dsh-plugin-guide 0.3.10 → 0.3.16

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 (431) hide show
  1. package/README-es.md +13 -3
  2. package/README-hi.md +13 -3
  3. package/README-pt.md +13 -3
  4. package/README-zh.md +13 -3
  5. package/README.md +12 -3
  6. package/SKILL.md +1 -1
  7. package/guide/links.md +1 -0
  8. package/guide/unfixed-issues.md +111 -0
  9. package/package.json +1 -1
  10. package/references/official-docs/AGENTS.md +74 -49
  11. package/references/official-docs/README.i18n.yaml +2 -2
  12. package/references/official-docs/README.zh.md +12 -0
  13. package/references/official-docs/SNAPSHOT.md +4 -4
  14. package/references/official-docs/THIRD_PARTY_NOTICES.md +86 -30
  15. package/references/official-docs/docs/AGENTS.md +7 -6
  16. package/references/official-docs/docs/agent-lifecycle.i18n.yaml +2 -2
  17. package/references/official-docs/docs/agent-lifecycle.md +12 -5
  18. package/references/official-docs/docs/agent-lifecycle.zh.md +12 -5
  19. package/references/official-docs/docs/api-gateway.i18n.yaml +2 -2
  20. package/references/official-docs/docs/api-gateway.md +2 -2
  21. package/references/official-docs/docs/api-gateway.zh.md +2 -2
  22. package/references/official-docs/docs/architecture.i18n.yaml +2 -2
  23. package/references/official-docs/docs/architecture.md +26 -12
  24. package/references/official-docs/docs/architecture.zh.md +28 -14
  25. package/references/official-docs/docs/capability-seams.i18n.yaml +2 -2
  26. package/references/official-docs/docs/capability-seams.md +111 -31
  27. package/references/official-docs/docs/capability-seams.zh.md +111 -31
  28. package/references/official-docs/docs/config-catalog.i18n.yaml +2 -2
  29. package/references/official-docs/docs/config-catalog.md +674 -202
  30. package/references/official-docs/docs/config-catalog.zh.md +691 -219
  31. package/references/official-docs/docs/cookbook/adding-a-session-format-version.i18n.yaml +6 -0
  32. package/references/official-docs/docs/cookbook/adding-a-session-format-version.md +111 -0
  33. package/references/official-docs/docs/cookbook/adding-a-session-format-version.zh.md +111 -0
  34. package/references/official-docs/docs/cookbook/adding-a-settings-card.zh.md +1 -1
  35. package/references/official-docs/docs/cookbook/adding-a-tool.i18n.yaml +2 -2
  36. package/references/official-docs/docs/cookbook/adding-a-tool.md +2 -2
  37. package/references/official-docs/docs/cookbook/adding-a-tool.zh.md +4 -4
  38. package/references/official-docs/docs/cookbook/adding-a-vendored-package.i18n.yaml +2 -2
  39. package/references/official-docs/docs/cookbook/adding-a-vendored-package.md +1 -1
  40. package/references/official-docs/docs/cookbook/adding-a-vendored-package.zh.md +1 -1
  41. package/references/official-docs/docs/cookbook/adding-an-llm-adapter.zh.md +1 -1
  42. package/references/official-docs/docs/cookbook/extension-cookbook.i18n.yaml +2 -2
  43. package/references/official-docs/docs/cookbook/extension-cookbook.md +3 -3
  44. package/references/official-docs/docs/cookbook/extension-cookbook.zh.md +5 -5
  45. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.i18n.yaml +2 -2
  46. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.md +1 -1
  47. package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.zh.md +1 -1
  48. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.i18n.yaml +6 -0
  49. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.md +108 -0
  50. package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.zh.md +108 -0
  51. package/references/official-docs/docs/cordis-api/fiber.i18n.yaml +2 -2
  52. package/references/official-docs/docs/cordis-api/fiber.md +3 -3
  53. package/references/official-docs/docs/cordis-api/fiber.zh.md +3 -3
  54. package/references/official-docs/docs/cordis-api/inherited.md +0 -3
  55. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.i18n.yaml +2 -2
  56. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.md +2 -2
  57. package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.zh.md +2 -2
  58. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.i18n.yaml +2 -2
  59. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.md +14 -15
  60. package/references/official-docs/docs/deepseek-llm-api-wire-extensions.zh.md +15 -16
  61. package/references/official-docs/docs/dependency-catalog.json +7312 -0
  62. package/references/official-docs/docs/development.i18n.yaml +2 -2
  63. package/references/official-docs/docs/development.md +13 -3
  64. package/references/official-docs/docs/development.zh.md +16 -6
  65. package/references/official-docs/docs/event-producer-consumer.i18n.yaml +2 -2
  66. package/references/official-docs/docs/event-producer-consumer.md +50 -39
  67. package/references/official-docs/docs/event-producer-consumer.zh.md +55 -44
  68. package/references/official-docs/docs/glossary.i18n.yaml +2 -2
  69. package/references/official-docs/docs/glossary.md +1 -1
  70. package/references/official-docs/docs/glossary.zh.md +1 -1
  71. package/references/official-docs/docs/i18n/README.i18n.yaml +2 -2
  72. package/references/official-docs/docs/i18n/README.md +8 -3
  73. package/references/official-docs/docs/i18n/README.zh.md +8 -3
  74. package/references/official-docs/docs/i18n/style-samples.md +1 -1
  75. package/references/official-docs/docs/i18n/translation-prompt.md +5 -5
  76. package/references/official-docs/docs/i18n/translation-rules.zh.md +2 -2
  77. package/references/official-docs/docs/module-graph.i18n.yaml +2 -2
  78. package/references/official-docs/docs/module-graph.md +303 -120
  79. package/references/official-docs/docs/module-graph.zh.md +303 -120
  80. package/references/official-docs/docs/persistence-catalog.i18n.yaml +2 -2
  81. package/references/official-docs/docs/persistence-catalog.md +5699 -64
  82. package/references/official-docs/docs/persistence-catalog.zh.md +5708 -73
  83. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.i18n.yaml +6 -0
  84. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.md +280 -0
  85. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.schema.json +13557 -0
  86. package/references/official-docs/docs/persistence-changes/2026-09-11-initial.zh.md +280 -0
  87. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.i18n.yaml +6 -0
  88. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.md +52 -0
  89. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.schema.json +910 -0
  90. package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.zh.md +52 -0
  91. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.i18n.yaml +6 -0
  92. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.md +96 -0
  93. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.schema.json +8478 -0
  94. package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.zh.md +96 -0
  95. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.i18n.yaml +6 -0
  96. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.md +48 -0
  97. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.schema.json +72 -0
  98. package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.zh.md +48 -0
  99. package/references/official-docs/docs/persistence-changes/README.i18n.yaml +6 -0
  100. package/references/official-docs/docs/persistence-changes/README.md +74 -0
  101. package/references/official-docs/docs/persistence-changes/README.zh.md +74 -0
  102. package/references/official-docs/docs/persistence-changes/historical-formats/README.i18n.yaml +6 -0
  103. package/references/official-docs/docs/persistence-changes/historical-formats/README.md +74 -0
  104. package/references/official-docs/docs/persistence-changes/historical-formats/README.zh.md +74 -0
  105. package/references/official-docs/docs/persistence-changes/historical-formats/v0.i18n.yaml +6 -0
  106. package/references/official-docs/docs/persistence-changes/historical-formats/v0.md +5105 -0
  107. package/references/official-docs/docs/persistence-changes/historical-formats/v0.schema.json +49308 -0
  108. package/references/official-docs/docs/persistence-changes/historical-formats/v0.zh.md +5105 -0
  109. package/references/official-docs/docs/persistence-changes/historical-formats/v1.i18n.yaml +6 -0
  110. package/references/official-docs/docs/persistence-changes/historical-formats/v1.md +5107 -0
  111. package/references/official-docs/docs/persistence-changes/historical-formats/v1.schema.json +49411 -0
  112. package/references/official-docs/docs/persistence-changes/historical-formats/v1.zh.md +5107 -0
  113. package/references/official-docs/docs/persistence-changes/historical-formats/v2.i18n.yaml +6 -0
  114. package/references/official-docs/docs/persistence-changes/historical-formats/v2.md +5362 -0
  115. package/references/official-docs/docs/persistence-changes/historical-formats/v2.schema.json +56466 -0
  116. package/references/official-docs/docs/persistence-changes/historical-formats/v2.zh.md +5362 -0
  117. package/references/official-docs/docs/persistence-changes/releases/README.i18n.yaml +6 -0
  118. package/references/official-docs/docs/persistence-changes/releases/README.md +103 -0
  119. package/references/official-docs/docs/persistence-changes/releases/README.zh.md +103 -0
  120. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.i18n.yaml +6 -0
  121. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.md +201 -0
  122. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.schema.json +39868 -0
  123. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.zh.md +201 -0
  124. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.i18n.yaml +6 -0
  125. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.md +261 -0
  126. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.schema.json +43342 -0
  127. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.zh.md +261 -0
  128. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.i18n.yaml +6 -0
  129. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.md +126 -0
  130. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.schema.json +19452 -0
  131. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.zh.md +126 -0
  132. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.i18n.yaml +6 -0
  133. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.md +75 -0
  134. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.schema.json +5 -0
  135. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.zh.md +75 -0
  136. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.i18n.yaml +6 -0
  137. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.md +75 -0
  138. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.schema.json +5 -0
  139. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.zh.md +75 -0
  140. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.i18n.yaml +6 -0
  141. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.md +75 -0
  142. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.schema.json +5 -0
  143. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.zh.md +75 -0
  144. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.i18n.yaml +6 -0
  145. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.md +75 -0
  146. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.schema.json +5 -0
  147. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.zh.md +75 -0
  148. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.i18n.yaml +6 -0
  149. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.md +75 -0
  150. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.schema.json +5 -0
  151. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.zh.md +75 -0
  152. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.i18n.yaml +6 -0
  153. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.md +75 -0
  154. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.schema.json +5 -0
  155. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.zh.md +75 -0
  156. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.i18n.yaml +6 -0
  157. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.md +75 -0
  158. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.schema.json +5 -0
  159. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.zh.md +75 -0
  160. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.i18n.yaml +6 -0
  161. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.md +82 -0
  162. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.schema.json +5320 -0
  163. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.zh.md +82 -0
  164. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.i18n.yaml +6 -0
  165. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.md +110 -0
  166. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.schema.json +21258 -0
  167. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.zh.md +110 -0
  168. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.i18n.yaml +6 -0
  169. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.md +82 -0
  170. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.schema.json +417 -0
  171. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.zh.md +82 -0
  172. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.i18n.yaml +6 -0
  173. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.md +119 -0
  174. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.schema.json +29672 -0
  175. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.zh.md +119 -0
  176. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.i18n.yaml +6 -0
  177. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.md +295 -0
  178. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.schema.json +48429 -0
  179. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.zh.md +295 -0
  180. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.i18n.yaml +6 -0
  181. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.md +286 -0
  182. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.schema.json +49347 -0
  183. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.zh.md +286 -0
  184. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.i18n.yaml +6 -0
  185. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.md +75 -0
  186. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.schema.json +5 -0
  187. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.zh.md +75 -0
  188. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.i18n.yaml +6 -0
  189. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.md +95 -0
  190. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.schema.json +17642 -0
  191. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.zh.md +95 -0
  192. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.i18n.yaml +6 -0
  193. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.md +75 -0
  194. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.schema.json +5 -0
  195. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.zh.md +75 -0
  196. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.i18n.yaml +6 -0
  197. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.md +75 -0
  198. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.schema.json +5 -0
  199. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.zh.md +75 -0
  200. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.i18n.yaml +6 -0
  201. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.md +154 -0
  202. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.schema.json +38678 -0
  203. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.zh.md +154 -0
  204. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.i18n.yaml +6 -0
  205. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.md +86 -0
  206. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.schema.json +783 -0
  207. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.zh.md +86 -0
  208. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.i18n.yaml +6 -0
  209. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.md +139 -0
  210. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.schema.json +24597 -0
  211. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.zh.md +139 -0
  212. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.i18n.yaml +6 -0
  213. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.md +95 -0
  214. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.schema.json +2132 -0
  215. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.zh.md +95 -0
  216. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.i18n.yaml +6 -0
  217. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.md +75 -0
  218. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.schema.json +5 -0
  219. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.zh.md +75 -0
  220. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.i18n.yaml +6 -0
  221. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.md +75 -0
  222. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.schema.json +5 -0
  223. package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.zh.md +75 -0
  224. package/references/official-docs/docs/persistence-changes/releases/manifest.json +162 -0
  225. package/references/official-docs/docs/persistence-schema.json +61480 -0
  226. package/references/official-docs/docs/postmortem/README.i18n.yaml +1 -1
  227. package/references/official-docs/docs/postmortem/README.md +1 -1
  228. package/references/official-docs/docs/postmortem/README.zh.md +1 -1
  229. package/references/official-docs/docs/rescope.i18n.yaml +2 -2
  230. package/references/official-docs/docs/rescope.md +2 -2
  231. package/references/official-docs/docs/rescope.zh.md +2 -2
  232. package/references/official-docs/docs/session-format-status.i18n.yaml +6 -0
  233. package/references/official-docs/docs/session-format-status.md +49 -0
  234. package/references/official-docs/docs/session-format-status.zh.md +49 -0
  235. package/references/official-docs/docs/subsystems/README.i18n.yaml +2 -2
  236. package/references/official-docs/docs/subsystems/README.md +12 -3
  237. package/references/official-docs/docs/subsystems/README.zh.md +23 -14
  238. package/references/official-docs/docs/subsystems/agent-team.i18n.yaml +2 -2
  239. package/references/official-docs/docs/subsystems/agent-team.md +1 -1
  240. package/references/official-docs/docs/subsystems/agent-team.zh.md +2 -2
  241. package/references/official-docs/docs/subsystems/approval.i18n.yaml +2 -2
  242. package/references/official-docs/docs/subsystems/approval.md +1 -1
  243. package/references/official-docs/docs/subsystems/approval.zh.md +1 -1
  244. package/references/official-docs/docs/subsystems/attachment.i18n.yaml +2 -2
  245. package/references/official-docs/docs/subsystems/attachment.md +17 -7
  246. package/references/official-docs/docs/subsystems/attachment.zh.md +17 -7
  247. package/references/official-docs/docs/subsystems/{code-runtime.i18n.yaml → boot.i18n.yaml} +3 -3
  248. package/references/official-docs/docs/subsystems/boot.md +223 -0
  249. package/references/official-docs/docs/subsystems/boot.zh.md +223 -0
  250. package/references/official-docs/docs/subsystems/browser-use.i18n.yaml +6 -0
  251. package/references/official-docs/docs/subsystems/browser-use.md +67 -0
  252. package/references/official-docs/docs/subsystems/browser-use.zh.md +67 -0
  253. package/references/official-docs/docs/subsystems/client-modules.i18n.yaml +2 -2
  254. package/references/official-docs/docs/subsystems/client-modules.md +20 -10
  255. package/references/official-docs/docs/subsystems/client-modules.zh.md +21 -11
  256. package/references/official-docs/docs/subsystems/client-resources.i18n.yaml +6 -0
  257. package/references/official-docs/docs/subsystems/client-resources.md +92 -0
  258. package/references/official-docs/docs/subsystems/client-resources.zh.md +92 -0
  259. package/references/official-docs/docs/subsystems/commands.i18n.yaml +2 -2
  260. package/references/official-docs/docs/subsystems/commands.md +4 -0
  261. package/references/official-docs/docs/subsystems/commands.zh.md +5 -1
  262. package/references/official-docs/docs/subsystems/compaction.i18n.yaml +2 -2
  263. package/references/official-docs/docs/subsystems/compaction.md +48 -2
  264. package/references/official-docs/docs/subsystems/compaction.zh.md +50 -4
  265. package/references/official-docs/docs/subsystems/computer-use.i18n.yaml +6 -0
  266. package/references/official-docs/docs/subsystems/computer-use.md +56 -0
  267. package/references/official-docs/docs/subsystems/computer-use.zh.md +56 -0
  268. package/references/official-docs/docs/subsystems/conversation.zh.md +1 -1
  269. package/references/official-docs/docs/subsystems/core.i18n.yaml +2 -2
  270. package/references/official-docs/docs/subsystems/core.md +106 -60
  271. package/references/official-docs/docs/subsystems/core.zh.md +109 -63
  272. package/references/official-docs/docs/subsystems/deliverables.i18n.yaml +6 -0
  273. package/references/official-docs/docs/subsystems/deliverables.md +178 -0
  274. package/references/official-docs/docs/subsystems/deliverables.zh.md +178 -0
  275. package/references/official-docs/docs/subsystems/extensions.zh.md +1 -1
  276. package/references/official-docs/docs/subsystems/feedback.i18n.yaml +2 -2
  277. package/references/official-docs/docs/subsystems/feedback.md +165 -31
  278. package/references/official-docs/docs/subsystems/feedback.zh.md +165 -31
  279. package/references/official-docs/docs/subsystems/filesystem.i18n.yaml +2 -2
  280. package/references/official-docs/docs/subsystems/filesystem.md +15 -0
  281. package/references/official-docs/docs/subsystems/filesystem.zh.md +16 -1
  282. package/references/official-docs/docs/subsystems/goal.i18n.yaml +2 -2
  283. package/references/official-docs/docs/subsystems/goal.md +37 -1
  284. package/references/official-docs/docs/subsystems/goal.zh.md +38 -2
  285. package/references/official-docs/docs/subsystems/invariants.i18n.yaml +2 -2
  286. package/references/official-docs/docs/subsystems/invariants.md +1 -1
  287. package/references/official-docs/docs/subsystems/invariants.zh.md +3 -3
  288. package/references/official-docs/docs/subsystems/jobs.i18n.yaml +1 -1
  289. package/references/official-docs/docs/subsystems/jobs.md +1 -1
  290. package/references/official-docs/docs/subsystems/jobs.zh.md +1 -1
  291. package/references/official-docs/docs/subsystems/llm-streaming.i18n.yaml +2 -2
  292. package/references/official-docs/docs/subsystems/llm-streaming.md +35 -15
  293. package/references/official-docs/docs/subsystems/llm-streaming.zh.md +37 -17
  294. package/references/official-docs/docs/subsystems/lsp.i18n.yaml +2 -2
  295. package/references/official-docs/docs/subsystems/lsp.md +1 -1
  296. package/references/official-docs/docs/subsystems/lsp.zh.md +1 -1
  297. package/references/official-docs/docs/subsystems/mcp.i18n.yaml +6 -0
  298. package/references/official-docs/docs/subsystems/mcp.md +139 -0
  299. package/references/official-docs/docs/subsystems/mcp.zh.md +139 -0
  300. package/references/official-docs/docs/subsystems/office-to-pdf.i18n.yaml +6 -0
  301. package/references/official-docs/docs/subsystems/office-to-pdf.md +87 -0
  302. package/references/official-docs/docs/subsystems/office-to-pdf.zh.md +87 -0
  303. package/references/official-docs/docs/subsystems/permission-presets.i18n.yaml +2 -2
  304. package/references/official-docs/docs/subsystems/permission-presets.md +62 -27
  305. package/references/official-docs/docs/subsystems/permission-presets.zh.md +62 -27
  306. package/references/official-docs/docs/subsystems/persistence.i18n.yaml +2 -2
  307. package/references/official-docs/docs/subsystems/persistence.md +36 -15
  308. package/references/official-docs/docs/subsystems/persistence.zh.md +36 -15
  309. package/references/official-docs/docs/subsystems/plan.zh.md +2 -2
  310. package/references/official-docs/docs/subsystems/ptc-runtime.i18n.yaml +6 -0
  311. package/references/official-docs/docs/subsystems/ptc-runtime.md +232 -0
  312. package/references/official-docs/docs/subsystems/ptc-runtime.zh.md +232 -0
  313. package/references/official-docs/docs/subsystems/sandbox.i18n.yaml +2 -2
  314. package/references/official-docs/docs/subsystems/sandbox.md +5 -4
  315. package/references/official-docs/docs/subsystems/sandbox.zh.md +7 -6
  316. package/references/official-docs/docs/subsystems/schedule.i18n.yaml +2 -2
  317. package/references/official-docs/docs/subsystems/schedule.md +2 -2
  318. package/references/official-docs/docs/subsystems/schedule.zh.md +3 -3
  319. package/references/official-docs/docs/subsystems/scope.i18n.yaml +2 -2
  320. package/references/official-docs/docs/subsystems/scope.md +1 -1
  321. package/references/official-docs/docs/subsystems/scope.zh.md +1 -1
  322. package/references/official-docs/docs/subsystems/session-projection.i18n.yaml +2 -2
  323. package/references/official-docs/docs/subsystems/session-projection.md +1 -1
  324. package/references/official-docs/docs/subsystems/session-projection.zh.md +2 -2
  325. package/references/official-docs/docs/subsystems/session-reference.i18n.yaml +2 -2
  326. package/references/official-docs/docs/subsystems/session-reference.md +11 -6
  327. package/references/official-docs/docs/subsystems/session-reference.zh.md +11 -6
  328. package/references/official-docs/docs/subsystems/session-telemetry.i18n.yaml +2 -2
  329. package/references/official-docs/docs/subsystems/session-telemetry.md +22 -6
  330. package/references/official-docs/docs/subsystems/session-telemetry.zh.md +23 -7
  331. package/references/official-docs/docs/subsystems/session-title.i18n.yaml +2 -2
  332. package/references/official-docs/docs/subsystems/session-title.md +5 -5
  333. package/references/official-docs/docs/subsystems/session-title.zh.md +5 -5
  334. package/references/official-docs/docs/subsystems/session.i18n.yaml +2 -2
  335. package/references/official-docs/docs/subsystems/session.md +149 -61
  336. package/references/official-docs/docs/subsystems/session.zh.md +150 -62
  337. package/references/official-docs/docs/subsystems/shell.i18n.yaml +2 -2
  338. package/references/official-docs/docs/subsystems/shell.md +19 -15
  339. package/references/official-docs/docs/subsystems/shell.zh.md +20 -16
  340. package/references/official-docs/docs/subsystems/sidebar-right.i18n.yaml +6 -0
  341. package/references/official-docs/docs/subsystems/sidebar-right.md +153 -0
  342. package/references/official-docs/docs/subsystems/sidebar-right.zh.md +153 -0
  343. package/references/official-docs/docs/subsystems/skills.i18n.yaml +2 -2
  344. package/references/official-docs/docs/subsystems/skills.md +4 -6
  345. package/references/official-docs/docs/subsystems/skills.zh.md +4 -6
  346. package/references/official-docs/docs/subsystems/slots.i18n.yaml +2 -2
  347. package/references/official-docs/docs/subsystems/slots.md +52 -38
  348. package/references/official-docs/docs/subsystems/slots.zh.md +53 -39
  349. package/references/official-docs/docs/subsystems/spill.i18n.yaml +2 -2
  350. package/references/official-docs/docs/subsystems/spill.md +13 -6
  351. package/references/official-docs/docs/subsystems/spill.zh.md +13 -6
  352. package/references/official-docs/docs/subsystems/ssh.i18n.yaml +6 -0
  353. package/references/official-docs/docs/subsystems/ssh.md +135 -0
  354. package/references/official-docs/docs/subsystems/ssh.zh.md +135 -0
  355. package/references/official-docs/docs/subsystems/storage.zh.md +2 -2
  356. package/references/official-docs/docs/subsystems/subagent.i18n.yaml +2 -2
  357. package/references/official-docs/docs/subsystems/subagent.md +33 -16
  358. package/references/official-docs/docs/subsystems/subagent.zh.md +32 -15
  359. package/references/official-docs/docs/subsystems/subprocess.i18n.yaml +2 -2
  360. package/references/official-docs/docs/subsystems/subprocess.md +41 -44
  361. package/references/official-docs/docs/subsystems/subprocess.zh.md +41 -44
  362. package/references/official-docs/docs/subsystems/system-prompt.i18n.yaml +2 -2
  363. package/references/official-docs/docs/subsystems/system-prompt.md +6 -2
  364. package/references/official-docs/docs/subsystems/system-prompt.zh.md +7 -3
  365. package/references/official-docs/docs/subsystems/todo.zh.md +1 -1
  366. package/references/official-docs/docs/subsystems/token-meter.i18n.yaml +2 -2
  367. package/references/official-docs/docs/subsystems/token-meter.md +2 -1
  368. package/references/official-docs/docs/subsystems/token-meter.zh.md +2 -1
  369. package/references/official-docs/docs/subsystems/tools.i18n.yaml +2 -2
  370. package/references/official-docs/docs/subsystems/tools.md +28 -12
  371. package/references/official-docs/docs/subsystems/tools.zh.md +28 -12
  372. package/references/official-docs/docs/subsystems/typert.i18n.yaml +2 -2
  373. package/references/official-docs/docs/subsystems/typert.md +6 -5
  374. package/references/official-docs/docs/subsystems/typert.zh.md +6 -5
  375. package/references/official-docs/docs/subsystems/user-questions.i18n.yaml +2 -2
  376. package/references/official-docs/docs/subsystems/user-questions.md +2 -0
  377. package/references/official-docs/docs/subsystems/user-questions.zh.md +2 -0
  378. package/references/official-docs/docs/subsystems/web-client.i18n.yaml +2 -2
  379. package/references/official-docs/docs/subsystems/web-client.md +5 -5
  380. package/references/official-docs/docs/subsystems/web-client.zh.md +6 -6
  381. package/references/official-docs/docs/subsystems/web-server.i18n.yaml +2 -2
  382. package/references/official-docs/docs/subsystems/web-server.md +64 -0
  383. package/references/official-docs/docs/subsystems/web-server.zh.md +65 -1
  384. package/references/official-docs/docs/subsystems/webhook.i18n.yaml +1 -1
  385. package/references/official-docs/docs/subsystems/webhook.md +2 -2
  386. package/references/official-docs/docs/subsystems/workflow.i18n.yaml +2 -2
  387. package/references/official-docs/docs/subsystems/workflow.md +8 -8
  388. package/references/official-docs/docs/subsystems/workflow.zh.md +10 -10
  389. package/references/official-docs/docs/subsystems/workspace.i18n.yaml +2 -2
  390. package/references/official-docs/docs/subsystems/workspace.md +199 -1
  391. package/references/official-docs/docs/subsystems/workspace.zh.md +199 -1
  392. package/references/official-docs/docs/testing.i18n.yaml +2 -2
  393. package/references/official-docs/docs/testing.md +5 -4
  394. package/references/official-docs/docs/testing.zh.md +5 -4
  395. package/references/official-docs/docs/tool-catalog.i18n.yaml +2 -2
  396. package/references/official-docs/docs/tool-catalog.md +452 -187
  397. package/references/official-docs/docs/tool-catalog.zh.md +454 -189
  398. package/references/official-docs/docs/tool-execution-pipeline.i18n.yaml +2 -2
  399. package/references/official-docs/docs/tool-execution-pipeline.md +2 -2
  400. package/references/official-docs/docs/tool-execution-pipeline.zh.md +2 -2
  401. package/references/official-docs/docs/user/develop/basic/index.zh.md +1 -1
  402. package/references/official-docs/docs/user/develop/basic/publish.i18n.yaml +2 -2
  403. package/references/official-docs/docs/user/develop/basic/publish.md +2 -2
  404. package/references/official-docs/docs/user/develop/basic/publish.zh.md +5 -5
  405. package/references/official-docs/docs/user/develop/framework/index.i18n.yaml +2 -2
  406. package/references/official-docs/docs/user/develop/framework/index.md +1 -1
  407. package/references/official-docs/docs/user/develop/framework/index.zh.md +1 -1
  408. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.i18n.yaml +2 -2
  409. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.md +8 -8
  410. package/references/official-docs/docs/user/develop/practice/dynamic-cordis.zh.md +8 -8
  411. package/references/official-docs/docs/user/guide/index.zh.md +2 -2
  412. package/references/official-docs/docs/user/guide/mcp-memory.zh.md +1 -1
  413. package/references/official-docs/docs/user/guide/network-proxy.i18n.yaml +2 -2
  414. package/references/official-docs/docs/user/guide/network-proxy.md +1 -1
  415. package/references/official-docs/docs/user/guide/network-proxy.zh.md +1 -1
  416. package/references/official-docs/docs/user/guide/providers.i18n.yaml +2 -2
  417. package/references/official-docs/docs/user/guide/providers.md +12 -8
  418. package/references/official-docs/docs/user/guide/providers.zh.md +14 -10
  419. package/references/official-docs/docs/user/guide/python-sdk.i18n.yaml +2 -2
  420. package/references/official-docs/docs/user/guide/python-sdk.md +59 -23
  421. package/references/official-docs/docs/user/guide/python-sdk.zh.md +60 -24
  422. package/references/official-docs/docs/web-styling.i18n.yaml +2 -2
  423. package/references/official-docs/docs/web-styling.md +2 -1
  424. package/references/official-docs/docs/web-styling.zh.md +3 -2
  425. package/references/official-docs/packages/AGENTS.md +1 -1
  426. package/references/official-docs/packages/README.md +12 -7
  427. package/references/official-docs/vendor/README.md +15 -11
  428. package/references/official-docs/website-docs.ts +4 -2
  429. package/scripts/sync-official-docs.ps1 +5 -5
  430. package/references/official-docs/docs/subsystems/code-runtime.md +0 -195
  431. package/references/official-docs/docs/subsystems/code-runtime.zh.md +0 -195
