MIT ライセンスの DSH デスクトップペット。依存ゼロの DOM 製クジラがデスクトップと Web で idle / think / working / celebrate / error / wait を反映し、profile の `package.json` 依存と `dsh.profile.bundles` への追記で導入します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-13
ライセンス
MIT
01どんなタスクに使えるのか?
DeepSeek Harness がいま何をしているか——アイドル、思考中、作業中、待機、エラー、完了——を隅のデスクトップペットから一目で把握する
セッションのステートマシンに合わせてアニメーションと表情が変わるクジラ(idle / think / working / celebrate / error / disappointed / wait、優先度 error > celebrate > think > working > idle)。デスクトップアプリでも Web UI でも同じ
長い agent ターンを回すことが多く、トランスクリプトを眺める代わりに常時見える状態インジケーターが欲しい DSH ユーザー
並行して走る複数のセッションを見張り、どれかが終わったら知らせてもらう
別のセッションが動いている間もクジラは作業を続け、実行中セッション数を吹き出しバッジで示し、終わったセッションを祝福して名前で知らせ、入力待ちのセッションも教えてくれる
DSH のセッションを並行して開いておく人(この機能には DSH 0.1.7 以降が必要)
長い DSH セッションを、つついたり着せ替えたり隠したりできるものに変える
つつき・なでなでへの反応、ダブルクリックでの回転、端までドラッグしたときのつぶれ、7 種類のパレット、0.8〜1.6 倍のサイズ変更、WebAudio の効果音、隅への収納とドラッグできるステータスボタン、ライト/ダークテーマへの追従
harness をターミナルではなくデスクトップアプリのように感じたい人
02DeepSeek Harness への導入方法
前提条件
- 必要な DSH は `>=0.1.5-alpha.2 <0.3.0`、Node.js は `^22.19.0 || >=24.0.0`
- 実際に使っているプロファイルディレクトリ——デスクトップと Web はそれぞれ別のプロファイルを使い、Web 版は通常 `~/.dsh/profiles/web`
インストール手順
- 01
プロファイルの `package.json` を編集する:`dependencies` に `"pet-whale": "^1.2.7"` を追加し、`dsh.profile.bundles` リストの既存エントリの隣に `"pet-whale"` を追加する
- 02
そのプロファイルディレクトリで `pnpm install` を実行し、DSH を再起動する——デスクトップ版はトレイから終了してから起動し直す
- 03
別の方法:npm を使わずにインストールする——ローカルのチェックアウトなら `dsh plugin --profile web add link:/path/to/pet-whale`(リポジトリにはビルド済みの `lib/` が含まれている)、git から入れるなら `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"`
$ dsh plugin --profile web add link:/path/to/pet-whale
導入成功の確認
作者は未記載
03DSH 統合と能力の範囲
DSH のプラグインバンドル。クライアント側(`lib/client.js`)が DSH の UI にクジラを描画してセッション状態に追従し、ホスト側(`lib/index.mjs`)がホスト側の処理を担う。プロファイルの `dsh.profile.bundles` リストに追加して使う
Agent ステートマシン
DSH のセッションスナップショットと chat プロジェクション(`running`、`lastAgentError`、`partial`、`runningCalls`、`turnEnds`)→idle / think / working / celebrate / error / disappointed / wait のアニメーション。優先度は error > celebrate > think > working > idle
全セッションへの追従
`ctx.uiSession.sessionStatus` から得られるセッションごとの実行状態と承認待ち状態→実行中セッション数の吹き出しバッジ、終了したセッションを名指しする祝福、入力待ちセッションの通知(サブエージェントは除く)
思考ストリームの吹き出し
状態が `think` のときのモデルの直近の思考テキスト→直近およそ 200 文字をクジラの上でゆっくりスクロール表示(右クリックメニューで切り替え可能)
インタラクションと外観
クリック、ダブルクリック、ドラッグ、カーソルの接近、右クリックメニューの選択→つつき/なでなでへの反応、360° 回転、端でのつぶれ、7 種類のパレット、0.8〜1.6 倍のサイズ、6 種類の WebAudio 効果音、隅への収納とドラッグできるステータスボタン
位置・非表示状態・設定を `localStorage` に保存するミュートしていない限り合成音を再生するロケール・テーマ・省電力の挙動
DSH のロケールサービス、DSH のライト/ダークテーマ、ページの可視状態→DSH のロケールに追従する中国語/英語の文言、テーマに追従する吹き出しと影、ページがバックグラウンドにある間のアニメーション停止、`prefers-reduced-motion` 時の静的表示へのフォールバック
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 長い agent ターンを回すことが多く、トランスクリプトを眺める代わりに常時見える状態インジケーターが欲しい DSH ユーザー
- DSH のセッションを並行して開いておく人(この機能には DSH 0.1.7 以降が必要)
- harness をターミナルではなくデスクトップアプリのように感じたい人
不向きな用途
- プラグインは DSH `>=0.1.5-alpha.2 <0.3.0` に固定されており、いくつかの挙動はホストのバージョンに依存する——全セッションへの追従には DSH 0.1.7 が必要で、README には 1.1.0 が 0.1.5 で例外を投げたこと、1.1.2 が 0.1.7 でアイドルのままだったことが記録されている。
- インストールは一行で追加するのではなくプロファイルの編集:依存と `pet-whale` バンドルをプロファイルの `package.json` に追加し、そのディレクトリで `pnpm install` を実行して DSH を再起動する(デスクトップ版はトレイから終了する必要がある)。デスクトップと Web はそれぞれ別のプロファイルを持つため、編集はプロファイルごとに必要。
05互換性・メンテナンス・セキュリティ上の注意
- プラグインは DSH `>=0.1.5-alpha.2 <0.3.0` に固定されており、いくつかの挙動はホストのバージョンに依存する——全セッションへの追従には DSH 0.1.7 が必要で、README には 1.1.0 が 0.1.5 で例外を投げたこと、1.1.2 が 0.1.7 でアイドルのままだったことが記録されている。
- インストールは一行で追加するのではなくプロファイルの編集:依存と `pet-whale` バンドルをプロファイルの `package.json` に追加し、そのディレクトリで `pnpm install` を実行して DSH を再起動する(デスクトップ版はトレイから終了する必要がある)。デスクトップと Web はそれぞれ別のプロファイルを持つため、編集はプロファイルごとに必要。
- クジラの輪郭は DeepSeek 公式の FishLogo パスを使っており、README はこれを再利用時に出典明記が必要なブランド素材として扱っている。
- ホットリロードが効くのは、プロファイルがこのリポジトリを `link:` でインストールしていて DSH が `>=0.1.5-alpha.2` の場合のみ。`package.json` の構造、`cordis.patch.yml`、ホスト側、バンドルリストの変更には DSH の再起動が必要。
MIT · 最新リリース v1.2.7(2026-10-02)、README の記載のみ、安全性は未監査
06よくある質問
pet-whale を DeepSeek Harness に導入するには?
実際に使っている profile ディレクトリ(デスクトップと Web で別々、Web は通常 `~/.dsh/profiles/web`)の `package.json` を編集します。`dependencies` に `"pet-whale": "^1.2.7"` を追加し、`dsh.profile.bundles` の一覧に既存の項目と並べて `"pet-whale"` を追加します。そのディレクトリで `pnpm install` を実行し、DSH を再起動します。デスクトップ版はトレイから「終了」してから起動し直します。
package.json を編集せずに導入できますか?
ローカルのチェックアウトや git 導入なら可能です。ローカルディレクトリは `dsh plugin --profile web add link:/path/to/pet-whale`(リポジトリにビルド済みの `lib/` が含まれるためビルド不要)、git からは `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"` を使います。README のホットリロード手順が使えるのは `link:` の場合だけです。
対応する DSH のバージョンは?
DSH `>=0.1.5-alpha.2 <0.3.0` と Node.js `^22.19.0 || >=24.0.0` が必要です。一部の機能は新しいホストを要求し、「すべてのセッションを追従」は DSH 0.1.7 以降で動作します。README には 1.1.0 が 0.1.5 で例外を投げた例、1.1.2 が 0.1.7 で待機したままになった例も記録され、1.1.3 でメインビューが保持するセッションを読む方式に変更されて解消しています。
ペットは会話内容を読み取りますか?
アニメーションの判断のためにセッション状態を読みます。セッションスナップショット(`running`、`lastAgentError`)と chat 投影(`partial`、`runningCalls`、`turnEnds`)を使い、状態が `think` のときはモデルの直近約 200 文字の推論をクジラの上にゆっくりスクロール表示します(右クリックで切り替え)。描画はすべて DSH のページ内で完結し、位置・非表示状態・設定は `localStorage` に保存されます。
どのようなファイルを書き込みますか?音声ファイルは必要ですか?
素の DOM 実装で React もサードパーティのランタイム依存もなく、6 種類の効果音はすべて WebAudio で合成するため音声ファイルは同梱していません。クライアント側で保存するのは位置・サイズ・パレット・ミュート・非表示状態といった `localStorage` の設定だけです。
07関連する DSH ワークフロー
ds-harness-remote
by liguobao
DeepSeek Harnessのマルチデバイス遠隔アクセスプラグイン。低遅延・エンドツーエンド暗号化のP2P優先ネットワークで、PC・Android・WebからリモートのHarnessを安全に操作できます。
dsh-windows-mcp
by hellohub1212
CursorTouchとWindows-MCPをDSHにつなぐWindowsデスクトップ自動化ブリッジ。Computer Useは初期オフで、依存関係をアプリ内インストーラーから導入できます。
dsh-desktop
by anywhere-labs
DeepSeek Harness(dsh)プラグインエコシステム向けのモダンなデスクトップクライアント。すべてが「プラグイン」であり、デスクトップそのものもプラグインとして機能します。
dsh-go
by ccch1mneyyy
DeepSeek Harnessをスマートフォン上で動かし、外出先から自分のパソコンを遠隔操作できるツールです。
08データと出典
DeepSeek Harness(DSH)的桌宠插件,桌面端和网页端都能用:右下角一只**官方轮廓版小鲸鱼**,随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖,WebAudio 合成音效无音频文…
在你正在用的 profile 目录(桌面端和网页版各用各的 profile,网页版一般是 `~/.dsh/profiles/web`)的 `package.json` 里加上依赖和 bundle:
"dependencies": { "pet-whale": "^1.2.7" }, "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-13。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
