---

Compatibilidad

Superficie	Estado
Harness	DeepSeek Harness 0.1.5-rc.1 (tag dsh-v0.1.5-rc.1 = 183f08e9c6dd; relevo tramo A→B dsh-v0.1.5-alpha.1 = 5dda764ed3aa; inicio del corredor 0.1.3-alpha.1) y, para legC, DeepSeek Harness 0.1.6-alpha.2 (tag dsh-v0.1.6-alpha.2). Banda de peers @deepseek-ai/dsh-skill >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0, @deepseek-ai/cordis ^4.0.2, @deepseek-ai/schemastery ^3.18.2.
Node	^22.19.0 || >=24.0.0
Plataformas	Donde corra Node; el escáner solo usa el sistema de archivos y es neutral respecto a la plataforma
Modelo	Modelos solo de texto totalmente soportados; la habilidad es un Markdown, sin requisitos de herramientas ni visión
Índice de corredores	Un paquete, un punto de entrada. lib/route.mjs contiene los corredores cerrados y la CLI enruta al que corresponde según la banda declarada del repo destino (engines.dsh, los rangos @deepseek-ai/dsh*); --span legAB|legC anula la conjetura y una banda no declarada recae en el corredor más antiguo. Los dos catálogos nunca se fusionan: cada corredor conserva su propio array de costuras, tarjeta, evidencia, fixtures y puerta de paridad.
Alcance	Dos corredores cerrados: legAB = 0.1.3-alpha.1 → 0.1.5-rc.1 (tramo A + tramo B), legC = 0.1.5-rc.2 → 0.1.6-alpha.2. Un corredor nunca se ensancha: un salto que añade una costura es un corredor nuevo — una tarjeta nueva y una fila nueva en el índice, no un paquete nuevo.
Tramos	Cada tramo vive en este paquete: el tramo A conserva las costuras S1–S10 + M1, el tramo B conserva C1, C2, C4, C5, H1–H4, P1, y el tramo C conserva E1–E5 — cada uno con su propia evidencia, sección de tarjeta, fixtures y ruta de reversión. No hay paquete hermano que instalar.
C3	Retirada: la tarjeta del tramo B escribía como C3 el falso verde de la línea de tipos obsoleta, que es el mismo defecto que el M1 del tramo A. La fusión queda registrada en la tarjeta; --seams C3 no coincide con nada.
Paquete anterior	No montes el retirado dsh-plugin-upgrade en el mismo perfil: ambos registran la skill plugin-upgrade, así que el segundo montaje colisiona con ese nombre. Ese paquete está obsoleto en npm y su repositorio se retiró; este paquete sustituye sus dos tramos.

Lo que obtienes

Dos mitades, un catálogo de costuras por corredor:

• Una habilidad de agente incluida (plugin-upgrade) — la tarjeta del corredor fusionado y un bucle de arreglar-y-verificar. El cuerpo primero enruta a quien la llama al tramo que corresponde a su banda de peers; el modelo la carga solo cuando una tarea la necesita de verdad, y el paquete no aporta ningún párrafo al prompt del sistema ni registra herramientas.
• Una CLI sin dependencias (dsh-plugin-upgrade-scan) — resuelve el corredor e informa hechos file:line de las costuras de ese corredor: las veinte de legAB (S3, S8, S9, M1, S4, S5, S6, S7, S2, S1, S10, C1, C2, P1, C4, C5, H1, H2, H4, H3) releídas de los rangos de tags del harness el 2026-09-09 (tramo A) y el 2026-09-10 (tramo B), o las cinco de legC (E1–E5) medidas en dsh-v0.1.6-alpha.2 (2026-09-19). Sale con 1 ante cualquier hallazgo de severidad error, así que entra directo en CI.

El objetivo es el modo de fallo que este corredor existe para matar: la rotura de este lapso es mayormente silenciosa, y lo es por ambos extremos. La línea de tipos puede estar obsoleta, así que el repo compila contra el catálogo antiguo (costura M1), y el slot de cliente desnudo conversation se eliminó sin alias mientras ctx.slots.inject() solo ejecuta su callback cuando la declaración existe: una mitad de cliente que aún lo apunta deja de montarse sin error, sin línea de log y sin build fallido (costura C1). Tres clases de rotura sobreviven a typecheck + test:

1. la puerta local compila una línea de tipos obsoleta — un alias paths antiguo, o tipos de dev/test fijados en 0.1.5-alpha.* (costura M1);
2. un escritor de logs omite el campo stream obligatorio de V3, así que la sesión se importa y luego se niega a reanudarse (costura S3);
3. las pruebas están simuladas contra la forma antigua, así que pasan mientras el host descarta tu contribución (costura C1).

