DSH Plugins
返回列表
🧩

dsh-gpu-guard

admin-security 更新于 2026.11.04

在终端中运行以下命令:

dsh plugin install lvyue1314/dsh-gpu-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中运行:dsh plugin install lvyue1314/dsh-gpu-guard,源码与说明见 https://github.com/lvyue1314/dsh-gpu-guard

插件介绍

在 Windows 上,按下停止后 subagent 往往只带走它直接拉起的 shell,下面的 bash、conda、python 等子树会变成孤儿却仍握着 CUDA 上下文,再叠上脚本自身的重试或循环,显存就会像「停不掉、过会儿又满」。dsh-gpu-guard 针对这类「链已断、树还在」的局面,对每个持有 GPU 计算上下文的进程沿祖先链向上追溯:父进程已不存在、或出现启动时间倒挂(PID 复用)则判为孤儿,并在遇到保护项、环、过长链等不确定情形时一律不动手。

核心能力是把「整棵孤儿树最上面的根」算清楚,并以整树结束的方式清理(而非只掐叶子),从而一并打断外层的重试循环或 supervisior,避免杀了 worker 又被父进程再起一轮。暴露给对话侧的工具包括:gpu_status(各卡显存/利用率/温度、持有者、祖先链与孤儿标注)、gpu_reap(默认 dry-run,确认后才真结束,可限定 pids)、gpu_guard(看门狗开关与间隔、宽限期、保护正则等配置)。

可选的看门狗在插件加载时即周期性扫描:autoReap 关闭时只把孤儿树打到日志与 stderr;开启时孤儿树需连续存活超过宽限期才会被处理,以减少短瞬孤儿被误伤。配置中 protect 正则默认覆盖 jupyter、nohup、code.exe、explorer 等常见常驻场景,命中则跳过。

适合在 Windows 上用 DeepSeek Harness 跑 GPU 训练或推理、且曾被「停了 agent 显存却不掉」困扰的人;它只处理持有 GPU 计算上下文的进程及其祖先语义,不负责不涉及 GPU 的孤儿或 DSH 有意保留的 background job——那类需依你的工作流另行判断。

使用场景

  • 停止 agent 后任务管理器里仍有 python 等子进程占用显存、需要看清持有者与其祖先链时。
  • 训练或推理脚本带重试/外层循环,停掉上层 shell 后下层仍在跑并周期性占满 GPU 时。
  • 希望周期性扫描、在宽限期后仅对确认的孤儿整树采取行动,并把状态记入日志或 stderr 时。

适合人员

  • 在 Windows 上用 DeepSeek Harness 跑 GPU 训练或推理、常被残留子树占显存困扰的使用者。
  • 需要 gpu_status 排障、用 gpu_reap 谨慎结束孤儿树(默认 dry-run)、或用 gpu_guard 管理看门狗的人。
  • 接受本工具只处理持有 GPU 计算上下文的进程,并理解 background job 与纯非 GPU 孤儿不在自动裁决范围内的人。