MIT ライセンスの DSH デスクトップペット。Web 画面の隅で 9 種類の状態アニメーションを描画し、タスク完了時はシステム全体に効果音を再生。`cordis_define` で動的プラグインとしてインストールし、`src/host.js` 冒頭の CONFIG で調整する。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-08-27
ライセンス
MIT
01どんなタスクに使えるのか？
DeepSeek Harness の Web 画面右下に、Agent の作業状態に反応するデスクトップペットを配置する
9 種類の状態アニメーション（Codex スプライト契約・8×9 グリッド）を切り替えるペット。タスク完了時には「你干嘛~哎哟」の効果音をシステム全体に再生する
Agent の動きを映す楽しいビジュアルコンパニオンを求める DeepSeek Harness（DSH）ユーザー・開発者
Agent のライブ状態（作業中 / 思考中 / 待機中 / エラー / アイドル）をペットのアニメーションとして可視化する
agents サービスのポーリングと、tools/execute・approval/request・agent/request-error イベントから導出した 5 つのモードを、専用のスプライト行と吹き出し文言にマッピング
Agent が実行中・停滞中・完了のどれかをひと目で把握したい DSH ユーザー
DSH にインストールせずに全アニメーションをプレビューする
静的サーバーで配信されるスタンドアロンのデモページ（demo/index.html）。ドラッグ操作つきで 9 種類のアニメーションを確認できる
DSH へインストールする前にペットの見た目・操作感を確かめたいユーザー
02DeepSeek Harness への導入方法
前提条件
- 動的プラグインツールを備えた DeepSeek Harness（DSH）セッション——ペットは `cordis_define` でインストールし、`cordis_run` でアクティベートする
- src/host.js・src/client.js と assets/ のスプライト＋音声ファイルを含むローカルクローン（パスは CONFIG で編集）
- プラットフォームに合った再生コマンド——macOS はデフォルトで `afplay`、Windows / Linux は別のコマンドに変更が必要
インストール手順
- 01
リポジトリをクローン：`git clone https://github.com/liyupi/dsh-kun-like-pet.git`
$ git clone https://github.com/liyupi/dsh-kun-like-pet.git
- 02
`src/host.js` 冒頭の CONFIG でアセットパス（spritePath / voicePath / playCommand）を編集する
- 03
ワンクリックインストール用ペイロードを生成：`node scripts/build-kunpet-package.mjs -`
- 04
生成された JSON ペイロードを `cordis_define` ツールに貼り付ける（kind "new" で新規プラグイン作成、以降の更新は kind "existing" + pluginId）
- 05
`cordis_run` でアクティベートすると、Web 画面の右下にペットが表示される
導入成功の確認
- リポジトリ整合性チェックを実行：`node scripts/validate.mjs`
03DSH 統合と能力の範囲
DeepSeek Harness セッション内で DSH 動的プラグインとしてインストールされる。host 側が状態マシン・アセットルーティング・システム音声を担い、client 側は shell.overlay 経由で描画する。`cordis_define` / `cordis_run` ツールでアクティベート
9 状態のスプライトアニメーション描画
Agent の作業状態（running / thinking / waiting / error / idle、およびドラッグ / クリック / タスク完了）→Codex ペットスプライト契約（8 列 × 9 行、各セル 192×208）に従い、9 状態のアニメーションをスプライト行へマッピングして描画
タスク完了時のシステム全体サウンド
任意のウィンドウ・セッションで発生するタスク完了イベント→host プロセスがシステムコマンド経由で「你干嘛~哎哟」を再生——ブラウザのミュート状態に関係なくマシン全体で聞こえる
設定済みのシステムコマンドを使用して host プロセスから音声を再生するドラッグ・クリック操作
ペットへのマウスドラッグまたはクリック→ドラッグ方向に追従する走るアニメーション。クリックすると手を振る（2.4 秒の反応）
内蔵デバッグツール
kun_pet_debug ツールの呼び出し→状態マシンの内部カウンターとポーリング健全性をオンデマンドで表示
Agent 状態のライブポーリング
agents サービスを pollMs（デフォルト 500）間隔でポーリング。加えて tools/execute・approval/request・agent/request-error イベントを参照→ペットアニメーションを駆動する 5 つの派生モード（working / thinking / waiting / error / idle）
設定された間隔（デフォルト 500ms）で agents サービスをポーリングする
04誰に向いているのか？使うべきでない場面は？
向いている用途
- Agent の動きを映す楽しいビジュアルコンパニオンを求める DeepSeek Harness（DSH）ユーザー・開発者
- Agent が実行中・停滞中・完了のどれかをひと目で把握したい DSH ユーザー
- DSH へインストールする前にペットの見た目・操作感を確かめたいユーザー
不向きな用途
- 動的プラグインのためセッションに紐づく：ペット UI はアクティベートしたセッションのページにのみ注入される。全ウィンドウにペットを表示するには、host が合成するパッケージへアップグレードする必要がある。
- 同梱の音声はネット公開のミーム音声クリップ、スプライトはファンメイドのピクセルキャラクターであり、いずれも個人の学習・交流目的のみに限定される。商用利用は不可。商用用途では著作権フリーの素材に差し替えること。
05互換性・メンテナンス・セキュリティ上の注意
- 完了音は OS ごとに異なるシステム再生コマンドを使用する。macOS はデフォルトで `afplay`、Windows / Linux は CONFIG 内でそれぞれのコマンド（SoundPlayer / ffplay など）に変更する必要がある。
- 動的プラグインのためセッションに紐づく：ペット UI はアクティベートしたセッションのページにのみ注入される。全ウィンドウにペットを表示するには、host が合成するパッケージへアップグレードする必要がある。
- 同梱の音声はネット公開のミーム音声クリップ、スプライトはファンメイドのピクセルキャラクターであり、いずれも個人の学習・交流目的のみに限定される。商用利用は不可。商用用途では著作権フリーの素材に差し替えること。
- イベント待ち受けは当てにできない：一部のデプロイでは agent/status や agent/turn-stopping イベントが動的プラグインのバスを一切通らない（831 回のイベント観測で status 系は 0 件）。そのため agents サービスのポーリングを最も移植性の高い方式としている。
MIT · リリース未公開（リポジトリ作成 2026-08-14）
06よくある質問
このペットを DeepSeek Harness にインストールするには？
DSH 動的プラグイン（`cordis_define`）として開発・検証済みです。リポジトリをクローンし、`src/host.js` 冒頭の CONFIG で spritePath / voicePath / playCommand を編集し、`node scripts/build-kunpet-package.mjs -` でペイロードを生成して `cordis_define` ツールに貼り付け、`cordis_run` でアクティベートすると Web 画面の右下にペットが現れます。DSH セッション内で Agent に一連の流れを任せることもできます。
ペットが 1 つのウィンドウにしか表示されないのはなぜ？
動的プラグインはセッションに紐づくため、ペット UI はアクティベートしたセッションのページにのみ注入されます。一方 v5 以降、完了音は host プロセスがシステム全体に再生するため、タスクを完了したウィンドウ・セッションの音はマシンで鳴ります。全ウィンドウに表示するには、host が合成するプラグインパッケージへアップグレードする必要があります。
ポーリング間隔や音声はどこで調整できますか？
調整項目は `src/host.js` 冒頭の CONFIG に集約されています：spritePath、voicePath、playCommand に加え、pollMs（デフォルト 500）、celebrateMs（4800）、failedMs（2600）。
インストール前にアニメーションをプレビューできますか？
できます。`demo/index.html` を開けば（`npx serve .` や `python3 -m http.server` など静的サーバー推奨）、DSH なしで 9 種類のアニメーションを確認し、ドラッグ操作も試せます。
同梱の音声やスプライトを商用利用できますか？
できません。`assets/voice.mp3` はネット公開のミーム音声クリップ（著名人の声を含む）で、個人の学習用途のみです。商用利用は禁止、必要な場合は著作権フリーの素材に差し替えてください。スプライトシートもファンメイドのピクセルキャラクターです。
07関連する DSH ワークフロー
dsh-pet
by pc2005-cloud
DSH Web デスクトップペット：51 透明 webm アニメ、画面漫游、クリック/ドラッグ。プロンプト＋AI 動画で自作も可
dsh-tavern
by flizzywine
SillyTavern 風文字ゲーム Agent。候補生成、角色卡編集、剧本モード
dsh-dafeiyu
by qcytsn
DeepSeek Harness 向け Windows 常時最前面の BigFish デスクトップコンパニオン。リアルな Agent ステータス表示
whale-girl
by vlln
DSH Web デスクトップペット：右下に浮遊、ドラッグ・餌やり・遊びができ、資格を積み上げて成長する QQ ペット風コンパニオン
08データと出典
桌宠以 **DSH 动态插件** 形式开发并运行验证（`cordis_define`）。在 DSH 会话里让 Agent 执行，或手动调用 `cordis_define` 工具：
4. 用 `cordis_run` 激活，Web 界面右下角即出现桌宠。
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-27。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。