@dobby.ai/dobby 0.1.0 → 0.1.2

package/docs/DOCKER_SANDBOX_vs_BOXLITE.md

@@ -1,77 +0,0 @@
-# Docker Sandboxes vs BoxLite 选型方案（面向 `dobby`）
-
-## 简要结论
-1. 结论：在你当前架构下，主选 `BoxLite`，保留现有 `docker` 后端作为回退；`Docker Sandboxes` 仅作为“开发机交互调试工具”可选。
-2. 原因：你的核心执行面是程序化 `Executor.exec(command, cwd, timeout, signal, env)`，而不是交互式 agent CLI。`BoxLite` 与此接口天然更贴合。
-3. 你的目标是“本地 agent 更谨慎访问文件系统 + 可自由试错”，`BoxLite` 更容易做强边界（只挂载 route/projectRoot）和可恢复试错（每会话/每路由生命周期控制）。
-
-## 横向对比（与当前架构相关）
-| 维度                       | Docker Sandboxes                                                   | BoxLite                                             |
-| -------------------------- | ------------------------------------------------------------------ | --------------------------------------------------- |
-| 产品定位                   | 面向 AI agent 工作流（Docker Desktop 体验优先）                    | 面向可嵌入式 sandbox runtime（SDK/程序化优先）      |
-| 接入方式                   | 以 `docker sandbox ...` CLI/工作流为主                             | Node/Python/Rust SDK 直接嵌入业务代码               |
-| 运行模式                   | 本地模式 + 云模式（但本地模式对 Codex/Claude，云模式支持矩阵不同） | 本地优先；另有 BoxRun（local/hybrid/serverless）    |
-| 隔离模型                   | 每个 sandbox 私有 Docker daemon；但文档明确仍继承用户系统权限边界  | micro-VM 硬件级隔离，库嵌入，无常驻 daemon          |
-| 文件系统策略               | workspace 同步/映射友好，适合交互开发                              | volume/workingDir 精细控制，适合 route 级边界治理   |
-| 网络治理                   | 有网络策略机制                                                     | 可通过 security/network 选项约束（按 SDK/平台能力） |
-| 稳定性表态                 | 官方标注 Beta、非生产就绪                                          | 仍属快速演进项目，但更偏 SDK 生产集成路径           |
-| 与你当前 `Executor` 贴合度 | 中（需要 CLI 编排层转译）                                          | 高（可直接实现 `BoxliteExecutor`）                  |
-
-## 针对当前架构的最终选型
-1. 主选：`BoxLite` 作为新 sandbox backend。
-2. 保留：`docker` backend 继续存在，作为回退与兼容路径。
-3. 不选主路径：`Docker Sandboxes` 不进入 `Executor` 主执行链路，仅用于开发者本机交互调试（可选）。
-
-推断说明：该结论基于你当前接口与调用链  
-`<repo-root>/src/sandbox/executor.ts:5`、`<repo-root>/src/sandbox/executor.ts:18`、`<repo-root>/src/agent/session-factory.ts:168`、`<repo-root>/src/core/types.ts:109`。
-
-## 决策后实施规格（decision-complete）
-
-## 1) 公共接口/类型变更
-1. 保持 `Executor` 接口不变：`exec(command, cwd, options)` 与 `close()`。
-2. 扩展 `SandboxConfig.boxlite`（当前仅 `workspaceRoot`）为可运营字段集合：`image`、`cpus`、`memoryMib`、`containerWorkspaceRoot`、`reuseMode`、`autoRemove`、`securityProfile`。
-3. 默认值：
-`image=alpine:latest`，`containerWorkspaceRoot=/workspace`，`reuseMode=conversation`，`securityProfile=maximum`。
-
-## 2) 执行语义
-1. 每个 conversation key 绑定一个 box（默认），避免跨会话“stop 连坐”。
-2. 仅挂载该 route 的 `projectRoot` 到 box 内 `/workspace`。
-3. 命令执行统一 `sh -lc "cd <guest-cwd> && <command>"`，保持与现有 DockerExecutor 行为一致。
-4. timeout/abort 策略：
-超时或 `AbortSignal` 触发时，不依赖 `execution.kill()`；直接 `box.stop()`，返回 `killed=true`，并重建该 conversation box。
-
-## 3) 失败模式处理
-1. 启动时原生 binding 缺失：fail fast，错误信息必须带安装修复建议。
-2. box stop 失败：记录 error，强制丢弃 runtime 引用，下一次 exec 全新建 box。
-3. cwd 越界：继续沿用现有 `assertWithinRoot` 逻辑，直接拒绝执行。
-
-## 4) 测试与验收场景
-1. 路由隔离：A/B 两个 route 不可跨目录读写。
-2. 中断能力：长命令在 stop 后 3 秒内结束并回报 `killed=true`。
-3. 超时恢复：超时后下一条命令可在新 box 成功执行。
-4. 并发安全：同 conversation 串行，不出现队列错乱。
-5. 依赖健壮性：缺失 native 包时启动即报错，不在运行中才崩溃。
-
-## 5) rollout 方案
-1. `sandbox.backend=boxlite` 先在单 route 灰度，其他 route 保持 `docker`。
-2. 收集 7 天指标：超时率、中断成功率、命令失败率、平均执行延迟。
-3. 达标后扩大到全部 route；未达标自动回退 `docker`。
-
-## 假设与默认
-1. 你的主要场景是“本地 agent 的程序化执行安全”，不是“Docker Desktop 交互体验优先”。
-2. 本机具备 virtualization 与 Docker 基础环境。
-3. 当前优先级是“文件系统边界可控 + 可试错恢复”，高于“零改造接入”。
-
-## 主要依据（sources）
-1. [Docker Sandboxes Overview](https://docs.docker.com/ai/sandboxes/)
-2. [Docker Sandboxes Architecture](https://docs.docker.com/ai/sandboxes/architecture/)
-3. [Docker Sandboxes Supported Agents](https://docs.docker.com/ai/sandboxes/supported-agents/)
-4. [Docker Sandboxes Get Started](https://docs.docker.com/ai/sandboxes/get-started/)
-5. [Docker Sandboxes Workflows](https://docs.docker.com/ai/sandboxes/workflows/)
-6. [Docker Sandboxes Network Policies](https://docs.docker.com/ai/sandboxes/network-policies/)
-7. [Docker Sandboxes Advanced](https://docs.docker.com/ai/sandboxes/advanced/)
-8. [BoxLite Introduction](https://docs.boxlite.ai/introduction)
-9. [BoxLite BoxRun](https://docs.boxlite.ai/concepts/boxrun)
-10. `<repo-root>/docs/BOXLITE_SANDBOX_FEASIBILITY.md:19`
-11. `<repo-root>/src/sandbox/executor.ts:5`
-12. `<repo-root>/src/agent/session-factory.ts:168`

package/docs/EXTENSION_SYSTEM_ARCHITECTURE.md

@@ -1,119 +0,0 @@
-# 扩展系统架构（V3）
-
-## 1. 目标
-
-V3 将扩展系统对齐 VSCode extension 使用体验：
-
-- 扩展按需下载与安装。
-- 扩展在独立目录管理，不污染宿主依赖树。
-- 启用与安装分离：配置声明启用，扩展目录提供安装事实。
-- 宿主不再提供任何 `plugins/*` 或 `dist/plugins/*` 回退加载。
-
-## 2. 核心模型
-
-### 2.1 安装目录
-
-- 扩展 store 固定在 `<data.rootDir>/extensions`。
-- 目录结构：
-  - `<data.rootDir>/extensions/package.json`
-  - `<data.rootDir>/extensions/package-lock.json`
-  - `<data.rootDir>/extensions/node_modules/*`
-
-### 2.2 配置语义
-
-- `extensions.allowList`：声明哪些包允许加载。
-- `providers/connectors/sandboxes.items`：绑定 `type + inline config`。
-- `routes`：定义可复用的执行 profile。
-- `bindings`：把 connector source 绑定到 route。
-
-新增不变量：
-- allowList 中每个启用包必须能从扩展 store 解析；否则启动 fail-fast。
-
-### 2.3 Manifest 约束
-
-- 扩展包必须包含 `dobby.manifest.json`。
-- `contributions[*].entry` 必须是插件包内构建好的 JS 入口（`.js/.mjs/.cjs`）。
-- entry 必须位于插件包根目录内部（禁止越界路径）。
-- 仓库里的 `plugins/*` 仅作源码参考，宿主不会回退加载这些源码路径。
-
-## 3. 宿主职责边界
-
-宿主仅负责：
-
-- 读取配置
-- 从扩展 store 解析 allowList 包
-- 解析 manifest 并动态 import entry
-- 注册 contribution 并实例化 provider/connector/sandbox
-- 运行 gateway 主流程
-
-宿主不负责：
-
-- 插件源码热加载
-- 插件开发态 fallback
-- 自动改写用户配置
-
-## 4. CLI 设计
-
-在 `src/main.ts` 提供子命令：
-
-- `extension install <packageSpec>`
-  - 执行：`npm install --prefix <extensionsDir> --save-exact <packageSpec>`
-  - 输出：已安装包、contributions、可粘贴配置模板（allowList + instances）
-- `extension uninstall <packageName>`
-  - 执行：`npm uninstall --prefix <extensionsDir> <packageName>`
-- `extension list`
-  - 列出扩展 store 中已安装包及其 contributions
-
-`start` 命令（默认）维持网关启动逻辑。
-
-## 5. 加载流程
-
-1. 读取 `gateway.json` 并归一化 `data.rootDir`。
-2. 计算 `extensionsDir = <data.rootDir>/extensions`。
-3. 使用 `createRequire(<extensionsDir>/package.json)` 解析 allowList 包。
-4. 读取并校验 manifest。
-5. 动态加载 contribution entry。
-6. 进行 contribution kind 一致性校验。
-7. 注册并实例化所需实例。
-
-## 6. 错误策略
-
-### 6.1 缺包
-
-当 allowList 包无法解析时，直接启动失败，并输出明确命令：
-
-`dobby extension install <package>`
-
-### 6.2 非法 manifest / entry
-
-以下情况直接启动失败：
-
-- manifest 不存在或结构非法
-- entry 非 JS 文件
-- entry 指向包外路径
-- entry 文件不存在
-- contribution kind 与模块导出不一致
-
-## 7. 插件包契约（发布侧）
-
-- 第三方依赖放在插件自身 `dependencies`。
-- `@dobby.ai/plugin-sdk` 作为插件契约依赖（通常 `peerDependencies`）。
-- connector capability 需显式声明 `updateStrategy`（`edit | final_only | append`），由网关统一决定出站发送策略（update / final-only / append）。
-- 开发态可通过 `devDependencies` 使用 `file:../plugin-sdk`，保证本地类型可用；运行态不依赖宿主回退。
-- 插件运行时不得依赖宿主源码路径或宿主 dist 路径。
-
-## 8. Breaking 变更总结
-
-- 宿主 `package.json` 不再使用 `file:plugins/*` 依赖。
-- 宿主编译边界收敛到 `src/**/*.ts`。
-- 插件入口不再 `try src / catch dist`。
-- manifest entry 改为包内 dist JS。
-- 插件 npm scope 统一为 `@dobby.ai/*`（旧 `@dobby/*` 配置需手动迁移）。
-
-## 9. 验收基线
-
-1. allowList 缺包时，启动 fail-fast，报错含 install 命令。
-2. 安装扩展后启动成功，日志可见已加载包和 contributions。
-3. 根 `node_modules` 中存在同名包时，loader 不回退解析（只认扩展 store）。
-4. `extension install` 输出模板可直接用于 `gateway.json`。
-5. `npm run check` 与 `npm run build` 通过。

package/docs/MVP.md

@@ -1,135 +0,0 @@
-# Discord-First MVP（独立仓库，依赖 pi 包，不改 pi 源码）
-
-## Summary
-最终落地决策如下：
-1. 不在 `pi-mono` 内开发 MVP，不修改其源码。
-2. 新建你自己的独立仓库（建议名：`dobby`）。
-3. 通过 NPM 稳定版依赖 `@mariozechner/pi-*` 包。
-4. MVP 仅做 Discord。
-5. 架构采用 `Gateway Core + Connector 插件`，单进程运行。
-6. 频道能力通过静态 `channelId -> route profile` 映射实现。
-7. 沙箱 MVP 先 Docker，Boxlite 作为后续里程碑。
-
-## 1. 代码放置位置
-建议新目录（仓库外）：
-1. `~/workspace/dobby`（或你的组织仓库）。
-2. `pi-mono` 作为只读参考，不参与提交。
-
-## 2. 新仓库结构（MVP）
-```text
-dobby/
-  package.json
-  tsconfig.json
-  .env.example
-  config/
-    gateway.example.json         # 可提交示例；复制为 gateway.json 后本地使用
-  src/
-    main.ts
-    core/
-      gateway.ts
-      routing.ts
-      types.ts
-      runtime-registry.ts
-      dedup-store.ts
-    connectors/
-      discord/
-        connector.ts
-        mapper.ts
-    agent/
-      session-factory.ts
-      event-forwarder.ts
-    sandbox/
-      executor.ts                # interface
-      docker-executor.ts
-      host-executor.ts
-  data/
-    sessions/
-    attachments/
-    logs/
-```
-
-## 3. 依赖策略（已锁定）
-`package.json` 依赖使用 NPM 稳定版（固定 minor，按需要升级）：
-1. `@mariozechner/pi-coding-agent`
-2. `@mariozechner/pi-agent-core`
-3. `@mariozechner/pi-ai`
-4. `discord.js`
-5. 你选择的日志与配置库（如 `pino`、`zod`）
-
-不使用：
-1. `file:` 本地路径依赖
-2. 直接改 `pi-mono/packages/*`
-
-## 4. 与 pi 的边界（不修改源码）
-只通过公开 API 使用：
-1. `createAgentSession`
-2. `SessionManager`
-3. `AuthStorage`
-4. `ModelRegistry`
-5. `createCodingTools(cwd)` / `createReadOnlyTools(cwd)`
-
-你自己的业务逻辑放在独立仓库：
-1. Discord 事件接入
-2. Channel 路由
-3. 队列与幂等
-4. 审计与监控
-5. 沙箱后端选择
-
-## 5. 频道差异化能力（Discord）
-配置文件固定支持：
-```json
-{
-  "channelMap": {
-    "1234567890": "projectA",
-    "2234567890": "projectB"
-  },
-  "routes": {
-    "projectA": {
-      "projectRoot": "/Users/you/workspace/project-a",
-      "tools": "full",
-      "systemPromptFile": "/Users/you/config/prompts/project-a.md"
-    },
-    "projectB": {
-      "projectRoot": "/Users/you/workspace/project-b",
-      "tools": "full",
-      "systemPromptFile": "/Users/you/config/prompts/project-b.md"
-    }
-  }
-}
-```
-这样每个 channel 会绑定不同项目目录与行为。
-
-## 6. Sandbox 方案
-MVP：
-1. 默认 `docker` 执行器。
-2. `host` 仅调试可选。
-
-Post-MVP：
-1. 新增 `BoxliteExecutor`，实现同一 `Executor` 接口。
-2. 配置切换 `sandbox.backend = "boxlite"`。
-3. 对接完成后做稳定性与性能回归。
-
-## 7. 里程碑（更新后）
-1. M0：独立仓库初始化 + 配置加载 + 类型定义 + 运行骨架。
-2. M1：Discord Connector + Gateway Pipeline + Session 串行队列。
-3. M2：频道静态路由（不同 channel -> 不同 projectRoot）。
-4. M3：工具全能力 + Docker sandbox + 审计日志。
-5. M4：错误恢复、重试、幂等、上线监控。
-6. M5：Boxlite 集成（非 MVP）。
-7. M6：Telegram/WhatsApp（MVP 后）。
-
-## Test Cases
-1. 两个 Discord channel 分别写入不同项目目录，互不污染。
-2. 同 channel 并发消息串行执行，不乱序。
-3. `message_update` 流式编辑稳定，无覆盖错乱。
-4. 工具调用日志完整记录（开始、结束、错误）。
-5. Docker 模式下不能越界访问未挂载路径。
-6. 进程重启后会话可恢复。
-
-## Assumptions & Defaults
-1. 你不会修改 `pi-mono` 源码。
-2. 依赖源固定为 NPM 稳定版。
-3. MVP 只支持 Discord。
-4. 默认工具权限 `full`。
-5. 默认 sandbox 为 Docker。
-6. channel 路由采用静态配置，不做动态 `/bind`。

package/docs/RUNBOOK.md

@@ -1,242 +0,0 @@
-# dobby 操作手册（v3）
-
-本文档用于在本机启动 `dobby` 并完成最小验收。  
-当前配置模型是扩展系统 v3，默认 sandbox 为 `host.builtin`。
-
-> Scope 变更说明：扩展包已硬切到 `@dobby.ai/*`。若你的旧配置仍使用 `@dobby/*`，请先手动替换后再执行安装/启动命令。
-
-## 1. 前置条件
-
-1. Node.js >= 20（见 `<repo-root>/package.json`）。
-2. 已安装 npm。
-3. 已创建 Discord Bot，并拿到 Token。
-4. Discord Bot 已开启 `MESSAGE CONTENT INTENT`，并被邀请到目标服务器。
-5. 已准备至少一个本地项目目录（作为 route 的 `projectRoot`）。
-
-## 2. 初始化项目
-
-在仓库根目录执行：
-
-```bash
-npm install
-npm run check
-```
-
-## 3. 环境变量
-
-复制示例：
-
-```bash
-cp .env.example .env
-```
-
-编辑 `.env`，至少设置：
-
-```bash
-DISCORD_BOT_TOKEN=你的真实Token
-LOG_LEVEL=info
-```
-
-说明：
-1. `npm run start --` 不会自动加载 `.env`，请先导出变量。
-2. `npm run start:local --` 会通过 `--env-file-if-exists=.env` 自动加载。
-
-手动导出方式：
-
-```bash
-set -a
-source .env
-set +a
-```
-
-## 4. 准备配置文件
-
-配置路径优先级：
-1. `DOBBY_CONFIG_PATH`（若设置）
-2. 在 `dobby` 仓库内运行时自动使用 `./config/gateway.json`
-3. 默认 `~/.dobby/gateway.json`
-
-示例（强制指定配置文件）：
-
-```bash
-DOBBY_CONFIG_PATH=/tmp/gateway.dev.json npm run start -- config show providers --json
-```
-
-```bash
-cp config/gateway.example.json config/gateway.json
-```
-
-说明：
-1. 若你使用 `dobby init` 并选择了 `provider.pi`，`models.custom.json` 会在缺失时自动生成。
-2. 手动维护配置时，仍可参考 `config/models.custom.example.json`。
-
-### 4.1 CLI config 命令（硬切）
-
-`config` 已切换为交互与结构化查看，不再支持路径式 `get/set/unset`。
-
-可用命令：
-
-```bash
-dobby config show [section] [--json]
-dobby config list [section] [--json]
-dobby config edit
-dobby config schema list [--json]
-dobby config schema show <contributionId> [--json]
-```
-
-说明：
-1. `config edit` 与 `configure` 在编辑 provider/connector 实例时，会优先读取扩展暴露的 `configSchema` 动态生成字段输入。
-2. 默认仅询问关键字段；带默认值的高级选项可在提示时按需展开。
-3. 若某个 contribution 没有可用 `configSchema`，CLI 会先提示原因（例如扩展 disabled/未安装）；未加载 schema 时会要求你确认是否继续使用 JSON 文本输入。
-4. `dobby init` 也会在安装扩展后按 `configSchema` 动态询问 provider/connector 的配置字段（Discord connector 保留专用引导配置）。
-
-旧命令映射：
-1. `config get ...` -> `config show` 或 `config list`
-2. `config set ...` -> `config edit`
-3. `config unset ...` -> 使用专用删除命令（`channel unset`、`route remove`、`extension uninstall`）
-
-`init` 语义说明：
-1. `dobby init` 仅用于首次初始化。
-2. 若配置文件已存在，`init` 会直接报错；请改用 `dobby config edit` 或 `dobby configure`。
-
-## 5. 关键配置说明（v3）
-
-编辑 `<repo-root>/config/gateway.json`。
-
-必须检查：
-1. `extensions.allowList`：声明启用的扩展包（仅声明启用，不等于已安装）。
-2. `providers.items`：至少有一个 provider 实例，并与 `providers.default` 对应。
-3. `connectors.items`：至少有一个 connector 实例（Discord）。
-4. `routes.items.*.projectRoot`：改成你机器上的真实目录。
-5. `bindings.items.*`：为每个入口声明 `(connector, source.type, source.id) -> route`。
-6. `routes.items.*.provider`：可省略；省略时走 `routes.defaults.provider`。
-7. `routes.items.*.sandbox`：可省略；省略时走 `routes.defaults.sandbox`。
-
-默认 sandbox：
-1. 全局默认是 `sandboxes.default = "host.builtin"`。
-2. route 里若显式写 `sandbox`，则按 route 覆盖。
-
-当前默认示例（推荐）：
-
-```json
-"sandboxes": {
-  "default": "host.builtin",
-  "items": {}
-}
-```
-
-## 6. 扩展安装
-
-首次运行前，需把 allowList 里的扩展安装到 extension store（`data/extensions`）：
-
-```bash
-npm run start -- extension install @dobby.ai/provider-pi
-npm run start -- extension install @dobby.ai/connector-discord
-```
-
-可选扩展：
-
-```bash
-npm run start -- extension install @dobby.ai/provider-claude
-npm run start -- extension install @dobby.ai/provider-claude-cli
-npm run start -- extension install @dobby.ai/sandbox-core
-```
-
-Claude provider 说明：
-1. `provider.claude`（`@dobby.ai/provider-claude`）走 Claude Agent SDK。
-2. `provider.claude-cli`（`@dobby.ai/provider-claude-cli`）走 Claude Code CLI（当前为 host-only）。
-
-若使用 `provider.claude-cli`，启动前建议检查：
-
-```bash
-claude --version
-claude auth status --json
-```
-
-说明：
-1. 若配置 `authMode=subscription`，`claude auth status --json` 需显示 `loggedIn: true`。
-2. 若配置 `authMode=apiKey`，需在网关启动环境提供 `ANTHROPIC_API_KEY`。
-
-查看已安装扩展：
-
-```bash
-npm run start -- extension list
-```
-
-## 7. 启动网关
-
-```bash
-npm run build
-npm run start --
-```
-
-或：
-
-```bash
-npm run start:local --
-```
-
-## 8. 最小验收
-
-启动成功后，日志应包含：
-1. `Extension packages loaded`
-2. `Discord connector ready`
-3. `Gateway started`
-
-在 Discord 中验证：
-1. 在已绑定频道发送消息（群聊若 `mentions="required"` 需 @bot）。
-2. Bot 先回复 `_Thinking..._`，随后流式更新。
-3. 发送 `stop`、`/stop` 或 `/cancel` 可取消当前会话中正在执行和排队中的任务。
-4. 发送 `/new` 或 `/reset` 会归档当前会话状态，并让下一条消息从新会话开始。
-
-## 9. 切换到 Docker / BoxLite（可选）
-
-如果需要容器沙箱，不再使用 `sandbox.backend` 字段，而是通过扩展实例配置：
-
-1. 安装 `@dobby.ai/sandbox-core`。
-2. 在 `sandboxes.items` 定义实例（如 `sandbox.docker` 或 `sandbox.boxlite`）。
-3. 将 `sandboxes.default` 或 `routes.items.*.sandbox` 指向对应实例。
-
-示意（只展示结构）：
-
-```json
-"sandboxes": {
-  "default": "docker.main",
-  "items": {
-    "docker.main": {
-      "type": "sandbox.docker",
-      "container": "im-agent-sandbox",
-      "hostWorkspaceRoot": "/Users/you/workspace",
-      "containerWorkspaceRoot": "/workspace"
-    }
-  }
-}
-```
-
-## 10. 数据目录
-
-运行后会自动创建：
-1. `<repo-root>/data/sessions`
-2. `<repo-root>/data/attachments`
-3. `<repo-root>/data/logs`
-4. `<repo-root>/data/state`
-5. `<repo-root>/data/extensions`
-
-## 11. 常见问题
-
-1. `Discord bot token env 'DISCORD_BOT_TOKEN' is not set`
-   - 未导出环境变量，先执行 `set -a; source .env; set +a`，或使用 `npm run start:local`。
-
-2. `Configured model 'provider/model' not found`
-   - 检查 provider 实例中的 `provider/model/modelsFile` 是否和 `config/models.custom.json` 一致。
-
-3. `Extension package 'xxx' is not installed in '.../data/extensions'`
-   - 先执行 `npm run start -- extension install <package>`。
-
-4. Docker 沙箱报 `container is not running` 或越界错误
-   - 检查 docker container 状态，以及 `hostWorkspaceRoot` 是否覆盖 route 的 `projectRoot`。
-
-5. 机器人在群里没反应
-   - 检查入口是否已经写进 `bindings.items`。
-   - 检查是否需要 @bot（`mentions="required"`）。
-   - 检查 bot 在频道内的读写权限与消息内容权限。