DeepSeek Harness ローカルプラグインの読み込み
前の記事DeepSeek Harness 最初のプラグインhello-plugin のソースコードを書いたので、次にそれを Web UI に読み込みます。
ここでは、patch オーバーレイの cordis.yml と --patch 起動パラメータの2つを使用します。
scratch-plugin ディレクトリ構造
以前 scratch-plugin/src を作成しましたが、次に cordis.yml を追加します。
一時プロジェクト全体の構造は次のとおりです:
scratch-plugin/ ├── src/ │ └── my-plugin.ts # 插件源码(上一篇写的 hello-plugin) └── cordis.yml # patch 覆盖层:告诉框架插入哪个插件
cordis.yml の insert
リポジトリのルートディレクトリで pwd を実行し、絶対パスを取得します。
次に scratch-plugin/cordis.yml を作成し、内容は次のとおりです:
例
# これは Web オーバーレイ(overlay)で、ローカルプラグインの挿入のみを担当します
- insert:
- id: hello
# name はプラグインファイルのパスです。絶対パスでなければなりません!
name: '/absolute/path/to/deepseek-harness/scratch-plugin/src/my-plugin.ts'
/absolute/path/to/deepseek-harness を pwd で出力された実際のパスに置き換えます。

プラグインのパスは絶対パスでなければなりません。
patch ファイルは設定にのみ寄与し、loader がモジュールパスを解決する際に使用する profile ディレクトリは変更しません。
--patch で起動
このオーバーレイで Web UI を起動します:
pnpm dsh web --patch ./scratch-plugin/cordis.yml
起動中、ターミナルに [hello-plugin] plugin loaded! が表示されます。

http://127.0.0.1:3080 を開き、設定のプラグインリストで hello を検索すると、インストールしたプラグインを確認できます。

動作原理
dsh は複数の設定ソースを順番に重ねて、最終的な設定を1つにまとめます。
--patch で渡される cordis.yml はオーバーレイであり、起動時に profile に重ねられます。
| 概念 | 何か | 役割 |
|---|---|---|
| profile | 起動可能な組み立て設定 | Web UI がどのバンドルで構成されるかを決定します |
| patch オーバーレイ | 起動時に追加で重ねられる yml | ローカルプラグインの挿入、特定設定の上書き |
| insert | patch 内でプラグインを挿入する構文 | name の絶対パスでプラグインを読み込む |
ヒント:--patch はローカル開発・デバッグに適しています。
プラグインを他の人に渡す場合は、バンドル(bundle)方式を使用します。第21篇を参照してください。