Medición honesta: el barrido del espacio de trabajo del tramo B encontró que las mitades de cliente de la familia usan solo 8 claves de slot, y las 8 sobreviven en rc.1 — para ellas la rotura de rc.1 es latente, no real. Los plugins de cliente de terceros que apuntaban a la clave desnuda conversation son los que se rompen, y lo hacen en silencio. El barrido del tramo A encontró la textura opuesta: 40 repos, 11 de ellos dieron con M1, y arreglar la ruta obsoleta destapó errores reales de TypeScript en 3 repos que antes estaban «en verde».

Inicio rápido

# 1. instala el bundle en tu perfil
dsh plugin --profile web add dsh-plugin-upgrade

# 2. verifica que la fila se montó
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-upgrade'

# 3. escanea el plugin que vas a actualizar
npx dsh-plugin-upgrade-scan --repo ../my-plugin

Luego pide al agente que use la habilidad plugin-upgrade, o lleva el bucle tú mismo con la tarjeta que corresponda a tu banda: skills/plugin-upgrade/references/v0.1.3-alpha.1-to-v0.1.5-rc.1.md (legAB — el tramo A es §1, el tramo B es §2, el índice de costuras fusionado es §3) o skills/plugin-upgrade/references/v0.1.5-rc.2-to-v0.1.6-alpha.2.md (legC). El escáner elige el corredor por ti; añade --span legC cuando la banda declarada sea ambigua.

Instalación y desinstalación

dsh plugin --profile web add dsh-plugin-upgrade            # desde npm
dsh plugin --profile web add "github:PerryLink/dsh-plugin-upgrade#main"   # desde el código
dsh plugin --profile web remove dsh-plugin-upgrade         # desinstalar (reversible)

Instalar el bundle solo registra una habilidad; quitar la fila quita la habilidad. La CLI es un destino npx normal y no necesita perfil.

Configuración

Cada clave es opcional y vive en el patch del perfil:

Clave	Por defecto	Significado
enabled	true	Registra la habilidad incluida. Pon false para mantener la dependencia montada pero en silencio.
skillName	plugin-upgrade	Directorio bajo skillsRoot que se registra, y el nombre que aparece en el catálogo.
skillsRoot	el ./skills del propio paquete	Dónde vive <skillName>/SKILL.md. Apúntalo a tu propia tarjeta para reutilizar la infraestructura.
userInvocable	true	Si una persona puede invocar la habilidad por nombre además del modelo.

- insert:
    - id: dsh-plugin-upgrade
      name: dsh-plugin-upgrade
      config:
        skillName: plugin-upgrade

El plugin monta de forma ruidosa: un SKILL.md ausente, un cuerpo vacío o un frontmatter sin name hacen fallar el montaje en lugar de registrar una habilidad vacía.

Superficies

Habilidad — plugin-upgrade (invocable por el modelo y por personas por defecto). Cuerpo: la tabla de enrutado por tramo, las 8 reglas duras y el bucle de 6 pasos. Referencias: la tarjeta del corredor fusionado. Scripts: el detector, dentro del directorio de la habilidad para que las rutas relativas resuelvan.

CLI — dsh-plugin-upgrade-scan:

dsh-plugin-upgrade-scan [--repo <path>] [--span legAB|legC|<span>] [--json <out.json>] [--seams S3,C1,P1] [--quiet]

Bandera	Significado
--repo <path>	Repositorio a escanear (por defecto: el directorio actual). Su banda dsh declarada elige el corredor.
--span legAB|legC|<span>	Fuerza un corredor en lugar de conjeturarlo desde la banda declarada. Una banda desconocida recae en legAB.
--json <out.json>	También escribe el informe legible por máquina (repo, scannedAt, files, hits[], bySeam).
--seams S3,C1,P1	Restringe a costuras concretas del catálogo del corredor resuelto (los ids nunca se comparten entre corredores).
--quiet	Suprime la salida humana (combínala con --json).

Códigos de salida: 0 sin hallazgos de severidad error · 1 al menos un hallazgo de severidad error · 2 uso o fallo del escaneo. Un escaneo limpio es necesario pero no suficiente: el criterio de salida es un smoke real en el host, más un ida y vuelta de reanudación para los escritores de logs (tramo A) y una aserción en un navegador real para la mitad de cliente (tramo B).

Las veinte costuras de legAB

