Ruowen Wang

使用指南：从零开始搭建你的第二大脑

25分钟阅读

这份文档会手把手带你完成第二大脑的搭建、配置和日常使用。不需要任何编程基础，跟着步骤走就行。

你会得到什么

完成搭建后，你会有一个完全属于自己的知识库网站。它长这样：

wiki 首页

每个概念页面互相链接，你可以沿着链接自由探索自己的思维结构：

学习路径

你还可以在浏览器里直接和知识库对话 — 问任何问题，它基于你已经内化的知识来回答，不是通用 AI 的标准答案：

和知识库对话

所有数据存在你自己的电脑上，不依赖任何云服务。只需要一台电脑 + 一个 AI 的 API Key。

第一步：安装 Node.js

Node.js 是运行本系统所需的唯一环境。不需要 Python、不需要装数据库、不需要配服务器。

Mac 用户（推荐方式）：

  1. 打开 https://nodejs.org/
  2. 点击下载 LTS 版本（左侧按钮，当前是 v22.x）
  3. 双击下载的 .pkg 文件，一路”下一步”完成安装

Mac 用户也可以用 Homebrew 安装：

brew install node

Windows 用户：

  1. 打开 https://nodejs.org/
  2. 点击下载 LTS 版本（左侧按钮，当前是 v22.x）
  3. 双击下载的 .msi 文件安装，全部默认选项即可
  4. 安装完成后重启电脑

验证安装是否成功：

打开终端（Mac：应用程序 > 实用工具 > 终端；Windows：按 Win+R 输入 cmd），运行：

node -v

如果显示 v22.x.x 类似的版本号，说明安装成功。

第二步：获取 AI 的 API Key

本系统需要一个 AI 模型来帮你提炼知识。默认使用 DeepSeek，因为它便宜且中文效果好。

注册 DeepSeek：

  1. 打开 https://platform.deepseek.com
  2. 注册账号（手机号即可）
  3. 充值 10 元（日常使用够一个月，后面有费用估算）
  4. 左侧菜单进入 API Keys
  5. 点击 创建 API Key
  6. 复制保存这个 Key（以 sk- 开头，只显示一次，务必保存好）

除了 DeepSeek，系统也支持 OpenAI、Anthropic (Claude)、OpenRouter 等。在设置页面可以随时切换。

第三步：解压模板

下载模板文件 SecondBrain.zip：

  • 公众号回复： 第二大脑压缩包

将收到的 SecondBrain.zip 解压到任意位置，比如：

  • Mac：~/Documents/SecondBrain/
  • Windows：D:\SecondBrain\

Mac 用户双击 zip 文件即可解压。Windows 用户右键 zip → “提取所有”。

第四步：放入素材

把你的素材放到 raw/ 文件夹里。什么格式都行（.md、.txt），不需要整理。

模板自带了示例素材，你可以先试用体验效果，之后删掉替换成自己的。

raw/ 目录下有 9 个子文件夹，每个文件夹里都有 _usage.md 说明该放什么。以下是简要介绍：

文件夹放什么优先级
01-articles/网页文章剪藏 — 读到的有价值的文章段落中
02-papers/学术论文和研究报告中
03-transcripts/访谈和对话转录低
04-meeting_notes/有深度讨论的会议记录低
05-tweets/社交媒体收藏低
06-flash_notes/闪念笔记 — 你的原创想法、直觉、感受最高
07-book_notes/读书笔记中
08-case_studies/具体案例和决策复盘中
09-archive/已被 wiki 吸收的素材归档-

最重要的文件夹是 06-flash_notes/。 你的原创洞见在编译时会被优先处理，标注为”原创洞见”，是知识库中权重最高的素材来源。外部文章是参考，你自己的想法才是你真正的认知。

写闪念笔记不需要完整、不需要严谨，记录当时脑子里的东西就行。50-500 字，关键词和短句也行。比如：

# 为什么我讨厌给别人贴标签
 
