前言¶

在使用 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 倉庫。