SKILL.md 11.2 KB

name: process-liveness-probe description: 判「某个进程 / 脚本守护到底在不在跑」的探针读法(Termux + su 双视角的 ps 字段语义 + /proc 直读判活)——本机已知坑:python 起的脚本进程在 ps -o cmd 下只显 python3(按脚本名 grep 结构性必失)、termux 侧看不见 root 进程、-o cmd 只给 comm、grep -c 把自己算进去。含汇报口径与「0 命中不算证据」纪律。触发词:进程在不在跑、守护不见了、实例数复核、ps 零命中、grep 没匹配到进程、watcher 不见了、cmd 列只显 python3、/proc cmdline 判活、看门狗还活着吗、单实例还是双实例、进程重启没、跑了多久、启动时刻、ps 的 STIME 列怎么读、/proc stat field22。 version: 1.0

category: android

进程判活探针(Termux + su 双视角)

适用:任何「X 还在跑吗 / 实例还是一个吗 / 守护是不是死了」的问题,对象是本机上的进程 (hermes gateway、hermes-gateway-watchdog.sh loop、wechat_reply_watcher.py、cloudflared、 微信 com.tencent.mm、任何 supervisor)。无人值守轮里这几乎是每轮都要做一次的读数。

核心一句:ps 的输出是 (视角 uid) × (字段选择符) 的函数 —— 两个维度任一不匹配, 都会静默变成 0 命中或截断字段,读起来像「对象不在」。阴性读数不能单独成结论。

本 skill 的落点说明(重要):这类判据在库里已有三处更细的归属 —— meta/probe-reading-verification(阴性读数复核)、cron/watchdog-evidence-verification(成功即静默型守护)、 android/process-instance-forensics(PID 变化 / 双实例 / 枚举零命中)。 但三者均 created_by=None(手工维护)⇒ skill_manage 一律 Refusing … not agent-created(零写入)。 本 skill 是可写落点:无人值守轮里新踩到的进程判活实测写这里;等上述 skill 被认领为 agent-created 后合并回去。 ⚠️ 「自称可写」不是判据:多个 skill 正文写着「新的实测写进本 skill」,实测照样被拒。

一、ps 字段语义(查表,别每轮重新踩)

读法 实际给什么 后果
su -c "ps -eo user,pid,etime,cmd" / ps -A -o … cmd 只给 comm / 解释器名:python3 …/xxx_watcher.py 打成 python3,hermes gateway run 打成 hermes 按脚本名 grep(watcher、*_pipeline.py)结构性必失 ⇒ 假报「进程不见了」
su -c "ps -ef" / ps -eo pid,ppid,user,args 完整 argv ✔ 首选读法
/proc/<pid>/cmdline(su -c "tr '\0' ' ' < /proc/<pid>/cmdline") 完整 argv(需先知道 pid) ✔ 最硬的正身证据;ls -l /proc/<pid>/cmdline 可读 = 活着
termux 侧 `ps -eo … \ grep/pidof ` 只列得出自己 uid 的行(uid/SELinux 隔离);对自己 uid 的行反而给完整 argv
`ps … \ grep -c ''` 把 grep 自身与外层 sh -c 计进去
`su -c "grep 'a\ b'"` root shell 对 BRE 反斜杠加倍 ⇒ 回空

二、判活标准姿势(三步,≈30 秒)

# ① 拿 pid(或由端口/日志拿)——视角用 su,字段用 args/-ef,别用 -o cmd
su -c "ps -ef | grep -Ei '<pat>' | grep -v grep"
su -c "ss -ltnp | grep <port>"                  # 端口持有者 = 正交旁证

# ② 直读正身(唯一能给完整 argv 又不依赖字段选择符的读法)
su -c "tr '\0' ' ' < /proc/<pid>/cmdline"; echo
ls -l /proc/<pid>/cmdline                        # 可读 = 活着;目录不存在才是真死

