--- name: wechat-login-gate description: 微信操作前置闸口——发消息/发图/语音等任何写操作前必须先过此闸口。检测微信进程+LSposed Hook是否在线,未就绪则拒绝执行。所有微信发送类 skill 和 cron job 的强制性第一检查点。 version: 1.0 category: wechat --- # WeChat Login Gate 任何需要微信写操作(发消息、发图、发语音、自动回复)的任务,**第一步必须调用此闸口**。 ## 检查逻辑 ```python from wechat_hook_send import check_wechat_ready gate = check_wechat_ready() if not gate["ready"]: # STOP HERE. 不要继续。报告失败原因。 print(f"WeChat not ready: {gate['reason']}") return ``` `check_wechat_ready()` 返回: - `ready: True` — 微信进程在线 + LSPosed hook 5分钟内活跃 → 可以安全发送 - `ready: False` — 原因见 `reason` 字段 ## 两阶段检测 1. **进程检测**:`pidof com.tencent.mm` 返回 PID → 微信主进程活着 2. **Hook 检测**(进程活着时):最新 LSPosed verbose log 中有 5 分钟内的 WeChatHook 注入记录 → hook 已注册 BroadcastReceiver 两个条件都满足才返回 `ready: True`。只有进程但 hook 没注入,广播发出去也没人收(RECEIVER_NOT_EXPORTED)。 ## 接入方式 ### Cron job 在 prompt 开头加入: ``` ## 闸口(第一步,不过则停) 运行: cd ~/pixelphone/event_bus && python3 -c "from wechat_hook_send import check_wechat_ready; import json; print(json.dumps(check_wechat_ready(), ensure_ascii=False))" 如果 ready=false → 报告原因并结束,不做任何发送操作。 ``` ### Python 脚本 ```python import sys; sys.path.insert(0, '/data/data/com.termux/files/home/pixelphone/event_bus') from wechat_hook_send import check_wechat_ready gate = check_wechat_ready() if not gate["ready"]: raise SystemExit(f"WeChat not ready: {gate['reason']}") ``` ### 人工调 send 函数前 ```bash cd ~/pixelphone/event_bus && python3 -c " from wechat_hook_send import check_wechat_ready r = check_wechat_ready() print(r) if r['ready']: print('OK to send') else: print('BLOCKED:', r['reason']) " ``` ## 常见失败原因 - `WeChat process not running` — 微信没启动或崩溃了。参考 wechat-pad-login-repair 诊断。 - `Hook last active Xs ago (>5min)` — 微信进程还活着但 hook 已掉线(被 plugin.zero 检测到?),消息发不出去。 - `WeChatHook not injected` — LSPosed 模块没注入,检查 LSPosed scope 和模块状态。 ## 需要加闸口的 Skill/Cron - wechat-image-sender - wechat-voice-sender - wechat-auto-reply(回复发送部分) - 1-TGO日报发送 (cron 9e4c5ab0889c) - 回复队列发送器 (cron 68a2e8dde137) → 这是 no_agent 脚本,在脚本里加检测 ## 不需要闸口的操作 - 读微信 DB(不需要登录态,纯本地 SQLite) - 微信消息抓取/摘要(被动读) - WeChat Viewer(读 DB 展示) ## 🚨 闸口通过 ≠ 发送一定成功 **即使闸口返回 `ready: True`(进程在线 + hook 已注入),消息发送仍可能失败并把用户踢下线。** 根因:`c01.c: NoResetUinStack`。微信的消息链路有会话栈校验(`c01.c`),hook 的 `sendViaAPI` 直接调消息工厂构造消息,跳过了正常的 UI → UIN 栈链路,触发 session 失效→踢回登录页。 这意味着:**在当前 wechathook 版本下,发送操作本身就会导致登录态丢失。** 详情见 `wechat-pad-login-repair` skill 的 `references/c01-noreset-uin-stack.md`。 闸口的作用是避免「白跑一趟」(微信没启动时还在那发广播),但不能阻止发送操作本身带来的副作用。