dsh-primer 0.4.5 → 0.4.7

package/README.en.md

@@ -44,7 +44,7 @@ Why not just read the official docs? Because they are written for someone who al
 | Gap | What this plugin adds |
 |---|---|
 | **"Which DSH am I even targeting?"** | A [version matrix](guide/version-matrix.md): the five 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.** |
-| **"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. |
+| **"What does this break?"** | A [migration guide](guide/migration-0.2.md) covering `0.1.6-alpha.2` → `0.2.2-rc.3` as citable seams (§0–§13 cover the 0.1.6→0.2.1 line; §14 is the 46 `K1`–`K46` seams of the 0.2.2 line released in rc.3) 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. |
 | **"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. |
 
 <picture>
@@ -103,7 +103,7 @@ All PerryLink plugins are browsable in the built-in DSH Desktop Market: **Market
 
 - **Plugin contract and hard rules** — effects/disposers, waterfall listeners that must call `next()`, host-owned session events, model-visible ⟺ logged, Schemastery config, UI and performance rules.
 - **Official docs mirror** — `references/official-docs/`: 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.
-- **Version-adaptivity matrix** — [guide/version-matrix.md](guide/version-matrix.md): the five different "latest" values, the frozen sub-package `latest` tags, the four breaking-change seams, how to pick a peer range, the session-format lineage V0→V4, and the 19 breaking changes that landed in `0.2.1-alpha.2`.
+- **Version-adaptivity matrix** — [guide/version-matrix.md](guide/version-matrix.md): the five different "latest" values, the frozen sub-package `latest` tags, the four breaking-change seams, how to pick a peer range, the session-format lineage V0→V4, the 19 breaking changes that landed in `0.2.1-alpha.2`, and the 46 seams of the 0.2.2 line released in rc.3 (`K1`–`K46`, see migration §14).
 - **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, the retired `plugin` message source), each with its official source and a 12-item checklist.
 - **Cordis primer and the official skill, distilled** — the five Cordis concepts and the mechanism timeline; [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md) distils the harness's own `cordis-plugin-development` prohibitions, display-metadata checklist, and UI/performance rules.
 - **Verified issue index** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 unfixed + 11 newly verified items with `path:line`, workarounds and fixing commits, plus a design-vs-bug table and an explicit "unreproducible" section.
@@ -127,8 +127,8 @@ All PerryLink plugins are browsable in the built-in DSH Desktop Market: **Market
 | `SKILL.md` | The `dsh-primer` agent skill: hard rules + task-based development paths |
 | `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 |
 | `guide/plugin-dev-guide.md` | The complete development guide (10 chapters) |
-| `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, the 19 changes in `0.2.1-alpha.2` |
-| `guide/migration-0.2.md` | Breaking-change migration guide for the 0.2 generation (§0–§12 up to `0.2.1-alpha.1`, §13 covering the 19 seams of `0.2.1-alpha.2`) |
+| `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, the 19 changes in `0.2.1-alpha.2` plus the 46 in the 0.2.2 line |
+| `guide/migration-0.2.md` | Breaking-change migration guide for the 0.2 generation (§0–§12 up to `0.2.1-alpha.1`, §13 covering the 19 seams of `0.2.1-alpha.2`, §14 covering the 46 seams (`K1`–`K46`) released in rc.3 and listing the 13 next-version guides separately) |
 | `guide/unfixed-issues.md` | Source-verified bug index + fixed-on-master list + design-vs-bug table |
 | `guide/quick-reference.md` | One-page cheat sheet (5 languages) |
 | `guide/links.md` | Curated URL index: official dev docs (site ↔ local copies) + community doc links + repo-only pages |
@@ -194,7 +194,7 @@ L3  webRuntime service replaced by webStartup
     detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
 ```
 
-*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:66`*
 
 ### Failure branch
 
@@ -309,7 +309,7 @@ This plugin does **not** interfere with other plugins:
 
 | Surface | Status |
 |---|---|
-| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0`. Current host line: npm `latest` = `next` = `0.2.1-rc.2`, `alpha` = `0.2.1-alpha.5`, newest tag = `dsh-v0.2.1-rc.2`; **there is no stable line** — all 31 npm versions and all 26 GitHub Releases are prereleases. The official-docs mirror is pinned to `e8f7b93a…` (synced 2026-11-13, 717 md pages / 356 EN-ZH pairs). |
+| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`. Current host line: npm `latest` = `0.2.2-rc.1`, `next` = `0.2.2-rc.3`, `alpha` = `0.2.2-alpha.3`, newest tag = `dsh-v0.2.2-rc.3`; **there is no stable line** — all 44 npm versions and all 39 GitHub Releases are prereleases. The official-docs mirror is pinned to the release tag `dsh-v0.2.2-rc.3` (`38a6a5c9…`, synced 2026-11-14, 709 md pages / 352 EN-ZH pairs). |
 | Node | `>=24.9.0` |
 | Platforms | Anywhere DSH runs (plain ESM bundle; no native code, no network) |
 | Model | Any (no model interaction: the host injects the skill body into context) |

package/README.es.md

@@ -44,7 +44,7 @@ Mantenido por la comunidad, **no** es un producto oficial de DeepSeek. DeepSeek
 | Brecha | Qué añade este plugin |
 |---|---|
 | **"¿Contra qué versión de DSH estoy desarrollando?"** | Una [matriz de versiones](guide/version-matrix.md): los cinco valores que se llaman "latest", las etiquetas `latest` congeladas de los subpaquetes, los seams de cambio incompatible y cómo elegir un rango de `peerDependencies`. **No existe línea estable.** |
-| **"¿Qué rompe esta versión?"** | Una [guía de migración](guide/migration-0.2.md) que ordena `0.1.6-alpha.2` → `0.2.1-alpha.2` como seams citables, cada uno con síntoma *y* arreglo y su fuente oficial, incluido un riesgo de pérdida de datos y un cambio que hace fallar los prompts antes de construir la petición al modelo. |
+| **"¿Qué rompe esta versión?"** | Una [guía de migración](guide/migration-0.2.md) que ordena `0.1.6-alpha.2` → `0.2.2-rc.3` como seams citables (§0–§13 cubren la línea 0.1.6→0.2.1; §14 son los 46 seams `K1`–`K46` de la línea 0.2.2 publicados en rc.3), cada uno con síntoma *y* arreglo y su fuente oficial, incluido un riesgo de pérdida de datos y un cambio que hace fallar los prompts antes de construir la petición al modelo. |
 | **"¿Mi plugin es realmente correcto?"** | Un [CLI sin dependencias](SKILL.md) (`dsh-plugin-dev new / check / verify`) más un [espejo literal sin conexión](references/official-docs/) de la documentación oficial, para que el agente cite la página exacta en vez de adivinar. |
 
 <picture>
@@ -103,7 +103,7 @@ Todos los plugins de PerryLink se pueden explorar en el mercado integrado de DSH
 
 - **Contrato de plugin y reglas duras** — effects/disposers, listeners waterfall que deben llamar a `next()`, eventos de sesión propiedad del host, visible-para-el-modelo ⟺ registrado, configuración Schemastery, reglas de UI y rendimiento.
 - **Espejo literal de la documentación oficial** — `references/official-docs/`: copia byte a byte de los documentos del repositorio oficial (EN + ZH), idéntica a upstream en la última instantánea verificada, incluidas las páginas que nunca llegan al sitio de documentación.
-- **Matriz de adaptación de versiones** — [guide/version-matrix.md](guide/version-matrix.md): los cinco valores "latest", las etiquetas `latest` congeladas de los subpaquetes, los cuatro seams de cambio incompatible, cómo elegir el rango peer, el linaje del formato de sesión V0→V4 y los 19 cambios incompatibles de `0.2.1-alpha.2`.
+- **Matriz de adaptación de versiones** — [guide/version-matrix.md](guide/version-matrix.md): los cinco valores "latest", las etiquetas `latest` congeladas de los subpaquetes, los cuatro seams de cambio incompatible, cómo elegir el rango peer, el linaje del formato de sesión V0→V4 los 19 cambios incompatibles de `0.2.1-alpha.2` y los 46 seams de la línea 0.2.2 publicados en rc.3 (`K1`–`K46`, ver migración §14).
 - **Guía de migración** — [guide/migration-0.2.md](guide/migration-0.2.md): cada cambio incompatible de `0.1.6-alpha.2` a `0.2.1-alpha.1` (formato de sesión V4, reconstrucción de settings, retirada de invariantes, `readBytes`, slots nuevos, la fuente de mensaje `plugin` retirada), cada uno con su fuente oficial y una lista de 12 comprobaciones.
 - **Primer de Cordis y la skill oficial, destilada** — los cinco conceptos de Cordis y la línea temporal de mecanismos; [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md) destila las prohibiciones de `cordis-plugin-development`, la lista de metadatos de presentación y las reglas de UI/rendimiento.
 - **Índice de bugs verificados** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 sin arreglar + 11 recién verificados, cada uno con `path:line`, workaround y commit de arreglo, más una tabla diseño-vs-bug y una sección explícita de "no reproducible".
@@ -127,8 +127,8 @@ Todos los plugins de PerryLink se pueden explorar en el mercado integrado de DSH
 | `SKILL.md` | La skill de agente `dsh-primer`: reglas duras + rutas de desarrollo por tipo de tarea |
 | `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | El bundle DSH instalable: manifiesto `dsh.bundle.patch`, entrada que registra la skill y metadatos de presentación que lee el Plugin Manager |
 | `guide/plugin-dev-guide.md` | La guía de desarrollo completa (10 capítulos) |
