DeepSeek Harness (DSH) 生態目前已有性能監控（如 OTel / Prometheus）類插件，但在安全審計與會話取證方面存在空白。auditrail 作爲一個 DSH Bundle 插件，旨在填補這一缺口，通過記錄完整的工具調用鏈路、標記高風險操作、提供隱私掩碼存儲以及會話回放功能，爲智能體運行環境提供安全基線保障。
核心能力¶
該插件通過訂閱 DSH 的 session/event 和 tools/* 流，對每一次工具調用進行全量記錄。
-
完整的審計鏈記錄
記錄每一個事件的關鍵信息：執行者（session/actor）、時間戳與序號、執行的命令（工具名與掩碼後的參數摘要）、涉及的文件、目標網絡地址、執行結果狀態以及耗時。它合併了tool_call、tool_result和tool_dispatch事件，形成一條完整的調用鏈。 -
敏感操作標記
內置規則引擎，檢測高風險操作模式，例如rm -rf、curl | sh、密鑰/敏感材料操作、破壞性 Git/DB 操作、數據外發請求以及提權行爲。系統會爲受影響的記錄附加嚴重程度和規則標籤。 -
SQLite (WAL) 持久化與隱私掩碼
使用 SQLite 的 WAL 模式進行持久化存儲，利用哈希鏈保證數據篡改可檢測。默認情況下，所有存儲內容均進行掩碼和截斷處理，不保存原始敏感數據。配置redact可調整掩碼策略。 -
查詢與導出
支持按時間窗口、會話、工具、最小嚴重程度、敏感規則標籤等維度篩選記錄。導出格式支持 JSON 報告、Markdown 報告以及符合dsh-audit-trail/compliance/1schema 的 JSONL 格式。 -
終端會話回放
將審計記錄渲染爲純文本的時間線，支持暫停、步進、跳轉和播放速度控制，無需瀏覽器即可在終端中復現會話執行過程。 -
模型工具鏈
向模型提供四個專用工具：audit_query（查詢審計數據）、audit_export（導出報告）、audit_playback（回放會話）和audit_policy（管理規則）。
安裝與啓用¶
安裝前請確保環境滿足依賴要求。
前置條件：
- Node.js >= 22.13
- @deepseek-ai/cordis >= 4
- @deepseek-ai/dsh-tools >= 0.0.1-rc.1
安裝步驟：
1、通過本地開發包安裝（推薦開發調試）：
dsh plugin --profile <name> add /path/to/dsh-plugin/auditrail
2、通過打包文件安裝（生產環境）：
# 假設已生成 tarball
dsh plugin --profile <name> add ./dsh-audit-trail-0.1.0.tgz
安裝後，插件會自動通過 cordis.patch.yml 層掛載到 DSH 進程中。
典型用法¶
1. 模型工具調用
在 DSH 會話中，模型可以直接調用以下工具進行審計操作：
- audit_query：檢索符合特定條件的審計記錄。
- audit_export：將查詢結果導出爲指定格式（JSON/Markdown）。
- audit_playback：執行會話回放。
- audit_policy：管理敏感操作規則的啓用與禁用。
2. 命令行工具
使用獨立的 auditrail CLI 連接同一數據庫進行操作（無需啓動 DSH Harness）：
auditrail <command> [options]
注意事項¶
- 運行權限：插件以當前 DSH 進程的權限運行，需確保數據庫文件路徑可寫。
- 數據安全：默認不保存原始敏感數據，需根據安全需求調整
redact配置。 - 許可證：本項目採用 MIT 許可證，使用前請檢查源碼。
總結¶
auditrail 爲 DSH 生態提供了從性能監控到安全審計的補全。通過 SQLite 哈希鏈存儲與隱私掩碼，它能在記錄詳盡的同時保護數據安全，適合需要對智能體操作進行合規審查與風險溯源的開發者。
