dsh Web インターフェースに、ドラッグ可能なクジラウィジェットでライブな DeepSeek API 残高・本日の利用額・ターンごとの消費を表示するネイティブ dsh bundle プラグイン。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-08-22
ライセンス
MIT
01どんなタスクに使えるのか？
dsh Web インターフェース内で DeepSeek API の残高と消費を常に確認する
dsh Web インターフェース右下の常駐クジラウィジェットが、ライブな DeepSeek API 残高（60 秒自動更新＋クリック更新、数字ロールアニメーション付き）、本日の利用額、各ターン終了後の消費を表示。ドラッグ／端へのスナップと遊び心のあるアニメーション付き
dsh Web インターフェースでの作業中に、常に残高／消費の読み取りを表示させたい DeepSeek API 利用者
追加の凭据なしで本日の消費を追跡する
既定の「クジラ記帳」モードは残高差分を本機だけで集計して本日の消費とし（プラットフォームトークン不要）、オプションの「リアルタイム・トークン」モードはプラットフォームセッショントークンを用いて1時間単位の峰谷（ピーク／バレー）価格で利用額を換算
最小設定で1ターンごと・日ごとの DeepSeek 消費を可視化したいコスト重視の利用者
02DeepSeek 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:.<subdir>` は不可）
- 02
`dsh web` を再起動し、ブラウザで F5 を押します
$ dsh web
- 03
（任意）未設定の場合は dsh 凭据に `DEEPSEEK_API_KEY` を設定。ウィジェットは右下に自動表示されます
導入成功の確認
- `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`
03DSH 統合と能力の範囲
DeepSeek Harness（dsh）のネイティブな bundle プラグイン `dsh-whale-widget` です。dsh Web インターフェースの右下に常駐するクジラのウィジェットを配置し、DeepSeek API の残高・本日の利用額・1 ターンごとの消費を表示し、画面を開くたびに自動で有効になります。インストール／アンインストールは `dsh plugin` 経由です。
ライブ残高ウィジェット
dsh Web インターフェース（右下）→DeepSeek API 残高を表示。60 秒自動更新＋クリック更新、変動時は数字ロールアニメーション。一時的なネットワーク揺れ時は直近の残高を fallback してエラーにしない
本日の利用額（2 モード）
観測された残高減少、または（任意）DeepSeek プラットフォーム利用 API→本日の消費：既定の「クジラ記帳」（本機残高差分記帳、トークン不要）、または任意の「リアルタイム・トークン」モード（プラットフォーム利用 API＋内蔵峰谷毎時価格）
ターンごとの消費
本機 dsh セッションイベント（turn 終了）→各ターン終了後、そのターンの正確な usage ベースの金額をポップ表示（推定ではなく実モデル usage）。プラットフォームトークン不要
ウィジェット操作と遊び心
ウィジェットへのマウス／メニュー操作→ドラッグ＋4 辺 1/4 スナップ（左スナップで水平ミラー反転）、Q 押下バウンド、ハンバーガーメニュー（サイズ 0.6–2.5 倍、音效切替、用量モード、バブル開閉、自動閉じ秒数）、任意音效（mp3 欠損時は無音へ劣化）、ランダム台詞
04誰に向いているのか？使うべきでない場面は？
向いている用途
- dsh Web インターフェースでの作業中に、常に残高／消費の読み取りを表示させたい DeepSeek API 利用者
- 最小設定で1ターンごと・日ごとの DeepSeek 消費を可視化したいコスト重視の利用者
不向きな用途
- `DEEPSEEK_API_KEY` は必須です（api.deepseek.com/user/balance から残高を取得）。`DEEPSEEK_PLATFORM_TOKEN` は任意——DeepSeek プラットフォームの Web セッショントークン（`sk-` 始まりの API key ではなく）、プラットフォーム Web にログイン中のみ有効、かつリアルタイム・トークン用量モードのみで必要です。再ログイン時に再取得が必要になる場合があります。
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 プラットフォームの Web セッショントークン（`sk-` 始まりの API key ではなく）、プラットフォーム Web にログイン中のみ有効、かつリアルタイム・トークン用量モードのみで必要です。再ログイン時に再取得が必要になる場合があります。
- 既定の「クジラ記帳」モードは日次記帳を本機の `$DSH_HOME/.dshw-usage.json` に保存（30 日保持）し、プラットフォームトークン不要です。リアルタイム・トークン モードは任意のセッショントークンを用いて DeepSeek プラットフォーム利用 API へリクエストを送信します。
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:.<subdir>` パスは不可）。その後ウィジェットが右下に自動表示されます。
どの凭据が必要ですか？
必要なのは `DEEPSEEK_API_KEY` のみ（残高取得用）。`DEEPSEEK_PLATFORM_TOKEN` は任意で、リアルタイム・トークン用量モードのみで必要です。既定のクジラ記帳モードは API key があれば動作します。
本日の利用額はどう計算されますか？
既定の「クジラ記帳」モードでは、観測された残高減少を本機で集計して本日の消費とします（トークン不要）。任意の「リアルタイム・トークン」モードは DeepSeek プラットフォーム利用 API を呼び出し、内蔵の峰谷毎時価格表で金額に換算します。
ターンごとの消費は表示されますか？
はい。本機 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
by zhu1090093659
DeepSeek Harness（dsh）の Web プラグインを集約するエコシステムパッケージ。すべてがプラグインであり、クリエイティブワークショップ（dsh-market.com）経由で配布されます。
petdex
by crafter-station
Claude Code、DeepSeek Harness、Gemini CLI などで使えるアニメーションペットの公開ギャラリー
j-space-cognition-suite-v3.7
by tiger3807861189
Anthropic の J-space グローバルワークスペース研究に基づく、AI 認知強化スキル集。思考を整理しながら作業を進めたい日本のユーザー向けのスイートです。
dsh-deep-whale
by small-tailqwq
DSH Web GUI 用の鯨っ娘テーマスキン（深海メイド工房 maid-atelier、ライト/ダーク両モード対応、CC BY-NC-SA 4.0）
08データと出典
DeepSeek Harness（DSH）Web 界面右下角的常驻余额挂件：小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗统计，每次打开界面自动启用。
本项目是标准 DSH 插件包，可通过 `dsh plugin` 安装/卸载。
dsh plugin --profile web add dsh-whale-widget
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-22。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。