dsh-plugin-guide 0.3.39 → 0.3.40

package/README-es.md

@@ -71,9 +71,10 @@ 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-hero.png)
+![Diagrama de flujo de dsh-plugin-guide: solicitud → política/revisión → veredicto.](docs/assets/dsh-plugin-guide-flow.svg)
+
+*Resumen del flujo: solicitud → política/revisión → veredicto. Los ejemplos siguientes usan la superficie de comandos real.*
 
-![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
 *La misma ejecución, animada.*
 
@@ -107,6 +108,7 @@ content counts as stated in the README (What you get)
 - **Enrutador de la cadena de herramientas** — [guide/family-toolchain.md](guide/family-toolchain.md): qué herramienta responde a cada pregunta, el catálogo completo de 33 comprobaciones de `dsh-plugin-doctor` y su cruce con las 16 de este repositorio.
 - **Decisión sobre el alcance del espejo** — [references/mirror-scope-decision.md](references/mirror-scope-decision.md): por qué "eliminar lo no referenciado para ahorrar un 80%" **no se sostiene** al volver a medirlo.
 - **Destilado de la skill oficial** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): prohibiciones, metadatos de presentación y reglas de UI/rendimiento de la skill oficial `cordis-plugin-development`.
+- **Niveles de adopción (no oficiales)** — [guide/standards.md](guide/standards.md): el modelo DSH-ENTRY / DSH-FLOW / DSH-BOOST, la tabla de dos ejes (profundidad × evidencia), lo que cada nivel *no* afirma y cómo subir de nivel. La comparación GB / GB-T / GB-Z es solo una analogía; las calificaciones de certificación A–D son ortogonales.
 ## Knowledge base
 
 | Path | Qué es |
@@ -202,6 +204,55 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
 
 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.
 