El orden sigue el catálogo de lib/scan.mjs (primero el tramo A, luego el tramo B), que es también el orden al que test/card.test.mjs fija la tarjeta.

Id	Severidad	Qué cambió en el camino a 0.1.5-rc.1
S3	error	assistant/message ganó un campo stream obligatorio (formato de sesión V3): un log escrito sin él se importa con éxito y luego se niega a reanudarse (Session.fromRestore lanza invalid settlement fields).
S8	error	SessionHandle.read() devuelve SessionHandleReadResult ({ eventState, events }) en lugar del array de eventos; las operaciones de array deben desenvolver .events.
S9	error	La configuración de SystemPrompt renombró persona → personaPrefix / personaSuffix. Sustituirlo por includeHarnessIdentity: false no es equivalente: elimina el bloque de identidad del harness.
M1	error	La puerta local compila una línea de tipos obsoleta: tipos de dev/test fijados en 0.1.5-alpha.*, o un alias paths de tsconfig que resuelve a un directorio de checkout inexistente, hacen que TypeScript vuelva en silencio a los tipos publicados. Puerta en verde, regla equivocada.
S4	error	tool/code-dispatch pasó a llamarse tool/ptc-dispatch; la etiqueta antigua ya no se reconoce en las sesiones V3.
S5	error	ctx.agent se eliminó: quien llama debe pasar el Agent explícitamente (por ejemplo, el segundo parámetro de setup(agentCtx, agent)).
S6	error	Inbox es una interfaz de tipo, no una clase construible; los fixtures usan la forma oficial no soportada y el código en tiempo de ejecución lee agent.inbox.
S7	warn	SubprocessHandle.pid se eliminó (solo queda SubprocessTerminalHandle.pid); quita el campo de los fixtures de prueba.
S2	warn	EpochHeader.system se eliminó: el prompt del sistema es ahora el system/message del nodo 0 de la superficie.
S1	warn	Formato de sesión V3 y nombres de log con sufijo de generación: la generación actual es session.v3.jsonl.zstd, así que los scripts que fijan session.jsonl.zstd fallan en silencio.
S10	warn	Los eventos de sesión escritos por un plugin deben pasar por la puerta de adaptación fail-closed del host: Session.append no tiene canal de escritura ignorable, así que un append incondicional puede dejar una sesión ilegible.
C1	error	El slot de cliente desnudo conversation se eliminó y se sustituyó por main + main.conversation, sin alias. ctx.slots.inject() solo se dispara si la declaración existe, así que un plugin que lo apunta deja de montarse en silencio.
C2	error	@deepseek-ai/dsh-client-ui-sidebar-textpreview pasó a llamarse …-sidebar-documentpreview; el nombre antiguo desapareció y no hay paquete shim.
P1	error	La banda de peers debe conservar su segundo segmento: >=0.1.2-rc.1 <0.2.0 por sí solo rechaza 0.1.5-rc.1 bajo la regla prerelease-tuple de npm semver (medido false en semver 7.8.5).
C4	warn	rc.1 añadió un modelo de panel principal global (main, sidebar.panellist, ctx.layout.selectPanel(MainPanelId | null)) y añadió la prop estándar usePanelInfo a casi todos los slots.
C5	warn	La vista previa de documentos se movió al slot con clave sidebar.right.tab.document (DocumentContent); sidebar.right.pane.tab sobrevive pero su entrada padre pasó a ser rightbar.session.
H1	warn	KNOWN_SESSION_EVENT_TYPES ganó deliverables/presented y subagent/catalog: el vocabulario fail-closed creció.
H2	warn	La fila de la nueva herramienta present ocupa la clave 'present' de tool.call.toolview, que en alpha.1 estaba libre.
H4	info	El catálogo asesor por defecto del adaptador DeepSeek ahora encabeza con deepseek-flash (DeepSeek-V41-Flash).
H3	info	Nuevas capacidades opcionales: ctx.sessionFeedback, ctx.layout.beginNavigation(), ctx.workspaces.openSession() / openWorkspace() / forkSession(). Listadas en la tarjeta; deliberadamente sin detección automática.

S7, S2, S1, S10, C4, C5, H1, H2 y H4 son deliberadamente asesorables: tienen coincidencias legítimas (un repo que ya usa la API nueva, una instantánea de documentación, la tabla de ids de modelo de un plugin, un ChildProcess.pid de Node), así que el escáner las reporta como pistas para revisión manual, no como fallos. M1 y P1 son comprobaciones estructurales — resuelven package.json y tsconfig*.json en lugar de coincidir texto — y H3 es solo de tarjeta: documentada, con paridad de ids comprobada y deliberadamente sin detector (CARD_ONLY = ['H3']).

