前言¶

DeepSeek Harness（DSH）是一個面向 AI Agent 開發的 CLI 工具，其核心設計理念是「一切皆插件」。在實際開發與調試過程中，開發者需要持續追蹤 Token 消耗、緩存命中率、實際費用以及接口延遲等關鍵指標，以便優化模型調用策略和控制成本。dsh-metrics-panel 是一個爲 DSH 生態設計的監控面板插件，它能在 Web 界面中提供實時統計功能，解決上述痛點。

功能特性¶

該插件主要提供以下能力：

• 實時統計：統計 Token 用量、緩存命中、費用與延遲。
• 可視化展示：提供概覽曲線、請求明細與錯誤清單。
• 多維聚合：支持按模型、供應商、工具進行用量與費用聚合。
• 計費配置：支持可配置的計費單價，用於計算實際費用。
• 界面定製：支持主題切換（淺色/深色/跟隨系統）與面板配色切換（5套），並支持全量刷新歷史數據。

安裝與啓用¶

安裝前請確保已安裝 DeepSeek Harness CLI (@deepseek-ai/dsh)。通過官方插件命令安裝：

dsh plugin --profile web add github:bulai-z/dsh-metrics-panel

安裝完成後，啓動 Web 界面即可使用：

dsh web

使用方法¶

打開頁面後，在側邊欄底部找到「監控面板」入口並點擊。

• 時間篩選：使用頂部的時間範圍選擇器（1h/24h/7d/30d/90d）查看不同時間維度的數據。
• 費用配置：在「費用」分區設置單價與貨幣單位，點擊保存後實時重算。
• 歷史數據：點擊「全量刷新歷史」可補齊未打開過的會話數據。

注意事項¶

• 數據持久化：面板數據基於運行期內存態，插件停止或進程重啓後數據會清空。
• 安全脫敏：HTTP 請求示例中的 Authorization 字段已脫敏爲 <redacted>。
• 聲明檢查：若安裝後提示 declares no dsh.bundle，說明 package.json 中的 dsh.bundle 聲明缺失，插件無法激活。

結語¶

dsh-metrics-panel 是一個實用的 DeepSeek Harness 輔助工具，適合需要在開發過程中實時監控模型調用成本與性能的開發者。更多細節可查看其GitHub 倉庫或社區目錄。