-| `guide/version-matrix.md` | Matriz de adaptación de versiones: los cinco "latest", etiquetas `latest` congeladas, seams de cambio incompatible, elección de rango peer, linaje del formato de sesión, los 19 cambios de `0.2.1-alpha.2` |
-| `guide/migration-0.2.md` | Guía de migración de cambios incompatibles de la generación 0.2 (§0–§12 hasta `0.2.1-alpha.1`, §13 con los 19 seams de `0.2.1-alpha.2`) |
+| `guide/version-matrix.md` | Matriz de adaptación de versiones: los cinco "latest", etiquetas `latest` congeladas, seams de cambio incompatible, elección de rango peer, linaje del formato de sesión, los 19 cambios de `0.2.1-alpha.2` más los 46 de la línea 0.2.2 |
+| `guide/migration-0.2.md` | Guía de migración de cambios incompatibles de la generación 0.2 (§0–§12 hasta `0.2.1-alpha.1`, §13 con los 19 seams de `0.2.1-alpha.2`, §14 con los 46 seams (`K1`–`K46`) publicados en rc.3 y los 13 de la próxima versión aparte) |
 | `guide/unfixed-issues.md` | Índice de bugs verificado en fuentes + lista arreglada en master + tabla diseño-vs-bug |
 | `guide/quick-reference.md` | Chuleta de una página (5 idiomas) |
 | `guide/links.md` | Índice de URL curado: documentación oficial de desarrollo (sitio ↔ copias locales) + enlaces de la comunidad + páginas solo del repositorio |
@@ -194,7 +194,7 @@ L3  webRuntime service replaced by webStartup
     detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
 ```
 
-*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:66`*
 
 ### Rama de fallo
 
@@ -309,7 +309,7 @@ Este plugin **no** interfiere con otros plugins:
 
 | Superficie | Estado |
 |---|---|
-| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0`. Línea actual del host: npm `latest` = `next` = `0.2.1-rc.2`, `alpha` = `0.2.1-alpha.5`, etiqueta más reciente = `dsh-v0.2.1-rc.2`; **no existe línea estable** — las 31 versiones de npm y las 26 releases de GitHub son prereleases. El espejo de la documentación oficial está fijado en `e8f7b93a…` (sincronizado el 2026-11-13, 717 páginas md / 356 pares EN-ZH). |
+| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`. Línea actual del host: npm `latest` = `0.2.2-rc.1`, `next` = `0.2.2-rc.3`, `alpha` = `0.2.2-alpha.3`, etiqueta más reciente = `dsh-v0.2.2-rc.3`; **no existe línea estable** — las 44 versiones de npm y las 39 releases de GitHub son prereleases. El espejo de la documentación oficial está fijado en la etiqueta `dsh-v0.2.2-rc.3` (`38a6a5c9…`, sincronizado el 2026-11-14, 709 páginas md / 352 pares EN-ZH). |
 | Node | `>=24.9.0` |
 | Plataformas | Donde corra DSH (bundle ESM puro; sin código nativo, sin red) |
 | Modelo | Cualquiera (sin interacción con modelos: el host inyecta el cuerpo de la skill en el contexto) |

package/README.hi.md

@@ -44,7 +44,7 @@ dsh plugin --profile <name> add dsh-primer
 | अंतराल | यह प्लगइन क्या जोड़ता है |
 |---|---|
 | **"मैं किस DSH के लिए बना रहा हूँ?"** | एक [संस्करण मैट्रिक्स](guide/version-matrix.md): वे पाँच मान जो स्वयं को "latest" कहते हैं, उप-पैकेजों के जमे हुए `latest` टैग, असंगत-बदलाव seam, और `peerDependencies` रेंज कैसे चुनें। **कोई स्थिर लाइन नहीं है।** |
-| **"यह संस्करण क्या तोड़ता है?"** | एक [माइग्रेशन गाइड](guide/migration-0.2.md) जो `0.1.6-alpha.2` → `0.2.1-alpha.2` को उद्धरण-योग्य seam के रूप में व्यवस्थित करता है, हर एक में लक्षण *और* समाधान तथा आधिकारिक स्रोत — जिसमें डेटा-हानि का एक जोखिम और एक ऐसा बदलाव शामिल है जो मॉडल अनुरोध बनने से पहले ही prompt विफल कर देता है। |
+| **"यह संस्करण क्या तोड़ता है?"** | एक [माइग्रेशन गाइड](guide/migration-0.2.md) जो `0.1.6-alpha.2` → `0.2.2-rc.3` को उद्धरण-योग्य seam के रूप में व्यवस्थित करता है (§0–§13 0.1.6→0.2.1 लाइन, §14 rc.3 में जारी 0.2.2 लाइन के 46 `K1`–`K46` seam), हर एक में लक्षण *और* समाधान तथा आधिकारिक स्रोत — जिसमें डेटा-हानि का एक जोखिम और एक ऐसा बदलाव शामिल है जो मॉडल अनुरोध बनने से पहले ही prompt विफल कर देता है। |
 | **"मेरा प्लगइन सचमुच सही है?"** | एक [शून्य-निर्भरता CLI](SKILL.md) (`dsh-plugin-dev new / check / verify`) और आधिकारिक दस्तावेज़ों का [शब्दशः ऑफ़लाइन मिरर](references/official-docs/), ताकि एजेंट अनुमान न लगाए बल्कि सटीक पृष्ठ उद्धृत करे। |
 
 <picture>
