dsh-plugin-guide 0.3.18 → 0.3.20

package/README-es.md

@@ -25,11 +25,18 @@
 
 ---
 
+<!-- star-cta -->
+## ⭐ 如果它帮到了你
+
+Este plugin forma parte de la [familia de plugins DSH](https://github.com/PerryLink) (más de 40, todos Apache-2.0). Si te resulta útil, **dale una estrella**: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre antes.
+
+*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.
+
 ## Compatibility
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (re-sincronizado el 2026-09-24, `ddefc45`): la instantánea de docs oficiales se refrescó a rc.1, el checker ahora espera el rango de pares de cuatro cláusulas (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) con fuente única en las plantillas del andamiaje, y una nueva línea roja falla las funciones `async apply` que registran después de su primer `await`. Cadena de gates local verde (40 tests, typecheck, dogfood de `verify`); la ejecución real rc.1 del job compat llega con el próximo push de CI. |
+| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (re-sincronizado el 2026-09-24, `ddefc45`): la instantánea de docs oficiales se refrescó a rc.1, el checker ahora espera el rango de pares de cuatro cláusulas (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) con fuente única en las plantillas del andamiaje, y una nueva línea roja falla las funciones `async apply` que registran después de su primer `await`. Cadena de gates local verde (40 tests, typecheck, dogfood de `verify`); la ejecución real rc.1 del job compat llega con el próximo push de CI. |
 | Node | `^22.19.0 || >=24.0.0` (runtime de DeepSeek Harness) |
 | Platforms | Todas (bundle ESM plano; sin código nativo, sin red) |
 | Model | Cualquiera (sin interacción con el modelo) |

package/README-hi.md

@@ -25,11 +25,18 @@
 
 ---
 
+<!-- star-cta -->
+## ⭐ 如果它帮到了你
+
+यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (40+ प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।
+
+*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.
+
 ## Compatibility
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (2026-09-24 को पुनः-सिंक किया गया, `ddefc45`): आधिकारिक दस्तावेज़ स्नैपशॉट rc.1 पर ताज़ा किया गया; checker अब चार-खंड peer रेंज (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) की अपेक्षा करता है (स्कैफ़ोल्ड टेम्पलेट्स के साथ एकल स्रोत); नई रेड लाइन — पहले `await` के बाद पंजीकरण करने वाले `async apply` विफल होते हैं। स्थानीय gate chain हरा (40 टेस्ट, typecheck, verify dogfood); compat job की वास्तविक rc.1 रन अगले CI push के साथ आती है। |
+| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (2026-09-24 को पुनः-सिंक किया गया, `ddefc45`): आधिकारिक दस्तावेज़ स्नैपशॉट rc.1 पर ताज़ा किया गया; checker अब चार-खंड peer रेंज (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) की अपेक्षा करता है (स्कैफ़ोल्ड टेम्पलेट्स के साथ एकल स्रोत); नई रेड लाइन — पहले `await` के बाद पंजीकरण करने वाले `async apply` विफल होते हैं। स्थानीय gate chain हरा (40 टेस्ट, typecheck, verify dogfood); compat job की वास्तविक rc.1 रन अगले CI push के साथ आती है। |
 | Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness रनटाइम) |
 | Platforms | सभी (सादा ESM बंडल; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
 | Model | कोई भी (कोई मॉडल अंतःक्रिया नहीं) |

package/README-pt.md

@@ -25,11 +25,18 @@
 
 ---
 
+<!-- star-cta -->
+## ⭐ 如果它帮到了你
+
+Este plugin faz parte da [família de plugins DSH](https://github.com/PerryLink) (mais de 40, todos Apache-2.0). Se for útil, **deixe uma estrela**: não desbloqueia nada, mas ajuda a próxima pessoa a encontrá-lo.
+
+*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.
+
 ## Compatibility
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (re-sincronizado em 2026-09-24, `ddefc45`): o snapshot de docs oficiais foi atualizado para rc.1, o checker agora espera o intervalo de pares de quatro cláusulas (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) com fonte única nos templates do scaffold, e uma nova linha vermelha falha funções `async apply` que registram após seu primeiro `await`. Cadeia de gates local verde (40 testes, typecheck, dogfood do `verify`); a execução real rc.1 do job compat chega com o próximo push de CI. |
+| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (re-sincronizado em 2026-09-24, `ddefc45`): o snapshot de docs oficiais foi atualizado para rc.1, o checker agora espera o intervalo de pares de quatro cláusulas (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) com fonte única nos templates do scaffold, e uma nova linha vermelha falha funções `async apply` que registram após seu primeiro `await`. Cadeia de gates local verde (40 testes, typecheck, dogfood do `verify`); a execução real rc.1 do job compat chega com o próximo push de CI. |
 | Node | `^22.19.0 || >=24.0.0` (runtime do DeepSeek Harness) |
 | Platforms | Todas (bundle ESM puro; sem código nativo, sem rede) |
 | Model | Qualquer (sem interação com o modelo) |

package/README-zh.md

@@ -27,11 +27,18 @@
 
 ---
 
+<!-- star-cta -->
+## ⭐ 如果它帮到了你
+
+这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员（40+ 个，全部 Apache-2.0）。如果你在用，**给个 star** —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。
+
+*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.
+
 ## Compatibility
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.1.7-rc.1`（2026-09-24 重同步，`ddefc45`）：官方文档快照已刷新到 rc.1；checker 现在期望四段式 peer 区间（`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`，与脚手架模板单源）；新增红线——`async apply` 在首个 `await` 之后注册即判错。本地门禁链绿（40 测试、typecheck、verify 自测）；compat job 的真机 rc.1 跑在下次 CI push 后生效。 |
+| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1`（2026-09-24 重同步，`ddefc45`）：官方文档快照已刷新到 rc.1；checker 现在期望四段式 peer 区间（`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`，与脚手架模板单源）；新增红线——`async apply` 在首个 `await` 之后注册即判错。本地门禁链绿（40 测试、typecheck、verify 自测）；compat job 的真机 rc.1 跑在下次 CI push 后生效。 |
 | Node | `^22.19.0 || >=24.0.0`（DeepSeek Harness 运行时） |
 | Platforms | 全部（纯 ESM bundle；无原生代码、无网络） |
 | Model | 任意（无模型交互） |

package/README.md

@@ -40,7 +40,7 @@
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (re-synced 2026-09-24, `ddefc45`): the official-docs snapshot is refreshed to rc.1, the checker now expects the four-clause peer range (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) single-sourced from the scaffold templates, and a new red line fails `async apply` functions that register after their first `await`. Local gate chain green (40 tests, typecheck, `verify` dogfood); the compat job's real rc.1 run lands with the next CI push. |
+| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (re-synced 2026-09-24, `ddefc45`): the official-docs snapshot is refreshed to rc.1, the checker now expects the four-clause peer range (`… || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`) single-sourced from the scaffold templates, and a new red line fails `async apply` functions that register after their first `await`. Local gate chain green (40 tests, typecheck, `verify` dogfood); the compat job's real rc.1 run lands with the next CI push. |
 | Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness runtime) |
 | Platforms | All (plain ESM bundle; no native code, no network) |
 | Model | Any (no model interaction) |

package/dist/dsh-plugin-dev.js

@@ -1690,7 +1690,7 @@ function suggestionsFor(step, result) {
 	const base = [`tail of "${step}":\n${tailOf(result)}`];
 	if (result.timedOut) base.push(`command timed out; raise --timeout or --smoke-timeout`);
 	if (step === "install") {
-		base.push("ensure the dsh CLI is @deepseek-ai/dsh@0.1.7-rc.1 (older builds such as the rc.6 line do not satisfy the compat pin)");
+		base.push("ensure the dsh CLI is @deepseek-ai/dsh@0.1.7-rc.2 (older builds such as the rc.6 line do not satisfy the compat pin)");
 		base.push("confirm the profile allowlist matches the repo compat workflow (native builds allowlisted)");
 	}
 	if (step === "headless") base.push("a hang usually means an injected service stayed pending; the smoke timeout surfaces exactly that");
@@ -1811,8 +1811,8 @@ async function main(argv, cwd = process.cwd()) {
 					dshBin: resolveDsh(flagString(flags, "dsh")),
 					pnpmBin: resolvePnpm(flagString(flags, "pnpm")),
 					profile: flagString(flags, "profile", "compat") ?? "compat",
-					base: flagString(flags, "base", "@deepseek-ai/dsh-base@0.1.7-rc.1") ?? "@deepseek-ai/dsh-base@0.1.7-rc.1",
-					headless: flagString(flags, "headless", "@deepseek-ai/dsh-headless@0.1.7-rc.1") ?? "@deepseek-ai/dsh-headless@0.1.7-rc.1",
+					base: flagString(flags, "base", "@deepseek-ai/dsh-base@0.1.7-rc.2") ?? "@deepseek-ai/dsh-base@0.1.7-rc.2",
+					headless: flagString(flags, "headless", "@deepseek-ai/dsh-headless@0.1.7-rc.2") ?? "@deepseek-ai/dsh-headless@0.1.7-rc.2",
 					timeoutMs: timeoutMs(flags, "timeout", "DSH_PLUGIN_DEV_TIMEOUT", DEFAULT_TIMEOUT_MS),
 					smokeTimeoutMs: timeoutMs(flags, "smoke-timeout", "DSH_PLUGIN_DEV_SMOKE_TIMEOUT", DEFAULT_SMOKE_TIMEOUT_MS)
 				});

package/guide/release-engineering.md

@@ -45,7 +45,7 @@ The pattern that admits all windows (one clause per prerelease tuple; each `-0`
     "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2"
   }
 }
 ```

package/guide/release-engineering.zh-CN.md

@@ -45,7 +45,7 @@
     "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2"
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-guide",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "The dsh-plugin-guide knowledge base plus the dsh-plugin-dev CLI toolchain: official docs, Cordis primer, community deep-dives, and battle-tested pitfalls registered as an on-demand agent skill, with a scaffolder, static checker, and pack verifier for building DSH plugins.",
   "type": "module",
   "main": "index.js",
@@ -64,12 +64,12 @@
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
     "@types/node": "^22.20.1",
     "vitest": "^3.2.7"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0"
+    "@deepseek-ai/dsh": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh": {
@@ -106,7 +106,8 @@
       "filesystem:read"
     ],
     "compatibility": {
-      "dshVersions": ["0.1.2-rc.1","0.1.5-rc.2","0.1.7-alpha.2","0.1.7-rc.1"]
+      "dshVersions": ["0.1.2-rc.1","0.1.5-rc.2","0.1.7-alpha.2","0.1.7-rc.1", "0.1.7-rc.2",
+        "0.2.1-alpha.1"]
     },
     "capability": {
       "id": "dsh-plugin-guide",

package/templates/js/README-es.md

@@ -6,7 +6,7 @@ Un plugin de DeepSeek Harness (DSH) generado con [`dsh-plugin-dev new`](https://
 
 | Superficie | Estado |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Plataformas | Todas (ESM puro; sin código nativo, sin red) |
 

package/templates/js/README-hi.md

@@ -6,7 +6,7 @@
 
 | सतह | स्थिति |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | प्लेटफ़ॉर्म | सभी (शुद्ध ESM; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
 

package/templates/js/README-pt.md

@@ -6,7 +6,7 @@ Um plugin do DeepSeek Harness (DSH) gerado com [`dsh-plugin-dev new`](https://gi
 
 | Superfície | Estado |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Plataformas | Todas (ESM puro; sem código nativo, sem rede) |
 

package/templates/js/README-zh.md

@@ -6,7 +6,7 @@
 
 | 项目 | 状态 |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | 平台 | 全部（纯 ESM；无原生代码、无网络） |
 

package/templates/js/README.md

@@ -6,7 +6,7 @@ A DeepSeek Harness (DSH) plugin scaffolded by [`dsh-plugin-dev new`](https://git
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Platforms | All (plain ESM; no native code, no network) |
 

package/templates/ts/README-es.md

@@ -6,7 +6,7 @@ Un plugin de DeepSeek Harness (DSH) generado con [`dsh-plugin-dev new`](https://
 
 | Superficie | Estado |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Plataformas | Todas (ESM puro; sin código nativo, sin red) |
 

package/templates/ts/README-hi.md

@@ -6,7 +6,7 @@
 
 | सतह | स्थिति |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | प्लेटफ़ॉर्म | सभी (शुद्ध ESM; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
 

package/templates/ts/README-pt.md

@@ -6,7 +6,7 @@ Um plugin do DeepSeek Harness (DSH) gerado com [`dsh-plugin-dev new`](https://gi
 
 | Superfície | Estado |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Plataformas | Todas (ESM puro; sem código nativo, sem rede) |
 

package/templates/ts/README-zh.md

@@ -6,7 +6,7 @@
 
 | 项目 | 状态 |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | 平台 | 全部（纯 ESM；无原生代码、无网络） |
 

package/templates/ts/README.md

@@ -6,7 +6,7 @@ A DeepSeek Harness (DSH) plugin scaffolded by [`dsh-plugin-dev new`](https://git
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `0.1.7-rc.1` |
+| Harness | DeepSeek Harness `0.1.7-rc.2` |
 | Node | `^22.19.0 || >=24.0.0` |
 | Platforms | All (plain ESM; no native code, no network) |