前言¶
DeepSeek Harness (DSH) 採用插件化架構，一切皆插件。在開發智能體或構建企業級應用時，需要在工具調用前增加安全與合規控制。dsh-approval-flow-poc 插件在官方的 tools/pre-execute 擴展點上實現了一個最小化的企業審批策略層。它負責對工具調用進行風險分類，根據預設策略決定是放行、攔截還是請求人工審批，並生成脫敏的審計日誌。
核心能力¶
該插件基於工具名稱和脫敏後的參數摘要，對工具調用進行風險評估，支持將風險分爲低、中、高、critical 四個等級。它實現了三種基礎策略：allow（放行）、deny（攔截）和 requireApproval（請求審批）。
在審計方面，插件僅記錄脫敏摘要、策略決定和最終錯誤狀態，不包含原始參數，以平衡安全性與隱私。當策略需要審批時，插件使用 DSH 原生審批通道，提供可注入的 ApprovalTransport 接口以及用於本地調試的 TTY transport。
安裝與啓用¶
通過 npm 包管理器安裝插件到 Web profile：
npx @deepseek-ai/dsh plugin --profile web add github:lasoloryan/dsh-approval-flow-poc
安裝完成後，執行配置檢查以確認插件已生效：
npx @deepseek-ai/dsh --profile web --dump-config
在輸出結果中，應能看到如下配置項：
- id: approval-flow-policy
name: dsh-approval-flow-poc
配置與策略¶
插件提供了三套預設策略，分別適用於不同的場景。切換預設時，需在 profile 的 cordis.patch.yml 中覆蓋完整配置。注意，DSH 的 patch 對同一行的 config 是整體替換，而非深度合併，因此覆蓋時必須寫全所有字段。
預設策略對照表：
| 預設 | low | medium | high | critical | 適用場景 |
|---|---|---|---|---|---|
developer |
委託/允許 | 委託/允許 | 人工審批 | 拒絕 | 本地開發 |
production |
委託/允許 | 人工審批 | 人工審批 | 拒絕 | 預生產或受控運行 |
strict |
委託/允許 | 人工審批 | 拒絕 | 拒絕 | 高敏感演示 |
配置示例：
- id: approval-flow-policy
config:
preset: production
auditPath: .dsh-approval-flow/audit.jsonl
approvalTimeoutMs: 45000
localPrompt: false
include: []
exclude: []
注意事項¶
這是一個非官方的社區實驗項目，與 DeepSeek AI 無隸屬或背書關係，不提供生產環境的安全承諾。
功能邊界：
* 不提供 SSO（單點登錄）、RBAC（基於角色的訪問控制）、多級會籤、遠程 Webhook 等高級功能。
* 不提供不可篡改日誌或合規認證。
* DSH 目前處於 developer preview 階段，升級 DSH 版本後，可能存在不兼容改動，需重新執行配置檢查和測試。
總結¶
該插件爲 DSH 開發者提供了一個落地的審批策略原型，適合需要快速實現基礎工具調用控制與審計的場景。更多細節可參考項目目錄頁或 GitHub 倉庫。
