DeepSeek Harness (DSH) 的插件化架構允許開發者靈活擴展智能體的能力。在處理敏感數據與合規審計時,手動檢查既繁瑣又容易遺漏。enterprise-compliance 插件通過自動化 SOC2/GDPR 檢查、敏感信息攔截與操作日誌審計,解決 DSH 生態中的合規痛點。
插件概述¶
這是 DeepSeek Harness 的企業級合規插件,由 xiaoliang2 維護,採用 MIT 許可證。它提供 SOC2/GDPR 自動化檢查、敏感信息脫敏及審計追溯能力,支持 Web 與 Desktop Profile 安裝。
核心功能¶
1. SOC2 / GDPR 自動化合規自檢¶
通過 compliance_report 模型工具讀取運行時事實,按 CC6.1 / CC6.2 / CC7.2 / CC6.6 與 GDPR Art.5 / Art.25 逐項判定 PASS / WARN / FAIL 並打分。支持 summary / json / markdown 三種格式導出,並記錄評分歷史趨勢。
2. 敏感信息攔截與脫敏¶
compliance_redact 模型工具集成 9 類正則規則(郵箱、手機號、身份證、銀行卡、API Key、JWT、Bearer、私鑰、IP)。已掛載到 session-telemetry/record 瀑布流,在遙測導出前自動脫敏,符合 GDPR 數據最小化原則。
3. 操作審計追溯¶
compliance_audit 模型工具監聽 tools/result,記錄每次工具調用的時間、工具名、成功/失敗、會話 ID、脫敏後的參數。審計數據持久化到 settings.yaml,重啓後不丟失證據,支持按工具/會話/時間過濾導出。
4. 敏感數據文件掃描¶
compliance_scan 模型工具掃描工作區文件或目錄中的明文敏感信息,返回逐文件命中統計與脫敏樣例。默認遵守 .gitignore,並跳過 .git / node_modules 目錄。默認限工作區,可通過 allowOutside 開關開啓外部掃描。
5. GDPR 數據主體權利¶
提供數據導出與擦除能力:
* compliance_data_export:依據 GDPR Art.20 導出採集的數據。
* compliance_data_erase:依據 GDPR Art.17 一鍵擦除審計/歷史/報警狀態(需確認)。
6. 閾值報警與策略管理¶
- 策略讀寫:
compliance_policy模型工具可讀取/修改報警閾值、審計持久化條數、檢查項開關、脫敏規則開關、告警 Webhook。 - 閾值報警:評分跌破
alertThreshold時發出enterprise-compliance/alert事件。 - 告警 Webhook:配置
alertWebhook後,評分跌破/恢復時 POST JSON 到指定 URL(5s 超時)。
安裝與啓用¶
使用 npm 安裝:
dsh plugin add @xiaobanli/dsh-enterprise-compliance
安裝後,本包會被加入 profile 的 dsh.profile.bundles,cordis.patch.yml 會在下次啓動時自動應用。插件支持 Web 與 Desktop Profile。
典型用法¶
生成合規報告¶
# 讀取運行時事實,輸出 JSON 格式報告
compliance_report --format json
敏感信息脫敏¶
# 對輸入文本進行脫敏,返回脫敏後的結果與命中統計
compliance_redact "請撥打 13800138000 或訪問 user@example.com"
查看審計日誌¶
# 導出審計日誌,支持按工具或會話過濾
compliance_audit --export csv
掃描敏感文件¶
# 掃描當前工作區,跳過二進制文件與超過 1MB 的文本文件
compliance_scan
擦除數據¶
# 確認後擦除本插件採集的審計/歷史/報警狀態
compliance_data_erase --confirm true
已知限制¶
- 審計持久化不含參數:
args僅在內存環中存在,落盤的是時間/工具/結果/會話/錯誤,重啓後參數不再可查。 - 持久化條數限制:默認持久化條數爲 100(可通過
policy.auditPersist調整),內存環上限爲 500。 - 文件掃描限制:
compliance_scan默認跳過二進制文件與超過 1MB 的文本文件。 - 數據擦除範圍:
compliance_data_erase僅擦除本插件自身採集的數據,不涉及 DSH 其他數據。 - 運行時依賴:部分檢查項結果取決於運行時服務是否掛載(如審批、憑證、持久化、遙測)。
- 頁面依賴:合規中心頁面依賴
settings服務存在;缺失時僅影響頁面展示,不影響模型工具。
生態與目錄¶
該插件已發佈到 npm,源碼託管在 GitHub。社區目錄收錄了該插件的詳細索引:https://www.skillhub.cn/plugins/xiaoliang2/enterprise-compliance。