dsh-agent-guard
在终端中运行以下命令:
dsh plugin install a5557/dsh-agent-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install a5557/dsh-agent-guard 安装本插件(开源地址:https://github.com/a5557/dsh-agent-guard)。
插件介绍
DSH 智能体一旦没读一手证据、只凭目录数量或摘要就下结论,很容易把正常设计当成数据丢失,进而重写会话目录、注册表等应用私有存储——轻则崩溃,重则难以恢复。dsh-agent-guard 正是为这类真实事故设计的护栏:让「先看清现场」成为最省事的路径,让「动 DSH 核心数据」成为最难走的一步。
插件当前覆盖证据采集与写入治理:guard_inspect 只读扫描工作区注册表、会话身份头与目录布局,区分用户会话与内部 subagent 记录,避免把「未注册」误读成丢对话;写入则在 tools/pre-execute 阶段拦截,默认在无法确认 DSH 已停止时拒绝写核心数据,允许时先备份再征求同意,备份失败或超预算一律拒绝,并对连续改写同一文件触发熔断、对生成引用受保护路径的脚本进行标记。
它还维护带哈希链的只追加日志与每轮回滚点,通过 guard_journal 暴露状态与人工回滚说明(不提供一键自动回写)。界面侧提供侧栏面板与「环境护栏」设置页,均为只读;独立 CLI 在 DSH 无法启动时也能只读检查 $DSH_HOME。全程零网络、零遥测、无运行时依赖。
适合在 DSH 上跑智能体、且担心误改 profiles、sessions、storages 等私有数据的开发者与运维:需要可验证的证据报告、写入前拦截与可审计记录,而不是第三方「一键修复」私有存储。
使用场景
- 智能体可能误改会话目录或工作区注册表前,需要写入前拦截与先备份再放行
- 怀疑「对话丢失」实为 subagent 未注册记录时,需要只读扫描身份头与来源分解
- DSH 无法启动但仍需检查 $DSH_HOME 现场与护栏日志状态时
适合人员
- 在 DSH 上运行智能体、担心误伤核心私有数据的开发者
- 需要可审计写入记录与人工回滚说明的运维或平台维护者
- 希望用证据报告而非一键脚本修复存储的管理员