obsidian-wiki

name	obsidian-wiki
description	为 obsidian 构建、维护、查询 Wiki 知识库。 当以下情况时使用： (1) 用户提到"wiki"、"知识库" (2) 用户要求文章增加到wiki/知识库中 (3) 用户要求整理 obsidian wiki/知识库 (4) 用户要求查询、搜索 obsidian wiki/知识库 (5) 用户针对 Wiki 内容提问、对话、讨论 (6) 用户要求保存问答/讨论结果

Obsidian Wiki

为 Obsidian 文章构建 Wiki 知识体系：提取摘要、深写概念、构建索引。

使用场景

• 整理已有文章，提取概念并联网搜索完善
• 整理已有文章，写入结构化摘要
• 构建原文 → 摘要 → 概念的三层索引
• 定期健康检查，补全和更新概念库
• 搜索、查询、问答 Wiki 内容，并与用户讨论
• 将问答/讨论结果自动归档到 outputs 目录

前置条件

• 文章已保存在 Obsidian Vault 中
• 文章已经过 obsidian-backlinks 处理（已有 YAML frontmatter、tags、双链）
• 用户确认提取的概念列表（或授权自动判断）

目录结构

用途	路径
资源目录（原文）	<原文目录>
Wiki 根目录	<原文目录>/Wiki/
摘要目录	<Wiki 根目录>/Summaries/
概念目录	<Wiki 根目录>/Concepts/
索引文件	<Wiki 根目录>/INDEX.md
日志文件	<Wiki 根目录>/LOG.md
已处理清单	<Wiki 根目录>/.done.files
概念归一化配置	.concepts.yaml（workspace 中）
问答目录	<Wiki 根目录>/outputs/
Vault 本地目录	通过 obsidian vault info="path" silent 命令获取
Vault 名	如果用户不指定，默认obsidian vault info="name" silent

核心规则

• ⚠️ 禁止修改资源目录中的原文件
• ⚠️ 概念过滤标准统一使用 .concepts.yaml 的 excluded 列表（与 obsidian-backlinks 共享）
• 操作 Obsidian 使用 obsidian CLI（参考 SKILL: obsidian-cli，注意带 silent 参数）
• 摘要只提炼、不创作；概念页可深度扩展 + 联网增强
• 一个标准概念 = 唯一一篇概念文章
• 所有页面必须带 References，形成可溯源链路
• 禁止泛概念独立成页（AI、模型、算法 等）

双链写入原则（摘要 & 概念文章统一遵守）

概念文章内部严格使用 .concepts.yaml standard 标准名，不新增别名

1. 只对第一次出现的术语添加 [[...]]
2. 同一概念后续出现一律不处理、不链接
3. 标题中的概念算作第一次出现
4. 已存在的双链不再重复处理

---

增加文章

步骤 0：去重检查

读取已处理清单，跳过已处理的文章：

obsidian read path="<Wiki 根目录>/.done.files" silent

.done.files 格式（每行一条）：

2026-04-14|文章路径.md|5 concepts|summary

格式：日期|文章路径|概念数|处理类型

如果目标文章路径已存在于清单中，跳过并告知用户。

步骤 1：读取文章 + 提取概念 + 写摘要（一次读取）

一次性读取原文，同时完成概念提取和摘要编写，避免重复读取：

obsidian read path="文章路径.md" silent

1a. 提取候选概念（结构化解析，不需要语义理解）

从已经过 backlinks 增强的文章中纯结构化提取：

1. tags：从 YAML frontmatter 的 tags 字段提取
2. 双链：用正则 \[\[([^\]|]+)(?:\|[^\]]+)?\]\] 提取所有 [[概念]] 和 [[标准名|别名]] 中的标准名
3. 去重合并：tags 和双链中的概念取并集
4. 过滤：读取 .concepts.yaml 的 excluded 列表，排除泛概念

输出候选概念列表，等待用户确认（除非用户已授权自动判断）。

1b. 写结构化摘要

根据文章类型选择摘要框架：

文章类型	摘要框架	判断依据
学术论文	IMRaD（Introduction / Methods / Results / Discussion）	有 Abstract、References、实验章节
技术博客/教程	WHAT-WHY-HOW（是什么 / 为什么 / 怎么做 / 关键结论）	有代码示例、步骤说明
概念解析	CONCEPT-MAP（定义 / 核心机制 / 对比 / 应用场景）	围绕单一术语展开
实践笔记	TIL（场景 / 问题 / 方案 / 收获）	短篇、经验导向

