前言¶

在 DSH 的「一切皆插件」擴展方式下，web 客戶端可以通過插件增加面板、統計和用量分析能力。對使用 DeepSeek API 的 DSH 開發者來說，一個具體問題是：API 餘額在哪裏看，今天的 token 花費是多少，外部視覺模型調用有沒有被計入成本。

dsh-usage-dashboard-plus 針對這些問題，在 DSH web 側邊欄底部顯示 餘額 ¥xx · 今日 ¥xx，並提供完整用量面板。

這是什麼¶

dsh-usage-dashboard-plus 是 1HelloMan1 維護的 DSH web 插件，許可證爲 MIT。資料說明它是 dsh-usage-dashboard 的 fork，原倉庫也是 MIT。

它的主要定位是：

• 在側邊欄底部顯示 DeepSeek API 餘額與今日花費。
• 支持外部視覺模型調用統計與完整用量面板。
• 繼承 Stats 實現，提供調用日誌、按模型統計和 CSV 導出。
• 無構建步驟：通過 dsh.client 機制提供 host half (lib/index.js) 和 browser bundle (lib/client.js)。

核心功能¶

側邊欄底部 widget¶

widget 顯示：

餘額 ¥xx · 今日 ¥xx

點擊後打開詳情卡片。詳情卡片可查看調用量、token、按模型拆分和定價說明。

API 餘額¶

插件通過 DSH credentials service 解析 DeepSeek key，並查詢餘額端點。查詢帶緩存，balanceCacheMs 用於配置緩存時長。

今日花費（估算）¶

今日花費爲估算值。插件掃描會話日誌，以及可選的外部 usage log，按價格表估算 token 花費。

外部視覺模型調用統計¶

插件通過可選 JSONL usage log，將外部視覺模型調用計入今日花費。它內置 mimo-v2.5 定價條目，可用於成本估算，並支持通過 prices 覆蓋。

峯谷定價計劃¶

支持 date-gated 的 DeepSeek 費率表。資料提到 2026-08-17 起的峯谷價格表，相關配置項爲 priceSchedule。

完整用量面板¶

完整用量面板按 provider/model 顯示：

• 調用量
• 延遲
• TTFT
• 吞吐
• input/output/cache tokens
• cache rate
• 估算成本

調用日誌分析¶

調用日誌支持按 session、provider、model 過濾和搜索，查看近期調用，並導出過濾後的 CSV。調用日誌有 500 行上限。

繼承 Stats 實現¶

Plus 包含以下繼承的 Stats 實現：

• usageDashboard session projection
• 500 行調用日誌上限
• 整 session 模型聚合
• replay-safe 歷史統計

安裝與啓用¶

在 web profile 中安裝：

dsh plugin --profile web add dsh-usage-dashboard-plus

安裝後重啓 dsh web。這是因爲 profile patch layer 不會熱加載。

驗證配置：

dsh --profile web --dump-config

預期輸出中出現 usage-dashboard-plus row。

隨後硬刷新 GUI，例如 Cmd+Shift+R。底部 widget 會出現在 設置/Settings 旁。

從 dsh-stats-dashboard 遷移¶

舊 dsh-stats-dashboard 已合併到 Plus。遷移時：

1、在 web profile 中移除或禁用舊 dsh-stats-dashboard 插件。
2、安裝 dsh-usage-dashboard-plus。
3、重啓 dsh web，並硬刷新 Settings 頁。

不要在同一 profile 同時安裝/啓用兩個統計插件。

典型用法¶

配置 usage-dashboard namespace¶

配置放在 ~/.dsh/settings.yaml 的 usage-dashboard 命名空間。資料說明 usage-dashboard 配置項支持熱加載。

示例：

usage-dashboard:
  apiKeyRef: DEEPSEEK_API_KEY
  baseURL: ""
  prices:
    "mimo-v2.5": { input: 2, cacheRead: 0.05, output: 8 }
  priceSchedule: []
  balanceCacheMs: 60000
  sessionsRoot: ""
  scanWindowMs: 172800000
  externalUsageLog: ""

各配置項：

• apiKeyRef：餘額查詢使用的 DeepSeek key credential ref。
• baseURL：餘額查詢使用的 base URL。
• prices：按模型的價格條目；可覆蓋內置 mimo-v2.5 條目。
• priceSchedule：date-gated 峯谷價格表。
• balanceCacheMs：餘額查詢緩存時長。
• sessionsRoot：會話日誌目錄。
• scanWindowMs：會話日誌掃描窗口。
• externalUsageLog：外部模型調用 JSONL 日誌路徑。

配置外部 usage log¶

externalUsageLog 可配置爲 JSONL 日誌路徑。默認路徑爲 <dsh home>/vision-fallback/usage.jsonl。如果不需要外部 usage log，可設置爲 off 禁用。

一行 JSONL 示例：

{ "ts": 1755000000000, "model": "mimo-v2.5", "inputTokens": 1200, "outputTokens": 320, "cacheReadTokens": 0, "cacheWriteTokens": 0 }

適用場景與注意¶

適合在 DSH web 客戶端中查看 DeepSeek API 餘額、今日花費、外部視覺模型調用統計、完整用量面板和 CSV 導出的人使用。

需要注意：

• 今日花費爲估算值，基於會話日誌與外部 usage log 的價格表計算。
• 餘額查詢使用 DeepSeek key ref 和餘額端點，且存在緩存。
• 調用日誌有 500 行上限。
• 峯谷價格表是 date-gated，資料提到 2026-08-17 起。
• profile patch layer 安裝後不熱加載，需要重啓 dsh web；usage-dashboard 配置項支持熱加載。
• 舊 dsh-stats-dashboard 已合併到 Plus；不要在同一 profile 同時啓用兩個統計插件。
• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證；該插件爲 MIT 許可證，資料說明其 fork 的原倉庫也是 MIT。

鏈接¶

• GitHub：1HelloMan1/dsh-usage-dashboard-plus
• 社區目錄頁：dsh-usage-dashboard-plus

上面的目錄頁是社區插件目錄，不是官方應用商店；與 DeepSeek / 幻方無官方從屬關係。