dsh-plugin-guide 0.3.21 → 0.3.23

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.i18n.yaml

@@ -0,0 +1,16 @@
+# Bilingual-pair consistency record for guide.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.md
+/:
+  en: 2b61d3edeb5cb9b3
+  zh: c8c19ac891de1483
+/automation-tasks-bundle-removed:
+  en: fb9d856d884313d9
+  zh: 6fa0d728f26c5f8e
+/automation-tasks-bundle-removed/change:
+  en: 0a35ea93af06452f
+  zh: 094dd5f6422bab8d
+/automation-tasks-bundle-removed/migration:
+  en: 04278f963f780cad
+  zh: f8e49107b3a5df07

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.md

@@ -0,0 +1,22 @@
+---
+kind: upgrade-guide
+description: "The Automation tasks optional bundle is removed; the Web composition mounts Schedule itself."
+---
+
+# Automation tasks bundle removed
+
+English | [中文](guide.zh.md)
+
+## Change
+
+In v0.2.0-rc.2, switching on Automation tasks in the Plugins page appended `@deepseek-ai/dsh-experimental-schedule-bundle` to `dsh.profile.bundles` in `$DSH_HOME/profiles/<name>/package.json`. That bundle inserted the `time-context`, `schedule`, and `ui-schedule` rows.
+
+The next release removes the bundle. `@deepseek-ai/dsh-web-app` mounts `schedule` and `ui-schedule` in every Web profile, and the `standard`, `cordis`, and `ptc` presets declare the clock reading and the four `schedule_*` tools; `minimal` declares neither ([details](../../../subsystems/schedule.md)).
+
+Loading a profile removes `@deepseek-ai/dsh-experimental-schedule-bundle` from its `dsh.profile.bundles` and rewrites `package.json`; other manifest fields are kept. Stored tasks and delivery records stay on disk and remain in use.
+
+## Migration
+
+1. Start `dsh` once with each affected profile; no manual edit is needed. A profile directory that another tool writes must drop the entry from `dsh.profile.bundles` itself.
+2. Keep overrides on `schedule` and `ui-schedule` in `cordis.patch.yml` or a `--patch` overlay; the Web composition carries those rows. A top-level override on `time-context` no longer matches a row, because the clock row belongs to the presets ([time-context](../../../../packages/context/time-context/README.md)); delete it.
+3. Confirm: `dsh.profile.bundles` no longer lists the bundle, the Plugins page shows no failed Automation tasks entry, and the sidebar shows Automation tasks with the previously stored reminders.

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.zh.md

@@ -0,0 +1,22 @@
+---
+kind: upgrade-guide
+description: "“自动化任务”可选 bundle 已移除；Web 组合自行挂载 Schedule。"
+---
+
+# “自动化任务” bundle 已移除
+
+[English](guide.md) | 中文
+
+## 变更
+
+在 v0.2.0-rc.2 中，在插件管理页开启“自动化任务”会把 `@deepseek-ai/dsh-experimental-schedule-bundle` 追加到 `$DSH_HOME/profiles/<name>/package.json` 的 `dsh.profile.bundles`。该 bundle 插入 `time-context`、`schedule` 和 `ui-schedule` 三行。
+
+下一版本移除该 bundle。`@deepseek-ai/dsh-web-app` 在每个 Web profile 中挂载 `schedule` 和 `ui-schedule`，`standard`、`cordis` 和 `ptc` preset 声明时钟读数和四个 `schedule_*` 工具；`minimal` 两者都不声明（[详情](../../../subsystems/schedule.zh.md)）。
+
+加载 profile 时会从其 `dsh.profile.bundles` 中删除 `@deepseek-ai/dsh-experimental-schedule-bundle` 并重写 `package.json`；其他 manifest 字段保持不变。已存储的任务和投递记录仍保留在磁盘上并继续使用。
+
+## 迁移
+
+1. 用每个受影响的 profile 启动一次 `dsh`，无需手动编辑。由其他工具写入的 profile 目录需要自行从 `dsh.profile.bundles` 删除该条目。
+2. 保留 `cordis.patch.yml` 或 `--patch` overlay 中针对 `schedule` 和 `ui-schedule` 的覆盖项；Web 组合包含这两行。顶层针对 `time-context` 的覆盖项不再匹配任何行，因为时钟行属于 preset（[time-context](../../../../packages/context/time-context/README.zh.md)）；请删除它。
+3. 确认：`dsh.profile.bundles` 不再列出该 bundle，插件管理页不再显示异常的“自动化任务”条目，且侧栏显示“自动化任务”并列出之前存储的提醒。

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.i18n.yaml