今天和一个人聊天，发现他一直在用"他是 E 人""她太 P 了"来概括别人。
我觉得不对。人格是一个决策函数，不是一个标签。
你可以说他在这种情况下倾向于这样做，但不能说他"就是"这种人。

如果不确定分类，可以先扔到 06-flash_notes/inbox/，编译时会自动整理归类。

第五步：启动系统

打开终端，运行：

# 进入项目目录（换成你实际解压的路径）
cd ~/Documents/SecondBrain
 
# 启动服务
node server.js

启动后会显示：

  === 第二大脑 ===
    仪表盘: http://localhost:3000
    预览站: http://localhost:8080

浏览器打开 http://localhost:3000 ，你会看到仪表盘界面，有四个 Tab：

  • 对话 — 和你的 wiki 知识库聊天（流式输出，支持 Markdown/纯文本复制，聊天记录自动保存）
  • 编译 — 一键 AI 编译 raw/ 素材到 wiki/，实时显示进度，支持增量编译和断点续编
  • 预览 — 查看 Quartz 生成的 wiki 网站
  • 设置 — 配置 AI 模型和 API Key

关闭终端网站就会停止。下次使用重新运行 node server.js 即可。Mac 用户可以把终端窗口最小化而不是关闭。

第六步：配置 API Key

首次使用时，先点击顶部的**「设置」** Tab。

在设置页面中：

  1. Provider — 保持默认的 DeepSeek（如果用其他模型就选对应的）
  2. Model — 保持默认（DeepSeek 用户不需要改）
  3. API Key — 粘贴你在第二步获取的 Key（以 sk- 开头）
  4. Base URL — 保持默认（DeepSeek 用户不需要改）
  5. 点击 「保存」
  6. 点击 「测试连接」 — 显示”连接成功: 正常”说明配置正确

设置页面下方还能看到当前状态：API Key 是否配置、Provider 和 Model 信息、Wiki 页面数、Raw 素材数。

你的 API Key 保存在本地的 llm.config.local.json 文件中，不会上传到 git 或任何服务器。

第七步：编译知识库

切到**「编译」** Tab，点击**「开始编译」**。

AI 会自动分析你的所有素材，提炼出概念页面。整个过程约 2-5 分钟（取决于素材数量），进度实时显示在页面下方的日志区域：

  • 正在分析的素材文件
  • 提取出的概念、实体、来源
  • 生成的 wiki 页面（每个页面一行）
  • 发现的矛盾和冲突

编译完成后你会看到统计数字：多少个概念、多少个实体、多少个来源、处理了多少素材。进度条会走到 100%。

编译 Tab 上的按钮说明：

按钮作用
开始编译增量编译，只处理新增或修改的素材，速度快
忽略缓存重编清除缓存后重新分析所有素材，适合修改了大量素材后使用
重新加载 Wiki把 wiki/ 目录的文件重新读入内存，不影响文件
清空 Wiki删除所有 AI 生成的 wiki 页面（保留 raw/ 素材）
全部清空（含素材）删除 wiki 页面 + raw/ 中的用户文件（保留 _usage.md）

编译是安全的：新增素材会更新相关页面，不会删除已有内容。矛盾会被标注而不是覆盖。如果编译中断（比如网络断了），下次启动时会自动提示”继续编译”，点击即可恢复。

第八步：构建网站

编译生成的文件在 wiki/ 目录下，是 Markdown 格式。要变成可以浏览的网站，还需要一步构建：

# 在终端新开一个窗口（保持 server.js 继续运行），执行：
cd ~/Documents/SecondBrain/site
npx quartz build

构建完成后，打开 http://localhost:8080 就能看到你的 wiki 网站了。或者在仪表盘的**「预览」** Tab 中内嵌浏览。

首次构建需要下载依赖，可能需要几分钟。之后每次构建约 10-30 秒。每次编译新素材后都需要重新构建才能在 8080 端口看到更新。

第九步：和知识库对话

回到 http://localhost:3000 的**「对话」** Tab，就可以和你的知识库聊天了。

