Obsidian 保姆级教程: 从安装、配置到真正用起来,一篇讲透(万字长文,建议收藏)

知识管理 · AI 工具 · 保姆级教程

适合小白 · 一小时搭建 · 本地 Markdown 知识库

你可能见过这样的场景：收藏夹里躺着几百篇文章，微信里“文件传输助手”塞满资料，电脑上散落着 Word、PDF、截图和临时文档；真正要写文章、做方案时，却想不起“以前在哪里看过”。

很多人因此开始找“第二大脑”。Obsidian 往往是绕不开的名字。

但第一次打开 Obsidian，你很可能会失望：没有花哨的欢迎页，没有 AI 主动替你整理，甚至连“新建笔记本”都叫“创建仓库”。它更像一间空房，而不是已经装修好的样板间。

这恰恰是它的价值：房子是你的，东西也是你的。Obsidian 不要求你把知识交给某个平台，而是直接使用保存在电脑里的普通 Markdown 文件。你可以离线使用、自由备份、批量修改，也可以在未来换掉软件而保留内容。官方明确说明，Obsidian 使用本地、非专有的纯文本 Markdown 文件；应用本体可免费使用，无须注册。

这篇文章不追求把 Obsidian 配成“赛博驾驶舱”。我们的目标很朴素：让一个完全没有 Markdown 基础的人，从安装开始，在一小时内建立一个稳定、能用、不会轻易推倒重来的知识库。

图：全文分为五个部分，从认识和安装 Obsidian，一直到搭建知识系统、接入 AI 并形成可持续工作流。

第一部分｜先决定：Obsidian 是否适合你

一、先说人话：Obsidian 到底是什么？

Obsidian 是一款以本地 Markdown 文件为基础的知识管理和笔记软件。

这句话有三个关键词。

1. 本地

你的笔记默认存放在自己选定的电脑文件夹里，而不是必须存进某家公司的云端数据库。这个文件夹在 Obsidian 里叫 Vault，中文界面通常翻译成“仓库”。官方对 Vault 的定义就是“本地文件系统中用于存放笔记的文件夹”。

关闭 Obsidian 后，你仍然可以用资源管理器看到这些文件，用记事本、VS Code 或其他 Markdown 软件打开它们。

2. Markdown

Markdown 是一种很轻量的纯文本写作格式。你不必先学会编程，只需要记住少量符号：

在 Obsidian 的“实时预览”模式里，大部分符号会直接显示成排版后的效果。小白没有必要先背语法，边用边学即可。

3. 链接

普通笔记软件常用文件夹整理内容；Obsidian 除了文件夹，还强调笔记之间的链接。

例如你在《如何培养阅读习惯》里写：

双中括号里的文字会成为一个内部链接。点击它，就能打开《习惯系统》这篇笔记；如果文件还不存在，也可以顺手创建。Obsidian 还会记录哪些笔记链接到了当前笔记，也就是“反向链接”。官方支持 [[笔记名]] 的 Wikilink 和标准 Markdown 链接，并可在文件重命名后自动更新内部链接。

文件夹解决“这篇笔记放在哪里”，链接解决“它和哪些想法有关”。这就是 Obsidian 常被称为“网状笔记”或“第二大脑”的原因。

二、为什么要用 Obsidian？它适合谁？

Obsidian 不是“所有人都必须用”的软件。它特别适合以下需求：

1. 你希望数据真正归自己

平台会改版、涨价、停服，账号也可能出现异常；纯文本文件的生命周期通常更长。即使未来不再使用 Obsidian，你依然能读到原始笔记。

2. 你需要长期积累，而不是一次性记录

临时购物清单用手机备忘录更快；但读书笔记、研究资料、写作素材、课程笔记、项目复盘需要多年积累。Obsidian 的链接、属性、搜索和插件更适合这种长期内容。

3. 你想把“收藏”变成“输出”

一个能产生价值的知识流程应该是：

Obsidian 的重点不是帮你收藏更多，而是让资料可以被重新组合。写文章时，你可以把过去的观点、案例和引用链接到同一个主题，再从主题笔记生成大纲。

4. 你愿意承担一点点维护成本

自由的另一面是责任。你需要决定文件放在哪里、如何同步、如何备份，也要克制安装插件的冲动。如果你只想“打开就用、所有事情由平台代管”，云笔记或 ima 可能更轻松。

不太适合 Obsidian 的情况

工具应该服从问题，而不是反过来。没有必要因为别人展示了漂亮的知识图谱，就逼自己使用 Obsidian。

