LLM Wiki 知识库系统

在 Obsidian vault 中增量构建和维护持久化知识 Wiki 的完整工作流。

核心理念：LLM 负责知识的编写和维护，人类负责收集素材和提问审查。

首次使用必读

本 skill 不会自动知道你的 vault 路径。

首次使用时，你必须告诉 LLM 你的 Obsidian vault 路径（绝对路径），LLM 会帮你：

在 vault 根目录创建 SCHEMA.md（运维规则手册）
创建 wiki/ 目录结构（实体/概念/素材/分析）
创建 raw/ 目录（原始素材存放区）
创建 wiki/index.md 和 wiki/log.md

一句话触发："帮我在 OB 里搭建 LLM Wiki 系统，vault 路径是：/你的/路径/"

架构概览

你的Obsidian Vault/               ← Obsidian vault 根目录（路径由你提供）
├── SCHEMA.md                   ← 运维规则手册（LLM 每次操作前必读）
├── Clippings/                  ← Obsidian Web Clipper 剪藏目录（临时，可选）
├── raw/                        ← 原始素材层（只读，不可修改）
│   ├── sources/                ← 文章、PDF、笔记等原始文件
│   └── assets/                ← 图片等附件
└── wiki/                       ← LLM 生成的知识层（LLM 全权维护）
    ├── index.md                ← 内容索引（每次操作后更新）
    ├── log.md                  ← 变更日志（append-only）
    ├── 实体/                   ← 实体页面（人物、公司、产品、工具）
    ├── 概念/                   ← 概念页面（方法论、趋势、理论）
    ├── 素材/                   ← 素材摘要页面（每篇原始素材的摘要）
    └── 分析/                   ← 分析页面（对比、综合、问答产出）

核心原则

raw/ 目录只读 — 原始素材绝对不修改，只读取
Wiki 页面用 [[双中括号]] 双向链接 — 方便 Obsidian 图谱视图
每次操作后更新 index.md 和 log.md — 保持索引实时同步
提炼而非复制 — Wiki 页面是提炼后的知识，不是原文搬运
单篇素材可能触及 5-15 个页面 — 这是正常的，不要怕页面多

Vault 路径配置

首次使用：告诉 LLM 你的 vault 绝对路径，例如：

Windows：D:/我的知识库/我的知识库/
macOS：/Users/你的名字/Documents/MyVault/

LLM 会记住这个路径，并在每次操作前确认路径存在。

如果路径变了：直接告诉 LLM 新路径，它会更新。

触发关键词

用户说	触发操作
---------	---------
"ingest" / "消化" / "录入" / "帮我处理这篇文章"	Ingest（摄入素材）
"查一下" / "关于XX Wiki里有什么" / "query"	Query（查询知识）
"lint" / "检查Wiki" / "健康检查"	Lint（健康检查）
"搭建Wiki" / "初始化Wiki" / "创建Wiki系统"	首次初始化
"腾讯文档同步" / "同步到文档"	同步到腾讯文档空间（可选）

操作零：初始化 Wiki 系统（仅首次）

触发：用户说"搭建Wiki""初始化Wiki""创建Wiki系统"，并提供 vault 路径。

执行步骤

确认 vault 路径 — 用户提供的绝对路径，确认目录存在
创建目录结构 — 在 vault 根目录下创建：

raw/sources/, raw/assets/
wiki/实体/, wiki/概念/, wiki/素材/, wiki/分析/

创建 SCHEMA.md — 复制本 skill 附录 A 的 SCHEMA.md 模板，写入 vault 根目录
创建 wiki/index.md — 写入初始索引（只有标题和空分类）
创建 wiki/log.md — 写入初始日志（只有标题和说明文字）
报告完成 — 告诉用户系统已就绪，可以开始 ingest

操作一：Ingest（摄入素材）

触发：用户给我一篇新文章/文件，说"消化这个""帮我录入""ingest"等。

Step 1：读取素材

如果是文件路径 → 用 Read 工具读取全文
如果是贴的文本 → 直接使用
如果是目录路径 → 遍历目录下所有 .md 文件，逐个 ingest

Step 2：提取关键信息

从素材中识别并提取以下内容（用 Think 工具先思考，再动手写文件）：

核心观点：2-5 个关键论点，用一句话概括
实体：人物、公司、产品、工具、平台名称（具体对象）
概念：方法论、趋势、理论、策略（抽象概念）
数据/案例：具体数字、真实案例、对比信息
行动建议：可执行的建议或下一步

Step 3：创建素材摘要页

