dsh-test-drive 0.3.24 → 0.3.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +548 -0
  4. package/README.es.md +548 -0
  5. package/README.hi.md +548 -0
  6. package/README.md +337 -229
  7. package/README.pt.md +548 -0
  8. package/SECURITY.md +0 -0
  9. package/THIRD_PARTY_NOTICES.md +0 -0
  10. package/cordis.patch.yml +0 -0
  11. package/lib/index.js +16 -31
  12. package/lib/types/batch.d.ts +0 -0
  13. package/lib/types/batch.d.ts.map +0 -0
  14. package/lib/types/capability.d.ts +0 -0
  15. package/lib/types/capability.d.ts.map +0 -0
  16. package/lib/types/command.d.ts +0 -0
  17. package/lib/types/command.d.ts.map +0 -0
  18. package/lib/types/config.d.ts +0 -0
  19. package/lib/types/config.d.ts.map +0 -0
  20. package/lib/types/domain.d.ts +0 -0
  21. package/lib/types/domain.d.ts.map +0 -0
  22. package/lib/types/drive.d.ts +0 -0
  23. package/lib/types/drive.d.ts.map +0 -0
  24. package/lib/types/driver.d.ts +0 -0
  25. package/lib/types/driver.d.ts.map +0 -0
  26. package/lib/types/index.d.ts +0 -0
  27. package/lib/types/index.d.ts.map +0 -0
  28. package/lib/types/report.d.ts +0 -0
  29. package/lib/types/report.d.ts.map +0 -0
  30. package/lib/types/result.d.ts +0 -0
  31. package/lib/types/result.d.ts.map +0 -0
  32. package/lib/types/sanitize.d.ts +0 -0
  33. package/lib/types/sanitize.d.ts.map +0 -0
  34. package/lib/types/session-log.d.ts +0 -0
  35. package/lib/types/session-log.d.ts.map +0 -0
  36. package/lib/types/tools.d.ts +0 -0
  37. package/lib/types/tools.d.ts.map +0 -0
  38. package/lib/types/version.d.ts +1 -1
  39. package/lib/types/version.d.ts.map +0 -0
  40. package/lib/types/workspace.d.ts +0 -0
  41. package/lib/types/workspace.d.ts.map +0 -0
  42. package/package.json +64 -38
  43. package/README-es.md +0 -418
  44. package/README-hi.md +0 -418
  45. package/README-pt.md +0 -418
  46. package/README-zh.md +0 -417
