AB
AB
AiBoss站

全部分类

project

second-brain-os - 由 AI 代理替你搭建和维护的纯 Markdown 知识库

second-brain-os 是维护者 undefined-ui 在 GitHub 上开源的一套「第二大脑」方案：用纯 Markdown 文件承载知识库，由 AI 代理负责归档、链接与维护。仓库提供指南、vault 模板、代理技能、斜杠命令与脚本，采用 MIT 许可证。截至 2026-09-27 星标 681，尚无正式 release。

second-brain-os 是一套围绕「让 AI 代理替你维护知识库」展开的开源方案。据项目自述，它要解决的问题很具体：人们保存书签、截图、稍后读队列和半途而废的笔记页面，本意是回头再看，实际上再也没看——因为归档和建立链接是枯燥的重复劳动，人坚持两周就会放弃。项目的思路是把这份劳动交给代理，让系统自己活下去。仓库里装的是完整版指南：概念、安装步骤、vault 模板、代理技能、脚本和资源清单。它适合阅读量大但留存少的人——研究者、工程师、写作者、学生，以及每周看几小时技术视频却什么都记不住的人。项目自述也明确划出了边界：它不是团队 wiki，不是 Notion 的替代品，也无法整理一个你从不往里添加内容的 vault。

维护者与状态

项目由 undefined-ui 维护，仓库创建于 2026-09-07，最后提交时间为 2026-09-25。截至 2026-09-27，仓库星标数为 681。需要说明的是，该项目尚无正式 release，也就是说目前没有可供引用的版本化发布产物，使用方式以直接克隆仓库为主。许可证为 MIT。

主要能力

以下内容均来自项目自述，未经独立验证。

  • 原始素材到 wiki 的流水线：据项目说明，你剪辑、保存或随手丢进 raw/ 的文章、转录稿、PDF、聊天导出等内容，会由代理执行 ingest、抽取、链接和 lint，最终沉淀为 sources/、concepts/、entities/、synthesis/ 等页面。新素材会更新既有页面，而不是在旁边不断堆积。
  • 两层结构：一层是 wiki，存放你「知道什么」；另一层是项目层，每个项目一个文件夹，各自带 CLAUDE.md 和 Inputs / Process / Outputs / Feedback 流程，存放你「正在做什么」。项目自述称两层互相喂养，并专门解释了为什么保持分离比听起来更重要。
  • 技能、命令与子代理：仓库包含 18 个代理技能（对应指南中的每个工作流）、72 个斜杠命令（进入这些技能的限定入口）、6 个子代理（其中四个按设计为只读）。
  • 无依赖脚本：scripts/ 下是纯 Python 实现，用于链接检查、统计和图谱导出，项目称其不依赖第三方库。
  • 指南与专题：docs/ 是十节、77 页的指南，覆盖概念、安装、采集、结构化、图谱、代理、检索、输出、维护与故障排查；docs/track-*/ 另有五条紧凑专题线，分别讲知识图谱、Jev 工程、代理 harness、循环工程和 eval 工程，项目称每条以一次当晚可完成的手把手构建收尾。
  • 可移植性：项目自述全部内容都是 Markdown 文件、wikilink 和 SKILL.md，可与 Claude Code 以及任何能读文件的代理配合；Obsidian 只是图谱查看器，不是依赖。即使放弃仓库中提到的所有工具，文件夹及其内容仍然归你所有。

项目还列出了三条设计取舍：未建立链接的内容不算完成采集；出现矛盾时记录而非覆盖，保留两个立场及日期与来源；在真正需要之前不引入向量数据库，理由是个人语料规模小且已有结构，结构化页面加链接能以零基础设施成本回答分块相似度答不了的问题。

使用入口

仓库地址：undefined-ui/second-brain-os。项目另有一个官网入口：官网。

据项目说明，快速上手被设计成「一个晚上、九个步骤」，每步都有完整页面支撑。核心动作是克隆仓库、把模板复制成自己的 vault、把技能与命令放进代理目录，然后在 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
cd ~/brain && claude

项目特别提示：复制 scripts/ 是为了让 /metrics、/health、/graph-export 能在 vault 内调用 scripts/vault_stats.py 等脚本；文件夹里的 README 是给在 GitHub 上阅读用的，需要从代理目录中删除。在 Windows 上，指南里写 python3 的地方应改用 python，因为 python3 通常指向 Microsoft Store 的占位程序，执行后没有效果。九个步骤依次为：安装 Obsidian 并以「Open folder as vault」打开刚复制的文件夹；配置 Claude Code；可选地通过 MCP 让代理从任意位置访问 vault（项目建议第一天跳过）；通过访谈生成 CLAUDE.md 而不是手写；建立 wiki 与项目两层结构；需要交付时收窄到单个项目；安装 Web Clipper 并运行 /ingest；接入日历、邮件、聊天等实时数据；把维护排进日程。项目还建议在评判效果前先喂十个以上来源，理由是五页的图谱看不出意思，五十页时则很难移开视线。

许可与限制

许可证为 MIT。项目自述中提到的已知边界包括：不适用于团队 wiki，不是 Notion 的替代品，也无法整理一个你从不添加内容的 vault；MCP 接入是可选项，第一天可以跳过；Windows 环境下需注意 python3 的命名问题。此外，仓库当前尚无正式 release，因此不存在版本化的安装包或发布说明，使用前需自行阅读仓库内文档。项目自述还引用了 Andy Matuschak 的观点作为对本方案最强的反驳：如果写作本身就是思考，那么把写作委托出去，等于没有思考。

返回