前言¶

在使用 DeepSeek Harness (DSH) 处理 Windows 任务时，代理可能执行删除文件、读取凭证或修改系统状态等危险操作。若缺乏控制，这些操作可能导致数据丢失或安全风险。dsh-windows-workspace-guard 旨在为 Windows 工作区、不可变路径、Git 风险以及审批和审计流程提供防护。

这是什么¶

这是一个 DeepSeek Harness 插件，用于在 Windows 环境下控制智能体的文件操作。它独立开发和维护，不属于 DeepSeek 官方组件。插件通过限制危险操作、提供审批机制和审计日志，帮助开发者确保智能体在受控范围内运行。

核心功能¶

插件对 Windows 智能体的工具调用进行拦截和决策，主要包含以下能力：

• 决策结果：对每个操作返回 PASS（通过）、ASK（需人工审批）或 HARD BLOCK（硬性拦截）。
• 风险拦截：阻止删除原始文件、脱离工作区、破坏 Git 恢复路径、读取凭证以及更改系统状态。
• 工具支持：支持 pwsh、read、read_image、write、edit、glob、grep 和 str_replace_editor 等工具。
• 审计日志：日志文件上限为 32 MiB。提供审计摘要工具，用于统计决策总数和频繁的规则 ID。
• 预检能力：支持在不执行命令的情况下检查指令（dry-run），用于排查风险。

安装与启用¶

在终端中执行以下命令安装插件：

dsh plugin --profile web add github:julescules/dsh-windows-workspace-guard#v1.1.1

安装后，重启 DSH 以加载插件配置。

典型用法¶

插件提供了多个辅助工具，用于检查、审计和诊断。

1. 预检命令：在执行前检查命令风险。
   询问智能体：
   > Run windows_workspace_guard_doctor, then use windows_workspace_guard_check to inspect this command without executing it: Get-Content -LiteralPath $env:DSH_HOME.credentials.yaml

2. 查看审计摘要：统计决策情况。
   询问智能体：
   > Run windows_workspace_guard_audit_summary and show the most frequent rule IDs.

3. 诊断未覆盖工具：检查哪些工具未被插件覆盖。
   询问智能体：
   > Run windows_workspace_guard_doctor and explain uncovered tools.

适用场景与注意¶

• 社区插件：此插件为非官方社区插件，请根据需要自行评估。
• 保守边界：它是一个保守的工具边界控制，并非通用 DLP（数据防泄漏）系统，不会检查任意原生进程内存或非支持工具。
• 无网络请求：插件运行时不发送任何网络请求。
• 审计文件：除非配置了 auditPath，否则不会生成审计文件。
• 路径配置建议：配置 workspaceRoots 和 sensitivePaths 时，请保持路径为绝对路径且范围尽量窄小。

短结尾¶

通过上述配置，你可以为 Windows 代理构建一个具备工作区隔离、凭证保护和审计能力的防护层。更多细节可参考官方目录或 GitHub 仓库。