incoming-message-hook-design.md
1.58 KB
Incoming Message Detection — WeChatHook WCDB Extension
Goal
Detect incoming WeChat messages (@mentions and DMs) event-driven, without polling.
Design: WCDB Insert Hook (方案 1)
Hook com.tencent.wcdb.database.SQLiteDatabase.insertWithOnConflict for message table.
On each INSERT:
- Check
isSend=0(incoming, not sent by us) - Extract
talker,content,createTimefrom ContentValues - Dedup by
talker|createTime|contentHash(Set in memory) - Check for @mention: read current user's wxid from
com.tencent.mm.model.c.cN() → field_username, testcontent.contains("@wxid") - Also trigger for private messages:
!talker.endsWith("@chatroom") - Write trigger file:
/data/local/tmp/hermes_trigger/{talker}_{createTime}
Multi-User Support
send_text_via_hookuses the currently-logged-in WeChat account- Current user wxid from
c.cN().field_username - When switching accounts (小伙子 ↔ 火星人), @mention matching auto-switches
Hermes Cron Side
Every 2 minutes, check /data/local/tmp/hermes_trigger/:
- List trigger files → for each:
- Parse talker + createTime from filename
- Query wechat_db for last 10 messages from that talker
- Spawn hermes with context → generate reply
send_text_via_hook(talker, reply)→ send- Delete trigger file
Implementation Status
- [x] Design complete (2026-07-09)
- [ ] WeChatHook Java code change (need Mac Claude Code — aapt2 broken on-device)
- [ ] APK build + install
- [ ] Hermes cron job for trigger processing
Change Spec
See /sdcard/wechathook/incoming-hook/CHANGE.md for the exact code diff.