乐于分享
好东西不私藏

手把手教你搭建一个 AI 知识库搭建

手把手教你搭建一个 AI 知识库搭建

✨ 前言:为什么你需要一个 AI 驱动的知识库?

你存了几百篇文章,打了几十份笔记,但要用的时侯怎么也找不到。

这不是你的问题。 知识管理最耗人的部分,从来不是"读"和"想",而是整理 :把信息分类、建立链接、让旧笔记和新资料串起来。

前 OpenAI 联合创始人 Andrej Karpathy 最近公开了他的解法: 让 AI 代替你做这些整理工作 。你只需要把资料丢进去,剩下的摘要、分类、交叉链接、维护——全部交给 AI。

🔧 第一部分:工具准备与安装

1️⃣ 安装 Obsidian(知识库容器)

Obsidian 是一款免费的本地优先笔记应用,所有数据存储在你自己的电脑上,不上传云端。

下载与安装

  • • 官方下载地址 : https://obsidian.md/download
  • • 支持 Windows、macOS、Linux 全平台

创建你的第一个 Vault(保险库)

  • • 打开 Obsidian
  • • 点击「创建」新建仓库
  • • 选择文件夹位置(建议选择云同步文件夹,如 iCloud/OneDrive)
  • • 命名你的知识库名称

推荐插件:Web Clipper(网页剪藏)📌

在浏览器扩展商店搜索 "Obsidian Web Clipper" 安装,可以一键将网页文章保存为干净的 Markdown 格式到 Obsidian。

推荐插件:Local Image Plus

进入Obsdian -> 设置 -> 第三方插件 关闭安全模式后,在社区插件市场搜索 Local Image Plus 进行安装,安装完成后可以将文章中的图片一键下载到附件存储路径。

2️⃣ 安装 Claude Code(AI 引擎)🤖

Claude Code 是 Anthropic 推出的命令行 AI 工具,它可以直接进入你的文件夹,读取笔记、写入新内容、更新目录——就像一个能操作你电脑的 AI 助理。

系统要求

  • • Node.js 18+ 版本
  • • npm 包管理器
  • • Anthropic API 密钥或 Claude Pro 订阅

安装步骤

# 1. 安装 Node.js(如果尚未安装)
# 访问 https://nodejs.org 下载 LTS 版本

# 2. 验证安装
node --version
npm --version

# 3. 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 4. 验证安装成功
claude --version

配置 API(重要)

如果你没有 Claude 官方订阅,可以使用第三方 API 服务:

# 配置环境变量(示例)
export ANTHROPIC_BASE_URL="https://your-api-provider.com"
export ANTHROPIC_API_KEY="your-api-key-here"

💡 小贴士 :推荐使用 cc switch 工具来切换不同的模型和 API 提供商,非常方便!


3️⃣ 安装 Claudian(图形化桥梁)🌟

Claudian 是一个革命性的 Obsidian 插件,它将 Claude Code 以图形化界面接入 Obsidian,比原生的命令行界面好用太多!

为什么需要 Claudian?

特性
原生 Claude Code
Claudian 插件
界面
命令行终端
图形化侧边栏
文件引用
手动输入路径
直接拖拽文件
上下文管理
复杂
可视化
学习曲线
陡峭
平缓

安装方法

Step 1:安装 BRAT 插件(第三方插件管理器)

  • • 打开 Obsidian → 设置(左下角齿轮图标)
  • • 进入「第三方插件」
  • • 关闭「安全模式」(如果开启)
  • • 点击「浏览」
  • • 搜索 "BRAT" 并安装
  • • 启用 BRAT 插件

Step 2:通过 BRAT 安装 Claudian

  • • 通过左侧图标 打开BRAT面板
  • 选择 "add a beta plugin for testing"
在弹出的对话框中输入插件地址并选择安装的版本 https://github.com/YishenTu/claudian
  • • 点击「添加」并确认安装
  • • 安装完成后,在插件列表中找到 Claudian 并启用
  • • 点击左侧claudian图标即可启用

🚀 第二部分:构建 Karpathy 式知识库系统

核心理念:像编译代码一样编译知识 💡

Karpathy 的方法出奇地简单: 不依赖向量数据库,不搭建 RAG 架构,直接让 LLM 读写 Markdown 文件 。

对于个人知识库规模(约 100 篇文章、40 万词),直接让 LLM 读取它自己维护的摘要文件,效果不比向量检索差,但简单得多。

这张图展示了完整的四阶段流程:

  • • Phase 1 - Ingest(摄入) :使用 Obsidian Web Clipper 收集原始资料
  • • Phase 2 - Compile(编译) :LLM 自动生成摘要、提取概念、建立索引
  • • Phase 3 - Query(查询) :通过自然语言或搜索进行问答
  • • Phase 4 - Lint(维护) :定期检查和更新知识库

三层目录结构 📁

