# RAGFlow 知识图谱教程：核对设备、部件、供应方的类型与关系方向

## 实际范围

需可用 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. 读取两份关系原文

equipment.md 和 suppliers.md 明确6个实体、5条有向边。电源模块供应方没有给出；本包人工真值图仅用于验收，不是 RAGFlow 图谱输出。

2. 固定实体与关系规范

在 Graph 模板配置 product/part/supplier 类型；添加 supplies 并写明方向。默认类型不适合本题时先删减，避免同一“温度单元”被拆成两个节点。

3. 配置并执行真实编译

把 Graph 模板接入实际 Ingestion Pipeline，再上传两份原文执行。保存模型、模板与任务日志；没有执行 Compiler 就不会产生可验收图谱。

4. 检查节点同名与类型

在真实 Artifacts Graph 里查看温度单元只出现一次，且是 part；青禾部件社应是 supplier。本站没有运行此界面，官方图仅解释配置入口。

5. 逐条核对关系方向

沿 part_of 从温度单元指向风禾监测站；沿 supplies 从青禾部件社指向温度单元。对于没有供应方的电源模块，不接受模型自行补边。

6. 导出规范化观察清单

按人工真值中的稳定 ID 给实际节点做映射，整理自己的 nodes/edges。脚本按集合核对顺序可变的节点与有向边，不能代替检查原生图谱。

7. 保留原句和错误图

负例分别颠倒方向和替换供货目标。错误边先记录再修正；人工关系参考与真实模型结果放在不同文件，避免混淆。

## 原创与图片身份

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

## 官方依据

- Graph 实体/关系规范: https://ragflow.io/docs/v1.0.0-rc1/knowledge_compilation/built_in_templates_and_dedicated_configuration
- 实际生成图谱的流程: https://ragflow.io/docs/v1.0.0-rc1/knowledge_compilation/apply_knowledge_compilation_template