@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,43 +1,43 @@
1
1
  ---
2
2
  title: "FAQ"
3
- description: "有關原生代理的常見問題 - 它是什么、它的用途、您可以建置什么以及它如何工作。"
3
+ description: "有關原生代理的常見問題 - 它是什麼、它的用途、您可以建置什麼以及它如何工作。"
4
4
  ---
5
5
 
6
6
  # FAQ
7
7
 
8
- 有關代理原生的常見問題,從“我只是在尋找”到“我現在正在連線驗證”。
8
+ 有關 Agent-Native 的常見問題,從“我只是在尋找”到“我現在正在連線驗證”。
9
9
 
10
10
  ## 基礎知識 {#general}
11
11
 
12
- ### 什么是代理原生? {#what-is-agent-native}
12
+ ### 什麼是 Agent-Native? {#what-is-agent-native}
13
13
 
14
- Agent-native 是一個用於建置應用程式的框架,其中 AI 代理及其週圍的產品表面是平等的合作伙伴。該介面可以從一個無頭代理開始,通過一個自訂操作,發展成為丰富的聊天,或者成為一個完整的 UI。不變的是智能體和人類共用相同的 actions、資料庫和狀態。完整解釋請參見 [What Is Agent-Native?](/docs/what-is-agent-native)。
14
+ Agent-Native 是一個用於建置應用程式的框架,其中 AI 代理及其週圍的產品表面是平等的合作伙伴。該介面可以從一個無頭代理開始,透過一個自訂操作,發展成為豐富的聊天,或者成為一個完整的 UI。不變的是智慧體和人類共用相同的 actions、資料庫和狀態。完整解釋請參見 [What Is Agent-Native?](/docs/what-is-agent-native)。
15
15
 
16
16
  ### 這是給誰的? {#who-is-this-for}
17
17
 
18
- Agent-native 適合那些想要真正的應用程式和 AI 代理使用相同資料和 actions 工作的人。常見的路徑是:
18
+ Agent-Native 適合那些想要真正的應用程式和 AI 代理使用相同資料和 actions 工作的人。常見的路徑是:
19
19
 
20
20
  - **如果您需要郵件、行事曆、表單、計畫或其他無需設定的成品範本,請使用託管應用程式** - 從 [template gallery](/templates) 開始。
21
21
  - **從聊天開始**如果您想要一個使用者可以立即交談的基本應用程式,然後使用 actions 和螢幕進行擴充功能 - 從 [Getting Started](/docs/getting-started) 或 [Chat](/docs/template-chat) 開始。
22
- - **如果您想要在提交到 UI 之前執行一個操作和一個無頭應用程式代理循環,請先啟動原語優先** — 從 [Getting Started](/docs/getting-started) 開始。
22
+ - **如果您想要在提交到 UI 之前執行一個操作和一個無頭應用程式代理迴圈,請先啟動原語優先** — 從 [Getting Started](/docs/getting-started) 開始。
23
23
  - **分叉並自訂範本**如果您想要自己的 SaaS 產品,並且已連線驗證、資料庫、UI 和代理 actions — 請參閱 [Templates](/docs/cloneable-saas)。
24
24
  - **從頭開始建置**如果您想要新的代理驅動產品的框架原語 - 從 [Getting Started](/docs/getting-started) 開始。
25
- - **如果您希望 Claude、ChatGPT、Codex、Cursor 或 GitHub Copilot / VS Code 使用代理本機應用程式,請連線另一個代理或程式碼工具** - 請參閱 [External Agents](/docs/external-agents) 和 [Skills Guide](/docs/skills-guide)。
25
+ - **如果您希望 Claude、ChatGPT、Codex、Cursor 或 GitHub Copilot / VS Code 使用 Agent-Native 應用程式,請連線另一個代理或程式碼工具** - 請參閱 [External Agents](/docs/external-agents) 和 [Skills Guide](/docs/skills-guide)。
26
26
 
27
27
  ### 這與向現有應用新增 AI 有何不同? {#how-is-this-different}
28
28
 
