2026-11-19 · 来自一次真实实验
AI 生成类项目上线前检查清单(12 条)
用法:上线前逐条打勾。第 1–6 条是「会静默出错」的,最危险; 第 7–12 条是「会白忙一场」的,最浪费时间。
一、会静默出错(最危险)
-
外部配置解析后,断言过一次真实值
反例:
JsonUtility.FromJson字段名对不上时不报错、返回全默认值。 必须断言「解析值 == 期望值」,而不是「解析成功」。 - 测试的基准来自输入,不来自程序输出 反例:断言「生成结果 == 解析结果」,两边都是默认值时必然通过——自我印证。
-
生成器的种子落在目标类型范围内
反例:
sha256[:8]可能超过 int32,Unity 编译报uint → int; 改成% 2147483647才对。 -
跨语言传输的编码明确
反例:C#
File.WriteAllText(…, Encoding.UTF8)会写 BOM, Pythonjson.load直接失败;读时用utf-8-sig。 - 「成功」的判定不依赖客户端响应 反例:上传 609 个文件报「12 个失败」,抽检却全部 200——客户端超时 ≠ 服务端失败。 判定要落到「线上可访问」。
- Agent 的产出被校验过,而不只是「报成功」 这条是我们自己的产品要解决的问题:产出为空但状态为成功,是最贵的 bug。
二、会白忙一场(最浪费时间)
-
构建目标平台确认过
反例:调
Build()实际在打 macOS 包,返回Unknown, 而日志里恰好有授权错误,于是误判成「授权坏了」,查了两轮。 -
签名不是 Debug
检查方式:
apksigner verify --print-certs。CN=Android Debug的包能装、能内测,但商店必拒。 -
密码/密钥不写死在代码里
用环境变量传入(
ONENIAN_KS_PASS这类),并把 keystore 单独备份; 丢了就不能再更新同一个应用。 - 商店素材是真实运行画面 用数据绘制的示意图很漂亮,但标注「非运行截图」就不能提交; 审核看的是真机画面。
- 隐私政策有可访问 URL 商店表单要填。自己站上放一页就行,写清「收什么、不收什么、内购怎么处理」。
- 「成功」的定义写在上线之前 不是「上架成功」,而是「自然量 ≥ X、内购 ≥ 1 笔」。 否则上线当天就会自我庆祝,然后没有下文。
三、这 12 条背后的一句话
AI 生成类项目最常见的失败,不是生成不出来,而是生成出来了一个「看起来对」的错东西。 上面 6 条静默失败项,全都在解决这件事。
我们把这类判断叫做「判据」:每条写清「何时触发、怎么做、什么算失败」。 这份清单是其中 12 条,完整库有 273 条,来自 67 次真实上线事故。
附:想自己跑一遍?
实验用的完整过程、代码片段与三组对照数据在 实验记录; 项目进度与包的情况在 项目页。 有问题可以发邮件到 moestone@qq.com,我会回。