你的 Obsidian Wiki，是每个项目都能调用的"个人知识 API"

你的 Obsidian Wiki，是每个项目都能调用的"个人知识 API"

作者：一只阿木木

程序员最懂 API 的价值。

你设计一个接口，任何服务都能调用它，永远不需要重复实现逻辑。 但奇怪的是，在知识管理这件事上，程序员们却一直在做最反模式的事：

每换一个项目，就重新在脑子里"初始化"一次背景——这个技术栈我踩过哪些坑、那次选型我为什么否决了 Redis、上个月读过的那篇关于 gRPC 的文章写的什么……

你的知识，存在你的大脑里，存在某个 Notion 页面里，存在已经关掉的 Claude 对话框里。每一个新项目，你都在从零开始调用一个不存在的接口。

今天要告诉你的是：这个接口可以被建出来。

1. 程序员在知识管理上的"最大悖论"

写代码时，你严格遵守 DRY（Don't Repeat Yourself）原则，绝不容忍复制粘贴的逻辑。 但在知识管理上，你每天都在重复：重新解释上下文、重新回忆上次的结论、重新搜索三个月前读过的那篇文章。

这不是个人问题，这是工具设计问题。

大多数程序员的"知识管理现状"长这样：

text

项目A的笔记  ←  只能在项目A里用
项目B的技术决策  ←  只活在当时的 Claude 对话里
项目C的技术调研  ←  沉在某个 Notion 页面里再也没打开过

三个孤岛，零复用，零复利。

大多数人使用 AI 的方式是：打开聊天框，问问题，关掉标签，重来一遍。每次会话都是孤岛。AI 从不了解你的上下文、你的过去决策、你正在进行的项目。

知识的孤岛化，是生产力的最大漏洞。

2. 范式转移：vault 不是笔记本，是知识服务层

理解这套系统的关键，是一个根本的认知转变：

你的 Obsidian vault，不是你的"笔记本"，是你的"知识服务层"。

笔记本：你写进去，然后定期翻阅，大概率不翻。 知识服务层：任何工具、任何项目、任何 AI 对话，都可以"调用"它。

这是一个跨 CLI 的 Obsidian 技能，可以把你的 vault 变成一个跨 Claude Code、Codex CLI、Gemini CLI 和 OpenCode 的活体 AI 第二大脑，支持 34 个命令、vault 优先研究和定时 Agent。

不锁定任何一个工具。你的知识，作为基础设施层存在。

3. 架构图解：三层结构，一个知识 API

这是最终形态的架构图：

text

┌─────────────────────────────────────────────┐
│              你的所有工作场景                  │
│  项目A  │  项目B  │  项目C  │  新对话  │  任何CLI │
└────────────────────┬────────────────────────┘
                     │ 统一调用
┌────────────────────▼────────────────────────┐
│           知识 API 层（你的 vault）            │
│                                              │
│  /wiki-query  ←  读取：带引用的知识提取         │
│  /wiki-update ←  写入：提炼当前项目的洞察       │
│  wiki/hot.md  ←  热缓存：跨会话记忆恢复        │
│  CLAUDE.md    ←  全局规则：跨项目行为约束       │
└────────────────────┬────────────────────────┘
                     │ 持久化存储
┌────────────────────▼────────────────────────┐
│         本地 Markdown 文件层（不可变资产）      │
│   wiki/entities/  wiki/concepts/  wiki/synthesis/  │
└─────────────────────────────────────────────┘

职责分离是关键：raw/ 是源材料存放的地方，wiki/ 是模型写页面的地方，CLAUDE.md 是操作规则存放的地方，index.md 告诉模型哪些页面已经存在，log.md 记录最近发生了什么。没有这个结构，你只有一个在文件夹里浏览的聊天机器人；有了它，你有了可重复执行的维护工作流。

4. 实操：两个命令，接通"个人知识 API"

搭建好 claude-obsidian 之后，和任何项目对接只需要两步。

Step 1：在全局 ~/.claude/CLAUDE.md 里声明你的知识库路径

Markdown

## 个人知识库（全局，所有项目共享）
路径：~/my-obsidian-vault/wiki/
每次会话开始时，按以下顺序读取上下文：
1. wiki/hot.md       ← 最近的工作记忆
2. wiki/index.md     ← 全局知识索引
3. wiki/entities/[相关技术].md ← 按需深入
当前项目完成值得保留的决策时，询问是否运行 /wiki-update。

一次配置，永久生效。此后所有项目里启动的 Claude Code，都会自动加载你的知识库上下文。

Step 2：两个命令，双向流动

Bash

