wxapkg-unpack:微信小程序反编译与样式还原
wxapkg-unpack:小程序反编译
想 1:1 复刻某个小程序的样式,或者参考它的交互写法时,让 agent 从本机微信缓存里找到对应的 .wxapkg,解密解包,再把样式还原成可读的 WXSS。
2026-10-06 起,这项能力并入
wechat-mpskill:脚本在wechat-mp/scripts/wxapkg/,说明在wechat-mp/references/wxapkg-unpack.md,触发词不变。
本能力基于开源项目 wux1an/wxapkg。上游 v2 只有 GUI,这里复用它的 wechat Go 包,包成命令行工具,并补上「按页面文字找小程序」和 WXSS 还原两项能力。
仅供学习研究,或复刻你有权使用的设计。不要分发解出来的源码,也不要用它绕过授权。
用法
直接说目标即可:
- 「反编译一下这个小程序,页面上有『xxx』这句话」
- 「解包刚才打开的那个小程序,把样式抠出来」
- 「照着 xx 小程序 1:1 复刻这个页面」
agent 会依次做这几步:
- 你先在电脑版微信里打开目标小程序,把要参考的页面都点一遍,分包也会被缓存下来。
- 定位 wxid:用页面上看得见的文字搜索缓存包,找不到时就按修改时间列出最近打开的几个。
- 解包:按 wxid 自动取最新版本目录,解密后解到临时目录,JS/HTML/JSON 默认会美化。
- 还原 WXSS:生成
app.wxss、pages/**/*.wxss、components/**/index.wxss。
首次运行需要本机有 git、go(1.25 及以上)和 node。脚本会自动拉取上游代码,编译到 ~/.cache/vft-kit/wxapkg/,之后直接复用。
解出来的东西怎么看
解出来的是编译产物,不是原始工程,各类信息分散在下面几个位置:
| 想要什么 | 去哪找 |
|---|---|
| 页面列表、tabBar、窗口配置 | app-config.json |
| 样式 | 还原出的 .wxss 文件 |
| 页面逻辑、data、文案、事件 | app-service.js 里每个 define("pages/xxx/xxx.js", ...) |
| 页面结构(WXML) | 已编译成 $gwx 函数,没法直接读;根据 data 和 WXSS 类名推断结构,再对照截图 |
| 图片素材 | assets/ 等原路径 |
拆逻辑、导出数据
解包后再跑一次 split-service.mjs,把 app-service.js 按模块拆到 _modules/,城市表、话术、文章这类纯数据模块直接导出成 _data/*.json。移植数据时从 JSON 生成代码,不要让模型手抄长段中文,手抄会漏字改字。
新版基础库把每页样式放在 pages/**/x.html 里,extract-wxss.mjs 已同时扫描这些文件;如果还原结果是 restored 0,先确认用的是最新脚本。
复刻到 Taro / H5 的要点
- 先搬设计 token:
app.wxss里body{--ink:...}这类变量就是整套配色,直接改成 CSS 变量使用。 - 单位:原包用
vw的可以原样照搬;用rpx的,按目标项目的设计稿宽度换算。 - 标签选择器要改写:
wx-view、wx-text、wx-button在目标项目里不存在,要改成 class 或普通元素选择器。 - 按钮边框:原包一般会重置
wx-button::after{border:0},Taro H5 的<button>默认带边框,复刻时要同样重置样式,或者换成view。 - 原包里
@media (min-width:600px)的大屏兜底样式也一起搬过来。
踩坑
| 现象 | 原因 / 处理 |
|---|---|
| 列表里找不到目标小程序 | 缓存还没生成或目录没探测到。重新打开小程序;仍然找不到就让 agent 手动指定缓存根目录 |
| 用文字搜不到 | 这句文案可能是接口下发的,没写在包里。改用标题、按钮、tab 名这类固定文字搜索 |
| 报「加密文件」 | 解密密钥就是 wxid,传入的路径里缺了 wxid,需要显式指定 |
| 同一个小程序有多个版本 | 默认取修改时间最新的那个版本目录;要指定旧版本就直接给版本目录 |
| clone 或编译超时 | 设置代理后重试,Go 依赖可用 GOPROXY=https://goproxy.cn,direct |
| 上游有更新 | 让 agent 带 --rebuild 重新拉取并编译 |
另外,解包产物、截图这类中间文件都放在临时目录,不要放进项目源码目录。
TikTok Minis:抓 H5 前端学习
TikTok 小程序(https://www.tiktok.com/minis/<token> 链接)里有一类是 H5 型,产物就是一个公开的静态站点,不用解包,直接下载即可。
- 网页本身只是扫码落地壳。真正的信息在
https://www.tiktok.com/tiktok/minis/link/<token>,这个接口要 TikTok 登录态,在已登录的浏览器里调用。 - 返回里的
minis_link_meta.minis_url是站点根(*.tiktokminis.us,公开可访问)。minis_meta.config里有build.htmlEntry就说明是 H5 型,domain.allowList则列出它的后端域名。 - 运行
python3 wechat-mp/scripts/tiktok-minis/fetch.py <minis_url> <输出目录> --pretty。脚本从入口 HTML 出发,递归下载 JS、CSS 和图片,再用 prettier 格式化。境外直连容易超时,先设置HTTPS_PROXY。
读代码时,常见的是 uni-app(Vue3 + Vite)构建,没有 sourcemap。页面按 pages-<路由>.<hash>.js 分包,宿主能力看 TTMinis.* 调用(支付、埋点、防录屏、胶囊按钮避让)。原生或游戏型 Minis 不在 web 上,这个方法拿不到。说明见 wechat-mp/references/tiktok-minis.md。
竞品调研:先读代码
研究竞品的登录、游客模式、支付、激励广告、播放预加载这类机制时,先抓源码读代码。模拟器只在两种情况下用:复刻视觉布局,或者代码看不出运行时行为(宿主弹窗、真实时序、广告有没有填充)。
找链接:用搜索引擎换几种说法搜
tiktok.com/minis加品牌名,把搜到的 token 都交给 link 接口批量解析,按返回的minis_meta.name认品牌。几种返回的含义:status_code=8:未登录。200002:链接不存在。- 返回里只有
{"minis_status":4}:小程序已不可用。 asset_type=1:游戏型包,网页上抓不到。
网页端找不到入口:TikTok 网页的搜索、作品页、主页简介都不给 Minis 入口。这时只能在 App 里搜品牌名,点开 Minis 卡片后用 Copy link 拿 token。
批量抓取:把 link 接口返回的 JSON 直接交给
fetch.py。js/css_fail不为 0 时,逐条查引用出处:出现在注释里或者是打包进去的模块路径,就是误报。分析清单:先
grep -rohE "TTMinis\.[a-zA-Z]+"统计宿主能力,再按维度找关键代码:- 登录:
TTMinis.login/authorize在启动时调还是点按钮才调,首屏请求是否等登录。 - 支付:下单、
pay、回查、补单。 - 广告:
createRewardedVideoAd的实例管理、单飞锁、isEnded判定、超时兜底。 - 播放:首帧来源、预加载、切集方式。
每个维度的完整关键词表见
wechat-mp/references/tiktok-minis.md「竞品源码调研」一节。- 登录:

留言板
0 条留言对话,从你开始
还没有留言。分享一个想法,或只是打声招呼。