@agent-native/core 0.79.11 → 0.79.15

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 (289) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +25 -0
  3. package/corpus/core/docs/content/locales/zh-TW/a2a-protocol.md +68 -68
  4. package/corpus/core/docs/content/locales/zh-TW/actions.md +82 -82
  5. package/corpus/core/docs/content/locales/zh-TW/agent-mentions.md +22 -22
  6. package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.md +82 -82
  7. package/corpus/core/docs/content/locales/zh-TW/agent-teams.md +29 -29
  8. package/corpus/core/docs/content/locales/zh-TW/agent-web-surfaces.md +11 -11
  9. package/corpus/core/docs/content/locales/zh-TW/audit-log.md +16 -16
  10. package/corpus/core/docs/content/locales/zh-TW/authentication.md +32 -32
  11. package/corpus/core/docs/content/locales/zh-TW/automations.md +32 -32
  12. package/corpus/core/docs/content/locales/zh-TW/blueprint-installer.md +19 -19
  13. package/corpus/core/docs/content/locales/zh-TW/cli-adapters.md +17 -17
  14. package/corpus/core/docs/content/locales/zh-TW/client.md +62 -62
  15. package/corpus/core/docs/content/locales/zh-TW/cloneable-saas.md +32 -32
  16. package/corpus/core/docs/content/locales/zh-TW/code-agents-ui.md +91 -91
  17. package/corpus/core/docs/content/locales/zh-TW/components.md +51 -51
  18. package/corpus/core/docs/content/locales/zh-TW/context-awareness.md +66 -66
  19. package/corpus/core/docs/content/locales/zh-TW/creating-templates.md +39 -39
  20. package/corpus/core/docs/content/locales/zh-TW/cross-app-sso.md +29 -29
  21. package/corpus/core/docs/content/locales/zh-TW/database.md +21 -21
  22. package/corpus/core/docs/content/locales/zh-TW/deployment.md +37 -37
  23. package/corpus/core/docs/content/locales/zh-TW/dispatch.md +43 -43
  24. package/corpus/core/docs/content/locales/zh-TW/drop-in-agent.md +34 -34
  25. package/corpus/core/docs/content/locales/zh-TW/durable-resume.md +18 -18
  26. package/corpus/core/docs/content/locales/zh-TW/embedding-sdk.md +73 -73
  27. package/corpus/core/docs/content/locales/zh-TW/evals.md +16 -16
  28. package/corpus/core/docs/content/locales/zh-TW/extensions.md +81 -81
  29. package/corpus/core/docs/content/locales/zh-TW/external-agents.md +146 -146
  30. package/corpus/core/docs/content/locales/zh-TW/faq.md +43 -43
  31. package/corpus/core/docs/content/locales/zh-TW/file-uploads.md +11 -11
  32. package/corpus/core/docs/content/locales/zh-TW/frames.md +33 -33
  33. package/corpus/core/docs/content/locales/zh-TW/getting-started.md +28 -28
  34. package/corpus/core/docs/content/locales/zh-TW/harness-agents.md +78 -78
  35. package/corpus/core/docs/content/locales/zh-TW/human-approval.md +27 -27
  36. package/corpus/core/docs/content/locales/zh-TW/internationalization.md +19 -19
  37. package/corpus/core/docs/content/locales/zh-TW/key-concepts.md +68 -68
  38. package/corpus/core/docs/content/locales/zh-TW/local-file-mode.md +50 -50
  39. package/corpus/core/docs/content/locales/zh-TW/mcp-apps.md +38 -38
  40. package/corpus/core/docs/content/locales/zh-TW/mcp-clients.md +67 -67
  41. package/corpus/core/docs/content/locales/zh-TW/mcp-protocol.md +50 -50
  42. package/corpus/core/docs/content/locales/zh-TW/messaging.md +99 -99
  43. package/corpus/core/docs/content/locales/zh-TW/migration-workbench.md +6 -6
  44. package/corpus/core/docs/content/locales/zh-TW/multi-app-workspace.md +39 -39
  45. package/corpus/core/docs/content/locales/zh-TW/multi-tenancy.md +7 -7
  46. package/corpus/core/docs/content/locales/zh-TW/native-chat-ui.md +38 -38
  47. package/corpus/core/docs/content/locales/zh-TW/notifications.md +23 -23
  48. package/corpus/core/docs/content/locales/zh-TW/observability.md +49 -49
  49. package/corpus/core/docs/content/locales/zh-TW/observational-memory.md +23 -23
  50. package/corpus/core/docs/content/locales/zh-TW/onboarding.md +40 -40
  51. package/corpus/core/docs/content/locales/zh-TW/plan-plugin.md +37 -37
  52. package/corpus/core/docs/content/locales/zh-TW/pr-visual-recap.md +72 -72
  53. package/corpus/core/docs/content/locales/zh-TW/processors.md +17 -17
  54. package/corpus/core/docs/content/locales/zh-TW/progress.md +15 -15
  55. package/corpus/core/docs/content/locales/zh-TW/pure-agent-apps.md +10 -10
  56. package/corpus/core/docs/content/locales/zh-TW/real-time-collaboration.md +103 -103
  57. package/corpus/core/docs/content/locales/zh-TW/recurring-jobs.md +19 -19
  58. package/corpus/core/docs/content/locales/zh-TW/routing.md +9 -9
  59. package/corpus/core/docs/content/locales/zh-TW/sandbox-adapters.md +48 -48
  60. package/corpus/core/docs/content/locales/zh-TW/security.md +49 -49
  61. package/corpus/core/docs/content/locales/zh-TW/server.md +47 -47
  62. package/corpus/core/docs/content/locales/zh-TW/sharing.md +22 -22
  63. package/corpus/core/docs/content/locales/zh-TW/skills-guide.md +46 -46
  64. package/corpus/core/docs/content/locales/zh-TW/template-analytics.md +40 -40
  65. package/corpus/core/docs/content/locales/zh-TW/template-assets.md +69 -69
  66. package/corpus/core/docs/content/locales/zh-TW/template-brain.md +81 -81
  67. package/corpus/core/docs/content/locales/zh-TW/template-calendar.md +40 -40
  68. package/corpus/core/docs/content/locales/zh-TW/template-chat.md +27 -27
  69. package/corpus/core/docs/content/locales/zh-TW/template-clips.md +85 -85
  70. package/corpus/core/docs/content/locales/zh-TW/template-content.md +65 -66
  71. package/corpus/core/docs/content/locales/zh-TW/template-design.md +29 -29
  72. package/corpus/core/docs/content/locales/zh-TW/template-dispatch.md +51 -51
  73. package/corpus/core/docs/content/locales/zh-TW/template-forms.md +25 -25
  74. package/corpus/core/docs/content/locales/zh-TW/template-mail.md +71 -71
  75. package/corpus/core/docs/content/locales/zh-TW/template-plan.md +92 -92
  76. package/corpus/core/docs/content/locales/zh-TW/template-slides.md +52 -52
  77. package/corpus/core/docs/content/locales/zh-TW/template-videos.md +30 -30
  78. package/corpus/core/docs/content/locales/zh-TW/tracking.md +29 -29
  79. package/corpus/core/docs/content/locales/zh-TW/using-your-agent.md +18 -18
  80. package/corpus/core/docs/content/locales/zh-TW/voice-input.md +19 -19
  81. package/corpus/core/docs/content/locales/zh-TW/what-is-agent-native.md +61 -61
  82. package/corpus/core/docs/content/locales/zh-TW/workspace-connections.md +41 -41
  83. package/corpus/core/docs/content/locales/zh-TW/workspace-management.md +27 -27
  84. package/corpus/core/docs/content/locales/zh-TW/workspace.md +58 -58
  85. package/corpus/core/docs/content/locales/zh-TW/writing-agent-instructions.md +41 -41
  86. package/corpus/core/docs/content/template-clips.md +48 -2
  87. package/corpus/core/package.json +2 -1
  88. package/corpus/core/src/client/AgentPanel.tsx +27 -3
  89. package/corpus/core/src/deploy/build.ts +738 -57
  90. package/corpus/core/src/deploy/route-discovery.ts +1 -1
  91. package/corpus/core/src/server/edge.ts +50 -0
  92. package/corpus/core/src/styles/agent-native.css +93 -0
  93. package/corpus/core/src/templates/default/app/i18n/zh-TW.ts +44 -44
  94. package/corpus/core/src/vite/client.ts +1 -0
  95. package/corpus/templates/analytics/app/components/layout/Layout.tsx +5 -3
  96. package/corpus/templates/analytics/app/i18n/zh-TW.ts +69 -70
  97. package/corpus/templates/analytics/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  98. package/corpus/templates/assets/app/components/layout/Layout.tsx +3 -3
  99. package/corpus/templates/assets/app/i18n/zh-TW.ts +82 -82
  100. package/corpus/templates/assets/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  101. package/corpus/templates/brain/app/components/layout/Layout.tsx +6 -4
  102. package/corpus/templates/brain/app/i18n/zh-TW.ts +90 -90
  103. package/corpus/templates/brain/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  104. package/corpus/templates/calendar/app/components/layout/AppLayout.tsx +1 -1
  105. package/corpus/templates/calendar/app/components/layout/Sidebar.tsx +1 -1
  106. package/corpus/templates/calendar/app/i18n/zh-TW.ts +57 -57
  107. package/corpus/templates/calendar/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  108. package/corpus/templates/calendar/server/lib/booking-og-fonts.ts +20 -6
  109. package/corpus/templates/calendar/server/lib/booking-og-image.ts +17 -9
  110. package/corpus/templates/chat/app/components/layout/Layout.tsx +5 -3
  111. package/corpus/templates/chat/app/i18n/zh-TW.ts +3 -3
  112. package/corpus/templates/chat/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  113. package/corpus/templates/clips/AGENTS.md +6 -0
  114. package/corpus/templates/clips/actions/delete-recording-permanent.ts +7 -1
  115. package/corpus/templates/clips/actions/get-recording-player-data.ts +44 -2
  116. package/corpus/templates/clips/actions/navigate.ts +2 -0
  117. package/corpus/templates/clips/actions/save-bug-report-context.ts +173 -0
  118. package/corpus/templates/clips/actions/view-screen.ts +58 -7
  119. package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx +9 -3
  120. package/corpus/templates/clips/app/hooks/use-navigation-state.ts +17 -0
  121. package/corpus/templates/clips/app/i18n/ar-SA.ts +31 -0
  122. package/corpus/templates/clips/app/i18n/de-DE.ts +32 -0
  123. package/corpus/templates/clips/app/i18n/en-US.ts +32 -0
  124. package/corpus/templates/clips/app/i18n/es-ES.ts +32 -0
  125. package/corpus/templates/clips/app/i18n/fr-FR.ts +32 -0
  126. package/corpus/templates/clips/app/i18n/hi-IN.ts +32 -0
  127. package/corpus/templates/clips/app/i18n/ja-JP.ts +31 -0
  128. package/corpus/templates/clips/app/i18n/ko-KR.ts +32 -0
  129. package/corpus/templates/clips/app/i18n/pt-BR.ts +32 -0
  130. package/corpus/templates/clips/app/i18n/zh-CN.ts +30 -0
  131. package/corpus/templates/clips/app/i18n/zh-TW.ts +461 -451
  132. package/corpus/templates/clips/app/routes/bug-report.done.tsx +126 -0
  133. package/corpus/templates/clips/app/routes/bug-report.tsx +222 -0
  134. package/corpus/templates/clips/app/routes/record.tsx +104 -12
  135. package/corpus/templates/clips/changelog/2026-06-26-brief-network-blips-no-longer-block-recording-or-wrongly-pro.md +6 -0
  136. package/corpus/templates/clips/changelog/2026-06-26-bug-report-recordings-can-keep-redacted-host-app-context-wit.md +6 -0
  137. package/corpus/templates/clips/changelog/2026-06-26-bug-report-widgets-can-launch-clips-recordings-from-embedded.md +6 -0
  138. package/corpus/templates/clips/changelog/2026-06-26-desktop-recording-keeps-connected-users-out-of-the-storage-s.md +6 -0
  139. package/corpus/templates/clips/changelog/2026-06-26-if-a-recording-can-t-be-uploaded-the-chrome-extension-now-sa.md +6 -0
  140. package/corpus/templates/clips/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  141. package/corpus/templates/clips/chrome-extension/public/manifest.json +9 -2
  142. package/corpus/templates/clips/chrome-extension/src/background.ts +43 -0
  143. package/corpus/templates/clips/chrome-extension/src/offscreen.ts +111 -6
  144. package/corpus/templates/clips/chrome-extension/src/popup.ts +18 -7
  145. package/corpus/templates/clips/desktop/src/app.tsx +53 -19
  146. package/corpus/templates/clips/server/db/schema.ts +26 -0
  147. package/corpus/templates/clips/server/lib/public-agent-context.ts +51 -0
  148. package/corpus/templates/clips/server/plugins/auth.ts +1 -0
  149. package/corpus/templates/clips/server/plugins/db.ts +28 -0
  150. package/corpus/templates/clips/server/routes/api/agent-context.json.get.ts +4 -1
  151. package/corpus/templates/clips/shared/bug-report.ts +161 -0
  152. package/corpus/templates/content/app/components/layout/Layout.tsx +10 -8
  153. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +1 -1
  154. package/corpus/templates/content/app/i18n/zh-TW.ts +67 -66
  155. package/corpus/templates/content/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  156. package/corpus/templates/design/app/components/layout/Layout.tsx +3 -3
  157. package/corpus/templates/design/app/i18n/zh-TW.ts +44 -44
  158. package/corpus/templates/design/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  159. package/corpus/templates/dispatch/app/i18n/zh-TW.ts +5 -4
  160. package/corpus/templates/dispatch/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  161. package/corpus/templates/forms/app/components/layout/Layout.tsx +4 -2
  162. package/corpus/templates/forms/app/components/layout/Sidebar.tsx +1 -1
  163. package/corpus/templates/forms/app/i18n/zh-TW.ts +48 -48
  164. package/corpus/templates/forms/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  165. package/corpus/templates/macros/app/components/layout/AppLayout.tsx +3 -3
  166. package/corpus/templates/macros/app/i18n/zh-TW.ts +5 -5
  167. package/corpus/templates/macros/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  168. package/corpus/templates/mail/app/i18n/zh-TW.ts +83 -83
  169. package/corpus/templates/mail/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  170. package/corpus/templates/plan/app/components/layout/Layout.tsx +5 -3
  171. package/corpus/templates/plan/app/i18n/zh-TW.ts +69 -69
  172. package/corpus/templates/plan/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  173. package/corpus/templates/slides/app/components/layout/Layout.tsx +3 -3
  174. package/corpus/templates/slides/app/i18n/zh-TW.ts +64 -64
  175. package/corpus/templates/slides/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  176. package/corpus/templates/videos/app/components/layout/Layout.tsx +2 -2
  177. package/corpus/templates/videos/app/i18n/zh-TW.ts +54 -54
  178. package/corpus/templates/videos/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
  179. package/dist/client/AgentPanel.d.ts.map +1 -1
  180. package/dist/client/AgentPanel.js +14 -4
  181. package/dist/client/AgentPanel.js.map +1 -1
  182. package/dist/collab/routes.d.ts +1 -1
  183. package/dist/deploy/build.d.ts +29 -2
  184. package/dist/deploy/build.d.ts.map +1 -1
  185. package/dist/deploy/build.js +587 -51
  186. package/dist/deploy/build.js.map +1 -1
  187. package/dist/deploy/route-discovery.d.ts +1 -1
  188. package/dist/deploy/route-discovery.js +1 -1
  189. package/dist/deploy/route-discovery.js.map +1 -1
  190. package/dist/file-upload/actions/upload-image.d.ts +2 -2
  191. package/dist/notifications/routes.d.ts +2 -2
  192. package/dist/observability/routes.d.ts +7 -7
  193. package/dist/resources/handlers.d.ts +2 -2
  194. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  195. package/dist/server/edge.d.ts +11 -0
  196. package/dist/server/edge.d.ts.map +1 -0
  197. package/dist/server/edge.js +11 -0
  198. package/dist/server/edge.js.map +1 -0
  199. package/dist/styles/agent-native.css +93 -0
  200. package/dist/templates/default/app/i18n/zh-TW.ts +44 -44
  201. package/dist/vite/client.d.ts.map +1 -1
  202. package/dist/vite/client.js +1 -0
  203. package/dist/vite/client.js.map +1 -1
  204. package/docs/content/locales/zh-TW/a2a-protocol.md +68 -68
  205. package/docs/content/locales/zh-TW/actions.md +82 -82
  206. package/docs/content/locales/zh-TW/agent-mentions.md +22 -22
  207. package/docs/content/locales/zh-TW/agent-surfaces.md +82 -82
  208. package/docs/content/locales/zh-TW/agent-teams.md +29 -29
  209. package/docs/content/locales/zh-TW/agent-web-surfaces.md +11 -11
  210. package/docs/content/locales/zh-TW/audit-log.md +16 -16
  211. package/docs/content/locales/zh-TW/authentication.md +32 -32
  212. package/docs/content/locales/zh-TW/automations.md +32 -32
  213. package/docs/content/locales/zh-TW/blueprint-installer.md +19 -19
  214. package/docs/content/locales/zh-TW/cli-adapters.md +17 -17
  215. package/docs/content/locales/zh-TW/client.md +62 -62
  216. package/docs/content/locales/zh-TW/cloneable-saas.md +32 -32
  217. package/docs/content/locales/zh-TW/code-agents-ui.md +91 -91
  218. package/docs/content/locales/zh-TW/components.md +51 -51
  219. package/docs/content/locales/zh-TW/context-awareness.md +66 -66
  220. package/docs/content/locales/zh-TW/creating-templates.md +39 -39
  221. package/docs/content/locales/zh-TW/cross-app-sso.md +29 -29
  222. package/docs/content/locales/zh-TW/database.md +21 -21
  223. package/docs/content/locales/zh-TW/deployment.md +37 -37
  224. package/docs/content/locales/zh-TW/dispatch.md +43 -43
  225. package/docs/content/locales/zh-TW/drop-in-agent.md +34 -34
  226. package/docs/content/locales/zh-TW/durable-resume.md +18 -18
  227. package/docs/content/locales/zh-TW/embedding-sdk.md +73 -73
  228. package/docs/content/locales/zh-TW/evals.md +16 -16
  229. package/docs/content/locales/zh-TW/extensions.md +81 -81
  230. package/docs/content/locales/zh-TW/external-agents.md +146 -146
  231. package/docs/content/locales/zh-TW/faq.md +43 -43
  232. package/docs/content/locales/zh-TW/file-uploads.md +11 -11
  233. package/docs/content/locales/zh-TW/frames.md +33 -33
  234. package/docs/content/locales/zh-TW/getting-started.md +28 -28
  235. package/docs/content/locales/zh-TW/harness-agents.md +78 -78
  236. package/docs/content/locales/zh-TW/human-approval.md +27 -27
  237. package/docs/content/locales/zh-TW/internationalization.md +19 -19
  238. package/docs/content/locales/zh-TW/key-concepts.md +68 -68
  239. package/docs/content/locales/zh-TW/local-file-mode.md +50 -50
  240. package/docs/content/locales/zh-TW/mcp-apps.md +38 -38
  241. package/docs/content/locales/zh-TW/mcp-clients.md +67 -67
  242. package/docs/content/locales/zh-TW/mcp-protocol.md +50 -50
  243. package/docs/content/locales/zh-TW/messaging.md +99 -99
  244. package/docs/content/locales/zh-TW/migration-workbench.md +6 -6
  245. package/docs/content/locales/zh-TW/multi-app-workspace.md +39 -39
  246. package/docs/content/locales/zh-TW/multi-tenancy.md +7 -7
  247. package/docs/content/locales/zh-TW/native-chat-ui.md +38 -38
  248. package/docs/content/locales/zh-TW/notifications.md +23 -23
  249. package/docs/content/locales/zh-TW/observability.md +49 -49
  250. package/docs/content/locales/zh-TW/observational-memory.md +23 -23
  251. package/docs/content/locales/zh-TW/onboarding.md +40 -40
  252. package/docs/content/locales/zh-TW/plan-plugin.md +37 -37
  253. package/docs/content/locales/zh-TW/pr-visual-recap.md +72 -72
  254. package/docs/content/locales/zh-TW/processors.md +17 -17
  255. package/docs/content/locales/zh-TW/progress.md +15 -15
  256. package/docs/content/locales/zh-TW/pure-agent-apps.md +10 -10
  257. package/docs/content/locales/zh-TW/real-time-collaboration.md +103 -103
  258. package/docs/content/locales/zh-TW/recurring-jobs.md +19 -19
  259. package/docs/content/locales/zh-TW/routing.md +9 -9
  260. package/docs/content/locales/zh-TW/sandbox-adapters.md +48 -48
  261. package/docs/content/locales/zh-TW/security.md +49 -49
  262. package/docs/content/locales/zh-TW/server.md +47 -47
  263. package/docs/content/locales/zh-TW/sharing.md +22 -22
  264. package/docs/content/locales/zh-TW/skills-guide.md +46 -46
  265. package/docs/content/locales/zh-TW/template-analytics.md +40 -40
  266. package/docs/content/locales/zh-TW/template-assets.md +69 -69
  267. package/docs/content/locales/zh-TW/template-brain.md +81 -81
  268. package/docs/content/locales/zh-TW/template-calendar.md +40 -40
  269. package/docs/content/locales/zh-TW/template-chat.md +27 -27
  270. package/docs/content/locales/zh-TW/template-clips.md +85 -85
  271. package/docs/content/locales/zh-TW/template-content.md +65 -66
  272. package/docs/content/locales/zh-TW/template-design.md +29 -29
  273. package/docs/content/locales/zh-TW/template-dispatch.md +51 -51
  274. package/docs/content/locales/zh-TW/template-forms.md +25 -25
  275. package/docs/content/locales/zh-TW/template-mail.md +71 -71
  276. package/docs/content/locales/zh-TW/template-plan.md +92 -92
  277. package/docs/content/locales/zh-TW/template-slides.md +52 -52
  278. package/docs/content/locales/zh-TW/template-videos.md +30 -30
  279. package/docs/content/locales/zh-TW/tracking.md +29 -29
  280. package/docs/content/locales/zh-TW/using-your-agent.md +18 -18
  281. package/docs/content/locales/zh-TW/voice-input.md +19 -19
  282. package/docs/content/locales/zh-TW/what-is-agent-native.md +61 -61
  283. package/docs/content/locales/zh-TW/workspace-connections.md +41 -41
  284. package/docs/content/locales/zh-TW/workspace-management.md +27 -27
  285. package/docs/content/locales/zh-TW/workspace.md +58 -58
  286. package/docs/content/locales/zh-TW/writing-agent-instructions.md +41 -41
  287. package/docs/content/template-clips.md +48 -2
  288. package/package.json +2 -1
  289. package/src/templates/default/app/i18n/zh-TW.ts +44 -44
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: "Agent-Native 程式碼 UI"
3
- description: "使用共用的 UI 包、桌面主機橋和 CLI 執行存儲建置和自訂 Agent-Native 程式碼表面。"
3
+ description: "使用共用的 UI 包、桌面主機橋和 CLI 執行儲存建置和自訂 Agent-Native 程式碼表面。"
4
4
  ---
