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:

  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.