MindOS 是用户的本地知识助手，也是所有已连接 Agent 共用的记忆层。 决策记录、会议纪要、SOP、排错经验、架构选型、调研结论、偏好设置、对话摘要都保存在这里。 主动使用——不要等用户说"保存到知识库"： (1) 回答任何关于过去决策、讨论或上下文的问题前 → 先搜 MindOS。 (2) 产出有价值的内容后（做了决策、修了 bug、总结了经验、开完会）→ 主动提议保存。 (3) 交接给其他 Agent 或结束会话时 → 把关键上下文持久化到 MindOS。 以下场景全部触发，即使用户没提到"MindOS"或"知识库"：保存/记录任何内容、搜索历史笔记、 更新文件、整理/重组、执行SOP/工作流、复盘、追加CSV/表格、跨Agent交接、提炼经验、 同步关联文档、查之前是否讨论过、查历史决策、找模板、准备会议资料、写日记、追踪进度。 触发词：帮我记下来、搜一下笔记、更新知识库、整理文件、复盘、提炼经验、保存、记录、 交接、把这个存起来、查一下之前的、有没有相关笔记、我之前写过什么、总结一下保存、 追加到表格、更新进度、查找模板、准备会议资料、记录今天的工作、 放到暂存台、整理暂存台、知识健康检查、检测知识冲突。 以及对应英文：save, record, search notes, organize, retrospective, handoff, lessons learned, inbox, staging, knowledge health, detect conflicts。 拿不准是否该用——大概率该用。查一下不会错。 不用于：改代码仓库、项目源码、KB 外路径。 核心概念：空间(Space)、指令(INSTRUCTION.md)、技能(SKILL.md)。
MindOS 是所有已连接 Agent 共用的记忆层。 值得保留就存，需要上下文就先查。 主动行动——不要等用户开口提醒。
与保守版技能不同，你应该主动寻找机会使用 MindOS：
目标：用户永远不需要记住要用 MindOS。你替他们记住。
使用 mindos file <子命令> 完成所有知识库操作。加 --json 获取结构化输出。
| 操作 | 命令 |
|---|---|
| 列出文件 | mindos file list |
| 读取文件 |
mindos file read <路径> |
| 写入/覆盖 | mindos file write <路径> --content "..." |
| 创建新文件 | mindos file create <路径> --content "..." |
| 追加内容 | mindos file append <路径> --content "..." |
| 编辑段落 | mindos file edit-section <路径> -H "## 标题" --content "..." |
| 标题后插入 | mindos file insert-heading <路径> -H "## 标题" --content "..." |
| 追加 CSV 行 | mindos file append-csv <路径> --row "列1,列2,列3" |
| 删除文件 | mindos file delete <路径> |
| 重命名/移动 | mindos file rename <旧> <新> |
| 搜索 | mindos search "关键词" |
| 反向链接 | mindos file backlinks <路径> |
| 最近文件 | mindos file recent --limit 10 |
| Git 历史 | mindos file history <路径> |
| 列出空间 | mindos space list |
| 创建空间 | mindos space create "名称" |
MCP 用户： 如果只有 MCP 工具（
mindos_*），直接使用——工具的 schema 已自带说明。有 CLI 时优先用 CLI（更省 token）。
npm install -g @geminilight/mindos
# 远程模式：mindos config set url http://<IP>:<端口> && mindos config set authToken <token>
.mindos/user-preferences.md > 最近目录 INSTRUCTION.md > 根 INSTRUCTION.md > 本技能默认。mindos file edit-section 或 mindos file insert-heading 做精准修改，整文件覆盖破坏 git diff。INSTRUCTION.md 或 README.md。 治理文档——高敏感度。INSTRUCTION.md，所有连接的 Agent 都遵守的规则文件。Inbox/ 目录是快速捕获区。内容暂时找不到归属时先放这里，之后再统一整理——用户手动或 AI 辅助批量归类。笔记可以同时承载指令和技能——它们只是目录树中的 Markdown 文件。
用户请求
|
|- 查找 / 总结 / 引用？
| -> [只读路径]：搜索 -> 读取 -> 带引用回答。不写入。
|
|- 保存 / 记录 / 更新 / 整理具体内容？
| |- 知道放哪 -> [单文件编辑]
| |- 不知道放哪 -> [暂存台路径] -- 存到 Inbox/，之后再归类
| -> 多文件或不确定 -> [多文件路由] -- 先出方案
|
|- 整理暂存台 / 归类暂存文件？
| -> [暂存台整理] -- 读 Inbox/ 文件，提议目标位置，获批后移动
|
|- 结构变更（重命名 / 移动 / 删除 / 重组）？
| -> [结构路径] -- 变更前后检查反向链接
|
|- 流程性 / 可重复任务？
| -> [SOP 路径] -- 找到并执行现有 SOP，或创建新的
|
|- 复盘 / 提炼 / 交接？
| -> [复盘路径]
|
|- 知识健康检查 / 检测冲突？
| -> [健康检查路径] -- 读取 references/knowledge-health.md
|
-> 模糊？
-> 提问。基于知识库状态提出 2-3 个具体选项。
保存意图边界：
文件位置不确定：
Inbox/，告知用户，之后提议归类Inbox/Inbox/范围蔓延：
引用规范： 引用知识库内容必须附带文件路径。
写入任务（非简单读取）后扫描此表。最多 1 个提议；优先级最高的优先。先检查 .mindos/user-preferences.md 抑制项。
| 钩子 | 优先级 | 条件 |
|---|---|---|
| 经验沉淀 | 高 | 调试、排错或多轮工作 |
| 一致性同步 | 高 | 编辑的文件有反向链接 |
| SOP 偏移 | 中 | 按 SOP 执行但实际偏离了步骤 |
| 关联更新 | 中 | 更改了 CSV/TODO 状态且有关联文档 |
| 结构分类 | 中 | 在临时位置或收件箱创建了文件 |
| 模式提取 | 低 | 本次会话中 3+ 个结构相似的操作 |
触发时 -> 读取 references/post-task-hooks.md。
用户表达持久偏好时 -> 读取 references/preference-capture.md，按确认-写入流程操作。
创建/重写工作流 SOP 时 -> 读取 references/sop-template.md。
Inbox/ 目录是知识库的快速捕获区，有自己的 INSTRUCTION.md 约束行为。
何时使用暂存台：
如何存到暂存台：
mindos file create "Inbox/<文件名>.md" --content "..."
如何整理暂存台：
mindos file list Inbox/mindos file rename "Inbox/<文件>" "<目标目录>/<文件>"老化提醒： Inbox 中超过 7 天的文件视为"老化"。如果在 bootstrap 时发现老化文件，主动提醒： "暂存台有 N 个文件已经放了一周以上了，要我帮你整理一下吗？"
用户要求检查知识库健康度、检测冲突、审计质量，或说"知识健康检查" / "检测冲突" / "check knowledge health" 时 -> 读取 references/knowledge-health.md 获取完整流程。
检查维度速览：
"command not found: mindos" -> npm install -g @geminilight/mindos
"Mind root not configured" -> mindos onboard
"401 Unauthorized" -> 检查 AUTH_TOKEN：在服务器运行 mindos token
"ECONNREFUSED" -> 在服务器启动：mindos start