前言¶
DeepSeek Harness 的核心理念是「一切皆插件」。現有的安全分類器通常關注輸出本身是否有害，這是一種模型層面的屬性。而 TapPass 插件關注的是一個不同的問題：在當前的規則下，這個智能體是否被允許執行這個動作？這是一個屬於組織的業務屬性，模型權重無法回答這個問題。
該插件在 Harness 的 tools/pre-execute 鉤子處攔截每一個工具調用，將其發送到 TapPass 的策略決策點，並根據返回結果允許、拒絕或升級爲人工審批。
插件定位¶
這是一個爲 DeepSeek Harness 設計的插件，旨在爲代理式 AI 提供業務規則層面的權威控制。它由 tappass 維護，採用 MIT 許可證。
它解決的核心問題是：如何在 Harness 中實施組織內部的業務邏輯（如退款額度、PII 數據出境限制、CRM 只讀策略），而不僅僅是依賴模型的安全分類器。
核心功能¶
- 攔截工具調用：在工具執行前的
tools/pre-execute階段介入。 - 基於業務規則：將策略編寫爲業務語言（如“超過 500 的退款需人工審批”），而非提示詞。
- 觀察與強制執行模式：默認以觀察模式運行，記錄所有調用而不阻斷；確認無誤後可切換至強制執行模式。
- 跨模型/框架通用：同一套規則可應用於 Harness、Claude Code、Codex 或 LiteLLM 後端。
- 審計日誌：記錄所有決策過程，支持 EU 託管，滿足 EU AI Act 要求。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness 並配置了默認 Profile。
- 安裝插件：
執行以下命令將插件添加到默認配置文件：
dsh plugin --profile default add @tappass/dsh-governance
- 配置環境變量：
設置 TapPass 開發者密鑰，該密鑰綁定到特定的 agent 和 org：
export TAPPASS_API_KEY="tp_dev_..."
- 驗證配置：
不啓動 Harness，直接檢查配置是否正確加載：
dsh --profile default --dump-config
典型用法¶
插件安裝後，需通過 YAML 補丁配置其運行模式。默認爲 observe（僅記錄），配置爲 enforce 後生效。
創建或編輯配置文件（例如 $DSH_HOME/profiles/default/cordis.patch.yml）：
- tappass-governance:
config:
mode: enforce
決策流程¶
插件會將 TapPass 返回的 outcome 映射爲 Harness 的決策：
TapPass outcome |
Harness 決策 | 效果 |
|---|---|---|
allow |
next() |
工具繼續執行 |
block |
{ kind: 'deny', reason } |
模型收到錯誤結果及原因 |
needs_approval |
{ kind: 'ask', reason } |
路由至 Harness 的人工審批流程 |
在 observe 模式下，所有調用默認返回 next()，但攔截到的 block 或 needs_approval 請求仍會在服務端記錄日誌，供你在切換到 enforce 模式前評估流量。
適用場景與注意¶
適用場景¶
- 需要對智能體工具調用進行細粒度權限控制（如只讀 CRM、禁止修改敏感配置）。
- 需要符合歐盟數據本地化及 AI Act 合規要求的組織。
- 希望先觀察再執行，逐步收緊策略的團隊。
注意事項¶
- 不支持參數重寫：DeepSeek Harness 在
tools/pre-execute階段將工具參數設爲只讀（用於日誌和展示），因此 TapPass 的modify意圖無法直接應用。該插件在強制模式下遇到此類請求會直接拒絕（Fail Closed），並返回原因。 - 批准需開放回合：
needs_approval意圖映射到 Harness 的ask決策，需要配置審批器。如果未配置審批器，該請求會安全地回退爲拒絕。 - 開發者預覽階段：DeepSeek Harness 及其插件 API 目前處於開發者預覽階段，可能存在變更。
- EU 託管：TapPass 服務託管於 EU，API 端點爲
https://app.tappass.ai/v1/govern。
結語¶
TapPass governance 提供了將組織業務規則落地到 AI Agent 執行層面的能力。通過觀察模式與強制模式的切換，它允許團隊在控制風險的同時，保留智能體的自主性。所有決策均記錄在案，確保了審計的透明度。
- 插件目錄：https://www.skillhub.cn/plugins/tappass/dsh-governance
- 源碼地址：https://github.com/tappass/dsh-governance