三、Obsidian 和 ima 有什么区别？

这里的 ima 指腾讯推出的 ima.copilot。它更强调 AI 搜索、阅读、写作与知识库问答。根据腾讯相关官方生态资料，ima 可以围绕个人或团队知识库进行问答、文档解读和内容生成，并强调回答来源引用；产品能力迭代较快，实际功能应以客户端为准。

最简单的理解是：

到底怎么选？

如果你的第一优先级是“文件长期归我、离线可用、结构自由、可以深度折腾”，选 Obsidian。

如果你的第一优先级是“我不想整理，先把资料丢进去，让 AI 帮我读、搜、问、写”，选 ima。

如果你既想长期保存，又想快速使用 AI，优选方式是 Obsidian 搭配 Claudian 插件（Claudian 是 Obsidian 里的一个插件，后文会讲，需要搭配 Claude Code 或 Codex 使用，或配置 API 使用）。

如果不想折腾配置，可以组合 Obsidian 加 ima 使用：

这套组合里，ima 像研究助理，Obsidian 像档案室和写作桌。

第二部分｜从零开始：完成安装、配置和第一次记录

四、安装 Obsidian：不要从第三方下载站下

打开 Obsidian 官方下载页面，根据自己的设备选择 Windows、macOS、Linux、iOS 或 Android 版本，按照页面提示完成安装即可。

不要从“绿色软件站”“汉化下载站”等第三方网站下载安装包，避免版本过旧、捆绑软件或文件被修改。第一次搭建知识库建议优先使用电脑端，安装完成后直接进入下一步创建仓库。

图：进入 Obsidian 官方网站后，点击系统对应的下载按钮；其他系统可选择“More platforms”。

五、第一次打开：创建你的第一个仓库

启动后通常会看到两个核心选项：

新手建议选择“创建新仓库”。

仓库应该放在哪里？

推荐路径：

或 macOS：

遵循三个原则：

仓库名字可以叫 MyVault、我的知识库 或 SecondBrain。名字没有技术影响，但不建议频繁改动仓库位置。

一个仓库还是多个仓库？

新手只建一个。

很多人会按“工作、生活、学习、写作”建四个仓库，结果跨领域内容无法链接，搜索也被割裂。除非存在严格的数据隔离需求，例如公司资料必须与个人资料分开，否则先用一个仓库，再用文件夹和链接分类。

图：第一次使用选择“新建仓库”；如果已经有 Obsidian 文件夹，则选择“打开本地仓库”。

六、先认识界面：你真正需要的只有五个区域

Obsidian 的界面可能因版本、主题和插件而变化，但基本逻辑不变：

常用操作：

命令面板是快捷入口。忘了某个按钮在哪里，不要在菜单里盲找，按 Ctrl/Cmd + P 后搜索动作名称。

七、必做基础配置：先稳定，再好看

进入“设置”，按下面顺序调整。菜单名称可能因版本翻译略有变化。

图：Obsidian 的常用选项、核心插件和第三方插件都可以从设置界面的左侧菜单进入。

1. 关于 → 语言

把语言切换为简体中文。如果你经常查英文教程，也可以保留英文，因为许多插件和命令的英文名称更容易搜索。

2. 外观

先使用默认主题。你可以设置浅色或深色、字体和界面缩放，但不要第一天就在主题和 CSS 上花三小时。

如果确实要换主题，只从 Obsidian 内置的主题市场安装，并检查更新时间和维护状态。主题越复杂，未来版本升级时越可能出现显示问题。

3. 快捷键

先只设三个：

遇到冲突时，Obsidian 会提示。不要一次设置几十个快捷键，否则记不住。

八、写第一篇真正有用的笔记

新建《Obsidian 学习记录》，粘贴下面内容并试着修改：

你刚刚同时使用了标题、属性、标签、任务和内部链接。

属性是什么？

笔记顶部 --- 之间的内容叫 YAML 属性，也可以直接通过界面添加。Obsidian 支持文本、列表、数字、复选框、日期、日期时间和标签等属性类型。

属性适合存放固定、可筛选的信息，例如：

属性不是越多越好。你每篇笔记都不愿填写的字段，就不该存在。

第三部分｜建立系统：让资料逐渐变成可复用知识

九、链接、标签和文件夹，到底怎么分工？

这是新手最容易混乱的地方。

文件夹：回答“它主要属于哪里”

一个文件通常只有一个主要位置。文件夹适合管理项目、归档和附件。

链接：回答“它和什么有关”

