unveilr 文档

黄粱一梦2024-05-0318

声明

本程序仅供于学习交流，请使用者遵守《中华人民共和国网络安全法》，勿将此工具用于非授权的测试，开发者不负任何连带法律责任。

:loud_sound:公告

:rocket:v2.0.0已经发布，快来试试吧~
一些常见问题移到讨论区去了

:heavy_check_mark:新版本特性

支持自动解密(windows从路径上提取wxAppId)
自动合并子包
支持解析最新版wxapkg (APP_V3/APP_V4/APP_SUBPACKAGE_V2)
支持解析最新版小程序插件 (APP_PLUGIN_V1)
采用@babel/core直接解析语法树，精准提取源码(1.x是正则提取)
使用Threadjs做的线程池，cpu直接干到顶(解析语法树特别吃cpu)

:white_check_mark:安装方法

1. 下载可执行文件【这是一个命令行工具，windows上双击是不行的】

从下载地址下载对应操作系统的可执行文件
例如：unveilr@2.0.0-win-x64.exe --help
具体参数看参数详解

2. npm 安装

npm i unveilr -g

3. yarn 安装

yarn global add unveilr

npm 或 yarn 安装后使用方法

unveilr --help 或者 uvr -h
具体参数看参数详解
当 ‘unveilr’ 不是内部或外部命令，也不是可运行的程序或批处理文件
尝试在命令前面加一个 npx, 例如：npx unveilr --help

:loop:参数详解

子命令是为了后续集成别的平台小程序解包功能 (其他小程序反编译方案收集)
子命令默认为 wx

子命令	参数	解释
	`-l, --log-level <level>`	设置日志等级 `debug`，`info`，`warn`，`error` 默认 `info`
	`-v, --version`	打印版本号并退出
`wx`	`<packages...>`	`wxapkg`的路径，可以是多个，也可以是一个目录
`wx`	`-i, --appid <appid>`	解密`windows`上的 `wxapkg`时需要提供已经支持自动从路径中提取
`wx`	`-f, --format`	是否需要格式化解析出来的代码
`wx`	`--no-clear-decompile`	不清除反编译时的残留文件
`wx`	`--no-clear-save`	不清除之前的编译结果
`wx`	`--no-parse`	只提取`wxapkg`中的文件，不进行反编译
`wx`	`-d, --depth <depth>`	设置从目录中查找`wxapkg`的深度默认: `1` 设置为`0`时不限制深度
`wx`	`-o, --output <path>`	设置反编译输出目录
`wx`	`--clear-output`	当输出目录不为空时程序将终止，提供该参数表示强制清空输出目录

:v:使用示例

如果路径有空格必需加引号

# 直接解包整个目录
$ unveilr "/path/to/wxapkg/dir/"
# 解多个包
$ unveilr "/path/to/1.wxapkg" "/path/to/2.wxapkg" ...
# 指定wx子命令并指定微信AppId
$ unveilr wx -i wx11aa22bb33cc44dd "/path/to/wxapkg/dir/"
# 格式化解析出来的代码
$ unveilr wx -f "/path/to/wxapkg/dir/"
# 只提取源文件不解析进行反编译
$ unveilr wx --no-parse "/path/to/wxapkg/dir/"