PC2005-cloud/dsh-pet

dsh‑pet – DeepSeek Harness用「デスクトップペット」プラグイン

概要 – dsh-pet は、DeepSeek Harness (DSH) プラットフォーム（WebベースのAIチャット環境）用のプラグインです。このプラグインは、DSH UI上や独立した透明なデスクトップウィンドウに住む小さなアニメーションキャラクターを追加します。ペットはユーザーのクリック、ドラッグ、DSHの会話イベント、残高確認APIに反応し、小さなHTTP APIを通じてスクリプト制御することも可能です。

重要性 – AIモデルそのものではありませんが、生成AI駆動のアセット（手描きのアニメーションパックはAIプロンプトで生成）をインタラクティブなUIコンポーネントにパッケージ化する方法を示しています。また、以下の3つの段階を明確に分離しています。

1. プロンプトレシピ：AIでアニメーションアセットを生成。
2. アセット生成パイプライン：ソースビデオを透明なWebM/VP9‑Alphaクリップに変換。
3. DSHプラグイン：それらのアセットを消費し、インタラクティブなペットを提供。

主な機能（READMEより）

• 純粋なデスクトップペット体験 – 天気やシステム監視機能はありません。オプションモジュールとして、残高表示、「ささやき」、チャット、作業ステータス、システム通知があります。
• アニメーションチェーン – アイドル、回転、移動、分類されたアクションには重み付けがあり、次のアニメーションが自動的に選択され、シームレスなクロスフェードが行われます。
• イベント駆動型アニメーション – 残高、ささやき、作業ステータスにはそれぞれ専用のアニメーションセットがあり、特定のトリガーで実行されます。
• マルチインスタンスサポート – 複数のペットを同時に実行でき、それぞれ独立したサイズ、位置、設定を持たせることができます。
• 画面移動と物理演算 – ペットは画面内を歩き回り、表示領域から出ないようにし、ドラッグ＆スローの物理演算（弾性バウンス、摩擦など）に応答します。
• コンテキストメニュー – 右クリックで手動でアニメーションをトリガーしたり、URLを開いたり、残高を表示したり、設定をリロードしたりできます。
• デスクトップモード – ペットごとにElectronベースの透明ウィンドウを使用でき、ブラウザの外でペットを飼うことができます。
• ペットパック – pet/ 配下に ‑config.json と対応するアニメーションフォルダを置くことで、新しい種を追加できます。
• カスタムアニメーションインポート – main-animation/webm/ にVP9‑Alpha .webm ファイルをドロップしてライブラリを拡張できます。
• アクセシビリティ – prefers-reduced-motion を尊重し、バウンスやフェードイン効果をスキップします。
• 外部HTTP API – ローカルの認証不要エンドポイント (/dsh-pet-7340/*) を通じて、他のプラグインからペットに話しかけたり、特定のアニメーションを再生したり、状態を照会したりできます。OpenAPI仕様と小さなテスターUIが提供されています。
• スタンドアロンモード – DSHなしでペットを実行でき、同じUIと物理演算を提供しますが、機能は制限されます（残高、ささやき、チャット、システム通知は不可）。

インストールと使用方法

1. DSHランチャーと pnpm をインストールします (npm i -g @deepseek-ai/dsh pnpm)。
2. DSH CLI経由でプラグインを追加します：dsh plugin --profile desktop add dsh-pet（またはUIからインストール）。
3. DSHデスクトップまたはWebクライアントを再起動すると、右上にペットが表示されます。
4. 開発用には、リポジトリをクローンし、npm install && npm run build を実行してから、dsh plugin --profile desktop add file:<path> で追加します。

設定 – メイン設定は assets/config.jsonc にあります。ユーザーはDSH設定UIから編集するか、JSONCファイル ($DSH_HOME/dsh-pet/main-config.jsonc) を直接編集できます。このファイルで以下を制御します：

• pets 配列（ID、サイズ、位置、表示モード、残高トグル）
• animations と animationWeights
• 残高、ささやきなどの更新間隔
• notificationsEnabled などのグローバルスイッチ

サポートプラットフォーム – Windows、macOS、Linux（ブラウザオーバーレイとElectronデスクトップの両方）。Safariは透明WebMをサポートしていないため、.mov のフォールバックが文書化されています。

全体的な印象 – dsh-pet は、DeepSeek Harness UIを遊び心のある拡張可能なデスクトップペット環境に変える、文書化された機能豊富なプラグインです。AI駆動プラットフォームと密接に結合された本格的なソフトウェアプロジェクトであり、AI強化UI拡張、プラグインエコシステム、インタラクティブな視覚エージェントに関心のある読者にとって価値があります。

---

クイックリファレンス

• リポジトリ：https://github.com/PC2005-cloud/dsh-pet
• npm：dsh-pet
• ライセンス：(バッジ参照) – おそらくオープンソースライセンス。
• メイン言語：TypeScript/JavaScript。
• ターゲット読者：視覚的なコンパニオンを求めるDeepSeek Harnessユーザー、およびカスタムAI生成アニメーションパックを構築したい開発者。

---

上記の詳細はすべてREADMEから直接引用したものであり、外部からの推測は含まれていません。