メインコンテンツへ移動
AIチュートリアル

echocat-skill-panel 3.0でDSH Skillsを管理・追跡する

この記事では、echocat-skill-panel 3.0のインストール方法、各対話ターンで呼び出されたskillの追跡、複数のソースからのワンクリックインストール、すばやい呼び出し、中国語名の設定、安全なバックアップとアンインストールについて説明します。

約10分で読了
echocat-skill-panel 3.0の管理・追跡

プロジェクト概要

echocat-skill-panel 3.0 は、DSH Desktop Beta向けのcordisプラグインです。モデルからの自己申告に依存せず、セッションイベントストリームから各対話ターンで実際に使用されたskillを推定します。

skillがモデルによって自動的に呼び出された場合、ユーザーが/nameで手動呼び出しした場合、またはそのターンでまったく呼び出されなかった場合でも、プラグインは対応する結果を表示できます。

skillの統計・管理パネル

3つの画面の役割

プラグインの3つの入口は同じデータを共有しますが、用途に応じて使い分けられます。

  • 入力欄上部のバー：常に1行の結果を表示し、クリックするとその場で完全なレポートを展開します。skillのワンクリック呼び出しに対応する唯一の画面です。
  • 左バーのアイコン：常設の入口として機能し、クリックすると中央エリアにパネルを開きます。
  • 中央パネル：完全なレポートとskillカタログを確認できます。

プラグインをインストールする

方法1：GitHubのソースコードからインストール

完全なパッケージを取得できるため、ソースコードからのインストールを推奨します。PowerShellで次を実行します。

git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1"

インストールスクリプトは、profileリストのバックアップ、ミラー処理、古いパッケージ名の削除、リンクの作成、manifestの変更を順に実行し、pnpm installも実行します。

方法2：npmまたはDSHからインストール

プラグインはnpmに公開されており、パッケージ名はechocat-skill-panel-3.0です。DSHにインストールを任せることもできます。

dsh plugin --profile web add echocat-skill-panel-3.0

profileディレクトリに直接インストールすることもできます。

npm install echocat-skill-panel-3.0

@deepseek-ai/dsh-llmと@deepseek-ai/schemasteryはオプションのpeer dependenciesとして宣言されています。これらはDSHランタイムから提供されるため、npmがホスト側のバージョンを置き換える複製を追加でダウンロードすることはありません。

インストール完了後は、必ずDSH Desktop Betaを再起動してください。 host側のコードは起動時にメモリへ読み込まれるため、hostを変更した場合も再起動が必要です。クライアント側のコードだけを変更した場合は、ページを更新すればクライアントbundleを再取得できます。

ロールバックとインストールの安全性

ソースコードからのインストールスクリプトは、処理前にprofileリストをバックアップします。復元する場合は、スクリプトの-Rollbackパラメーターを使用できます。手動インストール、アンインストールのロールバック、アプリケーションを起動できなくする可能性のある厳格な制約については、リポジトリのインストール手順を参照してください。

skillをインストールする

プラグインのインストール画面を開くと、作成者が提供した完全なアドレスをそのまま貼り付けられます。リポジトリ、ブランチ、サブディレクトリを個別に入力する必要はありません。

skillのワンクリックインストール画面

たとえば、次のGitHubサブディレクトリのアドレスを貼り付けます。

https://github.com/owner/repo/tree/main/skills/my-skill

hostはアドレスの種類を認識して、クローンとダウンロードのどちらを行うべきかを判断し、リンクからブランチとサブディレクトリを解析します。プラグインがサポートする入力形式は次のとおりです。

  • GitHubリポジトリのトップページURL。
  • リポジトリ内のフォルダーリンク。
  • SKILL.mdファイルのリンク。
  • ZIPの直リンク。
  • owner/repo形式。
  • SSHアドレス。
  • ローカルの.mdまたは.zipファイルのアップロード。
  • 完全なSKILL.mdの内容を直接貼り付け。

対象の場所に同名のskillがすでに存在する場合、プラグインは黙って上書きせず、先にバックアップを作成してから置き換えます。skillを削除するときも、ファイルはバックアップディレクトリに移動され、完全に削除されることはありません。

