📌 项目地址:mjmirza/app-store-compliance | ⭐ 1,671 颗星 | 🔧 Shell
一次拒审的代价不小:改代码、重新排队、上线日期往后推。mjmirza/app-store-compliance 的思路很直接:把拒审从“看审核员心情”变成“提前设计掉的问题”。项目提供一个 Shell 脚本,在你提交应用之前扫描代码,标出会导致拒审的风险点,每条附带文件、行号和修复建议。
两分钟上手
前提是机器上有 git 和 bash。第一条命令下载项目,第二条扫描你的应用目录。不装任何东西,也不改你项目里的一行代码。
git clone https://github.com/mjmirza/app-store-compliance ~/repositories/app-store-compliance
bash ~/repositories/app-store-compliance/agent-os/hooks/app-store-compliance-guard.sh "/path/to/your/app"
只需要把 /path/to/your/app 换成你的 Xcode 项目或 Android 项目的文件夹。引号要保留,这样路径里带空格也不会出错。不知道路径怎么写的话,把文件夹从 Finder 拖进终端窗口就行。
小项目扫描大概一秒,大项目最多一分钟,脚本会自己打印耗时。结果按严重程度排序,关键问题排最前面。
扫完看最后一行:
| 最后一行 | 含义 | 下一步 |
|---|---|---|
BLOCKED. |
发现了关键拒审风险 | 按每条 [CRITICAL] 下面的 fix. 行逐条修,修完重跑一次 |
CLEAR. |
代码里没有关键风险 | 处理剩下的非关键项 |
不止是脚本
这个项目本质是一份 playbook,可以当网站直接读(mjmirza.github.io/app-store-compliance),脚本只是它的自动化入口。README 里有一张分流表,按你的处境选入口:
已经被拒审了:去看仓库里的 appeal playbook(docs/MISTAKE-PATTERNS.md),十分钟读完,讲的是申诉怎么写。
不是开发者:打开提交前检查清单(docs/PRE-SUBMISSION-CHECKLIST.md),先把前两项检查做了,五分钟的事。产品经理和运营也能照着做。
在用 AI 编程工具:Claude Code、Codex、Gemini CLI、Copilot、Cursor 这些都支持。项目提供了一个 skill,按 README 里 “Install it into your AI coding tool” 一节装上,一分钟,之后 AI 助手每次帮你提交代码前都会带上这套合规知识。
几个要先想清楚的点
许可证不是 MIT。项目用的是 Open Roots License (ORA 2.3),对“拿内容另起炉灶”这类行为有约束。想 fork、商用或者抽取内容集成的,先读一遍条款。
依赖 bash 环境。核心是 Shell 脚本,Windows 用户要走 WSL 或 Git Bash。
它能挡住有模式可循的问题,挡不住审核员本人。脚本擅长的是已知风险(比如隐私 API 的违规使用),但 App Store 终究有人工审核,过脚本不等于过审。另外它的法规追踪以 Apple/Google 官方政策和欧美法规为主,如果你的市场在国内,这套东西当参考可以,国内商店的备案和本地规则得自己补。
我的看法
我更喜欢把它当成一份“拒审知识库”来看,脚本是锦上添花。README 里那些被拒原因的整理,对没有专门合规角色的独立开发者和小团队最值钱:这些人每次拒审烧的都是自己的时间。想再进一步,可以把脚本挂进 CI,或者用它的 AI 工具安装方式,让合规检查变成每次提交的默认动作。
作者的诉求也写在明面上:“如果这帮你避开了一次拒审,点个 star、fork 一下”,就这么多。截至发稿,star 数在一千六百多,对一个知识库型项目来说,更重要的是看作者后续更新拒审模式的频率,而不是 star 涨得多快。