前言¶
日常用 DeepSeek Harness（DSH）跑對話時，餘額和 token 消耗往往要打開「設置 → 賬號與餘額」或自己翻日誌才能對齊。計價還有峯谷時段差異，高峯單價會翻倍，單靠賬單頁也不總能一眼看出「今天大概花了多少」。社區插件 dsh-caption-balance 把賬戶餘額、本機會話推算的今日花費，以及當前峯/谷提示嵌進桌面端標題欄（「應用 / 編輯」菜單右側），懸停可看明細，點擊可立即刷新。
下面按定位、功能、安裝配置與注意事項說明用法，事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-caption-balance 由 resnowh 維護，分類爲 DSH 客戶端插件（package.json 中 dsh.client.platform 爲 web）。它在 Harness 界面裏渲染一行實時讀數：默認落在桌面端標題欄，也可改到會話標題欄或側邊欄底部。
餘額走官方賬號服務（與「設置 → 賬號與餘額」同源，插件不接觸憑證）；今日花費由本機 $DSH_HOME/sessions 下會話日誌統計 token，再按 profile 裏配置的價目表折算，並附帶當前計價時段的單字提示（峯/谷）。
核心功能¶
標題欄典型展示形如：
應用 編輯 ¥61.05 · ¥4.04 谷
已覈實的能力包括：
- 賬戶餘額：通過宿主側
deepseekAccount.getBalance讀取，帶超時與緩存（默認balanceRefreshSeconds: 180）。 - 今日花費：解析會話日誌
session*.jsonl.zstd中assistant/message的data.usage，按models下「元 / 百萬 tokens」的空閒價計算；高峯按peakMultiplier（默認 2）倍計。 - 峯 / 谷：北京時間工作日 9:00–12:00、14:00–18:00 爲
峯（×2），其餘爲谷；高峯時「峯」字可呈琥珀色。 - 低餘額提示：低於
lowBalanceThreshold時餘額可變琥珀/紅色，或選gradient在兩端顏色間過渡。 - 懸停明細：贈送餘額、今日/本月 token 與花費、當前時段、更新時間等。
- 刷新：點擊立即刷新；默認每
refreshSeconds（30）秒輪詢，且刷新時數字等寬、小數默認可縮小一號以減少跳動。 - 顯示項與位置：餘額、今日花費、峯谷單字可分別開關；
position支持auto/caption（桌面標題欄）/header（會話標題欄）/sidebar。
宿主提供本機可用的 GET /api/dsh-caption-balance/summary；客戶端按 display.position 注入到標題欄菜單、會話 utilities 或側邊欄底部。
環境與安裝¶
要求 DeepSeek Harness 0.2.2-rc.1 及以上（package.json 中 engines.dsh 爲 >=0.2.2-rc.1 <0.3.0-0）。當前包版本 0.5.1，許可證 MIT。
圖形界面¶
側欄 插件 → 添加插件（或「安裝第三方插件」），粘貼倉庫地址：
https://github.com/resnowh/dsh-caption-balance
安裝後點「立即啓用」，重啓應用生效（桌面版無刷新頁面快捷鍵）。
命令行¶
dsh plugin --profile desktop add github:resnowh/dsh-caption-balance
--profile 換成你要安裝的 profile 名（桌面端默認 desktop）。
安裝後同樣需要重啓應用。插件需聲明 dsh.bundle.patch 才能被 dsh plugin add 識別，本倉庫已包含 cordis.patch.yml。
配置¶
Profile 中的 YAML¶
在 profile 的 cordis.patch.yml 裏，dsh-caption-balance 條目下的 config 可寫默認值，例如：
- id: dsh-caption-balance
name: dsh-caption-balance
config:
currency: CNY
refreshSeconds: 30
balanceRefreshSeconds: 180
display:
position: auto
showBalance: true
showToday: true
showPhase: true
lowBalanceThreshold: 10
lowBalanceStyle: warn
models:
deepseek-flash:
cacheHit: 0.02
cacheMiss: 1
output: 4
價格單位爲「元 / 百萬 tokens」，填空閒時段單價；未配置單價的模型仍統計 token，但不計入花費。官方調價後需自行更新 models 與 aliases。
設置界面（無需改 YAML）¶
- 設置 → 餘額顯示
- 插件頁 → 餘額顯示 → 配置區
兩處是同一表單。保存後立即生效，用戶覆蓋寫入 ~/.dsh/plugin-data/dsh-caption-balance/settings.json，優先於 profile 默認值。點「恢復默認」等價於刪該文件並回到部署默認。
改 profile 裏 YAML 後需重啓；僅通過設置頁修改則不必重啓。
典型用法¶
- 裝好插件並登錄 DeepSeek 賬號，重啓 DSH 後看標題欄是否出現
¥餘額 · ¥今日花費與「峯/谷」。 - 懸停讀數查看贈送餘額、本月累計與更新時間；花費偏高時對照明細裏的 token 分項。
- 若餘額經常偏低，在設置裏把
lowBalanceThreshold調高，或lowBalanceStyle設爲danger/gradient。 - macOS 桌面端或
dsh web無 Windows 那排標題欄菜單時，將display.position設爲header或sidebar（auto會自動落到會話標題欄）。
適用場景與注意¶
適合誰：長期在 DSH 桌面端對話、希望隨時看到餘額和本機日誌推算的今日花費、並關心峯谷計價的用戶。
安全與權限：插件隨當前 DSH 進程在本地運行；餘額接口與設置頁同源，但花費統計會讀會話目錄。安裝前宜瀏覽 源碼 與 MIT 許可證，確認符合你的環境策略。
已知限制（README 載明）：
- 標題欄
caption位置僅 Windows 桌面端可用。 - 今日/本月按宿主本機時區劃分日曆日；峯谷按北京時間；法定節假日未單獨建模。
- 花費爲價目表參考值，不是官方賬單。
- 依賴桌面 preload 標題欄 DOM，DSH 大版本升級後掛載點可能變化。
社區目錄（如 SkillHub 插件頁）與 GitHub 爲獨立生態入口，與 DeepSeek / 幻方無官方從屬關係；安裝方式以倉庫說明爲準。
結尾¶
dsh-caption-balance 把餘額、今日花費和峯谷提示收進標題欄一行，減少反覆進設置頁的開銷。需要圖形安裝或二次開發時，可查閱目錄頁與倉庫：
