undefined-ui/second-brain-os

来源：https://github.com/undefined-ui/second-brain-os

AI 第二大脑

一个由 AI 代理为你搭建并维护的知识库，全部以你拥有的纯 markdown 文件存在。你阅读、观看和收藏的一切，都会被转化为相互链接的 wiki 页面，并与已有的内容相连；你还可以向它提问。

这个仓库是完整版指南：概念、安装、库模板、代理技能、脚本和资源。完全免费，无需注册，除了 Obsidian 和一个代理之外，不需要安装任何东西。

在线阅读： undefined-ui.github.io/second-brain-os（https://undefined-ui.github.io/second-brain-os/）——完整的指南，带搜索和导航，所有经过筛选的链接（https://undefined-ui.github.io/second-brain-os/resources.html）都汇集在一页可筛选的列表中。

这里收录了三样东西——选择你的入口：

• 第二大脑指南——一条只需走一次的路径：搭建一个由代理为你维护的知识库。65 页、一个起始 vault、18 个技能。
• 代理课程——一条按顺序阅读的路径：七个模块，从单个提示词到生产级代理，并附带两条命令即可安装的工具。
• 手册——不是一条路径，而是参考手册：某一层级上全部的技术、工具和构建方案。当那一层开始拖累你时，就打开对应的一本。

它解决的问题

你收藏东西时是打算回头再看的，但你从来不会回头。书签、截图、待读队列和半途而废的 Notion 页面不断堆积，却没有产生复利，因为整理归档和建立链接是无聊的体力活，而人类通常两周后就放弃做这件事。

把这项工作交给一个代理，系统就能一直保持活跃。这就是全部的理念。

快速开始

一个晚上。九个步骤，每个步骤背后都有完整的一页详解。

# 复制起始 vault、技能、命令和代理
git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents
cp -r second-brain-os/scripts  ~/brain/scripts

