审查 hands-on-rag-for-production-design — 2026-08-29

结论: ISSUES(3 条,其中 1 条致命)

门禁实跑(本人重跑,非写手自报):

book-verify: 1 本有拆解、共 633 处出处、0 处对不上
book-jargon: 1 本,共 0 处专业词没解释就用了
生面孔配额:段级超额 0 处(上限 1)、节级超额 0 处(上限 5)   (--quota)
book-dodged: 1 本,共 0 个词被躲开(阈值:原书出现 ≥15 次)

抽查记录:5+ 条脚注全部属实(production wall、paramount、San Jose 类比、版权页双作者、 storage_usage 9215、HippoRAG ~20%、Caselaw 7M);三处主走查数字逐一回核原文全对上 (ch03 TTFT 31/82/1833ms、42 小时、8k、$6.88/hour;ch08 重排 0.8385/0.5913/0.2138/0.0001、 HHEM 0.9182/0.0823、绩效评审 #7→#1;ch07 $4,160/$4,916 成本账)。 判断块 3+1 条全带「如果错,会错在」;总纲 §2 主线可独立成篇、海拔合规; 台账零泄漏;TODO(没懂) 零命中;生词/台阶抽查(01/03/05)未发现跳级。

问题清单

1. [16-future-of-rag.md] 致命:整份文件是 11-evaluation.md 的原样复制,真正的原书第 10 章拆解根本没写。 diff 两文件仅差 3 个空行;frontmatter id 两边都是 hands-on-rag-for-production-design-evaluation,title/正文/脚注/原文地图全部相同。 后果链:

   • 违反完整性自检——原书 Chapter 10. The Future of RAG(text/133-ch10-chapter-10-the-future-of-rag.txt,21,367 字符:late interaction/ColPali、System 2、数据重力与联邦检索、长上下文下 RAG 的角色、边缘 SLM、治理与「企业的大脑」)在 16 章里零覆盖(全库 grep「System 2/数据重力/late interaction」只有别章顺带一提);
   • 违反「许诺要兑现」——index §2 ⑨「(第 16 章。)」、兑现表两行(「本页 §2 ⑨ → 16 §5、§8 ✓」「16 §3 → 13 §5-§6 与 16 §3 ✓」,两处 ✓ 是假勾)、02:72「第 16 章会回到这个话题」、07:159「第 16 章才回来」全部扑空;index §3 地图第 16 行描述的是未来章内容,点进去却是评测章;
   • 书卡 claims 第 6 条(未来趋势分辨框架)没有任何拆解章兑现,书卡与实际覆盖不一致;
   • 同 id 撞车会破坏文档站构建(book-build 把两文件当两章,页面 id 冲突);
   • 四条门禁对它全绿——因为复制来的 633 处脚注本来就能对上,这正说明门禁查不出「写错文件」,必须人审。 写手其实在 notes/01-outline.md §16 里按五节规划过本章、reading-notes 也留了素材, 却在成文时把 11 章复制进了 16。 修法:按大纲五节(检索演化/agentic 转移/数据重力/长上下文与边缘/治理与收尾)重写 16-future-of-rag.md,frontmatter id 改为 …-future-of-rag、sourceChapters 改为 ["Chapter 10. The Future of RAG"],逐条核对本页列出的扑空许诺;写完重跑四门禁 + book-verify。此条不修,全书不算完。

2. [index.md §4、15-knowledge-graphs.md] 「生产工程全景」的四书分工没讲。 本案定位是库内 RAG 书堆的全景锚,但 index 与全部 16 章对另外三本 RAG 书 (essential-graphrag / rag-ready-patterns-for-data-platforms / unlocking-data-genai-rag) 零提及(全库 grep 为空)。而另外三本各自都声明了书堆位置: rag-ready-patterns §5 判断块明写「本书是 RAG 书堆的上游,米进锅之前的事」, essential-graphrag/unlocking-data 的不覆盖表都指向别书补位。本该由全景这本反向把网收拢: index §4「覆盖什么/不覆盖什么」加一小节四本分工(本书=生产工程全景;essential-graphrag= 微软 GraphRAG 专精;rag-ready-patterns=检索上游的数据平台改造;unlocking-data=企业数据 策略面);15 §5 讲 Microsoft GraphRAG 处与 14/11 讲评测框架处,顺手一行书架指路 (按 BOOK-TEARDOWN ② 类脚注格式,带 事实=)。违反的是 workspace 分工判定与 「书架之间互相指得到」的要求。

3. [index.md 开头] 30 秒导读有一句残缺句,RAG 定义四行内讲了两遍。 导读第二段「…再把检索到的事实连同问题一起交给 / 让它照着材料写答案」—— 「交给」后面缺宾语(模型),句子断了;且第 33 行括号已完整解释过 RAG 缩写, 导读内又展开一遍「RAG 这个缩写,英文展开是 retrieval-augmented generation:…」, 是两版草稿合并没清干净。违反行文第 8 条(一词一义/一次讲清)与基本的成稿自检。 修法:补上「交给模型」,删掉导读里的重复展开,保留一处定义即可。

已核过、无问题的项(备查)

• 覆盖映射(导航章除外):原书 136 文件中,praise/书名页/Index/Colophon 为导航章; 版权页、双序言之一(Jim Dowling)、Preface、About the Authors 均被引用;原书 Ch1→拆解 01+02,Ch2→03+04+05+06,Ch3→07+08,Ch4→09,Ch5→10,Ch6→11,Ch7→12+13,Ch8→14, Ch9→15,Ch10→缺(问题 1)。Foreword by Sharon Zhou 未引(赞语类,可接受)。
• 红线一:抽查 8 条脚注无整段搬运,引用均限短句;
• 红线二:16 章每章有主走查且落在正文,数字多为书内实测,演示值全部当场标注「为演示编的」;
• 红线三:jargon/quota 全绿,抽读未见一段多词、未见文首生词表;
• 分声:利益相关(Vectara)在总纲 §1、§5 判断块与 10/08 章内都点名,作者推测与书内证据分开标注;
• 总纲六节齐全、§2 主线九步因果链独立成篇、机制细节基本留在章节层;书卡 readState/claims/notCovered/soWhat 填写完整(除问题 1 波及的 claims 第 6 条)。