前言¶
在 DeepSeek Harness (DSH) 的開發流程中，錯誤往往在運行時被吞沒，或者難以追溯具體的用戶輸入與 AI 動作之間的關聯。排查問題通常需要人工介入日誌系統，效率較低。dsh-error-audit 插件解決了這個問題，它將報錯和警告的上下文信息實時歸檔，並賦予 AI 自身讀取和響應的能力。
這是什麼¶
dsh-error-audit 是一個 DeepSeek Harness 實時 AI 自審插件。它負責在報錯或警告發生的第一時間，連同時間戳、錯誤碼、會話 ID、用戶原話、AI 動作以及工作區信息寫入日誌目錄，並主動通知 AI。插件還內置了 read_error_logs 工具，方便 AI 隨時讀取錯誤日誌。
核心功能¶
- 實時記錄：監聽
agent/error、agent/request-error、tools/result等事件，錯誤發生時立即落盤並打印。 - 完整歸因：記錄數據不截斷，包含時間、錯誤碼、會話、工作區、用戶原話和 AI 動作。
- 主動通知：error 級別錯誤會向出錯會話注入提示（支持運行中注入和空閒喚醒）；warning 僅落盤。
- AI 可讀：內置
read_error_logs工具，支持列表、過濾和讀取單條報告。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add "github:166767/dsh-error-audit#main"
- 安裝後需重啓 dsh web 服務：
dsh web
- 驗證安裝是否生效：
dsh --profile web --dump-config | findstr error-audit
典型用法¶
插件安裝後默認開箱即用。日誌文件會寫入 $DSH_HOME/error-audit/ 目錄。AI 可以直接調用內置工具讀取：
read_error_logs
配置（可選）¶
如果需要修改默認行爲，可在對應配置文件中覆蓋配置項。路徑爲 $DSH_HOME/profiles/<name>/cordis.patch.yml。
| 配置項 | 默認值 | 說明 |
|---|---|---|
logDir |
$DSH_HOME/error-audit |
日誌目錄，也可使用環境變量 DSH_ERROR_AUDIT_DIR |
notify |
true |
error 級錯誤是否主動通知 AI |
notifyMode |
auto |
通知模式：auto / inject / followup |
windowSize |
50 |
每條錯誤攜帶的最近會話事件數 |
適用場景與注意¶
- 適用場景：需要實時監控智能體運行狀態、快速定位錯誤上下文的 DSH 開發者或管理員。
- 注意事項：插件以當前 DSH 進程的權限運行。安裝前請檢查源碼與許可證。
結尾¶
該插件通過將錯誤日誌結構化並賦予 AI 自讀能力，降低了排查故障的門檻。項目地址與目錄見下方。
