Obsidian Second Brain

这个 Agent 能做什么，适合哪些场景？

obsidian-second-brain 是一个开源（MIT）技能/插件项目，让 Claude Code、Codex CLI、Gemini CLI、OpenCode、Grok Bot、Hermes、Pi 和 Google Antigravity 共享同一个 Obsidian 库作为跨会话持久记忆。它在 Karpathy 的 LLM Wiki 模式之上扩展：新来源会重写已有页面而非追加，矛盾通过 /obsidian-reconcile 自动解决，/obsidian-synthesize 自主发现模式并写综合页。它实现了 OKM（Open Knowledge Metabolism）新鲜度规范：每条事实必须是 timeless、dated 或 pointer，由 /obsidian-health 附带的 linter 强制执行。v0.18 的 Crew 功能让 Claude Code、Codex、Cursor 和 Grok Bot 在任意普通文件夹中共享一本工作日志，代理互相留下经验，但只有人类执行 keep 才会变成规则。全项目共 49 条命令（Claude Code 版；其他平台 48 条），分为操作、思考工具、上下文引擎和研究工具四层，外加后台代理和 4 个定时代理。核心库命令无需任何 API key，研究类命令可选接入 xAI Grok、Perplexity、Gemini、YouTube 等。

安装后，代理通过斜杠命令读写你的 Obsidian 库：/obsidian-save 把对话中的决策、人物、任务自动分发到对应笔记；/obsidian-ingest 摄取 URL、PDF、Word/OpenDocument、音频、截图或 YouTube 视频，触碰 5–15 个页面并重写实体页；/obsidian-find 做语义搜索；/obsidian-challenge 用你自己的历史笔记反驳当前想法；/obsidian-visualize 生成库的可视化 canvas。研究工具层含 /x-read、/x-pulse（Grok 实时 X 数据）、/research、/research-deep（无密钥时回退到 Wikipedia、HackerNews、arXiv 等免费源）、/notebooklm（Gemini File Search 库内综合）、/youtube 和 /podcast。夜间定时代理执行五阶段整理：收尾当日、调解矛盾、跨源综合、修复孤儿笔记、重建索引。每个代理构建由 scripts/build.sh --platform 从同一源码树编译，CI 用 scripts/conformance_report.py 验证八个构建（Agent Skills、Claude Code、Codex CLI、Gemini CLI、Grok Bot、Hermes、OpenCode、Pi）全部通过。

1. 每天用 Claude Code 写代码的开发者，希望新会话不用重新解释项目背景，靠 /obsidian-world 和 CRITICAL_FACTS.md 十秒恢复上下文
2. 开会的创始人和运营者，用 /obsidian-save 一条命令把决策、人物、任务自动写进项目和人物笔记
3. 内容创作者，用 /x-pulse 扫描 X 上的热门主题和缺口，用 /youtube 把视频转成带引语和评论情绪的 AI-first 笔记
4. 研究员或分析师，用 /research-deep 先扫描库内已有知识、只补缺口并生成带引用的增量报告
5. 同时使用多个代理工具的用户，用 Crew 让 Claude Code、Codex、Cursor 和 Grok Bot 互相知道对方完成了什么
6. 长期维护个人知识库的人，靠 /obsidian-health、新鲜度 linter 和 /obsidian-merge 防止库中积累过时事实和重复笔记

如何安装或部署这个 Agent？

最简单的方式是 Claude Code 插件市场安装：

/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain

然后在 ~/.claude/settings.json 的 env 中指向你的库：

"env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault" }

重启 Claude Code 后在库内运行 /obsidian-second-brain:obsidian-init。

经典脚本安装（命令为裸名，需要 git、uv、jq）：

curl -fsSL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/scripts/quick-install.sh | bash

还没有库？先一键生成一个：

cd ~/.claude/skills/obsidian-second-brain
uv run python scripts/bootstrap_vault.py --path ~/Documents/MyVault --name "Your Name"
bash scripts/setup.sh ~/Documents/MyVault

其他平台（Codex CLI、Gemini CLI、OpenCode、Antigravity、Pi、Grok Bot、Hermes）用 bash scripts/build.sh --platform <平台> 构建，按 dist/<平台>/INSTALL.md 复制产物。前置要求：Python 3.10+、uv；研究工具还需在 ~/.config/obsidian-second-brain/.env 配置 XAI_API_KEY、PERPLEXITY_API_KEY、GEMINI_API_KEY 等（/research 和 /research-deep 无密钥也能用免费源）。

如何使用这个 Agent？

在库根目录启动 Claude Code（或其他主机 CLI），从三条核心命令开始：/obsidian-init 初始化库（生成 _CLAUDE.md、index.md、log.md），/obsidian-save 保存当前对话，/obsidian-find 检索记忆。其余 42+ 条命令按需使用，例如 /obsidian-ingest https://youtube.com/... 摄取来源并重写相关页面，/research "主题" 生成带引用的研究档案，/obsidian-daily 开启新的一天。Crew 共享日志只需 curl -fsSL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/scripts/quick-install.sh | bash 安装后运行 /crew setup，选 ~/crew 或库内 wiki/team/；Codex 用户需运行 /hooks 一次信任 Crew 的 hooks。后台代理默认不启用，需按 hooks/postcompact.hook.example.json 手动启用（它使用 --dangerously-skip-permissions 但工具面被限制为 Read/Write/Edit/Glob/Grep，且不加载 MCP 服务器）；有界召回（bounded recall）通过 OBSIDIAN_RECALL_ENABLED=1 启用。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题