前言¶

在 DeepSeek Harness（DSH）裏跑 Web 會話時，餘額、今日消耗和峯谷單價往往要切到平臺或憑據頁才能覈對；對話每輪的真實 token 費用也不總在視線裏。DSH 社區裏已有各類 bundle 插件擴展界面能力。下面介紹的是掛在 Web 界面右下角的小鯨魚掛件：把 DeepSeek 餘額、今日已用、峯谷狀態和部分提醒收進一個常駐控件，並通過可配置的點擊氣泡序列把展示方式交給使用者自己排版。

這是什麼¶

DSH 小鯨魚記賬掛件（npm 包名 dsh-whale-widget）由維護者 ggxx001 發佈，在 SkillHub 插件目錄 中歸類爲「趣味換裝」。源碼與說明見 GitHub：ggxx001/dsh-whale-widget。

它是標準 DSH bundle 插件，隨 DSH Web 界面打開自動出現在右下角：小鯨魚角色圖 + 氣泡內容。核心用途包括：展示 DeepSeek API 餘額與今日已用、按北京時間區分峯谷定價、監聽本機會話每輪 usage 並提示消耗金額，以及通過模塊化編輯器自定義「點鯨魚出泡」的序列、樣式、音效與角色資源。README 中說明：同一 npm 包也可用於官方桌面客戶端，但 Web 端與 Codex 桌面應用是不同產品線；Codex 版已遷至獨立倉庫，與本插件互不兼容。

核心功能¶

記賬與顯示¶

掛件每 60 秒自動刷新余額，點擊鯨魚可手動刷新；餘額變化時有數字滾動動畫，短時網絡抖動會沿用最近一次成功讀數。取數優先級爲：DSH 憑據中的 DEEPSEEK_API_KEY；若未配置 key 但已在「設置 → 賬號與餘額」登錄 DeepSeek 賬號，則使用登錄態（無需單獨去 platform 建 key）。

「今日已用」通過觀測餘額下降累計，充值或贈金導致的上升單獨記錄，不會沖掉已有消費；檢測到餘額增加時會提示「待覈對餘額調整」，可在「小鯨魚記賬 → DeepSeek（內置）→ 設置 → 餘額校正」中按實際到賬與非調用扣減校正。逐輪明細與歸檔策略見 README（例如逐輪明細保留 90 天或最多 2 萬條等）。

每輪對話消耗監聽 DSH 本機會話事件，按模型真實 usage（input / cache / output / reasoning tokens）換算金額，輪次結束可彈出消耗泡泡；開關、自動關閉秒數與泡泡文案在「菜單 → 音效與提示 → 全局設置 → 每輪消耗提示」中配置，金額佔位符爲 {cost}。

峯谷定價按北京時間：工作日 9:00–12:00、14:00–18:00 爲高峯，其餘爲空閒；自 2026-08-23 起週末全天按谷價。峯谷模塊支持多種展示樣式（如狀態文字、倒計時等）。

另提供用量記錄窗口：今日模型消費、近 7 天、全部記錄、模型佔比與按日期展開的明細，支持按日期或模型名搜索。

泡泡系統與交互¶

點擊序列分「首次點擊泡」與「再次點擊」隊列，隊列項可增刪排序；兩項可並列爲 A/B 加權，每輪按權重抽取其一。可選「點按角色推進隊列」：開啓後點角色依次推進隊列項，走完最後一項再點則收起，下次從第一項重新開始。

單個泡泡由多行模塊組成，每行最多 6 個模塊，泡泡最多 6 行。模塊類型包括：文本、超鏈接、隨機語句（帶權重且不連續重複）、圖片/動圖、隨機圖片、總餘額（充值+贈金）、贈金、充值餘額、今日已用、峯谷時段、對話名等；圖片類模塊獨佔一行且每泡僅一個。支持逐模塊字體、字號、加粗/斜體/下劃線、純色或跑馬燈漸變、底色；文本與隨機語句支持懸浮快捷編輯；常用模塊可存入模塊庫複用。