@@ -0,0 +1,16 @@
+# Bilingual-pair consistency record for guide.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.md
+/:
+  en: 671d5c0f87811869
+  zh: 442229358c471ea8
+/subpath-plugins-read-subpath-icon-instead-of-subpath-package-json:
+  en: 4e7a5119af04d780
+  zh: e70b1fc5f253d6f4
+/subpath-plugins-read-subpath-icon-instead-of-subpath-package-json/change:
+  en: 4793cf77e0c3a9ba
+  zh: a4fbe548044af6e6
+/subpath-plugins-read-subpath-icon-instead-of-subpath-package-json/migration:
+  en: bd32f99339b4a69e
+  zh: b0d6b46724bc57cc

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.md

@@ -0,0 +1,27 @@
+---
+kind: upgrade-guide
+description: "Subpath plugins no longer read display text or icons from an exported <subpath>/package.json; they use locale meta and <subpath>/icon."
+---
+
+# Subpath plugins read `<subpath>/icon` instead of `<subpath>/package.json`
+
+English | [中文](guide.zh.md)
+
+## Change
+
+In v0.2.0-rc.2, Plugin Manager and Settings read a subpath plugin such as `my-plugins/search` through `my-plugins/search/package.json` when the package exported it: `name` and `description` filled missing locale fields, and `icon` supplied the row image. A subpath is not a package, so the next release never reads a `package.json` for it. Its title and description come only from `my-plugins/search/locale/*.json`, and its image comes from the exported `my-plugins/search/icon` resource. Package-root plugins keep their `package.json` text and `icon`; when `icon` is omitted, an exported `./icon` supplies the image. Authors of packages that export subpath `package.json` files are affected.
+
+## Migration
+
+1. Move the subpath manifest's `name` and `description` into `meta.title` and `meta.description` of the subpath locale files, and export them, for example `"./search/locale/*.json": "./locale/search/*.json"`.
+2. Replace the subpath manifest's `icon` with an icon export and publish its target:
+
+   ```json
+   {
+     "exports": { "./search/icon": "./assets/search.svg" },
+     "files": ["assets/search.svg"]
+   }
+   ```
+
+3. Remove the `./search/package.json` export and its file.
+4. Run `pnpm run verify-package-meta` in a DSH checkout, or open Plugin Manager, and confirm the subpath row shows its title, description, and image.

package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.zh.md

@@ -0,0 +1,27 @@
+---
+kind: upgrade-guide
+description: "子路径插件不再从导出的 <子路径>/package.json 读取展示文本和图标，改用 locale meta 和 <子路径>/icon。"
+---
+
+# 子路径插件改读 `<子路径>/icon`，不再读 `<子路径>/package.json`
+
+[English](guide.md) | 中文
+
+## 变更
+
+在 v0.2.0-rc.2 中，插件管理页和设置页会在包导出 `my-plugins/search/package.json` 时，通过它读取 `my-plugins/search` 这样的子路径插件：`name` 和 `description` 补全缺失的 locale 字段，`icon` 提供行图片。子路径不是包，因此下一版本不再为它读取任何 `package.json`。其标题和描述只来自 `my-plugins/search/locale/*.json`，图片来自导出的 `my-plugins/search/icon` 资源。包根插件保留 `package.json` 文本和 `icon`；省略 `icon` 时，导出的 `./icon` 提供图片。受影响的是导出子路径 `package.json` 的包作者。
+
+## 迁移
+
+1. 将子路径清单的 `name` 和 `description` 移到子路径 locale 文件的 `meta.title` 和 `meta.description`，并导出这些文件，例如 `"./search/locale/*.json": "./locale/search/*.json"`。
+2. 用图标导出替换子路径清单的 `icon`，并发布其目标文件：
+
+   ```json
+   {
+     "exports": { "./search/icon": "./assets/search.svg" },
+     "files": ["assets/search.svg"]
+   }
+   ```
+
+3. 删除 `./search/package.json` 导出及其文件。
+4. 在 DSH 仓库中运行 `pnpm run verify-package-meta`，或打开插件管理页，确认子路径行显示标题、描述和图片。

