App Store / Google Play 合规守门实测:123 条拒审规则、1 秒扫完、装进 Claude Code 拦提审

App Store / Google Play 合规守门实测:123 条拒审规则、1 秒扫完、装进 Claude Code 拦提审

做过上架的人都知道这个循环:打包、上传、等几天、收到一封只有一句话的打回邮件、猜是哪条规矩踩了、改、再等。一次打回吞掉一周,而真正的原因往往是一行配置、一个没写的隐私声明,或者一条早就过期的目标版本号。

这个开源项目把「提审前自己过一遍」变成一条命令:它把苹果和谷歌的拒审规矩整理成 123 条可机检的判据,指向你的工程目录扫一遍,0.7 秒给出按严重程度排序的问题清单,每条都带文件名、行号和改法。我在沙箱里造了四个样例工程跑它(三个故意留了毛病、一个真干净),四次判断全部正确;也踩到三个会让你误以为「检查过了」的坑,写在第四段。

它给你什么

一句话定位:给即将上架或刚被打回的 iOS、安卓开发者,替你在提交前做完「代码能不能过审」这一半活;账号状态、协议是否签完、商店后台的表格填没填,它看不见,也不负责。

它不是一个网页清单,而是三层东西捆在一起:

  • 一份约 110 个勾选项的提交前检查表,按「两个商店共用、苹果、谷歌」分区,每项都写成可以验的动作;
  • 一个一千七百多行的扫描脚本,读你的工程文件,按规矩库逐条比对;
  • 一个安装器,把这道检查挂到 Claude Code、Cursor、Codex 这些编码工具上,让你敲上传命令的瞬间就被拦住。
没有它的时候 用了之后 代价 / 前提
提审前靠记性过一遍规则,或者照着博客抄一份过期清单 一条命令扫完工程,问题按致命、高风险、一般三档排好 要先装个命令行工具(macOS 和 Linux 自带 git 和 bash 即可,Windows 需要 WSL)
打回邮件只有一句话,得去论坛翻别人怎么改 每条问题后面直接跟「改法」一行,还指到具体文件第几行 它只判断「代码里有没有这个信号」,不判断你的业务逻辑合不合理
每次都要记得手动跑一遍,赶时间就跳过了 装进编码工具后,你敲上传命令前它自动跑,有致命问题直接拦下 装完要重启一次工具,部分工具还得手动批准这道钩子
不知道各国新规哪天生效,等踩到才发现 顺带列出 107 条监管截止日,最近的一条在 10 天后 这部分是纯信息播报,需要你自己判断适不适用

原理只有一个核心点:它把「审什么」写成了数据,把「怎么审」写成了脚本。所以作者更新规矩时只改数据文件,你不用重装;而你只要给出「查哪个目录」。

(钩子,也就是在你敲某条命令之前自动插一道检查的程序;这道检查不通过就不放行。)

怎么用起来

从零到第一次拿到结果,四步,十分钟以内。

第一步,把仓库拉下来(不装任何东西,不动你的工程):

git clone https://github.com/mjmirza/app-store-compliance ~/repositories/app-store-compliance

第二步,把扫描指向你的工程根目录——就是包含 Apple 工程文件或安卓构建文件的那一层:

bash ~/repositories/app-store-compliance/agent-os/hooks/app-store-compliance-guard.sh "/你的/工程目录"

第三步,只看开头那几行带「致命」标记的,按它给的改法逐条改,然后重跑同一条命令。退出码有三种含义:0 干净放行,2 有致命问题拦住,1 根本没扫成(目录里没找到 iOS 或安卓工程、或者路径写错了)——第三种最容易被当成「通过了」,见下一段的坑。

第四步,想让它长期生效,花一分钟装进你的编码工具:

bash ~/repositories/app-store-compliance/scripts/install.sh --tool all

装进 Claude Code 后差别很直观。装之前你说「帮我打包上传到 App Store」,工具会照做。装之后同一句话,它先跑一遍扫描,发现问题就把上传命令挡住,把清单甩给你。我用一段模拟的提交命令实测过:有致命问题时它返回拦截码,普通命令则安静放行、不留一行输出。装完会额外多一个 /app-store-audit 斜杠命令,随时手动触发一次完整审计。

