CLI 服务与文件

onemind CLI 服务与文件页面涵盖后台服务、Mind 资料库、更新流程以及每个已安装组件的本地状态。

后台服务

安装程序会注册用户级服务：

• macOS：LaunchAgent，位于 ~/Library/LaunchAgents/com.onemind.cli.daemon.plist
• Linux：systemd 用户服务，位于 ~/.config/systemd/user/onemind.service

检查服务状态：

onemind service status

重启服务：

onemind service stop
onemind service start

移动二进制文件或修复安装后，可以重新创建服务定义：

onemind service install

在 macOS 上，daemon 标准输出写入 ~/Library/Logs/OneMind/daemon.log，错误输出写入 ~/Library/Logs/OneMind/daemon-error.log。

Mind 资料库

Mind 资料库是在团队共享存储配额下、按 Project 隔离的私有文件空间。默认情况下，每次 onemind files 操作都会解析包含当前工作目录的最具体活跃普通 Project binding；若没有匹配，它会关闭式失败，绝不会静默改用 Team Project。只有明确要操作 Team Project 时才添加 --team。同一批文件可在 onemind BETA 应用的 Mind 资料库页面访问。

使用 onemind files 列出完整资料库和配额摘要。使用 --prefix 只查看某个类似目录的路径，或使用 --json 输出机器可读结果：

onemind files
onemind files list --prefix skills/writing
onemind files list --prefix assets --json
onemind files list --team

针对托管 AI 指令的最小单次任务新鲜度检查，请运行：

onemind files check --quiet --wait --ai codex

后台服务通常会在启动、相关服务器事件、身份验证或网络重连时检查已分配文件，并使用具备退避机制的 15 分钟低频回退检查；这个过程不涉及 AI。托管指令会列出已分配的相对路径，并始终通过 --ai 提供确切调用目标，从而避免多工具项目目录产生歧义。命令仅发现 projectIDs 与 aiTargets 赋值与该精确 binding 匹配的文件。它会对本地普通文件进行哈希、拒绝符号链接和特殊文件，并只向服务器发送元数据。文件已是最新时完全静默；批准更新只输出 Updated <path>.。选择"拒绝"会输出稳定机器结果 project_file_refused 并以状态码 3 退出，依赖该文件的工作必须停止，且不得自动重试。若基于请求期限的网络或服务器重试预算耗尽，命令会输出 project_file_wait_exhausted、以状态码 4 退出，并同样禁止自动重试。"延迟"也会以非零状态结束且请求继续保持待处理。状态码为 0 后，调用方必须先读取刷新的本地文件再依赖其内容。

受治理检查目标键：codex、cursor、qoder、claude_code、antigravity、openclaw、opencode、hermes、pi、grok_build、deepseek_harness、trae、workbuddy。Mind 分配上传目标键：codex、cursor、qoder、claude_code、antigravity、openclaw、opencode、hermes、pi、grok_build、deepseek_harness、trae、workbuddy。

过期文件会创建或复用一次性设备范围的请求，可在 onemind BETA 应用的项目文件更新页面选择批准、拒绝、延迟或取消。公开状态固定为 pending、refused、approved_awaiting_apply、applied、expired、conflict 和 failed；延迟会保持 pending。状态等待使用经过身份验证的有界长轮询和重连退避，不进行频繁轮询。一次性批准后，单写入执行器会重新验证两侧哈希和所选项目 head、核验下载内容、在项目检出目录外的 onemind 托管应用状态中保留精确的恢复副本，再通过已刷盘的同目录临时文件替换并确认结果。任何本地、远程、binding、符号链接、特殊文件或到期变化都会导致关闭式失败。关闭等待命令不会取消持久请求，后台服务仍可应用稍后的批准。

已应用身份记录在操作系统 onemind 应用状态目录下的版本化检查点清单中。本地请求/替换证据和恢复副本保存在其旁边，绝不在项目检出目录中。进行中的应用会在 mode 0600 的清单中持久保存设备绑定的尝试 ID、确认幂等键、协商协议、阶段以及轮换短租约，确保崩溃后可恢复同一次性授权。旧服务器 grant 会持久恢复，无需再次申请。终态会清除秘密。恢复存储上限为 100 MiB，未受保护的副本会在七天后清理。

Mind 路径必须是相对路径，并统一使用斜杠分隔。每次上传都必须提供 --ai，明确哪些 AI 目标可以使用该文件。请使用上方的 Mind 分配上传目标键；多个目标可写成 --ai codex,cursor。提交单个文件时，如果没有使用 --to，系统会使用本地文件名。例如，下面的命令会为 ChatGPT（codex）和 Cursor 建议新增 release-review.md：

onemind files upload --ai codex ./release-review.md

使用 --to 可以明确指定 Mind 路径。Prompt 文件通常保存在 prompts/ 下：