整个知识库就是一个普通文件夹,里面全是 markdown 文件:

knowledge-vault/
├── raw/                    # 原始资料(只进不改)
│   ├── articles/           # 网页文章
│   ├── podcasts/           # 播客转录
│   └── papers/             # 论文

├── wiki/                   # 编译产物(LLM 维护)
│   ├── indexes/            # All-Sources.md, All-Concepts.md
│   ├── concepts/           # 概念条目(一个概念一个文件)
│   └── summaries/          # 逐篇摘要

├── outputs/                # 运行时输出
│   ├── qa/                 # 问答沉淀
│   └── health/             # 健康检查报告

├── blog/                   # 可发布的博客文章
├── brain/                  # 个人目标和模式
└── .claude/commands/       # Claude Code 自定义命令

类比软件工程 :

  • • raw/ = src/ (源代码)
  • • wiki/ = build/ (编译产物)
  • • outputs/ = logs/ (运行日志)


💻 第三部分:使用 Claudian 进行知识管理

Claudian 界面介绍

安装完成后,你会在 Obsidian 右侧看到 Claudian 的面板。它提供了完整的 AI 对话能力,可以直接引用文件、执行命令、生成内容。

核心功能演示 🎯

1️⃣ 摄入资料(Ingest)

当你看到一篇好文章:

# 操作步骤

1. 使用 Obsidian Web Clipper 保存网页到 raw/articles/
2. 或者在 Claudian 中输入:

   /ingest https://example.com/some-article

3. Claude 自动:
   - 提取网页内容
   - 转换为干净 Markdown
   - 保存到指定文件夹
   - 更新索引文件

2️⃣ 编译知识库(Compile)

攒了几篇原始资料后:

# 在 Claudian 中执行

/compile

# Claude 会自动:
✅ 扫描 raw/ 中所有未编译的资料
✅ 为每篇生成摘要 → wiki/summaries/
✅ 提取概念 → wiki/concepts/
✅ 更新索引 → All-Sources.md, All-Concepts.md
✅ 建立交叉链接

3️⃣ 智能问答(Query)

当知识库积累到一定规模:

# 直接用自然语言提问

@wiki/indexes/All-Concepts.md
请帮我总结关于"Transformer架构"的所有资料,
并找出不同论文之间的关联。

4️⃣ 定期维护(Lint)

保持知识库健康:

# 执行健康检查

/lint

# Claude 会:
🔍 找出不一致的信息
📝 补充缺失的交叉链接
💡 建议新的研究方向
🗑️ 标记过时的内容

📊 第四部分:效果对比与传统方法的差异

传统知识管理 vs. AI 驱动知识管理 ⚡

维度
传统方法(手动)
Karpathy 方法(AI 驱动)
整理时间
每篇 30-60 分钟
每篇 < 1 分钟(自动)
一致性
取决于状态
高度一致
交叉链接
经常遗忘
自动建立
检索效率
关键词搜索
自然语言问答
可扩展性
100 篇以上崩溃
轻松处理 1000+ 篇
维护成本
持续投入
定期 Lint 即可

实际收益统计 📈

根据社区用户反馈:

  • • ⏰ 节省时间 :每周减少 10-15 小时整理时间
  • • 📈 知识留存率 :提升 300%(因为可检索)
  • • 🎯 输出质量 :文章深度和广度显著提升
  • • 😌 心理负担 :不再有"收藏从未阅读"的焦虑

🔧 第五部分:高级技巧与优化

1️⃣ 自定义 Claude Code 命令 ⚙️

在 .claude/commands/ 目录下创建自定义命令:

<!-- .claude/commands/blog.md -->
---
description: "基于当前知识库生成博客文章"
---

执行以下任务:
1. 读取当前会话上下文
2. 查询 wiki/indexes/All-Concepts.md
3. 生成 2000 字博客草稿
4. 包含引用链接
5. 输出到 blog/ 目录

2️🎴 使用模板标准化输出

在 Obsidian 中创建模板文件夹:

templates/
├── concept-template.md      # 概念条目模板
├── summary-template.md      # 摘要模板
└── blog-template.md         # 博客模板

3️🗂️ 多知识库协作

为不同项目创建独立的 Vault:

~/knowledge/
├── ai-research/             # AI 研究知识库
├── product-management/      # 产品管理知识库
└── personal-development/    # 个人成长知识库

💬 最后的话 🎯

Karpathy 的方案代表了一种全新的思路: 让 AI 成为知识的主人,你只需要喂它原材料 。

这不仅是工具的升级,更是思维方式的转变——从"我要如何整理知识"变成"我要如何设计一个能让 AI 替我整理知识的系统"。

正如 Obsidian CEO Kepano 所说:" AI 知识库的本质,是把人从低价值的整理工作中解放出来,专注于高价值的思考和创造。 "

现在,就开始打造属于你的第二大脑吧!