Obsidian 零基础精细颗粒完全指南 v6.0 · 教学闭环增强版

📋 目录 · v6.0 教学闭环增强版

S0v6.0 教学闭环：体验课、7天训练、30天进阶新增 S130分钟体验课：先让小白第一次成功新增 S2练习素材包：示例 Vault、任务卡、模板、标准答案新增 S3每章标准答案与完成样例新增 S4教师/机构授课节奏：怎么讲、怎么练、怎么验收新增 S5教学方法论与官方资料来源新增 R本版修正说明：先把容易误导新手的地方讲清楚 V视频陪跑入口：看不懂时先看哪个视频、怎么看完立刻实操新增 00学习前准备清单：先判断需要学到哪里新增 01新手学习路线图：7天先用起来，30天再变强新增 02工具边界图：Obsidian、浏览器、Claude Code、Codex 各做什么新增 03Obsidian 是什么？ 04下载与安装（修正版） 05创建你的第一个知识库（Vault） 06界面每个区域详细说明 07创建并编辑第一篇笔记 08Markdown 语法实操手册 09双向链接与关系图谱操作 10核心插件逐一精细配置 11社区插件安装全流程（安全修正版） 12Templater 从安装到用起来 13日记系统从零完整搭建 14Dataview 使用全程详解 15笔记组织实战操作 16三个真实场景：学生、职场、读书如何落地新增 17快捷键完整速查（含自定义方法） 18同步与备份方案（重写修正版） 19浏览器插件安装与整理：把浏览器变成资料入口 20Obsidian Web Clipper：把网页采集变成可整理的知识 21终端基础课：使用 Claude Code / 本地 Codex 前必须会的 5 个动作新增 22Obsidian × Claude Code：本地项目目录协同方案 23ACodex 桌面图形界面：项目工作区流程重点 23BObsidian × Codex CLI：备用/进阶终端工作流 24Obsidian URI：从浏览器、项目文档和 AI 报告跳回笔记 25AI-Handoff 交接区：让 AI 协同安全、可控、可复盘 26新手学习路线图：不要一次学完，按目标走 27每章完成验收卡：学完不是看完，而是能做出来 28如何连接其他教程内容：把 Obsidian 做成你的 AI 学习总控台 29新手常见误解纠正：把容易走偏的地方提前拦住新增 30故障排查完整手册

🏗️

V6.0 教学闭环架构

v6.0 教学闭环：把完整教材拆成可完成的训练路径

本版解决的核心问题：内容很全，但小白容易不知道先做什么。v6.0 将指南拆成“30分钟体验课、7天入门训练、30天进阶任务、长期维护机制”。

第一阶段

30分钟体验课

只完成一次最小成功：安装 Obsidian、创建知识库、写第一篇笔记、做一个双链。目标是让学习者当天有成就感。

第二阶段

7天入门训练

每天只做一个主题：Markdown、双链、日记、模板、网页采集、整理、复盘。目标是养成基本使用习惯。

第三阶段

30天进阶任务

再进入 Web Clipper、Templater、Dataview、Claude Code、Codex、AI-Handoff。目标是搭建个人知识库和 AI 协同工作流。

看目标先知道本章解决什么问题

照着做只做本章规定的最小动作

看结果对照标准答案和完成样例

查失败失败先查本章回退路径

再进阶通过验收后再进入下一章

⚠️

新手使用规则：第一次学习不要从 Claude Code、Codex、DataviewJS 开始。先完成 30 分钟体验课，再进入 7 天训练。高级 AI 工具属于 30 天进阶内容。

🚀

30分钟首次成功

30分钟体验课：先让新手第一次成功

这一节不追求完整，只追求“当场做成”。适合公开课、体验课、线下培训开场，也适合完全小白自学。

体验课目标

安装并打开 Obsidian。
创建一个名为 MyKnowledge 的知识库。
创建第一篇笔记：我的第一篇 Obsidian 笔记。
创建第二篇笔记：Obsidian 学习计划。
在第一篇笔记中输入 [[Obsidian 学习计划]]，完成第一次双链。

创建第一篇笔记

在左侧文件区点击“新建笔记”，命名为 我的第一篇 Obsidian 笔记。输入下面内容：

体验课示例内容

# 我的第一篇 Obsidian 笔记

今天我完成了三件事：

- 我打开了 Obsidian
- 我创建了自己的知识库
- 我开始学习如何整理知识

下一步我要学习：[[Obsidian 学习计划]]

✅

成功标准：这篇笔记有标题、有列表、有一个蓝色可点击的双链。

创建第二篇笔记并返回

点击蓝色的 Obsidian 学习计划，如果提示创建新文件，就确认创建。输入：

第二篇笔记示例内容

# Obsidian 学习计划

## 第1周
- [ ] 学会 Markdown
- [ ] 学会双链
- [ ] 学会日记
- [ ] 学会整理 Inbox

关联笔记：[[我的第一篇 Obsidian 笔记]]

✅

成功标准：两篇笔记可以互相点击跳转。打开关系图谱时，能看到两个节点之间有连线。

✅ 30分钟体验课验收

□

已成功创建知识库。

□

已创建 2 篇笔记。

□

至少有 1 个双链可以点击跳转。

□

知道“看懂教程”不等于“完成练习”。

📦

练习素材包

练习素材包：让每章都有可复制、可完成、可验收的材料

为降低小白学习门槛，本指南配套提供示例 Vault。学习者可以直接打开示例文件，对照练习，不必从空白开始。

文件夹	用途	学习者怎么用
`00-Inbox`	临时笔记区	先把所有新笔记放这里，每周整理一次。
`01-Projects`	项目任务区	放 Claude Code / Codex 任务卡、验收清单、修改记录。
`03-Resources`	资料与读书笔记	放网页采集、读书笔记、课程资料。
`05-Templates`	模板库	复制日记模板、读书模板、视频学习模板、Codex 任务卡模板。
`06-Daily`	日记区	每天一篇，用来记录学习过程和复盘。
`90-Answers`	标准答案区	练习做完后再看，不要先看答案。

💡

使用方法：下载资料包后，解压到电脑中的一个普通文件夹。打开 Obsidian，选择“以文件夹作为知识库打开”，选择解压后的文件夹即可。

⚠️

不要直接修改唯一原件：第一次练习前先复制一份资料包副本。做错了可以重新复制，避免学习过程产生心理压力。

🧪

标准答案

每章标准答案与完成样例：新手要知道“做对了长什么样”

没有标准答案，小白很容易怀疑自己是否做对。v6.0 将关键章节改成“练习题 + 完成样例 + 自检标准”。

Markdown 练习完成样例

一篇合格的基础笔记应包含：一级标题、二级标题、无序列表、待办任务、至少一个加粗重点。暂时不要求表格、脚注、复杂代码块。

能看出层级结构。
重点词被加粗。
任务项可以勾选。

双链练习完成样例

至少有 3 篇笔记互相连接，例如：学习计划、日记、读书笔记。关系图谱中能看到节点与连线即可，不追求图谱漂亮。

双链可以点击跳转。
反向链接能看到来源。
图谱不是空白。

Web Clipper 练习完成样例

采集一篇网页后，不只保存全文，还要补上“一句话摘要、我的理解、后续行动”。否则只是收藏，不是知识整理。

有原网页链接。
有一句话摘要。
有自己的行动项。

Codex / Claude Code 练习完成样例

AI 工具第一次练习只允许修改项目副本中的一个小文件，例如一个 HTML 标题。必须先列计划，确认后再执行。

任务卡清楚。
只修改指定文件。
有修改记录和人工验收。

👩‍🏫

教师授课节奏

教师/机构授课节奏：怎么讲、怎么练、怎么验收

如果本指南用于大众课、线下课或企业培训，建议按“演示 20% + 练习 60% + 验收 20%”组织。

课时	老师讲什么	学员练什么	验收方式
第1课 30分钟体验	Obsidian 是什么；创建知识库；第一篇笔记；双链。	复制体验课内容，创建两篇笔记并互相链接。	查看两篇笔记是否能互相跳转。
第2课基础格式	Markdown 只讲 5 个常用语法。	整理一篇学习笔记：标题、列表、加粗、待办、引用。	对照 Markdown 标准答案。
第3课整理系统	Inbox、Resources、Daily、Templates 的区别。	把 5 篇乱笔记整理到不同文件夹。	Inbox 是否减少；命名是否清楚。
第4课网页采集	Web Clipper 的安装、采集、整理。	采集一篇文章，写一句话摘要和后续行动。	不是只保存网页全文，而是有理解和行动。
第5课 AI 协同入门	AI-Handoff、安全边界、项目副本。	写一张 Codex 或 Claude Code 任务卡，不直接交出完整 Vault。	任务卡是否包含目标、范围、禁止事项、验收标准。

🎯

授课原则新手课程不要追求“讲完所有功能”，而要追求“每节课都有一个可展示成果”。学员看到成果，才会继续学习。

📚

方法论与资料来源

教学方法论与资料来源：为什么本指南要这样设计

本指南不是把功能简单堆在一起，而是采用“分段学习、先做后讲、示例引导、检索复习、低风险练习”的教学结构。

🧠 学习设计原则

分段原则：复杂内容拆成可控小块，避免一次输入过多信息。
通用学习设计：同一知识点提供文字、视频、练习、模板多种入口。
检索与间隔：通过日记复盘、每章验收卡、7天路线，让学习者反复提取和应用。
示例先行：先给完成样例，再要求学习者仿做，降低空白页恐惧。

🔗 官方资料边界

Obsidian 官方帮助用于确认核心插件、URI、Web Clipper 等基础功能。
Claude Code 官方文档用于确认终端项目目录、权限模式和修改前确认机制。
OpenAI Codex 官方文档用于确认 Codex App 与 Codex CLI 的使用边界。
社区视频和搜索入口只作为辅助观察，不作为唯一事实来源。

⚠️

维护提醒：Obsidian、Claude Code、Codex 和浏览器插件会持续更新。若界面按钮名称变化，优先以官方文档为准，并在本指南中更新对应截图、文字和视频入口。

🎬

视频指南（新增）

视频陪跑入口：看不懂时，先看哪里？

本章不是让你离开指南，而是给每个难点配一个“看动作”的入口：先看视频动作，再回到本指南按验收卡实操。

✅

为什么要加视频链接？文字教程适合做步骤清单和验收标准，但新手第一次接触 Obsidian、Codex 桌面界面、Claude Code 时，往往需要先看一遍“鼠标点哪里、界面长什么样”。所以 v5.2 增加“官方文档 + 视频搜索入口 + 中文视频搜索入口”，避免你看不懂时只能硬读文字。

视频学习规则：不要一口气看 1 小时。每次只看 5—10 分钟，看到一个动作就暂停，回到本指南执行一次。执行成功后，在 Obsidian 写一条“视频学习记录”。

链接打不开时怎么办？部分本地预览、Obsidian 预览或沙盒页面会拦截“新标签页打开”。本版已加入点击修复：优先新标签页打开，若被拦截则尝试在当前页打开；同时每个视频卡片下方都提供了“查看/复制网址”的备用入口。

一、优先看这些入口

Obsidian 新手入门

适合看：安装、创建 Vault、界面区域、第一篇笔记、双链。英文视频多，中文用户可优先用 B 站搜索。

YouTube 搜索 B站搜索官方帮助

链接无法打开时：展开查看/复制网址

YouTube 搜索https://www.youtube.com/results?search_query=Obsidian+beginner+tutorial

B站搜索https://search.bilibili.com/all?keyword=Obsidian%20%E6%96%B0%E6%89%8B%E6%95%99%E7%A8%8B

官方帮助https://help.obsidian.md/

Obsidian Web Clipper

适合看：如何安装浏览器扩展、如何保存网页、如何使用模板、保存失败如何排查。

官方文档 YouTube 搜索 B站搜索

链接无法打开时：展开查看/复制网址

官方文档https://obsidian.md/help/web-clipper

YouTube 搜索https://www.youtube.com/results?search_query=Obsidian+Web+Clipper+tutorial

B站搜索https://search.bilibili.com/all?keyword=Obsidian%20Web%20Clipper%20%E6%95%99%E7%A8%8B

Claude Code

适合看：终端里如何启动、怎么进入项目目录、如何让它先审查再修改、如何避免误改文件。

官方 Quickstart YouTube 搜索 B站搜索

链接无法打开时：展开查看/复制网址

官方 Quickstarthttps://code.claude.com/docs/en/quickstart

YouTube 搜索https://www.youtube.com/results?search_query=Claude+Code+beginner+tutorial

B站搜索https://search.bilibili.com/all?keyword=Claude%20Code%20%E6%96%B0%E6%89%8B%E6%95%99%E7%A8%8B

Codex 桌面界面

适合看：打开 Codex、选择项目、进入项目工作、查看变更、审查结果。适用于 Codex 桌面图形界面或项目工作区模式。

官方入门 Codex App 文档官方视频 B站搜索

链接无法打开时：展开查看/复制网址

官方入门https://openai.com/codex/get-started/

Codex App 文档https://developers.openai.com/codex/app

官方视频https://developers.openai.com/codex/videos

B站搜索https://search.bilibili.com/all?keyword=OpenAI%20Codex%20%E6%A1%8C%E9%9D%A2%20%E6%95%99%E7%A8%8B

Windows 版 Codex App

适合看：Windows 应用、PowerShell、沙盒权限、Full Access 风险、项目目录和工具依赖。

Windows 官方文档 YouTube 搜索 B站搜索

链接无法打开时：展开查看/复制网址

Windows 官方文档https://developers.openai.com/codex/app/windows

YouTube 搜索https://www.youtube.com/results?search_query=OpenAI+Codex+app+Windows+tutorial

B站搜索https://search.bilibili.com/all?keyword=Codex%20Windows%20%E6%95%99%E7%A8%8B

终端 / PowerShell 基础

适合看：cd、dir、pwd、路径、当前目录、命令报错。这是 Claude Code / Codex CLI 的前置课。

YouTube 搜索 B站搜索

链接无法打开时：展开查看/复制网址

YouTube 搜索https://www.youtube.com/results?search_query=PowerShell+beginner+tutorial+Windows

B站搜索https://search.bilibili.com/all?keyword=PowerShell%20%E9%9B%B6%E5%9F%BA%E7%A1%80%20%E6%95%99%E7%A8%8B

二、视频和本指南如何配合？

你卡在哪里	先看什么视频	看完回到哪一章实操	不要做什么
不知道 Obsidian 是什么	Obsidian 新手入门教程	第03—09章：安装、建库、写笔记、双链	不要先研究插件和主题
不知道网页怎么保存进笔记库	Obsidian Web Clipper 使用教程	第20章：网页采集到知识库	不要把网页全文无筛选地堆进 Vault
不会用 Claude Code	Claude Code 新手教程 / 官方 Quickstart	第21—22章：终端基础 + Claude Code 协同	不要直接让它修改唯一原件
Codex 为桌面图形界面	OpenAI Codex App / Codex 桌面教程	第23A章：Codex 桌面图形界面工作流	不要按 CLI 教程强行找终端命令
不知道“进入项目工作”后做什么	Codex 入门指南 / Codex App 视频	第23A章：先读任务卡、列计划、小步修改、审查变更	不要在“快速对话”里直接让它改完整指南
看得懂视频，但做不出来	暂停视频，不继续看	回到对应章节的“本章实操卡”和“验收清单”	不要把看视频当成完成学习

三、把视频学习记录保存进 Obsidian

复制到 Obsidian：视频学习记录模板

# 视频学习记录 - 视频标题

## 视频链接
粘贴链接：

## 观看进度
例如：08:30

## 本视频解决的问题
- 

## 学到的具体动作
1. 
2. 
3. 

## 下一步实操动作
- [ ] 

## 实操结果
- 成功了吗：是 / 否
- 失败提示是什么：
- 下一步查哪一章：

✅ 本章掌握清单

□

已理解：视频用于观察操作动作，真正学习仍需回到指南完成实操。

□

已收藏 Obsidian、Web Clipper、Claude Code、Codex 桌面界面的学习入口。

□

能够判断：Codex 桌面图形界面应优先阅读“Codex 桌面界面”章节，而不是先阅读 CLI 教程。

□

已在 Obsidian 中建立“视频学习记录”模板。

🧭

本版修正说明

本版修正说明：先把容易误导新手的地方讲清楚

v5.6 在不删减原内容的基础上，修复页面横向挤压、标题竖排、表格撑破布局、视频链接点击等问题，并继续保留“Codex 桌面界面 / Codex CLI”与 Claude Code 的协同边界说明。