package/README.es.md ADDED
@@ -0,0 +1,548 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-test-drive-hero-en-light.webp" width="100%" alt="dsh-test-drive: a la izquierda el nombre del plugin y dos frases de valor; a la derecha el recibo de una prueba real — objetivo dsh-click, id de ejecución tdr_0b9b…, las seis etapas con su estado y duración, la franja de aislamiento (DSH_HOME, directorio de trabajo y pnpm store desechables; el perfil anfitrión con 0 lecturas y 0 escrituras) y la línea de veredicto con el registro dsh-test-drive/v1">
6
+ </picture>
7
+
8
+ # dsh-test-drive
9
+
10
+ **Instalar, arrancar, verificar, desinstalar y limpiar dentro de un perfil desechable: convierte «¿esto siquiera arranca?» en un pipeline reproducible.**
11
+
12
+ Pruebas de instalación y arranque aisladas para plugins de DeepSeek Harness: cada objetivo recibe su propia raíz `mkdtemp` (un `DSH_HOME` desechable, un directorio de trabajo desechable y un pnpm store redirigido), tu `~/.dsh` real nunca se lee ni se escribe, y el resultado es un registro estructurado que las herramientas posteriores pueden consumir.
13
+
14
+ [Instalar](#instalación-en-tres-pasos) · [Configuración](#configuración) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
+
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.1%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#compatibilidad)
18
+ [![npm](https://img.shields.io/npm/v/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#compatibilidad)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-test-drive?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-test-drive?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-test-drive?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-test-drive/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-test-drive
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>Plugin de la comunidad, no afiliado a DeepSeek. Repositorio canónico: <https://github.com/PerryLink/dsh-test-drive> (Gitee es un espejo).</sub>
36
+
37
+ ## Qué es
38
+
39
+ `dsh-test-drive` convierte «¿este plugin se instala y arranca?» en un pipeline de seis etapas: `dsh plugin add` dentro de un `DSH_HOME` desechable → `--dump-config` para demostrar que la capa de patch del bundle sí surtió efecto → un arranque headless que busca marcadores de fallo del loader → una aserción de capacidad opcional (llevar al agente a invocar una herramienta o un comando concreto y comprobar que el registro de sesión durable anotó la invocación y que la salida observada contiene el literal esperado) → `dsh plugin remove` → limpieza de las raíces temporales que el plugin posee mediante la escalera dry-run → renombrado a cuarentena → borrado. Cada etapa lleva estado, código de salida, duración y una cola de salida saneada, y la ejecución completa es un único registro `schema: "dsh-test-drive/v1"`: `test_drive` para un objetivo, `/testdrive` para un lote y `drive_report` para releer resultados.
40
+
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-test-drive-flow-v5-light.svg" width="100%" alt="Estructura de dsh-test-drive: una raíz temporal propia dibujada como sala limpia — dentro están las tres subraíces desechables (home/, workspace/, pnpm-store/) y la columna vertical de cinco etapas install → config → smoke → capability → uninstall; en el suelo está el desagüe finally (plan dry-run → renombrado a cuarentena → reintentos de borrado) por el que pasan pass, fail, tiempo agotado y aborto. Fuera, a la izquierda, las tres superficies de entrada, los tipos de objetivo y el perfil anfitrión que nunca se abre; a la derecha, el registro dsh-test-drive/v1, las reglas de veredicto ordenadas y la matriz de lote de /testdrive">
44
+ </picture>
45
+
46
+ ## Instalación en tres pasos
47
+
48
+ 1. **Instalar** (dos canales):
49
+
50
+ ```sh
51
+ # canal npm (versiones publicadas; los paquetes precompilados no necesitan permiso de build)
52
+ dsh plugin --profile web add dsh-test-drive
53
+ # canal git (main más reciente; equivale a git+https://github.com/PerryLink/dsh-test-drive.git)
54
+ dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
55
+ ```
56
+
57
+ El primer `add` por el canal git falla porque pnpm bloquea el build `prepare` del paquete; copia la clave exacta que imprimió pnpm en el `pnpm-workspace.yaml` del perfil y vuelve a ejecutar:
58
+
59
+ ```yaml
60
+ allowBuilds:
61
+ 'dsh-test-drive': true
62
+ ```
63
+
64
+ Los paquetes npm precompilados no necesitan permiso de build. Reinicia el perfil y usa `test_drive` / `/testdrive` desde una sesión.
65
+
66
+ 2. **Configuración mínima** (los valores por defecto ya funcionan; solo la etapa de capacidad necesita `capability.*` y `forwardEnv`):
67
+
68
+ ```yaml
69
+ - insert:
70
+ - id: test-drive
71
+ name: dsh-test-drive
72
+ config:
73
+ headlessTask: "Reply with exactly: ok"
74
+ forwardEnv: [DEEPSEEK_API_KEY]
75
+ capability:
76
+ enabled: true
77
+ kind: tool
78
+ name: plugin_vet
79
+ args: '{}'
80
+ expect: pass
81
+ ```
82
+
83
+ 3. **Verificar que surtió efecto** (tras reiniciar):
84
+
85
+ ```sh
86
+ dsh --profile web --dump-config | grep -A3 'id: test-drive'
87
+ ```
88
+
89
+ Después lanza una primera prueba contra un objetivo conocido:
90
+
91
+ ```text
92
+ test_drive({ target: "dsh-click" })
93
+ → verdict pass · tdr_0b9b6e6a61e3e80cc4620f2e · registro completo en «Ejemplos»
94
+ ```
95
+
96
+ **Desinstalar**: `dsh plugin --profile web remove dsh-test-drive` (o borra la línea del patch del perfil).
97
+
98
+ > `test_drive` necesita un CLI `dsh` capaz de arrancar un **segundo** proceso DSH headless. El launcher de DSH Desktop (`dsh.CMD`) solo permite `dsh plugin …`, `--dump-config` y `--version`, y rechaza por política un segundo arranque headless: el error ahora lo dice explícitamente en lugar de «cannot parse npm shim». Apunta `config.dshBin` a un CLI `dsh` instalado con npm/pnpm, o a un Node normal con la entrada JS de dsh.
99
+
100
+ <details>
101
+ <summary>Instalar desde el mercado de DSH Desktop</summary>
102
+
103
+ Todos los plugins de PerryLink están en el mercado integrado de DSH Desktop: **Mercado → Fuentes → Añadir fuente → pegar** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ seleccionar**. La instalación sigue pasando por la verificación de identidad npm del mercado y tu confirmación.
104
+
105
+ </details>
106
+
107
+ ## Capacidades clave
108
+
109
+ `dsh-test-drive` divide «verificar esta instalación» en etapas observables y reproducibles:
110
+
111
+ - **Herramienta `test_drive`** — ejecuta el pipeline completo para un objetivo y devuelve el registro estructurado de forma síncrona; con `background: true` arranca un trabajo `drive-batch` y devuelve `{ kind: 'background', jobId }`.
112
+ - **Comando `/testdrive <objetivos...>`** — recibe una lista separada por espacios o comas, la ejecuta como un único trabajo `drive-batch` en segundo plano, transmite el progreso por la salida del trabajo y termina con un informe matricial (JSON + Markdown) cuya última línea nombra el id de la matriz.
113
+ - **Herramienta `drive_report`** — recupera cualquier ejecución guardada (`tdr_...`), una matriz (`tdm_...`) o, sin id, la última matriz, y la renderiza en Markdown.
114
+ - **Aserción de capacidad** — más allá de «arrancó y salió»: la etapa opcional `capability` lleva al agente a invocar una herramienta concreta (`kind: tool`) o ejecutar `/comando` (`kind: command`) con `args`, y verifica que el registro de sesión durable anotó la invocación y que la salida observada contiene `expect`. Un arranque limpio solo es un smoke test; `observed` demuestra que una capacidad concreta funciona de verdad.
115
+ - **Resultados estructurados** — cada registro lleva el discriminador `schema: "dsh-test-drive/v1"` con campos de primer nivel: `stages.install.status`, `stages.smoke.status`, `stages.capability.status`, `durationMs` por etapa, `summary` / `outputTail` saneados y un `verdict` global (`pass` / `fail` / `partial` / `unknown`). Es el contrato legible por máquina que consumen los puntuadores posteriores (dsh-score).
116
+ - **Seguridad por construcción** — cada directorio temporal lo crea este plugin con el prefijo propio `dsh-test-drive-`, queda registrado en un registro de propiedad en vivo y solo se elimina mediante la escalera dry-run → renombrado a cuarentena → borrado. El perfil anfitrión nunca se lee ni se escribe.
117
+
118
+ ```text
119
+ objetivo ──dsh plugin add──▶ DSH_HOME desechable ──--dump-config──▶ capa de patch
120
+ │ │
121
+ ├──headless boot──▶ escaneo de marcadores FAILED
122
+ ├──capability────▶ tool/command + registro de sesión
123
+ └──dsh plugin remove──▶ cuarentena → borrado
124
+ ```
125
+
126
+ ### Superficie de herramientas
127
+
128
+ | Superficie | Forma | Devuelve / notas |
129
+ |---|---|---|
130
+ | `test_drive` | herramienta | el registro estructurado completo (síncrono), o `{ kind: 'background', jobId }` |
131
+ | `/testdrive` | comando | un trabajo `drive-batch`; la última línea nombra el id de la matriz para `drive_report` |
132
+ | `drive_report` | herramienta | una ejecución `tdr_...`, una matriz `tdm_...` o la última matriz, en Markdown |
133
+
134
+ El `target` de `test_drive` acepta una especificación git (`github:owner/repo#sha`, `git+https://...`), un nombre de paquete npm, una ruta local o un tarball `.tgz`; `capability` tiene la forma `{ kind: 'tool' | 'command', name, args, expect }` y necesita `DEEPSEEK_API_KEY` (entorno anfitrión o `forwardEnv`): sin ella la etapa queda `skipped`, nunca fallida.
135
+
136
+ ### Resultado estructurado
137
+
138
+ Reglas del veredicto: fallo de instalación, fallo de arranque (`smoke.fail`) o una etapa de capacidad que llegó a `not-registered` / `failed` ⇒ `fail`; instalación correcta + patch efectivo + arranque limpio (`pass` / `boot-ok`) + desinstalación correcta ⇒ `pass` (con una nota cuando la etapa de capacidad llegó a `observed`); algo instalado pero sin la garantía posterior ⇒ `partial`; en cualquier otro caso ⇒ `unknown`.
139
+
140
+ <details>
141
+ <summary>Ejemplo de registro completo (dsh-test-drive/v1)</summary>
142
+
143
+ ```json
144
+ {
145
+ "schema": "dsh-test-drive/v1",
146
+ "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
147
+ "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
148
+ "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.13",
149
+ "platform": "win32", "node": "v22.22.3" },
150
+ "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
151
+ "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
152
+ "hasBundleManifest": true } },
153
+ "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
154
+ "hostHomeTouched": false },
155
+ "stages": {
156
+ "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
157
+ "summary": "install ok after allowBuilds allowance", "outputTail": "",
158
+ "allowBuildsNeeded": true },
159
+ "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
160
+ "summary": "dump ok (exit 0)", "outputTail": "",
161
+ "patchEffective": true, "layers": ["dsh-click"] },
162
+ "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
163
+ "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
164
+ "outputTail": "", "bootFailed": false, "taskCompleted": false },
165
+ "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
166
+ "summary": "tool \"plugin_vet\" called and its result contains the expectation",
167
+ "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
168
+ "expectMatched": true,
169
+ "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
170
+ "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
171
+ "summary": "remove ok (exit 0)", "outputTail": "" },
172
+ "cleanup": { "status": "pass", "quarantined": true, "removed": true,
173
+ "summary": "owned temp root quarantined and removed" }
174
+ },
175
+ "verdict": "pass",
176
+ "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
177
+ }
178
+ ```
179
+
180
+ </details>
181
+
182
+ ### Ejemplos
183
+
184
+ Estos son los puntos de entrada reales del plugin; instálalo una vez y llama a uno.
185
+
186
+ **Ejemplo detallado** — comando `test_drive`, entrada:
187
+
188
+ ```sh
189
+ test_drive({ target: "dsh-click" })
190
+ ```
191
+
192
+ Salida:
193
+
194
+ ```text
195
+ # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
196
+
197
+ - Target: `dsh-click` (npm)
198
+ - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
199
+ - Installed: dsh-click@0.2.0
200
+ - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
201
+
202
+ | Stage | Result | Exit | Duration | Summary |
203
+ |---|---|---|---|---|
204
+ | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
205
+ | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
206
+ | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
207
+ | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
208
+ | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
209
+ | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
210
+ ```
211
+
212
+ *Observed from `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
213
+
214
+ **Rama de fallo** — entrada:
215
+
216
+ ```text
217
+ {"target":" "}
218
+ ```
219
+
220
+ Salida:
221
+
222
+ ```text
223
+ isError=true; error.message=dsh-test-drive: target must be a non-empty string
224
+ ```
225
+
226
+ *Observed from `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
227
+
228
+ **Ejemplos breves**: `test_drive` · `/testdrive` · `drive_report`
229
+
230
+ ## Configuración
231
+
232
+ Todas las claves son opcionales (se muestran los valores por defecto); los valores inválidos fallan ruidosamente en la carga. `cordis.patch.yml` documenta cada clave en línea.
233
+
234
+ Claves más usadas:
235
+
236
+ | Clave | Valor por defecto | Descripción |
237
+ |---|---|---|
238
+ | `profileName` | `headless` | Plantilla de perfil inicializada dentro de cada DSH_HOME desechable (bundles base + headless). |
239
+ | `dshBin` | `""` | Ruta absoluta del ejecutable `dsh`; vacío autodetecta el PATH (en Windows se parsea el shim `.cmd`/`.bat` de npm). |
240
+ | `headlessTask` | `"Reply with exactly: ok"` | Tarea única de la etapa de arranque; vacío omite la etapa. |
241
+ | `forwardEnv` | `[]` | NOMBRES de variables de entorno (nunca valores) reenviadas a los procesos hijos del perfil de prueba; los valores nunca se registran. |
242
+ | `allowBuilds` | `true` | Permite en el perfil de prueba un build `prepare` de git bloqueado y reintenta la instalación una vez. |
243
+ | `capability.enabled` | `false` | Ejecuta la etapa de aserción de capacidad (registrada → invocada → observada). |
244
+ | `capability.expect` | `""` | Literal esperado en la salida observada (subcadena sin distinguir mayúsculas). |
245
+ | `keepTempDirs` | `false` | Conserva los directorios temporales al fallar para forense (se abandona la propiedad; limpias tú). |
246
+
247
+ <details>
248
+ <summary>Tabla de configuración completa (19 claves)</summary>
249
+
250
+ | Clave | Valor por defecto | Descripción |
251
+ |---|---|---|
252
+ | `profileName` | `headless` | Plantilla de perfil inicializada dentro de cada DSH_HOME desechable (bundles base + headless). |
253
+ | `dshBin` | `""` | Ruta absoluta del ejecutable `dsh`; vacío autodetecta el PATH (en Windows se parsea el shim `.cmd`/`.bat` de npm). |
254
+ | `headlessTask` | `"Reply with exactly: ok"` | Tarea única de la etapa de arranque; vacío omite la etapa. |
255
+ | `forwardEnv` | `[]` | NOMBRES de variables de entorno (nunca valores) reenviadas a los procesos hijos del perfil de prueba; los valores nunca se registran. |
256
+ | `allowBuilds` | `true` | Permite en el perfil de prueba un build `prepare` de git bloqueado y reintenta la instalación una vez. |
257
+ | `installTimeoutMs` | `600000` | Límite de la etapa `dsh plugin add` (ms). |
258
+ | `configTimeoutMs` | `60000` | Límite de la etapa `--dump-config` (ms). |
259
+ | `smokeTimeoutMs` | `300000` | Límite de la etapa de arranque headless (ms). |
260
+ | `capabilityTimeoutMs` | `300000` | Límite de la tarea de aserción de capacidad (ms). |
261
+ | `capability.enabled` | `false` | Ejecuta la etapa de aserción de capacidad (registrada → invocada → observada). |
262
+ | `capability.kind` | `tool` | Qué afirmar: `tool` o `command`. |
263
+ | `capability.name` | `""` | Nombre de herramienta o comando (sin `/` inicial). |
264
+ | `capability.args` | `""` | Texto de invocación: argumentos de herramienta (estilo JSON) o palabras de comando. |
265
+ | `capability.expect` | `""` | Literal esperado en la salida observada (subcadena sin distinguir mayúsculas). |
266
+ | `uninstallTimeoutMs` | `120000` | Límite de la etapa `dsh plugin remove` (ms). |
267
+ | `outputTailBytes` | `8000` | Tope de la cola de salida saneada registrada por etapa (bytes). |
268
+ | `keepTempDirs` | `false` | Conserva los directorios temporales al fallar para forense (se abandona la propiedad; limpias tú). |
269
+ | `maxBatchTargets` | `20` | Tope de objetivos por lote de `/testdrive`. |
270
+ | `batchConcurrency` | `1` | Concurrencia del lote (en serie evita la contención del pnpm store). |
271
+
272
+ </details>
273
+
274
+ Ejemplo de sobrescritura en el patch del perfil:
275
+
276
+ ```yaml
277
+ - insert:
278
+ - id: test-drive
279
+ name: dsh-test-drive
280
+ config:
281
+ headlessTask: "Reply with exactly: ok"
282
+ forwardEnv: [DEEPSEEK_API_KEY]
283
+ capability:
284
+ enabled: true
285
+ kind: tool
286
+ name: plugin_vet
287
+ args: '{}'
288
+ expect: pass
289
+ ```
290
+
291
+ ## FAQ
292
+
293
+ <details>
294
+ <summary>¿Toca mi <code>~/.dsh</code> real?</summary>
295
+
296
+ No. Cada prueba se ejecuta dentro de una raíz `mkdtemp` nueva bajo el directorio temporal del sistema: un `DSH_HOME` desechable, un directorio de trabajo desechable y un pnpm store redirigido. El código del plugin probado solo se ejecuta en ese perfil; el perfil anfitrión no se lee ni se escribe, y el registro estructurado afirma `isolation.hostHomeTouched: false`. La limpieza solo acepta directorios que este plugin registró: sin barridos de `%TEMP%`, sin prefijos ajenos y sin rutas del hogar real.
297
+
298
+ </details>
299
+
300
+ <details>
301
+ <summary>¿Qué pasa si la composición no tiene <code>storageDomain</code>?</summary>
302
+
303
+ Las herramientas siguen funcionando, pero los informes no se persisten: el plugin registra el motivo y desactiva la persistencia, y `drive_report` falla honestamente en lugar de fingir. Al contrario, las composiciones que sí tienen `storageDomain` guardan los registros en el dominio `test_drive` (tablas `runs`, `matrices` y el puntero a la última matriz).
304
+
305
+ </details>
306
+
307
+ <details>
308
+ <summary>¿Los procesos hijos probados reciben mis credenciales?</summary>
309
+
310
+ Por defecto no. Los procesos hijos heredan un entorno sin credenciales; a menos que nombres explícitamente una variable en `forwardEnv` (solo nombres), los secretos del anfitrión nunca llegan a un perfil probado y esos valores jamás se registran. Además, cada informe y cada cadena de log pasa por saneadores puros: los literales de token, las credenciales de URL y las cabeceras bearer se tachan, las rutas de la raíz temporal se sustituyen por `<testdrive-temp>` y las colas de salida se recortan por bytes.
311
+
312
+ </details>
313
+
314
+ <details>
315
+ <summary>¿Por qué la etapa de arranque a menudo se queda en <code>boot-ok</code>?</summary>
316
+
317
+ Porque la comprobación de arranque no necesita credenciales, mientras que completar la tarea única sí. Sin credenciales el plugin informa del honesto `boot-ok` —no hubo fallo del loader y la tarea no terminó— en lugar de anotar como `pass` algo que no verificó. Para llegar a `pass`, reenvía credenciales explícitamente con `forwardEnv` (sus valores siguen sin entrar en el log).
318
+
319
+ </details>
320
+
321
+ <details>
322
+ <summary>¿Quedan directorios temporales cuando una prueba falla?</summary>
323
+
324
+ No en silencio. La limpieza se ejecuta en un `finally` en éxito, fallo, timeout y aborto, y otra vez al desmontar el plugin; antes de borrar, renombra la raíz a un directorio `dsh-test-drive-quarantine-<ts>`, lo verifica y solo entonces elimina. Si el borrado falla, el directorio queda en cuarentena y se informa. Para conservar la escena del crimen pon `keepTempDirs: true`: la propiedad se abandona y la limpieza pasa a ser tu tarea.
325
+
326
+ </details>
327
+
328
+ ## Límites de seguridad
329
+
330
+ - **Aislamiento.** Cada prueba se ejecuta dentro de una raíz `mkdtemp` nueva bajo el directorio temporal del sistema: un `DSH_HOME` desechable, un directorio de trabajo desechable y un pnpm store redirigido. El código del plugin probado solo se ejecuta en ese perfil; tu perfil anfitrión no se toca.
331
+ - **Propiedad.** Un registro en vivo anota cada raíz que crea esta instancia del plugin. La limpieza rechaza todo lo que no sea un hijo directo registrado del directorio temporal del sistema con el prefijo `dsh-test-drive-`: sin barridos de `%TEMP%`, sin prefijos ajenos y sin rutas del hogar real.
332
+ - **Escalera de limpieza.** Antes de cualquier mutación se registra el plan completo de dry-run (rutas absolutas). El borrado primero renombra la raíz a un directorio `dsh-test-drive-quarantine-<ts>`, verifica y luego elimina; si falla, el directorio queda en cuarentena y se informa, nunca se descarta en silencio. La limpieza se ejecuta en un `finally` en éxito, fallo, timeout y aborto, y de nuevo al desmontar el plugin.
333
+ - **`allowBuilds` es un permiso real.** Permitir el build `prepare` de un paquete git ejecuta el código de ese paquete durante la instalación. El permiso se limita al perfil desechable, pero prueba solo objetivos en los que confíes y fija los commits.
334
+ - **El arranque headless es sin claves por defecto.** La comprobación de arranque no necesita credenciales; completar la tarea única sí. Reenvía credenciales explícitamente (`forwardEnv`) y nunca las registres.
335
+
336
+ ## Permisos y datos
337
+
338
+ - **Superficie de servicios.** Solo se consumen servicios públicos: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`. `storageDomain` es opcional: sin él tanto el arranque como las pruebas siguen funcionando.
339
+ - **Permisos.** El manifiesto `dshWorkshop` declara `fs:read`, `fs:write`, `subprocess:spawn`, `session:append`, `network:inherit`, `native-code:none`: la escritura cubre solo las raíces temporales que crea y la persistencia de informes, y `network:inherit` solo hereda del anfitrión (las instalaciones registry/git del objetivo necesitan red de todos modos).
340
+ - **Datos.** Los informes viven en el dominio de almacenamiento `test_drive` (tablas `runs`, `matrices` y el puntero a la última matriz); sin ese dominio los informes no se persisten y el motivo queda registrado.
341
+ - **Registro de sesión.** Los procesos hijos reciben un entorno sin credenciales y `forwardEnv` reenvía solo nombres; cada cadena de informe/log se sanea: literales de token, credenciales de URL y cabeceras bearer tachados, rutas de la raíz temporal sustituidas por `<testdrive-temp>` y colas de salida recortadas por bytes.
342
+
343
+ ## Limitaciones conocidas
344
+
345
+ - **DSH Desktop no es un anfitrión de pruebas soportado.** `test_drive` necesita un CLI `dsh` capaz de arrancar un segundo proceso headless, mientras que el launcher `dsh.CMD` solo permite `dsh plugin …`, `--dump-config` y `--version`; apunta `dshBin` a un `dsh` instalado con npm/pnpm.
346
+ - Instalar objetivos de registry/git requiere acceso de red desde los procesos hijos `dsh`/pnpm.
347
+ - La tarea de arranque necesita credenciales del modelo para llegar a `pass`; sin ellas informa del honesto `boot-ok`.
348
+ - En composiciones sin `storageDomain`, los informes no se persisten (`drive_report` falla honestamente).
349
+ - `dsh` debe poder localizarse en el PATH (o configurar `dshBin`); en Windows el shim `.cmd`/`.bat` de npm se parsea automáticamente, pero si solo se resuelve un `.ps1` pide `dshBin`.
350
+ - Los lotes se ejecutan en serie por defecto; subir `batchConcurrency` comparte el disco del pnpm store, no la corrección.
351
+
352
+ ## Interoperabilidad con otros plugins DSH
353
+
354
+ `dsh-test-drive` expone dos herramientas y un comando, y no se suma a las costuras de otros plugins:
355
+
356
+ - **Aislamiento de nombres.** Solo registra `test_drive` y `drive_report`, más el comando `/testdrive`: ningún nombre desnudo que ya usen herramientas integradas u otros plugins.
357
+ - **Sin recursos de cliente ni HTTP.** Este paquete no tiene mitad `client/`: no registra slots de cliente, ni prefijos `webServer`, ni listeners waterfall `agent/pre-step` o `tools/post-execute` (`AGENTS.md` deja constancia de que este plugin no registra listeners waterfall), ni parchea objetos globales.
358
+ - **Sin conflictos de claves de servicio.** No ofrece ninguna clave de servicio y solo consume `subprocess`, `jobs`, `tools`, `commands` y el opcional `storageDomain`.
359
+ - **La capa de patch inserta solo su propia fila.** El patch del bundle hace `insert` de su única fila `test-drive` y nunca sobrescribe el `config` de una fila integrada.
360
+ - **El registro es un effect.** Las herramientas, el comando y el cierre del dominio se registran dentro de `ctx.effect`; detener o recargar en caliente revoca solo lo que este plugin registró, y el registro de raíces temporales barre los restos mediante su disposer.
361
+
362
+ ## Compatibilidad
363
+
364
+ | Superficie | Estado |
365
+ |---|---|
366
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (tag de GitHub, verificado el 2026-09-11: cadena completa de puertas + smoke de instalación de perfil). Líneas npm `0.1.2-rc.1` y `0.1.7-rc.2`; `engines.dsh`: `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0` |
367
+ | Node | `^22.19.0 \|\| >=24.9.0` |
368
+ | Gestor de paquetes | `pnpm@11.7.0` |
369
+ | Plataforma | Windows / macOS / Linux (plugin de host puro, sin mitad de UI) |
370
+ | Herramientas externas | CLI `dsh` en el PATH (autodetectado, con parseo de shims npm), `pnpm` en el PATH |
371
+
372
+ ## Ecosistema y calidad
373
+
374
+ - [Espejo de Gitee](https://gitee.com/perrylink/dsh-test-drive) (espejo sincronizado; GitHub es el canónico)
375
+ - [Página del plugin en dshfind](https://dshfind.com/plugins/PerryLink/dsh-test-drive) (instalaciones y ranking)
376
+ - [Informe de OpenSSF Scorecard](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive) (impulsado por [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
377
+ - [Informe de verificación de dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (impulsado por el [.github/workflows/plugin-doctor.yml](.github/workflows/plugin-doctor.yml) de este repo)
378
+ - [DSH Market](https://dsh.market/) (listado)
379
+ - **Canal de la tienda 1024**: `npm i -g dsh1024` una vez y luego `dsh1024 plugin --profile web add dsh-test-drive` (cuenta para el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com))
380
+ - [Base de conocimiento del ecosistema](https://perrylink.github.io/dsh-plugin-guide/) — datos medidos, no marketing: guía de desarrollo de plugins · datos de selección · criterios de mantenimiento
381
+
382
+ ## Desarrollo
383
+
384
+ ```sh
385
+ pnpm install # node ^22.19 || >=24.9
386
+ pnpm run typecheck # tsc: src + tests, resolviendo @deepseek-ai/* por el checkout local del harness
387
+ pnpm run typecheck:ci # tsc: contra los tipos publicados del host
388
+ pnpm test # vitest
389
+ pnpm run build # node scripts/prepare.mjs (bundle tsdown + declaraciones)
390
+ pnpm run verify:self-contained # las specs de dependencias se resuelven desde el registry
391
+ pnpm run verify:artifacts # archivos enviados presentes + lib/index.js importable
392
+ pnpm run check:readmes # consistencia de los README en cinco idiomas
393
+ pnpm pack # el tarball publicado
394
+ ```
395
+
396
+ - `typecheck` resuelve `@deepseek-ai/*` por el checkout local del harness; `typecheck:ci` comprueba contra los tipos publicados del host.
397
+ - Las pruebas usan la pila real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage con un proveedor de subprocess guionizado.
398
+ - Extremo a extremo con CLI real (requiere red + `dsh` en el PATH): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — conduce el propio checkout de este paquete por el bucle real de instalación y arranque.
399
+ - Publicación: `node scripts/release.mjs <x.y.z>` (sube versión, sella el CHANGELOG, reejecuta la puerta, hace commit + tag; nunca push).
400
+
401
+ ### GitHub Action (action.yml)
402
+
403
+ El repositorio incluye un [`action.yml`](action.yml) compuesto que reutiliza este plugin en cualquier repositorio de plugins: conduce un objetivo en un perfil desechable aislado y emite el par de informes que consume la CI — Markdown (comentario de PR) y JUnit XML (test reporter / comprobación de estado).
404
+
405
+ ```yaml
406
+ # .github/workflows/test-drive.yml
407
+ name: test-drive
408
+ on: [pull_request, workflow_dispatch]
409
+ jobs:
410
+ smoke:
411
+ runs-on: ubuntu-latest
412
+ steps:
413
+ - uses: actions/checkout@v4
414
+ - name: Drive this plugin
415
+ id: drive
416
+ uses: PerryLink/dsh-test-drive@v0.2.4
417
+ with:
418
+ target: github:${{ github.repository }}#${{ github.sha }}
419
+ - name: Publish JUnit
420
+ uses: EnricoMi/publish-unit-test-result-action@v2
421
+ with:
422
+ files: ${{ steps.drive.outputs.junit }}
423
+ - name: Comment the report
424
+ run: cat "${{ steps.drive.outputs.markdown }}"
425
+ ```
426
+
427
+ Entradas de `action.yml`: `target` (obligatoria), `headless-task` (tarea de humo opcional) y `dsh-version` (la especificación del CLI `dsh`). Salidas: `markdown`, `junit` (rutas de informe) y `verdict` (`pass`/`fail`/`partial`/`unknown`). La conducción en sí sigue sin claves (install → patch check → boot smoke → uninstall → cleanup); la aserción de capacidad es la única etapa que necesita `DEEPSEEK_API_KEY`, y sin ella queda `skipped`, nunca fallida.
428
+
429
+ El mismo par de informes está disponible por código: `renderDriveResult` / `renderMatrix` (Markdown) y `renderDriveJUnitXml` / `renderMatrixJUnitXml` (JUnit) se exportan desde la raíz del paquete sobre un `DriveResult` o `MatrixRecord` ya resuelto.
430
+
431
+ Las imágenes del README se generan programáticamente con [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python + Pillow) y se pueden reejecutar sin riesgo: `python scripts/gen-readme-assets.py`.
432
+
433
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
434
+
435
+ ## Familia y agradecimientos
436
+
437
+ Este proyecto forma parte de la familia de plugins de DeepSeek Harness de [PerryLink](https://github.com/PerryLink) (todos Apache-2.0). Si te resulta útil, **una estrella ayuda a que la siguiente persona lo encuentre** — no hay nada bloqueado tras ella.
438
+
439
+ - [@PerryLink](https://github.com/PerryLink) — creador y mantenedor: el pipeline de un solo objetivo, la etapa de aserción de capacidad, la propiedad de las raíces temporales y la escalera de limpieza aislada, el contrato de resultados estructurados y la documentación en cinco idiomas.
440
+
441
+ <details>
442
+ <summary>Expandir todos los plugins</summary>
443
+
444
+ | Plugin | Estado |
445
+ |---|---|
446
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
447
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
448
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
449
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 CONGELADO — ver el README del repo |
450
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
451
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
452
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 CONGELADO — ver el README del repo |
453
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
454
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
455
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
456
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
457
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
458
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 CONGELADO — ver el README del repo |
459
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
460
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
461
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
462
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
463
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
464
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
465
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
466
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
467
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
468
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
469
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
470
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
471
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
472
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
473
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
474
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
475
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
476
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
477
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
478
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
479
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
480
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
481
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
482
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
483
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
484
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
485
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
486
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
487
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
488
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
489
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
490
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
491
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 CONGELADO — ver el README del repo |
492
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
493
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
494
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
495
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
496
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
497
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
498
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
499
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
500
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
501
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
502
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
503
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 RETIRADO (repo archivado) |
504
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
505
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 RETIRADO (repo archivado) |
506
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 RETIRADO (repo archivado) |
507
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
508
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
509
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
510
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
511
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
512
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
513
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
514
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
515
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
516
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
517
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
518
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 CONGELADO — ver el README del repo |
519
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
520
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
521
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
522
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
523
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
524
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
525
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
526
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
527
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
528
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
529
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
530
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 RETIRADO (repo archivado) |
531
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
532
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
533
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver el README del repo |
534
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver el README del repo |
535
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver el README del repo |
536
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver el README del repo |
537
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver el README del repo |
538
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRADO (repo archivado) |
539
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO (repo archivado) |
540
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO (repo archivado) |
541
+
542
+ </details>
543
+
544
+ ## Licencia
545
+
546
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-test-drive contributors
547
+
548
+ <p align="center"><sub>Apache-2.0 · Plugin de la comunidad, no afiliado a DeepSeek.</sub></p>