---

Compatibility (Compatibilidad)

Componente	Versión
DeepSeek Harness	0.1.2-rc.1 (adaptado el 2026-09-04; dependencias peer ≥ 0.1.0-rc.8): el sobre de sesión conserva su campo ignorable solo para compatibilidad de lectura de logs almacenados - Session.append aún no puede estamparlo, por lo que el comportamiento de la puerta no cambia.
Node.js	^22.19.0 || >=24.0.0
Gestor de paquetes	pnpm@11.7.0
Plataforma	Windows / macOS / Linux (complemento solo host)
Herramientas externas	CLI dsh en PATH (autodetección, shims de npm analizados), pnpm en PATH

What you get (Qué obtienes)

• Herramienta test_drive — un objetivo por el flujo completo: dsh plugin add → verificación del parche con --dump-config → arranque headless (escaneo de marcadores FAILED + tarea opcional de una frase) → aserción de capacidad opcional → dsh plugin remove → limpieza en cuarentena. Devuelve el registro estructurado de forma síncrona, o { kind: 'background', jobId } con background: true.
• Comando /testdrive — lote de objetivos separados por espacios/comas como tarea en segundo plano drive-batch sobre ctx.jobs, produciendo un informe matricial (JSON + Markdown).
• Herramienta drive_report — recupera cualquier ejecución (tdr_...), matriz (tdm_...) o la última matriz; se renderiza en Markdown.
• Aserción de capacidad — más allá de “arrancó y salió”: la etapa opcional capability hace que el agente llame a la herramienta nombrada (o ejecute /command) y verifica que el registro durable de sesión contenga la invocación y que la salida observada contenga expect. Un arranque limpio es solo una prueba de humo; observed demuestra que una capacidad con nombre realmente funciona.
• Resultados estructurados — cada registro lleva el discriminador schema: "dsh-test-drive/v1" con campos de primera clase: stages.install.status (pass/fail), stages.smoke.status (pass/fail/boot-ok/skipped), durationMs por etapa, summary/outputTail saneados y un verdict global (pass/fail/partial/unknown). Este es el contrato legible por máquina que consumen los puntuadores (dsh-score).
• Seguridad por construcción — cada directorio temporal lo crea este complemento bajo un prefijo dedicado dsh-test-drive-, se registra en un registro de propiedad activo y solo se elimina mediante la escalera dry-run → renombrado a cuarentena → borrado. El perfil del host nunca se lee ni se escribe.

Quick start (Inicio rápido)

Canal git

dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>

El primer add falla porque pnpm bloquea la compilación prepare del paquete; copia la clave exacta que pnpm imprimió en el pnpm-workspace.yaml del perfil y vuelve a ejecutar:

allowBuilds:
  'dsh-test-drive': true

Canal npm

dsh plugin --profile web add dsh-test-drive

Los paquetes precompilados no necesitan permiso de compilación. Reinicia el perfil y usa test_drive / /testdrive desde una sesión.

Install & uninstall (Instalación y desinstalación)

dsh plugin --profile web add dsh-test-drive     # instalar (npm) — o la forma git de arriba
dsh plugin --profile web remove dsh-test-drive  # desinstalar

Configuration (Configuración)

Todas las claves son opcionales (se muestran los valores por defecto); los valores inválidos fallan ruidosamente al cargar.