在 wiki/素材/ 下创建文件，文件名尽量保留原标题（缩短到 20 字以内）。

标准格式：

---
title: 素材标题
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [tag1, tag2, tag3]
original: raw/sources/原始文件名.md
---

# 素材标题

## 核心观点
- 观点1（一句话）
- 观点2
- 观点3

## 关键信息
（数据、案例、细节，用 bullet points）

## 涉及实体
- [[实体A]] — 一句话描述（身份/功能）
- [[实体B]] — ...

## 涉及概念
- [[概念X]] — 一句话描述
- [[概念Y]] — ...

## 行动建议
- 建议1
- 建议2

Step 4：更新实体和概念页面

对每个识别出的实体/概念：

检查是否已存在 → 读 wiki/实体/ 或 wiki/概念/ 下对应文件
已存在 → 用 Edit 工具追加新信息，更新 updated: 日期，在"涉及素材"部分添加本素材链接
不存在 → 用 Write 工具创建新页面

实体页面标准格式：

---
title: 实体名
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [标签1, 标签2]
sources: [素材摘要文件名]
---

# 实体名

一句话介绍（身份/功能/背景）。

## 核心信息
（关键数据、背景、特点）

## 相关链接
- [[相关实体A]]
- [[相关概念X]]
- [[素材摘要Y]]

## 涉及素材
- [[素材摘要Y]] — 日期

概念页面标准格式：

---
title: 概念名
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [标签1, 标签2]
sources: [素材摘要文件名]
---

# 概念名

用 1-2 句话解释这个概念是什么。

## 核心要点
- 要点1
- 要点2

## 相关链接
- [[相关概念A]]
- [[相关实体X]]
- [[素材摘要Y]]

## 涉及素材
- [[素材摘要Y]] — 日期

Step 5：添加双向链接

素材摘要页 → [[链接]] 所有涉及的实体和概念
实体/概念页面 → [[链接]] 相关素材和其他实体/概念
确保没有断开的 [[链接]]（链接到不存在的页面）

Step 6：更新索引和日志

更新 wiki/index.md：

在对应分类下追加新条目，格式：- [[页面名]] — 一句话描述

追加 wiki/log.md：

在文件开头（最新日志在最上面）追加：

## [YYYY-MM-DD] ingest | 素材标题
- 创建：素材/xxx, 实体/yyy, 概念/zzz
- 更新：实体/aaa, 概念/bbb
- 备注：关键发现（可选）

操作二：Query（查询知识）

触发：用户针对 Wiki 内容提问，说"查一下""关于XX Wiki里有什么""query"等。

Step 1：读取索引

读 wiki/index.md，找到与问题相关的页面名称。

Step 2：深入读取

读取相关页面的完整内容
如需要，进一步读取 linked 页面（跟踪 [[双中括号]] 链接）
至少读 2-3 层深度，确保理解上下文

Step 3：综合回答

给出有引用的回答，格式：（参考：[[页面名]]）
标注信息来源（哪个素材、哪个日期）
如果信息有冲突，明确指出并分析

Step 4：可选回写

如果回答本身有长期价值（不是一次性回答）：

创建 wiki/分析/ 页面，标题格式：分析主题 - YYYY-MM-DD
更新 wiki/index.md 和 wiki/log.md

操作三：Lint（健康检查）

触发：用户说"检查一下""lint""健康检查"等。

Step 1：全量扫描

遍历 wiki/ 下所有目录，用 Read 工具读取所有 .md 文件
同时读 wiki/index.md 获取完整页面清单

Step 2：检查项

检查项	说明
--------	------
矛盾检测	不同页面对同一事实说法冲突
孤儿页面	没有被任何其他页面 `[[链接]]` 的页面
缺失页面	文中用 `[[xxx]]` 引用但实际不存在的页面
过时内容	被新素材推翻的旧说法（对比 log.md 时间戳）
缺失交叉引用	语义相关但未互相链接的页面
索引不一致	index.md 列出的页面与实际文件不符

Step 3：输出报告

列出所有问题，按严重程度排序
提出修复建议
等用户确认后再执行修复（不要自作主张）

操作四：同步到腾讯文档（可选）

触发：用户说"腾讯文档同步""同步到文档"。

前置条件

用户需要先手动在腾讯文档创建一个空间，然后把空间 ID 告诉 LLM。

空间 ID 在腾讯文档空间 URL 中可以找到，格式如：SDZoexDtGXHM

流程

