Obsidian Wiki Manager

个人知识库管理系统，遵循 Raw → Wiki → Outputs 三层架构。

架构概览

核心原则：

• LLM 完全拥有 wiki/ 目录的读取和写入权限
• raw/ 目录由人类拥有，LLM 只能读取，绝不修改
• 系统文件（index/log/overview/QUESTIONS）不参与 Obsidian 图谱

配置要求

vault_root: "D:\\obsidian-job\\job"
qmd_cmd: "D:\\obsidian-job\\job\\qmd.bat"  # qmd 封装脚本

一、INGEST（摄入）操作规范

触发词：ingest、摄入、处理这个

来源类型判断

1. frontmatter 含 type: personal-writing → 走「个人写作」流程
2. 文件路径包含 raw/personal/ → 走「个人写作」流程
3. frontmatter 含 type: pdf-reference → 走「PDF 参考」流程
4. 其他 → 走「外部来源」标准流程

URL 直接输入处理规则

1. 获取内容：使用 web-content-fetcher 技能或 win_web_read 获取页面完整内容，转换为 Markdown
2. 确定文件名：根据页面标题或 URL 路径生成文件名，保存到 raw/clippings/ 目录
3. 确定作者和日期：从页面元数据中提取 author 和 publish_date，无法提取则标注「来源未知」
4. 保存后继续标准流程：对保存的文件执行完整 INGEST 流程
5. source_url 记录：在 source 页中同时保留 raw_file 和 source_url
6. 去重检查：如果已有相同或高度相似来源，更新已有 source 页，不创建重复

缺少 frontmatter 的处理规则

• 从文件第一个 # 标题提取 title；若无标题则从文件名推断
• source 字段留空，在 source 页中标注「来源未知」
• date 使用文件系统修改时间
• 不中断 INGEST，但在 log.md 记录警告

外部来源标准流程（12 步）

Step 1：读取目标原始来源

Step 2：计算 SHA-256 哈希（Python hashlib）

Step 3：与用户确认核心要点

Step 4：生成 slug（小写英文，用连字符）

Step 5：创建 wiki/sources/<slug>.md，frontmatter 写入：

• raw_file：相对路径
• raw_sha256：SHA-256 哈希值
• last_verified：摄入日期
• canonical_source：翻译/转述来源同源标记
• 来源超过 2 年前：标注 possibly_outdated: true

Step 5.5 — canonical_source 译文同源检测：

1. 遍历已有 source 页的 canonical_source 字段
2. 若指向同一原始来源：标记为同源，不创建新概念/实体
3. 在 Contradictions 节记录
4. 同源来源仅计为 1 个来源

Step 6 — 概念名称对齐检查：

1. 映射为英文小写连字符 slug
2. 查已有 concept 文件
3. 检查所有 concept 页的 aliases 字段
4. 匹配则更新，不创建新页
5. 不匹配才创建新页

Step 7：为每个概念：更新或创建 concept 页

• Evolution Log 追加规则：「强化」/「修正」/「新增分歧」

Step 8：为每个实体：同上逻辑

Step 9：更新 wiki/index.md

Step 10：检查 wiki/QUESTIONS.md 匹配

Step 11：追加 wiki/log.md

Step 12（索引同步）：执行 qmd update + qmd embed，报错则跳过记录

个人写作流程

• 不生成 Summary 节，跳过客观摘要
• 核心论点写入 ## My Position 节（标注「个人认知」）
• 不参与 confidence 的 source_count 计数
• Evolution Log 记录：「YYYY-MM-DD 个人写作 [[slug]] 确立了对此概念的明确立场」

二、QUERY（查询）操作规范

触发词：直接提问，或「根据我的知识库」

Step Q1：执行 qmd search "<query>" -n 5 --json（本机环境 qmd query 的 LLM 扩充会超时，故用 search 替代）

• 若报错则降级读取 wiki/index.md

Step Q2：逐一完整读取 top 5 文件

Step Q3：合成答案

• 每个核心结论必须溯源到具体 wiki/sources/<slug>.md
• 注明各来源 confidence 级别
• 来源矛盾时显式标注分歧

Step Q4：若答案有复用价值，写入 wiki/outputs/

输出格式

三、LINT（检查）操作规范

触发词：lint、检查、健康检查

1. 运行 scripts/lint.py（9 项检查）
2. 报告写入 wiki/outputs/lint-YYYY-MM-DD.md
3. 执行 qmd status，对比索引；落后则执行 qmd update
4. 展示摘要并询问是否修复

四、REFLECT（反射）操作规范

触发词：reflect、综合分析、发现规律

Stage 0 — 反向检验：主动搜索反驳证据，无则标注「⚠ 回音室风险」

Stage 1 — 模式扫描：

• qmd multi-get "wiki/concepts/*.md" -l 40
• qmd multi-get "wiki/entities/*.md" -l 40
• qmd multi-get "wiki/synthesis/*.md" -l 60

Stage 2 — 深度合成：写入 wiki/synthesis/<topic>-synthesis.md

Stage 3 — Gap Analysis：

• source_count=1 且创建 >30 天的孤立概念
• 多处提及但无独立页面的概念/实体
• 输出到 wiki/outputs/gap-report-YYYY-MM-DD.md

五、MERGE（合并）操作规范

触发词：merge、去重

同语言合并

1. 与用户确认（绝不自动合并）
2. 主 slug 保留，更新 wikilinks
3. 被合并文件替换为重定向文件

跨语言合并

1. 主 slug 保留英文
2. aliases 取并集
3. 内容按并集+去重合并
4. 旧 slug 保留为 redirect 文件

六、ADD-QUESTION 操作规范

触发词：我想搞清楚、add question、记录一个问题

1. 将问题规范化
2. 追加到 wiki/QUESTIONS.md（checkbox 格式）
3. 追加 wiki/log.md

七、系统规则

Wikilink 格式铁律

所有 wikilink 目标必须使用英文小写连字符格式：

中文名称写入 concept 页 aliases 字段。

禁止使用 wikilinks 的场景

• 不得引用系统文件：[[log]] [[index]] [[overview]] [[QUESTIONS]]
• 不得引用 lint 报告：[[outputs/lint-xxx]]
• 不得以操作名称作为 wikilink：[[ingest]] [[query]]
• log.md 使用纯文本路径

Wiki 语言规范

• Wiki 层统一中文写作
• concept 页 title 使用中文主名称
• slug（文件名）统一英文小写连字符
• aliases 覆盖中英文所有叫法

Confidence 更新规则

个人写作不参与 count。

Source Integrity Rules

• re-ingest 规则：lint 报告 ⚠ SOURCE MODIFIED 时重新摄入
• 来源 >2 年标注 possibly_outdated: true
• 矛盾来源必须在 Contradictions 节显式记录

系统文件隔离规则

以下文件 frontmatter 含 graph-excluded: true：

• wiki/log.md、wiki/index.md、wiki/overview.md、wiki/QUESTIONS.md
• wiki/outputs/ 下所有文件

文档维护规则

当此 skill 规则更新时，同步更新 USER_GUIDE.md 对应章节。