@CetOeil/dsh-process-guard

DeepSeek Harness plugin that refuses shell commands killing processes by image name, wildcard, process group, or unfiltered enumeration — the cleanup that closes the DSH GUI window.

Plugin安全视觉终端桌面终端 / Shell视觉 / OCR

验证

L5 · 运行已测

通过

风险

低风险

健康

活跃

信任

金

安装验证：运行验证通过 (L5) · 验证于 dsh 0.2.1-rc.2 · 验证日期 10-20安装验证详情 →

功能介绍AI

防护插件，拦截按镜像名、通配符、进程组或全量枚举方式杀进程的 shell 命令。

拒绝按镜像名杀进程的命令
拦截通配符、进程组及无过滤的杀进程操作
防止误杀导致 DSH GUI 窗口关闭

securityAIterminalAI

能力标签为 AI 推断或 README 规则抽取（见角标），词表受限、未经安装验证；AI = 推断，README = 原文关键词。

安装

dsh plugin --profile web add dsh-process-guard

已验证 0.2.1

安装方式: npm · 运行验证通过 (L5)

验证与兼容性

按插件版本分组：每张卡是该插件版本实测过的 dsh 版本与安装兼容结论（L5 优先）。只列真测过的组合——未列出 = 未实测，不推定兼容。L1–L3 为插件级静态档（与 dsh 版本无关，各 dsh 行同值）：在行内「验证等级」格里与 L4/L5 并列显示、标注「静态」，证据体为插件级单份、随行内「查看检查项与证据」出现，不在各版本重复存储。

External credentials（插件级）：未检测到

原插件兼容声明来自 package.json · peerDependencies

作者未声明 dsh 版本要求

○ 作者未声明 dsh 版本要求 —— 安装不会因版本被拒。

安装兼容矩阵（速览 · 行 = 插件版本〔最近 5〕，列 = dsh 版本〔最近 5〕）

结论一览 → 证据在下方分版本卡片

插件版本＼ dsh	dsh 0.2.1-rc.2 当前	dsh 0.2.1-alpha.4	dsh 0.2.1-alpha.2
0.2.1	✓	✓	✗
v0.2.1	·	·	·

安装兼容实测（按插件版本，组内按 dsh 版本）

图例：✓ L5 运行验证通过○ 生态插件◼ 生态应用✗ 失败

0.2.1npm✓ 运行验证通过 2失败 12026-10-20

dsh-process-guard

✓dsh 0.2.1-rc.2当前2026-10-20L5 · 运行验证通过

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-rc.2
• 被测插件工件: npm · dsh-process-guard@0.2.1

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

通过

在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

L5 · 运行验证通过 · dsh 0.2.1-rc.2 有效

ID: dsh-process-guard@0.2.1@dsh0.2.1-rc.2 · 档位: l4-sandbox

签发：2026-10-20 · 有效至：2026-10-27

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.0s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.0s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.0s

L5 · 运行已测✓ 通过

已在加载器目录树中激活（150 个条目）

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-process-guard · 安装方式复用 L4 沙盒

检查耗时：23ms

Web 启动就绪L5.2_WEB_BOOT_READY✓ 通过

来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-20

就绪行 dsh web: http://127.0.0.1:62773/?token=…

HTTP 服务响应L5.3_HTTP_SERVED✓ 通过

来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-20

探测路径 / · HTTP 200 · 耗时 23ms

插件清单中已激活L5.4_PLUGIN_INVENTORY_ACTIVE✓ 通过

来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-20

清单判定 active · 清单条目 150

命中：include:process-guard · dsh-process-guard · 相位 active

相位计数：active 122 · null 28

L1–L3 为插件级静态结论（基础门槛，全 dsh 版本相同）：证据为插件级单份，不在各版本重复存储。

✓dsh 0.2.1-alpha.42026-10-18L5 · 运行验证通过

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-alpha.4
• 被测插件工件: npm · dsh-process-guard@0.2.1

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

通过

在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

L5 · 运行验证通过 · dsh 0.2.1-alpha.4 有效

ID: dsh-process-guard@0.2.1@dsh0.2.1-alpha.4 · 档位: l4-sandbox

签发：2026-10-18 · 有效至：2026-10-25

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.2s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.2s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.2s

L5 · 运行已测✓ 通过

已在加载器目录树中激活（150 个条目）

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-process-guard · 安装方式复用 L4 沙盒

检查耗时：148ms

Web 启动就绪L5.2_WEB_BOOT_READY✓ 通过

来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-18

就绪行 dsh web: http://127.0.0.1:51093/?token=…