用户提供服务空间 ID
在空间中创建四个文件夹节点（实体/概念/素材/分析），记录节点 ID
遍历 wiki/ 下所有 .md 文件
对每个文件：用腾讯文档 MCP 工具在对应文件夹下创建智能文档并写入内容
完成后报告同步结果

命名规范

文件名用中文，简洁明确（20字以内）
实体页面：人名、公司名、产品名（如：Codex.md）
概念页面：概念名 或 概念名-限定条件（如：Vibe Coding.md）
素材摘要：尽量保留原标题缩写（如：AI播客Top10.md）
分析页面：分析主题-YYYY-MM-DD 或 A vs B 对比

常见坑

不要跳过读 SCHEMA.md — 每次操作前必读，里面有可能已更新的规则
不要忘记更新 index.md — 新建页面后必须加到索引，否则下次查询找不到
不要修改 raw/ 文件 — 只读，素材是真理来源
双向链接要互指 — A 链接 B，B 也要链接 A（如果语义相关）
log.md 是 append-only — 新日志加在文件开头，不要覆盖旧日志
一句话描述要实用 — index.md 里的描述应该能让人判断要不要点进去看

附录 A：SCHEMA.md 模板

首次初始化时，LLM 应将以下内容写入 SCHEMA.md：

# Wiki Schema — 运维规则手册

> 本文件是 LLM Wiki 系统的核心配置。每次操作 Wiki 前，必须先读此文件。

## 1. 目录结构

（你的Vault名）/

├── SCHEMA.md ← 你正在读的文件（本文件）

├── Clippings/ ← Obsidian Web Clipper 剪藏目录（临时存放，可选）

├── raw/ ← 原始素材层（只读，不可修改）

│ ├── sources/ ← 文章、PDF、笔记等原始文件

│ └── assets/ ← 图片等附件

└── wiki/ ← LLM 生成的知识层（LLM 全权维护）

├── index.md ← 内容索引（每次 ingest/query 后更新）

├── log.md ← 变更日志（append-only，每次操作后追加）

├── 实体/ ← 实体页面（人物、公司、产品、工具等）

├── 概念/ ← 概念页面（方法论、趋势、理论等）

├── 素材/ ← 素材摘要页面（每篇原始素材的摘要）

└── 分析/ ← 分析页面（对比、综合、问答产出）


## 2. 角色分工

| 角色 | 职责 |
|------|------|
| **你（人类）** | 收集素材、放入 raw/sources/ 或 Clippings/、提问、审查、决定方向 |
| **我（LLM）** | 读取素材 → 提取信息 → 写入/更新 Wiki 页面 → 维护索引和日志 |

## 3. 页面格式规范

### 3.1 所有 Wiki 页面统一格式

title: 页面标题

created: YYYY-MM-DD

updated: YYYY-MM-DD

tags: [tag1, tag2]

sources: [source1, source2]

页面标题

正文内容...

Wiki 索引

实体

[[实体名]] — 一句话描述

概念

[[概念名]] — 一句话描述

素材摘要

[[素材名]] — 一句话描述（来源，日期）

分析

[[分析名]] — 一句话描述


每次 ingest 或 query 后都要更新。

## 6. 日志文件 (log.md)

格式（append-only）：

[YYYY-MM-DD] ingest | 素材标题

创建页面：素材/xxx, 实体/yyy, 概念/zzz
更新页面：实体/aaa
备注：关键发现或决策

[YYYY-MM-DD] query | 问题摘要

读取页面：实体/xxx, 概念/yyy
回答要点：...
新建页面：分析/zzz（可选）


## 7. 命名规范

- 文件名用中文，简洁明确
- 实体页面：`人名`、`公司名`、`产品名`
- 概念页面：`概念名` 或 `概念名 - 限定条件`
- 素材摘要：尽量保留原标题（缩短）
- 分析页面：`分析主题 - 日期` 或 `A vs B 对比`

## 8. 注意事项

- **raw/ 目录的文件绝对不修改**，只读取
- Clippings/ 是过渡区，ingest 完成后可以把文件移到 raw/sources/
- 所有 Wiki 页面必须使用 `[[双中括号]]` 语法做双向链接，方便 Obsidian 图谱视图
- 每次操作后必须更新 index.md 和 log.md
- 保持页面简洁，避免大段复制原文——提炼才是价值

附录 B：对本 Skill 的说明

本 skill 是一个通用模板，不包含任何个人路径或数据。

使用者首次使用时需提供 Obsidian vault 路径，LLM 会自动完成初始化。

如需二次分发，直接分享本 skill 文件夹即可。

LLM-WIKI（龙虾联动OB建立）

概述