Obsidian 的进化：从笔记应用到 AI Agent 的认知基础设施层

副标题：我花了 3 年把 Obsidian 当记事本用，然后在 2026 年的某一天，它变成了我的 AI Agent 的操作系统

我说不出话的

2026年3月，某个工作日下午。

我在终端里输入了一行命令：

Bash

claude "帮我整理上周所有项目的决策记录，\
更新到对应的 DECISIONS.md，\
并检查是否有未解决的技术债"

然后我去倒了杯咖啡。

回来时，Claude 已经读取了我 Vault 里过去7天的23篇笔记，自动定位了4个项目文件夹，更新了3份 DECISIONS.md，并在 02-Areas/technical-debt.md 里新增了5条技术债记录——每一条都附有来源链接，指向产生它的原始笔记。

整个过程我没有参与一秒钟。

这不是 Obsidian 的插件功能。这不是某个 AI 工具的特殊集成。这是一个 AI Agent，把我的本地文件系统当作它的工作空间，在里面自由地读、写、整理。

我花了大概一分钟看着终端的输出发呆。

然后我意识到一件事：Obsidian 已经不是一个笔记应用了。

一、Obsidian 的用户在增长，但原因变了

2026年2月，Obsidian 刚刚突破150万活跃用户，年增长率22%。原因很清晰：在 AI 重塑工作方式的时代，Obsidian 的本地优先、基于 Markdown 的方式使其成为 AI 驱动第二大脑的理想基础。

但这里有一个有趣的反转：

有一位用户捕捉到了一个我持续观察到的趋势：「我对 Markdown 毫无兴趣，直到我开始与 AI 一起工作。」人们是因为 AI 集成而来到 Obsidian，而不是反过来。

这一句话道出了 2026 年 Obsidian 生态的本质变化。

三年前，人们用 Obsidian 是因为双向链接、图谱视图、Zettelkasten 方法论。今天，越来越多的新用户来到 Obsidian，是因为一个非常实际的原因：它的 Markdown 文件可以被 AI Agent 直接读写，不需要任何 API，不需要上传到任何云端。

Obsidian 将所有内容存储为文件系统上的纯 .md 文件。没有专有数据库，不需要云同步。这意味着任何能读取文件的 AI Agent 都能读取你的 Vault。Claude Code 可以直接 cd 进你的 Vault 文件夹开始工作。试着对 Notion 这样做。

二、三年的认知断层：我为什么一直用错了 Obsidian

让我说一件让自己有点尴尬的事。

在 2026 年之前，我用 Obsidian 的方式是这样的：

• 记会议纪要
• 存读书笔记
• 偶尔写一些思考片段
• 然后这些笔记就静静地躺在那里，慢慢腐烂

我的 Vault 有大约 3000 个文件，但我真正经常访问的不超过 50 个。

这是 PKM（个人知识管理）圈子里一个非常普遍的问题，有人专门给它起了个名字：

「Dead Vault 综合症」——Vault 里积累了大量笔记，但它们之间的连接从未真正建立，知识联系从未真正涌现，整个系统只是一个更漂亮的文件夹。

传统的第二大脑（以 Tiago Forte 的方法论推广的那种）是一个经过整理的、可搜索的知识库。Obsidian 是实现这个目标的最好工具之一：本地优先、基于 Markdown、有强大的图谱视图和插件生态。但它仍然是被动存储。

被动存储的核心问题在于：你投入时间建设它，但它不会主动回馈你。它就像一个很好的图书馆，但没有馆员。你知道答案在里面，但找到它需要你自己花时间。

改变这一切的，是三件事同时发生。

三、改变一切的三件事

第一件：Claude Code 学会了读写 Markdown

2025年底，Claude Code 开始支持直接操作本地文件系统。这意味着你可以告诉它：「帮我在 01-Projects/ 里创建一个新项目文件夹，按照 Templates/project-template.md 的结构。」

它会照做。完美地。包括 frontmatter、wikilinks，所有 Obsidian 特有的语法——只要你教会它。

第二件：Steph Ango 发布了 obsidian-skills