package/references/official-docs/docs/user/develop/basic/config.i18n.yaml

@@ -1,6 +1,28 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for config.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/basic/config.md
-config.md: d935fc3f3b5b42c5b3fbd8d3b0d398a2608aead3
-config.zh.md: 642a413950e2d8deb8591bc688968607604c050d
+/plugin-configuration:
+  en: f605e6e8021b82ba
+  zh: 3f33c4b0afb3f249
+/plugin-configuration/define-the-config-type:
+  en: a351a086d890f148
+  zh: 385803dd9d671391
+/plugin-configuration/schema-validation:
+  en: 6a20f3351a1c3e47
+  zh: b5ae56917fcbca2c
+/plugin-configuration/design-principles:
+  en: 79717ddc9d714ad9
+  zh: 67240f8382bbe783
+/plugin-configuration/design-principles/do-not-hardcode-tunable-values:
+  en: da67063750a52b55
+  zh: bd2c5978e10b6f79
+/plugin-configuration/design-principles/fail-loudly-on-invalid-configuration:
+  en: 98a4ff7d959783bd
+  zh: cb1410360b03b7a7
+/plugin-configuration/work-with-hmr:
+  en: 939f750af6fefbd5
+  zh: 94fbb3a0d761f098
+/plugin-configuration/next-steps:
+  en: 1151bb8b59577519
+  zh: 47a95340df47d273

package/references/official-docs/docs/user/develop/basic/index.i18n.yaml

@@ -1,6 +1,37 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for index.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/basic/index.md
-index.md: 08199624e638aaf4a36b04446c39c228b2af6025
-index.zh.md: 2ea894079ffb3c5b8c4563fd535fe6e654861b1b
+/your-first-plugin:
+  en: 66684c875e13acbb
+  zh: 48b5444386cf714c
+/your-first-plugin/create-a-local-project:
+  en: 2a9ff85da3a6ea8b
+  zh: 9ac5daf1dd3e3b95
+/your-first-plugin/what-is-a-plugin:
+  en: 0bca3ea987fecb61
+  zh: b4d398b887da6648
+/your-first-plugin/create-the-plugin-file:
+  en: 80e4e9f139d4773e
+  zh: c045d63ec04a2f3d
+/your-first-plugin/register-it-in-cordis-yml:
+  en: 216e79287d237f2a
+  zh: 16e5e8ad2b1b9263
+/your-first-plugin/automatic-cleanup:
+  en: 0a1486714b9d67d7
+  zh: 544df97baa7a8c59
+/your-first-plugin/declare-dependencies:
+  en: da59e4c09e258f94
+  zh: 1b3ef70741eccb31
+/your-first-plugin/three-plugin-forms:
+  en: 155369321743b317
+  zh: e2e98be100be297b
+/your-first-plugin/three-plugin-forms/object-form:
+  en: d674c416f5b0fd14
+  zh: a2224f5fe6ceae73
+/your-first-plugin/three-plugin-forms/class-form:
+  en: 130f504f9ebacebd
+  zh: 4e91d3fa2555390d
+/your-first-plugin/next-steps:
+  en: 9836e246d8279c8b
+  zh: 681475e2251ba006

package/references/official-docs/docs/user/develop/basic/publish.i18n.yaml