它和直接用 ChatGPT 的区别： 它只基于你已经内化的知识来回答。相当于和一个”读过你所有笔记的助手”聊天，不是通用 AI 的标准答案。

使用技巧：

  • 问开放式问题效果最好，比如”我对组织行为学有什么看法？“而不是”什么是组织行为学？”
  • 回答中加粗的文字是你 wiki 中的概念名称，代表回答引用了这些概念
  • 每条 AI 回答底部有灰色小字”参考: xxx”，显示这个回答引用了 wiki 中的哪些页面
  • 每条消息右侧有”复制”按钮，支持复制为 Markdown 或纯文本
  • 顶部有”复制对话”和”清空对话”按钮
  • 聊天记录自动保存在浏览器本地，下次打开还在
  • 如果回答不满意，可能是素材不够 — 往 raw/ 里补充更多素材后重新编译

第十步：浏览 wiki 网站

在仪表盘的**「预览」** Tab 中可以查看 wiki 网站，也可以直接访问 http://localhost:8080 。

网站的结构：

  • 首页 — 你的知识库总览，有推荐阅读路径和知识分类时间线
  • 概念页面 — 每个概念一页，互相链接，像在思维的网络里漫游
  • 总目录 — 所有页面的索引，按分类组织（核心概念 / 方法框架 / 实践经验 / 实体 / 来源）
  • 学习路径 — 推荐的阅读顺序，帮你系统地理解你的知识体系

浏览技巧：

  • 点击页面中的蓝色链接跳转到相关概念
  • 用浏览器的后退键回到上一个页面
  • 从总目录出发，找到感兴趣的概念，然后沿着链接探索

用 Obsidian 管理素材

推荐用 Obsidian 来管理你的素材文件。Obsidian 是免费的，而且天然支持 Markdown 和双向链接。

设置方法：

  1. 下载安装 Obsidian（https://obsidian.md）
  2. 打开 Obsidian，选择”打开文件夹为仓库”
  3. 选择你解压的 SecondBrain 文件夹
  4. 在左侧文件树中，展开 raw/ 目录，这就是你的素材管理区

日常操作：

  • 新建素材：在对应的 raw/ 子文件夹中新建 .md 文件
  • 编辑素材：直接双击文件编辑，保存即可
  • 浏览 wiki：点击 wiki/ 目录中的文件，用 Obsidian 的双链跳转浏览
  • 编辑 wiki：可以直接编辑 wiki/ 中的页面（但下次编译可能覆盖手动编辑）

素材放在 raw/ 目录。wiki/ 目录是 AI 自动生成的，你可以在 Obsidian 中浏览和手动微调，但主要的更新通过编译完成。

日常使用流程

日常记录素材 --> 积累到一定数量 --> 打开仪表盘编译 --> 构建 Quartz --> 浏览 wiki / 对话验证

典型的一天：

  1. 白天读书、看文章、有想法时，在 Obsidian 中记到 raw/ 对应文件夹
  2. 积累了几天素材后，打开 http://localhost:3000
  3. 切到「编译」Tab，点击”开始编译”，等 2-5 分钟
  4. 在终端执行 cd site && npx quartz build，等 10-30 秒
  5. 切到「对话」Tab 问几个问题验证新知识
  6. 切到「预览」Tab 或访问 http://localhost:8080 浏览更新后的 wiki

不需要每天都编译。 建议积累 3-5 条新素材后再编译一次，这样 AI 能更好地发现素材之间的关联。

一键编译（可选）

如果你不想分步操作，项目里有一个一键脚本：

./update.sh

它会依次执行：AI 编译素材 + 构建 Quartz 网站。执行完后运行 node server.js 即可。

支持的 AI 模型

系统默认使用 DeepSeek，但你可以在设置页面切换到任何支持的模型：

Provider推荐场景Base URL
DeepSeek默认选择，中文效果好，价格最低https://api.deepseek.com
OpenAI偏好 GPT 系列https://api.openai.com/v1
Anthropic偏好 Claude 系列https://api.anthropic.com
OpenRouter想在一个平台访问多个模型https://openrouter.ai/api/v1

