SKILL.md 3.6 KB

name: wechat-login-gate description: 微信操作前置闸口——发消息/发图/语音等任何写操作前必须先过此闸口。检测微信进程+LSposed Hook是否在线,未就绪则拒绝执行。所有微信发送类 skill 和 cron job 的强制性第一检查点。 version: 1.0

category: wechat

WeChat Login Gate

任何需要微信写操作(发消息、发图、发语音、自动回复)的任务,第一步必须调用此闸口。

检查逻辑

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 脚本

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 函数前

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。

闸口的作用是避免「白跑一趟」(微信没启动时还在那发广播),但不能阻止发送操作本身带来的副作用。