一個原生 dsh bundle 外掛，在 dsh Web 介面以可拖曳小鯨魚掛件顯示即時 DeepSeek API 餘額、今日已用與每輪消耗。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-22
授權條款
MIT
01它能幫你完成什麼？
在 dsh Web 介面裡隨時關注你的 DeepSeek API 餘額與消耗
dsh Web 介面右下角的常駐小鯨魚掛件，顯示即時 DeepSeek API 餘額（每 60 秒自動重新整理 + 點擊鯨魚手動重新整理，帶數字滾動動畫）、今日已用與每輪對話後的消耗，並支援拖曳 / 四邊吸附與趣味動畫
希望在 dsh Web 介面工作時始終看到餘額 / 消耗讀數的 DeepSeek API 使用者
無需額外令牌也能追蹤今日消耗
預設的「小鯨魚記帳」模式完全用本機餘額差值記帳今日消耗（無需平台令牌）；可選的「即時·令牌」模式用平台會話令牌按每小時峰谷定價換算即時用量
希望用最小設定獲得每輪與每日 DeepSeek 消耗可視性的成本敏感使用者
02如何將外掛接入 DeepSeek Harness？
先決條件
- 已啟用 Web 介面（`dsh web`）及 Web 設定的 DeepSeek Harness
- 在 dsh 凭据中設定 `DEEPSEEK_API_KEY`（拉取餘額必需）
安裝步驟
- 01
從 npm 安裝：`dsh plugin --profile web add dsh-whale-widget`（本地克隆則在該倉庫根目錄執行 `dsh plugin --profile web add link:.`，不要用 `link:.<子目錄>`）
$ dsh plugin --profile web add dsh-whale-widget
- 02
重啟 `dsh web`，然後在瀏覽器中按 F5
$ dsh web
- 03
（選用）若尚未設定，請在 dsh 凭据中設定 `DEEPSEEK_API_KEY`；掛件會自動出現在右下角
驗證整合成功
- 執行 `dsh --profile web --dump-config`，確認 `dsh-whale-widget` 列在 bundles 下
- curl `http://127.0.0.1:3080/dsh-whale/balance.json` 應傳回 200 且含 `totalBalance`；F5 後右下角應出現鯨魚掛件
復原
- 卸載：`dsh plugin --profile web remove dsh-whale-widget`
03DSH 整合程度與能力邊界
原生 DeepSeek Harness（dsh）bundle 外掛 `dsh-whale-widget`。它在 dsh Web 介面右下角掛載一個常駐的小鯨魚掛件，顯示 DeepSeek API 餘額、今日已用與每輪對話消耗，每次開啟介面自動啟用。透過 `dsh plugin` 安裝 / 卸載。
即時餘額掛件
dsh Web 介面（右下角）→顯示 DeepSeek API 餘額，每 60 秒自動重新整理 + 點擊手動重新整理，餘額變化有數字滾動動畫，瞬時網路抖動自動沿用最近餘額不報錯
今日已用（兩種模式）
觀測到的餘額下降，或（選用）DeepSeek 平台用量介面→今日消耗：預設「小鯨魚記帳」（本機餘額差值記帳，無需令牌），或選用「即時·令牌」模式（平台用量介面 + 內建峰谷每小時定價）
每輪對話消耗
本機 dsh 會話事件（turn 結束）→每輪對話結束後彈出該輪精確 usage 金額（真實模型 usage，非估算）——無需平台令牌
掛件互動與趣味效果
對掛件的滑鼠 / 選單互動→拖曳 + 四邊四分之一吸附（左吸附整體水平鏡像翻轉）、按壓 Q 彈玩偶效果、漢堡選單（大小 0.6–2.5 倍、音效切換、用量模式、氣泡開關、自動關閉秒數）、選用音效（缺少 mp3 時靜默降級）與隨機台詞
04適合誰？何時不該用？
適合
- 希望在 dsh Web 介面工作時始終看到餘額 / 消耗讀數的 DeepSeek API 使用者
- 希望用最小設定獲得每輪與每日 DeepSeek 消耗可視性的成本敏感使用者
不適合
- `DEEPSEEK_API_KEY` 必需（用於從 api.deepseek.com/user/balance 拉取餘額）。`DEEPSEEK_PLATFORM_TOKEN` 選用——它是 DeepSeek 平台網頁會話令牌（不是 `sk-` 開頭的 API key），僅在登入平台網頁時有效，且只用於即時·令牌用量模式；重新登入後可能需要重新取得。
05相容性、維護與安全提醒
- 原生 dsh bundle 外掛：需要 DeepSeek Harness 的 Web 介面（`dsh web`）及 Web 設定。用 `dsh plugin --profile web add dsh-whale-widget`（或倉庫根目錄 `link:.`）安裝，然後重啟 `dsh web` 並重新整理瀏覽器。僅在 dsh Web 介面內渲染。
- `DEEPSEEK_API_KEY` 必需（用於從 api.deepseek.com/user/balance 拉取餘額）。`DEEPSEEK_PLATFORM_TOKEN` 選用——它是 DeepSeek 平台網頁會話令牌（不是 `sk-` 開頭的 API key），僅在登入平台網頁時有效，且只用於即時·令牌用量模式；重新登入後可能需要重新取得。
- 預設的「小鯨魚記帳」模式把每日記帳儲存在本機 `$DSH_HOME/.dshw-usage.json`（保留 30 天），無需平台令牌。即時·令牌模式會用選用的會話令牌向 DeepSeek 平台用量介面發起請求。
MIT · 活躍維護中（最新版本 v0.2.7，2026-08-22）
06常見問題
怎麼安裝小鯨魚掛件？
在 Web 設定中執行 `dsh plugin --profile web add dsh-whale-widget`（npm），然後重啟 `dsh web` 並按 F5。若你克隆了倉庫，請在倉庫根目錄用 `dsh plugin --profile web add link:.`（不要用 `link:.<子目錄>` 路徑）。掛件隨後會自動出現在右下角。
它需要什麼凭据？
只需 `DEEPSEEK_API_KEY`——用於拉取餘額。`DEEPSEEK_PLATFORM_TOKEN` 選用，僅即時·令牌用量模式需要；預設的「小鯨魚記帳」模式有 API key 即可運作。
今日已用是怎麼算出來的？
預設「小鯨魚記帳」模式下，鯨魚用觀測到的餘額下降在本機累計今日消耗（無需令牌）。選用的「即時·令牌」模式呼叫 DeepSeek 平台用量介面，並按內建峰谷每小時定價表換算成金額。
會顯示每輪消耗嗎？
會。它監聽本機 dsh 會話事件，每輪對話結束後彈出該輪精確 usage 金額——使用真實模型 usage 而非估算，且不需要任何平台令牌。
怎麼驗證它是否生效，又怎麼卸載？
驗證：`dsh --profile web --dump-config` 應在 bundles 下列出 `dsh-whale-widget`；`curl http://127.0.0.1:3080/dsh-whale/balance.json` 傳回 200 且含 `totalBalance`；F5 後右下角出現鯨魚。卸載：`dsh plugin --profile web remove dsh-whale-widget`。
07相關的 DSH 工作流程
dsh-web
作者 zhu1090093659
DeepSeek Harness（dsh）外掛聚合生態，萬物皆外掛，通過創意工坊分發。
petdex
作者 crafter-station
面向 Codex、Claude Code、DeepSeek Harness 等智慧體的動效寵物公共相簿。
j-space-cognition-suite-v3.7
作者 tiger3807861189
J-Space Cognition Suite V3.7 - AI cognitive-enhancement Skills based on Anthropic's J-space global workspace research. | 嗶哩嗶哩：Tiger380 (UID 3494375382321675) — https://space.bilibili.com/3494375382321675
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 適用於 DeepSeek Harness 的，鯨魚娘系列皮膚。
08資料與來源
DeepSeek Harness（DSH）Web 界面右下角的常驻余额挂件：小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗统计，每次打开界面自动启用。
本项目是标准 DSH 插件包，可通过 `dsh plugin` 安装/卸载。
dsh plugin --profile web add dsh-whale-widget
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-22。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。