# LLM Wiki Obsidian

> 基于 Karpathy LLM Knowledge Base 模式的个人知识库管理技能。通过 Obsidian CLI 与本地 Obsidian Vault 交互。核心思想：LLM 不是在查询时从原始文档重新发现知识， 而是增量构建和维护一个持久的 Wiki——结构化的、互联的 Markdown 文件集合。 当添加新资料时，LLM 会读取、提取关键信息并整合到现有 Wiki 中。 **触发条件**：用户提到知识库、Wiki、整理知识、建立知识体系、Obsidian、摄入资料、 查询知识、维护个人知识库、或讨论 Karpathy/Wiki 模式。

- Skill: `dreamor/llm-wiki-obsidian` (Agent Skill, multi-file: 31 files)
- Install (CLI): `npx skillmds@latest add dreamor/llm-wiki-obsidian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dreamor/llm-wiki-obsidian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: dreamor (https://skillmd.com/u/dreamor)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dreamor/llm-wiki-obsidian

---


# 个人知识库管理技能 — llm-wiki-obsidian

基于 Karpathy LLM Wiki 模式，通过 Obsidian CLI 操作本地 Obsidian Vault。

## 核心思想

**不是 RAG，是持久 Wiki！**

| RAG | 持久 Wiki |
|------|----------|
| 每次查询从原始文档重新发现知识 | 知识被编译并**持续保持最新** |
| 无积累，问5个文档的综合问题每次都要重新拼凑 | 交叉引用已存在，矛盾已标注，综合已形成 |
| NotebookLM、ChatGPT 文件上传 | Obsidian + LLM = IDE + 程序员 |

**关键洞察**：Wiki 是一个**持久、复利的产物**。每添加一份资料，Wiki 就变得更丰富。

**人类的工作**：策划来源、引导分析、提出好问题、思考意义。
**LLM 的工作**：其他一切（bookkeeping 工作：更新交叉引用、保持摘要最新、标注矛盾）。

---

## 何时使用此技能

当用户进行以下操作时激活此技能：

- **构建知识库**：要求建立或整理个人知识管理系统
- **Ingest（摄入）**：提供新资料（文章、论文、文档）要求整理到知识库
- **Query（查询）**：向知识库提问，寻求综合分析
- **Lint（体检）**：要求检查知识库的健康状况
- **维护 Wiki**：更新、修订、补充交叉引用
- **讨论知识管理**：关于如何组织知识、构建 Zettelkasten、卡片盒等方法论

---

## 架构（三层）

```
知识库/
├── raw/                    # 原始资料（不可变，只读）
│   ├── minimind/          # 按主题/项目分类
│   ├── articles/          # 文章
│   ├── papers/            # 论文
│   └── assets/           # 图片、附件
├── wiki/                   # LLM 生成的 Wiki（AI 全权维护）
│   ├── entities/          # 实体页（人物、组织、项目、产品）
│   ├── concepts/         # 概念页（技术概念、理论、方法论）
│   ├── sources/          # 来源摘要页
│   ├── synthesis/        # 综合分析页
│   ├── meta/             # 仪表盘（Bases Dashboard）
│   └── canvases/         # Canvas 可视化
├── index.md               # 内容目录
├── log.md                # 操作日志
└── AGENTS.md             # 规则文件
```

---

## 核心操作

| 操作 | 详细文档 | 说明 |
|------|----------|------|
| **Ingest** | [wiki-ingest.md](wiki-ingest.md) | 摄入新资料：保存原始资料、创建来源页、更新实体/概念页 |
| **Query** | [wiki-query.md](wiki-query.md) | 查询知识库：搜索、读取、综合回答、沉淀新洞察 |
| **Lint** | [wiki-lint.md](wiki-lint.md) | 健康检查：8 轮检查（死链接、孤立页面、矛盾等） |
| **CrossLink** | [wiki-crosslinker.md](wiki-crosslinker.md) | 自动跨链：检测和创建双向链接 |
| **AutoResearch** | [autoresearch.md](autoresearch.md) | 自主研究：3 轮搜索→抓取→综合→摄入循环 |

---

## Obsidian CLI 命令参考

Vault 名称从 `obsidian.json` 获取，Obsidian 应用必须正在运行。

### 读取与搜索

```bash
# 读取笔记
obsidian read file="页面名"

# 搜索 vault
obsidian search query="搜索词" limit=10

# 查看反向链接（谁引用了此页面）
obsidian backlinks file="页面名"

# 标签统计
obsidian tags sort=count counts

# 获取每日笔记
obsidian daily:read
```

### 创建与更新

```bash
# 创建新笔记（多行用 \n）
obsidian create name="新页面" content="# 标题\n\n内容" silent

# 追加内容到现有笔记
obsidian append file="页面名" content="新段落"

# 设置属性
obsidian property:set name="status" value="done" file="我的笔记"

# 追加到每日笔记
obsidian daily:append content="- [ ] 新任务"
```

### Vault 定位

```bash
# 指定 vault（当多 vault 时）
obsidian vault="个人知识库" search query="关键词"
```

### 实用标志

- `silent` — 不打开文件
- `--copy` — 复制输出到剪贴板
- `overwrite` — 覆盖已存在的文件

---

## 页面模板

页面模板有两个来源：

### Obsidian Templater 模板（`_templates/`）

安装 Templater 插件后，新建笔记时自动填充 frontmatter：

| 模板 | 用途 | 路径 |
|------|------|------|
| Entity | 实体页 | `_templates/Entity.md` |
| Concept | 概念页 | `_templates/Concept.md` |
| Source | 来源页 | `_templates/Source.md` |
| Synthesis | 综合分析页 | `_templates/Synthesis.md` |

### 操作文档中的模板

LLM 创建页面时参考的详细模板：
- Entity / Concept 模板：[wiki-ingest.md](wiki-ingest.md)
- Source 模板：[wiki-ingest.md](wiki-ingest.md)
- Synthesis 模板：[wiki-query.md](wiki-query.md)

---

## 关键原则

1. **Raw sources immutable** — `raw/` 是只读的，绝不修改
2. **LLM owns wiki** — 自动创建、更新、维护 Wiki
3. **Cross-reference everything** — 双向 `[[wikilinks]]`
4. **Flag contradictions** — 发现矛盾时用 Obsidian callout 标注：`> [!contradiction] 与 [[X]] 矛盾`
5. **Keep index current** — 每次变更后更新 index.md
6. **Append to log** — 每次操作记录到 log.md

---

## index.md 格式

```markdown
# 📚 个人知识库索引