# 文件夹里的 README 是给人在 GitHub 上看的，不是给代理看的
rm ~/brain/.claude/*/README.md ~/brain/scripts/README.md

cd ~/brain && claude

复制 scripts/ 目录是为了让 /metrics、/health 和 /graph-export 能在 vault 内部运行 scripts/vault_stats.py 及其相关脚本。在 Windows 上，请把本指南中的 python3 替换为 python：python3 这个名称通常会解析到 Microsoft Store 的占位程序，什么也不会做。

1. 安装 Obsidian，并用 “Open folder as vault” 打开你刚复制的 ~/brain 文件夹
2. 配置 Claude Code，可以在终端里，也可以在桌面应用的 Code 标签页中
3. 通过 MCP 连接，如果你希望代理能随时随地访问 vault。可选项，第一天可以跳过
4. 通过访谈生成你的 CLAUDE.md，而不是手写它
5. 配置两层结构：一个用于存放你所知道之事的 wiki，一个用于存放你正在做的事的 projects
6. 当你要交付成果时，收缩到一个项目
7. 安装 Web Clipper（https://obsidian.md/clipper），把一篇文章剪藏到 raw/ 目录，然后运行 /ingest
8. 接入实时数据：日历、邮件、聊天
9. 把维护工作安排到定时任务上，早上醒来就能看到一个已经自动归档好的 vault

然后给它再喂十个来源，再做评判。五页时这个图谱还不值一提，五十页时你就很难移开视线了。

完整演示：安装配置。

它如何运作

   你                    raw/                 代理                wiki/
 ┌───────┐          ┌──────────────┐      ┌────────────┐      ┌──────────────┐
 │ 剪藏  │  ──────> │ 文章         │ ───> │  摄取      │ ───> │ sources/     │
 │ 保存  │          │ 转录文本      │      │  提取      │      │ concepts/    │
 │ 丢弃  │          │ pdf          │      │  链接      │      │ entities/    │
 └───────┘          │ 聊天导出      │      │  检查      │      │ synthesis/   │
                    └──────────────┘      └────────────┘      └──────────────┘
                                                │                     │
                                                │   任何问题都能问      │
                                                └─────────────────────┘

原始素材是一座你永远不会去读的档案库。wiki 才是真正的产出：用平实的语言书写，一页一个概念，链接密集。新来源会更新现有页面，而不是堆积在旁边——这就是为什么这个 vault 会随着规模增长而变得更好，而不只是变得更大。

wiki 旁边还有一个项目层：每个项目一个文件夹，各自拥有自己的 CLAUDE.md 和一条「输入 / 处理 / 输出 / 反馈」流水线。wiki 存放你所知道的，项目存放你正在做的，两者相互喂养。两层结构会解释为什么把两者分开比听上去更重要。

里面有什么

指南

十个章节、77 页，写出来是让人照着做的，而不是用来速览的。从概念讲起，一直到安装、采集、结构、图谱、自动化、检索、发布，以及每一项坏掉之后该怎么办。

代理课程

七个模块，从单个提示词到生产级代理，基于 Google 的代理白皮书和五层框架构建：代理能看到什么、谁决定下一步、谁处理进来的任务、它能访问什么，以及你如何知道它能正常工作。有来源支撑的理论，每个模块配一页实践，结尾给出第一天就能执行的计划。

课程自带工具，以 Claude Code 插件的形式发布——一个上下文审计器、一个目标测试生成器、一个关卡查找器、一个 harness 审计器、一个评估套件初始化器和一个循环评审器，每个都在你的仓库里完成对应模块的那一页实践：

claude plugin marketplace add undefined-ui/second-brain-os
claude plugin install agents-course@second-brain-os

手册

以上全部就是第二大脑本身。手册讲的是用代理构建的更广泛的技艺——独立的主题，刻意做得很紧凑：每本八九页，内容截至 2026 年 9 月，且每一本都以一个你一个晚上就能完成的动手构建收尾。

在网站上阅读：undefined-ui.github.io 的手册（https://undefined-ui.github.io/second-brain-os/）。

设计决策

这套配置是有明确立场的。最重要的三条规则，以及它们背后的原因：

没建立链接的内容就不算完成摄取。 一个孤零零落进来的页面，一周之内就会被遗忘。链接就是全部价值所在，所以它必须在同一次运行中完成，否则摄取就不算结束。

矛盾会被记录下来，绝不会被覆盖。 当新来源与某个页面冲突时，两种立场都会保留，并标注日期和来源。你曾经相信过什么、为什么相信——这段历史是你的 vault 拥有而搜索引擎没有的东西。

在需要之前不引入向量数据库。 个人语料库规模很小，而且已经有结构了。结构化的页面加上链接，能回答分块相似度检索无法回答的问题，而且基础设施成本为零。RAG 何时才真正值得用讨论了这条分界线。

这是给谁的

任何读得多、记住的却少于自己所愿的人：研究者、工程师、写作者、学生，以及每周看三小时技术视频却一点都记不住的人。

它不是给团队 wiki 用的，不是 Notion 的替代品，也不会帮你整理一个你自己从不往里加东西的 vault。

可迁移性

这里的一切都是 markdown 文件、wiki 链接和 SKILL.md 文件。它与 Claude Code 协同工作，也与任何能读取文件的代理协同工作。Obsidian 只是图谱的查看器，而不是依赖。即使你抛弃本仓库中提到的每一个工具，你仍然拥有那个文件夹以及里面的一切。

学习资料

原始文档，以及本指南中各项设计决策背后的研究。

完整笔记：reading.md 和 papers.md。

工具和插件

根据官方社区统计数据按安装量排名的 Obsidian 插件，2026 年 9 月。完整目录见 plugins.md 和 tools.md。

Obsidian 之外：用于采集的 Web Clipper（https://obsidian.md/clipper）、用于维护的 Claude Code（https://code.claude.com/docs/en/setup）、用于处理的 yt-dlp（https://github.com/yt-dlp/yt-dlp）和 OCRmyPDF（https://github.com/ocrmypdf/OCRmyPDF）、用于图谱的 ripgrep（https://github.com/BurntSushi/ripgrep）、NetworkX（https://networkx.org）、Kuzu（https://kuzudb.com）和 Gephi（https://gephi.org），以及用于发布的 Quartz（https://github.com/jackyzha0/quartz）。

技能与其他实现

本仓库发布 18 个技能、72 个命令、6 个子代理和 4 个脚本：指南中每个工作流对应一个技能，而你真正会运行的每个细分版本都有对应的命令。

其他实现，按相同方式计数。一个发布十六个技能的仓库就计为十六。星标数来自 GitHub API，2026 年 9 月。