前言¶
DeepSeek Harness (DSH) 是一個基於插件架構的客戶端工具。在使用 DeepSeek API 時，開發者常面臨兩個痛點：一是不知道當前會話燒了多少 token 和錢；二是高峯時段（官方雙倍價格）容易誤操作導致成本激增。dsh-token-rush 是一個掛在 DSH Web GUI 會話頁左上角的懸浮儀表，實時顯示當前會話的累計 token、按官方單價估算的金額以及賬戶餘額。高峯時段，窗口會自動變橙紅色，提示用戶當前處於計費加價期。
核心功能¶
該插件主要提供以下能力：
- 左上角懸浮窗：位於會話頁左上角，約 216px 寬，默認位置 (12, 56)，不遮擋主要信息。
- 實時統計：通過 DSH 的
tokenUsage投影實時推送，顯示累計總 token（包含輸入/輸出/緩存分桶）。 - 消耗金額估算：基於 DeepSeek 官方單價表（按模型、高峯/非高峯價）計算，界面標註“≈”。
- 賬戶餘額：代理 DeepSeek
GET /user/balance接口，數據緩存 60 秒。 - 高峯變色：高峯時段（默認北京時間週一至週五 09:00–12:00、14:00–18:00）窗口整體變橙紅色，其他時段跟隨 DSH 主題。
- 透明度漸變：未開啓對話時透明度爲 0%，開始對話後 0.8 秒平滑漸變爲半透明。
- 隨意拖動：按住窗口任意處拖動，位置自動記憶；雙擊可復位默認位置。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add link:E:\萬物暫存\AI緩存工作區\dsh-token-rush
安裝後，必須重啓 dsh web 進程（刷新頁面不生效），左側上方即會出現懸浮窗。
使用方法¶
- 查看狀態：重啓
dsh web後，窗口即顯示當前會話的 token 總量、估算金額與賬戶餘額。 - 移動窗口：按住窗口任意處拖動，位置會自動保存。
- 復位位置：雙擊窗口任意處，恢復到默認位置 (12, 56)。
- 高峯提示：在高峯時段，窗口背景色會變爲橙紅色。
配置說明¶
配置項讀取於 dsh web 啓動環境變量：
DSH_HUD_PEAK_WINDOWS：高峯時間段定義，如"9-12,14-18"或"8-10 20-23"（半開區間 [start, end)），默認爲9-12,14-18。DSH_HUD_PEAK_TZ：高峯判斷時區（IANA 名稱），默認爲Asia/Shanghai。DSH_HUD_PEAK_HOLIDAYS：法定節假日（全天按空閒時段計價），如"2027-01-01,2027-02-05..2027-02-11"。留空或無法解析時使用內置 2026 年清單。DEEPSEEK_BASE_URL：DeepSeek API 地址覆蓋，默認爲https://api.deepseek.com。
計價口徑與數據來源¶
- 總 Token：來自 DSH 會話
tokenUsage投影（uncachedInputTokens/cacheReadTokens/cacheWriteTokens/outputTokens）。 - 消耗金額（估算）：Token 數量乘以官方單價表。價格按模型匹配（如
deepseek-flash或deepseek-v4-pro），若模型未知則回退至 Flash 價。高峯價 = 空閒價 × 2。 - 賬戶餘額：通過 host 代理
GET /user/balance接口獲取。
DeepSeek 官方計價口徑（單位：元 / 百萬 tokens，2026-10 覈對）：
| 模型 | 輸入（緩存命中）空閒 | 輸入（緩存命中）高峯 | 輸入（緩存未命中）空閒 | 輸入（緩存未命中）高峯 | 輸出空閒 | 輸出高峯 |
|---|---|---|---|---|---|---|
deepseek-flash |
0.02 | 0.04 | 1 | 2 | 4 | 8 |
deepseek-v4-pro |
0.15 | 0.3 | 4.5 | 9 | 13.5 | 27 |
注意事項¶
- 消耗金額爲估算值：實際扣費以 DeepSeek 賬單爲準。若一次會話跨越高峯/非高峯時段邊界，跨界的部分按當前時段單價折算。
- 節假日限制：內置法定節假日清單僅覆蓋 2026 年。其他年份請通過
DSH_HUD_PEAK_HOLIDAYS手動配置，否則節假日的工作日會被算成高峯。 - 餘額查詢範圍：僅覆蓋 DeepSeek 官方 API（含自定義
baseURL端點）。使用其他 LLM 供應商時餘額行顯示“餘額不可用”。
結語¶
dsh-token-rush 通過視覺化的方式解決了 Token 消耗與計費焦慮，適合需要精細控制 API 成本的 DSH 用戶。安裝前請確認源碼與許可證。
