前言¶

在 DSH 裏跑長對話時，餘額和當日消耗往往要切到賬戶頁或另開工具才能看清。浮動小部件能解決問題，但容易擋界面、佔點擊區域，還帶角色動畫和菜單。若你只需要「一眼看到數字、不干擾操作」，側欄底部一行純文本往往更合適。下面介紹社區插件 dsh-balance-plain（維護者 zeenhuang9-boop，分類：客戶端）：把 DeepSeek 餘額相關讀數嵌進 DSH 側欄 footer，無鯨魚、無按壓、無音效、無菜單，整層 pointer-events: none。

這是什麼¶

dsh-balance-plain 是 DSH 插件，當前版本 0.5.0（見倉庫 package.json），按 MIT 許可發佈。

一句話定位：在 DSH 側欄最下方（工作區列表下面、用戶名上方）顯示一行純文本，內容包括餘額、今日已用、峯谷倒計時、每輪消耗與餘額預警；讀數作爲側欄 DOM 的一部分插入，不是屏幕座標上的浮動層。打開左下角賬戶菜單時，同一讀數會臨時改出現在菜單裏「賬戶用量，點擊刷新」上方。

數據與賬本寫在 ~/.dsh/.dshw-*.json；服務端仍提供 /dsh-whale/* 路由（與 dsh-whale-widget 同源設計），前端只消費其中部分路由，但本倉庫不含鯨魚圖片或音效。

側欄里長什麼樣¶

側欄 footer 自帶上分隔線，讀數行示例形態如下（README 示意）：

team-project
  · 整理發佈清單
docs-site
────────────────────────   ← footer 自帶的上分隔線
餘額 ¥8.46 · 今日 ¥3.61 · 谷 16h34m
示例賬號（賬號行）

視覺上無背景板、無邊框、無陰影、無圖標，文字顏色繼承側欄主題。側欄收起時讀數隨 footer 一起消失；找不到側欄 footer 時不顯示，也不回退到浮動層。

核心功能¶

以下能力均來自倉庫 README，按模塊說明。

餘額¶

請求 https://api.deepseek.com/user/balance，默認 10 秒刷新一輪；每輪對話結束會再補刷一次。連續失敗 3 次後自動退到 60 秒間隔。每次請求帶 refresh=1 以繞過服務端約 25 秒緩存。優先使用 API key，沒有則走 DSH 賬號登錄態。

今日已用¶

通過餘額觀測賬本文件 .dshw-usage.json 累計；充值與贈金單獨記賬，不衝抵消費。觀測間隔爲 10 秒。

峯谷標識與倒計時¶

工作日 9–12、14–18 爲峯，其餘爲谷；週末全天按谷價。讀數後會跟下一個切換點的倒計時。

每輪消耗¶

按上一輪真實 usage 與峯谷價換算；一輪結束後在餘額行上方顯示一小行純文字。開關與關閉延遲在 .dsh-size.json 的 turnCostOn、turnCostCloseMs。

餘額預警¶

餘額低於閾值時提醒一次，回到閾值以上後重新武裝。閾值在 .dshw-usage.json 的 settings.alert.below。

相對 whale 類插件去掉的內容¶

鯨魚角色、按壓彈窗、拖拽吸附、點擊泡泡、音效與音效組、角色/圖片/音頻管理、主菜單及子面板，以及任何鼠標與觸摸事件處理。

安裝與啓用¶

插件以 DSH 進程權限運行，安裝前建議瀏覽 GitHub 倉庫 源碼與 LICENSE。

Web profile（推薦）¶

官方 README 給出的安裝命令如下：

dsh plugin --profile web add https://github.com/zeenhuang9-boop/dsh-balance-plain

不要與 dsh-whale-widget 同時安裝：兩者註冊同一組 /dsh-whale/* 路由、讀寫同一賬本，並都會注入前端腳本。若曾安裝 whale 插件，先卸載：

dsh plugin --profile web remove dsh-whale-widget

桌面端（Electron）¶

桌面端 profile 由 Electron 獨佔，CLI 會拒絕 dsh plugin --profile desktop；桌面安裝方式以 DSH 自身插件管理爲準，倉庫說明未驗證桌面一鍵安裝。重載界面可點標題欄右上角 ⟳ 或按 Ctrl+R。

典型用法與配置¶

安裝並重載 DSH 後，側欄 footer 應出現讀數行；無需額外菜單操作即可週期性刷新余額與今日消耗。

需要調整預警或每輪消耗展示時，編輯用戶目錄下的 JSON（路徑以 README 爲準）：

• 餘額預警閾值：.dshw-usage.json → settings.alert.below
• 每輪消耗開關與自動關閉時間：.dsh-size.json → turnCostOn、turnCostCloseMs

開發者在本地調試 UI 時，可打開倉庫內 tools/preview.html：用查詢參數 ?s=normal|alert|peak|error 切換場景，&turn=1 模擬一輪結束，&dark=1 深色背景，&collapse=1 模擬側欄收起；頁面提供 window.__snapNow() 返回佈局快照 JSON。

適用場景與注意¶

適合誰：長期在 DSH Web 或已支持插件的桌面環境裏對話、希望餘額信息常駐側欄又不佔交互區域的開發者。

結構與主題依賴：讀數插在 footer 內 settings-area；啓用 dsh-claude-style 主題時用 data-dsh-claude-part~="settings-area" 定位，主題關閉時退回 class（footArea / sidebarCol）。DSH 大改側欄 DOM 時需要插件重新適配。

賬戶菜單行：依賴 [role=button]、文案「賬戶用量」、尺寸與左下角位置等多重判定；大版本改菜單結構時可能只剩側欄常駐，不會報錯。

平臺：README 寫明僅在 Windows 11 + DSH 桌面版實測；macOS / Linux 未驗證。

生態說明：DSH 社區插件目錄（如 SkillHub 條目）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令與行爲以 GitHub README 爲準。

結尾¶

dsh-balance-plain 把 DeepSeek 餘額、今日消耗、峯谷倒計時、每輪消耗和餘額預警收成側欄 footer 一行純文本，刻意去掉浮動層與交互，適合「只看數、不點 widget」的工作流。

• 目錄頁：https://www.skillhub.cn/plugins/zeenhuang9-boop/dsh-balance-plain
• GitHub：https://github.com/zeenhuang9-boop/dsh-balance-plain