摘要要求：

• 300-600 字，保留关键数据和结论
• 保留原文中的双链 [[概念]]
• YAML frontmatter 包含 source_path 指向原文

直接使用 write 工具操作文件，避免 Obsidian CLI 对于 \t、\n 的转义处理问题：

write(path="<Vault 本地目录>/<摘要目录>/文章名 - Summary.md", content="...")

步骤 2：编写概念文章（核心步骤）

对步骤 1a 确认的每个概念，执行以下流程：

2a. 联网搜索（必须）

搜索该概念的最新内容，关键字为：<概念名> 最新进展，提取 10 篇相关结果的标题、链接、摘要。

2b. 编写或更新概念文章

检查概念文章是否已存在：

obsidian read path="<概念目录>/概念名.md" silent

• 已存在：结合联网搜索的新内容，补充新论证、新观点、新进展，保留原有内容，增量不覆盖
• 不存在：写一篇完整文章，要求：
  • 1500 字以上
  • 结构：定义 → 核心原理（含数学推导/伪代码）→ 工程实践 → 对比方案 → 最新进展 → References
  • 清晰的原理解释和证明
  • 直接在生成内容中嵌入 [[双链]] 和 YAML tags（概念文章从零生成，agent 已知所有概念，无需再走 obsidian-backlinks 流程）

文章尾部 必须包含 References：

## References

