DeepSeek Harness : installation des plugins et ordre de chargement de la configuration

Le chapitre précédent a créé le bundle hello-plugin ; celui-ci l’installe dans un profil.

Étapes d’installation dansBundle de combinaison et profil DeepSeek Harness : deux manifestesProcédez sur cette base ; vous pouvez d’abord consulter les deux manifestes de cet article.

Ce chapitre répondra aussi à une question clé : lorsque les configurations de plusieurs bundles sont superposées, laquelle écrase laquelle.

Cela est déterminé par l’ordre de chargement de la configuration effective.


Ordre de chargement : superposition de la configuration effective

La configuration effective est composée couche par couche dans un ordre fixe au-dessus d’une racine vide, et les couches appliquées plus tard l’emportent ligne par ligne.

配置加载顺序层次图

L’ordre complet est le suivant.

SéquencecoucheDescription
1du profildsh.profile.bundlesListeLes correctifs de chaque bundle suivent l'ordre de la liste : d'abord dsh-base, puis chaque bundle installé dans l'ordre dans lequel il a été ajouté.
2propre au profilcordis.patch.ymlCouche de correctifs au niveau du profil utilisateur
3au niveau du répertoire home$DSH_HOME/cordis.patch.ymlPréférences locales à la machine partagées par tous les profils.
4chaque--patch <path> overlayDans l'ordre d'argv

Les paramètres d'application ne sont pas une autre couche de correctifs.

Les bundles de premier niveau peuvent les résoudre via les services ordinaires propres à l'application.

Les couches appliquées ultérieurement l'emportent ligne par ligne, et un correctif remplace la valeur de configuration entière de la ligne cible plutôt que de fusionner en profondeur les clés individuelles.


Exercice pratique : installer hello-plugin dans le profil

dsh plugin --profile <name> <args...>Transmis à pnpm dans le répertoire du profil, donc toutes les sous-commandes pnpm sont disponibles.

Dans un répertoire contenant hello-plugin, installez une copie locale de ce paquet.

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

La première utilisation initialise le profil.

@deepseek-ai/dsh-baseIl deviendra son premier paquet composite.

pnpm lie le checkout, et dsh, car ce paquet déclaredsh.bundle, ajoutez-le àdsh.profile.bundles。

Le package.json du profil généré est à peu près le suivant.

Exemple

{
  "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"
      ]
    }
  }
}

La signification de chaque champ est la suivante.

FieldsDescription
nameLe nom du paquet du profil, sous la formedsh-profile-demo
privateLe profil est utilisé uniquement sur cette machine et n'est pas publié.
dependenciesLes dépendances de plugins hors arborescence sont liées au checkout local par pnpm.
dsh.profile.bundlesUne liste ordonnée de bundles ; l'ordre de chargement correspond ici à l'ordre du tableau.

D'abord, ne le démarrez pas ; validez uniquement la couche, puis démarrez-le.

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

--dump-configIl affiche la configuration effective superposée, pour vérifier de quel bundle provient chaque couche.

Cela devrait être visible dans la sortie# == dsh-hello-pluginDes marqueurs de couche comme ceci.

La suppression d'un plugin est tout aussi simple.

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

Un patch remplace des lignes entières par id

Un patch n'est pas une fusion profonde ; au lieu de cela,idil remplace toute la valeur de configuration de la ligne cible comme une ligne entière.

Cela entraîne deux implications pour les auteurs de paquets composites.

Méthode de fusionComportementChoix de dsh
Fusion profondeSeules les clés modifiées sont écrasées ; les autres clés sont automatiquement préservées.Ce n'est pas le cas
Remplacer toute la lignePour remplacer une valeur de configuration par id au niveau d'une ligne entière, vous devez répéter toutes les clés.dsh utilise

Tout d’abord, votre patch peut remplacer les lignes des couches précédentes par id.

Tout commedsh-web-appCouverture du bundledsh-basecomme cette ligne.

Mais vous devez redéclarer chaque clé que la ligne exige, pas seulement celle que vous avez modifiée.

Deuxièmement, les utilisateurs peuvent, dans leur propre profilcordis.patch.ymlremplacer vos lignes dans celui-ci, sans avoir besoin de modifier votre package.

Par conséquent, privilégiez les valeurs par défaut de configuration que les utilisateurs sont susceptibles de conserver, et laissez le reste au schéma.

Les noms de paquets composites intégrés sont toujours résolus depuis le répertoire d’installation de dsh lui-même.

pnpm ne gère que les paquets hors arborescence, donc votre bundle peut en dépendre en toute sécurité.@deepseek-ai/dsh-baseExiste et reste cohérent avec l’installation.


Résumé et auto-test

Installer un plugin revient à ajouter à la liste de bundles du profil une entrée qui déclaredsh.bundleofPackage, la configuration effective s’applique selon la séquence bundles → profile patch → home patch → --patch overlay, puis ajout en cascade.

Questions d'auto-évaluation :

  1. Quel est l’ordre de chargement en quatre couches de la configuration effective ?
  2. Lorsqu'un patch remplace par id, pourquoi toutes les clés doivent-elles être redéclarées ?
  3. dsh --profile demo --dump-configQuelle est sa fonction ?
autres extensions