各対話ターンで使用されたskillを確認する

通常どおりDSHで対話を開始してください。各ターンの終了後、プラグインはセッションイベントストリームに基づいてレポートを生成し、システム標準の通知を1回表示します。

  1. 対話を1ターン完了します。
  2. 入力欄上部のバーに表示された簡易結果を確認します。
  3. バーをクリックして、そのターンの完全なレポートを展開します。
  4. 左バーのアイコンから中央パネルを開き、レポートとskillカタログを確認することもできます。

この検出方法では、モデルが回答内で呼び出したものを申告する必要がありません。そのため、モデルが説明を忘れても、パネルはイベント記録に基づいて結果を表示できます。

skillをワンクリックで呼び出す

入力欄上部のバーは、ワンクリック呼び出しに対応する唯一の画面です。バーを展開し、対象のskillカードで呼び出しをクリックすると、プラグインが対応するジェスチャーを現在の下書きに追加します。

/名前

その後Enterキーを押して送信すると、手動ジェスチャーでskillを呼び出せます。skillのインストール完了後に表示される通知にも同じボタンがあるため、インストール直後に呼び出して使用できます。

中国語表示名を設定する

プラグインは、skill自身のmeta.yamlにあるdisplay-name-zhフィールドを使って中国語名を表示します。インストール時に入力することも、インストール完了後にskillカードから変更することもできます。

  • 中国語名を入力すると、パネルでは中国語表示が優先されます。
  • このフィールドを空欄にすると、中国語表示名を削除できます。
  • /名前の呼び出しジェスチャーはASCIIコードを使用し、中国語表示名の影響を受けません。

中国語名がないskillについては、プラグインが表示名を自動翻訳してキャッシュすることもできます。

高度な使用上のヒント

読み取り専用モードを理解する

ホスト環境で書き込みが許可されていない場合、プラグインは自動的に読み取り専用状態へ切り替わり、理由を表示します。この場合もレポートとカタログは確認できますが、インストール、変更、削除に関する操作はホストの権限による制限を受けます。

バックアップで誤操作を防ぐ

同名のskillを置き換える前には自動的にバックアップが作成され、削除操作でもファイルは完全には削除されません。skillをアップグレードする前や、入手元が不確かなskillを試す前に、必要に応じて戻せるよう、バックアップディレクトリとprofileリストのバックアップが利用可能であることを確認してください。

クライアントとhostの変更を区別する

クライアントbundleはページを開くと再取得されるため、クライアントだけを変更した場合は通常、ページの更新だけで済みます。host側の内容はDSHの起動時にメモリへ読み込まれるため、hostを変更した場合やプラグインのインストールを完了した場合は、DSH Desktop Betaを再起動してください。

ダークテーマとその他の設定を有効にする

プラグインは、ダークテーマ、各ターン終了後のシステム通知、自動翻訳キャッシュ、各種設定に対応しています。具体的なオプションとインストール制限についてはインストール手順を参照してください。

開発とビルド

src/client/を変更した場合は、クライアントのビルド成果物を再生成する必要があります。

node tools/build-client.mjs

lib/client.jsはリポジトリに必ずコミットする必要があるビルド成果物です。対象マシンにツールチェーンがない可能性があるためです。src/client/の変更は、再ビルドしたファイルと同じコミットに含めてください。そうしないと、verify-install.mjsによるbundleとパッケージの整合性チェックに失敗します。

プロジェクトの実行時に追加の依存関係はありません。2つのpeer dependenciesはいずれもhostから提供されます。アーキテクチャ設計、インストールエンジンの安全ルール、実装上の注意点、テストの詳細については設計のポイントを参照してください。

まとめ

echocat-skill-panel 3.0は、skillの呼び出し追跡、カタログ閲覧、インストール、呼び出し、中国語表示、安全なアンインストールをDSH Desktop Beta内に集約します。プラグインをインストールしてアプリケーションを再起動すれば、入力欄上部のバーから各ターンのレポートをすばやく確認し、呼び出しボタンで対象のskillを下書きに追加できます。プロジェクトはMITライセンスで提供されています。