DeepSeek Harness: установка плагинов и порядок загрузки конфигурации

В предыдущей главе был создан бандл hello-plugin; в этой он устанавливается в профиль.

Шаги установки вDeepSeek Harness: комбинированный бандл и профиль: два манифестаДействуйте на основе этого; можете сначала просмотреть два манифеста из той статьи.

В этой главе также будет дан ответ на ключевой вопрос: когда конфигурации из нескольких бандлов накладываются друг на друга, какая из них переопределяет какую.

Это определяется порядком загрузки действующей конфигурации.


Порядок загрузки: слоистость действующей конфигурации

Действующая конфигурация составляется слой за слоем в фиксированном порядке поверх пустого корня, и слои, применённые позже, побеждают построчно.

配置加载顺序层次图

Полный порядок выглядит следующим образом.

ПоследовательностьслойОписание
1профиляdsh.profile.bundlesСписокПатчи каждого бандла следуют порядку списка: сначала dsh-base, затем каждый установленный бандл в порядке его добавления.
2собственный профиляcordis.patch.ymlСлой патчей уровня пользовательского профиля
3уровень домашнего каталога$DSH_HOME/cordis.patch.ymlЛокальные для машины настройки, общие для всех профилей.
4каждый--patch <path> overlayВ порядке argv

Параметры приложения — это не ещё один слой патчей.

Бандлы верхнего уровня могут разрешать их через собственные обычные сервисы приложения.

Слои, применённые позже, имеют приоритет построчно, а патч заменяет всё значение конфигурации целевой строки, а не выполняет глубокое слияние отдельных ключей.


Практика: установите hello-plugin в профиль

dsh plugin --profile <name> <args...>Перенаправляются в pnpm внутри каталога профиля, поэтому доступны все подкоманды pnpm.

В каталоге, содержащем hello-plugin, установите локальную копию этого пакета.

dsh plugin --profile demo add ./hello-plugin

При первом использовании профиль инициализируется.

@deepseek-ai/dsh-baseОн станет его первым составным пакетом.

pnpm связывает локальную копию, а также dsh, потому что этот пакет объявляетdsh.bundle, добавьте его вdsh.profile.bundles。

package.json сгенерированного профиля примерно выглядит так.

Пример

{
  "name": "dsh-profile-demo",
  "private": true,
  "dependencies": {
    "dsh-hello-plugin": "link:/path/to/hello-plugin"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "dsh-hello-plugin"
      ]
    }
  }
}

Значение каждого поля следующее.

FieldsОписание
nameИмя пакета профиля в форматеdsh-profile-demo
privateПрофиль используется только на этой машине и не публикуется.
dependenciesВнешние (out-of-tree) зависимости плагинов связываются с локальной рабочей копией через pnpm.
dsh.profile.bundlesУпорядоченный список бандлов; порядок загрузки здесь соответствует порядку массива.

Сначала не запускайте его; только проверьте слой, затем запустите.

dsh --profile demo --dump-config   # 会显示一个 "# == dsh-hello-plugin" 层
dsh --profile demo

--dump-configОн выводит наложенную эффективную конфигурацию, чтобы проверить, из какого бандла берётся каждый слой.

Должно быть видно в выводе# == dsh-hello-pluginмаркеры слоёв, подобные этому.

Удаление плагина так же просто.

dsh plugin --profile demo remove dsh-hello-plugin   # 同时移除依赖和对应的层

Патч заменяет целые строки по id

Патч — это не глубокое слияние; вместо этогоidон заменяет всё значение конфигурации целевой строки целиком.

Это влечёт два следствия для авторов составных пакетов.

Метод слиянияПоведениеВыбор dsh
Глубокое слияниеТолько изменённые ключи перезаписываются; остальные ключи сохраняются.Не так
Заменить всю строкуЧтобы заменить значение конфигурации по id на уровне всей строки, нужно заново указать все ключи.dsh использует

Во-первых, ваш патч может переопределять строки из более ранних слоёв по id.

Так же, какdsh-web-appПокрытие бандлаdsh-baseкак та строка.

Но вы должны заново указать каждый ключ, который требует строка, а не только тот, который вы изменили.

Во-вторых, пользователи могут в своём собственном профилеcordis.patch.ymlпереопределить ваши строки в нём, без необходимости изменять ваш пакет.

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

Имена встроенных составных пакетов всегда разрешаются из самого каталога установки dsh.

pnpm управляет только пакетами вне дерева, поэтому ваш бандл может безопасно от него зависеть.@deepseek-ai/dsh-baseСуществует и остаётся согласованным с установкой.


Итог и самопроверка

Установка плагина — это добавление в список bundles профиля записи, которая объявляетdsh.bundleofPackage, эффективная Configuration согласно последовательности bundles → profile patch → home patch → --patch overlay поэтапно каскадно добавляет.

Вопросы для самопроверки:

  1. Каков четырёхуровневый порядок загрузки действующей конфигурации?
  2. Когда патч переопределяет по id, почему нужно заново указывать все ключи?
  3. dsh --profile demo --dump-configКакова его функция?
Другие расширения