同一篇笔记可以关联许多概念。例如《如何养成阅读习惯》既能链接 [[阅读]]，也能链接 [[习惯系统]]、[[注意力]]。

常用写法：

前面的 ! 表示嵌入，而不是普通跳转。

标签：回答“我要临时筛选哪一批”

标签适合状态、类型或横向筛选：

不建议把所有主题都变成标签，更不要同时维护“文件夹人工智能、标签 #人工智能、笔记 [[人工智能]]”三套重复系统。

十、按照 Karpathy 的 LLM Wiki 思路搭建知识库

前面我们解决了文件夹、标签和链接如何分工。下一步要回答的是：资料越来越多以后，怎样让旧知识持续更新，而不是再次变成收藏夹？如果你希望以后让 Codex、WorkBuddy 或其他 AI 协助维护知识库，可以借鉴 Andrej Karpathy 提出的 LLM Wiki 思路。

传统的 AI 知识库通常采用 RAG：你上传一批资料，AI 在每次提问时重新检索相关片段，再临时拼出答案。它很适合快速问答，但每次都在重复阅读和组合，之前完成的综合判断不一定会积累下来。

LLM Wiki 的不同之处，是在原始资料和最终输出之间增加一层“持续维护的 Markdown Wiki”。每当新资料进入，AI 不只是把它存起来，而是与已有知识比较：更新主题页、补充来源、标出矛盾、修订阶段性结论。整理结果被保存为长期文件，下次可以继续使用。Karpathy 将其概括为三个核心层次：原始资料、由 LLM 维护的 Wiki，以及规定结构和工作方式的规则文件。

Karpathy 原文讲的是系统由哪三部分组成，并没有规定所有人必须使用哪套文件夹。为了让普通人真正用起来，我们可以在这个三部分架构之上，再建立一个更容易理解的“四层知识循环”：

AGENTS.md、索引、模板和处理日志不属于第五层，它们是维护整个循环的系统设施。

这不是要求 AI 取代你的判断。人仍然负责选择资料、提出问题和审核结论；AI 主要承担检索、比较、归档、补链接和维护索引等重复工作。

推荐的新手目录

结合 LLM Wiki 和普通人的使用习惯，可以先创建下面这套结构：

不要被编号吓到，它们只是让常用目录保持固定顺序。每一层解决的问题不同：

一篇小红书笔记刚导入时先留在 00-Inbox；确认值得长期保存后，原文进入 01-Evidence；它带来的新方法写进或更新 02-Knowledge；相关选题或实验进入 03-Action；最终写出的公众号文章进入 04-Output。

这套结构最重要的不是“把文件放整齐”，而是形成知识流动：

新手先手工跑通一次，不要第一天就让 AI 批量改造整个旧仓库。这套目录是新建仓库的参考方案，不是 Karpathy 规定的唯一答案。如果你已经有自己的分类，可以用索引、属性和双链把旧目录映射到四层功能，不需要整体搬迁。

不建议的结构

不要一开始建立几十层目录：

分类维度会变化，深层目录搬迁成本高。通常两层以内足够；跨主题关系交给链接和属性。

第四部分｜选择工具：官方功能、热门插件、采集入口与 AI

十一、认识 Obsidian 自带的核心功能

Obsidian 把许多自带功能称为“核心插件”。它们由官方随应用提供，不需要进入社区市场下载；大部分常用功能默认已经启用，少数功能可以在“设置 → 核心插件”中按需打开或关闭。下面不是要求你全部开启，而是帮助你看懂它们分别解决什么问题。

1. 每日笔记

每天自动创建一篇日期笔记，适合日志、工作记录和临时想法。建议设置：

2. 模板

把重复结构做成模板。先创建两个模板：

文章素材模板

会议记录模板

3. 反向链接与出链

反向链接告诉你“哪些笔记提到了当前笔记”；出链告诉你“当前笔记链接了谁”。这是发现知识关系的核心功能。

4. 大纲

长文写作时快速跳转各级标题。

5. 页面预览

按住 Ctrl（macOS 为 Cmd）悬停内部链接，可以预览目标笔记，不必离开当前页面。

6. 书签

把经常打开的笔记、搜索或标题固定起来。建议收藏“首页”“收件箱”和“当前项目”。

7. 文件恢复

用于在一定条件下恢复本地快照，但它不能代替正式备份。

8. Canvas

适合头脑风暴、研究路线和文章结构。官方将 Canvas 描述为可放置笔记、图片、PDF、视频、音频和网页的无限画布，并使用开放的 JSON Canvas 格式保存。

