搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

jessepinkman9900/claude-second-brain

效率与系统工具

一条命令搭建由 Claude Code 维护的 Obsidian 知识库,自带本地混合检索与 Git 同步。

166
23
JavaScript
MIT
创建于 7 个月前

项目介绍

claude-second-brain 是一个脚手架 CLI,用来生成一个由 Claude Code 维护的个人知识库:把文章、PDF 或笔记放入原始资料目录后,Claude 会提炼内容、建立双链并在新资料与旧知识冲突时给出提示。生成出来的目录本身就是合法的 Obsidian vault,qmd 为整个 wiki 建立本地混合检索索引(向量加 BM25),GitHub 则作为带版本历史的唯一事实来源。

它采用的思路是让 CLAUDE.md 充当「想法文件」:每次会话 Claude 都按其中的 schema 工作,页面分为 overview、topic、entity、source-summary、qa 五类,用 Obsidian 双链互连。项目明确说明自己不是对笔记做 RAG 的聊天机器人,而是持续维护的结构化 wiki。

快速开始

需要 Node.js 与 Claude Code,Obsidian 可选。缺少 mise 或 Node/pnpm 工具链时,CLI 会尝试自动安装。

  1. 生成知识库:
npx claude-second-brain

也可以全局安装后使用短命令:

npm i -g claude-second-brain
csb

向导会询问知识库名称(默认 my-brain),并可选地创建私有 GitHub 仓库;自动创建并推送依赖 gh CLI。CLI 会在 ~/.claude-second-brain/my-brain/ 生成目录,写入 ~/.claude-second-brain/config.toml,安装依赖并执行 git init。

  1. 生成向量索引:
cd ~/.claude-second-brain/my-brain
pnpm qmd:reindex

首次运行会下载约 2 GB 的 GGUF 模型,每台机器只需一次。

  1. 把 ~/.claude-second-brain/my-brain/ 作为 vault 在 Obsidian 中打开。目录内已预配置 obsidian-git 插件,启用后即可自动同步。如果安装时跳过了 GitHub,可自行执行 git remote add origin <url> 并推送。

之后把资料放进 raw-sources/articles/、raw-sources/pdfs/ 或 raw-sources/personal/,在 Claude Code 中运行 /brain-ingest 即可入库,再用 /brain-search 获取带引用的回答。

技能与多知识库

日常操作由斜杠命令完成:/brain-ingest 提炼资料并建立关联;/brain-search 做混合检索,并可将综合出的新答案归档为 wiki/qa/ 页面;/lint 检查孤立页面、失效链接与未解决的矛盾。维护命令包括用于增量重建向量的 /brain-refresh,以及会丢弃旧索引、重新设计 qmd schema 的破坏性命令 /brain-rebuild。

三个核心技能会安装到全局 ~/.claude/skills/,/brain-rebuild 与 /lint 则留在 vault 内。README 给出的技能更新方式是用 npx skills add 指向仓库模板技能目录。可以创建多个知识库,各自拥有独立目录、索引与 remote;全局技能始终作用于 config.toml 中声明的默认知识库,可通过 csb ls、csb use、csb doctor 等子命令管理。

使用约束

  • 资料提炼与检索流程依赖 Claude Code,CLI 本身只负责脚手架与知识库管理。
  • 首次构建索引需要下载约 2 GB 的本地模型。
  • 移动端编辑依赖 Claude Code 的 GitHub 集成;iOS 上需把 vault 放进 iCloud Drive 才能被 Obsidian Mobile 识别。
  • /brain-rebuild 是破坏性操作,会删除旧索引并从头重建向量。
  • 许可证为 MIT。

HotRepo 点评

2026-11-16,该项目在 JavaScript 日榜上新增 14 星,以总计 166 星、23 个 fork 排到第 11 名。目前只有这一条日榜记录,只能说明当天的表现,不足以判断趋势。仓库创建于 2026-04-11,属于较新的项目;它的价值主要来自把 Claude Code、qmd、Obsidian 与 GitHub 串成一套开箱即用的流程,而不是自己实现检索或模型能力。已经使用 Claude Code 和 Obsidian 的人最契合;其他用户需要接受约 2 GB 的模型下载和较长的依赖链。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. eugeniughelbur/obsidian-second-brain让 AI 编程助手把跨会话记忆以纯 Markdown 存进 Obsidian 笔记库,多个工具共用。Python4,925
  2. huytieu/COG-second-brain把本地 Markdown 笔记库变成由 AI 技能和代理持续维护的第二大脑。Python1,474
  3. Timaga/noda-local-ai-notes面向 Windows 的本地优先 Markdown 笔记应用,提供知识图谱、语义搜索和带引用来源的问答。JavaScript105
  4. TriliumNext/Trilium面向自托管用户、支持深度关联的个人知识库笔记应用,数据掌握在自己手里。TypeScript38,542
  5. avenoxai/avenoxbeyin面向 AI 编程代理的本地 Markdown 记忆系统,让决策和任务跨会话可保存、可检索。Python436