@@ -1,6 +1,31 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for publish.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/basic/publish.md
-publish.md: 17b0cb80f9cf385773ae9e1f4d7061ec1df9c1a2
-publish.zh.md: 3cc65af58d34028a6bff03455451153e2c7f439b
+/package-and-install-a-plugin:
+  en: 0958da34d1ea9b49
+  zh: 66a024ba2f2faba2
+/package-and-install-a-plugin/two-concepts-two-manifests:
+  en: 341c334cee646f58
+  zh: 1ac8f40609a71123
+/package-and-install-a-plugin/two-concepts-two-manifests/the-bundle-manifest:
+  en: 1c59ba70e2d643ea
+  zh: 403667f567bcc77c
+/package-and-install-a-plugin/two-concepts-two-manifests/the-profile-manifest:
+  en: e2bd00d8de99da67
+  zh: e70b17787bdb53a5
+/package-and-install-a-plugin/install-into-a-profile:
+  en: 78baf6471bd6e82b
+  zh: 0453a7d35fd57399
+/package-and-install-a-plugin/the-loading-order:
+  en: 41ea3455ac8c7635
+  zh: 7fabf467485898a5
+/package-and-install-a-plugin/give-a-surface-bundle-its-own-command-line:
+  en: cda660c66cef28a6
+  zh: 0dcad683c4521f50
+/package-and-install-a-plugin/installing-from-github-the-build-script-catch:
+  en: 974a37cd652bdfc0
+  zh: db9dd766c8ad7182
+/package-and-install-a-plugin/next-steps:
+  en: 1914c4c5eeb1d913
+  zh: 6f20168ebc196239

package/references/official-docs/docs/user/develop/basic/publish.md

@@ -61,7 +61,7 @@ Create `hello-plugin/cordis.patch.yml`. The patch is a YAML array like the `--pa
       name: dsh-hello-plugin
 ```
 
-A package without the `dsh.bundle` declaration still installs, but only as a plain dependency: `dsh plugin` prints a warning and activates no layer. Use that package format for a library that plugin packages import rather than a plugin users enable.
+`patch` also accepts an ordered list of files, for example `["./base.patch.yml", "./web.patch.yml"]`; the launcher applies them in that order as one layer, and each file's relative plugin paths resolve beside that file. A package without the `dsh.bundle` declaration still installs, but only as a plain dependency: `dsh plugin` prints a warning and activates no layer. Use that package format for a library that plugin packages import rather than a plugin users enable.
 
 ### The profile manifest
 
@@ -100,6 +100,12 @@ The first use initializes the profile (with `@deepseek-ai/dsh-base` as its first
 }
 ```
 
+A linked checkout keeps its own `node_modules`. Declare dsh packages whose instances the plugin must share with the host under both `peerDependencies` and `devDependencies`, as the harness packages do. At that manifest's lookup position, peers present in the running dsh's runtime resolution use the installation's copy; the devDependency copy serves your type checker and standalone tests. Keep independently versioned third-party dependencies and stateless dsh utilities under `dependencies`.
+
+Ordinary linked imports follow Node's ancestor order and check each directory's current peer declarations. A nearer physical package wins before a higher peer declaration. A link target can lack `package.json`; ancestor peers still apply, even without a physical `node_modules` beside that manifest. Explicit `require.resolve(..., { paths })` is always native, including paths inside a profile. These rules are shared by npm, Desktop, and source launches; they do not invalidate loaded modules or validate peer version ranges. See the [resolution rules](../../../../.agents/notes/implemented/architecture/2026-09-19-profile-resolution-lookup-order.md) for scope and file-query behavior.
+
+Linking a broad checkout does not apply peer interception to the running installation's own package directories. Links whose targets stay inside the profile, including its pnpm store, remain profile-owned installation content rather than external linked roots. Overlapping external links do not change lookup order: each request still starts from its importer's directory.
+
 Verify the layer without booting, then boot:
 
 ```sh

package/references/official-docs/docs/user/develop/basic/publish.zh.md

