前言¶
在 DeepSeek Harness（DSH）里長時間跑對話或開發智能體時，你往往要同時關心兩件事：當前是不是峯價時段、賬戶裏還剩多少錢。官方控制台可以查餘額，但和日常在 Harness 裏的操作是分開的；峯谷規則（工作日 09:00–12:00、14:00–18:00 北京時間爲峯價等）也需要自己對照時間表。客戶端插件 dsh-billing-bar（維護者 Daaaaxianer，分類：客戶端）把以當前時刻爲中心的 12 小時峯谷條和賬戶餘額嵌在 Composer 輸入區域上方，懸停可查看階段說明與本機估算花費，不離開對話界面。
這是什麼¶
dsh-billing-bar 是 DSH 的 Web 客戶端插件（npm 包名 dsh-billing-bar，當前版本 0.1.3，許可證 MIT）。它在 conversation.input.dock 註冊一塊 UI，與 Composer 卡片對齊，並在上方展示：
- 峯谷計費條（前 6 小時 → 現在 → 後 6 小時，按真實峯谷邊界着色）
- 賬戶餘額芯片（未登錄時顯示
—）
花費統計來自本機會話日誌的本地折算，不是服務商賬單的替代品；下面會單獨說明數據來源與侷限。
社區目錄頁：SkillHub - dsh-billing-bar
源碼與說明：GitHub - Daaaaxianer/dsh-billing-bar
核心功能¶
12 小時峯谷條¶
條形窗口以「現在」爲中心，左右各 6 小時（主機側默認半寬由 WINDOW_SIDE_MS 控制，默認 6 小時）。着色依據 DeepSeek 公佈的峯谷規則在本地計算，而不是按整點切塊：
- 峯價（琥珀）：工作日北京時間 09:00–12:00、14:00–18:00
- 谷價（綠色）：其餘時段；週末及中國法定節假日全天按谷價
豎線標記當前時刻。懸停峯谷條可看到當前階段、距離切換還有多久、精確切換時刻和顏色圖例。峯谷條僅響應懸停，點擊無效果。
賬戶餘額與花費面板¶
餘額顯示在峯谷條旁邊。數據來自 Harness 的 deepseekAccount 服務（getBalance）；充值餘額鏈向官方充值頁，地址取自 getState().links，而非插件寫死 URL。
懸停餘額展開面板，可查看：
- 今日、近 7 日、近 30 日：總花費、調用次數
- 多日範圍下的按日柱狀圖
- 各模型花費明細
點擊固定：單擊餘額或面板內任意位置可釘住面板，鼠標移開不會自動關閉；再次單擊餘額、點擊面板外或按 Esc 關閉。
主題與實現邊界¶
界面顏色、邊框、標籤與陰影使用 Harness 的 --dsw-alias-* 令牌，隨 Settings → Appearance（淺色 / 深色）切換，無需插件單獨維護配色。
主機側在 loopback 的 webServer 上註冊只讀路由 GET /dsh-billing-bar/status?range=today|7d|30d，返回階段、12 小時分段、餘額及所選範圍的花費；客戶端只渲染自有 DOM，不向峯谷條添加點擊目標。插件聲明無遙測，除賬號服務外無額外外連，也不向插件內存以外寫入數據。
安裝與啓用¶
插件要求 DSH 0.2.x（package.json 中 engines.dsh：>=0.2.0-rc.1 <0.2.2 || >=0.2.2-rc.1 <0.3.0-0）。餘額展示需要已登錄 DeepSeek 賬號。
在終端執行下列命令之一（與 README 一致）：
# npm package
dsh plugin --profile web add dsh-billing-bar
# or straight from this repository
dsh plugin --profile web add github:Daaaaxianer/dsh-billing-bar
安裝後重啓 Harness 使客戶端插件加載。
DSH 生態奉行「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝任意插件前，建議在 GitHub 上瀏覽源碼與許可證，並理解插件與當前 DSH 進程同權限運行。
典型用法¶
安裝並重啓後，打開帶 Composer 的對話頁即可在輸入框上方看到峯谷條與餘額，無需額外配置項。
- 判斷是否適合開長對話：懸停峯谷條，確認當前是峯價還是谷價，以及下一次切換時刻。
- 快速看餘額：直接看餘額芯片；需要明細時懸停或點擊固定面板，在今日 / 7 日 / 30 日之間切換。
- 覈對本機花費趨勢：在多日視圖下結合柱狀圖與各模型分項，評估近期 token 消耗（記住下文「本地估算」限制）。
- 充值：在固定面板內使用 充值餘額 跳轉官方充值頁。
若需從外部或腳本讀取同源數據，可請求本機 loopback 上的 GET /dsh-billing-bar/status?range=today|7d|30d（由插件 index.js 提供）。
數據來源與適用注意¶
| 展示內容 | 來源 |
|---|---|
| 峯谷階段與 12 小時條 | 公佈的 DeepSeek 資費時段，本地計算 |
| 餘額、充值鏈接 | deepseekAccount（getBalance、getState().links） |
| 花費 | 本機會話日誌中 assistant/message 用量，按價目表折算 |
| 單價 | 官方人民幣價目：如 deepseek-flash、deepseek-v4-pro；谷價爲峯價一半 |
花費是本地估算：只統計本機會話的文本 token；Search / Fetch 等按次計費項不計入；非 DeepSeek 模型若無公開單價則顯示「未定價」，不猜測價格。以服務商賬單爲準。
維護者需在資費或節假日變化時更新插件內常量（README 說明）：index.js 頂部 HOLIDAYS（法定節假日，國務院通知發佈後補次年日期）、PRICE_CLASSES（[谷價, 峯價]，元/百萬 tokens）、必要時調整 WINDOW_SIDE_MS。
適合誰：常在 DSH Web 客戶端裏開發或調試、希望一眼看到峯谷與餘額、並願意用本機日誌做花費參考的開發者。
不適合當唯一依據的場景：需要與官方賬單逐筆對賬、或多機彙總會話時，應使用控制台或導出賬單。
結尾¶
dsh-billing-bar 把峯谷時間軸、賬戶餘額和按模型/按日的本機花費估算收到 Composer 上方，並與客戶端主題一致。安裝命令見上文；細節與截圖見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/Daaaaxianer/dsh-billing-bar
- GitHub：https://github.com/Daaaaxianer/dsh-billing-bar
