# RAGFlow PageIndex 教程：把借用手册的规则与例外定位回具体章节

## 实际范围

需可用 RAGFlow 1.0.0-rc1 实例、embedding/chat 模型和实际解析记录。官方部署起点为 x86-64、16GB RAM、50GB 可用磁盘；本练习未部署 RAGFlow、未嵌入、未编译知识。代码 Apache-2.0，模型许可另计。

已实际执行：原创输入生成、PDF渲染、文件哈希/教材事实检查与两条故意错误拒绝。人工reference-manual.json不冒充目标工具输出；actual-template.json为空模板，不能视为实际结果。

## 使用

```bash
python3 verify.py
python3 verify.py --actual my-observation.json
```

默认材料检查使用Python标准库；可选的--pdf深度检查需要pypdf，且只接受本题定义的PDF契约。不连接任何外部服务或数据库。--actual检查你填写的规范化事实记录，不自动识别任意工具原生导出；仍须逐项回读原生输出。

## 七步操作

1. 读取五页手册和三个问题

source.pdf 是本站原创设备借用手册，共5页。规则在第3页，天气例外在第4页；先人工回答 Q1–Q3，避免把答案是否顺耳当检索成功。

2. 确认当前Knowledge Compilation版本

固定自己的 RAGFlow 版本。1.0.0-rc1 文档使用 Knowledge Compilation；旧 RAPTOR 开关的截图与参数不能直接替代当前 PageIndex 模板。

3. 配置PageIndex编译流程

在实际实例创建 PageIndex 模板，将 Parser、Chunker、Compiler、Indexer 连接到 Ingestion Pipeline，Compiler 选择该模板；仅创建模板不代表已经生成产物。

4. 上传并运行实际编译

将 source.pdf 上传专用测试 Dataset，选择对应 Pipeline 并执行。等各节点实际完成，保存任务日志；本站未部署该实例或运行编译。

5. 检查章节层级再问问题

在 Artifacts 查看 PageIndex，核对目录顺序和附录位置。查询 Q2 时回读第3和第4页，区分普通18点规则和需值班员确认的例外条件。

6. 填写事实与来源观察

按 actual-template.json 保存三条实际回答和一基源页码。脚本只核对本题事实记录，不能代替浏览实际索引与原页。

7. 保存失败节点和缺来源负例

如果索引缺例外章节，保留实际任务错误后修复，不用人工目录图冒充编译成果。负例会拒绝只引用第3页的延期答案。

## 原创与图片身份

source.pdf及数据文件是本站原创虚构教材。页面官方截图只说明工具入口；人工真值图与材料核验图都注明身份，未生成目标软件的假界面或假模型结果。

## 官方依据

- PageIndex 与知识编译: https://ragflow.io/docs/v1.0.0-rc1/knowledge_compilation/overview
- Pipeline 与 Artifacts 操作: https://ragflow.io/docs/v1.0.0-rc1/knowledge_compilation/apply_knowledge_compilation_template