@@ -9,7 +9,7 @@
9
9
 
10
10
  英文源文件由源代码(`scripts/gen-config-catalog.ts`)生成,并通过 `pnpm run verify-config-catalog`(`doc-sync` 的一部分)验证新鲜度;本中文文件作为经评审对侧通过双语配对维护。声明块使用 `ts config-catalog` 围栏(doc-typecheck 会跳过它,因为单独引用导入项的声明无法独立编译)。英文生成器还会将运行时 schemastery schema 与粘贴的声明进行交叉核对——每个经 schema 验证的键(包括嵌套键)都必须能在声明的配置类型中找到——因此,粘贴内容无法隐藏加载器接受的字段。
11
11
 
12
- `Requires:` 行列出插件通过 `inject` 注入的服务键:其 `cordis.yml` 树还必须加载这些服务的提供者。范围限定为 harness 层级(`packages/`);配置树还可能加载的 vendored cordis 插件(`hmr`、控制台日志记录器等)固定为上游源代码(参见 [vendoring policy](../vendor/README.md)),未收录于此目录。
12
+ `Requires:` 行列出插件通过 `inject` 注入的服务键:其 `cordis.yml` 树还必须加载这些服务的提供者。范围限定为 harness 层级(`packages/`);配置树还可能加载的 vendored cordis 插件(控制台日志记录器等)固定为上游源代码(参见 [vendoring policy](../vendor/README.md)),未收录于此目录。
13
13
 
14
14
  <a id="deepseek-aidsh-acp"></a>
15
15
 
@@ -31,7 +31,7 @@ export interface AcpConfig {
31
31
  }
32
32
  ```
33
33
 
34
- 依赖:`Stream`(`@agentclientprotocol/sdk`)
34
+ Depends on: `Stream` (`@agentclientprotocol/sdk`)
35
35
 
36
36
  来源:[`packages/acp/acp/src/index.ts:75`](../packages/acp/acp/src/index.ts)
37
37
 
@@ -111,7 +111,7 @@ export interface Config {
111
111
  }
112
112
  ```
113
113
 
114
- 依赖:[`AgentOptions`](subsystems/core.zh.md) · [`SessionId`](subsystems/core.zh.md)
114
+ Depends on: [`AgentOptions`](subsystems/core.zh.md) · [`SessionId`](subsystems/core.zh.md)
115
115
 
116
116
  来源:[`packages/core/agent-loop/src/index.ts:318`](../packages/core/agent-loop/src/index.ts)
117
117
 
@@ -181,7 +181,7 @@ export interface Config {
181
181
  }
182
182
  ```
183
183
 
184
- 依赖:[`ToolPresentationMode`](subsystems/tools.zh.md)
184
+ Depends on: [`ToolPresentationMode`](subsystems/tools.zh.md)
185
185
 
186
186
  来源:[`packages/core/agent-tool-presentation/src/index.ts:38`](../packages/core/agent-tool-presentation/src/index.ts)
187
187
 
@@ -215,7 +215,7 @@ export interface Config {
215
215
  }
216
216
  ```
217
217
 
218
- 来源:[`packages/api/session-controller/src/index.ts:69`](../packages/api/session-controller/src/index.ts)
218
+ 来源:[`packages/api/session-controller/src/index.ts:71`](../packages/api/session-controller/src/index.ts)
219
219
 
220
220
  <a id="deepseek-aidsh-api-settings-controller"></a>
221
221
 
