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 を作成し、内容は次のとおりです:

例

# ファイルパス: 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 を検索すると、インストールしたプラグインを確認できます。

patch 覆盖层加载流程


動作原理

dsh は複数の設定ソースを順番に重ねて、最終的な設定を1つにまとめます。

--patch で渡される cordis.yml はオーバーレイであり、起動時に profile に重ねられます。

概念何か役割
profile起動可能な組み立て設定Web UI がどのバンドルで構成されるかを決定します
patch オーバーレイ起動時に追加で重ねられる ymlローカルプラグインの挿入、特定設定の上書き
insertpatch 内でプラグインを挿入する構文name の絶対パスでプラグインを読み込む

ヒント:--patch はローカル開発・デバッグに適しています。

プラグインを他の人に渡す場合は、バンドル(bundle)方式を使用します。第21篇を参照してください。

その他の拡張