宜博 / pixelphone

根因: 图片 stage 到 /sdcard 根目录的临时文件(未被 MediaStore 索引)时，微信图片
CDN 上传管线解析不到该文件 → 上传成破损图(红叹号，接收方收不到)。而已索引的
/sdcard/Pictures/ 里的图能正常全图上传。之前 Mac 直发用 /sdcard/Pictures/ 现成图
碰巧成功，掩盖了 staging 的 bug。

修复(send_image_via_hook + wechat_send.sh image):
- stage 到 /sdcard/Pictures/wx_send_<pid>.<ext>(媒体目录 + 唯一名避免并发覆盖)
- 广播 MEDIA_SCANNER_SCAN_FILE 触发 MediaStore 索引 + sleep 1 让扫描落地
- 再发 SEND_IMAGE_INTERNAL

真机验证: 修复前 staged 路径确定性红叹号(Hermes 17:37 + MCP repro 17:43 均失败)；
修复后经 MCP helper(Hermes 同路径)发送全图正常渲染(17:46 AI AGI 日报全分辨率)。
"CDN submit DONE" 日志只代表提交，不代表上传成功——不能作为送达判据。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

新 skill voice-synth-send：一段文本合成为语音，作为微信语音消息发给联系人。
全程在 Pixel Termux 内跑（Hermes 环境），无需 Mac、无需本地 TTS 模型。

- voice_synth.sh: text → edge-tts(默认,免费云) / 豆包 seed-audio(可选,需额度) → MP3
  → ffmpeg 16k mono PCM → silk-wasm SILK V3 → stage 进微信数据目录 → SEND_VOICE_CGI。
  引擎 edge|doubao；音色可选；豆包 key 走 DOUBAO_KEY 环境变量（不入库）。
- 澄清 edge-tts 是云 TTS（非本地模型，无需 key/GPU，联网即用）；本机 Termux 已具备
  python/edge-tts/node/silk-wasm/ffmpeg。
- SKILL.md: 用法/引擎对比/真机验证/坑（TMPDIR、SILK 权限、adb-su 无 DNS 是测试
  artifact 非 skill bug）。

真机验证 2026-07-07：edge-tts(6.9s)+豆包 seed-audio(8.2s) 均发火星人成功，多分块上传
完整可播放，发送方本地已发送气泡。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

三种消息在使用层齐了（文字/图片/语音全走内部 API 全合成）:

- wechat_send.sh voice: 弃用旧 SEND_VOICE_INTERNAL(hot-swap 相关)，改走 SEND_VOICE_CGI
  全合成。SILK 须 WeChat 进程可读——动态取 WeChat uid(stat /data/user/0/com.tencent.mm)，
  stage 进 /data/data/com.tencent.mm/files/ + chown + restorecon（/sdcard EACCES、
  root cp 进沙盒需正确 owner+ctx）。
- wechat_hook_send.py: 新增 send_voice_cgi_via_hook（同上 staging + 广播 SEND_VOICE_CGI）。
- android_mcp.py: send_wechat_voice 改调 send_voice_cgi_via_hook，docstring 更新为全合成。
- skill_wechat_send/SKILL.md: 语音段改写为 SEND_VOICE_CGI 全合成用法。

真机验证：wechat_send.sh voice + MCP send_voice_cgi_via_hook 均 status=sent +
hook svrMsgId>0（uploadvoice cgi 服务器接受）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

sendVoiceViaCgi 之前只上传+投递给接收方，发送方本地无记录。补上:
- cgi 前把 SILK 写到 voice2/msg_<voiceId>.amr（进程内写，以 WeChat uid，避开
  外部 root cp 被 SELinux categories 挡）供本地回放。
- w11.r0 Object 构造器插入 f9 语音气泡（voicemsg XML + voiceId 经
  hookF9ImgPathInjector 注入）。
- convertTo hook 新增 sVoiceCgiInsert 标志：cgi 路已上传+投递，强制 status=4
  (已发送)，否则发送方气泡永远转圈「正在发送中」（hot-swap 路仍不强制，靠 H()）。

真机 filehelper 对比验证：16:17(修复前)绿气泡转圈无时长 → 16:22(修复后)干净
「3" 语音条」已发送。接收方(火星人/Mac)收到能播 + 发送方本地正常显示 = 端到端
双向闭环。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

真机肉眼确认：SEND_VOICE_CGI 纯合成语音在 filehelper 渲染成绿色语音条（多条
2"/4"/6"/3" 全无红叹号=投递成功）。文档 §2 改写为全合成实现（分块 cv6 →
modelbase.o 构造 → i.l()+pq5.g.l() 订阅派发），hot-swap 降级为旧路。TL;DR
新增 SEND_VOICE_CGI 行。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