它自己的安装器会做八项自检,包括把一条模拟的提交命令喂给刚装好的钩子、确认它真的拦住了——我在沙箱里跑下来八项全绿,最后打印一行安装已验证。

什么时候用它更快:功能已经做完、准备第一次提审,或者刚收到打回邮件想定位原因。什么时候不值得用:还在写原型的阶段,那时候连隐私政策都还没有,扫出来的高危项会一片红,看多了只会麻木。

我实测到的证据,和你要注意的坑

我在隔离沙箱里造了四个样例工程,一个是 iOS 加安卓的双平台烂工程,一个只有存令牌的隐私问题,一个是硬编码密钥,一个是真正干净的。结果:

样例 它给出的判断 耗时
双平台烂工程(目标版本过低、占位文案、没有隐私政策) 拦住,2 个致命、5 个高风险 0.7 秒
只把登录令牌存进明文偏好设置 高危:应改存系统钥匙串 不到 1 秒
干净工程(隐私政策与加密声明齐全) 放行,退出码 0 不到 1 秒
硬编码了一把生产环境密钥 只报了「年龄分级记得重填」 不到 1 秒

最后一行是第一个坑:它不查硬编码密钥。我把一串以 sk_live 开头的密钥直接写进代码,它一条都没报——它的敏感信息规则只认「存进了不加密的本地存储」这种动作,不认字面量。所以别把它当密钥扫描器,两者是两件事,各自跑各自的。

第二个坑更隐蔽:缺了文本处理工具时它会静默放行。这道检查脚本里大量依赖系统自带的 awk。我在一个故意不提供 awk 的环境里,喂给它一条上传命令,它一个字节都没输出、退出码是 0——也就是「检查根本没有发生」,但任何流程都会把它读成「没问题」。所以装完一定先跑一次它自带的样例验证(安装器会自动做),在自动化流水线里也要显式检查退出码,别只看「命令没报错」。

第三个坑:它分不清「你的代码」和「规则数据」。我把扫描指向仓库自己的根目录,它把作者存规则的 JSON 文件当成源码,报出一个致命问题。所以永远只把它指向 App 工程目录,不要指向仓库根,也不要指向放了很多第三方代码的大目录。

还有两条值得记住:

  • 它查的是代码,不是你的账号。开发者账号是否有效、协议签没签、商店后台的表填了没,这些能让你的首次上架卡好几周,扫描器一条都看不见——它的输出里会明确提示你回去照清单手查。
  • 报告默认会把一百多条监管截止日全量打印出来,几十行,容易把真正要看的问题淹掉。看末尾那行汇总(致命几个、高风险几个)和第一屏的清单就够。

适合谁,不适合谁

适合:一个人或小团队做独立 App、一年要提审好几次、被打回过至少一次的人。这类人最缺的就是「在提交前把已知的坑过一遍」这道工序,而它正好是零成本——不装依赖、不改你的工程、一条命令。

也适合团队里做发布把关的那位:把它的退出码挂进提交流水线,有致命问题就断掉构建,比人工过清单稳定得多。

不适合:还在验证想法的阶段,或者一年只发一版的人——装它的时间不如读完那份检查表。另外,如果你的 App 只走企业内部分发、不上公开商店,这 123 条规矩大部分跟你无关。

要提醒的是许可证:它用的是一份小众开源许可,个人和小团队(年收入两千万美元以下)免费,超过这条线要按超出部分交千分之五、每年封顶二十五万美元。商用之前花两分钟看一眼许可证原文,比事后补票便宜。

如果你也怕下一次提审被打回,值得花十分钟跑一遍;如果只是想了解苹果和谷歌到底卡哪些点,读它那份检查表就够,不装也行。

同类里可以顺带看一眼 unslop 的技能评测(同样是「把手工检查写成判据」的思路),以及 geo-sleuth 的证据拆解(判断一条结论该有几个证据)。

关注 AI商业快讯,每天一篇 AI 热点深度解读。