Clave	Por defecto	Descripción
profileName	headless	Plantilla de perfil inicializada dentro de cada DSH_HOME desechable (bundles base + headless).
dshBin	""	Ruta absoluta que reemplaza al ejecutable dsh; vacío autodetecta dsh en PATH.
headlessTask	"Reply with exactly: ok"	Tarea de una frase para la etapa de arranque; vacío omite la etapa.
forwardEnv	[]	NOMBRES de variables de entorno (nunca valores) reenviados a los procesos hijos del perfil de prueba.
allowBuilds	true	Permite una compilación prepare de git bloqueada en el perfil de prueba y reintenta la instalación una vez.
installTimeoutMs	600000	Plazo de la etapa dsh plugin add.
configTimeoutMs	60000	Plazo de la etapa --dump-config.
smokeTimeoutMs	300000	Plazo de la etapa de arranque headless.
capabilityTimeoutMs	300000	Plazo de la tarea de aserción de capacidad.
capability.enabled	false	Ejecuta la etapa de aserción de capacidad (registrado → invocado → observado).
capability.kind	tool	Qué afirmar: tool o command.
capability.name	""	Nombre de herramienta o comando (sin la / inicial).
capability.args	""	Texto de invocación: argumentos de herramienta (estilo JSON) o palabras del comando.
capability.expect	""	Literal esperado en la salida observada (subcadena sin distinción de mayúsculas).
uninstallTimeoutMs	120000	Plazo de la etapa dsh plugin remove.
outputTailBytes	8000	Límite de la cola de salida saneada registrada por etapa.
keepTempDirs	false	Conserva los directorios temporales ante fallos para análisis forense (se abandona la propiedad; tú limpias).
maxBatchTargets	20	Límite de lote de /testdrive.
batchConcurrency	1	Concurrencia del lote (en serie evita contención del almacén pnpm).

Tools & surfaces (Herramientas y superficies)

test_drive

test_drive(target: string, headlessTask?: string, background?: boolean,
  capability?: { kind: 'tool' | 'command', name: string,
                 args: string, expect: string })

• target — especificación git (github:owner/repo#sha, git+https://...), nombre npm, ruta local o tarball .tgz.
• capability — aserción posterior al arranque: el agente llama a name (herramienta) con args o ejecuta /name (comando); la etapa lee el registro durable de sesión y exige que la salida observada contenga expect. Requiere DEEPSEEK_API_KEY (entorno del host o forwardEnv); sin ella, la etapa queda skipped, nunca falla.
• Devuelve el registro estructurado completo; ejemplo más abajo.
• background: true inicia una tarea drive-batch y devuelve su id.

/testdrive <objetivos...>

Inicia una tarea por lotes en segundo plano; el progreso fluye por la salida de la tarea y la última línea nombra el id de matriz para drive_report.

drive_report(id?)

Devuelve un registro de ejecución (tdr_...), una matriz (tdm_...) o — sin id — la última matriz.

Ejemplo de resultado estructurado

{
  "schema": "dsh-test-drive/v1",
  "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
           "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
           "harnessVersion": "0.1.2-rc.1", "pluginVersion": "0.3.6",
           "platform": "win32", "node": "v22.22.3" },
  "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
              "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
                            "hasBundleManifest": true } },
  "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
                 "hostHomeTouched": false },
  "stages": {
    "install":   { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
                   "summary": "install ok after allowBuilds allowance", "outputTail": "",
                   "allowBuildsNeeded": true },
    "config":    { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
                   "summary": "dump ok (exit 0)", "outputTail": "",
                   "patchEffective": true, "layers": ["dsh-click"] },
    "smoke":     { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
                   "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
                   "outputTail": "", "bootFailed": false, "taskCompleted": false },
    "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
                    "summary": "tool \"plugin_vet\" called and its result contains the expectation",
                    "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
                    "expectMatched": true,
                    "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
    "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
                   "summary": "remove ok (exit 0)", "outputTail": "" },
    "cleanup":   { "status": "pass", "quarantined": true, "removed": true,
                   "summary": "owned temp root quarantined and removed" }
  },
  "verdict": "pass",
  "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
}

Reglas de veredicto: fallo de instalación, de arranque (smoke.fail) o una etapa de capacidad que llegó a not-registered/failed ⇒ fail; instalación aprobada + parche efectivo + arranque limpio (pass/boot-ok) + desinstalación aprobada ⇒ pass (con nota de capacidad cuando observed); instalado pero sin alguna garantía posterior ⇒ partial; en otro caso ⇒ unknown.

CI (GitHub Actions)

El repositorio incluye un action.yml composite reutilizable con uses: en cualquier repositorio de plugins: impulsa el objetivo en un perfil desechable y emite el par de informes que CI consume — Markdown (comentario de PR) y JUnit XML (verificación de estado). Entradas target (obligatorio)/headless-task/dsh-version; salidas markdown/junit/verdict. El drive no requiere clave; solo la aserción de capacidad necesita DEEPSEEK_API_KEY y queda skipped (nunca falla) sin ella.

Permissions & data (Permisos y datos)

