战簿实验室 · Lab Notes
CHECKLIST
2026-11-19 · 来自一次真实实验

AI 生成类项目上线前检查清单(12 条)

这份清单不是凭空写的:每一条都来自我们做「一句话生成游戏」实验时踩到的坑, 或推导出来的必检项。完整过程见 实验记录。

用法:上线前逐条打勾。第 1–6 条是「会静默出错」的,最危险; 第 7–12 条是「会白忙一场」的,最浪费时间。

一、会静默出错(最危险)

  1. 外部配置解析后,断言过一次真实值 反例:JsonUtility.FromJson 字段名对不上时不报错、返回全默认值。 必须断言「解析值 == 期望值」,而不是「解析成功」。
  2. 测试的基准来自输入,不来自程序输出 反例:断言「生成结果 == 解析结果」,两边都是默认值时必然通过——自我印证。
  3. 生成器的种子落在目标类型范围内 反例:sha256[:8] 可能超过 int32,Unity 编译报 uint → int; 改成 % 2147483647 才对。
  4. 跨语言传输的编码明确 反例:C# File.WriteAllText(…, Encoding.UTF8) 会写 BOM, Python json.load 直接失败;读时用 utf-8-sig。
  5. 「成功」的判定不依赖客户端响应 反例:上传 609 个文件报「12 个失败」,抽检却全部 200——客户端超时 ≠ 服务端失败。 判定要落到「线上可访问」。
  6. Agent 的产出被校验过,而不只是「报成功」 这条是我们自己的产品要解决的问题:产出为空但状态为成功,是最贵的 bug。

二、会白忙一场(最浪费时间)

  1. 构建目标平台确认过 反例:调 Build() 实际在打 macOS 包,返回 Unknown, 而日志里恰好有授权错误,于是误判成「授权坏了」,查了两轮。
  2. 签名不是 Debug 检查方式:apksigner verify --print-certs。 CN=Android Debug 的包能装、能内测,但商店必拒。
  3. 密码/密钥不写死在代码里 用环境变量传入(ONENIAN_KS_PASS 这类),并把 keystore 单独备份; 丢了就不能再更新同一个应用。
  4. 商店素材是真实运行画面 用数据绘制的示意图很漂亮,但标注「非运行截图」就不能提交; 审核看的是真机画面。
  5. 隐私政策有可访问 URL 商店表单要填。自己站上放一页就行,写清「收什么、不收什么、内购怎么处理」。
  6. 「成功」的定义写在上线之前 不是「上架成功」,而是「自然量 ≥ X、内购 ≥ 1 笔」。 否则上线当天就会自我庆祝,然后没有下文。

三、这 12 条背后的一句话

AI 生成类项目最常见的失败,不是生成不出来,而是生成出来了一个「看起来对」的错东西。 上面 6 条静默失败项,全都在解决这件事。

我们把这类判断叫做「判据」:每条写清「何时触发、怎么做、什么算失败」。 这份清单是其中 12 条,完整库有 273 条,来自 67 次真实上线事故。

附:想自己跑一遍?

实验用的完整过程、代码片段与三组对照数据在 实验记录; 项目进度与包的情况在 项目页。 有问题可以发邮件到 moestone@qq.com,我会回。