图谱视图可以开，但不要把“图谱很漂亮”误认为“知识管理有效”。能帮助你找到内容、做出输出，才算有效。

十二、热门社区插件：看需求选择，不必全部安装

Obsidian 的社区生态很丰富。下面这些插件长期出现在教程和用户推荐中，但“热门”不等于“人人必装”。社区插件可以运行第三方代码，官方明确提醒它们可能代表你执行操作，而且不会自动更新，需要手动检查版本。

建议先理解用途，再根据自己的问题选择。

1. Calendar

为每日笔记提供直观的月历入口，可以点击日期打开或创建当日笔记，也能看到哪些日期已经有记录。适合写日记、工作日志或学习日志的人；如果你完全不用每日笔记，就没有安装必要。

2. Dataview

把带有属性的 Markdown 笔记当成一个可查询的数据集合。它可以自动列出进行中的项目、待读书籍、某个主题下的资料或最近更新的笔记。

Dataview 很强，但有查询语法和属性设计成本。等你已经积累几十篇格式相对稳定的笔记再安装；不要为了使用它，反过来给每篇笔记塞十几个不会维护的字段。

3. Templater

比官方“模板”功能更强，可以插入动态日期、根据文件名生成内容、调用脚本，并为不同目录自动套用不同模板。适合模板规则已经比较成熟的人。新手先使用核心模板，确定真的需要动态逻辑后再安装。

4. Tasks

用于跨笔记管理 Markdown 待办，可识别截止日期、重复任务、优先级和查询条件。适合把行动记录分散在每日笔记、项目笔记中的人。如果正式任务已经统一放在飞书、Todoist 或系统提醒事项里，不要再维护一套内容重复的任务系统。

5. Excalidraw

把手绘白板能力带进 Obsidian，适合画流程图、概念图、课程结构和视觉笔记，也可以与普通笔记互相链接。它功能丰富、学习资料多，但绘图文件和图片可能增加仓库体积，移动端体验也需要自行测试。

6. Style Settings

用于调整支持该插件的主题和组件样式，例如标题大小、颜色、间距、侧栏或卡片效果。它只负责外观，不会改善笔记结构。喜欢折腾主题的人会觉得方便，追求稳定和少维护的人完全可以不装。

安装前问自己四个问题：

建议第一周最多从上面选择 0—3 个。先用一段时间，再判断插件到底减少了工作，还是增加了配置和维护。

图：进入“设置 → 第三方插件”，关闭安全模式后，点击“浏览”进入社区插件市场。第三方插件并非 Obsidian 官方核心功能，请根据需要安装。

十三、推荐安装的信息采集工具

前面的 Calendar、Dataview、Tasks 属于通用热门插件；下面这组则专门解决中文用户最常见的“资料怎么进入 Obsidian”。如果你会从网页、小红书、微信读书和微信收集内容，建议按自己的信息来源选择安装。

它们只是采集入口，不代表自动生成的内容已经成为可靠知识。推荐统一先进入 00-Inbox 或 01-Evidence，再进行筛选和消化。

1. Obsidian Web Clipper：保存普通网页

Obsidian Web Clipper 是官方提供的免费浏览器扩展，不是在 Obsidian 社区市场安装。它支持 Chrome 系、Firefox、Safari 和 Edge，可高亮网页、选择页面元素、套用剪藏模板，再保存到本地 Vault。官方说明扩展不收集使用指标，代码也已开源。

安装方法：

图：网页会自动识别当前浏览器。点击紫色按钮安装；使用其他浏览器时点击旁边的“More browsers”。

有些浏览器安装后可以在网页右键菜单中调用 Clipper，但入口取决于浏览器和扩展版本；最稳定的方式仍是固定扩展图标后点击使用。

图：打开要收藏的网页，点击浏览器中的 Web Clipper 图标，检查标题、来源和正文后，点击“Add to Obsidian”。

推荐模板：

2. Xiaohongshu Importer：导入小红书图文和媒体

在社区插件市场搜索 Xiaohongshu Importer。它支持粘贴小红书分享链接或分享文本，将标题、正文、图片、视频信息和标签转成 Markdown，还可以设置分类以及选择下载媒体到本地或保留远程链接。

图：进入社区插件市场搜索 xiaohongshu，找到 Xiaohongshu Importer 后安装并启用。注意核对插件名称，不要误装名称相近的插件。

推荐设置：

