如何一个晚上搭建AI第二大脑:second-brain-os 9步快速上手教程

原创2026-10-15 10:31:291,924 阅读

如何一个晚上搭建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) "我这周在做什么"

三层核心纪律:

  1. 永远不要编辑 raw/——那是忠实存档
  2. 不要嵌套太深——图谱才是导航,不是文件夹树
  3. 对外输出统一放 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。

登录后查看全文
second-brain-os