dsh-tmp-cleaner

中文 | English

DSH 插件：保证 /tmp 清理守护进程一直活着，并在「设置」里提供一个「临时清理」页。

• 启动时确保 tmp-clean watch 在跑；被 Android 杀掉后 ≤2 分钟自动复活（进程内看门狗）， 即使守护进程一直被系统杀，到期的清理由 dsh 进程自己兜底执行；
• 设置页可看状态、改配置、立即清理 / 演练，所有请求走 /tmp-clean/api/*；
• 清理工具本体是零依赖 Python 3 脚本，命令行与设置页共用同一份配置。

仓库内容

路径	说明
lib/index.js	宿主半边：看门狗、/tmp-clean/api/* 路由
lib/client.js	浏览器半边：settings.section 里的「临时清理」页
bin/tmp-clean	清理工具本体（Python 3，零第三方依赖）
cordis.patch.yml	插件行声明（dsh.bundle）
test/*.mjs	离线测试（假 ctx / 假 loader）

工具默认直接用随包自带的 bin/tmp-clean（通过 import.meta.url 定位，不依赖 /root 绝对路径）； 查找顺序：TMP_CLEAN_TOOL 环境变量 → 包内 bin/tmp-clean → 旧的 /root/dsh-bin/tmp-clean。 执行时用 python3（可用 TMP_CLEAN_PYTHON 覆盖），所以不需要脚本有可执行位。

宿主半边（lib/index.js）

1. web 启动（或 HMR 重载本插件）时调用 apply()：
   • 若 watch.pid 对应的进程确实是 tmp-clean（核对 /proc/<pid>/cmdline，防 PID 复用误判）→ 不动； 否则 detached 拉起 tmp-clean watch；
   • 异常只写 stderr，不影响 web 启动。
2. 进程内看门狗（每 2 分钟）：
   • Android 的 phantom process killer 会时不时杀掉 detached 子进程。以前只有重启 web 才会重新拉起， 表现就是设置页一直「守护进程：未运行」。现在掉线后 ≤2 分钟自动复活；
   • 重拉本身有 5 分钟冷却，避免连环刷进程；
   • 若守护进程持续缺席 ≥3 分钟，且按 interval_hours 已到期，则由 dsh 进程自己执行 tmp-clean run 兜底清理。
3. 注册路由（经 ctx.inject(['webServer'], …)）：
   • GET /tmp-clean/api/status → tmp-clean status --json --fast + 日志尾（默认不扫盘，页面秒开）
   • GET /tmp-clean/api/status?scan=1 → 完整扫描 /tmp 实际占用（7–20 秒，仅手动触发）
   • POST /tmp-clean/api/revive → 手动拉起守护进程（带冷却）
   • POST /tmp-clean/api/config → tmp-clean config set …
   • POST /tmp-clean/api/run → tmp-clean run [--dry-run]

浏览器半边（lib/client.js）

以 window.__ModuleLoader__.load({ id, factory }) 手写 bundle 形式发布， 注册到 settings.section 槽位（id tmp-cleaner，order 60，标签「临时清理」）：

• 状态默认走快路径；「扫描大小」按钮才触发完整扫盘；
• 读取失败时给出原因和「重试」按钮（web 刚重启后常见，不必刷新整页）；
• 守护进程未运行时显示「看门狗 2 分钟内自动拉起」，不再是无解释的「未运行」。

配置

/root/.tmp-clean/config.json（命令行与设置页共用）：

字段	默认	说明
enabled	true	是否启用自动清理
interval_hours	24	清理周期（小时）
max_size_gb	20	超过该占用就清
target_size_gb	10	清到该占用为止
min_age_hours	2	只删这么旧的目录
poll_minutes	15	守护进程轮询间隔
dry_run	false	演练模式（不真删）

测试

node test/host-test.mjs     # 假 ctx：4 条路由 + 快/慢状态 + revive + CLI 读写往返
node test/client-test.mjs   # 假 loader：materialize bundle + 注册/渲染断言
node test/probe-web.mjs     # 对运行中的 web 探测（需有效本地 cookie）

安装 / 卸载

• 安装：把仓库放进 /root/dsh-tmp-cleaner，在 profile 的 dependencies 加 "dsh-tmp-cleaner": "link:/root/dsh-tmp-cleaner"、dsh.profile.bundles 加 dsh-tmp-cleaner， 建 node_modules/dsh-tmp-cleaner 链接，重启一次 web。 工具已随包提供（bin/tmp-clean，Python 3，零第三方依赖），不需要另外复制到 /root/dsh-bin/。
• 卸载：反做上述步骤，并 kill $(cat /root/.tmp-clean/watch.pid)。