name: wechat-image-sender description: 通过 LSPosed 内部 API 发送微信图片(调微信自己的发图管线,无 UI 模拟,全图 CDN 上传) version: 2.0
category: communication
WeChat Image Sender(内部 API,全图 CDN)
发图给微信联系人,直接调微信自己的发送 API——不模拟点击、不走系统分享、不做 OCR 找联系人。 接收方收到全分辨率原图(可点开、可保存)。
调用前必须过闸口
任何发图操作前,必须先调 check_wechat_ready() 检查微信登录状态。 闸口不通过则拒绝执行,不要尝试启动微信。
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 检测
# 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。
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(直接调用)
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 检测微信登录状态,再发图:
# 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。