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

WorkBuddy 接入小本本

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

第 1 步 · 下载并放置

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

第 2 步 · 配置 MCP(~/.workbuddy/mcp.json)

① 先开「允许完全访问」:如果是由 WorkBuddy 里的 AI 代为安装,先在会话输入框下方把「允许完全访问」开关打开(否则 AI 只有沙箱权限,无法真实写入用户目录和配置文件,装了也是白装)。开完权限再把安装指令发给它:

WorkBuddy 开启允许完全访问
第 1 步:会话内打开「允许完全访问」开关
{
  "mcpServers": {
    "xiaobenben": {
      "command": "C:\\Users\\用户名\\.xiaobenben\\bin\\xbb.exe",
      "args": ["mcp"],
    }
  }
}

环境变量字段名是 env。上面 JSON 里出现了两处「用户名」(command 和 env 各一个),都要替换成你 Windows 的真实账户名(终端输入 echo %USERNAME% 查看;macOS/Linux 用 whoami,路径写法为 ~/.xiaobenben/bin/xbb)。

② 配置完成后彻底重启 WorkBuddy:MCP 配置只在启动时加载。注意右下角任务栏托盘里的 WorkBuddy 也要退出——只关主窗口它还在后台运行,配置不会重新读取。正确操作:先关主窗口,再右键任务栏托盘的 WorkBuddy 图标 → 退出,然后重新启动。

③ 重启后对连接器手动授权:WorkBuddy 出于安全设计,新接入的自定义连接器默认不被信任,需要手动确认一次。打开左侧菜单「专家 · 技能 · 连接器」→ 点「连接器」:

WorkBuddy 左侧菜单进入连接器
第 2 步:左侧菜单 → 专家 · 技能 · 连接器 → 连接器

在连接器页面右上角点「自定义连接器」,找到 xiaobenben 点击授权/信任:

WorkBuddy 连接器管理页自定义连接器入口
第 3 步:连接器页 → 右上角「自定义连接器」→ 对 xiaobenben 授权信任

授权成功后,在「MCP 服务管理」弹窗里能看到 xiaobenben 已出现且开关为启用状态(绿色):

WorkBuddy MCP 服务管理中 xiaobenben 已启用
授权完成:MCP 服务管理里 xiaobenben 已启用(开关为绿色)

第 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 步 · 验证安装

  1. 重启后确认「MCP 服务管理」里 xiaobenben 已启用(绿色)。
  2. 让 AI 写一条测试记忆并召回它:
    请记住:我最喜欢的编程语言是 TypeScript(用 write_memory 写入)
    我喜欢的编程语言是什么?(应自动 search_memory 召回)
  3. 让 AI 调用一次 recall_directives——能返回「小本本默认约束」域的约束即链路正常。

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