5
5
 
6
6
  # Agent-Native 程式碼 UI
@@ -10,29 +10,29 @@ description: "使用共用的 UI 包、桌面主機橋和 CLI 執行存儲建置
10
10
 
11
11
  ## 我需要哪個編碼檔案? {#which-doc}
12
12
 
13
- | 你想要…… | 使用 |
14
- | -------------------------------------------------------- | -------------------------------------- |
15
- | 渲染 Claude-Code/Codex-style **編碼工作區 UI** | **Agent-Native 程式碼 UI**(本頁面) |
16
- | 使用自己的循環+工具**作為代理**執行Claude程式碼/Codex/Pi | [Harness Agents](/docs/harness-agents) |
17
- | 交換執行代理 **`run-code` 工具**的後端 | [Adapters](/docs/sandbox-adapters) |
18
- | 封裝一個CLI工具(`gh`、`ffmpeg`)供代理調用 | [Adapters](/docs/sandbox-adapters) |
13
+ | 你想要…… | 使用 |
14
+ | ---------------------------------------------------------- | -------------------------------------- |
15
+ | 渲染 Claude-Code/Codex-style **編碼工作區 UI** | **Agent-Native 程式碼 UI**(本頁面) |
16
+ | 使用自己的迴圈+工具**作為代理**執行 Claude 程式碼/Codex/Pi | [Harness Agents](/docs/harness-agents) |
17
+ | 交換執行代理 **`run-code` 工具**的後端 | [Adapters](/docs/sandbox-adapters) |
18
+ | 封裝一個 CLI 工具(`gh`、`ffmpeg`)供代理呼叫 | [Adapters](/docs/sandbox-adapters) |
19
19
 