# 在任意项目里，把当前项目的洞察"写进"知识库
/wiki-update
# 在任意项目里，"读取"知识库里的相关内容
/wiki-query 我对 rate limiting 了解多少？

/wiki-update 读取你的项目，找出值得保留的内容，并将其提炼进你的 Obsidian vault——架构决策、你发现的模式、关键概念、你评估过的权衡。

它不会把你的项目代码复制进去，它提炼的是三个月后你会遗忘的那些东西。

5. 场景演练：5 个真实的"跨项目调用"场景

场景 1：你在新项目里遇到了熟悉的技术选型

Bash

> /wiki-query 我之前做过哪些关于数据库选型的调研？

系统不只给你上次的结论，还会把相关的 [[postgresql-vs-mongodb]] 页面、[[决策背景-2024-11]] 一并引出来。你三个月前的技术判断，今天直接复用。

场景 2：技术会议结束后，30 秒归档

你刚开完一个关于微服务拆分方案的评审会，打开终端：

Bash

> /wiki-update

开完会议后运行 /obsidian-save，Claude 会提取每一个决策、人员、任务和想法，并把它们各自保存到正确的笔记页面里。你什么都不用做。

你做了决策，系统帮你记住。

场景 3：向新人解释技术背景

新同事入职，你不需要重新讲解整个系统背景：

Bash

> /wiki-query 我们为什么从 REST 迁移到 gRPC？

系统找到当时的决策记录页面，带着原因、取舍、参考资料，一并返回。你的 wiki 成了技术历史的活档案。

场景 4：给下一个项目做准备

在项目结束时运行一次 /wiki-update，把这个项目最重要的教训提炼进知识库。下一个项目启动时，你的 AI 协作者已经知道："上次你在高并发场景下遇到了 Redis 连接池的问题，这次是否需要提前规划？"

场景 5：白板照片 → 知识库

你给白板拍了一张照片，运行 /obsidian-ingest photo.png，Claude 读取图片，提取文字和结构，创建概念笔记，并链接到相关项目。一张照片变成了知识。

6. 跨 CLI 接入：不绑定任何一个工具

这一点极为关键，大多数人没意识到。

你不一定永远只用 Claude Code。也许你今天在用 Cursor，明天换了 Gemini CLI，后天团队推了 Codex CLI。

整套系统是一组任何 AI 编程 Agent（Claude Code、Cursor、Windsurf、Pi 等）都能读取和执行的 Markdown 技能文件。你只需把它指向你的 Obsidian vault，告诉它做什么。

具体来说，安装一次后，技能文件会通过符号链接（symlink）分发到所有 Agent 的全局发现路径：

Bash

# 安装一次，自动覆盖所有工具
obsidian-wiki setup --vault /path/to/your/vault

wiki 技能被符号链接到 ~/.claude/skills/，在 Claude Code 的所有项目里都可以使用；同时被链接到所有 Agent 的全局发现路径。

你的知识库，不被任何一个工具绑架。它是基础设施，不是插件。

7. 进阶：夜间 Agent，让知识库在你睡觉时自动生长

这是最接近"自动生长的知识系统"的功能。

你甚至不需要打开 Obsidian，一切都通过 Claude 发生。系统分为四层：操作层（28 条命令，Claude 记住一切）、思考工具层（7 条命令，Claude 与你共同思考）、上下文引擎层（1 条命令，Claude 了解你是谁）、研究工具包层（7 条命令，Claude 把知识引入进来），加上始终运行的后台 Agent 和 4 个定时 Agent。

在你睡觉的时候，定时 Agent 完成五件事：

1. 收尾当天：整理当日所有碎片笔记
2. 调和矛盾：发现知识库里的逻辑冲突并标注
3. 跨来源综合：把多份资料里的共同模式提炼成综合页面
4. 修复孤立笔记：把没有任何链接的页面接入知识网络
5. 重建索引：确保 index.md 完整准确

早上你打开终端，知识库比昨晚更聪明了一点。这才是"自动生长"的字面意思。

8. 你的知识 API，是你唯一不被替代的竞争壁垒

在 AI 工具迭代如此之快的今天，每一个工具都可能在三个月内被替代，但有一件东西不会被替代：你积累的、带有你判断和上下文的知识资产。

Obsidian 把一切存储为本地的纯 .md 文件。没有专有数据库，无需云同步。这意味着任何能读文件的 AI Agent，都能读取你的 vault。

你的 vault 就是一个文本文件夹。就算 Obsidian 明天消失了，你的笔记依然能在 VS Code、Vim 或任何文本编辑器里正常工作。

你的知识，永远归你所有。工具来来去去，个人知识 API，才是真正的护城河。

在 AI 时代，你的知识积累，才是最深的技术壁垒。