2026年1月，Obsidian 的 CEO Steph Ango（GitHub 用户名：kepano）发布了一个叫 obsidian-skills 的仓库。

当 Obsidian CEO Steph Ango 在 2026 年 1 月发布 obsidian-skills 时，它在不到三个月内获得了 14,900 颗 GitHub Star。对于一个本质上是五个 Markdown 文件——用来教 Claude Code 如何写 wikilinks——的仓库来说，这不正常。

这五个文件解决了一个具体问题：

Obsidian Skills 之所以病毒式传播，是因为它解决了每一个 Obsidian + AI 用户都会遇到的问题：Claude 会写标准的 Markdown，但它不了解 [[wikilinks]]、callouts、Bases 或 Canvas。你的 AI 生成的笔记看起来差不多对，但每次都需要手动清理。这五个 Skills 文件彻底解决了这个问题——开发者们为此疯狂。

值得注意的是，这个数字后来还在持续增长：截至最新统计，obsidian-skills 已有 35,900+ 颗 GitHub Star，在 r/ObsidianMD 上有活跃讨论，Medium 和 YouTube 上有大量教程，开发者们正在基于它构建 CRM、Sprint 追踪器，甚至完整的商业操作系统。这不是一个新奇玩意儿，而是正在成为 vibe coding + PKM 交叉地带的基础设施。

第三件：Obsidian 官方发布了 CLI

2026年2月起，Obsidian 随附官方 CLI，暴露100多个命令——搜索、笔记创建、每日笔记管理、内容追加——所有命令均可从终端访问。

这一件事的意义比它看起来大得多。

任何拥有 Shell 访问权限的 AI Agent 现在都可以直接操作你的 Vault，而无需 MCP 服务器或额外插件：obsidian search query="authentication decision"；obsidian daily:append content="Pending task"；obsidian create --title="ADR: New API" --vault=my-vault。

CLI 的发布是一个明确的产品方向信号。

这不是一个社区 Hack。这是一个产品方向信号：Obsidian 正在从一个笔记应用进化成一个轻量级知识工作操作系统，以 AI 为协调层。

四、认知基础设施层：这个词究竟是什么意思？

过去一年，某些东西已经发生了转变。有能力的 AI 编码代理、开源嵌入模型，以及新一代「Agent Skills」的到来，已经将 Obsidian 从一个记笔记的应用转变成了更接近认知基础设施层的东西：一个 AI Agent 在其上思考、记忆和推理的基底。

「认知基础设施层」——这个词我自己推敲了很久。

用一个类比来解释它：

传统的 Obsidian 使用方式 = 图书馆。你存放书，你自己去找书，你自己从书里提取信息。AI 是一个能帮你搜索的图书管理员。

认知基础设施层的 Obsidian = 操作系统。你的 Vault 是文件系统，AI Agent 是运行在其上的进程，你是设计这个系统运作规则的架构师。

区别在于：在操作系统上，进程之间可以互相通信，可以写入共享文件，可以在你不在时继续运行。

五、具体是怎么运作的？技术全景图

让我把整个生态梳理成一张清晰的图：

text

你的 Obsidian Vault（纯 Markdown 文件）
        │
        ├── .claude/
        │   ├── CLAUDE.md          ← AI 的操作手册
        │   └── obsidian-skills/   ← Steph Ango 的5个文件
        │
        ├── 00-Inbox/              ← 所有新内容先进这里
        ├── 01-Projects/           ← 活跃项目
        ├── 02-Areas/              ← 持续责任区域
        ├── 03-Resources/          ← 参考资料
        ├── Decisions/             ← DECISIONS.md 集中存储
        └── Templates/             ← AI 生成笔记的模板
                │
                │  AI 访问 Vault 的三条通道
                │
     ┌──────────┼──────────────┐
     ▼          ▼              ▼
  MCP 协议   官方 CLI        直接文件读写
（推荐）     （轻量）          （Claude Code）
     │          │              │
     ▼          ▼              ▼