Las cinco costuras de legC (0.1.5-rc.2 → 0.1.6-alpha.2)

El orden sigue el catálogo de lib/scan-0.1.6.mjs, que es también el orden al que test/card.test.mjs fija la tarjeta de legC. Aquí toda costura es error y todas se detectan (CARD_ONLY = []).

Id	Severidad	Qué cambió en el camino a 0.1.6-alpha.2
E1	error	agent/created despacha sus listeners en serie: un listener que lanza — o que hace trabajo lento — bloquea por completo la creación del agente. Envuelve el trabajo síncrono en try/catch y aplaza el resto con queueMicrotask/setImmediate o tu propia cola.
E2	error	Un apply() asíncrono cuyo primer await precede a sus registros: todo lo registrado después cae en la ventana de descarga y lanza INACTIVE_EFFECT, mientras el cierre antiguo sigue corriendo. Registra todo antes del primer await, dentro de un único ctx.effect().
E3	error	Claves de slot/estado eliminadas: settings.plugin.item pasó a ser el keyed→list plugins.item, y SessionListState.current desapareció — una tarjeta de ajustes desaparece en silencio (retorno temprano por spec === undefined), y los casts de current siguen compilando mientras la función está muerta.
E4	error	API de cliente eliminada: sessions.open / openSubagent / clear pasaron a retain / using / retainInfo.
E5	error	Literales de modelo eliminados: deepseek-v4-flash* y deepseek-v4-vision-exp. El catálogo de modelos por defecto se encogió de 4 a 2, y un id sin catalogar pasa tal cual como solo texto.

Se aplica la misma disciplina que en legAB: un escaneo limpio es necesario, no suficiente. La rotura de legC es silenciosa o solo en tiempo de ejecución (la línea de tipos publicada oculta las eliminaciones), así que el criterio de salida sigue siendo un smoke real en el host sobre un DSH_HOME temporal, más el ida y vuelta del escritor de logs y la aserción en navegador real donde correspondan.

Lo que esto no cubre

• Un salto más allá de todos los corredores de aquí. legAB termina en 0.1.5-rc.1 por construcción: el salto del harness 0.1.5-rc.1 → 0.1.5-rc.2 no añadió ninguna costura de cara a los plugins (el pin de dev/test y la sonda de CI de este propio paquete corren sobre la línea 0.1.5-rc.2, de modo que el catálogo de legAB queda verificado contra esos tipos publicados), y legC cubre 0.1.5-rc.2 → 0.1.6-alpha.2. Un salto posterior que añada una costura no está cubierto: un corredor está cerrado, y ensanchar una tarjeta es peor que añadir una. Ese salto recibe una tarjeta nueva y una fila nueva en el índice — no un paquete nuevo.
• El salto 0.1.1 → 0.1.2. Usa la habilidad de convergencia de la comunidad.
• Repetir entre tramos. El tramo A posee las costuras del formato de sesión (assistant/message.stream, SessionHandleReadResult, EpochHeader.system, ctx.agent, Inbox, SystemPrompt.persona, la generación de log V3) y el tramo B no las repite: todo el diff de packages/core/session/src en el rango del tramo B son dos literales de tipo de evento añadidos y una línea de comentario. La sección de tarjeta de cada tramo conserva su propia declaración de alcance.
• La ruta de actualización del usuario de DSH. Este paquete actualiza código fuente de plugins, no la instalación del harness de un usuario.
• Tokens de tema. docs/web-styling.md no tiene ningún cambio en el rango del tramo B.
• Prueba. Un escaneo limpio es una hipótesis. El criterio de salida es un smoke real en el host (DSH_HOME temporal, CLI objetivo, plugin add <tarball>, --dump-config) más un ida y vuelta de reanudación para los escritores de logs de sesión (tramo A) y una aserción en un navegador real para cada hallazgo del lado cliente (tramo B).

Límites de seguridad

• Escaneo de solo lectura. La CLI nunca escribe dentro del repositorio escaneado; --json escribe solo en la ruta que indiques.
• Sin red, sin shell. El escáner no importa nada fuera de la biblioteca estándar de Node y nunca lanza un proceso.
• Sin secretos. Nada en el paquete lee credenciales, tokens de entorno ni datos de sesión.
• Receta de smoke en sandbox. La comprobación de host real de la tarjeta usa un DSH_HOME de mkdtemp; nunca toca tu ~/.dsh real.

