# 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: 1. Check `isSend=0` (incoming, not sent by us) 2. Extract `talker`, `content`, `createTime` from ContentValues 3. Dedup by `talker|createTime|contentHash` (Set in memory) 4. Check for @mention: read current user's wxid from `com.tencent.mm.model.c.cN() → field_username`, test `content.contains("@wxid")` 5. Also trigger for private messages: `!talker.endsWith("@chatroom")` 6. Write trigger file: `/data/local/tmp/hermes_trigger/{talker}_{createTime}` ## Multi-User Support - `send_text_via_hook` uses 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/`: 1. List trigger files → for each: 2. Parse talker + createTime from filename 3. Query wechat_db for last 10 messages from that talker 4. Spawn hermes with context → generate reply 5. `send_text_via_hook(talker, reply)` → send 6. 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.