| name | compile |
| description | 将 raw/ 中的素材编译为 wiki 条目，更新索引和关系图谱。Use when the user wants to process pending raw materials into wiki entries. |
| argument-hint | [素材文件路径] |
/compile — 编译素材到 Wiki
将 raw/ 中状态为 pending 的素材编译为 wiki 条目。
工作流
- 读取
raw/_registry.md，找出所有 pending 状态的素材
- 如果用户指定了具体素材，只编译该素材；否则编译所有 pending 素材
- 对每个待编译素材：
a. 读取素材内容
b. 根据素材类型选择对应的 prompt 模板（
templates/prompts/compile-article.md 或 compile-paper.md）
c. 提取核心概念列表
d. 匹配阶段：读取 wiki/_index.md 和 wiki/_graph.md，扫描已有 wiki 条目，为每个概念判定：
- CREATE — wiki 中无对应条目 → 按模板新建
- UPDATE — wiki 中已有对应条目 → 读取原条目，合并新信息
e. 执行创建新条目 / 更新已有条目
f. 扩散更新阶段：扫描 wiki 中所有已有条目，检查是否有条目应该补充本次新素材的信息（即使该条目不在步骤 c 的概念列表中）。一个素材可能触及 10-15 个已有条目。对这些条目：
- 补充相关新信息到合适的小节
- 在 frontmatter 的
sources 中添加本次素材路径
- 更新
updated 日期
- 添加新的
[[wikilinks]] 如果出现了新的关联
g. 用 [[wikilinks]] 链接所有相关条目
- 更新全局文件：
wiki/_index.md — 添加新条目到对应分类wiki/_graph.md — 添加新的概念关系wiki/_changelog.md — 追加条目，格式: ## [YYYY-MM-DD] compile | 素材标题，子条目列出新增/更新的条目和关系- 仅更新有变化的分类
_index.md（如只新增了 concepts/ 条目，不需要更新 topics/_index.md）
raw/_registry.md — 将素材状态更新为 compiled，填写关联条目
Wiki 条目格式要求
- 遵循
templates/content/wiki-concept.md 或 wiki-topic.md 模板
- 必须包含完整的 YAML frontmatter
- 内容用中文，术语首次出现附英文原文
- 每个条目的"概述"不超过 3 句话
注意事项
- 先匹配再创建：编译前必须读取所有已有 wiki 条目的标题和别名，通过标题匹配、别名匹配、内容关键词匹配三种方式确定已有条目
- 合并而非覆盖：更新已有条目时，保留原有内容，将新信息插入到对应小节，必要时扩展小节
- 处理矛盾：如果新素材与已有条目存在矛盾信息，两者都保留，用"注：[新素材] 提出不同观点..."标注
- 更新 frontmatter：更新条目时同步更新
updated 日期和 sources 字段
- 扩散意识：一篇关于 Transformer 的文章不仅要更新 [[concepts/transformer]]，还可能要更新 [[concepts/attention-mechanism]]、[[concepts/self-attention]]、[[topics/nlp]] 等
