2026-09-07 Obsidian 引入决策与安装

背景与目标

本人问 Windows 本地最好的 MD 阅读编辑软件。话题背后是真需求:thinking 项目的 notes/ideas/gongwen/docs 已积累几百个 MD 文件且每周增长,缺一个"在库里逛"的工具——VS Code 是"打开已知文件",印象笔记管移动端,IMA 管 AI 检索,本地大规模浏览和发现的位子一直空着。

过程回顾

尝试 1:工具横向对比(结果:给出分场景建议,而非单一答案)

按用途切分:写稿导出用 Typora、知识库管理用 Obsidian、免费平替 MarkText、代码仓库内文档 VS Code 就地编辑。结论"只装一个就装 Obsidian"。

尝试 2:本人追问"我们知识库有使用 Obsidian 的必要吗"(结果:先定架构位再谈装不装)

本人原话:"对,我早就想过这个"——想过但没装,说明顾虑不在软件本身,在"它和现有体系什么关系"。军师实测了 kb.toml 和 notes/ 结构后给出定位结论:

本地 MD → kb sync → 印象笔记(移动端)+ IMA(AI 检索)   # 数据流已闭环

Obsidian 插不进数据流也不该插——进来干同步/归档就是第二个事实源。唯一定位:本地阅读/检索前端,只读为主。

尝试 3:安装与预配置(结果:一次完成,零返工)

本人原话:"你帮我安装,并告诉怎么用"。winget 装 Obsidian 1.13.7,预置 .obsidian/app.json(useMarkdownLinks: true 禁 wikilink 语法污染同步链、frontmatter 可见、附件统一落 output/assets/),.obsidian/ 入 .gitignore,启动并交付用法说明(6 快捷键 + 3 场景 + 3 纪律)。

关键决策

• 先定位后安装:工具采纳的标准动作——"它在架构里站哪个位子"答不出来就不装;
• 三条纪律防污染:只读为主、禁 wikilink 语法、不装社区插件(插件会自动改写文件,和 kb 同步链冲突);
• 止损线前置:用一周,图谱和搜索确实翻到以前找不到的东西再谈深化,用不起来就卸载,零成本。

做得好的地方

• 没有被"最好的软件是什么"带偏成软件评测,直接落到"我们的知识库缺什么";
• 本人决策链完整:想要 → 问必要性 → 拿架构定位 → 授权安装,没有工具 FOMO;
• 配置即纪律:防污染规则不靠口头约定,直接写进 app.json 的 useMarkdownLinks 开关,机器强制执行。

复盘与改进

• 收尾时发现 .obsidian/app.json 属新增配置文件,按配置治理三件套必须登记——已补登 config-registry.md(P2,总数 119);教训:新建任何配置文件的收尾动作里,"登记"要成为肌肉记忆,不靠复盘想起;
• Obsidian 图谱能否在月度复盘真正用上(找孤儿笔记、看想法关联),一周后验证,届时回填本文。

个人成长评估

AI 自评失分点:安装后验证路径的 ls 命令写成一个复合命令,非零退出码 2(无实际影响但粗糙);首次启动 vault 需本人手点一次"打开文件夹",可以用 obsidian:// URI 预注册省掉这一步,没做。

改进一条:工具类安装交付标准里补一条——"首次启动障碍清零"(能预注册的预注册,能预配置的预配置),不让本人装完还要动手。

素材点

• "工具采纳的标准动作:先定位后安装——它在架构里站哪个位子答不出来就不装"
• "VS Code 是打开已知文件的工具,Obsidian 是在库里逛的工具"
• "防污染不靠口头约定:禁 wikilink 直接写进配置开关,机器强制执行"