## 最近更新
- [[页面名]] - 一句话描述 (2026-04-17)

## 实体
| 页面 | 摘要 | 来源 | 更新 |
|------|------|------|------|

## 概念
| 页面 | 摘要 | 来源 | 更新 |
|------|------|------|------|

## 来源
| 页面 | 摘要 | 日期 |
|------|------|------|
```

## log.md 格式（追加到每日笔记）

```markdown
## [2026-04-17] ingest | 资料标题
- 创建 wiki/sources/页面.md
- 更新 3 个实体页、2 个概念页
- 更新 index.md

## [2026-04-17] query | 用户问题
简要回答，涉及的页面

## [2026-04-17] lint
发现的问题，解决的孤立页面
```

---

## 实用技巧

### Obsidian Web Clipper
浏览器扩展，将网页文章转 Markdown，快速获取资料到 raw/。

### 搜索增强
- 小 Wiki（<100 页）：`index.md` + `obsidian search` 足够
- 增长中的 Wiki：使用 [qmd](https://github.com/tobi/qmd) CLI（BM25 + 向量搜索 + LLM 重排）

### 插件推荐
- **Dataview**：查询页面 frontmatter，生成动态表格
- **graph view**：查看 Wiki 结构，发现孤立页面
- **Marp**：从 Markdown 生成幻灯片
- **Obsidian CLI**：内置 CLI（1.9+），需在 obsidian.json 启用

### Git 版本控制
Wiki 就是 Git 仓库，可以获得版本历史、分支和协作能力。

### Bases Dashboard（Obsidian 1.9.10+）
打开 `wiki/meta/dashboard.base` 可查看知识库概览：
- 按类型分视图（实体、概念、来源、综合分析）
- 最近更新列表
- 词数估算和更新状态

### Canvas 知识地图
- `wiki/Wiki Map.canvas`：知识库架构可视化，展示目录间数据流
- `wiki/canvases/welcome.canvas`：新用户引导画布

---

## 为什么有效

维护知识库最繁琐的部分不是阅读或思考，而是** bookkeeping（记账工作）**：更新交叉引用、保持摘要最新、标注矛盾、保持一致性。人类放弃 Wiki 是因为维护负担增长比价值快。LLM 不会厌倦、不会忘记更新交叉引用、可以一次触及 15 个文件。

---

## 快速开始

当用户提供新资料要摄入时：
```
1. 请用户提供资料内容或 URL
2. 分析资料，提取关键信息
3. 确定放 raw/ 哪个子目录
4. obsidian create 创建 wiki/sources/ 来源摘要页
5. obsidian append 更新相关实体/概念页
6. 更新 index.md
7. obsidian daily:append 记录
```

当用户向知识库提问时：
```
1. obsidian search 搜索相关页面
2. obsidian read 读取匹配页面
3. 综合回答并标注来源
4. 询问用户是否要将回答存入 Wiki
```

---

---

## 自动跨链（Cross-Linker）

自动检测和创建双向链接，确保 Wiki 页面之间的互联性。

详细文档：[wiki-crosslinker.md](wiki-crosslinker.md)

---

## 健康检查（Lint）

自动检查知识库健康状况（8 轮检查）。

详细文档：[wiki-lint.md](wiki-lint.md)

快速使用：`./scripts/lint.sh /path/to/wiki`

---

## 性能优化

针对大型 Wiki（>1000 页）的优化策略。

详细文档：[performance-guide.md](performance-guide.md)

### 快速优化

```json
// config.json
{
  "performance": {
    "large_wiki_threshold": 1000,
    "batch_size": 50,
    "use_qmd_for_search": true
  }
}
```

### qmd 集成

```bash
# 安装 qmd
brew install qmd

# 索引 Wiki
qmd index wiki/

# 搜索
qmd search "关键词" --top 10
```

---

## 测试

运行测试套件验证功能正确性。

```bash
# 单元测试
./scripts/test.sh

# 详细输出
./scripts/test.sh --verbose

# 集成测试（需要 Obsidian 运行）
./scripts/test.sh --integration
```

---

## 配置

复制 `config.example.json` 为 `config.json` 并根据需要修改。

```bash
cp skills/llm-wiki-obsidian/config.example.json skills/llm-wiki-obsidian/config.json
```

主要配置项：

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `vault.path` | Obsidian Vault 路径 | - |
| `wiki.wiki_dir` | Wiki 目录名 | `wiki` |
| `crosslinker.enabled` | 启用自动跨链 | `true` |
| `lint.enabled_checks` | Lint 检查项 | 全部 |
| `performance.use_qmd_for_search` | 使用 qmd 搜索 | `false` |

---

## 参考资料

- [Karpathy LLM Knowledge Base](references/karpathy-kb-pattern.md)
- [Obsidian CLI 完整参考](references/obsidian-cli.md)
- [自动跨链功能](wiki-crosslinker.md)
- [性能优化指南](performance-guide.md)