@@ -231,6 +231,79 @@ export interface Config {
231
231
 
232
232
  来源:[`packages/api/settings-controller/src/index.ts:36`](../packages/api/settings-controller/src/index.ts)
233
233
 
234
+ <a id="deepseek-aidsh-api-terminal-controller"></a>
235
+
236
+ ## `@deepseek-ai/dsh-api-terminal-controller`
237
+
238
+ Requires: `subprocess` · `sandboxPolicy` · `typert`
239
+
240
+ ```ts config-catalog
241
+ /** Deployment limits and an optional shell profile. */
242
+ export interface Config {
243
+ /** Explicit shell profile; omission uses the execution environment's default shell. */
244
+ readonly shell?: {
245
+ /** Executable path or PATH name, verified by the subprocess provider. */
246
+ path: string
247
+ /** User-visible profile name. */
248
+ name: string
249
+ /** Arguments passed to the interactive shell. */
250
+ args: string[]
251
+ } | undefined
252
+ /** Executable names or paths checked for the new-terminal shell selector. */
253
+ readonly shellCandidates: string[]
254
+ /** Maximum retained terminals and pending allocations per Session. */
255
+ readonly maxTerminals: number
256
+ /** Maximum terminal width in columns. */
257
+ readonly maxCols: number
258
+ /** Maximum terminal height in rows. */
259
+ readonly maxRows: number
260
+ /** Screen history rows retained for reconnecting clients. */
261
+ readonly scrollback: number
262
+ /** Maximum queued UTF-8 frame bytes per output follower before disconnection. */
263
+ readonly maxBufferedBytes: number
264
+ /** Maximum UTF-8 bytes in one input request. */
265
+ readonly maxInputBytes: number
266
+ /** Provider process-termination grace period in milliseconds. */
267
+ readonly disposeGraceMs: number
268
+ /** Continuous confirmed idle time without window holds before reclamation; zero disables reclamation. */
269
+ readonly unattendedTimeoutMs: number
270
+ /** Interval between unattended shell and process observations. */
271
+ readonly activityPollIntervalMs: number
272
+ /** Delay before retrying failed owned terminal cleanup. */
273
+ readonly cleanupRetryMs: number
274
+ }
275
+ ```
276
+
277
+ 来源: [`packages/api/terminal-controller/src/index.ts:26`](../packages/api/terminal-controller/src/index.ts)
278
+
279
+ <a id="deepseek-aidsh-api-workspace-files"></a>
280
+
281
+ ## `@deepseek-ai/dsh-api-workspace-files`
282
+
283
+ Requires: `fs` · `sandboxPolicy` · `sessions` · `typert`
284
+
285
+ ```ts config-catalog
286
+ /** Deployment caps on one page or one listing. */
287
+ export interface Config {
288
+ /**
289
+ * Inclusive byte cap on one page's text and on one byte window.
290
+ *
291
+ * A page above this fails; it is not shortened, because a silently cut page
292
+ * reads as the whole page. A byte window asking for more is refused the same
293
+ * way. The file itself has no size cap: a caller pages through it.
294
+ */
295
+ readonly maxBytes: number
296
+ /** Inclusive byte cap on a complete-file read; larger files are refused, never truncated. */
297
+ readonly maxFileBytes: number
298
+ /** Default and largest page size in lines; a request asking for more is refused. */
299
+ readonly maxLines: number
300
+ /** Cap on returned directory entries; the rest is dropped and reported cut. */
301
+ readonly maxEntries: number
302
+ }
303
+ ```
304
+
305
+ 来源:[`packages/api/workspace-files/src/index.ts:69`](../packages/api/workspace-files/src/index.ts)
306
+
234
307
  <a id="deepseek-aidsh-attachment-local"></a>
235
308
 
236
309
  ## `@deepseek-ai/dsh-attachment-local`
@@ -309,19 +382,21 @@ export interface Config {
309
382
  export type Config = LocalConfig
310
383
  ```
311
384
 
312
- 依赖:[`LocalConfig`](#deepseek-aidsh-bash-local)
385
+ Depends on: [`LocalConfig`](#deepseek-aidsh-bash-local)
313
386
 
314
- 来源:[`packages/shell/bash-sandbox/src/index.ts:35`](../packages/shell/bash-sandbox/src/index.ts)
387
+ 来源:[`packages/shell/bash-sandbox/src/index.ts:36`](../packages/shell/bash-sandbox/src/index.ts)
315
388
 
316
389
  <a id="deepseek-aidsh-client-connection"></a>
317
390
 
318
391
  ## `@deepseek-ai/dsh-client-connection`
319
392
 
320
- 需要:`webServer` · `credentials`
393
+ 需要:`credentials`
321
394
 
322
395
  ```ts config-catalog
323
- /** Plugin config: the deployment's non-loopback serving authorities. */
396
+ /** Browser authentication, request limits, and connection recovery configuration. */
324
397
  export interface ConnectionConfig {
398
+ /** Browser recovery timing, injected into each served page. */
399
+ recovery?: ConnectionRecoveryConfig
325
400
  /**
326
401
  * Authorities this deployment serves beyond loopback: exact `host:port`, or
327
402
  * port-less `host` matching any port. The /api trust fence refuses any
@@ -336,9 +411,26 @@ export interface ConnectionConfig {
336
411
  /** Maximum buffered JSON body for every `/api` request. Default: 300 MiB. */
337
412
  maxRequestBodyBytes?: number
338
413
  }
414
+
415
+ /** Timing for generation readiness and automatic reconnection. */
416
+ export interface ConnectionRecoveryConfig {
417
+ /** First-retry delay cap in ms; actual delay is 50–100% of the cap. Default: 500. */
418
+ backoffBaseMs?: number
419
+ /** Finite growth factor of at least 1 per failed attempt; 1 keeps a fixed cap. Default: 2. */
420
+ backoffFactor?: number
421
+ /** Maximum retry delay cap in ms; retries continue at this cap. Default: 10000. */
422
+ backoffMaxMs?: number
423
+ /**
424
+ * Delay before reporting a slow handshake, without cancelling it. Default: 3000.
425
+ * Omitted when readiness, failure, cancellation, or the hard deadline occurs first.
426
+ */
427
+ generationReadyWarnMs?: number
428
+ /** Deadline in ms for readiness, including physical connection setup. Default: 15000. */
429
+ generationReadyTimeoutMs?: number
430
+ }
339
431
  ```
340
432
 
341
- 来源:[`packages/client/connection/src/index.ts:71`](../packages/client/connection/src/index.ts)
433
+ 来源: [`packages/client/connection/src/index.ts:87`](../packages/client/connection/src/index.ts)
342
434
 
343
435
  <a id="deepseek-aidsh-client-hmr"></a>
344
436
 
@@ -354,44 +446,30 @@ export interface Config {
354
446
  }
355
447
  ```
356
448
 
357
- 来源:[`packages/client/hmr/src/index.ts:31`](../packages/client/hmr/src/index.ts)
449
+ 来源:[`packages/client/hmr/src/index.ts:30`](../packages/client/hmr/src/index.ts)
358
450
 
359
- <a id="deepseek-aidsh-code-runtime-worker-thread"></a>
451
+ <a id="deepseek-aidsh-client-ui-sidebar-documentpreview"></a>
360
452
 
361
- ## `@deepseek-ai/dsh-code-runtime-worker-thread`
453
+ ## `@deepseek-ai/dsh-client-ui-sidebar-documentpreview`
362
454
 
363
455
  ```ts config-catalog
364
- /** Plugin config: every execution cap, changeable from `cordis.yml` (no hardcoded tunables). */
456
+ /** Transient Office conversion reuse within one Client connection. */
365
457
  export interface Config {
366
- /**
367
- * Busy-time budget in milliseconds: the run fails with kind `'timeout'`
368
- * once the worker's MEASURED event-loop active time
369
- * (`worker.performance.eventLoopUtilization()`) exceeds this. Metering
370
- * measured busy time not wall time, not host-side pending-call
371
- * bookkeeping — is what makes the budget both fair (a program awaiting a
372
- * slow tool accrues nothing) and ungameable (a hot loop accrues whether
373
- * or not a decoy dispatch is in flight).
374
- */
375
- computeMs?: number
376
- /**
377
- * Wall-clock ceiling in milliseconds; never pauses for anything. The
378
- * backstop for what busy-time cannot see (a program awaiting a promise
379
- * nobody will resolve). At most `2_147_483_647` (Node's maximum
380
- * `setTimeout` delay, about 24.9 days): a longer value is rejected at load
381
- * because `setTimeout` would clamp it to 1 ms.
382
- */
383
- maxWallMs?: number
384
- /**
385
- * Hard cap for serialized log-array, completion-value, and failure-message payloads;
386
- * fixed result-envelope syntax is excluded.
387
- */
388
- maxOutputBytes?: number
389
- /** The worker's max old-generation heap in MiB (`resourceLimits`); overflow kills the worker, surfacing as kind `'worker-exit'`. */
390
- maxOldGenerationSizeMb?: number
458
+ /** Retained PDF limits; pending conversions share cancellation by reader lifetime. */
459
+ office: {
460
+ /** Maximum retained completed PDFs. */
461
+ maxCachedEntries: number
462
+ /** Maximum retained PDF bytes, counted by each binary buffer's byteLength. */
463
+ maxCachedBytes: number
464
+ /** Maximum unsettled Host conversion RPCs, including cancellation teardown. */
465
+ maxPending: number
466
+ /** Maximum readers including source and renderer metadata lookups. */
467
+ maxReaders: number
468
+ }
391
469
  }
392
470
  ```
393
471
 
394
- 来源:[`packages/code-runtime/code-runtime-worker-thread/src/index.ts:25`](../packages/code-runtime/code-runtime-worker-thread/src/index.ts)
472
+ 来源:[`packages/client/ui-sidebar-documentpreview/src/config.ts:5`](../packages/client/ui-sidebar-documentpreview/src/config.ts)
395
473
 
396
474
  <a id="deepseek-aidsh-compaction-basic"></a>
397
475
 
@@ -495,24 +573,6 @@ export interface Config {
495
573
 
496
574
  来源:[`packages/credentials/credentials-local/src/index.ts:64`](../packages/credentials/credentials-local/src/index.ts)
497
575
 
498
- <a id="deepseek-aidsh-e2b"></a>
499
-
500
- ## `@deepseek-ai/dsh-e2b`
501
-
502
- ```ts config-catalog
503
- /** Configuration for the shared E2B sandbox owner. */
504
- export interface Config {
505
- /** API key; omission reads `E2B_API_KEY`. It is never forwarded into the sandbox. */
506
- apiKey?: string
507
- /** Shared remote working directory, created before adapters receive the sandbox. */
508
- cwd?: string
509
- /** E2B sandbox lifetime in milliseconds; expiry always deletes the sandbox. */
510
- timeoutMs?: number
511
- }
512
- ```
513
-
514
- 来源:[`packages/e2b/e2b/src/index.ts:45`](../packages/e2b/e2b/src/index.ts)
515
-
516
576
  <a id="deepseek-aidsh-experimental-agent-team"></a>
517
577
 
518
578
  ## `@deepseek-ai/dsh-experimental-agent-team`
@@ -535,74 +595,103 @@ export interface Config {
535
595
  }
536
596
  ```
537
597
 
538
- 来源:[`packages/experimental/agent-team/src/types.ts:124`](../packages/experimental/agent-team/src/types.ts)
598
+ 来源:[`packages/experimental/agent-team/src/types.ts:130`](../packages/experimental/agent-team/src/types.ts)
599
+
600
+ <a id="deepseek-aidsh-experimental-browser-use-chrome-devtools-mcp"></a>
539
601
 
540
- <a id="deepseek-aidsh-experimental-code-runtime-python"></a>
602
+ ## `@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp`
541
603
 
542
- ## `@deepseek-ai/dsh-experimental-code-runtime-python`
604
+ 需要:`browserUse` · `agents` · `tools` · `systemPrompt`
543
605
 
544
606
  ```ts config-catalog
545
- /** Plugin config: every cap, changeable from `cordis.yml` (no hardcoded tunables). */
607
+ /** Fixed Chromium launch or existing-browser attachment settings. */
608
+ export type Config = BrowserMcpConfig
609
+ ```
610
+
611
+ Depends on: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
612
+
613
+ 来源:[`packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts:14`](../packages/experimental/browser-use-chrome-devtools-mcp/src/index.ts)
614
+
615
+ <a id="deepseek-aidsh-experimental-browser-use-playwright-mcp"></a>
616
+
617
+ ## `@deepseek-ai/dsh-experimental-browser-use-playwright-mcp`
618
+
619
+ 需要:`browserUse` · `agents` · `tools` · `systemPrompt`
620
+
621
+ ```ts config-catalog
622
+ /** Fixed Chromium launch or existing-browser attachment settings. */
623
+ export type Config = BrowserMcpConfig
624
+ ```
625
+
626
+ Depends on: `BrowserMcpConfig` (`@deepseek-ai/dsh-experimental-browser-use-runtime/mcp`)
627
+
628
+ 来源:[`packages/experimental/browser-use-playwright-mcp/src/index.ts:15`](../packages/experimental/browser-use-playwright-mcp/src/index.ts)
629
+
630
+ <a id="deepseek-aidsh-experimental-browser-use-stagehand-native"></a>
631
+
632
+ ## `@deepseek-ai/dsh-experimental-browser-use-stagehand-native`
633
+
634
+ 需要:`browserUse` · `agents` · `tools` · `systemPrompt`
635
+
636
+ ```ts config-catalog
637
+ /** Profile-owned browser connection and independent Stagehand model credentials. */
546
638
  export interface Config {
547
- /**
548
- * RLIMIT_CPU in whole seconds (a positive integer — `setrlimit` in the child
549
- * rejects a float). The child sets the soft limit to `cpuSeconds` and the
550
- * hard limit to `cpuSeconds + 1`: the kernel delivers SIGXCPU at the soft
551
- * limit, which the host classifies as a `timeout`; the +1s hard limit is a
552
- * SIGKILL backstop for a program that traps SIGXCPU. Granularity is seconds —
553
- * a coarser counterpart to the worker backend's millisecond `computeMs`.
554
- */
555
- cpuSeconds?: number
556
- /** Wall-clock ceiling in milliseconds; backstops CPU time for programs awaiting a promise nobody resolves. */
557
- maxWallMs?: number
558
- /**
559
- * RLIMIT_AS in mebibytes; caps address space so a runaway allocation fails
560
- * cleanly. Not applied on Darwin, where the dyld shared cache mapped into
561
- * every process at exec exceeds any practical cap and the kernel rejects
562
- * the call; `cpuSeconds` and `maxWallMs` still bound the run there. Bounds
563
- * `maxLogBytes`/`maxValueBytes` at load on EVERY platform (this static check
564
- * runs on Darwin too, where only the runtime `setrlimit` is skipped): each
565
- * budget times a worst-case Unicode expansion must fit this byte count minus a
566
- * fixed interpreter baseline, so a near-budget output cannot breach the address
567
- * space during the child's build-and-encode.
568
- */
569
- addressSpaceMb?: number
570
- /**
571
- * Shared byte budget for captured log text (host-side ledger). Bounded at load
572
- * against `addressSpaceMb`: the child builds and encodes a near-budget entry
573
- * under RLIMIT_AS with several copies live at once, so this cap times the
574
- * worst-case Unicode expansion must fit the address space left after the
575
- * interpreter baseline (see `addressSpaceMb`) — a load-time rejection, not a
576
- * runtime clamp. Also bounded at load by the host's configured heap like
577
- * `maxValueBytes` (see its JSDoc): the effective frame cap minus the frame
578
- * envelope.
579
- */
580
- maxLogBytes?: number
581
- /**
582
- * Byte cap for the completion value. Bounded at load against `addressSpaceMb`
583
- * the same way `maxLogBytes` is: the child builds and encodes a near-budget
584
- * value under RLIMIT_AS with several copies live at once, so this cap times the
585
- * worst-case Unicode expansion must fit the address space left after the
586
- * interpreter baseline. Both budgets are ALSO bounded at load by the host's
587
- * configured heap: the effective frame cap (the protocol cap, or a lower
588
- * heap-derived ceiling when the host heap cannot safely parse a near-cap
589
- * frame — see `hostFrameParseCeiling`) minus the frame envelope, so a budget
590
- * whose honest frame could OOM the host's own JSON.parse is rejected up
591
- * front.
592
- */
593
- maxValueBytes?: number
594
- /** SIGTERM→SIGKILL grace period on kill, matching bash-local's default. */
595
- graceMs?: number
596
- /**
597
- * Absolute path, relative path, or basename of a CPython 3.10+ interpreter.
598
- * Resolved and validated once at plugin load under a five-second force-kill
599
- * deadline; a basename searches `PATH`.
600
- */
601
- pythonBin?: string
639
+ /** Native Stagehand model and credentials; independent of the Session model. */
640
+ model: StagehandModelConfig
641
+ /** Launch a fresh browser or attach to the configured existing endpoint. */
642
+ mode: 'launch' | 'attach'
643
+ /** CDP HTTP or WebSocket endpoint, required only for attach mode. */
644
+ cdpEndpoint?: string
645
+ /** Optional Stagehand extension id for an existing browser. */
646
+ extensionId?: string
647
+ /** Installed Chrome/Chromium executable used in launch mode. */
648
+ executablePath?: string
649
+ /** Hide an owned browser's window. */
650
+ headless?: boolean
651
+ /** Deadline for Chromium startup and Stagehand navigation/action operations. */
652
+ operationTimeoutMs?: number
653
+ /** Grace for native SDK cleanup before its connection Worker is terminated. */
654
+ shutdownGraceMs?: number
655
+ }
656
+
657
+ /** Profile-owned model settings accepted by the pinned Stagehand SDK. */
658
+ export interface StagehandModelConfig {
659
+ /** Provider-prefixed model name from Stagehand's supported model catalog. */
660
+ modelName: ModelConfig['modelName']
661
+ /** Explicit API key sent to Stagehand's browser extension. */
662
+ apiKey: string
663
+ /** Additional headers sent with the extension's model requests. */
664
+ headers?: Record<string, string>
602
665
  }
603
666
  ```
604
667
 
605
- 来源:[`packages/experimental/code-runtime-python/src/index.ts:42`](../packages/experimental/code-runtime-python/src/index.ts)
668
+ Depends on: `ModelConfig` (`@browserbasehq/stagehand`)
669
+
670
+ 来源:[`packages/experimental/browser-use-stagehand-native/src/index.ts:28`](../packages/experimental/browser-use-stagehand-native/src/index.ts)
671
+
672
+ <a id="deepseek-aidsh-experimental-computer-use-cua-driver-mcp"></a>
673
+
674
+ ## `@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp`
675
+
676
+ 需要:`computerUse` · `tools`
677
+
678
+ ```ts config-catalog
679
+ /** Installed executable and MCP connection overrides. */
680
+ export interface Config {
681
+ /** Executable path or PATH command; defaults to `cua-driver`. */
682
+ command: string
683
+ /** Arguments passed without a shell; defaults to `['mcp']`. */
684
+ args: string[]
685
+ /** Per-call timeout in milliseconds; omission uses the MCP client's default. */
686
+ toolCallTimeoutMs?: number
687
+ /** Reconnection overrides; defaults to the MCP client's policy. */
688
+ reconnect: McpClient.ReconnectConfig
689
+ }
690
+ ```
691
+
692
+ Depends on: [`McpClient`](../packages/mcp/mcp-client/src/index.ts)
693
+
694
+ 来源:[`packages/experimental/computer-use-cua-driver-mcp/src/index.ts:20`](../packages/experimental/computer-use-cua-driver-mcp/src/index.ts)
606
695
 
607
696
  <a id="deepseek-aidsh-experimental-inspector"></a>
608
697
 
@@ -672,6 +761,72 @@ export interface InspectorOptions {
672
761
 
673
762
  来源:[`packages/experimental/inspector/src/index.ts:66`](../packages/experimental/inspector/src/index.ts)
674
763
 
764
+ <a id="deepseek-aidsh-experimental-ptc-runtime-python"></a>
765
+
766
+ ## `@deepseek-ai/dsh-experimental-ptc-runtime-python`
767
+
768
+ ```ts config-catalog
769
+ /** Plugin config: every cap, changeable from `cordis.yml` (no hardcoded tunables). */
770
+ export interface Config {
771
+ /**
772
+ * RLIMIT_CPU in whole seconds (a positive integer — `setrlimit` in the child
773
+ * rejects a float). The child sets the soft limit to `cpuSeconds` and the
774
+ * hard limit to `cpuSeconds + 1`: the kernel delivers SIGXCPU at the soft
775
+ * limit, which the host classifies as a `timeout`; the +1s hard limit is a
776
+ * SIGKILL backstop for a program that traps SIGXCPU. Granularity is whole seconds.
777
+ */
778
+ cpuSeconds?: number
779
+ /** Wall-clock ceiling in milliseconds; backstops CPU time for programs awaiting a promise nobody resolves. */
780
+ maxWallMs?: number
781
+ /**
782
+ * RLIMIT_AS in mebibytes; caps address space so a runaway allocation fails
783
+ * cleanly. Not applied on Darwin, where the dyld shared cache mapped into
784
+ * every process at exec exceeds any practical cap and the kernel rejects
785
+ * the call; `cpuSeconds` and `maxWallMs` still bound the run there. Bounds
786
+ * `maxLogBytes`/`maxValueBytes` at load on EVERY platform (this static check
787
+ * runs on Darwin too, where only the runtime `setrlimit` is skipped): each
788
+ * budget times a worst-case Unicode expansion must fit this byte count minus a
789
+ * fixed interpreter baseline, so a near-budget output cannot breach the address
790
+ * space during the child's build-and-encode.
791
+ */
792
+ addressSpaceMb?: number
793
+ /**
794
+ * Shared byte budget for captured log text (host-side ledger). Bounded at load
795
+ * against `addressSpaceMb`: the child builds and encodes a near-budget entry
796
+ * under RLIMIT_AS with several copies live at once, so this cap times the
797
+ * worst-case Unicode expansion must fit the address space left after the
798
+ * interpreter baseline (see `addressSpaceMb`) — a load-time rejection, not a
799
+ * runtime clamp. Also bounded at load by the host's configured heap like
800
+ * `maxValueBytes` (see its JSDoc): the effective frame cap minus the frame
801
+ * envelope.
802
+ */
803
+ maxLogBytes?: number
804
+ /**
805
+ * Byte cap for the completion value. Bounded at load against `addressSpaceMb`
806
+ * the same way `maxLogBytes` is: the child builds and encodes a near-budget
807
+ * value under RLIMIT_AS with several copies live at once, so this cap times the
808
+ * worst-case Unicode expansion must fit the address space left after the
809
+ * interpreter baseline. Both budgets are ALSO bounded at load by the host's
810
+ * configured heap: the effective frame cap (the protocol cap, or a lower
811
+ * heap-derived ceiling when the host heap cannot safely parse a near-cap
812
+ * frame — see `hostFrameParseCeiling`) minus the frame envelope, so a budget
813
+ * whose honest frame could OOM the host's own JSON.parse is rejected up
814
+ * front.
815
+ */
816
+ maxValueBytes?: number
817
+ /** SIGTERM→SIGKILL grace period on kill, matching bash-local's default. */
818
+ graceMs?: number
819
+ /**
820
+ * Absolute path, relative path, or basename of a CPython 3.10+ interpreter.
821
+ * Resolved and validated once at plugin load under a five-second force-kill
822
+ * deadline; a basename searches `PATH`.
823
+ */
824
+ pythonBin?: string
825
+ }
826
+ ```
827
+
828
+ 来源:[`packages/experimental/ptc-runtime-python/src/index.ts:42`](../packages/experimental/ptc-runtime-python/src/index.ts)
829
+
675
830
  <a id="deepseek-aidsh-experimental-tool-agent-team"></a>
676
831
 
677
832
  ## `@deepseek-ai/dsh-experimental-tool-agent-team`
@@ -727,7 +882,7 @@ export interface Config {
727
882
  }
728
883
  ```
729
884
 
730
- 来源:[`packages/fs/fs-local/src/index.ts:41`](../packages/fs/fs-local/src/index.ts)
885
+ 来源:[`packages/fs/fs-local/src/index.ts:43`](../packages/fs/fs-local/src/index.ts)
731
886
 
732
887
  <a id="deepseek-aidsh-fs-sandbox"></a>
733
888
 
@@ -745,7 +900,7 @@ export interface Config {
745
900
  export type Config = LocalConfig
746
901
  ```
747
902
 
748
- 依赖:[`LocalConfig`](#deepseek-aidsh-fs-local)
903
+ Depends on: [`LocalConfig`](#deepseek-aidsh-fs-local)
749
904
 
750
905
  来源:[`packages/fs/fs-sandbox/src/index.ts:45`](../packages/fs/fs-sandbox/src/index.ts)
751
906
 
@@ -772,14 +927,40 @@ export interface Config {
772
927
  需要:`agentDefaultModel` · `agents` · `sessions`
773
928
 
774
929
  ```ts config-catalog
775
- /** Plugin config: the task resolved from this app's injected provider service. */
930
+ /** Plugin config: the task and run options resolved from this app's injected provider service. */
776
931
  export interface Config {
777
- /** The prompt text for the single run. */
778
- task: string
932
+ /** The prompt text for the single run; absent when the task arrives on stdin. */
933
+ task?: string
934
+ /** Exact Session identity to adopt; absent for a fresh random identity. An id with no stored Session fails. */
935
+ sessionId?: string
936
+ /** Whether stdout carries the machine-readable event stream instead of final text. */
937
+ json?: boolean
938
+ }
939
+ ```
940
+
941
+ 来源:[`packages/bundle/headless/src/index.ts:42`](../packages/bundle/headless/src/index.ts)
942
+
943
+ <a id="deepseek-aidsh-hmr"></a>
944
+
945
+ ## `@deepseek-ai/dsh-hmr`
946
+
947
+ ```ts config-catalog
948
+ /** Module roots and watcher timing, with Chokidar deployment options. */
949
+ export interface HmrConfig extends ChokidarOptions {
950
+ /** Directory resolved against the owning context's base URL. */
951
+ base?: string
952
+ /** Module watch roots; an empty list leaves only explicit configuration watches. */
953
+ root: string[]
954
+ /** Milliseconds for combining module changes. */
955
+ debounce: number
956
+ /** Glob patterns excluded from module watching. */
957
+ ignored: string[]
779
958
  }
780
959
  ```
781
960
 
782
- 来源:[`packages/bundle/headless/src/index.ts:33`](../packages/bundle/headless/src/index.ts)
961
+ Depends on: `ChokidarOptions` (`chokidar`)
962
+
963
+ 来源: [`packages/boot/hmr/src/index.ts:51`](../packages/boot/hmr/src/index.ts)
783
964
 
784
965
  <a id="deepseek-aidsh-hooks-claude-code"></a>
785
966
 
@@ -817,7 +998,7 @@ export interface Config {
817
998
  }
818
999
  ```
819
1000
 
820
- 来源:[`packages/hooks/hooks-claude-code/src/index.ts:45`](../packages/hooks/hooks-claude-code/src/index.ts)
1001
+ 来源:[`packages/hooks/hooks-claude-code/src/index.ts:44`](../packages/hooks/hooks-claude-code/src/index.ts)
821
1002
 
822
1003
  <a id="deepseek-aidsh-hooks-codex"></a>
823
1004
 
@@ -844,7 +1025,7 @@ export interface Config {
844
1025
  }
845
1026
  ```
846
1027
 
847
- 来源:[`packages/hooks/hooks-codex/src/index.ts:44`](../packages/hooks/hooks-codex/src/index.ts)
1028
+ 来源:[`packages/hooks/hooks-codex/src/index.ts:43`](../packages/hooks/hooks-codex/src/index.ts)
848
1029
 
849
1030
  <a id="deepseek-aidsh-host-directory-picker-browse"></a>
850
1031
 
@@ -876,6 +1057,37 @@ export interface Config {
876
1057
 
877
1058
  来源:[`packages/host/frontend-static/src/index.ts:30`](../packages/host/frontend-static/src/index.ts)
878
1059
 
1060
+ <a id="deepseek-aidsh-host-open-in-app"></a>
1061
+
1062
+ ## `@deepseek-ai/dsh-host-open-in-app`
1063
+
1064
+ 需要:`webServer` · `connection` · `subprocess`
1065
+
1066
+ ```ts config-catalog
1067
+ /** Open-in-app host configuration. */
1068
+ export interface Config {
1069
+ /**
1070
+ * Per-command deadline in milliseconds for catalog-resolution host
1071
+ * commands (`xcode-select`, the Windows registry reads).
1072
+ */
1073
+ readonly probeTimeoutMs: number
1074
+ /**
1075
+ * Per-command deadline in milliseconds for icon-extraction host commands
1076
+ * (`plutil`/`sips` on macOS, the PowerShell extraction on Windows).
1077
+ */
1078
+ readonly iconTimeoutMs: number
1079
+ /**
1080
+ * Early-failure watch window per launch, in milliseconds: a launcher still
1081
+ * running when the window closes counts as launched and keeps running, so
1082
+ * this bounds how long the open route holds a successful launch, not how
1083
+ * long an application may live.
1084
+ */
1085
+ readonly launchWatchMs: number
1086
+ }
1087
+ ```
1088
+
1089
+ 来源:[`packages/host/open-in-app/src/index.ts:50`](../packages/host/open-in-app/src/index.ts)
1090
+
879
1091
  <a id="deepseek-aidsh-host-webserver"></a>
880
1092
 
881
1093
  ## `@deepseek-ai/dsh-host-webserver`
@@ -937,7 +1149,7 @@ export interface Config {
937
1149
 
938
1150
  ## `@deepseek-ai/dsh-llm-deepseek`
939
1151
 
940
- 需要:`llm`
1152
+ 需要: `llm`
941
1153
 
942
1154
  ```ts config-catalog
943
1155
  /**
@@ -949,6 +1161,8 @@ export interface Config {
949
1161
  * reasoning effort resolves to `high`.
950
1162
  */
951
1163
  export interface Config {
1164
+ /** Wire protocol; defaults to messages. Configure through Cordis YAML. */
1165
+ protocol?: DeepSeekProtocol
952
1166
  /** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
953
1167
  apiKeyEnv?: string
954
1168
  /** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
@@ -961,7 +1175,7 @@ export interface Config {
961
1175
  maxTokens?: number
962
1176
  /** Positive context capacity used when the selected model has no exact value (default 1,000,000). */
963
1177
  defaultContextWindow?: number
964
- /** Advisory models shown by discovery consumers; defaults to V4 Flash, V4 Pro, and V4 Flash Vision Exp. */
1178
+ /** Advisory models shown by discovery consumers; defaults to V41 Flash and V4 Pro. */
965
1179
  models?: DeepSeekCatalogModel[]
966
1180
  /** Maximum provider idle time while one stream read is outstanding (default five minutes). */
967
1181
  streamIdleTimeoutMs?: number
@@ -989,6 +1203,9 @@ export interface Config {
989
1203
  retryPolicy?: RetryPolicyConfig
990
1204
  }
991
1205
 
1206
+ /** Supported wire implementations; Responses is not yet implemented. */
1207
+ export type DeepSeekProtocol = 'chat-completions' | 'messages'
1208
+
992
1209
  /** One optional model entry advertised by the direct-fetch adapter. */
993
1210
  export interface DeepSeekCatalogModel {
994
1211
  /** Wire model id accepted by the configured endpoint. */
@@ -1003,16 +1220,26 @@ export interface DeepSeekCatalogModel {
1003
1220
  maxTokens?: number
1004
1221
  /** Accepted request modalities; omission is text-only. */
1005
1222
  inputModalities?: ModelModality[]
1006
- /** Total-pixel budget for one deterministic request preview, or the 512-by-512 `low` preset. */
1223
+ /**
1224
+ * Total-pixel budget replacing the published token-grid projection for one
1225
+ * deterministic request preview, or the 512-by-512 `low` preset; omission
1226
+ * projects onto the token grid.
1227
+ */
1007
1228
  imagePixelBudget?: number | 'low'
1008
1229
  /** Encoded-byte target for one deterministic request preview; the smallest quality-ladder output is used when no quality fits. */
1009
1230
  imageMaxBytes?: number
1231
+ /**
1232
+ * `'in-history'` declares that the endpoint reads the latest `system`
1233
+ * message at any position of the conversation as the complete effective
1234
+ * system prompt; omission means only a leading system message is read.
1235
+ */
1236
+ systemPromptUpdate?: SystemPromptUpdate
1010
1237
  }
1011
1238
  ```
1012
1239
 
1013
- 依赖:[`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts)
1240
+ Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
1014
1241
 
1015
- 来源:[`packages/llm/llm-deepseek/src/index.ts:125`](../packages/llm/llm-deepseek/src/index.ts)
1242
+ 来源:[`packages/llm/llm-deepseek/src/config.ts:25`](../packages/llm/llm-deepseek/src/config.ts)
1016
1243
 
1017
1244
  <a id="deepseek-aidsh-llm-pi-ai"></a>
1018
1245
 
@@ -1231,8 +1458,14 @@ export interface PiAiCompatProfile {
1231
1458
  chatTemplateKwargs?: NonNullable<OpenAICompletionsCompat['chatTemplateKwargs']>
1232
1459
  /** Arguments sent as `chat_template_args` under the `baseten` thinking format; `openai-completions`. */
1233
1460
  chatTemplateArgs?: NonNullable<OpenAICompletionsCompat['chatTemplateArgs']>
1234
- /** Whether the endpoint accepts `thinking_token_budget` to cap vLLM reasoning; `openai-completions`. */
1461
+ /** Alias for `thinkingTokenBudgetField: "thinking_token_budget"`; an explicit field wins. `openai-completions`. */
1235
1462
  supportsThinkingTokenBudget?: boolean
1463
+ /** Request field carrying the reasoning budget from `thinkingBudgets`; omitted unless configured. `openai-completions`. */
1464
+ thinkingTokenBudgetField?: PiAiThinkingTokenBudgetField
1465
+ /** vLLM scheduler `priority`; lower runs earlier, and the server must enable priority scheduling. Omitted unless configured. */
1466
+ vllmPriority?: number
1467
+ /** Whether `openai-responses` accepts `max_output_tokens`; `false` omits it. Azure and Codex ignore this shared compat field. */
1468
+ supportsMaxOutputTokens?: boolean
1236
1469
  /**
1237
1470
  * Whether the endpoint accepts `strict` in tool definitions;
1238
1471
  * `openai-completions`, the three Responses protocols, `bedrock-converse-stream`.
@@ -1274,11 +1507,14 @@ export type PiAiReasoningEfforts = Partial<Record<ModelThinkingLevel, string | n
1274
1507
 
1275
1508
  /** One reasoning-dispatch wire format a profile may name. */
1276
1509
  export type PiAiThinkingFormat = NonNullable<OpenAICompletionsCompat['thinkingFormat']>
1510
+
1511
+ /** The reasoning-budget field spellings pi-ai accepts. */
1512
+ export type PiAiThinkingTokenBudgetField = NonNullable<OpenAICompletionsCompat['thinkingTokenBudgetField']>
1277
1513
  ```
1278
1514
 
1279
- 依赖:`Api`(`@earendil-works/pi-ai`)· `CacheRetention`(`@earendil-works/pi-ai`)· `Model`(`@earendil-works/pi-ai`)· `ModelThinkingLevel`(`@earendil-works/pi-ai`)· `OpenAICompletionsCompat`(`@earendil-works/pi-ai`)· [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · `ThinkingBudgets`(`@earendil-works/pi-ai`)· `Transport`(`@earendil-works/pi-ai`)
1515
+ Depends on: `Api` (`@earendil-works/pi-ai`) · `CacheRetention` (`@earendil-works/pi-ai`) · `Model` (`@earendil-works/pi-ai`) · `ModelThinkingLevel` (`@earendil-works/pi-ai`) · `OpenAICompletionsCompat` (`@earendil-works/pi-ai`) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · `ThinkingBudgets` (`@earendil-works/pi-ai`) · `Transport` (`@earendil-works/pi-ai`)
1280
1516
 
1281
- 来源:[`packages/llm/llm-pi-ai/src/config.ts:213`](../packages/llm/llm-pi-ai/src/config.ts)
1517
+ 来源:[`packages/llm/llm-pi-ai/src/config.ts:221`](../packages/llm/llm-pi-ai/src/config.ts)
1282
1518
 
1283
1519
  <a id="deepseek-aidsh-llm-replay"></a>
1284
1520
 
@@ -1350,12 +1586,14 @@ export interface ReplayModelConfig {
1350
1586
  * {@link reasoningEfforts} or call resolution rejects the route.
1351
1587
  */
1352
1588
  defaultReasoningEffort?: string
1589
+ /** Optional in-history system prompt replacement for a keyless replay route. */
1590
+ systemPromptUpdate?: SystemPromptUpdate
1353
1591
  }
1354
1592
  ```
1355
1593
 
1356
- 依赖:[`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts)
1594
+ Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
1357
1595
 
1358
- 来源:[`packages/test-support/llm-replay/src/index.ts:1294`](../packages/test-support/llm-replay/src/index.ts)
1596
+ 来源:[`packages/test-support/llm-replay/src/index.ts:1122`](../packages/test-support/llm-replay/src/index.ts)
1359
1597
 
1360
1598
  <a id="deepseek-aidsh-llm-retry"></a>
1361
1599
 
@@ -1440,10 +1678,12 @@ export interface StdioConfig {
1440
1678
  env: Record<string, string>
1441
1679
  /** Working directory for the child process. */
1442
1680
  cwd: string
1443
- /** Per-tool-call timeout in milliseconds. */
1681
+ /** Timeout per tool call or resource request in milliseconds. */
1444
1682
  toolCallTimeoutMs: number
1445
1683
  /** Fail plugin activation when the initial connection or tool synchronization fails. */
1446
1684
  failOnStartupError: boolean
1685
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
1686
+ maxInstructionBytes?: number
1447
1687
  /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
1448
1688
  reconnect?: ReconnectConfig
1449
1689
  }
@@ -1462,10 +1702,12 @@ export interface StreamableHttpConfig {
1462
1702
  url: string
1463
1703
  /** Additional headers attached to MCP requests. */
1464
1704
  headers: Record<string, string>
1465
- /** Per-tool-call timeout in milliseconds. */
1705
+ /** Timeout per tool call or resource request in milliseconds. */
1466
1706
  toolCallTimeoutMs: number
1467
1707
  /** Fail plugin activation when the initial connection or tool synchronization fails. */
1468
1708
  failOnStartupError: boolean
1709
+ /** Maximum UTF-8 bytes of attributed server instructions (default 32768). */
1710
+ maxInstructionBytes?: number
1469
1711
  /** Automatic reconnect policy after a lost connection; omission uses the defaults. */
1470
1712
  reconnect?: ReconnectConfig
1471
1713
  }
@@ -1483,13 +1725,13 @@ export interface ReconnectConfig {
1483
1725
  }
1484
1726
  ```
1485
1727
 
1486
- 来源:[`packages/mcp/mcp-client/src/index.ts:98`](../packages/mcp/mcp-client/src/index.ts)
1728
+ 来源:[`packages/mcp/mcp-client/src/index.ts:104`](../packages/mcp/mcp-client/src/index.ts)
1487
1729
 
1488
1730
  <a id="deepseek-aidsh-message-feedback"></a>
1489
1731
 
1490
1732
  ## `@deepseek-ai/dsh-message-feedback`
1491
1733
 
1492
- 需要:`storageDomain` · `sessionPersistence` · `sessions`
1734
+ 需要:`sessionPersistence` · `sessions`
1493
1735
 
1494
1736
  ```ts config-catalog
1495
1737
  /** Required deployment policy for optional notes. */
@@ -1499,7 +1741,57 @@ export interface Config {
1499
1741
  }
1500
1742
  ```
1501
1743
 
1502
- 来源:[`packages/feedback/message-feedback/src/index.ts:50`](../packages/feedback/message-feedback/src/index.ts)
1744
+ 来源:[`packages/feedback/message-feedback/src/index.ts:40`](../packages/feedback/message-feedback/src/index.ts)
1745
+
1746
+ <a id="deepseek-aidsh-office-to-pdf"></a>
1747
+
1748
+ ## `@deepseek-ai/dsh-office-to-pdf`
1749
+
1750
+ ```ts config-catalog
1751
+ /** Provider concurrency and kit rendering/font configuration. */
1752
+ export interface Config {
1753
+ /** Maximum simultaneous conversions; queued callers remain cancellable. */
1754
+ maxConcurrentConversions: number
1755
+ /** Maximum metadata-only jobs awaiting source admission. */
1756
+ maxQueuedJobs: number
1757
+ /** Maximum outstanding conversion readers. */
1758
+ maxReaders: number
1759
+ /** Maximum reserved bytes across admitted source reads and conversions. */
1760
+ maxSourceBytes: number
1761
+ /** Maximum concurrent background jobs; zero refuses speculative work. */
1762
+ maxBackgroundConversions: number
1763
+ /** Maximum retained content-addressed PDFs. */
1764
+ maxCachedEntries: number
1765
+ /** Maximum retained PDF bytes. */
1766
+ maxCachedBytes: number
1767
+ /** Maximum retained source-version aliases to cached content. */
1768
+ maxSourceEntries: number
1769
+ /** Conversion deadline in milliseconds; excludes the DSH queue. */
1770
+ timeoutMs: number
1771
+ /** Maximum authorized source bytes. */
1772
+ maxInputBytes: number
1773
+ /** Maximum complete PDF bytes. */
1774
+ maxOutputBytes: number
1775
+ /** Exported raster-image DPI. */
1776
+ maxImageResolution: number
1777
+ /** Maximum OOXML ZIP entries. */
1778
+ maxArchiveEntries: number
1779
+ /** Maximum total declared uncompressed OOXML bytes. */
1780
+ maxUncompressedBytes: number
1781
+ /** Absolute font roots; omission uses the kit's platform defaults. */
1782
+ fontDirectories?: string[]
1783
+ /** Ordered font-family preference groups; omission retains the kit defaults. */
1784
+ fontFallbacks?: string[][]
1785
+ /** Maximum physical font files indexed by each converter. */
1786
+ maxFontFiles: number
1787
+ /** Maximum individual font-file bytes. */
1788
+ maxFontFileBytes: number
1789
+ /** Maximum original font bytes loaded for a conversion. */
1790
+ maxLoadedFontBytes: number
1791
+ }
1792
+ ```
1793
+
1794
+ 来源: [`packages/document/office-to-pdf/src/index.ts:31`](../packages/document/office-to-pdf/src/index.ts)
1503
1795
 
1504
1796
  <a id="deepseek-aidsh-permission-presets"></a>
1505
1797
 
@@ -1513,7 +1805,8 @@ export interface Config {
1513
1805
  /**
1514
1806
  * The preset table: name → knob bundle. Defaults to `workspace-write`
1515
1807
  * (workspace-write + ask) and `danger-full-access` (danger-full-access +
1516
- * never). The name `custom` is reserved for the derived not-a-preset state.
1808
+ * never). The names `custom` and `auto` are reserved for derived state and
1809
+ * the Auto review integration respectively.
1517
1810
  */
1518
1811
  presets?: Record<string, PresetSpec>
1519
1812
  /**
@@ -1536,9 +1829,9 @@ export interface PresetSpec {
1536
1829
  }
1537
1830
  ```
1538
1831
 
1539
- 依赖:[`ApprovalPolicy`](subsystems/approval.zh.md) · [`SandboxMode`](subsystems/sandbox.zh.md)
1832
+ Depends on: [`ApprovalPolicy`](subsystems/approval.zh.md) · [`SandboxMode`](subsystems/sandbox.zh.md)
1540
1833
 
1541
- 来源:[`packages/interaction/permission-presets/src/index.ts:143`](../packages/interaction/permission-presets/src/index.ts)
1834
+ 来源:[`packages/interaction/permission-presets/src/index.ts:156`](../packages/interaction/permission-presets/src/index.ts)
1542
1835
 
1543
1836
  <a id="deepseek-aidsh-persona"></a>
1544
1837
 
@@ -1550,12 +1843,17 @@ export interface PresetSpec {
1550
1843
  /** Plugin config: the persona text this composition contributes. */
1551
1844
  export interface Config {
1552
1845
  /**
1553
- * Persona prose rendered as the `deployment:persona` section. A template:
1846
+ * Persona prose rendered as the `deployment:persona-prefix` section. A template:
1554
1847
  * complete `{{…}}` groups interpolate strictly against registered prompt
1555
1848
  * variables. Empty text drops the section at render, matching the registry.
1556
1849
  */
1557
- text: string
1558
- /** Make this persona the complete system prompt, suppressing every other section. */
1850
+ prefix: string
1851
+ /**
1852
+ * Persona suffix template rendered after first-party guidance. Omitted or empty
1853
+ * text shadows the deployment suffix away; interpolation is strict.
1854
+ */
1855
+ suffix?: string
1856
+ /** Make the prefix the complete system prompt, suppressing the suffix and every other section. */
1559
1857
  complete?: boolean
1560
1858
  /** Suppress dynamic runtime-context snapshots for this persona's agent scope. */
1561
1859
  includeRuntimeContext?: boolean
@@ -1578,7 +1876,29 @@ export interface PlanModeConfig {
1578
1876
  }
1579
1877
  ```
1580
1878
 
1581
- 来源:[`packages/plan/plan-mode/src/index.ts:63`](../packages/plan/plan-mode/src/index.ts)
1879
+ 来源:[`packages/plan/plan-mode/src/index.ts:64`](../packages/plan/plan-mode/src/index.ts)
1880
+
1881
+ <a id="deepseek-aidsh-plugin-manager"></a>
1882
+
1883
+ ## `@deepseek-ai/dsh-plugin-manager`
1884
+
1885
+ 依赖: `loader` · `profileContext`
1886
+
1887
+ ```ts config-catalog
1888
+ /** The pnpm executable and the limits for package diagnostics and registry lookups. */
1889
+ export interface Config {
1890
+ /** The pnpm executable name or path; resolved through `PATH` like the `dsh plugin` command. */
1891
+ pnpmCommand?: string
1892
+ /** Maximum retained pnpm diagnostic bytes per operation. */
1893
+ outputBytes?: number
1894
+ /** Maximum time to wait for another process's profile package operation. */
1895
+ lockWaitMs?: number
1896
+ /** Bound on one registry lookup an inspection runs, in milliseconds. */
1897
+ inspectTimeoutMs?: number
1898
+ }
1899
+ ```
1900
+
1901
+ 来源: [`packages/boot/plugin-manager/src/index.ts:33`](../packages/boot/plugin-manager/src/index.ts)
1582
1902
 
1583
1903
  <a id="deepseek-aidsh-plugin-package-inventory-deepseek"></a>
1584
1904
 
@@ -1594,7 +1914,43 @@ export interface Config {
1594
1914
  }
1595
1915
  ```
1596
1916
 
1597
- 来源:[`packages/llm/plugin-package-inventory-deepseek/src/index.ts:31`](../packages/llm/plugin-package-inventory-deepseek/src/index.ts)
1917
+ 来源:[`packages/llm/plugin-package-inventory-deepseek/src/index.ts:32`](../packages/llm/plugin-package-inventory-deepseek/src/index.ts)
1918
+
1919
+ <a id="deepseek-aidsh-ptc-runtime-node"></a>
1920
+
1921
+ ## `@deepseek-ai/dsh-ptc-runtime-node`
1922
+
1923
+ 需要: `fs` · `subprocess` · `sandbox` · `sandboxPolicy`
1924
+
1925
+ ```ts config-catalog
1926
+ /** Deployment-varying runtime bounds and launch choices. */
1927
+ export interface Config extends LaunchConfig {
1928
+ /** Default elapsed deadline, including nested tool and approval waits. */
1929
+ timeoutMs?: number
1930
+ /** Maximum numeric elapsed budget accepted by resolve. */
1931
+ maxTimeoutMs?: number
1932
+ /** Combined serialized logs, completion and diagnostic byte cap. */
1933
+ maxOutputBytes?: number
1934
+ /** V8 old-generation heap limit in MiB; native allocations are excluded. */
1935
+ maxOldGenerationSizeMb?: number
1936
+ /** Maximum control frame, outstanding argument and queued control-output bytes. */
1937
+ maxMessageBytes?: number
1938
+ /** Maximum simultaneous host binding calls accepted from a program. */
1939
+ maxPendingCalls?: number
1940
+ /** Managed process termination and output-drain grace in milliseconds. */
1941
+ graceMs?: number
1942
+ }
1943
+
1944
+ /** Deployment-owned Node executable and optional preinstalled built bootstrap. */
1945
+ export interface LaunchConfig {
1946
+ /** Executable in the subprocess world; defaults to the current Node executable. */
1947
+ nodeExecutable?: string
1948
+ /** Absolute preinstalled built bootstrap in the execution world. */
1949
+ bootstrapPath?: string
1950
+ }
1951
+ ```
1952
+
1953
+ 来源: [`packages/ptc-runtime/ptc-runtime-node/src/index.ts:26`](../packages/ptc-runtime/ptc-runtime-node/src/index.ts)
1598
1954
 
1599
1955
  <a id="deepseek-aidsh-pwsh-local"></a>
1600
1956
 
@@ -1647,7 +2003,7 @@ export interface Config {
1647
2003
  export type Config = LocalConfig
1648
2004
  ```
1649
2005
 
1650
- 依赖:[`LocalConfig`](#deepseek-aidsh-pwsh-local)
2006
+ Depends on: [`LocalConfig`](#deepseek-aidsh-pwsh-local)
1651
2007
 
1652
2008
  来源:[`packages/shell/pwsh-sandbox/src/index.ts:40`](../packages/shell/pwsh-sandbox/src/index.ts)
1653
2009
 
@@ -1735,16 +2091,16 @@ export interface Config {
1735
2091
  /** File-sandbox mode a session starts from (default: `read-only`). */
1736
2092
  mode?: SandboxMode
1737
2093
  /**
1738
- * Fallback root for agentless calls and sessions without a cwd (default:
2094
+ * Absolute fallback root for agentless calls and sessions without a cwd (default:
1739
2095
  * `process.cwd()`). Normal agent calls use their session cwd instead.
1740
2096
  */
1741
2097
  workspaceRoot?: string
1742
2098
  }
1743
2099
  ```
1744
2100
 
1745
- 依赖:[`SandboxMode`](subsystems/sandbox.zh.md)
2101
+ Depends on: [`SandboxMode`](subsystems/sandbox.zh.md)
1746
2102
 
1747
- 来源:[`packages/sandbox/sandbox-policy/src/index.ts:70`](../packages/sandbox/sandbox-policy/src/index.ts)
2103
+ 来源:[`packages/sandbox/sandbox-policy/src/index.ts:71`](../packages/sandbox/sandbox-policy/src/index.ts)
1748
2104
 
1749
2105
  <a id="deepseek-aidsh-sdk-app"></a>
1750
2106
 
@@ -1782,7 +2138,7 @@ export interface JsonRpcConfig {
1782
2138
  }
1783
2139
  ```
1784
2140
 
1785
- 依赖:`Readable`(`node:stream`)· `Writable`(`node:stream`)
2141
+ Depends on: `Readable` (`node:stream`) · `Writable` (`node:stream`)
1786
2142
 
1787
2143
  来源:[`packages/sdk/server/src/index.ts:25`](../packages/sdk/server/src/index.ts)
1788
2144
 
@@ -1795,12 +2151,12 @@ export interface JsonRpcConfig {
1795
2151
  ```ts config-catalog
1796
2152
  /** Session-log request contribution configuration. */
1797
2153
  export interface Config {
1798
- /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `false`. */
2154
+ /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `true`. */
1799
2155
  enabled?: boolean
1800
2156
  }
1801
2157
  ```
1802
2158
 
1803
- 来源:[`packages/session/session-log-deepseek/src/index.ts:36`](../packages/session/session-log-deepseek/src/index.ts)
2159
+ 来源:[`packages/session/session-log-deepseek/src/index.ts:38`](../packages/session/session-log-deepseek/src/index.ts)
1804
2160
 
1805
2161
  <a id="deepseek-aidsh-session-log-export"></a>
1806
2162
 
@@ -1819,7 +2175,7 @@ export interface Config {
1819
2175
  export type SessionLogCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
1820
2176
  ```
1821
2177
 
1822
- 来源:[`packages/session-query/session-log-export/src/index.ts:45`](../packages/session-query/session-log-export/src/index.ts)
2178
+ 来源:[`packages/session-query/session-log-export/src/index.ts:46`](../packages/session-query/session-log-export/src/index.ts)
1823
2179
 
1824
2180
  <a id="deepseek-aidsh-session-persistence-jsonl"></a>
1825
2181
 
@@ -1844,7 +2200,7 @@ export interface Config {
1844
2200
  export type JsonlCompression = 'zstd' | 'none'
1845
2201
  ```
1846
2202
 
1847
- 来源:[`packages/session/session-persistence-jsonl/src/index.ts:85`](../packages/session/session-persistence-jsonl/src/index.ts)
2203
+ 来源:[`packages/session/session-persistence-jsonl/src/index.ts:88`](../packages/session/session-persistence-jsonl/src/index.ts)
1848
2204
 
1849
2205
  <a id="deepseek-aidsh-session-projection-cache"></a>
1850
2206
 
@@ -1914,7 +2270,7 @@ export type OpenAt = 'startup' | 'first-search' | 'never'
1914
2270
  export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist'
1915
2271
  ```
1916
2272
 
1917
- 依赖:[`SessionQueryConfig`](../packages/session-query/session-query/src/index.ts)
2273
+ Depends on: [`SessionQueryConfig`](../packages/session-query/session-query/src/index.ts)
1918
2274
 
1919
2275
  来源:[`packages/session-query/session-query-sqlite/src/index.ts:92`](../packages/session-query/session-query-sqlite/src/index.ts)
1920
2276
 
@@ -1931,8 +2287,10 @@ export interface Config {
1931
2287
  maxReferences?: number
1932
2288
  /** Default host candidate-list limit. */
1933
2289
  candidateLimit?: number
1934
- /** Maximum rendered UTF-8 bytes for one source snapshot. */
2290
+ /** Explicit maximum rendered UTF-8 bytes per source; absent uses the model-relative budget with a 64 KiB floor. */
1935
2291
  maxReferenceBytes?: number
2292
+ /** Fraction of the model context window per source, estimated at four bytes per token; between zero and one. */
2293
+ referenceContextFraction?: number
1936
2294
  }
1937
2295
  ```
1938
2296
 
@@ -1951,7 +2309,7 @@ export interface Config {
1951
2309
  * and shutdown deadline at plugin load; `DISABLED` reads neither.
1952
2310
  */
1953
2311
  export interface Config {
1954
- /** Sharing policy; defaults to local-only `DISABLED` behavior. */
2312
+ /** Defaults to `FEEDBACK_ONLY`: capture session history only when feedback is explicitly submitted. */
1955
2313
  mode?: SessionTelemetryMode
1956
2314
  /**
1957
2315
  * Passed verbatim to the SDK's OTLP/HTTP log exporter — the complete
@@ -1974,15 +2332,14 @@ export interface Config {
1974
2332
 
1975
2333
  /** Session-sharing policy selected by {@link Config.mode}. */
1976
2334
  export enum SessionTelemetryMode {
1977
- FULL = 'FULL',
1978
2335
  FEEDBACK_ONLY = 'FEEDBACK_ONLY',
1979
2336
  DISABLED = 'DISABLED',
1980
2337
  }
1981
2338
  ```
1982
2339
 
1983
- 依赖:`BatchLogRecordProcessorOptions`(`@opentelemetry/sdk-logs`)· `OTLPExporterNodeConfigBase`(`@opentelemetry/otlp-exporter-base`)
2340
+ Depends on: `BatchLogRecordProcessorOptions` (`@opentelemetry/sdk-logs`) · `OTLPExporterNodeConfigBase` (`@opentelemetry/otlp-exporter-base`)
1984
2341
 
1985
- 来源:[`packages/session/session-telemetry-otel/src/index.ts:91`](../packages/session/session-telemetry-otel/src/index.ts)
2342
+ 来源:[`packages/session/session-telemetry-otel/src/index.ts:100`](../packages/session/session-telemetry-otel/src/index.ts)
1986
2343
 
1987
2344
  <a id="deepseek-aidsh-session-title"></a>
1988
2345
 
@@ -2015,7 +2372,7 @@ export interface Config {
2015
2372
  export type Config = SessionTitleLlmConfig
2016
2373
  ```
2017
2374
 
2018
- 依赖:[`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2375
+ Depends on: [`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2019
2376
 
2020
2377
  来源:[`packages/session/session-title-all-prompts-llm/src/index.ts:15`](../packages/session/session-title-all-prompts-llm/src/index.ts)
2021
2378
 
@@ -2030,7 +2387,7 @@ export type Config = SessionTitleLlmConfig
2030
2387
  export type Config = SessionTitleLlmConfig
2031
2388
  ```
2032
2389
 
2033
- 依赖:[`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2390
+ Depends on: [`SessionTitleLlmConfig`](../packages/session/session-title-llm/src/index.ts)
2034
2391
 
2035
2392
  来源:[`packages/session/session-title-first-prompt-llm/src/index.ts:15`](../packages/session/session-title-first-prompt-llm/src/index.ts)
2036
2393
 
@@ -2080,7 +2437,7 @@ export interface Config {
2080
2437
  }
2081
2438
  ```
2082
2439
 
2083
- 来源:[`packages/skill/skill/src/index.ts:280`](../packages/skill/skill/src/index.ts)
2440
+ 来源:[`packages/skill/skill/src/index.ts:278`](../packages/skill/skill/src/index.ts)
2084
2441
 
2085
2442
  <a id="deepseek-aidsh-skill-filesystem"></a>
2086
2443
 
@@ -2120,6 +2477,22 @@ export interface Config {
2120
2477
 
2121
2478
  来源:[`packages/skill/skill-filesystem/src/index.ts:49`](../packages/skill/skill-filesystem/src/index.ts)
2122
2479
 
2480
+ <a id="deepseek-aidsh-skill-office"></a>
2481
+
2482
+ ## `@deepseek-ai/dsh-skill-office`
2483
+
2484
+ 依赖:`skills`
2485
+
2486
+ ```ts config-catalog
2487
+ /** Office skill resource location. */
2488
+ export interface Config {
2489
+ /** Absolute assets directory containing the three skill folders and shared scripts; defaults to packaged assets. */
2490
+ assetRoot?: string
2491
+ }
2492
+ ```
2493
+
2494
+ 来源:[`packages/skill/skill-office/src/index.ts:15`](../packages/skill/skill-office/src/index.ts)
2495
+
2123
2496
  <a id="deepseek-aidsh-spill-local"></a>
2124
2497
 
2125
2498
  ## `@deepseek-ai/dsh-spill-local`
@@ -2167,7 +2540,41 @@ export interface Config {
2167
2540
  }
2168
2541
  ```
2169
2542
 
2170
- 来源:[`packages/spill/spill-policy/src/index.ts:60`](../packages/spill/spill-policy/src/index.ts)
2543
+ 来源:[`packages/spill/spill-policy/src/index.ts:61`](../packages/spill/spill-policy/src/index.ts)
2544
+
2545
+ <a id="deepseek-aidsh-ssh"></a>
2546
+
2547
+ ## `@deepseek-ai/dsh-ssh`
2548
+
2549
+ ```ts config-catalog
2550
+ /** Deployment-owned SSH identity and installed helper; no model argument selects these values. */
2551
+ export interface Config {
2552
+ /** OpenSSH host alias, including its existing user, key and known-host configuration. */
2553
+ host: string
2554
+ /** Absolute remote Node executable. */
2555
+ node: string
2556
+ /** Absolute path to the installed, bundled helper entry. */
2557
+ helper: string
2558
+ /** SHA-256 of that bundled helper; mismatches refuse the connection. */
2559
+ helperHash: string
2560
+ /** Absolute remote default workspace. */
2561
+ workspace: string
2562
+ /** Optional preinstalled built PTC entry, paired with its expected digest. */
2563
+ bootstrapPath?: string
2564
+ /** SHA-256 of bootstrapPath; both fields must be supplied together. */
2565
+ bootstrapHash?: string
2566
+ /** Connection and administrative-request deadline, at most 2,147,483,647 milliseconds. */
2567
+ requestTimeoutMs?: number
2568
+ /** Maximum JSON payload bytes per helper request or response. */
2569
+ maxFrameBytes?: number
2570
+ /** Maximum ordinary requests; heartbeat and bounded resource cleanup have reserved capacity. */
2571
+ maxPending?: number
2572
+ /** Remote helper lease; loss of heartbeats starts remote managed cleanup. */
2573
+ leaseMs?: number
2574
+ }
2575
+ ```
2576
+
2577
+ 来源:[`packages/ssh/ssh/src/index.ts:17`](../packages/ssh/ssh/src/index.ts)
2171
2578
 
2172
2579
  <a id="deepseek-aidsh-storage-domain"></a>
2173
2580
 
@@ -2253,6 +2660,22 @@ export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist'
2253
2660
 
2254
2661
  来源:[`packages/storage/storage-sqlite/src/index.ts:24`](../packages/storage/storage-sqlite/src/index.ts)
2255
2662
 
2663
+ <a id="deepseek-aidsh-subagent"></a>
2664
+
2665
+ ## `@deepseek-ai/dsh-subagent`
2666
+
2667
+ ```ts config-catalog
2668
+ /** Host configuration for continuable subagent capacity. */
2669
+ export interface Config {
2670
+ /** Maximum live children sharing uninterrupted continuable parent links; defaults to 8. */
2671
+ maxActiveSubagents?: number
2672
+ /** Default delegation depth for tools without an explicit limit; defaults to 1. */
2673
+ maxDepth?: number
2674
+ }
2675
+ ```
2676
+
2677
+ 来源: [`packages/subagent/subagent/src/index.ts:190`](../packages/subagent/subagent/src/index.ts)
2678
+
2256
2679
  <a id="deepseek-aidsh-subagent-acp"></a>
2257
2680
 
2258
2681
  ## `@deepseek-ai/dsh-subagent-acp`
@@ -2331,7 +2754,7 @@ export interface Config {
2331
2754
  * `bypassPermissions` explicitly skips permission checks.
2332
2755
  */
2333
2756
  permissionMode?: ClaudeCodePermissionMode
2334
- /** Grace in milliseconds for Claude Code process-tree termination. */
2757
+ /** Grace in milliseconds between Claude Code managed-range termination tiers. */
2335
2758
  disposeGraceMs?: number
2336
2759
  }
2337
2760
 
@@ -2361,7 +2784,7 @@ export interface Config {
2361
2784
  env?: Record<string, string>
2362
2785
  /** Native non-interactive permission mode fixed for this Provider instance. */
2363
2786
  permissionMode?: CodexPermissionMode
2364
- /** Grace in milliseconds for app-server process-tree termination. */
2787
+ /** Grace in milliseconds between app-server managed-range termination tiers. */
2365
2788
  disposeGraceMs?: number
2366
2789
  }
2367
2790
 
@@ -2462,38 +2885,27 @@ export interface Config {
2462
2885
 
2463
2886
  来源:[`packages/subagent/subagent-spawn-in-process/src/index.ts:25`](../packages/subagent/subagent-spawn-in-process/src/index.ts)
2464
2887
 
2465
- <a id="deepseek-aidsh-subprocess-e2b"></a>
2466
-
2467
- ## `@deepseek-ai/dsh-subprocess-e2b`
2468
-
2469
- 需要:`e2b`
2470
-
2471
- ```ts config-catalog
2472
- /** Configuration for the E2B subprocess adapter. */
2473
- export interface Config {
2474
- /** Remote status/liveness poll cadence in milliseconds; each tick is one control-plane request. */
2475
- pollMs?: number
2476
- }
2477
- ```
2478
-
2479
- 来源:[`packages/e2b/subprocess-e2b/src/index.ts:25`](../packages/e2b/subprocess-e2b/src/index.ts)
2480
-
2481
2888
  <a id="deepseek-aidsh-system-prompt"></a>
2482
2889
 
2483
2890
  ## `@deepseek-ai/dsh-system-prompt`
2484
2891
 
2485
2892
  ```ts config-catalog
2486
- /** Plugin config: the deployment-authored fragment of the system prompt (see {@link Config.persona} for its contract). */
2893
+ /** Plugin config: the deployment-authored fragment of the system prompt (see {@link Config.personaPrefix} for its contract). */
2487
2894
  export interface Config {
2488
2895
  /** Include the fixed DeepSeek Harness identity before the deployment persona (default true). */
2489
2896
  includeHarnessIdentity?: boolean
2490
2897
  /** Include dynamic runtime-context snapshots in model history (default true). */
2491
2898
  includeRuntimeContext?: boolean
2492
2899
  /**
2493
- * Deployment-wide order-0 persona template. A scoped section named
2494
- * `deployment:persona` shadows it; `{{variable}}` references are strict.
2900
+ * Deployment-wide persona prefix template before first-party guidance. A scoped section named
2901
+ * `deployment:persona-prefix` shadows it; `{{variable}}` references are strict.
2495
2902
  */
2496
- persona?: string
2903
+ personaPrefix?: string
2904
+ /**
2905
+ * Persona suffix template after first-party guidance. A scoped `deployment:persona-suffix`
2906
+ * section shadows it; `{{variable}}` references are strict. Defaults to empty.
2907
+ */
2908
+ personaSuffix?: string
2497
2909
  /**
2498
2910
  * Model-facing tool names in order, with {@link TOOL_ORDER_REST} exactly once.
2499
2911
  * Invalid fields fail at load and unknown names fail at assembly; known names
@@ -2503,7 +2915,7 @@ export interface Config {
2503
2915
  }
2504
2916
  ```
2505
2917
 
2506
- 来源:[`packages/core/system-prompt/src/index.ts:237`](../packages/core/system-prompt/src/index.ts)
2918
+ 来源:[`packages/core/system-prompt/src/index.ts:248`](../packages/core/system-prompt/src/index.ts)
2507
2919
 
2508
2920
  <a id="deepseek-aidsh-terminal-bash"></a>
2509
2921
 
@@ -2571,7 +2983,7 @@ export interface Config {
2571
2983
  }
2572
2984
  ```
2573
2985
 
2574
- 来源:[`packages/context/time-context/src/index.ts:48`](../packages/context/time-context/src/index.ts)
2986
+ 来源:[`packages/context/time-context/src/index.ts:49`](../packages/context/time-context/src/index.ts)
2575
2987
 
2576
2988
  <a id="deepseek-aidsh-tmux-context"></a>
2577
2989
 
@@ -2638,7 +3050,7 @@ export interface Config {
2638
3050
  }
2639
3051
  ```
2640
3052
 
2641
- 来源:[`packages/shell/tool-bash-persistent/src/index.ts:432`](../packages/shell/tool-bash-persistent/src/index.ts)
3053
+ 来源:[`packages/shell/tool-bash-persistent/src/index.ts:435`](../packages/shell/tool-bash-persistent/src/index.ts)
2642
3054
 
2643
3055
  <a id="deepseek-aidsh-tool-fs"></a>
2644
3056
 
@@ -2767,6 +3179,22 @@ export interface Config {
2767
3179
 
2768
3180
  来源:[`packages/lsp/tool-lsp/src/index.ts:57`](../packages/lsp/tool-lsp/src/index.ts)
2769
3181
 
3182
+ <a id="deepseek-aidsh-tool-present"></a>
3183
+
3184
+ ## `@deepseek-ai/dsh-tool-present`
3185
+
3186
+ 依赖: `tools` · `fs` · `sessionProjections`
3187
+
3188
+ ```ts config-catalog
3189
+ /** Per-call delivery limit. */
3190
+ export interface Config {
3191
+ /** Maximum number of files in one call. */
3192
+ maxFiles: number
3193
+ }
3194
+ ```
3195
+
3196
+ 来源:[`packages/deliverables/tool-present/src/index.ts:15`](../packages/deliverables/tool-present/src/index.ts)
3197
+
2770
3198
  <a id="deepseek-aidsh-tool-pwsh"></a>
2771
3199
 
2772
3200
  ## `@deepseek-ai/dsh-tool-pwsh`
@@ -2896,8 +3324,8 @@ export interface Config {
2896
3324
  */
2897
3325
  toolName?: string
2898
3326
  /**
2899
- * Sample the Host `subagent-model-selection` user setting for each new
2900
- * top-level session and inherit that decision in its child sessions.
3327
+ * Sample the Host `subagent-model-selection` setting for each new top-level
3328
+ * Session and inherit that decision in its child Sessions.
2901
3329
  */
2902
3330
  modelSelectionSettings?: boolean
2903
3331
  /**
@@ -2917,7 +3345,7 @@ export interface Config {
2917
3345
  */
2918
3346
  agentOptions?: AgentOptions
2919
3347
  /**
2920
- * Per-child persona that shadows `deployment:persona`. Requires the
3348
+ * Per-child persona that shadows `deployment:persona-prefix`. Requires the
2921
3349
  * provider's `persona` capability; omission preserves the deployment persona.
2922
3350
  */
2923
3351
  persona?: string
@@ -2933,19 +3361,20 @@ export interface Config {
2933
3361
  deny?: string[]
2934
3362
  }
2935
3363
  /**
2936
- * Maximum child depth: a non-negative safe integer (default `3`; `0` forbids
2937
- * delegation entirely), or `'provider-managed'` to send no cap. A numeric cap
3364
+ * Maximum child depth: a non-negative safe integer (`0` forbids delegation),
3365
+ * or `'provider-managed'` to send no cap. A numeric cap
2938
3366
  * requires the provider's `depthLimit` capability (mount fails loud
2939
3367
  * otherwise). The provider checks the calling agent's current depth at every
2940
3368
  * start; the tool remains model-visible so runtime policy owns rejection.
2941
3369
  * `'provider-managed'` is for an out-of-process provider whose recursion
2942
- * budget belongs to the child runtime or its own deployment.
3370
+ * budget belongs to the child runtime or its own deployment. Omission reads
3371
+ * the current Host subagent depth setting (default `1`) at each delegation.
2943
3372
  */
2944
3373
  maxDepth?: number | 'provider-managed'
2945
3374
  }
2946
3375
  ```
2947
3376
 
2948
- 依赖:[`AgentOptions`](subsystems/core.zh.md)
3377
+ Depends on: [`AgentOptions`](subsystems/core.zh.md)
2949
3378
 
2950
3379
  来源:[`packages/subagent/tool-subagent/src/index.ts:48`](../packages/subagent/tool-subagent/src/index.ts)
2951
3380
 
@@ -3049,7 +3478,7 @@ export interface Config {
3049
3478
  * sends only `run_code` plus a generated SDK prompt and collapses the
3050
3479
  * executor to the same surface (a model-direct call may only name
3051
3480
  * `run_code`; `run_code` SDK sub-dispatches keep every visible tool); `both`
3052
- * sends both forms. PTC mode requires a `ctx.codeRuntime` whose `language`
3481
+ * sends both forms. PTC mode requires a `ctx.ptcRuntime` whose `language`
3053
3482
  * has a registered SDK renderer (TypeScript or Python) and fail prompt
3054
3483
  * assembly when it is absent or has no renderer. Under `ptc`, native names
3055
3484
  * in `toolOrder` are invalid.
@@ -3069,7 +3498,7 @@ export interface Config {
3069
3498
  export type ToolPresentationMode = 'native' | 'ptc' | 'both'
3070
3499
  ```
3071
3500
 
3072
- 来源:[`packages/core/tools/src/index.ts:647`](../packages/core/tools/src/index.ts)
3501
+ 来源:[`packages/core/tools/src/index.ts:656`](../packages/core/tools/src/index.ts)
3073
3502
 
3074
3503
  <a id="deepseek-aidsh-typert-loader"></a>
3075
3504
 
@@ -3085,7 +3514,7 @@ export interface Config {
3085
3514
  }
3086
3515
  ```
3087
3516
 
3088
- 来源:[`packages/typert/loader/src/index.ts:47`](../packages/typert/loader/src/index.ts)
3517
+ 来源:[`packages/typert/loader/src/index.ts:48`](../packages/typert/loader/src/index.ts)
3089
3518
 
3090
3519
  <a id="deepseek-aidsh-user-approval"></a>
3091
3520
 
@@ -3116,7 +3545,7 @@ export interface Config {
3116
3545
  export type ApprovalPolicy = 'ask' | 'never'
3117
3546
  ```
3118
3547
 
3119
- 来源:[`packages/interaction/user-approval/src/index.ts:126`](../packages/interaction/user-approval/src/index.ts)
3548
+ 来源:[`packages/interaction/user-approval/src/index.ts:128`](../packages/interaction/user-approval/src/index.ts)
3120
3549
 
3121
3550
  <a id="deepseek-aidsh-web"></a>
3122
3551
 
@@ -3288,11 +3717,11 @@ export interface Config {
3288
3717
 
3289
3718
  来源:[`packages/webhook/webhook-github/src/index.ts:17`](../packages/webhook/webhook-github/src/index.ts)
3290
3719
 
3291
- <a id="deepseek-aidsh-workflow-worker-thread"></a>
3720
+ <a id="deepseek-aidsh-workflow-ptc"></a>
3292
3721
 
3293
- ## `@deepseek-ai/dsh-workflow-worker-thread`
3722
+ ## `@deepseek-ai/dsh-workflow-ptc`
3294
3723
 
3295
- 需要:`subagents`
3724
+ 需要: `subagents` · `ptcRuntime` · `sandboxPolicy`
3296
3725
 
3297
3726
  ```ts config-catalog
3298
3727
  /** Plugin config (all optional — `static Config` supplies the defaults). */
@@ -3305,18 +3734,39 @@ export interface Config {
3305
3734
  maxTotalAgents?: number
3306
3735
  /** Items accepted by a single `parallel()`/`pipeline()` call (default 4096). */
3307
3736
  maxItemsPerCall?: number
3308
- /** vm timeout for the script's initial synchronous slice, inside the worker (default 5000 ms). */
3737
+ /** VM timeout for the script's initial synchronous slice (default 5000 ms). */
3309
3738
  syncTimeoutMs?: number
3739
+ }
3740
+ ```
3741
+
3742
+ 来源: [`packages/workflow/workflow-ptc/src/index.ts:32`](../packages/workflow/workflow-ptc/src/index.ts)
3743
+
3744
+ <a id="deepseek-aidsh-workspace-changes"></a>
3745
+
3746
+ ## `@deepseek-ai/dsh-workspace-changes`
3747
+
3748
+ 依赖: `subprocess`
3749
+
3750
+ ```ts config-catalog
3751
+ /** Snapshot, capture, and comparison bounds. Invalid values fail plugin load. */
3752
+ export interface Config {
3753
+ /** Milliseconds one git command may run before the turn's record is abandoned. */
3754
+ timeoutMs: number
3755
+ /** Bytes of git output retained per command; a larger diff listing abandons the record. */
3756
+ outputMaxBytes: number
3757
+ /** Maximum files carried by one summary; `total` still reports the complete count. */
3758
+ maxFiles: number
3310
3759
  /**
3311
- * How long after a cancellation an unsettled script may keep running before
3312
- * the run force-settles `cancelled` and its worker is TERMINATED (default
3313
- * 5000 ms); also bounds `dispose()`.
3760
+ * Bytes a file may hold to be captured around a file-tool edit or read from a snapshot for its comparison.
3761
+ * A larger file gets no comparison; one captured around a file-tool edit is also listed without counts.
3314
3762
  */
3315
- disposeGraceMs?: number
3763
+ maxFileBytes: number
3764
+ /** Milliseconds a line comparison may run before it degrades to whole-file replacement. */
3765
+ diffTimeoutMs: number
3316
3766
  }
3317
3767
  ```
3318
3768
 
3319
- 来源:[`packages/workflow/workflow-worker-thread/src/index.ts:32`](../packages/workflow/workflow-worker-thread/src/index.ts)
3769
+ 来源: [`packages/deliverables/workspace-changes/src/index.ts:36`](../packages/deliverables/workspace-changes/src/index.ts)
3320
3770
 
3321
3771
  ## 无配置的可加载插件
3322
3772
 
@@ -3327,9 +3777,11 @@ export interface Config {
3327
3777
  - `@deepseek-ai/dsh-api-remotes` — 需要 `typertGateway`([`packages/api/remotes/src/index.ts`](../packages/api/remotes/src/index.ts))
3328
3778
  - `@deepseek-ai/dsh-api-workspace-controller` — 需要 `typert` · `workspaceRegistry`([`packages/api/workspace-controller/src/index.ts`](../packages/api/workspace-controller/src/index.ts))
3329
3779
  - `@deepseek-ai/dsh-authorization` — 需要 `credentials`([`packages/credentials/authorization/src/index.ts`](../packages/credentials/authorization/src/index.ts))
3780
+ - `@deepseek-ai/dsh-browser-use` ([`packages/browser-use/browser-use/src/index.ts`](../packages/browser-use/browser-use/src/index.ts))
3330
3781
  - `@deepseek-ai/dsh-client-file-upload` — 需要 `agents` · `attachments` · `commands` · `connection`([`packages/client/file-upload/src/index.ts`](../packages/client/file-upload/src/index.ts))
3331
3782
  - `@deepseek-ai/dsh-client-locale`([`packages/client/locale/src/index.ts`](../packages/client/locale/src/index.ts))
3332
- - `@deepseek-ai/dsh-client-modules` — 需要 `webServer` · `loader`([`packages/client/modules/src/index.ts`](../packages/client/modules/src/index.ts))
3783
+ - `@deepseek-ai/dsh-client-modules` — 需要 `loader`([`packages/client/modules/src/index.ts`](../packages/client/modules/src/index.ts))
3784
+ - `@deepseek-ai/dsh-client-resources`([`packages/client/resources/src/index.ts`](../packages/client/resources/src/index.ts))
3333
3785
  - `@deepseek-ai/dsh-client-ui-agent-preset`([`packages/client/ui-agent-preset/src/index.ts`](../packages/client/ui-agent-preset/src/index.ts))
3334
3786
  - `@deepseek-ai/dsh-client-ui-approval`([`packages/client/ui-approval/src/index.ts`](../packages/client/ui-approval/src/index.ts))
3335
3787
  - `@deepseek-ai/dsh-client-ui-attachment`([`packages/client/ui-attachment/src/index.ts`](../packages/client/ui-attachment/src/index.ts))
@@ -3338,7 +3790,7 @@ export interface Config {
3338
3790
  - `@deepseek-ai/dsh-client-ui-commands`([`packages/client/ui-commands/src/index.ts`](../packages/client/ui-commands/src/index.ts))
3339
3791
  - `@deepseek-ai/dsh-client-ui-conversation`([`packages/client/ui-conversation/src/index.ts`](../packages/client/ui-conversation/src/index.ts))
3340
3792
  - `@deepseek-ai/dsh-client-ui-cordis`([`packages/extensions/ui-cordis/src/index.ts`](../packages/extensions/ui-cordis/src/index.ts))
3341
- - `@deepseek-ai/dsh-client-ui-deliverables` — 需要 `systemPrompt`([`packages/client/ui-deliverables/src/index.ts`](../packages/client/ui-deliverables/src/index.ts))
3793
+ - `@deepseek-ai/dsh-client-ui-deliverables` — 需要 `systemPrompt` · `connection` · `sessionQuery` · `sessionController`([`packages/client/ui-deliverables/src/index.ts`](../packages/client/ui-deliverables/src/index.ts))
3342
3794
  - `@deepseek-ai/dsh-client-ui-directory-picker-browse`([`packages/client/ui-directory-picker-browse/src/index.ts`](../packages/client/ui-directory-picker-browse/src/index.ts))
3343
3795
  - `@deepseek-ai/dsh-client-ui-directory-picker-native`([`packages/client/ui-directory-picker-native/src/index.ts`](../packages/client/ui-directory-picker-native/src/index.ts))
3344
3796
  - `@deepseek-ai/dsh-client-ui-goal`([`packages/client/ui-goal/src/index.ts`](../packages/client/ui-goal/src/index.ts))
@@ -3347,8 +3799,10 @@ export interface Config {
3347
3799
  - `@deepseek-ai/dsh-client-ui-layout`([`packages/client/ui-layout/src/index.ts`](../packages/client/ui-layout/src/index.ts))
3348
3800
  - `@deepseek-ai/dsh-client-ui-message-feedback`([`packages/client/ui-message-feedback/src/index.ts`](../packages/client/ui-message-feedback/src/index.ts))
3349
3801
  - `@deepseek-ai/dsh-client-ui-model-selection`([`packages/client/ui-model-selection/src/index.ts`](../packages/client/ui-model-selection/src/index.ts))
3802
+ - `@deepseek-ai/dsh-client-ui-open-in-app`([`packages/client/ui-open-in-app/src/index.ts`](../packages/client/ui-open-in-app/src/index.ts))
3350
3803
  - `@deepseek-ai/dsh-client-ui-permission-presets`([`packages/client/ui-permission-presets/src/index.ts`](../packages/client/ui-permission-presets/src/index.ts))
3351
3804
  - `@deepseek-ai/dsh-client-ui-plan`([`packages/client/ui-plan/src/index.ts`](../packages/client/ui-plan/src/index.ts))
3805
+ - `@deepseek-ai/dsh-client-ui-plugin-manager`([`packages/client/ui-plugin-manager/src/index.ts`](../packages/client/ui-plugin-manager/src/index.ts))
3352
3806
  - `@deepseek-ai/dsh-client-ui-reference`([`packages/client/ui-reference/src/index.ts`](../packages/client/ui-reference/src/index.ts))
3353
3807
  - `@deepseek-ai/dsh-client-ui-renderer`([`packages/client/ui-renderer/src/index.ts`](../packages/client/ui-renderer/src/index.ts))
3354
3808
  - `@deepseek-ai/dsh-client-ui-schedule`([`packages/client/ui-schedule/src/index.ts`](../packages/client/ui-schedule/src/index.ts))
@@ -3358,7 +3812,12 @@ export interface Config {
3358
3812
  - `@deepseek-ai/dsh-client-ui-settings-models`([`packages/client/ui-settings-models/src/index.ts`](../packages/client/ui-settings-models/src/index.ts))
3359
3813
  - `@deepseek-ai/dsh-client-ui-settings-plugin-inventory`([`packages/client/ui-settings-plugin-inventory/src/index.ts`](../packages/client/ui-settings-plugin-inventory/src/index.ts))
3360
3814
  - `@deepseek-ai/dsh-client-ui-settings-plugins`([`packages/client/ui-settings-plugins/src/index.ts`](../packages/client/ui-settings-plugins/src/index.ts))
3815
+ - `@deepseek-ai/dsh-client-ui-settings-unarchive-sessions`([`packages/client/ui-settings-unarchive-sessions/src/index.ts`](../packages/client/ui-settings-unarchive-sessions/src/index.ts))
3361
3816
  - `@deepseek-ai/dsh-client-ui-sidebar`([`packages/client/ui-sidebar/src/index.ts`](../packages/client/ui-sidebar/src/index.ts))
3817
+ - `@deepseek-ai/dsh-client-ui-sidebar-browser`([`packages/client/ui-sidebar-browser/src/index.ts`](../packages/client/ui-sidebar-browser/src/index.ts))
3818
+ - `@deepseek-ai/dsh-client-ui-sidebar-files`([`packages/client/ui-sidebar-files/src/index.ts`](../packages/client/ui-sidebar-files/src/index.ts))
3819
+ - `@deepseek-ai/dsh-client-ui-sidebar-right`([`packages/client/ui-sidebar-right/src/index.ts`](../packages/client/ui-sidebar-right/src/index.ts))
3820
+ - `@deepseek-ai/dsh-client-ui-sidebar-terminal`([`packages/client/ui-sidebar-terminal/src/index.ts`](../packages/client/ui-sidebar-terminal/src/index.ts))
3362
3821
  - `@deepseek-ai/dsh-client-ui-skill`([`packages/client/ui-skill/src/index.ts`](../packages/client/ui-skill/src/index.ts))
3363
3822
  - `@deepseek-ai/dsh-client-ui-subagent`([`packages/client/ui-subagent/src/index.ts`](../packages/client/ui-subagent/src/index.ts))
3364
3823
  - `@deepseek-ai/dsh-client-ui-theme`([`packages/client/ui-theme/src/index.ts`](../packages/client/ui-theme/src/index.ts))
@@ -3371,17 +3830,23 @@ export interface Config {
3371
3830
  - `@deepseek-ai/dsh-command-feedback` — 需要 `commands`([`packages/feedback/command-feedback/src/index.ts`](../packages/feedback/command-feedback/src/index.ts))
3372
3831
  - `@deepseek-ai/dsh-command-goal` — 需要 `commands` · `goals`([`packages/goal/command-goal/src/index.ts`](../packages/goal/command-goal/src/index.ts))
3373
3832
  - `@deepseek-ai/dsh-commands`([`packages/interaction/commands/src/index.ts`](../packages/interaction/commands/src/index.ts))
3833
+ - `@deepseek-ai/dsh-compaction-image-offload`,需要 `agents` 和 `sessions`([`packages/compaction/compaction-image-offload/src/index.ts`](../packages/compaction/compaction-image-offload/src/index.ts))
3834
+ - `@deepseek-ai/dsh-computer-use` ([`packages/computer-use/computer-use/src/index.ts`](../packages/computer-use/computer-use/src/index.ts))
3374
3835
  - `@deepseek-ai/dsh-cordis-client-runner`([`packages/extensions/cordis-client-runner/src/index.ts`](../packages/extensions/cordis-client-runner/src/index.ts))
3375
3836
  - `@deepseek-ai/dsh-deepseek-llm-api-extensions`([`packages/llm/deepseek-llm-api-extensions/src/index.ts`](../packages/llm/deepseek-llm-api-extensions/src/index.ts))
3837
+ - `@deepseek-ai/dsh-experimental-auto-review` — 需要 `llm` · `permissionPresets` · `sessions` · `tools`([`packages/experimental/auto-review/src/index.ts`](../packages/experimental/auto-review/src/index.ts))
3376
3838
  - `@deepseek-ai/dsh-experimental-client-ui-agent-team`([`packages/experimental/client-ui-agent-team/src/index.ts`](../packages/experimental/client-ui-agent-team/src/index.ts))
3377
- - `@deepseek-ai/dsh-fs-e2b` — 需要 `e2b`([`packages/e2b/fs-e2b/src/index.ts`](../packages/e2b/fs-e2b/src/index.ts)
3839
+ - `@deepseek-ai/dsh-experimental-computer-use-cua-driver-native` — requires `computerUse` · `tools` · `systemPrompt` ([`packages/experimental/computer-use-cua-driver-native/src/index.ts`](../packages/experimental/computer-use-cua-driver-native/src/index.ts))
3378
3840
  - `@deepseek-ai/dsh-fs-observation-policy`([`packages/fs/fs-observation-policy/src/index.ts`](../packages/fs/fs-observation-policy/src/index.ts))
3841
+ - `@deepseek-ai/dsh-fs-ssh` — 需要 `ssh` · `sandboxPolicy`([`packages/ssh/fs-ssh/src/index.ts`](../packages/ssh/fs-ssh/src/index.ts))
3379
3842
  - `@deepseek-ai/dsh-goal-round-driver` — 需要 `agents` · `goals` · `sessions`([`packages/goal/goal-round-driver/src/index.ts`](../packages/goal/goal-round-driver/src/index.ts))
3380
3843
  - `@deepseek-ai/dsh-host-directory-picker-auto` — 需要 `webServer` · `loader`([`packages/host/directory-picker-auto/src/index.ts`](../packages/host/directory-picker-auto/src/index.ts))
3381
3844
  - `@deepseek-ai/dsh-host-directory-picker-native`([`packages/host/directory-picker-native/src/index.ts`](../packages/host/directory-picker-native/src/index.ts))
3382
3845
  - `@deepseek-ai/dsh-host-plugin-inventory` — 需要 `loader`([`packages/host/plugin-inventory/src/index.ts`](../packages/host/plugin-inventory/src/index.ts))
3383
3846
  - `@deepseek-ai/dsh-llm`([`packages/llm/llm/src/index.ts`](../packages/llm/llm/src/index.ts))
3384
3847
  - `@deepseek-ai/dsh-lsp`([`packages/lsp/lsp/src/index.ts`](../packages/lsp/lsp/src/index.ts))
3848
+ - `@deepseek-ai/dsh-mcp-resources` — 需要 `tools`([`packages/mcp/mcp-resources/src/index.ts`](../packages/mcp/mcp-resources/src/index.ts))
3849
+ - `@deepseek-ai/dsh-sandbox-ssh` — 需要 `ssh`([`packages/ssh/sandbox-ssh/src/index.ts`](../packages/ssh/sandbox-ssh/src/index.ts))
3385
3850
  - `@deepseek-ai/dsh-schedule` — 需要 `agents` · `sessions` · `tools` · `sessionPersistence`([`packages/schedule/schedule/src/index.ts`](../packages/schedule/schedule/src/index.ts))
3386
3851
  - `@deepseek-ai/dsh-session`([`packages/core/session/src/index.ts`](../packages/core/session/src/index.ts))
3387
3852
  - `@deepseek-ai/dsh-session-checkpoint-policy` — 需要 `llm` · `sessionPersistence` · `sessions` · `tools`([`packages/session/session-checkpoint-policy/src/index.ts`](../packages/session/session-checkpoint-policy/src/index.ts))
@@ -3390,12 +3855,12 @@ export interface Config {
3390
3855
  - `@deepseek-ai/dsh-session-turn-outline` — 需要 `sessionProjections`([`packages/session/session-turn-outline/src/index.ts`](../packages/session/session-turn-outline/src/index.ts))
3391
3856
  - `@deepseek-ai/dsh-skill-badge` — 需要 `skills`([`packages/skill/skill-badge/src/index.ts`](../packages/skill/skill-badge/src/index.ts))
3392
3857
  - `@deepseek-ai/dsh-storage`([`packages/storage/storage/src/index.ts`](../packages/storage/storage/src/index.ts))
3393
- - `@deepseek-ai/dsh-subagent`([`packages/subagent/subagent/src/index.ts`](../packages/subagent/subagent/src/index.ts))
3394
3858
  - `@deepseek-ai/dsh-subprocess-local`([`packages/subprocess/subprocess-local/src/index.ts`](../packages/subprocess/subprocess-local/src/index.ts))
3859
+ - `@deepseek-ai/dsh-subprocess-ssh` — 需要 `ssh`([`packages/ssh/subprocess-ssh/src/index.ts`](../packages/ssh/subprocess-ssh/src/index.ts))
3395
3860
  - `@deepseek-ai/dsh-terminal`([`packages/terminal/terminal/src/index.ts`](../packages/terminal/terminal/src/index.ts))
3396
3861
  - `@deepseek-ai/dsh-tool-ask-user` — 需要 `tools` · `userInteraction`([`packages/interaction/tool-ask-user/src/index.ts`](../packages/interaction/tool-ask-user/src/index.ts))
3397
3862
  - `@deepseek-ai/dsh-tool-call-timeout-policy` — 需要 `tools`([`packages/guard/timeout-policy/src/index.ts`](../packages/guard/timeout-policy/src/index.ts))
3398
- - `@deepseek-ai/dsh-tool-cordis` — 需要 `tools` · `systemPrompt` · `dynamicCordisRunner` · `cordisInspect`([`packages/extensions/tool-cordis/src/index.ts`](../packages/extensions/tool-cordis/src/index.ts))
3863
+ - `@deepseek-ai/dsh-tool-cordis` — 需要 `tools` · `systemPrompt` · `cordisInspect`([`packages/extensions/tool-cordis/src/index.ts`](../packages/extensions/tool-cordis/src/index.ts))
3399
3864
  - `@deepseek-ai/dsh-tool-subagent-control` — 需要 `tools` · `subagents`([`packages/subagent/tool-subagent-control/src/index.ts`](../packages/subagent/tool-subagent-control/src/index.ts))
3400
3865
  - `@deepseek-ai/dsh-user-questions`([`packages/interaction/user-questions/src/index.ts`](../packages/interaction/user-questions/src/index.ts))
3401
3866
  - `@deepseek-ai/dsh-webhook` — 需要 `agents` · `agentDefaultModel` · `agentPresets` · `permissionPresets` · `sessionTitle` · `workspaceRegistry`([`packages/webhook/webhook/src/index.ts`](../packages/webhook/webhook/src/index.ts))
@@ -3406,13 +3871,13 @@ export interface Config {
3406
3871
  抽象服务类——部署时应改为加载具体的实现包(参见[能力 seam](../.agents/notes/implemented/architecture/2026-06-13-capability-seams.zh.md))。
3407
3872
 
3408
3873
  - `@deepseek-ai/dsh-attachment` — 抽象 `AttachmentStore`([`packages/attachment/attachment/src/index.ts`](../packages/attachment/attachment/src/index.ts))
3409
- - `@deepseek-ai/dsh-code-runtime` — 抽象 `CodeRuntime`([`packages/code-runtime/code-runtime/src/index.ts`](../packages/code-runtime/code-runtime/src/index.ts))
3410
3874
  - `@deepseek-ai/dsh-compaction` — 抽象 `CompactionEngine`([`packages/compaction/compaction/src/index.ts`](../packages/compaction/compaction/src/index.ts))
3411
3875
  - `@deepseek-ai/dsh-credentials` — 抽象 `Credentials`([`packages/credentials/credentials/src/index.ts`](../packages/credentials/credentials/src/index.ts))
3412
3876
  - `@deepseek-ai/dsh-file-reference` — 抽象 `FileReferenceService`([`packages/context/file-reference/src/index.ts`](../packages/context/file-reference/src/index.ts))
3413
3877
  - `@deepseek-ai/dsh-fs` — 抽象 `FileSystem`([`packages/fs/fs/src/index.ts`](../packages/fs/fs/src/index.ts))
3414
3878
  - `@deepseek-ai/dsh-host-directory-picker` — 抽象 `DirectoryPicker`([`packages/host/directory-picker/src/index.ts`](../packages/host/directory-picker/src/index.ts))
3415
3879
  - `@deepseek-ai/dsh-jobs` — 抽象 `JobRegistry`([`packages/jobs/jobs/src/index.ts`](../packages/jobs/jobs/src/index.ts))
3880
+ - `@deepseek-ai/dsh-ptc-runtime` — 抽象 `PtcRuntime`([`packages/ptc-runtime/ptc-runtime/src/index.ts`](../packages/ptc-runtime/ptc-runtime/src/index.ts))
3416
3881
  - `@deepseek-ai/dsh-sandbox` — 抽象 `SandboxProvider`([`packages/sandbox/sandbox/src/index.ts`](../packages/sandbox/sandbox/src/index.ts))
3417
3882
  - `@deepseek-ai/dsh-session-persistence` — 抽象 `SessionPersistence`([`packages/session/session-persistence/src/index.ts`](../packages/session/session-persistence/src/index.ts))
3418
3883
  - `@deepseek-ai/dsh-session-query` — 抽象 `SessionQueryEngine`([`packages/session-query/session-query/src/index.ts`](../packages/session-query/session-query/src/index.ts))
@@ -3431,8 +3896,10 @@ export interface Config {
3431
3896
  - `@deepseek-ai/dsh-atomic-write`([`packages/util/atomic-write/src/index.ts`](../packages/util/atomic-write/src/index.ts))
3432
3897
  - `@deepseek-ai/dsh-base`([`packages/bundle/base/src/index.ts`](../packages/bundle/base/src/index.ts))
3433
3898
  - `@deepseek-ai/dsh-brand`([`packages/util/brand/src/index.ts`](../packages/util/brand/src/index.ts))
3899
+ - `@deepseek-ai/dsh-chunked-list`([`packages/util/chunked-list/src/index.ts`](../packages/util/chunked-list/src/index.ts))
3434
3900
  - `@deepseek-ai/dsh-client-store`([`packages/client/store/src/index.ts`](../packages/client/store/src/index.ts))
3435
3901
  - `@deepseek-ai/dsh-client-test-runtime`([`packages/test-support/client-runtime/src/index.ts`](../packages/test-support/client-runtime/src/index.ts))
3902
+ - `@deepseek-ai/dsh-client-ui-dockkit`([`packages/client/ui-dockkit/src/index.ts`](../packages/client/ui-dockkit/src/index.ts))
3436
3903
  - `@deepseek-ai/dsh-client-ui-primitives`([`packages/client/ui-primitives/src/index.ts`](../packages/client/ui-primitives/src/index.ts))
3437
3904
  - `@deepseek-ai/dsh-client-ui-slots`([`packages/client/ui-slots/src/index.ts`](../packages/client/ui-slots/src/index.ts))
3438
3905
  - `@deepseek-ai/dsh-client-web`([`packages/client/web/src/index.ts`](../packages/client/web/src/index.ts))
@@ -3440,16 +3907,20 @@ export interface Config {
3440
3907
  - `@deepseek-ai/dsh-deque`([`packages/util/deque/src/index.ts`](../packages/util/deque/src/index.ts))
3441
3908
  - `@deepseek-ai/dsh-experimental-agent-team-profile`([`packages/experimental/agent-team-profile/src/index.ts`](../packages/experimental/agent-team-profile/src/index.ts))
3442
3909
  - `@deepseek-ai/dsh-experimental-agent-team-web-profile`([`packages/experimental/agent-team-web-profile/src/index.ts`](../packages/experimental/agent-team-web-profile/src/index.ts))
3910
+ - `@deepseek-ai/dsh-experimental-browser-use-runtime` ([`packages/experimental/browser-use-runtime/src/index.ts`](../packages/experimental/browser-use-runtime/src/index.ts))
3443
3911
  - `@deepseek-ai/dsh-experimental-webworker-packer`([`packages/experimental/webworker-packer/src/index.ts`](../packages/experimental/webworker-packer/src/index.ts))
3444
3912
  - `@deepseek-ai/dsh-experimental-webworker-runtime`([`packages/experimental/webworker-runtime/src/index.ts`](../packages/experimental/webworker-runtime/src/index.ts))
3445
3913
  - `@deepseek-ai/dsh-home-paths`([`packages/util/home-paths/src/index.ts`](../packages/util/home-paths/src/index.ts))
3446
3914
  - `@deepseek-ai/dsh-hook-protocol`([`packages/hooks/hook-protocol/src/index.ts`](../packages/hooks/hook-protocol/src/index.ts))
3447
3915
  - `@deepseek-ai/dsh-http-proxy`([`packages/util/http-proxy/src/index.ts`](../packages/util/http-proxy/src/index.ts))
3448
3916
  - `@deepseek-ai/dsh-launch-environment`([`packages/util/launch-environment/src/index.ts`](../packages/util/launch-environment/src/index.ts))
3917
+ - `@deepseek-ai/dsh-lazy-require`([`packages/util/lazy-require/src/index.ts`](../packages/util/lazy-require/src/index.ts))
3449
3918
  - `@deepseek-ai/dsh-llm-mock-server`([`packages/test-support/llm-mock-server/src/index.ts`](../packages/test-support/llm-mock-server/src/index.ts))
3450
3919
  - `@deepseek-ai/dsh-loader-smoke`([`packages/test-support/loader-smoke/src/index.ts`](../packages/test-support/loader-smoke/src/index.ts))
3451
3920
  - `@deepseek-ai/dsh-native-command`([`packages/util/native-command/src/index.ts`](../packages/util/native-command/src/index.ts))
3452
3921
  - `@deepseek-ai/dsh-output-retention`([`packages/util/output-retention/src/index.ts`](../packages/util/output-retention/src/index.ts))
3922
+ - `@deepseek-ai/dsh-package-manifest` ([`packages/util/package-manifest/src/index.ts`](../packages/util/package-manifest/src/index.ts))
3923
+ - `@deepseek-ai/dsh-remote-mock`([`packages/test-support/remote-mock/src/index.ts`](../packages/test-support/remote-mock/src/index.ts))
3453
3924
  - `@deepseek-ai/dsh-sandbox-windows-acl`([`packages/sandbox/sandbox-windows-acl/src/index.ts`](../packages/sandbox/sandbox-windows-acl/src/index.ts))
3454
3925
  - `@deepseek-ai/dsh-scope`([`packages/core/scope/src/index.ts`](../packages/core/scope/src/index.ts))
3455
3926
  - `@deepseek-ai/dsh-sdk-client`([`packages/sdk/client/src/index.ts`](../packages/sdk/client/src/index.ts))
@@ -3459,6 +3930,7 @@ export interface Config {
3459
3930
  - `@deepseek-ai/dsh-session-format-catalog`([`packages/session/session-format-catalog/src/index.ts`](../packages/session/session-format-catalog/src/index.ts))
3460
3931
  - `@deepseek-ai/dsh-session-format-v0-to-v1`([`packages/session/session-format-v0-to-v1/src/index.ts`](../packages/session/session-format-v0-to-v1/src/index.ts))
3461
3932
  - `@deepseek-ai/dsh-session-format-v1-to-v2`([`packages/session/session-format-v1-to-v2/src/index.ts`](../packages/session/session-format-v1-to-v2/src/index.ts))
3933
+ - `@deepseek-ai/dsh-session-format-v2-to-v3`([`packages/session/session-format-v2-to-v3/src/index.ts`](../packages/session/session-format-v2-to-v3/src/index.ts))
3462
3934
  - `@deepseek-ai/dsh-session-snapshot`([`packages/test-support/session-snapshot/src/index.ts`](../packages/test-support/session-snapshot/src/index.ts))
3463
3935
  - `@deepseek-ai/dsh-session-telemetry`([`packages/session/session-telemetry/src/index.ts`](../packages/session/session-telemetry/src/index.ts))
3464
3936
  - `@deepseek-ai/dsh-session-title-llm`([`packages/session/session-title-llm/src/index.ts`](../packages/session/session-title-llm/src/index.ts))