dsh-plugin-guide 0.3.42 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (892) hide show
  1. package/LICENSE +0 -0
  2. package/NOTICE.md +8 -23
  3. package/PRIVACY.md +11 -0
  4. package/README-zh.md +45 -420
  5. package/README.md +50 -435
  6. package/SKILL.md +41 -99
  7. package/STANDARDS.md +14 -5
  8. package/cordis.patch.yml +0 -0
  9. package/docs/boost.md +75 -0
  10. package/docs/entry.md +60 -0
  11. package/docs/flow.md +57 -0
  12. package/docs/levels.md +76 -0
  13. package/icon.svg +0 -0
  14. package/index.js +7 -24
  15. package/locale/en.json +2 -2
  16. package/locale/zh.json +2 -2
  17. package/package.json +29 -78
  18. package/README-es.md +0 -455
  19. package/README-hi.md +0 -455
  20. package/README-pt.md +0 -455
  21. package/bin/dsh-plugin-dev.js +0 -6
  22. package/data/facts.json +0 -66
  23. package/data/seams/index.json +0 -397
  24. package/data/standards.json +0 -300
  25. package/dist/dsh-plugin-dev.js +0 -2261
  26. package/guide/choosing-a-plugin.md +0 -412
  27. package/guide/choosing-a-plugin.zh-CN.md +0 -414
  28. package/guide/family-toolchain.md +0 -260
  29. package/guide/links.md +0 -112
  30. package/guide/migration-0.2.md +0 -275
  31. package/guide/plugin-dev-guide.md +0 -629
  32. package/guide/quick-reference.es.md +0 -185
  33. package/guide/quick-reference.hi.md +0 -185
  34. package/guide/quick-reference.md +0 -185
  35. package/guide/quick-reference.pt.md +0 -185
  36. package/guide/quick-reference.zh-CN.md +0 -184
  37. package/guide/release-engineering.md +0 -198
  38. package/guide/release-engineering.zh-CN.md +0 -198
  39. package/guide/standards.md +0 -141
  40. package/guide/standards.zh-CN.md +0 -141
  41. package/guide/unfixed-issues.md +0 -155
  42. package/guide/version-matrix.md +0 -309
  43. package/guide/when-to-retire-a-plugin.md +0 -127
  44. package/guide/when-to-retire-a-plugin.zh-CN.md +0 -127
  45. package/index.d.ts +0 -32
  46. package/references/cli-positioning-decision.md +0 -78
  47. package/references/community-ecosystem.md +0 -202
  48. package/references/community-repo-deep-dive.md +0 -660
  49. package/references/cordis-paper-and-community.md +0 -326
  50. package/references/dev-resource-landscape.md +0 -294
  51. package/references/harness-repo.md +0 -673
  52. package/references/mirror-scope-decision.md +0 -79
  53. package/references/official-docs/AGENTS.md +0 -185
  54. package/references/official-docs/BENCHMARK.md +0 -3
  55. package/references/official-docs/CLAUDE.md +0 -1
  56. package/references/official-docs/CONTRIBUTING.i18n.yaml +0 -7
  57. package/references/official-docs/CONTRIBUTING.md +0 -23
  58. package/references/official-docs/CONTRIBUTING.zh.md +0 -23
  59. package/references/official-docs/LICENSE +0 -21
  60. package/references/official-docs/README.i18n.yaml +0 -34
  61. package/references/official-docs/README.md +0 -35
  62. package/references/official-docs/README.zh.md +0 -96
  63. package/references/official-docs/SNAPSHOT.md +0 -14
  64. package/references/official-docs/THIRD_PARTY_NOTICES.md +0 -304
  65. package/references/official-docs/docs/AGENTS.md +0 -77
  66. package/references/official-docs/docs/agent-lifecycle.i18n.yaml +0 -10
  67. package/references/official-docs/docs/agent-lifecycle.md +0 -91
  68. package/references/official-docs/docs/agent-lifecycle.zh.md +0 -93
  69. package/references/official-docs/docs/api-gateway.i18n.yaml +0 -31
  70. package/references/official-docs/docs/api-gateway.md +0 -172
  71. package/references/official-docs/docs/api-gateway.zh.md +0 -178
  72. package/references/official-docs/docs/architecture.i18n.yaml +0 -37
  73. package/references/official-docs/docs/architecture.md +0 -165
  74. package/references/official-docs/docs/architecture.zh.md +0 -169
  75. package/references/official-docs/docs/capability-seams.i18n.yaml +0 -10
  76. package/references/official-docs/docs/capability-seams.md +0 -714
  77. package/references/official-docs/docs/capability-seams.zh.md +0 -716
  78. package/references/official-docs/docs/cli-help.i18n.yaml +0 -34
  79. package/references/official-docs/docs/cli-help.md +0 -203
  80. package/references/official-docs/docs/cli-help.zh.md +0 -205
  81. package/references/official-docs/docs/config-catalog.i18n.yaml +0 -19
  82. package/references/official-docs/docs/config-catalog.md +0 -4801
  83. package/references/official-docs/docs/config-catalog.zh.md +0 -4803
  84. package/references/official-docs/docs/cookbook/adding-a-package.i18n.yaml +0 -28
  85. package/references/official-docs/docs/cookbook/adding-a-package.md +0 -170
  86. package/references/official-docs/docs/cookbook/adding-a-package.zh.md +0 -170
  87. package/references/official-docs/docs/cookbook/adding-a-plugin-preview.i18n.yaml +0 -22
  88. package/references/official-docs/docs/cookbook/adding-a-plugin-preview.md +0 -52
  89. package/references/official-docs/docs/cookbook/adding-a-plugin-preview.zh.md +0 -52
  90. package/references/official-docs/docs/cookbook/adding-a-remote-api.i18n.yaml +0 -25
  91. package/references/official-docs/docs/cookbook/adding-a-remote-api.md +0 -197
  92. package/references/official-docs/docs/cookbook/adding-a-remote-api.zh.md +0 -197
  93. package/references/official-docs/docs/cookbook/adding-a-session-format-version.i18n.yaml +0 -40
  94. package/references/official-docs/docs/cookbook/adding-a-session-format-version.md +0 -153
  95. package/references/official-docs/docs/cookbook/adding-a-session-format-version.zh.md +0 -153
  96. package/references/official-docs/docs/cookbook/adding-a-settings-card.i18n.yaml +0 -22
  97. package/references/official-docs/docs/cookbook/adding-a-settings-card.md +0 -72
  98. package/references/official-docs/docs/cookbook/adding-a-settings-card.zh.md +0 -72
  99. package/references/official-docs/docs/cookbook/adding-a-tool.i18n.yaml +0 -31
  100. package/references/official-docs/docs/cookbook/adding-a-tool.md +0 -101
  101. package/references/official-docs/docs/cookbook/adding-a-tool.zh.md +0 -103
  102. package/references/official-docs/docs/cookbook/adding-a-vendored-package.i18n.yaml +0 -19
  103. package/references/official-docs/docs/cookbook/adding-a-vendored-package.md +0 -59
  104. package/references/official-docs/docs/cookbook/adding-a-vendored-package.zh.md +0 -59
  105. package/references/official-docs/docs/cookbook/adding-an-llm-adapter.i18n.yaml +0 -19
  106. package/references/official-docs/docs/cookbook/adding-an-llm-adapter.md +0 -43
  107. package/references/official-docs/docs/cookbook/adding-an-llm-adapter.zh.md +0 -43
  108. package/references/official-docs/docs/cookbook/extension-cookbook.i18n.yaml +0 -25
  109. package/references/official-docs/docs/cookbook/extension-cookbook.md +0 -132
  110. package/references/official-docs/docs/cookbook/extension-cookbook.zh.md +0 -136
  111. package/references/official-docs/docs/cookbook/maintaining-dsh-code-review.i18n.yaml +0 -22
  112. package/references/official-docs/docs/cookbook/maintaining-dsh-code-review.md +0 -64
  113. package/references/official-docs/docs/cookbook/maintaining-dsh-code-review.zh.md +0 -64
  114. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.i18n.yaml +0 -16
  115. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.md +0 -32
  116. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.zh.md +0 -32
  117. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.i18n.yaml +0 -31
  118. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.md +0 -122
  119. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.zh.md +0 -122
  120. package/references/official-docs/docs/cordis-api/context.i18n.yaml +0 -73
  121. package/references/official-docs/docs/cordis-api/context.md +0 -364
  122. package/references/official-docs/docs/cordis-api/context.zh.md +0 -366
  123. package/references/official-docs/docs/cordis-api/events.i18n.yaml +0 -37
  124. package/references/official-docs/docs/cordis-api/events.md +0 -207
  125. package/references/official-docs/docs/cordis-api/events.zh.md +0 -209
  126. package/references/official-docs/docs/cordis-api/fiber.i18n.yaml +0 -76
  127. package/references/official-docs/docs/cordis-api/fiber.md +0 -375
  128. package/references/official-docs/docs/cordis-api/fiber.zh.md +0 -377
  129. package/references/official-docs/docs/cordis-api/inherited.md +0 -38
  130. package/references/official-docs/docs/cordis-api/registry.i18n.yaml +0 -22
  131. package/references/official-docs/docs/cordis-api/registry.md +0 -152
  132. package/references/official-docs/docs/cordis-api/registry.zh.md +0 -154
  133. package/references/official-docs/docs/cordis-api/service.i18n.yaml +0 -37
  134. package/references/official-docs/docs/cordis-api/service.md +0 -102
  135. package/references/official-docs/docs/cordis-api/service.zh.md +0 -104
  136. package/references/official-docs/docs/cordis-primer.i18n.yaml +0 -22
  137. package/references/official-docs/docs/cordis-primer.md +0 -45
  138. package/references/official-docs/docs/cordis-primer.zh.md +0 -51
  139. package/references/official-docs/docs/cordis-tutorial/01-first-plugin.i18n.yaml +0 -22
  140. package/references/official-docs/docs/cordis-tutorial/01-first-plugin.md +0 -95
  141. package/references/official-docs/docs/cordis-tutorial/01-first-plugin.zh.md +0 -95
  142. package/references/official-docs/docs/cordis-tutorial/02-lifecycle-and-effects.i18n.yaml +0 -16
  143. package/references/official-docs/docs/cordis-tutorial/02-lifecycle-and-effects.md +0 -98
  144. package/references/official-docs/docs/cordis-tutorial/02-lifecycle-and-effects.zh.md +0 -98
  145. package/references/official-docs/docs/cordis-tutorial/03-services.i18n.yaml +0 -22
  146. package/references/official-docs/docs/cordis-tutorial/03-services.md +0 -98
  147. package/references/official-docs/docs/cordis-tutorial/03-services.zh.md +0 -98
  148. package/references/official-docs/docs/cordis-tutorial/04-events.i18n.yaml +0 -16
  149. package/references/official-docs/docs/cordis-tutorial/04-events.md +0 -144
  150. package/references/official-docs/docs/cordis-tutorial/04-events.zh.md +0 -144
  151. package/references/official-docs/docs/cordis-tutorial/05-config.i18n.yaml +0 -19
  152. package/references/official-docs/docs/cordis-tutorial/05-config.md +0 -111
  153. package/references/official-docs/docs/cordis-tutorial/05-config.zh.md +0 -111
  154. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.i18n.yaml +0 -16
  155. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.md +0 -113
  156. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.zh.md +0 -113
  157. package/references/official-docs/docs/cordis-tutorial/07-into-the-harness.i18n.yaml +0 -19
  158. package/references/official-docs/docs/cordis-tutorial/07-into-the-harness.md +0 -108
  159. package/references/official-docs/docs/cordis-tutorial/07-into-the-harness.zh.md +0 -108
  160. package/references/official-docs/docs/cordis-tutorial/index.i18n.yaml +0 -16
  161. package/references/official-docs/docs/cordis-tutorial/index.md +0 -60
  162. package/references/official-docs/docs/cordis-tutorial/index.zh.md +0 -62
  163. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.i18n.yaml +0 -34
  164. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.md +0 -162
  165. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.zh.md +0 -162
  166. package/references/official-docs/docs/defensive-patterns/README.i18n.yaml +0 -10
  167. package/references/official-docs/docs/defensive-patterns/README.md +0 -25
  168. package/references/official-docs/docs/defensive-patterns/README.zh.md +0 -27
  169. package/references/official-docs/docs/defensive-patterns/client-components.i18n.yaml +0 -46
  170. package/references/official-docs/docs/defensive-patterns/client-components.md +0 -493
  171. package/references/official-docs/docs/defensive-patterns/client-components.zh.md +0 -495
  172. package/references/official-docs/docs/defensive-patterns/conversation-and-session.i18n.yaml +0 -31
  173. package/references/official-docs/docs/defensive-patterns/conversation-and-session.md +0 -316
  174. package/references/official-docs/docs/defensive-patterns/conversation-and-session.zh.md +0 -316
  175. package/references/official-docs/docs/defensive-patterns/general.i18n.yaml +0 -52
  176. package/references/official-docs/docs/defensive-patterns/general.md +0 -222
  177. package/references/official-docs/docs/defensive-patterns/general.zh.md +0 -252
  178. package/references/official-docs/docs/defensive-patterns/package-surface.i18n.yaml +0 -28
  179. package/references/official-docs/docs/defensive-patterns/package-surface.md +0 -231
  180. package/references/official-docs/docs/defensive-patterns/package-surface.zh.md +0 -231
  181. package/references/official-docs/docs/defensive-patterns/remote-and-api.i18n.yaml +0 -16
  182. package/references/official-docs/docs/defensive-patterns/remote-and-api.md +0 -115
  183. package/references/official-docs/docs/defensive-patterns/remote-and-api.zh.md +0 -115
  184. package/references/official-docs/docs/dependency-catalog.json +0 -7312
  185. package/references/official-docs/docs/development.i18n.yaml +0 -49
  186. package/references/official-docs/docs/development.md +0 -214
  187. package/references/official-docs/docs/development.zh.md +0 -221
  188. package/references/official-docs/docs/event-producer-consumer.i18n.yaml +0 -13
  189. package/references/official-docs/docs/event-producer-consumer.md +0 -110
  190. package/references/official-docs/docs/event-producer-consumer.zh.md +0 -112
  191. package/references/official-docs/docs/experimental-persistence-catalog.i18n.yaml +0 -10
  192. package/references/official-docs/docs/experimental-persistence-catalog.md +0 -17
  193. package/references/official-docs/docs/experimental-persistence-catalog.zh.md +0 -17
  194. package/references/official-docs/docs/glossary.i18n.yaml +0 -25
  195. package/references/official-docs/docs/glossary.md +0 -46
  196. package/references/official-docs/docs/glossary.zh.md +0 -46
  197. package/references/official-docs/docs/graph-atlas.i18n.yaml +0 -10
  198. package/references/official-docs/docs/graph-atlas.md +0 -22
  199. package/references/official-docs/docs/graph-atlas.zh.md +0 -24
  200. package/references/official-docs/docs/i18n/README.i18n.yaml +0 -19
  201. package/references/official-docs/docs/i18n/README.md +0 -69
  202. package/references/official-docs/docs/i18n/README.zh.md +0 -71
  203. package/references/official-docs/docs/i18n/style-samples.md +0 -87
  204. package/references/official-docs/docs/i18n/terminology.md +0 -215
  205. package/references/official-docs/docs/i18n/translation-prompt.md +0 -263
  206. package/references/official-docs/docs/i18n/translation-rules.i18n.yaml +0 -28
  207. package/references/official-docs/docs/i18n/translation-rules.md +0 -69
  208. package/references/official-docs/docs/i18n/translation-rules.zh.md +0 -69
  209. package/references/official-docs/docs/module-graph.i18n.yaml +0 -10
  210. package/references/official-docs/docs/module-graph.md +0 -1776
  211. package/references/official-docs/docs/module-graph.zh.md +0 -1778
  212. package/references/official-docs/docs/persistence-catalog.i18n.yaml +0 -2152
  213. package/references/official-docs/docs/persistence-catalog.md +0 -9140
  214. package/references/official-docs/docs/persistence-catalog.zh.md +0 -9142
  215. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.i18n.yaml +0 -28
  216. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.md +0 -280
  217. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.schema.json +0 -13557
  218. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.zh.md +0 -280
  219. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.i18n.yaml +0 -28
  220. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.md +0 -52
  221. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.schema.json +0 -910
  222. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.zh.md +0 -52
  223. package/references/official-docs/docs/persistence-changes/2026-09-13-working-directory.i18n.yaml +0 -28
  224. package/references/official-docs/docs/persistence-changes/2026-09-13-working-directory.md +0 -48
  225. package/references/official-docs/docs/persistence-changes/2026-09-13-working-directory.schema.json +0 -76
  226. package/references/official-docs/docs/persistence-changes/2026-09-13-working-directory.zh.md +0 -48
  227. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.i18n.yaml +0 -28
  228. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.md +0 -96
  229. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.schema.json +0 -8478
  230. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.zh.md +0 -96
  231. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.i18n.yaml +0 -28
  232. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.md +0 -48
  233. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.schema.json +0 -72
  234. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.zh.md +0 -48
  235. package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.i18n.yaml +0 -28
  236. package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.md +0 -120
  237. package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.schema.json +0 -16212
  238. package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.zh.md +0 -120
  239. package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.i18n.yaml +0 -28
  240. package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.md +0 -48
  241. package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.schema.json +0 -302
  242. package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.zh.md +0 -48
  243. package/references/official-docs/docs/persistence-changes/2026-09-19-external-subagent-catalog.i18n.yaml +0 -28
  244. package/references/official-docs/docs/persistence-changes/2026-09-19-external-subagent-catalog.md +0 -48
  245. package/references/official-docs/docs/persistence-changes/2026-09-19-external-subagent-catalog.schema.json +0 -290
  246. package/references/official-docs/docs/persistence-changes/2026-09-19-external-subagent-catalog.zh.md +0 -48
  247. package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.i18n.yaml +0 -28
  248. package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.md +0 -48
  249. package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.schema.json +0 -250
  250. package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.zh.md +0 -48
  251. package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.i18n.yaml +0 -28
  252. package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.md +0 -60
  253. package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.schema.json +0 -11405
  254. package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.zh.md +0 -60
  255. package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.i18n.yaml +0 -28
  256. package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.md +0 -52
  257. package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.schema.json +0 -297
  258. package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.zh.md +0 -52
  259. package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.i18n.yaml +0 -28
  260. package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.md +0 -48
  261. package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.schema.json +0 -457
  262. package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.zh.md +0 -48
  263. package/references/official-docs/docs/persistence-changes/2026-10-05-working-directory-attribution.i18n.yaml +0 -28
  264. package/references/official-docs/docs/persistence-changes/2026-10-05-working-directory-attribution.md +0 -60
  265. package/references/official-docs/docs/persistence-changes/2026-10-05-working-directory-attribution.schema.json +0 -11474
  266. package/references/official-docs/docs/persistence-changes/2026-10-05-working-directory-attribution.zh.md +0 -60
  267. package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.i18n.yaml +0 -28
  268. package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.md +0 -48
  269. package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.schema.json +0 -2990
  270. package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.zh.md +0 -48
  271. package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.i18n.yaml +0 -28
  272. package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.md +0 -48
  273. package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.schema.json +0 -231
  274. package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.zh.md +0 -48
  275. package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.i18n.yaml +0 -28
  276. package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.md +0 -60
  277. package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.schema.json +0 -11559
  278. package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.zh.md +0 -60
  279. package/references/official-docs/docs/persistence-changes/README.i18n.yaml +0 -28
  280. package/references/official-docs/docs/persistence-changes/README.md +0 -90
  281. package/references/official-docs/docs/persistence-changes/README.zh.md +0 -90
  282. package/references/official-docs/docs/persistence-changes/finalized/v4.json +0 -379
  283. package/references/official-docs/docs/persistence-changes/historical-formats/README.i18n.yaml +0 -28
  284. package/references/official-docs/docs/persistence-changes/historical-formats/README.md +0 -75
  285. package/references/official-docs/docs/persistence-changes/historical-formats/README.zh.md +0 -75
  286. package/references/official-docs/docs/persistence-changes/historical-formats/v0.i18n.yaml +0 -1285
  287. package/references/official-docs/docs/persistence-changes/historical-formats/v0.md +0 -5105
  288. package/references/official-docs/docs/persistence-changes/historical-formats/v0.schema.json +0 -49308
  289. package/references/official-docs/docs/persistence-changes/historical-formats/v0.zh.md +0 -5105
  290. package/references/official-docs/docs/persistence-changes/historical-formats/v1.i18n.yaml +0 -1285
  291. package/references/official-docs/docs/persistence-changes/historical-formats/v1.md +0 -5107
  292. package/references/official-docs/docs/persistence-changes/historical-formats/v1.schema.json +0 -49411
  293. package/references/official-docs/docs/persistence-changes/historical-formats/v1.zh.md +0 -5107
  294. package/references/official-docs/docs/persistence-changes/historical-formats/v2.i18n.yaml +0 -1345
  295. package/references/official-docs/docs/persistence-changes/historical-formats/v2.md +0 -5362
  296. package/references/official-docs/docs/persistence-changes/historical-formats/v2.schema.json +0 -56466
  297. package/references/official-docs/docs/persistence-changes/historical-formats/v2.zh.md +0 -5362
  298. package/references/official-docs/docs/persistence-changes/historical-formats/v3.i18n.yaml +0 -1441
  299. package/references/official-docs/docs/persistence-changes/historical-formats/v3.md +0 -5634
  300. package/references/official-docs/docs/persistence-changes/historical-formats/v3.schema.json +0 -61307
  301. package/references/official-docs/docs/persistence-changes/historical-formats/v3.zh.md +0 -5634
  302. package/references/official-docs/docs/persistence-changes/releases/README.i18n.yaml +0 -31
  303. package/references/official-docs/docs/persistence-changes/releases/README.md +0 -103
  304. package/references/official-docs/docs/persistence-changes/releases/README.zh.md +0 -103
  305. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.i18n.yaml +0 -31
  306. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.md +0 -201
  307. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.schema.json +0 -39868
  308. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.zh.md +0 -201
  309. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.i18n.yaml +0 -31
  310. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.md +0 -261
  311. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.schema.json +0 -43342
  312. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.zh.md +0 -261
  313. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.i18n.yaml +0 -31
  314. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.md +0 -126
  315. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.schema.json +0 -19452
  316. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.zh.md +0 -126
  317. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.i18n.yaml +0 -31
  318. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.md +0 -75
  319. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.schema.json +0 -5
  320. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.zh.md +0 -75
  321. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.i18n.yaml +0 -31
  322. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.md +0 -75
  323. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.schema.json +0 -5
  324. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.zh.md +0 -75
  325. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.i18n.yaml +0 -31
  326. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.md +0 -75
  327. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.schema.json +0 -5
  328. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.zh.md +0 -75
  329. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.i18n.yaml +0 -31
  330. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.md +0 -75
  331. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.schema.json +0 -5
  332. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.zh.md +0 -75
  333. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.i18n.yaml +0 -31
  334. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.md +0 -75
  335. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.schema.json +0 -5
  336. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.zh.md +0 -75
  337. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.i18n.yaml +0 -31
  338. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.md +0 -75
  339. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.schema.json +0 -5
  340. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.zh.md +0 -75
  341. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.i18n.yaml +0 -31
  342. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.md +0 -75
  343. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.schema.json +0 -5
  344. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.zh.md +0 -75
  345. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.i18n.yaml +0 -31
  346. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.md +0 -82
  347. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.schema.json +0 -5320
  348. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.zh.md +0 -82
  349. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.i18n.yaml +0 -31
  350. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.md +0 -110
  351. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.schema.json +0 -21258
  352. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.zh.md +0 -110
  353. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.i18n.yaml +0 -31
  354. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.md +0 -82
  355. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.schema.json +0 -417
  356. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.zh.md +0 -82
  357. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.i18n.yaml +0 -31
  358. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.md +0 -119
  359. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.schema.json +0 -29672
  360. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.zh.md +0 -119
  361. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.i18n.yaml +0 -31
  362. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.md +0 -295
  363. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.schema.json +0 -48429
  364. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.zh.md +0 -295
  365. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.i18n.yaml +0 -31
  366. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.md +0 -286
  367. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.schema.json +0 -49347
  368. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.zh.md +0 -286
  369. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.i18n.yaml +0 -31
  370. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.md +0 -75
  371. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.schema.json +0 -5
  372. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.zh.md +0 -75
  373. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.i18n.yaml +0 -31
  374. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.md +0 -95
  375. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.schema.json +0 -17642
  376. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.zh.md +0 -95
  377. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.i18n.yaml +0 -31
  378. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.md +0 -75
  379. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.schema.json +0 -5
  380. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.zh.md +0 -75
  381. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.i18n.yaml +0 -31
  382. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.md +0 -75
  383. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.schema.json +0 -5
  384. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.zh.md +0 -75
  385. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.i18n.yaml +0 -31
  386. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.md +0 -154
  387. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.schema.json +0 -38678
  388. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.zh.md +0 -154
  389. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.i18n.yaml +0 -31
  390. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.md +0 -86
  391. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.schema.json +0 -783
  392. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.zh.md +0 -86
  393. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.i18n.yaml +0 -31
  394. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.md +0 -139
  395. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.schema.json +0 -24597
  396. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.zh.md +0 -139
  397. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.i18n.yaml +0 -31
  398. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.md +0 -95
  399. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.schema.json +0 -2132
  400. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.zh.md +0 -95
  401. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.i18n.yaml +0 -31
  402. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.md +0 -75
  403. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.schema.json +0 -5
  404. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.zh.md +0 -75
  405. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.i18n.yaml +0 -31
  406. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.md +0 -75
  407. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.schema.json +0 -5
  408. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.zh.md +0 -75
  409. package/references/official-docs/docs/persistence-changes/releases/manifest.json +0 -162
  410. package/references/official-docs/docs/persistence-schema.json +0 -26177
  411. package/references/official-docs/docs/postmortem/0001-acp-default-export-drops-inject.i18n.yaml +0 -34
  412. package/references/official-docs/docs/postmortem/0001-acp-default-export-drops-inject.md +0 -113
  413. package/references/official-docs/docs/postmortem/0001-acp-default-export-drops-inject.zh.md +0 -113
  414. package/references/official-docs/docs/postmortem/0002-js-expression-disabled-filesystem-tools.i18n.yaml +0 -28
  415. package/references/official-docs/docs/postmortem/0002-js-expression-disabled-filesystem-tools.md +0 -47
  416. package/references/official-docs/docs/postmortem/0002-js-expression-disabled-filesystem-tools.zh.md +0 -47
  417. package/references/official-docs/docs/postmortem/0003-web-agent-gui-feedback-loop.i18n.yaml +0 -28
  418. package/references/official-docs/docs/postmortem/0003-web-agent-gui-feedback-loop.md +0 -53
  419. package/references/official-docs/docs/postmortem/0003-web-agent-gui-feedback-loop.zh.md +0 -53
  420. package/references/official-docs/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.i18n.yaml +0 -28
  421. package/references/official-docs/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.md +0 -55
  422. package/references/official-docs/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.zh.md +0 -55
  423. package/references/official-docs/docs/postmortem/README.i18n.yaml +0 -7
  424. package/references/official-docs/docs/postmortem/README.md +0 -18
  425. package/references/official-docs/docs/postmortem/README.zh.md +0 -18
  426. package/references/official-docs/docs/rescope.i18n.yaml +0 -19
  427. package/references/official-docs/docs/rescope.md +0 -53
  428. package/references/official-docs/docs/rescope.zh.md +0 -53
  429. package/references/official-docs/docs/session-format-status.i18n.yaml +0 -28
  430. package/references/official-docs/docs/session-format-status.md +0 -63
  431. package/references/official-docs/docs/session-format-status.zh.md +0 -63
  432. package/references/official-docs/docs/subsystems/README.i18n.yaml +0 -7
  433. package/references/official-docs/docs/subsystems/README.md +0 -76
  434. package/references/official-docs/docs/subsystems/README.zh.md +0 -76
  435. package/references/official-docs/docs/subsystems/agent-team.i18n.yaml +0 -22
  436. package/references/official-docs/docs/subsystems/agent-team.md +0 -231
  437. package/references/official-docs/docs/subsystems/agent-team.zh.md +0 -231
  438. package/references/official-docs/docs/subsystems/approval.i18n.yaml +0 -19
  439. package/references/official-docs/docs/subsystems/approval.md +0 -170
  440. package/references/official-docs/docs/subsystems/approval.zh.md +0 -170
  441. package/references/official-docs/docs/subsystems/attachment.i18n.yaml +0 -13
  442. package/references/official-docs/docs/subsystems/attachment.md +0 -361
  443. package/references/official-docs/docs/subsystems/attachment.zh.md +0 -361
  444. package/references/official-docs/docs/subsystems/boot.i18n.yaml +0 -16
  445. package/references/official-docs/docs/subsystems/boot.md +0 -447
  446. package/references/official-docs/docs/subsystems/boot.zh.md +0 -447
  447. package/references/official-docs/docs/subsystems/browser-use.i18n.yaml +0 -19
  448. package/references/official-docs/docs/subsystems/browser-use.md +0 -67
  449. package/references/official-docs/docs/subsystems/browser-use.zh.md +0 -67
  450. package/references/official-docs/docs/subsystems/claude-code-mods.i18n.yaml +0 -28
  451. package/references/official-docs/docs/subsystems/claude-code-mods.md +0 -146
  452. package/references/official-docs/docs/subsystems/claude-code-mods.zh.md +0 -146
  453. package/references/official-docs/docs/subsystems/client-modules.i18n.yaml +0 -19
  454. package/references/official-docs/docs/subsystems/client-modules.md +0 -198
  455. package/references/official-docs/docs/subsystems/client-modules.zh.md +0 -198
  456. package/references/official-docs/docs/subsystems/client-resources.i18n.yaml +0 -22
  457. package/references/official-docs/docs/subsystems/client-resources.md +0 -92
  458. package/references/official-docs/docs/subsystems/client-resources.zh.md +0 -92
  459. package/references/official-docs/docs/subsystems/commands.i18n.yaml +0 -19
  460. package/references/official-docs/docs/subsystems/commands.md +0 -223
  461. package/references/official-docs/docs/subsystems/commands.zh.md +0 -223
  462. package/references/official-docs/docs/subsystems/compaction.i18n.yaml +0 -22
  463. package/references/official-docs/docs/subsystems/compaction.md +0 -284
  464. package/references/official-docs/docs/subsystems/compaction.zh.md +0 -284
  465. package/references/official-docs/docs/subsystems/computer-use.i18n.yaml +0 -16
  466. package/references/official-docs/docs/subsystems/computer-use.md +0 -59
  467. package/references/official-docs/docs/subsystems/computer-use.zh.md +0 -59
  468. package/references/official-docs/docs/subsystems/conversation.i18n.yaml +0 -31
  469. package/references/official-docs/docs/subsystems/conversation.md +0 -301
  470. package/references/official-docs/docs/subsystems/conversation.zh.md +0 -303
  471. package/references/official-docs/docs/subsystems/core.i18n.yaml +0 -37
  472. package/references/official-docs/docs/subsystems/core.md +0 -1113
  473. package/references/official-docs/docs/subsystems/core.zh.md +0 -1125
  474. package/references/official-docs/docs/subsystems/credentials.i18n.yaml +0 -25
  475. package/references/official-docs/docs/subsystems/credentials.md +0 -493
  476. package/references/official-docs/docs/subsystems/credentials.zh.md +0 -493
  477. package/references/official-docs/docs/subsystems/deliverables.i18n.yaml +0 -28
  478. package/references/official-docs/docs/subsystems/deliverables.md +0 -178
  479. package/references/official-docs/docs/subsystems/deliverables.zh.md +0 -178
  480. package/references/official-docs/docs/subsystems/extensions.i18n.yaml +0 -7
  481. package/references/official-docs/docs/subsystems/extensions.md +0 -384
  482. package/references/official-docs/docs/subsystems/extensions.zh.md +0 -384
  483. package/references/official-docs/docs/subsystems/feedback.i18n.yaml +0 -28
  484. package/references/official-docs/docs/subsystems/feedback.md +0 -400
  485. package/references/official-docs/docs/subsystems/feedback.zh.md +0 -400
  486. package/references/official-docs/docs/subsystems/filesystem.i18n.yaml +0 -34
  487. package/references/official-docs/docs/subsystems/filesystem.md +0 -530
  488. package/references/official-docs/docs/subsystems/filesystem.zh.md +0 -530
  489. package/references/official-docs/docs/subsystems/goal.i18n.yaml +0 -19
  490. package/references/official-docs/docs/subsystems/goal.md +0 -313
  491. package/references/official-docs/docs/subsystems/goal.zh.md +0 -313
  492. package/references/official-docs/docs/subsystems/jobs.i18n.yaml +0 -28
  493. package/references/official-docs/docs/subsystems/jobs.md +0 -554
  494. package/references/official-docs/docs/subsystems/jobs.zh.md +0 -554
  495. package/references/official-docs/docs/subsystems/llm-streaming.i18n.yaml +0 -49
  496. package/references/official-docs/docs/subsystems/llm-streaming.md +0 -1196
  497. package/references/official-docs/docs/subsystems/llm-streaming.zh.md +0 -1202
  498. package/references/official-docs/docs/subsystems/lsp.i18n.yaml +0 -19
  499. package/references/official-docs/docs/subsystems/lsp.md +0 -202
  500. package/references/official-docs/docs/subsystems/lsp.zh.md +0 -202
  501. package/references/official-docs/docs/subsystems/mcp.i18n.yaml +0 -34
  502. package/references/official-docs/docs/subsystems/mcp.md +0 -139
  503. package/references/official-docs/docs/subsystems/mcp.zh.md +0 -139
  504. package/references/official-docs/docs/subsystems/office-to-pdf.i18n.yaml +0 -19
  505. package/references/official-docs/docs/subsystems/office-to-pdf.md +0 -87
  506. package/references/official-docs/docs/subsystems/office-to-pdf.zh.md +0 -87
  507. package/references/official-docs/docs/subsystems/otel.i18n.yaml +0 -7
  508. package/references/official-docs/docs/subsystems/otel.md +0 -44
  509. package/references/official-docs/docs/subsystems/otel.zh.md +0 -44
  510. package/references/official-docs/docs/subsystems/permission-presets.i18n.yaml +0 -19
  511. package/references/official-docs/docs/subsystems/permission-presets.md +0 -167
  512. package/references/official-docs/docs/subsystems/permission-presets.zh.md +0 -167
  513. package/references/official-docs/docs/subsystems/persistence.i18n.yaml +0 -37
  514. package/references/official-docs/docs/subsystems/persistence.md +0 -418
  515. package/references/official-docs/docs/subsystems/persistence.zh.md +0 -418
  516. package/references/official-docs/docs/subsystems/plan.i18n.yaml +0 -22
  517. package/references/official-docs/docs/subsystems/plan.md +0 -87
  518. package/references/official-docs/docs/subsystems/plan.zh.md +0 -87
  519. package/references/official-docs/docs/subsystems/product-telemetry.i18n.yaml +0 -10
  520. package/references/official-docs/docs/subsystems/product-telemetry.md +0 -81
  521. package/references/official-docs/docs/subsystems/product-telemetry.zh.md +0 -81
  522. package/references/official-docs/docs/subsystems/ptc-runtime.i18n.yaml +0 -19
  523. package/references/official-docs/docs/subsystems/ptc-runtime.md +0 -250
  524. package/references/official-docs/docs/subsystems/ptc-runtime.zh.md +0 -250
  525. package/references/official-docs/docs/subsystems/sandbox.i18n.yaml +0 -19
  526. package/references/official-docs/docs/subsystems/sandbox.md +0 -221
  527. package/references/official-docs/docs/subsystems/sandbox.zh.md +0 -221
  528. package/references/official-docs/docs/subsystems/schedule.i18n.yaml +0 -40
  529. package/references/official-docs/docs/subsystems/schedule.md +0 -550
  530. package/references/official-docs/docs/subsystems/schedule.zh.md +0 -550
  531. package/references/official-docs/docs/subsystems/scope.i18n.yaml +0 -16
  532. package/references/official-docs/docs/subsystems/scope.md +0 -59
  533. package/references/official-docs/docs/subsystems/scope.zh.md +0 -61
  534. package/references/official-docs/docs/subsystems/session-projection.i18n.yaml +0 -16
  535. package/references/official-docs/docs/subsystems/session-projection.md +0 -356
  536. package/references/official-docs/docs/subsystems/session-projection.zh.md +0 -356
  537. package/references/official-docs/docs/subsystems/session-query.i18n.yaml +0 -28
  538. package/references/official-docs/docs/subsystems/session-query.md +0 -511
  539. package/references/official-docs/docs/subsystems/session-query.zh.md +0 -511
  540. package/references/official-docs/docs/subsystems/session-reference.i18n.yaml +0 -19
  541. package/references/official-docs/docs/subsystems/session-reference.md +0 -224
  542. package/references/official-docs/docs/subsystems/session-reference.zh.md +0 -224
  543. package/references/official-docs/docs/subsystems/session-telemetry.i18n.yaml +0 -22
  544. package/references/official-docs/docs/subsystems/session-telemetry.md +0 -212
  545. package/references/official-docs/docs/subsystems/session-telemetry.zh.md +0 -212
  546. package/references/official-docs/docs/subsystems/session-title.i18n.yaml +0 -16
  547. package/references/official-docs/docs/subsystems/session-title.md +0 -213
  548. package/references/official-docs/docs/subsystems/session-title.zh.md +0 -213
  549. package/references/official-docs/docs/subsystems/session.i18n.yaml +0 -70
  550. package/references/official-docs/docs/subsystems/session.md +0 -1339
  551. package/references/official-docs/docs/subsystems/session.zh.md +0 -1343
  552. package/references/official-docs/docs/subsystems/settings.i18n.yaml +0 -13
  553. package/references/official-docs/docs/subsystems/settings.md +0 -155
  554. package/references/official-docs/docs/subsystems/settings.zh.md +0 -155
  555. package/references/official-docs/docs/subsystems/shell.i18n.yaml +0 -25
  556. package/references/official-docs/docs/subsystems/shell.md +0 -314
  557. package/references/official-docs/docs/subsystems/shell.zh.md +0 -314
  558. package/references/official-docs/docs/subsystems/sidebar-right.i18n.yaml +0 -37
  559. package/references/official-docs/docs/subsystems/sidebar-right.md +0 -160
  560. package/references/official-docs/docs/subsystems/sidebar-right.zh.md +0 -160
  561. package/references/official-docs/docs/subsystems/skills.i18n.yaml +0 -28
  562. package/references/official-docs/docs/subsystems/skills.md +0 -352
  563. package/references/official-docs/docs/subsystems/skills.zh.md +0 -352
  564. package/references/official-docs/docs/subsystems/slots.i18n.yaml +0 -28
  565. package/references/official-docs/docs/subsystems/slots.md +0 -200
  566. package/references/official-docs/docs/subsystems/slots.zh.md +0 -204
  567. package/references/official-docs/docs/subsystems/spill.i18n.yaml +0 -16
  568. package/references/official-docs/docs/subsystems/spill.md +0 -124
  569. package/references/official-docs/docs/subsystems/spill.zh.md +0 -124
  570. package/references/official-docs/docs/subsystems/ssh.i18n.yaml +0 -22
  571. package/references/official-docs/docs/subsystems/ssh.md +0 -146
  572. package/references/official-docs/docs/subsystems/ssh.zh.md +0 -146
  573. package/references/official-docs/docs/subsystems/storage.i18n.yaml +0 -25
  574. package/references/official-docs/docs/subsystems/storage.md +0 -259
  575. package/references/official-docs/docs/subsystems/storage.zh.md +0 -259
  576. package/references/official-docs/docs/subsystems/subagent.i18n.yaml +0 -28
  577. package/references/official-docs/docs/subsystems/subagent.md +0 -686
  578. package/references/official-docs/docs/subsystems/subagent.zh.md +0 -688
  579. package/references/official-docs/docs/subsystems/subprocess.i18n.yaml +0 -31
  580. package/references/official-docs/docs/subsystems/subprocess.md +0 -321
  581. package/references/official-docs/docs/subsystems/subprocess.zh.md +0 -321
  582. package/references/official-docs/docs/subsystems/system-prompt.i18n.yaml +0 -19
  583. package/references/official-docs/docs/subsystems/system-prompt.md +0 -254
  584. package/references/official-docs/docs/subsystems/system-prompt.zh.md +0 -254
  585. package/references/official-docs/docs/subsystems/terminal.i18n.yaml +0 -19
  586. package/references/official-docs/docs/subsystems/terminal.md +0 -184
  587. package/references/official-docs/docs/subsystems/terminal.zh.md +0 -184
  588. package/references/official-docs/docs/subsystems/todo.i18n.yaml +0 -13
  589. package/references/official-docs/docs/subsystems/todo.md +0 -32
  590. package/references/official-docs/docs/subsystems/todo.zh.md +0 -32
  591. package/references/official-docs/docs/subsystems/token-meter.i18n.yaml +0 -13
  592. package/references/official-docs/docs/subsystems/token-meter.md +0 -106
  593. package/references/official-docs/docs/subsystems/token-meter.zh.md +0 -106
  594. package/references/official-docs/docs/subsystems/tools.i18n.yaml +0 -25
  595. package/references/official-docs/docs/subsystems/tools.md +0 -747
  596. package/references/official-docs/docs/subsystems/tools.zh.md +0 -747
  597. package/references/official-docs/docs/subsystems/translation.i18n.yaml +0 -19
  598. package/references/official-docs/docs/subsystems/translation.md +0 -103
  599. package/references/official-docs/docs/subsystems/translation.zh.md +0 -103
  600. package/references/official-docs/docs/subsystems/typert.i18n.yaml +0 -25
  601. package/references/official-docs/docs/subsystems/typert.md +0 -690
  602. package/references/official-docs/docs/subsystems/typert.zh.md +0 -690
  603. package/references/official-docs/docs/subsystems/user-questions.i18n.yaml +0 -28
  604. package/references/official-docs/docs/subsystems/user-questions.md +0 -307
  605. package/references/official-docs/docs/subsystems/user-questions.zh.md +0 -307
  606. package/references/official-docs/docs/subsystems/voice-input.i18n.yaml +0 -19
  607. package/references/official-docs/docs/subsystems/voice-input.md +0 -164
  608. package/references/official-docs/docs/subsystems/voice-input.zh.md +0 -164
  609. package/references/official-docs/docs/subsystems/web-client.i18n.yaml +0 -37
  610. package/references/official-docs/docs/subsystems/web-client.md +0 -100
  611. package/references/official-docs/docs/subsystems/web-client.zh.md +0 -100
  612. package/references/official-docs/docs/subsystems/web-server.i18n.yaml +0 -16
  613. package/references/official-docs/docs/subsystems/web-server.md +0 -302
  614. package/references/official-docs/docs/subsystems/web-server.zh.md +0 -302
  615. package/references/official-docs/docs/subsystems/web.i18n.yaml +0 -28
  616. package/references/official-docs/docs/subsystems/web.md +0 -206
  617. package/references/official-docs/docs/subsystems/web.zh.md +0 -206
  618. package/references/official-docs/docs/subsystems/webhook.i18n.yaml +0 -19
  619. package/references/official-docs/docs/subsystems/webhook.md +0 -70
  620. package/references/official-docs/docs/subsystems/webhook.zh.md +0 -70
  621. package/references/official-docs/docs/subsystems/workflow.i18n.yaml +0 -28
  622. package/references/official-docs/docs/subsystems/workflow.md +0 -278
  623. package/references/official-docs/docs/subsystems/workflow.zh.md +0 -278
  624. package/references/official-docs/docs/subsystems/working-directory.i18n.yaml +0 -13
  625. package/references/official-docs/docs/subsystems/working-directory.md +0 -64
  626. package/references/official-docs/docs/subsystems/working-directory.zh.md +0 -64
  627. package/references/official-docs/docs/subsystems/workspace.i18n.yaml +0 -28
  628. package/references/official-docs/docs/subsystems/workspace.md +0 -647
  629. package/references/official-docs/docs/subsystems/workspace.zh.md +0 -647
  630. package/references/official-docs/docs/subsystems/worktrees.i18n.yaml +0 -13
  631. package/references/official-docs/docs/subsystems/worktrees.md +0 -76
  632. package/references/official-docs/docs/subsystems/worktrees.zh.md +0 -76
  633. package/references/official-docs/docs/testing.i18n.yaml +0 -34
  634. package/references/official-docs/docs/testing.md +0 -55
  635. package/references/official-docs/docs/testing.zh.md +0 -55
  636. package/references/official-docs/docs/tool-catalog.i18n.yaml +0 -331
  637. package/references/official-docs/docs/tool-catalog.md +0 -2824
  638. package/references/official-docs/docs/tool-catalog.zh.md +0 -2832
  639. package/references/official-docs/docs/tool-execution-pipeline.i18n.yaml +0 -10
  640. package/references/official-docs/docs/tool-execution-pipeline.md +0 -65
  641. package/references/official-docs/docs/tool-execution-pipeline.zh.md +0 -67
  642. package/references/official-docs/docs/ui-radius.i18n.yaml +0 -31
  643. package/references/official-docs/docs/ui-radius.md +0 -117
  644. package/references/official-docs/docs/ui-radius.zh.md +0 -117
  645. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.i18n.yaml +0 -16
  646. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.md +0 -22
  647. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.zh.md +0 -22
  648. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.i18n.yaml +0 -16
  649. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.md +0 -25
  650. package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.zh.md +0 -25
  651. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.i18n.yaml +0 -16
  652. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.md +0 -18
  653. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.zh.md +0 -18
  654. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/bundled-python-tests/guide.i18n.yaml +0 -16
  655. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/bundled-python-tests/guide.md +0 -18
  656. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/bundled-python-tests/guide.zh.md +0 -18
  657. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/primary-runtime-python-aliases/guide.i18n.yaml +0 -16
  658. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/primary-runtime-python-aliases/guide.md +0 -18
  659. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/primary-runtime-python-aliases/guide.zh.md +0 -18
  660. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.i18n.yaml +0 -16
  661. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.md +0 -23
  662. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.zh.md +0 -23
  663. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.i18n.yaml +0 -16
  664. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.md +0 -22
  665. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.zh.md +0 -22
  666. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.i18n.yaml +0 -16
  667. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.md +0 -27
  668. package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.zh.md +0 -27
  669. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/deepseek-model-discovery/guide.i18n.yaml +0 -16
  670. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/deepseek-model-discovery/guide.md +0 -17
  671. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/deepseek-model-discovery/guide.zh.md +0 -17
  672. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/desktop-test-auth-popup/guide.i18n.yaml +0 -16
  673. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/desktop-test-auth-popup/guide.md +0 -18
  674. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/desktop-test-auth-popup/guide.zh.md +0 -18
  675. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/experimental-package-composition/guide.i18n.yaml +0 -16
  676. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/experimental-package-composition/guide.md +0 -28
  677. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/experimental-package-composition/guide.zh.md +0 -28
  678. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/instruction-home-override/guide.i18n.yaml +0 -16
  679. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/instruction-home-override/guide.md +0 -20
  680. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/instruction-home-override/guide.zh.md +0 -20
  681. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/job-id-identity/guide.i18n.yaml +0 -16
  682. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/job-id-identity/guide.md +0 -18
  683. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/job-id-identity/guide.zh.md +0 -18
  684. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/jsonl-persistence-plugin/guide.i18n.yaml +0 -16
  685. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/jsonl-persistence-plugin/guide.md +0 -18
  686. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/jsonl-persistence-plugin/guide.zh.md +0 -18
  687. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/mock-messages-events/guide.i18n.yaml +0 -16
  688. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/mock-messages-events/guide.md +0 -17
  689. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/mock-messages-events/guide.zh.md +0 -17
  690. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/native-subagent-bundle-tools/guide.i18n.yaml +0 -16
  691. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/native-subagent-bundle-tools/guide.md +0 -31
  692. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/native-subagent-bundle-tools/guide.zh.md +0 -31
  693. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/new-session-generations/guide.i18n.yaml +0 -16
  694. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/new-session-generations/guide.md +0 -20
  695. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/new-session-generations/guide.zh.md +0 -20
  696. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/plugin-option-placement/guide.i18n.yaml +0 -16
  697. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/plugin-option-placement/guide.md +0 -20
  698. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/plugin-option-placement/guide.zh.md +0 -20
  699. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-optional-resources/guide.i18n.yaml +0 -16
  700. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-optional-resources/guide.md +0 -18
  701. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-optional-resources/guide.zh.md +0 -18
  702. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-ptc-sandbox/guide.i18n.yaml +0 -16
  703. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-ptc-sandbox/guide.md +0 -21
  704. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/python-ptc-sandbox/guide.zh.md +0 -21
  705. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-adapters/guide.i18n.yaml +0 -16
  706. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-adapters/guide.md +0 -18
  707. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-adapters/guide.zh.md +0 -18
  708. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-provider-strategy/guide.i18n.yaml +0 -16
  709. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-provider-strategy/guide.md +0 -20
  710. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/session-title-provider-strategy/guide.zh.md +0 -20
  711. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/ssh-helper-launch/guide.i18n.yaml +0 -16
  712. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/ssh-helper-launch/guide.md +0 -19
  713. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/ssh-helper-launch/guide.zh.md +0 -19
  714. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-activations/guide.i18n.yaml +0 -16
  715. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-activations/guide.md +0 -59
  716. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-activations/guide.zh.md +0 -59
  717. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-preset-composition/guide.i18n.yaml +0 -16
  718. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-preset-composition/guide.md +0 -21
  719. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/subagent-preset-composition/guide.zh.md +0 -21
  720. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/team-direct-inbox/guide.i18n.yaml +0 -16
  721. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/team-direct-inbox/guide.md +0 -21
  722. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/team-direct-inbox/guide.zh.md +0 -21
  723. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/terminal-command-labels/guide.i18n.yaml +0 -16
  724. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/terminal-command-labels/guide.md +0 -18
  725. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/terminal-command-labels/guide.zh.md +0 -18
  726. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/tool-presentation-mode/guide.i18n.yaml +0 -16
  727. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/tool-presentation-mode/guide.md +0 -21
  728. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/tool-presentation-mode/guide.zh.md +0 -21
  729. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.i18n.yaml +0 -16
  730. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md +0 -36
  731. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.zh.md +0 -36
  732. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/working-directory/guide.i18n.yaml +0 -16
  733. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/working-directory/guide.md +0 -25
  734. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.1/working-directory/guide.zh.md +0 -25
  735. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-identity-watch/guide.i18n.yaml +0 -16
  736. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-identity-watch/guide.md +0 -18
  737. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-identity-watch/guide.zh.md +0 -18
  738. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-model-catalog/guide.i18n.yaml +0 -16
  739. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-model-catalog/guide.md +0 -27
  740. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-model-catalog/guide.zh.md +0 -27
  741. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/desktop-font-size-shortcuts/guide.i18n.yaml +0 -16
  742. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/desktop-font-size-shortcuts/guide.md +0 -18
  743. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/desktop-font-size-shortcuts/guide.zh.md +0 -18
  744. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/from-default-profile-replaces-target/guide.i18n.yaml +0 -16
  745. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/from-default-profile-replaces-target/guide.md +0 -20
  746. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/from-default-profile-replaces-target/guide.zh.md +0 -20
  747. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/operator-connect/guide.i18n.yaml +0 -16
  748. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/operator-connect/guide.md +0 -18
  749. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/operator-connect/guide.zh.md +0 -18
  750. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-azure-provider/guide.i18n.yaml +0 -16
  751. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-azure-provider/guide.md +0 -19
  752. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-azure-provider/guide.zh.md +0 -19
  753. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-model-discovery/guide.i18n.yaml +0 -16
  754. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-model-discovery/guide.md +0 -17
  755. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/pi-ai-model-discovery/guide.zh.md +0 -17
  756. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/plugin-install-over-installed/guide.i18n.yaml +0 -16
  757. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/plugin-install-over-installed/guide.md +0 -20
  758. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/plugin-install-over-installed/guide.zh.md +0 -20
  759. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/sdk-minimal-image-compaction/guide.i18n.yaml +0 -16
  760. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/sdk-minimal-image-compaction/guide.md +0 -32
  761. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/sdk-minimal-image-compaction/guide.zh.md +0 -32
  762. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/stored-credentials-precedence/guide.i18n.yaml +0 -16
  763. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/stored-credentials-precedence/guide.md +0 -25
  764. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.2/stored-credentials-precedence/guide.zh.md +0 -25
  765. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.3/plugin-engines-dsh/guide.i18n.yaml +0 -16
  766. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.3/plugin-engines-dsh/guide.md +0 -21
  767. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.3/plugin-engines-dsh/guide.zh.md +0 -21
  768. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.4/account-notification-fields/guide.i18n.yaml +0 -16
  769. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.4/account-notification-fields/guide.md +0 -18
  770. package/references/official-docs/docs/upgrade-guide/v0.2.1-alpha.4/account-notification-fields/guide.zh.md +0 -18
  771. package/references/official-docs/docs/user/develop/basic/config.i18n.yaml +0 -28
  772. package/references/official-docs/docs/user/develop/basic/config.md +0 -106
  773. package/references/official-docs/docs/user/develop/basic/config.zh.md +0 -106
  774. package/references/official-docs/docs/user/develop/basic/index.i18n.yaml +0 -37
  775. package/references/official-docs/docs/user/develop/basic/index.md +0 -144
  776. package/references/official-docs/docs/user/develop/basic/index.zh.md +0 -144
  777. package/references/official-docs/docs/user/develop/basic/publish.i18n.yaml +0 -31
  778. package/references/official-docs/docs/user/develop/basic/publish.md +0 -191
  779. package/references/official-docs/docs/user/develop/basic/publish.zh.md +0 -191
  780. package/references/official-docs/docs/user/develop/basic/tool.i18n.yaml +0 -16
  781. package/references/official-docs/docs/user/develop/basic/tool.md +0 -52
  782. package/references/official-docs/docs/user/develop/basic/tool.zh.md +0 -52
  783. package/references/official-docs/docs/user/develop/framework/events.i18n.yaml +0 -46
  784. package/references/official-docs/docs/user/develop/framework/events.md +0 -143
  785. package/references/official-docs/docs/user/develop/framework/events.zh.md +0 -143
  786. package/references/official-docs/docs/user/develop/framework/index.i18n.yaml +0 -31
  787. package/references/official-docs/docs/user/develop/framework/index.md +0 -137
  788. package/references/official-docs/docs/user/develop/framework/index.zh.md +0 -137
  789. package/references/official-docs/docs/user/develop/framework/service.i18n.yaml +0 -40
  790. package/references/official-docs/docs/user/develop/framework/service.md +0 -148
  791. package/references/official-docs/docs/user/develop/framework/service.zh.md +0 -150
  792. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.i18n.yaml +0 -10
  793. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.md +0 -15
  794. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.zh.md +0 -15
  795. package/references/official-docs/docs/user/develop/practice/index.i18n.yaml +0 -46
  796. package/references/official-docs/docs/user/develop/practice/index.md +0 -155
  797. package/references/official-docs/docs/user/develop/practice/index.zh.md +0 -155
  798. package/references/official-docs/docs/user/develop/practice/llm-adapter.i18n.yaml +0 -34
  799. package/references/official-docs/docs/user/develop/practice/llm-adapter.md +0 -189
  800. package/references/official-docs/docs/user/develop/practice/llm-adapter.zh.md +0 -189
  801. package/references/official-docs/docs/user/guide/github-review.i18n.yaml +0 -25
  802. package/references/official-docs/docs/user/guide/github-review.md +0 -99
  803. package/references/official-docs/docs/user/guide/github-review.zh.md +0 -99
  804. package/references/official-docs/docs/user/guide/index.i18n.yaml +0 -19
  805. package/references/official-docs/docs/user/guide/index.md +0 -31
  806. package/references/official-docs/docs/user/guide/index.zh.md +0 -31
  807. package/references/official-docs/docs/user/guide/mcp-memory.i18n.yaml +0 -37
  808. package/references/official-docs/docs/user/guide/mcp-memory.md +0 -101
  809. package/references/official-docs/docs/user/guide/mcp-memory.zh.md +0 -101
  810. package/references/official-docs/docs/user/guide/network-proxy.i18n.yaml +0 -25
  811. package/references/official-docs/docs/user/guide/network-proxy.md +0 -85
  812. package/references/official-docs/docs/user/guide/network-proxy.zh.md +0 -85
  813. package/references/official-docs/docs/user/guide/plugin-market.i18n.yaml +0 -34
  814. package/references/official-docs/docs/user/guide/plugin-market.md +0 -148
  815. package/references/official-docs/docs/user/guide/plugin-market.zh.md +0 -148
  816. package/references/official-docs/docs/user/guide/providers-custom-form.png +0 -0
  817. package/references/official-docs/docs/user/guide/providers-custom-form.zh.png +0 -0
  818. package/references/official-docs/docs/user/guide/providers-models-page.png +0 -0
  819. package/references/official-docs/docs/user/guide/providers-models-page.zh.png +0 -0
  820. package/references/official-docs/docs/user/guide/providers.i18n.yaml +0 -40
  821. package/references/official-docs/docs/user/guide/providers.md +0 -227
  822. package/references/official-docs/docs/user/guide/providers.zh.md +0 -227
  823. package/references/official-docs/docs/user/guide/public-deployments.i18n.yaml +0 -19
  824. package/references/official-docs/docs/user/guide/public-deployments.md +0 -37
  825. package/references/official-docs/docs/user/guide/public-deployments.zh.md +0 -37
  826. package/references/official-docs/docs/user/guide/python-sdk.i18n.yaml +0 -28
  827. package/references/official-docs/docs/user/guide/python-sdk.md +0 -185
  828. package/references/official-docs/docs/user/guide/python-sdk.zh.md +0 -185
  829. package/references/official-docs/docs/user/guide/schedule.i18n.yaml +0 -31
  830. package/references/official-docs/docs/user/guide/schedule.md +0 -79
  831. package/references/official-docs/docs/user/guide/schedule.zh.md +0 -79
  832. package/references/official-docs/docs/user/index.i18n.yaml +0 -10
  833. package/references/official-docs/docs/user/index.md +0 -11
  834. package/references/official-docs/docs/user/index.zh.md +0 -11
  835. package/references/official-docs/docs/web-styling.i18n.yaml +0 -19
  836. package/references/official-docs/docs/web-styling.md +0 -39
  837. package/references/official-docs/docs/web-styling.zh.md +0 -39
  838. package/references/official-docs/packages/AGENTS.md +0 -29
  839. package/references/official-docs/packages/README.md +0 -117
  840. package/references/official-docs/vendor/README.md +0 -73
  841. package/references/official-docs/website-docs.ts +0 -591
  842. package/references/official-plugin-dev-skill.md +0 -124
  843. package/references/sources.md +0 -143
  844. package/references/upstream-cordis.md +0 -594
  845. package/references/website-pages.md +0 -673
  846. package/scripts/archive-discussions.ps1 +0 -162
  847. package/scripts/build-llms-full.mjs +0 -73
  848. package/scripts/check-docs-drift-detail.mjs +0 -145
  849. package/scripts/check-docs-drift.ps1 +0 -55
  850. package/scripts/check-facts.mjs +0 -162
  851. package/scripts/check-ps1-bom.mjs +0 -68
  852. package/scripts/check-readme-parity.mjs +0 -149
  853. package/scripts/check-readme-sync.mjs +0 -96
  854. package/scripts/download-community-articles.ps1 +0 -188
  855. package/scripts/download-community-repos.ps1 +0 -232
  856. package/scripts/download-sources.ps1 +0 -195
  857. package/scripts/gen-topic-snapshot.ps1 +0 -91
  858. package/scripts/install-skill.ps1 +0 -63
  859. package/scripts/measure-mirror-references.mjs +0 -117
  860. package/scripts/sync-official-docs.ps1 +0 -138
  861. package/scripts/verify-artifacts.mjs +0 -145
  862. package/scripts/verify-kit.ps1 +0 -197
  863. package/templates/js/LICENSE +0 -15
  864. package/templates/js/README-es.md +0 -46
  865. package/templates/js/README-hi.md +0 -46
  866. package/templates/js/README-pt.md +0 -46
  867. package/templates/js/README-zh.md +0 -46
  868. package/templates/js/README.md +0 -46
  869. package/templates/js/cordis.patch.yml +0 -10
  870. package/templates/js/icon.svg +0 -4
  871. package/templates/js/index.js +0 -38
  872. package/templates/js/locale/en.json +0 -6
  873. package/templates/js/locale/zh.json +0 -6
  874. package/templates/js/package.json +0 -49
  875. package/templates/js/tests/index.test.js +0 -12
  876. package/templates/ts/LICENSE +0 -15
  877. package/templates/ts/README-es.md +0 -48
  878. package/templates/ts/README-hi.md +0 -48
  879. package/templates/ts/README-pt.md +0 -48
  880. package/templates/ts/README-zh.md +0 -48
  881. package/templates/ts/README.md +0 -48
  882. package/templates/ts/cordis.patch.yml +0 -10
  883. package/templates/ts/icon.svg +0 -4
  884. package/templates/ts/locale/en.json +0 -6
  885. package/templates/ts/locale/zh.json +0 -6
  886. package/templates/ts/package.json +0 -58
  887. package/templates/ts/src/config.ts +0 -12
  888. package/templates/ts/src/index.ts +0 -36
  889. package/templates/ts/tests/index.test.ts +0 -12
  890. package/templates/ts/tsconfig.json +0 -17
  891. package/templates/ts/tsdown.config.mjs +0 -21
  892. package/templates/ts/vitest.config.ts +0 -8
