discord

Discord 技能（只读）

使用 discord-cli 读取 Discord，用于金融研究。该命令行工具会在本地同步 Discord 消息，并提供搜索、分析和导出功能。

此技能为只读。 它专为金融研究设计：搜索交易服务器讨论、监控加密货币／市场群组、追踪金融社区中的情绪，以及导出消息以供分析。不支持发送消息、添加表情回应、编辑、删除或任何写入操作。

重要： 此工具使用从本地 Discord 客户端或浏览器会话中提取的 Discord 令牌。无需 Bot 账号。

---

步骤 1：确保已安装并通过身份验证的 discord-cli

当前环境状态：

!`(command -v discord && discord status 2>&1 | head -5 && echo "AUTH_OK" || echo "AUTH_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

如果上述状态显示 AUTH_OK，请跳到步骤 2。如果显示 NOT_INSTALLED，请先安装：

# Install (requires Python 3.10+)
uv tool install kabi-discord-cli

如果显示 AUTH_NEEDED，请引导用户：

身份验证

方法 A：从本地 Discord 客户端自动提取（推荐）

discord auth --save

此操作会从本地运行的 Discord 桌面应用或浏览器会话中提取令牌，并保存以供日后使用。

方法 B：环境变量

export DISCORD_TOKEN="<token from browser DevTools>"
discord status

常见身份验证问题

症状	解决方法
Token not found	打开 Discord 桌面应用或在浏览器中登录，然后运行 discord auth --save
Token expired / invalid	重新登录 Discord，然后再次运行 discord auth --save
Unauthorized (401)	令牌无效——使用 discord auth --save 重新提取

---

步骤 2：确定用户的需求

将用户的请求对应到以下只读命令之一，然后使用 references/commands.md 中相应的命令。

用户请求	命令	主要标志
检查身份验证	discord status	—
我是谁	discord whoami	--json
列出服务器／公会	discord dc guilds	--json
列出服务器中的频道	discord dc channels GUILD_ID	--json
服务器信息	discord dc info GUILD_ID	--json
服务器成员	discord dc members GUILD_ID	--max N、--json
获取消息历史	discord dc history CHANNEL_ID	-n N
在本地同步消息	discord dc sync CHANNEL_ID	-n N
同步所有频道	discord dc sync-all	-n N
查看实时／最新消息	discord dc tail CHANNEL_ID	--once
搜索服务器（API）	discord dc search GUILD_ID "QUERY"	-c CHANNEL_ID、--json
本地搜索	discord search "QUERY"	-c CHANNEL、-n N、--json
最近的消息	discord recent	-c CHANNEL、--hours N、-n N、--json
今天的消息	discord today	-c CHANNEL、--json
消息统计	discord stats	--json
热门发送者	discord top	-c CHANNEL、--hours N、--json
活动时间线	discord timeline	-c CHANNEL、--hours N、--by day|hour、--json
导出消息	discord export CHANNEL	-f text|json、-o FILE、--hours N

---

步骤 3：执行命令

通用模式

# Use --json or --yaml for structured output
discord dc guilds --json
discord dc channels GUILD_ID --json

# Sync messages from a channel for local queries
discord dc sync CHANNEL_ID -n 1000

# Search for financial topics
discord dc search GUILD_ID "AAPL earnings" --json
discord search "BTC pump" -n 20 --json

# Recent activity
discord recent --hours 24 -n 50 --json
discord today -c CHANNEL_ID --json

主要规则

1. 先检查身份验证——执行任何其他命令前，先运行 discord status
2. 以编程方式处理数据时，使用 --json 或 --yaml 获取结构化输出
3. 执行本地查询前先同步——使用 discord search、discord recent 等命令前，先运行 discord dc sync CHANNEL_ID
4. 使用 -n N 限制结果数量——除非用户要求更多，否则从 50–100 条开始
5. 使用 discord dc search 执行服务器端搜索（无需同步）；使用 discord search 执行本地搜索（需要先同步）
6. 使用 --hours N 与 recent、top、timeline 和 export 一起指定时间范围
7. 绝不执行写入操作——此技能为只读；不要发送消息、添加表情回应、编辑、删除或管理服务器设置
8. 绝不运行 discord purge——此命令会删除本地数据，与研究无关

输出标志

标志	用途
--json	JSON 输出
--yaml	YAML 输出（非 TTY 环境下的默认格式）
-n N	限制结果数量
-o FILE	将输出保存到文件
-c CHANNEL	按频道筛选

新服务的典型工作流

# 1. List guilds to find the server
discord dc guilds --json

# 2. List channels in the target guild
discord dc channels GUILD_ID --json

# 3. Sync messages from channels of interest
discord dc sync CHANNEL_ID -n 2000

# 4. Search or analyze
discord search "price target" -n 20 --json
discord recent -c CHANNEL_ID --hours 24 --json
discord top -c CHANNEL_ID --hours 168 --json

---

步骤 4：呈现结果

获取数据后，清晰地呈现内容，以便用于金融研究：

1. 总结关键内容 — 突出与用户金融研究最相关的消息
2. 注明来源 — 显示用户名、消息内容和时间戳
3. 对于搜索结果，按相关性分组，并突出关键主题、情绪或市场信号
4. 对于服务/频道列表，使用清晰的表格呈现名称和 ID
5. 标注情绪 — 说明看涨/看跌情绪，以及观点是共识还是逆向观点
6. 对于分析结果（stats、top、timeline），呈现活动模式和重要贡献者
7. 将令牌视为机密 — 切勿将 Discord 令牌回显到 stdout

---

步骤 5：诊断

如果身份验证失败，请重新运行：

discord auth --save
discord status

确保 Discord 桌面应用正在运行，或者你已在浏览器中登录 Discord。

---

错误参考

错误	原因	修复方法
Token not found	未通过身份验证	在 Discord 已打开的情况下运行 discord auth --save
HTTP 401	令牌已过期/无效	重新登录 Discord 并重新提取令牌
HTTP 403	无权访问资源	确认你有权访问该服务/频道
HTTP 429	请求频率受限	等待几分钟后重试

---

参考文件

• references/commands.md — 完整的读取命令参考，包含所有标志和用法示例

需要准确的命令语法或标志详细说明时，请阅读参考文件。