前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在企業落地過程中，往往最先遇到三個問題：誰能調用高危工具、出事如何追溯、成本花在哪裏。dsh-gov 是爲此設計的插件，提供了基於策略的工具門禁、結構化審計日誌以及按 Agent 的 Token 配額控制能力。
這是什麼¶
這是一個面向 DeepSeek Harness 的 Agent 治理套件，旨在提供策略門禁、結構化審計和成本管理。它由用戶 863683348 維護，狀態持久化在 $DSH_HOME/gov/ 目錄下。
核心功能¶
- 策略門禁：支持按工具名稱、Agent 或工作區設置規則，動作包括允許、拒絕或詢問。支持通配符和優先級。默認策略爲放行，平局時遵循 fail-closed 邏輯（拒絕 > 詢問 > 允許）。
- 結構化審計日誌：生成純追加的 JSONL 文件，記錄工具名、Agent、工作區、決策、理由和結果（不記錄工具參數）。
- Token 配額管理：基於宿主的
tokenMeter，按 Agent ID 累計 Token 用量。支持按天/周/月/總量設定配額，超限時會向模型上下文注入警告。 - 工具攔截與觀察：在工具執行前進行門禁檢查，並在工具調用後記錄結果。
安裝與啓用¶
通過官方插件目錄安裝：
dsh plugin --profile <profile> add dsh-gov
安裝後，插件會接管 DSH 的工具調用流程，並自動在 $DSH_HOME/gov/ 下創建策略、配額和審計數據。
典型用法¶
插件提供了一個 gov 工具，包含以下常用命令：
- 查看治理總覽：
gov status
- 添加策略（示例：對 PowerShell 開頭的工具要求審批）：
gov policy_add tool="pwsh*" policyAction=ask reason="shell commands require approval" priority=10
- 設置配額（示例：爲 Agent alice 設置每天 100,000 tokens 的限制）：
gov quota_set id=alice quotaLimit=100000 period=day
- 查詢審計日誌（示例：查詢最近的拒絕記錄）：
gov audit_query decision=deny limit=20
適用場景與注意¶
該插件適合需要嚴格權限控制、合規審計或成本管理的團隊。注意，插件以當前 DSH 進程的權限運行，調用工具和訪問文件系統，請務必在安裝前檢查源碼與許可證。
結尾¶
dsh-gov 提供了策略門禁、審計追蹤和配額管理的基礎能力，幫助企業更安全地使用 DeepSeek Harness。更多細節請參考社區目錄或GitHub 倉庫。
