Wiki 数据摄入

wiki-ingest
分类写作
作者Alireza Rezvani
许可MIT
评分4.30/5
使用10.8K

<!-- 正本：engineering/llm-wiki/commands/wiki-ingest.md — 请保持同步（根目录副本使用相对于仓库根目录的脚本路径） -->

/wiki-ingest

将新源文件导入 LLM Wiki。这是最常用的命令。

工作流：读取源文件 → 与你讨论 TL;DR 和核心观点 → 编写源文件摘要页 → 更新所有相关的实体和概念页面 → 标记矛盾点 → 更新 index.md → 写入 log.md。

一次典型的导入会涉及 5-15 个 wiki 页面。用户将参与其中：导入程序会提出修改建议，并在写入前等待你的确认。

用法

code
/wiki-ingest <path>
/wiki-ingest raw/papers/monosemanticity.pdf
/wiki-ingest raw/articles/2026-04-01-interpretability-post.md

执行流程

1. 准备 (Prep) — 运行 engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py 以获取标题、预览和建议的摘要路径
2. 读取 (Read) — 直接读取源文件
3. 讨论 (Discuss) — 汇报 TL;DR、核心观点、将涉及的页面以及任何矛盾点
4. 确认 (Confirm) — 等待你的批准（或重定向）
5. 写入 (Write) — 创建源摘要，更新 5-15 个页面，标记矛盾点
6. 索引 (Index) — 运行 engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py 或直接编辑 wiki/index.md
7. 日志 (Log) — 运行 engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py --op ingest --title "<title>"
8. 报告 (Report) — 以列表形式提供所有涉及页面的 wikilinks

子代理 (Sub-agent)

此命令将调用 wiki-ingestor 子代理来处理繁重的工作。详见 agents/wiki-ingestor.md。

脚本

  • engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py — 源文件准备（元数据 + 预览）
  • engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py — 重新生成索引
  • engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py — 记录导入日志

规则

  • 源文件必须位于 vault 的 raw/ 层。如果不在，命令会要求你先将其移动过去。
  • raw/ 是不可变的 —— 导入程序仅执行读取操作。
  • 如果摘要页已存在，导入程序将进入 合并模式 (merge mode) 并追加一个重新导入章节。

技能参考

→ engineering/llm-wiki/skills/llm-wiki/SKILL.md
→ engineering/llm-wiki/skills/llm-wiki/references/ingest-workflow.md