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 綁定才能同步。
原生 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 skill。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 | 可用的 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 編輯 | 建立 Project 並提交 Project 更新提案 |
| 批准或拒絕待審 Project 編輯 | 決定待處理的 Project 更新提案 |
| 讀取 BETA Mind、已批准內容及待審更新 | 讀取 Mind 詳情和版本 |
| 即時建立活躍 BETA Mind 並提交內容更新以供審核 | 建立 Mind 並提交 Mind 更新提案 |
| 查看已指派 Project 檔案的新鮮度與刷新狀態 | 比對本地檔案的雜湊值與遠端分配記錄 |
| 請求批准以刷新已指派的 Project 檔案 | 建立審批請求以替換過期的本地 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 形式。