Obsidian知识管理学习手册

发表于 2026-05-05 更新于 2026-05-17 分类于工具使用阅读次数：本文字数： 7.8k 阅读时长 ≈ 29 分钟

Obsidian知识管理学习手册

文档核心说明

本文档适用于希望系统掌握 Obsidian 知识管理工具的用户，从零基础入门到高级项目实践全覆盖。包含 Obsidian 核心功能、工作流设计、插件生态、以及基于 Obsidian 实现 LLM Wiki 知识编译系统的完整方案。所有内容均经过去重优化，按照学习认知逻辑重新组织，可直接作为学习手册使用。

一、基础入门

1.1 什么是 Obsidian

Obsidian 是一款基于本地纯 Markdown 文件的非线性知识管理软件，被誉为 "第二大脑"。它与传统笔记软件最大的区别在于：

本地优先：所有笔记都以 \.md 格式存储在你的电脑上，永远属于你，不联网也能使用
双向链接：这是 Obsidian 的灵魂，让笔记从孤立的文件变成相互连接的知识网络
高度可定制：拥有庞大的插件生态系统，几乎可以满足任何知识管理需求
知识图谱：可视化展示笔记之间的连接关系，帮助你发现知识间的潜在联系

1.2 下载安装与初始设置

1.2.1 下载安装

访问官方网站：https://obsidian.md
点击 "Download" 下载适合你操作系统的版本（支持 Windows/macOS/Linux/iOS/Android）
运行安装程序，按提示完成安装

1.2.2 创建第一个笔记库（Vault）

笔记库本质上就是你电脑上的一个普通文件夹，Obsidian 会管理这个文件夹里的所有 Markdown 文件。

首次打开 Obsidian，你会看到欢迎界面
点击 "创建新的笔记库" 按钮
选择一个存放位置（建议放在 iCloud Drive、OneDrive 等云同步目录）
为你的笔记库命名（如 "我的知识库"、"MyBrain"）
点击 "创建"

重要避坑：不要把笔记库放在 Dropbox 上，Dropbox 的文件锁机制与 Obsidian 的本地文件读写存在冲突，可能导致同步丢失问题

1.2.3 基础设置优化

切换中文界面：设置 → 关于 → 语言 → 选择 "中文（简体）"
编辑器设置：
- 开启 "实时预览" 模式（Obsidian 默认的编辑模式）
- 开启 "自动保存"
- 调整字体大小和行高以获得舒适的阅读体验
文件设置：
- 设置默认新笔记的位置
- 设置附件文件夹（建议统一放在 "Attachments" 文件夹）
- 开启 "自动更新内部链接"

1.3 核心概念详解

1.3.1 双向链接（Backlinks）

双向链接是 Obsidian 最核心的功能。当你在笔记 A 中创建指向笔记 B 的链接时：

笔记 A 中显示一个出链指向 B
笔记 B 中自动显示一个入链（反向链接）来自 A

这种双向可见性让你不仅能看到当前笔记链接到了哪里，还能看到哪些笔记提到了当前笔记，从而形成一个有机的知识网络

1.3.2 原子化笔记

原子化笔记是指每条笔记只记录一个独立、完整的观点、概念或事实。这是 Zettelkasten 卡片盒笔记法的核心原则。

优点：

更容易被其他笔记引用
更容易找到和复用
知识网络会更加清晰和有意义

1.3.3 知识图谱（Graph View）

知识图谱将你的所有笔记显示为节点，笔记之间的链接显示为连线。通过图谱视图，你可以：

直观地看到整个知识库的结构
发现知识间的潜在联系
识别出你的核心概念（中心度高的节点）

1.3.4 前哨站笔记（MOCs - Maps of Content）

MOCs 是一种特殊的笔记，它不记录具体的知识，而是作为一个主题的 "目录" 或 "地图"，链接到该主题下的所有相关笔记。

MOCs 解决了纯链接网络缺乏结构的问题，让你能够在保持知识网络灵活性的同时，拥有清晰的主题组织

1.4 基本操作指南

1.4.1 创建与编辑笔记

创建笔记：

点击左侧文件列表上方的 "新建笔记" 图标
使用快捷键：Ctrl \+ N（Windows/Linux）或 Cmd \+ N（Mac）
使用命令面板：Ctrl \+ P → 输入 "新建笔记"

Markdown 常用语法：