Claude      任意 Shell      Claude Code
Desktop     脚本/cron       直接 cd 进 Vault

三条通道各有适用场景

MCP 协议：最强大，支持双向交互。

Claude Code + MCP 是最强组合：通过 MCP 将 Claude Code 连接到你的 Obsidian Vault，让 AI Agent 可以从命令行直接读取、搜索、创建和修改笔记。Obsidian 在单人 AI 工作流上胜过 Notion：2700+ 插件、任意模型支持、完全离线访问，以及通过 Ollama 的本地 AI。

市场上有五个主流的 Obsidian MCP Server 实现：

五个实现占据主导地位，分成两大架构阵营：通过 REST API 连接的服务器（需要 Obsidian Local REST API 插件，且 Obsidian 必须在运行），以及直接读取 Markdown 的文件系统服务器。

我的推荐：

• mcpvault：基于文件，不需要插件，14个工具，BM25 搜索。目前维护最活跃的选择。
• mcp-obsidian（3000 颗星）：基于 REST API，需要 Local REST API 插件，7个工具。成熟稳定的选择。

官方 CLI：最轻量，适合脚本和 cron 任务。

不需要配置 MCP，不需要安装插件。任何 Shell 脚本都能调用。适合定时任务（比如每天凌晨自动整理 Inbox）。

Claude Code 直接读写：最灵活，但需要安装 obsidian-skills。

这是目前最像「认知基础设施层」的使用方式。配合 CLAUDE.md，Claude Code 可以像一个了解你整个知识系统的工程师一样工作。

六、CLAUDE.md：你的 Vault 操作系统的启动配置

这是整个系统里最重要的单个文件。

我最终确定了一套对 AI Agent 效果很好的文件夹结构。核心洞察来自一位开发者，他把 Vault 组织得「像一家公司」，设有部门文件夹：.claude/（存放 obsidian-skills + CLAUDE.md）、00-Inbox/、01-Projects/、02-Areas/、03-Resources/、04-Archive/、Decisions/ 和 Templates/。

下面是我自己的 CLAUDE.md 模板，可以直接使用：

Markdown

# CLAUDE.md
# 这是你操作这个 Vault 的指南。每次开始工作前请阅读。

## 这个 Vault 是谁的？
这是 [你的名字] 的个人知识库，专注于 AI 部署工程、FDE 实践
和知识工程方法论。

## Vault 结构
- `00-Inbox/`：所有新内容的入口，未整理的原始笔记
- `01-Projects/`：每个活跃项目一个子文件夹
  - 每个项目必须有 `README.md` 和 `DECISIONS.md`
- `02-Areas/`：持续关注的领域（FDE技能、读书、写作）
- `03-Resources/`：参考资料，按主题组织
- `04-Archive/`：已完成或不再活跃的内容
- `Decisions/`：所有重要决策的中央存储
- `Templates/`：笔记模板，创建新笔记时参考

