dsh-plugin-guide 0.1.0 → 0.1.2
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 +127 -87
- package/README.hi.md +128 -87
- package/README.md +180 -165
- package/README.pt.md +126 -86
- package/README.zh.md +179 -0
- package/package.json +4 -4
- package/references/official-docs/CLAUDE.md +1 -1
- package/references/official-docs/SNAPSHOT.md +16 -16
- package/scripts/verify-kit.ps1 +1 -1
- package/README.zh-CN.md +0 -164
package/README.es.md
CHANGED
|
@@ -2,138 +2,178 @@
|
|
|
2
2
|
|
|
3
3
|
# 🐳 dsh-plugin-guide
|
|
4
4
|
|
|
5
|
-
**Todo lo que necesitas para
|
|
5
|
+
**Todo lo que necesitas para construir plugins de [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).**
|
|
6
6
|
|
|
7
|
-
Archivo de documentación oficial ·
|
|
7
|
+
*Archivo de documentación oficial · primer de Cordis · deep-dives de la comunidad · trampas probadas en batalla · agent skill*
|
|
8
8
|
|
|
9
|
-
[
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
10
16
|
|
|
11
|
-
[
|
|
12
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/network/members)
|
|
13
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
|
|
14
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
15
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
16
|
-
[](LICENSE)
|
|
17
|
-
[](https://github.com/topics/dsh)
|
|
18
|
-
[](https://github.com/topics/dsh-plugin)
|
|
19
|
-
[](references/official-docs/)
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
20
18
|
|
|
21
19
|
</div>
|
|
22
20
|
|
|
23
|
-
|
|
24
|
-
>
|
|
25
|
-
> ⏱️ **Verificado por última vez el 2026-08-15** — documentación oficial idéntica byte a byte al `master` upstream (47f9438, véase [SNAPSHOT.md](references/official-docs/SNAPSHOT.md)); etiquetas npm y el topic `dsh-plugin` (API total_count subió **2668 → 2671** durante el snapshot del 08-15; 998 repos capturados, véase [sources.md](references/sources.md) §D.2) re-verificados en vivo; HEAD upstream (47f9438) y npm `@deepseek-ai/dsh` (0.1.0-rc.6) sin cambios.
|
|
21
|
+
---
|
|
26
22
|
|
|
27
|
-
##
|
|
23
|
+
## Compatibility
|
|
28
24
|
|
|
29
|
-
|
|
|
30
|
-
|
|
31
|
-
|
|
|
25
|
+
| Surface | Status |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Harness | DeepSeek Harness `0.1.1-rc.2` |
|
|
28
|
+
| Node | `^22.19.0 || >=24.0.0` (runtime de DeepSeek Harness) |
|
|
29
|
+
| Platforms | Todas (bundle ESM plano; sin código nativo, sin red) |
|
|
30
|
+
| Model | Cualquiera (sin interacción con el modelo) |
|
|
31
|
+
|
|
32
|
+
## What you get
|
|
33
|
+
|
|
34
|
+
`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.
|
|
32
35
|
|
|
33
|
-
|
|
36
|
+
- **Contrato de plugin y reglas duras** — effects/disposers, waterfall `next()`, visible para el modelo ⟺ registrado, configuración Schemastery.
|
|
37
|
+
- **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.
|
|
38
|
+
- **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
|
+
- **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
|
+
- **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.
|
|
34
41
|
|
|
35
|
-
|
|
42
|
+
## Knowledge base
|
|
43
|
+
|
|
44
|
+
| Path | Qué es |
|
|
45
|
+
|---|---|
|
|
46
|
+
| `SKILL.md` | La skill de agente `dsh-plugin-guide`: reglas duras + rutas de desarrollo por tarea |
|
|
47
|
+
| `package.json` · `cordis.patch.yml` · `index.js` | El bundle DSH instalable: manifiesto `dsh.bundle.patch` + punto de entrada que registra la skill |
|
|
48
|
+
| `guide/plugin-dev-guide.md` | La guía de desarrollo completa (10 capítulos) |
|
|
49
|
+
| `guide/quick-reference.md` | Hoja de referencia de una página (5 idiomas) |
|
|
50
|
+
| `guide/links.md` | Índice de URL curado: documentación oficial de desarrollo (sitio ↔ copias locales) + enlaces de documentación de la comunidad |
|
|
51
|
+
| `references/official-docs/` | Copia textual de la documentación oficial del repo (EN + ZH) |
|
|
52
|
+
| `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
|
+
| `scripts/` | Scripts de descarga idempotentes + verificador de integridad + generador de instantáneas de tema |
|
|
54
|
+
| `downloads/` | Instantáneas crudas — generadas por `scripts/`, no confirmadas |
|
|
36
55
|
|
|
37
|
-
|
|
56
|
+
## Quick start
|
|
38
57
|
|
|
39
58
|
```sh
|
|
40
|
-
|
|
41
|
-
|
|
59
|
+
# 1. install the bundle into your profile
|
|
60
|
+
dsh plugin --profile web add "github:PerryLink/dsh-plugin-guide#main"
|
|
61
|
+
|
|
62
|
+
# or from npm (published releases)
|
|
63
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
64
|
+
|
|
65
|
+
# 2. restart and verify the row
|
|
66
|
+
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
42
67
|
```
|
|
43
68
|
|
|
44
|
-
|
|
69
|
+
Luego pídele a tu agente: *"Usa la skill dsh-plugin-guide para construirme un plugin de …."*
|
|
45
70
|
|
|
46
|
-
|
|
71
|
+
## Install & uninstall
|
|
47
72
|
|
|
48
|
-
|
|
73
|
+
- **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.
|
|
74
|
+
- **canal npm** (versiones publicadas): `dsh plugin --profile web add dsh-plugin-guide`.
|
|
75
|
+
- **canal tarball**: `pnpm pack` en este repo, luego `dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz`.
|
|
76
|
+
- **desinstalar**: `dsh plugin --profile web remove dsh-plugin-guide`.
|
|
49
77
|
|
|
50
|
-
|
|
78
|
+
## Copy as a plain agent skill
|
|
79
|
+
|
|
80
|
+
También puedes copiar la carpeta completa al directorio de skills de tu agente (las rutas relativas permanecen intactas):
|
|
51
81
|
|
|
52
82
|
```powershell
|
|
83
|
+
# Windows (PowerShell)
|
|
53
84
|
pwsh -File scripts/install-skill.ps1 `
|
|
54
|
-
-Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # o <
|
|
85
|
+
-Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # o <project>\.agents\skills\dsh-plugin-guide
|
|
55
86
|
```
|
|
56
87
|
|
|
57
|
-
**macOS / Linux**
|
|
58
|
-
|
|
59
88
|
```bash
|
|
60
|
-
|
|
89
|
+
# macOS / Linux
|
|
90
|
+
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide # o <project>/.agents/skills/dsh-plugin-guide
|
|
61
91
|
```
|
|
62
92
|
|
|
63
|
-
El instalador omite `downloads/` (generado) y `.github/`, y verifica byte a byte
|
|
93
|
+
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.
|
|
64
94
|
|
|
65
|
-
|
|
95
|
+
## Configuration
|
|
66
96
|
|
|
67
|
-
|
|
97
|
+
`dsh-plugin-guide` no expone ningún `Config` de Schemastery — registra la base de conocimiento como una skill de agente sin claves ajustables.
|
|
68
98
|
|
|
69
|
-
|
|
70
|
-
|---|---|
|
|
71
|
-
| La chuleta de una página | [`guide/quick-reference.md`](guide/quick-reference.md) |
|
|
72
|
-
| La ruta completa de 10 capítulos | [`guide/plugin-dev-guide.md`](guide/plugin-dev-guide.md) |
|
|
73
|
-
| Enlaces a documentación oficial y comunitaria | [`guide/links.md`](guide/links.md) · [`references/community-ecosystem.md`](references/community-ecosystem.md) |
|
|
74
|
-
| APIs exactas de servicios/eventos | `references/official-docs/docs/subsystems/` y `docs/cordis-api/` |
|
|
99
|
+
## Tools & surfaces
|
|
75
100
|
|
|
76
|
-
|
|
101
|
+
| Surface | Kind | Notes |
|
|
102
|
+
|---|---|---|
|
|
103
|
+
| `dsh-plugin-guide` | skill | Registrada vía `ctx.skills`; carga `SKILL.md` + `./guide/` + `./references/` bajo demanda |
|
|
77
104
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
105
|
+
## Permissions & data
|
|
106
|
+
|
|
107
|
+
- **Permissions**: declara `filesystem:read` en su manifiesto de workshop.
|
|
108
|
+
- **Data**: solo lectura — lee sus propios archivos empaquetados `guide/` y `references/`. Sin solicitudes de red, sin escrituras, sin llamadas al modelo.
|
|
109
|
+
|
|
110
|
+
## Security boundaries
|
|
111
|
+
|
|
112
|
+
- **Base de conocimiento de solo lectura.** El bundle solo lee sus propios archivos; nunca escribe, nunca usa la red y nunca invoca un modelo.
|
|
113
|
+
- **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`.
|
|
114
|
+
- **Límites de distribución.** El contenido de terceros empaquetado conserva su licencia de upstream; consulta [NOTICE.md](NOTICE.md) (p. ej. `downloads/` es solo local; `awesome-dsh-plugins` no debe redistribuirse).
|
|
88
115
|
|
|
89
|
-
##
|
|
116
|
+
## Known limitations
|
|
90
117
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
- 🔬 **114 repositorios comunitarios archivados** (15 analizados) — plantillas, andamiajes, archivos de errores, reglas de plugin-check, capa Fabric, puente MCP, más una guía en 15 idiomas, un curso s01–s23, manuales, SDKs TS/Rust y el lote 08-15 (shells de escritorio, puente QQ, PoCs de seguridad, port a Python).
|
|
95
|
-
- 🔗 **Índice de fuentes completo** — cada hecho enlaza a su origen (docs oficiales, repos upstream, repos comunitarios).
|
|
96
|
-
- 🗃️ **1654 Discussions oficiales archivadas** (con comentarios de hilos seleccionados) + más de 100 artículos comunitarios (zh/en/HN) — refresca con `scripts/archive-discussions.ps1` / `scripts/download-community-articles.ps1`.
|
|
97
|
-
- 🆕 **Sello de actualidad** — re-verificado contra `master` upstream, npm y el topic `dsh-plugin` en vivo el 2026-08-15.
|
|
118
|
+
- **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`.
|
|
119
|
+
- **`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.
|
|
120
|
+
- **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.
|
|
98
121
|
|
|
99
|
-
##
|
|
122
|
+
## Keeping it fresh
|
|
100
123
|
|
|
101
124
|
```sh
|
|
102
|
-
pwsh -File scripts/sync-official-docs.ps1 # copia textual de docs desde un checkout local
|
|
125
|
+
pwsh -File scripts/sync-official-docs.ps1 # copia textual de docs desde un checkout local
|
|
103
126
|
pwsh -File scripts/download-sources.ps1 # sitio/docs oficiales, Cordis, paper
|
|
104
|
-
pwsh -File scripts/download-community-repos.ps1 #
|
|
105
|
-
pwsh -File scripts/download-community-articles.ps1 # artículos
|
|
106
|
-
pwsh -File scripts/archive-discussions.ps1 # Discussions oficiales (
|
|
107
|
-
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir> # censo del
|
|
108
|
-
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # rutas críticas + enlaces
|
|
127
|
+
pwsh -File scripts/download-community-repos.ps1 # repositorios de la comunidad (tarballs codeload)
|
|
128
|
+
pwsh -File scripts/download-community-articles.ps1 # artículos de la comunidad zh/en/HN
|
|
129
|
+
pwsh -File scripts/archive-discussions.ps1 # Discussions oficiales (necesita $env:GH_TOKEN)
|
|
130
|
+
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir> # censo del tema dsh-plugin
|
|
131
|
+
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # rutas críticas + escaneo de enlaces + deriva de docs
|
|
109
132
|
```
|
|
110
133
|
|
|
111
|
-
|
|
134
|
+
## Development
|
|
112
135
|
|
|
113
|
-
|
|
136
|
+
El bundle es ESM plano — sin paso de build. CI ejecuta la puerta de integridad en cada push y pull request:
|
|
114
137
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
- ⭐ **Dale una estrella** — ayuda a que otros autores de plugins DSH lo encuentren.
|
|
120
|
-
- ¿Encontraste un error, una nueva trampa o un repo que merece análisis? Abre un [issue](https://github.com/PerryLink/dsh-plugin-guide/issues) o un pull request — consulta [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
121
|
-
- Únete a la comunidad: [Discord de DeepSeek Harness](https://discord.gg/Ycq5dCaS4) · [discusiones oficiales](https://github.com/deepseek-ai/deepseek-harness/discussions) · [topic `dsh-plugin`](https://github.com/topics/dsh-plugin).
|
|
138
|
+
```sh
|
|
139
|
+
pwsh -File scripts/verify-kit.ps1 # rutas críticas + escaneo de enlaces (+ deriva de docs con -Checkout <checkout>)
|
|
140
|
+
```
|
|
122
141
|
|
|
123
|
-
##
|
|
142
|
+
## Topics
|
|
124
143
|
|
|
125
|
-
-
|
|
126
|
-
- El mantenimiento diario cuenta con la asistencia de agentes de DeepSeek Harness (no tienen cuenta de GitHub y se listan aquí solo por transparencia, no como contribuidores).
|
|
144
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`
|
|
127
145
|
|
|
146
|
+
## Contributors
|
|
128
147
|
|
|
129
|
-
|
|
148
|
+
- [PerryLink](https://github.com/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.
|
|
149
|
+
- El mantenimiento diario está asistido por agentes de DeepSeek Harness (no tienen cuenta de GitHub y se listan aquí por transparencia, no como contribuyentes).
|
|
130
150
|
|
|
131
|
-
|
|
132
|
-
- El contenido de terceros incluido está documentado en [NOTICE.md](NOTICE.md), con sus límites de distribución
|
|
133
|
-
(p. ej. `downloads/` es solo local; `awesome-dsh-plugins` no debe redistribuirse).
|
|
151
|
+
## PerryLink DSH Plugin Family
|
|
134
152
|
|
|
135
|
-
|
|
153
|
+
Este proyecto es uno de los [15 plugins de DeepSeek Harness](https://github.com/PerryLink) mantenidos por [PerryLink](https://github.com/PerryLink). Si este te ayuda, los demás probablemente también:
|
|
136
154
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
155
|
+
| Plugin | One-liner |
|
|
156
|
+
|---|---|
|
|
157
|
+
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
|
|
158
|
+
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | Engineering-discipline guard: requirements grill, test gates, adversary review |
|
|
159
|
+
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Durable background child agents with a Web UI sidebar, messaging and interrupt |
|
|
160
|
+
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | LSP diagnostics, formatting, completion, code actions and rename over language servers |
|
|
161
|
+
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-equivalent runtime style switching |
|
|
162
|
+
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
|
|
163
|
+
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-style declarative allow/deny/ask permission rules with audit |
|
|
164
|
+
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | Second-model auto-review on the approval chain, fail-closed by default |
|
|
165
|
+
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
|
|
166
|
+
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | Security-audit skill pack: secret scan, dependency and supply-chain review |
|
|
167
|
+
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Pin sessions in the Web sidebar with durable ordering |
|
|
168
|
+
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Terminal-style input history for the web composer: arrows, Ctrl+R search |
|
|
169
|
+
| [dsh-github](https://github.com/PerryLink/dsh-github) | GitHub PR/issues integration for DSH, every write gated by approval |
|
|
170
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | Plugin-development knowledge base as an on-demand agent skill |
|
|
171
|
+
| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |
|
|
172
|
+
|
|
173
|
+
## Disclaimer
|
|
174
|
+
|
|
175
|
+
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.
|
|
176
|
+
|
|
177
|
+
## License
|
|
178
|
+
|
|
179
|
+
[Apache License 2.0](LICENSE) © 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](NOTICE.md).
|
package/README.hi.md
CHANGED
|
@@ -2,137 +2,178 @@
|
|
|
2
2
|
|
|
3
3
|
# 🐳 dsh-plugin-guide
|
|
4
4
|
|
|
5
|
-
**[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) प्लगइन बनाने के लिए
|
|
5
|
+
**[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) प्लगइन बनाने के लिए आपकी ज़रूरत की हर चीज़।**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
*आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill*
|
|
8
8
|
|
|
9
|
-
[
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
10
16
|
|
|
11
|
-
[
|
|
12
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/network/members)
|
|
13
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
|
|
14
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
15
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
16
|
-
[](LICENSE)
|
|
17
|
-
[](https://github.com/topics/dsh)
|
|
18
|
-
[](https://github.com/topics/dsh-plugin)
|
|
19
|
-
[](references/official-docs/)
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
20
18
|
|
|
21
19
|
</div>
|
|
22
20
|
|
|
23
|
-
|
|
24
|
-
>
|
|
25
|
-
> ⏱️ **अंतिम सत्यापन 2026-08-15** — आधिकारिक दस्तावेज़ अपस्ट्रीम `master` (47f9438, देखें [SNAPSHOT.md](references/official-docs/SNAPSHOT.md)) से बाइट-दर-बाइट समान; npm टैग और `dsh-plugin` टॉपिक (08-15 स्नैपशॉट के दौरान API total_count **2668 → 2671** बढ़ा; 998 रेपो कैप्चर, देखें [sources.md](references/sources.md) §D.2) लाइव पुनः-जाँचे गए; अपस्ट्रीम HEAD (47f9438) व npm `@deepseek-ai/dsh` (0.1.0-rc.6) में कोई बदलाव नहीं।
|
|
21
|
+
---
|
|
26
22
|
|
|
27
|
-
##
|
|
23
|
+
## Compatibility
|
|
28
24
|
|
|
29
|
-
|
|
|
30
|
-
|
|
31
|
-
|
|
|
25
|
+
| Surface | Status |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Harness | DeepSeek Harness `0.1.1-rc.2` |
|
|
28
|
+
| Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness रनटाइम) |
|
|
29
|
+
| Platforms | सभी (सादा ESM बंडल; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
|
|
30
|
+
| Model | कोई भी (कोई मॉडल अंतःक्रिया नहीं) |
|
|
31
|
+
|
|
32
|
+
## What you get
|
|
33
|
+
|
|
34
|
+
`dsh-plugin-guide` DSH प्लगइन-विकास ज्ञान-आधार है, जो एक इंस्टॉल-योग्य बंडल के रूप में पैक किया गया है और पूरी सामग्री को `dsh-plugin-guide` agent skill के रूप में पंजीकृत करता है। यह skill हर सत्र कैटलॉग में दृश्य रहती है और अपने वर्कफ़्लो चरण, आधिकारिक दस्तावेज़ और सामुदायिक गहन-विश्लेषण माँग पर लोड करती है।
|
|
32
35
|
|
|
33
|
-
|
|
36
|
+
- **प्लगइन अनुबंध और कठोर नियम** — effects/disposers, waterfall `next()`, मॉडल-दृश्य ⟺ लॉग किया गया, Schemastery विन्यास।
|
|
37
|
+
- **आधिकारिक दस्तावेज़ संग्रह** — आधिकारिक रेपो दस्तावेज़ों की शब्दशः प्रति (EN + ZH), अंतिम सत्यापित स्नैपशॉट पर अपस्ट्रीम से बाइट-समान।
|
|
38
|
+
- **Cordis प्राइमर** — पाँच अवधारणाएँ और तंत्र समयरेखा (repository-plugin 0809 को जोड़ा, 0811 को हटाया; दो इंस्टॉल चैनल)।
|
|
39
|
+
- **20+ वास्तविक-दुनिया नुकसान** मूल कारण + समाधान सहित (cordis दोहरी प्रतियाँ, tsconfig त्रयी, बहु-फ़्रेम zstd सत्र, Windows junction, पुराना npm `latest`, …)।
|
|
40
|
+
- **सामुदायिक गहन-विश्लेषण** — 114 सामुदायिक रिपॉज़िटरी संग्रहीत (15 गहन-विश्लेषित), साथ ही पूर्ण स्रोत सूची जहाँ हर तथ्य अपने मूल से जुड़ा है।
|
|
34
41
|
|
|
35
|
-
|
|
42
|
+
## Knowledge base
|
|
36
43
|
|
|
37
|
-
|
|
44
|
+
| Path | यह क्या है |
|
|
45
|
+
|---|---|
|
|
46
|
+
| `SKILL.md` | `dsh-plugin-guide` agent skill: कठोर नियम + कार्य-आधारित विकास पथ |
|
|
47
|
+
| `package.json` · `cordis.patch.yml` · `index.js` | इंस्टॉल-योग्य DSH बंडल: `dsh.bundle.patch` मैनिफ़ेस्ट + skill पंजीकृत करने वाला प्रवेश बिंदु |
|
|
48
|
+
| `guide/plugin-dev-guide.md` | पूर्ण विकास मार्गदर्शिका (10 अध्याय) |
|
|
49
|
+
| `guide/quick-reference.md` | एक-पृष्ठ चीट शीट (5 भाषाएँ) |
|
|
50
|
+
| `guide/links.md` | संकलित URL सूची: आधिकारिक विकास दस्तावेज़ (साइट ↔ स्थानीय प्रतियाँ) + सामुदायिक दस्तावेज़ लिंक |
|
|
51
|
+
| `references/official-docs/` | आधिकारिक रेपो दस्तावेज़ों की शब्दशः प्रति (EN + ZH) |
|
|
52
|
+
| `references/*.md` | शोध रिपोर्ट: रेपो दस्तावेज़, वेबसाइट, Cordis, पेपर, सामुदायिक पारिस्थितिकी, 114-रेपो संग्रह (15 गहन-विश्लेषित) |
|
|
53
|
+
| `scripts/` | इडेम्पोटेंट डाउनलोड स्क्रिप्ट + अखंडता जाँचकर्ता + विषय स्नैपशॉट जनरेटर |
|
|
54
|
+
| `downloads/` | कच्चे स्नैपशॉट — `scripts/` से उत्पन्न, कमिट नहीं |
|
|
55
|
+
|
|
56
|
+
## Quick start
|
|
38
57
|
|
|
39
58
|
```sh
|
|
40
|
-
|
|
41
|
-
|
|
59
|
+
# 1. install the bundle into your profile
|
|
60
|
+
dsh plugin --profile web add "github:PerryLink/dsh-plugin-guide#main"
|
|
61
|
+
|
|
62
|
+
# or from npm (published releases)
|
|
63
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
64
|
+
|
|
65
|
+
# 2. restart and verify the row
|
|
66
|
+
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
42
67
|
```
|
|
43
68
|
|
|
44
|
-
|
|
69
|
+
फिर बस अपने एजेंट से पूछें: *"मुझे … प्लगइन बनाने के लिए dsh-plugin-guide skill का उपयोग करो।"*
|
|
45
70
|
|
|
46
|
-
|
|
71
|
+
## Install & uninstall
|
|
47
72
|
|
|
48
|
-
|
|
73
|
+
- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha>` — पुनरुत्पादन के लिए एक कमिट पिन करें; प्रवेश बिंदु सादा ESM JS है, कोई बिल्ड चरण नहीं।
|
|
74
|
+
- **npm चैनल** (प्रकाशित रिलीज़): `dsh plugin --profile web add dsh-plugin-guide`.
|
|
75
|
+
- **tarball चैनल**: इस रेपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz`.
|
|
76
|
+
- **uninstall**: `dsh plugin --profile web remove dsh-plugin-guide`.
|
|
49
77
|
|
|
50
|
-
|
|
78
|
+
## Copy as a plain agent skill
|
|
79
|
+
|
|
80
|
+
आप पूरे फ़ोल्डर को अपने एजेंट की skill निर्देशिका में भी कॉपी कर सकते हैं (सापेक्ष पथ बरकरार रहते हैं):
|
|
51
81
|
|
|
52
82
|
```powershell
|
|
83
|
+
# Windows (PowerShell)
|
|
53
84
|
pwsh -File scripts/install-skill.ps1 `
|
|
54
85
|
-Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # या <project>\.agents\skills\dsh-plugin-guide
|
|
55
86
|
```
|
|
56
87
|
|
|
57
|
-
**macOS / Linux**
|
|
58
|
-
|
|
59
88
|
```bash
|
|
89
|
+
# macOS / Linux
|
|
60
90
|
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide # या <project>/.agents/skills/dsh-plugin-guide
|
|
61
91
|
```
|
|
62
92
|
|
|
63
|
-
इंस्टॉलर `downloads/` (
|
|
93
|
+
इंस्टॉलर `downloads/` (उत्पन्न) और `.github/` को छोड़ता है, फिर हर कॉपी की गई फ़ाइल को बाइट-दर-बाइट सत्यापित करता है। पूरे फ़ोल्डर की मैन्युअल `Copy-Item -Recurse` भी काम करती है।
|
|
64
94
|
|
|
65
|
-
|
|
95
|
+
## Configuration
|
|
66
96
|
|
|
67
|
-
|
|
97
|
+
`dsh-plugin-guide` कोई Schemastery `Config` उजागर नहीं करता — यह ज्ञान-आधार को बिना किसी ट्यूनेबल कुंजी के एक agent skill के रूप में पंजीकृत करता है।
|
|
68
98
|
|
|
69
|
-
|
|
70
|
-
|---|---|
|
|
71
|
-
| एक पेज की चीट शीट | [`guide/quick-reference.md`](guide/quick-reference.md) |
|
|
72
|
-
| 10 अध्यायों का पूरा रास्ता | [`guide/plugin-dev-guide.md`](guide/plugin-dev-guide.md) |
|
|
73
|
-
| आधिकारिक व सामुदायिक दस्तावेज़ लिंक | [`guide/links.md`](guide/links.md) · [`references/community-ecosystem.md`](references/community-ecosystem.md) |
|
|
74
|
-
| सेवा/इवेंट के सटीक API | `references/official-docs/docs/subsystems/` और `docs/cordis-api/` |
|
|
99
|
+
## Tools & surfaces
|
|
75
100
|
|
|
76
|
-
|
|
101
|
+
| Surface | Kind | Notes |
|
|
102
|
+
|---|---|---|
|
|
103
|
+
| `dsh-plugin-guide` | skill | `ctx.skills` से पंजीकृत; माँग पर `SKILL.md` + `./guide/` + `./references/` लोड करता है |
|
|
77
104
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
##
|
|
90
|
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
- 🗃️ **1654 आधिकारिक Discussions संग्रहीत** (चयनित थ्रेड्स की टिप्पणियों सहित) + 100+ सामुदायिक लेख (zh/en/HN) — `scripts/archive-discussions.ps1` / `scripts/download-community-articles.ps1` से ताज़ा करें।
|
|
97
|
-
- 🆕 **ताज़गी की मुहर** — 2026-08-15 को अपस्ट्रीम `master`, npm और लाइव `dsh-plugin` टॉपिक से पुनः-सत्यापित।
|
|
98
|
-
|
|
99
|
-
## 🔄 इसे ताज़ा रखें
|
|
105
|
+
## Permissions & data
|
|
106
|
+
|
|
107
|
+
- **Permissions**: workshop मैनिफ़ेस्ट में `filesystem:read` घोषित करता है।
|
|
108
|
+
- **Data**: केवल-पठन — अपनी पैक की गई `guide/` और `references/` फ़ाइलें पढ़ता है। कोई नेटवर्क अनुरोध नहीं, कोई लेखन नहीं, कोई मॉडल कॉल नहीं।
|
|
109
|
+
|
|
110
|
+
## Security boundaries
|
|
111
|
+
|
|
112
|
+
- **केवल-पठन ज्ञान-आधार।** बंडल केवल अपनी फ़ाइलें पढ़ता है; कभी लिखता नहीं, कभी नेटवर्क उपयोग नहीं करता, और कभी मॉडल नहीं बुलाता।
|
|
113
|
+
- **आधिकारिक दस्तावेज़ शब्दशः प्रतियाँ हैं।** `references/official-docs/` यहाँ कभी संपादित नहीं होता; समस्याएँ अपस्ट्रीम को रिपोर्ट करें और केवल `scripts/sync-official-docs.ps1` से पुनः-सिंक करें।
|
|
114
|
+
- **वितरण सीमाएँ।** पैक की गई तृतीय-पक्ष सामग्री अपना अपस्ट्रीम लाइसेंस रखती है; [NOTICE.md](NOTICE.md) देखें (जैसे `downloads/` केवल स्थानीय; `awesome-dsh-plugins` पुनर्वितरित नहीं होना चाहिए)।
|
|
115
|
+
|
|
116
|
+
## Known limitations
|
|
117
|
+
|
|
118
|
+
- **आधिकारिक दस्तावेज़ एक स्नैपशॉट है।** अपस्ट्रीम बदलने पर `scripts/sync-official-docs.ps1` से पुनः-सिंक करें; ताज़गी मुहर और कमिट हैश `references/official-docs/SNAPSHOT.md` को संदर्भित करते हैं।
|
|
119
|
+
- **`downloads/` उत्पन्न है, कमिट नहीं।** कच्चे स्नैपशॉट (सामुदायिक रेपो संग्रह, Discussions, लेख) उपयोग से पहले स्क्रिप्ट से उत्पन्न करने चाहिए।
|
|
120
|
+
- **`awesome-dsh-plugins` सामग्री केवल स्थानीय है।** इसका अपस्ट्रीम आंतरिक-उपयोग प्रतिबंध घोषित करता है, इसलिए इसे रेपो के साथ पुनर्वितरित नहीं किया जाता।
|
|
121
|
+
|
|
122
|
+
## Keeping it fresh
|
|
100
123
|
|
|
101
124
|
```sh
|
|
102
|
-
pwsh -File scripts/sync-official-docs.ps1 # स्थानीय checkout से
|
|
125
|
+
pwsh -File scripts/sync-official-docs.ps1 # स्थानीय checkout से शब्दशः दस्तावेज़ प्रति
|
|
103
126
|
pwsh -File scripts/download-sources.ps1 # आधिकारिक साइट/दस्तावेज़, Cordis, पेपर
|
|
104
|
-
pwsh -File scripts/download-community-repos.ps1 #
|
|
105
|
-
pwsh -File scripts/download-community-articles.ps1 # zh/en/HN सामुदायिक लेख
|
|
106
|
-
pwsh -File scripts/archive-discussions.ps1 # आधिकारिक Discussions ($env:GH_TOKEN
|
|
107
|
-
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir> # dsh-plugin
|
|
108
|
-
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # महत्वपूर्ण पथ +
|
|
127
|
+
pwsh -File scripts/download-community-repos.ps1 # सामुदायिक रिपॉज़िटरी (codeload tarballs)
|
|
128
|
+
pwsh -File scripts/download-community-articles.ps1 # zh/en/HN सामुदायिक लेख
|
|
129
|
+
pwsh -File scripts/archive-discussions.ps1 # आधिकारिक Discussions ($env:GH_TOKEN चाहिए)
|
|
130
|
+
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir> # dsh-plugin विषय जनगणना
|
|
131
|
+
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # महत्वपूर्ण पथ + लिंक स्कैन + दस्तावेज़ विचलन
|
|
109
132
|
```
|
|
110
133
|
|
|
111
|
-
|
|
134
|
+
## Development
|
|
112
135
|
|
|
113
|
-
|
|
136
|
+
बंडल सादा ESM है — कोई बिल्ड चरण नहीं। CI हर push और pull request पर अखंडता द्वार चलाता है:
|
|
114
137
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
- ⭐ **स्टार दें** — इससे अन्य DSH प्लगइन लेखकों को यह मिल पाएगा।
|
|
120
|
-
- कोई त्रुटि, नई समस्या या विश्लेषण योग्य रिपो मिला? [issue](https://github.com/PerryLink/dsh-plugin-guide/issues) खोलें या pull request भेजें — देखें [CONTRIBUTING.md](CONTRIBUTING.md)।
|
|
121
|
-
- समुदाय से जुड़ें: [DeepSeek Harness Discord](https://discord.gg/Ycq5dCaS4) · [आधिकारिक चर्चाएँ](https://github.com/deepseek-ai/deepseek-harness/discussions) · [`dsh-plugin` टॉपिक](https://github.com/topics/dsh-plugin)।
|
|
138
|
+
```sh
|
|
139
|
+
pwsh -File scripts/verify-kit.ps1 # महत्वपूर्ण पथ + लिंक स्कैन (-Checkout <checkout> से दस्तावेज़ विचलन)
|
|
140
|
+
```
|
|
122
141
|
|
|
123
|
-
##
|
|
142
|
+
## Topics
|
|
124
143
|
|
|
125
|
-
-
|
|
126
|
-
- दैनिक अनुरक्षण में DeepSeek Harness एजेंट सहायता करते हैं (उनका कोई GitHub खाता नहीं है; पारदर्शिता के लिए सूचीबद्ध, योगदानकर्ता के रूप में नहीं)।
|
|
144
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`
|
|
127
145
|
|
|
146
|
+
## Contributors
|
|
128
147
|
|
|
129
|
-
|
|
148
|
+
- [PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: ज्ञान-आधार सामग्री, इंस्टॉल-योग्य बंडल रूपांतरण, पारिस्थितिकी योगदान और सामुदायिक अभियांत्रिकी।
|
|
149
|
+
- दैनिक अनुरक्षण में DeepSeek Harness एजेंट सहायता करते हैं (उनका कोई GitHub खाता नहीं है और वे पारदर्शिता हेतु यहाँ सूचीबद्ध हैं, योगदानकर्ता के रूप में नहीं)।
|
|
130
150
|
|
|
131
|
-
|
|
132
|
-
- शामिल तृतीय-पक्ष सामग्री [NOTICE.md](NOTICE.md) में दर्ज है, वितरण सीमाओं सहित
|
|
133
|
-
(जैसे `downloads/` केवल स्थानीय उपयोग हेतु; `awesome-dsh-plugins` का पुनर्वितरण न करें)।
|
|
151
|
+
## PerryLink DSH Plugin Family
|
|
134
152
|
|
|
135
|
-
|
|
153
|
+
यह परियोजना [PerryLink](https://github.com/PerryLink) द्वारा अनुरक्षित [15 DeepSeek Harness प्लगइन](https://github.com/PerryLink) में से एक है। यदि यह आपकी मदद करता है, तो बाकी भी संभवतः करेंगे:
|
|
136
154
|
|
|
137
|
-
|
|
138
|
-
|
|
155
|
+
| Plugin | One-liner |
|
|
156
|
+
|---|---|
|
|
157
|
+
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
|
|
158
|
+
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | Engineering-discipline guard: requirements grill, test gates, adversary review |
|
|
159
|
+
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Durable background child agents with a Web UI sidebar, messaging and interrupt |
|
|
160
|
+
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | LSP diagnostics, formatting, completion, code actions and rename over language servers |
|
|
161
|
+
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-equivalent runtime style switching |
|
|
162
|
+
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
|
|
163
|
+
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-style declarative allow/deny/ask permission rules with audit |
|
|
164
|
+
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | Second-model auto-review on the approval chain, fail-closed by default |
|
|
165
|
+
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
|
|
166
|
+
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | Security-audit skill pack: secret scan, dependency and supply-chain review |
|
|
167
|
+
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Pin sessions in the Web sidebar with durable ordering |
|
|
168
|
+
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Terminal-style input history for the web composer: arrows, Ctrl+R search |
|
|
169
|
+
| [dsh-github](https://github.com/PerryLink/dsh-github) | GitHub PR/issues integration for DSH, every write gated by approval |
|
|
170
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | Plugin-development knowledge base as an on-demand agent skill |
|
|
171
|
+
| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |
|
|
172
|
+
|
|
173
|
+
## Disclaimer
|
|
174
|
+
|
|
175
|
+
सामुदायिक-अनुरक्षित, **नहीं** एक आधिकारिक DeepSeek उत्पाद। DeepSeek Harness डेवलपर पूर्वावलोकन में है और ब्रेकिंग बदलाव प्रकाशित करता है; संदेह होने पर `references/official-docs/` में आधिकारिक दस्तावेज़ सत्य का स्रोत हैं।
|
|
176
|
+
|
|
177
|
+
## License
|
|
178
|
+
|
|
179
|
+
[Apache License 2.0](LICENSE) © 2026 dsh-plugin-guide contributors — हमारा अपना पाठ (`SKILL.md`, `guide/`, `references/`, `scripts/`, यह README) Apache-2.0 है; पैक की गई तृतीय-पक्ष सामग्री [NOTICE.md](NOTICE.md) में दस्तावेज़ित है।
|