@@ -103,7 +103,7 @@ dsh plugin --profile <name> add dsh-primer
 
 - **प्लगइन अनुबंध और कठोर नियम** — effect/disposer, `next()` कॉल करने वाले waterfall listener, होस्ट के स्वामित्व वाले सत्र इवेंट, मॉडल-दृश्य ⟺ लॉग में दर्ज, Schemastery कॉन्फ़िग, UI और प्रदर्शन नियम।
 - **आधिकारिक दस्तावेज़ों का शब्दशः मिरर** — `references/official-docs/`: आधिकारिक रेपो दस्तावेज़ों की बाइट-दर-बाइट प्रति (EN + ZH), अंतिम सत्यापित स्नैपशॉट पर upstream के समान, उन पृष्ठों सहित जो दस्तावेज़ साइट तक कभी नहीं पहुँचते।
-- **संस्करण-अनुकूलन मैट्रिक्स** — [guide/version-matrix.md](guide/version-matrix.md): पाँच "latest" मान, उप-पैकेजों के जमे हुए `latest` टैग, चार असंगत-बदलाव seam, peer रेंज का चयन, सत्र-प्रारूप वंशावली V0→V4, और `0.2.1-alpha.2` में आए 19 असंगत बदलाव।
+- **संस्करण-अनुकूलन मैट्रिक्स** — [guide/version-matrix.md](guide/version-matrix.md): पाँच "latest" मान, उप-पैकेजों के जमे हुए `latest` टैग, चार असंगत-बदलाव seam, peer रेंज का चयन, सत्र-प्रारूप वंशावली V0→V4, `0.2.1-alpha.2` के 19 असंगत बदलाव और rc.3 में जारी 0.2.2 लाइन के 46 seam (`K1`–`K46`, माइग्रेशन §14 देखें)।
 - **माइग्रेशन गाइड** — [guide/migration-0.2.md](guide/migration-0.2.md): `0.1.6-alpha.2` से `0.2.1-alpha.1` तक हर असंगत बदलाव (सत्र प्रारूप V4, settings का पुनर्निर्माण, invariant हटाना, `readBytes`, नए slot, सेवानिवृत्त `plugin` संदेश स्रोत), हर एक के आधिकारिक स्रोत और 12-मद चेकलिस्ट के साथ।
 - **Cordis प्राइमर और आधिकारिक स्किल का सार** — Cordis की पाँच अवधारणाएँ और तंत्र की समयरेखा; [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md) आधिकारिक `cordis-plugin-development` के निषेध, प्रदर्शन-मेटाडेटा सूची और UI/प्रदर्शन नियमों का सार देता है।
 - **सत्यापित bug सूची** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 अनसुलझे + 11 नए सत्यापित, हर एक में `path:line`, बचने का उपाय और सुधार कमिट, साथ में डिज़ाइन-बनाम-bug तालिका और स्पष्ट "पुनरुत्पादन नहीं हो सका" अनुभाग।
@@ -127,8 +127,8 @@ dsh plugin --profile <name> add dsh-primer
 | `SKILL.md` | `dsh-primer` एजेंट स्किल: कठोर नियम + कार्य-प्रकार के अनुसार विकास पथ |
 | `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | इंस्टॉल-योग्य DSH bundle: `dsh.bundle.patch` manifest, स्किल रजिस्टर करने वाला प्रवेश-बिंदु, और Plugin Manager द्वारा पढ़ा जाने वाला प्रदर्शन मेटाडेटा |
 | `guide/plugin-dev-guide.md` | पूर्ण विकास गाइड (10 अध्याय) |
-| `guide/version-matrix.md` | संस्करण-अनुकूलन मैट्रिक्स: पाँच "latest", जमे हुए उप-पैकेज टैग, असंगत-बदलाव seam, peer रेंज चयन, सत्र-प्रारूप वंशावली, `0.2.1-alpha.2` के 19 बदलाव |
-| `guide/migration-0.2.md` | 0.2 पीढ़ी के असंगत बदलावों की माइग्रेशन गाइड (§0–§12 `0.2.1-alpha.1` तक, §13 में `0.2.1-alpha.2` के 19 seam) |
+| `guide/version-matrix.md` | संस्करण-अनुकूलन मैट्रिक्स: पाँच "latest", जमे हुए उप-पैकेज टैग, असंगत-बदलाव seam, peer रेंज चयन, सत्र-प्रारूप वंशावली, `0.2.1-alpha.2` के 19 बदलाव तथा 0.2.2 लाइन के 46 बदलाव |
+| `guide/migration-0.2.md` | 0.2 पीढ़ी के असंगत बदलावों की माइग्रेशन गाइड (§0–§12 `0.2.1-alpha.1` तक, §13 में `0.2.1-alpha.2` के 19 seam, §14 में rc.3 में जारी 0.2.2 लाइन के 46 seam (`K1`–`K46`) और अगली पीढ़ी के 13 अलग से) |
 | `guide/unfixed-issues.md` | स्रोत-सत्यापित bug सूची + master पर सुधर चुकी सूची + डिज़ाइन-बनाम-bug तालिका |
 | `guide/quick-reference.md` | एक पृष्ठ की चीटशीट (5 भाषाएँ) |
 | `guide/links.md` | चयनित URL सूची: आधिकारिक विकास दस्तावेज़ (साइट ↔ स्थानीय प्रतियाँ) + सामुदायिक दस्तावेज़ लिंक + केवल-रेपो पृष्ठ |
@@ -194,7 +194,7 @@ L3  webRuntime service replaced by webStartup
     detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
 ```
 