29
- 大多數應用程式將人工智能作為事後的想法,實際上無法在應用程式中*做*事情。在代理原生應用程式中,代理是一等公民,與 UI 共用相同的 actions、資料庫和狀態,因此它可以執行按鈕可以執行的任何操作 - 並修改應用程式自己的程式碼。參見[What Is Agent-Native?](/docs/what-is-agent-native#the-ladder)。
29
+ 大多數應用程式將人工智慧作為事後的想法,實際上無法在應用程式中*做*事情。在 Agent-Native 應用程式中,代理是一等公民,與 UI 共用相同的 actions、資料庫和狀態,因此它可以執行按鈕可以執行的任何操作 - 並修改應用程式自己的程式碼。參見[What Is Agent-Native?](/docs/what-is-agent-native#the-ladder)。
30
30
 
31
- ```an-diagram title="附加人工智能與 agent-native" summary="螺栓固定的聊天側邊欄有自己的世界。 agent-native 代理與 UI 共用相同的操作、資料庫和狀態。"
31
+ ```an-diagram title="附加人工智慧與 agent-native" summary="螺栓固定的聊天側邊欄有自己的世界。 agent-native 代理與 UI 共用相同的操作、資料庫和狀態。"
32
32
  {
33
- "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">外掛式 AI</span><div class=\"diagram-node\">聊天側邊欄</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>獨立的 AI 世界<br><small class=\"diagram-muted\">無法操作應用</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
33
+ "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">外掛式 AI</span><div class=\"diagram-node\">聊天側邊欄</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>獨立的 AI 世界<br><small class=\"diagram-muted\">無法操作應用</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-Native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
34
34
  "css": ".diagram-vs{display:flex;align-items:stretch;gap:18px;flex-wrap:wrap}.diagram-vs .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:center;flex:1;min-width:200px}.diagram-vs .diagram-row2{display:flex;gap:8px}.diagram-vs .diagram-arrow{font-size:20px;line-height:1}.diagram-vs .diagram-divider{width:1px;align-self:stretch;background:currentColor;opacity:.15}"
35
35
  }
36
36
  ```
37
37
 
38
- ### 它是開來源的嗎? {#is-this-open-source}
38
+ ### 它是開放原始碼的嗎? {#is-this-open-source}
39
39
 
40
- 是的。該框架和所有範本都是開來源的。您可以在本機執行所有內容、自行託管或使用 Builder.io 的雲端來實現託管、協作和團隊功能。
40
+ 是的。此框架和所有範本都是開放原始碼的。您可以在本機執行所有內容、自行託管或使用 Builder.io 的雲端來實現託管、協作和團隊功能。
41
41
 
42
42
  ### 需要多少錢? {#how-much}
43
43
 
@@ -50,17 +50,17 @@ Agent-native 適合那些想要真正的應用程式和 AI 代理使用相同資
50
50
 
51
51
  ### 我可以自己主持嗎? {#can-i-self-host}
52
52
 
53
- 是的。選取執行 Node 的任何主機 — Netlify、Vercel、Cloudflare、AWS、Deno Deploy、您自己的伺服器 — 以及任何 SQL 資料庫(Postgres、SQLite、Turso、D1)。該框架是為了可移植而建置的。參見[Deployment](/docs/deployment)。
53
+ 是的。選取執行 Node 的任何主機 — Netlify、Vercel、Cloudflare、AWS、Deno Deploy、您自己的伺服器 — 以及任何 SQL 資料庫(Postgres、SQLite、Turso、D1)。此框架是為了可移植而建置的。參見[Deployment](/docs/deployment)。
54
54
 
55
- ### 支持哪些AI模型? {#what-models}
55
+ ### 支援哪些 AI 模型? {#what-models}
56
56
 
57
- Anthropic Claude、OpenAI(GPT-5 系列)、Google Gemini 以及使用 OpenAI API 形狀的任何提供者(包括通過 Ollama 的本機模型)。您可以在設定中設定模型;切換是設定更改,而不是程式碼重寫。該框架最重的測試路徑是 Claude,因此這是預設推薦。
57
+ Anthropic Claude、OpenAI(GPT-5 系列)、Google Gemini 以及使用 OpenAI API 形狀的任何提供者(包括透過 Ollama 的本機模型)。您可以在設定中設定模型;切換是設定更改,而不是程式碼重寫。此框架最重的測試路徑是 Claude,因此這是預設推薦。
58
58
 
59
- ### 我需要了解人工智能/機器學習嗎? {#do-i-need-to-know-ai}
59
+ ### 我需要了解人工智慧/機器學習嗎? {#do-i-need-to-know-ai}
60
60
 
61
- 沒有。您不需要訓練模型、微調或處理嵌入。您建置了一個常規的 Web 應用程式 - 在託管版本上,您幾乎不需要建置任何東西。該框架處理代理整合:路由訊息、執行 actions、同步狀態。
61
+ 沒有。您不需要訓練模型、微調或處理嵌入。您建置了一個一般的 Web 應用程式 - 在託管版本上,您幾乎不需要建置任何東西。此框架處理代理整合:路由訊息、執行 actions、同步狀態。
62
62
 
63
- ### 我可以將現有應用遷移到代理原生嗎? {#can-i-use-existing-code}
63
+ ### 我可以將現有應用遷移到 Agent-Native 嗎? {#can-i-use-existing-code}
64
64
 
65
65
  可以,但是從頭開始建置原生代理效果最好。架構——共用資料庫、輪詢同步、actions、應用程式狀態——需要始終整合。從範本開始並自訂它是推薦的路徑。可以把它想象成從桌面優先到行動優先的轉變:你*可以*改造,但建置原生更好。
66
66
 
@@ -68,53 +68,53 @@ Anthropic Claude、OpenAI(GPT-5 系列)、Google Gemini 以及使用 OpenAI
68
68
 
69
69
  ### 有哪些範本可用? {#what-templates-are-available}
70
70
 
71
- 該框架附帶了可用於正式環境的範本,包括 [Chat](/docs/template-chat)、[Mail](/docs/template-mail)、[Calendar](/docs/template-calendar)、[Forms](/docs/template-forms)、[Plan](/docs/template-plan)(視覺計畫和 PR 回顧)、[Analytics](/docs/template-analytics)、[Dispatch](/docs/template-dispatch) 等。每個都是一個完整的應用程式,包含 UI、代理 actions、資料庫架構和 AI 指令。完整目錄請參見 [Templates](/docs/cloneable-saas)。
71
+ 此框架附帶了可用於正式環境的範本,包括 [Chat](/docs/template-chat)、[Mail](/docs/template-mail)、[Calendar](/docs/template-calendar)、[Forms](/docs/template-forms)、[Plan](/docs/template-plan)(視覺計畫和 PR 回顧)、[Analytics](/docs/template-analytics)、[Dispatch](/docs/template-dispatch) 等。每個都是一個完整的應用程式,包含 UI、代理 actions、資料庫架構和 AI 指令。完整目錄請參見 [Templates](/docs/cloneable-saas)。
72
72
 
73
73
  ### 我可以自訂範本嗎? {#can-i-customize-templates}
74
74
 
75
- 這就是重點。分叉一個範本並通過詢問代理來自訂它。 “向表單新增優先級欄位。” “連線到我們的 Salesforce 執行個體。” “更改配色方案以匹配我們的品牌。”代理修改程式碼,您的應用程式會隨著時間的推移而發展。
75
+ 這就是重點。分叉一個範本並透過詢問代理來自訂它。 “向表單新增優先級欄位。” “連線到我們的 Salesforce 執行個體。” “更改配色方案以匹配我們的品牌。”代理修改程式碼,您的應用程式會隨著時間的推移而發展。
76
76
 
77
77
  ### 我可以建置範本未涵蓋的內容嗎? {#build-from-scratch}
78
78
 
79
- 是的。如果你想要一個基本的聊天應用程式,請執行`npx @agent-native/core@latest create my-chat-app --template chat`;您可以獲得持久的聊天線程、actions、驗證、SQL 支持的執行時狀態以及新增您自己的螢幕的空間。如果您想要沒有 UI 的最小操作優先應用程式,請執行 `npx @agent-native/core@latest create my-agent --headless`。請參閱 [Getting Started](/docs/getting-started)、[Pure-Agent Apps](/docs/pure-agent-apps) 和 [Chat](/docs/template-chat)。
79
+ 是的。如果你想要一個基本的聊天應用程式,請執行`npx @agent-native/core@latest create my-chat-app --template chat`;您可以獲得持久的聊天對話串、actions、驗證、SQL 支援的執行時狀態以及新增您自己的螢幕的空間。如果您想要沒有 UI 的最小操作優先應用程式,請執行 `npx @agent-native/core@latest create my-agent --headless`。請參閱 [Getting Started](/docs/getting-started)、[Pure-Agent Apps](/docs/pure-agent-apps) 和 [Chat](/docs/template-chat)。
80
80
 
81
81
  ### 我可以在不分叉範本的情況下嘗試它嗎? {#try-with-a-skill}
82
82
 
83
- 是的——通過一個指令將一項技能安裝到您已經使用的編碼代理中,不需要腳手架。請參閱 [Skills Guide](/docs/skills-guide#app-backed-skills) 了解演練。
83
+ 是的——透過一個指令將一項技能安裝到您已經使用的編碼代理中,不需要腳手架。請參閱 [Skills Guide](/docs/skills-guide#app-backed-skills) 了解演練。
84
84
 
85
85
  ## 代理能力 {#agent-capabilities}
86
86
 
87
87
  ### 代理真的可以修改應用程式自己的程式碼嗎? {#can-the-agent-modify-code}
88
88
 
89
- 是的,這是一個功能。代理可以安全地編輯元件、路線、樣式和 actions。您要求“新增群組分析圖表”,代理就會建置它。您詢問“連線到我們的 Stripe 帳戶”,然後代理會編寫整合。一切都是正常的 Git 跟蹤程式碼,因此不良更改很容易恢復。
89
+ 是的,這是一個功能。代理可以安全地編輯元件、路由、樣式和 actions。您要求“新增群組分析圖表”,代理就會建置它。您詢問“連線到我們的 Stripe 帳戶”,然後代理會編寫整合。一切都是正常的 Git 跟蹤程式碼,因此不良更改很容易恢復。
90
90
 
91
91
  ### 使用者可以從應用程式外部與代理交談嗎? {#external-channels}
92
92
 
93
- 是的。相同的代理在您的網路 UI、Slack、Telegram、通過電子郵件以及其他代理(通過 [A2A](/docs/a2a-protocol))中執行。這是同一個特工,具有相同的內存和相同的 actions,只是通過不同的渠道到達。參見[Messaging the agent](/docs/messaging)。
93
+ 是的。相同的代理在您的網路 UI、Slack、Telegram、透過電子郵件以及其他代理(透過 [A2A](/docs/a2a-protocol))中執行。這是同一個代理,具有相同的記憶和相同的 actions,只是透過不同的管道到達。參見[Messaging the agent](/docs/messaging)。
94
94
 
95
95
  ### 代理可以互相交談嗎? {#can-agents-talk-to-each-other}
96
96
 
97
- 是的,通過 [A2A (Agent-to-Agent) protocol](/docs/a2a-protocol)。每個代理本機應用程式都會自動獲取 A2A 端點。從郵件應用程式中,您可以標記分析代理以查詢資料。代理發現其他可用代理,通過協議調用它們,並在 UI 中顯示結果。無需設定 - 代理卡是根據範本的 actions 自動生成的。
97
+ 是的,透過 [A2A (Agent-to-Agent) protocol](/docs/a2a-protocol)。每個 Agent-Native 應用程式都會自動取得 A2A 端點。從郵件應用程式中,您可以標記分析代理以查詢資料。代理發現其他可用代理,透過協議呼叫它們,並在 UI 中顯示結果。無需設定 - 代理卡是根據範本的 actions 自動產生的。
98
98
 
99
- ### 客服人員可以在應用程式中看到什么? {#what-can-the-agent-see}
99
+ ### 代理可以在應用程式中看到什麼? {#what-can-the-agent-see}
100
100
 
101
- 代理始終知道使用者目前正在檢視的內容。 UI 在每次路線更改時將導覽狀態寫入資料庫 - 開啟哪個視圖、選取哪個專案。代理在采取行動之前會閱讀此內容。如果電子郵件已開啟,代理就知道是哪封電子郵件。如果選取了一張幻燈片,代理就知道是哪張幻燈片。參見[Context Awareness](/docs/context-awareness)。
101
+ 代理始終知道使用者目前正在檢視的內容。 UI 在每次路由更改時將導覽狀態寫入資料庫 - 開啟哪個檢視、選取哪個專案。代理在採取行動之前會閱讀此內容。如果電子郵件已開啟,代理就知道是哪封電子郵件。如果選取了一張幻燈片,代理就知道是哪張幻燈片。參見[Context Awareness](/docs/context-awareness)。
102
102
 
103
103
  ## 開發問題 {#development}
104
104
 
105
- ### 哪些人工智能編碼工具可與代理原生配合使用? {#which-ai-tools-work}
105
+ ### 哪些人工智慧編碼工具可與 Agent-Native 配合使用? {#which-ai-tools-work}
106
106
 
107
- 任何讀取專案指令的人工智能編碼工具。該框架使用 AGENTS.md 作為通用標準,並自動為特定工具建立符號連結:
107
+ 任何讀取專案指令的人工智慧編碼工具。此框架使用 AGENTS.md 作為通用標準,並自動為特定工具建立符號連結:
108
108
 
109
- - **Claude 程式碼** — 讀取 CLAUDE.md(通過 CLI 設定從 AGENTS.md 進行符號連結)
110
- - **光標** - 直接讀取 AGENTS.md,或者如果專案中存在 `.cursorrules`(光標的舊位置)
111
- - **Windsurf** — 讀取 .windsurfrules(通過 CLI 設定從 AGENTS.md 進行符號連結)
112
- - **Codex、Gemini 等** — 通過嵌入式代理面板工作
113
- - **Builder.io** — 具有可視化編輯和協作功能的雲端託管代理
109
+ - **Claude 程式碼** — 讀取 CLAUDE.md(透過 CLI 設定從 AGENTS.md 進行符號連結)
110
+ - **游標** - 直接讀取 AGENTS.md,或者如果專案中存在 `.cursorrules`(游標的舊位置)
111
+ - **Windsurf** — 讀取 .windsurfrules(透過 CLI 設定從 AGENTS.md 進行符號連結)
112
+ - **Codex、Gemini 等** — 透過嵌入式代理面板工作
113
+ - **Builder.io** — 具有視覺化編輯和協作功能的雲端託管代理
114
114
 
115
115
  ### 我可以使用自己的資料庫嗎? {#can-i-use-my-own-database}
116
116
 
117
- 是的。設定 `DATABASE_URL` ,框架會自動檢測它。支持的資料庫包括 SQLite、Postgres(Neon、Supabase、plain)、Turso (libSQL) 和 Cloudflare D1。所有 SQL 通過 Drizzle ORM 都是與方言無關的 - 相同的程式碼在任何地方都可以工作。
117
+ 是的。設定 `DATABASE_URL` ,框架會自動偵測它。支援的資料庫包括 SQLite、Postgres(Neon、Supabase、plain)、Turso (libSQL) 和 Cloudflare D1。所有 SQL 透過 Drizzle ORM 都是與方言無關的 - 相同的程式碼在任何地方都可以工作。
118
118
 
119
119
  ### 我可以在哪裡部署? {#where-can-i-deploy}
120
120
 
@@ -122,21 +122,21 @@ Anthropic Claude、OpenAI(GPT-5 系列)、Google Gemini 以及使用 OpenAI
122
122
 
123
123
  ## 架構 {#architecture}
124
124
 
125
- ### 為什么是 SSE 加輪詢而不是 WebSocket? {#why-polling-not-websockets}
125
+ ### 為什麼是 SSE 加輪詢而不是 WebSocket? {#why-polling-not-websockets}
126
126
 
127
- SSE 為同進程寫入提供了到瀏覽器的直接路徑,而輕量級版本計數器輪詢仍然是後備方案,因為它適用於每個部署環境 - 包括無伺服器和邊缘,其中持久套接字可能不可用。參見[Key Concepts — 實時同步](/docs/key-concepts#polling-sync)。
127
+ SSE 為同行程寫入提供了到瀏覽器的直接路徑,而輕量級版本計數器輪詢仍然是後備方案,因為它適用於每個部署環境 - 包括無伺服器和邊緣,其中持久 socket 可能不可用。參見[Key Concepts — 即時同步](/docs/key-concepts#polling-sync)。
128
128
 
129
- ```an-diagram title="SSE 首先,輪詢後備" summary="同進程即時寫流;版本計數器輪詢使無伺服器、邊缘和跨進程寫入保持收斂。"
129
+ ```an-diagram title="SSE 首先,輪詢後備" summary="同行程即時寫流;版本計數器輪詢使無伺服器、邊緣和跨行程寫入保持收斂。"
130
130
  {
131
- "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>資料庫寫入</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">輪詢<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>瀏覽器重新獲取</div></div>",
131
+ "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>資料庫寫入</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">輪詢<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>瀏覽器重新取得</div></div>",
132
132
  "css": ".diagram-transport{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-transport .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-transport .diagram-arrow{font-size:22px;line-height:1}"
133
133
  }
134
134
  ```
135
135
 
136
- ### 為什么UI不能直接調用LLM? {#why-no-inline-llm-calls}
136
+ ### 為什麼 UI 不能直接呼叫 LLM? {#why-no-inline-llm-calls}
137
137
 
138
- 人工智能是非確定性的,因此您需要對話流來提供意見回饋和迭代 - 而不是一次性按鈕 - 並且代理已經擁有內聯調用所缺乏的程式碼庫、指令、skills 和歷史紀錄。通過代理路由所有內容還可以讓應用程式從 Slack、Telegram 或其他代理驅動。參見[Key Concepts — Agent chat bridge](/docs/key-concepts#agent-chat-bridge)。
138
+ 人工智慧是非確定性的,因此您需要對話流來提供意見回饋和迭代 - 而不是一次性按鈕 - 並且代理已經擁有行內呼叫所缺乏的程式碼庫、指令、skills 和歷史紀錄。透過代理路由所有內容還可以讓應用程式從 Slack、Telegram 或其他代理驅動。參見[Key Concepts — Agent chat bridge](/docs/key-concepts#agent-chat-bridge)。
139
139
 
140
- ### 為什么這是一個框架而不是一個庫? {#why-framework-not-library}
140
+ ### 為什麼這是一個框架而不是一個庫? {#why-framework-not-library}
141
141
 
142
- 共用資料庫、實時同步、actions 系統和應用程式狀態之所以有效,是因為它們從頭開始連線在一起 - UI 立即對代理更改做出反應,代理進行通信,並且代理了解使用者正在檢視的內容。圖書館為你提供作品;這是一個架構。參見[Key Concepts](/docs/key-concepts)。
142
+ 共用資料庫、即時同步、actions 系統和應用程式狀態之所以有效,是因為它們從頭開始連線在一起 - UI 立即對代理更改做出反應,代理進行通信,並且代理了解使用者正在檢視的內容。程式庫提供零件;這是一個架構。參見[Key Concepts](/docs/key-concepts)。
@@ -1,23 +1,23 @@
1
1
  ---
2
2
  title: "檔案上傳"
3
- description: "設定檔案上傳存儲 - 用於開發的 SQL 後備、Builder.io 或用於正式環境的自訂提供程序。"
3
+ description: "設定檔案上傳儲存 - 用於開發的 SQL 後備、Builder.io 或用於正式環境的自訂提供者。"
4
4
  ---
5
5
 
6
6
  # 檔案上傳
7
7
 
8
- 該框架提供了一個檔案上傳抽象,可通過可設定的提供程序路由上傳。範本調用 `uploadFile()` 並返回 URL — 存儲後端可交換,無需更改應用程式程式碼。
8
+ 此框架提供了一個檔案上傳抽象,可透過可設定的提供者路由上傳。範本呼叫 `uploadFile()` 並傳回 URL — 儲存後端可交換,無需更改應用程式的程式碼。
9
9
 
10
10
  ## 它是如何工作的 {#how-it-works}
11
11
 
12
- 上傳請求發送至 `POST /_agent-native/file-upload`,後者分派至活動提供者。您可以在`GET /_agent-native/file-upload/status`處檢視設定了哪個提供者。
12
+ 上傳請求傳送至 `POST /_agent-native/file-upload`,後者分派至活動提供者。您可以在`GET /_agent-native/file-upload/status`處檢視設定了哪個提供者。
13
13
 
14
14
  提供者解析順序是:
15
15
 
16
- 1. **使用者註冊的提供程序**通過 `registerFileUploadProvider()` 註冊的自訂提供程序
17
- 2. **Builder.io 提供程序**內置,連線 Builder.io 時自動激活
18
- 3. **SQL 後備** - 將檔案作為 base64 存儲在資料庫中(適合開發,不適用於正式環境)
16
+ 1. **使用者註冊的提供者**透過 `registerFileUploadProvider()` 註冊的自訂提供者
17
+ 2. **Builder.io 提供者**內建,連線 Builder.io 時自動啟用
18
+ 3. **SQL 後備** - 將檔案作為 base64 儲存在資料庫中(適合開發,不適用於正式環境)
19
19
 
20
- ```an-diagram title="提供者決議順序" summary="uploadFile() 按順序選取第一個設定的提供程序。 SQL 後備始終存在,因此上傳可以零設定進行。"
20
+ ```an-diagram title="提供者決議順序" summary="uploadFile() 按順序選取第一個設定的提供者。 SQL 後備始終存在,因此上傳可以零設定進行。"
21
21
  {
22
22
  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">使用者註冊<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">連線後自動啟用——由 CDN 提供</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL 兜底<br><small class=\"diagram-muted\">資料庫中的 base64——僅開發使用</small></div></div></div></div>",
23
23
  "css": ".diagram-upload{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-upload .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-upload .diagram-step{display:flex;align-items:center;gap:8px}.diagram-upload .diagram-arrow{font-size:22px;line-height:1}"
@@ -28,7 +28,7 @@ description: "設定檔案上傳存儲 - 用於開發的 SQL 後備、Builder.io
28
28
  {
29
29
  "method": "POST",
30
30
  "path": "/_agent-native/file-upload",
31
- "summary": "通過活動提供者上傳檔案並返回公開URL。",
31
+ "summary": "透過活動提供者上傳檔案並返回公開 URL。",
32
32
  "description": "Dispatches to the first configured provider in resolution order. Check the active provider at `GET /_agent-native/file-upload/status`.",
33
33
  "request": { "contentType": "multipart/form-data" },
34
34
  "responses": [
@@ -39,7 +39,7 @@ description: "設定檔案上傳存儲 - 用於開發的 SQL 後備、Builder.io
39
39
 
40
40
  ## 預設:SQL 後備 {#sql-fallback}
41
41
 
42
- 當沒有設定提供者時,檔案通過資源系統以base64資料存儲在SQL資料庫中。這對於本機開發來說是開箱即用的,但不建議用於正式環境——大檔案會使資料庫膨脹,而且沒有 CDN。
42
+ 當沒有設定提供者時,檔案透過資源系統以base64資料儲存在 SQL 資料庫中。這對於本機開發來說是開箱即用的,但不建議用於正式環境——大檔案會使資料庫膨脹,而且沒有 CDN。
43
43
 
44
44
  使用後備時會紀錄一次性警告。
45
45
 
@@ -49,7 +49,7 @@ description: "設定檔案上傳存儲 - 用於開發的 SQL 後備、Builder.io
49
49
 
50
50
  ## 自訂提供者 {#custom-providers}
51
51
 
52
- 在伺服器外掛中註冊自訂提供程序以使用任何存儲後端(S3、Cloudflare R2、GCS 等):
52
+ 在伺服器外掛中註冊自訂提供者以使用任何儲存後端(S3、Cloudflare R2、GCS 等):
53
53
 
54
54
  ```ts
55
55
  // server/plugins/file-upload.ts
@@ -77,7 +77,7 @@ export default defineNitroPlugin(() => {
77
77
  });
78
78
  ```
79
79
 
80
- ## 上傳API {#upload-api}
80
+ ## 上傳 API {#upload-api}
81
81
 
82
82
  `FileUploadProvider`介面:
83
83
 
@@ -5,20 +5,20 @@ description: "本機開發框架、嵌入式代理面板和雲端框架 - AI 代
5
5
 
6
6
  # 框架
7
7
 
8
- 每個代理本機應用程式都與應用程式 UI 旁邊的 AI 代理一起執行。 **框架**是
8
+ 每個 Agent-Native 應用程式都與應用程式 UI 旁邊的 AI 代理一起執行。 **框架**是
9
9
  承載兩者的包裝器:它顯示您的應用程式並為代理提供一個地方
10
10
  聊天、執行和(在開發中)編輯程式碼。一共有三個框架,共用一個執行時:
11
11
 
12
- - **嵌入式代理面板** - 內置於 `@agent-native/core` 的每個應用程式中。
12
+ - **嵌入式代理面板** - 內建於 `@agent-native/core` 的每個應用程式中。
13
13
  這是您的應用在開發和正式環境過程中自行呈現的側邊欄。
14
14
  - **本機開發框架** - 在 iframe 中載入正在執行的應用程式的薄包裝器
15
15
  並新增相同的代理面板以及旁邊的整合 CLI 終端。使用過
16
16
  用於此儲存庫中範本的本機開發。
17
17
  - **Builder.io 雲端框架** — 具有協作功能的託管託管框架,
18
- 可視化編輯,並行代理執行。
18
+ 視覺化編輯,並行代理執行。
19
19
 
20
20
  無論託管哪個框架,您的應用程式碼都是相同的。代理說話
21
- 在每種情況下都通過相同的 actions 和應用程式狀態連線到您的應用程式。
21
+ 在每種情況下都透過相同的 actions 和應用程式狀態連線到您的應用程式。
22
22
 
23
23
  ```an-diagram title="三幀,一個執行時間" summary="您的應用程式和代理面板在每一幀中都是相同的;只有它們週圍的包裝發生變化。"
24
24
  {
@@ -30,7 +30,7 @@ description: "本機開發框架、嵌入式代理面板和雲端框架 - AI 代
30
30
  ## 嵌入式代理面板 {#embedded-agent}
31
31
 
32
32
  嵌入式面板是您的應用程式呈現的代理側邊欄。它附帶
33
- `@agent-native/core` - 沒有單獨的軟件包需要安裝 - 並且是相同的
33
+ `@agent-native/core` - 沒有單獨的套件需要安裝 - 並且是相同的
34
34
  開發和正式環境中的元件。
35
35
 
36
36
  - 從 `@agent-native/core/client` 匯出為 `AgentPanel`,帶有
@@ -45,19 +45,19 @@ description: "本機開發框架、嵌入式代理面板和雲端框架 - AI 代
45
45
  面板以兩種工具模式之一執行:
46
46
 
47
47
  - **應用程式模式** - 代理只有您的應用程式自己的工具:您的 actions
48
- 使用 `defineAction` 定義,加上導覽和上下文。沒有檔案系統或
48
+ 使用 `defineAction` 定義,加上導覽和脈絡。沒有檔案系統或
49
49
  外殼存取。這就是最終使用者得到的。
50
50
  - **程式碼模式** — 新增共用編碼工具(`bash`、`read`、`edit`、`write`)
51
51
  以及應用程式工具之上的資料庫存取,因此代理可以更改應用程式的
52
52
  自己的來源。程式碼請求被門控:當訊息需要程式碼時
53
- (`type: "code"`)並且沒有連線支持程式碼的框架,面板顯示
53
+ (`type: "code"`)並且沒有連線支援程式碼的框架,面板顯示
54
54
  解釋程式碼更改需要 Agent Native Desktop 或 Builder 的對話框;
55
55
  當連線框架時,請求將路由到它和程式碼代理
56
56
  工作時指示燈顯示 (`useSendToAgentChat`)。對於規範
57
- 編碼工具列表和共用UI合約,參見
57
+ 編碼工具清單和共用 UI 合約,參見
58
58
  [Agent-Native Code UI](/docs/code-agents-ui).
59
59
 
60
- ```an-diagram title="程式碼請求門控" summary="程式碼型別訊息需要支持程式碼的幀。一旦連線,請求就會路由到那裡;如果沒有,面板會解釋程式碼更改需要 Desktop 或 Builder。"
60
+ ```an-diagram title="程式碼請求門控" summary="程式碼型別訊息需要支援程式碼的幀。一旦連線,請求就會路由到那裡;如果沒有,面板會解釋程式碼更改需要 Desktop 或 Builder。"
61
61
  {
62
62
  "html": "<div class=\"diagram-gate\"><div class=\"diagram-node\" data-rough>message<br><small class=\"diagram-muted\">type: \\\"code\\\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>code-capable frame connected?</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">yes &rarr; route to frame, show code-agent indicator</div><div class=\"diagram-pill warn\">no &rarr; dialog: needs Desktop or Builder</div></div></div>",
63
63
  "css": ".diagram-gate{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-gate .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-gate .diagram-arrow{font-size:22px;line-height:1}.diagram-gate .center{text-align:center}"
@@ -66,44 +66,44 @@ description: "本機開發框架、嵌入式代理面板和雲端框架 - AI 代
66
66
 
67
67
  “程式碼模式”是代理功能切換 - 與環境開發模式不同
68
68
  (`NODE_ENV` / Vite)。用戶端鉤子是`useCodeMode()`。 (參見
69
- [Compatibility notes](#compatibility) 用於向後兼容別名。)
69
+ [Compatibility notes](#compatibility) 用於向後相容別名。)
70
70
 
71
71
  在本機開發框架中,設定齒輪在這些模式之間切換。切換
72
72
  關閉程式碼模式隱藏框架自己的側邊欄並顯示應用程式的應用內代理
73
73
  側邊欄位於 iframe 內,因此您可以準確預覽最終使用者所看到的內容。
74
74
 
75
- ## 整合終端和CLI切換 {#cli-terminal}
75
+ ## 整合終端和 CLI 切換 {#cli-terminal}
76
76
 
77
77
  正在開發中,面板包括一個嵌入式終端(`AgentTerminal`,也
78
- 來自 `@agent-native/core/client`),由 PTY 伺服器支持。你可以執行一個真正的
78
+ 來自 `@agent-native/core/client`),由 PTY 伺服器支援。你可以執行一個真正的
79
79
  在應用程式旁邊編碼 CLI 並在它們之間切換;終端重新啟動
80
80
  與選定的 CLI。
81
81
 
82
- 支持的 CLI 來自核心 CLI 註冊表
82
+ 支援的 CLI 來自核心 CLI 註冊表
83
83
  (`packages/core/src/terminal/cli-registry.ts`)。僅允許這些指令
84
84
  生成 - PTY 伺服器根據註冊表驗證請求的指令
85
- 允許列表以防止注入:
85
+ 允許清單以防止注入:
86
86
 
87
- | CLI | 指令 | 安裝包 |
88
- | ------------ | ---------- | --------------------------- |
89
- | Claude程式碼 | `claude` | `@anthropic-ai/claude-code` |
90
- | Builder.io | `builder` | (內置) |
91
- | Codex | `codex` | `@openai/codex` |
92
- | 雙子座CLI | `gemini` | `@google/gemini-cli` |
93
- | 開放程式碼 | `opencode` | `opencode-ai` |
87
+ | CLI | 指令 | 安裝包 |
88
+ | ------------- | ---------- | --------------------------- |
89
+ | Claude 程式碼 | `claude` | `@anthropic-ai/claude-code` |
90
+ | Builder.io | `builder` | (內建) |
91
+ | Codex | `codex` | `@openai/codex` |
92
+ | 雙子座 CLI | `gemini` | `@google/gemini-cli` |
93
+ | 開放程式碼 | `opencode` | `opencode-ai` |
94
94
 
95
95
  如果在 `PATH` 上找不到所選的 CLI,終端將回退到執行它
96
- 通過 `npx --yes <install-package>@latest`(存在安裝包的地方)。
96
+ 透過 `npx --yes <install-package>@latest`(存在安裝包的地方)。
97
97
  預設指令是`claude`。隨時從代理面板設定切換 CLI
98
98
  時間。
99
99
 
100
- ## Builder.io雲端框 {#cloud-frame}
100
+ ## Builder.io 雲端框 {#cloud-frame}
101
101
 
102
102
  [Builder.io](https://www.builder.io) 提供託管框架
103
103
  相同的應用程式和相同的代理面板,在雲端端:
104
104
 
105
- - 實時協作 - 多個使用者可以同時觀看和互動。
106
- - 可視化編輯、角色和權限。
105
+ - 即時協作 - 多個使用者可以同時觀看和互動。
106
+ - 視覺化編輯、角色和權限。
107
107
  - 並行代理執行以加快迭代速度。
108
108
  - 適合團隊使用,每個人共用一個託管環境。
109
109
 
@@ -116,17 +116,17 @@ description: "本機開發框架、嵌入式代理面板和雲端框架 - AI 代
116
116
  這些隨 `@agent-native/core` 一起提供,是您的應用用來與
117
117
  代理,無論哪個框架託管它:
118
118
 
119
- 1. **發送訊息** — `sendToAgentChat()` 向代理發送訊息。
119
+ 1. **傳送訊息** — `sendToAgentChat()` 向代理傳送訊息。
120
120
  `useSendToAgentChat()` 鉤子用描述的程式碼請求門控包裝它
121
121
  並返回一個 `codeRequiredDialog` 元素進行渲染。參見
122
122
  [Drop-in Agent](/docs/drop-in-agent) 的完整用法和選項。
123
123
  2. **生成狀態** - `useAgentChatGenerating()` 跟蹤代理何時
124
124
  正在執行,因此 UI 可以顯示進度,而無需直接輪詢代理。
125
- 3. **輪詢同步** - 資料庫支持的同步在代理時保持 UI 快取最新
125
+ 3. **輪詢同步** - 資料庫支援的同步在代理時保持 UI 快取最新
126
126
  更改資料或應用程式狀態。
127
- 4. **操作系統** - `pnpm action <name>` 分派到相同的可調用
128
- actions 代理作為工具調用,因此代理能做的任何事情,您都可以
129
- 腳本。
127
+ 4. **操作系統** - `pnpm action <name>` 分派到相同的可呼叫
128
+ actions 代理作為工具呼叫,因此代理能做的任何事情,您都可以
129
+ 指令碼。
130
130
 
131
131
  ## 執行它 {#running}
132
132
 
@@ -139,11 +139,11 @@ cd my-app
139
139
  pnpm dev
140
140
  ```
141
141
 
142
- 本機開發框架(框架儲存庫中的私人 `@agent-native/frame` 包)是未發布到 npm 的內部工具包。它將活動應用程式的開發伺服器載入到 iframe 中,並在其旁邊安裝嵌入式面板,通過 `app` 查詢參數選取應用程式。整合CLI終端需要Agent Native Desktop,提供終端所需的本機程式碼和PTY存取;如果沒有它,面板將顯示聊天介面並提示您開啟桌面以使用 CLI。
142
+ 本機開發框架(框架儲存庫中的私人 `@agent-native/frame` 包)是未發布到 npm 的內部工具包。它將活動應用程式的開發伺服器載入到 iframe 中,並在其旁邊安裝嵌入式面板,透過 `app` 查詢參數選取應用程式。整合 CLI 終端需要 Agent Native Desktop,提供終端所需的本機程式碼和PTY存取;如果沒有它,面板將顯示聊天介面並提示您開啟桌面以使用 CLI。
143
143
 
144
- ## 兼容性說明 {#compatibility}
144
+ ## 相容性說明 {#compatibility}
145
145
 
146
- “程式碼模式”概念以前被稱為“開發模式”,因此有一些向後兼容
146
+ “程式碼模式”概念以前被稱為“開發模式”,因此有一些向後相容
147
147
  名稱仍然存在。您可以忽略這些,除非您正在維護舊的整合
148
148
  程式碼:
149
149
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: "開始使用"
3
- description: "建立代理應用,了解說明、skills 和 actions,然後觀看代理調用其第一個操作。"
3
+ description: "建立代理應用,了解說明、skills 和 actions,然後觀看代理呼叫其第一個操作。"
4
4
  ---
5
5
 
6
6
  # 開始使用
@@ -9,7 +9,7 @@ Agent-Native 應用程式為 AI 代理和您的 UI 提供相同的 actions、資
9
9
  狀態。基本代理是由指導它的指令(skills 進行教學)組成的
10
10
  可重複的行為,以及讓它做實際工作的 actions。
11
11
 
12
- **想要一個完整的應用程式開始嗎?**克隆我們丰富的範本之一 -
12
+ **想要一個完整的應用程式開始嗎?**克隆我們豐富的範本之一 -
13
13
  [Chat](/docs/template-chat), [Mail](/docs/template-mail),
14
14
  [Calendar](/docs/template-calendar), [Content](/docs/template-content),
15
15
  [Analytics](/docs/template-analytics) 和 [many more](/docs/cloneable-saas) —
@@ -30,31 +30,31 @@ Agent-Native 應用程式為 AI 代理和您的 UI 提供相同的 actions、資
30
30
  ```
31
31
 
32
32
  無論您是從聊天 UI、無頭代理還是完整應用程式開始,都是如此。
33
- UI改變表面;指令、skills 和 actions 為代理提供
33
+ UI 改變表面;指令、skills 和 actions 為代理提供
34
34
  指導和行為。
35
35
 
36
36
  ## 1。建立您的應用
37
37
 
38
38
  您需要 [Node.js 22+](https://nodejs.org) 和 [pnpm](https://pnpm.io)。
39
39
 
40
- 在沒有標志的情況下執行 `create`,它會詢問您要如何開始(完整的範本,
40
+ 在沒有標誌的情況下執行 `create`,它會詢問您要如何開始(完整的範本,
41
41
  聊天,或無頭)先於其他:
42
42
 
43
43
  ```bash
44
44
  npx @agent-native/core@latest create my-app
45
45
  ```
46
46
 
47
- 或者傳遞一個標志來跳過提示:
47
+ 或者傳遞一個標誌來跳過提示:
48
48
 
49
- **想要 UI?** 從聊天範本開始。您將獲得一名工作代理人以及
50
- 可自訂的聊天UI,您新增的每個操作都會自動顯示在其中:
49
+ **想要 UI?** 從聊天範本開始。您將獲得一名工作代理以及
50
+ 可自訂的聊天 UI,您新增的每個操作都會自動顯示在其中:
51
51
 
52
52
  ```bash
53
53
  npx @agent-native/core@latest create my-app --template chat
54
54
  ```
55
55
 
56
56
  **只是無頭原語?**開始無頭 - 相同的 actions 和代理
57
- 循環,無 UI shell:
57
+ 迴圈,無 UI shell:
58
58
 
59
59
  ```bash
60
60
  npx @agent-native/core@latest create my-agent --headless
@@ -71,7 +71,7 @@ pnpm install
71
71
 
72
72
  ## 2。新增操作
73
73
 
74
- 操作是您的代理(以及您的 UI)可以調用的一項操作。兩個腳手架
74
+ 操作是您的代理(以及您的 UI)可以呼叫的一項操作。兩個腳手架
75
75
  附帶此範例:
76
76
 
77
77
  ```an-annotated-code title="你的第一個 action"
@@ -80,10 +80,10 @@ pnpm install
80
80
  "language": "ts",
81
81
  "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n description: \"從本機代理問好。\",\n schema: z.object({\n name: z.string().default(\"world\"),\n }),\n http: { method: \"GET\" },\n readOnly: true,\n run: async ({ name }) => {\n return { message: `Hello, ${name}!` };\n },\n});",
82
82
  "annotations": [
83
- { "lines": "5", "label": "工具描述", "note": "代理會讀取 `description`,判斷何時把它作為工具調用。" },
83
+ { "lines": "5", "label": "工具描述", "note": "代理會讀取 `description`,判斷何時把它作為工具呼叫。" },
84
84
  { "lines": "6-8", "label": "型別化契約", "note": "一個 zod `schema` 會校驗來自每個入口的輸入:代理、UI、HTTP、MCP 和 A2A。" },
85
85
  { "lines": "9", "label": "HTTP 動詞", "note": "將此操作接入自動掛載的 HTTP 端點。" },
86
- { "lines": "10", "label": "唯讀", "note": "`readOnly` 表示該操作無需批準即可安全調用,並且可作為查詢快取。" },
86
+ { "lines": "10", "label": "唯讀", "note": "`readOnly` 表示該操作無需核准即可安全呼叫,並且可作為查詢快取。" },
87
87
  { "lines": "11-13", "label": "單一實現", "note": "`run` 主體是所有介面都會執行的唯一真實來源。" }
88
88
  ]
89
89
  }
@@ -94,12 +94,12 @@ pnpm install
94
94
 
95
95
  使用 `AGENTS.md` 作為每回合都適用的指導。使用技能時
96
96
  代理需要可重用的工作流程或域過程。在以下情況下使用操作
97
- 代理需要一種型別化、可測試的方式來讀取資料、寫入資料、調用 API 或
98
- 執行批準。
97
+ 代理需要一種型別化、可測試的方式來讀取資料、寫入資料、呼叫 API 或
98
+ 執行核准。
99
99
 
100
100
  ## 3。執行它
101
101
 
102
- 直接調用操作:
102
+ 直接呼叫操作:
103
103
 
104
104
  ```bash
105
105
  pnpm action hello --name Steve
@@ -112,25 +112,25 @@ pnpm agent "Call the hello action for Steve and explain what happened."
112
112
  ```
113
113
 
114
114
  如果您從聊天範本開始,請執行該應用並在
115
- 瀏覽器 - 它已經可以調用您定義的每個操作:
115
+ 瀏覽器 - 它已經可以呼叫您定義的每個操作:
116
116
 
117
117
  ```bash
118
118
  pnpm dev
119
119
  ```
120
120
 
121
- 現在可以通過聊天 UI、CLI、HTTP、MCP、A2A 存取該操作
122
- 計畫作業和 webhooks。定義一次,從任何地方調用。
121
+ 現在可以透過聊天 UI、CLI、HTTP、MCP、A2A 存取該操作
122
+ 計畫作業和 webhooks。定義一次,從任何地方呼叫。
123
123
 
124
- ```an-diagram title="一個動作,每個表面" summary="單個 defineAction 檔案扇出到每個消費者,無需額外接線。"
124
+ ```an-diagram title="一個動作,每個表面" summary="單一 defineAction 檔案扇出到每個消費者,無需額外接線。"
125
125
  {
126
126
  "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">聊天介面</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">計畫工作</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
127
127
  "css": ".diagram-fan{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fan .diagram-surfaces{display:flex;flex-wrap:wrap;gap:8px;max-width:420px}.diagram-fan .diagram-arrow{font-size:22px;line-height:1}"
128
128
  }
129
129
  ```
130
130
 
131
- ## 狀態是內置的
131
+ ## 狀態是內建的
132
132
 
133
- 無頭並不意味著無狀態。 Actions,工作階段,應用程式狀態,線程,
133
+ 無頭並不意味著無狀態。 Actions,工作階段,應用程式狀態,對話串,
134
134
  執行歷史紀錄和憑證均位於 SQL 中。本機地址為 SQLite
135
135
  `data/app.db`;在正式環境中您設定 `DATABASE_URL`。請參閱
136
136
  [Deployment](/docs/deployment).
@@ -138,14 +138,14 @@ pnpm dev
138
138
  ```an-callout
139
139
  {
140
140
  "tone": "info",
141
- "body": "**Headless 仍然是一個真正的應用程式。**應用程式代理循環在 SQL 中保留工作階段、線程、執行、設定和憑證 - 它不是無狀態提示。您可以稍後新增 UI,而無需更改操作或狀態。"
141
+ "body": "**Headless 仍然是一個真正的應用程式。**應用程式代理迴圈在 SQL 中保留工作階段、對話串、執行、設定和憑證 - 它不是無狀態提示。您可以稍後新增 UI,而無需更改操作或狀態。"
142
142
  }
143
143
  ```
144
144
 
145
- ## 自訂UI
145
+ ## 自訂 UI
146
146
 
147
147
  如果您從聊天範本開始,則可以編輯 UI。聊天本身
148
- 是基於 `<AgentChatSurface>` 元件建置的一條小路線:
148
+ 是基於 `<AgentChatSurface>` 元件建置的一條小路由:
149
149
 
150
150
  ```tsx
151
151
  // app/routes/_index.tsx
@@ -158,7 +158,7 @@ export default function ChatRoute() {
158
158
 
159
159
  - **`app/routes/_index.tsx`** — 聊天頁面。更改建議,空
160
160
  狀態和布局。
161
- - **`app/root.tsx`** — 應用程式外殼。在週圍新增您自己的路線和螢幕
161
+ - **`app/root.tsx`** — 應用程式外殼。在週圍新增您自己的路由和螢幕
162
162
  代理。
163
163
  - 使用 `<AgentSidebar>` 將代理放入任何螢幕,從 a 手動操作它
164
164
  使用 `sendToAgentChat()` 按鈕,或直接使用
@@ -166,7 +166,7 @@ export default function ChatRoute() {
166
166
 
167
167
  請參閱 [Drop-in Agent](/docs/drop-in-agent) 了解完整的元件集,並且
168
168
  [Native 聊天介面](/docs/native-chat-ui) 將操作結果呈現為表格,
169
- 圖表和打字卡片而不是純文本。
169
+ 圖表和打字卡片而不是純文字。
170
170
 
171
171
  **開始無頭,稍後想要 UI?** 聊天範本*是* UI 入口 -
172
172
  它的`app/`層(React Router + Vite)正是無頭腳手架
@@ -178,7 +178,7 @@ export default function ChatRoute() {
178
178
 
179
179
  ```text
180
180
  my-app/
181
- actions/ # 代理可調用的操作
181
+ actions/ # 代理可呼叫的操作
182
182
  app/ # React 前端(僅 UI 範本;無頭模式會省略)
183
183
  server/ # Nitro API 伺服器(路由、外掛)
184
184
  AGENTS.md # 始終生效的代理指令
@@ -189,9 +189,9 @@ my-app/
189
189
  ## 下一步去哪裡
190
190
 
191
191
  - **[Key Concepts](/docs/key-concepts)** — 核心架構:SQL、actions,
192
- 同步和上下文感知。
192
+ 同步和脈絡感知。
193
193
  - **[Actions](/docs/actions)** — 完整操作 API:架構、HTTP、驗證和
194
- 批準。
194
+ 核准。
195
195
  - **[Agent Surfaces](/docs/agent-surfaces)** — 無頭、聊天、嵌入式 sidecar,
196
196
  和完整的應用程式。
197
197
  - **[Drop-in Agent](/docs/drop-in-agent)** — 將代理聊天新增到任何 React 應用程式。