一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | obsidian-second-brain | GitHub 仓库名 |
| 作者/维护者 | Eugeniu Ghelbur（AI Automation Engineer @ Single Grain） | GitHub |
| 来源链接 | https://github.com/eugeniughelbur/obsidian-second-brain | — |
| 许可证 | MIT | LICENSE |
| GitHub Stars | 3,225 | GitHub API |
| Forks | 393 | GitHub API |
| 最新版本 | v0.12.0（2026-07-11 发布） | GitHub Releases |
| 安装方式 | Claude Code 插件市场一条命令安装（见第十章） | 官方 README |
仓库创建于 2026-03-24，不到 4 个月即积累 3,225 星、393 次 Fork，最近一次提交在运行当天前 2 天，属高频活跃维护项目。
二、功能介绍与亮点
obsidian-second-brain 把 Obsidian 笔记库变成一个“会自我改写”的 AI 知识库，而不是简单的追加式笔记工具：
- 自我改写型知识库：新信息到来时自动重写既有笔记、调和矛盾表述、跨来源提炼模式，无需手工整理归档
- 双时态事实记录：通过 frontmatter 的
timeline:字段同时保留“事实何时成立”与“知识库何时学到”，形成可审计的知识演化轨迹 - 44 个斜杠命令：覆盖日常操作（保存对话、生成日报）、知识管理（摄取来源、调和矛盾、模式综合）、研究工具箱（网页/X/YouTube/播客检索并附引用）、思维工具（红队质询、跨域联想）等四层
- 定时后台代理：晨间生成日报、夜间调和矛盾、周度回顾、周日健康检查四类任务可无人值守自动运行
- 零 API Key 也能跑：44 个命令中 37 个纯本地功能完全不需要任何 API Key；仅“深度网页研究”等 7 个命令在无 Key 时自动降级为 Wikipedia、Hacker News、arXiv、Reddit 等免费源
亮点：设计理念脱胎于业界公开的“LLM Wiki”知识管理模式；官方仓库含正式 SECURITY.md 漏洞披露流程，并明确将 prompt injection 数据泄露纳入安全审查范围。
三、适用场景
固定分类：内容创作与知识管理
适用于：需要长期积累研究笔记、项目文档、会议纪要且希望知识库能自动去重、调和矛盾、保持信息新鲜度的用户；习惯用 Claude Code / Codex 等 CLI Agent 日常工作、希望对话内容和调研结果自动沉淀为可复用笔记而非随对话结束而丢失的用户；需要跨多篇笔记做模式综合、红队质询自己想法的知识工作者、独立研究者、内容创作者。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方主平台，插件市场一条命令安装，44 个命令含日历 MCP 集成 |
| Codex | 原生支持 | README 明确说明会在 .agents/skills/ 下生成原生 Agent Skills，43 个命令（不含日历 MCP） |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw；注意仓库支持的是 “OpenCode”（另一款 CLI 工具），与 OpenClaw 是两个不同项目，不可混淆，本次未为兼容性单独发起搜索 |
| Hermes Agent | 支持 | README 明确列出 Hermes Agent，可通过 OpenRouter 云端或 Ollama 本地模型运行 |
五、推荐理由
多数 CLI Agent 用户的知识沉淀停留在“对话完就丢”或“手动复制粘贴到笔记软件”，长期笔记库容易变成信息坟场——旧笔记不会随新信息更新，矛盾表述长期共存。obsidian-second-brain 用“自我改写 + 定时调和”机制解决了这个痛点：新对话、新调研自动合并进已有笔记而不是简单追加，44 个命令覆盖从日常记录到深度研究的完整工作流，且核心功能零 API Key 依赖、开箱即用。项目同时原生支持 Claude Code、Codex 与 Hermes Agent 三大目标生态，覆盖面在同类知识管理类技能中少见；仓库不到 4 个月增长至 3,225 星、正式安全披露流程齐备，是当前建目录阶段“内容创作与知识管理”类别下证据最扎实的候选。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,225 星、393 Fork，创建仅 4 个月即达到该规模，增速显著；1k–5k 星区间上段 |
| 可用性 | 9 | 插件市场一条命令安装；README/SKILL.md/DEMOS.md/docs 目录文档完整；最近提交在运行当天前 2 天，维护活跃；核心 37/44 命令零付费依赖 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 有代码执行：安装/配置脚本（install.sh、setup.sh）与 Python 工具脚本，权限范围限定在读写用户指定的 Obsidian 笔记库目录，边界明确 |
| ② 运行时联网外发 | 仅“研究类”命令按需联网（Perplexity/xAI/Gemini/YouTube），未配置 Key 时自动降级为免费公开源；官方声明无遥测、无后台上报 |
| ③ API Key/凭据 | 全部可选，本地存放于 ~/.config/obsidian-second-brain/.env；核心 37 个命令完全不需要任何凭据 |
| ④ 可疑指令排查 | 已抓取 SKILL.md 全文，未发现可疑指令；SECURITY.md 明确将 “prompt injection 导致数据泄露” 列为审查范围内的威胁类型，属主动防御姿态 |
| ⑤ 作者/组织信誉 | 个人开发者（非机构出品），但身份公开可查，有正式漏洞披露邮箱与响应时限承诺 |
| ⑥ License | MIT，权利义务明确 |
| ⑦ 最近维护 | 最新版本 v0.12.0 于运行当天前 3 天发布，开放 Issue 仅 4 条（相对 393 Fork 的规模显著偏低），无弃置风险 |
综合看，本技能有明确边界的代码执行与可选联网，无强制凭据、无可疑指令，达到“范围明确可审计”档；因非机构出品且涉及笔记库读写权限，未给满分。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| claude-blog（本次候选池同类落选者，GitHub 1,363★） | 面向 SEO 博客写作的全流程自动化（研究→草稿→质检→发布） | 仅支持 Claude Code 单一平台，且需接入 Google/CMS 等多个第三方服务凭据；obsidian-second-brain 定位是通用知识沉淀而非单一内容产出，跨 3 个 Agent 生态原生可用，核心功能零外部凭据 |
| slack-gif-creator / algorithmic-art（anthropics/skills 官方内容创作类技能，本次未入选） | 分别生成 Slack 表情 GIF、p5.js 生成艺术，均为“一次性产出型”创作工具 | 二者面向单次创意产出，不涉及长期知识积累；obsidian-second-brain 是持续运行的知识库系统，笔记会随时间自我更新而非静态产出 |
| Obsidian 社区常见的 AI 检索类插件（如语义搜索/RAG 插件） | 多为“给已有笔记库加检索能力”的单点增强 | 这类插件通常不改写笔记内容、不具备定时后台代理与矛盾调和能力；obsidian-second-brain 是端到端的“笔记库运维系统”，检索只是其 7 个研究类命令之一 |
核心差异化：obsidian-second-brain 不是又一个“AI 加检索”的笔记插件，而是把笔记库当作需要持续运维的系统——自动改写、调和矛盾、后台代理维护，同时是本次评估中少数原生覆盖 3 个目标 Agent 生态的知识管理类技能。
八、用户评价
本次完成 2 次专门检索，尝试寻找针对该项目的独立第三方评价：检索命中的相关文章（如 agenticpm.substack.com、mindstudio.ai 的“Claude Code + Obsidian 第二大脑”系列文章）经抓取核实后确认均为作者自建方法论，未实际提及或评测本项目。如实说明：本次未收集到足够的独立第三方用户评价，不为凑数编造或追加抓取。
九、其他补充
项目同时提供 Gemini CLI、OpenCode、Pi Coding Agent 的适配包（均以社区贡献形式支持），本报告仅评估固定分类范围内的四个目标 Agent；README 中说明该项目的知识管理方法论受到 Andrej Karpathy 公开提出的 “LLM Wiki” 模式启发并做了工程化扩展。
十、安装使用方式
Claude Code（推荐）：
/plugin install obsidian-second-brain或经典脚本安装：
curl -fsSL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/install.sh | bash安装后需在 ~/.claude/settings.json 中配置 OBSIDIAN_VAULT_PATH 指向本地 Obsidian 笔记库路径。
Codex CLI： 安装后自动在 .agents/skills/ 下生成原生 Agent Skills，无需额外配置即可被 Codex 识别。
Hermes Agent： 通过 OpenRouter（云端）或 Ollama（本地）接入所用模型后即可使用。
安装后注意事项： 无需重启终端；首次使用建议先执行 /obsidian-save 或 /obsidian-daily 等基础命令验证笔记库读写正常，再逐步启用研究类命令；若需网页/社交媒体/播客研究功能，按需在 ~/.config/obsidian-second-brain/.env 中补充对应 API Key，未配置时会自动降级为免费源，不影响核心功能使用。
十一、注意事项
- Obsidian 应用本身对个人使用免费，仅商业用途需付费授权（约 50 美元/年）；本技能自身运行不产生额外付费依赖，但完整体验需先安装 Obsidian
- OpenClaw 兼容性本次未获得可验证材料，官方文档提及的 “OpenCode” 是另一款不同的 CLI 工具，与 OpenClaw 不可混淆；如需在 OpenClaw 环境使用请自行测试
- 定时后台代理（晨间/夜间/周度任务）依赖宿主 Agent CLI 的调度能力，具体触发方式因平台而异，安装后建议先查阅 README 确认调度是否需要额外配置
- 本次未能收集到具备个人体验色彩的独立第三方评价，实际效果建议自行小范围试用后判断