小本本 安装指南 · opencode
← 返回安装总览

opencode 接入小本本

四步完成：下载程序 → 写 opencode.json 配置 → 写使用规则 → 重启验证。

第 1 步 · 下载并放置

如果 ~/.xiaobenben/bin/ 下已有可执行文件，跳过下载直接复用。没有则下载对应平台的文件（下载地址与放置命令见安装总览），统一放在 ~/.xiaobenben/bin/。

第 2 步 · 配置 MCP（~/.config/opencode/opencode.json）

{
  "mcp": {
    "xiaobenben": {
      "type": "local",
      "command": ["~/.xiaobenben/bin/xbb", "mcp"],
      "enabled": true
    }
  }
}

⚠️ opencode 的环境变量字段名是 environment（不是 env），且 command 是数组——写错的话引擎会 fallback 到客户端工作目录新建空库，检索永远是空的。

⚠️ 配置写完一定要重启 opencode：MCP 配置只在启动时加载，不重启的话新接入的小本本不会出现，AI 也调用不了任何记忆工具。

第 3 步 · 写入使用规则（AGENTS.md）

把下面整块内容追加到 ~/.config/opencode/AGENTS.md（若文件已有「小本本」章节则只更新缺失的条目，不要重复追加）：

## 记忆库（小本本 xiaobenben）

用户有一个跨客户端共享的本地记忆库（MCP 工具，覆盖写入 / 检索 / 收件箱 /
原话情景层 / 组织协作；完整清单见 tools/list）。只需记住：

1. 触发检索：用户提到"以前 / 上次 / 之前 / 去年聊过的事"，或话题可能与历史记忆相关时，
   先 search_memory 再回答；问的是明确实体则直接 recall_topic。动手产出（写代码 /
   做设计 / 写文档）之前，用任务词群调 recall_constraints 查约束。
2. 写入时机：对话中出现决策 / 承诺 / 偏好 / 事实 / 修正 / 叮嘱时，用 write_memory
   批量记录，terms 必填 5-15 个扩展词并携带上下文领域词。
3. 新会话开始先调用一次 recall_directives。其余全部行为纪律（消歧、时间锚、不编造、
   主动记录、会话归属、管理后台、指令类写入规范等）由引擎随握手与工具响应自动下发，
   以引擎返回内容为准，无需在此维护。

这份规则块刻意保持极短：只负责存在性声明和最小触发；其余纪律全部内置在引擎里，随版本升级自动更新，规则文件不需要跟着改。

第 4 步 · 重启并验证

  1. 重启 opencode（MCP 配置在启动时加载）。
  2. 确认 21 个工具已出现：一代面 10 个（write_memory / search_memory / recall_topic / recall_timeline / recall_session / get_memory / get_related / recall_directives / recall_constraints / reveal_secret） ＋ 收件箱与统计 5 个（inbox / outbox / ack / forget / stats） ＋ 情景层 2 个（log_episodes / recall_episodes） ＋ 补链 1 个（supersede） ＋ 组织协作 3 个（list_members / list_spaces / set_memory_audience）。
  3. 让 AI 写一条测试记忆并召回它：
    请记住：我最喜欢的编程语言是 TypeScript（用 write_memory 写入）
我喜欢的编程语言是什么？（应自动 search_memory 召回）
  4. 让 AI 调用一次 recall_directives——能返回「小本本默认约束」域的约束即链路正常。

更新方法、命令行一览、常见问题排查、隐私承诺，见安装总览。