-*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:66`*
 
 ### विफलता शाखा
 
@@ -309,7 +309,7 @@ CI में चार द्वार चलते हैं: `check:readmes`
 
 | सतह | स्थिति |
 |---|---|
-| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0`। वर्तमान होस्ट लाइन: npm `latest` = `next` = `0.2.1-rc.2`, `alpha` = `0.2.1-alpha.5`, नवीनतम टैग = `dsh-v0.2.1-rc.2`; **कोई स्थिर लाइन नहीं** — सभी 31 npm संस्करण और सभी 26 GitHub Release prerelease हैं। आधिकारिक-दस्तावेज़ मिरर `e8f7b93a…` पर पिन है (2026-11-13 को सिंक, 717 md पृष्ठ / 356 EN-ZH जोड़े)। |
+| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`। वर्तमान होस्ट लाइन: npm `latest` = `0.2.2-rc.1`, `next` = `0.2.2-rc.3`, `alpha` = `0.2.2-alpha.3`, नवीनतम टैग = `dsh-v0.2.2-rc.3`; **कोई स्थिर लाइन नहीं** — सभी 44 npm संस्करण और सभी 39 GitHub Release prerelease हैं। आधिकारिक-दस्तावेज़ मिरर जारी टैग `dsh-v0.2.2-rc.3` पर पिन है (`38a6a5c9…`, 2026-11-14 को सिंक, 709 md पृष्ठ / 352 EN-ZH जोड़े)। |
 | Node | `>=24.9.0` |
 | प्लेटफ़ॉर्म | जहाँ DSH चले (शुद्ध ESM bundle; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
 | मॉडल | कोई भी (मॉडल के साथ कोई अंतःक्रिया नहीं: होस्ट स्किल-भाग को संदर्भ में डालता है) |

package/README.md

@@ -44,7 +44,7 @@ dsh plugin --profile <name> add dsh-primer
 | 缺口 | 本插件补什么 |
 |---|---|
 | **"我到底在对着哪一版开发？"** | [版本矩阵](guide/version-matrix.md)：五个都自称"最新"的值、子包 `latest` 冻结陷阱、破坏性变更断层，以及 `peerDependencies` 区间怎么选。**不存在稳定版**。 |
-| **"这一版破坏了什么？"** | [迁移指南](guide/migration-0.2.md)：把 `0.1.6-alpha.2` → `0.2.1-alpha.2` 整理成可引用的 seam，每条含症状*与*修法并附官方出处——包括一处数据丢失风险和一处"模型请求还没发出就失败"的变更。 |
+| **"这一版破坏了什么？"** | [迁移指南](guide/migration-0.2.md)：把 `0.1.6-alpha.2` → `0.2.2-rc.3` 整理成可引用的 seam（§0–§13 覆盖 0.1.6→0.2.1 线，§14 是 rc.3 包内 0.2.2 线的 46 个 `K1`–`K46`），每条含症状*与*修法并附官方出处——包括一处数据丢失风险和一处"模型请求还没发出就失败"的变更。 |
 | **"我的插件真的对吗？"** | [零依赖 CLI](SKILL.md)（`dsh-plugin-dev new / check / verify`）+ [官方文档逐字离线镜像](references/official-docs/)，让 agent 能引确切页面而不是靠猜。 |
 
 <picture>
@@ -103,7 +103,7 @@ dsh plugin --profile <name> add dsh-primer
 
 - **插件契约与红线** —— effect/disposer、waterfall 必调 `next()`、宿主自有会话事件、模型可见 ⟺ 已记录、Schemastery 配置、UI 与性能规则。
 - **官方文档逐字镜像** —— `references/official-docs/`：官方仓库文档（英 + 中）逐字副本，在最近核验快照处与上游逐字节一致，含从不进文档站的页面。
-- **版本适配矩阵** —— [guide/version-matrix.md](guide/version-matrix.md)：五个"最新"的区别、子包 `latest` 冻结陷阱、四条破坏性变更断层、peer 区间怎么选、会话格式 V0→V4 谱系，以及 `0.2.1-alpha.2` 落的 19 条破坏性变更。
+- **版本适配矩阵** —— [guide/version-matrix.md](guide/version-matrix.md)：五个"最新"的区别、子包 `latest` 冻结陷阱、四条破坏性变更断层、peer 区间怎么选、会话格式 V0→V4 谱系，以及 `0.2.1-alpha.2` 的 19 条与 rc.3 包内 0.2.2 线的 46 条破坏性变更（`K1`–`K46`，见 migration §14）。
 - **迁移指南** —— [guide/migration-0.2.md](guide/migration-0.2.md)：`0.1.6-alpha.2` → `0.2.1-alpha.1` 的每条破坏性变更（会话格式 V4、settings 重建、不变量移除、`readBytes`、新 slot、退役的 `plugin` 消息源），每条附官方出处与 12 项检查清单。
 - **Cordis 入门与官方技能要点** —— Cordis 的五个概念与机制时间线；[references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md) 提炼官方 `cordis-plugin-development` 的禁则、展示元数据清单与 UI/性能规则。
 - **来源可核验的 bug 索引** —— [guide/unfixed-issues.md](guide/unfixed-issues.md)：22 条未修 + 11 条新验证条目，每条带 `path:line`、规避法与修复提交，另有"设计取舍 vs 真 bug"对照表与明确的"无法复现"小节。
@@ -127,8 +127,8 @@ dsh plugin --profile <name> add dsh-primer
 | `SKILL.md` | `dsh-primer` agent 技能：红线 + 按任务类型的开发路径 |
 | `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | 可安装 DSH bundle：`dsh.bundle.patch` 清单、注册技能的入口，以及 Plugin Manager 读取的展示元数据 |
 | `guide/plugin-dev-guide.md` | 完整开发指南（10 章） |
-| `guide/version-matrix.md` | 版本适配矩阵：五个"最新"的区别、子包 `latest` 冻结、破坏性变更断层、peer 区间选择、会话格式谱系、`0.2.1-alpha.2` 的 19 条变更 |
-| `guide/migration-0.2.md` | 0.2 世代破坏性变更迁移指南（§0–§12 覆盖到 `0.2.1-alpha.1`，§13 覆盖 `0.2.1-alpha.2` 的 19 个 seam） |
+| `guide/version-matrix.md` | 版本适配矩阵：五个"最新"的区别、子包 `latest` 冻结、破坏性变更断层、peer 区间选择、会话格式谱系、`0.2.1-alpha.2` 的 19 条与 0.2.2 线的 46 条变更 |
+| `guide/migration-0.2.md` | 0.2 世代破坏性变更迁移指南（§0–§12 覆盖到 `0.2.1-alpha.1`，§13 覆盖 `0.2.1-alpha.2` 的 19 个 seam，§14 覆盖 rc.3 包内 0.2.2 线的 46 个 seam（`K1`–`K46`），并单列下一版 13 条） |
 | `guide/unfixed-issues.md` | 来源可核验的 bug 索引 + 已修清单 + 设计 vs bug 对照表 |
 | `guide/quick-reference.md` | 一页速查表（5 语言） |
 | `guide/links.md` | 精选 URL 索引：官方开发文档（站点 ↔ 本地副本）+ 社区文档链接 + 仅仓库内页面 |
@@ -194,7 +194,7 @@ L3  webRuntime service replaced by webStartup
     detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
 ```
 
-*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:66`*
 
 ### 失败分支
 
@@ -290,7 +290,7 @@ no seam or capability matches "no-such-seam-xyz". This is an absence of evidence
 
 ## 已知限制
 
-- **官方文档是快照。** 上游变化时用 `scripts/sync-official-docs.ps1` 重新同步；新鲜度戳与提交号引用 `references/official-docs/SNAPSHOT.md`。
+- **官方文档是快照。** 镜像钉发布 tag（当前 `dsh-v0.2.2-rc.3` / `38a6a5c9`），上游发新版时用 `scripts/sync-official-docs.ps1 -Ref <tag>` 重新同步；`node scripts/check-docs-drift.mjs` 判断是否有更新的 release tag。新鲜度戳与提交号引用 `references/official-docs/SNAPSHOT.md`。
 - **`downloads/` 由脚本生成、不入库。** 原始快照（社区仓库归档、Discussions、文章）使用前需用 `scripts/download-*.ps1` 生成。
 - **`awesome-dsh-plugins` 内容仅本地。** 其上游声明内部使用约束，故不随仓库再分发。
 
@@ -309,7 +309,7 @@ no seam or capability matches "no-such-seam-xyz". This is an absence of evidence
 
 | 维度 | 状态 |
 |---|---|
-| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0`。当前宿主线：npm `latest` = `next` = `0.2.1-rc.2`、`alpha` = `0.2.1-alpha.5`，最新 tag = `dsh-v0.2.1-rc.2`；**不存在稳定版**——31 个 npm 版本与 26 个 GitHub Release 全是 prerelease。官方文档镜像钉在 `e8f7b93a…`（2026-11-13 同步，717 篇 md / 356 对中英双语）。 |
+| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`。当前宿主线：npm `latest` = `0.2.2-rc.1`、`next` = `0.2.2-rc.3`、`alpha` = `0.2.2-alpha.3`，最新 tag = `dsh-v0.2.2-rc.3`；**不存在稳定版**——44 个 npm 版本与 39 个 GitHub Release 全是 prerelease。官方文档镜像钉在发布 tag `dsh-v0.2.2-rc.3`（`38a6a5c9…`，2026-11-14 同步，709 篇 md / 352 对中英双语）。 |
 | Node | `>=24.9.0` |
 | 平台 | 任何 DSH 可运行处（纯 ESM bundle；无原生代码、无网络） |
 | 模型 | 任意（不调用模型：技能正文由宿主注入上下文） |

package/README.pt.md

@@ -44,7 +44,7 @@ Por que não basta ler a documentação oficial? Porque ela é escrita para quem
 | Lacuna | O que este plugin acrescenta |
 |---|---|
 | **"Contra qual DSH eu estou desenvolvendo?"** | Uma [matriz de versões](guide/version-matrix.md): os cinco valores que se chamam "latest", as tags `latest` congeladas dos subpacotes, os seams de mudança incompatível e como escolher um intervalo de `peerDependencies`. **Não existe linha estável.** |
