清单怎么用
这份清单不是打分表，而是门禁：每一项只有「过」与「不过」，没有中间态。
每项包含四个字段：
| 字段 | 含义 |
|---|
| 检查项 | 一句话描述要验证什么 |
| 判定标准 | 满足什么条件算过 |
| 证据形态 | 可以接受的证明材料 |
| 责任方 | 出问题时谁解释 |
证据必须是可复现的东西：文件路径、测试输出、线上查询语句、监控截图带时间戳。口头确认、「已经测过了」不算证据。
一、协议与兼容
| 检查项 | 判定标准 | 证据形态 |
|---|
| 消息信封统一 | 所有业务消息带版本、类型、序号、时间戳 | 协议定义文件 |
| 版本兼容规则 | 新增字段可选、删除字段先废弃、未知字段忽略 | 契约测试用例 |
| 不兼容消息拒绝 | 版本超出支持范围时明确报错，不静默降级 | 错误码表与测试 |
| 契约测试 | 兼容规则有可执行断言，CI 每次跑 | node --test 输出 |
二、连接与重连
| 检查项 | 判定标准 | 证据形态 |
|---|
| 连接状态机 | 连接、就绪、断开、重连、恢复五态明确 | 状态图与单测 |
| 退避策略 | 指数退避带抖动，有上限与总时限 | 配置与单测 |
| 重连后校准 | 明确哪些状态必须重新拉取 | 校准清单 |
| 断线可观测 | 断线率、重连成功率、恢复耗时进入监控 | 监控面板 |
三、离线与冲突
| 检查项 | 判定标准 | 证据形态 |
|---|
| 队列边界 | 明确哪些操作允许离线、哪些必须在线 | 操作清单 |
| 幂等与去重 | 重复提交不会产生重复奖励 | 去重键与测试 |
| 冲突策略 | 冲突有明确胜出规则与提示 | 冲突矩阵 |
| 可见性延迟 | 明确「已提交未确认」的 UI 表现 | 交互稿 |
四、同步与预测
| 检查项 | 判定标准 | 证据形态 |
|---|
| 权威归属 | 每一项状态标明服务端权威或客户端权威 | 状态责任表 |
| 预测范围 | 只预测可回滚的本地表现 | 预测清单 |
| 回滚平滑 | 修正时无大幅跳变，有插值策略 | 真机录屏 |
| 延迟补偿边界 | 补偿只影响表现或明确影响判定 | 设计说明 |
五、战报与赛季
| 检查项 | 判定标准 | 证据形态 |
|---|
| 战报最小集 | 含结果、关键帧、输入摘要、版本号 | 战报 schema |
| 可回放 | 同版本下回放结果一致 | 回放测试 |
| 版本隔离 | 旧战报在新版本下可读或明确不可用 | 兼容说明 |
| 结算口径 | 客户端展示与服务端结算一致 | 对账用例 |
六、流量与心跳
| 检查项 | 判定标准 | 证据形态 |
|---|
| 流量账本 | 一次会话的流量按消息类型可拆解 | 埋点报表 |
| 心跳合理 | 心跳间隔与在线状态、耗电有取舍说明 | 配置与评估 |
| 流量预算 | 每会话、每 DAU 日流量有上限 | 预算表 |
| 弱网适配 | 弱网下降低非必要请求，不阻塞主流程 | 弱网测试记录 |
七、资源与分包
| 检查项 | 判定标准 | 证据形态 |
|---|
| 依赖图无环 | 资源依赖图通过环检测 | 图报告 |
| 分组规则 | 共享、场景、产品资源边界清晰 | 分组表 |
| 冗余受控 | 多包重复资源有上限与审计 | 冗余报告 |
| 首包边界 | 首包只含启动与首场景必需资源 | 首包清单 |
八、热更与灰度
| 检查项 | 判定标准 | 证据形态 |
|---|
| 政策边界 | 热更内容符合商店政策与自定红线 | 内容分类表 |
| 差量可用 | 差量补丁可生成、校验、应用、回退 | 补丁测试 |
| 灰度可观测 | 灰度分组、比例、指标与停止条件明确 | 发布方案 |
| 回滚演练 | 回滚在时限内完成，有演练记录 | 演练报告 |
九、下载与 CDN
| 检查项 | 判定标准 | 证据形态 |
|---|
| 下载器健壮 | 分片、并发、断点续传、校验完整 | 单测与真机 |
| CDN 策略 | 命中率、回源比例、多源切换明确 | CDN 报表 |
| 失败降级 | 下载失败有重试、换源、降级路径 | 故障演练 |
| 成功率达标 | 下载成功率与弱网成功率有基线 | 监控面板 |
评审记录模板
每次评审保留一行记录：
| 日期 | 版本 | 通过项 | 阻塞项 | 带病进入项 | 负责人 |
|---|
| 2026-11-04 | 消消 3.8 | 32/36 | hotfix-rollback | cdn-fallback | 客户端 |
「带病进入」不是免责声明，而是待办：下一版本必须优先处理，否则清单会逐渐失去约束力。
与第 13 章的关系
第 13.3 节把这份清单写成可运行的评审门禁：每项只有 pass / partial / fail，pass 必须附证据，partial 按未过处理。清单是人工版本，评审器是机器版本，两者使用同一组编号与分组。
继续阅读
探索更多技术文章
浏览归档，发现更多关于系统设计、工具链和工程实践的内容。