安装指南

注册账号 → 下载客户端 → 用绑定票或密钥把本机接上云端。多台设备各绑一次，之后自动同步。

一、注册账号

打开 account.xiaobenben.net 用手机号注册并登录。登录后你就有了一个个人云端空间。

二、下载客户端

云端版仍然需要装客户端——它才是 AI 的接入点（MCP 服务）。下载地址与本地版完全相同：

操作系统	文件名	下载地址
Windows x64	`xbb-windows-x64.exe`	`https://dl.xiaobenben.net/latest/xbb-windows-x64.exe`
macOS（Apple Silicon）	`xbb-darwin-arm64`	`https://dl.xiaobenben.net/latest/xbb-darwin-arm64`
macOS（Intel）	`xbb-darwin-x64`	`https://dl.xiaobenben.net/latest/xbb-darwin-x64`
Linux x64	`xbb-linux-x64`	`https://dl.xiaobenben.net/latest/xbb-linux-x64`

放到 ~/.xiaobenben/bin/（Windows 为 %USERPROFILE%\.xiaobenben\bin\），重命名为 xbb / xbb.exe。

云端模式的检索在服务端跑，本机不需要向量增强包。

三、绑定这台设备

在账号中心拿到绑定凭据，二选一：

方式 A：绑定票（推荐，一次一用）

控制台里点「绑定设备」，会生成一张 60 秒内有效、只能用一次的票，并唤起 xubb:// 协议：

xbb bind <票>

票过期或已用过就重新生成一张。这种方式适合只绑一台机器。

方式 B：长期密钥（多机共用 / 误删恢复）

在控制台复制长期密钥：

xbb bind-key <密钥>

密钥可以绑多台设备，也用于”我不小心删了配置，想恢复”的情形。因为它长期有效，不要贴到聊天记录、截图或代码仓库里。

四、确认模式

xbb cloud

应该看到类似：

模式: 云端 · 你的空间  @ https://api.xiaobenben.net

如果显示”本地（仅本机）“，说明绑定没生效。也可以在托盘菜单里切换，或打开管理窗口 http://127.0.0.1:17630/ui。

五、接进 AI 客户端

配置与本地版完全一致（因为就是同一个程序），只是启动时会按当前模式路由到云端：

Claude Code

claude mcp add xiaobenben -- ~/.xiaobenben/bin/xbb mcp

opencode（~/.config/opencode/opencode.json，command 是数组）

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

WorkBuddy（~/.workbuddy/mcp.json）

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

改完彻底重启客户端（关窗口不算），WorkBuddy 还要去「连接器 → 自定义连接器」里授权。

六、第二台设备

在同一账号下重复第三步（用长期密钥，或再生成一张票），然后用同样的方式接入客户端。

不需要任何”同步”动作：两台设备各自读写云端，写入即互见。

迁移已有本地记忆

本机原来跑过本地版、库里已经有东西，绑定云端后不会自动上云。这一点必须清楚：

云端模式下新写入的记忆直接进云；
本地库仍然是本地库，切回 xbb cloud off 就能看到；
想把手上的本地记忆搬到云端，需要在云端模式下让 AI 重新整理写入（或联系我们协助迁移）。

没有任何”一键把本地库推上云”的按钮，是刻意的：那等于把你的全部历史一次性上传，而这个决定该由你明确做出。

常见卡点

绑定票总是过期 —— 它是 60 秒单用票，生成后要立刻用。多机绑定请用长期密钥。

xubb:// 点了没反应 —— 协议处理器没注册，执行 xbb register-protocol 注册一次。

绑定成功但 AI 记不住 —— 先 xbb cloud 确认模式，再确认客户端已彻底重启（MCP 配置只在启动时读）。

公司网络连不上 —— 云端版需要访问 api.xiaobenben.net。被代理或防火墙拦截时会表现为工具调用超时，此时可临时 xbb cloud off 用本地模式。

需要协助