微信收款助手监控脚本 — 更新日志v2.0（RapidOCR 极速版）

项目：Windows 微信收款助手 OCR 监控 + 自动推送
更新日期：2026-10-01
版本：v2.0（RapidOCR 极速版）

一、版本概述

本次更新对原脚本进行了安全性、稳定性、性能三方面的全面改造。核心成果：

• ⚡ 单笔识别耗时从 10~20 秒压到 1.5~3 秒（提升 5~10 倍）
• 🔒 密钥外置，消除明文硬编码风险
• 🎯 ROI 自学习，自动定位金额行，适配不同窗口布局
• 🛡️ 短时去重，解决”同金额误判为重复订单”问题

二、重大改进

1. 安全性修复

新增 config.json 配置文件，所有可变参数集中管理，代码不再包含敏感信息。

2. 稳定性修复

3. 性能优化

3.1 OCR 从 10 秒 → 1.5 秒

3.2 心跳/推送并发化

• 心跳：ThreadPoolExecutor 同时请求两个服务端，总耗时从 5~10s 降到 <3s
• 推送：两服务端并发，耗时从 2.7s 降到 1.1s

3.3 关键日志耗时观测

新增耗时打印：

[OCR-快] ROI 命中: 0.01，OCR 2.69s，总 2.71s
[推送] 完成，耗时 1.15s，成功=True
[周期] 本次检测总耗时 3.92s

4. 新增：ROI 自学习机制

背景：窗口布局随微信版本/分辨率变化，写死比例容易裁偏。

机制：

1. 每次全图 OCR 成功后，从结果里找「纯金额行」（正则 ^[¥￥]?\s*\d+\.\d{2}$）
2. 优先选「收款金额」标签下方最近的那一行
3. 把该行的像素坐标（不是比例）写回 config.json
4. 下次识别直接走新 ROI，速度极快

日志示例：

[自学习] 金额行原始像素: y[331-381] x[234-361]，图尺寸 600x800，来源文本：￥0.01
[配置] 已保存: {'amount_roi_px_top': 311, 'amount_roi_px_bottom': 401, ...}
[自学习] ROI 已更新为像素：y[311-401] x[216-379]

关键设计：用像素坐标而不是比例，避免 PrintWindow 截图尺寸与窗口尺寸不一致导致的换算误差。

5. 新增：OCR 结果 strict 修复

背景：rec-only 模式下，RapidOCR 对「大字号 + 有间隙」的金额容易丢字符，例如：

• ￥0.01 → 识别为 01（丢了 ￥ 和 .）
• ￥1.00 → 识别为 .00（丢了 1）

修复逻辑（strict=True 时启用）：

日志示例：

[OCR修复] '01' → '0.01'（补小数点+去前导0）
[OCR修复] '02' → '0.02'（补小数点+去前导0）

6. 新增：短时去重机制

背景：ROI 只裁金额行，没有时间信息，导致不同订单但同金额的 key 相同（如 unknown_0.01），被误判为重复。

旧机制：

dedup_key = f"{msg_time}_{amount}"   # msg_time 永远是 unknown
if dedup_key in pushed_records: skip

新机制：

short_key = f"{current_hash[:8]}_{amount}"   # 截图哈希 + 金额
if now - recent_push.get(short_key, 0) < 10:  # 10 秒内同图同金额才去重
    skip

效果：

• 同一订单的重复检测（截图未变）→ 被 pHash 提前跳过，不会进到推送
• 同一订单截图微抖 → 10 秒内同 hash 同金额 → 去重 ✅
• 不同订单同金额 → 截图 hash 不同 → 正常推送 ✅

三、配置项说明

config.json 主要字段：

{
  "servers": [
    {
      "name": "Workers版",
      "url": "https://域名/appPush",
      "heart_url": "https://域名/appHeart",
      "key": "请改成真实密钥",
      "timeout": 5
    },
    {
      "name": "PHP版",
      "url": "http://域名/appPush",
      "heart_url": "http://域名/appHeart",
      "key": "秘钥",
      "timeout": 10
    }
  ],
  "window_title": "微信收款助手",
  "scan_interval": 0.5,
  "heartbeat_interval": 10,
  "time_filter_minutes": 5,
  "debug_save": false,
  "window_width": 600,
  "window_height": 800,
  "amount_roi_px_left":   216,
  "amount_roi_px_right":  379,
  "amount_roi_px_top":    311,
  "amount_roi_px_bottom": 401
}

关键字段：

四、性能对比

五、升级须知

5.1 从旧版升级

1. 删除旧的 config.json（旧版无此文件，不用删；如果之前手建过，删掉让程序重新生成）
2. 替换整个 .py 文件
3. 首次运行会自动生成 config.json，手动把 key 改成真实密钥
4. 跑一笔收款，让它自学习 ROI
5. 确认 [OCR-快] ROI 命中 后，把 debug_save 改为 false

5.2 首次部署

1. 安装依赖：

   pip install rapidocr_onnxruntime pygetwindow pywin32 pillow numpy requests infi.systray
   

2. 把 icon.ico 放在脚本同目录（可选）
3. 运行脚本

5.3 打包成 exe（可选）

python -m PyInstaller --onefile --noconsole --name 微信收款监控 --collect-all rapidocr_onnxruntime --collect-all onnxruntime --collect-all cv2 --add-data "icon.ico;." --hidden-import numpy --hidden-import PIL --hidden-import pygetwindow --hidden-import win32gui --hidden-import infi.systray vmq.py

打包后 config.json 会生成在 exe 同目录，不会被 PyInstaller 的临时目录干扰。

六、已知问题与后续规划

已知问题

1. ￥1.00 这类金额，rec-only 偶尔丢整数位

   • 当前 strict 修复未覆盖 .00 → 0.00 场景（因为 0 元无意义，未处理）
   • 若实际场景有 1.00 以上金额，可考虑切回 det+rec 全流程

2. 自学习坐标可能偏移

   • RapidOCR 返回坐标的参考系因版本而异
   • 已通过”像素存坐标”降低影响，但极端情况下仍需手动微调

3. 窗口必须可见

   • PrintWindow 要求窗口未最小化，最小化时会先 ShowWindow(SW_RESTORE)
   • 若窗口被其他窗口完全遮挡，仍能截图（PrintWindow 特性），不影响

后续规划

• [ ] 支持多窗口/多账号同时监控
• [ ] 识别结果置信度过滤（低于阈值跳过）
• [ ] Webhook / 钉钉 / 企业微信 多种推送通道
• [ ] 打包成带 GUI 配置界面的版本

七、故障排查速查

八、改造历程回顾

从最初的 v1.0 到 v2.0，共修复 12 类问题：

九、致谢

感谢在调试过程中提供多轮日志和 debug_roi.png 的实测反馈。正是这些真实数据让 ROI 自学习和 strict 修复逻辑得以精准定位问题并逐层修复。

如遇新问题，请附上 vmq.log 完整日志 + debug_roi.png（如 debug_save=true），便于快速定位。

十、附上完整源代码