前言¶
在 DSH 環境中，多供應商、多模型的調用會產生分散的 token 用量、延遲、費用和額度信息。DSH 的插件化方式允許把這類監控掛入 web profile。dsh-spend 是面向 DeepSeek Harness 的 Token usage & cost monitor：在 web UI 中提供懸浮窗口、多維統計、時間序列圖表、自動識別的 Code/Token 計費計劃和預計花費。倉庫由 nonewind 維護，許可證爲 MIT。資料中未確認目錄頁 URL，也不宜把它當作官方應用商店入口。
這是什麼¶
dsh-spend 是一個 DSH web 插件，核心用途是把 $DSH_HOME/sessions 下的會話日誌回放爲用量與費用視圖。它主要回答三類問題：近期用了多少 token；不同 provider、model、目錄、會話分別對應多少費用；Code 計劃額度或 Token 計劃餘額處於什麼狀態。計費計劃會自動識別，顯式 plans/pricing 配置可以覆蓋自動識別。
核心功能¶
- 三級交互：懸浮膠囊常駐、hover 摘要預覽、點擊展開四標籤頁詳情面板。
- 多維統計：按提供商、模型、小時、天、會話、工作目錄、最近調用，含 TTFT、生成速度。
- 時間序列圖表：今日逐小時、24h/72h/7d 時間曲線、52 周活躍熱力圖。
- 計費計劃自動識別：內置 17 供應商 / 131 模型價格，自動區分 Code 與 Token。
- 即時額度 / 餘額直讀：9 家訂閱商適配器，失敗安全回退。
- DeepSeek 峯谷計價：按調用時刻自動按高峯/空閒價計費。
$ / ¥貨幣切換：即時匯率，失敗回退usdCnyRate默認 7.2。- 工作區篩選：按項目限定統計口徑，支持逐級下鑽子目錄。
- 數據導出：CSV / JSON / 調用明細 CSV。
- 自動刷新：默認 30s，面板內可手動刷新。
安裝與啓用¶
安裝到 web profile。以下命令來自已覈實資料：
dsh plugin --profile web add github:nonewind/dsh-spend
安裝後驗證組合配置中是否出現 usage-stats：
dsh --profile web --dump-config | grep usage-stats
插件需要重啓 dsh web 加載，HMR 對插件不生效：
dsh web
典型用法¶
先看懸浮膠囊。它在 web UI 中常駐顯示摘要信息；hover 可查看預覽；點擊進入四標籤頁詳情面板。面板內可使用工作區篩選，把統計限定到某個項目或子目錄；也可切換 $ / ¥ 顯示。
如果需要直讀 DeepSeek 或 Moonshot 的餘額/額度，可配置憑據縫或環境變量，例如：
DEEPSEEK_API_KEY
MOONSHOT_API_KEY
憑據以只讀方式複用本機登錄態與憑據縫；接口失敗時安全回退，不崩潰。OpenAI Codex、Claude Code、GitHub Copilot 需要本機登錄態或 token，未登錄時回退本地配額。
如需覆蓋默認配置，在 ~/.dsh/profiles/web/cordis.patch.yml 中加入同 id（usage-stats）的 insert 行。資料中的完整配置項未確認，具體配置以倉庫 README 爲準。
適用場景與注意¶
適合在 DSH web 環境中運行多個模型、多個項目，需要覈對 token 用量、費用、額度與延遲指標的開發者。插件會讀取 $DSH_HOME/sessions 下所有會話的持久化日誌；即時額度/餘額適配器涉及非公開/逆向接口（chatgpt.com、api.anthropic.com、api.github.com 等），隨時可能變化，失敗不崩潰。
插件以當前 dsh 進程權限運行。安裝前應檢查源碼、依賴與許可證；本資料確認的許可證爲 MIT。
結尾¶
dsh-spend 把 token 用量、多維統計、時間序列、預計費用和訂閱額度集中到 DSH web UI 中。GitHub 倉庫：https://github.com/nonewind/dsh-spend。目錄頁 URL 未在本次覈實資料中確認。
