CLI 命令參考
onemind CLI 命令參考列出了目前版本中所有可用的 shell 命令、命令面板操作、用戶角色和同步模式。
瀏覽命令面板
| 輸入 | 結果 |
|---|---|
| 輸入文字 | 按名稱或說明篩選命令；支援模糊匹配。 |
| 上 / 下方向鍵 | 在可見命令之間移動。 |
| Enter | 執行選中的命令。 |
| Escape | 從結果頁面返回命令面板。 |
| Backspace / Delete | 刪除最後一個搜尋字元。 |
| Ctrl+C | 從任何頁面退出 onemind。 |
命令參考
Shell 命令
這些命令直接在 macOS 或 Linux 終端機中執行：
| Shell 命令 | 用途 |
|---|---|
onemind | 開啟互動式命令面板。 |
onemind help | 顯示直接 shell 命令概覽。 |
onemind propose "TEXT" | 將新的 Mind 條目加入佇列並立即上傳，等待管理員審核。 |
onemind propose [--kind KIND] --file PATH | 從檔案提交較長的 Markdown 內容；使用 --file - 可從標準輸入讀取。--kind 指定提案類別（1–64 個小寫字母、數字、連字號或底線；預設為 prompt_observation）。 |
onemind propose --help | 顯示提案輸入方式和選項。 |
onemind files | 列出當前目錄所綁定普通項目的 Mind 檔案；等同於 onemind files list。 |
onemind files list [--team] [--prefix PATH] [--json] | 列出當前普通項目的 Mind 檔案。--team 是前往 Team Project 的明確安全路徑。 |
onemind files check [--ai TARGET] [--quiet] [--wait] | 僅比較分配給精確當前項目和 AI 目標的 Mind 檔案與本地普通檔案。只發送身份和 SHA-256 元資料，不發送檔案內容，並建立或輪詢裝置範圍的替換批准。--wait 需搭配 --quiet 使用。 |
onemind files upload [--team] --ai TARGET[,TARGET...] [--to MATRIX_PATH] LOCAL_PATH | 將一個 UTF-8 .md、.markdown、.txt、.json、.yaml、.yml 或 .toml 檔案，或只包含這些格式的目錄，作為 Mind 檔案變更提案提交。--ai 為必填項，接受以下列出的每個 Mind 分配上傳鍵；多個目標以逗號分隔。管理員批准每個提案前，Mind main 不會更改。 |
onemind files download [--team] [--output LOCAL_PATH] [--force] MATRIX_PATH | 從所選項目下載一個精確 Mind 檔案。--force 只授權此次直接下載；絕不會視為受治理的替換批准。 |
onemind files delete [--team] [--recursive] --yes MATRIX_PATH | 從所選項目刪除一個精確 Mind 檔案，或使用 --recursive 刪除整個路徑前綴。必須明確傳入 --yes 確認。 |
onemind projects list [--json] | 列出當前登入團隊可見的所有 Project。 |
onemind projects show PROJECT_ID [--json] | 查看一個精確 Project，包括待處理編輯和 Mind 檔案提案數量。 |
onemind projects create --name NAME --key KEY --goal GOAL --description TEXT [options] | 建立普通 Project。需要管理員權限；可按需使用 --id、--status、--health、--message 或 --json。 |
onemind projects edit PROJECT_ID [field options] | 只編輯所選元資料，並保留現有 Project 章節和成員工具分配。團隊編輯通常會生成審批草稿。 |
onemind projects approve PROJECT_ID DRAFT_ID [--json] | 批准一個精確的待處理 Project 編輯。當前管理員可以批准自己的草稿。 |
onemind projects reject PROJECT_ID DRAFT_ID [--json] | 拒絕一個精確的待處理 Project 編輯。需要管理員權限。 |
onemind project TOOL PROJECT_PATH | 將指定目錄偵測為 Codex、Antigravity、Claude Code、OpenClaw、OpenCode、Hermes Agent、Pi、Grok Build、DeepSeek Harness、Cursor、Qoder、TRAE 或 CodeBuddy（workbuddy）的 Project 範圍目標。路徑為必填項；在同步設定綁定普通 Project 之前，該目標保持閒置。 |
onemind cursor [PROJECT_PATH] | 偵測 Cursor Project 目標的相容簡寫。 |
onemind qoder [PROJECT_PATH] | 透過儲存庫根目錄 AGENTS.md 偵測 Qoder Project 目標的相容簡寫。 |
onemind trae [PROJECT_PATH] | 偵測 TRAE Project 目標的相容簡寫。 |
onemind sync | 強制應用套件並重試已排隊的提案上傳。套用後，在預設應用程式中開啟每個已同步的 Markdown 指令檔案。 |
onemind sync-status [--mine | --team] [--json] | 顯示即時的本機和 AI 工具同步狀態。 |
onemind sync-backup list [--json] | 列出此裝置上的 Mind 同步還原點。 |
onemind sync-backup restore ID --yes | 從 Mind 同步備份還原指令檔案。 |
onemind skills status [--json] | 只讀檢查與精確 Project 關聯的技能並報告本地狀態，不更改檔案。 |
onemind skills resolve NAME | 將一個已安裝且為最新的 Project 技能解析為精確校驗過的 SKILL.md 路徑，供當前執行中的任務直接使用。 |
onemind skills install NAME... | 僅下載、校驗並安裝明確選擇且尚未安裝的 Project 技能。 |
onemind skills update NAME... | 僅校驗並更新明確選擇的過期受管理技能；舊檔案會移入隔離區。 |
onemind skills uninstall NAME... | 僅將明確選擇的 Project 受管理技能解除安裝至可恢復隔離區。 |
onemind analyze on | 在此裝置上啟用有界限的 Codex skill 和 onemind 工作歷史分析。 |
onemind analyze off | 立即停止本地分析讀取，並在雲端可達時停用雲端授權。 |
onemind analyze status [--json] | 顯示本地授權、雲端授權和共享 Security Check provider 狀態。 |
onemind analyze now | 立即分析發生變化的受支援來源；必須先啟用分析。 |
onemind status | 顯示已安裝版本、已連接團隊、Mind 狀態和裝置同步狀態。 |
onemind memory | 預覽已批准的共享記憶。 |
onemind review | 列出知識提案；需要管理員權限。 |
onemind approve ID | 批准提案並發布新的共享記憶版本；需要管理員權限。 |
onemind reject ID | 拒絕提案；需要管理員權限。 |
onemind mind backups [--path PATH] [--json] | 列出指定路徑指令檔案的本地 Mind 備份。 |
onemind mind restore ID --path PATH --file FILENAME [--json] --yes | 還原 onemind 接管前的備份或先前已套用的 Mind。傳入 pre-onemind 作為 ID 可還原原始 onemind 接管前的檔案。 |
onemind mind-check member --harness PATH[,PATH...] [--subject PATH] [--project ID] [--json] | 執行 Mind Check Station（成員角色）；僅警告，從不阻止同步。 |
onemind mind-check manager --subject PATH [--project ID] [--json] | 執行 Mind Check Station（管理員角色）；僅警告，從不阻止同步。 |
onemind minds list [--json] | 列出登入團隊可見的 BETA Minds。 |
onemind minds show MIND_ID [--json] | 查看一個 BETA Mind。 |
onemind minds create --id ID --name NAME --key KEY --purpose TEXT --file PATH --idempotency-key KEY [--project PROJECT_ID] [--file-name mind.md] [--json] | 建立 BETA Mind。需要管理員權限。 |
onemind minds update MIND_ID --file PATH --title TEXT --expected-version N --expected-source-hash HASH [--details TEXT] [--file-name NAME] [--json] | 為 BETA Mind 提議更新，以進行 Safe Check 和審核。 |
onemind version | 顯示已安裝的 CLI 版本。 |
onemind update --check | 檢查官方發佈頻道，但不更改當前安裝。 |
onemind update | 顯示官方簽名安裝程式說明，不更改當前安裝，然後以「需要操作」狀態碼 3 退出。它絕不會只替換 CLI 二進位檔案。 |
onemind logout | 登出此 CLI 工作階段並隔離其本機 Project 資料。 |
onemind server URL | 設定 onemind API 基礎網址。更改伺服器後，舊伺服器的已儲存憑證將會移除；之後請重新登入。 |
onemind integrations list [--json] [--app-binding ABSOLUTE_PATH] | 列出已簽名的整合套件及其狀態。 |
onemind integrations status TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | 顯示一個整合的詳細狀態。 |
onemind integrations install TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | 安裝 TARGET 的已綁定已簽名整合。 |
onemind integrations update TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | 將已安裝的整合更新至當前已簽名套件。 |
onemind integrations uninstall TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | 解除安裝一個整合。 |
onemind integrations repair TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | 修復損壞或不一致的整合。 |
onemind integrations capabilities --json --app-binding ABSOLUTE_PATH | 列出應用程式綁定的整合能力（macOS 應用程式 Codex 連接流程）。 |
onemind integrations adopt codex --json --app-binding ABSOLUTE_PATH [--host-executable ABSOLUTE_PATH] | 採用現有 Codex 整合；僅在外掛程式與當前已簽名套件完全匹配時才寫入生命週期收據。 |
onemind session status | 以 JSON 格式輸出不含密鑰的 CLI 工作階段身份。 |
onemind config restore-pre-v9 | 從 v9 遷移前還原已驗證的設定快照。 |
onemind verify-session --tool TOOL [--host-adapter ABSOLUTE_PATH] | 報告 TOOL 的本地指令檔案加密就緒狀態，或透過明確的已認證 --host-adapter 產生伺服器接受的最新工作階段驗證。本地就緒狀態並非宿主已驗證的憑證。 |
onemind verify-release-integration VERSION ARCHIVE SIGSTORE_BUNDLE | 驗證已簽名的 AI 工具整合封存檔，不解壓或修改本地狀態。 |
onemind import-signed-integration-release VERSION ARCHIVE SIGSTORE_BUNDLE STORE | 發布已認證的不可變整合世代。 |
onemind install-signed-integration-release VERSION ARCHIVE SIGSTORE_BUNDLE STORE PROFILE_HOME | 安裝先前匯入的已簽名整合版本。 |
onemind daemon run | 在前台執行同步 daemon。正常情況下由作業系統服務執行。 |
onemind service install | 建立並註冊每個用戶的背景服務。 |
onemind service start | 啟動已註冊的服務。 |
onemind service stop | 停止已註冊的服務。 |
onemind service status | 向作業系統查詢服務狀態。退出狀態為 0 表示服務可用。 |
onemind service uninstall | 停止並取消註冊服務，同時移除其服務定義。不會刪除 CLI 二進位檔案或 project 檔案。 |
命令面板操作
執行 onemind 並從顯示的項目中選取。登入後顯示三個項目，未登入時顯示兩個項目：
| 命令面板操作 | 作用 | 可用角色 |
|---|---|---|
| 同步 | 強制應用套件並重試已排隊的提案上傳。套用後，在預設應用程式中開啟每個已同步的 Markdown 指令檔案。 | 成員、管理員 |
| 狀態 | 顯示已安裝版本、已連接團隊、Mind 狀態和裝置同步狀態。 | 成員、管理員 |
| 登出 | 撤銷此終端工作階段並移除其已儲存的憑證。 | 成員、管理員 |
| 登入 | 為此終端開啟瀏覽器授權。 | 未登入用戶 |
| 檢查更新 | 檢查官方發佈頻道，但不更改當前安裝。 | 未登入用戶 |
用戶角色
| 能力 | 未登入 | 成員 | 管理員 |
|---|---|---|---|
| 登入 | 是 | — | — |
| 檢查更新 | 是 | 是 | 是 |
| 連接、查看和同步項目 | — | 是 | 是 |
| 列出、上傳、下載或刪除 Mind 資料庫檔案 | — | 是 | 是 |
| 在一台裝置上啟用個人 skill/工作歷史分析 | — | 是 | 是 |
| 查看團隊和活動資訊 | — | 是 | 是 |
| 審核知識提案 | — | — | 是 |
| 邀請、調整角色、移除或撤銷成員（透過團隊與 AI 工具） | — | — | 是 |
| 退出登入 | — | 是 | 是 |
同步模式
每個 Project 目標在你於同步設定中選擇其 Project Mind 後開始同步；此後，背景同步和同步會把已核准的記憶套用到該目標。較早的單一項目設定亦會儲存 auto、manual 或 disabled 同步模式，現時版本已不再提供更改方式。