前言¶
DeepSeek Harness（DSH）採用插件化架構。在開發治理套件時，追蹤各插件的執行狀態對於排查問題至關重要。dsh-observability 旨在解決治理插件日誌分散、難以統一查看的問題。它爲 Claw suite 提供了一套共用的診斷日誌方案，並在 Web 設置頁面中集成了運行診斷功能，方便開發者快速定位執行流。
插件定位¶
該插件由 xingyingyuzhui 維護，屬於 admin-security 類別。它不直接運行智能體，而是作爲一套基礎設施，供其他插件調用以記錄操作終態。
核心功能¶
- 共用診斷日誌：治理套件內的插件通過統一的接口記錄日誌。
- 可視化診斷頁：在 Web 設置界面提供「運行診斷」頁面。
- 時間線查詢：支持按錯誤碼或
traceId查看事件的時間線視圖。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin --profile web add github:xingyingyuzhui/dsh-observability
安裝完成後重啓 dsh web。啓動後進入設置頁面，在「審計」附近即可找到「運行診斷」入口。
典型用法¶
- 寫入日誌：其他治理插件通過同級目錄的
../dsh-observability/observe.mjs寫入日誌。 - 構建客戶端：修改 Client 源碼後，需執行
npm run build生成客戶端文件。 - 查看日誌：診斷日誌默認落在
$DSH_HOME/agent-observe/diag.l。若寫入失敗，系統會將日誌回退到stderr。
適用場景與注意事項¶
- 記錄粒度：插件僅記錄操作終態（
succeeded/rejected/failed/degraded），不記錄內部函數調用的詳細過程。 - 隱私保護：日誌字段採用白名單機制，不記錄 prompt、memory/identity 正文、工具參數或 token 等敏感信息。
- 權限與審計：該插件以當前 DSH 進程權限運行。安全審計功能仍由
dsh-agent-gate獨立處理，日誌寫入agent-gate/audit.l，與診斷日誌分離。
總結¶
dsh-observability 爲 DeepSeek Harness 的治理套件提供了標準化的診斷入口。通過統一的日誌記錄和可視化的時間線查看，開發者可以更高效地追蹤和定位問題。該插件基於 MIT 許可證開源。
