AI 工具指南
请选择以你所用 AI 工具命名的页面。每份指南都会说明哪个 onemind 客户端支持该工具、如何连接、指令文件位置，以及如何确认结果。
CLI 检测到仓库后，仍需在设置流程中把精确目标显式绑定到普通 Project，才能运行 onemind sync；检测不会授予写入或上传权限。原生 BETA 用户请按 Project 与文件夹操作：它准备兼容且已连接的目标，并保持上传关闭。
新增指令同步目标都以 Project 为范围。Codex、Antigravity、Claude Code、OpenClaw、OpenCode、Hermes Agent、Pi、Grok Build、DeepSeek Harness、Cursor、Qoder、TRAE 和 CodeBuddy 都连接到一个明确的本地 Project 目录。当前服务器一次性组合 team 角色的 Project Mind，随后是所选普通 Project 的 project 角色 Mind，CLI 再把该原子包写入该 Project 对应工具的原生指令文件；两者的 Mind 种类都是 project，当前运行时尚不解析已存储的 AI 目标 Mind。已有全局目标仅作为显式迁移状态继续显示，不会提供给新增设置。Cursor 支持 CLI 选择的 Team Project 目标和独立激活的普通 Project 仓库目标。Qoder 和 TRAE 是额外的 CLI 仓库目标。CodeBuddy 使用兼容目标键 workbuddy：发现功能只能建议候选路径，只有用户明确激活的精确 Project binding 才能同步。
原生 BETA Project 同步还维护 Mind 同步所述的工具专属稳定用户级引导区块。此适配器配置独立于旧全局 Team 内容绑定，绝不包含 Project 内容。CLI 目标注册和原生文件夹绑定使用不同的设置路径。
当 Codex、Claude Code 或 Grok Build 任务运行中请求工具权限时，设备所有者可在不暂停任务的情况下，在 Matrix 或 macOS 应用中回应请求。Matrix 编辑器也接受 / 斜杠命令，适用于活跃的 Codex、Claude Code 和 Grok Build 会话。在 Claude Code 会话中，@ 会列出 Claude Code 子智能体；Codex 和 Grok Build 没有子智能体。
能力集成
指令同步与 AI 工具集成是两个独立部分。同步会把已审核的 Mind 写入目标工具的指令文件；集成能力包会加入 onemind skill、经过认证的 MCP 连接，以及宿主支持的原生工具。
使用明确的 onemind integrations 命令（install、update、repair、uninstall）来更改每项集成。官方安装程序只保存已签名集成包；只有这些明确的命令才会更改宿主集成。集成操作也不会安装、更新或移除 Project skills。Codex 集成操作只会更改内置 Codex marketplace/插件；它绝不会运行完整 onemind 安装程序、替换 CLI 或应用、重启服务或打开应用。
在其他操作系统中，请下载 https://onemind.team/downloads/integrations/vVERSION/OneMindIntegrations-VERSION.zip 及其 .sha256 和 .sigstore.json 文件。运行 onemind verify-release-integration VERSION OneMindIntegrations-VERSION.zip OneMindIntegrations-VERSION.zip.sigstore.json 可只读验证发布者。运行 onemind import-signed-integration-release VERSION OneMindIntegrations-VERSION.zip OneMindIntegrations-VERSION.zip.sigstore.json 绝对存储目录 会认证精确字节、保留证据并发布不可变版本。之后仅通过 onemind integrations install 目标 修改宿主；安装器和脚本不会直接修改宿主插件。.sha256 只能检测损坏，不能认证发布者。
| AI 工具 | onemind 集成 |
|---|---|
| Codex | 原生插件 |
| Antigravity | 位于 ~/.gemini/config/plugins/onemind 的文档化应用／CLI agy 插件、位于 ~/.gemini/config/skills 的全局技能，加上独立的 Project 根目录 GEMINI.md 指令同步；原生证明、应用准备与指令同步仍是独立状态；不是旧版 Gemini 扩展 |
| Claude Code | 原生插件 |
| OpenClaw | 原生插件能力包 |
| OpenCode | 共享 skill 能力包位于 ~/.config/opencode/skills/onemind；由于 onemind 无法验证 OpenCode 原生插件或 MCP 生命周期，只显示"能力包已准备" |
| Hermes Agent | 原生 Python 插件 |
| Pi | 原生 Pi 软件包与 TypeScript 扩展 |
| Grok Build | ~/.grok/skills/onemind 共享技能包，插件生命周期为已准备／手动；原生 MCP 连接与 Project 指令同步是独立能力。 |
DeepSeek Harness (dsh) | 共享 skill 能力包位于 ~/.dsh/skills/onemind；由于 dsh 开发者预览版没有可验证的本地插件清单，只显示"能力包已准备" |
| Cursor | Team 与普通 Project 指令同步可用；原生本地 skill/MCP 能力包生命周期使用明确的 cursor-agent JSON 标记探测提供连接证据 |
| Qoder | 原生本地插件命令契约及 skill/MCP 后备方案 |
| TRAE | 共享 ~/.agents/skills/onemind skill + 手动导入 Project MCP；由于 onemind 无法验证界面管理的连接，只显示"能力包已准备" |
| CodeBuddy | 通过 codebuddy、codebuddy-code 或 cbc 使用原生插件；workbuddy 仅是兼容注册键 |
| ChatGPT | 仅支持 Mind 文件分配；没有本地适配器或宿主生命周期 |
| Browser agent | 仅支持 Mind 文件分配；没有本地适配器或宿主生命周期 |
官方安装程序会在执行任何宿主生命周期操作前保存精确且已验证的能力包。先检查状态，再一次明确选择一个目标：
onemind integrations list
onemind integrations status codex
onemind integrations install codex
onemind integrations update codex
onemind integrations uninstall codex
list --json 与 status 目标 --json 分开显示软件包与宿主状态。onemind 绝不搜索当前 Project 的 PATH；非标准宿主位置必须使用 --host-executable 指定一个可信绝对路径。官方 CodeBuddy 2.131.0 在全新配置下运行 plugin list、plugin validate 与模型执行，60 秒内均未产生可用输出；日志反复报告用户设置缺失，随后耗尽文件 watcher 并禁用热重载。被动状态绝不启动未归属配置。当固定的 ~/.codebuddy 配置目录不存在时，明确安装会在不启动 CodeBuddy 的情况下返回 requires_host_initialization；已有配置仍保留 15 秒有界清单预检。Cursor 使用原生收据绑定的本地能力包，只有新鲜的 cursor-agent JSON 标记探测成功后才报告已连接；缺少认证的宿主仍为离线／未验证。TRAE 仍为"能力包已准备／手动配置"，仅 Mind 目标拒绝本地变更，每次变更只允许一个明确目标且不更改 Project skill。实验性 Windows 包装器代码仍仅允许下文记录的原生可执行文件和 npm cmd-shim 模板。
证据范围：Codex 0.146.0-alpha.3.1、Claude Code 2.1.220、OpenClaw 2026.7.1-2、Pi 0.82.0 与 AGY 1.1.9 都在隔离的主目录中，针对本软件包完成了精确的安装、清单、更新或重新安装及卸载生命周期。OpenClaw 与 Pi 共享的软件包标识为 @onemind/onemind；OpenClaw 会以精确 manifest ID onemind 加载，且不会出现软件包名称不匹配警告。Qoder 1.1.5 完成了精确原生生命周期，但不声称已有认证供应商制品 CI。保留的 Hermes 0.19 运行时在仅用于审计的 PYTHONPATH 下完成了发现、启用、停用、移除与全新重装；这仍不能证明全新安装的宿主可用。供应商移除会保留 disabled/override 配置，而重装并启用会清空 disabled 集合。Claude 的全新清单会写入 ~/.claude.json 与备份；OpenClaw 在插件不存在时的检查会写入 SQLite 状态；因此被动状态绝不会启动尚未归 onemind 所有的主机。Claude 的包装器与原生字节符合官方 npm integrity，隔离生命周期也已通过。原生二进制报告 Team ID Q6L2SF6YDW，但严格 codesign/spctl 验证失败；这仍是供应商签名调查，并非 onemind 生命周期失败，onemind 也不作 Apple 签名信任声明。官方 AGY 1.1.9 安装器依据其发布的清单成功完成安装，但本次运行没有独立重新计算压缩制品的哈希；解压后的二进制报告 Team ID EQHXZ8M8AV，且无法完成严格的 Apple 颁发机构／公证验证，因此 onemind 不作 Apple 信任声明。CodeBuddy 命令仍仅由源码确认，因为全新清单超出了上手时间预算。不得把这些精确证据分类扩展成更广泛的版本支持声明。
安装或更新集成后，请新建工具会话。认证仍是独立的按需步骤：在支持 MCP 认证的宿主中批准 onemind OAuth 连接。
AI 工具连接 onemind MCP 服务器时，你可以选择授予哪些权限。每项权限涵盖一组特定的操作，只授予工作流所需的权限即可。授权步骤请参见登录与账户 > 为 CLI 或 AI 工具授权。
| 权限 | 允许的操作 |
|---|---|
| 读取设备和 AI 工具同步状态 | 检查当前同步与设备状态 |
| 读取 Matrix 已批准的 AI 记忆 | 读取已批准的共享团队记忆 |
| 请求已连接设备进行同步 | 请求已连接设备进行同步 |
| 读取 Matrix 项目和待处理编辑 | 列出并读取 Project 详细信息 |
| 创建项目并提交项目编辑 | 创建 Project 并提交 Project 更新提案 |
| 批准或拒绝待处理项目编辑 | 决定待处理的 Project 更新提案 |
| 读取 BETA Mind、已批准内容和待审更新 | 读取 Mind 详情与版本 |
| 立即创建生效的 BETA Mind，并提交内容更新供审批 | 创建 Mind 并提交 Mind 更新提案 |
| 检查已分配项目文件的时效和刷新状态 | 将本地文件哈希与远程分配进行比对 |
| 请求批准刷新已分配的项目文件 | 创建替换过期本地 project 文件的审批请求 |
以上操作均不会直接写入本地文件；文件写入需要在目标设备上通过独立的已审批工作流执行。
从解压后的 marketplace 根目录直接通过 Codex 宿主管理器安装时，已验证的语法是：
codex plugin marketplace add "$ROOT" --json
codex plugin add onemind --marketplace onemind-app --json
插件参数是 onemind，marketplace 通过独立的 --marketplace onemind-app 指定。不要使用未经验证的 onemind@onemind-app 形式。