MeteorNOX/DeepSeek-Balance-Whale-Widget

DeepSeek Balance Whale Widget の機能

このリポジトリには、DeepSeek Web/デスクトップクライアント (DSH) 用のプラグインが含まれています。常時表示される小さな「クジラ」ウィジェットを追加し、以下を表示します：

• DeepSeek API 残高（60 秒ごとに自動更新、滑らかなロールングナンバー付き）。
• 今日の支出 – 残高の変化とターンごとのトークン使用量から計算されます。
• 現在のターンのコスト – 各モデル応答後にバブルがポップアップし、そのターンのコスト金額を表示します。
• カスタマイズ可能なバブル – テキストを編集したり、ランダムな文章、画像、GIF を追加したり、残高/価格情報を表示したりできます。
• ピーク/オフピーク価格 – ウィジェットは DeepSeek の「ピーク」スケジュールを認識し、適切な価格を表示できます。
• 予算/残高不足アラート – 残高がしきい値を下回った場合や、今日の支出が制限を超えた場合にポップアップします。
• オーディオフィードバック – 押下/解放音、ターン終了音、質問/承認用のオプションのプロンプト。
• ドラッグ＆ドロップ配置 – クジラは画面端にスナップ、ミラーリング、または自由に配置できます。

仕組み

1. データソース – プラグインはまず DSH 資格情報ストアから DEEPSEEK_API_KEY を読み取ろうとします。キーがない場合は、DSH が内部でクエリできるログイン済みの DeepSeek アカウントにフォールバックします。
2. 会計コア – lib/accounting.mjs は残高エンドポイントを監視し、増減を記録し、台帳を保持します（90 日間のロールアップ、最大 20,000 エントリ）。また、トークン使用量（input、cache、output、reasoning）を、DeepSeek の組み込み価格テーブル（またはモデルごとに設定できるカスタム価格）を使用して金銭的コストに変換します。
3. UI – assets/whale-widget.js は DSH UI の右下隅にクジラとバブルを描画します。すべての視覚設定（サイズ、色、フォント、ミラーリングなど）は $DSH_HOME/.dshw-size.json に保存されます。
4. 拡張性 – ウィジェットには「モジュールライブラリ」が付属しており、テキスト、リンク、ランダムな文章、画像/GIF、または {balance}、{cost}、{quota} などの組み込みプレースホルダーからバブル行を構成できます。モジュールは保存して再利用できます。
5. マルチベンダーサポート – 「カスタム API」パネルから、他のプロバイダー（OpenRouter、Kimi、OpenAI 互換ゲートウェイなど）を追加できます。各プロバイダーには独自の残高/クォータモジュールがあり、DeepSeek と並べて表示できます。

インストールパス

ターゲット	ブランチ	インストールコマンド
DSH Web UI（右下ウィジェット）	main	dsh plugin --profile web add dsh-whale-widget (npm) または … add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
DSH Desktop (Electron) クライアント	main	デスクトップクライアントに自動インストールさせる：DSH セッションで 「把 dsh-whale-widget 裝上」 と入力するか、内蔵プラグインマネージャーを使用します。
Codex デスクトップアプリ（異なるコードパス）	For-Codex	%USERPROFILE%\plugins\api-balance-whale に解凍し、ブランチ固有のドキュメントに従います。

2 つの製品ラインは同時に使用できません – 完全に独立しています。

設定ファイル（$DSH_HOME に保存）

ファイル	目的
.dshw-size.json	UI サイズ、スナップポイント、オーディオグループ選択、ピーク価格スタイル
.dshw-usage.json	残高観測の台帳、ターンごとのコスト、アラートしきい値、オーディオ設定
.dshw-bubble.json	カスタムバブルシーケンスとモジュールライブラリ
.dshw-api.json	追加した追加プロバイダーのリスト（エンドポイント URL、JSON パス、オプションのトークンごとの価格設定）
.dshw-usage-archive.json	古い台帳データ（ターンごとに 90 日、日次集計で 365 日）
.dshw-codex.json	Codex モードブランチ用のローカル Codex セッションログのキャッシュ

使用するタイミング

• 多くの DeepSeek 呼び出しを実行し、支出額をすばやく視覚的に確認したい場合。
• 残高が尽きる前に警告する 予算ガード が必要な場合。
• 遊び心のある「クジラ」UI が好きで、バブルメッセージをカスタマイズしたい場合（例：ランダムなモチベーション引用、GIF、毎日の予算リマインダー）。
• 複数の LLM プロバイダーを使用しており、各プロバイダーの残りクォータを表示できる単一のウィジェットが必要な場合。

---

結論： このリポジトリは、DeepSeek クライアントを、かわいくて高度にカスタマイズ可能なクジラウィジェットを備えた小さな会計ダッシュボードに変える、フル機能のインストール可能な DSH プラグインです。