跳至指南

在 CodeBuddy 中使用 onemind（兼容旧版 WorkBuddy）

macOS AI 工具集成管理器可以安装、更新或卸载共享插件包。这不会激活 Project binding 或启用上传。Project 指令使用规范目标 workbuddy；上传要求用户明确激活的精确 Project binding 已启用 UploadEnabled。

CodeBuddy 当前的可执行文件名称是 codebuddy、codebuddy-code 和 cbc，onemind 通过它们连接到 CodeBuddy。公开目标别名 codebuddy 映射到兼容键 workbuddy。原生 BETA 可为其注册的指令适配器绑定 Project 文件夹；宿主已连接时请按 Mind 同步操作。下方仍提供 CLI 发现和显式激活流程。仅检测到路径不会授权写入或上传。onemind 不通过托管方式向 CodeBuddy 提供 Skill。原生 BETA 同步还会在 ~/.codebuddy/CODEBUDDY.md 维护稳定的用户全局 bootstrap；Project 内容保留在已绑定的文件夹中。

使用 onemind integrations（install、update、repair、uninstall）通过 CLI 管理共享插件包。这些插件操作与绑定精确 Project 文件夹、同步指令和启用上传相互独立。

请先在 CodeBuddy 中交互式初始化并登录。被动状态绝不启动全新的未归属配置。如果固定的 ~/.codebuddy 配置目录不存在，明确安装会在不启动 CodeBuddy 且不写收据的情况下返回 requires_host_initialization。如果删除该配置后仍留有收据，更新和卸载会在启动宿主前返回同一初始化错误并保留收据。已有配置仍保留 15 秒有界清单预检；验证安装后，被动状态只检查收据绑定的本地快照，不会重新启动 CodeBuddy。

macOS app

  1. 登录 OneMind BETA.app，从团队连接 CodeBuddy。
  2. 打开 Mind，选择目标 Project，并在这台 Mac 上绑定其确切文件夹。
  3. 打开已批准的 Mind，选择同步，检查工具/设备，然后选择立即同步。等待确认送达。
  4. 从该文件夹启动新的 CodeBuddy 会话。请参阅 Mind 同步 了解待处理、离线及恢复状态。

CLI

  1. 在 CodeBuddy 中打开工作区。
  2. 运行 onemind project codebuddy . 检测工作区。CLI 会打印提示，要求你打开 onemind 并为检测到的文件夹选择 Project Mind。
  3. 打开 onemind 应用，在同步设置中找到检测到的文件夹，并将其绑定到目标 Project Mind。
  4. 运行 onemind sync。
  5. 运行 onemind status。
  6. 确认所选的 <工作区>/CODEBUDDY.md 或 <工作区>/AGENTS.md 包含 onemind 管理区块。
  7. 新建 CodeBuddy 会话。

首次写入时，onemind 会将旧版文件保存至 <工作区>/.one-mind/CODEBUDDY.md.backup（若回退到 AGENTS.md，则为 .one-mind/AGENTS.md.backup）。

onemind 会检查 CodeBuddy 与旧版 WorkBuddy 的应用和配置位置，包括 ~/CodeBuddy 与 ~/WorkBuddy 下的候选默认路径。发现会以只读方式打开 CodeBuddy/WorkBuddy 注册数据库，且只查询工作区/会话路径元数据，绝不读取聊天或消息内容。在非 macOS 系统上，必须确保 sqlite3 已加入 PATH，以便发现工作区。发现结果仅供提示；同步和上传只会作用于用户明确激活的那个 Project binding。

对于已激活的工作区，如果存在普通且非符号链接的 CODEBUDDY.md，它就是规范指令目标；如果不存在，onemind 会保留对 AGENTS.md 的兼容。两个文件同时存在时，onemind 只会把当前管理区块写入 CODEBUDDY.md。如果 AGENTS.md 仍包含属于同一个精确 WorkBuddy binding 的旧管理区块，onemind 只移除该区块，并保留其余每一个字节、文件权限和所有用户编写的内容。如果优先路径是符号链接或非普通文件，同步会停止，不会回退到其他目标。

对于已激活的工作区，onemind 会同步已审核记忆；当目标在同步设置中启用了上传时，通用 Project reconciler 会上传结构化 onemind 提案事件。注册发现只读取工作区/会话路径元数据；onemind 绝不读取 WorkBuddy/CodeBuddy 的聊天或消息内容，也不会从宿主的任意文件变化中推导长期知识。