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
判据(两步,别跳):
- 阳性 + 阴性读数同源冲突时,先怀疑视角而不是对象:root 拥有的进程一律
su -c ps -ef/su -c tr '\0' ' ' < /proc/<pid>/cmdline复读一次(§二 ②)。 - 复读仍空(且
/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)