HTTP 服务响应L5.3_HTTP_SERVED✓ 通过

来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-18

探测路径 / · HTTP 200 · 耗时 148ms

插件清单中已激活L5.4_PLUGIN_INVENTORY_ACTIVE✓ 通过

来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-18

清单判定 active · 清单条目 150

命中：include:process-guard · dsh-process-guard · 相位 active

相位计数：active 122 · null 28

L1–L3 为插件级静态结论（基础门槛，全 dsh 版本相同）：证据为插件级单份，不在各版本重复存储。

✗dsh 0.2.1-alpha.22026-10-15L5 · 失败

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-alpha.2
• 被测插件工件: npm · dsh-process-guard@0.2.1

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

未通过

在 dsh 沙盒中安装实测失败

L5 · 失败

ID: dsh-process-guard@0.2.1@dsh0.2.1-alpha.2 · 档位: l3-fullscan

签发：2026-10-15 · 有效至：2026-10-22

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：7.2s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：7.2s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-process-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：7.2s

L5 · 运行已测✕ 未通过

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-process-guard · 安装方式复用 L4 沙盒

检查耗时：0ms

Web 启动就绪L5.2_WEB_BOOT_READY✕ 未通过

boot failed

HTTP 服务响应L5.3_HTTP_SERVED✕ 未通过

L1–L3 为插件级静态结论（基础门槛，全 dsh 版本相同）：证据为插件级单份，不在各版本重复存储。

v0.2.1github2026-10-14

https://github.com/CetOeil/dsh-process-guard

该版本无运行时安装实测（仅静态扫描）——兼容性未知，不推定。

作者徽章

将官方徽章嵌入你的 README，展示插件的安全与安装检测状态：

安全报告

两层自动化检查，都不是人工审核：静态扫描（逐插件规则判定）与模型驱动的动态安全审计（只覆盖静态判定 warn 及以上的插件子集，不执行插件代码）。

dsh-process-guard自动审查 · 每日更新

静态扫描低，动态审计最高低，按「取更严者」→ 总评级低。

静态低→动态低→总评级低

0 严重·0 高

低总评级 · 低

1静态扫描 · vet 主判vet AST 静态分析（npm 发布物或 git 源码）

版本绑定

插件版本v0.2.1dsh 清单

扫描版本0.2.1npm2026-10-21

当前版本0.2.1版本一致

vet 判定clean · npm

vet 为 AST 静态扫描（npm 发布物或 git 源码）。

静态发现（2 条）

严重shellExec · shelllib/matcher.js:374
if (/^find(?:\.exe)?\b/i.test(tail) && /-exec(?:dir)?$/i.test(tail)) return true;
警告netIp · networklib/matcher.js:884
return `process-guard: blocked - this terminates ${images} after selecting it by image name. That image may host the DSH GUI (http://127.0.0

2动态审计模型读脱敏源码上下文 · 不执行插件代码

最高等级低

并入后总评级低

审计时间2026-10-17

发现计数0 严重·0 高另有 0 条中 / 1 条低未展开

展开 1 条审计发现

low守卫的解释器/包装器枚举不完整，部分按名称杀进程的命令不会被拦截lib/matcher.js:76
间接执行只针对枚举列表（EXEC_WRAPPERS、INLINE_CODE_EXECUTABLES、INTERPRETER_EXECUTABLES）中列出的执行器/解释器进行搜索。使用未列出的解释器时，例如 `awk 'BEGIN{system("killall chrome")}'`，其载荷被 maskViews() 的单引号掩码隐藏，且不匹配任何执行器模式，evaluateCommand() 会返回 allow，受保护进程（浏览器 / node 宿主）仍可被杀掉。这是插件自身目标上的纵深防御缺口，并未给攻击者带来新能力：需要调用方刻意选择未列出的执行器，而且该守卫本就被文档定位为行为匹配器而非安全边界。

未发现可利用风险：该插件仅是文本层面的防御性守卫，没有网络、文件或代码执行路径；静态扫描命中的都是用于检测的攻击特征字符串。

口径：动态审计只会把风险往严重里判，不会把风险降下来（只升不降，不构成豁免）；模型判错时由人工复核撤回，撤回后回到静态判定。合并判定 = 两层中更严的那一个。

免责声明：静态扫描与动态安全审计都是自动化分析，不构成安全保证。安装前请自行审查。

活跃度

最近提交 2026-09-25 · 活跃度：活跃

• 仓库创建: 2026-09-21

• 星标: ★ 1 · 复刻: 0

• 健康度: 活跃 — 近 30 天有提交

来源

GitHub: github.com/CetOeil/dsh-process-guard

插件说明