安装并启用后，可从左侧功能区打开导入窗口，粘贴分享链接并选择分类。插件入口可能随版本调整，以实际界面为准。

图：点击左侧的小红书导入按钮，粘贴分享链接或分享文本，选择分类，再点击“Import”保存。是否下载图片和视频可根据需要选择。

3. Weread：同步微信读书划线和想法

在社区插件市场搜索 Weread。它可以同步微信读书的书籍信息、高亮、笔记、书评等；当前插件还提供书架管理、阅读统计、自定义 FrontMatter 和定时同步。

图：在社区插件市场搜索 weread，选择作者为 zhaohongxuan 的 Weread，点击“安装”并启用。

安装并完成登录或认证后，点击 Obsidian 左侧的书本图标进入微信读书书架。这里可以查看已同步的书籍、划线和想法，也可以使用页面中的同步按钮更新内容。

图：Weread 的书架界面会展示已同步书籍、划线数量和阅读状态；点击书籍旁的同步图标可以更新对应笔记。

建议把原始划线和自己的读书笔记分开：

划线只是原料。一本书读完后，至少补充它解决的问题、三个关键观点、你不同意的地方、相关旧笔记和下一步行动。

插件可能使用 API Key、Cookie 或扫码认证。不要把 Cookie、密钥和登录信息写入会公开发布或交给不可信 AI 的笔记。

4. Biji Tongbu（笔记同步助手）：从微信和企业微信剪藏

笔记同步助手不是简单的“电脑手机文件同步”，而是一项基于微信公众号与企业微信的第三方内容剪藏服务。它的完整链路是：

官方产品页称其可以把图文、聊天内容、文件和视频链接整理后同步到 Obsidian 等笔记工具，其中部分 AI 整理和高级能力属于付费权益，具体功能与价格以公众号最新页面为准。

基本安装与使用流程：

图：在微信中找到并关注“笔记同步助手”，按照服务号提示添加对应助手并完成 Obsidian 端配置。

图：将内容发给微信侧助手后，服务号会推送处理结果或功能通知；收到完成提示后，再回到 Obsidian 拉取笔记。

注意：“笔记同步助手”服务号负责通知，真正接收你发送内容的是微信“Obsidian”好友；两者角色不同。由于内容会经过第三方服务和可选的云端 AI 处理，不要发送公司机密、私人聊天、证件、账号凭据或未经授权的文件。建议所有结果先进入 00-Inbox/微信收集，不要直接写进成熟 Wiki 页面。

四种工具怎么选

不需要为了“必装清单”把四个全部装上。只安装与你真实来源对应的工具，才不会把 Inbox 变成新的信息垃圾场。

十四、把 AI 接入 Obsidian：安装和配置 Claudian

第十六章会讲 AI 应该怎样维护知识库，本章先解决“从哪里使用 AI”。关系可以这样理解：

Codex 和 WorkBuddy 是同一级别的外部 AI 工作台：有些人习惯 Codex，有些人习惯 WorkBuddy，没有必要为了这套教程同时安装。Claudian 则是 Obsidian 内的使用入口，它可以连接 Codex、Claude Code 等受支持的代理。

1. Claudian 是什么，为什么先讲它

这里的 Claudian 指开源项目 YishenTu/claudian。它把 Claude Code、Codex、Grok、OpenCode、Pi 等代理接入 Obsidian 侧边栏，并把当前 Vault 作为工作目录。除了聊天，它还可以读取和写入文件、搜索仓库、调用命令、执行多步骤任务；项目还提供会话、@ 引用、斜杠命令或 Skill、计划模式、MCP 和带差异对比的行内编辑等能力。

它的优势是上下文近：正在阅读一篇笔记时，可以直接要求 AI 查找相关页面、解释某段内容、补双链或修改当前文档，不必频繁切换窗口。不过，Claudian 只是连接层，并不免费附送模型。你仍需安装至少一种受支持的命令行代理，并拥有对应订阅或 API 服务。

当前项目要求 Obsidian 1.7.2 或更高版本，并面向 Windows、macOS 和 Linux 桌面端；移动端不在支持范围内。版本与支持列表以后可能变化，安装前请以项目首页为准。

2. 从社区插件市场安装 Claudian

推荐使用普通用户最容易维护的方式：

项目也提供手动或源码安装方式，但新手不建议从源码编译。社区市场没有显示、版本不兼容或安装失败时，再查看项目 README 的最新方法，不要随意下载来路不明的压缩包。

图：搜索 Claudian 后核对插件名称与作者 Yishen Tu，点击“安装”；安装完成后还需要启用插件。

