微信小程序性能诊断助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @qixiantech/wechat-miniprogram-performance-diagnostic。
技能介绍
要解决的痛点
微信小程序的性能问题很少只出在一个文件里。一个页面可能同时存在 setData 调用密、WXML 层级深、图片未压缩、未引用文件被打包、分包边界不合理、wx:for 缺少 key、事件绑定过多等隐患。这些点在开发者工具里容易漏看,在真机上又常被启动耗时、FPS、内存等指标掩盖,定位成本很高。
这个技能只做源码静态性能诊断:它接收小程序项目 ZIP,分析其中的源码文件,给出按文件和行号定位的发现项、风险等级与摘要,用来缩小排查范围。
技能如何工作
核心能力是静态规则扫描与性能风险归类。调用时收集必填字段 files,可选字段 project_name;对 json/js/ts/wxml/wxss/css/scss/less 提交 path、content 和 size,图片等非源码文件只提交 path 和 size。工具会在本地安全读取目录,不执行脚本、不安装依赖、不构建项目。
支付后的重试必须保持首次请求的业务 JSON 不变,并原样携带 WeixinPay-Required 与 X-Out-Trade-No;若首次请求使用了合法 UUID 作为幂等键,网络重发时继续复用,避免重复下单。
结果按 result_status、summary、score、grade、findings、recommendations、risks、missing_info、performance_metrics 与 diagnostic_coverage 返回。findings 会合并同类问题,occurrences 保留所有相关文件和行号。结果同时适配屏幕与语音终端,但不同终端只能调整展示形式,不能修改结论、风险和依据。
适用边界与注意点
它只能做静态分析,不会执行代码、访问微信后台,也不会测量真实启动耗时、FPS、内存峰值、网络瀑布或真机差异。动态属性调用、运行时生成代码、间接封装可能漏检,因此静态结果不能替代开发者工具性能面板或真机数据。
包体积和 setData 字节数是基础估算,最终仍需在微信开发者工具、代码依赖分析和真机中复核。疑似未引用文件只能用于复核,动态路径、构建插件和运行时加载可能无法识别,不能据此直接删除。它只回答性能问题,不包含上线审核、隐私合规或免费自查。
使用场景
- 拿到小程序代码后,想在不运行真机的情况下找出 setData 调用过多、WXML 层级过深等性能隐患
- 排查性能问题时,需要静态估算包体积、setData 字节数,并复核疑似未引用但可能被动态加载的文件
- 支付诊断服务后切换到手机、PC 或语音设备查看结果,需确认各终端拿到同一结论且未重复收费
- 诊断报告显示 ACTION_REQUIRED 时,需要按文件与行号逐一核对高风险项,再决定是否修改代码
适合人员
- 微信小程序前端开发者,需要在提交代码前用静态方式定位 setData、包体积和未引用文件等问题
- 小程序研发团队负责人,想通过静态诊断评估项目性能风险,再安排真机与开发者工具复核
- 跨设备办公的开发或测试人员,需要在手机、PC 或语音终端查看同一份性能诊断结论
- 付费采购诊断服务的开发者,需要在订单支付后跨设备取回结果并核对履约凭证的有效期