• Solo se consumen servicios públicos: ctx.subprocess, ctx.jobs, ctx.storageDomain, ctx.tools, ctx.commands.
• Los informes se guardan en el dominio de almacenamiento test_drive (tablas runs, matrices; puntero de última matriz). Si la composición no tiene storageDomain (p. ej. el perfil headless oficial), las herramientas siguen funcionando y la persistencia se desactiva con motivo registrado.
• Los procesos hijos heredan un entorno sin credenciales: los secretos del host nunca llegan al perfil probado salvo que los nombres explícitamente en forwardEnv. Los valores nunca se registran.
• Todas las cadenas de informes/registros pasan por saneadores puros: literales de token, credenciales en URL y cabeceras bearer se redactan, las rutas raíz temporales se sustituyen por <testdrive-temp> y las colas se limitan por bytes.

Security boundaries (Límites de seguridad)

• Aislamiento. Cada prueba se ejecuta dentro de una raíz mkdtemp nueva bajo el directorio temporal del SO: un DSH_HOME desechable, un directorio de trabajo desechable y un almacén pnpm redirigido. El código del complemento probado solo se ejecuta en ese perfil; tu perfil del host queda intacto.
• Propiedad. Un registro activo guarda cada raíz creada por esta instancia. La limpieza rechaza cualquier ruta que no sea hija directa registrada del directorio temporal del SO con el prefijo dsh-test-drive- — sin barridos de %TEMP%, sin prefijos ajenos, sin rutas del hogar real.
• Escalera de limpieza. Antes de cualquier mutación se registra el plan dry-run completo (rutas absolutas). El borrado primero renombra la raíz a un directorio dsh-test-drive-quarantine-<ts>, verifica y luego elimina; los fallos dejan el directorio en cuarentena y se informan, nunca se descartan en silencio. La limpieza se ejecuta en un finally ante éxito, fallo, timeout y aborto, y de nuevo al desmontar el complemento.
• allowBuilds es un permiso real. Permitir la compilación prepare de un paquete git ejecuta el código de ese paquete en el momento de la instalación. El permiso se limita al perfil desechable, pero prueba solo objetivos de confianza y fija commits.
• El arranque headless es sin clave por defecto. La comprobación de arranque no necesita credenciales; completar la tarea sí. Reenvía credenciales explícitamente (forwardEnv) y nunca las registres.

Known limitations (Limitaciones conocidas)

• Instalar objetivos de registro/git requiere acceso a red desde los procesos dsh/pnpm hijos.
• La tarea de arranque necesita credenciales del modelo para llegar a pass; sin ellas informa el honesto boot-ok.
• En composiciones sin storageDomain los informes no se persisten (drive_report falla honestamente).
• dsh debe poder localizarse en PATH (o configura dshBin); en Windows el shim .cmd/.bat de npm se analiza automáticamente; una resolución .ps1 pide dshBin.
• Los lotes se ejecutan en serie por defecto; subir batchConcurrency solo afecta a la contención de disco del almacén pnpm, no a la corrección.

Development (Desarrollo)

pnpm install
pnpm run typecheck && pnpm run typecheck:ci && pnpm test
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack

