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字段
两阶段检测
- 进程检测:
pidof com.tencent.mm返回 PID → 微信主进程活着 - 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。
闸口的作用是避免「白跑一趟」(微信没启动时还在那发广播),但不能阻止发送操作本身带来的副作用。