20
20
  Agent-Native Code 是 Agent-Native 編碼介面:本機 Claude Code/Codex 風格的工作區,用於編碼工作階段、斜線指令、遷移、審計、轉錄、執行控制和後續操作。一個簡單的 `npx @agent-native/core@latest` 指令可以開啟這個工作區; `npx @agent-native/core@latest code` 是相同體驗的顯式子指令。
21
21
 
22
22
  共有三層:
23
23
 
24
24
  - **CLI**:`npx @agent-native/core@latest` 和 `npx @agent-native/core@latest code` 啟動、恢復、檢查和停止執行。
25
- - **桌面**:左側邊欄“程式碼”分頁新增本機終端啟動、應用程式 Web 視圖和桌面深層連結,同時使用相同的執行模型。
25
+ - **桌面**:左側邊欄“程式碼”分頁新增本機終端啟動、應用程式 Web 檢視和桌面深層連結,同時使用相同的執行模型。
26
26
  - **共用 UI**:`@agent-native/code-agents-ui` 渲染可重用的 React 表面。
27
27
 
28
- ```an-diagram title="一間經營商店三層" summary="CLI、Desktop 和共用 UI 是同一檔案支持的執行存儲和執行器上的不同表面;主機通過 CodeAgentsHost 合約對其進行調整。"
28
+ ```an-diagram title="一間經營商店三層" summary="CLI、Desktop 和共用 UI 是同一檔案支援的執行儲存和執行器上的不同表面;主機透過 CodeAgentsHost 合約對其進行調整。"
29
29
  {
30
- "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">啟動 · 恢復 · 狀態 · 停止</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">原生終端 · webviews · 深連結</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">分享d UI</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</span><small class=\"diagram-muted\">host contract</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>檔案支持的執行存儲 + 執行器<br><small class=\"diagram-muted\">@agent-native/core/code-agents</small></div></div>",
30
+ "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">啟動 · 恢復 · 狀態 · 停止</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">原生終端 · webviews · 深連結</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">分享d UI</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</span><small class=\"diagram-muted\">host contract</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>檔案支援的執行儲存 + 執行器<br><small class=\"diagram-muted\">@agent-native/core/code-agents</small></div></div>",
31
31
  "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px;align-items:center}.diagram-layers .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-layers .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-layers .diagram-arrow{font-size:22px;line-height:1}.diagram-layers .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
32
32
  }
