香色 XBS 打包与五关卡验证流水线

香色闺阁（StandarReader）的交付质量靠流水线兜底，不是靠手感。这篇讲打包与验证的完整流程。

打包：忠实转换

JSON 源最终打包为 XBS（二进制格式）。要点：

1. 用 json2xbs_bytes 做忠实打包——转换过程不增不删不改值。
2. 不要手改 XBS：二进制层的手改无法验证，出了问题无法回溯。
3. 交付前做键集对齐：与最近一次 App 保存版做值级 diff（豁免 lastModifyTime 这类时间戳字段），防止字段在转换中悄悄丢失。

契约核对清单

• 2.56.1 契约字段一个不少：顶层模块、五动作（搜索/详情/目录/正文/发现）配置齐全。
• 多余键没有意义：解析结果受字段白名单（23 键）强制过滤，写了也白写。
• removeHtmlKeys 按需声明：要保留原始 HTML 的字段走它，否则会被清洗。

五关卡验证流水线

text
schema 校验 → editor 校验 → fixture 本地夹具 → live 真实接口 → 官方 App 实测

全部通过才算交付。静态校验通过只是第一关——静态通过 ≠ 官方 App 可用。

防闪退自查（最容易翻车的四处）

1. webViewJs 必须单表达式 IIFE，禁顶层 return（详见《webViewJs 求值语义》帖）。
2. 列表类动作响应必须是「字典 + 非空 list + 首末元素是对象」，缺一即异常。
3. 分页 nextPageUrl 以 # 开头即不发请求——注意这是停止信号不是普通字符串。
4. success 字段只在无 success 时求值，任何非 nil 即真——不要把它当布尔标志用。

版本策略

App 保存版永远比你的母版新（用户可能在 App 里改过），以上传件为基底，禁止直接用母版生成成品。改前哈希归档，改后键集对齐，这套纪律和 Legado 工程化是同一个思想：让每一步可回溯。