CLI 命令参考
onemind CLI 命令参考列出了当前版本所有可用的 Shell 命令、命令面板操作、用户角色和同步模式。
浏览命令面板
| 输入 | 结果 |
|---|---|
| 输入文字 | 按名称或说明筛选命令；支持模糊匹配。 |
| 上 / 下方向键 | 在可见命令之间移动。 |
| Enter | 运行选中的命令。 |
| Escape | 从结果页面返回命令面板。 |
| Backspace / Delete | 删除最后一个搜索字符。 |
| Ctrl+C | 从任何页面退出 onemind。 |
命令参考
Shell 命令
这些命令直接在 macOS 或 Linux 终端中运行：
| Shell 命令 | 用途 |
|---|---|
onemind | 打开交互式命令面板。 |
onemind help | 显示直接 shell 命令概览。 |
onemind propose "文本" | 将新的 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 | 从所选项目删除精确文件或目录式前缀；必须明确传入 --yes。 |
onemind projects list [--json] | 列出当前登录团队可见的所有项目。 |
onemind projects show 项目_ID [--json] | 查看一个确切项目，包括待处理编辑和 Mind 文件提案数量。 |
onemind projects create --name 名称 --key 键 --goal 目标 --description 描述 [选项] | 创建普通项目。需要管理员权限；可按需使用 --id、--status、--health、--message 或 --json。 |
onemind projects edit 项目_ID [字段选项] | 只编辑所选元数据，并保留现有项目章节和成员工具分配。团队编辑通常会生成审批草稿。 |
onemind projects approve 项目_ID 草稿_ID [--json] | 批准一个确切的待处理项目编辑。当前管理员可以批准自己的草稿。 |
onemind projects reject 项目_ID 草稿_ID [--json] | 拒绝一个确切的待处理项目编辑。需要管理员权限。 |
onemind project 工具 项目路径 | 把明确指定的目录检测为 Codex、Antigravity、Claude Code、OpenClaw、OpenCode、Hermes Agent、Pi、Grok Build、DeepSeek Harness、Cursor、Qoder、TRAE 或 CodeBuddy (workbuddy) 的 Project 范围目标。项目路径为必填项；在同步设置绑定普通 Project 之前，该目标保持不活动。 |
onemind cursor [项目路径] | 用于检测 Cursor Project 目标的兼容性简写。 |
onemind qoder [项目路径] | 通过代码仓库根目录的 AGENTS.md 检测 Qoder Project 目标的兼容性简写。 |
onemind trae [项目路径] | 用于检测 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] | 只读检查与当前项目关联的技能并报告本地状态，不更改文件。 |
onemind skills resolve 名称 | 把一个已安装且为最新的项目技能解析为精确校验过的 SKILL.md 路径，供当前运行中的任务直接使用。 |
onemind skills install 名称... | 仅下载、校验并安装明确选择且尚未安装的项目技能。 |
onemind skills update 名称... | 仅校验并更新明确选择的过期托管技能；旧文件会移入隔离区。 |
onemind skills uninstall 名称... | 仅把明确选择的项目托管技能卸载到可恢复隔离区。 |
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] | 为指定目标安装内置的已签名集成。 |
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 集成；仅当插件与当前已签名包完全匹配时才写入生命周期 receipt。 |
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 二进制文件或项目文件。 |
命令面板操作
运行 onemind 并从显示的选项中选择。已登录时显示三项，未登录时显示两项：
| 命令面板操作 | 作用 | 可用角色 |
|---|---|---|
| 同步 | 强制应用云端包，并重试上传队列中的建议。应用后，在默认应用程序中打开所有已同步的 Markdown 指令文件。 | 成员、管理员 |
| 状态 | 输出已安装版本、已连接团队、Mind 状态和设备同步状态。 | 成员、管理员 |
| 退出登录 | 撤销此终端会话并删除已保存的凭据。 | 成员、管理员 |
| 登录 | 在浏览器中授权此终端。 | 未登录用户 |
| 检查更新 | 检查官方发布渠道，但不更改当前安装。 | 未登录用户 |
用户角色
| 能力 | 未登录 | 成员 | 管理员 |
|---|---|---|---|
| 登录 | 是 | — | — |
| 检查更新 | 是 | 是 | 是 |
| 连接、查看和同步项目 | — | 是 | 是 |
| 列出、上传、下载或删除 Mind 资料库内容 | — | 是 | 是 |
| 在一台设备上开启个人 skill/工作历史分析 | — | 是 | 是 |
| 查看团队和活动信息 | — | 是 | 是 |
| 审核知识提案 | — | — | 是 |
| 邀请、调整角色、移除或撤销成员（通过团队和 AI 工具） | — | — | 是 |
| 退出登录 | — | 是 | 是 |
同步模式
每个 Project 目标在你于同步设置中选择其 Project Mind 后即开始同步；此后，后台同步和同步会将已批准的记忆应用到该目标。早期单项目设置还会存储 auto、manual 或 disabled 同步模式，但当前版本已不再允许更改。