# 代理 DiscordBot 一种 TypeScript CLI 工具，使 AI 代理和人类能够使用机器人令牌与 Discord 服务器进行交互。与从桌面应用程序中提取用户令牌的 agent-discord 不同，agent-discordbot 使用标准 Discord Bot 令牌进行服务器端和 CI/CD 集成。 ## 快速入门 # 设置你的机器人令牌 agent-discordbot 身份验证设置 your-bot-token # 验证身份验证代理discordbot 身份验证状态 # 发送消息 agent-discordbot 消息发送 1234567890123456789 “来自机器人的你好！” # 列出频道 agent-discordbot 频道列表 ## 身份验证 ### 机器人令牌设置 agent-discordbot 使用您在 Discord 开发者门户中创建的 Discord Bot 令牌： # 设置机器人令牌（保存前根据 Discord API 进行验证） agent-discordbot 身份验证设置 your-bot-token # 设置自定义机器人标识符 agent-discordbot auth 设置 your-bot-token --bot 部署 --name“部署机器人” # 检查授权状态代理discordbot 身份验证状态 # 清除存储的凭据代理discordbot 身份验证清除有关机器人令牌设置、服务器邀请流程、消息内容意图和多机器人管理，请参阅 [references/authentication.md]()。 ## 内存代理维护一个“~/.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”） * 设置机器人标识符后（来自“auth list”）写入时，请包含**完整的文件内容** - “写入”工具会覆盖整个文件。 ### 存储什么 * 服务器 ID 和名称 * 带有名称和类别的频道 ID * 带有显示名称的用户 ID * 机器人标识符及其用途 * 用户指定的别名（“警报机器人”、“公告频道”） * 交互过程中表达的任何用户偏好 ### 不应该存储什么切勿存储机器人令牌、凭据或任何敏感数据。切勿存储完整的消息内容（仅 ID 和通道上下文）。切勿存储文件上传内容。 ### 处理陈旧数据如果记住的 ID 返回错误（未找到通道、未找到服务器），请将其从“MEMORY.md”中删除。不要盲目相信记忆的数据——当出现问题时进行验证。更喜欢重新列出，而不是使用可能已过时的记忆 ID。 ### 格式/示例 # 代理信使内存 ## Discord 服务器（机器人） - `1234567890123456` — Acme 开发 ## 机器人（Acme 开发） - `deploy` — 部署机器人（主动） - `alert` — 警报机器人 ## 频道（Acme 开发） - `1111111111111111` — #general（一般类别） - `2222222222222222` — #engineering（工程类别） - `3333333333333333` — #deploys（工程类别） ## 用户（Acme 开发） - `4444444444444444` — Alice（服务器所有者） - `5555555555555555` — 鲍勃 ## 别名 -“部署”→`3333333333333333`（Acme Dev 中的#deploys） ## 注释 - 部署机器人用于 CI/CD 通知 - Alert Bot 用于错误监控 > 内存可让您跳过重复的“频道列表”和“服务器列表”调用。如果您已经知道之前会话的 ID，请直接使用它。 ## 命令 ### 验证命令 # 设置机器人令牌 Agent-discordbot 身份验证集 <令牌> agent-discordbot auth set --bot deploy --name“部署机器人” # 检查授权状态代理discordbot 身份验证状态 # 清除所有凭证代理discordbot 身份验证清除 # 列出存储的机器人 Agent-discordbot 授权列表 # 切换活跃机器人 agent-discordbot 身份验证使用 # 删除已存储的机器人 agent-discordbot auth 删除 ### 服务器命令 # 列出机器人所在的服务器 agent-discordbot 服务器列表 # 显示当前服务器当前代理discordbot服务器 # 切换活动服务器 agent-discordbot 服务器交换机 # 获取服务器信息 agent-discordbot 服务器信息 ### 消息命令 # 发送消息 agent-discordbot 消息发送 agent-discordbot 消息发送 1234567890123456789 “Hello world” # 列出消息 agent-discordbot 消息列表 agent-discordbot 消息列表 1234567890123456789 --limit 50 # 根据ID获取单条消息 agent-discordbot 消息获取

# 获取话题回复 agent-discordbot 消息回复

agent-discordbot 消息回复 1234567890123456789 9876543210987654321 --limit 50 # 更新消息（仅限机器人自己的消息） agent-discordbot 消息更新

# 删除一条消息（仅限机器人自己的消息） agent-discordbot 消息删除

