wechat_hook_send.py
22 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
"""
WeChat send via LSPosed internal hook (fast path — no UI disruption).
Text only. The hook (wechathook module in xhs_lsposed_a16_fix) registers a
RECEIVER_NOT_EXPORTED BroadcastReceiver inside the WeChat main process and uses
WeChat's own w11.s1 factory to dispatch the message, so it bypasses all of the
anti-automation that kills UI-based senders. Delivery is asynchronous after the
broadcast returns; the caller decides whether to DB-verify.
Requirements
------------
- wechathook LSPosed module installed, scope includes com.tencent.mm
- WeChat main process running (or this module starts it)
- Broadcast must come from root (RECEIVER_NOT_EXPORTED)
"""
from __future__ import annotations
import base64
import subprocess
import time
from typing import Any
from ui_control_tools import _run, _adb_prefix, _ON_DEVICE
SEND_ACTION = "com.hermes.wechat.SEND_MSG_INTERNAL"
SEND_IMAGE_ACTION = "com.hermes.wechat.SEND_IMAGE_INTERNAL"
SEND_VOICE_CGI_ACTION = "com.hermes.wechat.SEND_VOICE_CGI"
_WECHAT_PKG = "com.tencent.mm"
_WECHAT_MAIN = "com.tencent.mm/.ui.LauncherUI"
def _wechat_running() -> bool:
try:
r = _run("pidof " + _WECHAT_PKG, timeout=5)
return bool((r.stdout or "").strip())
except Exception:
return False
def _start_wechat(wait_secs: int = 12) -> bool:
_run("am start -n " + _WECHAT_MAIN, timeout=8)
deadline = time.time() + wait_secs
while time.time() < deadline:
if _wechat_running():
return True
time.sleep(1)
return False
def _root_sh(cmd: str, timeout: int = 10) -> subprocess.CompletedProcess:
"""Run *cmd* as root, both on-device (su -c) and off-device (adb shell su -c)."""
b64 = base64.b64encode(cmd.encode()).decode()
payload = f"echo {b64} | base64 -d | sh"
if _ON_DEVICE:
return subprocess.run(["su", "-c", payload],
capture_output=True, text=True, timeout=timeout)
adb = _adb_prefix()
return subprocess.run(adb + [f"su -c '{payload}'"],
capture_output=True, text=True, timeout=timeout + 5)
def send_text_via_hook(wxid: str, text: str) -> dict[str, Any]:
"""Send *text* to *wxid* via the wechathook internal broadcast.
Fast (< 1 s round-trip), no UI disruption, no ADBKeyboard dependency.
Status 'sent' means the broadcast was accepted by the system; delivery is
asynchronous. Use wechat_send._verify_sent() for DB confirmation if needed.
Args:
wxid: talker id as stored in WeChat's rcontact.username (e.g. 'filehelper',
'wxid_xxx'). Nicknames are NOT resolved here — caller must resolve first.
text: message text (arbitrary UTF-8, including CJK).
"""
if not wxid or not text:
return {"status": "error", "error": "wxid and text required"}
if not _wechat_running():
if not _start_wechat():
return {"status": "error", "error": "WeChat not running and failed to start"}
time.sleep(3) # allow App.onCreate + BroadcastReceiver registration
# Double-base64 the args to survive nested su quoting with arbitrary content.
b64_wxid = base64.b64encode(wxid.encode()).decode()
b64_text = base64.b64encode(text.encode()).decode()
cmd = (
f'TO=$(printf "%s" "{b64_wxid}" | base64 -d); '
f'TEXT=$(printf "%s" "{b64_text}" | base64 -d); '
f'am broadcast -a {SEND_ACTION} --es to "$TO" --es text "$TEXT"'
)
try:
r = _root_sh(cmd)
except subprocess.TimeoutExpired:
return {"status": "error", "error": "broadcast timed out"}
stdout = (r.stdout or "").strip()
stderr = (r.stderr or "").strip()
# am broadcast exits 0 and prints "Broadcast completed: result=0" on success.
if r.returncode == 0 and ("result=" in stdout or "Broadcast completed" in stdout):
return {
"status": "sent",
"to": wxid,
"method": "hook_broadcast",
"verified": False, # DB not checked; caller may call _verify_sent
"detail": stdout[:200],
}
return {
"status": "error",
"error": f"broadcast rc={r.returncode}: {stderr or stdout or '(no output)'}",
}
def send_image_via_intent(to_wxid: str, image_path: str) -> dict[str, Any]:
"""Send an image to *to_wxid* via WeChat's share intent + UI tap.
Copies the image to /sdcard/ (world-readable), fires an ACTION_SEND intent,
then navigates WeChat's 'select contact' sheet to pick the target and confirms.
This is a best-effort UI path — it works reliably for filehelper. For other
contacts the search step matches the first rcontact search result, which may
be wrong if multiple contacts share a name fragment.
Args:
to_wxid: must be 'filehelper' for safe testing, or a unique search query.
image_path: absolute path on the device to a PNG/JPEG image file.
"""
import os
# Validated approach from the Hermes wechat-image-sender skill (2026-06-23):
# am start -a android.intent.action.SEND -t image/png with STREAM extra →
# WeChat "选择联系人" UI → search → tap → 发送 at ~(0.67, 0.88).
# Coordinates verified on 1344×2992 screen (fixed: 899, 2627).
# ── 1. Copy image to /sdcard so WeChat can read it ──────────────────────
ext = os.path.splitext(image_path)[1].lower() or ".jpg"
share_path = f"/sdcard/wechat_share_tmp{ext}"
mime = "image/png" if ext == ".png" else "image/jpeg"
cp_result = _root_sh(f'cp "{image_path}" "{share_path}" && chmod 644 "{share_path}"')
if cp_result.returncode != 0:
return {"status": "error",
"error": f"failed to copy image to /sdcard: {cp_result.stderr or cp_result.stdout}"}
# ── 2. Fire the share intent ─────────────────────────────────────────────
_run(f"am start -a android.intent.action.SEND -t {mime} "
f"--eu android.intent.extra.STREAM 'file://{share_path}' "
f"-p {_WECHAT_PKG}", timeout=10)
time.sleep(2.5) # wait for WeChat to open the select-contact sheet
# ── 3. Search for the contact in the sheet (same approach as text send) ──
from ui_control_tools import _run as run
from wechat_send import _screen_size, _tap_frac, _foreground
w, h = _screen_size()
query = "文件传输助手" if to_wxid == "filehelper" else to_wxid
# The share sheet has a search box. Tap it, type the query.
search_frac = (0.5, 0.075) # top search bar in share contact picker
result_frac = (0.5, 0.22) # first result row
send_frac = (0.669, 0.878) # 发送 button; 899/1344, 2627/2992 on ref device
_tap_frac(search_frac, w, h)
time.sleep(0.8)
# Use ADBKeyboard to type the search query
b64q = base64.b64encode(query.encode()).decode()
_root_sh(f'am broadcast -a ADB_INPUT_B64 --es msg "{b64q}"')
time.sleep(1.5)
_tap_frac(result_frac, w, h)
time.sleep(1.0)
# ── 4. Tap "发送" / confirm ───────────────────────────────────────────────
_tap_frac(send_frac, w, h)
time.sleep(1.5)
# Cleanup temp file
_root_sh(f'rm -f "{share_path}"')
return {
"status": "sent",
"to": to_wxid,
"image": image_path,
"method": "share_intent",
"verified": False, # image sends don't leave a simple DB row to verify
}
def send_image_via_hook(wxid: str, image_path: str) -> dict[str, Any]:
"""Send an image to *wxid* via the wechathook internal API (no UI simulation).
Fires SEND_IMAGE_INTERNAL. The hook calls WeChat's own image plugin
b80.u.oj (insert message f9 + ImgInfo b0 + build CDN upload descriptors)
then submits each descriptor to the CDN service v70.w.oj — the full image
uploads via WeChat's own CDN (receiver sees full-resolution original, not a
stuck thumbnail). Fire-and-forget: delivery is async after the broadcast.
This is the fast path — no share sheet, no contact search, no wrong-contact
risk. Preferred over send_image_via_intent. Verified 2026-07-07 on WeChat
8.0.74 (filehelper + real contact, full-res delivery). NOTE: the image MUST be
staged into a MediaStore-indexed dir (/sdcard/Pictures/) + media-scanned — a fresh
file in /sdcard root uploads as a broken image (red !); this fn handles that.
Args:
wxid: talker id as stored in rcontact.username (e.g. 'filehelper',
'wxid_xxx', 'yibooo'). Nicknames are NOT resolved here.
image_path: absolute device path to a PNG/JPEG. Must be readable by the
WeChat process; this fn stages it into /sdcard first so
root-only source paths work too.
"""
import os
if not wxid or not image_path:
return {"status": "error", "error": "wxid and image_path required"}
if not _wechat_running():
if not _start_wechat():
return {"status": "error", "error": "WeChat not running and failed to start"}
time.sleep(3) # allow App.onCreate + BroadcastReceiver registration
# Stage into /sdcard/Pictures/ (a MediaStore-indexed media dir) and trigger a media
# scan. WeChat's image CDN upload resolves the file via MediaStore — a fresh file in
# /sdcard root (not indexed) uploads as a broken image (red !, receiver gets nothing).
# Unique per-pid name so a fixed path isn't overwritten mid-upload by a concurrent send.
ext = os.path.splitext(image_path)[1].lower() or ".jpg"
share_path = f"/sdcard/Pictures/wx_send_{os.getpid()}{ext}"
cp = _root_sh(f'cp "{image_path}" "{share_path}" && chmod 644 "{share_path}"')
if cp.returncode != 0:
return {"status": "error",
"error": f"failed to stage image to /sdcard/Pictures: {cp.stderr or cp.stdout}"}
# Register with MediaStore so WeChat's image pipeline can resolve it (required).
_root_sh(f'am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d "file://{share_path}"')
time.sleep(1.0) # let the scan land before WeChat reads it
b64_wxid = base64.b64encode(wxid.encode()).decode()
cmd = (
f'TO=$(printf "%s" "{b64_wxid}" | base64 -d); '
f'am broadcast -a {SEND_IMAGE_ACTION} --es to "$TO" --es path "{share_path}"'
)
try:
r = _root_sh(cmd)
except subprocess.TimeoutExpired:
return {"status": "error", "error": "broadcast timed out"}
stdout = (r.stdout or "").strip()
stderr = (r.stderr or "").strip()
if r.returncode == 0 and ("result=" in stdout or "Broadcast completed" in stdout):
return {
"status": "sent",
"to": wxid,
"image": image_path,
"method": "hook_broadcast",
"verified": False, # CDN upload is async; confirm via UI screenshot
"detail": stdout[:200],
}
return {
"status": "error",
"error": f"broadcast rc={r.returncode}: {stderr or stdout or '(no output)'}",
}
def send_voice_cgi_via_hook(wxid: str, silk_path: str, duration_ms: int = 3000) -> dict[str, Any]:
"""Send a FULLY-SYNTHETIC voice to *wxid* via the internal uploadvoice cgi.
No recording, no hot-swap. The hook chunks the SILK, builds WeChat's own
/cgi-bin/micromsg-bin/uploadvoice request (audio inline), dispatches it via the
NetSceneQueue (modelbase.i.l() + subscribe), and inserts a local f9 bubble marked
sent. Result: the recipient gets a playable voice AND the sender sees a sent bubble.
Verified end-to-end on WeChat 8.0.74 (recipient + Mac both received; both sides visible).
The hook reads *silk_path* AS the WeChat process, so the SILK is first staged into
WeChat's own data dir (its uid + app_data_file SELinux context) — /sdcard gives
EACCES and a plain root cp into the sandbox needs chown + restorecon.
Args:
wxid: talker id as in rcontact.username (e.g. 'filehelper', 'wxid_xxx', 'yibooo').
Test with 'filehelper' first to avoid account risk.
silk_path: device path to a SILK V3 file (Tencent variant, \\x02#!SILK_V3),
e.g. from edge-tts → ffmpeg 16k mono → silk-wasm.
duration_ms: voice duration in milliseconds shown in WeChat UI.
"""
if not wxid or not silk_path:
return {"status": "error", "error": "wxid and silk_path required"}
if not _wechat_running():
if not _start_wechat():
return {"status": "error", "error": "WeChat not running and failed to start"}
time.sleep(3)
# Resolve WeChat's uid (changes across reinstalls) and stage the SILK into its data
# dir with the matching owner + SELinux context so the WeChat process can read it.
uid_res = _root_sh("stat -c %U /data/user/0/com.tencent.mm")
wx_uid = (uid_res.stdout or "").strip()
if not wx_uid:
return {"status": "error", "error": f"could not resolve WeChat uid: {uid_res.stderr or '(no output)'}"}
stage_path = "/data/data/com.tencent.mm/files/hook_voice_cgi.silk"
stage = _root_sh(
f'cp "{silk_path}" "{stage_path}" && '
f'chown {wx_uid}:{wx_uid} "{stage_path}" && '
f'chmod 600 "{stage_path}"; restorecon "{stage_path}" 2>/dev/null; true'
)
if stage.returncode != 0:
return {"status": "error", "error": f"failed to stage SILK: {stage.stderr or stage.stdout}"}
cmd = (
f"am broadcast -a {SEND_VOICE_CGI_ACTION} "
f"--es to {wxid} --es src_path {stage_path} --ei duration {duration_ms}"
)
try:
r = _root_sh(cmd)
except subprocess.TimeoutExpired:
return {"status": "error", "error": "voice cgi broadcast timed out"}
stdout = (r.stdout or "").strip()
stderr = (r.stderr or "").strip()
if r.returncode == 0 and ("result=" in stdout or "Broadcast completed" in stdout):
return {
"status": "sent",
"to": wxid,
"method": "uploadvoice_cgi",
"verified": False, # cgi is async; confirm via UI / recipient
"detail": stdout[:200],
}
return {"status": "error", "error": f"broadcast rc={r.returncode}: {stderr or stdout or '(no output)'}"}
def send_voice_via_hook(wxid: str, silk_path: str, duration_ms: int = 3000) -> dict[str, Any]:
"""Send a voice message to *wxid* via the wechathook internal API.
Uses WeChat's own w11.r0 factory (type=34) — no UI simulation.
The hook (hookF9ImgPathInjector) intercepts the f9 entity inside the r0
constructor to inject the voiceId before the DB insert, so the stored row
has the correct imgPath pointing to the SILK file.
Protocol:
1. Push SILK V3 file to WeChat's cache dir (root-writable).
2. Fire com.hermes.wechat.SEND_VOICE_INTERNAL broadcast (root-only,
RECEIVER_NOT_EXPORTED). The hook generates a random 26-char voiceId,
computes voice2/{md5(id)[0:2]}/{md5(id)[2:4]}/msg_{id}.amr path,
copies from cache, inserts the DB row, and calls H() for server sync.
Args:
wxid: talker id as in WeChat DB (e.g. 'filehelper', 'wxid_xxx').
IMPORTANT: test only with 'filehelper' to avoid account risk.
silk_path: absolute path on the device to a SILK V3 file
(Tencent variant: starts with \\x02#!SILK_V3).
duration_ms: voice duration in milliseconds (shown in WeChat UI).
"""
if not wxid or not silk_path:
return {"status": "error", "error": "wxid and silk_path required"}
if not _wechat_running():
if not _start_wechat():
return {"status": "error", "error": "WeChat not running and failed to start"}
time.sleep(3)
# Stage 1: push SILK to WeChat's cache (readable by WeChat process)
wechat_cache = "/data/data/com.tencent.mm/cache/hook_voice_src.amr"
stage = _root_sh(
f'cp "{silk_path}" "{wechat_cache}" && '
f'chmod 644 "{wechat_cache}" && '
f'chown u0_a330:u0_a330 "{wechat_cache}"'
)
if stage.returncode != 0:
return {
"status": "error",
"error": f"failed to stage SILK in WeChat cache: {stage.stderr or stage.stdout}",
}
# Stage 2: fire the voice broadcast
cmd = (
f"am broadcast -a com.hermes.wechat.SEND_VOICE_INTERNAL "
f"--es to {wxid} "
f"--es src_path {wechat_cache} "
f"--ei duration {duration_ms}"
)
try:
r = _root_sh(cmd)
except subprocess.TimeoutExpired:
return {"status": "error", "error": "voice broadcast timed out"}
stdout = (r.stdout or "").strip()
stderr = (r.stderr or "").strip()
if r.returncode == 0 and ("result=" in stdout or "Broadcast completed" in stdout):
return {
"status": "sent",
"to": wxid,
"method": "hook_broadcast_voice",
"duration_ms": duration_ms,
"verified": False,
"detail": stdout[:200],
}
return {
"status": "error",
"error": f"voice broadcast rc={r.returncode}: {stderr or stdout or '(no output)'}",
}
# ── TTS helpers ───────────────────────────────────────────────────────────────
def _tts_to_silk(text: str, voice: str, tmp_dir: str) -> tuple[str, int]:
"""Generate SILK V3 .amr from *text* using edge-tts + ffmpeg + silk-wasm.
Dependencies (must be installed on-device or on Mac):
pip install edge-tts
(Termux) pkg install ffmpeg nodejs && npm install -g silk-wasm
(Mac) brew install ffmpeg; openclaw installs silk-wasm automatically
Returns (silk_path, duration_ms).
Raises RuntimeError if any step fails.
"""
import asyncio, os, shutil
mp3 = os.path.join(tmp_dir, "tts.mp3")
pcm = os.path.join(tmp_dir, "tts.pcm")
silk = os.path.join(tmp_dir, "tts.amr")
# 1. edge-tts → MP3
try:
import edge_tts
except ImportError:
raise RuntimeError("edge-tts not installed: pip install edge-tts")
async def _synth():
await edge_tts.Communicate(text, voice).save(mp3)
asyncio.run(_synth())
# 2. ffmpeg → PCM16LE 16kHz mono
# shutil.which misses Termux bin when running under root su; probe extra paths
_FFMPEG_CANDIDATES = ["ffmpeg",
"/data/data/com.termux/files/usr/bin/ffmpeg",
"/usr/bin/ffmpeg", "/usr/local/bin/ffmpeg"]
ffmpeg_bin = next((p for p in _FFMPEG_CANDIDATES if shutil.which(p) or
(os.path.isfile(p) and os.access(p, os.X_OK))), None)
if not ffmpeg_bin:
raise RuntimeError("ffmpeg not found: (Termux) pkg install ffmpeg")
subprocess.run(
[ffmpeg_bin, "-y", "-i", mp3, "-ar", "16000", "-ac", "1", "-f", "s16le", pcm],
check=True, capture_output=True
)
# 3. Node.js silk-wasm → SILK V3 (already includes \x02#!SILK_V3 prefix)
_NODE_CANDIDATES = ["node",
"/data/data/com.termux/files/usr/bin/node",
"/usr/bin/node", "/usr/local/bin/node"]
node_bin = next((p for p in _NODE_CANDIDATES if shutil.which(p) or
(os.path.isfile(p) and os.access(p, os.X_OK))), None)
if not node_bin:
raise RuntimeError("node not found: (Termux) pkg install nodejs")
# Locate silk-wasm: check global npm, then openclaw bundle
node_script = f"""
var silkPaths = [
'/data/data/com.termux/files/usr/lib/node_modules/silk-wasm',
'/opt/homebrew/lib/node_modules/openclaw/node_modules/silk-wasm',
'silk-wasm',
];
var silk = null;
for (var p of silkPaths) {{
try {{ silk = require(p); break; }} catch(e) {{}}
}}
if (!silk) {{ process.stderr.write('silk-wasm not found'); process.exit(1); }}
var fs = require('fs');
silk.encode(fs.readFileSync('{pcm}'), 16000).then(function(r) {{
fs.writeFileSync('{silk}', r.data);
process.stdout.write(String(r.duration));
}}).catch(function(e) {{ process.stderr.write(String(e)); process.exit(1); }});
"""
r = subprocess.run([node_bin, "-e", node_script], capture_output=True, text=True, timeout=60)
if r.returncode != 0:
raise RuntimeError(f"silk-wasm encode failed: {r.stderr or r.stdout}. "
"Install: npm install -g silk-wasm")
duration_ms = int(r.stdout.strip()) if r.stdout.strip().isdigit() else 3000
return silk, duration_ms
def send_voice_tts_via_hook(
wxid: str,
text: str,
voice: str = "zh-CN-XiaoxiaoNeural",
) -> dict[str, Any]:
"""Generate TTS from *text* and send as WeChat voice message to *wxid*.
End-to-end: edge-tts → ffmpeg (16kHz PCM) → silk-wasm (SILK V3) →
wechathook SEND_VOICE_CGI (internal uploadvoice cgi): uploads the audio + delivers
to the recipient AND inserts a sent bubble on the sender side. Verified end-to-end.
Args:
wxid: talker id (e.g. 'filehelper'). IMPORTANT: test only with 'filehelper'.
text: Chinese text to synthesize (or any language supported by the voice).
voice: edge-tts voice name. Defaults to zh-CN-XiaoxiaoNeural (female).
Other options: zh-CN-YunxiNeural (male), zh-CN-YunyangNeural (news male).
"""
import tempfile
if not wxid or not text:
return {"status": "error", "error": "wxid and text required"}
if not _wechat_running():
if not _start_wechat():
return {"status": "error", "error": "WeChat not running and failed to start"}
time.sleep(3)
with tempfile.TemporaryDirectory(prefix="wc_tts_") as tmp:
try:
silk_path, duration_ms = _tts_to_silk(text, voice, tmp)
except RuntimeError as e:
return {"status": "error", "error": str(e)}
except Exception as e:
return {"status": "error", "error": f"TTS/SILK generation failed: {e}"}
# Delegate staging + broadcast to the fully-synthetic cgi sender (uploads audio
# inline via the internal uploadvoice cgi + delivers to the recipient + inserts a
# sent bubble). Must call while tmp dir is still alive.
result = send_voice_cgi_via_hook(wxid=wxid, silk_path=silk_path,
duration_ms=duration_ms)
result["tts_text"] = text[:100]
result["tts_voice"] = voice
return result