🎬

视频陪跑入口当学习者看不懂文字说明时，可先进入“视频陪跑入口”：看 5—10 分钟动作演示，再回到本指南按步骤做。视频负责“看动作”，本指南负责“防误区、给模板、做验收”。

🔗

链接与布局修复视频陪跑入口中的外部链接增加了备用打开逻辑和可复制网址；本版同时修复了章节头部误嵌套导致的窄列竖排、大面积空白和卡片宽度异常问题。

⚠️

为什么要先看这一节？原 v3.0 的优点是“步骤多、画面感强”，但也存在几个会让新手走弯路的点：把非官方镜像当成优先下载入口、把第三方同步写得像官方内置能力、把云盘路径风险说得过于绝对、以及默认文件夹名称前后不一致。本版已逐项修正。

原说明问题	风险	本版修正
声称“零模糊描述”“从安装到精通”	容易让新手以为照做即可覆盖所有场景	改为“入门到稳定使用”，并增加安全边界、备份与同步限制说明
优先推荐中文论坛/镜像下载	下载来源不统一，存在版本旧、文件不可信、误下第三方包的风险	改为优先使用 Obsidian 官网或官方 GitHub Release；镜像仅作为“无法访问时的备选”，并要求核对来源
Windows 安装要求改到 D:\Software\Obsidian	User Installer 通常不需要手动改路径；强行改路径反而增加操作失败概率	改为新手使用默认路径，Vault 数据单独放在非系统盘或文档目录
默认新笔记位置写成 Inbox，但后面创建的是 00-Inbox	新建笔记可能落到不存在的文件夹，造成教程断裂	统一改为 00-Inbox
“绝对不要放 OneDrive/iCloud”	过于绝对。云盘能用，但需要本地完整同步和避免多端同时编辑	改为“新手不建议；确需使用时必须备份、单端编辑、确认本地文件已下载”
社区插件仍使用“安全模式”旧口径	新版界面通常称为 Restricted mode / 受限模式，中文按钮可能显示“开启社区插件”	改为“受限模式”，并补充插件权限风险
把 WebDAV 写成手机端 Obsidian 内置同步	严重误导。Obsidian 官方支持的是 Obsidian Sync；WebDAV 依赖第三方插件或外部同步工具	同步章节重写为：官方 Sync、系统云盘、Remotely Save/WebDAV、Git 备份四类，并标注适用人群
Templater 与核心 Daily Notes 模板混用说明不够清楚	新手容易出现变量不替换，看到原始 <% %> 代码	增加“核心模板只解析 {{date}}/{{time}}/{{title}}；Templater 变量需由 Templater 触发”的说明
标题写三平台安装，但缺少 Linux 步骤	目录承诺与正文不一致	新增 Linux 安装简版流程

✅

本版使用建议零基础用户建议：先使用“本地 Vault + 官方下载 + 暂不安装太多插件 + 定期备份”的最低风险路线；等基础笔记稳定后，再开启社区插件和同步。

🧪 本章细颗粒实操卡：阅读本版修正说明

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

知道哪些旧说法被修正，避免照着旧教程误操作。

现在就做

找出一个与你相关的修正点，例如“不要把 Vault 直接放进混乱云盘”。

怎么算成功

能说出本指南为什么强调安全、备份和边界。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧭

第 00-A 章（新增）

学习前准备清单：先判断需要学到哪里

把新手最容易卡住的前置条件提前讲清楚

🚦

使用本指南的第一条规则不要从头到尾一次看完。先确认需要走哪条路线，再按“今天只完成一个小任务”的方式推进。新手真正失败的原因通常不是教程不够多，而是一次学太多。

✅ 只学 Obsidian 基础，需要准备什么？

一台 Windows / macOS / Linux 电脑，手机只能作为补充。
能打开浏览器、下载文件、找到“下载”文件夹。
能新建文件夹、复制文件路径、给文件改名。
每天 20–30 分钟，连续 7 天动手写真实笔记。

✅ 学网页采集，需要准备什么？

Chrome、Edge、Brave 或其他 Chromium 浏览器。
已经会创建 Obsidian Vault，并知道 Vault 存在哪里。
已经创建 03-Resources/Web-Clips 文件夹。
知道“采集只是入口，整理才是知识”。

✅ 学 Claude Code，需要准备什么？

会打开终端：Windows Terminal / PowerShell / Terminal。
知道项目文件夹和 Obsidian Vault 不是一回事。
能运行 claude --version 做安装验证。
会先备份，再让工具修改文件。

✅ 学本地 Codex CLI，需要准备什么？

你的 Codex 是本地终端使用，不是 VS Code 插件。
能运行 codex --version 做安装验证。
能用 cd 进入本地项目目录。
知道不要在整个私人 Vault 根目录启动 Codex。

能说出“Vault 是普通文件夹”。

能说出“Obsidian 负责资料，AI 工具负责项目执行”。

知道第一次学习不要装一堆插件。

知道所有高级功能都可以以后再学。

🧪 本章细颗粒实操卡：确认前置条件

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

别把高级工具当成第一步。

现在就做

按清单勾选自己具备的基础能力。

怎么算成功

知道自己今天该学哪条路线。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

📅

第 00-B 章（新增）

新手学习路线图：7天先用起来，30天再变强

把长教程拆成可执行的每日任务

📅

7天最小可行路线这不是完整学习路线，而是“先用起来”的路线。前7天只追求建立习惯，不追求配置完美。

安装 + 创建 Vault + 第一篇笔记

只完成三个动作：安装 Obsidian，创建 MyVault，写一篇《第一篇 Obsidian 笔记》。今天不要装插件。

学 5 个 Markdown 格式

只学标题、粗体、列表、待办、引用。把第一篇笔记重新排版一次。

建立 3 篇笔记之间的双链

创建《AI 学习》《课程资料》《工具清单》三篇笔记，用 [[笔记名]] 互相连接。

建立日记系统

开启日记核心插件，创建 06-Daily 文件夹，写当天日记。

只安装一个社区插件

先安装 Calendar 或 Templater 中的一个，不要同时装十几个插件。

整理 Inbox

把前几天临时写的内容从 00-Inbox 移动到项目、资料或日记文件夹。

复盘与固定习惯

写一篇《第一周 Obsidian 使用复盘》，记录学会了什么、哪里还卡、下周每天什么时候打开它。

目标	必学章节	先跳过
只想做个人笔记	准备清单 → 安装 → Vault → 第一篇笔记 → Markdown → 双链 → 组织 → 备份	Dataview、Claude Code、Codex、URI
想做资料库/课程库	基础章节 → 浏览器插件 → Web Clipper → 教程连接 → AI-Handoff	本地 Codex 可后学
想做 AI 项目工作台	基础章节 → 终端基础 → Claude Code → 本地 Codex CLI → AI-Handoff → 验收卡	复杂主题和视觉美化

🧪 本章细颗粒实操卡：按天执行

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

7天只做最小可行动作。

现在就做

把 D1–D7 写成自己的日程。

怎么算成功

第7天有至少 10 篇笔记。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧩

第 00-C 章（新增）

工具边界图：Obsidian、浏览器、Claude Code、Codex 各做什么

先分清角色，再谈协同

🧩

先建立边界感新手最容易把所有工具混在一起：Obsidian、浏览器插件、Claude Code、Codex、Git、云盘。正确做法是让每个工具只做它擅长的一件事。

工具	它负责什么	不要让它做什么	新手第一案例
Obsidian	保存笔记、资料、模板、任务卡、复盘	不要当代码运行环境	写《第一篇笔记》
浏览器插件	采集网页、高亮、资料入口	不要无脑收藏一切网页	保存一篇文章到 Web-Clips
Claude Code	在本地项目目录中理解项目、编辑文件、运行命令	不要直接扫完整私人 Vault	只检查一个 HTML 页面结构
Codex 桌面界面 / CLI	在选定项目工作区里读取、修改、运行代码；可通过图形界面或终端使用	不要和 Claude Code 同时改同一目录，也不要让它进入完整私人 Vault	先用“进入项目工作”打开一个测试项目，只改一个标题或一个 CSS 样式
Git / 备份	保存版本、方便回滚	新手不要一上来做复杂分支协作	修改前复制一份备份文件

⚠️

安全原则：AI 工具只处理“本次任务需要的项目副本”。不要把完整合同库、客户资料、学生资料、账号信息、私人日记交给任何本地或云端 AI 工具。

🧪 本章细颗粒实操卡：建立工具边界

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

每个工具只做擅长的事。

现在就做

画出自己的 Obsidian→AI-Handoff→项目目录流程。

怎么算成功

能说出为什么不把全库交给 AI。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

⬡

第 00 章

Obsidian 是什么？

开始之前，先搞清楚这个工具的核心定位

💡

一句话定义Obsidian 是一款把笔记存在你电脑上的本地 Markdown 编辑器，最大特色是"双向链接"——笔记 A 链接到笔记 B，就能同时看到 B 也链接了 A。适合需要长期积累、整理知识的人。

🔒

笔记存在你电脑上

所有笔记是本地的 .md 文件，不依赖任何服务器，断网也能用，软件停服笔记依然可以用记事本打开。

数据自主

🕸️

双向链接

在笔记里写 [[另一篇笔记的名字]]，就能建立链接。不仅能跳过去，还能看到有哪些笔记链接了自己（反向链接）。

核心功能

🗺️

关系图谱

所有笔记和它们的链接关系会被可视化成一张动态网络图，让你直观看到知识之间的联系。

可视化

🆓

基础应用免费

Obsidian 基础应用无需注册即可使用；Sync、Publish 和商业支持属于可选付费服务。组织场景建议评估商业许可证或内部合规要求。

免费+可选付费

适合什么人使用？

人群	使用场景	推荐程度
学生 / 研究者	整理课堂笔记、文献阅读、写论文	★★★★★ 强烈推荐
知识工作者	项目管理、会议记录、知识积累	★★★★★ 强烈推荐
写作者	素材收集、构思整理、草稿管理	★★★★★ 强烈推荐
程序员	技术笔记、代码片段、文档整理	★★★★★ 强烈推荐
只想简单记事	日常备忘、购物清单	★★★ 可以用但杀鸡用牛刀

🧪 本章细颗粒实操卡：理解 Obsidian 的定位

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

它是本地 Markdown 知识库，不是普通备忘录，也不是云文档。

现在就做

用一句话说明：使用 Obsidian 的主要目的。

怎么算成功

能说出 Vault、Markdown、双链三个词的意思。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

⬇️

第 01 章

下载与安装（修正版）

Windows / macOS / Linux 三平台安装流程，优先保证来源安全和路径简单

🔐

下载来源安全修正优先使用 Obsidian 官方下载页。国内访问不稳定时，可以参考中文社区提供的信息，但不要随便下载来历不明的网盘包；如果必须使用镜像，至少要核对版本来源、文件名、发布说明，并保留安装包来源记录。

⚠️

先纠正一个关键点软件下载优先使用 Obsidian 官网或官方 GitHub Release。中文论坛、网盘、镜像站可以作为无法访问官网时的参考入口，但不建议新手优先从不明镜像下载安装包。

Windows 安装（新手推荐默认安装）

进入官方下载页

打开浏览器，在地址栏输入 https://obsidian.md/download。页面会自动识别当前系统，优先点击 Windows 下载按钮。

浏览器→obsidian.md/download→Download for Windows

✅

预期结果：下载文件通常来自 Obsidian 官方 GitHub Release，文件名类似 Obsidian-1.x.x.exe。

💡

如果官网慢：可以到官方 GitHub Release 页面下载；中文论坛只建议用于查说明或找官方链接，不建议随意下载第三方打包文件。

运行安装程序

2-1

进入“下载”文件夹，双击 Obsidian-1.x.x.exe

2-2

如果 Windows 弹出安全提示，确认发布者和文件名无异常后点击运行

2-3

新手建议使用默认安装位置，不要强行改到复杂路径。安装程序完成后，桌面或开始菜单会出现 Obsidian 图标

2-4

安装完成后启动 Obsidian。真正重要的是知识库 Vault 的保存位置，不是软件安装位置；Vault 建议单独放在 D 盘或“文档”目录中

✅

预期结果：Obsidian 打开欢迎界面，能看到“创建新仓库/新建知识库”“打开文件夹作为仓库”等入口。

切换中文界面

3-1

点击左下角齿轮 Settings / 设置，或按 Ctrl+,

3-2

进入 General / 通用，找到 Language / 语言

3-3

选择 简体中文，根据提示点击重启或重新加载

✅

预期结果：界面菜单变为中文。如果菜单名称与教程略有不同，以“设置 → 通用 → 语言”的逻辑寻找即可。

macOS 安装

下载并拖入应用程序

1-1

访问 obsidian.md/download，点击 Mac 下载。现在官方通常提供 Universal 版本，能适配 Apple Silicon 与 Intel Mac

1-2

双击下载的 .dmg 文件，将 Obsidian 图标拖入 Applications / 应用程序

1-3

第一次打开时如出现安全提示：打开“系统设置 → 隐私与安全”，点击“仍要打开”

✅

预期结果：Obsidian 能从“应用程序”启动，Dock 中可右键保留。

Linux 安装（补全原缺失内容）

选择适合你的安装包

AppImage

适合多数发行版。下载后右键文件 → 属性 → 权限 → 勾选“允许作为程序执行”，再双击运行

Deb

适合 Ubuntu / Debian 系。下载 .deb 后双击安装，或终端运行 sudo apt install ./Obsidian*.deb

Snap / Flatpak

适合已经配置对应软件源的用户。新手优先 AppImage 或 Deb，减少权限与沙盒问题

⚠️

Linux 注意：如果后续需要使用外部编辑器、Git 或同步工具，优先确认 Obsidian 对当前 Vault 文件夹有读写权限。

🧪 本章细颗粒实操卡：完成可靠安装

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

优先官方来源，安装路径可以默认，Vault 位置要自己管理。

现在就做

下载并打开 Obsidian，切换中文界面。

怎么算成功

能打开设置页，知道版本在哪里查看。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

📁

第 02 章

创建你的第一个知识库（Vault）

Vault 是笔记数据文件夹，选对位置比软件安装路径更重要

📖

什么是 Vault？Vault 本质上是一个普通文件夹，里面保存Markdown 笔记、图片附件和 Obsidian 配置。以后换电脑，只要这个文件夹还在，个人笔记就还在。

在欢迎界面创建新知识库

1-1

点击 创建新仓库 / 新建知识库

1-2

知识库名称建议输入 MyVault、WorkVault 或中文名称。名称可以改，但不要频繁改路径

1-3

选择保存位置：Windows 可选 D:\ObsidianVaults\MyVault；macOS 可选 ~/Documents/ObsidianVaults/MyVault

1-4

确认名称和位置后，点击创建

✅

预期结果：Obsidian 主界面打开，左侧文件列表为空或只有默认说明；Vault 文件夹内会出现隐藏的 .obsidian 配置文件夹。

⚠️

云盘路径修正说明：不是“绝对不能放 OneDrive/iCloud/坚果云”，而是新手不建议一开始就放云盘同步目录。如果要放，必须确保文件始终本地可用、不要多设备同时编辑同一篇笔记，并定期备份整个 Vault。

完成初始配置（修正默认文件夹名称）

2-1

附件保存位置：设置 → 文件与链接 → 附件默认保存位置 → 选择“当前文件的子文件夹”，子文件夹名称填 assets

2-2

新笔记默认位置：设置 → 文件与链接 → 新笔记的默认位置 → 选择“指定的文件夹”，填写 00-Inbox。这是对原文 Inbox 的修正

2-3

默认编辑模式：设置 → 编辑器 → 默认编辑模式 → 选择“实时预览”

2-4

核心插件：先开启日记、模板、快速切换器、标签视图、大纲、书签、反向链接。不要一次开启所有功能，先保证基础稳定

创建基础文件夹结构

📁 MyVault/ ├── 📁 00-Inbox ← 新笔记临时收集箱 ├── 📁 01-Projects ← 有截止目标的项目 ├── 📁 02-Areas ← 长期维护领域：工作、家庭、健康 ├── 📁 03-Resources ← 资料、课程、读书笔记 ├── 📁 04-Archives ← 已完成或暂不处理内容 ├── 📁 05-Templates ← 模板文件 └── 📁 06-Daily ← 每日日记

操作方法

左侧文件区空白处右键 → 新建文件夹 → 输入名称 → 按 Enter。先创建这些文件夹，再设置默认新笔记位置，避免路径不存在。