--force ### 通道命令 # 列出当前服务器中的频道 agent-discordbot 频道列表 # 获取频道信息 agent-discordbot 频道信息 Agent-discordbot 频道信息 1234567890123456789 ### 用户命令 # 列出服务器成员代理discordbot 用户列表 agent-discordbot 用户列表 --limit 50 # 获取用户信息 agent-discordbot 用户信息 ### 反应命令 # 添加反应（使用不带冒号的表情符号名称） agent-discordbot 反应添加

代理不和谐机器人反应添加1234567890123456789 9876543210987654321拇指 # 删除反应 agent-discordbot 反应删除

### 文件命令 # 上传文件到频道 agent-discordbot 文件上传 agent-discordbot 文件上传 1234567890123456789 ./report.pdf # 列出频道中的文件 agent-discordbot 文件列表 ### 线程命令 # 根据消息创建一个线程 agent-discordbot 线程创建 agent-discordbot 线程创建 1234567890123456789“讨论”--auto-archive-duration 1440 # 归档一个线程 agent-discordbot 线程存档 ### 快照命令获取 AI 代理的全面服务器状态： # 当前服务器的完整快照代理不和谐机器人快照 # 过滤后的快照 agent-discordbot 快照 --仅限通道 agent-discordbot 快照 --仅限用户 # 限制每个通道的消息数 agent-discordbot 快照 --limit 10 返回 JSON： * 服务器元数据（id、名称） * 频道（id、名称、类型、主题） * 最近的消息（id、内容、作者、时间戳） * 成员（id、用户名、全局名称） ## 输出格式 ### JSON（默认）所有命令默认输出 JSON 以供 AI 使用： { "id": "1234567890123456789", “内容”：“你好世界”， “作者”：“机器人用户名”， “时间戳”：“2024-01-15T10：30：00.000Z” } ### 漂亮（人类可读）使用“--pretty”标志进行格式化输出： agent-discordbot 频道列表 --pretty ## 全局选项选项 |描述 ---|--- `--漂亮` |人类可读的输出而不是 JSON `--bot ` |使用特定的机器人执行此命令 `--server ` |使用特定服务器执行此命令 ## 常见模式请参阅“references/common-patterns.md”了解典型的 AI 代理工作流程。 ## 模板请参阅“templates/”目录以获取可运行的示例： * `post-message.sh` \- 发送带有错误处理的消息 * `monitor-channel.sh` \- 监视新消息的通道 * `server-summary.sh` \- 生成服务器摘要 ## 错误处理所有命令返回一致的错误格式： { “错误”：“没有凭据。首先运行“auth set”。” } 常见错误：“missing_token”、“invalid_token”、“Missing Access”、“Unknown Channel”、“Missing Permissions”。 ## 配置凭证存储在 `~/.config/agent-messenger/discordbot-credentials.json` 中（0600 权限）。有关格式和安全详细信息，请参阅 [references/authentication.md]()。 ## 与 agent-discord 的主要区别特色|代理不和谐 |代理discordbot ---|---|--- 代币类型 |用户令牌 |机器人代币代币来源 |从桌面应用程序自动提取 |开发者门户手册留言搜索 |是的 |否 DM |是的 |否提及 |是的 |否朋友/笔记|是的 |否编辑/删除消息 |任何留言 |仅机器人自己的消息文件上传 |是的 |是的快照 |是的 |是的 CI/CD 友好 |需要桌面应用程序 |是（只需设置令牌） ## 限制 * 无实时事件/网关连接 * 不支持语音通道 * 无服务器管理（创建/删除频道、角色） * 没有斜杠命令 * 不支持网络钩子 * 没有消息搜索 * 没有 DM 或好友管理 * 机器人只能编辑/删除自己的消息 * 机器人必须被邀请到服务器并具有适当的权限 * 已验证机器人所需的消息内容意图（100 多个服务器） * 仅纯文本消息（v1 中没有嵌入） ## 故障排除 ### `agent-discordbot：找不到命令` **`agent-discordbot` 不是 npm 包名称。** npm 包是 `agent-messenger`。如果全局安装包，则直接使用“agent-discordbot”： agent-discordbot 消息发送 1234567890123456789 “你好” 如果未安装该软件包，请使用“bunx agent-messenger discordbot”： Bunx代理信使discordbot消息发送1234567890123456789“你好” **永远不要运行 `bunx agent-discordbot`** \-- 它会失败或安装错误的包，因为 `agent-discordbot` 不是 npm 包名称。有关其他故障排除（权限、令牌问题、消息内容意图），请参阅 [references/authentication.md]()。＃＃参考 * [认证指南]() * [常见模式]()

特工Discordbot

包含技能