## 写作规范（必须遵守）
1. 所有内部链接使用 `[[双中括号]]` 格式
2. 所有笔记必须包含 frontmatter：
   ```yaml
   ---
   created: YYYY-MM-DD
   tags: []
   status: active/archived/draft
   ---

3. 禁止修改 04-Archive/ 里的任何文件
4. 禁止删除任何笔记（移动到 Archive 而不是删除）

你可以做什么

✅ 读取任何笔记 ✅ 在 00-Inbox/ 创建新笔记 ✅ 在 01-Projects/ 的对应项目中更新 DECISIONS.md ✅ 在 02-Areas/ 更新技能追踪笔记 ✅ 移动文件到 04-Archive/

你不可以做什么

❌ 修改 Templates/ 中的文件（除非明确被要求） ❌ 删除任何文件 ❌ 修改任何 frontmatter 中的 created 字段 ❌ 在未经确认的情况下重命名已有文件

上下文快捷方式

• 当前活跃项目：见 02-Areas/active-projects.md
• 技术债记录：见 02-Areas/technical-debt.md
• 我的写作风格：见 02-Areas/writing-style-guide.md

七、一个真实工作流：AI 驱动的知识沉淀循环

下面是一个我实际在用的自动化工作流，用 bash + Claude Code + Obsidian CLI 构建：

#!/bin/bash
# daily_knowledge_loop.sh
# 每天凌晨6:00由 cron 运行
# 功能：自动处理 Inbox、更新知识库

VAULT_PATH="$HOME/obsidian-vault"
DATE=$(date +%Y-%m-%d)
LOG_FILE="$VAULT_PATH/02-Areas/automation-log.md"

echo"## $DATE 自动整理日志">>"$LOG_FILE"

# 步骤1：检查 Inbox 有多少未处理笔记
INBOX_COUNT=$(find"$VAULT_PATH/00-Inbox"-name"*.md"|wc-l)
echo"- Inbox 笔记数：$INBOX_COUNT">>"$LOG_FILE"

if["$INBOX_COUNT"-gt0];then
# 步骤2：让 Claude 整理 Inbox
    claude --dangerously-skip-permissions \
"请处理 $VAULT_PATH/00-Inbox/ 里的所有笔记：
       1. 读取每篇笔记的内容
       2. 根据内容判断它属于哪个项目或领域
       3. 将它移动到对应的 01-Projects/ 或 02-Areas/ 文件夹
       4. 如果无法判断归属，保留在 Inbox 并添加 tag: needs-review
       5. 更新 $VAULT_PATH/02-Areas/inbox-log.md 记录每次移动

       遵守 $VAULT_PATH/.claude/CLAUDE.md 中的所有规范。"\
--allowedTools"Read,Write,Edit,Bash"

echo"- Inbox 整理完成">>"$LOG_FILE"
fi

# 步骤3：检查技术债有无新增
TECH_DEBT_COUNT=$(grep-c"status: open"\
"$VAULT_PATH/02-Areas/technical-debt.md"2>/dev/null ||echo0)
echo"- 未解决技术债：$TECH_DEBT_COUNT">>"$LOG_FILE"

# 步骤4：如果有超过10条未解决技术债，创建周报草稿
if["$TECH_DEBT_COUNT"-gt10];then
    claude --dangerously-skip-permissions \
"读取 $VAULT_PATH/02-Areas/technical-debt.md，
       生成一份技术债优先级排序报告，
       保存到 $VAULT_PATH/00-Inbox/tech-debt-report-$DATE.md"\
--allowedTools"Read,Write"
fi

echo"✅ 每日知识循环完成">>"$LOG_FILE"

这个脚本每天运行，我完全不需要参与。

「手动维护 Obsidian 大概只能坚持一周，然后就被废弃了。只有当 AI Agent 接管日常维护时，Vault 才能真正成为第二大脑。」——@Atenov_D，2026年3月

这句话我完全认同。

八、最大的坑：AI 有写入权限之后会发生什么

不讲这个，这篇文章就是不诚实的。

14 在启用写入权限之前，先备份你的 Vault。用 Git 对 Vault 进行版本控制，这样就可以撤销任何不想要的更改。

具体来说，我踩过以下坑：

坑1：AI 静默覆盖了笔记

Claude 在「整理」一篇笔记时，把我认为重要的原始段落删掉了，替换成了「更简洁的版本」。我的原始想法消失了。

解法：在 CLAUDE.md 里明确规定「编辑时保留所有原始内容，追加而不是替换」。并且配置 Git 自动提交：

Bash

# 在 Vault 根目录的 .git/hooks/post-commit 里
# 每次有文件变动自动 commit
cd "$VAULT_PATH" && git add -A && \
git commit -m "auto: $(date '+%Y-%m-%d %H:%M')" --no-verify

坑2：AI 创建了大量重复笔记

相同的主题在10次不同的对话里被讨论，产生了10个几乎相同的记忆条目（这里结合了 Claudian 工具的实测反馈）。 去重成了一个真实的维护负担。

解法：在运行任何创建类任务之前，让 Claude 先搜索是否已有相关笔记：

text

在创建任何新笔记之前，必须先运行：
obsidian search query="[关键词]"
如果已有相关笔记，更新现有笔记而不是创建新笔记。

坑3：写入操作在 Obsidian 打开时产生冲突

文件系统服务器直接读写 Markdown 文件，不需要 Obsidian 在运行。但在 Obsidian 打开时做的修改可能与 Obsidian 自己的文件监视器产生冲突，尽管在实践中这种情况很少发生。

解法：把重型自动化任务（比如批量整理 Inbox）安排在 Obsidian 关闭的时间段（比如凌晨）运行。日常的读取和追加操作不受影响。

九、Cognition 的一个数据点让我改变了架构

Cognition 测量到 AI 编码 Agent 60% 的时间花在搜索上下文上。给它们对知识和代码的结构化访问权限，可以显著降低这部分开销。

这个数据让我重新理解了 Vault 结构设计的重要性。

AI Agent 在你的 Vault 里搜索的效率，直接决定了它工作的质量和成本。一个结构混乱的 Vault，让 AI 花 60% 的时间在搜索上；一个结构清晰的 Vault，可以把这个比例大幅降低。

用一致的 tags、links 和 metadata 结构化笔记，确保 AI 插件能为任何任务检索到正确的上下文，从而将你的 Vault 变成每次 AI 交互的持久知识库。

具体来说，我在 frontmatter 里加入了以下字段：

YAML

---
created: 2026-06-15
modified: 2026-06-21
tags: [rag, production, deployment]
project: "[[01-Projects/enterprise-rag]]"
status: active
type: decision  # note/decision/resource/meeting/daily
ai-context: "这篇笔记包含我们选择 ChromaDB 的完整决策推理"
---

ai-context 字段是我自己加的——专门写给 AI Agent 看的一句话摘要，告诉它这篇笔记最重要的信息是什么。这大幅减少了 AI 需要完整读取笔记才能决定是否相关的情况。

十、Obsidian vs Notion：一场关于数据主权的架构选择

这是很多人在问的问题。我给一个直接的答案。

为什么 Obsidian 脱颖而出：你的笔记就是设备上的纯 Markdown 文件。这意味着：任何 AI 都能访问它们，不被锁定在单一 AI 提供商；本地模型原生运行；MCP 集成——Claude Code 和其他 Agent 可以直接读写你的 Vault；无需上传——除非你选择，数据永远不会离开你的机器。Notion 胜在团队协作和结构化数据库。对于构建 AI 第二大脑的个人知识工作者来说，Obsidian 胜出。

但这个选择的深层逻辑，不只是功能对比。

它是 File over App 哲学的具体体现：

当你把笔记存在 Notion 里，你依赖 Notion 的服务器来检索它们，依赖 Notion 的 API 来让 AI 访问它们，依赖 Notion 的商业决策来保证它们永远可用。

当你把笔记存在 Obsidian 里，它们就是你电脑上的 .md 文件。任何会读文件的 AI，永远都能访问它们。你不依赖任何公司的服务条款。

我们可以在本地维护自己的知识库，用 Git 这样的标准工具管理它们，并利用 MCP 这样的协议让 AI 模型在我们设定的条件下与我们的数据交互。这给了 AI 一个我们拥有和管理的持久记忆，使得在复杂目标上的深度、长期协作成为可能。

结语：你的 Vault 是你最有价值的数字资产

让我用一个预测结束这篇文章。

三年后，当 AI Agent 变得更强大，能做更多事情时，最有价值的不是你用了哪个 AI 模型，而是你给它的上下文有多丰富、多准确、多结构化。

13 AI 驱动的检索将多年积累的知识变成了即时可查询的资源。结合 Context Engineering 原则，你的 Obsidian Vault 成为真正的竞争优势。

你今天建设的每一篇笔记，每一个 DECISIONS.md，每一条结构化的 frontmatter，都是在给未来的 AI Agent 更好的原材料。

这是一种特殊的长期主义：不是为了未来的你在写作，而是在为未来的你和 AI 的协作在建设基础设施。

Vault 的质量，就是你的 AI 协作质量的上限。

现在就开始认真对待它。