+### Ejemplos
+
+Son los puntos de entrada reales; instala y llama a uno.
+
+#### Ejemplo detallado
+
+**Comando**
+
+~~~sh
+dsh-plugin-dev seams L3
+~~~
+
+**Salida**
+
+~~~text
+1 seam(s):
+
+L3  webRuntime service replaced by webStartup
+    kind        service-renamed
+    lands in    0.2.1-alpha.2
+    confidence  documented
+    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
+    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
+    instead     webStartup (row web-startup), concrete host literals
+    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
+~~~
+
+*Observado en `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+
+#### Rama de fallo
+
+**Entrada**
+
+~~~text
+node bin/dsh-plugin-dev.js seams no-such-seam-xyz
+~~~
+
+**Salida**
+
+~~~text
+no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
+~~~
+
+*Observado en `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
+
+#### Ejemplos breves
+
+
+
 ## Configuration
 
 El bundle de skill no expone ningún `Config` de Schemastery — registra la base de conocimiento como una skill de agente sin claves ajustables. El CLI `dsh-plugin-dev` lee sus ajustes de flags y variables de entorno `DSH_PLUGIN_DEV_*` (ver [CLI toolchain](#cli-toolchain)).

package/README-hi.md

@@ -71,9 +71,10 @@ 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-hero.png)
+![dsh-plugin-guide कार्यप्रवाह आरेख: अनुरोध → नीति/समीक्षा → निर्णय।](docs/assets/dsh-plugin-guide-flow.svg)
+
+*कार्यप्रवाह: अनुरोध → नीति/समीक्षा → निर्णय। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
 
-![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
 *वही रन, एनिमेटेड।*
 
@@ -107,6 +108,7 @@ content counts as stated in the README (What you get)
 - **टूलचेन राउटर** — [guide/family-toolchain.md](guide/family-toolchain.md): कौन-सा प्रश्न किस टूल का है, `dsh-plugin-doctor` की पूरी 33-जाँच सूची, और इस रिपॉज़िटरी की 16 जाँचों से तुलना।
 - **मिरर स्कोप निर्णय** — [references/mirror-scope-decision.md](references/mirror-scope-decision.md): "संदर्भ-रहित सामग्री हटाकर 80% बचाने" का सुझाव दोबारा मापने पर **टिकता नहीं**।
 - **आधिकारिक skill का सार** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): आधिकारिक `cordis-plugin-development` skill के निषेध, प्रदर्शन मेटाडेटा और UI/प्रदर्शन नियम।
+- **अपनाने के स्तर (अनौपचारिक)** — [guide/standards.md](guide/standards.md): DSH-ENTRY / DSH-FLOW / DSH-BOOST मॉडल, दो-अक्षीय (गहराई × प्रमाण) तालिका, हर स्तर क्या दावा **नहीं** करता, और ऊपर कैसे जाएँ। GB / GB-T / GB-Z केवल एक उपमा है; प्रमाणन ग्रेड A–D इन स्तरों से स्वतंत्र हैं।
 ## Knowledge base
 
 | Path | यह क्या है |
@@ -202,6 +204,55 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
 
 इंस्टॉलर `downloads/` (उत्पन्न) और `.github/` को छोड़ता है, फिर हर कॉपी की गई फ़ाइल को बाइट-दर-बाइट सत्यापित करता है। पूरे फ़ोल्डर की मैन्युअल `Copy-Item -Recurse` भी काम करती है।
 
+### उदाहरण
+
+ये वास्तविक प्रवेश बिंदु हैं; इंस्टॉल के बाद एक चलाएँ।
+
+#### विस्तृत उदाहरण
+
+**कमांड**
+
+~~~sh
+dsh-plugin-dev seams L3
+~~~
+
+**आउटपुट**
+
+~~~text
+1 seam(s):
+
+L3  webRuntime service replaced by webStartup
+    kind        service-renamed
+    lands in    0.2.1-alpha.2
+    confidence  documented
+    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
+    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
+    instead     webStartup (row web-startup), concrete host literals
+    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
+~~~
+
+*स्रोत `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+
+#### विफलता शाखा
+
+**इनपुट**
+
+~~~text
+node bin/dsh-plugin-dev.js seams no-such-seam-xyz
+~~~
+
+**आउटपुट**
+
+~~~text
+no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
+~~~
+
+*स्रोत `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
+
+#### संक्षिप्त उदाहरण
+
+
+
 ## Configuration
 
 skill बंडल कोई Schemastery `Config` उजागर नहीं करता — यह ज्ञान-आधार को बिना किसी ट्यूनेबल कुंजी के एक agent skill के रूप में पंजीकृत करता है। `dsh-plugin-dev` CLI अपने ट्यूनेबल flags और `DSH_PLUGIN_DEV_*` पर्यावरण चरों से पढ़ता है ([CLI toolchain](#cli-toolchain) देखें)।

package/README-pt.md

@@ -71,9 +71,10 @@ 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-hero.png)
+![Diagrama de fluxo de dsh-plugin-guide: solicitação → política/revisão → veredito.](docs/assets/dsh-plugin-guide-flow.svg)
+
+*Visão geral do fluxo: solicitação → política/revisão → veredito. Os exemplos abaixo usam a superfície real de comandos.*
 
-![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
 *A mesma execução, animada.*
 
@@ -107,6 +108,7 @@ O `dsh-plugin-guide` é a base de conhecimento de desenvolvimento de plugins DSH
 - **Roteador da cadeia de ferramentas** — [guide/family-toolchain.md](guide/family-toolchain.md): qual ferramenta responde a cada pergunta, o catálogo completo de 33 verificações do `dsh-plugin-doctor` e o cruzamento com as 16 deste repositório.
 - **Decisão sobre o escopo do espelho** — [references/mirror-scope-decision.md](references/mirror-scope-decision.md): por que "remover o não referenciado para economizar 80%" **não se sustenta** ao medir de novo.
 - **Destilado da skill oficial** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): proibições, metadados de apresentação e regras de UI/desempenho da skill oficial `cordis-plugin-development`.
+- **Níveis de adoção (não oficiais)** — [guide/standards.md](guide/standards.md): o modelo DSH-ENTRY / DSH-FLOW / DSH-BOOST, a tabela de dois eixos (profundidade × evidência), o que cada nível *não* afirma e como subir de nível. A comparação GB / GB-T / GB-Z é apenas uma analogia; as notas de certificação A–D são ortogonais.
 ## Knowledge base
 
 | Path | O que é |
@@ -202,6 +204,55 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
 
 O instalador pula `downloads/` (gerado) e `.github/`, e então verifica cada arquivo copiado byte a byte. Um `Copy-Item -Recurse` manual da pasta inteira também funciona.
 
+### Exemplos
+
+São os pontos de entrada reais; instale e chame um.
+
+#### Exemplo detalhado
+
+**Comando**
+
+~~~sh
+dsh-plugin-dev seams L3
+~~~
+
+**Saída**
+
+~~~text
+1 seam(s):
+
+L3  webRuntime service replaced by webStartup
+    kind        service-renamed
+    lands in    0.2.1-alpha.2
+    confidence  documented
+    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
+    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
+    instead     webStartup (row web-startup), concrete host literals
+    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
+~~~
+
+*Observado em `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+
+#### Ramo de falha
+
+**Entrada**
+
+~~~text
+node bin/dsh-plugin-dev.js seams no-such-seam-xyz
+~~~
+
+**Saída**
+
+~~~text
+no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
+~~~
+
+*Observado em `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
+
+#### Exemplos breves
+
+
+
 ## Configuration
 
 O bundle de skill não expõe nenhum `Config` de Schemastery — ele registra a base de conhecimento como uma agent skill sem chaves ajustáveis. O CLI `dsh-plugin-dev` lê seus ajustes de flags e variáveis de ambiente `DSH_PLUGIN_DEV_*` (veja [CLI toolchain](#cli-toolchain)).

package/README-zh.md

@@ -73,9 +73,10 @@ 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-hero.png)
+![dsh-plugin-guide 工作流图：请求 → 策略/复核 → 判定。](docs/assets/dsh-plugin-guide-flow.svg)
+
+*工作流概览：请求 → 策略/复核 → 判定。下面的示例使用实际命令面。*
 
-![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
 *同一次运行，动图版。*
 
@@ -109,6 +110,7 @@ content counts as stated in the README (What you get)
 - **家族工具链路由** —— [guide/family-toolchain.md](guide/family-toolchain.md)：哪个工具负责哪个问题、`dsh-plugin-doctor` 33 项检查全表，以及与本库 16 项检查的交叉对照。
 - **镜像范围决策** —— [references/mirror-scope-decision.md](references/mirror-scope-decision.md)：为什么"删掉零引用内容以省 80% 体积"经复测**不成立**（它们被本库自己声明的宽 glob 覆盖）。
 - **官方自带技能要点** —— [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md)：官方 `cordis-plugin-development` 技能的禁则、展示元数据清单与 UI/性能规则。
+- **采用分级（非官方）** —— [guide/standards.md](guide/standards.md)：DSH-ENTRY / DSH-FLOW / DSH-BOOST 三层模型、"采用深度 × 证据状态"两轴表、每层**不**声称什么，以及升级路径。GB / GB-T / GB-Z 仅为类比；认证 A–D 与三层正交。
 ## Knowledge base
 
 | Path | 是什么 |
@@ -204,6 +206,55 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
 
 安装器跳过 `downloads/`（生成的）与 `.github/`，然后逐字节校验每个复制的文件。手动 `Copy-Item -Recurse` 整个文件夹也可以。
 
+### 示例
+
+以下为插件真实入口；安装后调用一个即可。
+
+#### 详细示例
+
+**命令**
+
+~~~sh
+dsh-plugin-dev seams L3
+~~~
+
+**输出**
+
+~~~text
+1 seam(s):
+
+L3  webRuntime service replaced by webStartup
+    kind        service-renamed
+    lands in    0.2.1-alpha.2
+    confidence  documented
+    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
+    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
+    instead     webStartup (row web-startup), concrete host literals
+    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
+~~~
+
+*来源 `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+
+#### 失败分支
+
+**输入**
+
+~~~text
+node bin/dsh-plugin-dev.js seams no-such-seam-xyz
+~~~
+
+**输出**
+
+~~~text
+no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
+~~~
+
+*来源 `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
+
+#### 简短示例
+
+
+
 ## Configuration
 
 技能 bundle 不暴露任何 Schemastery `Config` —— 它把知识库注册为 agent 技能，无可调键。`dsh-plugin-dev` CLI 从 flag 与 `DSH_PLUGIN_DEV_*` 环境变量读取可调项（见 [CLI toolchain](#cli-toolchain)）。

package/README.md

@@ -2,6 +2,9 @@
 
 # 🐳 dsh-plugin-guide
 
+> **Non-official companion tool.** Part of the DSH standards family; not a certification, accreditation, security audit, or official endorsement. Standard: https://github.com/PerryLink/dsh-standards. The `dsh.standards` block is a `not-run` placeholder, not a pass.
+
+
 **Your agent stops inventing DSH plugin APIs.**
 
 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.
@@ -83,11 +86,11 @@ Everything you need to build [DeepSeek Harness](https://github.com/deepseek-ai/d
 Official docs archive · Cordis primer · community deep-dives · battle-tested pitfalls · agent skill · CLI toolchain
 
 
-![Terminal demo of 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)
+![Workflow diagram for dsh-plugin-guide: request → policy / review → verdict.](docs/assets/dsh-plugin-guide-flow.svg)
+
+*Workflow overview: request → policy / review → verdict. The examples below use the real command surface.*
 
-![Animated terminal demo of dsh-plugin-guide](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-demo.gif)
 
-*The same run, animated.*
 
 ## Comparison
 
@@ -118,6 +121,7 @@ content counts as stated in the README (What you get)
 - **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, …).
 - **Community deep-dives** — 114 community repositories archived (15 deep-dived), plus a full source index where every fact links to its origin.
 - **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.
+- **Adoption levels (non-official)** — [guide/standards.md](guide/standards.md): the DSH-ENTRY / DSH-FLOW / DSH-BOOST model, the two-axis (depth × evidence) table, what each level does *not* claim, and how to move up. The GB / GB-T / GB-Z comparison is an analogy only; certification grades A–D are orthogonal.
 
 ## Knowledge base
 
@@ -217,6 +221,55 @@ pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide
 
 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.
 
+### Examples
+
+These are the plugin's real entry points; install once, then call one.
+
+#### Detailed example
+
+**Command**
+
+~~~sh
+dsh-plugin-dev seams L3
+~~~
+
+**Output**
+
+~~~text
+1 seam(s):
+
+L3  webRuntime service replaced by webStartup
+    kind        service-renamed
+    lands in    0.2.1-alpha.2
+    confidence  documented
+    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
+    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
+    instead     webStartup (row web-startup), concrete host literals
+    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
+~~~
+
+*Observed from `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+
+#### Failure branch
+
+**Input**
+
+~~~text
+node bin/dsh-plugin-dev.js seams no-such-seam-xyz
+~~~
+
+**Output**
+
+~~~text
+no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
+~~~
+
+*Observed from `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
+
+#### Brief examples
+
+
+
 ## Configuration
 
 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)).

package/SKILL.md

@@ -19,7 +19,7 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 
 ## 开发前置（第一步必做）
 
-0. **先认版本**：跑 `dsh --version`，然后按下表决定读什么。**不要跳过这一步**——本库 17 篇文档里对当前宿主不适用的部分不会自己标注。
+0. **先认版本**：跑 `dsh --version`，然后按下表决定读什么。**不要跳过这一步**——本库 19 篇文档里对当前宿主不适用的部分不会自己标注。
    | 你的 `dsh --version` | 含义 | 读什么 |
    |---|---|---|
    | `< 0.1.7-alpha.1` | 旧基线 | 本世代破坏性变更**全部适用** → `guide/migration-0.2.md` §0–§12 逐条改 |
@@ -30,6 +30,7 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 1. 若未读过 Cordis 概念：读 `references/official-docs/docs/cordis-primer.md`（5 个概念，5 分钟）；需要动手跟练时跑 `references/official-docs/docs/cordis-tutorial/` 01-07（无 API key 可跑）。
 2. 打开 `guide/quick-reference.md`（契约速查）+ `guide/plugin-dev-guide.md`（完整路径）。官方/社区文档 URL 对照见 `guide/links.md`。排查官方运行时行为/未修复 bug 时查 `guide/unfixed-issues.md`（master 基线源码核实的问题清单 + 已修复提交号 + 设计行为对照 + 本世代新核实的 T1–T11）。决定一个插件**该不该继续维护**（官方已进内核 / 第三方采用度显著更高）时查 `guide/when-to-retire-a-plugin.md`（判据 + 实测倍数表）；判断某个能力面谁领先时查 `guide/choosing-a-plugin.md`。
 2b. **要判断"该改哪一行 / 该找哪个工具"时**，读 `guide/family-toolchain.md`（家族工具链路由：问题→所有者→可引用产物；`dsh-plugin-doctor` 33 项检查全表与裁定语义；本库 16 项检查与 doctor 的交叉对照）。发布流水线（多插件组合的持续可安装/可发布/可升级）见 `guide/release-engineering.md`。
+2c. **要回答"这个插件算哪一级 / 怎么升级"时**，读 `guide/standards.md`（DSH-ENTRY / DSH-FLOW / DSH-BOOST：每层回答什么、需要什么证据、不声称什么、怎么自检；"采用深度 × 证据状态"两轴；ENTRY → FLOW → BOOST 的升级路径）。中文稿 `guide/standards.zh-CN.md`。**三层非官方、非认证**，A–D 认证等级与三层正交；`static` 不是 `runtime`，`runtime` 不是 UI 已渲染，`not-measured` 不是通过。
 3. 确认目标扩展点：读 `references/official-docs/docs/architecture.md` 的「Where new behavior goes」表与 `references/official-docs/docs/cookbook/extension-cookbook.md` 的 feature→mechanism 表——**新行为必须挂到已文档化扩展点，不得改 agent-loop**；**用最弱的够用机制**（restrict < guard < waterfall 改写 < system-prompt/assemble）。
 4. 要写 UI / 要让 agent 自己装插件时，读 `references/official-plugin-dev-skill.md`（官方自带技能的要点与硬性规定）。
 

package/STANDARDS.md

@@ -0,0 +1,7 @@
+# Standards status
+
+- Canonical standard: https://github.com/PerryLink/dsh-standards
+- This package is a **companion tool**, not a certified plugin and not an official product.
+- `package.json` carries `dsh.standards` with `entry`/`flow` = `not-run`, `boost` = `not-measured`, and `evidence: null`. It is a placeholder; do not read it as a pass.
+- License: Apache-2.0 (code/docs in this repository).
+- Evidence: the package's test suite; a passing test is not a DSH-ENTRY/FLOW/BOOST attestation.

package/data/facts.json

@@ -3,7 +3,8 @@
   "measuredAt": "2026-10-19",
   "notes": [
     "One home per fact. Prose, tables and badges must agree with these numbers; `scripts/check-facts.mjs` enforces the ones a machine can check.",
-    "These are the counts that caused real defects when they drifted: the family roster was stated four different ways, the pitfall list was '30+' in one language and '20+' in another, and the mirror page count was '215' long after it reached 429."
+    "These are the counts that caused real defects when they drifted: the family roster was stated four different ways, the pitfall list was '30+' in one language and '20+' in another, and the mirror page count was '215' long after it reached 429.",
+    "Recounted 2026-11-01 after adding guide/standards.md and guide/standards.zh-CN.md: guideDocuments 19, whatYouGetEntries 11 (the standards bullet was added to all five READMEs)."
   ],
   "mirror": {
     "mdPages": 481,
@@ -14,11 +15,11 @@
   },
   "readme": {
     "sections": 24,
-    "whatYouGetEntries": 10,
+    "whatYouGetEntries": 11,
     "knowledgeBaseRows": 17
   },
   "knowledgeBase": {
-    "guideDocuments": 17,
+    "guideDocuments": 19,
     "referenceDocuments": 11
   },
   "cli": {