DeepSeek Harness: cargar complementos locales

Artículo anteriorDeepSeek Harness: el primer complementoHemos escrito el código fuente de hello-plugin; a continuación lo cargamos en la Web UI.

Aquí usaremos dos cosas: el patch overlay (capa de superposición) cordis.yml y el parámetro de inicio --patch.


Estructura de directorios de scratch-plugin

Antes creamos scratch-plugin/src; ahora añadimos un cordis.yml.

La estructura de todo el proyecto temporal es la siguiente:

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

Inserción de cordis.yml

Ejecuta pwd en el directorio raíz del repositorio para obtener la ruta absoluta.

Luego crea scratch-plugin/cordis.yml con el siguiente contenido:

Ejemplo

# Ruta del archivo: scratch-plugin/cordis.yml
# Esta es una capa de superposición (overlay) de Web, solo se encarga de insertar complementos locales
- insert
:
    - id
: hello
      # name es la ruta del archivo del complemento, ¡debe ser una ruta absoluta!
      name
: '/absolute/path/to/deepseek-harness/scratch-plugin/src/my-plugin.ts'

Reemplaza /absolute/path/to/deepseek-harness con la ruta real que imprime pwd.

La ruta del complemento debe ser una ruta absoluta.

El archivo patch solo contribuye con configuración; no cambia el directorio profile que usa el loader para resolver las rutas de los módulos.


Iniciar con --patch

Inicia la Web UI con esta superposición (overlay):

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

Durante el inicio, la terminal imprimirá [hello-plugin] plugin loaded!.

Abre http://127.0.0.1:3080, busca hello en la lista de complementos de configuración y podrás ver el complemento que instalamos.

patch 覆盖层加载流程


Cómo funciona

dsh superpone varias fuentes de configuración en orden para formar una configuración final.

El cordis.yml pasado mediante --patch es una superposición (overlay) que se agrega al profile al iniciar.

ConceptoQué esFunción
profileUna configuración ensamblada que puede iniciarseDetermina de qué paquetes (bundles) está compuesta la Web UI.
Superposición (overlay) de patchUn yml adicional que se superpone al iniciarInsertar complementos locales, sobrescribir una configuración
insertSintaxis para insertar complementos en el patchCargar complementos mediante la ruta absoluta de name

Consejo: --patch es adecuado para el desarrollo y la depuración local.

Cuando quieras entregar el complemento a otras personas, usa el método de paquete combinado (bundle); consulta el artículo 21.

Otras extensiones