├── .gitignore ├── README.md ├── WeeBot.md └── dist └── WeeBot-3.9.10.27-0.6.0.exe /.gitignore: -------------------------------------------------------------------------------- 1 | /_agent.js 2 | /node_modules 3 | _xp.js 4 | agent/*.js 5 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # WeeBot 2 | 3 | WeeBot提供最基本的消息收发功能，帮助你实现简单的自动化操作 4 | 5 | ## 下载和启动 6 | 7 | 1. 下载程序包 [WeeBot-3.9.10.27-0.6.0.zip](https://www.yuque.com/attachments/yuque/0/2024/zip/250308/1718969080072-81e3b9cc-d712-4005-9a38-f1fbb976616a.zip?_lake_card=%7B%22src%22%3A%22https%3A%2F%2Fwww.yuque.com%2Fattachments%2Fyuque%2F0%2F2024%2Fzip%2F250308%2F1718969080072-81e3b9cc-d712-4005-9a38-f1fbb976616a.zip%22%2C%22name%22%3A%22WeeBot-3.9.10.27-0.6.0.zip%22%2C%22size%22%3A45898878%2C%22ext%22%3A%22zip%22%2C%22source%22%3A%22%22%2C%22status%22%3A%22done%22%2C%22download%22%3Atrue%2C%22taskId%22%3A%22u515ede7c-14f2-4e3a-93b9-55e8708dc30%22%2C%22taskType%22%3A%22upload%22%2C%22type%22%3A%22application%2Fx-zip-compressed%22%2C%22__spacing%22%3A%22both%22%2C%22mode%22%3A%22title%22%2C%22id%22%3A%22u71375e1b%22%2C%22margin%22%3A%7B%22top%22%3Atrue%2C%22bottom%22%3Atrue%7D%2C%22card%22%3A%22file%22%7D) 8 | 2. 登录客户端，确认当前版本为3.9.10.27（[下载客户端](https://github.com/tom-snow/wechat-windows-versions/releases/download/v3.9.10.27/WeChatSetup-3.9.10.27.exe)） 9 | 3. 解压缩后启动WeeBot程序，点击【Start】启动服务，点击【Stop】取消程序挂接 10 | 11 | ## 接收消息 12 | 13 | 协议：websoket 14 | 15 | 连接地址：ws://127.0.0.1:19099 16 | 17 | 使用任意编程语言启动一个ws client即可实时接收消息推送 18 | 接收消息示例： 19 | 20 | ```json 21 | { 22 | "id": "1264199305822102857", 23 | "filename": "", 24 | "text": "Jim", 25 | "timestamp": 1718391525, 26 | "type": 1, 27 | "talkerId": "luyc", 28 | "roomId": "21341182572@chatroom", 29 | "mentionIds": [], 30 | "listenerId": "", 31 | "isSelf": false 32 | } 33 | ``` 34 | 35 | ## WeeBot API说明 36 | 37 | 协议：http 38 | 39 | API地址： http://127.0.0.1:19088 40 | 41 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 42 | 43 | ### 获取联系人列表 GET /api/contacts 44 | 45 | ```json 46 | { 47 | "code": 1, 48 | "data": [ 49 | { 50 | "id": "wwwang99326", 51 | "gender": 1, 52 | "type": 3, 53 | "name": "踏雪御苍穹", 54 | "friend": true, 55 | "star": false, 56 | "coworker": false, 57 | "address": null, 58 | "weixin": "cya89", 59 | "corporation": "", 60 | "title": "", 61 | "description": "", 62 | "phone": [] 63 | }, 64 | { 65 | "id": "wxid_sonjrdopx77221", 66 | "gender": 1, 67 | "type": 3, 68 | "name": "一类化学危险品汽车修理", 69 | "friend": true, 70 | "star": false, 71 | "coworker": false, 72 | "address": null, 73 | "weixin": "Z3381108383", 74 | "corporation": "", 75 | "title": "", 76 | "description": "", 77 | "phone": [] 78 | }], 79 | "msg": "success" 80 | } 81 | ``` 82 | 83 | ### 获取群列表 GET /api/rooms 84 | 85 | ```json 86 | { 87 | "code": 1, 88 | "data": [ 89 | { 90 | "id": "20800000065@chatroom", 91 | "gender": 1, 92 | "type": 2, 93 | "name": "羽毛球俱乐部", 94 | "friend": true, 95 | "star": false, 96 | "coworker": false, 97 | "address": null, 98 | "weixin": "", 99 | "corporation": "", 100 | "title": "", 101 | "description": "", 102 | "phone": [] 103 | }, 104 | { 105 | "id": "2037110006@chatroom", 106 | "gender": 1, 107 | "type": 2, 108 | "name": "联盟🏸", 109 | "friend": true, 110 | "star": false, 111 | "coworker": false, 112 | "address": null, 113 | "weixin": "", 114 | "corporation": "", 115 | "title": "", 116 | "description": "", 117 | "phone": [] 118 | }], 119 | "msg": "success" 120 | } 121 | ``` 122 | 123 | ### 获取登录用户信息 GET /api/contacts/self 124 | 125 | ```json 126 | { 127 | "code": 1, 128 | "data": { 129 | "id": "wxid_xxx0o1t51l3f57221", 130 | "gender": 1, 131 | "name": "大师", 132 | "coworker": true, 133 | "avatar": "https://wx.qlogo.cn/mmhead/ver_1/2FFoLE7eRpAOFHUwYkLyicQwrhsDHZU1Nmp0IcDKJcmRNxlTgXlzrvmAYJDQ32NibNRBRTxfGyK09UyUgPibjAYibc7xJWtJvPoRfwAfRQdvgG8/0", 134 | "address": "", 135 | "alias": "", 136 | "city": "Haidian", 137 | "province": "Beijing", 138 | "weixin": "ledongmao", 139 | "corporation": "", 140 | "title": "", 141 | "description": "", 142 | "phone": [ 143 | "15313358151" 144 | ] 145 | }, 146 | "msg": "success" 147 | } 148 | ``` 149 | 150 | ### 发送文本消息 POST /api/message/text 151 | 152 | ```json 153 | {"contactId": "filehelper","text": "1112224"} 154 | ``` 155 | 156 | ```json 157 | { 158 | "code": 1, 159 | "data": 1, 160 | "msg": "success" 161 | } 162 | ``` 163 | 164 | ## 兼容wxhelper API说明 165 | 166 | 兼容wxhelper接口，服务端口、路径、请求参数与wxhelper一致，**响应参数中的data有差异** 167 | 168 | 协议：http 169 | 170 | API地址： http://127.0.0.1:19088 171 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 172 | 173 | ### 获取登录用户信息 POST /api/userInfo 174 | 175 | 入参： 176 | 177 | ```javascript 178 | {} 179 | ``` 180 | 181 | 响应： 182 | 183 | ```javascript 184 | { 185 | "code": 1, 186 | "data": { 187 | "account": "xxx", 188 | "city": "Zhengzhou", 189 | "country": "CN", 190 | "currentDataPath": "C:\\WeChat Files\\wxid_xxx\\", 191 | "dataSavePath": "C:\\wechatDir\\WeChat Files\\", 192 | "dbKey": "965715e30e474da09250cb5aa047e3940ffa1c8f767c4263b132bb512933db49", 193 | "headImage": "https://wx.qlogo.cn/mmhead/ver_1/MiblV0loY0GILewQ4u2121", 194 | "mobile": "13949175447", 195 | "name": "xxx", 196 | "province": "Henan", 197 | "signature": "xxx", 198 | "wxid": "wxid_22222" 199 | }, 200 | "msg": "success" 201 | } 202 | ``` 203 | 204 | ### 获取联系人和群列表 POST /api/getContactList 205 | 206 | 入参： 207 | 208 | ```json 209 | {} 210 | ``` 211 | 212 | 响应： 213 | 214 | ```json 215 | { 216 | "code": 1, 217 | "data": [ 218 | { 219 | "customAccount": "", 220 | "encryptName": "v3_020b3826fd03010000000000e04128fddf4d90000000501ea9a3dba12f95f6b60a0536a1adb6b40fc4086288f46c0b89e6c4eb8062bb1661b4b6fbab708dc4f89d543d7ade135b2be74c14b9cfe3accef377b9@stranger", 221 | "nickname": "文件传输助手", 222 | "pinyin": "WJCSZS", 223 | "pinyinAll": "wenjianchuanshuzhushou", 224 | "remark": "", 225 | "remark_pinyin": "", 226 | "remark_pinyin_all": "", 227 | "label_ids": "", 228 | "reserved1": 1, 229 | "reserved2": 1, 230 | "type": 3, 231 | "verifyFlag": 0, 232 | "wxid": "filehelper" 233 | } 234 | ], 235 | "msg": "success" 236 | } 237 | ``` 238 | 239 | ### 发送文本消息 POST /api/sendTextMsg 240 | 241 | 入参： 242 | 243 | ```typescript 244 | {"wxid": "filehelper","msg": "1112224"} 245 | ``` 246 | 247 | 响应： 248 | 249 | ```json 250 | { 251 | "code": 1, 252 | "data": 1, 253 | "msg": "success" 254 | } 255 | ``` 256 | 257 | ## 兼容wechat-bot API说明 258 | 259 | 兼容wechat-bot接口，服务端口、路径、请求参数与wechat-bot一致，**响应参数中的data有差异** 260 | 261 | 协议：http 262 | 263 | API地址： http://127.0.0.1:19088 264 | 265 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 266 | 267 | ### 获取联系人和群列表 POST **/api/getcontactlist** 268 | 269 | ```json 270 | { 271 | "id":"123456", 272 | "type":5000, 273 | "roomid":"null", 274 | "wxid":"null", 275 | "content":"null", 276 | "nickname":"null", 277 | "ext":"null" 278 | } 279 | ``` 280 | 281 | ```json 282 | { 283 | "code": 1, 284 | "data": [ 285 | { 286 | "customAccount": "", 287 | "encryptName": "v3_020b3826fd03010000000000e04128fddf4d90000000501ea9a3dba12f95f6b60a0536a1adb6b40fc4086288f46c0b89e6c4eb8062bb1661b4b6fbab708dc4f89d543d7ade135b2be74c14b9cfe3accef377b9@stranger", 288 | "nickname": "文件传输助手", 289 | "pinyin": "WJCSZS", 290 | "pinyinAll": "wenjianchuanshuzhushou", 291 | "remark": "", 292 | "remark_pinyin": "", 293 | "remark_pinyin_all": "", 294 | "label_ids": "", 295 | "reserved1": 1, 296 | "reserved2": 1, 297 | "type": 3, 298 | "verifyFlag": 0, 299 | "wxid": "filehelper" 300 | } 301 | ], 302 | "msg": "success" 303 | } 304 | ``` 305 | 306 | ### 发送文本消息 POST **/api/sendtxtmsg** 307 | 308 | ```json 309 | { 310 | "id":"123456", 311 | "type":555, 312 | "wxid":"23023281066@chatroom", 313 | "content":"hello word", 314 | "nickname":"null", 315 | "ext":"null" 316 | } 317 | ``` 318 | 319 | ```json 320 | { 321 | "code": 1, 322 | "data": 1, 323 | "msg": "success" 324 | } 325 | ``` 326 | 327 | ## 更新日志 328 | 329 | v0.6.0 330 | 331 | - 新增wechat-bot兼容接口API 332 | 333 | v0.5.3 334 | 335 | - 优化启动逻辑，程序开启时自动启动，可手动停止 336 | - 优化按钮操作显示，增加按钮激活、禁用状态 337 | - 优化图片解析逻辑，增加延时保证缩略图下载 338 | 339 | v0.5.0 340 | 341 | - 新增接收图片（缩略图）消息 342 | - 新增接收文件消息 343 | 344 | v0.4.0 345 | 346 | - 新增获取群列表接口/api/rooms 347 | - 修复无法正常退出问题 348 | - 修复联系人列表信息不全问题 349 | - 优化响应数据格式 350 | 351 | v0.1.0 352 | 353 | - 初始化版本，支持获取联系人列表、获取当前用户信息、发送文本消息、接收消息 354 | -------------------------------------------------------------------------------- /WeeBot.md: -------------------------------------------------------------------------------- 1 | :::info 2 | WeeBot提供最基本的WeChat消息收发功能，帮助你实现简单的自动化操作 3 | ::: 4 | ## 下载和启动 5 | 6 | 1. 下载程序包 [WeeBot-3.9.10.27-0.6.0.zip](https://www.yuque.com/attachments/yuque/0/2024/zip/250308/1718969080072-81e3b9cc-d712-4005-9a38-f1fbb976616a.zip?_lake_card=%7B%22src%22%3A%22https%3A%2F%2Fwww.yuque.com%2Fattachments%2Fyuque%2F0%2F2024%2Fzip%2F250308%2F1718969080072-81e3b9cc-d712-4005-9a38-f1fbb976616a.zip%22%2C%22name%22%3A%22WeeBot-3.9.10.27-0.6.0.zip%22%2C%22size%22%3A45898878%2C%22ext%22%3A%22zip%22%2C%22source%22%3A%22%22%2C%22status%22%3A%22done%22%2C%22download%22%3Atrue%2C%22taskId%22%3A%22u515ede7c-14f2-4e3a-93b9-55e8708dc30%22%2C%22taskType%22%3A%22upload%22%2C%22type%22%3A%22application%2Fx-zip-compressed%22%2C%22__spacing%22%3A%22both%22%2C%22mode%22%3A%22title%22%2C%22id%22%3A%22u71375e1b%22%2C%22margin%22%3A%7B%22top%22%3Atrue%2C%22bottom%22%3Atrue%7D%2C%22card%22%3A%22file%22%7D) 7 | 2. 登录WeChat客户端，确认当前版本为3.9.10.27（[下载WeChat客户端](https://github.com/tom-snow/wechat-windows-versions/releases/download/v3.9.10.27/WeChatSetup-3.9.10.27.exe)） 8 | 3. 解压缩后启动WeeBot程序，点击【Start】启动服务，点击【Stop】取消程序挂接 9 | 10 | ![a024aae6eec40d8ddebe01cd52916ffc.png](https://cdn.nlark.com/yuque/0/2024/png/250308/1718327308477-cf36e606-0e52-47af-8809-462fb1d0129e.png#averageHue=%23e6e6e6&clientId=u5d00b06c-dad2-4&from=paste&height=331&id=u16e01af9&originHeight=588&originWidth=1224&originalType=binary&ratio=1.75&rotation=0&showTitle=false&size=174721&status=done&style=none&taskId=uab297acf-d025-410d-ba77-4b8bc6e589b&title=&width=690) 11 | ## 接收消息 12 | 协议：websoket 13 | 连接地址：ws://127.0.0.1:19099 14 | 使用任意编程语言启动一个ws client即可实时接收消息推送 15 | 接收消息示例： 16 | ```json 17 | { 18 | "id": "1264199305822102857", 19 | "filename": "", 20 | "text": "Jim", 21 | "timestamp": 1718391525, 22 | "type": 1, 23 | "talkerId": "luyc", 24 | "roomId": "21341182572@chatroom", 25 | "mentionIds": [], 26 | "listenerId": "", 27 | "isSelf": false 28 | } 29 | ``` 30 | ## WeeBot API说明 31 | 协议：http 32 | API地址： http://127.0.0.1:19088 33 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 34 | ### 获取联系人列表 GET /api/contacts 35 | ```json 36 | { 37 | "code": 1, 38 | "data": [ 39 | { 40 | "id": "wang9935226", 41 | "gender": 1, 42 | "type": 3, 43 | "name": "青牛踏雪御苍穹", 44 | "friend": true, 45 | "star": false, 46 | "coworker": false, 47 | "address": null, 48 | "weixin": "cya89", 49 | "corporation": "", 50 | "title": "", 51 | "description": "", 52 | "phone": [] 53 | }, 54 | { 55 | "id": "wxid_sonjrdopx77221", 56 | "gender": 1, 57 | "type": 3, 58 | "name": "一类化学危险品汽车修理", 59 | "friend": true, 60 | "star": false, 61 | "coworker": false, 62 | "address": null, 63 | "weixin": "Z3381108383", 64 | "corporation": "", 65 | "title": "", 66 | "description": "", 67 | "phone": [] 68 | }], 69 | "msg": "success" 70 | } 71 | ``` 72 | ### 获取群列表 GET /api/rooms 73 | ```json 74 | { 75 | "code": 1, 76 | "data": [ 77 | { 78 | "id": "20889085065@chatroom", 79 | "gender": 1, 80 | "type": 2, 81 | "name": "干球人羽毛球俱乐部", 82 | "friend": true, 83 | "star": false, 84 | "coworker": false, 85 | "address": null, 86 | "weixin": "", 87 | "corporation": "", 88 | "title": "", 89 | "description": "", 90 | "phone": [] 91 | }, 92 | { 93 | "id": "2037113676@chatroom", 94 | "gender": 1, 95 | "type": 2, 96 | "name": "星羽联盟🏸", 97 | "friend": true, 98 | "star": false, 99 | "coworker": false, 100 | "address": null, 101 | "weixin": "", 102 | "corporation": "", 103 | "title": "", 104 | "description": "", 105 | "phone": [] 106 | }], 107 | "msg": "success" 108 | } 109 | ``` 110 | ### 获取登录用户信息 GET /api/contacts/self 111 | ```json 112 | { 113 | "code": 1, 114 | "data": { 115 | "id": "wxid_0o1t51l3f57221", 116 | "gender": 1, 117 | "name": "大师", 118 | "coworker": true, 119 | "avatar": "https://wx.qlogo.cn/mmhead/ver_1/2FFoLE7eRpAOFHUwYkLyicQwrhsDHZU1Nmp0IcDKJcmRNxlTgXlzrvmAYJDQ32NibNRBRTxfGyK09UyUgPibjAYibc7xJWtJvPoRfwAfRQdvgG8/0", 120 | "address": "", 121 | "alias": "", 122 | "city": "Haidian", 123 | "province": "Beijing", 124 | "weixin": "ledongmao", 125 | "corporation": "", 126 | "title": "", 127 | "description": "", 128 | "phone": [ 129 | "15313358151" 130 | ] 131 | }, 132 | "msg": "success" 133 | } 134 | ``` 135 | ### 发送文本消息 POST /api/message/text 136 | ```json 137 | {"contactId": "filehelper","text": "1112224"} 138 | ``` 139 | ```json 140 | { 141 | "code": 1, 142 | "data": 1, 143 | "msg": "success" 144 | } 145 | ``` 146 | ## 兼容wxhelper API说明 147 | 兼容wxhelper接口，服务端口、路径、请求参数与wxhelper一致，**响应参数中的data有差异** 148 | 协议：http 149 | API地址： http://127.0.0.1:19088 150 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 151 | ### 获取登录用户信息 POST /api/userInfo 152 | 入参： 153 | ```javascript 154 | {} 155 | ``` 156 | 响应： 157 | ```javascript 158 | { 159 | "code": 1, 160 | "data": { 161 | "account": "xxx", 162 | "city": "Zhengzhou", 163 | "country": "CN", 164 | "currentDataPath": "C:\\WeChat Files\\wxid_xxx\\", 165 | "dataSavePath": "C:\\wechatDir\\WeChat Files\\", 166 | "dbKey": "965715e30e474da09250cb5aa047e3940ffa1c8f767c4263b132bb512933db49", 167 | "headImage": "https://wx.qlogo.cn/mmhead/ver_1/MiblV0loY0GILewQ4u2121", 168 | "mobile": "13949175447", 169 | "name": "xxx", 170 | "province": "Henan", 171 | "signature": "xxx", 172 | "wxid": "wxid_22222" 173 | }, 174 | "msg": "success" 175 | } 176 | ``` 177 | ### 获取联系人和群列表 POST /api/getContactList 178 | 入参： 179 | ```json 180 | {} 181 | ``` 182 | 1 183 | 响应： 184 | ```json 185 | { 186 | "code": 1, 187 | "data": [ 188 | { 189 | "customAccount": "", 190 | "encryptName": "v3_020b3826fd03010000000000e04128fddf4d90000000501ea9a3dba12f95f6b60a0536a1adb6b40fc4086288f46c0b89e6c4eb8062bb1661b4b6fbab708dc4f89d543d7ade135b2be74c14b9cfe3accef377b9@stranger", 191 | "nickname": "文件传输助手", 192 | "pinyin": "WJCSZS", 193 | "pinyinAll": "wenjianchuanshuzhushou", 194 | "remark": "", 195 | "remark_pinyin": "", 196 | "remark_pinyin_all": "", 197 | "label_ids": "", 198 | "reserved1": 1, 199 | "reserved2": 1, 200 | "type": 3, 201 | "verifyFlag": 0, 202 | "wxid": "filehelper" 203 | } 204 | ], 205 | "msg": "success" 206 | } 207 | ``` 208 | ### 发送文本消息 POST /api/sendTextMsg 209 | 入参： 210 | ```typescript 211 | {"wxid": "filehelper","msg": "1112224"} 212 | ``` 213 | 响应： 214 | ```json 215 | { 216 | "code": 1, 217 | "data": 1, 218 | "msg": "success" 219 | } 220 | ``` 221 | ## 兼容wechat-bot API说明 222 | 兼容wechat-bot接口，服务端口、路径、请求参数与wechat-bot一致，**响应参数中的data有差异** 223 | 协议：http 224 | API地址： http://127.0.0.1:19088 225 | 同时支持GET/POST的接口，在使用POST方法请求时body设置为{} 226 | ### 获取联系人和群列表 POST **/api/getcontactlist** 227 | ```json 228 | { 229 | "id":"123456", 230 | "type":5000, 231 | "roomid":"null", 232 | "wxid":"null", 233 | "content":"null", 234 | "nickname":"null", 235 | "ext":"null" 236 | } 237 | ``` 238 | ```json 239 | { 240 | "code": 1, 241 | "data": [ 242 | { 243 | "customAccount": "", 244 | "encryptName": "v3_020b3826fd03010000000000e04128fddf4d90000000501ea9a3dba12f95f6b60a0536a1adb6b40fc4086288f46c0b89e6c4eb8062bb1661b4b6fbab708dc4f89d543d7ade135b2be74c14b9cfe3accef377b9@stranger", 245 | "nickname": "文件传输助手", 246 | "pinyin": "WJCSZS", 247 | "pinyinAll": "wenjianchuanshuzhushou", 248 | "remark": "", 249 | "remark_pinyin": "", 250 | "remark_pinyin_all": "", 251 | "label_ids": "", 252 | "reserved1": 1, 253 | "reserved2": 1, 254 | "type": 3, 255 | "verifyFlag": 0, 256 | "wxid": "filehelper" 257 | } 258 | ], 259 | "msg": "success" 260 | } 261 | ``` 262 | ### 发送文本消息 POST **/api/sendtxtmsg** 263 | ```json 264 | { 265 | "id":"123456", 266 | "type":555, 267 | "wxid":"23023281066@chatroom", 268 | "content":"hello word", 269 | "nickname":"null", 270 | "ext":"null" 271 | } 272 | ``` 273 | ```json 274 | { 275 | "code": 1, 276 | "data": 1, 277 | "msg": "success" 278 | } 279 | ``` 280 | ## 更新日志 281 | v0.6.0 282 | 283 | - 新增wechat-bot兼容接口API 284 | 285 | v0.5.3 286 | 287 | - 优化启动逻辑，程序开启时自动启动，可手动停止 288 | - 优化按钮操作显示，增加按钮激活、禁用状态 289 | - 优化图片解析逻辑，增加延时保证缩略图下载 290 | 291 | v0.5.0 292 | 293 | - 新增接收图片（缩略图）消息 294 | - 新增接收文件消息 295 | 296 | v0.4.0 297 | 298 | - 新增获取群列表接口/api/rooms 299 | - 修复无法正常退出问题 300 | - 修复联系人列表信息不全问题 301 | - 优化响应数据格式 302 | 303 | v0.1.0 304 | 305 | - 初始化版本，支持获取联系人列表、获取当前用户信息、发送文本消息、接收消息 306 | -------------------------------------------------------------------------------- /dist/WeeBot-3.9.10.27-0.6.0.exe: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/atorber/WeeBot/86d8d63abac22284a13f5c3068da4197d582c495/dist/WeeBot-3.9.10.27-0.6.0.exe --------------------------------------------------------------------------------