3. 已经有 Codex：直接让 Codex 帮你配置

如果你已经在使用 Codex，不需要自己研究命令行路径。先在 Codex 中打开 Obsidian Vault，然后告诉它为当前 Vault 配置 Claudian；当 Codex 请求电脑操作权限时，根据界面逐项确认即可。

把下面这段提示词发给 Codex：

Codex 能自动完成多少步骤，取决于当前客户端具备的电脑操作能力以及你授予的权限。如果它无法直接点击 Obsidian，仍可以检查本机环境、定位所需程序，并根据实际界面一步一步指导你。登录、订阅和密钥始终由你本人处理。

4. 已经有 Claude Code：让 Claude Code 帮你配置

如果你使用的是 Claude Code，也不必先理解 PATH 或可执行文件。打开 Vault 后发送：

如果 Codex 或 Claude Code 检查后发现本机缺少 Claudian 所需的命令行组件，让它根据官方说明继续引导即可。小白不需要预先分辨桌面应用、CLI 和安装路径。

5. 完成一次最简单的连接测试

配置完成后，在 Claudian 中打开一篇普通笔记，发送：

能正确读到当前笔记，就说明基础连接已经成功。然后再尝试查找相关笔记、提出修改建议和预览差异。第一次不要让它批量整理、移动或删除整个知识库。

6. 如果连接失败，再看这里

按下面顺序排查，通常比反复重装更有效：

只有自动检测失败时，才需要了解进阶问题：Windows 图形应用有时读取不到终端中的 PATH，因此终端能运行、Obsidian 却找不到代理。此时让 AI 根据你的实际安装方式定位可执行文件，不要照抄其他教程中的路径，也不要随意填写 .cmd 或 .ps1 文件。

不要为了让插件工作而关闭系统安全机制，也不要把密钥发到公开问题区。Claudian 项目说明称自身不收集遥测，但提示词、附件、图片和工具输出仍会发送给你选择的模型提供商；是否适合处理公司资料或私人内容，应结合服务商政策和你所在组织的规定判断。

7. Codex 和 WorkBuddy 到底怎么选

Codex 与 WorkBuddy 都可以从 Obsidian 外部读取和维护 Vault，选择自己已经习惯使用的一个即可：

Codex 与 WorkBuddy 在本文承担的是同一种角色：学习方法、理解仓库、执行规则和生成成果。它们的界面、授权方式与具体能力可能不同，但第十六章的知识维护逻辑可以共用。

Claudian 也不是必须安装。它解决的是“在 Obsidian 里面直接调用 AI”，而不是提供另一套知识管理方法。无论从哪个入口操作，都应遵守同一条底线：保留原始证据，敏感内容不交给模型，修改有记录，批量移动和删除由人确认。

第五部分｜让知识库真正运转起来

十五、四个真实使用场景

场景 1：读书笔记

不要逐章抄书。建议把原始划线保存在 01-Evidence，自己的理解写进 02-Knowledge：

摘录是作者的，理解才是你的。把“原文摘录”和“我的思考”分开，未来才能安全地让 AI 更新后者而不污染来源。

场景 2：公众号写作

每个选题记录读者问题、核心结论、证据、反对意见和行动建议。写作时，让 Codex 或 WorkBuddy 读取相关 Wiki、方法和历史复盘，再组合成结构，而不是面对空白页面凭空生成。

场景 3：工作项目

注意公司敏感数据的合规要求。未经允许，不要把公司资料放进个人仓库、第三方云端 AI 或社区插件。

场景 4：建立信息收集雷达

采集完成后先问三个问题：未来会不会被引用或再次加工？它提供了新信息还是重复旧内容？它应该更新已有页面还是新建页面？

例如连续收集三篇“公众号标题写法”，不要只留下三篇孤立摘要，而应更新一篇 [[公众号标题方法]]，写出共同结论、适用条件、反例和各自来源。原始资料保留不动，方法页随着新证据持续修订。

十六、让 AI 学习 Karpathy 的方法并维护知识库

第十章解决的是“知识应该怎样流动”，这一章解决的是“怎样让 AI 学会这套方法，再按统一规则长期维护”。二者不能混为一谈：四层目录是知识系统，Codex 或 WorkBuddy 是执行这套流程的 AI 助理，规则文件则相当于知识工作室的操作手册。

