# 大赢家微信接收助手（Hook 版）· Windows 使用说明

## 与截图版的区别
Hook 版直接依附微信本体读取消息：
- 无需打开/保持群窗口，窗口可最小化
- 文本与昵称来自微信本体，无 OCR 误差 → 满足自动录入条件（2 分钟内、格式有效）
- 消息被撤回不影响：撤回前已捕获原文

## 安装步骤（一次性）
1. 安装 64 位 Python 3.9：https://www.python.org/downloads/ （勾选 Add to PATH）
2. 安装指定版本的微信（见下方「微信版本」），安装后关闭微信自动更新
3. 完整解压本包到一个固定目录（不要放在 OneDrive/桌面同步目录）
4. 若杀毒软件拦截 `sdk\libs\WeChatApi.dll`，加入信任白名单
5. 双击 start.bat，首次会自动安装依赖

## 使用步骤
1. 登录电脑微信
2. 网站「微信订单」→ 创建电脑连接 → 复制 DYJW- 密钥
3. 助手页面粘贴密钥 → 保存连接 → 开始接收
4. 网站为群配置绑定业务员和彩种（自动/核对模式）

## 微信版本（重要）
- 当前 SDK 专业版官方指定微信版本以 WeChatPYAPI 项目 README 为准（README 标注 4.1.12.26）
- 先尝试你现有的 4.2.0.54：启动后若微信能正常登录且助手状态显示「微信已登录（Hook 注入中）」即说明兼容
- 若注入失败/崩溃：卸载微信，安装指定版本（WeChatPYAPI 作者 QQ 群 54995858 提供各版本安装包），并把助手包内 SDK 换成对应版本的组件
- 版本核对：微信设置 → 关于 → 版本号；助手数据目录 `~/.dayingjia/wechat-hook/sdk-debug.jsonl` 会记录 SDK 原始返回，用于快速定位兼容问题

## 故障排查
| 现象 | 处理 |
|---|---|
| 状态「微信未登录，请扫码登录」 | 打开微信扫码登录 |
| 状态「微信进程已结束」 | 重新打开微信（助手会自动重新注入） |
| 状态「群『X』未找到」 | 网站填写的群名必须与微信群标题中的文字一致（或为其唯一片段） |
| 消息一直等待重试 | 网站连接被停用/账号授权到期，或网络异常；恢复后自动重发 |
| 群里发了但网站收不到 | 确认该群已在网站绑定；确认是文本消息（图片/语音不解析）；确认发送者过滤设置 |

## 安全
- 程序只做被动接收，不发送任何消息、不读取微信数据库、不接触微信密码
- 连接密钥可随时在网站停用；数据目录 `~/.dayingjia/wechat-hook` 仅存密钥与待发送队列