@@ -61,7 +61,7 @@ export function apply() {
       name: dsh-hello-plugin
 ```
 
-没有 `dsh.bundle` 声明的包仍然可以安装，但只作为普通依赖：`dsh plugin` 会打印警告，且不激活任何层。如果一个库供插件包 import，而不是供用户启用，就使用这种包格式。
+`patch` 也接受一个有序的文件列表，例如 `["./base.patch.yml", "./web.patch.yml"]`；launcher 按该顺序把它们作为同一层应用，每个文件中的相对插件路径相对于该文件解析。没有 `dsh.bundle` 声明的包仍然可以安装，但只作为普通依赖：`dsh plugin` 会打印警告，且不激活任何层。如果一个库供插件包 import，而不是供用户启用，就使用这种包格式。
 
 ### profile manifest
 
@@ -100,6 +100,12 @@ dsh plugin --profile demo add ./hello-plugin
 }
 ```
 
+通过链接安装的 checkout 保留自己的 `node_modules`。与 harness 自身的包一样，需要与宿主共享实例的 dsh 包同时声明在 `peerDependencies` 与 `devDependencies` 中。在该 manifest 的查询位置，运行中 dsh 的 runtime resolution 已包含的 peer 使用安装中的副本；devDependency 副本供类型检查和独立测试使用。需要独立版本的第三方依赖和无状态 dsh 工具包放在 `dependencies` 中。
+
+普通 linked import 遵循 Node 的祖先顺序，检查每个目录当前的 peer 声明。更近的物理包先于更高的 peer 声明。link 目标可以没有 `package.json`，祖先 peer 仍可生效，即使该 manifest 旁没有物理 `node_modules`。显式 `require.resolve(..., { paths })` 始终是原生查询，包括指向 profile 内的路径。npm、Desktop 与源码启动共用这些规则；规则不会使已加载模块失效，也不校验 peer 版本范围。作用域和文件查询行为见[解析规则](../../../../.agents/notes/implemented/architecture/2026-09-19-profile-resolution-lookup-order.zh.md)。
+
+链接整个 checkout 不会对运行中安装自身的包目录应用 peer 拦截。目标仍位于 profile 内的链接（包括它的 pnpm store）属于 profile 自己安装的内容，不算外部 linked root。外部链接互相重叠也不改变查找顺序，每个请求仍从其 importer 所在目录开始。
+
 先不启动、只验证该层，再启动：
 
 ```sh

package/references/official-docs/docs/user/develop/basic/tool.i18n.yaml

@@ -1,6 +1,16 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for tool.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/basic/tool.md
-tool.md: aeed5cf0e742cdde33bdcb86bfac4de471ae2597
-tool.zh.md: 25538e42b7777fe3b05b361379a8bce70d6ec5f5
+/build-a-tool:
+  en: 7cc993f14da8bb11
+  zh: 32cc4de7310ace97
+/build-a-tool/create-the-tool-plugin:
+  en: ee66fee86af58d93
+  zh: ee7d157e69d01ae4
+/build-a-tool/run-and-call-the-tool:
+  en: 3bdae6640d729bfc
+  zh: d1e945ac53cbb467
+/build-a-tool/next-steps:
+  en: aba2c55a0ba557f9
+  zh: d4615e9e57c540bd

package/references/official-docs/docs/user/develop/framework/events.i18n.yaml

@@ -1,6 +1,46 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for events.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/framework/events.md
-events.md: c8c1bc753a2353f735f3f0d56f1c7e7f37b5be6d
-events.zh.md: 366c37ca4dc02a97d8ecb43d0425da141ec4253d
+/event-system:
+  en: 325f3d8726f52d9b
+  zh: 059d0c424e70feb7
+/event-system/basic-use:
+  en: 0f77f08250cc0b09
+  zh: 43c64f755c0de880
+/event-system/basic-use/listen-for-an-event:
+  en: 54c623cad1f04d3d
+  zh: 6c023e21df4cf6fd
+/event-system/basic-use/emit-an-event:
+  en: 5038c270c7a28863
+  zh: 01da169b2de7eed2
+/event-system/event-modes:
+  en: 95c09e39e3c07143
+  zh: d8ac8b6b65f092eb
+/event-system/event-modes/emit-broadcast:
+  en: 486df849733f05ff
+  zh: 1031ccfa266c13b7
+/event-system/event-modes/bail-short-circuit:
+  en: bae8dbcf78cb8217
+  zh: 9310977dbfe6f197
+/event-system/event-modes/serial-ordered-execution:
+  en: f8937683891b0c88
+  zh: 071feca4572f3f97
+/event-system/event-modes/waterfall-pipeline:
+  en: 64a336bbc72680a6
+  zh: 22fe42401ccf3dae
+/event-system/typed-events:
+  en: 18070de55501a230
+  zh: 0a34d22dc2662599
+/event-system/cordis-events-and-session-records:
+  en: 93102b27250eea35
+  zh: a97a0197f785a4aa
+/event-system/event-listeners-are-effects:
+  en: b7cc96734661caef
+  zh: 442ec0da611cf644
+/event-system/example-logging-plugin:
+  en: 9a79302d8fbec77c
+  zh: 58db4d48c4189ecb
+/event-system/next-steps:
+  en: 5f2a85db2ceb2c76
+  zh: b2507ab4e5e4afbf

package/references/official-docs/docs/user/develop/framework/index.i18n.yaml

@@ -1,6 +1,31 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for index.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/framework/index.md
-index.md: e0e9ef44c44c502f86cf1f682560bf72c4c71b13
-index.zh.md: 835fc0beeba5c1386347ec839e27474436ee54ca
+/plugins-and-lifecycle:
+  en: bc1c66795191727b
+  zh: e0666a674ca9921c
+/plugins-and-lifecycle/fiber-state-machine:
+  en: 66b51bb63094de1a
+  zh: 1d9f70611c9930ea
+/plugins-and-lifecycle/dependency-driven-loading:
+  en: 726a61e5c20db20f
+  zh: bd935ca733c30a15
+/plugins-and-lifecycle/automatic-cleanup:
+  en: e9bcc83f7a752d13
+  zh: c8df4bd5c23c8875
+/plugins-and-lifecycle/nested-contexts:
+  en: 2862ee99034d4423
+  zh: 7180298e3eff6524
+/plugins-and-lifecycle/dispose-semantics:
+  en: 1d23337dbcc4ae61
+  zh: ad003f8b5e325801
+/plugins-and-lifecycle/hot-replacement-hmr:
+  en: ca8495ec7369856c
+  zh: 54db7540aceb4b09
+/plugins-and-lifecycle/example-lifecycle:
+  en: e17160970571b690
+  zh: e49149cd82e77801
+/plugins-and-lifecycle/next-steps:
+  en: c245d538e75eef67
+  zh: 2e0ad34a2022aee3

package/references/official-docs/docs/user/develop/framework/service.i18n.yaml

@@ -1,6 +1,40 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for service.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/framework/service.md
-service.md: 1bcfe2e7690d9f93b871500660e0fbe1e3439b3f
-service.zh.md: b275c3d200fb50b1fab0e762d0154477c7ca4447
+/services-and-dependencies:
+  en: 03fe9a674163a484
+  zh: 45374665fa3bb8e3
+/services-and-dependencies/what-is-a-service:
+  en: fb06be7799d75fc0
+  zh: a59fdde61e557b24
+/services-and-dependencies/consume-a-service:
+  en: 6655ebf5abce2a59
+  zh: 0c91cac86768d63e
+/services-and-dependencies/provide-a-service:
+  en: ed1d04f41f64b6ce
+  zh: e0ddcb48bf3207c1
+/services-and-dependencies/provide-a-service/extend-service:
+  en: 3de1c24498e2c62f
+  zh: 57836dc4fa8d5c9a
+/services-and-dependencies/provide-a-service/declare-its-type:
+  en: fc1a29f46715ade5
+  zh: b1edb281077df180
+/services-and-dependencies/dependency-behavior:
+  en: 6678917fe40eea55
+  zh: 6227580b94a50855
+/services-and-dependencies/dependency-behavior/required-and-optional-dependencies:
+  en: 8a98845896146946
+  zh: 2383ad4ba5d2943d
+/services-and-dependencies/dependency-behavior/when-a-service-disappears:
+  en: 689e4b95dd320122
+  zh: 674ffba2733ec745
+/services-and-dependencies/service-isolation:
+  en: cc4be89f19cb7615
+  zh: e00e86a615f59003
+/services-and-dependencies/built-in-harness-services:
+  en: 07eb5bcc03955284
+  zh: 5eec0f3c6e01c0f9
+/services-and-dependencies/next-steps:
+  en: 1537e6955eb02c62
+  zh: 6430f34e63cfa533

package/references/official-docs/docs/user/develop/practice/dynamic-cordis.i18n.yaml

@@ -1,6 +1,10 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for dynamic-cordis.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/practice/dynamic-cordis.md
-dynamic-cordis.md: c9065027f3449355aa7a19e16672fa5812cab633
-dynamic-cordis.zh.md: 21d0a410d8e27931786a76b9383230a3d30004e5
+/configure-persistent-plugins-from-a-prompt:
+  en: 9503745724cbe962
+  zh: 985513234a4eda31
+/configure-persistent-plugins-from-a-prompt/connect-an-mcp-server:
+  en: f9fefda94ba8a005
+  zh: f1a9a977a0732fc0

package/references/official-docs/docs/user/develop/practice/index.i18n.yaml

@@ -1,6 +1,46 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for index.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/practice/index.md
-index.md: f7e10e14b78da0b2eb922ca0cafd3151d412efd1
-index.zh.md: 55ed3d3a93008f63a3e677de935c1de4be8872e5
+/three-role-capability-design:
+  en: 16d18db6160c9f61
+  zh: 823ea7e889390fab
+/three-role-capability-design/concept-reference:
+  en: 4e60abf663a9748f
+  zh: 3c80c65e519a51dd
+/three-role-capability-design/bash-example:
+  en: 548526d726675a23
+  zh: 51f065f8b23ea6f9
+/three-role-capability-design/benefits-of-the-split:
+  en: 026507583f272d46
+  zh: db37713da87a0e0e
+/three-role-capability-design/benefits-of-the-split/replace-providers:
+  en: 8f74a0bba164ce14
+  zh: e1869cf9b4dd284c
+/three-role-capability-design/benefits-of-the-split/evolve-independently:
+  en: bdf8329fe9d51537
+  zh: 416b7d81d8d30881
+/three-role-capability-design/benefits-of-the-split/decouple-dependencies:
+  en: 068feeea47c2ab74
+  zh: b53112b27f3bf82f
+/three-role-capability-design/tutorial-develop-a-three-role-capability:
+  en: 7bd3c99c2cdb06ad
+  zh: 264d321e9fa35dd8
+/three-role-capability-design/tutorial-develop-a-three-role-capability/step-1-write-the-service-definition:
+  en: 3940ce7faa9e33d6
+  zh: 71e5450d4f57e43a
+/three-role-capability-design/tutorial-develop-a-three-role-capability/step-2-write-a-service-provider:
+  en: 187b9fd73900f8ea
+  zh: 19d29d3fd9cea71a
+/three-role-capability-design/tutorial-develop-a-three-role-capability/step-3-write-a-consumer:
+  en: 604c3c3483a0db87
+  zh: 3069257db64d921c
+/three-role-capability-design/tutorial-develop-a-three-role-capability/compose-them-in-cordis-yml:
+  en: 7b5eae32911c61d3
+  zh: 8a7a03df8294a8c9
+/three-role-capability-design/design-points:
+  en: 5822e06c2cfce8e1
+  zh: aed13f901bb8891e
+/three-role-capability-design/next-steps:
+  en: 27b5fd93b6ab9e75
+  zh: 598c47f40a4ac25b

package/references/official-docs/docs/user/develop/practice/llm-adapter.i18n.yaml

@@ -1,6 +1,34 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for llm-adapter.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/develop/practice/llm-adapter.md
-llm-adapter.md: 7e30847cdf265bca8f55aac40f73686101ec185d
-llm-adapter.zh.md: 22a3c54f45088a41362c1a8e903d2441ed4fc93b
+/llm-adapters:
+  en: 3ed9fd352e2c3edd
+  zh: f575c12bb4409a7f
+/llm-adapters/overview:
+  en: 613076de2e5c7c2d
+  zh: 9df5bf6bca93267f
+/llm-adapters/minimal-implementation:
+  en: 2eeb1c65c2b1e67b
+  zh: 0dbee75ec52aa2d5
+/llm-adapters/streamchunk-protocol:
+  en: c5b80f3ab607300c
+  zh: 6d143add0d5fc44c
+/llm-adapters/streamchunk-protocol/key-rules:
+  en: c0138e6ba95197fa
+  zh: fc1e2b8047e08d2a
+/llm-adapters/generateoptions:
+  en: 5bdb364bd44239c4
+  zh: ca0f2854069aa134
+/llm-adapters/register-an-adapter:
+  en: 8e0ac8990c049f29
+  zh: f8c3de63ee4d6757
+/llm-adapters/use-it-from-cordis-yml:
+  en: b83c91da871dca8c
+  zh: d21046627e3cb0c4
+/llm-adapters/reference-implementations:
+  en: e05d4b0a901e8ef0
+  zh: 9516cebb3e5c3692
+/llm-adapters/error-handling:
+  en: d54065c52caf7910
+  zh: 79b3ebc22a38286d

package/references/official-docs/docs/user/develop/practice/llm-adapter.md

@@ -146,7 +146,7 @@ The first argument lists provider routes handled by the adapter. `GenerateOption
 
 The repository contains complete implementations:
 
-- `packages/llm/llm-deepseek/` — DeepSeek API adapter using the OpenAI-compatible format
+- `packages/llm/llm-deepseek/` — DeepSeek adapter using the Messages API
 - `packages/llm/llm-pi-ai/` — Pi AI adapter using a different API format
 
 Compare the two shipped adapters to see the same harness contract implemented over different provider SDKs.

package/references/official-docs/docs/user/develop/practice/llm-adapter.zh.md

@@ -146,7 +146,7 @@ ctx.llm.registerAdapter(['my-provider'], adapter)
 
 仓库中包含以下两个完整实现：
 
-- `packages/llm/llm-deepseek/` — DeepSeek API 适配器（OpenAI 兼容格式）
+- `packages/llm/llm-deepseek/` — 使用 Messages API 的 DeepSeek 适配器
 - `packages/llm/llm-pi-ai/` — Pi AI 适配器（不同的 API 格式）
 
 对比这两个已交付的适配器，可以看到同一套 harness 契约如何在不同提供方 SDK 之上实现。

package/references/official-docs/docs/user/guide/github-review.i18n.yaml

@@ -1,6 +1,25 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for github-review.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/user/guide/github-review.md
-github-review.md: 69c61df95ce7d461b8a120cf6ae4a568ce201f78
-github-review.zh.md: 114aa6546d2366cf34a4a2d3057e9a26e4c43c96
+/create-review-sessions-from-github-webhooks:
+  en: d7326712d79158d8
+  zh: 02102a8b9e749928
+/create-review-sessions-from-github-webhooks/prerequisites:
+  en: 6784d85f90231608
+  zh: 3e62e9cadfdc2c18
+/create-review-sessions-from-github-webhooks/start-dsh:
+  en: 5751931f5c89b1c0
+  zh: 867950515a152d47
+/create-review-sessions-from-github-webhooks/expose-the-dedicated-endpoint:
+  en: f18a2969b3082da9
+  zh: 87d3d0e58d25a62f
+/create-review-sessions-from-github-webhooks/rule-behavior:
+  en: e90b3061a15fdedc
+  zh: a8e9549e732314f6
+/create-review-sessions-from-github-webhooks/programmatic-extensions:
+  en: d448fc3e440a0ec6
+  zh: 18568898933ef054
+/create-review-sessions-from-github-webhooks/delivery-semantics:
+  en: 8d098eeb5a62a4ba
+  zh: cfc7f2759ebf129d