修好派发：裸 z2.b(g) 不 wire 回调 → 场景永不完成、dv6 空。正确派发 =
modelbase.i.l()（注册响应消费者 d + 返回 pq5.g deferred）+ pq5.g.l(timeoutMs)
终端订阅触发 cgi。加 sVoiceCgiKeepAlive 强引用防 deferred 弱持有的 i 被 GC。

真机 filehelper 验证（纯合成，无录音/无 hot-swap）:
  RESP try=1 svrMsgId(11)=6727180359918674774
  VOICECGI-RESULT errType=0 errCode=0 errMsg=null respClass=r45.dv6
= 服务器接受请求(errCode=0) + 分配 msgId(>0) = 投递成功。

诊断 hook hookVoiceCgiResult(modelbase.i onSceneEnd 按签名定位) 确认 errCode。
广播 SEND_VOICE_CGI --es to --es src_path <SILK> --ei duration。SILK 须 WeChat
进程可读（用其自身 voice2 文件或 chown 到 WeChat uid；/sdcard 会 EACCES）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

按捕获的 wire 协议实现全合成语音（无录音、无 hot-swap）:
- 读 SILK → 按 6000 字节分块 → 每块建 r45.cv6 请求 pb（[0]self [1]talker
  [2]offset [3]len [4]"newSendVoice_"+voiceId [6]dur [7]cu5(SILK切片) [8]end
  [11]msgsource [12]=4）→ 经 modelbase.o 13参构造器(绕过 modelbase.l 字段名
  base≠tinker 不匹配) → modelbase.i.p(o)(按签名定位) → scene modelbase.g(m1)
  → z2.b(scene) 入队（同文字发送）。
- 广播 SEND_VOICE_CGI --es to --es src_path <SILK> --ei duration。

真机 filehelper 测试：反射全部解析成功，scene=com.tencent.mm.modelbase.g，
z2.b 提交 1 块无异常（silk=2593B dur=2000）。投递确认待（设备屏幕 doze +
需第二账号）；已知待补：[15] long 字段省略、本地 f9 气泡未插、cgi 响应
getLong(11) 未校。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

真机 hook 追踪确认本机语音走 jg0.x.w 内联 cgi 分支（非 CDN 引擎 addSendTask，
那是 send_use_cdn_upload=1 的机器才走）。内联路可 z2.b 全合成，复用文字同队列。

新增追踪 hook:
- hookCdnTrace: h2.d(addSendTask)/l1.keep_onUpload*/jg0.x.u — 证实 CDN 路本机不触发。
- hookVoiceCgiCapture: hook modelbase.l.a() 过滤 uploadvoice，按类型定位字段（base≠
  tinker 名，NoSuchFieldError 教训），dump 请求 pb r45.cv6 全字段。

捕获的 wire 协议（cgi /cgi-bin/micromsg-bin/uploadvoice, cmdid 127, req cv6/resp dv6）:
  [0]self [1]talker [2]netOffset [3]本块SILK长 [4]"newSendVoice_"+voiceId
  [6]时长ms [7]custom cu5(SILK字节) [8]endflag [11]msgsource [12]=4 [15]long
  分块=6000字节/片，末块 end=1 响应 dv6.getLong(11)>0=服务器msgId=投递。
  scene modelbase.g extends m1 → z2.b(scene) 同文字。modelbase.o 有公开构造器可绕
  过 modelbase.l 字段名不匹配。

下一步: sendVoiceViaCgi 实现分块 cgi + z2.b 全合成。详见 memory + WECHAT_SEND_API。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

图片 CDN 上传打通后，把发图能力接进使用层:

- skill_wechat_send/SKILL.md: 图片段 🟢→✅，给出 SEND_IMAGE_INTERNAL 广播 +
  wechat_send.sh 封装用法，标注真机验证（filehelper + 火星人全图收到）。
- wechat_send.sh image: 弃用旧的 share intent + 手动选联系人（UI 模拟），
  改走内部 API 广播 SEND_IMAGE_INTERNAL；先 stage 到 /sdcard 保证 WeChat
  进程可读，再 fire-and-forget 到 <wxid>。真机验证 oj()+CDN submit 均 DONE。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

攻克图片发送最后一公里（LSPosed，微信 8.0.74，真机验证全分辨率送达）：

根因: b80.u.oj(o70.k) 只做「插消息 f9 + 插 ImgInfo b0 + 建缩略图」并
返回 List<o70.l> CDN 上传描述符，自己不提交 CDN。旧代码拿到 res 就丢掉
list → 上传永不触发（缩略图渲染但全图转圈）。真实编排 pe5.f.a 才循环
list 逐图提交（b80.s 只是 prebuild service checkPreBuildImg，不含 oj）。

