--- name: wechat-image-sender description: 通过 LSPosed 内部 API 发送微信图片(调微信自己的发图管线,无 UI 模拟,全图 CDN 上传) version: 2.0 category: communication --- # WeChat Image Sender(内部 API,全图 CDN) 发图给微信联系人,**直接调微信自己的发送 API**——不模拟点击、不走系统分享、不做 OCR 找联系人。 接收方收到**全分辨率原图**(可点开、可保存)。 ## 调用前必须过闸口 **任何发图操作前,必须先调 `check_wechat_ready()` 检查微信登录状态。** 闸口不通过则拒绝执行,不要尝试启动微信。 ```python import sys; sys.path.insert(0, '/data/data/com.termux/files/home/pixelphone/event_bus') from wechat_hook_send import check_wechat_ready gate = check_wechat_ready() if not gate["ready"]: raise SystemExit(f"WeChat not ready: {gate['reason']}") ``` 详见 `wechat-login-gate` skill。 ## When to Use - 发图片给微信联系人(截图 / 信息图 / 报告图) - 需要程序化、无 UI 干扰地发图 ## ⚠️ 前置条件:微信必须在线(Step 0,不可跳过) **发送图片前必须验证微信登录状态。** `send_image_via_hook` 的 broadcast 返回 `result=0` 只表示系统接受了广播,不代表微信 hook 的 BroadcastReceiver 已注册或已登录。微信进程不在/处于登录页/副设备过期时,broadcast 静默成功但图片不会发出。 ### Step 0 检测 ```bash # 1. 进程在不在(缺少这步 = 广播白发了) pidof com.tencent.mm # 2. 前台是微信主界面而非登录页(缺少这步 = 图片进不去) su -c 'dumpsys activity activities | grep topResumedActivity | grep LauncherUI' ``` 两项都通过才继续发送。任一项失败 → **停止发送**,先修复微信状态(参考 `wechat-pad-login-repair` skill)。不要跳过检测直接发。 `send_image_via_hook` 内置的 `_wechat_running()` 只做 `pidof` 进程检测,不做登录态检测,且 `_start_wechat()` 只能启动进程不能保证登录 → **调用方必须先做 Step 0,不可依赖内置检测**。 ## 从 Flask/Web 服务调用(非 Hermes CLI) Hermes CLI `-t terminal` 子进程**没有 MCP 工具**,无法调 `send_wechat_image`。 在 Flask 中发图的正确方式:**直接 import `send_image_via_hook`**。 ```python import sys, os _base = os.path.join(os.path.dirname(__file__), '..', '.hermes', 'event_bus') sys.path.insert(0, _base) from wechat_hook_send import send_image_via_hook # 先复制图片到微信可读路径 subprocess.run(["su", "-c", f"cp {src} /sdcard/Pictures/x.png && chmod 644 /sdcard/Pictures/x.png"]) # 调用 send_image_via_hook(wxid="34576206251@chatroom", image_path="/sdcard/Pictures/x.png") ``` 验证于 2026-07-08:Flask 调此方法成功发送 2MB PNG 到微信群。 ## 核心工具:`send_wechat_image`(直接调用) ```python mcp.call("send_wechat_image", { "to": "yibooo", # 联系人 wxid(不是昵称);先用 'filehelper' 测 "image_path": "/sdcard/Pictures/x.png" # 设备上图片路径(PNG/JPEG) }) # 返回 {"status": "sent", "method": "hook_broadcast", ...} ``` **工具内部自动完成**:stage 图片 → SEND_IMAGE_INTERNAL 广播 → 微信 b80.u.oj 插库建描述符 → v70.w.oj 提交 CDN 上传。**不要**自己走系统分享 / OCR / 固定坐标点发送——那是旧的 UI 模拟老路,已弃用。 ## 注意 - `to` 认 **wxid(username)不认昵称**。昵称→wxid 见 wechat-internal-send skill 的 EnMicroMsg.db 查法。 - 图片路径工具会自动 stage 到微信可读位置;root-only 源路径也 OK。 - 先用 `filehelper`(文件传输助手,自己)测试,确认无误再发真人。 - 真机验证 2026-07-07:filehelper + 火星人均全分辨率收到。详见 `WECHAT_SEND_API.md` §3。 ## Cron 发送失败后手动恢复 当 cron job(如日报图片定时发送)报 error 时,先做 Step 0 检测微信登录状态,再发图: ```bash # Step 0: 验证微信在线 pidof com.tencent.mm && su -c 'dumpsys activity activities | grep topResumedActivity | grep LauncherUI' || echo "微信不在线,先修复" # Step 1: 发送 cd ~/pixelphone/event_bus && python3 -c " import sys; sys.path.insert(0, '.') from wechat_hook_send import send_image_via_hook print(send_image_via_hook('yibooo', '/data/data/com.termux/files/home/daily_digest_1tgo.png')) " ``` 如果微信不在线,先走 `wechat-pad-login-repair` skill 诊断修复,不要跳过检测直接发。 常见 cron 失败原因见 `references/cron-send-preconditions.md`。