@@ -1,303 +0,0 @@
1
- # Conversation 组装
2
-
3
- [English](conversation.md) | 中文
4
-
5
- Conversation 是 Client `SessionEventLikeEntry` window 与浏览器 view 之间的 target-neutral assembly 层。[`ui-conversation`](../../packages/client/ui-conversation/README.zh.md)拥有 event 与 view registry、每个 `SessionBinding` 对应的 identity-stable binding、Turn/Step Location、增量 Context assembly、target source、共享 shell 与输入编排。[`ui-chat`](../../packages/client/ui-chat/README.zh.md)和 [`ui-trajectory`](../../packages/client/ui-trajectory/README.zh.md)等 target 包拥有各自的 Definition、最终 snapshot 与渲染。
6
-
7
- 本文定义数据模型与业务自有 Conversation node 的扩展路径。[Web Client 架构](web-client.zh.md)说明该子系统在 Client model 与 Slots 之间的位置;[Conversation Node 组装决策](../../.agents/notes/implemented/architecture/2026-08-09-client-conversation-node-assembly.zh.md)记录其设计理由。
8
-
9
- ## 数据模型与所有权
10
-
11
- Session Controller 拥有连续的已加载逻辑 event window。每个 `SessionEventLikeEntry` 要么是表示一个持久事件的 `{ type: 'event', event: SessionEvent }`,要么是表示一个 Client-only `assistant/live-chunk` 呈现的 `{ type: 'transient', event: AssistantLiveChunkEvent }`;两种内部 event 都公开 `type`、`seq`、`time` 与 `data`。`ui-conversation` 把这些 entry 直接交给 assembler,不另开 history stream。每个 Session 对应一个 `ConversationNodeAssembler`,它应用所有已注册 Definition,并为每个已注册 view target 发布独立 source。
12
-
13
- | 概念 | Owner 与用途 |
14
- |---|---|
15
- | Event Definition | 业务包一次匹配一个持久 event 或 Client-only 瞬态 event,以稳定 `(kind, id)` 关联输入、折叠确定性 State,并可选择 materialize 一个 target node。 |
16
- | Context | Engine 为一个 `(kind, id)` 拥有的有序 Match 与当前 State。持久和瞬态事件都可以作为 start。当前最早的 start 初始化 State,后续 Match 更新它。只有 update 的证据保持 pending,直到其 start 加载。 |
17
- | Location | Engine 根据持久 boundary event 推导的 Session、Turn 或 Step 坐标。Definition 可以向一个 Turn 或 Step 发布类型化数据。 |
18
- | View Definition | Target 包为每个 Session 创建一个增量 builder,并拥有该 target 的最终 snapshot 类型。 |
19
- | Group Definition | 业务包从物化后的 Node 派生一个目标的根引用和组快照,拥有成员归属、分段、摘要及增量缓存。 |
20
- | View | Chat 或 Trajectory 等 Slot entry 只读取自身 target snapshot,并渲染 target 自有 node。 |
21
-
22
- Chat 与 Trajectory 可以识别同一个持久 event family,但各自保留自己的 Definition State 与最终 node payload。共享的 target-neutral 机制只包括 identity routing、有序 replay、Location data、predecessor dependency 与 publication cadence。
23
-
24
- ## Target 激活
25
-
26
- 每个 Session 都保留单调增长的 active target 集合。创建或读取 target source 不会激活它。shell 会显式激活持久化选择或新选择的 View,其他消费者则通过 target source 的首个订阅激活 target。首次激活会创建该 target 的 builder,并从当前按 target 索引的 Context 调用一次 `replace()`。后续 flush 对每个 active target 调用 `apply()`,取消订阅不会移除 target。
27
-
28
- shell 拥有 View 选择,并在 binding 创建、被选为 current 或 View roster 变化时,于渲染前解析已注册的偏好 View 或 Chat fallback。assembler 只接收解析后的 target id,不自行选择 Chat 或其他默认 target。第三方 View 使用相同的选择与激活操作。View Definition 可以提供 `toolCallFocus(callId)`;shell 仅为声明了此能力且可见的目标提供 Inspect,由目标将调用 id 映射为自己的焦点标识。
29
-
30
- <a id="group-definitions"></a>
31
- ## Group Definition
32
-
33
- 可选的 `ctx.uiConversation.groups.register(definition)` 贡献沿用事件及视图注册的 effect 生命周期。它要求已有 View 目标,拒绝重复目标注册,不构造 Builder。每个 Session 仅在目标激活时创建自己的 Group 上下文。注册替换通过既有注册重建流程丢弃旧上下文,并清空其被观察的组。
34
-
35
- [分组类型](../../packages/client/ui-conversation/src/client/contract/groups.ts)定义完整协议:
36
-
37
- | 类型 | 含义 |
38
- |---|---|
39
- | `ConversationGroupDefinition<Node, State, Data>` | `create()` 初始化 Session 内的 State;`update(context, input)` 返回下一份 State;`buildGroups(context)` 返回待发布输出或 `null`。替换输入要求输出 entries 与完整组替换。 |
40
- | `ConversationGroupInput<Node>` | `replace` 提供目标顺序、时间线及同步的 `readNode`、`readTurn`、`readPosition` 读取器。`apply` 增加投影后的 `previous/current` 节点变化、生命周期 `changedTurns` 和 `changedTurnOrders`。不要把读取器留在 State 中。 |
41
- | `GroupNodePosition` | 所属 Turn(如有)及前后紧邻的可见 Node 键。相邻关系保留仅按 Turn 取键时会遗漏的分隔。 |
42
- | `NodeReference` / `GroupReference` | 以 `kind` 区分的品牌类型 `NodeKey` 或 `GroupKey`。Node 引用可选择渲染器拥有的 `groupPart`,省略表示整个 Node。 |
43
- | `GroupSnapshot<Data>` | 不可变的组键、业务数据和有序 Node 引用。Group 不包含其他 Group,也不拥有原 Node 数据。 |
44
- | `GroupUpdate<Data>` | `entries` 替换完整根序列,仅 apply 输入允许省略它以保留原序列。替换输入必须同时提供 `entries` 与 `groups.replace`。`groups.replace.snapshots` 替换全部组;`groups.apply.upserts/removes` 只更新具名组记录。删除组不删除 Node。 |
45
- | `ConversationGroupDataMap` | 通过声明合并关联目标与数据类型,注册及 `views.grouped(target)` 共用。未声明的目标没有组载荷类型。 |
46
- | `ConversationGroupedView<Data>` | 稳定的根 `entries` 与按键 `groupSource(key)` 读取器;已删除的组返回 `undefined`。 |
47
-
48
- 注册分组时 Builder 必须提供 `groupInput()`,缺少输入方法在首次激活时报错。它记录自身投影后的节点值,并在仅正文更新时保留顺序数组身份。assembler 每次更新都提供变化轮次,直接调用未分组 Builder 的调用方可以省略。拥有独立来源的 Builder 把通知推迟到 `publish()`。首次激活与普通 flush 共用同一顺序:物化 Location 数据和 Node,更新 Builder,调用 Group Definition,校验并安装分组,再发布全部受影响目标及 Location 来源。分组阶段复用既有发布节奏。
49
-
50
- 目标位置索引提供这些读取器,并标识可见键或相邻关系发生变化的 Turn。`changedTurnOrders` 包含移动 Node 的新旧所属轮次,以及相邻的轮次外 Node 被插入或移除所影响的轮次;仅生命周期变化仍由 `changedTurns` 提供。业务 Definition 可只重分这些轮次,并只刷新包含变化内容的组。结构输出仍替换完整根引用数组,但不要求重读未变化的 Node 内容。
51
-
52
- Group 存储在安装前校验完整提交结果:根 Group 引用与记录一一对应,引用的 Node 全部存在,每个 `(NodeKey, groupPart)` 在根和成员位置中最多占位一次。整 Node 不能与自身任一部分共存。重复 upsert、重复删除以及同时 upsert 和删除一个组都会报错。仅数据 upsert 保留根及成员数组、不读取 Node,并只通知变化组的来源;完整替换重新校验全部引用。
53
-
54
- 渲染器按两种引用 kind 切换,由所属 View 选择组件,不通过组数据中的 renderer 字段选择。根 Node 引用与被引用组的成员构成完整渲染列表;未被引用的目标 Node 仍保留在存储中,但不渲染。组 body 将成员与摘要数据分开读取。展示模式必须保留组件类型、key 和成员父级;业务数据改变成员归属时,移动成员可以正常重挂载。框架不解释部分内容完备性、分段或展示策略。
55
-
56
- ## 可回放 event family
57
-
58
- 编写 Definition 前先选定稳定的业务 id。构成同一个 Node 的每条事件都必须携带该 id,或只凭自身 payload 独立推导出该 id;Client 绝不能把 update 猜测为属于“最近一个未完成”的 Context。
59
-
60
- 以一个 review job 为例,事件约定可以是:
61
-
62
- | 事件 | 角色 | 必须持久化的事实 |
63
- |---|---|---|
64
- | `review/start` | 唯一 start | `reviewId`、Turn/Step 坐标、标题 |
65
- | `review/progress` | update | 相同的 `reviewId`、坐标、可回放进度 |
66
- | `review/end` | update | 相同的 `reviewId`、坐标、最终摘要 |
67
-
68
- 跨进程边界使用生产方拥有的 branded id 类型。把 `SessionEventMap` 合并和 payload 类型放在生产方的纯类型导出中,再由 Client 包通过仅类型副作用导入该导出。每个 `(kind, id)` 最多只能有一条 start 事件。单事件业务可以把事件自身的稳定身份(例如 `event.seq`)作为 Definition 内部 id。
69
-
70
- 系统支持增量事件。如果生产方能以较低成本发出 whole-value checkpoint,应优先采用,因为 start 位于已加载窗口之外时它仍可直接使用。每条 delta 都必须携带稳定 id,并且按照日志 `seq` 升序回放时能够确定性地产生 State;它不能依赖只存在于实时内存中的状态。如果当前历史窗口只有 update,Assembler 会保留一个 pending Context,并在更早分页补齐 start 前不构造 State。如果产品必须在 start 尚未加载时渲染,terminal 或 checkpoint 事件就必须携带足够的完整 fallback 状态,让 Definition 能直接构造结果;不要通过扫描无关事件恢复它。
71
-
72
- 实时 Assistant delta 作为 Client-only `assistant/live-chunk` event 到达。重连 baseline 会把活跃的进程内紧凑 stream 展开为相同的瞬态 event,持久 `assistant/message` 与 `assistant/attempt` event 则嵌入完整紧凑 stream 供历史回放。瞬态 event 可以初始化 Context。每条工具 delta 和后续 `tool/call` 都可以按同一个 callId 匹配为 start,即使名称尚未到达;只有最早的 Match 调用 `start()`,后续 Match 调用 `update()`。准备态 Tool 节点只有在名称可用后才显示。历史分页不把已结束消息展开为实时 delta。消费 Assistant 输出的 Definition 通过同一组匹配和更新接口处理 live chunk 与持久 settlement,其他 Definition 直接返回 `null`,无需展开 stream。
73
-
74
- <a id="definition-and-typed-chat-payload"></a>
75
-
76
- ## Definition 与类型化 Chat payload
77
-
78
- 为了完整展示关联关系,下面把生产方声明和 Client 贡献写在同一个代码块里。实际的包族中,branded id 与 `SessionEventMap` 声明留在事件生产方,Definition、Chat data 合并与 renderer 留在 Client 插件。
79
-
80
- ```ts ignore-check
81
- import { createElement } from 'react'
82
- import type { Context as ClientContext } from '@deepseek-ai/cordis'
83
- import type { Branded } from '@deepseek-ai/dsh-brand'
84
- import type {
85
- ConversationLocation, ConversationNodeContext,
86
- ConversationNodeDefinition,
87
- } from '@deepseek-ai/dsh-client-ui-conversation/client'
88
- import type { ChatNodeViewProps } from '@deepseek-ai/dsh-client-ui-chat/client'
89
-
90
- type ReviewId = Branded<'ReviewId'>
91
-
92
- interface ReviewStartData {
93
- readonly reviewId: ReviewId
94
- readonly turn: number
95
- readonly step: number
96
- readonly title: string
97
- }
98
-
99
- interface ReviewProgressData {
100
- readonly reviewId: ReviewId
101
- readonly turn: number
102
- readonly step: number
103
- readonly completed: number
104
- }
105
-
106
- interface ReviewEndData {
107
- readonly reviewId: ReviewId
108
- readonly turn: number
109
- readonly step: number
110
- readonly summary: string
111
- }
112
-
113
- declare module '@deepseek-ai/dsh-session/types' {
114
- interface SessionEventMap {
115
- /**
116
- * Opens one durable review job.
117
- * @mode emit
118
- * @param data - stable identity, location, and initial display state.
119
- */
120
- 'review/start': ReviewStartData
121
- /**
122
- * Records replayable progress for one review job.
123
- * @mode emit
124
- * @param data - stable identity, location, and latest progress.
125
- */
126
- 'review/progress': ReviewProgressData
127
- /**
128
- * Closes one review job with its final summary.
129
- * @mode emit
130
- * @param data - stable identity, location, and final display state.
131
- */
132
- 'review/end': ReviewEndData
133
- }
134
- }
135
-
136
- interface ReviewChatData {
137
- readonly title: string
138
- readonly completed: number
139
- readonly status: 'running' | 'completed'
140
- readonly summary?: string
141
- }
142
-
143
- declare module '@deepseek-ai/dsh-client-ui-chat/client' {
144
- interface ChatNodeDataMap {
145
- 'review-job': ReviewChatData
146
- }
147
- }
148
-
149
- declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
150
- interface ConversationStepDataMap {
151
- 'review-job': ReviewChatData
152
- }
153
- }
154
-
155
- interface ReviewState extends ReviewChatData {
156
- readonly turn: number
157
- readonly step: number
158
- }
159
-
160
- function locationOf(context: ConversationNodeContext): ConversationLocation {
161
- return context.start?.location ?? context.matches[0]?.location ?? { kind: 'unresolved' }
162
- }
163
-
164
- function viewData(state: ReviewState): ReviewChatData {
165
- return {
166
- title: state.title,
167
- completed: state.completed,
168
- status: state.status,
169
- ...state.summary === undefined ? {} : { summary: state.summary },
170
- }
171
- }
172
-
173
- const reviewDefinition: ConversationNodeDefinition<ReviewState> = {
174
- kind: 'review-job',
175
- target: 'chat',
176
- match: (event) => {
177
- if (event.type === 'review/start') {
178
- return { id: String(event.data.reviewId), role: 'start' }
179
- }
180
- if (event.type === 'review/progress' || event.type === 'review/end') {
181
- return { id: String(event.data.reviewId), role: 'update' }
182
- }
183
- return null
184
- },
185
- start: (_context, match) => {
186
- if (match.event.type !== 'review/start') throw new Error('review-job requires review/start')
187
- return {
188
- turn: match.event.data.turn,
189
- step: match.event.data.step,
190
- title: match.event.data.title,
191
- completed: 0,
192
- status: 'running',
193
- }
194
- },
195
- update: (context, match) => {
196
- if (match.event.type === 'review/progress') {
197
- return { ...context.state, completed: match.event.data.completed }
198
- }
199
- if (match.event.type === 'review/end') {
200
- return { ...context.state, completed: 100, status: 'completed', summary: match.event.data.summary }
201
- }
202
- return context.state
203
- },
204
- publication: match => match.event.type === 'review/progress'
205
- ? 'animation-frame'
206
- : 'immediate',
207
- buildLocationData: (context, scope) => {
208
- if (scope !== 'step' || context.state === undefined) return null
209
- return {
210
- kind: 'step',
211
- turn: context.state.turn,
212
- step: context.state.step,
213
- key: 'review-job',
214
- value: viewData(context.state),
215
- }
216
- },
217
- buildViewNode: (context) => {
218
- if (context.state === undefined) return null
219
- return {
220
- key: context.key,
221
- kind: 'review-job',
222
- id: context.id,
223
- target: 'chat',
224
- anchorSeq: context.start?.event.seq ?? context.matches[0]?.event.seq ?? 0,
225
- location: locationOf(context),
226
- visibility: 'visible',
227
- data: viewData(context.state),
228
- }
229
- },
230
- }
231
-
232
- function ReviewNodeView({ node }: ChatNodeViewProps<'review-job'>) {
233
- const text = node.data.summary ?? `${node.data.title}: ${node.data.completed}%`
234
- return createElement('p', null, text)
235
- }
236
-
237
- export const inject = ['uiConversation', 'slots']
238
-
239
- export function apply(ctx: ClientContext): void {
240
- ctx.uiConversation.events.register(reviewDefinition)
241
- ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({
242
- name: 'conversation.chat.node',
243
- key: 'review-job',
244
- }, ReviewNodeView))
245
- }
246
- ```
247
-
248
- `match(event)` 是身份提取器,不是 fold:它只能收到当前 `SessionEventLike`,并返回 Definition 内部 id 与生命周期角色。命中后,Assembler 通过 `(kind, id)` 定位 Context;当前最早的 start 初始化 State,不论它是持久事件还是瞬态事件。后续所有 Match,包括其他 start,都调用 `update`。移除瞬态 Match 后,从剩余事件重新选择 start 并重算 State;没有剩余 start 时 State 为 undefined。两个函数都必须返回引擎随后采用的 State;推荐返回新的 immutable value,但函数原地修改后返回同一对象时,采用语义也相同。
249
-
250
- `ConversationNodeDefinitionInput` 接受上述函数,或事件类型到匹配函数的只读表。函数形式的注册接收所有事件;表形式只接收列出的类型。Registry 在注册关系变化时复制表条目并预计算有序候选 Set,不在逐事件分发时构造候选集合。替换表时先注销,再重新注册。两种形式解析后的 `ConversationNodeDefinition` 都保留可调用的 `match(event)`。
251
-
252
- match 结果带 `exclusive: true` 时,即在该 Definition 的 target 上认领这个事件。Assembler 先求出该事件的全部 match,再逐个接收,因此结果与注册顺序无关:被认领 target 上的其他 Definition 不为该事件建立 Context,该 target 的未匹配事件 fallback 也不运行;其他 target 的 Definition 与没有 target 的 Definition 照常接收。同一 target 被认领两次,或没有 target 的 Definition 发起认领,都会在分发时抛错;fallback 自身返回的认领不起作用。业务 Definition 用认领来呈现某一类消息,而同一 target 上的通用 Definition 原本也会呈现它,例如迟到的问题回答。
253
-
254
- `buildLocationData(context, scope)` 可以把 Definition 拥有的数据发布到引擎拥有的 Turn 或 Step 上。通过 declaration merging 为每个 key 指定精确 value 类型。同一 Location 内的另一个 Node 可以使用受限 slot hook(例如 `useTurnData(key)`)读取该值,无须取得 Session,也无须扫描 `snapshot.chat.nodes`。
255
-
256
- `target` 与 `buildViewNode(context)` 必须同时声明一项由 target 拥有的渲染贡献。把 `context.key` 保留为 React 侧身份,根据持久排序证据选择 `anchorSeq`,并且只返回 renderer 可以直接使用的数据。某个 target Node 一旦发布,就要继续返回同一个 key;需要暂时离开可见流时使用 `visibility: 'hidden'`,不要改为返回 `null` 撤回它。
257
-
258
- Chat Node 还通过 `groupTree` 选择所在行的位置。位置由外到内排列,站在某个位置的 Node 同时具有所有内层位置的效果。Chat 的过程分组、整轮折叠和轮次输入判断只读取这个位置;完整契约见 [group-tree.ts](../../packages/client/ui-chat/src/client/contract/group-tree.ts)。
259
-
260
- | Node 是 | 声明 |
261
- |---|---|
262
- | Step 1 认领的人的输入,所在轮次开启一个交互段 | `exchange` |
263
- | 所在轮次的其他输入,如之后的人的输入或触发通知;位于过程之前时是开场输入,之后出现时整个轮次保持展开 | `input` |
264
- | 留在整轮折叠之外的轮次通知,如错误或已完成轮次页脚 | `turn` |
265
- | 整轮折叠仍会隐藏的独立行,如模型重试 | `process` |
266
- | 并入相邻步骤组的普通过程内容 | 不声明 `groupTree` |
267
-
268
- 各内置 Node 声明的位置见 [Chat 业务规则](../../packages/client/ui-chat/src/client/conversation-nodes/README.zh.md#process-grouping)。如果同一 target 的通用 Definition 也会匹配你的 Node 所呈现的事件,按上文用 `exclusive: true` 认领该事件。
269
-
270
- ## Predecessor read
271
-
272
- 有些 Definition 需要另一个业务 kind 在当前位置之前的最新 State。`start` 会收到 `ConversationContextReader`;应在这里调用 `reader.previous<State>(kind)`,不要接收 Context 集合或扫描事件。Reader 返回当前 start `seq` 之前最近一个已启动 Context 的只读数据。
273
-
274
- Assembler 会记录这项依赖。如果后续 older prepend 带来了更近的前序 Context、补齐了原先未知的窗口缺口,或者前序 State 被修订,引擎会从 `start` 重新运行依赖方 Context,并按 `seq` 升序回放其 update。被查询的 Definition 仍负责把有用信息写入自身 State;Reader 不提供业务专用查询方法,也不授予修改其他 Context 的权限。
275
-
276
- ## Window 更新路径
277
-
278
- 历史可能从尾部开始一页一页向前请求。Session journal 先校验互不重叠的逻辑 seq range,Assembler 再按每个已接受 input 的首 `seq` 排序并进入 State 回放。
279
-
280
- | 路径 | 引擎工作 | Definition 可观察到的行为 |
281
- |---|---|---|
282
- | open、resync 或 gap repair 时 replace | 重建已加载窗口,每条标准 event 或 packed run 对每个 Definition 匹配一次,再回放每个已有 start 的 Context | 先执行 `start`,再按逻辑 `seq` 升序执行其 update;只有 update 的 pending Context 仍没有 State |
283
- | prepend 一页更早历史 | 只匹配新增的更早 input,按 `(kind, id)` 合并进 Context,保留现有 keyed node,并只重放受影响的 Context 与依赖 | 新发现的 scalar start 会激活已收集的 scalar 与 packed update;Location 或前序依赖变化也可能重跑 Context |
284
- | append 一条实时事件 | 每个 Definition 各调用一次 `match`,按 key 查找命中的 Context,只更新该 Context | 对 start 之后的匹配事件执行一次 scalar `update` 并请求一次发布;不扫描已有 Context |
285
-
286
- 注册 `D` 个 Definition 时,一条新 scalar event 或 packed run 会进行 `D` 次仅当前 input 匹配;命中后的 Context key 查询是常数时间。Definition 代码必须维持这个性质:正常 append 热路径不得遍历完整事件窗口、所有 Context、`context.matches` 或已渲染 Node 集合。累计事实放进 State,同 Turn/Step 共享信息放进 Location data,有索引的前序依赖使用 `reader.previous()`。
287
-
288
- `publication` 控制发生 State 变更后何时物化。结构或 terminal 变化使用 `immediate`,高频可见 delta 使用 `animation-frame`,只为后续发布积累 State 时使用 `none`。引擎按日志顺序应用每条 scalar update,并用一次 batch update 应用一个 packed run;该选项只合并视图发布频率。
289
-
290
- ## 验证要求
291
-
292
- 添加聚焦测试,证明以下结果:
293
-
294
- 1. 完整窗口通过 replace 后产生预期的最终 State、Location data、Node payload 与 `anchorSeq`。
295
- 2. 只有 update 的尾部窗口保持 pending;prepend 其 start 后,结果与完整 replace 相同。
296
- 3. 初始历史后继续实时 append,与回放合并后的完整窗口得到相同结果。
297
- 4. prepend 更早分页只增加更早的行;数据未变化的既有 keyed Node value 不被替换。
298
- 5. 重复的可见 delta 保持 `context.key`,并在请求 `animation-frame` 时每帧最多发布一次。
299
- 6. keyed renderer 只消费 `node.data` 与受限 Location hook,不扫描 Session 事件窗口、Context 或 Chat Node。
300
- 7. scalar 与 packed Assistant 历史产生相同的最终 State、timing boundary 和 target snapshot;一个 packed run 在 replace、prepend、Location replay 与 registry rebuild 中始终只保留一个 Match。
301
- 8. 创建 target source 不执行 builder 工作;显式选择或首次订阅执行一次完整 replace,后续更新送达所有 active target,重复激活不会再次 replace。
302
-
303
- 流式与中断处理可参考 [`packages/client/ui-chat/src/client/conversation-nodes/assistant.ts`](../../packages/client/ui-chat/src/client/conversation-nodes/assistant.ts),前序查询可参考 [`inbox.ts`](../../packages/client/ui-chat/src/client/conversation-nodes/inbox.ts) 与 [`message.ts`](../../packages/client/ui-chat/src/client/conversation-nodes/message.ts),只发布 Turn data 而不创建自有 Node 的例子见 [`packages/client/ui-deliverables`](../../packages/client/ui-deliverables)。
@@ -1,37 +0,0 @@
1
- # Bilingual-pair consistency record for core.md (docs/i18n/README.md): per heading
2
- # section, a hash of its English and Chinese blocks outside code blocks and generated regions.
3
- # After editing either side, bring the other along and re-record with:
4
- # pnpm run verify-translation-pairing --write docs/subsystems/core.md
5
- /core:
6
- en: f6ae07d8902e8edf
7
- zh: c92fef531c6da331
8
- /core/the-spine-package-by-package:
9
- en: c90cb23528ddb6c8
10
- zh: 62724b7255b586b6
11
- /core/creation-and-ownership:
12
- en: ab09a38b4e1f0883
13
- zh: 81e2d14c4036ab6c
14
- /core/the-agent-handle:
15
- en: c21787347d8e2b14
16
- zh: 25bc9cb60ee1520a
17
- /core/initiating-agent:
18
- en: 6c8c47ac78de2dde
19
- zh: c9d527a25a85d1d9
20
- /core/interception-decisions:
21
- en: 6fccceb0a5f1cad9
22
- zh: f43c30c2386d8cc8
23
- /core/sessions:
24
- en: 9a38f693a00fa80d
25
- zh: d0f66664ac85ae64
26
- /core/tooldefinition:
27
- en: d926a9b80aada2e5
28
- zh: 7e191ba5dab904df
29
- /core/repo-wide-type-patterns:
30
- en: 057db6d8bf356c0f
31
- zh: 1441b39e5142b0bf
32
- /core/repo-wide-type-patterns/the-map-derived-union-pattern:
33
- en: 84c039e929edb897
34
- zh: 84241bb993f23ef2
35
- /core/repo-wide-type-patterns/branded-ids:
36
- en: 10f8ac0f97e7c54a
37
- zh: 75cd2311aabfe464