dsh-plugin-guide 0.3.32 → 0.3.35

package/README-es.md

@@ -59,7 +59,7 @@ Todo lo que necesitas para construir plugins de [DeepSeek Harness](https://githu
 
 Archivo de documentación oficial · primer de Cordis · deep-dives de la comunidad · trampas probadas en batalla · agent skill · toolchain CLI
 
-![Demostración de terminal de dsh-plugin-guide: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.png)
+![Demostración de terminal de dsh-plugin-guide: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-hero.png)
 
 ![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
@@ -125,6 +125,7 @@ El bundle incluye el CLI `dsh-plugin-dev` sin dependencias de runtime (`bin/`
 dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
 dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
 dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
+dsh-plugin-dev seams <query> | --since <version>   # ¿existe esta API en mi host destino?
 ```
 
 | Subcomando | Qué hace |
@@ -258,6 +259,10 @@ pnpm test
 pnpm run build
 pnpm run verify:artifacts        # auto-check + smoke de scaffold (sin red)
 pnpm run verify:self-contained   # pack + smoke de instalación/inicio/desinstalación en perfil limpio
+pnpm run check:readmes           # five READMEs share section structure
+pnpm run check:parity            # translations have identical block counts
+pnpm run check:facts             # self-stated numbers match data/facts.json
+pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
 pnpm pack
 pwsh -File scripts/verify-kit.ps1   # rutas críticas + escaneo de enlaces (+ deriva de docs con -Checkout <checkout>)
 ```
@@ -269,6 +274,7 @@ pwsh -File scripts/verify-kit.ps1   # rutas críticas + escaneo de enlaces (+ de
 ## Contributors
 
 - [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.
+- [@Yisa-yi](https://github.com/Yisa-yi) — **product manager**. Participó en todo el arco de diseño, desde el primer esquema hasta el bundle publicado, y se ocupó de la forma del producto más que de su código: la decisión de que se entregara como bundle instalable que registra una agent skill bajo demanda (el sitio de documentación renderiza esas mismas fuentes y no un conjunto de contenido aparte), la arquitectura de la información de la guía de 10 capítulos, la regla de que cada hecho enlace con su origen, y la separación entre la capa cognitiva (`SKILL.md` + `guide/`) y la capa mecánica (`dsh-plugin-dev new / check / verify`). Fijó el estándar de evidencia de `guide/unfixed-issues.md` — `path:line` contra un commit concreto del host, la tabla diseño-vs-bug y una sección explícita de no reproducible — y los criterios de congelación y retirada de `guide/when-to-retire-a-plugin.md`. Sostuvo la línea de alcance (solo lectura, sin red, sin llamadas al modelo, sin claves configurables) y el requisito de paridad de los README en cinco idiomas.
 - El mantenimiento diario está asistido por agentes de DeepSeek Harness (no tienen cuenta de GitHub y se listan aquí por transparencia, no como contribuyentes).
 
 ## PerryLink DSH Plugin Family

package/README-hi.md

@@ -59,7 +59,7 @@ dsh plugin --profile web add dsh-plugin-guide
 
 आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill · CLI टूलचेन
 
-![dsh-plugin-guide का टर्मिनल डेमो: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.png)
+![dsh-plugin-guide का टर्मिनल डेमो: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-hero.png)
 
 ![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
@@ -125,6 +125,7 @@ content counts as stated in the README (What you get)
 dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
 dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
 dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
+dsh-plugin-dev seams <query> | --since <version>   # क्या यह API मेरे लक्ष्य होस्ट में है?
 ```
 
 | उप-कमांड | क्या करता है |
@@ -258,6 +259,10 @@ pnpm test
 pnpm run build
 pnpm run verify:artifacts        # आत्म-जाँच + स्कैफ़ोल्ड स्मोक (कोई नेटवर्क नहीं)
 pnpm run verify:self-contained   # पैक + साफ़ प्रोफ़ाइल इंस्टॉल/स्टार्ट/अनइंस्टॉल स्मोक
+pnpm run check:readmes           # five READMEs share section structure
+pnpm run check:parity            # translations have identical block counts
+pnpm run check:facts             # self-stated numbers match data/facts.json
+pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
 pnpm pack
 pwsh -File scripts/verify-kit.ps1   # महत्वपूर्ण पथ + लिंक स्कैन (-Checkout <checkout> से दस्तावेज़ विचलन)
 ```
@@ -269,6 +274,7 @@ pwsh -File scripts/verify-kit.ps1   # महत्वपूर्ण पथ +
 ## Contributors
 
 - [PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: ज्ञान-आधार सामग्री, इंस्टॉल-योग्य बंडल रूपांतरण, पारिस्थितिकी योगदान और सामुदायिक अभियांत्रिकी।
+- [@Yisa-yi](https://github.com/Yisa-yi) — **product manager** (उत्पाद प्रबंधक)। शुरुआती रूपरेखा से लेकर प्रकाशित bundle तक पूरी डिज़ाइन यात्रा में शामिल रहे, और कोड के बजाय उत्पाद का स्वरूप संभाला: यह तय करना कि यह इंस्टॉल-योग्य bundle के रूप में आए जो माँग पर agent skill रजिस्टर करे (दस्तावेज़-साइट उन्हीं स्रोतों को प्रस्तुत करती है, अलग सामग्री नहीं); 10 अध्यायों वाली गाइड की सूचना-संरचना; “हर तथ्य अपने स्रोत से जुड़ा हो” का नियम; और संज्ञानात्मक परत (`SKILL.md` + `guide/`) तथा यांत्रिक परत (`dsh-plugin-dev new / check / verify`) का अलगाव। `guide/unfixed-issues.md` का प्रमाण-मानक तय किया — नामित host commit के सामने `path:line`, design-vs-bug तालिका, और स्पष्ट “पुनरुत्पादन-असंभव” अनुभाग — तथा `guide/when-to-retire-a-plugin.md` के फ़्रीज़/सेवानिवृत्ति मानदंड। दायरे की सीमा (केवल-पठन, कोई नेटवर्क नहीं, कोई मॉडल कॉल नहीं, कोई कॉन्फ़िगर करने योग्य विकल्प नहीं) और पाँच-भाषा README समानता की शर्त बनाए रखी।
 - दैनिक अनुरक्षण में DeepSeek Harness एजेंट सहायता करते हैं (उनका कोई GitHub खाता नहीं है और वे पारदर्शिता हेतु यहाँ सूचीबद्ध हैं, योगदानकर्ता के रूप में नहीं)।
 
 ## PerryLink DSH Plugin Family

package/README-pt.md

@@ -59,7 +59,7 @@ Tudo o que você precisa para construir plugins do [DeepSeek Harness](https://gi
 
 Arquivo de documentação oficial · primer de Cordis · deep-dives da comunidade · armadilhas testadas em batalha · agent skill · toolchain CLI
 
-![Demonstração de terminal do dsh-plugin-guide: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.png)
+![Demonstração de terminal do dsh-plugin-guide: dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-hero.png)
 
 ![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
@@ -125,6 +125,7 @@ O bundle inclui o CLI `dsh-plugin-dev` sem dependências de runtime (`bin/` →
 dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
 dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
 dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
+dsh-plugin-dev seams <query> | --since <version>   # esta API existe no host alvo?
 ```
 
 | Subcomando | O que faz |
@@ -258,6 +259,10 @@ pnpm test
 pnpm run build
 pnpm run verify:artifacts        # auto-check + smoke de scaffold (sem rede)
 pnpm run verify:self-contained   # pack + smoke de instalação/início/desinstalação em perfil limpo
+pnpm run check:readmes           # five READMEs share section structure
+pnpm run check:parity            # translations have identical block counts
+pnpm run check:facts             # self-stated numbers match data/facts.json
+pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
 pnpm pack
 pwsh -File scripts/verify-kit.ps1   # caminhos críticos + varredura de links (+ deriva de docs com -Checkout <checkout>)
 ```
@@ -269,6 +274,7 @@ pwsh -File scripts/verify-kit.ps1   # caminhos críticos + varredura de links (+
 ## Contributors
 
 - [PerryLink](https://github.com/PerryLink) — criador e mantenedor: conteúdo da base de conhecimento, a transformação para bundle instalável, envios ao ecossistema e engenharia de comunidade.
+- [@Yisa-yi](https://github.com/Yisa-yi) — **product manager**. Participou de todo o arco de design, do primeiro esboço ao bundle publicado, e respondeu pela forma do produto, não pelo seu código: a decisão de que isto fosse entregue como bundle instalável que registra uma agent skill sob demanda (o site de documentação renderiza essas mesmas fontes, não um conjunto de conteúdo à parte); a arquitetura da informação do guia de 10 capítulos; a regra de que todo fato deve linkar sua origem; e a separação entre a camada cognitiva (`SKILL.md` + `guide/`) e a camada mecânica (`dsh-plugin-dev new / check / verify`). Definiu o padrão de evidência de `guide/unfixed-issues.md` — `path:line` contra um commit nomeado do host, a tabela design-vs-bug e uma seção explícita de não reproduzível — e os critérios de congelamento e retirada de `guide/when-to-retire-a-plugin.md`. Sustentou a linha de escopo (somente leitura, sem rede, sem chamadas ao modelo, sem chaves configuráveis) e a exigência de paridade dos READMEs em cinco idiomas.
 - A manutenção diária é assistida por agentes do DeepSeek Harness (eles não têm conta no GitHub e são listados aqui por transparência, não como contribuidores).
 
 ## PerryLink DSH Plugin Family

package/README-zh.md

@@ -61,7 +61,7 @@ dsh plugin --profile web add dsh-plugin-guide
 
 官方文档档案 · Cordis 入门 · 社区深读 · 实战踩坑 · agent 技能 · CLI 工具链
 
-![dsh-plugin-guide 终端演示：dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.png)
+![dsh-plugin-guide 终端演示：dsh-plugin-guide — install the bundle, then run the checker](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-hero.png)
 
 ![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
@@ -127,6 +127,7 @@ bundle 附带零运行时依赖的 `dsh-plugin-dev` CLI（`bin/` → tsdown 打
 dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
 dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
 dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
+dsh-plugin-dev seams <query> | --since <version>   # 这个 API 在我目标宿主里存在吗？
 ```
 
 | 子命令 | 作用 |
@@ -260,6 +261,10 @@ pnpm test
 pnpm run build
 pnpm run verify:artifacts        # 自检 + 脚手架冒烟（无网络）
 pnpm run verify:self-contained   # 打包 + 干净 profile 安装/启动/卸载冒烟
+pnpm run check:readmes           # five READMEs share section structure
+pnpm run check:parity            # translations have identical block counts
+pnpm run check:facts             # self-stated numbers match data/facts.json
+pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
 pnpm pack
 pwsh -File scripts/verify-kit.ps1   # 关键路径 + 链接扫描（加 -Checkout <checkout> 做文档漂移）
 ```
@@ -271,6 +276,7 @@ pwsh -File scripts/verify-kit.ps1   # 关键路径 + 链接扫描（加 -Checkou
 ## Contributors
 
 - [PerryLink](https://github.com/PerryLink) —— 创建者与维护者：知识库内容、可安装 bundle 改造、生态提交与社区工程。
+- [@Yisa-yi](https://github.com/Yisa-yi) —— **产品经理**。全流程参与项目设计，从最初的大纲到最终发布的 bundle，负责的是产品形态而非代码：确定它以「可安装 bundle + 按需注册 agent skill」的形态交付（文档站只渲染同一批源文件，不另立一套内容）；确定 10 章开发指南的信息架构；确立「每条事实必须链接出处」的纪律；以及把认知层（`SKILL.md` + `guide/`）与机械层（`dsh-plugin-dev new / check / verify`）分开的分层设计。也确定了 `guide/unfixed-issues.md` 的证据标准——每条都带针对指定宿主提交的 `path:line`、设计取舍与真 bug 对照表，以及明确的「无法复现」小节——以及 `guide/when-to-retire-a-plugin.md` 的冻结/退役判据。守住范围边界（只读、不联网、不调用模型、无配置项）与五语 README 同步的要求。
 - 日常维护由 DeepSeek Harness agents 辅助（它们无 GitHub 账号，为透明起见列于此，不作贡献者）。
 
 ## PerryLink DSH Plugin Family