wechat/wxhelper
5
0
Fork 0
mirror of https://github.com/ttttupup/wxhelper.git synced 2024-07-01 03:42:38 +08:00
Code Issues Packages Projects Releases Wiki Activity
f324db9b7b
wxhelper/README.md

826 lines
17 KiB
Markdown
Raw Normal View History

Initial commit
2022-12-21 17:13:03 +08:00
# wxhelper
update reademe
2022-12-26 16:57:18 +08:00
wechat hook 。PC端微信逆向学习。支持3.8.0.41，3.8.1.26版本。
init commit
2022-12-21 20:30:44 +08:00
#### 免责声明:
本仓库发布的内容，仅用于学习研究，请勿用于非法用途和商业用途！如因此产生任何法律纠纷，均与作者无关！
#### 项目说明：
update reademe
2022-12-26 16:57:18 +08:00
本项目是个人学习学习逆向的项目，主要参考https://github.com/ttttupup/ComWeChatRobot，在此基础上实现了微信的的其它版本的部分内容。
init commit
2022-12-21 20:30:44 +08:00
#### 使用说明：
修改readme格式
2023-01-10 10:03:57 +08:00
支持的版本3.8.0.41，3.8.1.26。
src:主要的dll代码
tool：简单的注入工具，一个是控制台，一个是图形界面。
python: 简单的服务器，用以接收消息内容。
release：编译好的dll。
0.首先安装对应的微信版本，主分支是3.8.0.41版本，3.8.1.26分支对应3.8.1.26版本。
1.通过cmake构建成功后，将wxhelper.dll注入到微信，本地启动tcp server，监听19088端口。
2.通过http协议与dll通信，方便客户端操作。
3.接口的url为http://127.0.0.1:19088，注入成功后，直接进行调用即可。
4.特别注意数据库查询接口需要先调用获取到句柄之后，才能进行查询。
5.相关功能只在win11环境下进行简单测试，其他环境无法保证。
init commit
2022-12-21 20:30:44 +08:00
环境说明
2022-12-21 20:42:34 +08:00
#### 编译环境
init commit
2022-12-21 20:30:44 +08:00
update reademe
2022-12-26 16:57:18 +08:00
Visual Studio 2022(x86)
Visual Studio code
cmake
环境说明
2022-12-21 20:42:34 +08:00
vcpkg
增加编译说明
2022-12-27 10:07:14 +08:00
#### 构建步骤
以下是在vscode中操作，vs中的操作类似。
1.安装vcpkg，cmake，vscode
init commit
2022-12-21 20:30:44 +08:00
增加编译说明
2022-12-27 10:07:14 +08:00
2.安装相应的库，如果安装的版本不同，则根据vcpkg安装成功后提示的find_package修改CMakeLists.txt内容即可。或者自己编译。
```
vcpkg install mongoose
vcpkg install nlohmann-json
```
3.vscode 配置CMakePresets.json,主要设置CMAKE_C_COMPILER 和CMAKE_CXX_COMPILER 为cl.exe.参考如下
```
{
"name": "x86-release",
"displayName": "x86-release",
"description": "Sets Ninja generator, build and install directory",
"generator": "Ninja",
"binaryDir": "${sourceDir}/out/build/${presetName}",
"architecture":{
"value": "x86",
"strategy": "external"
},
"cacheVariables": {
"CMAKE_C_COMPILER": "cl.exe",
"CMAKE_CXX_COMPILER": "cl.exe",
"CMAKE_BUILD_TYPE": "Release",
"CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}",
"CMAKE_TOOLCHAIN_FILE": {
"value": "C:/soft/vcpkg/scripts/buildsystems/vcpkg.cmake",
"type": "FILEPATH"
}
},
"environment": {
}
}
```
4.vscode中右键configure all projects,在Terminal中点击Run Task，如没有先配置build任务，然后运行即可
update reademe
2022-12-26 16:57:18 +08:00
完善文档
2023-01-10 13:55:45 +08:00
#### 参与项目
本项目还有许多不足，欢迎提出 issues 或 pr。
update reademe
2022-12-26 16:57:18 +08:00
#### 更新说明
新增退出登录
2023-01-02 11:56:03 +08:00
2022-12-26 ： 增加3.8.1.26版本支持。
update reademe
2022-12-26 16:57:18 +08:00
新增退出登录
2023-01-02 11:56:03 +08:00
2022-12-29 ： 新增提取文字功能。
2022-01-02 ： 退出微信登录。
init commit
2022-12-21 20:30:44 +08:00
### 接口文档：
#### 0.检查微信登录**
###### 接口功能
> 检查微信是否登录
###### 接口地址
> [/api/?type=0](/api/?type=0)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1 成功, 0失败|
|result|string|成功提示|
|data|string|响应内容|
###### 接口示例
入参：
``` javascript
```
响应：
``` javascript
{
"code": 1,
"result": "ok"
}
```
#### 1.获取登录用户信息**
###### 接口功能
> 获取登录用户信息
###### 接口地址
> [/api/?type=1](/api/?type=1)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1 成功, 0失败|
|result|string|成功提示|
|data|object|响应内容|
|account|string|账号|
|bigImage|string|头像大图|
|city|string|城市|
|country|string|国家|
|currentDataPath|string|当前数据目录|
|dataRootPath|string|根目录|
|dataSavePath|string|保存目录|
|mobile|string|手机|
|name|string|昵称|
|province|string|省|
|smallImage|string|小头像|
|wxid|string|wxid|
###### 接口示例
入参：
``` javascript
```
响应：
``` javascript
{"code":1,"data":{"account":"xx","bigImage":"https://wx.qlogo.cn/mmhead/ver_1xx","city":"xx","country":"CN","currentDataPath":"xxx","dataRootPath":"C:\\xx","dataSavePath":"C:\\xx","mobie":"13949175447","name":"xx","province":"xx","smallImage":"xx","wxid":"xx"},"result":"OK"}
```
#### 2.发送文本消息**
###### 接口功能
> 发送文本消息
###### 接口地址
> [/api/?type=2](/api/?type=2)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|wxid |ture |string| 接收人wxid |
|msg|true |string|消息文本内容|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,不为0成功, 0失败|
|result|string|成功提示|
###### 接口示例
修改readme
2022-12-27 10:12:15 +08:00
init commit
2022-12-21 20:30:44 +08:00
入参：
``` javascript
{
"wxid": "filehelper",
"msg": "1112222"
}
```
响应：
``` javascript
{"code":345686720,"result":"OK"}
```
#### 5.发送图片消息**
###### 接口功能
> 发送图片消息
###### 接口地址
> [/api/?type=5](/api/?type=5)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|wxid |ture |string| 接收人wxid |
|imagePath|true |string|图片路径|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,不为0成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"wxid": "filehelper",
"imagePath": "C:/Users/123.png"
}
```
响应：
``` javascript
{"code":345686724,"result":"OK"}
```
#### 6.发送文件消息**
###### 接口功能
> 发送文件
###### 接口地址
> [/api/?type=6](/api/?type=6)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|wxid |ture |string| 接收人wxid |
|filePath|true |string|文件路径|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"wxid": "filehelper",
"filePath": "C:/Users/123.txt"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 9.hook消息**
###### 接口功能
> hook接收文本消息，图片消息，群消息.该接口将hook的消息通过tcp回传给本地的端口
###### 接口地址
> [/api/?type=9](/api/?type=9)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|port |ture |string| 本地服务端端口，用来接收消息内容 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"port": "19099"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 11.hook图片**
###### 接口功能
> hook图片原始内容，不推荐该接口，可以使用图片查询接口
###### 接口地址
> [/api/?type=11](/api/?type=11)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|imgDir |ture |string| 图片保存的目录 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"imgDir":"C:\\other"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 17.删除好友**
###### 接口功能
> 删除好友
###### 接口地址
> [/api/?type=17](/api/?type=17)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|wxid |ture |string| 好友wxid |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"wxid":"wxid_o"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 25.获取群成员**
###### 接口功能
> 获取群成员
###### 接口地址
> [/api/?type=25](/api/?type=25)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|chatRoomId |ture |string| 群id |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
|data|object|返回内容|
|admin|string|群主id|
|chatRoomId|string|群id|
|members|string|群成员id以^分隔|
###### 接口示例
入参：
``` javascript
{
"chatRoomId":"123@chatroom"
}
```
响应：
``` javascript
{"code":1,"data":{"admin":"wxid","chatRoomId":"123@chatroom","members":"wxid_123^Gwxid_456^Gwxid_45677"},"result":"OK"}
```
#### 27.删除群成员**
###### 接口功能
> 删除群成员
###### 接口地址
> [/api/?type=27](/api/?type=27)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|chatRoomId |ture |string| 群id |
|memberIds |ture |string| 成员id，以,分割 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"chatRoomId":"34932563384@chatroom",
"memberIds":"wxid_oyb662qhop4422"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 28.增加群成员**
###### 接口功能
> 增加群成员
###### 接口地址
> [/api/?type=28](/api/?type=28)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|chatRoomId |ture |string| 群id |
|memberIds |ture |string| 成员id，以,分割 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"chatRoomId":"34932563384@chatroom",
"memberIds":"wxid_oyb662qhop4422"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
#### 32.获取数据库句柄**
###### 接口功能
> 获取sqlite3数据库句柄
###### 接口地址
> [/api/?type=32](/api/?type=32)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
|data|array|返回数据|
|databaseName|string|数据库名称|
|handle|int|数据库句柄|
|tables|array|表信息|
|name|string|表名|
|rootpage|string|rootpage|
|sql|string|sql|
|tableName|string|tableName|
###### 接口示例
入参：
``` javascript
```
响应：
``` javascript
{
"data": [
{
"databaseName": "MicroMsg.db",
"handle": 119561688,
"tables": [
{
"name": "Contact",
"rootpage": "2",
"sql": "CREATE TABLE Contact(UserName TEXT PRIMARY KEY ,Alias TEXT,EncryptUserName TEXT,DelFlag INTEGER DEFAULT 0,Type INTEGER DEFAULT 0,VerifyFlag INTEGER DEFAULT 0,Reserved1 INTEGER DEFAULT 0,Reserved2 INTEGER DEFAULT 0,Reserved3 TEXT,Reserved4 TEXT,Remark TEXT,NickName TEXT,LabelIDList TEXT,DomainList TEXT,ChatRoomType int,PYInitial TEXT,QuanPin TEXT,RemarkPYInitial TEXT,RemarkQuanPin TEXT,BigHeadImgUrl TEXT,SmallHeadImgUrl TEXT,HeadImgMd5 TEXT,ChatRoomNotify INTEGER DEFAULT 0,Reserved5 INTEGER DEFAULT 0,Reserved6 TEXT,Reserved7 TEXT,ExtraBuf BLOB,Reserved8 INTEGER DEFAULT 0,Reserved9 INTEGER DEFAULT 0,Reserved10 TEXT,Reserved11 TEXT)",
"tableName": "Contact"
}
]
}
],
"result": "OK"
}
```
#### 34.查询数据库**
###### 接口功能
> 查询数据库
###### 接口地址
> [/api/?type=34](/api/?type=34)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|dbHandle |ture |int| 句柄 |
|sql |ture |string| sql语句 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
|data|array|返回数据|
###### 接口示例
入参：
``` javascript
{
"dbHandle": 219277920,
"sql":"select * from MSG where MsgSvrID=8985035417589024392"
}
```
响应：
``` javascript
{"code":1,"data":[["localId","TalkerId","MsgSvrID","Type","SubType","IsSender","CreateTime","Sequence","StatusEx","FlagEx","Status","MsgServerSeq","MsgSequence","StrTalker","StrContent","DisplayContent","Reserved0","Reserved1","Reserved2","Reserved3","Reserved4","Reserved5","Reserved6","CompressContent","BytesExtra","BytesTrans"],["6346","24","8985035417589024392","1","0","0","1670897832","1670897832000","0","0","2","1","778715089","wxid_1222","112","","0","2","","","","","","","CgQIEBAAGkEIBxI9PG1zZ3NvdXJjZT4KCTxzaWduYXR1cmU+djFfSFFyeVAwZTE8L3NpZ25hdHVyZT4KPC9tc2dzb3VyY2U+ChokCAISIDU5NjI1NjUxNWE0YzU2ZDQxZDJlOWMyYmIxMjFhNmZl",""]],"result":"OK"}
```
新增退出登录
2023-01-02 11:56:03 +08:00
#### 44.退出登录**
###### 接口功能
> 退出登录微信，相当于直接退出微信，跟手动退出比，少了重新打开登录的一步，dll注入后也会随微信关闭而关闭。调用后不能再继续操作dll。
###### 接口地址
> [/api/?type=44](/api/?type=44)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,非0成功|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
```
响应：
``` javascript
{"code":4344,"result":"OK"}
```
init commit
2022-12-21 20:30:44 +08:00
#### 46.联系人列表**
###### 接口功能
> 联系人列表
###### 接口地址
> [/api/?type=46](/api/?type=46)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
|data|array|返回内容|
|customAccount|string|自定义账号|
|delFlag|int|删除标志|
|type|int|好友类型|
|userName|string|用户名称|
|verifyFlag|int|验证|
|wxid|string|wxid|
###### 接口示例
入参：
``` javascript
{
"wxid": "filehelper",
"msgid":7215505498606506901
}
```
响应：
``` javascript
{"code":1,"data":[{"customAccount":"custom","delFlag":0,"type":8388611,"userName":"昵称","verifyFlag":0,"wxid":"wxid_123pcqm22"}]}
```
#### 47.群详情**
###### 接口功能
> 获取群详情
###### 接口地址
> [/api/?type=47](/api/?type=47)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|chatRoomId |ture |string| 群id |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
|data|object|返回内容|
|admin|string|群主id|
|chatRoomId|int|群id|
|notice|int|通知|
|xml|string|xml|
###### 接口示例
入参：
``` javascript
{
"wxid": "filehelper",
"msgid":7215505498606506901
}
```
响应：
``` javascript
{"code":1,"data":{"admin":"123","chatRoomId":"123@chatroom","notice":"1222","xml":""},"result":"OK"}
```
#### 48.获取解密图片**
###### 接口功能
> 获取解密图片
###### 接口地址
> [/api/?type=48](/api/?type=48)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|imagePath |ture |string| 图片路径 |
|savePath |ture |string| 保存路径 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,1成功, 0失败|
|result|string|成功提示|
###### 接口示例
入参：
``` javascript
{
"imagePath":"C:\\3a610d7bc1cf5a15d12225a64b8962.dat",
"savePath":"C:\\other"
}
```
响应：
``` javascript
{"code":1,"result":"OK"}
```
新增ocr
2022-12-29 15:00:14 +08:00
#### 49.提取文字**
###### 接口功能
> 提取图片中的文字
###### 接口地址
> [/api/?type=49](/api/?type=49)
###### HTTP请求方式
> POST JSON
###### 请求参数
|参数|必选|类型|说明|
|---|---|---|---|
|imagePath |ture |string| 图片路径 |
###### 返回字段
|返回字段|字段类型|说明 |
|---|---|---|
|code|int|返回状态,0成功, -1失败，1 2 则是缓存或者正在进行中需再调用一次|
|result|string|成功提示|
|text|string|提取的相应文字|
###### 接口示例
入参：
``` javascript
{
"imagePath":"C:\\3a610d7bc1cf5a15d12225a64b8962.dat"
}
```
响应：
``` javascript
{"code":0,"result":"OK","text":"搜索商品新闻简报小程序上线啦!!!我的收藏地址管理促销单品多买多省热门榜单热门榜单首发新品精品推荐精品推荐首发新品FRONTI警微安奈儿 童装冬季款男￥39900￥59.90帕拉丁品牌 时尚双背包409 00￥49.90我是有底线的首页分类购物车我的"}
```
环境说明
2022-12-21 20:42:34 +08:00
#### 感谢
update reademe
2022-12-26 16:57:18 +08:00
https://github.com/ljc545w/ComWeChatRobot
https://github.com/NationalSecurityAgency/ghidra
https://github.com/x64dbg/x64dbg
Reference in New Issue Copy Permalink