# ③ 正交旁证(与 ps 无关,至少一条)
curl -s -m5 http://127.0.0.1:<port>/health
su -c dumpsys battery >/dev/null; cat ~/.hermes/state/*.heartbeat 2>/dev/null; date +%s

判读:②或③为正 ⇒ 原阴性读数是假阴性,按真值写;三者全阴 ⇒ 写「读法 + 未复核存在性」, 不要写「进程没了」。跨轮对比 pid 前,先复核本轮 pid(单轮读数不升级成故障)。

支持文件:scripts/liveness_probe.sh —— 本节的只读可执行版 (bash liveness_probe.sh '<pattern>' [pid]):同刻打 [1] ps -ef / [2] -o cmd(反例对照)/ [2b] 自己 uid 全表 / [3] /proc/<pid>/cmdline 正身 + etime,末尾附判读纪律提醒 ⇒ 无人值守轮直接跑它,别每轮手搓三段探针。

三、2026-10-02 实测(原始读数,调度器 cd69c503fbb7 09:04 轮)

$ su -c "ps -A -o user,pid,ppid,etime,cmd" | grep -iE 'hermes|watchdog|watcher'
u0_a329       9206     1    18:38:18 hermes            # 真身:…/hermes gateway run(未重启,与 12:00–08:00 同 pid)
root         21544     1    17:59:44 hermes-gateway-    # 真身:sh …/hermes-gateway-watchdog.sh loop
# ⇒ grep -i watcher 命中 0 行 ⇒ 差点报「wechat_reply_watcher 不见了」

$ su -c "tr '\0' ' ' < /proc/5938/cmdline"
/data/data/com.termux/files/usr/bin/python3 /data/data/com.termux/files/home/pixelphone/wechat_reply/wechat_reply_watcher.py
# ⇒ 真身健在(etime 1-23:44:47),原读数是假阴性

$ ps -eo user,pid,ppid,etime,cmd | grep -i hermes     # termux 侧
u0_a329   9206 1 18:38:19 /data/data/com.termux/files/usr/bin/python3.14 /data/data/com.termux/files/usr/bin/hermes gateway run
# ⇒ 同 uid 的行有完整 argv;root 的行整行不见(与上表第三行一致)

落笔口径:写 `su -c "ps -A -o …cmd"` ⇒ 0 命中;`/proc/5938/cmdline` ⇒ 真身 , 不写「watcher 进程不存在」。同一轮里把这条记进账本时标为「方法学(新实测,本轮踩)」。

四、权限域静默空:/proc/<root-pid> 直读回「空」≠ 进程死了(2026-10-02 16:00 轮实测)

§一 表格补一行(本机最高频的假死相):

读法 实际给什么 后果
termux 侧 cat /proc/<root-pid>/stat(不加 su) 空输出 / 文件像不存在,不是 Permission denied root 的 /proc 对 u0_a329 不可见 ⇒ 活着的守护被读成「已死」
$ cat /proc/21544/stat | awk '{print "f22="$22}'      # termux 侧(无 su)
                      ↑ 空 ⇒ 看起来「守护 21544 已经没了」
$ su -c "ps -eo user,pid,ppid,etime,cmd" | grep 21544
root         21544     1  1-00:56:37 hermes-gateway-    # 真身:健在、ppid 1、独立于 gateway

判据(两步,别跳):

  1. 阳性 + 阴性读数同源冲突时,先怀疑视角而不是对象:root 拥有的进程一律 su -c ps -ef / su -c tr '\0' ' ' < /proc/<pid>/cmdline 复读一次(§二 ②)。
  2. 复读仍空(且 /proc/<pid> 目录整个不存在)才是真死;空读数单条不得写「进程已死」, 写「读法 + 未复核」或补 su 口径。

同族第二个坑(日志目录,形态更阴):ls /data/adb/lspd/log/verbose_*.log 在 termux 侧 列不出目录(root:root 0640 的目录 + 文件)⇒ 探针脚本里的 LOG=$(ls -t … | head -1) 拿到空字符串, 脚本于是打出 NO_VERBOSE_LOG。这个字样读起来像「本机没有 verbose 日志 / 无长链旁证」, 其实只是视角不对。正确姿势:cp 探针脚本到 ~/tmp/<name>_<HHMM>.sh 再 su -c "sh <绝对路径>" (anycgi_probe.sh 头部有同款说明,但直跑的错误形态极易被误读)。

⇒ 汇报口径:凡该轮只有「无 su 的空读数」一条证据,不得下「守护已死 / 无旁证 / 断线 / 日志缺失」的 结论——与 §二「0 命中不算证据」同一条纪律,只是这次的 0 来自权限域而非字段选择符。

📎 本轮原始读数 + 两个附属坑(探针哨兵字符串 NO_VERBOSE_LOG 属自报不属读数、 write_file 的 sibling 告警如何判「假并发」、以及 ~/.hermes/cron/jobs.json 的作业表快照片段): references/2026-10-02-1600-permission-domain-and-probe-sentinels.md。

五、判「重启没有 / 跑了多久」:只认 /proc/<pid>/stat field22 + /proc/stat btime(2026-10-02 17:00 轮实测)

ps 的时间列不是可靠判据 —— 同 uid 行才给 etime,且 ps -ef 里那一列根本不是 etime:

读法 实际给什么 后果
su -c "ps -ef" 第 5 列 STIME = 启动时刻(表头 UID PID PPID C STIME TTY TIME CMD;第 4 列 C = CPU%) 按 etime 读 ⇒ 把「启动时刻」当成「已运行时长」;同列换一轮就露馅(10-02 12:00 读作 21:35:59、13:00 读作 14:26:58)
ps -eo … etime(termux 侧) 只对自己 uid 的行有效 root 守护那行根本列不出来(§一)

判重启的唯一硬读法(两条一起看):

su -c "cut -d' ' -f22 /proc/<pid>/stat"     # starttime,单位 = clock ticks(Android HZ=100)
su -c "grep btime /proc/stat"               # 开机时刻(epoch 秒)
# start_epoch = btime + field22/100
# 与该 pid 上一轮记下的启动时刻比:同值 = pid 延续 = 未重启;now - start_epoch = 真实已运行时长

⚠️ 两条都要 su -c,否则回空(§四)⇒ 别把它读成「守护已死」。

2026-10-02 17:00 轮工作例(算法照抄即可):date +%s = 1790931729、btime = 1790697808 ⇒ 开机已 233921s ≈ 2.71d

  • gateway:cut -f22 /proc/9206/stat = 13821011 → 1790697808 + 138210 = 1790836018 ⇒ 启动 ≈ 10-01 14:27(≈26.6h) 与 12:00–16:00 各轮同值 ⇒ pid 延续、未重启
  • root 守护:cut -f22 /proc/21544/stat = 14052426 → 1790697808 + 140524 = 1790838332 ⇒ 启动 ≈ 10-01 15:05(≈25.9h)⇒ 未重启

落笔口径:写「/proc/9206/stat field22=13821011 + btime=1790697808 ⇒ 启动 ≈ 10-01 14:27 ⇒ 未重启」, 不要写「ps 显示已跑 1-02:35:04」——那是把 STIME 当 etime 的读数,跨轮不自洽(审计下一轮就对不上)。

同轮第二个噪声(凡 write_file 新落盘都可能命中,已第 N 次复现):write_file 报 _warning: … modified by sibling subagent '<uuid>' but this agent never read it,即使该文件是本轮第一次写、 ps 里只有一只 gateway。处置 = 写后立刻 read_file 回读;正文即本轮内容(本轮两次命中:轮报 168B/3 行、 账本条目 6686B)⇒ 判工具侧跟踪噪声(假并发),记噪声、不上报、不改流程; 只有回读发现兄弟内容被覆盖(_warning + 内容不是自己的)才算真并发。

六、相关 skill(均为 created_by=None,只读参考,别浪费调用去 patch)

  • meta/probe-reading-verification §二 盲区清单(阴性读数核验的元级纪律)
  • cron/watchdog-evidence-verification(成功即静默型守护:日志零新行 ≠ 没在跑)
  • android/process-instance-forensics(PID 变化 / 双实例 / 枚举零命中)
  • cron/cron-round-triage §0(轮次开场:核 root 守护/进程一律走 su -c ps)
  • meta/skill-learning-landing-fallbacks(写不进去时的落点纪律:试 1 个被拒即停、改走 create 新 umbrella)