# 特工不和谐一种 TypeScript CLI 工具，使 AI 代理和人类能够通过简单的命令界面与 Discord 服务器进行交互。具有从 Discord 桌面应用程序和多服务器支持中无缝提取令牌的功能。 ## 快速入门 # 获取服务器快照（凭据自动提取）代理不和谐快照 # 发送消息 agent-discord 消息发送 “来自 AI 代理的你好！” # 列出频道代理不和谐频道列表 ## 身份验证首次使用时，会自动从 Discord 桌面应用程序中提取凭据。无需手动设置 - 只需运行任何命令，身份验证就会在后台静默进行。在 macOS 上，系统可能会首次提示您输入钥匙串密码（需要解密 Discord 存储的令牌）。这是一次性提示。 **重要**：切勿引导用户打开 Web 浏览器、使用 DevTools 或从浏览器手动复制令牌。始终使用“agent-discord auth extract”从桌面应用程序获取令牌。 ### 多服务器支持 # 列出所有可用的服务器代理不一致服务器列表 # 切换到不同的服务器 agent-discord 服务器开关 # 显示当前服务器代理不一致服务器当前 # 检查授权状态代理不一致身份验证状态 ## 内存代理维护一个“~/.config/agent-messenger/MEMORY.md”文件作为跨会话的持久内存。这是代理管理的 — CLI 不会读取或写入此文件。使用“读取”和“写入”工具来管理您的内存文件。 ### 读取内存在**每个任务开始**时，使用“Read”工具读取“~/.config/agent-messenger/MEMORY.md”，以加载任何先前发现的服务器 ID、通道 ID、用户 ID 和首选项。 * 如果该文件尚不存在，那也没有问题 — 无需该文件即可继续操作，并在您第一次存储有用信息时创建该文件。 * 如果无法读取文件（权限、缺少目录），则无需记忆即可继续操作 — 不要出错。 ### 写入内存发现有用信息后，使用“Write”工具更新“~/.config/agent-messenger/MEMORY.md”。写触发器包括： * 发现服务器 ID 和名称后（从“服务器列表”、“快照”等） * 发现有用的频道 ID 和名称后（从“频道列表”、“快照”等） * 发现用户 ID 和名称后（从“用户列表”、“用户我”等） * 用户为您提供别名或偏好后（“将此称为开发服务器”，“我的主频道是 X”） * 发现频道结构（类别、语音频道）后写入时，请包含**完整的文件内容** - “写入”工具会覆盖整个文件。 ### 存储什么 * 服务器 ID 和名称 * 带有名称和类别的频道 ID * 带有显示名称的用户 ID * 用户指定的别名（“开发服务器”、“公告频道”） * 常用的线程ID * 交互过程中表达的任何用户偏好 ### 不应该存储什么切勿存储令牌、凭据或任何敏感数据。切勿存储完整的消息内容（仅 ID 和通道上下文）。切勿存储文件上传内容。 ### 处理陈旧数据如果记住的 ID 返回错误（未找到通道、未找到服务器），请将其从“MEMORY.md”中删除。不要盲目相信记忆的数据——当出现问题时进行验证。更喜欢重新列出，而不是使用可能已过时的记忆 ID。 ### 格式/示例 # 代理信使内存 ## 不和谐服务器 - `1234567890123456` — Acme Dev（默认） - `9876543210987654` — 开源社区 ## 频道（Acme 开发） - `1111111111111111` — #general（一般类别） - `2222222222222222` — #engineering（工程类别） - `3333333333333333` — #deploys（工程类别） ## 用户（Acme 开发） - `4444444444444444` — Alice（服务器所有者） - `5555555555555555` — 鲍勃 ## 别名 -“开发服务器”→`1234567890123456`（Acme Dev） -“部署”→`3333333333333333`（Acme Dev 中的#deploys） ## 注释 - 用户更喜欢 --pretty 快照输出 - 主服务器是“Acme Dev” > 内存可让您跳过重复的“频道列表”和“服务器列表”调用。如果您已经知道之前会话的 ID，请直接使用它。 ## 命令 ### 验证命令 # 从 Discord 桌面应用程序中提取令牌（通常是自动的）代理不和谐身份验证摘录代理不和谐身份验证提取--调试 # 检查授权状态代理不一致身份验证状态 # 从 Discord 中注销代理不一致身份验证注销 ### 消息命令 # 发送消息代理不和谐消息发送代理不和谐消息发送 1234567890123456789 “Hello world” # 列出消息代理不和谐消息列表代理不和谐消息列表 1234567890123456789 --limit 50 # 根据ID获取单条消息代理不和谐消息获取 <频道 ID> <消息 ID> 代理不一致消息获取 1234567890123456789 9876543210987654321 # 删除一条消息 Agent-discord 消息删除 <频道 ID> <消息 ID> --force # 确认/将消息标记为已读代理不和谐消息确认 <通道 ID> <消息 ID> # 搜索当前服务器中的消息代理不和谐消息搜索代理不和谐消息搜索“项目更新”--限制 10 代理不和谐消息搜索“hello”--channel --author ### 通道命令 # 列出当前服务器中的频道（仅限文本频道）代理不和谐频道列表 # 获取频道信息代理不和谐频道信息代理不和谐频道信息 1234567890123456789 # 获取频道历史记录（消息列表的别名） agent-discord 频道历史记录 --limit 100 ### 服务器命令 # 列出所有服务器代理不一致服务器列表 # 获取服务器信息代理不一致服务器信息 <服务器 ID> # 切换活动服务器 agent-discord 服务器开关 # 显示当前服务器代理不一致服务器当前 ### 用户命令 # 列出服务器成员代理不和谐用户列表 # 获取用户信息代理不和谐用户信息 <用户 ID> # 获取当前用户代理不和谐用户我 ### DM 命令 # 列出 DM 频道代理不和谐 DM 列表 # 与用户创建DM通道 agent-discord dm create <用户 ID> ### 提及命令 # 列出最近提及的内容代理不和谐提及列表代理不和谐提及列表 --limit 50 代理不和谐提及列表 --guild <服务器 ID> ### 好友命令 # 列出所有关系（朋友、阻止、待处理的请求）代理不和谐好友列表代理不和谐好友列表 --pretty ### 注意命令 # 获取用户的注释 agent-discord note 获取 <用户 ID> # 为用户设置注释 agent-discord note set “注释内容” ### 配置文件命令 # 获取详细的用户资料代理不和谐配置文件获取 <用户 ID> ### 成员命令 # 搜索公会成员 agent-discord 成员搜索 agent-discord 会员搜索 1234567890123456789 "john" --limit 20 ### 线程命令 # 在通道中创建一个线程 agent-discord 线程创建代理不和谐线程创建1234567890123456789“讨论”--自动存档持续时间1440 # 归档一个线程 agent-discord 线程存档 ### 反应命令 # 添加反应（使用不带冒号的表情符号名称）代理不和谐反应添加