切换方法： 在设置页面选择 Provider，填入对应的 API Key 和 Base URL，保存即可。

注意：切换 Provider 后，对话功能使用的 API 会随之改变。Anthropic 使用独立的 API 协议，其他 Provider 都走 OpenAI 兼容接口。

费用估算

工具费用

项目费用
Obsidian免费
Node.js免费
Quartz免费
DeepSeek API约 9-15 元/月

DeepSeek API 用量

DeepSeek 官方定价（deepseek-v3-251201 模型，人民币）：

类型每 100 万 tokens
输入（命中缓存）0.5 元
输入（未命中缓存）2 元
输出8 元

实际消耗：

操作单次消耗单次费用
编译知识库~5 万输入 + 3 万输出 tokens约 0.34 元
和 wiki 聊天~2000 输入 + 1000 输出 tokens约 0.012 元
使用方式频率月费用
编译知识库每周 1 次1.4 元
和 wiki 聊天每天 20 次7.2 元
合计约 9 元/月

重度使用（每天 50 次对话）约 15 元/月。充值 10 元 覆盖日常使用约一个月。

夜间（00:30-08:30 北京时间）API 价格减半，如果素材量大可以在夜间编译。

目录结构速查

SecondBrain/
├── raw/                    # 你的原始素材（只增不改）
│   ├── 01-articles/        #   网页文章剪藏
│   ├── 02-papers/          #   学术论文和研究报告
│   ├── 03-transcripts/     #   访谈和对话转录
│   ├── 04-meeting_notes/   #   有深度讨论的会议记录
│   ├── 05-tweets/          #   社交媒体收藏
│   ├── 06-flash_notes/     #   闪念笔记（原创洞见，编译时优先处理）
│   │   └── inbox/          #     暂存区，编译时自动整理
│   ├── 07-book_notes/      #   读书笔记
│   ├── 08-case_studies/    #   具体案例和决策复盘
│   └── 09-archive/         #   已被 wiki 吸收的素材归档
├── wiki/                   # AI 编译生成的知识库
│   ├── concepts/           #   概念页面
│   │   ├── 核心概念/       #     最基础的观点和立场（元认知）
│   │   ├── 方法框架/       #     分析和解决问题的结构化工具（心智模型）
│   │   └── 实践经验/       #     真实场景的案例和反思（实践工具）
│   ├── entities/           #   人物和组织
│   ├── sources/            #   素材摘要
│   ├── syntheses/          #   跨概念综合分析
│   └── index.md            #   总目录
├── blog/                   # 博客文章（wiki 的下游输出）
├── assets/                 # 图片和媒体
├── site/                   # Quartz 网站框架（构建命令在此执行）
├── server.js               # 仪表盘服务（启动命令：node server.js）
├── compile.js              # CLI 编译脚本（备用，可脱离网页使用）
├── chat.js                 # CLI 对话脚本（备用，终端中直接对话）
├── update.sh               # 一键编译 + 构建脚本
├── llm.config.json         # LLM 默认配置
└── llm.config.local.json   # LLM 本地配置（API Key 保存在这里）

备用工具：命令行

除了网页仪表盘，项目还提供了两个命令行工具，适合不想开浏览器或者想写脚本自动化的场景：

CLI 编译：

node compile.js

读取 raw/ 素材，调用 AI 编译到 wiki/。效果和网页的”开始编译”相同。

CLI 对话：

# 直接问一个问题
node chat.js "你对路径依赖怎么看？"
 
# 或者进入交互模式
node chat.js

在终端里直接和 wiki 知识库对话。交互模式中输入 q 或 退出 退出。

常见问题

Q: 支持哪些文件格式？

A: .md 和 .txt。Word 和 PDF 需要先转成纯文本再放进 raw/。

Q: 编译结果不满意怎么办？

A: 两种方式：一是在 Obsidian 里直接手动编辑 wiki 页面；二是把素材整理一下，然后用”忽略缓存重编”重新编译。

Q: 数据安全吗？

