16.3 交付卷三
卷二交付给卷三《叙事体验与路径度量》的五类接口:规格段、内核函数、仿真产物、原型产物、判据与容差。本节用自检脚本逐项核对磁盘上的段、函数、产物与阈值,再用 W 层脚本在浏览器里复算 16.2 的锚点摘要,并声明边界——本卷只交结构量,体验度量归卷三。
tag
卷二交付给卷三《叙事体验与路径度量》的五类接口:规格段、内核函数、仿真产物、原型产物、判据与容差。本节用自检脚本逐项核对磁盘上的段、函数、产物与阈值,再用 W 层脚本在浏览器里复算 16.2 的锚点摘要,并声明边界——本卷只交结构量,体验度量归卷三。
什么必须逐位相同、什么允许不同,本节写成一张容差表:整数状态(好感度、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,并与卷一同种子采样逐位相同,证明卷二未另立真源。
点赞可以乐观,支付与下单不行。本节按回滚成本把写操作分成四档:即时可逆、可补偿、需服务端确认、绝不能乐观,并给出一个可测试的 TypeScript 判定函数与七类操作的决策表;重点解释为什么资金、库存与对外通知不能靠本地回滚,以及重试策略如何与乐观策略解耦。
用 arch-lab 订单系统实现固定到达间隔的开环 loadgen,并与固定 worker 的闭环对照;真实运行展示服务变慢时闭环如何因协调遗漏少报延迟,附原始输出、数据构造、预热、回放比例与脱敏边界,以及超时统计、并发上限与报告口径的读法。
评论提交比点赞多出正文、时间顺序、草稿保存与失败重发。本节把一条评论拆成发送中、失败、已确认三态:用客户端 clientId 建占位,按时间正序合并,失败时保留原文与草稿,重试复用同一客户端幂等键,并完整复盘一次超时重试导致的重复评论与丢字事故。
卷一交付给卷二《叙事引擎与分支系统》的四类接口:规格段、内核函数、仿真产物、判据与容差。本节用一份自检脚本逐项核对磁盘上的段、函数、产物与阈值,给出交付清单表与验收口径的迁移表,并声明边界——卷二接住执行,不重写条件文法、不重算穷举、不另立真源。
一份散文大纲要变成可执行的规格,中间隔着一层「骨架」:meta 头部加九段内容字段。本节给出散文语句到字段的逐句映射表,列出 world、characters、beats、scene_graph、dialogue、conditions、state、endings、metrics 九段各自承载什么,并用一份 S 层脚本按实际键序逐段打印规模摘要。
点赞与收藏看似只是改一个布尔值,真正难的是本地先行之后如何让服务端裁决:绝对计数与增量事件冲突、列表与详情各存一份状态、连点与取消产生乱序响应。本节给出一个带序号与意图层的 TypeScript 状态存储,用假时钟复现乱序响应,并完整复盘一次计数越点越少的线上问题。
以 arch-lab 订单系统为例,把日订单量、峰值系数与下单事务的请求放大倍数换算成峰值 QPS 和并发数;实现 Little's Law 计算器与 24 小时峰值系数校验,附表驱动测试、本机微基准和一组区分目标值、示例值与实测值的容量结论,并说明 P99 并发为何是安全包络。
实现一个支持顺序、并行和重试预留的延迟预算分配器,用 context.WithDeadline 把剩余预算传给下游,并用真实测试证明超时不会被重试放大、预留不会被并发叠加,最后给出 arch-lab 下单链路的预算表、降级优先级与退出条件,附五次真实运行输出。
用一个单锁计数与 64 分片锁的可比基准,真实运行 go test -bench -benchmem -cpuprofile -mutexprofile 并用 go tool pprof -top 读取输出,说明如何从 profile 区分锁竞争、分配和 I/O 等待,最后给出 arch-lab 订单服务的最小排查顺序。
卷二的收尾交付:接口契约写清卷一封了装配/深度/覆盖、卷二封了着色链(片元颜色的来源),卷三只替换「直接光照求值」为渲染方程的积分估计;另给出三条轴的参数扰动扫描——强度偏移 1 个 Q16.16 单位即产生首次可见差异(128 像素),超采样 N=4 才收敛,10 条软告警不硬失败、exit 0。
同一份 scene_spec.json 在 Python 定点、TypeScript 定点、浏览器 WebGL2 三处消费:S 与 P 成片 sha256 逐字节相同(0d997343…,43731 覆盖像素),S 与 W 按声明容差比对为 MAE 0.5067、PSNR 47.03 dB、覆盖归属差 0.0781‰;负例(片元颜色 ×0.5)MAE 21.3528 被同一判据拒绝。
把卷二前面十五节的环节首尾相接成一条从规格到成像的链:S 层在 320x240 场景上逐级核对十二个缓冲契约,w 不变量 487/487 成立、重心权重和违反 0 次、覆盖 43731 像素,成片 sha256 与卷二基线逐字节一致;P 层用 BigInt 重算同一链路复现同一摘要,负例(顶点顺序交换)必须让摘要分叉。
把同一份场景交给 WebGL2 渲染,再与 S 层定点基线逐像素比对:MAE 0.5073、PSNR 46.95 dB、覆盖归属差异 0.08‰,与 12.1 的 CPU 浮点镜像 0.4963 落在同一噪声地板上。不一致像素按「共享边归属 0.0% / 插值精度 11.3% / 舍入 88.6%」三类归因,并如实交代本机后端是 ANGLE/SwiftShader 软件实现,不是真实 GPU。
sha256 是「全等判据」,只在「全等是合理期望」时成立——浮点实现的 sha256 与基线不同,而它的 MAE 只有 0.4963。本节给出 MAE / RMSE / PSNR / 最大通道差四个标量的定义与各自盲区:整幅 +1 与 4 像素 +64 的 MAE 完全相同,只有 RMSE 与最大通道差分得开;覆盖归属差异与颜色误差是两条独立判据,必须分两栏报告。
同一张封面图,在支持 AVIF 的手机上清晰又小,在旧 WebView 里却可能直接白屏。本节把能力探测、格式顺序、尺寸变体、压缩参数与版本化 URL 串成一条可测策略:只在解码探测通过时使用新格式,按 DPR 选最小可用变体,解码失败沿降级链回退,并用内容哈希路径保证缓存不会串图。
逐位相等在两个宿主之间不可能,容差必须可声明、可复算。本节把容差写成三条同时成立的判据——覆盖归属差异 ≤ 20‰、MAE ≤ 1.0、PSNR ≥ 30 dB,逐条给出阈值出处,并用同一份整数基线量出噪声地板与三条穿越点:太松会漏掉 2% 的全局偏置,太紧会把噪声本身判成错。