Obsidian Mind
为 AI 编程助手提供跨会话、可检索的持久记忆。
按维度查看评分与理由
材料详细说明了本地模型、索引隔离、公开根目录、private 标签、读取日志、仓库作用域记忆、迁移确认和 Git 更新路径；测试还验证了目录穿越输入被拒绝，并强调复制而非删除。作者、设计影响和 MIT 版权归属清晰，因此来源归属充分。扣分在于日常流程会自动写入和重组大量个人及工作笔记，跨仓库会话仍可直接读取保险库，README 明言防止内容进入公开 PR 主要依赖提示契约而非强制访问控制；Slack、GitHub 和 MCP 等外部读取的具体授权边界未由所给实现文件完整证明。依赖方面只有版本要求、可选回退和少量 CI 配置，没有锁文件、依赖审计、SBOM、哈希固定或漏洞处置证据。
README 的架构、命令、生命周期和回退叙述总体一致，所给测试对卫生扫描、路径过滤、缺失目录、超时和清理失败报告提供了实质支持。QMD 缺失时的词法回退、CPU 回退、环境诊断和明确的 Node 要求改善了依赖可用性。扣分是大量 MCP、跨客户端、迁移、分类和命令行为只有文档陈述，未提供相应实现或测试；错误信息证据集中在测试辅助函数和卫生提示，尚不足以证明所有安装、外部集成及写入路径都有一致的可操作故障反馈。
材料覆盖个人记忆、项目管理、会议、事故、评审和跨仓库知识等明确场景，并给出 Claude Code、Codex CLI、Gemini CLI 及其他客户端的不同支持级别。能力边界写得尤其清楚，包括 QMD 可选性、仅 Claude 支持的自动记忆加载器、文件夹名冲突、肯定性 MCP 指令可能被忽略、模型下载和 Node 标志风险。五类钩子的触发时点、输入类别、排除条件、预算与退化规则也很精确。扣分主要在环境适配：三种主要客户端及 MCP 的完整兼容性未由所给配置或集成测试交叉证明，其他客户端明确只有部分支持。
信息架构、目录职责、模板字段、命令命名和日常流程非常完整；克隆、ShardMind、QMD、升级、迁移及 dry-run/审批步骤均有具体说明。已明确记录模型体积、性能代价、文件夹名冲突、Node 实验性标志和不同客户端支持差异，MIT 正文也完整提供。扣分是没有正式 FAQ，示例虽多但部分外部集成示例依赖未提供的实现；CHANGELOG 和版本清单仅被提及而未作为证据提供。维护方面有具名作者、贡献规则、PR 标题检查和更新路径，但缺少维护承诺、支持渠道、发布责任或多人治理说明；发布者未验证只表示身份未知，并非风险推断。
输出设计直接面向使用：结构化笔记、决策记录、事故时间线、评审简报、索引、反向链接和卫生提示均有清晰落点，测试还表明部分卫生反馈具备具体、可操作的措辞。分层加载、注入预算、本地搜索模型、关键词降级以及不同搜索模式的成本说明，使成本收益较透明。扣分在边际价值上：持久记忆和自动整理的整套收益主要来自 README 的产品叙述，未提供实际生成样本、用户比较或覆盖核心工作流的静态实现证据来充分证明其相对普通 Obsidian 模板与代理指令的增量效果。
部分主张可追溯到 LICENSE、CI 工作流和具名测试，测试注释也将若干行为关联到具体故障模式，并区分成功删除、残留记录、路径拒绝和可清除卫生状态。扣分是主要产品能力集中在一份翻译 README 中，关键 MCP、隐私、迁移、跨客户端和成本记录实现未随材料提供，因而只能有限交叉印证。材料确实显式使用 verified、inferred、unverified，并披露若干测量条件和失败边界；但诸如存储会随增长而更可靠、跨客户端完整支持和实测效果等营销性结论没有足够独立证据，事实与推论的分隔尚非全面。
- 该保险库可能包含雇主机密、客户资料、会议记录和绩效信息；在连接其他仓库或生成公开 PR 前，应把提示契约视为软控制，并另行检查实际文件权限、公开根目录和输出内容。
- 启用 Slack、GitHub、MCP、QMD 或 reason 功能前，应核验各工具的真实权限、认证继承、读取日志、网络行为及数据保留方式；这些边界未被所给实现文件完整证明。
- 自动写入、重组和升级前应使用独立分支或备份，并先执行 dry-run；Git 和三方合并提供恢复路径，但不保证所有代理生成的内容变更都容易撤销。
- 安装会引入 Node、ShardMind、QMD、GitHub Actions 和多个本地模型；应补做依赖锁定、来源校验和漏洞审查，尤其是全局 npm 安装与首次模型下载。
- Codex、Gemini 及跨仓库 MCP 的完整行为需要在真实环境中另行验证；本评估未执行代码，也不评价运行正确性或可复现性。
这个 Agent 能做什么，适合哪些场景？
Obsidian Mind 是一个可自托管的 Obsidian 仓库模板，把项目、人员、决策、事故、绩效证据和长期经验保存为 Markdown 笔记与双向链接。它通过 SessionStart、UserPromptSubmit、PostToolUse、PreCompact 和 Stop 生命周期钩子，为 Claude Code、Codex CLI 与 Gemini CLI 注入上下文并检查写入结果。仓库包含命令、专用子代理、模板、Bases 数据视图、TypeScript 钩子脚本，以及供其他代码仓库访问知识库的 om MCP 服务。QMD 可选地提供本地混合语义检索；未安装时，系统退回到 grep、Obsidian CLI 和词法匹配。所有持久内容保存在用户控制的本地文件系统中，并可通过 Git 跨设备同步，但使用者需要接受明确的目录、frontmatter 和链接约定。
启动会话时，SessionStart 会重新索引或修复 QMD，并在字节预算内载入 North Star 摘要、活跃项目、未完成任务、近期 Git 变更和仓库文件列表。UserPromptSubmit 对每条消息进行分类，识别决策、事故、成果、1:1、架构、人员和项目更新，再给出归档提示；PostToolUse 在 Markdown 写入后验证 frontmatter、wikilink、文件位置和笔记大小。用户可运行 om-standup、om-dump、om-wrap-up、om-weekly、om-review-brief、om-incident-capture、om-vault-audit 等命令，生成或更新项目笔记、决策记录、事故文档、人员档案、Brag Doc、评审材料和索引。PreCompact 将会话转录备份到 thinking/session-logs/，Stop 则执行结束检查并报告知识库卫生问题。可选的 om MCP 服务向其他代码仓库暴露 search、expand、recall、remember、record_work、reason 和 health，并依据项目身份、作用域、置信度和暴露策略控制跨仓库读取与记忆写入。
- 同时维护多个代码项目的工程师，希望新会话能自动恢复目标、活跃工作、阻塞项和最近决策。
- 需要记录架构取舍的团队成员，希望把决策、被否决方案和相关项目笔记连接成可追踪的证据链。
- 准备绩效评审的开发者，希望持续汇总成果、能力证据、1:1 反馈、事故贡献和同事 PR 证据。
- 事故响应人员需要从 Slack 记录整理时间线、根因分析、参与者档案及后续行动；相关深度扫描仍取决于相应外部访问能力。
- 拥有多个代码仓库的个人，希望通过 om MCP 从任意仓库搜索个人知识库，并把新经验按项目或平台范围写回。
- 已有 Obsidian 知识库的用户，希望通过 om-vault-upgrade 预览并迁移旧版或非 Obsidian Mind 笔记，同时保留原仓库不变。
这个 Agent 有哪些优点和局限？
- 持久知识使用普通 Markdown、YAML frontmatter、wikilink 和 Git 保存，不依赖专有远程数据库，并可直接在 Obsidian 中浏览。
- 同一套 TypeScript 钩子与命令覆盖 Claude Code、Codex CLI 和 Gemini CLI，而 Claude Code 还获得完整的子代理与自动记忆支持。
- 上下文采用预算化分层加载，只在启动时注入摘要、任务和文件清单，并按需通过 QMD 检索，避免把整个知识库塞入会话。
- 内置从工作记录到能力证据、Brag Doc 和评审简报的完整链路，适合希望把日常记录转化为绩效材料的工程师。
- om MCP 支持跨仓库搜索、图关系展开、工作记录和带范围及置信度的经验记忆，并记录读取来源。
- 需要 Obsidian 1.12+、Node.js 22+、Git 和受支持的命令行编程助手，且依赖本地文件系统与 shell；它不是即开即用的托管服务。
- Claude Code 获得完整支持，而 Codex CLI 和 Gemini CLI 主要通过共享钩子与常规提示使用命令；其他编辑器型助手只获得文档级约定，钩子支持不确定。
- QMD 虽然可选，但 README 表示体验会明显更好；完整检索会额外下载约 2.25 GB 模型，并可能令每次查询等待数秒。
- 跨仓库 om MCP 需要绝对路径注册，并要求每个消费仓库编写具体触发规则；只完成服务注册可能产生零次实际查询。
- 使用者必须长期维护 North Star、目录分类、frontmatter、链接、项目身份和暴露范围，错误配置可能造成检索遗漏、项目同名冲突或不当共享。
- Node 的 --experimental-strip-types 标志若在未来版本中更名或移除，需要手工修改 Claude、Codex 和 Gemini 的钩子配置。
如何安装或部署这个 Agent？
要求安装 Obsidian 1.12+、Node.js 22+ LTS、Git，以及 Claude Code、Codex CLI 或 Gemini CLI 之一。推荐安装：
npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind向导会收集姓名、组织、用途、要启用的编程助手及是否使用 QMD，并初始化 Git、个性化 brain/North Star.md。也可以直接运行：
git clone https://github.com/breferrari/obsidian-mind.git随后将目录作为 Obsidian vault 打开，在 Settings → General 启用 Obsidian CLI，并在该目录运行 claude、codex 或 gemini。若要启用推荐的本地语义检索，再执行：
npm install -g @tobilu/qmd
node --experimental-strip-types .scripts/qmd-bootstrap.tsQMD 首次使用会下载约 328 MB、1.28 GB 和 640 MB 的三个本地模型；它不是核心功能的硬性依赖。
如何使用这个 Agent？
进入 vault 目录后启动所选编程助手。早晨运行 om-standup（Claude Code 中可使用 /om-standup），会载入目标、活跃项目、任务和近期变更；会议或工作结束后用 om-dump 加自由文本，系统会把人物、决策、成果和项目更新路由到相应笔记。结束一天时说“wrap up”或运行 om-wrap-up，以验证笔记、更新索引、检查链接并发现未记录成果；每周可运行 om-weekly 和 om-vault-audit。首次使用前应填写 brain/North Star.md，并根据组织情况调整 org/、perf/competencies/ 和 CLAUDE.md。若要从其他仓库访问此知识库，可全局注册：
claude mcp add --scope user om node "/absolute/path/to/your-vault/.claude/scripts/om-mcp.mjs"然后在消费仓库的 CLAUDE.md 中加入明确的查询触发条件；README 明确指出，仅注册 MCP 服务并不会可靠地促使会话主动查询知识库。
这个 Agent 与同类方案有什么区别？
与直接 git clone 相比，ShardMind 安装增加个性化向导、可选模块和三方合并升级；默认选项下生成的 vault 与克隆版本按字节等价，且删除 .shardmind/ 与 shard-values.yaml 后仍能工作。与仅使用 grep 或 Obsidian CLI 相比，QMD 增加本地向量检索、查询扩展和重排，能够找到措辞不同但语义相关的笔记，不过会增加模型下载、查询延迟和本地资源消耗。平台支持方面，Claude Code 是完整实现；Codex CLI 和 Gemini CLI 共用钩子及命令，而 Cursor、Windsurf、GitHub Copilot 和 JetBrains AI 仅被描述为可读取 AGENTS.md，具体钩子能力因产品而异。