交互上支持拖拽與四邊吸附（頂部吸附默認 0 表示關閉，需在「菜單 → 吸附與翻轉 → 自定義」中設正值）；貼左吸附時整體水平鏡像翻轉。主菜單含角色與大小、音效與提示、氣泡開關、吸附、資源管理等；可隱藏菜單按鈕，隱藏後桌面端右鍵鯨魚、移動端長按約 1.5 秒喚出菜單。

提醒、音效與資源¶

餘額低於閾值、今日已用達到預算、每輪消耗、以及 DSH 需要你回答提問或批准授權時，均可配置氣泡或卡片提醒（部分默認關閉）。按壓與鬆開音效、任務結束音、提問音/授權音可獨立開關與音量；可導入音頻片段組成自定義音效組。角色與泡泡圖庫支持上傳 png/gif，內置示例圖見 README。

多廠商餘額與額度（可選）¶

除內置 DeepSeek 外，可在「小鯨魚記賬 → 模型」添加其他廠商：README 列出 34 個廠商模板（含可直接查餘額/額度與「無餘額接口、探活 + 會話估算」等類型）。密鑰寫入 DSH 官方憑據服務，配置中只存憑據名；各模型可配餘額預警、今日預算與額度模塊，泡泡中可使用 {balance}、{today}、{quota} 等佔位符。並非所有廠商都提供公開餘額 API，具體以模板說明爲準。

安裝與啓用¶

Web 界面右下角使用 main 分支對應的 npm 已發佈版，推薦命令如下：

dsh plugin --profile web add dsh-whale-widget

README 也提到可從 GitHub 安裝當前 main 狀態（不跟隨 npm 已發佈版本）：

dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget

兩種方式對應同一包名，不要混裝；若已用 github: 安裝要改用 npm 名，需先執行：

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

官方 Electron 桌面客戶端不能使用 --profile web 從 CLI 安裝，需在桌面端會話中讓 DSH 自行安裝插件，詳見倉庫 README「官方桌面端」一節。

插件以當前 DSH 進程的權限運行，會讀取憑據與賬號登錄態併發起餘額相關請求。安裝前建議閱讀源碼、MIT 許可證（package.json 標註）及 README 中的分支與 Codex 遷移說明。

典型用法¶

1、安裝並打開 DSH Web 界面，確認右下角出現小鯨魚；若已配置 DEEPSEEK_API_KEY 或完成賬號登錄，氣泡中的餘額模塊應能刷新。

2、打開鯨魚菜單，進入「自定義泡泡」或氣泡相關入口，配置首次點擊與再次點擊序列：例如一行放「總餘額」模塊，一行放「今日已用」，再添加峯谷模塊；保存後點鯨魚驗證序列。

3、需要每輪費用反饋時：「音效與提示 → 全局設置 → 每輪消耗提示」中打開冒泡，設置自動關閉秒數，在「編輯提示內容」裏用 {cost} 引用本輪金額。

4、若使用多模型：在「小鯨魚記賬 → 模型」選擇廠商模板、綁定憑據名並「測試連通性」，再把「餘額·模型名」等模塊拖入泡泡。

5、吸附與翻轉：「菜單 → 吸附與翻轉 → 自定義」調整四邊吸附區；貼左時觀察鏡像翻轉是否符合閱讀習慣。

適用場景與注意¶

適合長期在 DSH Web 裏調試智能體、希望餘額、今日消耗、峯谷與每輪費用留在同一視線內的開發者。若主要使用 Codex 桌面應用，應使用 README 指向的 Codex-Whale-Public 產品線，不能用 dsh plugin … add 把本倉庫插件裝進 Codex。

自定義單價、廠商模板與硅基流動等平臺 API 變更等細節以 README 當前說明爲準；涉及密鑰與日誌時，README 要求反饋問題時註明版本與系統、勿上傳未脫敏配置。

結尾¶

DSH 小鯨魚記賬掛件把 DeepSeek 餘額觀測、今日記賬、峯谷展示和可編排氣泡收進 Web 右下角，並擴展到多廠商模板與提醒音效。若要查看分類與簡介，可打開 SkillHub 目錄頁；安裝命令、模塊字段與桌面端說明以 GitHub 倉庫 README 爲準。