nexus/wiki/concepts/IngestWorkflow.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
IngestWorkflow	concept	workflow knowledge-management llm	llm-wiki	2026-05-02

Overview

导入工作流（Ingest Workflow）是 PersistentWiki 的核心运营模式之一——当新源添加到 raw/ 目录时，LLM 读取、处理并将其整合到 Wiki 中。

Standard Process（9步）

1. 读取源文件：完整读取待摄取的源文档
2. 了解上下文：读取 wiki/index.md 和 wiki/overview.md
3. 生成 Source Page：创建 wiki/sources/<slug>.md（参照 Source Page Format）
4. 更新 Index：在 wiki/index.md 的 Sources 节添加新条目
5. 更新 Overview：如有修订必要时更新综合摘要
6. 更新/创建 Entity 页面：为关键人物/公司/项目创建或更新实体页
7. 更新/创建 Concept 页面：为关键想法和框架创建或更新概念页
8. 检测冲突：记录与现有 Wiki 内容的矛盾
9. 追加 Log：在 wiki/log.md 中追加时间线条目

Trigger

触发方式：用户说 "ingest " 或 "摄取这个文件：raw/xxx.md"

Design Principles

• 一次源可能影响 10-15 个 Wiki 页面：更新实体、概念、摘要、交叉引用
• 单源优于批量：作者偏好一次导入一个源并全程参与，可更好把控知识整合质量
• 批量可行：也可以一次性批量导入，减少监督

Related Workflows

• QueryWorkflow：查询工作流——用户提问，LLM 从 Wiki 检索答案
• LintWorkflow：检查工作流——定期健康检查 Wiki 质量