- [[原文标题]] — Obsidian 内部文章
- [论文/博客标题](https://url) — 外部链接

写入概念目录，先获取 vault 根目录：

obsidian vault info="path" silent

直接使用 write 工具操作文件，避免 Obsidian CLI 对于 \t、\n 的转义处理问题：

write(path="<Vault 本地目录>/<概念目录>/概念名.md", content="...")

2c. 并行策略

• 概念文章之间互相独立，适合并行处理
• 当概念数 ≥ 3 时，使用 subagent 并行编写
• 每个 subagent 负责：联网搜索 + 编写/更新一篇概念文章（含内嵌双链和 tags）
• 主 agent 负责：汇总结果、更新索引、记录日志

步骤 3：更新索引

INDEX.md 使用以下固定结构：

# Wiki 索引

> 自动生成，请勿手动编辑。最后更新：YYYY-MM-DD

## 按分类

### 模型架构
- [[概念A]] — 一句话描述
- [[概念B]] — 一句话描述

### 训练方法
- ...

### 推理优化
- ...

### 位置编码
- ...

（按需增加分类）

## 摘要

- [[文章A - Summary]] ← [[文章A]]
- [[文章B - Summary]] ← [[文章B]]

## 统计

- 概念文章：XX 篇
- 摘要文章：XX 篇
- 最后更新：YYYY-MM-DD

分类不是固定的，根据概念的 tags 自动归类。一个概念可以出现在多个分类下。

obsidian create path="<Wiki 根目录>/INDEX.md" content="..." silent overwrite

步骤 4：记录已处理文件

追加到 .done.files：

obsidian append path="<Wiki 根目录>/.done.files" content="2026-04-14|文章路径.md|5 concepts|summary" silent

步骤 5：记录操作日志

追加到 LOG.md：

## 2026-04-14 16:00
**源路径**：文章路径.md
**处理文章**：[[RoPE 旋转位置编码]]
**摘要**：[[RoPE 旋转位置编码 - Summary]]
**新增概念**：[[RoPE]]、[[旋转矩阵]]、[[Position Interpolation]]
**更新概念**：[[Transformer]]（补充 RoPE 相关内容）
**联网搜索**：10 条结果，5 条采纳

obsidian append path="<Wiki 根目录>/LOG.md" content="..." silent

---

健康检查

定期扫描 Wiki 概念库，检查和补全内容。

步骤 1：扫描现有概念文章

obsidian list path="<概念目录>" silent

获取所有概念文章列表。

步骤 2：逐项检查

对每篇概念文章执行以下检查：

2a. 内容新鲜度

• 读取概念文章，检查 YAML frontmatter 中的 date 或文章末尾的"最新进展"章节
• 阈值：超过 90 天未更新的概念，触发联网搜索
• 联网搜索该概念最新进展，关键字：<概念名> 最新进展
• 有重要更新（新论文、新版本、重大变更）则补充到文章中

2b. 引用完整性

• 检查 ## References 是否存在
• 是否至少包含 1 个 Obsidian 内部链接 [[...]]
• 是否至少包含 1 个外部 URL [...](https://...)
• 缺失则标记为待修复

2c. 双链有效性

• 提取文章中所有 [[概念]] 链接
• 检查每个链接是否对应 <概念目录> 下已有的概念文章
• 不存在的链接收集为待创建概念列表

2d. 索引一致性

• 读取 <Wiki 根目录>/INDEX.md
• 对比概念目录和摘要目录的实际文件列表
• 检查是否有文章未收录在索引中

2e. 重复概念检查

• 根据 .concepts.yaml 的 aliases 检查是否存在同义不同名文件
• 如存在，标记为 需要合并
• 保留标准名，删除别名文件

步骤 3：输出检查报告

汇总后输出：

📋 Wiki 健康检查报告

✅ 正常概念：XX 篇
⚠️ 需要更新（超过 90 天）：概念A、概念B
❌ 缺少 References：概念C
🔗 断链（概念文章不存在）：概念D、概念E
📑 未收录在索引中：概念F

建议操作：
1. 更新 X 篇过期概念
2. 创建 X 篇缺失概念
3. 修复 X 篇引用
4. 重建索引

等待用户确认后再执行修复操作。

步骤 4：执行修复

根据用户确认的范围：

• 更新过期概念：联网搜索 + 补充内容（同增加文章的步骤 2c）
• 创建缺失概念：联网搜索 + 编写新文章（同增加文章的步骤 2b-2c）
• 修复引用：补全 References 章节
• 重建索引：同增加文章的步骤 3
• 记录日志：同增加文章的步骤 5

---

搜索与问答

步骤 1：接收用户问题

用户问题示例：

• KV Cache 为什么会爆显存？
• RoPE 和 ALiBi 区别是什么？
• 解释一下 Attention Sink

步骤 2：检索 Wiki 内容

从三个位置检索信息：

1. 概念文章
2. 摘要库
3. 问答库
4. INDEX 索引：关键词匹配

obsidian search path="<概念目录>" query="KV Cache" silent
obsidian search path="<摘要目录>" query="KV Cache" silent
obsidian search path="<问答目录>" query="KV Cache" silent

步骤 3：结合联网信息补充（必要时）

如果 Wiki 信息不足，自动联网补全。

步骤 4：生成结构化回答

遵循格式：

# 问答：KV Cache 为什么会占用大量显存？

## 简短结论
...

## 原理
...

## 关键机制
...

## 相关 Wiki 概念
- [[KV Cache]]
- [[PagedAttention]]
- [[Attention Sink]]

## References
- [[KV Cache]]
- [[论文：...]]

步骤 5：与用户多轮讨论

• 允许用户追问、扩展、对比、质疑
• 每轮回答都引用 Wiki 内链 [[...]]
• 不编造无来源结论
• 保持学术 / 工程风格

---

归档问答

步骤 1：结束讨论后自动归档

当用户说：

• 保存
• 归档
• 记录下来
• 写到 wiki outputs

自动执行保存。

步骤 2：生成归档文件

文件名格式：

YYYY-MM-DD-问答-关键词.md

示例：

2026-04-15-问答-KV-Cache-显存问题.md

内容结构：

---
title: "问答：KV Cache 显存占用问题"
tags: [KV Cache, 推理优化, 显存]
date: 2026-04-15
source: wiki-discussion
---

# 问答：KV Cache 为什么会爆显存？

（完整对话内容）

## 相关 Wiki
- [[KV Cache]]
- [[PagedAttention]]

## References
- [[KV Cache]]
- [https://...]]

步骤 3：写入 outputs 目录

使用 write 避免 LaTeX 乱码：

write(path="<Vault 本地目录>/outputs/2026-04-15-xxx.md", content="...")

步骤 4：更新索引 & 日志

• 在 INDEX.md 增加「问答归档」板块

## 问答归档
- [[2026-04-15-问答-KV-Cache-显存问题]]
- [[2026-04-15-问答-RoPE-vs-ALiBi]]

• 在 LOG.md 记录本次问答

---