✅

预期结果：以后按 Ctrl+N 新建笔记，会默认进入 00-Inbox，不会出现“找不到 Inbox 文件夹”的问题。

🧪 本章细颗粒实操卡：创建可长期使用的知识库

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

Vault 是你的根文件夹，后续所有笔记都在里面。

现在就做

创建 MyVault，并创建 00-Inbox、05-Templates、06-Daily。

怎么算成功

能在文件管理器里找到 .md 笔记文件。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🖥️

第 03 章

界面每个区域详细说明

认清每个按钮和区域，不再迷路

🗂️ 左侧边栏（5个图标）

📁 文件资源管理器：显示个人文件夹和笔记树，右键可新建/删除/移动
🔍 搜索：点击后在上方输入框搜索全库内容
🔖 书签：你收藏的笔记、文件夹快速访问
🏷️ 标签列表：显示库中所有 #标签及每个标签的笔记数
🗺️ 关系图谱：点击打开可视化的笔记关联网络图

📄 右侧边栏（3个常用面板）

↩️ 反向链接：显示哪些笔记链接了当前这篇笔记（重要！）
📑 大纲：显示当前笔记的标题结构，点击快速跳转
ℹ️ 文件属性：以图形方式显示和编辑笔记的 Front Matter 属性

⌨️ 状态栏与顶部工具栏

顶部左侧箭头：← → 后退/前进浏览历史，类似浏览器
顶部右上角书图标：切换当前笔记的显示模式（编辑/阅读）
顶部右上角小图标们：从左到右依次是：关系图谱、新建笔记、打开快速切换等
底部状态栏：显示字数、当前行列数、当前是实时预览还是源码模式
左下角齿轮⚙️：打开设置（最重要的按钮之一）

💡

侧边栏不见了怎么办？按 Ctrl+\（反斜杠）显示/隐藏左侧边栏；按 Ctrl+Shift+\ 显示/隐藏右侧边栏。如果还是找不到，拖动界面左右边缘的空白区域可以展开侧边栏。

🧪 本章细颗粒实操卡：认清界面区域

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

左边找文件，中间写内容，右边看大纲/反链。

现在就做

逐个点击左侧文件、搜索、图谱、设置。

怎么算成功

关闭侧边栏后能重新打开。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

📝

第 04 章

创建并编辑第一篇笔记

从创建到格式化到保存，完整操作一遍

创建新笔记

方法A

按快捷键 Ctrl+N（最快，推荐记住这个）

方法B

点击左侧边栏顶部的铅笔+纸张图标（鼠标悬停显示"新建笔记"）

方法C

在左侧文件树中右键希望存放笔记的文件夹（如 00-Inbox）→ 选"新建笔记"

✅

预期结果：中央编辑区出现一个新笔记，文件名处（顶部）呈高亮可编辑状态，光标在文件名上等待输入。

给笔记命名

2-1

新笔记创建后，顶部文件名默认显示"未命名"并处于编辑状态，直接输入希望要的笔记名称，如"第一篇笔记"

2-2

输入完成后按 Enter 或按 Tab 键，光标会自动跳到笔记内容区域

💡

命名建议：用具体的、描述性的名称，避免用"新笔记1"这样无意义的名字。好名字举例："深度学习核心概念"、"2025年读书计划"、"会议记录-产品需求评审"。

在笔记中输入内容

在编辑区域直接输入文字即可。下面演示一些基本格式：

在编辑区直接输入以下内容测试

# 这是一级标题（# 后有空格）

## 这是二级标题

这是普通段落，直接输入就好。

**这是加粗文字** （两个星号包裹）

*这是斜体文字* （一个星号包裹）

- 这是无序列表第一项
- 第二项
- 第三项

1. 这是有序列表
2. 第二项

- [ ] 这是待办任务（点击前面的方框可以勾选）
- [x] 这是已完成的任务

✅

预期结果（实时预览模式下）：输入 # 后按空格，文字立即变大成标题样式；输入 ** 包裹文字，文字变粗体；输入 - 后按空格，出现圆点列表。这就是"实时预览"的效果。

理解"自动保存"机制

Obsidian 会自动保存输入的内容，无需按 Ctrl+S。每次切换笔记或失去焦点时自动保存到磁盘。

验证保存：打开文件管理器，导航到当前知识库文件夹（如 D:\MyVault\00-Inbox），会看到刚才创建的 .md 文件，用记事本打开可以看到内容。

💡

想手动保存？按 Ctrl+S 也可以强制保存，不过通常不需要。

在不同视图模式间切换

实时预览

默认模式，所见即所得，推荐日常使用。输入 Markdown 语法后立即渲染。

源码模式

显示原始 Markdown 代码（如 ** 星号），适合复杂格式调整。切换方法：右上角点击书本图标旁的下拉箭头 → 选"源码模式"

阅读模式

完整渲染且不可编辑，适合阅读整理好的文章。切换方法：按 Ctrl+E 或点击右上角书本图标

🧪 本章细颗粒实操卡：写出第一篇笔记

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

先写出来，不追求完美格式。

现在就做

创建《第一篇笔记》，写 5 行内容。

怎么算成功

能重命名、移动、删除并恢复理解。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

✍️

第 05 章

Markdown 语法实操手册

每种语法都有输入示例和渲染效果说明

希望要的效果	输入什么	注意事项
一级标题（最大）	`# 标题文字`	# 和标题文字之间必须有一个空格
二级标题	`## 标题文字`	## 两个井号，同样要有空格
三到六级标题	`### 到 ######`	井号越多级别越小，最多6级
粗体文字	`要加粗的文字`	文字两端各有两个星号，中间没有空格
斜体文字	`要斜体的文字`	一个星号包裹，不加空格
高亮文本	`==要高亮的文字==`	两个等号包裹，Obsidian 特有语法
~~删除线~~	`~~要划掉的文字~~`	两个波浪线包裹
无序列表 •	`- 列表内容` 或 `* 列表内容`	- 或 * 后面必须有一个空格
有序列表 1.	`1. 列表内容`	数字+英文句号+空格，数字随便填，自动重排
待办任务 □	`- [ ] 任务内容`	[ ] 里有一个空格；[x] 表示已完成
引用块	`> 引用内容`	`>` 后有空格，多层嵌套用 `>>` 或 `>>>`
行内代码 `样式`	`代码内容`	反引号（键盘左上角 ~ 键不按 Shift）
代码块	输入三个反引号 ``` 后按 Enter	第一行 ``` 后可加语言名如 python 启用高亮
分割线 ——	`---`	三个短横线单独占一行，前后各空一行
内部图片	`![[图片文件名.png]]`	直接粘贴图片后自动生成此语法
网络链接	`[链接文字](https://网址)`	快捷键 Ctrl+K 可以帮你插入
数学公式	$公式内容$	两个 $$ 包裹是块级（独占一行）公式

Callout 提示块（特别实用）

Callout 语法 — 直接复制使用

> [!NOTE] 这是标题（可以省略）
> 这是内容，会渲染成蓝色提示框

> [!TIP] 技巧
> 绿色的提示框

> [!WARNING] 警告
> 橙色警告框

> [!DANGER] 危险
> 红色危险提示

> [!TIP]- 默认折叠的提示（标题后加 - 号）
> 点击标题才会展开内容

Front Matter 属性区域

Front Matter 是笔记开头的信息区，用三个短横线 --- 包裹，存放标签、日期、自定义属性等。在 Obsidian v1.4+ 中可以通过点击笔记顶部的"+ 添加属性"图形化添加，无需手写 YAML。

Front Matter 示例（笔记最开头）

---
title: 笔记标题
date: 2026-05-26
tags:
  - 学习
  - 技术
status: 进行中
---

正文从这里开始...

🧪 本章细颗粒实操卡：掌握最常用格式

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

Markdown 是轻量排版符号，不是编程。

现在就做

练习标题、粗体、列表、待办、引用。

怎么算成功

不看教程也能写出 5 种格式。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🕸️

第 06 章

双向链接与关系图谱操作

建立笔记之间的连接，让知识形成网络

创建内部链接（[[双括号]]）

1-1

在笔记编辑区，将光标放到希望插入链接的位置

1-2