语法	效果
`\# 标题1`	一级标题
`\#\# 标题2`	二级标题
`\\粗体\\`	粗体
`\斜体\`	斜体
`\- 列表项`	无序列表
`1\. 列表项`	有序列表
`\- \[ \] 任务`	未完成任务
`\- \[x\] 任务`	已完成任务
`\> 引用`	引用文本
`\`代码``	行内代码
`代码块`	代码块

1.4.2 创建链接

内部链接：

输入两个左方括号 \[\[，系统会自动弹出笔记列表供你选择
按 Enter 键确认创建链接
按住 Ctrl 键（Mac 为 Cmd 键）点击链接可以跳转到目标笔记

链接到笔记的特定部分：

\[\[笔记名称\#标题\]\] 链接到笔记中的特定标题
\[\[笔记名称^块ID\]\] 链接到笔记中的特定段落

创建未存在笔记的链接：
你可以先创建指向一个还不存在的笔记的链接，点击这个链接就会自动创建该笔记。这是一种非常有效的 "先有想法，后补内容" 的工作方式

外部链接：

\[链接文字\]\(https://example\.com\) 创建指向外部网站的链接

1.4.3 搜索与导航

全局搜索：

快捷键：Ctrl \+ Shift \+ F
支持搜索笔记内容、标题、标签
支持 or、and、\(\) 等逻辑运算符进行精确搜索

快速切换笔记：

快捷键：Ctrl \+ O
输入笔记名称的一部分即可快速找到并打开

命令面板：

快捷键：Ctrl \+ P
可以执行 Obsidian 的几乎所有操作，是提升效率的关键工具

1.4.4 标签与文件夹

标签：

在笔记中输入 \#标签名 即可创建标签
标签可以嵌套：\#标签/子标签
点击标签可以查看所有包含该标签的笔记

文件夹：

虽然 Obsidian 强调链接思维，但文件夹仍然是组织笔记的有用工具
建议保持极简的文件夹结构，不要创建过多层级
推荐的基础文件夹结构：
- Attachments：存放图片、文件等附件
- Daily：存放每日笔记
- Templates：存放模板
- Permanent：存放永久笔记

二、核心工作流与笔记方法

2.1 主流笔记方法

2.1.1 Zettelkasten 卡片盒笔记法

Zettelkasten 是德国社会学家尼克拉斯・卢曼发明的知识管理方法，他用这个方法在 30 年里产出了 70000 多张卡片和 58 本著作。

核心原则：

原子化：每条笔记只记录一个想法
用自己的话写：不要只是复制粘贴
建立链接：每条笔记都要链接到其他相关笔记
添加上下文：在链接时说明为什么这两条笔记相关

三种笔记类型：

闪念笔记（Fleeting Notes）：临时记录想法，24 小时内处理
文献笔记（Literature Notes）：记录你从书籍、文章等来源学到的内容
永久笔记（Permanent Notes）：你自己的思考和见解，是知识库的核心

2.1.2 PARA 方法

PARA 是 Tiago Forte 提出的一种通用信息组织方法，将所有信息分为四类：

Projects（项目）：有明确目标和截止日期的任务
Areas（领域）：你生活中需要长期负责的方面
Resources（资源）：你感兴趣的主题和有用的信息
Archives（档案）：已经完成或不再活跃的项目和资源

Obsidian 中的 PARA 实现：

用标签而不是文件夹来实现 PARA 分类
用 Dataview 自动生成每个分类的列表
用周期笔记进行定期回顾

2.1.3 混合工作流推荐

对于大多数人来说，纯 Zettelkasten 或纯 PARA 都不是最佳选择，推荐使用混合工作流：

用 PARA 管理执行：项目、任务、日常事务
用 Zettelkasten 管理知识：学习、思考、见解
用 MOCs 连接两者：创建主题地图，将执行和知识联系起来
用周期笔记进行回顾：每日、每周、每月回顾，不断优化系统

2.2 高级技巧与进阶功能

2.2.1 YAML Frontmatter

YAML Frontmatter 是写在笔记开头的一段元数据，用三个短横线包裹：

---
title: "Obsidian使用教程"
date: 2026-05-11
tags: ["Obsidian", "知识管理", "教程"]
status: "已完成"
---

元数据可以被 Dataview 等插件读取和查询，是实现自动化的关键

2.2.2 嵌入笔记与块引用

嵌入整个笔记：

\!\[\[笔记名称\]\] 将另一个笔记的内容嵌入到当前笔记中

嵌入笔记的一部分：

\!\[\[笔记名称\#标题\]\] 嵌入笔记中的特定标题部分
\!\[\[笔记名称^块ID\]\] 嵌入笔记中的特定段落

2.2.3 工作区管理

工作区允许你保存和切换不同的界面布局：

保存当前布局：Ctrl \+ P → "保存工作区"
切换工作区：Ctrl \+ P → "加载工作区"
常用工作区：写作模式、阅读模式、图谱模式、白板模式

2.2.4 主题与 CSS 代码片段

Obsidian 支持自定义主题和 CSS 代码片段，可以完全改变软件的外观：

安装主题：设置 → 外观 → 主题 → 浏览
使用 CSS 代码片段：在笔记库的 \.obsidian/snippets 文件夹中放入 CSS 文件，然后在设置中启用

2.3 同步与备份方案

2.3.1 官方同步服务（Obsidian Sync）

优点：与 Obsidian 深度集成，同步速度快，支持端到端加密
缺点：需要付费
适用人群：追求稳定性和安全性的用户

2.3.2 云盘同步

推荐：iCloud Drive（苹果生态）、OneDrive
优点：免费，使用简单
缺点：可能存在同步冲突
注意：不要使用 Dropbox

2.3.3 Git 同步

优点：免费，版本控制功能强大
缺点：有一定学习曲线
推荐插件：Obsidian Git，可以自动提交和推送更改

三、插件生态系统

3.1 插件选择黄金原则

在开始之前，请记住这三条原则，避免陷入 "插件地狱"：

少即是多：只安装你真正需要的插件，每增加一个插件都会消耗性能
先基础后进阶：先掌握核心功能和必装插件，再尝试高级插件
定期清理：每 3 个月检查一次，卸载不再使用的插件

3.2 核心必装插件（所有用户必备）

这些插件是 Obsidian 的 "灵魂伴侣"，没有它们，Obsidian 的体验会大打折扣。

插件名称	核心功能	适用人群
Templater	比自带模板强大 10 倍，支持动态变量、脚本和条件逻辑	所有人
Dataview	将笔记库变成可查询的数据库，用类似 SQL 的语法提取信息	所有人，特别是笔记超过 100 篇的用户
Calendar	侧边栏月历视图，点击日期即可打开或创建对应日记	所有人
Linter	保存时自动整理格式，统一空行、修复标题层级、规范 YAML	所有人，特别是注重格式规范的用户
QuickAdd	一键创建特定类型的笔记并自动应用模板	所有人

3.3 分类插件推荐

3.3.1 写作与编辑增强

插件名称	核心功能	适用人群
Metadata Menu	可视化元数据编辑，不用手写 YAML	重度使用 Dataview 的用户
Note Refactor	一键拆分笔记、提取内容、合并笔记、批量移动文件	有大量笔记需要整理的用户
Obsidian Web Clipper	Chrome 浏览器插件，一键保存网页内容到 Obsidian	经常在网上学习和收集资料的用户
Zotero Integration	与 Zotero 无缝集成，一键插入引用、生成参考文献	学生、研究人员、学术工作者

3.3.2 知识组织与管理

插件名称	核心功能	适用人群
Periodic Notes	扩展日记概念，支持周记、月记、季记、年记	所有人，特别是注重复盘和规划的用户
Tag Wrangler	批量重命名、合并、重构标签系统	标签数量超过 50 个的用户
Notebook Navigator	将文件夹、标签、属性整合到一个侧边栏，支持属性浏览器	所有用户
MOC Generator	根据标签或文件夹自动生成 MOC（内容地图）笔记	有大量主题笔记的用户

3.3.3 任务与项目管理

插件名称	核心功能	适用人群
Tasks	增强任务管理功能，支持截止日期、优先级、重复任务	所有人，特别是用 Obsidian 做 GTD 的用户
Project Browser	替代新标签页，显示项目列表和进度，快速切换工作区	同时管理多个项目的知识工作者
Sentinel	自动更新笔记属性，基于状态执行命令	追求极致自动化的用户

3.3.4 数据与自动化

插件名称	核心功能	适用人群
DataviewJS	Dataview 的 JavaScript 版本，支持更复杂的查询和可视化	有 JavaScript 基础的高级用户
Button	在笔记中添加可点击的按钮，执行各种操作	喜欢自定义界面的用户
Advanced Tables	自动格式化表格，支持排序、计算、合并单元格	经常使用表格的用户

3.3.5 可视化与白板

插件名称	核心功能	适用人群
Excalidraw	手绘风格白板环境，绘制思维导图、流程图、概念图	所有人，特别是视觉型学习者
Canvas	官方白板功能，自由拖拽笔记、图片、链接	所有人
Graph Analysis	增强知识图谱功能，显示节点中心度、社区检测等分析数据	有大量笔记的高级用户

3.3.6 AI 增强类（2026 年最火）

插件名称	核心功能	适用人群
Claudian	深度集成 Claude AI，支持知识库上下文理解	所有 AI 用户，特别适合长文本处理
Agent Client	支持 Claude Code、Codex、Gemini CLI 等 AI 代理	开发者、技术人员
LLM Tagger	使用 AI 自动为笔记生成标签和元数据	有大量未分类笔记的用户
PromptCrafter	创建和管理可复用的模块化提示词	经常使用 AI 的用户

3.3.7 同步与备份

插件名称	核心功能	适用人群
Obsidian Git	用 Git 给笔记库做版本控制，自动提交和推送	所有用户，特别是有 Git 基础的用户
Nutstore Sync	坚果云官方出品的同步插件，支持增量同步和冲突处理	国内用户，特别是使用坚果云的用户
Obsidian Sync	官方同步服务，端到端加密	追求稳定性和安全性的用户

3.3.8 效率与导航

插件名称	核心功能	适用人群
Recent Files	在侧边栏显示最近打开的笔记列表，支持固定重要文件	有大量笔记的用户
Quick Explorer	用纯键盘方式快速浏览和切换文件	键盘流用户
Commander	创建自定义命令，将常用操作绑定到快捷键或工具栏	追求效率的高级用户
Pane Relief	增强窗格管理功能，支持快捷键切换、移动、关闭窗格	经常使用多窗格的用户

3.3.9 被低估的宝藏插件

插件名称	核心功能	适用人群
Style Settings	不用写 CSS，通过图形界面自定义主题的颜色、字体、间距	所有用户，特别是视觉控
Copy Block Link	一键复制指向特定段落的块链接	经常需要引用笔记内容的用户
Numerals	将任何代码块变成高级计算器，支持单位、货币和数学表达式	经常需要做计算的用户
Another Name	显示多个每日笔记的大纲，整合不同日期的内容	写每日笔记的用户

3.4 新手插件安装建议

第一阶段（第 1-2 周）：基础必装

Templater
Dataview
Calendar
Linter
QuickAdd

第二阶段（第 3-4 周）：效率提升

Periodic Notes
Tasks
Recent Files
Obsidian Git
Excalidraw

第三阶段（第 2 个月及以后）：按需添加

Metadata Menu
Notebook Navigator
Zotero Integration（学术党）
Claudian（AI 用户）
其他你真正需要的插件

四、LLM Wiki 高级项目

4.1 核心架构设计

4.1.1 LLM Wiki 核心理念

LLM Wiki 不是传统的 RAG 系统，而是将知识提前编译成结构化、相互链接的 Markdown 知识库：

知识编译一次，反复复用：避免每次查询都重新扫描原始文档
纯文件系统：没有向量数据库、没有嵌入模型、没有复杂的检索管道
人机协作：人负责策划信息源和决策，AI 负责整理、链接和维护
面向 AI 友好：结构化的 Markdown 格式对 LLM 极其友好，可直接作为 AI Agent 的长期记忆

4.1.2 三层架构模型

Text

你的 Obsidian 笔记库/
├── raw/          # 第一层：原始资料（AI 只读，永不修改）
├── wiki/         # 第二层：AI 维护的结构化知识库（核心）
└── schema/       # 第三层：模板和提示词规范（定义生成逻辑）

4.1.3 Obsidian 作为前端的独特优势

原生双向链接：完美支持 LLM 生成的交叉引用
知识图谱可视化：直观展示知识网络结构和连接关系
Dataview 查询引擎：将 Wiki 变成可查询的数据库
插件生态系统：提供丰富的扩展能力
本地优先：数据完全属于你，支持离线使用
Git 版本控制：轻松追踪 AI 生成内容的变化

4.2 标准目录结构

Text

LLM-Wiki-Vault/
├── raw/                          # 原始资料（不可变）
│   ├── articles/                 # 网络文章
│   ├── papers/                   # 学术论文
│   ├── books/                    # 书籍笔记
│   ├── meetings/                 # 会议记录
│   └── personal/                 # 个人想法和闪念笔记
├── wiki/                         # AI 生成的结构化知识库
│   ├── sources/                  # 源文件摘要（事实性内容）
│   ├── concepts/                 # 概念定义和解释
│   ├── entities/                 # 人物、组织、产品等实体页面
│   ├── synthesis/                # 跨源综合分析和观点
│   ├── queries/                  # 历史问答记录
│   ├── .drafts/                  # 草稿目录（待审核）
│   ├── index.md                  # 全局索引和导航
│   ├── log.md                    # 操作日志（AI 自动更新）
│   └── overview.md               # 知识库总览
├── schema/                       # 模板和提示词
│   ├── source-summary.md         # 源文件摘要模板
│   ├── concept-page.md           # 概念页面模板
│   ├── entity-page.md            # 实体页面模板
│   ├── synthesis-page.md         # 综合分析模板
│   └── system-prompt.md          # 全局系统提示词
├── assets/                       # 图片和附件
└── .obsidian/                    # Obsidian 配置和插件

4.3 两种主流实现方式

4.3.1 方式一：CLI 工具 + Obsidian（推荐）

使用专门的 obsidian\-llm\-wiki CLI 工具，这是目前最成熟、自动化程度最高的方案。

安装与配置：

# 安装 CLI 工具
pip install obsidian-llm-wiki

# 初始化新的 LLM Wiki
olw init ~/LLM-Wiki-Vault

# 配置 API 密钥
olw config set openai.api_key YOUR_API_KEY
# 或使用 Claude
olw config set anthropic.api_key YOUR_ANTHROPIC_API_KEY
olw config set model claude-3-5-sonnet-20240620

核心功能：

文件监听：运行 olw watch 后，任何丢进 raw/ 的文件都会自动处理
增量编译：只重新编译受影响的页面，不是整个知识库
草稿审核：AI 生成的内容先放在 wiki/\.drafts/，审核通过后再发布
手动编辑保护：如果你手动修改了 Wiki 页面，CLI 会检测到并跳过它
健康检查：定期扫描整个 Wiki，修复断链、处理信息不一致
查询功能：olw query \&\#34;什么是 LLM Wiki?\&\#34; 直接从 Wiki 回答问题

工作流：

将任何资料（文章、论文、笔记）丢进 raw/ 对应的子文件夹
CLI 自动检测新文件，进行分析和提取
AI 生成源文件摘要、概念页面和实体页面
你在 Obsidian 中审核草稿，修改或批准
批准后的页面自动移动到 wiki/ 对应的位置
全局索引和操作日志自动更新

4.3.2 方式二：纯 Obsidian 插件（零代码）

使用 Claudian 插件直接在 Obsidian 内部实现 LLM Wiki，不需要任何命令行操作。

核心插件安装：

安装 Claudian 插件（Claude 深度集成）
安装 Dataview 插件（数据查询）
安装 Metadata Menu 插件（元数据编辑）
安装 Obsidian Git 插件（版本控制）

核心文件配置：
在笔记库根目录创建 CLAUDE\.md 文件，这是 AI 的 "操作手册"，完整内容见模板包。

工作流：

将资料丢进 raw/ 文件夹
在 Claudian 聊天框中输入："处理这个新文件：[[raw / 文件名]]"
AI 会自动分析文件，生成相应的 Wiki 页面
你在 Obsidian 中审核和修改生成的内容
定期让 AI 运行健康检查："扫描整个 Wiki，找出断链和信息不一致的地方"

4.4 页面标准与元数据规范

4.4.1 标准 YAML Frontmatter

所有 Wiki 页面都必须包含以下元数据，这是实现自动化和查询的基础：

---
title: "LLM Wiki"
type: "concept"  # 可选：source, concept, entity, synthesis, query
status: "published"  # 可选：draft, published, archived
ai_generated: true
explored: false  # 你是否已经审核过这篇文章
confidence: "high"  # 可选：low, medium, high
sources:
  - "[[raw/llm-wiki-karpathy.md]]"
  - "[[raw/obsidian-llm-wiki.md]]"
created_at: 2026-05-11
updated_at: 2026-05-11
tags:
  - wiki/concept
  - knowledge-management
---

4.5 插件配置与优化

4.5.1 必装插件与配置

插件名称	用途	关键配置
Dataview	数据查询和仪表盘	开启 "实时预览" 和 "内联查询"
Claudian	AI 集成	配置 API 密钥，设置默认模型为 Claude 3.5 Sonnet
Metadata Menu	元数据编辑	为不同页面类型创建对应的元数据模板
Obsidian Git	版本控制	设置自动提交间隔为 10 分钟
Graph Analysis	图谱分析	开启节点中心度计算，按中心度调整节点大小
Linter	自动格式化	开启 "保存时自动格式化"，只启用必要的规则

4.5.2 核心仪表盘示例

使用 Dataview 创建一个 LLM Wiki 管理仪表盘，放在 wiki/index\.md：

# 待审核的草稿
LIST FROM "wiki/.drafts" WHERE status = "draft"
SORT created_at DESC

# 最近发布的页面
LIST FROM "wiki" WHERE status = "published"
SORT updated_at DESC
LIMIT 10

# 未探索的页面
LIST FROM "wiki" WHERE explored = false
SORT created_at DESC

# 按类型统计
TABLE length(rows) as 数量
FROM "wiki"
WHERE type != null
GROUP BY type

4.6 最佳实践与避坑指南

4.6.1 内容质量控制

先小后大：从一个专注的主题开始，不要一开始就导入所有资料
审核是关键：AI 会犯错，你必须审核所有生成的内容
添加个人笔记：在每个页面的 "个人笔记" 部分添加你自己的理解和见解
使用置信度标记：根据支持的来源数量标记文章的置信度
定期回顾：每周花 30 分钟回顾新生成的页面，标记为已探索

4.6.2 性能优化

限制并发：CLI 工具默认同时处理 2 个文件，不要调得太高
分批处理：如果有大量旧资料需要导入，分批处理，每次 10-20 个文件
关闭不必要的插件：只保留你真正需要的插件
使用 SSD：将笔记库放在 SSD 上可以显著提高性能
定期清理：删除不需要的草稿和临时文件

4.6.3 数据安全与备份

使用 Git 版本控制：每次导入新资料后提交一次
多备份策略：同时使用云同步和本地备份
不要存储敏感信息：Wiki 中不要包含密码、个人隐私等敏感内容
定期导出：每月导出一次整个笔记库作为备份

4.6.4 常见问题解决

AI 创建重复页面：在系统提示词中强调优先使用已有的概念页面
断链问题：定期运行 olw lint 命令自动修复断链
同步冲突：不要同时在多个设备上运行 CLI 工具
生成内容质量差：优化你的系统提示词和页面模板，使用更强大的模型

4.7 进阶功能与扩展

4.7.1 本地部署方案

如果你不想使用云 API，可以使用 Ollama 本地运行 LLM：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 下载 Llama 3 70B 模型
ollama pull llama3:70b

# 配置 obsidian-llm-wiki 使用本地模型
olw config set model ollama/llama3:70b
olw config set base_url http://localhost:11434/v1

4.7.2 AI Agent 集成

LLM Wiki 可以作为 AI Agent 的长期记忆：

使用 Agent Client 插件连接多个 AI Agent
让 Agent 直接读取和查询你的 Wiki
让 Agent 自动更新 Wiki 当有新信息时
创建专门的 Agent 负责 Wiki 的健康检查和维护

4.7.3 多模态支持

2026 年的 LLM 已经支持多模态输入：

将图片和 PDF 直接丢进 raw/ 文件夹
AI 会自动提取图片中的文字和图表信息
生成包含图片引用的 Wiki 页面
使用 Gemini 或 GPT-4o 获得最佳的多模态效果

4.8 完整模板包

4.8.1 核心系统文件

[CLAUDE.md](CLAUDE.md)（AI 操作手册）

# LLM Wiki 系统操作手册 v2.0

## 架构与权限
- **raw/**：原始资料目录，你**只能读取**，绝对不能修改任何文件
- **wiki/**：知识库目录，你完全拥有读写权限，负责创建、更新和维护所有内容
- **schema/**：模板目录，你必须严格遵守所有模板规范
- **assets/**：附件目录，用于存放图片和其他文件

## 页面类型与生成规则

### 1. 源文件摘要（wiki/sources/）
**用途**：提取原始资料中的事实性内容，不添加任何解释或观点
**文件名**：`[作者]-[标题缩写].md`
**必须包含**：
- 完整的 YAML frontmatter
- 基本信息（作者、日期、来源链接）
- 核心观点（3-5条最主要的结论）
- 关键概念和实体（全部创建双向链接）
- 重要引述（原文引用，使用>标记）
- 个人笔记部分（留空，由人类填写）

### 2. 概念页面（wiki/concepts/）
**用途**：定义和解释一个独立的概念
**文件名**：`[概念名称].md`
**必须包含**：
- 一句话清晰定义
- 3-5个关键特征
- 相关概念（说明关系类型：包含、相反、相似、因果等）
- 所有引用的来源
- 个人理解部分（留空，由人类填写）
**重要规则**：
- 每个概念只能有一个页面
- 优先使用已有的概念页面，不要创建重复内容
- 当发现已有页面信息不完整时，更新它而不是创建新的

### 3. 实体页面（wiki/entities/）
**用途**：描述一个人物、组织、产品或事件
**文件名**：`[实体名称].md`
**必须包含**：
- 基本信息
- 重要事件（按时间顺序排列）
- 相关概念和其他实体
- 引用来源

### 4. 综合分析（wiki/synthesis/）
**用途**：跨多个来源进行综合分析和比较
**文件名**：`[主题]-分析.md`
**必须包含**：
- 不同来源的观点对比
- 共识和分歧点
- 你的分析结论
- 所有引用的来源

### 5. 查询记录（wiki/queries/）
**用途**：保存历史问答记录
**文件名**：`[问题缩写].md`
**必须包含**：
- 原始问题
- 回答内容
- 引用的来源页面

## 全局规则
1. 所有页面必须使用标准的 YAML frontmatter
2. 所有内部链接必须使用 [[wikilinks]] 格式
3. 每次修改都要在 wiki/log.md 中添加一条记录
4. 当发现信息矛盾时，明确标注出来，不要静默覆盖
5. 保持语言简洁、客观、准确
6. 不要编造信息，所有内容必须有来源支持
7. 优先使用中文，除非是专有名词

4.8.2 页面模板

源文件摘要模板

---
title: "{{title}}"
type: "source"
status: "draft"
ai_generated: true
explored: false
confidence: "high"
source_type: "{{source_type}}"
author: "{{author}}"
publication_date: "{{publication_date}}"
source_url: "{{source_url}}"
created_at: "{{date}}"
updated_at: "{{date}}"
tags:
  - wiki/source
  - "{{source_type}}"
---

# {{title}}

## 基本信息
- **作者**：[[{{author}}]]
- **发布日期**：{{publication_date}}
- **来源链接**：[原文]({{source_url}})
- **阅读时间**：{{reading_time}} 分钟

## 核心观点
{{#each core_points}}
- {{this}}
{{/each}}

## 关键概念
{{#each key_concepts}}
- [[{{this}}]]
{{/each}}

## 重要引述
{{#each quotes}}
> {{this}}

{{/each}}

## 个人笔记
（在此处添加你自己的理解和见解，AI 不会修改这个部分）

概念页面模板

---
title: "{{title}}"
type: "concept"
status: "draft"
ai_generated: true
explored: false
confidence: "medium"
created_at: "{{date}}"
updated_at: "{{date}}"
tags:
  - wiki/concept
---

# {{title}}

## 定义
{{definition}}

## 关键特征
{{#each key_features}}
- {{this}}
{{/each}}

## 相关概念
{{#each related_concepts}}
- [[{{name}}]]：{{relationship}}
{{/each}}

## 引用来源
{{#each sources}}
- [[{{this}}]]
{{/each}}

## 个人理解
（在此处添加你自己的理解和见解，AI 不会修改这个部分）

4.8.3 常用 Dataview 查询片段

// 按置信度筛选页面
TABLE confidence, type
FROM "wiki"
WHERE confidence = "low"
SORT created_at DESC

// 查找没有来源的页面
LIST
FROM "wiki"
WHERE sources = null OR length(sources) = 0
SORT created_at DESC

// 查找孤立页面（没有任何链接的页面）
LIST
FROM "wiki"
WHERE length(file.inlinks) = 0 AND length(file.outlinks) = 0
SORT created_at DESC

五、避坑指南与性能优化

5.1 新手常见错误

过度纠结文件夹结构：不要一开始就建十几个文件夹，先写笔记，结构会自然形成
为了链接而链接：只有当两个笔记之间有实质性关联时才建立链接
安装太多插件：只安装你真正需要的插件，太多插件会影响性能
追求完美主义：笔记是用来思考的工具，不是艺术品，先完成再完美

5.2 性能优化

定期清理不需要的笔记和附件
关闭不常用的插件
限制图谱视图显示的节点数量
使用 SSD 存储笔记库

5.3 数据安全

定期备份你的笔记库
使用 Git 进行版本控制
不要把敏感信息放在笔记中
开启 Obsidian 的自动保存功能

核心知识点速览

Obsidian 核心优势：本地优先、双向链接、高度可定制，所有笔记都是纯 Markdown 文件
基础工作流：先掌握核心操作，再逐步添加插件，避免一开始就过度配置
插件选择原则：少即是多，先基础后进阶，定期清理不再使用的插件
必装核心插件：Templater、Dataview、Calendar、Linter、QuickAdd 是所有用户的基础
LLM Wiki 核心思想：知识提前编译，人机协作，纯文件系统，没有复杂的向量数据库
LLM Wiki 三层架构：raw/ 原始资料、wiki/ 结构化知识库、schema/ 模板规范
两种实现方式：CLI 工具（推荐，自动化程度高）、纯插件方案（零代码，简单）
同步避坑：推荐 iCloud/OneDrive 或官方同步，不要使用 Dropbox
内容质量控制：AI 生成内容必须人工审核，定期回顾和更新知识库
学习路径：从基础使用开始，掌握工作流，然后插件，最后尝试 LLM Wiki 高级项目

Obsidian知识管理 学习手册

文档核心说明

一、基础入门

1.1 什么是 Obsidian

1.2 下载安装与初始设置

1.2.1 下载安装

1.2.2 创建第一个笔记库（Vault）

1.2.3 基础设置优化

1.3 核心概念详解

1.3.1 双向链接（Backlinks）

1.3.2 原子化笔记

1.3.3 知识图谱（Graph View）

1.3.4 前哨站笔记（MOCs - Maps of Content）

1.4 基本操作指南

1.4.1 创建与编辑笔记

1.4.2 创建链接

1.4.3 搜索与导航

1.4.4 标签与文件夹

二、核心工作流与笔记方法

2.1 主流笔记方法

2.1.1 Zettelkasten 卡片盒笔记法

2.1.2 PARA 方法

2.1.3 混合工作流推荐

2.2 高级技巧与进阶功能

2.2.1 YAML Frontmatter

2.2.2 嵌入笔记与块引用

2.2.3 工作区管理

2.2.4 主题与 CSS 代码片段

2.3 同步与备份方案

2.3.1 官方同步服务（Obsidian Sync）

2.3.2 云盘同步

2.3.3 Git 同步

三、插件生态系统

3.1 插件选择黄金原则

3.2 核心必装插件（所有用户必备）

3.3 分类插件推荐

3.3.1 写作与编辑增强

3.3.2 知识组织与管理

3.3.3 任务与项目管理

3.3.4 数据与自动化

3.3.5 可视化与白板

3.3.6 AI 增强类（2026 年最火）

3.3.7 同步与备份

3.3.8 效率与导航

3.3.9 被低估的宝藏插件

3.4 新手插件安装建议

第一阶段（第 1-2 周）：基础必装

第二阶段（第 3-4 周）：效率提升

第三阶段（第 2 个月及以后）：按需添加

四、LLM Wiki 高级项目

4.1 核心架构设计

4.1.1 LLM Wiki 核心理念

4.1.2 三层架构模型

4.1.3 Obsidian 作为前端的独特优势

4.2 标准目录结构

4.3 两种主流实现方式

4.3.1 方式一：CLI 工具 + Obsidian（推荐）

4.3.2 方式二：纯 Obsidian 插件（零代码）

4.4 页面标准与元数据规范

4.4.1 标准 YAML Frontmatter

4.5 插件配置与优化

4.5.1 必装插件与配置

4.5.2 核心仪表盘示例

4.6 最佳实践与避坑指南

4.6.1 内容质量控制

4.6.2 性能优化

4.6.3 数据安全与备份

4.6.4 常见问题解决

4.7 进阶功能与扩展

4.7.1 本地部署方案

4.7.2 AI Agent 集成

4.7.3 多模态支持

4.8 完整模板包

4.8.1 核心系统文件

4.8.2 页面模板

4.8.3 常用 Dataview 查询片段

五、避坑指南与性能优化

5.1 新手常见错误

5.2 性能优化

5.3 数据安全

Obsidian知识管理学习手册