coding-agent/GraphRAG增强版_20260920/验证结果/中文命名修订验收.md

中文命名与具体对象教学修订验收

2026-09-20。修改仅在 GraphRAG 增强版副本中，已同步第五章独立代码。页面已刷新为新版 5.2。

教学变化

• 从 (蛋糕:商品)、(果酱:半成品)、(草莓:食材) 开始，不以 Entity 或泛化的“实体”作为入门示例标签。
• 图和表格明确区分：蛋糕是查询临时变量，商品是分类标签，名称是属性名，招牌蛋糕是实际保存的属性值。
• 自定义分类、关系、图属性、参数和查询变量使用中文。MATCH、WHERE、RETURN、AND 和语言/驱动函数保留原写法，旁边解释用途。
• 三个逐行讲解片段明确提示不能独立运行；完整三行查询可以直接执行。
• 5.7 多跳查询、后续新增章节的示例及图解同步中文命名。原有短代码块风格保持。

真正执行的验证

检查	结果	记录
物理图名称迁移	84 个节点、108 条关系转换完成，先备份、单事务修改	中文命名迁移.json
重复迁移	0 节点、0 关系需要转换，无重复数据	中文命名重复迁移.json
直接驱动中文查询与语义回读	17 项通过	中文Cypher实测.json
课件完整查询及中文参数	6 段逐条执行成功；3 个拆解片段另行标注	课件中文查询实测.json
整合主线回归	49 项通过，另有 51 个子用例通过	pytest-chinese-schema.log / xml
保留 IT 附录回归	独立集合中 9 项全部通过	pytest-chinese-legacy.log / xml
第五章独立项目	使用 --scope 甜品店 完成真实融合问答，3 份必要来源齐全，警告为 0	中文命名独立问答.json
课件静态检查	47 页、20 幅图、29 处真实源码摘录；0 问题、0 外部关键依赖	../research/course-validation.json

当前主图的 22 个对象、31 份原文、27 条业务事实，经过中文存储及反向映射后，与导入前的内部数据逐字段一致。Neo4j 的业务标签、关系类型、属性键均已中文化；Python/JSON/Milvus 的既有字段和稳定编号保留，以保持同源证据对应。编号是内部关联标识，不作为教学例子的节点名称。

此前 54 次三模式评估保留为首次实测，本次未重新生成整套评估数字。此次通过真实服务回归、逐字段数据核对和独立模型问答确认中文命名改造的兼容性。

页面与交付

实际浏览器确认新版 5.2 已刷新，具体对象说明、中文查询和两幅图正常显示，无脚本错误；573px 当前视口下页面无横向溢出，图使用独立横向滚动区。问答服务已按新版代码重新启动并返回 HTTP 200。

图名称映射位于 graph_qa/graph_names.py，独立迁移入口为 python -m graph_qa.migrate_chinese_names。备份位于增强版的 research/中文命名改版前备份，不含账号密码或模型权重。模型没有重新下载。

原目录存在用户其他任务同时进行的代码和课件修改，哈希差异已记录在 中文命名原件校验.json；本任务未还原或覆盖那些文件，所有编辑路径均位于增强版或已授权维护的课件制作技能中。

制作偏好已持久保存到课程制作技能：用具体中文对象讲解，自定义标识符可中文化时先验证，先分清变量、标签、属性和值，再介绍抽象术语。

命名规则参考：Neo4j 官方 Cypher 命名说明。上述示例另以本机 Neo4j 5.26 实际执行结果核实。