如何一个晚上搭建AI第二大脑:second-brain-os 9步快速上手教程
如何一个晚上搭建AI第二大脑:second-brain-os 9步快速上手教程
还在收藏文章却从不回看?second-brain-os 是一个AI 第二大脑开源项目:你负责剪藏和保存,AI 智能体负责归档、建立链接和维护知识图谱,一切以纯 Markdown 文件存储,你真正拥有自己的数据。本文带你用 9 步在一个晚上完成搭建。
为什么普通笔记库会"死掉"
书签、截图、稍后阅读队列只会越积越多,因为归档和链接是枯燥的重复劳动,大多数人两周后就放弃。second-brain-os 的思路很直接:把这些工作交给 Agent。
你 ──> raw/(原始素材)──> Agent 摄取/链接 ──> wiki/(互相连接的知识页)
原始素材是"你再也不读"的存档,wiki 才是真正会复利增长的资产——新来源会更新已有页面,而不是在旁边堆一页又一页摘要。完整理念见 docs/01-concepts/what-is-a-second-brain.md。
准备工作:你需要什么
| 工具 | 作用 | 说明 |
|---|---|---|
| Obsidian | 知识库查看器,渲染链接图谱 | 免费,数据存本地 |
| Claude Code | 读写知识库的智能体 | 需付费账号(Pro/Max 等) |
| Git | 版本控制,让 Agent 出错可一键回滚 | 随系统或自行安装 |
👉 详细清单见 docs/02-setup/README.md。
第1步:克隆仓库,复制起步 Vault
打开终端,克隆项目并把起步模板(wiki 结构、项目流水线、页面模板、18 个技能、72 个命令)复制到 ~/brain 目录:
git clone https://gitcode.com/gh_mirrors/se/second-brain-os
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
scripts/ 目录让 /metrics、/health、/graph-export 等命令可以直接运行 scripts/vault_stats.py 等脚本。💡 模板根目录的 vault-template/CLAUDE.md 是 Agent 每次会话都会读的"说明书",建议先通读一遍。
第2步:安装 Obsidian 并打开 Vault
从官网下载安装 Obsidian,在欢迎界面选择 "Open folder as vault"(以文件夹打开),选中 ~/brain。
建议顺手修改三个设置(详见 docs/02-setup/obsidian-install-and-vault.md):
- Files and links → New link format:相对路径
- Files and links → Automatically update internal links:开启
- Editor → Show frontmatter:开启
还可以动手写一条笔记,输入 [[goals]] 创建第一个双向链接——这就是整个系统的数据模型:笔记指向笔记。
第3步:安装并运行 Claude Code
两种方式任选(详见 docs/02-setup/claude-code-setup.md):
- 桌面应用:下载 Claude Desktop,使用 Code 标签页,适合不熟悉终端的新手
- 终端:安装后进入 Vault 目录运行
claude
cd ~/brain && claude
以文件系统方式直连 Vault 是最简单的配置,不需要任何插件。首次运行时先让 Agent 读结构:
Read CLAUDE.md and wiki/index.md, then tell me what this vault currently contains and what is missing.
⚠️ 权限建议:只授予它对 Vault 的写入权限,不要给全盘 shell 权限。安全边界详见 docs/06-agents/safety-and-guardrails.md。
可选进阶:用 MCP 连接 Obsidian,让 Agent 在任意会话中访问 Vault。第一天可以跳过。
第4步:让 Agent 访谈你,生成 CLAUDE.md
不要手写 CLAUDE.md,冷写出来的文件只会又薄又泛。把下面这段话粘贴给 Agent,让它一次只问一个问题:
You are setting up my second brain. Interview me ONE question at a time to build my profile...
它会询问你的身份、年度目标、沟通偏好、当前项目等,最终把结果写入根目录 CLAUDE.md。这是"懂你的助手"和"每次都要重新交代的助手"的分水岭。技巧与要点见 docs/02-setup/claude-md.md。
第5步:理解两层结构
Vault 由两层组成,这是系统能撑过第一个月的关键(详见 docs/02-setup/vault-structure.md):
| 层 | 目录 | 回答的问题 |
|---|---|---|
| 知识层 | wiki/(sources / concepts / entities / synthesis) |
"我对 X 知道什么" |
| 项目层 | projects/(每个项目含 Inputs / Process / Outputs / Feedback) |
"我这周在做什么" |
三层核心纪律:
- 永远不要编辑
raw/——那是忠实存档 - 不要嵌套太深——图谱才是导航,不是文件夹树
- 对外输出统一放
output/或项目的Outputs/
第6步:为一个项目划定范围
这是大多数人跳过、之后又疑惑"为什么输出质量下降"的一步。把 Agent 指向整个 Vault 时,每个任务都要和你所有历史内容竞争;指向单个项目时,它只读该项目的 CLAUDE.md 和目标文件。
在终端中很简单:
cd ~/brain/projects/你的项目目录
claude
经验法则:全 Vault 用于规划,单项目用于产出(详见 docs/02-setup/project-scoping.md)。
第7步:剪藏一篇文章,运行 /ingest
现在见证第一份复利。安装 Obsidian 官方 Web Clipper 插件,把一篇文章剪藏到 raw/ 目录,然后在 Claude Code 中运行:
/ingest
Agent 会完成三件事:为来源建立 wiki 页面、链接到已有的概念页、更新 wiki/index.md 和 wiki/log.md。
记住第一条设计原则:没有链接就不算完成摄取。这正是知识库和普通摘要文件夹的区别,逻辑写在 skills/second-brain-ingest/SKILL.md 中。
📌 在评价这个系统之前,先喂给它至少 10 个来源——5 页的图谱不好看,50 页的图谱让人移不开眼。
第8步:接入实时数据(可选)
静态笔记只是半个大脑,另一半是日历、邮件、聊天里真实发生的决定。通过 MCP 连接(详见 docs/02-setup/live-data.md):
- 日历优先:Agent 可以读出每天的会议承诺并写入项目
- 邮件、Slack、Notion 各有对应 MCP 服务器
两条安全铁律:
- 给读权限,不给写权限——大脑应该读你的数据,而不是替你操作
- 靠钥匙而不是提示词:"不要删除"只是建议;如果技术上能删,终有一天会删。用只读 token、按连接器隔离凭证
第9步:设置定时维护,让 Vault 自己归档
这一步是 Vault "活过来"的时刻(详见 docs/06-agents/scheduled-maintenance.md):
| 任务 | 频率 | 说明 |
|---|---|---|
| Ingest | 每天 | 夜里处理当天剪藏,批量才能发现"这三篇在讲同一件事" |
| Link / Lint | 每周 | 先补链接,再体检坏链 |
| Review | 每周 | 早上规划日读的报告 |
| Metrics | 每月 | 四个数字追加到笔记 |
在 Claude Desktop 的 Schedule 标签页新建任务即可,例如"每天 7 点:把 raw/ 的新素材归档进 wiki,链接到已有页面,更新 index.md 和 log.md,提交一次并附运行报告"。
⚠️ 建议先手动运行一周再定时,确保你能不细读也接受它的输出。
搭建完成后:让它持续复利
- 每周回顾 wiki/log.md,这是 Agent 的行动账本
- 用
/health查看知识库健康状况,/graph-export导出图谱(脚本在 scripts/ 目录) - 发现 Agent 连续两次犯同样的错?那是
CLAUDE.md的问题——加一条带理由的规则 - 遇到矛盾观点时系统只记录、不覆盖,保留"你曾经相信什么、为什么"——这是搜索引擎给不了你的
常见问题
Q:一定要 Obsidian 吗? 不是。Obsidian 只是图谱查看器,Vault 全部是 Markdown + 双向链接,用任何文本编辑器都能打开。
Q:Claude Code 需要付费吗? 需要 Pro、Max 或 Console 等付费方案,免费 Claude.ai 账号不包含 Claude Code。
Q:数据会上传到云端吗? 文件全部存在你自己的机器上;换掉所有工具,这个文件夹依然完整可用。
Q:适合团队协作吗? 不适合。它不是团队 Wiki 或 Notion 替代品,它是个人的、自我维护的第二大脑。
一个晚上、九个步骤,你会拥有一个自己维护自己的知识库。完整的 65 页指南在 docs/ 目录,18 个技能说明见 skills/README.md,命令清单见 commands/README.md。