Appearance
装修老板的 AI 第二大脑：Claude Code + Obsidian 实战（前端向）
麦序子 maixuzi.cn｜掘金技术文｜2026 年 6 月
一句话价值
5 年的客户档案、报价记录、施工经验，怎么从散落在 5 个微信号 + Excel + 微信收藏夹的"数据坟墓"，变成可问答、可复用的 AI 第二大脑？
GitHub 上有个 7200+ Stars 的开源项目 claude-obsidian 干这事。本文从掘金前端向视角拆解它的优雅设计。
为什么是 claude-obsidian
2026 年 4 月 Karpathy 贴了一条 gist，叫 LLM Wiki：
理想的知识库，应该让 LLM 自己来读、自己来链接、自己来维护。
这个理念催生了 claude-obsidian（AgriciDaniel/claude-obsidian，7200+ Stars）。它的设计哲学对前端开发者特别有启发：
1. 双向链接 = Markdown 的灵魂
Obsidian 早就支持 [[实体名]] 双向链接，但 99% 的人手动维护。claude-obsidian 让 Claude 自动建——AI 读完 .raw/ 里的资料，自动识别实体，自动插 [[]]。
前端类比：就像 React 自动追踪组件依赖，省掉手动 import。
2. 实体页 / 概念页 / 来源页 = 三层架构
text
entities/ 实体（人物、机构、项目）= 数据
concepts/ 概念（理论、模式、方法）= 业务
sources/ 来源（原始材料） = 事件类比前端三层架构：数据层、业务层、事件溯源。
3. 健康检查 = Linter
lint一下 命令 = 你的 wiki 自带 ESLint。孤儿笔记、死链、过期声明、缺失引用全列出来。
前端类比：跟 npm run lint 一个味道。
4. 会话记忆 = Hot Reload
hot.md 持续更新 = 你的 AI 有状态记忆，下次开局不用交代背景。
前端类比：HMR (Hot Module Replacement)，状态不丢。
30 分钟搭建实战
bash
git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh
# 启动 Claude Code
cd ~/Documents/claude-obsidian
claude
# 在 Claude Code 里输入
/wiki装修老板 5 个核心动作
1. 丢资料
把微信聊天记录、PDF 报价单、户型图丢到 .raw/，跟 Claude 说"吸收一下这些知识"。
2. 问问题
"半包 120 平的报价，过去 3 年是怎么浮动的？" → AI 按 hot.md → index.md → 具体页面读，给你带出处的答案。
3. 健康检查
lint一下 → 孤儿笔记、死链、过期信息全列出来。
4. 可视化
/canvas → 打开可视化画布，把客户画像、户型图、报价单摆上去。
5. 跨项目复用
在任何 Claude Code 项目的 CLAUDE.md 里加一段引导，共享同一份知识。
自研备份方案：hermes-memory.py
我们做 maixuzi.cn 这个站，自己也跑了一套类似方案：
- 200+ Markdown SOP 文档
- 跑了一个
hermes-memory.py（零依赖 Python，倒排索引，30 分钟手写） - 3 秒从 200+ SOP 里抽中正确答案
跟 claude-obsidian 互为备份：
- claude-obsidian 适合：装修老板个人用
- hermes-memory.py 适合：网站/团队协作
为什么这事对装修老板尤其重要
- 经验密集型：哪个品牌 PPR 容易爆、哪个小区物业不让周末施工 = 5 年经验 = 你的护城河
- 人员流动大：设计师离职 = 客户跟着走 = 公司最大隐性损失
- 零订阅：完全本地 plain Markdown，不需要为知识库付年费
参考
- 项目地址：https://github.com/AgriciDaniel/claude-obsidian
- Karpathy gist：https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
- maixuzi.cn：https://maixuzi.cn
更多内容：https://maixuzi.cn 主理人微信：maixuzicn