dsh-plugin-guide 0.3.32 → 0.3.35
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 +7 -1
- package/README-hi.md +7 -1
- package/README-pt.md +7 -1
- package/README-zh.md +7 -1
- package/README.md +358 -352
- package/SKILL.md +4 -1
- package/data/facts.json +54 -0
- package/data/seams/index.json +397 -0
- package/dist/dsh-plugin-dev.js +196 -1
- package/package.json +12 -5
- package/references/cli-positioning-decision.md +78 -0
- package/scripts/check-docs-drift-detail.mjs +145 -0
- package/scripts/check-facts.mjs +162 -0
- package/scripts/verify-artifacts.mjs +37 -0
package/README.md
CHANGED
|
@@ -1,352 +1,358 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# 🐳 dsh-plugin-guide
|
|
4
|
-
|
|
5
|
-
**Your agent stops inventing DSH plugin APIs.**
|
|
6
|
-
|
|
7
|
-
The DeepSeek Harness plugin-development knowledge base, installed *as an agent skill* — official docs, a version-compatibility matrix, migration seams and battle-tested pitfalls, plus a scaffolder/checker CLI.
|
|
8
|
-
|
|
9
|
-
```sh
|
|
10
|
-
dsh plugin --profile web add dsh-plugin-guide
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
Then just ask: *"Use the dsh-plugin-guide skill to build me a … plugin."*
|
|
14
|
-
|
|
15
|
-
[](https://gitee.com/perrylink/dsh-plugin-guide)
|
|
16
|
-
[](https://dshfind.com/plugins/PerryLink/dsh-plugin-guide?ref=badge)
|
|
17
|
-
[](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-plugin-guide)
|
|
18
|
-
|
|
19
|
-
> **Official repository.** This is the only official repository of dsh-plugin-guide, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
|
|
20
|
-
|
|
21
|
-
[](LICENSE)
|
|
22
|
-
[](https://github.com/topics/dsh-plugin)
|
|
23
|
-
[](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
24
|
-
[](https://dsh.market/)
|
|
25
|
-
[](#)
|
|
26
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/actions)
|
|
27
|
-
[](https://github.com/PerryLink/dsh-plugin-guide/releases)
|
|
28
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
29
|
-
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
30
|
-
|
|
31
|
-
[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
|
|
32
|
-
|
|
33
|
-
</div>
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## Why not just read the official docs?
|
|
38
|
-
|
|
39
|
-
Because the official docs are written for someone who already knows which page to open, and DSH ships a **prerelease every 1.7–2.8 days** with breaking changes. This plugin closes the three gaps that costs authors the most time:
|
|
40
|
-
|
|
41
|
-
| Gap | What this plugin adds |
|
|
42
|
-
|---|---|
|
|
43
|
-
| **"Which DSH am I even targeting?"** | A [version matrix](guide/version-matrix.md): the four different values that all call themselves "latest", the frozen sub-package `latest` tags, the breaking-change seams, and how to pick a `peerDependencies` range. **There is no stable line** — every published version is a prerelease. |
|
|
44
|
-
| **"What does this break?"** | A [migration guide](guide/migration-0.2.md) covering `0.1.6-alpha.2` → `0.2.1-alpha.2` as **citable seams** with symptom *and* fix, each with its official source — including a data-loss hazard and a change that makes prompts fail before a model request is built. |
|
|
45
|
-
| **"Is my plugin actually correct?"** | A [zero-dependency CLI](SKILL.md) (`dsh-plugin-dev new / check / verify`) plus an [offline verbatim mirror](references/official-docs/) of the official docs, so your agent can cite the exact page instead of guessing. |
|
|
46
|
-
|
|
47
|
-
**Prove it works in 60 seconds:**
|
|
48
|
-
|
|
49
|
-
```sh
|
|
50
|
-
dsh plugin --profile web add dsh-plugin-guide
|
|
51
|
-
npx dsh-plugin-guide new hello-plugin # scaffold a plugin
|
|
52
|
-
cd hello-plugin && npx dsh-plugin-guide check --json # 16 static checks
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
**📖 Prefer reading it as a site?** [perrylink.github.io/dsh-plugin-guide](https://perrylink.github.io/dsh-plugin-guide/) — every chapter as its own page, plus a machine-readable [llms.txt](https://perrylink.github.io/dsh-plugin-guide/llms.txt) for assistants.
|
|
56
|
-
|
|
57
|
-
**Also on the 1024 store channel:** `npm i -g dsh1024`, then `dsh1024 plugin --profile web add dsh-plugin-guide` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
|
|
58
|
-
|
|
59
|
-
<!-- star-cta -->
|
|
60
|
-
## ⭐ 如果它帮到了你
|
|
61
|
-
|
|
62
|
-
这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员（40+ 个，全部 Apache-2.0）。如果你在用，**给个 star** —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。
|
|
63
|
-
|
|
64
|
-
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
## What is dsh-plugin-guide?
|
|
68
|
-
|
|
69
|
-
Everything you need to build [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugins.
|
|
70
|
-
|
|
71
|
-
Official docs archive · Cordis primer · community deep-dives · battle-tested pitfalls · agent skill · CLI toolchain
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
77
|
-
|
|
78
|
-
*The same run, animated.*
|
|
79
|
-
|
|
80
|
-
## Comparison
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
content counts as stated in the README (What you get)
|
|
85
|
-
|
|
86
|
-
## Compatibility
|
|
87
|
-
|
|
88
|
-
| Surface | Status |
|
|
89
|
-
|---|---|
|
|
90
|
-
| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.2` (`d743267388641bc76f17c45ce8b4c231aed1d32c`, the newest master tag **and** master HEAD, 2026-10-09); npm `latest` = `next` = `0.2.0-rc.2`, `alpha` = `0.2.1-alpha.2`. **There is no stable line** — all 31 npm versions and all 26 GitHub Releases are prereleases. The official-docs mirror is pinned to that same commit (429 md pages, re-synced 2026-10-13; see [references/official-docs/SNAPSHOT.md](references/official-docs/SNAPSHOT.md)). `guide/migration-0.2.md` covers `0.1.6-alpha.2` → `0.2.1-alpha.1` in §0–§12 and `0.2.1-alpha.1` → `0.2.1-alpha.2` as 19 citable seams in §13; the 20 breaking-change guides added since the previous baseline (19 under `v0.2.1-alpha.1` plus one backfilled into `v0.2.0-rc.2`) are all in the mirror. |
|
|
91
|
-
| Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness runtime) |
|
|
92
|
-
| Platforms | All (plain ESM bundle; no native code, no network) |
|
|
93
|
-
| Model | Any (no model interaction) |
|
|
94
|
-
|
|
95
|
-
## What you get
|
|
96
|
-
|
|
97
|
-
`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.
|
|
98
|
-
|
|
99
|
-
- **Plugin contract & hard rules** — effects/disposers, waterfall `next()`, host-owned session events, `MessageSourceMap`, the weakest-mechanism ordering, Schemastery config, UI and performance rules.
|
|
100
|
-
- **Official docs archive** — a verbatim copy of the official repo docs (EN + ZH), byte-identical to upstream at the last verified snapshot, including the pages that never reach the documentation site.
|
|
101
|
-
- **Version adaptivity** — [guide/version-matrix.md](guide/version-matrix.md): the five different "latest" values, the frozen sub-package `latest` tags, the four breaking-change seams, the canonical peer range and how to pick one, the session-format lineage V0→V4, and the 19 breaking changes that landed in `0.2.1-alpha.2`.
|
|
102
|
-
- **Migration guide** — [guide/migration-0.2.md](guide/migration-0.2.md): every breaking change from `0.1.6-alpha.2` to `0.2.1-alpha.1` (session format V4, the settings rebuild, invariant removal, `readBytes`, new slots, retired `plugin` message source), each with its official source and a 12-item checklist.
|
|
103
|
-
- **Official in-repo skill, distilled** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): the harness's own `cordis-plugin-development` workflow, prohibitions, display-metadata checklist, practices, and UI/performance rules.
|
|
104
|
-
- **Cordis primer** — the five concepts and the mechanism timeline (repository-plugin introduced 0809, removed 0811; the two install channels).
|
|
105
|
-
- **Verified issue index** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 unfixed + 11 newly verified items with `path:line`, workarounds, fixing commits, design-vs-bug table, and an explicit "unreproducible" section.
|
|
106
|
-
- **30+ real-world pitfalls** with root cause + fix (cordis dual copies, tsconfig trio, multi-frame zstd sessions, Windows junctions, stale npm `latest`, `file:` installs loading a copy, live patch writes, …).
|
|
107
|
-
- **Community deep-dives** — 114 community repositories archived (15 deep-dived), plus a full source index where every fact links to its origin.
|
|
108
|
-
- **CLI toolchain** — `dsh-plugin-dev new / check / verify`: scaffold, static-check (including display metadata and multi-patch manifests), and pack-verify DSH plugins; every check links back to the skill section it enforces.
|
|
109
|
-
|
|
110
|
-
## Knowledge base
|
|
111
|
-
|
|
112
|
-
| Path | What it is |
|
|
113
|
-
|---|---|
|
|
114
|
-
| `SKILL.md` | The `dsh-plugin-guide` agent skill: hard rules + task-based development paths |
|
|
115
|
-
| `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | The installable DSH bundle: `dsh.bundle.patch` manifest, entry point that registers the skill, and the display metadata Plugin Manager reads |
|
|
116
|
-
| `guide/plugin-dev-guide.md` | The complete development guide (10 chapters) |
|
|
117
|
-
| `guide/version-matrix.md` | **Version adaptivity matrix**: the five "latest" values, frozen sub-package `latest` tags, breaking-change seams, peer-range selection, session-format lineage, and the 19 changes in `0.2.1-alpha.2` |
|
|
118
|
-
| `guide/migration-0.2.md` | Breaking-change migration guide for the 0.2 generation |
|
|
119
|
-
| `guide/unfixed-issues.md` | Source-verified bug index + fixed-on-master list + design-vs-bug table |
|
|
120
|
-
| `guide/quick-reference.md` | One-page cheat sheet (5 languages) |
|
|
121
|
-
| `guide/links.md` | Curated URL index: official dev docs (site ↔ local copies) + community doc links + repo-only pages |
|
|
122
|
-
| `guide/when-to-retire-a-plugin.md` | Retiring and freezing plugins: the criteria and the measured data behind a portfolio audit (EN + ZH) |
|
|
123
|
-
| `guide/choosing-a-plugin.md` | Choosing a plugin: who leads each capability surface, with the measured numbers and the verification caveats (EN + ZH) |
|
|
124
|
-
| `references/official-docs/` | Verbatim copy of the official repo docs (EN + ZH) |
|
|
125
|
-
| `references/official-plugin-dev-skill.md` | Distilled official in-repo plugin-development skill |
|
|
126
|
-
| `references/*.md` | Research reports: repo docs, website, Cordis, the paper, community ecosystem, 114-repo archive (15 deep-dived) |
|
|
127
|
-
| `scripts/` | Idempotent download scripts + integrity checker + topic snapshot generator |
|
|
128
|
-
| `bin/` · `src/cli/` · `dist/` | The `dsh-plugin-dev` CLI: scaffolder, checker, verifier (TypeScript, tsdown-bundled) |
|
|
129
|
-
| `templates/` | TS + JS scaffold skeletons: contract template, Config, tests, cordis.patch.yml, locale metadata, icon, five-language READMEs |
|
|
130
|
-
| `downloads/` | Raw snapshots — generated by `scripts/`, not committed |
|
|
131
|
-
|
|
132
|
-
## CLI toolchain
|
|
133
|
-
|
|
134
|
-
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.
|
|
135
|
-
|
|
136
|
-
```sh
|
|
137
|
-
dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
|
|
138
|
-
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
|
|
139
|
-
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
| `
|
|
146
|
-
| `
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
npx dsh-plugin-guide
|
|
187
|
-
npx dsh-plugin-guide
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
- **
|
|
194
|
-
- **
|
|
195
|
-
- **
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
| `dsh-plugin-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
- **
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
- **
|
|
234
|
-
- **
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
-
|
|
240
|
-
- **`
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
|
250
|
-
|
|
|
251
|
-
|
|
|
252
|
-
|
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
pwsh -File scripts/
|
|
259
|
-
pwsh -File scripts/download-
|
|
260
|
-
pwsh -File scripts/download-community-
|
|
261
|
-
pwsh -File scripts/
|
|
262
|
-
pwsh -File scripts/
|
|
263
|
-
pwsh -File scripts/
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
pnpm
|
|
273
|
-
pnpm
|
|
274
|
-
pnpm
|
|
275
|
-
pnpm run
|
|
276
|
-
pnpm run verify:self-
|
|
277
|
-
pnpm pack
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
-
|
|
289
|
-
|
|
290
|
-
##
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
|
301
|
-
|
|
302
|
-
| **[dsh-
|
|
303
|
-
| **[dsh-
|
|
304
|
-
| **[dsh-
|
|
305
|
-
| **[dsh-
|
|
306
|
-
| **[dsh-
|
|
307
|
-
| **[dsh-
|
|
308
|
-
| **[dsh-
|
|
309
|
-
| **[dsh-
|
|
310
|
-
| **[dsh-
|
|
311
|
-
| **[dsh-
|
|
312
|
-
| **[dsh-
|
|
313
|
-
| **[dsh-
|
|
314
|
-
| **[dsh-
|
|
315
|
-
| **[dsh-
|
|
316
|
-
| **[dsh-
|
|
317
|
-
| **[dsh-
|
|
318
|
-
| **[dsh-
|
|
319
|
-
| **[dsh-
|
|
320
|
-
| **[dsh-
|
|
321
|
-
| **[dsh-
|
|
322
|
-
| **[dsh-
|
|
323
|
-
| **[dsh-
|
|
324
|
-
| **[dsh-
|
|
325
|
-
| **[dsh-
|
|
326
|
-
| **[dsh-
|
|
327
|
-
| **[dsh-
|
|
328
|
-
| **[dsh-
|
|
329
|
-
| **[dsh-
|
|
330
|
-
| **[dsh-
|
|
331
|
-
| **[dsh-
|
|
332
|
-
| **[dsh-
|
|
333
|
-
| **[dsh-
|
|
334
|
-
| **[dsh-
|
|
335
|
-
| **[dsh-
|
|
336
|
-
| **[dsh-
|
|
337
|
-
| **[dsh-
|
|
338
|
-
| **[dsh-
|
|
339
|
-
| **[dsh-
|
|
340
|
-
| **[dsh-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 🐳 dsh-plugin-guide
|
|
4
|
+
|
|
5
|
+
**Your agent stops inventing DSH plugin APIs.**
|
|
6
|
+
|
|
7
|
+
The DeepSeek Harness plugin-development knowledge base, installed *as an agent skill* — official docs, a version-compatibility matrix, migration seams and battle-tested pitfalls, plus a scaffolder/checker CLI.
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Then just ask: *"Use the dsh-plugin-guide skill to build me a … plugin."*
|
|
14
|
+
|
|
15
|
+
[](https://gitee.com/perrylink/dsh-plugin-guide)
|
|
16
|
+
[](https://dshfind.com/plugins/PerryLink/dsh-plugin-guide?ref=badge)
|
|
17
|
+
[](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-plugin-guide)
|
|
18
|
+
|
|
19
|
+
> **Official repository.** This is the only official repository of dsh-plugin-guide, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
|
|
20
|
+
|
|
21
|
+
[](LICENSE)
|
|
22
|
+
[](https://github.com/topics/dsh-plugin)
|
|
23
|
+
[](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
24
|
+
[](https://dsh.market/)
|
|
25
|
+
[](#)
|
|
26
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/actions)
|
|
27
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/releases)
|
|
28
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
29
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
30
|
+
|
|
31
|
+
[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
|
|
32
|
+
|
|
33
|
+
</div>
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Why not just read the official docs?
|
|
38
|
+
|
|
39
|
+
Because the official docs are written for someone who already knows which page to open, and DSH ships a **prerelease every 1.7–2.8 days** with breaking changes. This plugin closes the three gaps that costs authors the most time:
|
|
40
|
+
|
|
41
|
+
| Gap | What this plugin adds |
|
|
42
|
+
|---|---|
|
|
43
|
+
| **"Which DSH am I even targeting?"** | A [version matrix](guide/version-matrix.md): the four different values that all call themselves "latest", the frozen sub-package `latest` tags, the breaking-change seams, and how to pick a `peerDependencies` range. **There is no stable line** — every published version is a prerelease. |
|
|
44
|
+
| **"What does this break?"** | A [migration guide](guide/migration-0.2.md) covering `0.1.6-alpha.2` → `0.2.1-alpha.2` as **citable seams** with symptom *and* fix, each with its official source — including a data-loss hazard and a change that makes prompts fail before a model request is built. |
|
|
45
|
+
| **"Is my plugin actually correct?"** | A [zero-dependency CLI](SKILL.md) (`dsh-plugin-dev new / check / verify`) plus an [offline verbatim mirror](references/official-docs/) of the official docs, so your agent can cite the exact page instead of guessing. |
|
|
46
|
+
|
|
47
|
+
**Prove it works in 60 seconds:**
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
51
|
+
npx dsh-plugin-guide new hello-plugin # scaffold a plugin
|
|
52
|
+
cd hello-plugin && npx dsh-plugin-guide check --json # 16 static checks
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**📖 Prefer reading it as a site?** [perrylink.github.io/dsh-plugin-guide](https://perrylink.github.io/dsh-plugin-guide/) — every chapter as its own page, plus a machine-readable [llms.txt](https://perrylink.github.io/dsh-plugin-guide/llms.txt) for assistants.
|
|
56
|
+
|
|
57
|
+
**Also on the 1024 store channel:** `npm i -g dsh1024`, then `dsh1024 plugin --profile web add dsh-plugin-guide` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
|
|
58
|
+
|
|
59
|
+
<!-- star-cta -->
|
|
60
|
+
## ⭐ 如果它帮到了你
|
|
61
|
+
|
|
62
|
+
这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员（40+ 个，全部 Apache-2.0）。如果你在用，**给个 star** —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。
|
|
63
|
+
|
|
64
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
## What is dsh-plugin-guide?
|
|
68
|
+
|
|
69
|
+
Everything you need to build [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugins.
|
|
70
|
+
|
|
71
|
+
Official docs archive · Cordis primer · community deep-dives · battle-tested pitfalls · agent skill · CLI toolchain
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
*The same run, animated.*
|
|
79
|
+
|
|
80
|
+
## Comparison
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
content counts as stated in the README (What you get)
|
|
85
|
+
|
|
86
|
+
## Compatibility
|
|
87
|
+
|
|
88
|
+
| Surface | Status |
|
|
89
|
+
|---|---|
|
|
90
|
+
| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.2` (`d743267388641bc76f17c45ce8b4c231aed1d32c`, the newest master tag **and** master HEAD, 2026-10-09); npm `latest` = `next` = `0.2.0-rc.2`, `alpha` = `0.2.1-alpha.2`. **There is no stable line** — all 31 npm versions and all 26 GitHub Releases are prereleases. The official-docs mirror is pinned to that same commit (429 md pages, re-synced 2026-10-13; see [references/official-docs/SNAPSHOT.md](references/official-docs/SNAPSHOT.md)). `guide/migration-0.2.md` covers `0.1.6-alpha.2` → `0.2.1-alpha.1` in §0–§12 and `0.2.1-alpha.1` → `0.2.1-alpha.2` as 19 citable seams in §13; the 20 breaking-change guides added since the previous baseline (19 under `v0.2.1-alpha.1` plus one backfilled into `v0.2.0-rc.2`) are all in the mirror. |
|
|
91
|
+
| Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness runtime) |
|
|
92
|
+
| Platforms | All (plain ESM bundle; no native code, no network) |
|
|
93
|
+
| Model | Any (no model interaction) |
|
|
94
|
+
|
|
95
|
+
## What you get
|
|
96
|
+
|
|
97
|
+
`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.
|
|
98
|
+
|
|
99
|
+
- **Plugin contract & hard rules** — effects/disposers, waterfall `next()`, host-owned session events, `MessageSourceMap`, the weakest-mechanism ordering, Schemastery config, UI and performance rules.
|
|
100
|
+
- **Official docs archive** — a verbatim copy of the official repo docs (EN + ZH), byte-identical to upstream at the last verified snapshot, including the pages that never reach the documentation site.
|
|
101
|
+
- **Version adaptivity** — [guide/version-matrix.md](guide/version-matrix.md): the five different "latest" values, the frozen sub-package `latest` tags, the four breaking-change seams, the canonical peer range and how to pick one, the session-format lineage V0→V4, and the 19 breaking changes that landed in `0.2.1-alpha.2`.
|
|
102
|
+
- **Migration guide** — [guide/migration-0.2.md](guide/migration-0.2.md): every breaking change from `0.1.6-alpha.2` to `0.2.1-alpha.1` (session format V4, the settings rebuild, invariant removal, `readBytes`, new slots, retired `plugin` message source), each with its official source and a 12-item checklist.
|
|
103
|
+
- **Official in-repo skill, distilled** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): the harness's own `cordis-plugin-development` workflow, prohibitions, display-metadata checklist, practices, and UI/performance rules.
|
|
104
|
+
- **Cordis primer** — the five concepts and the mechanism timeline (repository-plugin introduced 0809, removed 0811; the two install channels).
|
|
105
|
+
- **Verified issue index** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 unfixed + 11 newly verified items with `path:line`, workarounds, fixing commits, design-vs-bug table, and an explicit "unreproducible" section.
|
|
106
|
+
- **30+ real-world pitfalls** with root cause + fix (cordis dual copies, tsconfig trio, multi-frame zstd sessions, Windows junctions, stale npm `latest`, `file:` installs loading a copy, live patch writes, …).
|
|
107
|
+
- **Community deep-dives** — 114 community repositories archived (15 deep-dived), plus a full source index where every fact links to its origin.
|
|
108
|
+
- **CLI toolchain** — `dsh-plugin-dev new / check / verify`: scaffold, static-check (including display metadata and multi-patch manifests), and pack-verify DSH plugins; every check links back to the skill section it enforces.
|
|
109
|
+
|
|
110
|
+
## Knowledge base
|
|
111
|
+
|
|
112
|
+
| Path | What it is |
|
|
113
|
+
|---|---|
|
|
114
|
+
| `SKILL.md` | The `dsh-plugin-guide` agent skill: hard rules + task-based development paths |
|
|
115
|
+
| `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | The installable DSH bundle: `dsh.bundle.patch` manifest, entry point that registers the skill, and the display metadata Plugin Manager reads |
|
|
116
|
+
| `guide/plugin-dev-guide.md` | The complete development guide (10 chapters) |
|
|
117
|
+
| `guide/version-matrix.md` | **Version adaptivity matrix**: the five "latest" values, frozen sub-package `latest` tags, breaking-change seams, peer-range selection, session-format lineage, and the 19 changes in `0.2.1-alpha.2` |
|
|
118
|
+
| `guide/migration-0.2.md` | Breaking-change migration guide for the 0.2 generation |
|
|
119
|
+
| `guide/unfixed-issues.md` | Source-verified bug index + fixed-on-master list + design-vs-bug table |
|
|
120
|
+
| `guide/quick-reference.md` | One-page cheat sheet (5 languages) |
|
|
121
|
+
| `guide/links.md` | Curated URL index: official dev docs (site ↔ local copies) + community doc links + repo-only pages |
|
|
122
|
+
| `guide/when-to-retire-a-plugin.md` | Retiring and freezing plugins: the criteria and the measured data behind a portfolio audit (EN + ZH) |
|
|
123
|
+
| `guide/choosing-a-plugin.md` | Choosing a plugin: who leads each capability surface, with the measured numbers and the verification caveats (EN + ZH) |
|
|
124
|
+
| `references/official-docs/` | Verbatim copy of the official repo docs (EN + ZH) |
|
|
125
|
+
| `references/official-plugin-dev-skill.md` | Distilled official in-repo plugin-development skill |
|
|
126
|
+
| `references/*.md` | Research reports: repo docs, website, Cordis, the paper, community ecosystem, 114-repo archive (15 deep-dived) |
|
|
127
|
+
| `scripts/` | Idempotent download scripts + integrity checker + topic snapshot generator |
|
|
128
|
+
| `bin/` · `src/cli/` · `dist/` | The `dsh-plugin-dev` CLI: scaffolder, checker, verifier (TypeScript, tsdown-bundled) |
|
|
129
|
+
| `templates/` | TS + JS scaffold skeletons: contract template, Config, tests, cordis.patch.yml, locale metadata, icon, five-language READMEs |
|
|
130
|
+
| `downloads/` | Raw snapshots — generated by `scripts/`, not committed |
|
|
131
|
+
|
|
132
|
+
## CLI toolchain
|
|
133
|
+
|
|
134
|
+
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.
|
|
135
|
+
|
|
136
|
+
```sh
|
|
137
|
+
dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
|
|
138
|
+
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
|
|
139
|
+
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
|
|
140
|
+
dsh-plugin-dev seams <query> | --since <version> # is this API in my target host?
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
| Subcommand | What it does |
|
|
144
|
+
|---|---|
|
|
145
|
+
| `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`. |
|
|
146
|
+
| `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. |
|
|
147
|
+
| `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. |
|
|
148
|
+
|
|
149
|
+
### CLI configuration
|
|
150
|
+
|
|
151
|
+
The CLI has no hardcoded tunables — each is a flag or an environment variable.
|
|
152
|
+
|
|
153
|
+
| Tunable | Flag | Env | Default |
|
|
154
|
+
|---|---|---|---|
|
|
155
|
+
| Templates directory | — | `DSH_PLUGIN_DEV_TEMPLATES` | `<package>/templates` |
|
|
156
|
+
| dsh binary | `--dsh` | `DSH_PLUGIN_DEV_DSH` | `dsh` |
|
|
157
|
+
| pnpm binary | `--pnpm` | `DSH_PLUGIN_DEV_PNPM` | `pnpm` |
|
|
158
|
+
| Install/pack timeout | `--timeout` | `DSH_PLUGIN_DEV_TIMEOUT` | `300000` ms |
|
|
159
|
+
| Headless smoke timeout | `--smoke-timeout` | `DSH_PLUGIN_DEV_SMOKE_TIMEOUT` | `120000` ms |
|
|
160
|
+
|
|
161
|
+
### Upstream roadmap
|
|
162
|
+
|
|
163
|
+
`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.
|
|
164
|
+
|
|
165
|
+
## Quick start
|
|
166
|
+
|
|
167
|
+
```sh
|
|
168
|
+
# 1. install the bundle into your profile — npm first
|
|
169
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
170
|
+
|
|
171
|
+
# 2. restart and verify the row
|
|
172
|
+
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
⚠️ **Use the npm channel, not the git channel, for a first install.** The git channel pulls source, and
|
|
176
|
+
`dist/` is not committed, so pnpm has to run this package's `prepare` build script — which pnpm 10+ blocks
|
|
177
|
+
until you explicitly allowlist it (`allowBuilds`). That is a documented pitfall of git installs, not a
|
|
178
|
+
defect, but it makes the git channel a poor first experience. See [Install & uninstall](#install--uninstall)
|
|
179
|
+
for the git and tarball channels when you specifically want an unreleased commit.
|
|
180
|
+
|
|
181
|
+
Then just ask your agent: *"Use the dsh-plugin-guide skill to build me a … plugin."*
|
|
182
|
+
|
|
183
|
+
Or drive the CLI directly:
|
|
184
|
+
|
|
185
|
+
```sh
|
|
186
|
+
npx dsh-plugin-guide new hello-plugin # scaffold a TS plugin repo
|
|
187
|
+
npx dsh-plugin-guide check --json # static-check it
|
|
188
|
+
npx dsh-plugin-guide verify # pack + clean-profile smoke
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
## Install & uninstall
|
|
192
|
+
|
|
193
|
+
- **npm channel** (published releases — **the default; start here**): `dsh plugin --profile web add dsh-plugin-guide`. The published tarball already contains `dist/`, so no build step runs.
|
|
194
|
+
- **git channel** (latest `main`, or an unreleased commit): `dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha>` — pin a commit for reproducibility. ⚠️ `dist/` is not committed, so pnpm must run this package's `prepare` and will refuse until the build is allowlisted; add it to the profile's `allowBuilds` (see [publish.md](references/official-docs/docs/user/develop/basic/publish.md)).
|
|
195
|
+
- **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz`.
|
|
196
|
+
- **uninstall**: `dsh plugin --profile web remove dsh-plugin-guide`.
|
|
197
|
+
|
|
198
|
+
## Copy as a plain agent skill
|
|
199
|
+
|
|
200
|
+
You can also copy the whole folder into your agent's skill directory (relative paths stay intact):
|
|
201
|
+
|
|
202
|
+
```powershell
|
|
203
|
+
# Windows (PowerShell)
|
|
204
|
+
pwsh -File scripts/install-skill.ps1 `
|
|
205
|
+
-Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # or <project>\.agents\skills\dsh-plugin-guide
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
```bash
|
|
209
|
+
# macOS / Linux
|
|
210
|
+
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide # or <project>/.agents/skills/dsh-plugin-guide
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
The installer skips `downloads/` (generated) and `.github/`, then verifies every copied file byte-for-byte. A manual `Copy-Item -Recurse` of the whole folder also works.
|
|
214
|
+
|
|
215
|
+
## Configuration
|
|
216
|
+
|
|
217
|
+
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)).
|
|
218
|
+
|
|
219
|
+
## Tools & surfaces
|
|
220
|
+
|
|
221
|
+
| Surface | Kind | Notes |
|
|
222
|
+
|---|---|---|
|
|
223
|
+
| `dsh-plugin-guide` | skill | Registered via `ctx.skills`; loads `SKILL.md` + `./guide/` + `./references/` on demand |
|
|
224
|
+
| `dsh-plugin-dev` | bin (CLI) | `new` / `check` / `verify` subcommands; not a DSH plugin row |
|
|
225
|
+
|
|
226
|
+
## Permissions & data
|
|
227
|
+
|
|
228
|
+
- **Permissions**: declares `filesystem:read` in its workshop manifest.
|
|
229
|
+
- **Data**: read-only — reads its own bundled `guide/` and `references/` files. No network requests, no writes, no model calls.
|
|
230
|
+
|
|
231
|
+
## Security boundaries
|
|
232
|
+
|
|
233
|
+
- **Read-only knowledge base.** The bundle only reads its own files; it never writes, never calls the network, and never invokes a model.
|
|
234
|
+
- **Official docs are verbatim copies.** `references/official-docs/` is never edited here; report issues upstream and re-sync only with `scripts/sync-official-docs.ps1`.
|
|
235
|
+
- **Distribution boundaries.** Bundled third-party content keeps its upstream license; see [NOTICE.md](NOTICE.md) (e.g. `downloads/` is local-only; `awesome-dsh-plugins` must not be redistributed).
|
|
236
|
+
|
|
237
|
+
## Known limitations
|
|
238
|
+
|
|
239
|
+
- **Official docs are a snapshot.** Re-sync with `scripts/sync-official-docs.ps1` when upstream moves; the freshness stamp and commit hash reference `references/official-docs/SNAPSHOT.md`.
|
|
240
|
+
- **`downloads/` is generated, not committed.** Raw snapshots (community repo archives, Discussions, articles) must be generated with the scripts before use.
|
|
241
|
+
- **`awesome-dsh-plugins` content is local-only.** Its upstream declares an internal-use constraint, so it is not redistributed with the repo.
|
|
242
|
+
|
|
243
|
+
## Release channels
|
|
244
|
+
|
|
245
|
+
Every channel resolves from this repository or from npm, so one tag reaches all of them; only the Gitee mirror is a scheduled copy:
|
|
246
|
+
|
|
247
|
+
| Channel | Source of truth | How it updates |
|
|
248
|
+
|---|---|---|
|
|
249
|
+
| npm (`dsh-plugin-guide`) | this repo's `package.json` | `.github/workflows/release.yml` on a `v*` tag: `verify-kit` gate → CHANGELOG section check → `npm publish --provenance` (skipped when the version already exists) |
|
|
250
|
+
| GitHub Release | the same tag | the same workflow creates it idempotently from the tag |
|
|
251
|
+
| Discovery badges (npm version, GitHub tag, DSH Market, dsh-doctor) | live lookups | nothing to publish — they read npm/the registry on each render |
|
|
252
|
+
| Gitee mirror | this repo | a **read-only scheduled mirror**, not a publish target: it is force-aligned to the GitHub tip (`--force-with-lease`) by the family's `gitee-sync` workflow, so `main` is normally one scheduled run behind. Gitee never receives a tag push from here; compare `git ls-remote` against GitHub before reporting the mirror stale |
|
|
253
|
+
| DSH Desktop Market / dsh1024 | npm | the market installs the npm package, so a published version is immediately installable; no per-version submission |
|
|
254
|
+
|
|
255
|
+
## Keeping it fresh
|
|
256
|
+
|
|
257
|
+
```sh
|
|
258
|
+
pwsh -File scripts/sync-official-docs.ps1 # verbatim docs copy from a local checkout
|
|
259
|
+
pwsh -File scripts/download-sources.ps1 # official site/docs, Cordis, paper
|
|
260
|
+
pwsh -File scripts/download-community-repos.ps1 # community repositories (codeload tarballs)
|
|
261
|
+
pwsh -File scripts/download-community-articles.ps1 # zh/en/HN community articles
|
|
262
|
+
pwsh -File scripts/archive-discussions.ps1 # official Discussions (needs $env:GH_TOKEN)
|
|
263
|
+
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir> # dsh-plugin topic census
|
|
264
|
+
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # critical paths + link scan + docs drift
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
## Development
|
|
268
|
+
|
|
269
|
+
The skill bundle (`index.js`) is plain ESM with no build step; the `dsh-plugin-dev` CLI is TypeScript built by tsdown. Gates:
|
|
270
|
+
|
|
271
|
+
```sh
|
|
272
|
+
pnpm install --frozen-lockfile
|
|
273
|
+
pnpm run typecheck && pnpm run typecheck:ci
|
|
274
|
+
pnpm test
|
|
275
|
+
pnpm run build
|
|
276
|
+
pnpm run verify:artifacts # dogfood self-check + scaffold smoke (no network)
|
|
277
|
+
pnpm run verify:self-contained # pack + clean-profile install/start/uninstall smoke
|
|
278
|
+
pnpm run check:readmes # five READMEs share section structure
|
|
279
|
+
pnpm run check:parity # translations have identical block counts
|
|
280
|
+
pnpm run check:facts # self-stated numbers match data/facts.json
|
|
281
|
+
pnpm run check:ps1-bom # PowerShell scripts keep their UTF-8 BOM
|
|
282
|
+
pnpm pack
|
|
283
|
+
pwsh -File scripts/verify-kit.ps1 # critical paths + link scan (+ docs drift with -Checkout <checkout>)
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
## Topics
|
|
287
|
+
|
|
288
|
+
`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`, `cli`, `scaffold`, `checker`
|
|
289
|
+
|
|
290
|
+
## Contributors
|
|
291
|
+
|
|
292
|
+
- [PerryLink](https://github.com/PerryLink) — creator and maintainer: knowledge-base content, the installable-bundle transformation, ecosystem submissions, and community engineering.
|
|
293
|
+
- [@Yisa-yi](https://github.com/Yisa-yi) — **product manager**. Took part in the whole design arc, from the first outline to the shipped bundle, and owned the shape of the product rather than its code: the call to ship it as an installable bundle that registers an on-demand agent skill (the docs site renders those same sources rather than carrying a separate content set), the information architecture of the 10-chapter guide, the "every fact links to its origin" rule, and the split between the cognitive layer (`SKILL.md` + `guide/`) and the mechanical layer (`dsh-plugin-dev new / check / verify`). Set the evidence standard behind `guide/unfixed-issues.md` — `path:line` against a named host commit, a design-vs-bug table, and an explicit unreproducible section — and the freeze/retire criteria in `guide/when-to-retire-a-plugin.md`. Held the scope line (read-only, no network, no model calls, no tunable keys) and the five-language README parity requirement.
|
|
294
|
+
- Day-to-day maintenance is assisted by DeepSeek Harness agents (they hold no GitHub account and are listed here for transparency, not as contributors).
|
|
295
|
+
|
|
296
|
+
## PerryLink DSH Plugin Family
|
|
297
|
+
|
|
298
|
+
This project is one of the **34 actively maintained** DeepSeek Harness plugins from [PerryLink](https://github.com/PerryLink) — the roster is **42**, of which **5** are frozen and **3** retired; every one keeps its row below, with the reason in the Status column. If this one helps you, the others likely will too:
|
|
299
|
+
|
|
300
|
+
| Plugin | One-liner | Status |
|
|
301
|
+
|---|---|---|
|
|
302
|
+
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | Second-model auto-review on the approval chain, fail-closed by default | |
|
|
303
|
+
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | Durable background child agents with a Web UI sidebar, messaging and interrupt | 🚫 **RETIRED** — see the note above |
|
|
304
|
+
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. | 🧊 FROZEN — see the repo README |
|
|
305
|
+
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore | |
|
|
306
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH | 🧊 FROZEN — see the repo README |
|
|
307
|
+
| **[dsh-click](https://github.com/PerryLink/dsh-click)** | Cross-platform native desktop control for DeepSeek Harness — Windows first. | |
|
|
308
|
+
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | Terminal-style input history for the web composer: arrows, Ctrl+R search | |
|
|
309
|
+
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here) | |
|
|
310
|
+
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. | 🧊 FROZEN — see the repo README |
|
|
311
|
+
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | Engineering-discipline guard: requirements grill, test gates, adversary review | |
|
|
312
|
+
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | Unified static-image generation routing for DeepSeek Harness. | 🧊 FROZEN — see the repo README |
|
|
313
|
+
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | Read-only performance diagnostics for DeepSeek Harness. | |
|
|
314
|
+
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | Deterministic research reports for Chinese public mutual funds | |
|
|
315
|
+
| **[dsh-github](https://github.com/PerryLink/dsh-github)** | GitHub PR/issues integration for DSH, every write gated by approval | |
|
|
316
|
+
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | Industry research orchestration that seals its deliverables through this plugin's `ctx.researchReport.assemble` | |
|
|
317
|
+
| **[dsh-library](https://github.com/PerryLink/dsh-library)** | Local document knowledge base for DeepSeek Harness. | |
|
|
318
|
+
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | Local-model (Ollama) integration for DeepSeek Harness. | |
|
|
319
|
+
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | LSP diagnostics, formatting, completion, code actions and rename over language servers | |
|
|
320
|
+
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | PII masking middleware: anonymize at the model boundary, restore at the display layer | |
|
|
321
|
+
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors | |
|
|
322
|
+
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool | |
|
|
323
|
+
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. | |
|
|
324
|
+
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Claude Code outputStyles-equivalent runtime style switching | |
|
|
325
|
+
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | Claude Code-style declarative allow/deny/ask permission rules with audit | |
|
|
326
|
+
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console | 🧊 FROZEN — see the repo README |
|
|
327
|
+
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | Verifiable research-report engine: content-addressed evidence ledger and sealed versions | |
|
|
328
|
+
| **[dsh-score](https://github.com/PerryLink/dsh-score)** | Multi-dimensional quality scoring for DeepSeek Harness plugins. | |
|
|
329
|
+
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | Pin sessions in the Web sidebar with durable ordering | 🚫 **RETIRED** — see the note above |
|
|
330
|
+
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store. | |
|
|
331
|
+
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | Security-audit skill pack: secret scan, dependency and supply-chain review | |
|
|
332
|
+
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. | |
|
|
333
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | Isolated install-and-smoke test drives for DeepSeek Harness plugins. | |
|
|
334
|
+
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | TickTick/Dida365 task bridge: session-header panel + 11 tools | |
|
|
335
|
+
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. | |
|
|
336
|
+
| **[dsh-wechat](https://github.com/pan17/dsh-wechat)** | WeChat ↔ DSH bridge (Tencent iLink bot): text/image/file/voice, approvals in chat | |
|
|
337
|
+
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | Automatic strong/cheap model-tier routing with deterministic risk guards and a `/tier` command | |
|
|
338
|
+
| **[dsh-catalog](https://github.com/PerryLink/dsh-catalog)** | DSH Desktop Market standard catalog source for the PerryLink family | |
|
|
339
|
+
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence | |
|
|
340
|
+
| **[dsh-kit](https://github.com/PerryLink/dsh-kit)** | One-command starter pack that installs the core family | |
|
|
341
|
+
| **[dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification)** | Community certification registry with repro-checkable grades and badges | |
|
|
342
|
+
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins | |
|
|
343
|
+
| **[dsh-plugin-portal](https://github.com/PerryLink/dsh-plugin-portal)** | Zero-dependency static portal rendering the whole plugin family as one page | |
|
|
344
|
+
| **[dsh-plugin-upgrade-015](https://github.com/PerryLink/dsh-plugin-upgrade-015)** | Merged `0.1.3-alpha.1` → `0.1.5-rc.1` upgrade corridor card plus a zero-dependency seam scanner | 🚫 RETIRED — corridors carried by `dsh-plugin-upgrade` |
|
|
345
|
+
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | Cross-session team rooms: shared message bus, task board and timeline | 🚫 **RETIRED** — see the note above |
|
|
346
|
+
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | Zero-dependency static + sandbox smoke detector for DSH plugins | |
|
|
347
|
+
|
|
348
|
+
## Disclaimer
|
|
349
|
+
|
|
350
|
+
Community-maintained, **not** an official DeepSeek product. DeepSeek Harness is in developer preview and ships breaking changes; when in doubt, the official docs in `references/official-docs/` are the source of truth.
|
|
351
|
+
|
|
352
|
+
### Install from the DSH Desktop Market
|
|
353
|
+
|
|
354
|
+
All PerryLink plugins are browsable in the built-in DSH Desktop Market: **Market → Sources → add source → paste** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ select it**. Installation still goes through the Market's npm-identity verification and your confirmation.
|
|
355
|
+
|
|
356
|
+
## License
|
|
357
|
+
|
|
358
|
+
[Apache License 2.0](LICENSE) © 2026 dsh-plugin-guide contributors — our own text (`SKILL.md`, `guide/`, `references/`, `scripts/`, this README) is Apache-2.0; bundled third-party content is documented in [NOTICE.md](NOTICE.md).
|