前言¶
在 DeepSeek Harness（DSH）裏跑長對話時，token 在漲、錢包在扣，但界面往往不直接告訴你「這一會話大概花了多少、賬戶還剩多少」。有人用桌面掛件、多廠商統計或通知提醒，功能多、也更容易打斷對話。下面介紹維護者 ashuai 的客戶端插件 dsh-status-balance：在 Web UI 輸入框下方常駐一行兩個數字，點開再看今日賬本，刻意不做對話鏈路上的額外請求。
這是什麼¶
dsh-status-balance 是 DeepSeek Harness Web UI 的極簡餘額掛件。它在輸入框下方、上下文指示器之後顯示 本會話花費 與 錢包餘額；點擊後展開今日消耗、餘額變化、預計可用天數和當前峯谷時段。插件分類爲客戶端，零依賴、無構建，不參與對話、不註冊工具、不注入 system prompt。
倉庫：https://github.com/ashuai/dsh-status-balance
社區目錄頁：https://www.skillhub.cn/plugins/ashuai/dsh-status-balance
界面上你會看到什麼¶
狀態欄是一行約 22px 的 pill，無文字標籤、無動畫、無聲音。示意（來自 README）：
[↗ ¥0.0043] · [👛 ¥6,053.41] ← 輸入框下、上下文指示器之後
| pill | 含義 |
|---|---|
| 左（流出圖標） | 本會話消耗：由 tokenUsage 投影 × 當前峯谷價估算，隨投影實時刷新，不輪詢 |
| 右（錢包圖標） | 錢包餘額：經 Host 同源 route 拉取，頁面可見時每 60 秒輪詢一次 |
點開 pill 後，詳情裏會按行展示賬戶餘額、充值/贈送餘額（兩者都非零時合併）、今日我的消耗、今日餘額減少、差額、今日充值、預計可用天數、當前峯谷時段，以及更新時間、統計起點、錯誤原因和手動刷新入口。兩個「今日」口徑不同：我的消耗 是本進程按事件與峯谷價算的 usage；餘額減少 是本進程觀測到的錢包下降（含其他終端、會話或 key），差額大於 ¥0.01 時提示可能被別處消耗。
爲什麼這麼小¶
源碼約 86 KB，兩個 JS 文件（index.js Host、client.js 瀏覽器），無 npm、無編譯。瀏覽器側按需請求：可見時 60 秒輪詢餘額，隱藏則停；Host 側 30 秒緩存、單飛、失敗退避。API key 只在 Host 解析使用，瀏覽器只拿到展示用字符串。本地賬本 $DSH_HOME/.dsh-status-balance.json（未設置 DSH_HOME 時爲 ~/.dsh/.dsh-status-balance.json）只存金額、token 數與 session id，不存 prompt 或消息內容。
金額按 DeepSeek 官方 CNY / 百萬 tokens 標價估算（DeepSeek 不返回單次調用成本），不是賬單；折扣、贈送與計費差異不會完全體現。
安裝與啓用¶
需要帶 Web UI 的 DSH profile（例如 composer.dock，且存在 tokenUsage / modelSelection 投影時可用）。
# 本地目錄
dsh plugin --profile web add link:/absolute/path/to/dsh-status-balance
# 或從 GitHub
dsh plugin --profile web add github:ashuai/dsh-status-balance
安裝後重啓 dsh web（改 Host 半需重啓；只改瀏覽器半則刷新頁面）。卸載：
dsh plugin --profile web remove dsh-status-balance
配置（可選）¶
所有鍵寫在 profile patch 該插件行的 config 下，均可省略。常用項如下（完整表見 README）：
| 鍵 | 默認 | 說明 |
|---|---|---|
balanceUrl |
https://api.deepseek.com/user/balance |
餘額接口 |
apiKeyRef |
DEEPSEEK_API_KEY |
憑據引用 |
routePath |
/plugin/dsh-status-balance |
同源 GET 路由 |
cacheTtlMs |
30000 |
成功緩存時長 |
prices |
README 價表 | 可覆蓋 timezone、peakWindows、models 等 |
峯谷默認按 Asia/Shanghai：工作日 09:00–12:00、14:00–18:00 爲高峯，其餘與週末爲谷時；flash 系與 pro 系單價見倉庫 README。
典型用法¶
- 按上文命令安裝並重啓
dsh web，打開 Web UI，在輸入框下確認兩個金額 pill 出現。 - 對話過程中觀察左側數字隨會話 token 投影變化；右側約每分鐘更新余額（頁面在前臺且可見時）。
- 點擊 pill 查看今日賬本與預計可用天數；若今日餘額減少從進程首次成功請求才開始觀測，標籤會顯示「（自 HH:mm）」。
- 需要改價表或餘額 URL 時，在 profile 的
config中寫入對應鍵後重啓 Host。
適用場景與注意¶
適合已經在 DSH Web UI 裏日常對話、希望一眼看到本機會話估算花費與 DeepSeek 錢包餘額、又不想讓插件進入模型鏈路的用戶。它不做多廠商、訂閱額度、通知、桌面懸浮或歷史趨勢圖。
安裝前建議瀏覽倉庫源碼與 MIT 許可證。插件以當前 dsh 進程權限運行；同源路由 /plugin/dsh-status-balance 與其它插件路由類似，無額外鑑權，只返回展示字段——服務監聽在哪個網卡，路由就在哪裏可達。多 Host 進程共享同一 DSH_HOME 時本地賬本可能互相覆蓋。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-status-balance 把「本會話花了多少、錢包還剩多少」收成輸入框下的一行數字，需要時再點開今日賬本。若要安裝或查配置細節，以 GitHub README 爲準：https://github.com/ashuai/dsh-status-balance；目錄頁：https://www.skillhub.cn/plugins/ashuai/dsh-status-balance。