• typecheck resuelve @deepseek-ai/* a través del checkout local del harness; typecheck:ci comprueba contra los tipos publicados 0.1.2-rc.1.
• Las pruebas usan la pila real Context/Session/ToolRuntime/LocalJobRegistry/almacenamiento con un proveedor de subprocesos guionizado.
• End-to-end con CLI real (requiere red + dsh en PATH): DSH_TESTDRIVE_E2E=1 pnpm run test:e2e — prueba el checkout de este propio paquete por el bucle real de instalación y arranque.
• Lanzamiento: node scripts/release.mjs <x.y.z> (sube versión, sella CHANGELOG, repite la puerta, commit + tag; nunca hace push).

Topics

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, plugin-testing, install-smoke, compatibility-matrix, ci

Contributors (Contribuidores)

PerryLink — diseño e implementación.

PerryLink DSH Plugin Family

Este proyecto es uno de los 33 complementos de DeepSeek Harness mantenidos por PerryLink. Si este te ayuda, probablemente los demás también:

Plugin	One-liner
dsh-dsh-auto-review	Auto-revisión de segundo modelo en la cadena de aprobación, con cierre en fallo por defecto
dsh-dsh-background-agents	Agentes hijos en segundo plano durables con barra lateral de UI web, mensajería e interrupción
dsh-dsh-budget	Gobernanza de costes para DeepSeek Harness: presupuestos, carbono y latencia en un panel.
dsh-dsh-checkpoint-rewind	Equivalente a /rewind de Claude Code: instantáneas, bifurcaciones de sesión, restauración de un solo uso
dsh-dsh-claude-move	Migra sesiones, memoria, habilidades y CLAUDE.md de Claude Code a DSH
dsh-dsh-click	Control de escritorio nativo multiplataforma para DeepSeek Harness — Windows primero.
dsh-dsh-composer-history	Historial de entrada estilo terminal para el compositor web: flechas, búsqueda Ctrl+R
dsh-dsh-data-quality	Comprobaciones de calidad de datasets y verificación de citas (el puente numérico opcional consumido aquí)
dsh-dsh-defend	Defensa contra inyección de prompts, jailbreak y fuga de secretos para DeepSeek Harness.
dsh-dsh-doublecheck	Guardián de disciplina de ingeniería: interrogatorio de requisitos, puertas de pruebas, revisión adversaria
dsh-dsh-draw	Enrutamiento unificado de generación de imágenes estáticas para DeepSeek Harness.
dsh-dsh-fast	Diagnóstico de rendimiento de solo lectura para DeepSeek Harness.
dsh-dsh-fund-research	Informes de investigación deterministas para fondos mutuos públicos chinos
dsh-dsh-github	Integración de PR/issues de GitHub para DSH, cada escritura controlada por aprobación
dsh-dsh-industry-research	Orquestación de investigación sectorial que sella sus entregables mediante el ctx.researchReport.assemble de este plugin
dsh-dsh-library	Base de conocimiento documental local para DeepSeek Harness.
dsh-dsh-local-ai	Integración de modelos locales (Ollama) para DeepSeek Harness.
dsh-dsh-lsp-actions	Diagnósticos, formato, autocompletado, acciones de código y renombrado LSP sobre servidores de lenguaje
dsh-dsh-mask	Middleware de enmascaramiento de PII: anonimiza en el límite del modelo, restaura en la capa de visualización
dsh-dsh-mcp-panel	Panel de tiempo de ejecución MCP de solo lectura: comando /mcp + pestaña Settings con estado, herramientas y errores
dsh-dsh-memento	Memoria entre sesiones controlada por aprobación: costura ctx.memory + SQLite + herramienta de memoria
dsh-dsh-observe	Exportador de observabilidad OpenTelemetry y Langfuse para DeepSeek Harness.
dsh-dsh-output-styles	Cambio de estilo en tiempo de ejecución equivalente a outputStyles de Claude Code
dsh-dsh-permission-rules	Reglas de permisos declarativas allow/deny/ask estilo Claude Code con auditoría
dsh-dsh-plugin-guide	Base de conocimiento de desarrollo de plugins como habilidad de agente bajo demanda
dsh-dsh-research-report	Motor de informes de investigación verificables con evidencia direccionada por contenido
dsh-dsh-score	Puntuación de calidad multidimensional para plugins de DeepSeek Harness.
dsh-dsh-session-pin	Fija sesiones en la barra lateral web con orden durable
dsh-dsh-session-sync	Sincronización de sesiones entre dispositivos para DeepSeek Harness — un espejo git dedicado de tu almacén de sesiones.
dsh-dsh-skill-pack-security	Paquete de habilidades de auditoría de seguridad: escaneo de secretos, revisión de dependencias y cadena de suministro
dsh-dsh-talk	Bucle de sesión con voz para DeepSeek Harness: háblale y escucha su respuesta.
dsh-dsh-translate	Traducción de parámetros entre proveedores y reparación determinista de JSON para DeepSeek Harness.

License (Licencia)

Apache-2.0

Instalar desde el mercado de DSH Desktop

Todos los plugins de PerryLink pueden explorarse en el mercado integrado de DSH Desktop: Market → Sources → add source → pegar https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → seleccionarlo. La instalación sigue pasando por la verificación de identidad npm del mercado y tu confirmación.