下面主要用 Codex 演示，因为它可以直接把 Vault 当成本地工作目录。习惯使用 WorkBuddy 的读者也可以采用同样的步骤和提示词：把 Vault 授权为工作目录，并让它先阅读维护规则即可。两者在这一章是同一级别的选择，不需要同时安装。

使用 Codex 时，建议把规则保存为 Vault 根目录的 AGENTS.md；使用 WorkBuddy 时，可以保存为 99-System/知识库维护规则.md，并在任务开始时明确要求它先阅读。如果你使用的 WorkBuddy 版本支持项目级规则，也可以按实际界面设置。

1. 先确定人和 AI 的分工

AI 适合承担重复但可检查的工作：读取新资料、补齐来源、查找重复内容、比较新旧观点、更新索引、生成摘要和修改日志。人应保留四项决定权：资料是否可信、观点是否成立、哪些内容值得长期保存，以及哪些成果可以对外发布。

最稳妥的协作顺序是：

不要第一次连接就要求“整理整个知识库”。如果目录中有工作文件、私人日记、客户资料或账号信息，先移出测试范围，或者明确禁止 AI 读取。

2. 第一步：让 AI 先学习 Karpathy 的 LLM Wiki

不要让 AI 凭印象设计知识库。先在 Codex 或 WorkBuddy 中打开 Obsidian Vault，再让它阅读 Karpathy 的原文。打开的应该是 Vault 根目录，不是某一篇 Markdown，也不是 Vault 的上一级文件夹。

如果 AI 无法访问链接，就把原文复制到对话或保存进 Vault，再将第一句改为“请阅读我提供的文章”。学习结束后，先检查它有没有区分作者原意与自己的推断。

3. 第二步：让 AI 理解你的现有仓库

接下来让 AI 只读检查 Vault，判断现有结构怎样与 LLM Wiki 方法对应，而不是立刻套用别人的目录：

4. 第三步：结合方法和仓库生成维护规则

只有完成“学习方法”和“理解仓库”以后，才让 AI 起草规则：

完整顺序应该是：学习方法 → 理解仓库 → 适配方法 → 生成规则。这能避免 AI 凭空发明一套看似完整、实际不适合你的分类系统。

5. 一份资料进入知识库时，AI 应该做什么

以 00-Inbox 中的一篇网页剪藏为例，合格的处理不是“再生成一篇摘要”，而是完成一条可追溯的流水线：

可以这样要求 AI：

判断 AI 是否处理得好，可以看三个结果：原文还能追溯；认知页变得更准确而不是更多；处理结束后，你知道它改了什么。

6. 把维护分成“每日轻整理”和“每周蒸馏”

每日任务应轻量，只处理新增内容：检查 Inbox、补元数据、识别重复、把低价值内容留在日志里。每周任务才适合跨笔记比较：更新主题页、合并重复概念、列出过时判断、把知识连接到项目和选题。

每日提示词示例：

每周提示词示例：

如果当前 Codex 客户端提供自动化任务，可以在界面中创建定时执行，让它按 AGENTS.md 做“检查和报告”。WorkBuddy 用户可以查看自己当前版本是否提供相应的定时或自动执行能力；没有也不影响使用，每周手动发送一次提示词即可。功能和账号条件可能调整，应以当时的客户端界面和官方说明为准。

7. 重复三次以上的流程，再沉淀成 Skill

Skill 可以理解为“交给 AI 执行的标准作业流程”。目录规则回答“这个仓库怎样维护”，Skill 回答“某一类具体任务怎样做好”，例如读书笔记消化、竞品分析、周报、公众号写作或选题筛选。

当同一流程连续做过至少三次，并且步骤和质量标准已经稳定，可以让 Codex 帮你起草 Skill。WorkBuddy 用户也可以把相同方法保存为长期规则或可复用提示词；具体名称和保存方式以当前产品功能为准。

不要把“我做过一次”立刻封装成 Skill。过早固化会把偶然做法变成长期偏差；先实际使用，再沉淀方法。

8. 基于知识库输出，并让成果重新回流

AI 的价值不是把 Inbox 清空，而是帮助你完成真实成果。写文章时，不要只给一个题目让它凭空生成，而要限制资料范围、要求引用路径，并区分事实与推断：

输出之后，把读者反馈、发布数据、失败原因或新案例重新放入证据层，再更新认知和方法。这才构成完整循环：输出不是知识库的终点，而是下一轮证据的来源。

9. 怎样避免 AI 生成一堆垃圾笔记

请长期坚持以下边界：

一个简单的质量门槛是：这条内容未来是否可能被引用、比较、执行或用于决策？如果四项都不是，就让它留在处理日志，或者直接不进入长期知识层。

