- Home
- Plugins
- Tools & Capabilities
- dsh-miniapp-audit
dsh-miniapp-audit
lee2277-t/dsh-miniapp-audit
Before submitting a WeChat mini program, check the parts a machine can. `miniapp_privacy_scan` lists the privacy APIs that must be declared in the user-privacy guideline, gaps in `requiredPrivateInfos`, and silent failure handlers that leave a tap doing nothing; `miniapp_asset_audit` reports package weight and assets no source file references; `miniapp_release_check` combines both and adds the items only a human can confirm in the console. Every hit carries a file and line, and machine-checked items are kept apart from the manual ones.
Install
dsh plugin --profile web add github:lee2277-t/dsh-miniapp-auditREADME
dsh-miniapp-audit
微信小程序提交审核之前,先把能机器查的部分查一遍。
为什么
小程序被驳回最常见的原因不是功能不行,是隐私声明和实际调用对不上:
代码里调了 wx.getLocation,后台的「用户隐私保护指引」里没勾对应项;
或者 requiredPrivateInfos 漏了声明,真机上直接 fail。
这类问题的共同点是:代码里看得见,界面上看不见。提审前翻一遍源码不现实, 提审后被打回又得重来一轮。这个插件就是把这一步变成一条命令。
三个工具
miniapp_privacy_scan
扫隐私接口调用,逐条给文件与行号:
## 1. 历史映射命中的待核对项(4 类)
[1] 收集你的位置信息 (1 处)
pages/index/index.js:3 → wx.getLocation
[2] 收集你的手机号 (1 处)
pages/index/index.wxml:3 → open-type="getPhoneNumber"
[4] 读取你的剪切板 (1 处)
utils/clip.js:2 → wx.getClipboardData
## 2. requiredPrivateInfos 校验
待核对:发现 wx.getLocation 直接调用,app.json 未列出该项
## 3. 静默失败点 fail: () => {}(4 处)
! pages/index/index.js:6 ⚠ 需检查 ← fail: () => {}
· pages/index/index.js:16 (疑似合理静默:附近 showModal,向上 2 行)
覆盖 21 类:昵称头像、位置、地址、发票、步数、手机号、车牌、照片视频、文件、 麦克风、摄像头、蓝牙、相册、通讯录、日历、四类传感器、剪切板。
静默失败那一节是重点。 fail: () => {} 让用户在失败时看到的是「点了没反应」。
但并不是所有静默都该报——wx.showModal 用户主动取消是正常的。
判断方式是向上回溯 40 行、取缩进最小的那个调用(最外层对象字面量):
wx.showActionSheet({
success: () => { wx.showModal({ ... }) },
fail: () => {} // 属于外层 showActionSheet,不是 showModal
})
只看「最近」或只看缩进层级都会判错。
miniapp_asset_audit
## 预算(2 MB / 单个分包)
✅ 余量 843.8 KB
## 最大的 10 个
1.17 MB assets/icons/hero-banner.png
## 未见引用(2 个,1.18 MB)
1.17 MB assets/icons/hero-banner.png
原则是宁可多留,绝不误删。动态拼接的引用({{icon}}--{{tone}}.svg、'prefix' + name)
会按前缀保守保留,报告里说的是「没在源码文本里找到名字」,不是「可以删」。
miniapp_release_check
把上面两项合成一份提审前报告,外加基础配置检查:
## 自动检查
✗ tabBar 图标缺失:assets/icons/missing.png
✗ tabBar 有 6 项,微信上限是 5
✗ app.json 未设置 __usePrivacyCheck__
✗ requiredPrivateInfos 可能缺 getLocation
✗ 3 处静默失败没有错误反馈
## 工具查不到的部分
· 后台「用户隐私保护指引」是否与服务内容一致
· 「接口设置」里对应接口是否已开通
· 真机授权弹窗的实际表现
最后那一节是刻意留的。工具只负责把要核对的地方摆出来,不能替你下合规结论。
安装
dsh plugin add github:Lee2277-t/dsh-miniapp-audit
配置
maxFindings: 60
packageLimitMB: 2
立场
这是线索,不是结论。 映射表来自历史整理,规则一年改几次,可能过时。 报告里每一处都带文件与行号,就是为了让你能自己去核对。
工具不访问后台、不执行真机测试、不判断类目与资质。
许可
AGPL-3.0-only。
Related plugins
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora