dsh-tmp-cleaner

Tmp Cleaner

启动时确保 /tmp 清理守护进程运行（含进程内看门狗与兜底清理），并提供设置页与 /tmp-clean/api 接口

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:yezitotempeace/dsh-tmp-cleaner#1ab8ba74aa9e30fa4fe276d4ca0b8ab0a6c853e0

兼容性与来源证明

Tmp Cleaner 以 dsh-tmp-cleaner 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/20

版本

0.2.2stable

2026/10/20

README

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）

web 启动（或 HMR 重载本插件）时调用 apply()：
- 若 watch.pid 对应的进程确实是 tmp-clean（核对 /proc/<pid>/cmdline，防 PID 复用误判）→ 不动；否则 detached 拉起 tmp-clean watch；
- 异常只写 stderr，不影响 web 启动。
进程内看门狗（每 2 分钟）：
- Android 的 phantom process killer 会时不时杀掉 detached 子进程。以前只有重启 web 才会重新拉起，表现就是设置页一直「守护进程：未运行」。现在掉线后 ≤2 分钟自动复活；
- 重拉本身有 5 分钟冷却，避免连环刷进程；
- 若守护进程持续缺席 ≥3 分钟，且按 interval_hours 已到期，则由 dsh 进程自己执行 tmp-clean run 兜底清理。
注册路由（经 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)。

README

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）

宿主半边（lib/index.js）

web 启动（或 HMR 重载本插件）时调用 apply()：
- 若 watch.pid 对应的进程确实是 tmp-clean（核对 /proc/<pid>/cmdline，防 PID 复用误判）→ 不动；否则 detached 拉起 tmp-clean watch；
- 异常只写 stderr，不影响 web 启动。
进程内看门狗（每 2 分钟）：
- Android 的 phantom process killer 会时不时杀掉 detached 子进程。以前只有重启 web 才会重新拉起，表现就是设置页一直「守护进程：未运行」。现在掉线后 ≤2 分钟自动复活；
- 重拉本身有 5 分钟冷却，避免连环刷进程；
- 若守护进程持续缺席 ≥3 分钟，且按 interval_hours 已到期，则由 dsh 进程自己执行 tmp-clean run 兜底清理。
注册路由（经 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)。