十七、建立一个最小可持续工作流

复杂系统很容易放弃。新手只需要四步。

第一步：随手记进 Inbox

想到什么先记，不分类。标题可以不完美，但至少让未来的自己看得懂。

第二步：每天处理 5 分钟

打开 00-Inbox，对每条内容做一个决定：

第三步：围绕项目输出

不要从“我要建一个完美知识体系”开始，而从真实项目开始。例如“写一篇 Obsidian 教程”：

第四步：每周回顾

每周固定 20 分钟：

知识库不是只进不出的仓库，而是一座需要定期整理的花园。

十八、常见误区与排错

误区 1：先看一百个插件视频，再开始记笔记

正确顺序是：先使用核心功能，遇到重复问题，再找插件解决。

误区 2：把图谱当成果

大量链接可以生成漂亮图谱，但如果链接没有语义、内容没有消化，图谱只是一张装饰图。

误区 3：每天改文件夹和标签体系

先连续使用两周再改。结构应从真实内容中长出来，而不是从模板博主的截图里复制。

误区 4：把所有原始资料都放进去

知识库不是硬盘回收站。重要、可搜索、未来可能复用的内容才值得进入；超大视频和可重新下载的安装包没有必要放在 Vault。

打不开仓库或插件导致异常

可按顺序排查：

图片不显示

检查附件是否仍在仓库内、文件名是否改变、链接是否更新，以及图片是否只是云端占位。路径中避免使用系统禁止字符。

链接重命名后失效

确认“设置 → 文件与链接 → 自动更新内部链接”已开启。重命名尽量在 Obsidian 内完成。

十九、7 天入门计划

第 1 天：安装与建库

创建一个仓库和上文推荐的文件夹，不装社区插件。

第 2 天：写 3 篇笔记

学会标题、列表、任务、加粗和引用。

第 3 天：建立链接

让 3 篇笔记互相连接，打开反向链接查看关系。

第 4 天：模板与每日笔记

做一个简单模板，记录一天的工作或学习。

第 5 天：剪藏与消化

用 Web Clipper 保存一篇文章，并写 100 字自己的摘要。

第 6 天：用 AI 处理一份资料

在 Claudian 中连接已有代理，或在外部 Codex、WorkBuddy 中打开正确的 Vault。让 AI 先阅读维护规则，只读分析一份普通资料并给出修改计划；确认无误后再允许它修改这一份笔记，检查它是否保留来源、避免重复内容并记录修改。

第 7 天：做一个真实输出

用已有笔记写一篇短文、一次复盘或一个项目方案。只有输出，才能检验系统是否有用。

七天后再决定要不要装 Calendar、Dataview、Tasks 等插件。

二十、给小白的一套最终推荐配置

如果你不想逐项研究，直接照抄这套最小配置：

你不需要先掌握双链、卡片盒、PARA、MOC、Dataview 和复杂自动化的全部理论。先稳定记录，建立链接，完成一次输出，再让系统随着需求生长。

结语：不要搭建第二大脑，先留下第一条真正属于你的思考

Obsidian 的强大，不在于插件数量，也不在于图谱上有多少圆点。它真正迷人的地方，是把内容保存在你能掌控的文件里，并允许一条想法在多年后与另一条想法重新相遇。

ima 这样的 AI 知识工具，让“读得更快、问得更深、写得更快”成为可能；Obsidian 则更擅长让经过判断后的知识留下来。前者提升处理速度，后者保护长期积累。你可以选择其中一个，也可以让它们各司其职。

现在就做一件事：新建一篇《我的知识管理原则》，写下三句话——我为什么记笔记、什么内容值得保存、我希望这些笔记最终帮助我完成什么。

往期精彩

保姆级教程｜我用 WorkBuddy 从0到1跑通了500条小红书笔记（全流程拆解）

如何用workbuddy生成各类数据图表

如何用workbuddy做上半年经营分析

WorkBuddy 这 20 个用法，我后悔没早点知道

用完 WorkBuddy 这17个案例   你的同事以为你偷偷招了助理

运营/HR/内容人看过来：用WorkBuddy+ima搭私有知识库，你的所有资料AI都能读懂了

— END —

本文约 15000 字 · 预计阅读 30 分钟

关注我，一起迎接AI时代的到来分享AI实用技巧，记录副业变现心得AI工具｜职场赋能｜副业变现｜个人成长期待与你一起拥抱AI用AI开启未来，用行动定义可能！