文章

Obsidian 从空文件夹到 AI 大脑:先跑通最小闭环

#1331 · 2026-08-18 · 21ZHAO Blog
Reading Path / ARTICLE 先抓主张,再转成行动 #1331 · 21ZHAO Blog · 读完进入产品或下一篇

承上启下:装完 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.mdAGENTS.md——这就是 Home 被 Agent 读到的那一时刻。聊天窗口关掉,文件还在。

第二大脑成立的条件是:人能从 Home 点回去,模型能从同一路径读到原文。 只聊天、不落盘,那是会话,不是大脑。只把其中一个产品(比如 NexDo)叫大脑,而主站、远控、博客各过各的,那是多套互不相认的记忆。把 1.7 万张自动新闻卡叫卡片盒,数量会骗人。

先认 6 个词,再点按钮

仓库不是神秘数据库,就是一个文件夹。后面会反复碰到这 6 个词:

  1. Vault / 仓库:Obsidian 打开的那个根目录。在本项目里,就是 21zhao-site/
  2. Markdown:带少量符号的纯文本。换软件也能用文本编辑器打开。
  3. Inbox / 收件箱:先接住内容的抽屉,不在这里做最终分类。
  4. Home:一篇普通笔记,作用像网站首页。可以叫「首页」或「开始这里」。
  5. 内部链接 / 反向链接:你在 A 里写 [[B]];B 的右侧自动出现「A 提到过我」。
  6. 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.mdDESIGN.mdTEST_CASES.mdTESTING.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、建议去向 blogdigest。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 每次可发布集合 +1CHANGELOG.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/ 默认不推送。

当前这棵树可以看成四格,全部是文件

  1. 护栏格CLAUDE.mdAGENTS.mdARCHITECTURE.md、版本五件套。Agent 进门先读,防止每次从零编造规则。
  2. 产品格todo/remote-control/pm-tracker/api/nextalk/miniapp/youcare/。每只抽屉有自己的热路径和 HANDOFF,但仍挂在同一 Vault。
  3. 工作记忆格:仓外 NexDo 用户目录 3570 篇人写的任务与笔记。这才是个人侧的知识库存。
  4. 表达格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 如何避免再被统计成知识存量。

参考资料

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.