---

Compatibility

Surface	Status
Harness	DeepSeek Harness 0.1.1-rc.2
Node	`^22.19.0
Platforms	Todas (bundle ESM plano; sin código nativo, sin red)
Model	Cualquiera (sin interacción con el modelo)

What you get

dsh-plugin-guide es la base de conocimiento de desarrollo de plugins DSH, empaquetada como un bundle instalable que registra todo como la skill de agente dsh-plugin-guide. La skill permanece visible en el catálogo de cada sesión y carga sus pasos de flujo de trabajo, documentación oficial y deep-dives de la comunidad bajo demanda.

• Contrato de plugin y reglas duras — effects/disposers, waterfall next(), visible para el modelo ⟺ registrado, configuración Schemastery.
• Archivo de documentación oficial — una copia textual de la documentación oficial del repo (EN + ZH), byte-idéntica al upstream en la última instantánea verificada.
• Primer de Cordis — los cinco conceptos y la línea de tiempo de mecanismos (repository-plugin introducido 0809, eliminado 0811; los dos canales de instalación).
• 20+ trampas del mundo real con causa raíz + arreglo (copias duales de cordis, trío tsconfig, sesiones zstd multi-frame, junctions de Windows, latest obsoleto de npm, …).
• Deep-dives de la comunidad — 114 repositorios de la comunidad archivados (15 con deep-dive), más un índice fuente completo donde cada hecho enlaza a su origen.
• Toolchain CLI — dsh-plugin-dev new / check / verify: genera, verifica estáticamente y valida el empaquetado de plugins DSH; cada check enlaza a la sección de la skill que aplica.

Knowledge base

Path	Qué es
SKILL.md	La skill de agente dsh-plugin-guide: reglas duras + rutas de desarrollo por tarea
package.json · cordis.patch.yml · index.js	El bundle DSH instalable: manifiesto dsh.bundle.patch + punto de entrada que registra la skill
guide/plugin-dev-guide.md	La guía de desarrollo completa (10 capítulos)
guide/quick-reference.md	Hoja de referencia de una página (5 idiomas)
guide/links.md	Índice de URL curado: documentación oficial de desarrollo (sitio ↔ copias locales) + enlaces de documentación de la comunidad
references/official-docs/	Copia textual de la documentación oficial del repo (EN + ZH)
references/*.md	Informes de investigación: documentación del repo, sitio web, Cordis, el paper, ecosistema de la comunidad, archivo de 114 repos (15 con deep-dive)
scripts/	Scripts de descarga idempotentes + verificador de integridad + generador de instantáneas de tema
bin/ · src/cli/ · dist/	El CLI dsh-plugin-dev: scaffolder, checker, verifier (TypeScript, empaquetado con tsdown)
templates/	Esqueletos TS + JS: plantilla de contrato, Config, tests, cordis.patch.yml, READMEs en cinco idiomas
downloads/	Instantáneas crudas — generadas por scripts/, no confirmadas

CLI toolchain

El bundle incluye el CLI dsh-plugin-dev sin dependencias de runtime (bin/ → dist/dsh-plugin-dev.js empaquetado con tsdown). Cada check cita la sección de la skill que aplica, para que un agente pueda seguir auditando manualmente.

dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]

Subcomando	Qué hace
new <name>	Genera un repo de plugin TS o JS: plantilla de contrato src/index.ts, Config de Schemastery, tests, tsdown/vitest, cordis.patch.yml comentado, READMEs en cinco idiomas. Idempotente; rechaza destinos no vacíos sin --force.
check	Checks estáticos: validez de cordis.patch.yml, metadatos de package.json (puntero dsh.bundle.patch, peer deps, engines, lista blanca de files), consistencia de READMEs en cinco idiomas, patrones de línea roja de ingeniería. Emite JSON consumible por CI.
verify	pnpm pack, luego instala/inicia/desinstala el bundle en un perfil DSH_HOME mkdtemp limpio (alineado con verify:self-contained). Los fallos reportan la cola del log más sugerencias.

CLI configuration

El CLI no tiene ajustes hardcodeados — cada uno es un flag o una variable de entorno.

Ajuste	Flag	Env	Por defecto
Directorio de plantillas	—	DSH_PLUGIN_DEV_TEMPLATES	<package>/templates
Binario dsh	--dsh	DSH_PLUGIN_DEV_DSH	dsh
Binario pnpm	--pnpm	DSH_PLUGIN_DEV_PNPM	pnpm
Timeout de instalación/pack	--timeout	DSH_PLUGIN_DEV_TIMEOUT	300000 ms
Timeout de smoke headless	--smoke-timeout	DSH_PLUGIN_DEV_SMOKE_TIMEOUT	120000 ms

Upstream roadmap

dsh-plugin-dev es un candidato upstream para el CLI oficial de desarrollo de plugins (ítem C12): el scaffolder/checker/verifier son las capas mecánicas, mientras que SKILL.md + guide/ siguen siendo la capa cognitiva.

Quick start

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-plugin-guide#main"

# or from npm (published releases)
dsh plugin --profile web add dsh-plugin-guide

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'

Luego pídele a tu agente: "Usa la skill dsh-plugin-guide para construirme un plugin de …."

O maneja el CLI directamente:

npx dsh-plugin-guide new hello-plugin            # genera un repo de plugin TS
npx dsh-plugin-guide check --json                # check estático
npx dsh-plugin-guide verify                      # pack + smoke de perfil limpio

Install & uninstall

• canal git (último main): dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha> — fija un commit para reproducibilidad; el punto de entrada es JS ESM plano, sin paso de build.
• canal npm (versiones publicadas): dsh plugin --profile web add dsh-plugin-guide.
• canal tarball: pnpm pack en este repo, luego dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz.
• desinstalar: dsh plugin --profile web remove dsh-plugin-guide.

Copy as a plain agent skill

También puedes copiar la carpeta completa al directorio de skills de tu agente (las rutas relativas permanecen intactas):

# Windows (PowerShell)
pwsh -File scripts/install-skill.ps1 `
  -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide"   # o <project>\.agents\skills\dsh-plugin-guide

