DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在開發或使用 DSH Web GUI 進行智能體開發時，實時瞭解當天的 Token 消耗成本與緩存命中率（Cache Hit Rate）能顯著提升調試效率。dsh-cost-widget 插件提供了這一能力，將關鍵指標集成到 Web 界面中。
插件定位¶
這是一個 DSH Web GUI 客戶端插件，由 zhangshaobo608 維護。它解決的問題是：在不離開 Web 界面的情況下，查看 DeepSeek 開放平臺賬號當天 V4-Flash / V4-Pro 的每百萬 token 平均費用及緩存命中率。
核心功能¶
- 懸浮浮窗：提供可拖拽的懸浮浮窗，包含緊湊懸浮條與完整面板兩種形態。
- 成本計算：展示當天 V4-Flash / V4-Pro 每百萬 token 的平均費用（= 當天成本 ÷ 當天 token 數 × 100 萬）。
- 指標概覽：展示緩存命中率（含進度條）、今日消耗、請求數、今日總成本、總命中率、餘額。
- 時段標識：北京時間 9:00–12:00、14:00–18:00 爲峯時，其餘爲閒時。
- 自動刷新：每 5 分鐘自動刷新，支持手動刷新。
- 位置記憶：面板位置保存在
localStorage中。
安裝與啓用¶
前置條件：需要 DSH web profile（@deepseek-ai/dsh >= 0.1.0-rc.6）。
執行以下命令添加插件：
dsh plugin --profile web add "github:zhangshaobo608/dsh-cost-widget"
重啓 dsh web 後，瀏覽器硬刷新（Cmd+Shift+R），面板會掛載在 Web GUI 側欄底部動作區（sidebar.footer.action 插槽）。
配置憑證（一次性）¶
插件通過 harness 憑證管道讀取平臺會話 token。在 ~/.dsh/.credentials.yaml 中添加：
DEEPSEEK_PLATFORM_TOKEN: <userToken>
獲取 userToken 的方法：在 Chrome 登錄 platform.deepseek.com 後，F12 Console 執行以下命令，token 會自動複製到剪貼板：
copy(JSON.parse(localStorage.getItem('userToken')).value)
複製輸出的長串（以 eyJ 開頭）並粘貼到配置文件中。
數據來源與安全¶
- 數據來源：數據來自
platform.deepseek.com的內部 API（/api/v0/usage/by_api_key/{amount,cost}和/users/get_user_summary），與官方用量頁共用同一 JSON 接口，非爬網頁。 - 接口安全：插件只在本機註冊一個只讀迴環接口
GET /api/dsh-cost/today，非本機調用直接 403。 - 憑證限制：公開 API key（
api.deepseek.com）只有/user/balance，沒有用量統計，因此用量統計必須使用平臺會話 token。
典型用法¶
- 重啓
dsh web，瀏覽器硬刷新。 - 在右下角或側欄動作區找到默認形態的緊湊懸浮條（
DeepSeek ¥x · 命中率 · 峯/閒）。 - 點擊懸浮條展開完整面板，查看詳細數據。
- 按住標題欄可拖動面板到任意位置。
注意事項¶
- 插件只在本機運行，位置記憶在
localStorage中。 - 公開 API key 無用量統計，必須配置平臺會話 token 才能獲取數據。
- 安裝前建議檢查源碼與許可證。
總結¶
該插件爲 DSH 用戶提供了輕量級的成本與緩存監控方案。社區目錄與 GitHub 倉庫鏈接如下：
