Agent Skills
返回列表
微信小程序上线预检助手

微信小程序上线预检助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @qixiantech/wechat-miniprogram-launch-review-assistant 这一技能。

技能介绍

它解决什么问题

微信审核被驳回,常见原因并非代码跑不通,而是合规项和前端代码对不上:页面里出现了用户生成内容入口,却没有相应声明;功能调用了 wx.getLocation,却未在后台勾选位置权限;app.json 里的页面路径拼写错了一个字母;或主包体积已经贴近限制。这些在本地静态文件里看不出运行时报错的错误,往往要在提交后由微信团队打回才知道。
本技能就是针对这道预检门槛设计的。它不运行你的代码,也不访问微信开放后台,而是把项目前端源码打包后,通过 HTTPS 提交到分析服务,由服务端按规则集做一次静态扫描。扫描结果用于在正式提交审核前,给出可量化的风险提示,而不是替代微信官方审核。

核心能力与调用流程

这个技能接受一个ZIP包,但不会执行任何脚本或构建命令,只做静态文本分析。扫描前必须先和用户确认两个关键参数:小程序所属的 category_id(小程序类目),以及一组布尔值表示实际使用的能力(auth、ugc、payment、location、media)。只有这两项和源码内容交叉匹配,才能判断哪些行为存在声明不一致的风险。
文件收集方面,只保留源码文本(.js .json .wxml .wxss 和 TypeScript 的 .ts)。图片和其他二进制文件必须排除,ZIP里只要包含一个二进制文件被标记为 text,会让服务端直接拒绝。
当缺少 appid 字段时,请求会触发 AI Pay 作为鉴权流程,并要求在请求头携带 Authorization: SkillHub <token> 与 X-Out-Trade-No: 订单号。支付成功之后,重试请求必须携带首次响应返回的 WeixinPay-Required 和 X-Out-Trade-No 两个 Header,并按首次请求的字段原样发起重试,确保分包和快照是同一个交付物。
项目通过微信开发者工具本地安全导出。扫描前必须清除 project.private.config.json 等包含私人身份标识的配置,不提交密钥、测试账号或任何商业机密。接口上不需要用户配置 API Key 或云凭证,服务端会下发一个临时的 random deliverable Token,在第一次 Shell 调用时由 auth_pay 捕获后执行。

适用边界

如果在框架返回超过 4 MB 源码、2500 个文件、或超过单文件 1 MB 的限制,生态会自动先断开打包,确保重要的浅层代码被扫描。若派发内容没有命中高危项,result_status 会返回 REVIEW_RECOMMENDED,但这不等于任何清单或契约在微信后台一定合规。
工具只扫描客户提交的 ZIP 里所见的源码,动态代码(分包、插件)不在此范围内。此外工具不提供付费或未付费的开放接口,交付物只用于在代码写在墙上之前尽早纠错,帮助开发团队省下从零编写清单的时间。工具也只针对单文件;如果存在多码点生成或混淆器处理,词法匹配可能漏掉部分项。AI 工具并非微信的开发审核,最终能否通过,仍以微信官方审核表单为准。

使用场景

  • 小程序已完成开发,在正式提交微信审核前,需要对前端代码中权限申请、用户声明与类目选择的一致性做一次静态预检,确认是否存在高概率被驳回的风险项。
  • 打包后的小程序代码体积接近微信主包限制,需要按文件原始字节数估算包大小是否超标,并在开发者工具上传前提前发现体积异常。
  • 代码中使用了支付、登录、定位或音视频等能力,但不确定 app.json 或后台勾选的权限项是否与实际调用完全对应,需要一个独立的规则扫描来标记可能遗漏的声明。

适合人员

  • 负责小程序前端开发并需要把控代码提交质量工程师,希望在正式审核前用工具找出权限描述不一致和代码相关风险的地方。
  • 负责上线节奏的项目经理,需要在提交微信审核前,拿到一份可操作的整改清单,用来协调开发、产品和运营同学确认缺失的能力声明或合规资料。
  • 审核经验逐年减少的子类开发者,希望在小程序上传之前,通过静态扫描工具分级和打回原因,了解到哪些需要在开发者文档中具体标注或调整调用逻辑,事先补齐需要上传的凭证。