代理不和谐反应添加 1234567890123456789 9876543210987654321 点赞 # 删除反应代理不和谐反应删除

# 列出对消息的反应代理不和谐反应列表

### 文件命令 # 上传文件 agent-discord 文件上传代理不和谐文件上传 1234567890123456789 ./report.pdf # 列出频道中的文件 agent-discord 文件列表 # 获取文件信息代理不和谐文件信息 <频道 ID> <文件 ID> ### 快照命令获取 AI 代理的全面服务器状态： # 完整快照代理不和谐快照 # 过滤后的快照代理不和谐快照 --仅限通道代理不和谐快照--仅限用户 # 限制每个通道的消息数代理不和谐快照 --limit 10 返回 JSON： * 服务器元数据（id、名称） * 频道（id、名称、类型、主题） * 最近的消息（id、内容、作者、时间戳） * 成员（id、用户名、全局名称） ## 输出格式 ### JSON（默认）所有命令默认输出 JSON 以供 AI 使用： { "id": "1234567890123456789", “内容”：“你好世界”， “作者”：“用户名”， “时间戳”：“2024-01-15T10：30：00.000Z” } ### 漂亮（人类可读）使用“--pretty”标志进行格式化输出：代理不和谐频道列表 --pretty ## 与 Slack 的主要区别特色|不和谐 |松弛 ---|---|--- 服务器术语 |服务器|工作空间频道标识符 |雪花 ID |频道名称或ID 消息标识符|雪花 ID |时间戳 (ts) 主题 |线程 ID 字段 |线程时间戳提及 | `<@user_id>` | `<@USER_ID>` **重要**：Discord 使用 Snowflake ID（大数字，如“1234567890123456789”）作为所有标识符。您不能直接使用频道名称 - 首先使用“频道列表”查找 ID。 ## 常见模式请参阅“references/common-patterns.md”了解典型的 AI 代理工作流程。 ## 模板请参阅“templates/”目录以获取可运行的示例： * `post-message.sh` \- 发送带有错误处理的消息 * `monitor-channel.sh` \- 监视新消息的通道 * `server-summary.sh` \- 生成服务器摘要 ## 错误处理所有命令返回一致的错误格式： { "error": "未经过身份验证。首先运行\"auth extract\"。" } 常见错误： * `未验证`：没有有效的令牌（自动提取失败 - 请参阅故障排除） * `没有当前服务器集`: 首先运行`server switch ` * `消息未找到`: 消息 ID 无效 * `未知频道`: 无效频道ID ## 配置凭证存储在：`~/.config/agent-messenger/discord-credentials.json` 格式： { "token": "user_token_here", “当前服务器”：“1234567890123456789”， “服务器”：{ “1234567890123456789”：{ "server_id": "1234567890123456789", "server_name": "我的服务器" } } } **安全**：文件权限设置为 0600（所有者只读/写） ## 限制 * 无实时事件/网关连接 * 不支持语音通道 * 无服务器管理（创建/删除频道、角色） * 没有斜杠命令 * 不支持网络钩子 * 仅纯文本消息（v1 中没有嵌入） * 仅用户令牌（无机器人令牌） ## 故障排除 ### 身份验证失败或未找到令牌凭证通常是自动提取的。如果自动提取失败，请使用调试输出手动运行它：代理不和谐身份验证提取--调试常见原因： * Discord 桌面应用程序未安装或未登录 * macOS 钥匙串访问被拒绝（重新运行并批准提示） * Discord 未运行且 LevelDB 文件已过时 ### `代理不和谐：找不到命令` **`agent-discord` 不是 npm 包名称。** npm 包是 `agent-messenger`。如果该包是全局安装的，则直接使用“agent-discord”：代理不一致服务器列表如果未安装该软件包，请使用“bunx agent-messenger discord”： Bunx代理-信使不和谐服务器列表 **永远不要运行 `bunx agent-discord`** — 它会失败或安装错误的包，因为 `agent-discord` 不是 npm 包名称。 ## 参考文献 * [认证指南]() * [常见模式]()

不和谐特工

包含技能