A: 所有文件在你自己的电脑上，是本地 Markdown 文件。编译和聊天时素材内容会发给 AI 模型的 API（比如 DeepSeek），但他们承诺不用 API 数据训练模型。你的 API Key 保存在本地 llm.config.local.json，不会上传到 git 或任何外部服务器。

Q: 可以换电脑使用吗？

A: 可以。把整个 SecondBrain 文件夹复制到新电脑，安装 Node.js，运行 node server.js 即可。聊天记录存在浏览器本地，需要重新积累。

Q: 素材文件可以改名或移动吗？

A: 可以，但建议只在 raw/ 目录内操作。wiki/ 目录由 AI 自动管理，手动改动可能在下次编译时被覆盖。

Q: 编译报错了怎么办？

A: 最常见的原因是 API Key 无效或余额不足。到设置页面点”测试连接”检查。如果显示连接失败，检查 Key 是否正确、账户是否还有余额。其他问题可以把终端中的错误信息截图发给我。

Q: 网站打不开？

A: 确认终端中 node server.js 还在运行。关闭终端或按 Ctrl+C 都会停止服务。重新运行 node server.js 即可。如果 8080 端口显示空白，可能还没构建过 Quartz，执行 cd site && npx quartz build 即可。

Q: wiki 页面之间的链接是怎么建立的？

A: AI 在编译时会分析概念之间的关联，自动建立双向链接。比如”人格作为决策函数”和”路径依赖”之间的关系 — 人格是一个稳定的决策偏好，这个偏好随时间不断重复，就被放大成了组织结构。这种关联是 AI 从你的素材中发现的，不需要你手动建链。

Q: 编译时发现矛盾怎么办？

A: 这是好事。系统会在相关页面创建”知识冲突”区块，把两种说法都保留。比如你去年写的笔记认为”性格决定命运”，今年读了一篇文章认为”情境比性格更能预测行为” — 系统会把两个观点都保留，让你自己判断。

Q: 增量编译和全量编译有什么区别？

A: 增量编译（点”开始编译”）只分析新增或修改的素材文件，跳过没有变化的页面，速度快、省 token。全量编译（点”忽略缓存重编”）会清除缓存，重新分析所有素材文件，适合你修改了大量素材后使用。系统会通过内容哈希智能判断：即使文件的修改时间变了，只要内容没变，就不会触发重新编译。

进阶：写更好的素材

知识库的质量取决于你的素材质量。以下是一些让 wiki 更好的建议：

原创洞见比收藏文章更有价值

06-flash_notes/ 中的内容权重最高。与其收藏 10 篇别人的文章，不如写 1 条自己的思考。比如：

# 读完了《系统之美》，和我的想法有冲突
 
书里说系统思维能帮你看到全局。我觉得对，但漏了一点：
"看到全局"和"做出正确决策"是两回事。你可能看清了系统结构，
但行动时还是被情绪和惯性绑架。
 
这让我想到，系统思维需要配上"承载力"才有用 --
就是你在不舒服的状态下还能不能保持功能。

关联你的不同素材

如果某个想法和另一个想法有关系，在笔记里提一句。AI 会自动识别这些关联，但如果素材本身就有关联线索，编译效果会更好。

具体案例比抽象理论更有力量

目前系统擅长提炼概念和框架，但缺少具体的案例和体验。以下素材类型对 wiki 质量提升最大：

素材类型为什么重要放在哪里
具体案例没有案例的框架是空的raw/08-case_studies/
情感体验情感是知识的温度raw/06-flash_notes/
决策复盘”当时怎么想的”比”正确做法是什么”更有价值raw/08-case_studies/
行动记录想了很多但没做过，wiki 会变成空谈raw/06-flash_notes/

获取帮助

如果遇到问题，可以联系我：

服务费用说明
陪伴式指导200 元/小时腾讯会议共享屏幕，一起操作，边做边聊
远程协助100 元/次远程操作你的电脑，帮你解决问题

微信：ruowenwang，备注「第二大脑」

反向链接