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 со следующим содержимым:
Пример
# Это веб-оверлей, отвечает только за вставку локальных плагинов.
- 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 в списке плагинов в настройках, и вы увидите установленный нами плагин.

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