dsh-plugin-guide 0.1.2 → 0.3.1
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.
- package/README.es.md +89 -20
- package/README.hi.md +89 -20
- package/README.md +92 -21
- package/README.pt.md +89 -20
- package/README.zh.md +92 -21
- package/SKILL.md +11 -1
- package/bin/dsh-plugin-dev.js +6 -0
- package/cordis.patch.yml +5 -0
- package/dist/dsh-plugin-dev.js +1623 -0
- package/guide/plugin-dev-guide.md +1 -1
- package/guide/quick-reference.es.md +1 -1
- package/guide/quick-reference.hi.md +1 -1
- package/guide/quick-reference.md +1 -1
- package/guide/quick-reference.pt.md +1 -1
- package/guide/quick-reference.zh-CN.md +1 -1
- package/package.json +50 -5
- package/references/harness-repo.md +1 -1
- package/references/official-docs/AGENTS.md +1 -1
- package/references/official-docs/docs/persistence-catalog.md +1 -12
- package/references/official-docs/docs/persistence-catalog.zh.md +1 -12
- package/references/official-docs/docs/subsystems/persistence.md +1 -1
- package/references/official-docs/docs/subsystems/persistence.zh.md +1 -1
- package/references/official-docs/docs/subsystems/session.md +0 -11
- package/references/official-docs/docs/subsystems/session.zh.md +0 -11
- package/scripts/check-docs-drift.ps1 +55 -0
- package/scripts/check-readme-sync.mjs +91 -0
- package/scripts/verify-artifacts.mjs +70 -0
- package/templates/js/LICENSE +15 -0
- package/templates/js/README.es.md +42 -0
- package/templates/js/README.hi.md +42 -0
- package/templates/js/README.md +42 -0
- package/templates/js/README.pt.md +42 -0
- package/templates/js/README.zh.md +42 -0
- package/templates/js/cordis.patch.yml +10 -0
- package/templates/js/index.js +38 -0
- package/templates/js/package.json +35 -0
- package/templates/js/tests/index.test.js +12 -0
- package/templates/ts/LICENSE +15 -0
- package/templates/ts/README.es.md +44 -0
- package/templates/ts/README.hi.md +44 -0
- package/templates/ts/README.md +44 -0
- package/templates/ts/README.pt.md +44 -0
- package/templates/ts/README.zh.md +44 -0
- package/templates/ts/cordis.patch.yml +10 -0
- package/templates/ts/package.json +44 -0
- package/templates/ts/src/config.ts +12 -0
- package/templates/ts/src/index.ts +36 -0
- package/templates/ts/tests/index.test.ts +12 -0
- package/templates/ts/tsconfig.json +17 -0
- package/templates/ts/tsdown.config.mjs +15 -0
- package/templates/ts/vitest.config.ts +8 -0
package/README.es.md
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
3
|
# 🐳 dsh-plugin-guide
|
|
4
|
+
- **Canal 1024 store**: `npm i -g dsh1024` una vez, luego `dsh1024 plugin --profile web add dsh-plugin-guide` (cuenta para el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com)).
|
|
4
5
|
|
|
5
6
|
**Todo lo que necesitas para construir plugins de [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).**
|
|
6
7
|
|
|
7
|
-
*Archivo de documentación oficial · primer de Cordis · deep-dives de la comunidad · trampas probadas en batalla · agent skill*
|
|
8
|
+
*Archivo de documentación oficial · primer de Cordis · deep-dives de la comunidad · trampas probadas en batalla · agent skill · toolchain CLI*
|
|
8
9
|
|
|
9
10
|
[](LICENSE)
|
|
10
11
|
[](https://github.com/topics/dsh-plugin)
|
|
@@ -38,6 +39,7 @@
|
|
|
38
39
|
- **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).
|
|
39
40
|
- **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, …).
|
|
40
41
|
- **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.
|
|
42
|
+
- **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.
|
|
41
43
|
|
|
42
44
|
## Knowledge base
|
|
43
45
|
|
|
@@ -51,8 +53,42 @@
|
|
|
51
53
|
| `references/official-docs/` | Copia textual de la documentación oficial del repo (EN + ZH) |
|
|
52
54
|
| `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) |
|
|
53
55
|
| `scripts/` | Scripts de descarga idempotentes + verificador de integridad + generador de instantáneas de tema |
|
|
56
|
+
| `bin/` · `src/cli/` · `dist/` | El CLI `dsh-plugin-dev`: scaffolder, checker, verifier (TypeScript, empaquetado con tsdown) |
|
|
57
|
+
| `templates/` | Esqueletos TS + JS: plantilla de contrato, Config, tests, cordis.patch.yml, READMEs en cinco idiomas |
|
|
54
58
|
| `downloads/` | Instantáneas crudas — generadas por `scripts/`, no confirmadas |
|
|
55
59
|
|
|
60
|
+
## CLI toolchain
|
|
61
|
+
|
|
62
|
+
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.
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
|
|
66
|
+
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
|
|
67
|
+
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
| Subcomando | Qué hace |
|
|
71
|
+
|---|---|
|
|
72
|
+
| `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`. |
|
|
73
|
+
| `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. |
|
|
74
|
+
| `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. |
|
|
75
|
+
|
|
76
|
+
### CLI configuration
|
|
77
|
+
|
|
78
|
+
El CLI no tiene ajustes hardcodeados — cada uno es un flag o una variable de entorno.
|
|
79
|
+
|
|
80
|
+
| Ajuste | Flag | Env | Por defecto |
|
|
81
|
+
|---|---|---|---|
|
|
82
|
+
| Directorio de plantillas | — | `DSH_PLUGIN_DEV_TEMPLATES` | `<package>/templates` |
|
|
83
|
+
| Binario dsh | `--dsh` | `DSH_PLUGIN_DEV_DSH` | `dsh` |
|
|
84
|
+
| Binario pnpm | `--pnpm` | `DSH_PLUGIN_DEV_PNPM` | `pnpm` |
|
|
85
|
+
| Timeout de instalación/pack | `--timeout` | `DSH_PLUGIN_DEV_TIMEOUT` | `300000` ms |
|
|
86
|
+
| Timeout de smoke headless | `--smoke-timeout` | `DSH_PLUGIN_DEV_SMOKE_TIMEOUT` | `120000` ms |
|
|
87
|
+
|
|
88
|
+
### Upstream roadmap
|
|
89
|
+
|
|
90
|
+
`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.
|
|
91
|
+
|
|
56
92
|
## Quick start
|
|
57
93
|
|
|
58
94
|
```sh
|
|
@@ -68,6 +104,14 @@ dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
|
68
104
|
|
|
69
105
|
Luego pídele a tu agente: *"Usa la skill dsh-plugin-guide para construirme un plugin de …."*
|
|
70
106
|
|
|
107
|
+
O maneja el CLI directamente:
|
|
108
|
+
|
|
109
|
+
```sh
|
|
110
|
+
npx dsh-plugin-guide new hello-plugin # genera un repo de plugin TS
|
|
111
|
+
npx dsh-plugin-guide check --json # check estático
|
|
112
|
+
npx dsh-plugin-guide verify # pack + smoke de perfil limpio
|
|
113
|
+
```
|
|
114
|
+
|
|
71
115
|
## Install & uninstall
|
|
72
116
|
|
|
73
117
|
- **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.
|
|
@@ -94,13 +138,14 @@ El instalador omite `downloads/` (generado) y `.github/`, y luego verifica cada
|
|
|
94
138
|
|
|
95
139
|
## Configuration
|
|
96
140
|
|
|
97
|
-
|
|
141
|
+
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](#cli-toolchain)).
|
|
98
142
|
|
|
99
143
|
## Tools & surfaces
|
|
100
144
|
|
|
101
145
|
| Surface | Kind | Notes |
|
|
102
146
|
|---|---|---|
|
|
103
147
|
| `dsh-plugin-guide` | skill | Registrada vía `ctx.skills`; carga `SKILL.md` + `./guide/` + `./references/` bajo demanda |
|
|
148
|
+
| `dsh-plugin-dev` | bin (CLI) | Subcomandos `new` / `check` / `verify`; no es una fila de plugin DSH |
|
|
104
149
|
|
|
105
150
|
## Permissions & data
|
|
106
151
|
|
|
@@ -133,15 +178,22 @@ pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # rutas críticas
|
|
|
133
178
|
|
|
134
179
|
## Development
|
|
135
180
|
|
|
136
|
-
El bundle es ESM plano
|
|
181
|
+
El bundle de skill (`index.js`) es ESM plano, sin paso de build; el CLI `dsh-plugin-dev` es TypeScript compilado con tsdown. Puertas:
|
|
137
182
|
|
|
138
183
|
```sh
|
|
184
|
+
pnpm install --frozen-lockfile
|
|
185
|
+
pnpm run typecheck && pnpm run typecheck:ci
|
|
186
|
+
pnpm test
|
|
187
|
+
pnpm run build
|
|
188
|
+
pnpm run verify:artifacts # auto-check + smoke de scaffold (sin red)
|
|
189
|
+
pnpm run verify:self-contained # pack + smoke de instalación/inicio/desinstalación en perfil limpio
|
|
190
|
+
pnpm pack
|
|
139
191
|
pwsh -File scripts/verify-kit.ps1 # rutas críticas + escaneo de enlaces (+ deriva de docs con -Checkout <checkout>)
|
|
140
192
|
```
|
|
141
193
|
|
|
142
194
|
## Topics
|
|
143
195
|
|
|
144
|
-
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`
|
|
196
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`, `cli`, `scaffold`, `checker`
|
|
145
197
|
|
|
146
198
|
## Contributors
|
|
147
199
|
|
|
@@ -150,25 +202,42 @@ pwsh -File scripts/verify-kit.ps1 # rutas críticas + escaneo de enlaces (+ de
|
|
|
150
202
|
|
|
151
203
|
## PerryLink DSH Plugin Family
|
|
152
204
|
|
|
153
|
-
Este proyecto es uno de los [
|
|
205
|
+
Este proyecto es uno de los [33 complementos de DeepSeek Harness](https://github.com/PerryLink) mantenidos por [PerryLink](https://github.com/PerryLink). Si este te ayuda, probablemente los demás también:
|
|
154
206
|
|
|
155
207
|
| Plugin | One-liner |
|
|
156
208
|
|---|---|
|
|
157
|
-
| [dsh-
|
|
158
|
-
| [dsh-
|
|
159
|
-
| [dsh-
|
|
160
|
-
| [dsh-
|
|
161
|
-
| [dsh-
|
|
162
|
-
| [dsh-
|
|
163
|
-
| [dsh-
|
|
164
|
-
| [dsh-
|
|
165
|
-
| [dsh-
|
|
166
|
-
| [dsh-
|
|
167
|
-
| [dsh-
|
|
168
|
-
| [dsh-
|
|
169
|
-
| [dsh-
|
|
170
|
-
| **[dsh-
|
|
171
|
-
| [dsh-
|
|
209
|
+
| **[dsh-dsh-auto-review](https://github.com/PerryLink/dsh-dsh-auto-review)** | Auto-revisión de segundo modelo en la cadena de aprobación, con cierre en fallo por defecto | |
|
|
210
|
+
| **[dsh-dsh-background-agents](https://github.com/PerryLink/dsh-dsh-background-agents)** | Agentes hijos en segundo plano durables con barra lateral de UI web, mensajería e interrupción | |
|
|
211
|
+
| **[dsh-dsh-budget](https://github.com/PerryLink/dsh-dsh-budget)** | Gobernanza de costes para DeepSeek Harness: presupuestos, carbono y latencia en un panel. | |
|
|
212
|
+
| **[dsh-dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-dsh-checkpoint-rewind)** | Equivalente a /rewind de Claude Code: instantáneas, bifurcaciones de sesión, restauración de un solo uso | |
|
|
213
|
+
| **[dsh-dsh-claude-move](https://github.com/PerryLink/dsh-dsh-claude-move)** | Migra sesiones, memoria, habilidades y CLAUDE.md de Claude Code a DSH | |
|
|
214
|
+
| **[dsh-dsh-click](https://github.com/PerryLink/dsh-dsh-click)** | Control de escritorio nativo multiplataforma para DeepSeek Harness — Windows primero. | |
|
|
215
|
+
| **[dsh-dsh-composer-history](https://github.com/PerryLink/dsh-dsh-composer-history)** | Historial de entrada estilo terminal para el compositor web: flechas, búsqueda Ctrl+R | |
|
|
216
|
+
| **[dsh-dsh-data-quality](https://github.com/PerryLink/dsh-dsh-data-quality)** | Comprobaciones de calidad de datasets y verificación de citas (el puente numérico opcional consumido aquí) | |
|
|
217
|
+
| **[dsh-dsh-defend](https://github.com/PerryLink/dsh-dsh-defend)** | Defensa contra inyección de prompts, jailbreak y fuga de secretos para DeepSeek Harness. | |
|
|
218
|
+
| **[dsh-dsh-doublecheck](https://github.com/PerryLink/dsh-dsh-doublecheck)** | Guardián de disciplina de ingeniería: interrogatorio de requisitos, puertas de pruebas, revisión adversaria | |
|
|
219
|
+
| **[dsh-dsh-draw](https://github.com/PerryLink/dsh-dsh-draw)** | Enrutamiento unificado de generación de imágenes estáticas para DeepSeek Harness. | |
|
|
220
|
+
| **[dsh-dsh-fast](https://github.com/PerryLink/dsh-dsh-fast)** | Diagnóstico de rendimiento de solo lectura para DeepSeek Harness. | |
|
|
221
|
+
| **[dsh-dsh-fund-research](https://github.com/PerryLink/dsh-dsh-fund-research)** | Informes de investigación deterministas para fondos mutuos públicos chinos | |
|
|
222
|
+
| **[dsh-dsh-github](https://github.com/PerryLink/dsh-dsh-github)** | Integración de PR/issues de GitHub para DSH, cada escritura controlada por aprobación | |
|
|
223
|
+
| **[dsh-dsh-industry-research](https://github.com/PerryLink/dsh-dsh-industry-research)** | Orquestación de investigación sectorial que sella sus entregables mediante el `ctx.researchReport.assemble` de este plugin | |
|
|
224
|
+
| **[dsh-dsh-library](https://github.com/PerryLink/dsh-dsh-library)** | Base de conocimiento documental local para DeepSeek Harness. | |
|
|
225
|
+
| **[dsh-dsh-local-ai](https://github.com/PerryLink/dsh-dsh-local-ai)** | Integración de modelos locales (Ollama) para DeepSeek Harness. | |
|
|
226
|
+
| **[dsh-dsh-lsp-actions](https://github.com/PerryLink/dsh-dsh-lsp-actions)** | Diagnósticos, formato, autocompletado, acciones de código y renombrado LSP sobre servidores de lenguaje | |
|
|
227
|
+
| **[dsh-dsh-mask](https://github.com/PerryLink/dsh-dsh-mask)** | Middleware de enmascaramiento de PII: anonimiza en el límite del modelo, restaura en la capa de visualización | |
|
|
228
|
+
| **[dsh-dsh-mcp-panel](https://github.com/PerryLink/dsh-dsh-mcp-panel)** | Panel de tiempo de ejecución MCP de solo lectura: comando /mcp + pestaña Settings con estado, herramientas y errores | |
|
|
229
|
+
| **[dsh-dsh-memento](https://github.com/PerryLink/dsh-dsh-memento)** | Memoria entre sesiones controlada por aprobación: costura ctx.memory + SQLite + herramienta de memoria | |
|
|
230
|
+
| **[dsh-dsh-observe](https://github.com/PerryLink/dsh-dsh-observe)** | Exportador de observabilidad OpenTelemetry y Langfuse para DeepSeek Harness. | |
|
|
231
|
+
| **[dsh-dsh-output-styles](https://github.com/PerryLink/dsh-dsh-output-styles)** | Cambio de estilo en tiempo de ejecución equivalente a outputStyles de Claude Code | |
|
|
232
|
+
| **[dsh-dsh-permission-rules](https://github.com/PerryLink/dsh-dsh-permission-rules)** | Reglas de permisos declarativas allow/deny/ask estilo Claude Code con auditoría | |
|
|
233
|
+
| **[dsh-dsh-research-report](https://github.com/PerryLink/dsh-dsh-research-report)** | Motor de informes de investigación verificables con evidencia direccionada por contenido | |
|
|
234
|
+
| **[dsh-dsh-score](https://github.com/PerryLink/dsh-dsh-score)** | Puntuación de calidad multidimensional para plugins de DeepSeek Harness. | |
|
|
235
|
+
| **[dsh-dsh-session-pin](https://github.com/PerryLink/dsh-dsh-session-pin)** | Fija sesiones en la barra lateral web con orden durable | |
|
|
236
|
+
| **[dsh-dsh-session-sync](https://github.com/PerryLink/dsh-dsh-session-sync)** | Sincronización de sesiones entre dispositivos para DeepSeek Harness — un espejo git dedicado de tu almacén de sesiones. | |
|
|
237
|
+
| **[dsh-dsh-skill-pack-security](https://github.com/PerryLink/dsh-dsh-skill-pack-security)** | Paquete de habilidades de auditoría de seguridad: escaneo de secretos, revisión de dependencias y cadena de suministro | |
|
|
238
|
+
| **[dsh-dsh-talk](https://github.com/PerryLink/dsh-dsh-talk)** | Bucle de sesión con voz para DeepSeek Harness: háblale y escucha su respuesta. | |
|
|
239
|
+
| **[dsh-dsh-test-drive](https://github.com/PerryLink/dsh-dsh-test-drive)** | Pruebas de instalación y humo aisladas para plugins de DeepSeek Harness. | |
|
|
240
|
+
| **[dsh-dsh-translate](https://github.com/PerryLink/dsh-dsh-translate)** | Traducción de parámetros entre proveedores y reparación determinista de JSON para DeepSeek Harness. | |
|
|
172
241
|
|
|
173
242
|
## Disclaimer
|
|
174
243
|
|
package/README.hi.md
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
3
|
# 🐳 dsh-plugin-guide
|
|
4
|
+
- **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-plugin-guide` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)।
|
|
4
5
|
|
|
5
6
|
**[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) प्लगइन बनाने के लिए आपकी ज़रूरत की हर चीज़।**
|
|
6
7
|
|
|
7
|
-
*आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill
|
|
8
|
+
*आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill · CLI टूलचेन*
|
|
8
9
|
|
|
9
10
|
[](LICENSE)
|
|
10
11
|
[](https://github.com/topics/dsh-plugin)
|
|
@@ -38,6 +39,7 @@
|
|
|
38
39
|
- **Cordis प्राइमर** — पाँच अवधारणाएँ और तंत्र समयरेखा (repository-plugin 0809 को जोड़ा, 0811 को हटाया; दो इंस्टॉल चैनल)।
|
|
39
40
|
- **20+ वास्तविक-दुनिया नुकसान** मूल कारण + समाधान सहित (cordis दोहरी प्रतियाँ, tsconfig त्रयी, बहु-फ़्रेम zstd सत्र, Windows junction, पुराना npm `latest`, …)।
|
|
40
41
|
- **सामुदायिक गहन-विश्लेषण** — 114 सामुदायिक रिपॉज़िटरी संग्रहीत (15 गहन-विश्लेषित), साथ ही पूर्ण स्रोत सूची जहाँ हर तथ्य अपने मूल से जुड़ा है।
|
|
42
|
+
- **CLI टूलचेन** — `dsh-plugin-dev new / check / verify`: DSH प्लगइन स्कैफ़ोल्ड करना, स्थैतिक जाँच और पैक-सत्यापन; हर जाँच उस skill अनुभाग से जुड़ती है जिसे वह लागू करती है।
|
|
41
43
|
|
|
42
44
|
## Knowledge base
|
|
43
45
|
|
|
@@ -51,8 +53,42 @@
|
|
|
51
53
|
| `references/official-docs/` | आधिकारिक रेपो दस्तावेज़ों की शब्दशः प्रति (EN + ZH) |
|
|
52
54
|
| `references/*.md` | शोध रिपोर्ट: रेपो दस्तावेज़, वेबसाइट, Cordis, पेपर, सामुदायिक पारिस्थितिकी, 114-रेपो संग्रह (15 गहन-विश्लेषित) |
|
|
53
55
|
| `scripts/` | इडेम्पोटेंट डाउनलोड स्क्रिप्ट + अखंडता जाँचकर्ता + विषय स्नैपशॉट जनरेटर |
|
|
56
|
+
| `bin/` · `src/cli/` · `dist/` | `dsh-plugin-dev` CLI: स्कैफ़ोल्डर, जाँचकर्ता, सत्यापक (TypeScript, tsdown-बंडल) |
|
|
57
|
+
| `templates/` | TS + JS स्कैफ़ोल्ड कंकाल: अनुबंध टेम्प्लेट, Config, टेस्ट, cordis.patch.yml, पाँच-भाषा README |
|
|
54
58
|
| `downloads/` | कच्चे स्नैपशॉट — `scripts/` से उत्पन्न, कमिट नहीं |
|
|
55
59
|
|
|
60
|
+
## CLI toolchain
|
|
61
|
+
|
|
62
|
+
बंडल शून्य-रनटाइम-निर्भरता `dsh-plugin-dev` CLI लेकर आता है (`bin/` → tsdown-बंडल `dist/dsh-plugin-dev.js`). हर जाँच उस skill अनुभाग को उद्धृत करती है जिसे वह लागू करती है, ताकि एजेंट मैन्युअल ऑडिट जारी रख सके।
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
|
|
66
|
+
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
|
|
67
|
+
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
| उप-कमांड | क्या करता है |
|
|
71
|
+
|---|---|
|
|
72
|
+
| `new <name>` | TS या JS प्लगइन रेपो स्कैफ़ोल्ड करता है: `src/index.ts` अनुबंध टेम्प्लेट, Schemastery Config, टेस्ट, tsdown/vitest, टिप्पणी-युक्त `cordis.patch.yml`, पाँच-भाषा README। इडेम्पोटेंट; `--force` के बिना गैर-खाली लक्ष्य को अस्वीकार करता है। |
|
|
73
|
+
| `check` | स्थैतिक जाँच: `cordis.patch.yml` वैधता, `package.json` मेटाडेटा (`dsh.bundle.patch` पॉइंटर, peer deps, engines, files श्वेतसूची), पाँच-भाषा README संगति, इंजीनियरिंग रेड-लाइन पैटर्न। CI-उपभोज्य JSON उत्सर्जित करता है। |
|
|
74
|
+
| `verify` | `pnpm pack`, फिर साफ़ mkdtemp `DSH_HOME` प्रोफ़ाइल में बंडल को इंस्टॉल/स्टार्ट/अनइंस्टॉल स्मोक (आधिकारिक `verify:self-contained` से संरेखित)। विफलता लॉग टेल + सुझाव देती है। |
|
|
75
|
+
|
|
76
|
+
### CLI configuration
|
|
77
|
+
|
|
78
|
+
CLI में कोई हार्डकोडेड ट्यूनेबल नहीं — हर एक flag या पर्यावरण चर है।
|
|
79
|
+
|
|
80
|
+
| ट्यूनेबल | Flag | Env | डिफ़ॉल्ट |
|
|
81
|
+
|---|---|---|---|
|
|
82
|
+
| टेम्प्लेट निर्देशिका | — | `DSH_PLUGIN_DEV_TEMPLATES` | `<package>/templates` |
|
|
83
|
+
| dsh बाइनरी | `--dsh` | `DSH_PLUGIN_DEV_DSH` | `dsh` |
|
|
84
|
+
| pnpm बाइनरी | `--pnpm` | `DSH_PLUGIN_DEV_PNPM` | `pnpm` |
|
|
85
|
+
| इंस्टॉल/पैक टाइमआउट | `--timeout` | `DSH_PLUGIN_DEV_TIMEOUT` | `300000` ms |
|
|
86
|
+
| हेडलेस स्मोक टाइमआउट | `--smoke-timeout` | `DSH_PLUGIN_DEV_SMOKE_TIMEOUT` | `120000` ms |
|
|
87
|
+
|
|
88
|
+
### Upstream roadmap
|
|
89
|
+
|
|
90
|
+
`dsh-plugin-dev` आधिकारिक प्लगइन-विकास CLI (नियोजित आइटम C12) का अपस्ट्रीम उम्मीदवार है: स्कैफ़ोल्डर/जाँचकर्ता/सत्यापक यांत्रिक परतें हैं, जबकि `SKILL.md` + `guide/` संज्ञानात्मक परत बने रहते हैं।
|
|
91
|
+
|
|
56
92
|
## Quick start
|
|
57
93
|
|
|
58
94
|
```sh
|
|
@@ -68,6 +104,14 @@ dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
|
68
104
|
|
|
69
105
|
फिर बस अपने एजेंट से पूछें: *"मुझे … प्लगइन बनाने के लिए dsh-plugin-guide skill का उपयोग करो।"*
|
|
70
106
|
|
|
107
|
+
या सीधे CLI चलाएँ:
|
|
108
|
+
|
|
109
|
+
```sh
|
|
110
|
+
npx dsh-plugin-guide new hello-plugin # TS प्लगइन रेपो स्कैफ़ोल्ड करें
|
|
111
|
+
npx dsh-plugin-guide check --json # स्थैतिक जाँच
|
|
112
|
+
npx dsh-plugin-guide verify # पैक + साफ़ प्रोफ़ाइल स्मोक
|
|
113
|
+
```
|
|
114
|
+
|
|
71
115
|
## Install & uninstall
|
|
72
116
|
|
|
73
117
|
- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha>` — पुनरुत्पादन के लिए एक कमिट पिन करें; प्रवेश बिंदु सादा ESM JS है, कोई बिल्ड चरण नहीं।
|
|
@@ -94,13 +138,14 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
|
|
|
94
138
|
|
|
95
139
|
## Configuration
|
|
96
140
|
|
|
97
|
-
|
|
141
|
+
skill बंडल कोई Schemastery `Config` उजागर नहीं करता — यह ज्ञान-आधार को बिना किसी ट्यूनेबल कुंजी के एक agent skill के रूप में पंजीकृत करता है। `dsh-plugin-dev` CLI अपने ट्यूनेबल flags और `DSH_PLUGIN_DEV_*` पर्यावरण चरों से पढ़ता है ([CLI toolchain](#cli-toolchain) देखें)।
|
|
98
142
|
|
|
99
143
|
## Tools & surfaces
|
|
100
144
|
|
|
101
145
|
| Surface | Kind | Notes |
|
|
102
146
|
|---|---|---|
|
|
103
147
|
| `dsh-plugin-guide` | skill | `ctx.skills` से पंजीकृत; माँग पर `SKILL.md` + `./guide/` + `./references/` लोड करता है |
|
|
148
|
+
| `dsh-plugin-dev` | bin (CLI) | `new` / `check` / `verify` उप-कमांड; DSH प्लगइन पंक्ति नहीं |
|
|
104
149
|
|
|
105
150
|
## Permissions & data
|
|
106
151
|
|
|
@@ -133,15 +178,22 @@ pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # महत्व
|
|
|
133
178
|
|
|
134
179
|
## Development
|
|
135
180
|
|
|
136
|
-
बंडल सादा ESM
|
|
181
|
+
skill बंडल (`index.js`) सादा ESM है, कोई बिल्ड चरण नहीं; `dsh-plugin-dev` CLI TypeScript है, tsdown से बिल्ट। द्वार:
|
|
137
182
|
|
|
138
183
|
```sh
|
|
184
|
+
pnpm install --frozen-lockfile
|
|
185
|
+
pnpm run typecheck && pnpm run typecheck:ci
|
|
186
|
+
pnpm test
|
|
187
|
+
pnpm run build
|
|
188
|
+
pnpm run verify:artifacts # आत्म-जाँच + स्कैफ़ोल्ड स्मोक (कोई नेटवर्क नहीं)
|
|
189
|
+
pnpm run verify:self-contained # पैक + साफ़ प्रोफ़ाइल इंस्टॉल/स्टार्ट/अनइंस्टॉल स्मोक
|
|
190
|
+
pnpm pack
|
|
139
191
|
pwsh -File scripts/verify-kit.ps1 # महत्वपूर्ण पथ + लिंक स्कैन (-Checkout <checkout> से दस्तावेज़ विचलन)
|
|
140
192
|
```
|
|
141
193
|
|
|
142
194
|
## Topics
|
|
143
195
|
|
|
144
|
-
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`
|
|
196
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`, `cli`, `scaffold`, `checker`
|
|
145
197
|
|
|
146
198
|
## Contributors
|
|
147
199
|
|
|
@@ -150,25 +202,42 @@ pwsh -File scripts/verify-kit.ps1 # महत्वपूर्ण पथ +
|
|
|
150
202
|
|
|
151
203
|
## PerryLink DSH Plugin Family
|
|
152
204
|
|
|
153
|
-
यह
|
|
205
|
+
यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) द्वारा अनुरक्षित [33 DeepSeek Harness प्लगइनों](https://github.com/PerryLink) में से एक है। अगर यह आपकी मदद करता है, तो बाकी भी करेंगे:
|
|
154
206
|
|
|
155
207
|
| Plugin | One-liner |
|
|
156
208
|
|---|---|
|
|
157
|
-
| [dsh-
|
|
158
|
-
| [dsh-
|
|
159
|
-
| [dsh-
|
|
160
|
-
| [dsh-
|
|
161
|
-
| [dsh-
|
|
162
|
-
| [dsh-
|
|
163
|
-
| [dsh-
|
|
164
|
-
| [dsh-
|
|
165
|
-
| [dsh-
|
|
166
|
-
| [dsh-
|
|
167
|
-
| [dsh-
|
|
168
|
-
| [dsh-
|
|
169
|
-
| [dsh-
|
|
170
|
-
| **[dsh-
|
|
171
|
-
| [dsh-
|
|
209
|
+
| **[dsh-dsh-auto-review](https://github.com/PerryLink/dsh-dsh-auto-review)** | अनुमोदन श्रृंखला पर द्वितीय-मॉडल स्वतः-समीक्षा, डिफ़ॉल्ट रूप से विफल-बंद | |
|
|
210
|
+
| **[dsh-dsh-background-agents](https://github.com/PerryLink/dsh-dsh-background-agents)** | वेब UI साइडबार, संदेश और अवरोधन के साथ टिकाऊ पृष्ठभूमि चाइल्ड एजेंट | |
|
|
211
|
+
| **[dsh-dsh-budget](https://github.com/PerryLink/dsh-dsh-budget)** | DeepSeek Harness के लिए लागत प्रशासन: बजट, कार्बन और विलंबता एक पैनल में। | |
|
|
212
|
+
| **[dsh-dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-dsh-checkpoint-rewind)** | Claude Code /rewind-समतुल्य: स्नैपशॉट, सत्र फ़ॉर्क, एक-बार पुनर्स्थापना | |
|
|
213
|
+
| **[dsh-dsh-claude-move](https://github.com/PerryLink/dsh-dsh-claude-move)** | Claude Code सत्र, मेमोरी, कौशल और CLAUDE.md को DSH में स्थानांतरित करें | |
|
|
214
|
+
| **[dsh-dsh-click](https://github.com/PerryLink/dsh-dsh-click)** | DeepSeek Harness के लिए क्रॉस-प्लेटफ़ॉर्म नेटिव डेस्कटॉप नियंत्रण — Windows पहले। | |
|
|
215
|
+
| **[dsh-dsh-composer-history](https://github.com/PerryLink/dsh-dsh-composer-history)** | वेब कंपोज़र के लिए टर्मिनल-शैली इनपुट इतिहास: तीर, Ctrl+R खोज | |
|
|
216
|
+
| **[dsh-dsh-data-quality](https://github.com/PerryLink/dsh-dsh-data-quality)** | डेटासेट गुणवत्ता जाँच व उद्धरण सत्यापन (यहाँ उपभोग किया गया वैकल्पिक संख्या-सेतु) | |
|
|
217
|
+
| **[dsh-dsh-defend](https://github.com/PerryLink/dsh-dsh-defend)** | DeepSeek Harness के लिए प्रॉम्प्ट-इंजेक्शन, जेलब्रेक और सीक्रेट-लीक रक्षा। | |
|
|
218
|
+
| **[dsh-dsh-doublecheck](https://github.com/PerryLink/dsh-dsh-doublecheck)** | इंजीनियरिंग-अनुशासन रक्षक: आवश्यकताओं की पूछताछ, परीक्षण द्वार, प्रतिद्वंद्वी समीक्षा | |
|
|
219
|
+
| **[dsh-dsh-draw](https://github.com/PerryLink/dsh-dsh-draw)** | DeepSeek Harness के लिए एकीकृत स्थैतिक-छवि निर्माण रूटिंग। | |
|
|
220
|
+
| **[dsh-dsh-fast](https://github.com/PerryLink/dsh-dsh-fast)** | DeepSeek Harness के लिए रीड-ओनली प्रदर्शन डायग्नोस्टिक्स। | |
|
|
221
|
+
| **[dsh-dsh-fund-research](https://github.com/PerryLink/dsh-dsh-fund-research)** | चीनी सार्वजनिक म्यूचुअल फंड के लिए नियतात्मक अनुसंधान रिपोर्ट | |
|
|
222
|
+
| **[dsh-dsh-github](https://github.com/PerryLink/dsh-dsh-github)** | DSH के लिए GitHub PR/issues एकीकरण, हर लेखन अनुमोदन-द्वारित | |
|
|
223
|
+
| **[dsh-dsh-industry-research](https://github.com/PerryLink/dsh-dsh-industry-research)** | उद्योग-अनुसंधान ऑर्केस्ट्रेशन जो इस प्लगिन के `ctx.researchReport.assemble` से डिलीवरेबल सील करता है | |
|
|
224
|
+
| **[dsh-dsh-library](https://github.com/PerryLink/dsh-dsh-library)** | DeepSeek Harness के लिए स्थानीय दस्तावेज़ ज्ञानकोश। | |
|
|
225
|
+
| **[dsh-dsh-local-ai](https://github.com/PerryLink/dsh-dsh-local-ai)** | DeepSeek Harness के लिए स्थानीय-मॉडल (Ollama) एकीकरण। | |
|
|
226
|
+
| **[dsh-dsh-lsp-actions](https://github.com/PerryLink/dsh-dsh-lsp-actions)** | भाषा सर्वरों पर LSP निदान, फ़ॉर्मेटिंग, पूर्णता, कोड क्रियाएँ और नाम बदलना | |
|
|
227
|
+
| **[dsh-dsh-mask](https://github.com/PerryLink/dsh-dsh-mask)** | PII मास्किंग मिडलवेयर: मॉडल सीमा पर अनाम करें, डिस्प्ले लेयर पर पुनर्स्थापित करें | |
|
|
228
|
+
| **[dsh-dsh-mcp-panel](https://github.com/PerryLink/dsh-dsh-mcp-panel)** | केवल-पढ़ने वाला MCP रनटाइम पैनल: /mcp कमांड + स्थिति, टूल और त्रुटियों वाला Settings टैब | |
|
|
229
|
+
| **[dsh-dsh-memento](https://github.com/PerryLink/dsh-dsh-memento)** | अनुमोदन-द्वारित क्रॉस-सत्र मेमोरी: ctx.memory सीम + SQLite + मेमोरी टूल | |
|
|
230
|
+
| **[dsh-dsh-observe](https://github.com/PerryLink/dsh-dsh-observe)** | DeepSeek Harness के लिए OpenTelemetry और Langfuse अवलोकनीयता निर्यातक। | |
|
|
231
|
+
| **[dsh-dsh-output-styles](https://github.com/PerryLink/dsh-dsh-output-styles)** | Claude Code outputStyles-समतुल्य रनटाइम शैली बदलाव | |
|
|
232
|
+
| **[dsh-dsh-permission-rules](https://github.com/PerryLink/dsh-dsh-permission-rules)** | ऑडिट के साथ Claude Code-शैली घोषणात्मक allow/deny/ask अनुमति नियम | |
|
|
233
|
+
| **[dsh-dsh-research-report](https://github.com/PerryLink/dsh-dsh-research-report)** | सामग्री-पता साक्ष्य और सीलबंद संस्करणों वाला सत्यापन-योग्य अनुसंधान-रिपोर्ट इंजन | |
|
|
234
|
+
| **[dsh-dsh-score](https://github.com/PerryLink/dsh-dsh-score)** | DeepSeek Harness प्लगिनों की बहु-आयामी गुणवत्ता स्कोरिंग। | |
|
|
235
|
+
| **[dsh-dsh-session-pin](https://github.com/PerryLink/dsh-dsh-session-pin)** | टिकाऊ क्रम के साथ वेब साइडबार में सत्र पिन करें | |
|
|
236
|
+
| **[dsh-dsh-session-sync](https://github.com/PerryLink/dsh-dsh-session-sync)** | DeepSeek Harness के लिए क्रॉस-डिवाइस सत्र सिंक — आपके सत्र स्टोर का एक समर्पित git मिरर। | |
|
|
237
|
+
| **[dsh-dsh-skill-pack-security](https://github.com/PerryLink/dsh-dsh-skill-pack-security)** | सुरक्षा-ऑडिट कौशल पैक: गुप्त स्कैन, निर्भरता और आपूर्ति-श्रृंखला समीक्षा | |
|
|
238
|
+
| **[dsh-dsh-talk](https://github.com/PerryLink/dsh-dsh-talk)** | DeepSeek Harness के लिए आवाज़-प्रथम सत्र लूप: बोलें और उत्तर सुनें। | |
|
|
239
|
+
| **[dsh-dsh-test-drive](https://github.com/PerryLink/dsh-dsh-test-drive)** | DeepSeek Harness प्लगिनों के लिए पृथक इंस्टॉल-एंड-स्मोक टेस्ट ड्राइव। | |
|
|
240
|
+
| **[dsh-dsh-translate](https://github.com/PerryLink/dsh-dsh-translate)** | DeepSeek Harness के लिए वेंडर पैरामीटर अनुवाद और नियतात्मक JSON मरम्मत। | |
|
|
172
241
|
|
|
173
242
|
## Disclaimer
|
|
174
243
|
|
package/README.md
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
3
|
# 🐳 dsh-plugin-guide
|
|
4
|
+
- **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-plugin-guide` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
|
|
4
5
|
[](https://gitee.com/perrylink/dsh-plugin-guide)
|
|
5
6
|
|
|
6
7
|
**Everything you need to build [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugins.**
|
|
7
8
|
|
|
8
|
-
*Official docs archive · Cordis primer · community deep-dives · battle-tested pitfalls · agent skill*
|
|
9
|
+
*Official docs archive · Cordis primer · community deep-dives · battle-tested pitfalls · agent skill · CLI toolchain*
|
|
10
|
+
|
|
11
|
+
> **Official repository.** This is the only official repository of dsh-plugin-guide, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
|
|
9
12
|
|
|
10
13
|
[](LICENSE)
|
|
11
14
|
[](https://github.com/topics/dsh-plugin)
|
|
@@ -32,13 +35,14 @@
|
|
|
32
35
|
|
|
33
36
|
## What you get
|
|
34
37
|
|
|
35
|
-
`dsh-plugin-guide` is the DSH plugin-development knowledge base, packaged as
|
|
38
|
+
`dsh-plugin-guide` is the DSH plugin-development knowledge base plus a CLI toolchain, packaged as one installable bundle. The knowledge base registers as the `dsh-plugin-guide` agent skill (visible in every session catalog, loading workflow steps, official docs, and community deep-dives on demand); the `dsh-plugin-dev` CLI adds three mechanical layers on top of it.
|
|
36
39
|
|
|
37
40
|
- **Plugin contract & hard rules** — effects/disposers, waterfall `next()`, model-visible ⟺ logged, Schemastery config.
|
|
38
41
|
- **Official docs archive** — a verbatim copy of the official repo docs (EN + ZH), byte-identical to upstream at the last verified snapshot.
|
|
39
42
|
- **Cordis primer** — the five concepts and the mechanism timeline (repository-plugin introduced 0809, removed 0811; the two install channels).
|
|
40
43
|
- **20+ real-world pitfalls** with root cause + fix (cordis dual copies, tsconfig trio, multi-frame zstd sessions, Windows junctions, stale npm `latest`, …).
|
|
41
44
|
- **Community deep-dives** — 114 community repositories archived (15 deep-dived), plus a full source index where every fact links to its origin.
|
|
45
|
+
- **CLI toolchain** — `dsh-plugin-dev new / check / verify`: scaffold, static-check, and pack-verify DSH plugins; every check links back to the skill section it enforces.
|
|
42
46
|
|
|
43
47
|
## Knowledge base
|
|
44
48
|
|
|
@@ -52,8 +56,42 @@
|
|
|
52
56
|
| `references/official-docs/` | Verbatim copy of the official repo docs (EN + ZH) |
|
|
53
57
|
| `references/*.md` | Research reports: repo docs, website, Cordis, the paper, community ecosystem, 114-repo archive (15 deep-dived) |
|
|
54
58
|
| `scripts/` | Idempotent download scripts + integrity checker + topic snapshot generator |
|
|
59
|
+
| `bin/` · `src/cli/` · `dist/` | The `dsh-plugin-dev` CLI: scaffolder, checker, verifier (TypeScript, tsdown-bundled) |
|
|
60
|
+
| `templates/` | TS + JS scaffold skeletons: contract template, Config, tests, cordis.patch.yml, five-language READMEs |
|
|
55
61
|
| `downloads/` | Raw snapshots — generated by `scripts/`, not committed |
|
|
56
62
|
|
|
63
|
+
## CLI toolchain
|
|
64
|
+
|
|
65
|
+
The bundle ships the zero-runtime-dependency `dsh-plugin-dev` CLI (`bin/` → tsdown-bundled `dist/dsh-plugin-dev.js`). Each check cites the skill section it enforces, so an agent can keep auditing manually.
|
|
66
|
+
|
|
67
|
+
```sh
|
|
68
|
+
dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
|
|
69
|
+
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
|
|
70
|
+
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
| Subcommand | What it does |
|
|
74
|
+
|---|---|
|
|
75
|
+
| `new <name>` | Scaffolds a TS or JS plugin repo: `src/index.ts` contract template, Schemastery Config, tests, tsdown/vitest, commented `cordis.patch.yml`, five-language READMEs. Idempotent; refuses non-empty targets without `--force`. |
|
|
76
|
+
| `check` | Static checks: `cordis.patch.yml` validity, `package.json` metadata (`dsh.bundle.patch` pointer, peer deps, engines, files whitelist), five-language README consistency, engineering red-line patterns. Emits CI-consumable JSON. |
|
|
77
|
+
| `verify` | `pnpm pack`, then install/start/uninstall the bundle in a clean mkdtemp `DSH_HOME` profile (aligned with `verify:self-contained`). Failures report the log tail plus suggestions. |
|
|
78
|
+
|
|
79
|
+
### CLI configuration
|
|
80
|
+
|
|
81
|
+
The CLI has no hardcoded tunables — each is a flag or an environment variable.
|
|
82
|
+
|
|
83
|
+
| Tunable | Flag | Env | Default |
|
|
84
|
+
|---|---|---|---|
|
|
85
|
+
| Templates directory | — | `DSH_PLUGIN_DEV_TEMPLATES` | `<package>/templates` |
|
|
86
|
+
| dsh binary | `--dsh` | `DSH_PLUGIN_DEV_DSH` | `dsh` |
|
|
87
|
+
| pnpm binary | `--pnpm` | `DSH_PLUGIN_DEV_PNPM` | `pnpm` |
|
|
88
|
+
| Install/pack timeout | `--timeout` | `DSH_PLUGIN_DEV_TIMEOUT` | `300000` ms |
|
|
89
|
+
| Headless smoke timeout | `--smoke-timeout` | `DSH_PLUGIN_DEV_SMOKE_TIMEOUT` | `120000` ms |
|
|
90
|
+
|
|
91
|
+
### Upstream roadmap
|
|
92
|
+
|
|
93
|
+
`dsh-plugin-dev` is an upstream candidate for the official plugin-development CLI (planned item C12): the scaffolder/checker/verifier are the mechanical layers, while `SKILL.md` + `guide/` stay the cognitive layer.
|
|
94
|
+
|
|
57
95
|
## Quick start
|
|
58
96
|
|
|
59
97
|
```sh
|
|
@@ -69,6 +107,14 @@ dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
|
69
107
|
|
|
70
108
|
Then just ask your agent: *"Use the dsh-plugin-guide skill to build me a … plugin."*
|
|
71
109
|
|
|
110
|
+
Or drive the CLI directly:
|
|
111
|
+
|
|
112
|
+
```sh
|
|
113
|
+
npx dsh-plugin-guide new hello-plugin # scaffold a TS plugin repo
|
|
114
|
+
npx dsh-plugin-guide check --json # static-check it
|
|
115
|
+
npx dsh-plugin-guide verify # pack + clean-profile smoke
|
|
116
|
+
```
|
|
117
|
+
|
|
72
118
|
## Install & uninstall
|
|
73
119
|
|
|
74
120
|
- **git channel** (latest `main`): `dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha>` — pin a commit for reproducibility; the entry point is plain ESM JS, no build step.
|
|
@@ -95,13 +141,14 @@ The installer skips `downloads/` (generated) and `.github/`, then verifies every
|
|
|
95
141
|
|
|
96
142
|
## Configuration
|
|
97
143
|
|
|
98
|
-
|
|
144
|
+
The skill bundle exposes no Schemastery `Config` — it registers the knowledge base as an agent skill with no tunable keys. The `dsh-plugin-dev` CLI reads its tunables from flags and `DSH_PLUGIN_DEV_*` environment variables (see [CLI toolchain](#cli-toolchain)).
|
|
99
145
|
|
|
100
146
|
## Tools & surfaces
|
|
101
147
|
|
|
102
148
|
| Surface | Kind | Notes |
|
|
103
149
|
|---|---|---|
|
|
104
150
|
| `dsh-plugin-guide` | skill | Registered via `ctx.skills`; loads `SKILL.md` + `./guide/` + `./references/` on demand |
|
|
151
|
+
| `dsh-plugin-dev` | bin (CLI) | `new` / `check` / `verify` subcommands; not a DSH plugin row |
|
|
105
152
|
|
|
106
153
|
## Permissions & data
|
|
107
154
|
|
|
@@ -134,15 +181,22 @@ pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # critical paths +
|
|
|
134
181
|
|
|
135
182
|
## Development
|
|
136
183
|
|
|
137
|
-
The bundle is plain ESM
|
|
184
|
+
The skill bundle (`index.js`) is plain ESM with no build step; the `dsh-plugin-dev` CLI is TypeScript built by tsdown. Gates:
|
|
138
185
|
|
|
139
186
|
```sh
|
|
187
|
+
pnpm install --frozen-lockfile
|
|
188
|
+
pnpm run typecheck && pnpm run typecheck:ci
|
|
189
|
+
pnpm test
|
|
190
|
+
pnpm run build
|
|
191
|
+
pnpm run verify:artifacts # dogfood self-check + scaffold smoke (no network)
|
|
192
|
+
pnpm run verify:self-contained # pack + clean-profile install/start/uninstall smoke
|
|
193
|
+
pnpm pack
|
|
140
194
|
pwsh -File scripts/verify-kit.ps1 # critical paths + link scan (+ docs drift with -Checkout <checkout>)
|
|
141
195
|
```
|
|
142
196
|
|
|
143
197
|
## Topics
|
|
144
198
|
|
|
145
|
-
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`
|
|
199
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`, `cli`, `scaffold`, `checker`
|
|
146
200
|
|
|
147
201
|
## Contributors
|
|
148
202
|
|
|
@@ -151,25 +205,42 @@ pwsh -File scripts/verify-kit.ps1 # critical paths + link scan (+ docs drift w
|
|
|
151
205
|
|
|
152
206
|
## PerryLink DSH Plugin Family
|
|
153
207
|
|
|
154
|
-
This project is one of the [
|
|
208
|
+
This project is one of the [33 DeepSeek Harness plugins](https://github.com/PerryLink) maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
|
|
155
209
|
|
|
156
210
|
| Plugin | One-liner |
|
|
157
211
|
|---|---|
|
|
158
|
-
| [dsh-
|
|
159
|
-
| [dsh-
|
|
160
|
-
| [dsh-
|
|
161
|
-
| [dsh-
|
|
162
|
-
| [dsh-
|
|
163
|
-
| [dsh-
|
|
164
|
-
| [dsh-
|
|
165
|
-
| [dsh-
|
|
166
|
-
| [dsh-
|
|
167
|
-
| [dsh-
|
|
168
|
-
| [dsh-
|
|
169
|
-
| [dsh-
|
|
170
|
-
| [dsh-
|
|
171
|
-
| **[dsh-
|
|
172
|
-
| [dsh-
|
|
212
|
+
| **[dsh-dsh-auto-review](https://github.com/PerryLink/dsh-dsh-auto-review)** | Second-model auto-review on the approval chain, fail-closed by default | |
|
|
213
|
+
| **[dsh-dsh-background-agents](https://github.com/PerryLink/dsh-dsh-background-agents)** | Durable background child agents with a Web UI sidebar, messaging and interrupt | |
|
|
214
|
+
| **[dsh-dsh-budget](https://github.com/PerryLink/dsh-dsh-budget)** | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. | |
|
|
215
|
+
| **[dsh-dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-dsh-checkpoint-rewind)** | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore | |
|
|
216
|
+
| **[dsh-dsh-claude-move](https://github.com/PerryLink/dsh-dsh-claude-move)** | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH | |
|
|
217
|
+
| **[dsh-dsh-click](https://github.com/PerryLink/dsh-dsh-click)** | Cross-platform native desktop control for DeepSeek Harness — Windows first. | |
|
|
218
|
+
| **[dsh-dsh-composer-history](https://github.com/PerryLink/dsh-dsh-composer-history)** | Terminal-style input history for the web composer: arrows, Ctrl+R search | |
|
|
219
|
+
| **[dsh-dsh-data-quality](https://github.com/PerryLink/dsh-dsh-data-quality)** | Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here) | |
|
|
220
|
+
| **[dsh-dsh-defend](https://github.com/PerryLink/dsh-dsh-defend)** | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. | |
|
|
221
|
+
| **[dsh-dsh-doublecheck](https://github.com/PerryLink/dsh-dsh-doublecheck)** | Engineering-discipline guard: requirements grill, test gates, adversary review | |
|
|
222
|
+
| **[dsh-dsh-draw](https://github.com/PerryLink/dsh-dsh-draw)** | Unified static-image generation routing for DeepSeek Harness. | |
|
|
223
|
+
| **[dsh-dsh-fast](https://github.com/PerryLink/dsh-dsh-fast)** | Read-only performance diagnostics for DeepSeek Harness. | |
|
|
224
|
+
| **[dsh-dsh-fund-research](https://github.com/PerryLink/dsh-dsh-fund-research)** | Deterministic research reports for Chinese public mutual funds | |
|
|
225
|
+
| **[dsh-dsh-github](https://github.com/PerryLink/dsh-dsh-github)** | GitHub PR/issues integration for DSH, every write gated by approval | |
|
|
226
|
+
| **[dsh-dsh-industry-research](https://github.com/PerryLink/dsh-dsh-industry-research)** | Industry research orchestration that seals its deliverables through this plugin's `ctx.researchReport.assemble` | |
|
|
227
|
+
| **[dsh-dsh-library](https://github.com/PerryLink/dsh-dsh-library)** | Local document knowledge base for DeepSeek Harness. | |
|
|
228
|
+
| **[dsh-dsh-local-ai](https://github.com/PerryLink/dsh-dsh-local-ai)** | Local-model (Ollama) integration for DeepSeek Harness. | |
|
|
229
|
+
| **[dsh-dsh-lsp-actions](https://github.com/PerryLink/dsh-dsh-lsp-actions)** | LSP diagnostics, formatting, completion, code actions and rename over language servers | |
|
|
230
|
+
| **[dsh-dsh-mask](https://github.com/PerryLink/dsh-dsh-mask)** | PII masking middleware: anonymize at the model boundary, restore at the display layer | |
|
|
231
|
+
| **[dsh-dsh-mcp-panel](https://github.com/PerryLink/dsh-dsh-mcp-panel)** | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors | |
|
|
232
|
+
| **[dsh-dsh-memento](https://github.com/PerryLink/dsh-dsh-memento)** | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool | |
|
|
233
|
+
| **[dsh-dsh-observe](https://github.com/PerryLink/dsh-dsh-observe)** | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. | |
|
|
234
|
+
| **[dsh-dsh-output-styles](https://github.com/PerryLink/dsh-dsh-output-styles)** | Claude Code outputStyles-equivalent runtime style switching | |
|
|
235
|
+
| **[dsh-dsh-permission-rules](https://github.com/PerryLink/dsh-dsh-permission-rules)** | Claude Code-style declarative allow/deny/ask permission rules with audit | |
|
|
236
|
+
| **[dsh-dsh-research-report](https://github.com/PerryLink/dsh-dsh-research-report)** | Verifiable research-report engine: content-addressed evidence ledger and sealed versions | |
|
|
237
|
+
| **[dsh-dsh-score](https://github.com/PerryLink/dsh-dsh-score)** | Multi-dimensional quality scoring for DeepSeek Harness plugins. | |
|
|
238
|
+
| **[dsh-dsh-session-pin](https://github.com/PerryLink/dsh-dsh-session-pin)** | Pin sessions in the Web sidebar with durable ordering | |
|
|
239
|
+
| **[dsh-dsh-session-sync](https://github.com/PerryLink/dsh-dsh-session-sync)** | Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store. | |
|
|
240
|
+
| **[dsh-dsh-skill-pack-security](https://github.com/PerryLink/dsh-dsh-skill-pack-security)** | Security-audit skill pack: secret scan, dependency and supply-chain review | |
|
|
241
|
+
| **[dsh-dsh-talk](https://github.com/PerryLink/dsh-dsh-talk)** | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. | |
|
|
242
|
+
| **[dsh-dsh-test-drive](https://github.com/PerryLink/dsh-dsh-test-drive)** | Isolated install-and-smoke test drives for DeepSeek Harness plugins. | |
|
|
243
|
+
| **[dsh-dsh-translate](https://github.com/PerryLink/dsh-dsh-translate)** | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. | |
|
|
173
244
|
|
|
174
245
|
## Disclaimer
|
|
175
246
|
|