04-03 · Obsidian + CLI 知识库

Obsidian 是你的第二大脑，也是你 Agent 的长期记忆。 学到的概念、读过的文章、跑通的命令、踩过的坑、写过的 Skill —— 都该沉淀到这里。这是公司唯一指定的个人知识库工具。

一、为什么是 Obsidian

维度	Notion	飞书文档	Obsidian
数据所有权	在 Notion 服务器	在飞书服务器	本地纯 Markdown 文件
离线	❌	❌	✅
AI 友好	有限	有限	极佳（一个文件夹，AI 想读啥读啥）
双向链接	有	弱	✅
插件生态	弱	弱	超丰富（2000+ 社区插件）
Git 版本管理	❌	❌	✅
是否能让 Agent 直接读写	❌	❌	✅

Obsidian Vault = 一个纯 markdown 文件夹。这意味着：

Claude Code 一句"读 ~/Obsidian 然后总结"就能用
你能用 git 管理它、回滚它、多端同步它
Hermes / OpenClaw 都能把它当作上下文源

二、安装与基础配置

2.1 安装

官网：https://obsidian.md/
完全免费（个人 / 公司内部使用）

2.2 创建 Vault

~/qdy-vault/                  ← 你的知识库根目录
├── 00-Inbox/                ← 临时收纳
├── 10-Notes/                ← 永久笔记（atomic notes）
├── 20-Projects/             ← 项目笔记
├── 30-References/           ← 文章 / 资料剪藏
├── 40-Skills/               ← 你写的 SKILL.md（与 ~/.claude/skills 软链）
├── 50-Snippets/             ← 代码片段、命令、prompt 模板
├── 90-Daily/                ← 每日笔记
└── attachments/             ← 图片资源

公司心法：目录结构不超过 3 层。Agent 看 4 层以上的目录会迷路；人看 4 层以上也会懒得用。

2.3 必装插件

插件	用途
Templater	模板系统
Dataview	让笔记之间像数据库一样查询
Periodic Notes	周报 / 月报自动生成
Excalidraw	画架构图
Git	把 Vault 自动 commit + push
Tasks	待办系统
Claudian / Claude Code	直接在 Obsidian 里调用 Claude

三、Obsidian CLI —— 让命令行也能管知识库

Obsidian 官方在 2025 年推出 Obsidian CLI：你在终端能完成 GUI 里的几乎所有操作。这是把 Obsidian 升级为"基础设施"的关键一步。

3.1 安装

bash

# macOS
brew install obsidian-cli

# 或 npm
npm install -g obsidian-cli

3.2 常用命令

bash

# 在 Vault 里搜索
obsidian search "Agent"

# 创建一篇新笔记
obsidian new "今天读到的好工具" --folder=00-Inbox

# 移动 / 改名笔记
obsidian mv "00-Inbox/foo.md" "10-Notes/Agent 工具栈.md"

# 列出所有 daily notes
obsidian list 90-Daily

# 把某段标准输入快速捕获到 inbox
echo "Hermes 的 tmux+pty 模式必须开启" | obsidian capture

3.3 配合 Claude Code 用

这才是真正的"王炸组合"：

bash

# 让 Claude Code 直接读 vault 写报告
cd ~/qdy-vault
claude

# > 帮我把 30-References 里 2026 年 4 月之后所有关于 MCP 的文章总结到 10-Notes/MCP-2026-summary.md

它会：

用 Obsidian CLI（或文件系统 MCP）扫描 30-References
筛出 MCP 相关文章
生成总结
写入 10-Notes/

公司方法论：所有"读 → 总结 → 写笔记"的工作都交给 Agent，你只决定读什么、想要什么结论。

四、把 Obsidian 当 Agent 的长期记忆

4.1 做法

把 Vault 路径写进 CLAUDE.md / AGENTS.md：

markdown

# CLAUDE.md

## 我的知识库
- 路径：~/qdy-vault
- 重要：所有"我学过的东西"都在那里。需要参考时主动去读。
- 必读：~/qdy-vault/40-Skills/index.md（我写过的所有 Skills）
- 必读：~/qdy-vault/50-Snippets/prompt-library.md（我的 Prompt 库）

4.2 用 RAG 把 Vault 接成 MCP

社区已经有现成的 obsidian-rag MCP：

仓库：https://github.com/liaocaoxuezhe/obsidian-rag

挂上后：

bash

claude mcp add obsidian-rag -- python /path/to/obsidian-rag/server.py --vault ~/qdy-vault

之后在 Claude Code 里：

> 我以前在哪篇笔记里记过"AGI 与 Physical AI 的区别"？

会通过向量检索精准定位到具体笔记。

五、自动化录入（公司推荐 3 种）

5.1 浏览器剪藏 → Inbox

装 Chrome 插件：

Obsidian Web Clipper（官方）

读到好文章一键剪藏到 00-Inbox/，每周用 Claude Code 整理一次。

5.2 微信文章 → 自动转 markdown

社区方案：

把微信文章用"微信文件转存"或"feishu.cn ima 知识库"等转 markdown
或用第三方工具如 WeRead Sync 适配

5.3 终端速记 → Inbox

bash

# 在 ~/.zshrc / ~/.bashrc 里加一个 alias
alias jot='obsidian capture --folder=00-Inbox'

# 用法
jot "刚发现 Hermes 的 tmux 模式比 pty 稳定 10 倍"

六、整理节奏（公司经验）

节奏	动作
每天	Inbox 清零（让 Agent 帮你分类到对应目录）
每周	把本周笔记跑一次"自动总结"，生成 90-Daily/2026-W18.md
每月	把这个月新增的精华抽出来、改写成永久笔记（atomic notes）
每季度	复盘：哪些笔记从来没被引用过？砍掉。

七、参考资料

八、心法（必背）

不会沉淀的人，永远在重复劳动。
会沉淀的人，每解决一个问题就给未来的自己 + 团队 + Agent 加一份资产。

公司只考核一件事：你的 Vault + Skills + 项目模板，能不能在你不在的时候让别人接手？ 能 = 你创造了组织级杠杆。不能 = 你只是一个高级工人。

继续 → 05 · 工具体系搭建

04-03 · Obsidian + CLI 知识库 ​

一、为什么是 Obsidian ​

二、安装与基础配置 ​

2.1 安装 ​

2.2 创建 Vault ​

2.3 必装插件 ​

三、Obsidian CLI —— 让命令行也能管知识库 ​

3.1 安装 ​

3.2 常用命令 ​

3.3 配合 Claude Code 用 ​

四、把 Obsidian 当 Agent 的长期记忆 ​

4.1 做法 ​

4.2 用 RAG 把 Vault 接成 MCP ​

五、自动化录入（公司推荐 3 种） ​

5.1 浏览器剪藏 → Inbox ​

5.2 微信文章 → 自动转 markdown ​

5.3 终端速记 → Inbox ​

六、整理节奏（公司经验） ​

七、参考资料 ​

八、心法（必背） ​

04-03 · Obsidian + CLI 知识库

一、为什么是 Obsidian

二、安装与基础配置

2.1 安装

2.2 创建 Vault

2.3 必装插件

三、Obsidian CLI —— 让命令行也能管知识库

3.1 安装

3.2 常用命令

3.3 配合 Claude Code 用

四、把 Obsidian 当 Agent 的长期记忆

4.1 做法

4.2 用 RAG 把 Vault 接成 MCP

五、自动化录入（公司推荐 3 种）

5.1 浏览器剪藏 → Inbox

5.2 微信文章 → 自动转 markdown

5.3 终端速记 → Inbox

六、整理节奏（公司经验）

七、参考资料

八、心法（必背）