DeepSeek Harness (DSH) 提供了強大的智能體編排能力，但在調試複雜流程、子代理調用和工具執行時，缺乏系統化的 trace 數據支持。Litefuse 插件旨在解決這個問題，它將 DSH 的運行時數據轉化爲符合規範的可觀測性追蹤。
這是什麼¶
該插件是 DeepSeek Harness 的一個官方插件，用於接入 Litefuse 的可觀測性與評估能力。它將每一次用戶交互轉化爲一個獨立的 trace，並嚴格遵循 Litefuse agent-trace spec v1.2 規範。
插件由 litefuse 維護，採用 MIT 許可證。
核心功能¶
該插件具備以下核心能力：
- Turn 級 Trace 映射：每個用戶輪次生成一個 trace，包含一個
agent根節點。根節點下包含每個模型調用的generation、每個工具執行的tool，以及委託給子代理的嵌套容器。 - 零依賴：沒有運行時依賴，不依賴 Langfuse SDK。數據直接通過 OTLP 發送到 Litefuse 端點。
- 子代理支持：支持子代理和委託場景，能夠準確記錄委託開銷（Delegation Overhead）。
- 代碼模式支持：支持代碼模式，直接追蹤
run_code程序中的工具調用，避免與普通工具調用混淆。 - OTLP 集成：支持通過 OTLP 協議將 trace 數據發送到 Litefuse。
安裝與啓用¶
安裝插件需要使用 npx 命令。
npx @deepseek-ai/dsh plugin --profile web add -w dsh-litefuse-plugin
安裝完成後，需要配置憑證。
- 在
~/.dsh/.env中設置 Litefuse 的公鑰和私鑰：
LITEFUSE_PUBLIC_KEY=pk-lf-…
LITEFUSE_SECRET_KEY=sk-lf-…
這些密鑰需要在 Litefuse 項目的設置中創建。
- 啓動 DeepSeek Harness：
npx @deepseek-ai/dsh web
典型用法¶
完成上述配置後，當你在 DSH 中發送一條消息時：
- 打開瀏覽器訪問 https://litefuse.cloud 並進入對應項目。
- 在 Tracing 頁面查看數據。
- Trace 會在該輪次的第一個 span 完成時出現，而不是在輪次結束時。
插件讀取配置時優先從環境變量讀取，也可以通過 ~/.dsh/profiles/<name>/cordis.patch.yml 進行覆蓋。
注意事項¶
- 憑據處理：配置中的憑據是引用，不是實際值。插件從 harness 的憑證存儲（
~/.dsh/.credentials.yaml）或進程環境變量中讀取值。任何配置項都不會將密鑰寫入文件，且只記錄公鑰的前 10 個字符。 - Trace 出現時機：Trace 僅在第一個 span 完成時可見。
- 權限：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼和許可證。
- 配置位置：默認配置讀取自環境變量；若需覆蓋，需編輯
~/.dsh/profiles/<name>/cordis.patch.yml。
生態背景¶
DeepSeek Harness 的理念是“一切皆插件”。社區目錄（如 SkillHub）提供了插件的索引，但與 DeepSeek 或幻方 AI 無官方從屬關係。
該插件通過直接訂閱 DSH 的 session/event 事件流，實現了對真實執行過程（而非事後重構）的精確記錄，包括真實的延遲、Token 使用量、上下文壓縮事件等。