33
33
  ```
34
34
 
35
- 目前的拆分是有意融合的:標準代理側邊欄和代理團隊在核心 `run-manager` 生命週期上執行,而 Agent-Native Code 使用由基於檔案的程式碼執行存儲和共用後台執行控制器詞匯表支持的本機長時間執行工作階段。
35
+ 目前的拆分是有意融合的:標準代理側邊欄和代理團隊在核心 `run-manager` 生命週期上執行,而 Agent-Native Code 使用由基於檔案的程式碼執行儲存和共用背景執行控制器詞匯表支援的本機長時間執行工作階段。
36
36
 
37
37
  共用的 UI 是主機驅動的。它不知道自己是在 Electron、瀏覽器範本還是未來的託管 shell 中執行。主機提供 `CodeAgentsHost` 實現。
38
38
 
@@ -60,11 +60,11 @@ export function CodeSurface() {
60
60
  }
61
61
  ```
62
62
 
63
- 主機可以在同一列表中混合執行來源。本機 Agent-Native 程式碼工作階段
64
- 可以出現在代理團隊或其他後台執行的適配器旁邊,只要每個適配器的長度相同
63
+ 主機可以在同一清單中混合執行來源。本機 Agent-Native 程式碼工作階段
64
+ 可以出現在代理團隊或其他背景執行的轉接器旁邊,只要每個轉接器的長度相同
65
65
  條目標準化為`CodeAgentRun`。當主機提供`sourceLabel`時,
