资料摄取 Ingest｜从添加资料到核对 Wiki
保存资料、检查处理过程、确认主题，再核对生成文件和原文。
- 开发预览
- 本页模块仍在开发预览中，实际入口以当前版本为准。
这篇教程按“保存 → 处理 → 审核 → 生成 → 核对”操作。第一次建议选一份结构清楚、自己熟悉且有权处理的短文。先配置可用的文字模型，需要扫描文字识别或图片理解时，再核对视觉模型能力。
1. 添加资料并选择保存位置
- 打开知识库的“资料”页。
- 点击“添加资料”。
- 选择“文档”并添加支持格式的文件，或切到“网页”填写地址。
- 选择保存分类。
- 按需修改资料名称和标签。
保存分类来自配置的 Resources 根目录，通常是 3. Resources 的直接子目录。保存分类管理原始来源，最终 Wiki 的知识域管理知识主题，两者不必同名。支持格式和限制见来源说明。
先检查文件格式与保存分类。截图没有选文件，也没有提交资料。
2. 核对识别选项，再保存
展开“处理选项”，按资料内容决定：
- 分析图片与图表：默认关闭。开启后尝试理解图片内容，会增加模型调用。关闭时保留原图。
- 识别扫描页文字：默认开启。只在缺少可靠正文时识别文字。关闭后遇到扫描页会停止处理并提示启用。
准备好后点击“保存资料”。资料原件先保存，之后进入处理流程。若后续处理失败，先检查资料是否已经出现在列表中，不要直接重复导入。
网页输入和两项处理选项的实际界面。本次只展开检查，没有保存或调用模型。
3. 查看处理过程与等待状态
从资料的更多菜单打开“查看处理过程”。检查当前尝试、失败步骤及提示，需要时查看处理全文。先核对解析结果，再判断模型是否漏读了来源内容。
运行中会经历读取、解析、识别、分块、索引和 Wiki 整理。准备好候选主题后，流程等待人工确认。不要因为已经有候选主题就判断最终 Wiki 已生成。
这张历史记录已显示“知识已生成”。它用于认识阶段与日志，等待审核时的状态会不同。
若失败，先处理具体原因，例如模型不可用、扫描识别未开启或来源读取失败。重新处理可能产生新的尝试和模型费用。已经写出的部分文件不一定回滚，重试后仍需核对产出。
4. 审阅候选主题
打开资料预览的“候选主题”。先读标题、说明、类型与子类型、别名、知识域及原文依据。确认每个主题说的是谁、是什么、准备保留哪些内容。
需要时修改标题、说明、类型或别名，取消不需要的主题，也可提出原文支持的新主题。新增或改变主题身份会进行证据检查。根据反馈调整，不要把相关概念互作别名。主题属于哪个知识域也应核对，界面可编辑字段以当前版本为准。
这是已有任务的三个已确认主题，处于只读状态；不是正在等待你确认的新提案。
收藏建议、理解顺序和是否勾选分别表达保留价值、阅读先后和本次选择。低收藏等级不会自动取消勾选。检查理由后，再决定保留哪些主题。
5. 回到原文检查依据
展开某一主题的原文依据。检查引用片段是否真的支持主题，再通过“查看上下文”阅读附近内容。只有提到了相同名称，不足以证明整篇写作范围都有依据。
例如，同一来源介绍 DuckDB 与 Rust Appender 方法，可以形成关联主题。它们不是同一个身份，也不应因为在同一段出现就合成别名。
已有主题展开了四处原文依据，并提供“查看上下文”。逐条核对后再决定写作范围。
6. 保存选择，再确认生成
待审核时，“保存选择”保留本次修改，让你稍后继续。准备好后再点击“确认并生成”。没有选择主题时，按界面提示核对本次不生成主题的决定。
保存选择不启动正文写作。确认请求还会检查提案版本，遇到过期提示应重新加载再审核。开始生成后，仍需等待写作与保存阶段完成。此步骤的按钮行为已经代码核对；新的待审核按钮截图与完整操作仍待补验，本轮没有对新的待审任务点击确认。
7. 打开产出并检查正文
处理完成后，从处理过程点击“查看知识产出”。逐一打开主题笔记与来源摘要，检查主体、范围、引用和关联链接。
真实历史产出列表可以打开保存内容。主题、摘要与导航应分别检查，不能只看文件数量。
至少检查一处能亲自核对的论断。对照原文，检查是否存在断章取义或无依据的综合。主题审核确认了写作选择，仍不等于逐句审核了生成正文。
8. 从来源继续使用知识
回到资料的原文页，查看“关联知识”。进入 Wiki 后沿链接阅读，再把有用笔记加入工作上下文。
同一原始网页连接三篇主题笔记，来源保留在资料侧，综合内容在 Wiki 侧。
同一主题的后续来源可以参与已有知识的整理。管线以来源为单位维护受管内容，保留受管块外的人工内容。不要据此推断所有混合修改都能无冲突合并。遇到内容变化或冲突提示时，先阅读差异再重试。
下一步：让 Agent 调用同一流程，或阅读与检查知识笔记。
同一资料从不同入口处理
本页资料表单的默认是图片分析关闭、扫描页识别开启。Agent 启动采用后端默认，两项都开启。需要限制图像发送和调用范围时，先在界面明确核对处理选项，再启动；仅关闭图片分析不等于同时关闭扫描页识别。更多边界见Agent 摄取。
文档核对说明
- 查看编写与验证范围
- 对应操作截图待补
- 当前审核配图是历史已确认结果，新的待审核提案、编辑、保存选择与确认生成仍需对应实拍。
- 开发预览与截图范围
- 当前源码在开发模式开放资料处理，生产默认入口仍关闭。本页说明按当前代码核对。实拍来自 Windows 开发实例，完成记录使用已有公开 DuckDB 资料；本轮没有导入新资料、确认主题或重新生成 Wiki。
内容来自 Orrery Desktop 的 Wiki，文档仍在持续完善。功能开放情况以当前版本为准。