-| **"O que esta versão quebra?"** | Um [guia de migração](guide/migration-0.2.md) que organiza `0.1.6-alpha.2` → `0.2.1-alpha.2` como seams citáveis, cada um com sintoma *e* correção e sua fonte oficial, incluindo um risco de perda de dados e uma mudança que faz os prompts falharem antes de a requisição ao modelo ser montada. |
+| **"O que esta versão quebra?"** | Um [guia de migração](guide/migration-0.2.md) que organiza `0.1.6-alpha.2` → `0.2.2-rc.3` como seams citáveis (§0–§13 cobrem a linha 0.1.6→0.2.1; §14 são os 46 seams `K1`–`K46` da linha 0.2.2 publicados no rc.3), cada um com sintoma *e* correção e sua fonte oficial, incluindo um risco de perda de dados e uma mudança que faz os prompts falharem antes de a requisição ao modelo ser montada. |
 | **"Meu plugin está realmente correto?"** | Um [CLI sem dependências](SKILL.md) (`dsh-plugin-dev new / check / verify`) mais um [espelho literal offline](references/official-docs/) da documentação oficial, para que o agente cite a página exata em vez de adivinhar. |
 
 <picture>
@@ -103,7 +103,7 @@ O `dsh-primer` é a base de conhecimento de desenvolvimento de plugins do DSH ma
 
 - **Contrato de plugin e regras duras** — effects/disposers, listeners waterfall que precisam chamar `next()`, eventos de sessão de propriedade do host, visível-para-o-modelo ⟺ registrado, configuração Schemastery, regras de UI e desempenho.
 - **Espelho literal da documentação oficial** — `references/official-docs/`: cópia byte a byte dos documentos do repositório oficial (EN + ZH), idêntica ao upstream no último snapshot verificado, incluindo as páginas que nunca chegam ao site de documentação.
-- **Matriz de adaptação de versões** — [guide/version-matrix.md](guide/version-matrix.md): os cinco valores "latest", as tags `latest` congeladas dos subpacotes, os quatro seams de mudança incompatível, como escolher o intervalo peer, a linhagem do formato de sessão V0→V4 e as 19 mudanças incompatíveis de `0.2.1-alpha.2`.
+- **Matriz de adaptação de versões** — [guide/version-matrix.md](guide/version-matrix.md): os cinco valores "latest", as tags `latest` congeladas dos subpacotes, os quatro seams de mudança incompatível, como escolher o intervalo peer, a linhagem do formato de sessão V0→V4 as 19 mudanças incompatíveis de `0.2.1-alpha.2` e os 46 seams da linha 0.2.2 publicados no rc.3 (`K1`–`K46`, ver migração §14).
 - **Guia de migração** — [guide/migration-0.2.md](guide/migration-0.2.md): cada mudança incompatível de `0.1.6-alpha.2` a `0.2.1-alpha.1` (formato de sessão V4, reconstrução de settings, remoção de invariantes, `readBytes`, slots novos, a fonte de mensagem `plugin` aposentada), cada uma com sua fonte oficial e uma lista de 12 verificações.
 - **Primer do Cordis e a skill oficial, destilada** — os cinco conceitos do Cordis e a linha do tempo de mecanismos; [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md) destila as proibições de `cordis-plugin-development`, a lista de metadados de apresentação e as regras de UI/desempenho.
 - **Índice de bugs verificados** — [guide/unfixed-issues.md](guide/unfixed-issues.md): 22 não corrigidos + 11 recém-verificados, cada um com `path:line`, contorno e commit de correção, mais uma tabela projeto-vs-bug e uma seção explícita de "não reproduzível".
@@ -127,8 +127,8 @@ O `dsh-primer` é a base de conhecimento de desenvolvimento de plugins do DSH ma
 | `SKILL.md` | A skill de agente `dsh-primer`: regras duras + caminhos de desenvolvimento por tipo de tarefa |
 | `package.json` · `cordis.patch.yml` · `index.js` · `locale/` · `icon.svg` | O bundle DSH instalável: manifesto `dsh.bundle.patch`, entrada que registra a skill e metadados de apresentação lidos pelo Plugin Manager |
 | `guide/plugin-dev-guide.md` | O guia de desenvolvimento completo (10 capítulos) |
-| `guide/version-matrix.md` | Matriz de adaptação de versões: os cinco "latest", tags `latest` congeladas, seams de mudança incompatível, escolha de intervalo peer, linhagem do formato de sessão, as 19 mudanças de `0.2.1-alpha.2` |
-| `guide/migration-0.2.md` | Guia de migração de mudanças incompatíveis da geração 0.2 (§0–§12 até `0.2.1-alpha.1`, §13 com os 19 seams de `0.2.1-alpha.2`) |
+| `guide/version-matrix.md` | Matriz de adaptação de versões: os cinco "latest", tags `latest` congeladas, seams de mudança incompatível, escolha de intervalo peer, linhagem do formato de sessão, as 19 mudanças de `0.2.1-alpha.2` mais as 46 da linha 0.2.2 |
+| `guide/migration-0.2.md` | Guia de migração de mudanças incompatíveis da geração 0.2 (§0–§12 até `0.2.1-alpha.1`, §13 com os 19 seams de `0.2.1-alpha.2`, §14 com os 46 seams (`K1`–`K46`) publicados no rc.3 e os 13 da próxima versão em separado) |
 | `guide/unfixed-issues.md` | Índice de bugs verificado em fontes + lista corrigida no master + tabela projeto-vs-bug |
 | `guide/quick-reference.md` | Folha de consulta de uma página (5 idiomas) |
 | `guide/links.md` | Índice de URLs curado: documentação oficial de desenvolvimento (site ↔ cópias locais) + links da comunidade + páginas só do repositório |
@@ -194,7 +194,7 @@ L3  webRuntime service replaced by webStartup
     detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
 ```
 
-*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:44`*
+*Observed from `src/cli/commands/seams.ts:54; data/seams/index.json:66`*
 
 ### Ramo de falha
 
@@ -309,7 +309,7 @@ Este plugin **não** interfere em outros plugins:
 
 | Superfície | Estado |
 |---|---|
-| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0`. Linha atual do host: npm `latest` = `next` = `0.2.1-rc.2`, `alpha` = `0.2.1-alpha.5`, tag mais recente = `dsh-v0.2.1-rc.2`; **não existe linha estável** — as 31 versões do npm e as 26 releases do GitHub são prereleases. O espelho da documentação oficial está fixado em `e8f7b93a…` (sincronizado em 2026-11-13, 717 páginas md / 356 pares EN-ZH). |
+| Harness | `engines.dsh` = `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`. Linha atual do host: npm `latest` = `0.2.2-rc.1`, `next` = `0.2.2-rc.3`, `alpha` = `0.2.2-alpha.3`, tag mais recente = `dsh-v0.2.2-rc.3`; **não existe linha estável** — as 44 versões do npm e as 39 releases do GitHub são prereleases. O espelho da documentação oficial está fixado na tag `dsh-v0.2.2-rc.3` (`38a6a5c9…`, sincronizado em 2026-11-14, 709 páginas md / 352 pares EN-ZH). |
 | Node | `>=24.9.0` |
 | Plataformas | Onde o DSH rodar (bundle ESM puro; sem código nativo, sem rede) |
 | Modelo | Qualquer (sem interação com modelos: o host injeta o corpo da skill no contexto) |

package/SKILL.md

@@ -24,9 +24,11 @@ description: Use when developing, reviewing, packaging, debugging, or answering
    |---|---|---|
    | `< 0.1.7-alpha.1` | 旧基线 | 本世代破坏性变更**全部适用** → `guide/migration-0.2.md` §0–§12 逐条改 |
    | `0.1.7-alpha.1` – `0.2.1-alpha.1` | 中间线 | 会话格式 V4 已生效；§13 的 19 条**不适用** |
-   | `0.2.1-alpha.2` 或更新 | 最新线 | §13 的 19 条**适用** → `guide/version-matrix.md` §3 |
-   | **npm `latest`（= `0.2.0-rc.2`）** | **默认安装拿到的就是这一版** | ⚠️ 它**早于** master 一版：§13 不适用，但 `version-matrix.md` §1.1 的"不存在稳定版"警告适用 |
-   **四个"最新"不是同一个东西**：npm `latest`=`next`=`0.2.0-rc.2`、npm `alpha`=`0.2.1-alpha.2`、master 最新 tag = `dsh-v0.2.1-alpha.2`。**不存在稳定版**（全部 31 个 npm 版本都是 prerelease）。完整谱系、子包 `latest` 冻结陷阱与 peer 区间选择见 `guide/version-matrix.md`。
+   | `0.2.1-alpha.2` – `0.2.2-alpha.2` | 0.2.1 尾线 | §13 的 19 条**适用**；`§14` 的 0.2.2 线（`K1`–`K46`）尚未落地 |
+   | `0.2.2-alpha.3` – `0.2.2-rc.1` | 0.2.2 线中段 | `K1`–`K22` 已落地（alpha.3）、`K23`–`K27` 已落地（rc.1）；`K28`–`K46` 尚未 |
+   | `0.2.2-rc.2` 或更新（当前 `0.2.2-rc.3`） | **当前线** | §13 + §14 全部 **46 条**（`K1`–`K46`）适用；`v0.2.2-rc.2` 的 13 条指南是**下一版**内容，**不适用** |
+   | **npm `latest`（= `0.2.2-rc.1`）** | **默认安装拿到的就是这一版** | 它**早于**最新 tag 两个发布：`K28`–`K46` 尚未落地，其余同 0.2.2 线 |
+   **几个"最新"不是同一个东西**：npm `latest`=`0.2.2-rc.1`、`next`=`0.2.2-rc.3`、`alpha`=`0.2.2-alpha.3`，最新 tag = `dsh-v0.2.2-rc.3`（2026-11-13）。**不存在稳定版**（全部 44 个 npm 版本与 39 个 GitHub Release 都是 prerelease）。完整谱系、子包 `latest` 冻结陷阱与 peer/engines 区间选择见 `guide/version-matrix.md`。
 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`。
@@ -50,7 +52,7 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 - 可替换能力按三层接缝设计：Service Definition / Provider / Consumer；不提前拆。
 - 打包：bundle 清单 `"dsh":{"bundle":{"patch":"..."}}`（`patch` **可为有序数组**，每个文件的相对路径按各自目录解析）；覆盖按 `id` 整行替换 config（上游删行后 override **静默失效**，升级后跑 `--dump-config` 查 `patch: entry not found`）；`!!js`（双感叹号）；git 安装需要 `prepare` 脚本与用户侧 `allowBuilds`，发布 npm/tarball 免构建许可。
 - **交付必须补展示元数据**：`locale/*.json` 的 `meta.title`/`meta.description` + 导出的 `./icon`（≤256 KiB、realpath 后必须在包内）；子路径插件**不读** `package.json`。
-- **共享实例的 dsh 包只放 peerDependencies + devDependencies**，绝不放 dependencies（profile 内副本会静默遮蔽运行时版本，核心服务注册失败）。⚠️ **peer 范围会被安装期强制**（早期版本写成"DSH 不校验"，**已更正**）：`dsh plugin add` 拿运行时版本比对声明的 `@deepseek-ai/dsh-*` 范围，不匹配即**拒绝安装**；`engines.dsh` 才是纯声明、零强制。范围只能表达"能不能装"，**表达不了某个 API 在不在**——仍要配运行时探测。区间选择见 `guide/version-matrix.md` §4。
+- **共享实例的 dsh 包只放 peerDependencies + devDependencies**，绝不放 dependencies（profile 内副本会静默遮蔽运行时版本，核心服务注册失败）。⚠️ **兼容性门禁在安装/启动时强制**（早期版本写成"DSH 不校验 peer"，**已更正**）：**清单里有 `engines.dsh` 时，它单独决定结果并忽略 `@deepseek-ai/dsh*` peers**；只有**没有** `engines.dsh` 时才回退到 peer 范围。判定用 `includePrerelease: true`，所以下界要带预发布（`>=0.2.2-0 <0.3.0`）；`workspace:` 在 `engines.dsh` 里不合法；声明了 `engines.dsh` 就必须让它覆盖全部支持版本。范围只能表达"能不能装"，**表达不了某个 API 在不在**——仍要配运行时探测。区间选择见 `guide/version-matrix.md` §4，官方语义见 `references/official-docs/docs/upgrade-guide/v0.2.1-alpha.3/plugin-engines-dsh/guide.md`。
 - **UI 插件**：只渲染 slot 里的 React 组件（禁止 iframe 托管页面）；样式只用 `--dsw-alias-*` 主题 token；不 `require` 任何 Harness Client 包（抛错组件会把整个 slot 搞白）；`dsh.client.inject` **必须是静态数组**；不在组件外写 DOM、不往 `document.body` 追加。
 - **性能**：per-session 状态放 `ctx.sessionProjections`（纯同步 apply、忽略即同引用、纯 JSON + `stateVersion`）；等持久事件（`turn/end`/`assistant/message`/`tool/result`），实时 token 读 `agent/assistant-stream`；**不轮询 `agent/status`**。
 - **禁止**：在会话运行期间改 profile 的 `cordis.patch.yml`（HMR 会重载，实测丢光 preset 工具、杀掉在途 turn、最坏永久废掉 `sessionController`）；手写 profile 的 `package.json`；在 profile 目录里跑 pnpm。
@@ -69,7 +71,7 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 - **权限 / 审批 / 沙箱**：`docs/subsystems/approval.md`（审批流与 `ask` 决策）+ `docs/subsystems/permission-presets.md`（预设档位）+ `docs/subsystems/sandbox.md`（进程约束及其已知边界：Windows ACL 部分强制）。需要拦截工具调用时读 `docs/cookbook/extension-cookbook.md` 的 permission-gate 范例。
 - **上下文 / 压缩 / 性能**：`docs/subsystems/compaction.md`（压缩缝与阈值语义）+ `docs/subsystems/spill.md`（溢出存储：只负责存储，无保留策略、无检索 API）；`ctx` 自身的 API 面见 `docs/cordis-api/context.md`（**没有** subsystems 版的 context 页）。per-session 派生状态用 `ctx.sessionProjections`（见 §4.8 第 5 条）。
 - **打包/发布**：`docs/user/develop/basic/publish.md`（bundle/profile、层顺序、多 patch 数组、peer 解析、git 安装坑）。