66
66
  `source`或`kind`,集線器呈現一個小的來源標籤,例如“本機程式碼”
67
- 或執行列表和選定工作階段標題中的“代理團隊”。省略這些欄位
67
+ 或執行清單和選定工作階段標題中的“代理團隊”。省略這些欄位
68
68
  對於單來源表面;空狀態和基本布局保持不變。
69
69
 
70
70
  ## 桌面主機
@@ -72,12 +72,12 @@ export function CodeSurface() {
72
72
  桌面使用共用的 UI 但保留 Electron 中的特權功能:
73
73
 
74
74
  - 開啟本機終端
75
- - 使用 `AppWebview` 渲染可選的應用程式支持的表面
75
+ - 使用 `AppWebview` 渲染可選的應用程式支援的表面
76
76
  - 處理 `agentnative://open?...` 連結
77
- - 跟蹤本機執行進程
77
+ - 跟蹤本機執行行程
78
78
  - 紀錄主動執行的轉向與排隊後續操作
79
79
  - 重試並重新執行本機程式碼工作階段,包括 `/migrate` 和 `/audit`
80
- - 停止它啟動的進程
80
+ - 停止它啟動的行程
81
81
 
82
82
  分離很重要。 UI 可以被範本重用,但本機流程控制應保留在 Desktop 或 CLI 中。
83
83
 
@@ -96,7 +96,7 @@ codex login status
96
96
  桌面和 CLI 讀取 `codex login status` 並執行 `codex exec`,因此它們
97
97
  重用您安裝的 Codex CLI 的任何 ChatGPT 訂閱或 API 金鑰驗證
98
98
  報告。這與使用的 `@ai-sdk/harness-codex` 包是分開的
99
- [Harness Agents](/docs/harness-agents);線束適配器可以複製本機
99
+ [Harness Agents](/docs/harness-agents);線束轉接器可以複製本機
100
100
  僅當 `codexCliAuth: true` 為時,Codex CLI 才授權進入可信沙箱
101
101
  顯式啟用。
102
102
 
@@ -112,22 +112,22 @@ pnpm install
112
112
  pnpm dev
113
113
  ```
114
114
 
115
- 您的主機可以通過正常的 actions 包裝本機執行存儲。這些是
115
+ 您的主機可以透過正常的 actions 包裝本機執行儲存。這些是
116
116
  主機擁有的 actions 您可以自己定義 - 它們不是附帶的框架
117
- actions — 將每個 `CodeAgentsHost` 方法對應到執行存儲,例如:
117
+ actions — 將每個 `CodeAgentsHost` 方法對應到執行儲存,例如:
118
118
 
119
- - 支持 `listRuns` 的“列表執行”操作
120
- - 支持 `listCodePacks` 的“列出程式碼包”操作
121
- - 支持 `createRun` 的“建立執行”操作
122
- - 支持 `readTranscript` 的“閱讀紀錄”操作
123
- - 支持 `appendFollowUp` 的“追加後續”操作
124
- - 支持 `updateRun` 的“更新執行”操作
125
- - 支持`controlRun`的“控制執行”動作
119
+ - 支援 `listRuns` 的“清單執行”操作
120
+ - 支援 `listCodePacks` 的“列出程式碼包”操作
121
+ - 支援 `createRun` 的“建立執行”操作
122
+ - 支援 `readTranscript` 的“閱讀紀錄”操作
123
+ - 支援 `appendFollowUp` 的“追加後續”操作
124
+ - 支援 `updateRun` 的“更新執行”操作
125
+ - 支援`controlRun`的“控制執行”動作
126
126
 
127
- 每個都調用 `@agent-native/core/code-agents`,它公開相同的內容
128
- CLI 使用的檔案支持的執行存儲和執行器。
127
+ 每個都呼叫 `@agent-native/core/code-agents`,它公開相同的內容
128
+ CLI 使用的檔案支援的執行儲存和執行器。
129
129
 
130
- ## CLI 執行控件
130
+ ## CLI 執行控制項
131
131
 
132
132
  頂級 CLI 的行為類似於 Claude 程式碼或 Codex:
133
133
 
@@ -137,7 +137,7 @@ npx @agent-native/core@latest "fix the failing auth tests"
137
137
  npx @agent-native/core@latest code
138
138
  ```
139
139
 
140
- 當您需要顯式命名空間時,請使用 `npx @agent-native/core@latest code`。內置斜線
140
+ 當您需要顯式命名空間時,請使用 `npx @agent-native/core@latest code`。內建斜線
141
141
  目標和專案指令可以在互動式工作區中執行或直接執行
142
142
  來自外殼:
143
143
 
@@ -147,12 +147,12 @@ npx @agent-native/core@latest code /audit --url https://example.com
147
147
  npx @agent-native/core@latest code /release-check
148
148
  ```
149
149
 
150
- 這裡`/migrate`和`/audit`是內置目標(內置目標是
150
+ 這裡`/migrate`和`/audit`是內建目標(內建目標是
151
151
  `task`、`migrate` 和 `audit`)。 `/release-check` 作為範例顯示
152
- 專案指令 - 在 `.agents/commands/` 中定義,不是內置目標。專案
152
+ 專案指令 - 在 `.agents/commands/` 中定義,不是內建目標。專案
153
153
  指令來自`.agents/commands/*.md`;專案skills來自
154
154
  `.agents/skills/*/SKILL.md`。控制指令在同一執行中執行
155
- 紀錄桌面程式碼分頁和共用UI顯示:
155
+ 紀錄桌面程式碼分頁和共用 UI 顯示:
156
156
 
157
157
  ```bash
158
158
  npx @agent-native/core@latest code list
@@ -164,15 +164,15 @@ npx @agent-native/core@latest code stop --last
164
164
  npx @agent-native/core@latest code ui
165
165
  ```
166
166
 
167
- `resume` 附加上下文並繼續執行,`status` 報告最新執行
167
+ `resume` 附加脈絡並繼續執行,`status` 報告最新執行
168
168
  狀態,`stop`要求主動控制器停止工作,`ui`開啟本機
169
169
  程式碼表面。這些是執行控制,而不是單獨的實施路徑。如果一個
170
- 高風險指令暫停等待批準,`approve --last` 執行該指令
170
+ 高風險指令暫停等待核准,`approve --last` 執行該指令
171
171
  指令,然後指示您返回以恢復工作階段。
172
172
 
173
173
  執行模式使每個工作階段的編輯策略變得明確:
174
174
 
175
- | 模式 | CLI 標志 | 行為 |
175
+ | 模式 | CLI 標誌 | 行為 |
176
176
  | ------------ | -------- | ------------------------------------------------------------------------- |
177
177
  | **計畫模式** | `--plan` | 檢查、計畫和解釋,無需編寫檔案或執行突變。 |
178
178
  | **自動模式** | `--auto` | 僅針對真正具有破壞性的檔案、git、發布或資料操作編輯檔案、執行檢查和暫停。 |
@@ -181,21 +181,21 @@ npx @agent-native/core@latest code ui
181
181
  評估、架構、審核或您之前需要提案的任何工作
182
182
  編輯。
183
183
 
184
- 對於跨表面列表、儀表板或監控窗格,首選共用
185
- 通過讀取程式碼從 `@agent-native/core/code-agents` 後台執行匯出
184
+ 對於跨表面清單、儀表板或監控窗格,首選共用
185
+ 透過讀取程式碼從 `@agent-native/core/code-agents` 背景執行匯出
186
186
  直接執行檔案。他們將本機程式碼工作階段標準化為相同的詞匯表
187
- 由託管後台工作使用:執行 ID、狀態、cwd、需求輸入,
188
- 需求批準、轉錄事件和工件根。
187
+ 由託管背景工作使用:執行 ID、狀態、cwd、需求輸入,
188
+ 需求核准、轉錄事件和工件根。
189
189
 
190
190
  託管代理團隊也會從瀏覽器的代理聊天路由中公開
191
- 需要程式碼中心兼容列表而不直接伺服器匯入的主機:
191
+ 需要程式碼中心相容清單而不直接伺服器匯入的主機:
192
192
  `GET /_agent-native/agent-chat/runs/list?goalId=agent-team` 返回
193
193
  `{ status: "ok", goalId, runs }`,其中每次執行都包含 `kind`,
194
- `source`、`sourceLabel`、`status`、`title`、時間戳和工作元資料。
194
+ `source`、`sourceLabel`、`status`、`title`、時間戳和工作中繼資料。
195
195
  `GET /_agent-native/agent-chat/runs/:id/background-events` 返回
196
- 為代理團隊執行共用後台轉錄事件。
196
+ 為代理團隊執行共用背景轉錄事件。
197
197
 
198
- 適配器支持的主機還可以附加來源元資料:
198
+ 轉接器支援的主機還可以附加來源中繼資料:
199
199
 
200
200
  ```ts
201
201
  {
@@ -213,13 +213,13 @@ npx @agent-native/core@latest code ui
213
213
 
214
214
  ## 執行商店
215
215
 
216
- 本機 Agent-Native 程式碼執行存儲在:
216
+ 本機 Agent-Native 程式碼執行儲存在:
217
217
 
218
218
  ```text
219
219
  ~/.agent-native/code-agents
220
220
  ```
221
221
 
222
- 設定 `AGENT_NATIVE_CODE_AGENTS_HOME` 以隔離範本或測試執行存儲。
222
+ 設定 `AGENT_NATIVE_CODE_AGENTS_HOME` 以隔離範本或測試執行儲存。
223
223
 
224
224
  ```bash
225
225
  AGENT_NATIVE_CODE_AGENTS_HOME=./data/code-agents pnpm dev
@@ -235,64 +235,64 @@ AGENT_NATIVE_CODE_AGENTS_HOME=./data/code-agents pnpm dev
235
235
  | `listCodePacks?()` | 列出`.agents/commands`和`.agents/skills` |
236
236
  | `createRun(request)` | 開始新的執行 |
237
237
  | `subscribeTranscript?(request, callback)` | 將紀錄更新推送到共用對話 |
238
- | `readTranscript(request)` | 輪詢紀錄事件作為兼容性回退 |
238
+ | `readTranscript(request)` | 輪詢紀錄事件作為相容性回退 |
239
239
  | `appendFollowUp(request)` | 新增後續工作,引導活動工作或排隊 |
240
- | `updateRun(request)` | 更新模式或執行元資料 |
240
+ | `updateRun(request)` | 更新模式或執行中繼資料 |
241
241
  | `retryRun?(request)` | 就地重試所選執行 |
242
242
  | `rerunRun?(request)` | 從先前的提示開始新的執行 |
243
- | `controlRun(goalId, runId, command, permissionMode?)` | 恢復、批準、刷新或停止 |
243
+ | `controlRun(goalId, runId, command, permissionMode?)` | 恢復、核准、重新整理或停止 |
244
244
  | `openTerminal?(request)` | 可選的本機終端掛鉤 |
245
245
 
246
246
  瀏覽器主機應該返回一個正常的 `openTerminal` 錯誤,而不是嘗試模擬本機終端啟動。
247
247
 
248
- ## 共用作曲家
248
+ ## 共用撰寫器
249
249
 
250
250
  Agent-Native 程式碼使用相同的 `AgentComposerFrame` + `PromptComposer` /
251
251
  從 `@agent-native/core/client/composer` 匯出的 `TiptapComposer` 堆堆疊作為
252
252
  框架代理側邊欄。不要分叉單獨的
253
- 文本區域、編碼工具選取器、上傳選取器、語音按鈕、模型選取器或 Enter-to-submit
253
+ 文字區、編碼工具選取器、上傳選取器、語音按鈕、模型選取器或 Enter-to-submit
254
254
  類似程式碼表面的實現。如果主機需要一個額外的控制,請傳遞
255
- 它通過共用的composer擴充功能點,所以側邊欄,程式碼UI,和
255
+ 它透過共用的composer擴充功能點,所以側邊欄,程式碼 UI,和
256
256
  大腦聊天保持相同的互動模型和視野。
257
257
 
258
- Brain 的 Ask 路線使用 `AgentChatSurface`,該路線已得到支持
258
+ Brain 的 Ask 路由使用 `AgentChatSurface`,該路由已得到支援
259
259
  標準側邊欄編輯器。程式碼直接使用`PromptComposer`,因為主機
260
- 擁有執行建立、成績單和後續交付。
260
+ 擁有執行建立、逐字稿和後續交付。
261
261
 
262
262
  ## 共用編碼工具
263
263
 
264
- 側邊欄開發代理和Agent-Native程式碼都使用相同的最小值
264
+ 側邊欄開發代理和 Agent-Native 程式碼都使用相同的最小值
265
265
  編碼工具設定檔案:`bash`、`read`、`edit` 和 `write`。預設為`bash`
266
- 用於列出/搜尋檔案、執行測試以及調用專案 CLIs; `read`
267
- 顯示行編號的檔案切片; `edit` 應用精確的文本替換;和
266
+ 用於列出/搜尋檔案、執行測試以及呼叫專案 CLIs; `read`
267
+ 顯示行編號的檔案切片; `edit` 應用精確的文字替換;和
268
268
  `write` 保留用於新檔案或有意完全重寫。舊別名
269
269
  例如`shell`、`read-file`、`write-file`、`list-files`和`search-files`
270
- 僅兼容,不屬於預設廣告表面的一部分。
270
+ 僅相容,不屬於預設廣告表面的一部分。
271
271
 
272
- 特定於程式碼的 UI 屬於作曲家週圍,而不是分叉的聊天欄位內。
272
+ 特定於程式碼的 UI 屬於撰寫器週圍,而不是分叉的聊天欄位內。
273
273
  共用程式碼 UI 可能會新增插槽:
274
274
 
275
- - 自動/計畫模式控件。
276
- - 選定的 cwd、專案選取器和執行元資料。
275
+ - 自動/計畫模式控制項。
276
+ - 選定的 cwd、專案選取器和執行中繼資料。
277
277
  - 僅限主機的功能,例如開啟終端。
278
278
 
279
279
  其他所有內容都保留在共用編輯器中:附件、引用、斜杠和
280
- 技能插入、貼上文本處理、語音听寫、草稿、鍵盤
280
+ 技能插入、貼上文字處理、語音聽寫、草稿、鍵盤
281
281
  快捷方式和提交語義。
282
282
 
283
283
  面向使用者的文字紀錄應保持工作階段式。程式碼主機標準化原始
284
284
  將轉錄/狀態/工具事件寫入共用對話渲染器:助手
285
- 文本合並為一圈,低信號生命週期噪音遠離主線
286
- 表面和工具活動呈現為帶有詳細資訊的緊湊內聯摘要
285
+ 文字合併為一圈,低信號生命週期噪音遠離主線
286
+ 表面和工具活動呈現為帶有詳細資訊的緊湊行內摘要
287
287
  需要時可用。
288
288
 
289
289
  ## 斜線指令
290
290
 
291
- Agent-Native 程式碼將遷移視為一種功能,而不是單獨的應用程式類別。 `/migrate` 可以是內置目標、專案指令或同一主機合約之上的自訂指令包。
291
+ Agent-Native 程式碼將遷移視為一種功能,而不是單獨的應用程式類別。 `/migrate` 可以是內建目標、專案指令或同一主機合約之上的自訂指令包。
292
292
 
293
- ### 使用`/migrate`遷移到Agent-Native {#migrate}
293
+ ### 使用`/migrate`遷移到 Agent-Native {#migrate}
294
294
 
295
- `/migrate` 是將現有應用程式、URL 或描述的產品行動到 Agent-Native 的內置目標。它是程式碼工作區中的一個斜線目標 - 不是一個單獨的腳手架範本,也不是一次性產品 - 因此它與其他所有程式碼工作階段共用相同的工作階段存儲、腳本、執行控件和桌面中心,並且您可以以相同的方式恢復、附加、檢查和停止它。
295
+ `/migrate` 是將現有應用程式、URL 或描述的產品行動到 Agent-Native 的內建目標。它是程式碼工作區中的一個斜線目標 - 不是一個單獨的腳手架範本,也不是一次性產品 - 因此它與其他所有程式碼工作階段共用相同的工作階段儲存、指令碼、執行控制項和桌面中心,並且您可以以相同的方式恢復、附加、檢查和停止它。
296
296
 
297
297
  ```bash
298
298
  npx @agent-native/core@latest code /migrate ./my-next-app --out ../migrated-app
@@ -301,7 +301,7 @@ npx @agent-native/core@latest code /migrate --describe "A Rails admin app with r
301
301
  npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app # shortcut into the same goal
302
302
  ```
303
303
 
304
- 本機來源路徑是唯讀的;生成的輸出必須位於來源樹之外。使用 `--emit <dir>` 編寫便攜式遷移檔案(`AGENTS.md`、`MIGRATION_PLAYBOOK.md`、評估和 `ir.json` 庫存(如果可用))並將其交給另一個編碼代理,而不是開啟內部執行表面。 `/migrate` 重用框架的正常憑證系統 - 沒有特定於遷移的金鑰存儲。 `@agent-native/migrate` 包公開了一個用於自訂工作流程的可重用引擎(`createMigrationRun`、`discoverMigration`、`planMigration`、來源/目標適配器)。
304
+ 本機來源路徑是唯讀的;產生的輸出必須位於來源樹之外。使用 `--emit <dir>` 編寫便攜式遷移檔案(`AGENTS.md`、`MIGRATION_PLAYBOOK.md`、評估和 `ir.json` 庫存(如果可用))並將其交給另一個編碼代理,而不是開啟內部執行表面。 `/migrate` 重用框架的正常憑證系統 - 沒有特定於遷移的金鑰儲存。 `@agent-native/migrate` 包公開了一個用於自訂工作流程的可重用引擎(`createMigrationRun`、`discoverMigration`、`planMigration`、來源/目標轉接器)。
305
305
 
306
306
  特定於專案的指令位於:
307
307
 
@@ -317,40 +317,40 @@ npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app # sh
317
317
  .agents/skills/*/SKILL.md
318
318
  ```
319
319
 
320
- 當主機實現`listCodePacks`時,共用的UI在導軌中顯示專案指令和skills。指令行插入 `/<command>`,技能行插入重點“使用 <skill> 技能...”提示,以便導軌保持可操作性。內置斜線目標 `/migrate` 和 `/audit` 保留為全域 Agent-Native 程式碼控件保留,執行控制名稱(例如 `status` 和 `resume`)也是如此 — 這些是不帶斜線調用的子指令(`npx @agent-native/core@latest code status`、`npx @agent-native/core@latest code resume`),而不是斜線目標。
320
+ 當主機實現`listCodePacks`時,共用的 UI 在導軌中顯示專案指令和skills。指令行插入 `/<command>`,技能行插入重點“使用 <skill> 技能...”提示,以便導軌保持可操作性。內建斜線目標 `/migrate` 和 `/audit` 保留為全域 Agent-Native 程式碼控制項保留,執行控制名稱(例如 `status` 和 `resume`)也是如此 — 這些是不帶斜線呼叫的子指令(`npx @agent-native/core@latest code status`、`npx @agent-native/core@latest code resume`),而不是斜線目標。
321
321
 
322
322
  不要為新的程式碼主機建立單獨的斜杠指令註冊表。專案
323
323
  指令和skills是從`.agents/commands/*.md`發現的
324
324
  `.agents/skills/*/SKILL.md`; UI 應該渲染這些包並插入提示
325
- 通過共用作曲家。
325
+ 透過共用撰寫器。
326
326
 
327
- ## 後台代理執行管理器
327
+ ## 背景代理執行管理器
328
328
 
329
- 後台編碼代理工作應重用與執行管理器相同的基礎
329
+ 背景編碼代理工作應重用與執行管理器相同的基礎
330
330
  Agent-Native 的其餘部分:
331
331
 
332
- - 使用程式碼執行存儲/執行器進行本機程式碼工作階段。
333
- - 當表面需要列出時,使用共用後台執行適配器/基礎,
334
- 檢查或橋接本機程式碼工作階段以及其他後台工作。
332
+ - 使用程式碼執行儲存/執行器進行本機程式碼工作階段。
333
+ - 當表面需要列出時,使用共用背景執行轉接器/基礎,
334
+ 檢查或橋接本機程式碼工作階段以及其他背景工作。
335
335
  - 使用核心 `run-manager` 進行託管代理執行,以便進行流式傳輸、中止、心跳,
336
336
  可恢復性、軟超時和卡住執行清理的行為一致。
337
337
  - 當 UI 將工作委派給 a 時使用 `agent-teams` / `spawnTask()`
338
- 來自普通應用聊天的後台子代理。
338
+ 來自普通應用聊天的背景子代理。
339
339
 
340
- 不要僅僅因為新表面需要一個並行的後台代理執行程序
341
- 不同的布局。在共用頂部建置主機適配器或 UI 插槽
340
+ 不要僅僅因為新表面需要一個並行的背景代理執行程式
341
+ 不同的布局。在共用頂部建置主機轉接器或 UI 插槽
342
342
  改為執行管理器基礎。
343
343
 
344
344
  ## 後續行動
345
345
 
346
- 主動執行的後續支持兩種交付模式:
346
+ 主動執行的後續支援兩種交付模式:
347
347
 
348
- - 按 Enter 或點選發送會紀錄立即轉向提示
348
+ - 按 Enter 或點選傳送會紀錄立即轉向提示
349
349
  活躍跑步者在下一個安全繼續點申請。
350
350
  - 在 macOS 上按 Cmd+Enter 或在其他地方按 Ctrl+Enter 會將提示排隊執行
351
351
  目前回合結束後。
352
352
 
353
- 非活動執行保持兼容行為:追加後續操作並立即恢復執行。
353
+ 非活動執行保持相容行為:追加後續操作並立即恢復執行。
354
354
 
355
355
  這為程式碼提供了與代理團隊相同的面向使用者的雙向訊息傳遞形式:
356
356
  使用者可以繼續與活動工作對話,但執行僅消耗該內容
@@ -359,23 +359,23 @@ Agent-Native 的其餘部分:
359
359
 
360
360
  ## 遠端調度
361
361
 
362
- 桌面可以將本機程式碼代理執行程序公開給已部署的調度中繼,因此
362
+ 桌面可以將本機程式碼代理執行程式公開給已部署的調度中繼,因此
363
363
  電話或 Telegram 聊天可以啟動、監控和繼續工作階段,而
364
- 計算機已喚醒。
364
+ 電腦已喚醒。
365
365
 
366
366
  連線僅從桌面出站:
367
367
 
368
- 1. 桌面與 Dispatch 配對並在本機存儲設備權杖。
368
+ 1. 桌面與 Dispatch 配對並在本機儲存設備權杖。
369
369
  2. 桌面長輪詢 `/_agent-native/integrations/remote/poll`。
370
370
  3. 行動工作階段和 Telegram `/code` 在中繼資料庫中排隊指令。
371
- 4. 桌面聲明指令、驅動本機執行存儲並發布結果
371
+ 4. 桌面聲明指令、驅動本機執行儲存並發布結果
372
372
  將事件紀錄回 Dispatch。
373
373
  5. 行動設備從 Dispatch 讀取 `hosts`、`runs` 和 `transcript`;它從不說話
374
374
  直接到桌面。
375
375
 
376
- ```an-diagram title="遠端 Dispatch 僅限出站" summary="行動設備從不直接與桌面對話。 Desktop 長輪詢 Dispatch,聲明指令,驅動本機執行存儲,並將結果鏡像回來。"
376
+ ```an-diagram title="遠端 Dispatch 僅限出站" summary="行動設備從不直接與桌面對話。 Desktop 長輪詢 Dispatch,聲明指令,驅動本機執行儲存,並將結果鏡像回來。"
377
377
  {
378
- "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>行動端 / Telegram<br><small class=\"diagram-muted\">/code · 工作階段</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Dispatch 中繼<br><small class=\"diagram-muted\">主機 · 執行 · 轉錄</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">長輪詢 · 領取 · 驅動執行存儲</small></div></div>",
378
+ "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>行動端 / Telegram<br><small class=\"diagram-muted\">/code · 工作階段</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Dispatch 中繼<br><small class=\"diagram-muted\">主機 · 執行 · 轉錄</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">長輪詢 · 領取 · 驅動執行儲存</small></div></div>",
379
379
  "css": ".diagram-remote{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-remote .diagram-arrow{font-size:22px;line-height:1}"
380
380
  }
381
381
  ```
@@ -395,7 +395,7 @@ Agent-Native 的其餘部分:
395
395
  }
396
396
  ```
397
397
 
398
- | 方法 | 路線 | 呼叫者 | 目的 |
398
+ | 方法 | 路由 | 呼叫者 | 目的 |
399
399
  | ---------- | -------------------------------------------------------- | ----------------- | -------------------------- |
400
400
  | `POST` | `/_agent-native/integrations/remote/register` | 桌面工作階段 | 配對桌面主機並返回權杖一次 |
401
401
  | `GET` | `/_agent-native/integrations/remote/hosts` | 行動/工作階段 | 列出配對的主機 |
@@ -409,7 +409,7 @@ Agent-Native 的其餘部分:
409
409
  | `GET` | `/_agent-native/integrations/remote/runs/:id/transcript` | 行動設備/工作階段 | 讀取鏡像轉錄本 |
410
410
  | `POST` | `/_agent-native/integrations/remote/push/register` | 行動設備/工作階段 | 註冊博覽會/行動推送權杖 |
411
411
 
412
- Telegram 通過 Dispatch 使用相同的中繼。支持的指令有:
412
+ Telegram 透過 Dispatch 使用相同的中繼。支援的指令有:
413
413
 
414
414
  ```text
415
415
  /code <prompt>
@@ -433,4 +433,4 @@ import "@agent-native/code-agents-ui/styles.css";
433
433
 
434
434
  ## 限制
435
435
 
436
- 瀏覽器範本是本機優先的。當其本機節點伺服器處於活動狀態時,它可以啟動和恢復執行。對於本機進程生命週期、終端啟動和應用程式 Web 視圖,請使用桌面。
436
+ 瀏覽器範本是本機優先的。當其本機節點伺服器處於活動狀態時,它可以啟動和恢復執行。對於本機行程生命週期、終端啟動和應用程式 Web 檢視,請使用桌面。