补上第二步（照搬 pe5.f.a）: oj() 后对每个 o70.l:
  cdnSvc = n0.c(xs.d1.class)  // v70.w MsgImgFeatureService
  g = new r70.g(l.e, compress, c01.z1.r()/*self wxid*/, talker, k70.i0{a=3})
  cdnSvc.oj(g, l)             // → 启动 CDN 上传协程 e80.c

真机: oj() DONE res=size=1 + CDN submit DONE items=1，无异常；filehelper
收到消息点开是全分辨率原图（有原图+保存按钮，不再转圈）。

坑: v70.w.oj 内部走 ViewModelProvider.get 须主线程调（广播 receiver 本就在
主线程）；jadx 字段名末位字母=真实 dex 字段；XposedHelpers stub 无
getLongField 用原生反射。逆向靠拉 Tinker dex + jadx --single-class。

产物: WECHAT_SEND_API.md §3 完整两步实现 + API 表；backups 源码快照。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

逆向微信 8.0.74 内部发送 API（LSPosed，无 UI 模拟）：

- 文字（中英文）: w11.r0(type=1) Object-ctor + z2.b NetSceneQueue，真机验证送达。
  中文走 text_b64 base64 通道避免 shell 损坏 UTF-8。避开 dk5.s5.Ni（实为发名片）。
- 图片: hook 真实发送抓 o70.h/o70.k/o70.i 原样重放，攻克消息构建——
  能建 type=3 图片消息、缩略图渲染、进 pt0.e0 管线；全图 CDN 上传是最后一公里。
- 语音: jg0.x.w hot-swap（真机验证投递）。
- wxid 解析: EnMicroMsg.db SQLCipher 解密（key=MD5(imei+uin)[:7]）查 rcontact。
- 坑: 真实代码在 Tinker 补丁 CL（hook 用 sTinkerCL）；force-stop 不 flush 加密 WAL。

产物: WECHAT_SEND_API.md（完整逆向文档）+ skill_wechat_send/SKILL.md
     + backups/（WeChatHook.java 快照 + 构建/发送脚本）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

**WeChatHook.java — 语音发送四个关键 fix**：
- 跳过 H()：DB INSERT 在 r0 构造器内已完成，H() 只触发 CDN 上传，
  服务端拒绝后会删消息；skip H 彻底解决消息消失问题
- status=4 双写：ContentValues + f9.r1(4) 内存字段同时写，
  防止 K(0) 回调再次 convertTo 时读到 status=1 覆盖回转圈
- sDatabaseF9 精准捕获：在 convertTo() hook 里捕获入库的 f9 对象
  放入 r0.i，修复旧逻辑取第三个 f9（内容为空）导致点击崩溃
- K(0) 而非 I(0)：onSceneEnd code=0 时调成功路径 K 而非失败路径 I，
  修复红色感叹号问题
- fromusername 兜底：sMyWxid 为 null 时回退硬编码 wxid

**tts_voice_send.sh（新）**：
一行命令 TTS 发语音：edge-tts → ffmpeg(16kHz PCM) → silk-wasm(SILK V3) → adb push → SEND_VOICE_INTERNAL

**wechat_send.sh（新）**：统一 text / image / voice 三种发送模式的 CLI

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Hermes 重编 APK 时连踩三坑导致平板登录失效：
1. 用 XposedBridgeApi.jar 而非 LSPosed legacy JAR 编译 → 所有 hook NoSuchMethodError
2. xposed_init 放在 APK 根目录而非 assets/ → daemon 验证失败每次重启自动删模块 DB 注册
3. 换了 keystore → INSTALL_FAILED_UPDATE_INCOMPATIBLE

修复：从 wechathook_v2_signed.apk（正确 legacy JAR 编译）提取 DEX 复用，重打包含正确
assets/xposed_init，debug.keystore 签名，fix_lspd_final.py 重建 DB 注册。
2026-07-04 重启后验证平板登录恢复正常，所有 tablet hook 日志无 NoSuchMethodError。