onemind files upload --ai codex,cursor --to prompts/release-review.md ./release-review.md

目录会递归上传。--to 是 Mind 目标根路径，目录中的每个后代都会保留其相对路径。假设本地技能目录如下：

writing/
├── SKILL.md
├── examples/
│   └── example.json
└── references/
    └── style.md

使用以下命令上传：

onemind files upload --ai codex,claude_code --to skills/writing ./writing

待审核队列会收到 skills/writing/SKILL.md、skills/writing/examples/example.json 和 skills/writing/references/style.md 的变更建议。如果目录预检发现不支持的格式，上传会在提交任何文件之前停止。

如果没有使用 --to，目录会以本地目录名作为 Mind 根路径。服务器会将每个提交文件与已批准的 Mind main 比较：不存在的路径标记为 新文件，已有路径的变更标记为 新版本，内容完全相同则报告"未变化"且不创建建议。新文件和新版本建议会一直等待，直到管理员在所选项目的 Mind 资料库页面明确批准或拒绝。

多文件建议会按顺序提交。如果后续文件失败，此前的建议仍处于待审核状态，但已批准的 Mind main 不会改变。请先解决错误、在资料库页面检查待审核队列，然后重新运行命令。完全相同的重试会复用已有的待审核建议，不会创建重复项。管理员批准后，系统才会追加不可变的 Mind 提交、在项目历史中保留旧版本，并更新配额用量。

下载操作只处理一个路径完全匹配的 Mind 文件。如果没有使用 --output，CLI 会将文件写入当前目录，并使用 Mind 路径的基础文件名。除非传入 --force，否则不会覆盖已经存在的本地文件：

onemind files download skills/writing/SKILL.md
onemind files download --output ./writing-SKILL.md skills/writing/SKILL.md
onemind files download --force --output ./writing-SKILL.md skills/writing/SKILL.md

删除操作始终要求 --yes。如果没有使用 --recursive，路径必须与一个文件完全匹配。使用 --recursive 时，系统会删除完全匹配的路径，以及 / 路径段边界之后的所有后代；名称相似的同级前缀不会被选中：

onemind files delete --yes prompts/release-review.md
onemind files delete --recursive --yes skills/writing

递归删除同样会按顺序执行，并不具备原子性。如果后续删除失败，之前已经删除的文件不会恢复。请检查该前缀下仍存在的内容、解决错误，然后重新运行同一个已确认命令以完成清理。

资料库中的内容只是静态存储。上传 prompt 文件不会更改当前启用的项目 Mind、发布团队记忆，也不会绕过提案与管理员审核治理。上传技能、脚本、hook 或资产不会在任何设备上安装或执行它们。onemind sync 绝不会更改技能。先运行 onemind skills status；只读的 onemind skills resolve 名称 只为最新技能返回精确校验过的 SKILL.md 路径，不会声称宿主刷新了任务启动时的技能目录。再使用 install、update 或 uninstall 明确选择具体名称。onemind 会校验下载、保护本地修改和项目边界、隔离可恢复文件，并记录每个完成或阻止的操作。

更新 onemind

运行 onemind update --check 只读检查新版本。命令面板中的 检查更新 会执行同样的只读检查。直接运行 onemind update 会显示官方签名安装程序说明、不做任何更改，并以稳定的"需要操作"状态码 3 退出，防止自动化误报更新已经完成。这两条路径都不会停止或启动服务、下载构建产物、替换 CLI 二进制文件或更改本地状态。

后台服务也会在启动时及每隔六小时检查新版本，发现更新后会向 stderr 输出一行提示，并在 macOS 和 Linux 上发送桌面通知。同一版本的提示不会重复出现。

如需安装新版本，请从 CLI 快速开始 重新运行适用于当前操作系统的官方安装命令。公开的 macOS/Linux 更新命令仅安装 CLI，并使用 ONEMIND_INSTALL_APP=0；在 macOS 上，它不会下载、替换、配置或打开 OneMind.app 或 OneMind BETA.app。官方安装程序会同时更新 CLI、已签名的 AI 工具集成包和安装绑定；它不会更改 AI 宿主插件。不要单独替换 CLI 二进制文件，否则集成状态可能进入 repair_required，直到安装完整的签名发行版。完成后，运行被动的 onemind integrations list --json，只对报告需要操作的目标明确安装、更新或修复。

文件和本地状态

同一 Project 和根目录的所有活跃工具绑定共享此队列。守护进程的确定性绑定选择仅用于上传授权路由。schema v11 LearningEvent 不包含生产工具身份，提议响应也完全省略生产工具身份；这种缺失表示生产者不可归属，并不表示被选中的上传工具生成了事件。保留的设备与账号只标识获授权的提交路由和提交者，不标识生成事件的进程。

不要手动修改管理标记。标记缺失、重复、顺序错误或格式损坏时，同步会停止，以免影响用户自己的内容。