前言¶
在 DeepSeek Harness（DSH）裏切模型、走訂閱額度時，賬戶頁和廠商控制台往往要單獨打開。社區裏的小鯨魚類記賬掛件已經能把餘額、今日消費和每輪消耗貼在界面角落，但不少版本默認盯着 DeepSeek 賬戶口徑。如果你本會話實際在用的是 Kimi Coding、OpenRouter 或其它已登記模型，角標仍顯示 DeepSeek，就容易誤判還剩多少錢、訂閱窗還剩多少。
下面介紹維護者 Xun209 發佈的 DSH 大肥魚記賬掛件 · 勛（倉庫 Xun209/dsh-fatfish-usage-xun209）。它在記賬掛件形態上做了本機向改造：單次點擊即可查看當前會話正在使用的模型對應的餘額，或會員訂閱週期的剩餘用量，而不是固定展示 DeepSeek。分類上屬於 DSH 客戶端掛件（SkillHub 目錄當前版本 v0.4.2）。
這是什麼¶
這是標準 DSH bundle 客戶端插件（包名仍爲 dsh-whale-widget，與上游記賬掛件共用結構），在 DSH Web 或官方桌面客戶端右下角常駐顯示「大肥魚」角色氣泡。代碼側繼承上游小鯨魚記賬掛件的能力棧；本倉庫的差異化主要在交互與取數口徑：package.json 描述爲「藍毛小女僕 · 記賬掛件：右下角常駐，跟隨當前會話正在使用的模型，顯示其餘額或會員訂閱週期用量」。
角色形象來自社羣二創，美術採用 CC BY-NC-SA 4.0（禁止商用）。插件代碼在 README 中註明爲 MIT；安裝前宜自行閱讀倉庫源碼與 PROVENANCE.md（若存在）中的素材說明。插件在 當前 DSH 進程權限下運行，會讀取憑據服務中的 API key 名、訪問餘額接口並寫賬本到 $DSH_HOME（默認 ~/.dsh），使用前請確認你信任維護者與許可證條款。
與本倉庫相關的核心能力¶
跟會話模型走的餘額與訂閱窗¶
與「角標永遠綁在 DeepSeek」相比，本改造強調跟車當前會話：
- 掛件隨 DSH 界面打開自啓（
dsh.client.platform: web，immediately: true）。 - 點按角色觸發氣泡：展示當前會話模型的賬戶餘額，或該模型配置的訂閱 / 額度窗口剩餘用量（具體能讀到哪一類，取決於你在「小鯨魚記賬 → 模型」裏登記的廠商模板與憑據）。
- 上游仍支持 60 秒自動刷新余額、點擊手動刷新、餘額變化滾動動畫；DeepSeek 內置路徑仍可通過 DSH 憑據中的
DEEPSEEK_API_KEY，或未配置 key 時在「設置 → 賬號與餘額」登錄 DeepSeek 賬號後走登錄態取數（README 原文說明）。
繼承的記賬與多廠商擴展（摘要）¶
README 沿用上野豬掛件文檔，下列能力在 Xun209/dsh-fatfish-usage-xun209 的 main 分支同樣適用，篇幅原因只列與日常開發相關的幾條：
- 今日已用 / 每輪消耗：監聽本機會話事件，按模型真實 usage 換算金額；可在菜單 →「音效與提示」→「全局設置」裏配置每輪消耗泡泡與
{cost}模板。 - 多廠商模板：在記賬裏添加 OpenRouter、Kimi、智譜 Coding Plan、OpenCode Go 等；密鑰只存 DSH 憑據名，配置裏不寫明文 key。
- 可定製泡泡：點擊序列、模塊化排版、隨機語句 / 圖片、拖拽吸附與音效等，與上游說明一致。
若你只需要「換皮膚 + 跟會話看餘額」，不必先配齊全部泡泡編輯器；先完成安裝與模型登記即可。
安裝與啓用¶
SkillHub 目錄頁給出的安裝方式，是在 DSH 會話裏讓宿主代爲安裝本倉庫（勿與上游 npm 包混爲同一來源）：
請安裝 DSH 插件 Xun209/dsh-fatfish-usage-xun209。先讀取..
（完整提示以 SkillHub 插件頁 爲準。）
官方桌面客戶端（推薦路徑）¶
本插件在目錄中歸類爲客戶端。README 寫明桌面端使用 desktop profile，命令行 dsh plugin --profile desktop 會被拒絕；應在桌面客戶端會話中讓 DSH 使用內置 plugin_manager 安裝。README 提供的示例話術爲：
請使用當前桌面端內置的 plugin_manager 安裝 dsh-whale-widget。先覈對當前 profile 和是否已有同名插件；已有安裝時先報告來源與版本。按該工具支持的操作完成後，告訴我安裝結果及是否需要重啓。
安裝規格需指向 Xun209/dsh-fatfish-usage-xun209 這一來源，而不是默認的 MeteorNOX/DeepSeek-Balance-Whale-Widget。裝完後若右下角無掛件，按 README 建議完全退出客戶端（含托盤）後重開，並覈對 desktop profile 下的 bundle 登記。
DSH Web（dsh web）¶
若你使用瀏覽器版 DSH，README「安裝」章節中的 Web 方式仍然有效，但請勿執行文中示例裏指向上游倉庫的命令（例如 dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget 或 dsh plugin --profile web add dsh-whale-widget），以免裝成上游包而非本 fork。
在已取得本倉庫完整目錄（含 package.json、cordis.patch.yml、lib/、assets/）時，可按 README 方式 A 或 方式 C 操作：
- 若曾安裝過同名包，先卸載避免衝突：
dsh plugin --profile web remove dsh-whale-widget
- 在倉庫根目錄（
package.json所在目錄）鏈接安裝：
dsh plugin --profile web add link:.
或使用絕對路徑（README 方式 A）：
dsh plugin --profile web add link:D:\Plugins\dsh-fatfish-usage-xun209
- 重啓
dsh web，瀏覽器再 F5 刷新。
經過上面的步驟，掛件應出現在 Web 界面右下角；菜單底部會顯示當前插件版本（開發版可能帶 -beta 後綴）。
典型用法¶
- 只看當前模型還剩多少：打開 DSH，確認會話使用的模型；單擊右下角大肥魚，閱讀氣泡中的餘額或訂閱週期剩餘用量。需要刷新余額時可再次點擊（上游支持手動刷新與 60 秒輪詢）。
- 登記非 DeepSeek 模型：主菜單 → 資源管理 / 小鯨魚記賬 →「模型」→ 選擇廠商模板 → 在 DSH 憑據裏填對應 key →「測試連通性」。之後在泡泡模塊裏可使用
{balance}、{quota}、{quota_left}等佔位符（README「自定義 API」一節）。 - 校正 DeepSeek 充值導致的賬本偏差：若觀測到餘額上升，按 README 在「小鯨魚記賬 → DeepSeek（內置）→ 設置 → 餘額校正」中核對累計到賬，避免「今日已用」被充值沖掉。
適用場景與注意¶
適合誰：經常在 DSH 裏切換多廠商模型、又想在不離開會話的情況下看一眼當前模型餘額或 Coding Plan / 訂閱窗餘量的開發者；接受右下角常駐 UI 與輕微音效提示的用戶。
注意：
- 與上游 npm 包
dsh-whale-widget同名，README 要求 npm 名與github:來源不要混裝；換來源前應先remove dsh-whale-widget。 - 並非所有廠商都提供「用 API key 查餘額」接口；無餘額接口的模板會顯示「—」，今日已用可能退化爲會話估算（README 廠商表有標註）。
- 插件會寫
.dshw-usage.json等運行時文件到$DSH_HOME；卸載不會自動刪除你的泡泡與賬本配置，需自行備份。 - 角色美術 CC BY-NC-SA 4.0，勿用於商用再分發；代碼 MIT 與素材許可分離，以倉庫聲明爲準。
- DeepSeek Harness 社區目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係；安裝第三方插件前請自行審閱源碼與許可證。
結尾¶
DSH 大肥魚記賬掛件 · 勛 把記賬掛件從「默認 DeepSeek 角標」推進到「跟當前會話模型看餘額與訂閱用量」，並替換爲社羣二創角色形象。需要查閱元數據或複製安裝提示時，可打開 SkillHub 目錄頁；閱讀實現細節、安裝分支說明與多廠商模板表，請以 GitHub 倉庫 README 爲準。