# macOS / Linux
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide   # o <project>/.agents/skills/dsh-plugin-guide

El instalador omite downloads/ (generado) y .github/, y luego verifica cada archivo copiado byte a byte. Un Copy-Item -Recurse manual de toda la carpeta también funciona.

Configuration

El bundle de skill no expone ningún Config de Schemastery — registra la base de conocimiento como una skill de agente sin claves ajustables. El CLI dsh-plugin-dev lee sus ajustes de flags y variables de entorno DSH_PLUGIN_DEV_* (ver CLI toolchain).

Tools & surfaces

Surface	Kind	Notes
dsh-plugin-guide	skill	Registrada vía ctx.skills; carga SKILL.md + ./guide/ + ./references/ bajo demanda
dsh-plugin-dev	bin (CLI)	Subcomandos new / check / verify; no es una fila de plugin DSH

Permissions & data

• Permissions: declara filesystem:read en su manifiesto de workshop.
• Data: solo lectura — lee sus propios archivos empaquetados guide/ y references/. Sin solicitudes de red, sin escrituras, sin llamadas al modelo.

Security boundaries

• Base de conocimiento de solo lectura. El bundle solo lee sus propios archivos; nunca escribe, nunca usa la red y nunca invoca un modelo.
• La documentación oficial son copias textuales. references/official-docs/ nunca se edita aquí; reporta problemas al upstream y vuelve a sincronizar solo con scripts/sync-official-docs.ps1.
• Límites de distribución. El contenido de terceros empaquetado conserva su licencia de upstream; consulta NOTICE.md (p. ej. downloads/ es solo local; awesome-dsh-plugins no debe redistribuirse).

Known limitations

• La documentación oficial es una instantánea. Vuelve a sincronizar con scripts/sync-official-docs.ps1 cuando el upstream se mueva; el sello de frescura y el hash de commit referencian references/official-docs/SNAPSHOT.md.
• downloads/ es generado, no confirmado. Las instantáneas crudas (archivos de repos de la comunidad, Discussions, artículos) deben generarse con los scripts antes de usarse.
• El contenido de awesome-dsh-plugins es solo local. Su upstream declara una restricción de uso interno, por lo que no se redistribuye con el repo.

Keeping it fresh

pwsh -File scripts/sync-official-docs.ps1                     # copia textual de docs desde un checkout local
pwsh -File scripts/download-sources.ps1                       # sitio/docs oficiales, Cordis, paper
pwsh -File scripts/download-community-repos.ps1               # repositorios de la comunidad (tarballs codeload)
pwsh -File scripts/download-community-articles.ps1            # artículos de la comunidad zh/en/HN
pwsh -File scripts/archive-discussions.ps1                    # Discussions oficiales (necesita $env:GH_TOKEN)
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir>       # censo del tema dsh-plugin
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>        # rutas críticas + escaneo de enlaces + deriva de docs

Development

El bundle de skill (index.js) es ESM plano, sin paso de build; el CLI dsh-plugin-dev es TypeScript compilado con tsdown. Puertas:

pnpm install --frozen-lockfile
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:artifacts        # auto-check + smoke de scaffold (sin red)
pnpm run verify:self-contained   # pack + smoke de instalación/inicio/desinstalación en perfil limpio
pnpm pack
pwsh -File scripts/verify-kit.ps1   # rutas críticas + escaneo de enlaces (+ deriva de docs con -Checkout <checkout>)

Topics

dsh, deepseek-harness, dsh-plugin, cordis, agent-skill, plugin-development, knowledge-base, cli, scaffold, checker

Contributors

• PerryLink — creador y mantenedor: contenido de la base de conocimiento, la transformación a bundle instalable, envíos al ecosistema e ingeniería de comunidad.
• El mantenimiento diario está asistido por agentes de DeepSeek Harness (no tienen cuenta de GitHub y se listan aquí por transparencia, no como contribuyentes).

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-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-test-drive	Pruebas de instalación y humo aisladas para plugins de DeepSeek Harness.
dsh-dsh-translate	Traducción de parámetros entre proveedores y reparación determinista de JSON para DeepSeek Harness.

Disclaimer

Mantenido por la comunidad, no es un producto oficial de DeepSeek. DeepSeek Harness está en vista previa de desarrollador y publica cambios rompedores; ante la duda, la documentación oficial en references/official-docs/ es la fuente de verdad.

License

Apache License 2.0 © 2026 dsh-plugin-guide contributors — nuestro propio texto (SKILL.md, guide/, references/, scripts/, este README) es Apache-2.0; el contenido de terceros empaquetado se documenta en NOTICE.md.