将文章/文档/笔记摄取为结构化 Wiki…

当用户要求把文本内容编译/摄取到 wiki 或知识库，并希望生成带交叉引用、索引和操作日志的结构化页面时使用。

适用场景

解决思路

1. 遵循铁律：一个 wiki 页面 = 一个知识实体；绝不把多个概念塞进一页。
2. 默认使用当前项目根目录下的 `wiki/`；用户可以指定其他路径。
3. 按默认结构组织：`wiki/index.md` 为完整目录；`wiki/log.md` 为仅追加操作日志；`wiki/concepts/` 存核心概念页面；`wiki/products/` 存产品/工具实体页面；`wiki/patterns/` 存工程模式与设计决策；`wiki/comparisons/` 存跨主题比较页面。
4. 确认输入：接受用户直接粘贴的文本。
5. 确认输入：接受文件路径（md、txt、pdf 等）。
6. 确认输入：接受目录路径用于批处理。
7. 如果用户未指定 wiki 路径，使用 `wiki/`；如果不存在则创建目录。
8. 检查现有 wiki：读取 `wiki/index.md`（若存在）以了解已有页面并避免重复。
9. 从内容中抽取概念实体到 `concepts/`：抽象想法、术语、理论。
10. 从内容中抽取产品实体到 `products/`：具体产品、工具、服务。
11. 从内容中抽取模式实体到 `patterns/`：工程模式、设计决策、方法论。
12. 从内容中抽取比较页面到 `comparisons/`：跨产品或跨方案分析。
13. 应用抽取阈值：只有当实体会被其他页面引用时，才值得拥有独立页面。
14. 创建或更新页面：每个实体映射到一个 wiki 页面。
15. 加载 [references/page-templates.md](references/page-templates.md) 获取页面模板。
16. 如果页面已存在，则更新它，追加新信息，不要覆盖已有内容。
17. 保持一行定义稳定，除非新内容提供明显更好的定义。
18. 优先更新 "Sources" 和 "Related Pages" 部分。
19. 更新交叉引用：检查所有现有 wiki 页面。
20. 如果新内容涉及其他页面引用的概念，更新它们的 Related Pages 列表。
21. 如果新内容涉及其他页面引用的概念，更新它们的 Sources 列表。
22. 如果新内容涉及其他页面引用的概念，在它们的 detail sections 补充新信息。
23. 更新 `index.md`：将新页面条目按类别加入 `wiki/index.md`。
24. 追加到 `log.md`：向 `wiki/log.md` 追加以下格式： ```markdown ## YYYY-MM-DD: Ingest <source title> **Source**: <file path or "user input"> **New pages**: list newly created pages **Updated pages**: list modified pages **New cross-references**: list newly established links ```
25. 报告结果：告诉用户创建了哪些页面、更新了哪些页面、建立了哪些新交叉引用。
26. 文件命名：全部小写、连字符分隔，例如 `agent-loop.md`、`kv-cache.md`。
27. 文件命名：按实体命名，不按编号。
28. 交叉引用格式：使用 `[[category/page-name]]` 双链格式（兼容 Obsidian），例如 `[[concepts/agent-loop]]`、`[[products/claude-code]]`。
29. 交叉引用格式：始终包含类别前缀，以避免跨目录歧义。
30. 交叉引用格式：在每个页面底部列出所有相关页面。
31. 指南：绝不创建重复页面——始终先检查 `wiki/`。
32. 指南：不要抽取琐碎实体——如果一个概念只出现一次且不会被其他地方引用，跳过它。
33. 指南：批处理时，先抽取所有实体，然后一次性创建页面并更新引用，避免不一致的中间状态。
34. 指南：每次 ingest 后始终更新 `index.md` 和 `log.md`。