Desarrollo

npm install                        # o: pnpm install (el repo incluye pnpm-lock.yaml)
npm test                           # node --test: escáner, paridad tarjeta<->catálogo, Cordis + SkillRegistry reales
npm run verify:self-contained      # cada import resuelve dentro del paquete
npm run verify:artifacts           # el tarball lleva la habilidad, la CLI y el patch, y excluye las pruebas
npm run check:readmes              # consistencia de los README en cinco idiomas
npm pack

El escáner tiene un par de fixtures sintéticos por tramo de legAB: fixtures/leg-a-bad-repo (las costuras de sesión/configuración del tramo A, con todas las costuras de error presentes a propósito) junto con fixtures/leg-a-good-repo (adaptado), y fixtures/bad-repo (las costuras de slot de cliente del tramo B) junto con fixtures/good-repo (adaptado) — más un negativo en vivo sobre un repositorio de la familia ya fijado a 0.1.5-rc.1, de modo que una regresión del catálogo falla en esta suite y no en un usuario aguas abajo. test/card.test.mjs afirma que el índice de cada tarjeta y su propio catálogo (lib/scan.mjs para legAB, lib/scan-0.1.6.mjs para legC) nombran exactamente los mismos ids de costura con las mismas severidades, que el CARD_ONLY de legAB es exactamente ['H3'] mientras el de legC está vacío, y que los dos catálogos no comparten ningún id de costura — la regla de vinculación de evidencia como puerta de máquina, por corredor.

Temas

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, plugin-upgrade, migration, skill, version-card, scanner, client-slots (reflejan las keywords de package.json; dsh-plugin es el canal de visibilidad del ecosistema).

Familia de plugins DSH de PerryLink

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

Plugin	One-liner
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Unified session + workspace + config checkpoints with one-shot /rewind
dsh-claude-move	Migrate Claude Code, Codex, OpenCode and Hermes sessions, memories and skills into DSH
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Deterministic dataset profiling, cleaning and citation verification
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.
dsh-fast	Read-only performance diagnostics: load, spill, compaction and cache hit rate
dsh-fund-research	Chinese mutual-fund research with sealed, traceable source snapshots
dsh-github	GitHub PR/issue/CI integration with every write approval-gated
dsh-industry-research	Industry and company research pack: chain map, policy timeline, company cards
dsh-kit	One-command starter pack that installs the core family
dsh-library	Local document knowledge base with hybrid search and citation-aware injection
dsh-local-ai	Local Ollama model discovery and task-based routing with cloud fallback
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions, symbols and rename
dsh-mask	PII masking at the model boundary with a host-side restore table
dsh-mcp-panel	MCP management console: /mcp command, Settings tab and trial calls
dsh-memento	Approval-gated cross-session memory protocol (ctx.memory + SQLite)
dsh-observe	OpenTelemetry and Langfuse telemetry export from the session event stream
dsh-output-styles	Runtime-switchable model output styles
dsh-permission-rules	Declarative allow/deny/ask rules plus a process-level network policy
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-dev knowledge base, agent skill and the dsh-plugin-dev CLI toolchain
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-portal	Zero-dependency static portal rendering the whole plugin family as one page
dsh-reach	Multi-channel approval/question bridge: WeChat, Telegram, Feishu + a session console
dsh-research-report	Verifiable research reports: evidence ledger, manifest seal, per-claim verdicts
dsh-score	Multi-dimensional plugin quality scoring with an evidence-backed leaderboard
dsh-session-pin	Pin sessions and workspaces in the Web sidebar with per-pin colors
dsh-session-sync	Git-backed cross-device session synchronization with keep-both merges
dsh-skill-pack-security	Security-audit skill pack plus the plugin_vet supply-chain gate
dsh-talk	Voice-first session loop: speech-to-text input and text-to-speech replies
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline
dsh-test-drive	Isolated install-and-smoke test drives with a pass/fail matrix
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel plus eleven agent tools
dsh-translate	Vendor parameter translation and deterministic JSON repair
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools

Parte de la familia de plugins DSH de PerryLink: más de 40 repositorios que cubren sesiones, memoria, permisos, entrega, observabilidad y herramientas para desarrolladores. Explora el catálogo en perrylink-dsh-catalog.perrylink.workers.dev o el tema dsh-plugin.

Licencia

Apache-2.0 — consulta LICENSE. Las dependencias de instalación y sus licencias están en THIRD_PARTY_NOTICES.md; no se incluye nada empaquetado.