dsh-risk-guard: Zero-interruption Audit and Fuse Blocking for DeepSeek Harness

DeepSeek Harness (DSH) 提供了開發智能體的框架，但在實際使用中，Agent 執行破壞性操作（如強制推送、刪除關鍵文件）的風險難以量化且難以回溯。傳統的安全方案往往需要人工介入或權限變更，打斷工作流。dsh-risk-guard 是一個針對 DSH 的插件，旨在提供零打擾的審計能力與不可逆操作的熔斷保護。

它由 shuxue6662-a11y 維護，採用 MIT 許可證。核心價值在於將安全監控與業務執行解耦：先靜默記錄所有工具調用，再通過確定性評分模型識別高風險行爲，最後在執行前阻斷不可逆的操作。

核心能力¶

靜默審計¶

插件不會彈窗詢問權限，也不會修改沙箱環境。它會將每次工具調用（工具名稱、脫敏後的參數、執行結果、風險標籤、可解釋分數）記錄到本地的 JSONL 文件中。這爲事後復盤提供了完整的數據基礎。

確定性風險評分¶

評分過程不調用 LLM，不產生額外費用。它覆蓋了破壞性刪除、讀取憑證、網絡外聯、寫入工作區外部、依賴安裝和重型構建等場景。對於重複的高風險調用或連續的高風險操作，會累積額外分數。

保險熔斷¶

針對不可逆的災難性操作，插件會直接阻斷執行。受保護的操作包括：
* 刪除受保護路徑（如根目錄、憑證文件）；
* 磁盤擦除/格式化命令；
* 強制推送到受保護的分支（默認爲 main/master）；
* 引用憑證文件的網絡命令。

運作賬單¶

通過 /risk-guard 命令，你可以查看當前會話的操作歷史、分數分佈、標籤統計以及具體的熔斷記錄。這解決了“Agent 到底做了什麼”的溯源問題。

安裝與啓用¶

本插件需要先安裝 DeepSeek Harness。

1. 使用插件管理器（推薦）¶

在終端中執行：

dsh plugin --profile web add dsh-risk-guard

安裝完成後，重啓 Web UI，即可在任意會話中使用 /risk-guard 命令。

2. 通過 npm 安裝¶

如果使用 npm，執行：

npm install dsh-risk-guard

然後在配置文件的 cordis.patch.yml 中註冊插件：

- insert:
    - id: risk-guard
      name: 'dsh-risk-guard'

典型用法¶

插件提供了以下命令來查看審計記錄：

/risk-guard              # 查看當前會話的操作賬單
/risk-guard --turn       # 僅查看上一輪的操作
/risk-guard --all        # 查看所有會話的彙總及詳細賬單
/risk-guard --since=2026-08-01
                        # 查看指定日期後的記錄（可與其他參數混用）
/risk-guard --           # 輸出機器可讀的 JSON 格式

適用場景與注意¶

適用環境：DSH 0.1.0-rc.6，Web 模式或 Headless 模式。
數據存儲：所有審計數據存儲在 <DSH_HOME>/risk-guard/ 目錄下。敏感信息（如 GitHub Token、密鑰）在存儲前會被脫敏。
隱私與網絡：插件不發送任何遙測數據，也不發起網絡請求。
運行權限：插件以當前 DSH 進程的權限運行。如果需要更細粒度的權限控制，需在系統層面配置。

總結¶

dsh-risk-guard 是一套偏向系統底層的防護方案，它通過確定性規則替代了模糊的 LLM 判斷，保證了審計的客觀性。對於需要高安全性的 Agent 開發與調試流程，這是一個值得引入的工具。

插件目錄：dsh-risk-guard
GitHub 倉庫：shuxue6662-a11y/dsh-risk-guard