DeepSeek Harness загружает локальные плагины

Предыдущая статьяПервый плагин DeepSeek HarnessМы написали исходный код для hello-plugin; далее мы загрузим его в веб-интерфейс.

Здесь мы будем использовать две вещи: патч-оверлей cordis.yml и параметр запуска --patch.


Структура каталога scratch-plugin

Ранее мы создали scratch-plugin/src, теперь добавим cordis.yml.

Структура всего временного проекта выглядит так:

scratch-plugin/
├── src/
│   └── my-plugin.ts    # 插件源码(上一篇写的 hello-plugin)
└── cordis.yml          # patch 覆盖层:告诉框架插入哪个插件

вставьте в cordis.yml

Выполните `pwd` в корне репозитория, чтобы получить абсолютный путь.

Затем создайте scratch-plugin/cordis.yml со следующим содержимым:

Пример

# Путь к файлу: scratch-plugin/cordis.yml
# Это веб-оверлей, отвечает только за вставку локальных плагинов.
- insert
:
    - id
: hello
      # name — это путь к файлу плагина, должен быть абсолютным путём!
      name
: '/absolute/path/to/deepseek-harness/scratch-plugin/src/my-plugin.ts'

Замените /absolute/path/to/deepseek-harness на фактический путь, выведенный pwd.

Путь к плагину должен быть абсолютным путём.

Файлы патчей только предоставляют конфигурацию; они не изменяют каталог профиля, используемый загрузчиком при разрешении путей модулей.


Запустите с --patch

Запустите веб-интерфейс с этим оверлеем:

pnpm dsh web --patch ./scratch-plugin/cordis.yml

Во время запуска терминал выведет [hello-plugin] plugin loaded!.

Откройте http://127.0.0.1:3080, найдите hello в списке плагинов в настройках, и вы увидите установленный нами плагин.

patch 覆盖层加载流程


Как это работает

dsh послойно объединяет несколько источников конфигурации по порядку в одну итоговую конфигурацию.

cordis.yml, переданный через --patch, является оверлеем, который объединяется с профилем при запуске.

КонцепцииЧто этоФункция
profileКонфигурация запускаемой сборкиОпределите, из каких бандлов состоит веб-интерфейс.
патч-оверлейДополнительный yml, накладываемый при запускеВставка локальных плагинов и переопределение элемента конфигурации
insertСинтаксис вставки плагинов в патчЗагрузка плагинов по абсолютному пути через `name`.

Совет: --patch подходит для локальной разработки и отладки.

Когда нужно передать плагин другим, используйте подход с бандлом; см. статью 21.

Другие расширения