16.2 三处消费的联调
把同一份规格上的三处消费串成一次联调:穷举给出完整可达状态数与结局分布,执行让确定性策略 first 走到底并算出整数摘要 4162796975,度量给出覆盖率与张力曲线残差。P 层用 TypeScript 内核重放同一条路径,摘要与 S 层逐位相同,验证引擎与规格同源。
category
把同一份规格上的三处消费串成一次联调:穷举给出完整可达状态数与结局分布,执行让确定性策略 first 走到底并算出整数摘要 4162796975,度量给出覆盖率与张力曲线残差。P 层用 TypeScript 内核重放同一条路径,摘要与 S 层逐位相同,验证引擎与规格同源。
装配检查表把本卷十五节交付的零件收成十二项可断言的检查:规格可解析、引用完整、写入域合法、整数不变量残差 0、规模对账、BFS 与基线一致、goto 全部存在、结局全部可达、跨语言锚点一致、W 层零外部依赖、覆盖率达目标、无卡死路径。S 层脚本逐项跑出 PASS/FAIL 表,任一项 FAIL 即非零退出。
把基线摘要、结局分布、整数不变量残差落成回归基线文件,规格每改一次就重跑比对。本节给三类告警:摘要失配、分布漂移、残差非零,各配一个内存内注入负例,实测三组全部触发。告警只打印 WARN 并 exit 0,与 B 层口径一致;而负例测试必须硬失败。
把随机路径当模糊测试的输入:用自实现可播种 PRNG 跑 20000 条路径,断言全部终止于 5 个结局之一、无卡死、无越界。实测分布为离港 10074、沉没 5507、缄默 3223、灯守 1018、真相 178,最稀有的真相仅 178 条。Python 与 TypeScript 两侧对同一批路径的终局状态摘要逐位一致。
属性测试不问「跑一遍对不对」,而问「一条命题是否对所有输入都成立」。本节把第 3 / 6 / 8 章的不变量写成六条属性:好感度恒在 [0,100]、set 类算子幂等、add 故意不幂等、静态死路 0、5 个结局全可达、每状态至少一个可用选项,并给每条属性配一个必须 fail 的注入式负例。
什么必须逐位相同、什么允许不同,本节写成一张容差表:整数状态(好感度、flag、item、节点 id、路径)必须逐位;浮点派生量、对象键序、文本渲染、时间戳允许不同。负例把好感度钳位上限从 100 改成 99,实测 12 / 500 条路径摘要改变,首个分歧点定位到路径 #13 第 20 步 c_fg_1a 的 shen。
同一条确定性策略路径(总是选第一个可用选项,25 个事件)在 Python、Node 内核与浏览器内联三个宿主上推进,终局节点 e_lit、结局 灯守、FNV-1a 摘要 4162796975 三侧逐位相同。本节给出宿主差异清单:整数运算、取模、Math.imul 与大整数、对象键序、Unicode 归一化,逐条说明为何不影响状态摘要。
摘要用 FNV-1a 32 位,只对 canonical 规范串(状态)做,不对台词文本做。本节实测同一批 500 条路径(seed=20261016)在 Python 与 TypeScript 两侧逐位相同 500 / 500,前 3 条摘要为 3976226298、3848604931、1198029437,并与卷一同种子采样逐位相同,证明卷二未另立真源。
四类文本一致性校验一次算齐:漏键、悬空键、变体覆盖、占位符。前两类残差为 0;变体覆盖报出 d_lt_2 欠声明(有 line_when 无 line_else,按规则回落,只报不判失败);占位符残差 0,并给一条负例。本章只做结构一致性,译文质量与字体覆盖需真实业务环境,命令行不可复现。
同一条键在不同状态下要渲染不同文本,这是条件变体;同一句话在不同数量下要选不同形式,这是复数。本节给出 2 个带条件变体节点的覆盖矩阵(1 完整、1 欠声明),并给出 zh-CN 与 en-US 的最小复数规则对照——中文退化为单类,复数只在对照语言上有意义。
文本是规格的一种渲染产物,而键是文本表与规格之间唯一的连接点。本节从 dialogue 段抽出全部文本键——48 条 line、1 条 else、115 条选项文本,共 164 键——给出键命名规则与漏键 / 悬空键检测,并各给一条负例。只做文本的结构一致性,不评价译文质量。
读档后从存档点继续推进,必须与从头一次走完得到逐位相同的终局状态。本节沿 25 步路径在第 1、5、10、15、20、25 步分别存档读档,终局规范串全部相同;并给出负例:把存档里的好感度篡改成 999,宽松读档钳位到 100 并记录修复,严格读档直接拒绝,检测器抓得到。
存档是状态的规范序序列化:键按字典序、值全是整数、无浮点、无时间戳、无随机。本节把一条 25 步路径的终局状态写成 795 字节的存档 JSON,验证字段与 canonical 串一一对应,并让序列化到反序列化再序列化两次字节完全相同;同时点明临时 UI 状态、派生量、绝对时间不能进存档。
用固定种子采样 20 条路径,逐条把选择序列注入页面,断言终局节点、结局与状态摘要与 Python 侧一致,批跑通过 20/20、覆盖 4 种结局。失败时原样打印选择序列便于重放;S 层落成 JSON,P 层 core/test 回放对照。
把 25 步序列走完后的终局状态读回来断言四件事:终局节点 e_lit、结局 灯守、终局摘要 4162796975(与 Python 与 TS 侧逐位一致)、同一序列跑两遍摘要不变;再截图到 out/shots/ 并给出 PNG 字节数。只对整数状态写逐位一致。
用 Playwright 无头打开 web/dist/ne10.html,靠 data-choice-id 选择器契约注入一条 25 步的完整选择序列真玩一遍:逐步记录节点 id 与当前好感度读数,并断言每一步注入的选项都落在规格该节点的可用集合里,终局摘要 4162796975。
同源的意思是同一份规格在 Python 与 TypeScript 两侧推进同一选择序列,整数状态摘要逐位相同。本节用四种确定性策略各走一条路径:Python 侧落出四条路径的选择序列与 FNV-1a 摘要,TypeScript 侧读回产物原样重放,断言规范串与摘要两侧完全一致。
规格驱动的意思是引擎里没有一条硬编码剧情:可用的选项来自 dialogue 的 choices 加 when 求值,状态推进来自 state 的四个效果算子,终局来自 endings 的 when 判定。本节用一份 TypeScript 模块与四条断言证明这台状态机的全部行为都由 spec 的三段决定。
叙事引擎可以被抽象成一个三元组:状态(节点、好感度、flag、物品、路径)、事件(一次选项点击)、转移(纯函数 step)。本节把《雾港夜航》的引擎压到这三个词上,并用一份 S 层脚本打印一条 25 步路径的逐步骤状态轨迹与每一步之后的 FNV-1a 摘要。
《叙事策划与叙事工艺》卷二《叙事引擎与分支系统》目录:16 章 48 节,把 story_spec.json 变成可执行的对话状态机——条件求值、效果应用、确定性回放、状态空间穷举、可玩原型与跨语言摘要。本页给出分工说明、六档可运行性口径与全书 16 章 48 节完整清单。