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
# 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.

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.
| Concepto | Qué es | Función |
|---|---|---|
| profile | Una configuración ensamblada que puede iniciarse | Determina de qué paquetes (bundles) está compuesta la Web UI. |
| Superposición (overlay) de patch | Un yml adicional que se superpone al iniciar | Insertar complementos locales, sobrescribir una configuración |
| insert | Sintaxis para insertar complementos en el patch | Cargar 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.