前言¶

在 DeepSeek Harness（DSH）里長時間對話時，餘額和計價時段往往要切到別處才能看到。社區插件 dsh-balance-strip（餘額膠囊）把「餘額、今日已用估算、峯/谷」直接貼在會話頁頂部標籤行右側，不點、不懸停、不額外開面板。下面介紹它做什麼、怎麼裝、使用時要注意什麼。

這是什麼¶

dsh-balance-strip 由社區維護者 CPHW 發佈，分類爲客戶端插件；README 標明其爲非官方社區插件，與 DeepSeek 官方無隸屬關係。當前 npm 包版本爲 0.1.5，許可證 MIT。

它在 DSH Web 界面會話頁標籤行右側渲染一枚小膠囊，層級低於系統彈窗；整枚膠囊 pointer-events: none，不擋底下輸入與點擊。界面語言爲中文時顯示漢字，其它語言自動換成英文（如 Balance / Today ≈ / Peak / Off-peak）。

核心功能¶

常駐顯示的三類讀數¶

佈局與交互¶

• 垂直對齊「對話」標籤文字中線，字號取標籤的 computed font-size，隨界面縮放與窗口變化。
• 右邊緣貼會話欄右邊界，不隨窗口外緣漂移。
• 每 20 秒向本機 data.json 拉一次數據更新；失敗時約 6 秒重試。餘額採樣約每 60 秒一次，用於估算「今日已用」。

餘額數據來源¶

宿主側按順序嘗試：

1. profile 中的 DEEPSEEK_API_KEY → GET https://api.deepseek.com/user/balance
2. deepseekAccount 服務（登錄態）

二者皆無時顯示 餘額 —，其它讀數仍可按規則展示。須已登錄 DeepSeek 賬戶，或在 profile 中配置 API Key 憑據。

與同類型插件¶

README 說明與 dsh-whale-widget（小鯨魚）位置不同但都會顯示餘額；同一塊區域不要裝兩份，關掉其中一個即可。

安裝與啓用¶

環境要求 DeepSeek Harness >=0.2.1-rc.2 且 <0.3.0（寫在包的 engines.dsh 中，不兼容版本會拒絕加載）。包爲純 JavaScript，無需 allowBuilds。

先做 npm 安裝（CLI Web 應用常用 web profile）：

dsh plugin --profile web add dsh-balance-strip

npm 不可用時的備選（跟 GitHub 主幹）：

dsh plugin --profile web add github:CPHWQ/dsh-balance-strip

本地開發可用 link: 指向目錄絕對路徑。桌面版 profile 通常名爲 desktop，由 Electron 應用獨佔；可在應用內插件頁安裝，或由助手用內置插件工具安裝，而不是用 CLI 改桌面 profile。

裝完後必須重啓客戶端（含系統托盤退出）：注入腳本的通道只在宿主啓動時收集一次，當次熱裝不會出現膠囊。之後僅改 assets/strip.js 樣式可通過熱替換生效，見下文。

卸載：

dsh plugin --profile web remove dsh-balance-strip

插件唯一落盤文件爲 $DSH_HOME/.dsh-strip.json（今日累計與上一次餘額），卸載後可自行刪除。

典型用法¶

安裝並重啓後，打開 DSH 會話頁即可在標籤行右側看到膠囊，無需額外配置項。預覽形態大致如下（ASCII 示意自 README）：

  對話   上下文   …            ┌───────────────────────────────────┐
  ─────                            │ 今日 ¥0.40 估 │ 餘額 ¥89.24   峯 │
                                   └───────────────────────────────────┘

若要調間距、輪詢間隔或找不到「對話」標籤時的兜底位置，編輯插件內 assets/strip.js 頂部常量（如 GAP、EDGE、RIGHT / BOTTOM、POLL_OK / POLL_ERR），保存後約 20 秒內前端熱替換生效，無需刷新頁面。

工作原理（簡況）¶

一半在宿主 lib/index.js（註冊 GET /dsh-strip/data.json 與 GET /dsh-strip/strip.js，注入頁面腳本），一半在頁面 assets/strip.js（定位、配色、輪詢）。data.json 無認證但僅服務本機：非迴環或跨站請求返回 403；公開部署到局域網/公網時遠端頁面會顯示 餘額 —，屬有意設計。

「今日已用」不是賬單：無賬單接口，只能按餘額採樣間隔累計下降額，小額請求可能被合併，插件未運行時段不計入。

適用場景與注意¶

適合誰： 經常在 DSH 會話頁工作、希望一眼看到餘額與峯谷計價時段的開發者；已配置 API Key 或賬號登錄態的用戶。

務必注意：

• 插件以當前 DSH 進程權限運行，安裝前請閱讀 GitHub 源碼 與 MIT 許可證。
• 同機其它進程理論上仍可讀到本機 data.json 中的金額數字；路由不返回賬戶 ID、令牌或流水。
• 完全沒有膠囊時，多數是裝完未重啓；長期 餘額 — 需檢查憑據或 deepseekAccount 服務。
• 社區目錄 SkillHub 插件頁 與 GitHub 爲同一項目的公開入口，非 DeepSeek / 幻方官方應用商店。

結尾¶

dsh-balance-strip 把餘額、今日消耗估算和峯谷時段收進標籤行右側一枚膠囊，減少切頁查賬。安裝用 dsh plugin --profile web add dsh-balance-strip，裝完重啓客戶端即可使用。

• 社區目錄：https://www.skillhub.cn/plugins/CPHWQ/dsh-balance-strip
• 源碼與問題反饋：https://github.com/CPHWQ/dsh-balance-strip
• npm：https://www.npmjs.com/package/dsh-balance-strip