-- **升级/迁移**：`guide/version-matrix.md`（**版本适配矩阵：先读这个**——五个"最新"、子包 `latest` 冻结、破坏性变更断层、peer 区间选择、会话格式 V0→V4）→ `guide/migration-0.2.md`（本库综述，0.1.6→0.2.1-alpha.1）→ `docs/upgrade-guide/**`（官方逐版本迁移指南）+ `docs/persistence-changes/**`（持久化类型变更记录）+ `docs/session-format-status.md`（会话格式版本权威）。⚠️ **目标宿主是 `0.2.1-alpha.2` 或更新时**：`version-matrix.md` §3 列了该版落的 **19 条破坏性变更**（`webRuntime`→`webStartup`、`mode: both` 被拒、`backgroundMode`/`run_in_background` 移除、`{{cwd}}` 移除、`BundleInfo` 新增必填字段、`dsh plugin --profile` 位置强制等），`migration-0.2.md` **尚未并入**。
+- **升级/迁移**：`guide/version-matrix.md`（**版本适配矩阵：先读这个**——几个"最新"、子包 `latest` 冻结、破坏性变更断层、peer/engines 区间选择、会话格式 V0→V4）→ `guide/migration-0.2.md`（本库综述，0.1.6→0.2.1 线 + §14 的 0.2.2 线）→ `docs/upgrade-guide/**`（官方逐版本迁移指南）+ `docs/persistence-changes/**`（持久化类型变更记录）+ `docs/session-format-status.md`（会话格式版本权威）。⚠️ **目标宿主落在 `0.2.2-rc.2` 或更新（当前 rc.3）时**：`version-matrix.md` §3 的 19 条（0.2.1-alpha.2 线）**与** `migration-0.2.md` §14 的 46 条（0.2.2 线，`K1`–`K46`）都适用——后者含 `engines.dsh` 门禁语义、`dsh-doc-skill`、`plugin-update-method`（`BundleInfo.updatable`→`update`）、`Session.append` 双 overload、`window-drag-regions`、`attachment-error-codes` 等。镜像里**没有** `v0.2.2-rc.2` 目录：那 13 条属下一版，别当 rc.3 变更。
 - **查服务/事件精确签名**：**优先用会话内 inspection**（`cordis_inspect_list` / `cordis_inspect_query`：Service / Event / Config / Tool / Slots / Theme），其次 `docs/subsystems/*.md` 生成式 Cordis API 区 + `docs/cordis-api/*`；**不要自造第二份静态清单**。站点 URL ↔ 本地副本对照见 `guide/links.md`，社区链接完整清单见 `references/community-ecosystem.md`。
 - **官方自带插件开发技能（0.2 世代新增，先读）**：`references/official-plugin-dev-skill.md`（主流程 + 六份分面参考要点 + 模板定位）；上游在 `packages/preset/agent-preset/skills/cordis-plugin-development/**`。它规定的官方路径是：工作区写 bundle → `plugin_manager` `install_bundle`（绝对目录）→ `cordis_inspect_query` 核对，**禁止**手写 profile 的 `package.json`/`cordis.patch.yml`、禁止在 profile 目录跑 pnpm。
 - **参考社区实现与实测坑**：`references/community-ecosystem.md`、`references/community-repo-deep-dive.md`（首批 15 个开发仓库深读）、`downloads/community-repos/`（**114 个仓库完整源码副本**，需先跑 `scripts/download-community-repos.ps1` 生成）。社区已确认的机制变化（repository-plugin 0811 移除、bundle vs 纯 cordis 双通道）与实测坑清单在 `guide/plugin-dev-guide.md` §7，源码级问题索引在 `guide/unfixed-issues.md`（含本世代新核实的 T1–T11）。官方 Discussions 全量归档（**2026-10-06 刷新**，含 #1629 官方插件脚手架 RFC）与 npm 全家桶元数据分别在 `downloads/github/harness/discussions/` 与 `downloads/npm/`；中英文社区文章 HTML 快照在 `downloads/web/community-articles/`。
@@ -85,9 +87,9 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 
 ## 知识库维护（需要时）
 
-- 同步官方文档副本：`pwsh -File ./scripts/sync-official-docs.ps1 [-Checkout <deepseek-harness checkout>]`——只同步 git 已跟踪文件（未跟踪草稿与未推送提交不会进来），并刷新 `references/official-docs/SNAPSHOT.md`；README 的"最后核验"日期与提交号引用 SNAPSHOT.md，不要手改。漂移校验：`pwsh -File ./scripts/check-docs-drift.ps1 -Checkout <checkout>`（快速）或 `pwsh -File ./scripts/verify-kit.ps1 -Checkout <checkout>`（全量）。
+- 同步官方文档副本：`pwsh -File ./scripts/sync-official-docs.ps1 [-Checkout <deepseek-harness checkout>] [-Ref <tag|sha>]`——用 `-Ref` 钉**发布 tag**（当前 = `dsh-v0.2.2-rc.3` / `38a6a5c9…`，709 篇 md / 352 对中英），不钉 master HEAD；只同步 git 已跟踪文件（未跟踪草稿与未推送提交不会进来），并刷新 `references/official-docs/SNAPSHOT.md`；README 的"最后核验"日期与提交号引用 SNAPSHOT.md，不要手改。新鲜度校验（无 checkout）：`node ./scripts/check-docs-drift.mjs`（比较最新 release tag 与 SNAPSHOT 的 Source ref；**不要**用旧的 branch-tip 探针，tag 钉住时它必然报 drift）。有 checkout 时用 `pwsh -File ./scripts/verify-kit.ps1 -Checkout <checkout>` 做逐文件哈希对比。
 - 刷新线上资料：`pwsh -File ./scripts/download-sources.ps1`；刷新社区仓库：`pwsh -File ./scripts/download-community-repos.ps1`；刷新社区文章快照：`pwsh -File ./scripts/download-community-articles.ps1`（三个脚本幂等，产出进 `./downloads/`）。刷新官方 Discussions 归档：`$env:GH_TOKEN=<token>; pwsh -File ./scripts/archive-discussions.ps1`（list.json + 精选线程评论，防缩水保护；**2026-10-06 期：list=5000、精选 1648**）。**注意 REST 分页天花板**：`/discussions` 列表最多翻到 5000 条，而仓库实际 total_count≈8850（GraphQL 口径）——需要更全的历史时按 GraphQL `UPDATED_AT DESC` 补抓。话题清单计数重核：`pwsh -File ./scripts/gen-topic-snapshot.ps1 -OutDir <dir> -MaxPages 10`。
-- **维护节奏建议**：官方 3 周内发了 9 个 prerelease，所以"最后核验"日期要跟 tag 走；每次官方发版后按 `references/official-docs/docs/upgrade-guide/**`（**无 index、无入链**，必须主动看）+ `docs/persistence-changes/**` + GitHub Releases 说明三处增量更新 `guide/migration-0.2.md` 与 `guide/unfixed-issues.md`。
+- **维护节奏建议**：0.2.2 线在 17 天内发了 5 个 prerelease（2026-10-27 `alpha.2` → 11-13 `rc.3`），所以"最后核验"日期要跟 tag 走；每次官方发版后按 `references/official-docs/docs/upgrade-guide/**`（**无 index、无入链**，必须主动看）+ `docs/persistence-changes/**` + GitHub Releases 说明三处增量更新 `guide/migration-0.2.md` 与 `guide/unfixed-issues.md`。
 - 安装/刷新 agent 技能副本：`pwsh -File ./scripts/install-skill.ps1 -Target <skill目录>`（跳过 downloads/ 与 .github/，逐字节校验）。
 - 冲突裁决：与官方文档冲突时以 `references/official-docs/`（官方仓库原文）为准；官方文档与**代码**冲突时以代码/产物为准并**明确标注分歧**（本轮已发现一例：`session-format-status.md` 的发布记录落后于代码与 npm）。
 
