审查 shen-ru-li-jie-ai-agent — 2026-08-27
结论: ISSUES(4 条实质 + 1 条轻微)
门禁实跑:
book-verify: 1 本有拆解、共 1128 处出处、0 处对不上
book-jargon: 1 本,共 0 处专业词没解释就用了
生面孔配额:段级超额 0 处(上限 1)、节级超额 0 处(上限 5)
book-dodged: 1 本,共 0 个词被躲开(阈值:原书出现 ≥15 次)
抽查结果(过项):5 条脚注回核原文全部属实(03[^1] 时间戳事故=04-ch02.txt:393;08[^15] 49%→74%=06-ch04.txt:159;10 Pass^k 7.8%=08-ch06-6-agent.txt:295;13 WebGen 26.4%→51.9%=12-ch10-10-agent.txt:117;06 User as Code 6%–43%=05-ch03.txt:141)。 9 处书架锚抽 5 处:mcp-spec/browser-use/a2ui/ag-ui 四处「事实=」与书架内容吻合; mem0 一处不成立(见问题 2)。13 章均有主走查、全落正文、带具体数或字串(抽核 01/03/ 08/09/12/13 六章)。原书 ch2 拆四份(02-05)、ch3 拆两份(06-07)各自独立成链,衔接处 显式交棒(02 §3.5 图说点明 02-05 分工;06 §5 明说向量细节留给 07;07 §3.8 合流双层 记忆),无重复无断层。零基础试读 03 §2-§3.2、04 §2-§3.4、13 §3.1 均一路读通,数字 有参照物,生词就地解释。判断块 3 处全带「如果错」;章内「是作者的判断」均与证据分开。 无台账泄漏;frontmatter 六字段齐全;总纲六节齐全、§4 首行写明时效截点(数字停在 2026 年年中)、§5 写明「引机制,别引数字」。
问题清单
-
[全书/完整性] 原书第 8 章「Agent 的持续进化」整章未覆盖 — 违反收尾自检第一条 「原书每一章都被覆盖了吗」与诚实条款。
text/10-ch08-8-agent.txt(455 段、约 2.4 万 字符)讲三层 轨迹验证器、四种更新载体(知识/Prompt-Skill/程序/参数)、经验知识库与 版本化发布,是全书「从会做到长期变好」的枢纽章(后记明说它是全书汇合点, 13-fm-agent-llm.txt:15)。13 章 sourceChapters 均未含它,正文仅 13-multi-agent.md:194 一句括号带过;index §4「不覆盖」表也没有把它声明为有意不覆盖——读者无从知道这章 被跳过了。书卡 readChapters 列了它,但 claims/notCovered 均未反映。 修法: 补写一章(可按 8.1 轨迹验证 / 8.2 四种更新方式 / 8.3 版本化与回归的链条, 主走查可用实验 8-1 的客服轨迹验证器);若确有理由不拆,须在 index §4 与书卡 notCovered 里如实声明,并处理 06:177、13:194 两处指向「第八章」的引用。 -
[06-user-memory.md §3.6 脚注 17] mem0 书架锚「事实=」与我们自己的书架矛盾 — 违反「锚没腐烂」与 ② 类来源取材要求。锚写「事实=Mem0 的 add 流程先经 LLM 提取候选 记忆、再逐条与既有记忆比对后入库,与书里的两阶段描述一致」,但所引书架
ai-frontier-reference/docs/mem0/01-add-pipeline.md(sourceCommit 001c235)通篇说的 是反的:essence「单次 LLM 调用的 ADD-only 抽取 + md5 哈希去重」;§2「把 『判断要不要改旧记忆』这件难事从写入端拿掉」;§7「只增不改……md5 去重只挡 逐字重复」。即这个 pin 版本根本没有「逐条与既有记忆比对后决策入库」的阶段——书里 的「提取—对比—决策」是论文口径,与书架实现不一致。锚把不一致写成一致,读者会 带着错误的 Mem0 心智模型出门。 修法: 改写该锚,如实写「书架 pin 的开源实现把对比决策从写入端拿掉、只做 ADD-only+哈希去重,与书中论文口径不同」;正文 §3.6 相应补一句分歧说明。 -
[index.md §1、09-coding-agent.md §4] 利益相关声明把 OpenClaw 写成作者团队的方向, 与原书相悖 — 「这是谁在什么时候写的」一节的立身之本是准确。原书处处把 OpenClaw 标为第三方开源项目:03-ch01.txt:486「开源全能个人 Agent」、07-ch05.txt:61「开源项目 OpenClaw 也采用了类似思路」、05-ch03.txt:542「OpenClaw(开源 Agent 框架)」;作者 自家产品是 Pine(02-fm.txt:13),全书未见作者与 OpenClaw 的隶属关系。index §1 「第 5 章的 OpenClaw 也是他团队的方向」与 09:214「作者的创业方向(OpenClaw)恰好 建立在这个判断上」均无出处支撑,属把第三方项目记到作者头上。 修法: 删去或改写这两处;利益相关保留 Pine AI 产品案例、自家论文作正文依据这两条 有据的即可(09 §4 那句同时承担「判断与证据」分层职能,改写时别把「工业界验证过的 洞察 vs 作者立场」这层对照一起删掉)。
-
[多章] 「第 N 章」两套章号口径混用,多处落点会指错章 — 违反行文第 8 条(一词 一义)与兑现表记账要求。全书实际混用三套写法:零填充「第 04 章」=拆解章(03:118、 05:72/76、07:192,均正确);中文数字多为原书章号(01:78「第七章讲后训练」=原书 ch7→拆解 11;01:121/142「第四章」=原书 ch4→拆解 08;02:131「第五章讲故障恢复」= 原书 ch5→拆解 09;05:154「第四、五章…第三章」→拆解 08/09/07;06:176-177; 13:139/168/194);但又有中文数字指拆解章(02:144-145 图说「第三章的缓存、第五章 的压缩」=拆解 03/05)。后果:同一文件里两个「第五章」指向不同对象(02:131 vs 02:144);04:147「第五章的通用配置只要七个核心工具」按拆解章号落到 05(压缩)—— 实际内容在 09(原书 ch5);13:139「第四章『审查者须与被审者能力相近』」实际在 08 §3.5;06:177/13:194 的「第八章」则根本没有对应拆解章(见问题 1)。另有若干后向指 (01:78/121/123/142、02:131/190)未在兑现表记账。 修法: 定死一套写法(建议:拆解章用「第 N 章」,原书章一律写「原书第 N 章」), 逐处改掉歧义引用;补兑现表行;问题 1 解决后 06:177/13:194 才有落点。
-
[13-multi-agent.md §3.5] 「编排对编舞」首现无解释(轻微) — 「动机是模拟人类 组织——编排对编舞。」这对借喻(中心化编排 vs 去中心化编舞)是承重对照,零基础读者 此处会卡一下。机检不报(词不在表),按「拿不准就当它需要解释」补一个半句括号即可。 不动正文结构。
逐项判定(收尾自检表)
| 检查 | 判定 |
|---|---|
| 完整性 | 不过(原书 ch8 未覆盖,且未声明) |
| 生词/配额 | 过(门禁全绿,试读通过;问题 5 为漏网一处) |
| 台阶 | 过(抽 03/04/13 段首连读不跳) |
| 走查 | 过(13 章全有,均落正文带实数) |
| 句子/空转词/TODO | 过(dodged 0、TODO 0,抽读无空转词堆积) |
| 数字参照物 | 过(抽查各章数字均有对照) |
| 许诺兑现 | 部分不过(问题 4 的未记账项;已记账 25 行抽查属实) |
| 总纲 | 过(§3 独立成篇;机制细节未上提;时效截点、引机制不引数字均在) |
| 出处 | 过(book-verify 0 错;5/5 抽查属实) |
| 诚实/三个声音 | 不过(问题 3:OpenClaw 归属失实;其余分层清楚) |
| 来源标注 | 部分不过(问题 2:锚「事实=」与书架相悖) |
| 干净/版权 | 过(无台账、无整段搬运) |
| 锚没腐烂 | 4/5 抽查成立,mem0 一处腐烂(问题 2) |
PASS 门槛要求收尾自检每项都过——本书三条不过,判 ISSUES。问题 1 是结构性的(需补一章), 问题 2-4 是定点改(一处脚注、两句话、一轮章号统一),工作量不大但都碰「可信度」本体, 建议一并整改后再送复查(review-02)。