dsh-plugin-guard：DeepSeek Harness 的插件安装安全网

dsh-plugin-guard 是 DeepSeek Harness（DSH）的插件安装安全网（DSH plugin），由 lxzy-7 维护，采用 MIT 协议，最近更新于 2026-08。它解决的是插件安装可能导致的启动失败问题：传统方式下，一个坏插件可能让应用无法启动，修复往往需要手动翻查配置文件。该插件自动化了整个安全链条：安装前自动快照、守护启动、自动回退、事故报告自动触发 Agent 分析。

dsh-plugin-guard 这个 DSH 插件如何检测问题？

检测机制分三层，且不静态审查插件代码。快照是纯文件复制，仅复制 5 个配置文件（package.json、pnpm-lock.yaml 等），不运行任何插件。启动级检测会真实运行 dsh web 进程（加载所有已装插件），并在超时内对 HTTP / 做健康检查；若启动失败，守护脚本自动终止进程树、回退到上次良好快照并重试一次。运行时问题（如特定操作崩溃）不在安装时检测，但事故发生后可通过 dsh_rollback action=incident 生成问题定位报告（含最近启动日志、stderr、配置差异），并设置待处理标记，让下次会话自动聚焦诊断。

dsh-plugin-guard 怎么安装？

从 GitHub 源码安装（当前推荐）：

dsh plugin --profile web add github:lxzy-7/dsh-plugin-guard

也可从仓库内 tarball 安装：

dsh plugin --profile web add https://raw.githubusercontent.com/lxzy-7/dsh-plugin-guard/main/dist/dsh-plugin-guard-0.3.0.tgz

安装后重启 dsh web。这是标准 bundle 插件，自动加入 profile 层栈。

dsh-plugin-guard 如何启用守护启动？

强烈建议通过 scripts/boot-guard.ps1（Windows）或 scripts/boot-guard.sh（macOS/Linux）启动，而不是直接运行 dsh web。Windows 启动器示例：

@echo off
set DSH_HOME=%~dp0.dsh-home
cd /d %~dp0
powershell -NoProfile -ExecutionPolicy Bypass -File node_modules\dsh-plugin-guard\scripts\boot-guard.ps1

dsh-plugin-guard 提供哪些额外工具？

包内附带 dsh-guard CLI（scripts/guard-cli.js），可覆盖手动终端安装场景。事故解决后，调用 incident_resolved 清除待处理标记。

dsh-plugin-guard 的核心理念是什么？

守护不评判插件“好坏”，而是保证：每次变更可回退、启动失败自动回退、事故被分析而非静默破坏。所有快照在变更前自动生成，事后也可手动回退。

查看更多 DSH 插件，访问 dsh-plugin.org