@@ -103,9 +105,9 @@ description: Use when developing, reviewing, packaging, debugging, or answering
 - `new <name>`：参数化脚手架，生成 TS 或 JS 插件仓库骨架（`src/index.ts` 契约模板、Schemastery Config、tests、tsdown/vitest、注释齐全的 `cordis.patch.yml`、五语 README），模板与 `references/official-docs` 同步更新。标志：`--lang <ts|js>`、`--dir <path>`、`--force`、`--git`。
 - `check [--json] [--strict] [--cwd <dir>]`：静态检查（`cordis.patch.yml` 合法性、`package.json` 元数据（`dsh.bundle.patch` 指向/peer 依赖/engines/files 白名单）、五语 README 一致性、工程红线模式），输出 CI 可消费的结构化 JSON；每个检查项在输出里引用本知识库对应章节（skill 联动），agent 可继续人工审计。**这 16 项是同族 `dsh-plugin-doctor` 33 项的子集**（逐项对照见 `guide/family-toolchain.md` §3）；发布前建议两个都跑。
 - `verify [--cwd <dir>] [--base <spec>] [--headless <spec>] [--profile <name>]`：`pnpm pack` 后装入干净临时 `DSH_HOME` profile 做安装+启动+卸载冒烟（对齐官方 verify:self-contained）；失败给出日志尾部与建议。
-- `seams <query>` / `seams --since <version>`：**回答"这个 API 在我目标宿主里存不存在"**，而不是让你去翻 717 页镜像。`query` 可以是 seam id（`L3`）、能力 id（`A20`）、版本号或任意词。`--since 0.2.0-rc.2` 列出**在该版本之后落地**的所有破坏性变更，并标出哪些**静态检查看不到**。
+- `seams <query>` / `seams --since <version>`：**回答"这个 API 在我目标宿主里存不存在"**，而不是让你去翻 709 页镜像。`query` 可以是 seam id（`L3` / `K12`）、能力 id（`A20`）、版本号或任意词。`--since 0.2.0-rc.2` 列出**在该版本之后落地**的所有破坏性变更，并标出哪些**静态检查看不到**。
   - **第三态是强制的**：知识库没有依据时**退出码 3 并明确说"这是知识库没有依据，不等于该 API 不存在"**——绝不把"不知道"渲染成"没有"。
-  - 数据源 `data/seams/index.json`：19 条 `L` 走廊 seam + 6 条机制 seam + 22 个能力区，每条带 `confidence`（`documented`/`inferred`/`unknown`）与官方出处；**其中 9 条标 `detectable: false` 并写明原因**（数据丢失、运行时状态、部署相关行为），任何消费者都不得把它们算作通过。
+  - 数据源 `data/seams/index.json`：19 条 `L` 走廊 seam（0.2.1 线）+ 7 条机制 seam + **46 条 `K` seam（0.2.2 线，rc.3 包内）** + 22 个能力区；另用 `unreleased` 单列 `v0.2.2-rc.2` 的 13 条下一版指南。每条带 `confidence`（`documented`/`inferred`/`unknown`）与官方出处；**其中 23 条标 `detectable: false` 并写明原因**（数据丢失、运行时状态、部署相关行为），任何消费者都不得把它们算作通过。
 
 四个子命令均可逆/幂等；网络/子进程尊重超时与 AbortSignal；只清理自己 mkdtemp 的目录。CLI 零运行时依赖，构建产物经 tsdown 打包为单文件 `dist/dsh-plugin-dev.js`。
 

package/data/facts.json

@@ -1,18 +1,20 @@
 {
   "schema": "dsh-plugin-guide/facts/v1",
-  "measuredAt": "2026-11-13",
+  "measuredAt": "2026-11-14",
   "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.",
     "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 recounted 2026-11-13 after re-syncing references/official-docs to deepseek-harness e8f7b93 (dsh-v0.2.2-rc.2): 717 md pages, 356 .zh.md pairs."
+    "Mirror recounted 2026-11-13 after re-syncing references/official-docs to deepseek-harness e8f7b93 (dsh-v0.2.2-rc.2): 717 md pages, 356 .zh.md pairs.",
+    "Recounted 2026-11-14: the official-docs mirror is re-synced from the release tag `dsh-v0.2.2-rc.3` (`38a6a5c9…`), not from master HEAD. The previous pin `e8f7b93` was a master sync commit 17 minutes after the rc.2 tag, never the rc.2 tag itself (tag commit `ddac9676…`), and it carried 4 master-only `v0.2.2-rc.1` guides: 717 md / 356 .zh.md pairs. The tag snapshot is 709 md / 352 .zh.md pairs.",
+    "Host facts recounted 2026-11-14 against the npm registry and the GitHub API: 44 npm versions, 39 GitHub Releases (all prereleases), dist-tags latest=0.2.2-rc.1 / next=0.2.2-rc.3 / alpha=0.2.2-alpha.3, newest tag dsh-v0.2.2-rc.3. The rc.3 tag ships 46 upgrade guides for the 0.2.2 line (22 authored at v0.2.2-alpha.2, 5 at v0.2.2-alpha.3, 19 at v0.2.2-rc.1); the 13 guides authored at v0.2.2-rc.2 are master-only next-version content and are NOT counted."
   ],
   "mirror": {
-    "mdPages": 717,
-    "zhPairs": 356,
-    "pinnedCommit": "e8f7b93a344964de3dca1ace9e72b6e4d6de87cb",
-    "pinnedTag": "dsh-v0.2.2-rc.2",
-    "syncedAt": "2026-11-13"
+    "mdPages": 709,
+    "zhPairs": 352,
+    "pinnedCommit": "38a6a5c965aa99ab525161efb7cc5cf1fe62fced",
+    "pinnedTag": "dsh-v0.2.2-rc.3",
+    "syncedAt": "2026-11-14"
   },
   "readme": {
     "sections": 24,
@@ -30,6 +32,10 @@
   },
   "seams": {
     "corridorL": 19,
+    "corridorK": 46,
+    "corridorKDetectable": 32,
+    "corridorKAdvisory": 14,
+    "unreleased": 13,
     "capabilityAreas": 22,
     "staticallyDetectable": 10,
     "advisoryOnly": 9,
@@ -45,16 +51,30 @@
       "L14",
       "L15"
     ],
-    "note": "An audit claimed 14 detectable / 5 advisory. Counting the records in data/seams/index.json gives 10 / 9. The audit figure was never verified; these are the counted values, and scripts/check-facts.mjs asserts them against the index."
+    "note": "L1–L19 are the 0.2.1-alpha.2 corridor (10 statically detectable / 9 advisory). K1–K46 are the 0.2.2 line covered by the rc.3 release tag (32 detectable / 14 advisory; each advisory record says why). `unreleased` holds the 13 guides authored at v0.2.2-rc.2 that are master-only next-version content. The audit figure 14/5 for L was never verified; these are the counted values, and scripts/check-facts.mjs asserts all of them against the index."
   },
   "host": {
-    "npmLatest": "0.2.1-rc.2",
-    "npmNext": "0.2.1-rc.2",
-    "npmAlpha": "0.2.1-alpha.5",
-    "newestTag": "dsh-v0.2.1-rc.2",
-    "npmVersionCount": 31,
-    "githubReleaseCount": 26,
-    "stableLines": 0
+    "npmLatest": "0.2.2-rc.1",
+    "npmNext": "0.2.2-rc.3",
+    "npmAlpha": "0.2.2-alpha.3",
+    "newestTag": "dsh-v0.2.2-rc.3",
+    "npmVersionCount": 44,
+    "githubReleaseCount": 39,
+    "stableLines": 0,
+    "node": ">=24.9.0",
+    "cordisWrapper": "4.1.0",
+    "cordisUpstream": "4.0.0-rc.11",
+    "rc3GuideCounts": {
+      "0.2.2-alpha.2": 22,
+      "0.2.2-alpha.3": 5,
+      "0.2.2-rc.1": 19,
+      "total": 46
+    },
+    "nextVersion": {
+      "authoredAt": "0.2.2-rc.2",
+      "count": 13,
+      "note": "Only on master after the rc.3 tag; not part of the rc.3 release."
+    }
   },
   "family": {
     "rosterRows": 45,