MIT ライセンスの DSH デスクトップペットプラグイン。公式 bundle として `dsh plugin --profile web add` でインストールし、DSH Web GUI の右下に表示されます。
DSH 統合
互換
作者による申告
安全性監査
未監査
最終検証日
2026-08-21
ライセンス
MIT
01どんなタスクに使えるのか？
Add a persistent desktop pet companion to the DeepSeek Harness Web GUI
A draggable, feedable, playable pet floating bottom-right, with animated states that react to sessions, tasks and approvals
DSH Web GUI users who want a fun resident companion while running agent sessions
Grow a companion that accrues seniority across your DSH usage
Seniority levels, titles and memories accumulated from completed tasks, sessions and companionship time
Long-term DeepSeek Harness users who want their usage history reflected in a companion
Keep the whale girl resident on your OS desktop, outside the browser
A standalone companion app (Node engine + Tauri shell) that stays on the desktop, connected to a local or remote DSH
Users who want the pet on their OS desktop instead of the DSH web page
02DeepSeek Harness への導入方法
前提条件
- DeepSeek Harness (dsh) with the web profile — the plugin is managed via `dsh plugin --profile web`
- Optional desktop companion: Node ≥18 and Rust (cargo) for the Tauri rendering shell
インストール手順
- 01
Run `dsh plugin --profile web add "github:vlln/whale-girl#main"` (single-line git source, build artifacts committed)
$ dsh plugin --profile web add "github:vlln/whale-girl#main"
- 02
Alternative sources: `dsh plugin --profile web add whale-girl@0.1.0` (npm) or `dsh plugin --profile web add <path-to-whale-girl>` (local directory)
$ dsh plugin --profile web add whale-girl@0.1.0
- 03
Restart web — bundle layers compose at startup
- 04
Optional desktop companion: `npm install -g whale-girl-desktop`, run `whale-girl-desktop --headless` or build the Tauri shell via `cargo build --release` in `src-tauri`
$ npm install -g whale-girl-desktop
- 05
Update via `dsh plugin --profile web update whale-girl` (or switch the git ref), then restart
$ dsh plugin --profile web update whale-girl
導入成功の確認
- After restarting web, the pet appears bottom-right: click for its menu (🍗 feed / 🎾 play), drag to move, hover for the status bar (seniority level / task count / recent shared memories)
03DSH 統合と能力の範囲
Official DSH bundle plugin installed via the `dsh plugin --profile web` CLI and rendered inside the DSH Web GUI
Event-driven pet state machine
DSH session / task events (task done, failure, approval, new session, idle ≥60s)→15 animated states — celebrate, error, disappointed, joy, eat, play, drag, walk, sleep, wake, welcome, think, working, wait, idle
Accrual-based growth (seniority, titles, memories)
Completed tasks, sessions and companionship time→Seniority levels, titles and shared memories shown in the hover status bar
XP / title thresholds are sealed and not configurable, to protect the accumulation ledgerLive configuration & character switching
`whale-girl:` section in `<dshHome>/settings.yaml` (or the settings UI); `whale-girl:character` in localStorage→Size / opacity / wandering / sleep toggles applied live without restart; cycling between characters
Setting `enabled: false` disables the in-page pet while a desktop companion runsStandalone desktop companion (optional)
whale-girl's public endpoints (`/state`, `/events`, `/presence`, `/interact`, `/config`, `/assets`)→Transparent always-on-top desktop pet connected to a local or remote DSH (Tauri v2 shell ~12MB, legacy Electron shell kept)
Not installed via `dsh plugin` — enabled manually (npm global install + cargo build)The in-page pet hides while the companion runs (presence contract) and returns after exit/crash (TTL 45s)
04誰に向いているのか？使うべきでない場面は？
向いている用途
- DSH Web GUI users who want a fun resident companion while running agent sessions
- Long-term DeepSeek Harness users who want their usage history reflected in a companion
- Users who want the pet on their OS desktop instead of the DSH web page
不向きな用途
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
05互換性・メンテナンス・セキュリティ上の注意
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
- Growth semantics (XP and title thresholds) are sealed and not configurable — changing them would break the accumulation ledger.
- The in-page pet lives only in the DSH Web GUI and is hidden on onboarding pages; while the desktop companion runs, the in-page pet hides (presence contract).
MIT · actively maintained (last push 2026-08-18)
06よくある質問
whale-girl を DeepSeek Harness に導入するには？
公式プロファイルで管理される公式 bundle プラグインです。`dsh plugin --profile web add "github:vlln/whale-girl#main"` を実行し（npm ソース `whale-girl@0.1.0` やローカルディレクトリにも対応）、web を再起動してください。起動時に bundle レイヤーが構成され、ペットが右下に現れます。
DSH ネイティブプラグインですか、それとも MCP サーバーですか？
どちらでもありません。公式 bundle プラグイン形式（ルート `package.json` の `dsh.bundle` + `dsh.client`）で提供され、DSH Web GUI 内に直接描画されます。MCP は不要です。
デスクトップ常駐版には何が必要ですか？
任意の機能で、`dsh plugin` では導入しません。Tauri シェルのビルドに Node ≥18 と Rust（cargo）が必要で、初回ビルドは約 5〜15 分かかります。whale-girl の公開エンドポイントを利用し、既定ではローカル 3080 ポートの DSH に接続します（`WHALE_GIRL_BASE_URL` でリモート DSH も指定可）。
成長データはどこから来て、ルールは変更できますか？
完了タスク・セッション・陪伴時間がシニアリティレベル・称号・思い出として蓄積されます。XP と称号のしきい値は意図的に封印されており設定不可です。変更すると蓄積台帳が壊れるためです。
サイズや透明度、うろつきはどう設定しますか？
`<dshHome>/settings.yaml` の `whale-girl:` セクション（または設定 UI）を編集します。変更は再起動なしで即時反映されます。キャラクターは 🎭 ボタンまたは localStorage の `whale-girl:character` で切り替えられます。
07関連する DSH ワークフロー
dsh-pet
by pc2005-cloud
DSH Web デスクトップペット：51 透明 webm アニメ、画面漫游、クリック/ドラッグ。プロンプト＋AI 動画で自作も可
dsh-dafeiyu
by qcytsn
DeepSeek Harness 向け Windows 常時最前面の BigFish デスクトップコンパニオン。リアルな Agent ステータス表示
dsh-tavern
by flizzywine
SillyTavern 風文字ゲーム Agent。候補生成、角色卡編集、剧本モード
dsh-kun-like-pet
by liyupi
デスクトップペット「小坤宠」：Agent 状態に連動する 9 アニメ、完了時に効果音。shell.overlay 描画
08データと出典
Official **bundle plugin** (`dsh.bundle` + `dsh.client` in root `package.json`), managed via the official profile:
dsh plugin --profile web add "github:vlln/whale-girl#main" # single-line git source (build artifacts committed)
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-21。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。