跳至指南

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

macOS AI 工具集成管理器可以安裝、更新或卸載共用插件套件。這不會激活 Project binding 或啟用上傳。Project 指令使用規範目標 workbuddy；上傳要求用戶明確激活的精確 Project binding 已啟用 UploadEnabled。

CodeBuddy 目前的可執行檔案名稱是 codebuddy、codebuddy-code 和 cbc。公開目標別名 codebuddy 對應相容鍵 workbuddy。原生 BETA 可為其註冊的指令適配器綁定 Project 資料夾；宿主已連接時請按 Mind 同步操作。下方仍提供 CLI 發現和顯式啟動流程。僅偵測到路徑不會授權寫入或上傳。onemind 不提供透過 CodeBuddy 管理的技能。Native BETA 同步也會在 ~/.codebuddy/CODEBUDDY.md 維護穩定的全用戶啟動設定；Project 內容保存在已綁定的資料夾中。

使用 onemind integrations（install、update、repair、uninstall）可從 CLI 管理共享外掛程式套件。這些外掛程式操作獨立於綁定精確 Project 資料夾、同步指令及啟用上傳功能。

請先在 CodeBuddy 中以互動方式初始化並登入。被動狀態絕不啟動全新的未歸屬設定檔。如果固定的 ~/.codebuddy 設定檔目錄不存在，明確安裝會在不啟動 CodeBuddy 且不寫入收據的情況下返回 requires_host_initialization。如果刪除該設定檔後仍留有收據，更新和解除安裝會在啟動宿主前返回同一初始化錯誤並保留收據。已有設定檔仍保留 15 秒有界清單預檢；驗證安裝後，被動狀態只驗證收據綁定的本地快照，不會重新啟動 CodeBuddy。

macOS 應用程式

  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 綁定。

對於已啟動的工作區，如果存在普通且非符號連結的 CODEBUDDY.md，它就是標準指令目標；如果不存在，onemind 會保留對 AGENTS.md 的相容性。兩個檔案同時存在時，onemind 只會把當前 WorkBuddy 管理區塊寫入 CODEBUDDY.md。如果 AGENTS.md 仍包含屬於同一個精確 WorkBuddy 綁定的舊管理區塊，onemind 只移除該區塊，並保留其餘每一個位元組、檔案權限和所有用戶編寫的內容。如果優先路徑是符號連結或非普通檔案，同步會停止，不會回退至其他目標。

對於已啟動的工作區，onemind 會同步已審核的記憶；當同步設定中已為該目標啟用上傳時，通用 Project reconciler 會上傳結構化 onemind 提案事件。註冊發現只讀取工作區/工作階段路徑元資料；onemind 絕不讀取 WorkBuddy/CodeBuddy 的聊天或訊息內容，也不會從宿主的任意檔案變更中推導長期知識。