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 поэтапно каскадно добавляет.
Вопросы для самопроверки:
- Каков четырёхуровневый порядок загрузки действующей конфигурации?
- Когда патч переопределяет по id, почему нужно заново указывать все ключи?
dsh --profile demo --dump-configКакова его функция?