连续输入两个左方括号 [[，Obsidian 立即弹出一个搜索浮窗

1-3

继续输入目标笔记的名称（支持模糊搜索，输入几个关键字即可），浮窗会显示匹配的笔记列表

1-4

用键盘 ↑↓ 箭头选择目标笔记，或直接鼠标点击，按 Enter 确认

1-5

如果输入的名称在库里不存在，按 Enter 会创建一个"幽灵链接"（显示为紫色/红色），点击该链接会自动创建对应的空笔记

✅

预期结果：编辑区出现 [[目标笔记名]] 格式的链接，在实时预览模式下显示为带下划线的蓝紫色文字。鼠标悬停在链接上时，按住 Ctrl 可以预览目标笔记内容。

💡

链接变体：
· [[笔记名|显示别名]]：链接显示为"别名"而非笔记名
· [[笔记名#标题]]：链接到笔记内的某个标题（输入 # 后按 Tab 自动补全）
· ![[笔记名]]：嵌入显示笔记内容（前面加感叹号）

查看反向链接

2-1

打开任意一篇笔记，确保右侧边栏是展开的（按 Ctrl+Shift+\ 展开）

2-2

在右侧边栏找到"反向链接"面板（可能需要点击面板顶部的标签切换）

2-3

面板会显示两个区域："已链接的提及"（明确 [[链接]] 的笔记）和"未链接的提及"（提到了名称但没有链接的笔记）

2-4

点击任意"未链接的提及"旁边的"链接"按钮，可以一键将文本变为正式链接

✅

预期结果：能看到哪些其他笔记引用了当前这篇笔记，以及哪些地方提到了当前笔记的名字但还没有建立链接。

打开并使用关系图谱

3-1

点击左侧边栏中的关系图谱图标（像蜘蛛网的图标），或按 Ctrl+P 输入"图谱"搜索并执行

3-2

图谱加载后，每个圆点是一篇笔记，连线是链接关系。滚动鼠标滚轮可以缩放，拖拽空白处可以平移，拖拽节点可以重排位置

3-3

点击任意节点，该节点高亮，右侧显示笔记名称；双击节点直接打开该笔记

3-4

图谱右上角的滑块面板可以调整：节点大小、连线粗细、是否显示标签等

3-5

局部图谱：在某篇笔记中按 Ctrl+P 搜索"局部关系图谱"，只显示这篇笔记周围的关联网络，更清晰

💡

图谱没有节点？需要先创建几篇笔记并在它们之间建立 [[链接]] 才能看到图谱效果。新建的空知识库图谱是空的，这是正常的。

🧪 本章细颗粒实操卡：建立真实关系

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

双链不是装饰，是让笔记互相解释。

现在就做

创建 3 篇笔记并用 [[ ]] 链接。

怎么算成功

图谱里能看到节点和连线。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🔧

第 07 章

核心插件逐一精细配置

每个核心插件的开启方法、配置路径和使用说明

ℹ️

核心插件 vs 社区插件核心插件是 Obsidian 官方内置的功能模块，默认部分关闭，在设置里一键开关，无需下载，稳定可靠。社区插件是第三方开发者写的扩展，需要从插件市场安装，见第08章。

核心插件：日记（Daily Notes）完整配置

开启日记插件

1-1

点击左下角 ⚙️ 打开设置 → 点击左侧列表中的"核心插件"

1-2

在右侧找到"日记"，点击右边的开关将其打开（开关变为蓝色）

1-3

开关右边会出现一个⚙️小齿轮，点击它进入日记插件的专属设置

配置日记设置（4项重要配置）

日期格式

找到"日期格式"输入框，填入 YYYY-MM-DD。这决定日记文件的命名格式，如 2026-05-26.md。也可以用 YYYY/MM/YYYY-MM-DD 来按年月创建子文件夹。

新文件位置

找到"新文件位置"，输入 06-Daily（或 06-Daily/{{date:YYYY}}/{{date:MM}} 自动按年月分文件夹）

模板文件

找到"模板文件"（可选但强烈推荐），输入你的日记模板文件路径，如 05-Templates/日记模板（先不填，等第09章配置好 Templater 后再回来填）

打开日记快捷键

关闭设置，按 Ctrl+P 搜索"打开今天的日记"，右侧点击 + 号，设置一个你喜欢的快捷键，如 Ctrl+Shift+D

✅

测试是否成功：按你设置的快捷键（或命令面板搜"今天的日记"），应该自动创建今天日期命名的笔记并打开。文件出现在 06-Daily 文件夹里。

核心插件：模板（Templates）配置

开启并配置模板插件

1-1

设置 → 核心插件 → 找到"模板" → 点击开关开启 → 点击⚙️进入模板设置

1-2

"模板文件夹位置"输入框填入 05-Templates（必须与你创建的文件夹名完全一致，区分大小写）

1-3

日期格式保持 YYYY-MM-DD，时间格式保持 HH:mm

💡

核心模板 vs Templater：核心模板插件只支持 {{date}} {{time}} {{title}} 三个简单变量。如果希望要更强大的动态模板（如弹出输入框、自动填充等），需要安装 Templater 社区插件（见第09章），两者可以同时开启，Templater 会完全替代核心模板。

创建第一个模板文件并使用

2-1

在左侧文件树中找到 05-Templates 文件夹，右键 → 新建笔记，命名为基础笔记模板

2-2

在这篇模板笔记中输入以下内容（这就是模板内容）：

05-Templates/基础笔记模板.md

---
date: {{date}}
tags: []
---

# {{title}}

## 背景

## 核心内容

## 相关笔记
- [[]]

2-3

使用模板：新建一篇空白笔记 → 按 Ctrl+P → 输入"插入模板" → 回车 → 在弹出的列表中选择"基础笔记模板" → 回车

✅

预期结果：模板内容自动填充到当前笔记，{{date}} 替换为今天的日期，{{title}} 替换为当前笔记的文件名。

🧪 本章细颗粒实操卡：只打开必要核心插件

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

核心插件是 Obsidian 自带功能，先少开。

现在就做

打开日记、模板、快速切换、大纲、反向链接。

怎么算成功

知道每个开启项有什么用。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧩

第 08 章

社区插件安装全流程（安全修正版）

从受限模式到插件启用，重点补足插件安全边界

🛡️

先理解风险社区插件是第三方代码。开启社区插件前，需要信任插件作者和插件来源。不要因为教程推荐就一次安装大量插件，新手先装 2—3 个真正需要的插件。

方法一：在线安装（官方插件市场）

开启社区插件

1-1

点击左下角 ⚙️ 设置 → 左侧选择 社区插件 / Community plugins

1-2

新版界面通常显示 受限模式 / Restricted mode。点击 开启社区插件 / Turn on community plugins

1-3

阅读风险提示后确认。确认后才会出现“浏览 / Browse”和“已安装插件”等入口

⚠️

不要忽略风险提示：社区插件可能读取本地文件、联网或影响 Obsidian 性能。企业资料、合同、隐私内容较多的 Vault，建议少装插件或单独建测试 Vault。

搜索并安装插件

2-1

点击 浏览 / Browse，等待插件市场加载

2-2

搜索插件名，如 dataview、templater、calendar

2-3

进入插件详情页，先看下载量、更新日期、评分/安全提示，再点击安装

2-4

安装完成后必须再点击 启用 / Enable，否则插件不会生效

✅

预期结果：插件出现在“已安装插件”列表中，右侧开关为开启状态。

无法加载插件市场时怎么办？

优先

检查网络、系统代理、防火墙或杀毒软件是否阻止 Obsidian 访问网络

备选

从插件作者的 GitHub Release 下载 main.js、manifest.json、必要时还有 styles.css

放置

放入 Vault/.obsidian/plugins/插件ID/ 文件夹，再回到 Obsidian 刷新并启用

⚠️

手动安装底线：只从插件作者 GitHub 或可信社区获取文件；第三方镜像只能作为参考，不建议下载不明来源的压缩包。

新手插件推荐清单（压缩版）

📊

Dataview

把笔记当数据库查询。适合项目、读书、任务汇总，但先学基础语法。

插件ID: dataview

高优先级

⚡

Templater

增强模板能力。适合固定格式笔记、日记、项目模板。

插件ID: templater-obsidian

高优先级

📅

Calendar

提供日历入口，适合日记系统。不是必须，但对新手直观。

插件ID: obsidian-calendar-plugin

可选

✅

Tasks

管理跨笔记任务。只有当你真的要做任务系统时再装。

插件ID: obsidian-tasks-plugin

进阶

🧪 本章细颗粒实操卡：安全安装社区插件

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

社区插件不是越多越好，要看来源和权限。

现在就做

只安装 Calendar 或 Templater 一个插件。

怎么算成功

能进入社区插件设置并关闭不用的插件。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

⚡

第 09 章（全新精细）

Templater 从安装到用起来

最重要的插件之一，手把手配置每一步

安装 Templater（参考第08章安装流程）

按照第08章的方法安装 Templater 插件（插件ID: templater-obsidian）并启用。安装完成后进行以下配置。

进行 Templater 必要配置（6项）

2-1

设置 → 社区插件 → 找到 Templater → 点击右边的⚙️进入 Templater 专属设置（或设置左侧列表最底部找到"Templater"）

2-2

Template folder location（模板文件夹）：输入 05-Templates（与你的模板文件夹路径一致，区分大小写）

2-3

Trigger Templater on new file creation（新建文件时触发）：建议打开，这样创建笔记时可自动应用对应文件夹的模板

2-4

Folder Templates（文件夹模板映射）：点击"Add new folder template"，第一列输入文件夹路径（如 01-Projects），第二列选择对应模板文件（如 05-Templates/项目模板）。这样在 01-Projects 文件夹新建文件时自动套用项目模板。

2-5

Syntax Highlighting（语法高亮）：打开，在编辑模板文件时高亮显示 Templater 语法

2-6

关闭设置窗口

✅

预期结果：配置保存完毕。在 05-Templates 文件夹里创建模板文件后，就可以通过命令面板使用 Templater 了。

创建日记模板文件

3-1

在左侧文件树中找到 05-Templates 文件夹，右键 → 新建笔记，命名为日记模板

3-2

将下面的模板代码完整复制粘贴到该笔记中（注意：在源码模式下粘贴，避免格式被误渲染）

05-Templates/日记模板.md — 完整代码

---
date: <% tp.date.now("YYYY-MM-DD") %>
week: <% tp.date.now("YYYY-[W]WW") %>
type: daily
---

# 📅 <% tp.date.now("YYYY年MM月DD日 dddd") %>

## 🎯 今日三件事
- [ ] 🔴 
- [ ] 🟡 
- [ ] 🟢 

## 💭 晨间思考


## 📝 工作记录


## 📚 今日学习
- **来源**：
- **收获**：

## 🌙 每日回顾
**完成了什么？**

**学到了什么？**

**明日跟进：**
- [ ] 

---
← [[<% tp.date.now("YYYY-MM-DD", -1) %>]] 昨天 ｜ 明天 [[<% tp.date.now("YYYY-MM-DD", 1) %>]] →

💡

语法说明： <% tp.date.now("YYYY-MM-DD") %> 是 Templater 的动态变量，使用模板时会自动替换为当前日期。dddd 是星期几（如"星期一"）。

⚠️

核心说明：核心模板插件只解析 {{date}}、{{time}}、{{title}} 这类变量；<% tp.date.now() %> 是 Templater 变量，必须由 Templater 插件触发解析。不要把两套模板机制混为一谈。

将日记模板关联到日记插件

4-1

设置 → 核心插件 → 日记 → 点击⚙️进入日记设置

4-2

在"模板文件"输入框中输入 05-Templates/日记模板（不需要 .md 后缀）

4-3

保存并关闭设置

4-4

测试：按 Ctrl+P 搜索并执行"打开今天的日记"，观察日记是否自动填入了模板内容和今天的日期

✅

预期结果：新建日记时自动填充模板结构，顶部 Front Matter 中日期已自动替换为今天，标题显示"2026年05月26日星期二"样式。

⚠️

如果日期没有自动替换（显示原始变量代码）：这是因为日记插件用的是核心模板，而 Templater 变量需要 Templater 来解析。解决方法：在 Templater 设置中开启"Trigger Templater on new file creation"，或在日记创建后手动按 Ctrl+P 搜索"Templater: Replace templates in active file"执行一次。

使用 Templater 插入模板（日常操作）

方法A

按 Ctrl+P 打开命令面板 → 输入"Templater" → 选择"Open Insert Template Modal" → 从列表中选择模板 → 回车

方法B

设置 Templater 快捷键：设置 → 快捷键 → 搜索"Templater: Open Insert Template Modal" → 点击 + 设置快捷键，如 Alt+T，以后按 Alt+T 直接调出模板选择框

方法C

如果已配置"文件夹模板映射"，在对应文件夹创建新文件时会自动弹出模板选择框或直接应用

🧪 本章细颗粒实操卡：用模板减少重复输入

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

模板的价值是固定格式，不是炫技代码。

现在就做

做一个会议记录模板或读书模板。

怎么算成功

新建笔记时能插入模板内容。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

📅

第 10 章（全新）

日记系统从零完整搭建

配合 Calendar 插件，建立每日记录的完整闭环

安装并配置 Calendar 插件

1-1

按第08章方法安装 Calendar 插件（ID: obsidian-calendar-plugin）

1-2

安装启用后，左侧边栏自动出现一个日历图标，点击它展开日历面板

1-3

日历面板显示当月日历，有日记记录的日期会有小圆点标记

1-4

设置 Calendar：设置 → Calendar（在插件设置底部）→ 确认"每周开始"是否符合你的习惯（建议设为"周一"）

日常使用日记的标准操作流程

早晨开始

打开 Obsidian → 点击左侧日历图标展开日历 → 点击今天的日期 → 自动创建今天的日记（如已创建则直接打开） → 填写"今日三件事"

工作中

随时在日记的"工作记录"区记录想法、决策、进展 → 创建新笔记时在日记里添加 [[链接]] 关联

晚间回顾

填写"每日回顾"区域 → 给未完成的任务加 - [ ] 标记以便下次找到 → 记录明天要跟进的事项

💡

效率技巧：在任意笔记中按 Ctrl+P 搜索"今天的日记"，随时跳转到今日日记，不需要通过文件树导航。建议设置快捷键。

使用 Periodic Notes 创建周记（可选进阶）

3-1

安装 Periodic Notes 插件（ID: periodic-notes）

3-2

设置 → Periodic Notes → 开启 Weekly Notes → 设置日期格式 YYYY-[W]WW，存放位置 06-Daily/周记，选择周记模板

3-3

每周日点击日历面板中当前周的周号数字（如"W21"），自动创建本周的周记

🧪 本章细颗粒实操卡：建立每日记录习惯

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

日记是让知识库持续增长的最低门槛。

现在就做

创建今天的日记，写 3 个小标题。

怎么算成功

06-Daily 文件夹出现当天日期文件。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

📊

第 11 章

Dataview 使用全程详解

安装配置 → 第一个查询 → 常用代码库，全程无盲点

⚠️

v5.0 新手修正：DataviewJS 不作为新手必学内容。第一阶段只学普通 LIST、TABLE、TASK 查询。只有当你明确知道为什么需要 JavaScript 查询时，再进入进阶学习。

安装后必做的设置

1-1

安装并启用 Dataview 后：设置 → 社区插件 → 已安装插件 → Dataview → 点击⚙️进入设置

1-2

找到"Enable JavaScript Queries"（启用 JavaScript 查询），打开此开关（DataviewJS 功能）

1-3

找到"Enable Inline Queries"（启用行内查询），打开（支持在文本中用 `=字段名` 插入动态值）

1-4

日期格式改为 yyyy-MM-dd，时间格式 HH:mm

✅

预期结果：设置保存。现在可以在任意笔记的代码块里写 Dataview 查询代码了。

写第一个 Dataview 查询

在任意笔记（如首页）中，输入以下代码块：

在笔记里输入这个代码块（注意语言是 dataview）

```dataview
LIST FROM ""
SORT file.mtime DESC
LIMIT 10
```

2-1

在笔记中输入三个反引号 ``` 后紧接输入 dataview（不加空格），按 Enter

2-2

输入查询内容（如上面的三行），再输入三个反引号 ``` 结束代码块

2-3

在实时预览模式下，代码块自动渲染为查询结果列表

✅

预期结果：代码块渲染为你知识库中最近修改的10篇笔记的列表，每条都是可点击的链接。如果显示"No results"说明库中还没有笔记。

⚠️

显示代码而不是查询结果？确认是"实时预览"模式而非"源码模式"；确认语言名写的是 dataview 而非其他；确认插件已启用。

Dataview 语法核心规则（先记这4条）

子句	作用	示例
`FROM`	指定从哪里查数据	`FROM "Projects"`从Projects文件夹；`FROM #标签`按标签
`WHERE`	过滤条件	`WHERE status = "进行中"`；`WHERE date = date(today)`
`SORT`	排序	`SORT file.mtime DESC`按修改时间降序
`LIMIT`	限制条数	`LIMIT 10`只显示10条

8个即用查询代码（复制粘贴使用）

① 所有进行中项目

```dataview
TABLE status, deadline AS "截止日期", priority AS "优先级"
FROM "01-Projects"
WHERE status = "进行中"
SORT deadline ASC
```

② 读书清单（按评分排序）

```dataview
TABLE author AS "作者", status AS "状态", rating AS "评分"
FROM #读书笔记
SORT rating DESC
```

③ 今日未完成任务

```dataview
TASK FROM "06-Daily"
WHERE !completed
WHERE date = date(today)
```

④ 最近7天修改的笔记

```dataview
LIST FROM ""
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC
LIMIT 20
```

⑤ 日历打卡视图（看哪天有日记）

```dataview
CALENDAR date
FROM "06-Daily"
```

🧪 本章细颗粒实操卡：理解自动汇总

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

Dataview 用来从笔记里筛选信息，新手先不用 JS。

现在就做

创建 3 篇带标签的笔记，用一个简单查询列出来。

怎么算成功

能解释 list/table/task 的区别。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🗂️

第 12 章

笔记组织实战操作

文件夹、标签、链接三套武器的具体操作方法

移动和整理笔记（从 00-Inbox 到对应文件夹）

方法A 拖拽

在左侧文件树中，按住笔记不放，拖到目标文件夹后松开。多选：先点第一篇，按住 Ctrl 再点其他篇，可以一次拖动多篇。

方法B 右键

右键笔记 → "移动文件到..." → 在弹出的搜索框中输入目标文件夹名 → 选择确认

方法C 命令面板

打开要移动的笔记 → Ctrl+P → 搜索"移动当前文件" → 回车 → 输入目标路径

✅

重要说明：移动文件时，Obsidian 会自动更新所有指向该笔记的链接路径，无需手动修改。

给笔记添加标签

方法A 行内标签

在笔记正文中任意位置输入 #标签名（# 后不能有空格），如 #学习 #技术/Python（斜杠创建嵌套标签）

方法B Front Matter

在笔记顶部的属性区域，点击"+ 添加属性" → 选择 tags → 输入标签名（不需要 # 号）→ 按 Enter 确认，再按 Enter 可以继续加标签

💡

查看所有标签：点击左侧边栏的标签列表图标，可以看到全库所有标签。点击某个标签，会在搜索框自动填入该标签的搜索条件并显示结果。

重命名笔记并保持链接不断

3-1

在左侧文件树中，慢速双击笔记名（不是双击打开，而是再慢一点让它进入重命名状态），或右键 → "重命名"，或选中文件按 F2

3-2

输入新名称后按 Enter 确认

3-3

Obsidian 会弹出提示"是否更新所有链接"，点击"更新链接"

✅

预期结果：笔记被重命名，并且库中所有指向原名字的 [[链接]] 全部自动更新为新名字，一个都不会断。

🧪 本章细颗粒实操卡：整理而不是堆积

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

Inbox 是临时区，不是永久垃圾桶。

现在就做

把 5 篇笔记从 00-Inbox 移到合适文件夹。

怎么算成功

00-Inbox 能定期清空。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🎯

第 13-A 章（新增）

三个真实场景：学生、职场、读书如何落地

把抽象功能变成自己的使用方法

🎯

为什么要加真实场景？新手不是不会点按钮，而是不知道“我自己的内容应该怎么放”。下面三个场景可以直接照抄文件夹和模板。

🎓

学生课堂笔记

结构：课程文件夹 → 每节课笔记 → 作业/错题 → 期末复习总表。第一案例：创建《数学-分数应用题》并链接到《错题本》。

学习场景

💼

职场会议记录

结构：项目文件夹 → 会议记录 → 待办 → 决策记录。第一案例：创建《会议-2026-05-27-项目评审》，提取 3 条待办。

工作场景

📚

读书知识积累

结构：书籍笔记 → 金句摘录 → 概念卡片 → 应用记录。第一案例：读一篇文章，拆出 1 个概念卡。

资料场景

三种场景的最小模板

学生/职场/读书模板

# {{标题}}

## 1. 这是什么？
用一句话说明本笔记的主题。

## 2. 关键信息
- 
- 
- 

## 3. 和哪些内容有关？
- [[相关笔记1]]
- [[相关笔记2]]

## 4. 下一步行动
- [ ] 需要复习、处理或输出的事项

今天立刻做：选择一个场景建 3 篇笔记

学生：建《课程总览》《某一节课》《错题本》。
职场：建《项目总览》《一次会议》《待办清单》。
读书：建《书籍总览》《一个概念》《应用记录》。
用 [[ ]] 把它们连起来，再打开关系图谱检查。

🧪 本章细颗粒实操卡：把功能放入场景

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

同一功能在学生、职场、读书中用法不同。

现在就做

选一个场景做 3 篇笔记。

怎么算成功

能用模板持续复用。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

⌨️

第 13 章

快捷键完整速查（含自定义方法）

从最常用到进阶快捷键，附自定义设置步骤

⌨️

设置自定义快捷键（步骤）设置 → 快捷键 → 在搜索框输入功能名（中文或英文均可）→ 找到目标功能 → 点击右侧的 + 号 → 按下希望要的按键组合 → 按 Enter 确认。如果提示"冲突"，选一个未被占用的组合。

最高频使用（必须熟记）

功能	Windows	macOS	说明
命令面板（最重要！）	Ctrl+P	⌘P	不知道怎么操作？先开这个
新建笔记	Ctrl+N	⌘N	在默认位置创建新笔记
快速切换（跳转文件）	Ctrl+O	⌘O	输入文件名模糊搜索并打开
全局搜索	Ctrl+Shift+F	⌘⇧F	搜索全库所有笔记内容
打开设置	Ctrl+,	⌘,	快速进入设置界面

编辑操作

功能	Windows	macOS
粗体 / 斜体	Ctrl+B / Ctrl+I	⌘B / ⌘I
插入链接（外部URL）	Ctrl+K	⌘K
切换编辑/阅读模式	Ctrl+E	⌘E
撤销 / 重做	Ctrl+Z / Ctrl+Y	⌘Z / ⌘⇧Z
上下移动当前行	Alt+↑↓	⌥↑↓
按词跳转光标	Alt+←→	⌥←→
打开属性面板	Ctrl+;	⌘;
文件内搜索替换	Ctrl+H	⌘H

界面控制

功能	Windows	macOS
显示/隐藏左侧边栏	Ctrl+\	⌘\
显示/隐藏右侧边栏	Ctrl+Shift+\	⌘⇧\
放大/缩小字体	Ctrl++ / Ctrl+-	⌘+ / ⌘-
后退/前进浏览历史	Alt+← / Alt+→	⌘[ / ⌘]
关闭当前标签	Ctrl+W	⌘W

🧪 本章细颗粒实操卡：只记高频快捷键

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

快捷键服务于写作，不要背大全。

现在就做

先记 Ctrl/Cmd+N、O、P、E、, 五个。

怎么算成功

能不用鼠标创建和打开笔记。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

☁️

第 14 章

同步与备份方案（重写修正版）

先区分“同步”和“备份”，再选择适合自己的方案

⚠️

重要修正Obsidian 官方提供的是 Obsidian Sync。WebDAV、坚果云、第三方云盘、Git 都不是 Obsidian 官方内置同步服务，而是外部工具或社区插件方案。它们可以用，但需要额外承担冲突、权限、网络和插件风险。

先选路线：新手不要一上来折腾复杂同步

方案	适合人群	优点	风险/限制
Obsidian Sync	想省心多端同步的人	官方服务、跨平台、版本历史、端到端加密	付费；需要 Obsidian 账号
系统云盘：iCloud / OneDrive / Dropbox / 坚果云客户端	只在电脑端轻量同步的人	设置简单，不依赖插件	多端同时编辑容易冲突；移动端限制较多
Remotely Save / WebDAV 类插件	懂一点插件和 WebDAV 的用户	可用坚果云、S3、WebDAV 等服务	第三方插件；需测试；必须先备份
Obsidian Git	懂 Git 或需要版本备份的人	版本历史强，适合桌面端备份	手机端不友好；冲突处理门槛较高

方案一：Obsidian Sync（最省心）

开通并登录账号

1-1

打开 Obsidian → 设置 → 账户 / Account → 登录 Obsidian 账号

1-2

在官网开通 Sync 后，回到 Obsidian → 设置 → 核心插件 → 开启 同步 / Sync

1-3

进入同步设置，创建或连接远程 Vault

选择同步内容

建议开启

Markdown 笔记、图片附件、主题、片段、核心设置

谨慎开启

社区插件和插件配置。如果电脑和手机插件环境不同，建议先不要同步插件配置

✅

预期结果：其他设备登录同一账号后，可以连接远程 Vault，笔记会自动同步。

方案二：系统云盘/坚果云客户端（简单但要守规则）

把 Vault 放进本地同步文件夹

1-1

先关闭 Obsidian，复制整个 Vault 文件夹到云盘本地同步目录

1-2

确认云盘客户端显示同步完成，再用 Obsidian 打开这个 Vault

1-3

另一台电脑等待同步完成后，选择“打开文件夹作为知识库”

⚠️

三条铁律：不要两台设备同时编辑同一篇笔记；不要在文件还没同步完时打开；不要只依赖云盘，至少每周复制一份完整 Vault 备份。

方案三：WebDAV / Remotely Save（修正原 WebDAV 误导）

使用第三方插件，而不是 Obsidian 内置入口

1-1

先完整备份 Vault

1-2

安装并启用 Remotely Save 或其他可靠的 WebDAV 同步插件

1-3

在插件设置中填写 WebDAV 地址、账号、应用密码、远程路径

1-4

先用测试 Vault 做同步测试，确认上传、下载、删除、冲突处理都正常，再迁移正式 Vault

⚠️

不要直接拿正式知识库测试：WebDAV 插件属于社区插件，遇到冲突时处理方式可能与官方 Sync 不同。正式使用前必须备份。

方案四：Obsidian Git（适合备份，不建议纯新手上来就用）

桌面端备份基本流程

1-1

安装 Git，创建 GitHub 私有仓库

1-2

在 Vault 文件夹中初始化 Git，并首次提交

1-3

安装 Obsidian Git 插件，设置自动备份间隔。新手建议自动备份不要太频繁，先设 30—60 分钟

示例命令：只给懂 Git 的用户参考

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/用户名/my-obsidian-vault.git
git push -u origin main

⚠️

安全修正：不要把 GitHub Token 直接写进教程里的远程地址，更不要截图或分享。优先使用 GitHub 官方认证方式或凭据管理器。

🧪 本章细颗粒实操卡：先备份，再同步

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

同步不是备份，备份不是同步。

现在就做

复制整个 Vault 到一个备份文件夹。

怎么算成功

能说出官方 Sync、云盘、Git 的区别。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🌐

第 15 章（新增）

浏览器插件安装与整理：把浏览器变成资料入口

先学会安全安装、固定、分组和清理插件，再把网页资料稳定送进 Obsidian

🧭

本章定位浏览器插件不是越多越好，而是围绕“采集、标注、保存、整理”四件事配置。新手建议先装 1 个核心插件：Obsidian Web Clipper；其他插件等你形成整理流程后再加。

推荐插件分层：先少后多

类别	推荐工具	用途	是否必装
网页采集	Obsidian Web Clipper	把网页正文、高亮、URL、标题保存到 Vault	必装
稍后阅读	浏览器书签 / 阅读列表	临时保存未判断价值的网页	可选
网页高亮	谨慎选择，先不用也可以	对网页做标注	可选
截图标注	系统截图工具优先	截取教程界面、错误提示、网页证据	可选
密码/账号	系统或可信密码管理器	管理网站登录信息	不放进 Obsidian

Chrome / Edge 安装插件通用流程

只从官方扩展商店安装

Chrome

打开 Chrome Web Store → 搜索插件名称 → 点击插件详情页 → 点击 Add to Chrome / 添加至 Chrome

Edge

打开 Edge → 点击右上角扩展图标 → 选择 获取 Microsoft Edge 扩展 → 搜索并安装

确认

浏览器弹出权限提示时，先看它要访问哪些数据，再点击“添加扩展”。如果权限明显超过用途，取消安装。

⚠️

不要做：不要从陌生网盘、群文件、破解网站下载 .crx 插件；不要为了一个不确定插件关闭浏览器安全保护。

固定常用插件，隐藏低频插件

浏览器右上角拼图图标→找到插件→点击图钉/固定

✅

预期结果：地址栏右侧只保留 2—4 个常用插件，例如 Web Clipper、截图、密码管理器。其他插件隐藏到拼图菜单里。

限制插件访问范围

3-1

进入扩展管理页：Chrome 输入 chrome://extensions；Edge 输入 edge://extensions

3-2

点击某个插件的“详情 / Details”

3-3

找到“网站访问权限 / Site access”，优先选择 点击时 或 仅限特定网站，不要默认允许访问所有网站

💡

整理原则：资料采集类插件只在需要保存网页时启用；不常用的插件先关闭，月底统一清理。

建立“插件体检表”

复制到 Obsidian：浏览器插件清单.md

# 浏览器插件清单

| 插件名称 | 用途 | 是否固定 | 权限范围 | 最后检查 | 处理 |
|---|---|---|---|---|---|
| Obsidian Web Clipper | 网页采集 | 是 | 点击时 | 2026-05-26 | 保留 |
| 截图插件 | 截图标注 | 否 | 点击时 | 2026-05-26 | 观察 |

## 清理规则
- 30天没用过：关闭
- 60天没用过：卸载
- 权限过大但用途不清：卸载
- 来源不明：立即卸载

🧪 本章细颗粒实操卡：把浏览器变成资料入口

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

插件要少而精，权限要可控。

现在就做

打开浏览器扩展管理页，固定/隐藏一个插件。

怎么算成功

能删除不用的扩展。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

✂️

第 16 章（新增）

Obsidian Web Clipper：把网页采集变成可整理的知识

不是“看见好文章就收藏”，而是保存来源、摘要、判断和后续行动

✂️

工具定位Obsidian Web Clipper 是官方浏览器扩展，可将网页内容、高亮和元数据保存到 Vault。它适合做资料采集入口，但真正的价值在于后续整理。

推荐文件夹结构

📁 MyVault/ ├── 📁 00-Inbox ├── 📁 03-Resources │ └── 📁 Web-Clips ← 网页采集资料统一进入这里 ├── 📁 20-AI-Projects ← 与 AI 工具协同的项目资料 └── 📁 99-Review ← 每周整理与复盘

安装并连接到 Obsidian

1-1

在浏览器扩展商店搜索 Obsidian Web Clipper 并安装

1-2

打开 Obsidian，确认当前 Vault 已经打开

1-3

回到浏览器，点击 Web Clipper 图标，选择要保存到的 Vault

1-4

第一次使用时，浏览器可能会询问是否允许打开 Obsidian，选择允许

✅

预期结果：网页标题、URL、正文或选中内容可以被保存到 Vault 中。

设置默认保存位置

Web Clipper 设置→保存位置 / Save location→03-Resources/Web-Clips

💡

不要直接保存到根目录：网页资料如果直接散落在 Vault 根目录，三天后就会变成新的垃圾场。

建立网页采集模板

Web Clipper 模板：web-clip-template.md

---
type: web-clip
source: "{{url}}"
created: "{{date}}"
status: inbox
tags:
  - web
  - 待整理
---

# {{title}}

## 一句话摘要
这篇内容主要讲：

## 为什么要保存它？
- 

## 关键摘录
- 

## 个人理解
- 

## 可以转化成什么？
- [ ] 课程素材
- [ ] 项目需求
- [ ] 提示词案例
- [ ] 文章选题
- [ ] 视频脚本

## 后续行动
- [ ] 今天是否需要处理？
- [ ] 是否值得精读？
- [ ] 是否需要交给 AI 总结？
- [ ] 是否需要纳入某个项目？

⚠️

变量名称以插件实际支持为准：如果某个变量没有被替换，先查看 Web Clipper 的变量说明，不要把未替换的模板误认为保存失败。

每周整理一次，不让采集变成堆积

1打开 Web-Clips

2删除低价值网页

3补一句话摘要

4链接到项目

5改 status

状态	含义	处理方式
`inbox`	刚保存，未判断	本周必须看一眼
`keep`	值得保留	补摘要，链接到项目或主题笔记
`discard`	低价值	删除或移到 Archives
`project`	已经进入项目	复制关键内容到项目资料夹

🧪 本章细颗粒实操卡：采集网页并整理

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

采集不是收藏，采集后要写自己的理解。

现在就做

用 Web Clipper 保存一篇网页到 Web-Clips。

怎么算成功

笔记里有来源、摘要、下一步。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

⌨️

第 17-A 章（新增）

终端基础课：使用 Claude Code / 本地 Codex 前必须会的 5 个动作

先补齐最小命令行能力，避免新手卡在第一步

🖥️

为什么要单独学终端？Claude Code 和本地 Codex CLI 都是“在终端里进入项目目录，再执行任务”的工具。不会终端，不代表不能用，但必须先学会最小的 5 个动作。

Windows 用户先分清 3 个窗口

PowerShell：提示符常见为 PS C:\Users\你>。
CMD：提示符常见为 C:\Users\你>。
Windows Terminal：一个外壳，可以打开 PowerShell、CMD、Git Bash。

macOS / Linux 用户看这个

Terminal：系统自带终端。
pwd：查看当前位置。
ls：列出当前文件夹内容。
cd 文件夹路径：进入指定文件夹。

5 个必须会的终端动作

动作	Windows 示例	macOS / Linux 示例	看见什么算成功
查看当前位置	`cd`	`pwd`	显示当前所在文件夹路径
列出文件	`dir`	`ls`	看到当前目录里的文件名
进入 D 盘	`D:`	不适用	提示符变成 D 盘
进入项目目录	`cd /d D:\AI-Projects\demo`	`cd ~/AI-Projects/demo`	提示符路径变为 demo
验证命令是否安装	`codex --version`	`claude --version`	显示版本号，而不是 command not found

第一个终端小练习：只进入一个项目文件夹

在电脑上新建文件夹：D:\AI-Projects\hello-html。
打开终端，输入 cd /d D:\AI-Projects\hello-html。
输入 dir，确认当前文件夹内容。
不要运行 Claude 或 Codex，今天只练会“进入目录”。

已理解 PowerShell 和 CMD 不是同一个窗口。

能够进入指定项目文件夹。

能够用版本命令判断工具是否安装成功。

已理解：不要在 MyVault 根目录启动代码工具。

🧪 本章细颗粒实操卡：掌握最小终端动作

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

代码工具工作在“当前目录”里。

现在就做

进入一个测试项目文件夹并列出文件。

怎么算成功

能判断自己是否在正确目录。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🛠️

第 17 章（重写增强）

Obsidian × Claude Code：本地项目目录协同方案

本章默认 Claude Code 在终端/本地项目目录中使用，不把它当普通聊天窗口，也不要求必须使用 VS Code

🧠

先把定位说清楚Claude Code 是“在项目目录里帮你读文件、改文件、运行命令的代码协作工具”。Obsidian 不是让它直接操作的私人知识库，而是任务需求整理区、任务卡生成区、验收记录区。正确关系是：Obsidian 写清楚 → 复制到项目 docs/ → Claude Code 在项目目录执行 → 结果回写 Obsidian。

本章默认的使用方式

项目	本教程采用	不采用	原因
启动位置	终端进入项目文件夹后启动 Claude Code	在整个 Obsidian Vault 根目录启动	避免私人笔记、合同、客户资料被纳入上下文
资料交接	只把本次任务需要的文件复制到 `docs/`	把全库资料都交给 AI	范围越小，越安全，修改越可控
工作方式	先让它读任务卡并输出计划，再分步修改	直接说“你看着优化”	新手可以在动手前发现误解
执行范围	只允许修改任务卡列出的文件	允许大范围重构	保护原项目结构和原内容体量

Claude Code 和 Obsidian 的职责边界

环节	Obsidian 负责	Claude Code 负责	人的判断负责
需求阶段	整理目标、约束、参考资料、验收标准	阅读需求，复述理解，提出执行计划	确认它是否理解正确
执行阶段	不直接改代码，只保存任务说明和决策记录	读取项目文件、编辑代码、运行命令、检查错误	批准或拒绝关键修改
验收阶段	记录改了什么、是否达标、下次怎么优化	输出变更摘要、列出风险和待确认项	打开页面/运行项目进行人工验收

推荐项目结构：不要让 AI 直接面对整个 Vault

📁 D:/AI-Projects/project-name/ ← Claude Code 只在这个项目目录中工作 ├── 📁 src/ ← 真正的代码或页面文件 ├── 📁 public/ ├── 📁 docs/ ← 从 Obsidian 复制出来的“任务交接文件” │ ├── 📄 00-任务背景.md │ ├── 📄 01-Claude-Code-任务.md │ ├── 📄 02-禁止事项.md │ ├── 📄 03-验收清单.md │ └── 📄 04-修改记录.md ├── 📄 index.html └── 📄 README.md

⚠️

关键边界：如果你的 Obsidian Vault 里有合同、客户、学生、账号、付款、私人日记等内容，不要在 Vault 根目录运行 Claude Code。把本次任务需要的内容“复制一份”到项目 docs/，只让 Claude Code 接触这份经过筛选的交接材料。

先在 Obsidian 写“任务卡”，不要直接打开 Claude Code

任务卡不是写给自己看的流水账，而是写给 AI 执行的“施工图”。它必须包含：目标、当前问题、允许改什么、不允许改什么、验收标准。

01-Claude-Code-任务.md

# Claude Code 任务说明

## 项目目标
请根据以下说明，修改当前项目中的 HTML / 代码文件。

## 当前文件
- index.html
- docs/03-验收清单.md

## 不允许改动
- 不改变整体视觉风格
- 不删除原有章节
- 不改变已有锚点 ID
- 不破坏移动端适配
- 不引入复杂依赖
- 不读取与本任务无关的私人笔记
- 不修改 docs/ 以外的私人资料

## 需要完成
1. 只根据任务卡新增或修正指定章节
2. 更新侧边栏目录
3. 更新顶部目录
4. 保留原 CSS 风格
5. 修改完成后输出变更摘要

## 验收标准
- 页面能正常打开
- 目录跳转正常
- 新内容对新手友好
- 没有暴露私人资料
- 没有引入外部不可信脚本
- Git diff 中没有无关文件变化

✅

预期结果：你得到一份 Claude Code 可以直接读取的任务说明，而不是一段模糊的聊天请求。

把任务卡从 Obsidian 复制到项目 docs 文件夹

2-1

在项目目录中新建 docs/ 文件夹

2-2

把 Obsidian 中的任务卡复制成 docs/01-Claude-Code-任务.md

2-3

把验收清单复制成 docs/03-验收清单.md

2-4

确认 docs 里不含账号、Token、客户名单、合同原件、身份证、付款记录等敏感内容

在项目目录启动 Claude Code

这里的核心不是“安装在哪”，而是“在哪个文件夹启动”。用户在哪个项目目录启动，AI 就会围绕这个目录工作。

Windows 示例

cd /d D:\AI-Projects\project-name
claude

macOS / Linux 示例

cd ~/AI-Projects/project-name
claude

⚠️

不要这样做：cd D:\MyVault 后启动 Claude Code。这样等于把整个知识库都放到 AI 工作区旁边，新手很难控制边界。

第一句话必须要求“先计划，后执行”

建议直接复制

请先阅读 docs/01-Claude-Code-任务.md 和 docs/03-验收清单.md。

在动手修改前，请先输出：
1. 你理解的任务目标
2. 你准备修改哪些文件
3. 你不会修改哪些文件
4. 是否发现风险、矛盾或缺失信息
5. 你的执行步骤

未经我确认前，不要删除文件，不要大规模重构，不要修改与任务无关的内容。

✅

预期结果：Claude Code 先给出计划。你确认计划没跑偏后，再让它分步执行。

执行时只批准小步修改

情况	建议	原因
修改 HTML 页面、课程网页、工具脚本	适合	能读取文件并根据任务卡进行编辑
需要运行命令、检查报错、修复项目问题	适合	终端环境下更接近真实开发流程
只想润色一段文案	不必使用	直接在聊天窗口或 Obsidian 中整理即可
包含大量私人笔记、合同、客户资料	不建议直接打开	先复制脱敏材料到项目 docs/ 再处理

为什么要学

Obsidian 写需求，Claude Code 读项目并改文件。

现在就做

让 Claude Code 只检查一个 HTML 文件并给修改建议。

怎么算成功

知道不要让它直接扫私人 Vault。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

Claude Code 第一个安全案例：只做审查，不改文件

复制一个测试 HTML 到 D:\AI-Projects\demo-page。
终端进入该目录：cd /d D:\AI-Projects\demo-page。
运行 claude，输入：请只审查 index.html 的页面结构问题，先不要修改文件。
看它给出的建议，把建议复制回 Obsidian 的《修改记录.md》。
确认建议合理后，再进行下一轮“允许修改”。

🖥️

第 18-A 章（新增修正）

Codex 桌面图形界面：项目工作区流程

本章专门适配“快速对话 / 搜索 / 插件 / 自动化 / 项目 / 进入项目工作”这个界面

✅

先给结论Codex 桌面图形界面不是 VS Code 插件，也不是普通网页聊天；它属于通过图形界面进入项目工作区的 Codex 使用方式。它仍然属于“本地项目协同”的范畴，但操作入口不是在终端里输入 codex，而是通过界面中的 进入项目工作 选择或进入项目工作区。

🎬

官方 Codex 视频入口如果不确定“进入项目工作”“选择项目目录”“查看变更”分别在哪里，请先打开本指南顶部的“视频陪跑入口”，查看 Codex App 官方入门、官方视频和 B 站搜索入口。看完以后再回到本章按流程操作。

Codex 桌面界面与终端 CLI 流程的差异

指南原说法	与Codex 桌面界面是否匹配	正确改法
终端输入 codex 启动	不完全匹配	主入口应改为：打开 Codex 桌面界面 → 点击进入项目工作 → 选择项目目录
Codex 在本地项目目录工作	匹配	仍然保留：必须选择独立项目文件夹，不要选择整个 Obsidian Vault
先写任务卡，再交给 Codex	匹配	任务卡仍放在项目 docs/ 文件夹，进入项目后让 Codex 先读任务卡
权限要谨慎	匹配	界面可能显示“完全访问权限”，新手第一周建议改为较低权限或每次确认，不要默认全权执行
修改后看 diff / 文件变化	匹配	桌面界面通常更适合审查变更，重点教“查看变更、撤销、确认、保存记录”

⚠️

最容易误解的地方：“本地 Codex”不等于“只有终端 CLI”。该界面也是本地/桌面工作方式的一种。旧版指南若只写 cd 项目目录 → codex，会让你以为自己用错了工具；实际上不是你错，是指南需要补“Codex 桌面界面”这一条主线。

Codex 桌面界面小白主流程

Obsidian 写任务卡

复制到项目 docs/

打开 Codex 桌面界面

进入项目工作

先计划后执行

审查变更并回写

先准备一个“可让 Codex 进入”的项目文件夹

不要把 Obsidian Vault 直接当项目工作区。先在电脑上建立一个专门给 Codex 操作的项目副本。

📁 D:/AI-Projects/obsidian-guide-test/ ├── 📁 docs/ ← 从 Obsidian 复制来的任务卡、验收清单 │ ├── 📄 01-Codex-任务卡.md │ ├── 📄 02-禁止事项.md │ └── 📄 03-验收清单.md ├── 📄 index.html ← 要修改的页面副本 └── 📄 README.md

✅

预期结果：你有一个独立项目目录，里面只有本次任务需要的文件，没有私人日记、合同、客户资料、账号密码。

点击“进入项目工作”，而不是直接随便提问

2-1

打开Codex 桌面图形界面界面。

2-2

在输入框下方找到 进入项目工作。

2-3

选择刚才准备好的项目目录，例如 D:/AI-Projects/obsidian-guide-test。

2-4

进入后，先检查界面是否显示当前项目或工作区名称。没有显示时，不要开始执行修改。

⚠️

不要这样做：不要在“快速对话”里直接说“帮我修改我的 Obsidian 教程”。没有进入项目工作区时，Codex 可能无法准确知道要改哪个文件，也不方便你审查变更。

把“完全访问权限”改成新手可控模式

你的截图里显示的是 完全访问权限。这适合熟练用户，但新手第一周不建议默认使用。优先选择“每次确认 / 询问后执行 / 只读审查”一类权限。

权限模式	适合谁	新手建议
只读 / 审查	第一次使用、只想让它看问题	第一优先
每次确认后修改	已经知道要改哪个文件	推荐
完全访问权限	熟悉项目、会看 diff、会回滚	暂时慎用

💡

新手口诀：第一次让 Codex 进入项目，只让它“看”和“列计划”；第二次再允许它改一个文件；第三次才考虑批量修改。

第一句话：要求它先确认工作区、再读任务卡、最后列计划

给 Codex 桌面界面的第一句话

请先不要修改任何文件。

请先完成以下检查：
1. 确认你当前进入的项目工作区路径是什么；
2. 阅读 docs/01-Codex-任务卡.md 和 docs/03-验收清单.md；
3. 复述你理解的任务目标；
4. 列出你计划修改哪些文件；
5. 明确说明你不会修改哪些文件；
6. 如果发现任务卡不清楚、文件缺失、权限过大或存在隐私风险，请先提醒我。

未经我确认，不要删除文件，不要批量重构，不要访问与任务无关的资料。

✅

预期结果：Codex 先输出理解和计划，而不是马上改文件。你确认没问题后，再让它执行第一步。

执行时只让它做一个小任务

安全任务

只修改一个标题、一个段落、一个 CSS 小问题、一个目录项。

危险任务

“全面优化整份指南”“自由发挥重构页面”“你看着改到最好”。这些都太大，不适合新手第一次使用。

第一个安全执行请求

请只修改 index.html 中 Codex 相关章节的标题和说明文字，
不要修改 CSS，不要删除任何原有章节，
修改完成后请列出具体改动位置和人工验收方法。

修改后必须审查变更，再回写 Obsidian

6-1

查看 Codex 展示的文件变更、diff、修改摘要或变更列表。

6-2

打开被修改的 HTML / 项目页面，人工检查页面是否正常。

6-3

把“改了什么、为什么改、是否通过验收、下次继续做什么”写回 Obsidian 的修改记录。

✅ Codex 桌面界面验收清单

□

确认 Codex 进入的是项目副本，不是完整 Vault。

□

确认权限不是无脑全权执行，关键修改需要我确认。

□

让 Codex 先列计划，再执行。

□

看过文件变更，知道它改了什么。

□

已把修改记录回写到 Obsidian。

🤖

第 18-B 章（修正）

Obsidian × Codex CLI：备用/进阶终端工作流

本章保留终端 CLI 用法；如果使用的是上一章Codex 桌面图形界面桌面界面，请优先按 18-A 操作

🤖

概念边界说明这里保留的是“Codex CLI 终端用法”：在电脑终端里进入某个项目目录，然后运行 Codex，让它在这个目录里读取、修改和运行项目文件。它不是 Obsidian 插件，也不要求必须安装 VS Code 或 IDE 扩展。如果该界面是“进入项目工作”的图形界面，先看上一章 18-A。

Codex 的两条本地路线：桌面界面优先，CLI 备用

选项	是否为本章默认	说明	新手注意
本地 Codex CLI	是	在终端进入项目目录后运行 `codex`，围绕当前目录执行开发任务	必须先确认当前目录正确
Codex IDE / VS Code 扩展	不是	在编辑器中使用 Codex，本章不以此为主	不要把 IDE 说明混到本地 CLI 流程里
Codex Cloud	不是	把仓库任务交给云端环境执行	涉及仓库权限，不适合作为小白第一流程
完全离线本地模型	另行配置	Codex CLI 可以本地运行，但默认并不等于模型完全离线；若使用本地模型需另外配置 OSS / 本地提供方	不要把“本地终端运行”误解成“一定不联网”

Obsidian、本地 Codex、Claude Code 的关系

工具	在这套流程中的位置	主要产出	不要让它做什么
Obsidian	任务总控台、资料整理区、复盘区	任务卡、验收清单、修改记录、教程索引	不要直接变成给 AI 全量读取的私人数据库
本地 Codex CLI	在项目目录执行代码任务	代码修改、文件变更、命令运行结果、变更摘要	不要同时和另一个 AI 改同一批文件
Claude Code	可以作为另一个本地代码执行工具，或作为方案审查工具	执行计划、代码修改、复核意见	不要和 Codex 同时在同一目录自动修改

🧭

推荐判断如果已经明确“我的 Codex 是本地终端使用”，那么本教程默认走“Obsidian 写任务卡 → 复制到项目 docs/ → 终端进入项目目录 → 运行 Codex → 验收后回写 Obsidian”的路线。IDE、VS Code、Cloud 只作为附加说明，不放在主流程里。

本地 Codex 项目结构

📁 D:/AI-Projects/project-name/ ← 终端必须进入这里，而不是进入 MyVault ├── 📁 src/ ├── 📁 public/ ├── 📁 docs/ │ ├── 📄 00-任务背景.md │ ├── 📄 01-Codex-开发任务卡.md │ ├── 📄 02-禁止事项.md │ ├── 📄 03-验收清单.md │ └── 📄 04-Codex-修改记录.md ├── 📄 index.html └── 📄 README.md

Codex 本地任务卡模板

01-Codex-开发任务卡.md

# Codex 本地开发任务卡

## 任务名称
例如：为 Obsidian 教程 HTML 明确“本地 Codex CLI 与 Claude Code 协同方案”

## 当前问题
若把 Codex IDE、Codex CLI、Codex Cloud 放在同一张表中并列讲解，容易导致新手无法判断主流程。

## 本次默认工具
- 工具：本地 Codex CLI
- 使用方式：终端进入项目目录后运行 codex
- 不使用：VS Code 插件、IDE 扩展、Codex Cloud

## 需要修改的文件
- index.html

## 不允许修改
- 不修改私人 Obsidian Vault
- 不删除原有章节
- 不改变原有视觉风格
- 不新增复杂依赖
- 不修改任务卡以外的无关文件
- 不读取 docs/ 之外的私人资料

## 需要完成
1. 明确本地 Codex CLI 的主流程
2. 说明 Claude Code 和 Codex 不要同时编辑同一批文件
3. 加入交接目录、启动命令、第一句话、验收方法
4. 保留原内容体量，只做增量增强

## 验收标准
- 新手知道：Codex 应该在项目目录中启动
- 新手知道：Codex 不是 Obsidian 插件
- 新手知道：本章不是 VS Code / IDE 扩展教程
- 新手知道：修改后要检查 Git diff 或文件变化
- 新手知道：结果要回写 Obsidian

交给 Codex 前先做“目录确认”

本地 Codex 最大的风险不是“不会用”，而是“在错误目录里启动”。启动前先确认：需要改的是项目文件夹，不是整个 Obsidian Vault。

检查1

项目是否已经复制到独立目录，例如 D:\AI-Projects\project-name

检查2

任务卡是否已经放入 docs/01-Codex-开发任务卡.md

检查3

是否有 Git 备份，或者至少复制了一份原始文件

检查4

是否删除了账号、Token、客户资料、合同原件等敏感内容

检查5

是否明确写了“只允许修改哪些文件”

在终端进入项目目录并运行本地 Codex

Windows 示例

cd /d D:\AI-Projects\project-name
codex

macOS / Linux 示例

cd ~/AI-Projects/project-name
codex

⚠️

新手不要做：不要在 D:\MyVault、~/Documents/MyVault 或含有私人资料的总文件夹里运行 codex。

给本地 Codex 的第一句话

建议复制使用

请阅读 docs/01-Codex-开发任务卡.md 和 docs/03-验收清单.md。

在修改任何文件之前，请先输出：
1. 你理解的任务目标
2. 本次只会修改哪些文件
3. 明确不会修改哪些文件
4. 你发现的风险或矛盾
5. 你的执行步骤

未经我确认，不要直接修改文件；不要删除原有内容；不要读取与任务无关的私人资料。

✅

预期结果：Codex 会先给出计划，你确认后再让它执行。这样可以避免它按错误方向大规模改动。

让 Codex 分批执行，不要一次全改

第一批

只改目录、标题、说明文字等低风险内容

第二批

再改核心正文、模板、流程图

第三批

最后修正故障排查、验收清单、版本说明

💡

为什么要分批？本地 Codex 能读写项目文件，效率高，但如果任务太大，新手不容易判断它改了哪些内容。分批执行更容易验收和回滚。

修改后先看变化，再决定是否继续

方法A

如果会 Git：运行 git diff，查看到底改了哪些内容

方法B

如果不会 Git：复制修改前文件，与修改后文件用文本对比工具比较

方法C

如果是 HTML：直接双击打开页面，检查目录、样式、文字、跳转是否正常

让 Codex 输出修改摘要

请总结本次修改：
1. 修改了哪些文件
2. 每个文件改了什么
3. 有哪些潜在风险
4. 我应该如何人工验收
5. 哪些内容没有处理

把 Codex 结果回写到 Obsidian

04-Codex-修改记录.md

# Codex 修改记录

## 本次任务
- 日期：2026-05-26
- 工具：本地 Codex CLI
- 启动目录：
- 任务卡：docs/01-Codex-开发任务卡.md

## Codex 修改了什么
- 

## 我人工检查了什么
- [ ] 页面能打开
- [ ] 目录能跳转
- [ ] 原内容没有被删减
- [ ] 没有无关文件变化
- [ ] 没有泄露私人资料

## 需要下次继续处理
- 

## 本次经验
-

Claude Code 与本地 Codex 如何协同：三种安全模式

模式	做法	适合情况	风险控制
模式A：二选一执行	一个任务只选 Claude Code 或 Codex 其中一个执行	新手首选	不会互相覆盖修改
模式B：Claude Code 先审方案，Codex 执行	Claude Code 帮你检查任务卡是否清晰，再把最终任务卡交给本地 Codex 修改代码	适合任务复杂但执行范围明确	Claude Code 不直接改文件，只产出方案
模式C：Codex 执行，Claude Code 复核	Codex 完成后，把变更摘要和关键文件交给 Claude Code 做代码/结构审查	适合重要项目验收	复核前先保存 Codex 版本，避免二次覆盖
禁止模式：两个工具同时改同一目录	Claude Code 和 Codex 同时运行、同时编辑同一批文件	不建议	容易产生覆盖、冲突、无法追踪责任

什么时候用 Codex，什么时候用 Claude Code？

任务类型	优先建议	理由
本地代码仓库中的明确开发任务	本地 Codex CLI	围绕当前项目目录执行，适合文件修改和命令运行
需要长时间讨论需求、梳理产品逻辑	Obsidian + Claude Code / 普通 Claude	先把问题说清楚，再进入代码执行
修改单个 HTML 教程文件	二者都可以，建议一次只选一个	关键在任务卡和验收标准，不在工具名
涉及私人 Vault、合同、客户资料	先在 Obsidian 脱敏，再复制到项目 docs/	任何本地 Agent 都不应该直接面对全量私人资料

⚠️

最重要提醒：本地 Codex CLI 的“本地”指用户在本机终端和本地项目目录中操作，不代表可以无边界读取私人资料，也不代表模型一定完全离线。新手只需要记住：先进入正确项目目录，再运行 codex；不要在私人 Vault 根目录运行。

🧪 本章细颗粒实操卡：用本地 Codex CLI 执行代码任务

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

本地 CLI 主线是终端 + 项目目录。

现在就做

在测试项目中让 Codex 修改一个标题。

怎么算成功

修改前后能人工验收。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

本地 Codex CLI 第一个安全案例：只改一个标题

创建测试项目：D:\AI-Projects\codex-test，里面只放一个 index.html。
复制整个文件夹，得到 codex-test-backup。
终端进入测试项目：cd /d D:\AI-Projects\codex-test。
运行 codex。
输入：请只把 index.html 的主标题改成“Obsidian 教程测试页”，不要修改其他内容。
修改后用浏览器打开 index.html 检查，再把变更摘要写回 Obsidian。

🔗

第 19 章（新增）

Obsidian URI：从浏览器、项目文档和 AI 报告跳回笔记

用链接把“网页资料、项目代码、AI 修改记录、Obsidian 笔记”连接起来

🔗

一句话理解Obsidian URI 是一种特殊链接，形如 obsidian://...。点击它可以打开指定 Vault、指定笔记，适合做跨软件跳转。

最常用格式

打开指定笔记

obsidian://open?vault=MyVault&file=20-AI-Projects/Obsidian教程改版/需求说明

新建一篇笔记

obsidian://new?vault=MyVault&name=临时想法&content=这里写内容

先确认 Vault 名称和笔记路径

1-1

Vault 名称就是 Obsidian 左下角切换知识库时看到的名称

1-2

笔记路径从 Vault 根目录开始写，不需要写磁盘盘符

1-3

中文、空格、特殊符号有时需要 URL 编码；如果点击失败，先换成英文路径测试

把 URI 放进项目 README

README.md 示例

## 项目资料

- Obsidian 需求笔记：obsidian://open?vault=MyVault&file=20-AI-Projects/项目名/需求说明
- 本次 AI 修改记录：obsidian://open?vault=MyVault&file=20-AI-Projects/项目名/修改记录

常见用途

📌

浏览器书签

把某个项目笔记做成书签，点击直接打开 Obsidian 对应页面。

快速入口

📄

项目 README

代码项目里保留需求笔记链接，避免代码和需求脱节。

项目连接

🤖

AI 修改报告

在 Claude Code / Codex 的输出摘要里写上对应笔记链接，方便回查。

结果回溯

📅

每日复盘

日记中链接当天处理过的项目和网页资料。

复盘闭环

⚠️

注意：URI 依赖 Vault 名称和文件路径。改名、移动文件、换电脑后，链接可能失效。重要项目尽量保持路径稳定。

🧪 本章细颗粒实操卡：建立跨软件跳转

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

URI 用于从外部回到某个 Vault/文件。

现在就做

创建一个打开指定笔记的 obsidian:// 链接。

怎么算成功

知道中文路径可能需要编码。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧱

第 20 章（新增）

AI-Handoff 交接区：让 AI 协同安全、可控、可复盘

只交给 AI 本次需要的资料，不交整个私人知识库

🔐

最重要原则把 Obsidian 当“主知识库”，把 AI-Handoff 当“临时交接区”。交给 AI 的内容必须是经过筛选的任务材料，而不是你的完整私人资料、合同、账号、客户名单或未脱敏文件。

AI-Handoff 文件夹结构

📁 MyVault/ └── 📁 20-AI-Projects/ └── 📁 项目名称/ ├── 📄 00-任务背景.md ├── 📄 01-需求说明.md ├── 📄 02-可提供资料.md ├── 📄 03-禁止事项.md ├── 📄 04-验收清单.md └── 📄 05-结果复盘.md

✅ 可以交给 AI

已经脱敏的项目需求
公开网页资料和链接
需要修改的单个 HTML / Markdown 文件
明确的验收标准
不含私人信息的示例数据

🚫 不建议交给 AI

完整私人 Vault
合同原件、身份证、账号密码、Token
客户名单、学生信息、付款记录
未经授权的公司内部资料
与本任务无关的大量历史聊天记录

交接前脱敏清单

检查项	处理方式
手机号 / 邮箱 / 身份证号	替换为“某手机号”“某邮箱”“某证件号”
公司合同金额	如果不影响任务，替换成区间或示例金额
API Key / Token / 密码	删除，不允许出现在任何交接文件中
真实客户资料	替换成 A客户、B客户，保留结构不保留身份
私人日记或聊天记录	只摘取与任务相关的结论，不整段复制

AI 协同闭环

1Obsidian 写需求

2脱敏筛选

3复制到 Handoff

4Claude/Codex 执行

5验收回写

AI 交接总提示词

你只能基于我提供的资料完成本次任务。
请不要假设可以访问我的完整 Obsidian 知识库。
请不要要求我上传与任务无关的私人资料。

在执行前，请先检查：
1. 任务目标是否清楚
2. 输入资料是否足够
3. 是否存在隐私或安全风险
4. 是否需要我确认修改范围

执行后，请输出：
1. 完成了什么
2. 修改了哪些文件/内容
3. 有哪些不确定点
4. 我应该如何验收
5. 哪些内容需要回写到 Obsidian

🧪 本章细颗粒实操卡：安全交接给 AI

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

只给 AI 本次任务所需资料。

现在就做

创建 AI-Handoff 文件夹和任务卡。

怎么算成功

能检查是否泄露私人信息。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧭

第 21 章（新增）

新手学习路线图：不要一次学完，按目标走

把 25 章拆成 3 条路线、7 天任务和可跳过模块，小白不再被内容体量吓住

🎯

这一章解决什么问题？本指南内容很多，不代表必须一次学完。新手最容易犯的错误是第一天就安装很多插件、折腾同步、研究 Claude Code / Codex，最后基础库还没搭好。正确做法是：先完成最小闭环，再逐步增加能力。

三条学习路线：先选你的目标

路线	适合谁	必学章节	暂时可跳过	最终产出
路线 A：个人笔记入门	只想用 Obsidian 写笔记、整理学习资料	00 → 01 → 02 → 03 → 04 → 05 → 06 → 12 → 14 → 24	Templater、Dataview、Claude Code、Codex	一个能长期写笔记、能双链、能备份的个人知识库
路线 B：资料采集与课程知识库	要整理网页、课程、提示词、业务资料	00 → 01 → 02 → 05 → 06 → 12 → 15 → 16 → 20 → 22 → 23 → 24	高级 Dataview、Git 同步、复杂自动化	浏览器采集 → Obsidian 整理 → 模板沉淀的资料库
路线 C：AI 项目协同工作台	要把 Obsidian 连接 Claude Code / Codex 做网页、代码、文档项目	00 → 01 → 02 → 12 → 15 → 16 → 17 → 18 → 19 → 20 → 21 → 22 → 23 → 24	不相关的主题美化、过多社区插件	Obsidian 写需求，AI 工具执行，结果回写复盘

7 天最小可行学习计划

D1安装 · 建库

D2写第一篇笔记

D3Markdown · 双链

D4文件夹与组织

D5网页采集

D6模板 · 日记

D7备份 · 复盘

📅 第 1 天：只完成安装与建库

完成软件下载与安装，不追求主题美化
创建一个 Vault，位置选本地稳定文件夹
创建 00-Inbox、01-Projects、03-Resources、05-Templates 等基础文件夹
完成附件位置、新笔记位置、实时预览三个基础设置

📝 第 2 天：只完成第一篇笔记

创建一篇“第一篇 Obsidian 笔记”
输入标题、列表、待办、粗体、链接
验证文件是否真实保存为 .md 文件
不要安装社区插件，不要研究同步

🕸️ 第 3 天：建立第一个双链网络

新建 3 篇相关笔记，例如“AI学习”“提示词”“课程设计”
用 [[笔记名]] 把它们连接起来
打开反向链接和关系图谱看效果
理解：双链不是为了炫酷，而是为了建立知识关系

🗂️ 第 4 天：整理文件夹与项目

把临时笔记放进 00-Inbox
把正在做的内容放进 01-Projects
把长期资料放进 03-Resources
建立一个“项目首页”，用链接连接相关材料

🌐 第 5 天：浏览器采集闭环

安装并固定 Obsidian Web Clipper
采集 1 篇网页到 03-Resources/Web-Clips
补上“一句话摘要、我的理解、后续行动”
删除无价值网页，不把 Obsidian 变成垃圾收藏夹

⚡ 第 6 天：模板与日记

建立 05-Templates 文件夹
制作一个“网页采集整理模板”
制作一个“每日复盘模板”
只保留 2–3 个常用模板，先不要做复杂自动化

☁️ 第 7 天：备份与复盘

复制整个 Vault 到移动硬盘或备用文件夹
检查 7 天内写了几篇笔记、链接了几篇
记录自己最常用的 5 个功能
决定下一步走个人笔记、资料库，还是 AI 项目协同路线

🚧 第 8 天以后再做

需要项目开发时，再学习 Claude Code / Codex
需要数据查询时，再学习 Dataview
需要跨设备时，再选择 Sync / 云盘 / Git / WebDAV
需要规模化课程时，再建立教程总控台

前 7 天不要做什么

⚠️

不要一上来追求“全自动”。前 7 天不要一次安装 20 个社区插件，不要把 Vault 放进多个云盘同时同步，不要直接用 Claude Code / Codex 打开整个私人知识库，不要花大量时间换主题。先让“写进去、找得到、能连接、能备份”跑通。

新手每日复盘模板

# {{date}} Obsidian 学习复盘

## 今天完成了什么？
- [ ] 我完成了本章的操作
- [ ] 我知道结果应该长什么样
- [ ] 我遇到的问题已经记录

## 今天新建了哪些笔记？
- 

## 今天建立了哪些链接？
- [[示例笔记]]

## 今天最容易忘的一步
- 

## 明天只做一件事
-

🧪 本章细颗粒实操卡：按路线学习

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

不同目标学不同章节。

现在就做

选一条路线并写在日记中。

怎么算成功

知道哪些章节现在可以跳过。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

✅

第 22 章（新增）

每章完成验收卡：学完不是看完，而是能做出来

每一章都给出“完成标准”，新手可以逐章打勾，不会学到一半不知道自己是否成功

✅

使用方法每学完一章，不要急着往下看，先对照验收卡。只要验收卡没有通过，就回到对应章节检查路径、文件夹、设置项或预期结果。这个表也可以复制成一篇 Obsidian 笔记，作为你的学习进度看板。

章节	完成后应当能做到	验收标准	不通过时回看
00 Obsidian 是什么	能说清楚 Obsidian 是本地 Markdown 知识库，不是普通云文档	能解释 Vault、Markdown、双链、图谱四个词	CH00
01 下载与安装	能从可靠来源下载安装 Obsidian	桌面或应用程序中能正常打开 Obsidian	CH01 + 故障排查
02 创建知识库	能创建 Vault 并完成基础设置	左侧出现基础文件夹，附件位置和新笔记位置已设置	CH02
03 界面详解	知道左侧边栏、右侧边栏、设置入口、状态栏在哪里	能打开文件树、搜索、图谱、反向链接、大纲	CH03
04 第一篇笔记	能创建、命名、编辑、自动保存一篇笔记	在 Vault 文件夹里能找到对应 .md 文件	CH04
05 Markdown	能输入标题、列表、待办、引用、代码块、表格	输入示例能正确渲染，不再只显示原始符号	CH05 + 显示问题
06 双链与图谱	能用 [[笔记名]] 建立链接	反向链接面板能看到引用来源，图谱出现节点关系	CH06
07 核心插件	知道哪些核心插件应该开启	日记、模板、快速切换、标签、大纲、反向链接可用	CH07
08 社区插件	能安全开启社区插件并安装必要插件	知道受限模式、插件权限、安装失败原因	CH08 + 插件问题
09 Templater	能区分核心模板和 Templater 模板	能用模板生成带日期、标题、固定结构的新笔记	CH09
10 日记系统	能创建每日笔记并套用日记模板	06-Daily 中出现按日期命名的每日笔记	CH10
11 Dataview	知道 Dataview 是查询笔记属性和任务的工具	能运行一个基础查询并看到结果	CH11
12 笔记组织	能用 Inbox、Projects、Resources、Archives 管理笔记	新笔记有去处，项目资料能通过项目首页连接	CH12
13 快捷键	掌握新建笔记、搜索、快速切换、命令面板等高频快捷键	不用鼠标也能完成 3 个常用动作	CH13
14 同步与备份	能选择适合自己的备份/同步方案	至少有一份 Vault 备份，不把唯一原件放在风险路径	CH14
15 浏览器插件整理	能安装、固定、隐藏、禁用、删除浏览器插件	浏览器工具栏只保留高频插件，扩展页无陌生高权限插件	CH15
16 Web Clipper	能把网页采集进 Obsidian 并整理	Web-Clips 文件夹内有网页笔记，并包含摘要、来源、行动项	CH16
17 Claude Code 协同	能把 Obsidian 需求整理成 Claude Code 可执行任务	任务卡里有目标、不允许改动、输入资料、验收标准	CH17 + AI 协同问题
18-A Codex 桌面界面	能用“进入项目工作”打开项目副本，并让 Codex 先列计划再执行	确认项目路径、权限、任务卡、变更审查、回写记录都完成	CH18-A
18-B Codex CLI	能在终端进入项目目录并运行 Codex CLI	只在项目目录运行，不在完整 Vault 中运行	CH18-B
19 Obsidian URI	能从外部链接跳回指定 Obsidian 笔记	点击 obsidian://open 链接能打开目标 Vault 或笔记	CH19 + URI 问题
20 AI-Handoff	能只交接本次任务资料，不暴露整个 Vault	AI-Handoff 文件夹内有脱敏资料、任务说明、验收清单	CH20
21 学习路线图	能选择自己的路线，不再盲目全学	能明确“今天只做哪一章，哪些章节暂时跳过”	CH21
22 每章验收卡	能判断自己每章是否真正完成	每章至少有一个可见结果或可执行动作	CH22
23 连接其他教程	能把 Claude Code、Codex、课程开发等教程接入总控台	30-Courses 中有统一入口页、教程首页、问题库和模板链接	CH23
24 故障排查	遇到问题知道先查哪里	能按问题类型定位到安装、插件、同步、AI 协同、URI 等排错项	CH24

建议复制到 Obsidian 的学习进度看板

学习进度看板模板

# Obsidian 指南学习进度

## 当前路线
- [ ] 路线 A：个人笔记入门
- [ ] 路线 B：资料采集与课程知识库
- [ ] 路线 C：AI 项目协同工作台

## 本周目标
- 

## 章节验收
- [ ] 00 Obsidian 是什么
- [ ] 01 下载与安装
- [ ] 02 创建知识库
- [ ] 03 界面详解
- [ ] 04 第一篇笔记
- [ ] 05 Markdown
- [ ] 06 双链与图谱
- [ ] 07 核心插件
- [ ] 08 社区插件
- [ ] 09 Templater
- [ ] 10 日记系统
- [ ] 11 Dataview
- [ ] 12 笔记组织
- [ ] 13 快捷键
- [ ] 14 同步与备份
- [ ] 15 浏览器插件整理
- [ ] 16 Web Clipper
- [ ] 17 Claude Code 协同
- [ ] 18-A Codex 桌面界面
- [ ] 18-B Codex CLI 备用流程
- [ ] 19 Obsidian URI
- [ ] 20 AI-Handoff
- [ ] 21 学习路线图
- [ ] 22 每章验收卡
- [ ] 23 连接其他教程
- [ ] 24 故障排查

## 卡住的问题
- 

## 下次只做一件事
-

🧪 本章细颗粒实操卡：用验收判断学会

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

看完不算会，做出来才算会。

现在就做

对照本章勾选 3 个检查项。

怎么算成功

知道卡住时回看哪一章。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🧩

第 23 章（新增）

如何连接其他教程内容：把 Obsidian 做成你的 AI 学习总控台

把浏览器插件、Claude Code、Codex、儿童 AI 课程、成人培训、合同审核、品牌设计等教程统一接入

🧠

核心原则Obsidian 不只是存笔记，而是所有教程的“索引系统”。每一个外部教程都应该有一个入口页、一个学习路线、一套模板、一个问题库、一个成果归档区。这样后期再接入 Claude Code、Codex、浏览器插件、课程开发资料时，不会越积越乱。

推荐总目录结构

📁 MyVault/ ├── 📁 00-Inbox/ ← 临时想法和未整理资料 ├── 📁 01-Projects/ ← 当前正在推进的项目 ├── 📁 03-Resources/ ← 长期参考资料 ├── 📁 20-AI-Projects/ ← 与 Claude Code / Codex 协同的项目 └── 📁 30-Courses/ ← 所有教程内容的总入口 ├── 📁 00-总控台/ │ ├── 📄 我的AI学习总入口.md │ ├── 📄 教程索引.md │ ├── 📄 模板索引.md │ └── 📄 常见问题总表.md ├── 📁 Claude-Code实战教程/ ├── 📁 Codex实战教程/ ├── 📁 浏览器插件与资料采集教程/ ├── 📁 儿童AI课程开发教程/ ├── 📁 成人AI培训教程/ ├── 📁 合同审核与文档生成教程/ └── 📁 品牌设计与提示词教程/

每个教程都要有 5 个固定文件

文件	作用	为什么必须有
`00-课程总览.md`	说明这个教程解决什么问题、适合谁、最终产出什么	防止新手不知道为什么要学
`01-学习路线.md`	把教程拆成 Day 1、Day 2、Day 3 或模块任务	防止内容太多无法行动
`02-实操任务.md`	列出每一节课要完成的具体动作	把“看教程”变成“做任务”
`03-模板库.md`	集中保存提示词、任务卡、验收表、复盘表	方便复制复用，不每次重写
`99-问题库.md`	记录安装失败、操作失败、理解错误、解决方法	后续可以沉淀成自己的知识库 FAQ

教程入口页模板

复制到每个教程文件夹的 00-课程总览.md

# 教程名称

## 这个教程解决什么问题？
一句话说明：这个教程帮助我完成什么具体结果。

## 适合谁？
- [ ] 零基础用户
- [ ] 已经会基础操作的用户
- [ ] 项目实战用户
- [ ] 教师 / 培训机构 / 企业用户

## 前置条件
- 需要安装的软件：
- 需要注册的账号：
- 需要具备的基础能力：
- 可以先跳过的内容：

## 学习路线
1. 第一步：
2. 第二步：
3. 第三步：

## 本教程的最终产出
- [ ] 一个可使用的文件 / 页面 / 系统
- [ ] 一套模板
- [ ] 一套案例
- [ ] 一份复盘记录

## 相关 Obsidian 笔记
- [[我的AI学习总入口]]
- [[AI-Handoff 交接模板]]
- [[Claude-Code-任务模板]]
- [[Codex-开发任务卡]]

## 验收标准
- [ ] 我完成了安装或准备工作
- [ ] 我完成了第一个案例
- [ ] 我知道失败后去哪里查
- [ ] 我能把结果回写到 Obsidian

的 AI 学习总入口模板

30-Courses/00-总控台/我的AI学习总入口.md

# 我的 AI 学习总入口

## 一、基础工具
- [[Obsidian 使用指南]]
- [[浏览器插件与资料采集教程]]
- [[Obsidian Web Clipper 使用流程]]

## 二、AI 编程与项目工具
- [[Claude-Code实战教程/00-课程总览]]
- [[Codex实战教程/00-课程总览]]
- [[AI-Handoff 交接区]]

## 三、业务教程
- [[儿童AI课程开发教程/00-课程总览]]
- [[成人AI培训教程/00-课程总览]]
- [[合同审核与文档生成教程/00-课程总览]]
- [[品牌设计与提示词教程/00-课程总览]]

## 四、常用模板
- [[网页采集整理模板]]
- [[Claude Code 任务说明模板]]
- [[Codex 开发任务卡模板]]
- [[课程设计复盘模板]]

## 五、当前正在推进
- [ ] 本周主线：
- [ ] 当前项目：
- [ ] 本周要输出的文件：

## 六、问题库
- [[常见问题总表]]
- [[插件安装问题]]
- [[同步与备份问题]]
- [[AI 工具协同问题]]

外部教程接入 SOP

先判断这个教程属于哪一类

不要所有资料都塞进 03-Resources。能够产生项目成果的教程，放入 30-Courses；正在执行的项目，放入 01-Projects 或 20-AI-Projects；单篇参考资料，才放入 03-Resources。

创建教程文件夹和 5 个固定文件

每个教程都必须有“总览、路线、任务、模板、问题库”。没有这 5 个文件，后期资料会越来越散，新手也不知道从哪里开始。

把旧资料迁移进去，但不要原封不动堆进去

从网页、PDF、聊天记录、AI 输出中迁移内容时，必须补上：来源、用途、适用场景、下一步动作。只保存内容，不写用途，等于把 Obsidian 变成仓库而不是系统。

建立教程之间的链接

例如 Claude Code 教程应链接到 AI-Handoff 模板，Codex 教程应链接到开发任务卡，儿童 AI 课程应链接到提示词模板和素材采集教程。

每周复盘一次，删除无用入口

教程连接不是越多越好。每周检查一次：哪些教程正在用，哪些只是收藏，哪些应该归档。长期不使用的教程移入 04-Archives。

可以连接的教程类型与连接方式

教程类型	放在哪	必须连接到	推荐输出物
Claude Code 实战教程	`30-Courses/Claude-Code实战教程`	AI-Handoff、项目需求、验收清单	HTML 页面、代码修改记录、项目复盘
Codex 实战教程	`30-Courses/Codex实战教程`	Codex 开发任务卡、Git 备份说明	开发任务卡、修改摘要、测试结果
浏览器插件教程	`30-Courses/浏览器插件与资料采集教程`	Web Clipper、网页采集模板、插件权限表	插件清单、网页资料库、整理规则
儿童 AI 课程开发	`30-Courses/儿童AI课程开发教程`	课程设计模板、家长交付物、课堂流程	课件、课堂话术、作品模板、招生素材
成人 AI 培训	`30-Courses/成人AI培训教程`	业务场景、案例库、提示词库	培训大纲、实操任务、销售转化材料
合同审核与文档生成	`30-Courses/合同审核与文档生成教程`	合同压力测试模板、风险清单、输出格式规范	HTML 审核报告、DOCX 合同文本、风险复盘
品牌设计与提示词	`30-Courses/品牌设计与提示词教程`	视觉提示词、评估标准、版本记录	Logo 提示词、海报提示词、品牌说明文档

🔗

连接原则每个教程至少连接 3 类内容：入口页、模板页、问题库。能连接到项目成果的，再增加项目页。不要只建立“收藏链接”，要建立“行动链接”。

🧪 本章细颗粒实操卡：连接其他教程

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

Obsidian 可以做课程总控台。

现在就做

创建《我的 AI 学习总入口》。

怎么算成功

能把一个外部教程接入固定结构。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

💡

第 24-A 章（新增）

新手常见误解纠正：把容易走偏的地方提前拦住

不是学更多，而是少踩坑

❌ 错误理解

Obsidian 越多插件越强。
图谱越漂亮，知识体系越好。
必须一次搭好完美文件夹。
双链就是随便把所有笔记互相链接。
本地 Codex CLI 等于完全离线。
Claude Code 和 Codex 可以同时改同一批文件。

✅ 正确理解

第一周少插件，先养成记录习惯。
图谱只是检查工具，不是最终成果。
文件夹可以随着使用慢慢调整。
双链应该表达真实关系：原因、来源、应用、反例。
本地 CLI 是在本机目录执行，但仍可能调用在线服务。
一个任务只让一个 AI 工具执行，另一个只做审查。

自查练习：学习路径自查

如果已经装了超过 10 个插件，但还没有写 10 篇笔记：先停下，回到写笔记。
如果一直在改主题，但没有使用日记：先停下，写今天的日记。
如果希望让 AI 直接读取整个 Vault：先停下，建立 AI-Handoff 文件夹。

🧪 本章细颗粒实操卡：纠正常见误区

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

少折腾，多写真实内容。

现在就做

写下自己最容易踩的 3 个坑。

怎么算成功

能解释为什么第一周不装太多插件。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

🔨

第 24 章（扩展专章）

故障排查完整手册

60+ 常见问题逐一解答，新增学习路线、教程连接、浏览器插件与 AI 协同排错

安装与启动问题

❓ Obsidian 安装后无法启动，双击没有反应

• 检查是否有杀毒软件拦截：临时关闭360/Windows Defender，再试启动
• 检查安装路径是否含有中文或特殊符号，如有请重新安装到纯英文路径
• 在任务管理器检查是否有 Obsidian 进程已在后台运行，如有先结束进程

❓ 界面显示英文，按教程找不到 Language 选项

• 点击左下角齿轮图标 → 点击左侧第一项"General" → 右侧区域向下滚动 → Language 选项大约在页面中部
• 如果真的看不到，按 Ctrl+P 输入 language 搜索，选择"Change interface language"

知识库与文件问题

❓ 打开 Obsidian 后知识库不见了，显示欢迎界面

• 点击"以文件夹作为知识库打开" → 导航到你之前创建 Vault 的位置（如 D:\MyVault）→ 点击选择
• 如果文件夹确实不见了，检查回收站，或搜索文件名为 .obsidian 的隐藏文件夹

❓ 笔记内容丢失了

• 大多数情况是文件被移到了其他位置：在全局搜索中搜索你记得的内容关键词
• 检查 .obsidian/trash 文件夹（如果有的话）
• 如果配置了 Git 备份，可以从 GitHub 历史版本恢复
• 检查 OneDrive/iCloud 的版本历史（如果存放在这些位置）

❓ 笔记重命名后原来的链接都断了（显示红色）

• 重命名时弹出"是否更新所有链接"的提示，可能点了取消。补救方法：
1. 打开该笔记，复制其现在的名称
2. 用全局搜索（Ctrl+Shift+F）搜索旧名称
3. 在搜索结果中用"全部替换"将旧名替换为新名

插件问题

❓ 打开社区插件浏览页面一直转圈（无法加载）

• 这是因为插件市场服务器在 GitHub，国内需要代理访问
• 无代理解决方案：使用第08章"方法二手动安装"，从 pkmer.cn 下载插件文件手动安装
• 有代理：确保系统代理已开启，Obsidian 会跟随系统代理

❓ Templater 模板变量没有被替换（显示原始代码如 <% tp.date.now() %>）

• 确认：已安装并启用 Templater 插件
• 确认：Templater 设置中"模板文件夹"路径与你的 Templates 文件夹名完全一致（区分大小写）
• 手动触发替换：Ctrl+P → 搜索"Templater: Replace templates in active file" → 执行
• 在 Templater 设置中开启"Trigger Templater on new file creation"

❓ Dataview 代码块显示"No results to show"

• FROM 路径检查：确认文件夹名大小写完全一致，如 FROM "Projects" 要确保文件夹名就是 Projects
• WHERE 条件检查：确认 Front Matter 中的字段名与查询中使用的完全一致
• 日期字段：YAML 中日期不能加引号，格式必须是 2026-05-26 而非 "2026-05-26"
• 尝试先删除 WHERE 和 FROM 限制，只保留 LIST FROM "" 测试基本查询是否工作

❓ 插件开启后 Obsidian 变卡变慢

• 排查是哪个插件导致的：关闭最近安装的插件，逐一测试
• Dataview 查询过多：减少 Dataview 代码块数量，特别是 FROM "" 全库查询
• 社区插件超过20个时建议禁用不常用的
• 关闭不必要的侧边栏面板

同步问题

❓ 手机和电脑的笔记内容不一致（出现重复或冲突文件）

• 同时在两端编辑同一文件会产生冲突：修改后等同步完成再在另一端操作
• 坚果云会生成"冲突副本"文件，内容是旧版本，手动合并后删除副本
• Obsidian Sync：在同步面板查看冲突详情，选择保留哪个版本

❓ 坚果云 WebDAV 连接失败

• 检查应用密码是否正确（应用密码不是登录密码）
• 服务器地址必须是 https://dav.jianguoyun.com/dav/（结尾有斜杠）
• 用户名是你的坚果云注册邮箱（完整邮箱地址）
• 网络问题：尝试切换 WiFi 或 4G

显示与界面问题

❓ 笔记中的 Markdown 语法没有渲染，显示原始符号

• 确认当前不是"源码模式"：右上角书本图标下拉 → 选"实时预览"
• 或按 Ctrl+E 切换到实时预览模式

❓ 粘贴图片后显示为文件路径而非图片

• 直接 Ctrl+V 粘贴截图，Obsidian 会自动保存图片文件并插入链接
• 如果图片没有正确显示，检查附件文件夹是否存在，或在设置中确认附件保存路径设置正确

❓ 关系图谱是空的

• 图谱需要笔记之间有 [[链接]] 才能显示连线。新库没有链接时图谱是孤立的节点
• 确认已创建了多篇笔记，且笔记之间有相互链接
• 检查图谱设置（右上角滑块）中"文件"过滤器是否过于严格

❓ 字体太小或界面太密，眼睛不舒服

• 整体缩放：Ctrl+= 放大，Ctrl+- 缩小
• 仅调整字体大小：设置 → 外观 → 字体大小，拖动滑块
• 行间距和段间距：安装 Style Settings 插件，配合主题调整

浏览器插件与网页采集问题

❓ 安装了 Web Clipper，但点了没有反应

• 先确认 Obsidian 已经打开，并且目标 Vault 已经打开
• 检查浏览器是否弹出“允许打开 Obsidian”的提示，如果之前点了拒绝，需要在浏览器设置中恢复协议调用权限
• 换一个普通网页测试，部分网站会阻止正文提取
• 在扩展管理页确认插件已启用，没有被浏览器禁用

❓ 网页保存进 Obsidian 后格式很乱

• 优先保存“选中内容”而不是整篇网页
• 使用采集模板，只保存标题、URL、摘要、关键摘录和自己的理解
• 对广告多、结构复杂的网站，先复制核心段落到 Obsidian，再手动整理

❓ 浏览器插件太多，工具栏很乱

• 只固定每天都会用的插件
• 进入 chrome://extensions 或 edge://extensions，关闭 30 天没用过的插件
• 每月检查一次权限，删除用途不明、权限过大的插件

Claude Code / Codex 协同问题

❓ Claude Code 或 Codex 改动范围太大

• 任务卡里必须写“不允许改动”清单
• 启动前要求它先列出计划和准备修改的文件
• 如果项目有 Git，先看 diff，再决定是否接受
• 下次提示中加入“只修改指定文件，不做重构”

❓ AI 读取了不该读取的私人资料

• 不要在整个私人 Vault 根目录启动代码 Agent
• 建立 AI-Handoff 文件夹，只放本次任务需要的材料
• 交接前删除手机号、邮箱、身份证号、Token、客户信息
• 对已经泄露到任务材料中的敏感信息，立即更换密码或 Token

❓ AI 修改结果看起来能用，但我不确定有没有破坏页面

• 用浏览器打开 HTML 文件，逐个点击侧边栏目录测试锚点
• 缩小浏览器宽度，检查手机端布局是否仍可读
• 搜索新增章节 ID，确认目录链接和章节 ID 一致
• 把修改前文件保留一份，必要时直接回滚

❓ Obsidian URI 点击后打不开对应笔记

• 检查 Vault 名称是否完全一致
• 检查 file 参数是否从 Vault 根目录开始写
• 中文路径可能需要 URL 编码，先用英文文件名测试
• 文件移动或改名后，旧 URI 会失效，需要重新生成

学习路线与教程连接问题

❓ 教程太长，我不知道从哪里开始

• 不要从头到尾硬看，先去第21章选择路线
• 只做 7 天最小学习计划，第一天只安装和建库
• 如果目标只是写笔记，Claude Code / Codex / Dataview 都可以先跳过
• 每章学完后用第22章验收卡判断是否完成

❓ 我想把其他教程也放进 Obsidian，但越放越乱

• 统一放进 30-Courses，不要散落在 Inbox 和 Resources
• 每个教程必须有 00-课程总览、01-学习路线、02-实操任务、03-模板库、99-问题库
• 用“我的AI学习总入口.md”做总控台，不要靠文件夹层级硬找
• 每周把长期不用的教程移入 04-Archives

❓ 我不知道一个内容应该放 Projects、Resources 还是 Courses

• 正在推进并有交付结果：放 01-Projects
• 长期参考资料、网页文章、读书笔记：放 03-Resources
• 有学习路线、任务、模板、问题库的系统教程：放 30-Courses
• 需要交给 Claude Code / Codex 执行的项目资料：放 20-AI-Projects

❓ 我连接了很多笔记，但感觉没有用

• 检查链接是否能支持行动：能不能帮你找到模板、执行任务、回到项目？
• 删除只为好看而建立的链接
• 每个教程首页至少链接“模板库、问题库、相关项目、验收标准”
• 每个项目首页至少链接“需求、资料、任务卡、修改记录、复盘”

🧪 本章细颗粒实操卡：遇错能自救

1 先知道为什么 2 再照做一次 3 看预期结果 4 失败就回退 5 勾选验收

为什么要学

先看现象，再定位原因，再做回退。

现在就做

遇到一个小问题时查故障排查。

怎么算成功

知道先备份再尝试修复。

失败时先查

是否做错了文件夹或路径？
是否少按了一次确认/保存/重启？
是否把进阶步骤提前做了？
先回到本章第一个最小案例，不要继续叠加复杂度。

Obsidian从零到可实操完全指南

30分钟体验课

7天入门训练

30天进阶任务

体验课目标

Markdown 练习完成样例

双链练习完成样例

Web Clipper 练习完成样例

Codex / Claude Code 练习完成样例

Obsidian 新手入门

Obsidian Web Clipper

Claude Code

Codex 桌面界面

Windows 版 Codex App

终端 / PowerShell 基础

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

现在就做

怎么算成功

失败时先查

为什么要学

Obsidian
从零到可实操完全指南