新增文件：
- wechathook_v2_signed.apk: 黄金基准 APK（legacy JAR 编译，DEX 可复用）
- do_not_break.md: 给 Hermes 的禁止事项清单
- hermes_task.md: 已在顶部加 DO NOT BREAK 警告 banner
- analyze_wechathook.py: DEX 字节码分析工具（Tinker patch）
- rebuild_wechathook.sh / update_wechathook_db.sh: Mac 侧重建脚本
- termux_build.sh: Hermes 的手机侧 build script（有编译 JAR bug，留作参考）
- wechat_send_internal/: Hermes 对 WeChat 内部发送 API 的研究产出（进行中）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Hook.java v3.1 (315 行):
- body 捕获：okio.Buffer 读取 POST/PUT body（截断 2000 字符）
- Proxy poller（后台线程，1s 轮询 /xhs_proxy/pending）：
    executeOkHttp() 在 XHS 进程内用 OkHttpClient 执行代理请求，
    自动经过 XHS 拦截器签名，结果 POST /xhs_proxy/result
- 手写 JSON 解析器（无外部依赖）
- 保留 /xhs_params 转发（每条 edith 请求实时上报）

event_server.py（Hermes 编写）:
- proxy_requests 表（pending→ok/error 状态机）
- POST /xhs_proxy — Hermes 下发代理请求
- GET  /xhs_proxy/pending — Hook 轮询取下一个任务
- POST /xhs_proxy/result — Hook 上报执行结果
- GET  /xhs_proxy/result/{id} — Hermes 轮询取结果
- DELETE /xhs_proxy/{id} — 清理完成的任务

架构：Hermes → event_server → Hook(XHS进程内OkHttp签名) → event_server → Hermes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- STATUS.md: file index updated to v3 (DEX=6328B, HTTP forwarding), add
  ~/.hermes/event_bus/event_server.py to index
- update_xhshook_db.sh: phase 3 — after checkpoint, verify scope table has
  row for current mid; auto-insert if missing (mid changes after every reinstall,
  missing scope → lspd skips injection silently)
- .gitignore: ignore *.idsig (apksigner side-car, not useful in git)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- event_server.py: POST /xhs_params receives forwarded XHS edith requests from
  xhshook v3 (Hook.java background thread), stores as type='xhs_request' in events DB;
  GET /xhs_params returns latest N captures for Hermes to query
- Pushed to device ~/.hermes/event_bus/event_server.py
- STATUS.md: reflect v3 state (mid=4, DEX=6328B, HTTP forwarding live), mark task C done,
  add Hermes startup instructions for event_server + xhs_params query

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Hook.java v3：在现有 logcat 日志基础上，后台线程 POST 每条
edith.xiaohongshu.com 请求（method/url/全量 headers）到
Hermes event_server（127.0.0.1:8765/xhs_params）。
Hermes server 未运行时静默失败，logcat 捕获不受影响。

rebuild_xhshook.sh：d8 步骤改用 find 通配所有 .class 文件，
避免新增匿名类时漏掉（之前写死 Hook$1.class）。

update_xhshook_db.sh：两阶段更新策略
- Phase 1：Python in-place UPDATE + commit（不做 checkpoint，
  lspd 持有写锁时 checkpoint 会 OperationalError）
- Phase 2：pull DB+WAL → Mac 本地 checkpoint → push 干净主文件
  → 删设备端 WAL/SHM，确保重启后 DB 正确

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- STATUS.md：更新至 2026-06-30 00:33 验证通过状态，新增捕获到的额外
  签名 header（x-mini-sig/mua/s1/gid、x-legacy-sid、shield），
  补充 curl HTTP 200 复现验证结果，记录 lspd crash 恢复流程
- update_xhshook_db.sh：改用 Termux Python 原地 UPDATE + wal_checkpoint
  代替 cp/adb push（后者改变 inode，lspd FileObserver 监听旧 inode 不刷缓存）
- STATUS.md "已知不行的路线" 新增 adb push DB 和手动重启 lspd 两条陷阱

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

修复 LSPosed（JingMatrix/Vector fork）在 Android 16 上 zygote64 崩溃问题，
并完成 xhshook Xposed 模块注入 XHS（com.xingin.xhs），实现 edith.xiaohongshu.com
xy-common-params header 的实时拦截。

A16 崩溃根因：NDK 26 compile-time sizeof(JNINativeInterface) 不包含 Android 16 ART
新增的函数指针，memcpy 截断导致垃圾指针 → zygote 崩溃。
修复：从 env->functions->reserved0 读运行期实际大小，heap-alloc 后 memcpy。

其他修复：
- service.sh 去掉 Android toybox 不支持的 --propagation slave flag
- daemon 入口类名 org.lsposed.lspd.Main → org.matrix.vector.daemon.VectorDaemon

xhshook 踩坑记录：
- APK 必须含 assets/xposed_init（而非根目录），VectorConfigCache 只认这个路径
- adb install 必须加 --no-incremental，Incremental Install marker 破坏 ZipFile 解析
- Xposed API 类不能打进 module DEX，LSPosed 会检查 XposedBridge classloader 一致性

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>