其他客户端接入小本本

适用于 Windsurf / Cline / Trae 等支持 mcpServers 约定的客户端，四步完成。

第 1 步 · 下载并放置

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

第 2 步 · 配置 MCP（通用 mcpServers 模式）

在客户端的 MCP 配置文件中添加（各客户端配置文件位置以其官方文档为准，常见为 ~/.xxx/mcp.json 或项目根 .mcp.json）：

{
  "mcpServers": {
    "xiaobenben": {
      "command": "C:\\Users\\用户名\\.xiaobenben\\bin\\xbb.exe",
      "args": ["mcp"],
    }
  }
}

环境变量字段名是 env（opencode 例外，用 environment 且 command 是数组）。JSON 里两处「用户名」都要替换成真实账户名（Windows 终端 echo %USERNAME%；macOS/Linux whoami，路径写法为 ~/.xiaobenben/bin/xbb）。

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

把下面整块内容追加到你的规则文件（多数客户端支持项目根 AGENTS.md 约定；若文件已有「小本本」章节则只更新缺失的条目，不要重复追加）：

## 记忆库（小本本 xiaobenben）

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

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

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

第 4 步 · 重启并验证

重启客户端（MCP 配置在启动时加载）。首次调用工具时在弹窗里选「始终允许」。
确认 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）。

让 AI 写一条测试记忆并召回它：

请记住：我最喜欢的编程语言是 TypeScript（用 write_memory 写入）
我喜欢的编程语言是什么？（应自动 search_memory 召回）

让 AI 调用一次 recall_directives——能返回「小本本默认约束」域的约束即链路正常。

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