Obsidian 从空文件夹到 AI 大脑:先跑通最小闭环
承上启下:装完 Obsidian 却不知道点哪里,和打开一个巨型代码仓却找不到入口,是同一类卡点——工具在,契约不在。本篇先把空仓库的最小闭环跑通,再对照当前这个已经在干活的
21zhao-site目录。
极客解析:所谓 AI 大脑,不是再买一个会聊天的产品,也不是某一个 App 的别名。它是三件事叠在同一棵目录树上:人能打开的文件、文件之间的链接、能读这个根目录的 Agent。Obsidian 教的是空文件夹怎么开工;
21zhao-site已经按同一思路把主站、博客、NexDo、NexControl、项目管理工具放进一个 Vault。文件数量不等于知识:仓内zettel/那 1.7 万张是评分新闻进料,不是卡片盒。
痛点:别人晒成品图谱,你打开软件只看到一排按钮。截图和链接存了一堆,找不到入口,也写不出一篇能用的笔记。换到工程仓,症状变成:装了很多产品目录,Agent 每次都像第一次进门。
Obsidian 从空文件夹到 AI 大脑:先跑通最小闭环
你听过「用 Obsidian 做第二大脑」。打开软件,满屏按钮,第一步该点哪?资料存了,笔记没有。卡住的原因通常不是插件太少,而是没人告诉你:做完这一步,屏幕上应该出现什么。
这次从一个空文件夹开始。创建仓库、起名、选位置、建目录、写 Home、做 [[双向链接]]、开日记、看关系图谱,再把它交给 Codex 只读扫描。目标只有一个:让没用过 Obsidian 的人,独立搭出一套能开始工作的本地知识库。
跑通这条最短路径:
随手收集 → 放进 Inbox → 整理成笔记 → 建立链接 → 从 Home 再次找到 → 输出文章或方案
插件、自动化、PARA、卡片盒,等你真的重复做同一件事三次再加。
当前这个 21zhao-site 目录,已经是同一条路径的工程放大版。它不是「旁边还有一个 NexDo 知识库」,而是整仓按 Vault 在运转:
| 格子 | 路径 | 2026-08-18 当场核对 |
|---|---|---|
| Vault 根 | 21zhao-site/ |
Agent 打开的工作目录 |
| Agent Home | CLAUDE.md + AGENTS.md |
进门先读事实与做事方式 |
| 人用导览 | README.md + ARCHITECTURE.md |
域名、端口、产品入口 |
| 表达输出 | blog-src/content/posts/ |
1340 篇成稿 |
| 个人工作记忆 | ~/Documents/NexDo/zhaosj/ |
3570 篇人写的笔记(仓外 Vault,产品在仓内 todo/) |
| 图谱几何 | TOPOLOGY_VISUALIZATION.md |
博客首页与 NexDo 共用世界半径 1.5–6 |
| 不算知识 | zettel/ |
约 17365 张自动新闻卡,seed 17323 张,模板判断段 |
所以「AI 大脑」不是下一季度的规划。它是你能用访达打开、Agent 能从根目录读到的那一棵树。NexDo 只是其中一只抽屉。zettel/ 只是流水线 Inbox,张数再大也不进知识格。
为什么值得关注
市面上的「AI 大脑」多半把记忆锁进账号。换模型、换客户端,上下文就断。Obsidian 官方把 Vault 定义成本地文件系统里的一个文件夹;软件本体可免费使用,也不要求注册。Sync 和 Publish 是可选付费。
21zhao-site 走同一条本地优先线。笔记、代码、护栏文档、技能说明书都在磁盘上。Cursor / Codex / Claude 打开这个文件夹时,自动加载 CLAUDE.md 和 AGENTS.md——这就是 Home 被 Agent 读到的那一时刻。聊天窗口关掉,文件还在。
第二大脑成立的条件是:人能从 Home 点回去,模型能从同一路径读到原文。 只聊天、不落盘,那是会话,不是大脑。只把其中一个产品(比如 NexDo)叫大脑,而主站、远控、博客各过各的,那是多套互不相认的记忆。把 1.7 万张自动新闻卡叫卡片盒,数量会骗人。
先认 6 个词,再点按钮
仓库不是神秘数据库,就是一个文件夹。后面会反复碰到这 6 个词:
- Vault / 仓库:Obsidian 打开的那个根目录。在本项目里,就是
21zhao-site/。 - Markdown:带少量符号的纯文本。换软件也能用文本编辑器打开。
- Inbox / 收件箱:先接住内容的抽屉,不在这里做最终分类。
- Home:一篇普通笔记,作用像网站首页。可以叫「首页」或「开始这里」。
- 内部链接 / 反向链接:你在 A 里写
[[B]];B 的右侧自动出现「A 提到过我」。 - MOC:Map of Content,主题目录笔记。还是一篇普通
.md,正文主要放链接。
Home 不是 Obsidian 内置的特殊功能。它只是你给一篇笔记起的名字。给 Agent 看的那一份,在本仓叫 CLAUDE.md。
Obsidian 六个词,如何落到整仓
空仓库教程解决「第一次怎么点」。下面这张表解决「点完以后,工程仓该长成什么样」。对照物不是某一个产品,是当前目录里已经封板的结构。
| Obsidian | 在 21zhao-site 里已经长成什么 |
|---|---|
| Vault | 整个 Git 仓库。一个根目录,多只产品抽屉,禁止再复制出第二份「大脑文件夹」。 |
| 浅层目录 | todo/(NexDo)、remote-control/(NexControl)、pm-tracker/、blog-src/、api/、nextalk/、miniapp/、youcare/。数字前缀换成产品名,职责一样:回答文件现在放在哪。 |
| Inbox | scratch/、reports/、尚未整理的素材。zettel/ 也属于这一格:高分 RSS 压成单张 .md,等日清,不是整理后的知识。 |
| Home | 人读 README.md;Agent 读 CLAUDE.md。两份入口,同一棵树。 |
[[链接]] |
材料链 REQUIREMENTS.md → DESIGN.md → TEST_CASES.md → TESTING.md;产品文档互指;NexDo 正文里的 [[双链]]。改一处必须能走回来。 |
| 90-模板 | skills/ 与 .claude/skills/:材料维护、发布闭环、博主声纹、通宵托管。重复三次的动作才升成技能。 |
| 99-附件 | data/、日志、密钥。本地需要,默认不进 Git。 |
| 日记 | CHANGELOG.md + version.json:每天可发布的改动写成带版本号的条目,而不是「想法 1」。 |
| MOC | ARCHITECTURE.md(进程与域名)、AGENTS.md(做事方式)、remote-control/HANDOFF.md(远控现场)、TOPOLOGY_VISUALIZATION.md(图谱几何)。 |
| 关系图谱 | blog.21zhao.com 首页 Knowledge Graph,与 NexDo 任务图谱共用几何标准。点是文件/文章,线是已经存在的引用。 |
| 交给 Codex | 打开仓库根目录,不是只打开 todo/ 或某一篇笔记。第一次只读;写入锁到指定路径。 |
zettel/ 由 scripts/zettel_materials.py 从新闻库抽出:未发布、价值分 ≥ 75、建议去向 blog 或 digest。2026-08-18 扫过 17367 张正文,来源头名是澎湃、微博热搜、知乎;「我的判断」几乎同一句模板。这是进料,和知识没啥关系。.gitignore 已经把它当成数据资产,不进 Git。
NexDo 资料库放在 Documents/NexDo/zhaosj/,是仓外的个人 Vault,产品代码仍在仓内 todo/。这样拆,是为了 3570 篇私人笔记不进 Git;不是为了再造一套互不相认的大脑。Agent 改产品时读 todo/,整理个人笔记时打开那个用户目录,Home 规则同一套。
步步为营:从空文件夹到能工作的知识库
Step 1:创建本地仓库,不要点「打开」或登录
到 Obsidian 下载页 安装。macOS 把应用拖进「应用程序」;Windows 走安装向导。第一次只在电脑上跑通,手机同步放到最后。
打开后点「创建」本地仓库。不要点「打开本地仓库」(那是已有文件夹),也不要走远程同步。
- 仓库名称填一个半年后还看得懂的名字,例如
我的知识库。不要加日期和版本号。 - 位置选「文稿」或你长期使用的目录。不要放「下载」——清理电脑时容易一起删。
- 点「创建」。左下角出现你刚起的名字,访达里也能看到同名文件夹,这一步才算过。
创建过程不会扫描整台电脑,也不会自动上传旧文件。
你若已经在维护 21zhao-site,这一步的工程等价物早做完了:根目录就是 Vault。不要为「学 Obsidian」再复制一棵仓。
Step 2:先做浅层目录,数字只负责排序
文件夹回答「文件现在放在哪」,不负责理解内容。第一版保持浅层。自媒体工作流可以这样起手:
我的知识库/
├── 00-灵感收件箱/
├── 01-选题库/
├── 02-内容创作/
├── 03-素材库/
├── 04-渠道运营/
├── 05-数据复盘/
├── 06-商业合作/
├── 07-已发布/
├── 90-模板/
└── 99-附件/
刚冒出来的一句话进 00-灵感收件箱;补齐「写给谁、解决什么问题、怎么讲」再进 01-选题库;开工进 02-内容创作;发布完进 07-已发布。
对照本仓:刚冒出来的点子进 Inbox / scratch/;补齐需求进 REQUIREMENTS.md;开工进对应产品目录;发布完进 blog-src/ 或安装包。NexDo 个人库同样有 Inbox/、00-规范/、工作日志/、周报/。业务文件夹可以换,Inbox + 规范 + 附件 这三格不要省。
左侧点「新建文件夹」,一次只建一个,按 Enter。不要把整棵树粘进输入框。点错成笔记就删掉空文件再来。
Step 3:两条默认路线——新笔记进 Inbox,附件进 99
设置 → 文件与链接:
- 新建笔记的存放位置:指定文件夹 →
00-灵感收件箱 - 附件默认存放路径:指定文件夹 →
99-附件 - 打开「始终更新内部链接」:重命名笔记时,其他文件里的
[[链接]]跟着改
验收:Cmd/Ctrl + N 新建「测试灵感」,它应出现在收件箱;正文粘贴一张图,99-附件 里能看到文件。
工程仓对应关系:新想法先落可检索的 Markdown 或 Issue 式笔记,不要直接改热路径;大文件进 data/,密钥不进文档。AGENTS.md 写死「只 git add 具体文件,永远不用 git add -A」——这就是「始终更新内部链接」的 Git 版:改名、移动必须能对上归属。
Step 4:写一篇 Home,只放最近会点的入口
Cmd/Ctrl + N,标题 Home。它可能掉进收件箱,没关系——首页看的是内容,不是所在文件夹。
把下面模板贴进去,日期改成今天:
# 我的知识库
> 每次打开仓库,先从这里开始。
## 今天
- [[2026-08-18]]
## 正在推进
- [[Obsidian 知识库搭建]]
## 常用入口
- [[写作 MOC]]
## 本周行动
- [ ] 写 3 篇知识卡片
- [ ] 整理收件箱
商场比喻落到机制:左侧文件夹是楼层,Home 是一楼导览牌。导览牌只写「今天去哪、正在做什么、常用入口」。内容太多,首页会变成第二个需要翻找的仓库。
CLAUDE.md 的「技术事实速查」就是这种导览牌:端口、域名、版本真理源、禁止项。它不收纳全部代码。Home 只放最近会点的入口。
右上角书本图标切到阅读视图:# 和 [[ ]] 藏起来,文件还是这一份。Cmd/Ctrl + E 切回来。
Step 5:只手写正向链接,反向链接让软件记
在 Home 的「正在推进」下写:
- [[Obsidian 知识库搭建]]
输入 [[ 会弹出候选。按住 Cmd/Ctrl 点击浅色链接,Obsidian 会创建同名笔记。在新笔记里写目标、再链出你真正会去读的三篇。
打开右侧「反向链接」面板(命令面板搜「反向链接」)。你应看到 Home 指向当前笔记。从 Home 能点进来,从右侧能点回 Home——这就是双向:正向入口 + 自动记录来源。不必在两篇里各写一次。
三个写法,用到再查:
[[笔记名]]
[[笔记名|显示成另一段文字]]
[[笔记名#某个小标题]]
图谱变密不是目标。以后可能要从这篇找到那篇,才加一条。
工程仓里,正向链接是需求条目指向设计条目;反向链接是 CHANGELOG.md 写明改了哪、TESTING.md 写明怎么验。五文档护栏要求每次任务先核对这五份——缺一份,Agent 就会在无来路的文件上改。NexDo 则把同一机制做成正文 [[双链]] 和右侧反向引用。
Step 6:日记只问三个问题
设置 → 核心插件,确认「日记」开启。日记设置里:
- 日期格式:
YYYY-MM-DD - 存放位置:
05-数据复盘(或自建08-日记)
点日历图标,或命令面板「打开/创建今天的日记」。正文只放:
## 今天做了什么
- 建好第一个 Obsidian 仓库
- 完成 [[Obsidian 知识库搭建]]
## 今天学到了什么
- 输入 [[笔记名]] 可以创建内部链接
## 明天最重要的事
- [ ] 写一张知识卡片
返回:[[Home]]
价值来自连续,不来自字数。本仓的日记是带版本号的:version.json 每次可发布集合 +1,CHANGELOG.md 顶上写下「谁要什么、现场怎样、改了哪」。NexDo 的工作日志、周报文件夹做个人侧同一件事。
Step 7:图谱只检查连接,不当装修
点左侧关系图谱。圆点是笔记名,线是至少一条内部链接。笔记少、线稀疏是正常的。
只查两件事:
- 某个点完全没线:孤立笔记。要不要连到项目、日记或 Home。
- 同一主题很多点却没有入口:写一篇 MOC,把链接收进去。
# 写作 MOC
## 方法
- [[选题方法]]
- [[文章结构]]
## 正在写
- [[Obsidian 从空文件夹到 AI 大脑:先跑通最小闭环]]
第一周看一次图谱就够。不要每天拖节点调颜色。
博客首页和 NexDo 图谱在 1.0.1103 起共用 TOPOLOGY_VISUALIZATION.md:点小、线细、字带白描边,默认先看结构再展开标题。Obsidian 是可读性参照,不是要求所有布局涂成同一种灰。图谱检查的是「这篇博客能不能链回产品文档、这只产品抽屉有没有 HANDOFF」——不是圆点漂不漂亮。
AI 大脑:打开根目录,而不是另存一份记忆
Codex 不是 Obsidian 插件。它面对的是仓库根目录里的文件。ChatGPT 桌面端可以打开本地文件夹;Cursor 打开 21zhao-site 时,读到的就是这棵树:代码、护栏、blog-src/、skills/。zettel/ 也在根下,但只当进料,不要让模型把它当成知识库扫一遍。
第一次只允许读取:
请扫描当前仓库根目录,只读取,不修改任何文件。
请输出:
1. 顶层目录分别承担什么作用(产品抽屉 / 护栏文档 / 成稿 / 进料 Inbox);
2. 目前有哪些孤立文档:没有被 CLAUDE.md、ARCHITECTURE.md 或产品 README 引用;
3. 哪些主题已经足够多,可以新建或更新 MOC;
4. 给出建议,但不要执行修改。
确认后再给一个很小的写入范围,例如只新增一篇 MOC,只引用已有文件,先列出清单再创建。不要让模型一次改 remote-control/、todo/ 和博客洪水。AGENTS.md 的「修 A 不许动 B」就是这条权限边界的工程写法。
权限还要写进习惯:密码、密钥、身份证、财务账户、私人聊天不要放进普通知识库,也不要写进 CLAUDE.md。批量改名、移动、删除前先备份,并要求模型列出变更清单。本地存储不等于自动备份。data/ 和 cloudflared-backup/ 默认不推送。
当前这棵树可以看成四格,全部是文件:
- 护栏格:
CLAUDE.md、AGENTS.md、ARCHITECTURE.md、版本五件套。Agent 进门先读,防止每次从零编造规则。 - 产品格:
todo/、remote-control/、pm-tracker/、api/、nextalk/、miniapp/、youcare/。每只抽屉有自己的热路径和 HANDOFF,但仍挂在同一 Vault。 - 工作记忆格:仓外 NexDo 用户目录 3570 篇人写的任务与笔记。这才是个人侧的知识库存。
- 表达格:
blog-src/content/posts/1340 篇成稿,首页图谱从同一批 Markdown 抽节点;每日上限 ≤ 3 篇。
zettel/ 不进这四格。它是 RSS 进料落盘,模板判断、几乎全是 seed。张数统计不能当成知识存量。
聊天窗口只是临时工作台。关掉窗口,大脑还在磁盘上。把「AI 大脑」理解成 NexDo 一个产品,会漏掉远控五维标准、博客质量棘轮、项目管理材料链——那些同样是记忆,而且已经写成文件。
四个快捷键,文件一多就靠它们
| 快捷键 | 作用 |
|---|---|
Cmd/Ctrl + N |
新建笔记(应落入 Inbox) |
Cmd/Ctrl + O |
按标题打开,少翻左侧树 |
Cmd/Ctrl + P |
命令面板,搜「反向链接」「日记」 |
Cmd/Ctrl + E |
编辑 / 阅读视图 |
macOS 用 Cmd,Windows 用 Ctrl。标题写成「2026-08-18 产品会议结论」,不要用「想法 1」「未命名」。在工程仓里,等价物是 Cmd/Ctrl + P 搜文件、先打开 CLAUDE.md 而不是在十几个产品目录里闲逛。
第一周每天 10 分钟
白天进 Inbox。晚上三行日记,连上当天项目。周末 20 分钟清收件箱:删掉没用的,留下的改标题、移动、补链接。同主题到大约 5 篇,再写 MOC。原生功能让你重复三次同一件事,再找插件。不要第一天同时上 Calendar、Dataview、Tasks、Templater。
工程仓同一节奏:白天改一只抽屉;晚上把条目写进 CHANGELOG.md;材料链当天补上。重复三次的操作再写进 skills/。不要第一天给每只产品都上新框架。
常见卡点
不会 Markdown 也能用。实时预览会把符号渲染掉。先会标题、列表、待办和 [[链接]]。
文件夹管位置,标签管少量状态,链接管两条知识之间的具体关系。第一版以浅层文件夹和链接为主。
PARA 和卡片盒等你写满两周再借。没有真实内容时,方法论只会增加整理成本。本仓的 zettel/ 已经证明:自动堆张数,不会长成卡片盒。
图谱不好看,是因为笔记还少或链接没形成。10 秒内找到需要的笔记,比图谱密度重要。10 秒内找到 HANDOFF.md 或当天 CHANGELOG,比再画一张仓级力导向图重要。
21ZHAO 判断
「AI 大脑」这个词被用滥了。能核对的只有三件事:文件在不在本地、链接能不能走回来、模型改文件前有没有清单。
Obsidian 把第一课教成空 Vault。21zhao-site 把同一课做成整仓:护栏是 Home,产品目录是抽屉,博客是对外输出,NexDo 是个人工作记忆,Cursor / Codex 是读根目录的手。NexControl 的体验五维、博客的日上限与审稿分档表、材料维护的五件套——都是写在文件里的记忆,不是聊天里的口头禅。zettel/ 那 1.7 万张进料,不在这份记忆里。
装完不用吃灰。今天只做闭环:一篇 Home、一篇日记、一篇项目笔记,用 [[双向链接]] 连上,打开一次图谱。能从 Home 找到项目、从项目看到来源、从日记回到当天行动,这套库已经开始工作。模板和自动化只是让这条路更快,不能代替这条路。
已经有这个目录的人,不要再为「AI 大脑」新开一棵文件夹。打开根目录,更新 Home,把孤立文件链回去。
可复用建议
- 在「文稿」下建 Vault,名称不含日期;新笔记默认进 Inbox,图片进
99-附件。 - Home 只放「今天 / 正在推进 / 常用入口 / 本周行动」,超过一屏就往外挪。Agent Home(
CLAUDE.md)同样只放事实表和禁止项,不贴全部源码。 - 交给 Codex 的第一条提示词写死「只读取,不修改」;写入任务一次只动一只产品抽屉或一个指定路径。
- 已有
21zhao-site的,用 Obsidian「打开本地仓库」不要指向zettel/当知识库;个人任务走Documents/NexDo/zhaosj。不要复制出第二份大脑。 - 看图谱时只标记孤立点和缺 MOC 的主题,不调色。仓级孤立点优先补进
ARCHITECTURE.md或产品 README。
可延展观察
当同一根目录既给人类点、又给 Agent 读,冲突会出在哪一层:是 CLAUDE.md 过时,还是模型一次改了太多抽屉?你准备把「变更清单」写进 CHANGELOG.md,还是继续只留在聊天里?进料 Inbox 堆到 1.7 万张之后,日清规则要不要改成「不进知识格、到期就丢」?
💡 下一篇预告:给仓根写一份更薄的人用 Home,以及进料 Inbox 如何避免再被统计成知识存量。
参考资料
- Obsidian:Create a vault
- Obsidian:Internal links
- Obsidian:Attachments
- Obsidian:Pricing
- OpenAI Docs:ChatGPT desktop app 与 Codex 打开本地文件夹
- 本仓库
CLAUDE.md、AGENTS.md、ARCHITECTURE.md、TOPOLOGY_VISUALIZATION.md - 本仓库
scripts/zettel_materials.py(新闻进料落盘,不是知识库)
NexDo Time
打开访达里的 21zhao-site。先读 CLAUDE.md 前两节,把它当成 Agent Home。需要个人笔记时,打开 Documents/NexDo/zhaosj,补一条指向正在推进项目的 [[双链]]。不要打开 zettel/ 当知识库,也不要为「AI 大脑」新建第三套文件夹。
Don’t wait for next time, do it in the next moment.