@agent-native/core 0.79.12 → 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 (285) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +19 -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 +417 -42
  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 +3 -1
  184. package/dist/deploy/build.d.ts.map +1 -1
  185. package/dist/deploy/build.js +361 -37
  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/resources/handlers.d.ts +2 -2
  191. package/dist/server/edge.d.ts +11 -0
  192. package/dist/server/edge.d.ts.map +1 -0
  193. package/dist/server/edge.js +11 -0
  194. package/dist/server/edge.js.map +1 -0
  195. package/dist/styles/agent-native.css +93 -0
  196. package/dist/templates/default/app/i18n/zh-TW.ts +44 -44
  197. package/dist/vite/client.d.ts.map +1 -1
  198. package/dist/vite/client.js +1 -0
  199. package/dist/vite/client.js.map +1 -1
  200. package/docs/content/locales/zh-TW/a2a-protocol.md +68 -68
  201. package/docs/content/locales/zh-TW/actions.md +82 -82
  202. package/docs/content/locales/zh-TW/agent-mentions.md +22 -22
  203. package/docs/content/locales/zh-TW/agent-surfaces.md +82 -82
  204. package/docs/content/locales/zh-TW/agent-teams.md +29 -29
  205. package/docs/content/locales/zh-TW/agent-web-surfaces.md +11 -11
  206. package/docs/content/locales/zh-TW/audit-log.md +16 -16
  207. package/docs/content/locales/zh-TW/authentication.md +32 -32
  208. package/docs/content/locales/zh-TW/automations.md +32 -32
  209. package/docs/content/locales/zh-TW/blueprint-installer.md +19 -19
  210. package/docs/content/locales/zh-TW/cli-adapters.md +17 -17
  211. package/docs/content/locales/zh-TW/client.md +62 -62
  212. package/docs/content/locales/zh-TW/cloneable-saas.md +32 -32
  213. package/docs/content/locales/zh-TW/code-agents-ui.md +91 -91
  214. package/docs/content/locales/zh-TW/components.md +51 -51
  215. package/docs/content/locales/zh-TW/context-awareness.md +66 -66
  216. package/docs/content/locales/zh-TW/creating-templates.md +39 -39
  217. package/docs/content/locales/zh-TW/cross-app-sso.md +29 -29
  218. package/docs/content/locales/zh-TW/database.md +21 -21
  219. package/docs/content/locales/zh-TW/deployment.md +37 -37
  220. package/docs/content/locales/zh-TW/dispatch.md +43 -43
  221. package/docs/content/locales/zh-TW/drop-in-agent.md +34 -34
  222. package/docs/content/locales/zh-TW/durable-resume.md +18 -18
  223. package/docs/content/locales/zh-TW/embedding-sdk.md +73 -73
  224. package/docs/content/locales/zh-TW/evals.md +16 -16
  225. package/docs/content/locales/zh-TW/extensions.md +81 -81
  226. package/docs/content/locales/zh-TW/external-agents.md +146 -146
  227. package/docs/content/locales/zh-TW/faq.md +43 -43
  228. package/docs/content/locales/zh-TW/file-uploads.md +11 -11
  229. package/docs/content/locales/zh-TW/frames.md +33 -33
  230. package/docs/content/locales/zh-TW/getting-started.md +28 -28
  231. package/docs/content/locales/zh-TW/harness-agents.md +78 -78
  232. package/docs/content/locales/zh-TW/human-approval.md +27 -27
  233. package/docs/content/locales/zh-TW/internationalization.md +19 -19
  234. package/docs/content/locales/zh-TW/key-concepts.md +68 -68
  235. package/docs/content/locales/zh-TW/local-file-mode.md +50 -50
  236. package/docs/content/locales/zh-TW/mcp-apps.md +38 -38
  237. package/docs/content/locales/zh-TW/mcp-clients.md +67 -67
  238. package/docs/content/locales/zh-TW/mcp-protocol.md +50 -50
  239. package/docs/content/locales/zh-TW/messaging.md +99 -99
  240. package/docs/content/locales/zh-TW/migration-workbench.md +6 -6
  241. package/docs/content/locales/zh-TW/multi-app-workspace.md +39 -39
  242. package/docs/content/locales/zh-TW/multi-tenancy.md +7 -7
  243. package/docs/content/locales/zh-TW/native-chat-ui.md +38 -38
  244. package/docs/content/locales/zh-TW/notifications.md +23 -23
  245. package/docs/content/locales/zh-TW/observability.md +49 -49
  246. package/docs/content/locales/zh-TW/observational-memory.md +23 -23
  247. package/docs/content/locales/zh-TW/onboarding.md +40 -40
  248. package/docs/content/locales/zh-TW/plan-plugin.md +37 -37
  249. package/docs/content/locales/zh-TW/pr-visual-recap.md +72 -72
  250. package/docs/content/locales/zh-TW/processors.md +17 -17
  251. package/docs/content/locales/zh-TW/progress.md +15 -15
  252. package/docs/content/locales/zh-TW/pure-agent-apps.md +10 -10
  253. package/docs/content/locales/zh-TW/real-time-collaboration.md +103 -103
  254. package/docs/content/locales/zh-TW/recurring-jobs.md +19 -19
  255. package/docs/content/locales/zh-TW/routing.md +9 -9
  256. package/docs/content/locales/zh-TW/sandbox-adapters.md +48 -48
  257. package/docs/content/locales/zh-TW/security.md +49 -49
  258. package/docs/content/locales/zh-TW/server.md +47 -47
  259. package/docs/content/locales/zh-TW/sharing.md +22 -22
  260. package/docs/content/locales/zh-TW/skills-guide.md +46 -46
  261. package/docs/content/locales/zh-TW/template-analytics.md +40 -40
  262. package/docs/content/locales/zh-TW/template-assets.md +69 -69
  263. package/docs/content/locales/zh-TW/template-brain.md +81 -81
  264. package/docs/content/locales/zh-TW/template-calendar.md +40 -40
  265. package/docs/content/locales/zh-TW/template-chat.md +27 -27
  266. package/docs/content/locales/zh-TW/template-clips.md +85 -85
  267. package/docs/content/locales/zh-TW/template-content.md +65 -66
  268. package/docs/content/locales/zh-TW/template-design.md +29 -29
  269. package/docs/content/locales/zh-TW/template-dispatch.md +51 -51
  270. package/docs/content/locales/zh-TW/template-forms.md +25 -25
  271. package/docs/content/locales/zh-TW/template-mail.md +71 -71
  272. package/docs/content/locales/zh-TW/template-plan.md +92 -92
  273. package/docs/content/locales/zh-TW/template-slides.md +52 -52
  274. package/docs/content/locales/zh-TW/template-videos.md +30 -30
  275. package/docs/content/locales/zh-TW/tracking.md +29 -29
  276. package/docs/content/locales/zh-TW/using-your-agent.md +18 -18
  277. package/docs/content/locales/zh-TW/voice-input.md +19 -19
  278. package/docs/content/locales/zh-TW/what-is-agent-native.md +61 -61
  279. package/docs/content/locales/zh-TW/workspace-connections.md +41 -41
  280. package/docs/content/locales/zh-TW/workspace-management.md +27 -27
  281. package/docs/content/locales/zh-TW/workspace.md +58 -58
  282. package/docs/content/locales/zh-TW/writing-agent-instructions.md +41 -41
  283. package/docs/content/template-clips.md +48 -2
  284. package/package.json +2 -1
  285. package/src/templates/default/app/i18n/zh-TW.ts +44 -44
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: "視覺計畫"
3
- description: "Agent-Native 計畫將您的編碼代理的計畫轉變為結構化的、可審閱的檔案 - 圖表、線框圖、帶注釋的程式碼、注釋和共用連結。從CLI安裝一次;您與之共用的審閱者以訪客身分進行編輯,登入後僅可儲存或共用。"
3
+ description: "Agent-Native 計畫將您的編碼代理的計畫轉變為結構化的、可審閱的檔案 - 圖表、線框圖、帶註解的程式碼、註解和共用連結。從 CLI 安裝一次;您與之共用的審閱者以訪客身分進行編輯,登入後僅可儲存或共用。"
4
4
  ---
5
5
 
6
6
  # 視覺計畫
@@ -8,24 +8,24 @@ description: "Agent-Native 計畫將您的編碼代理的計畫轉變為結構
8
8
  > **大多數人安裝 Plan 作為一項技能,而不是支架式應用程式。** 一個 CLI 指令
9
9
  > 新增 `/visual-plan` 和 `/visual-recap` skills 以及託管計畫
10
10
  > 連線到您的編碼代理 - 請參閱 [Plan plugin & marketplace](/docs/plan-plugin)
11
- > 用於外掛和市場路線。分叉計畫範本(參見
11
+ > 用於外掛和市場路由。分叉計畫範本(參見
12
12
  > [For developers](#for-developers)) 是輔助路徑,用於自託管或
13
13
  > 建立在計畫本身之上。
14
14
 
15
- Agent-Native 計畫是編碼代理的可視化計畫模式。它變成了普通
15
+ Agent-Native 計畫是編碼代理的視覺化計畫模式。它變成了普通
16
16
  Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
17
- 使用富文本、圖表、線框圖、帶注釋的程式碼演練檢視表面
18
- 以及檔案樹、注釋、評論和可共用連結。
17
+ 使用富文字、圖表、線框圖、帶註解的程式碼演練檢視表面
18
+ 以及檔案樹、註解、評論和可共用連結。
19
19
 
20
20
  它歸結為兩個指令。 `/visual-plan` 在代理之前**制定計畫
21
21
  編寫程式碼。 `/visual-recap` 將**已經發生的變化變成了 PR,
22
- 提交、分支或 git diff — 進入高海拔可視化程式碼審查。都開啟
23
- 相同的審閱介面,因此您可以注釋、評論並將意見回饋返回給
22
+ 提交、分支或 git diff — 進入高海拔視覺化程式碼審查。都開啟
23
+ 相同的審閱介面,因此您可以註解、評論並將意見回饋返回給
24
24
  以同樣的方式代理。
25
25
 
26
- ```an-diagram title="兩個指令,一個檢視介面" summary="這兩個指令都通過託管的 Plan MCP 連線器發布到相同的注釋和評論介面。"
26
+ ```an-diagram title="兩個指令,一個檢視介面" summary="這兩個指令都透過託管的 Plan MCP 連線器發布到相同的註解和評論介面。"
27
27
  {
28
- "html": "<div class=\"diagram-plan\"><div class=\"diagram-col\"><div class=\"diagram-node\"><span class=\"diagram-pill accent\">/visual-plan</span><small class=\"diagram-muted\">寫程式碼前 — 架構、UI、重構</small></div><div class=\"diagram-node\"><span class=\"diagram-pill\">/visual-recap</span><small class=\"diagram-muted\">寫程式碼後 — PR、提交、分支、diff</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">Plan MCP 連線器<br><small class=\"diagram-muted\">plan.agent-native.com</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">審閱介面<br><small class=\"diagram-muted\">圖表 · 線框圖 · 帶注釋的程式碼 · 評論</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-node\">編碼代理<br><small class=\"diagram-muted\">意見回饋已交回</small></div></div>",
28
+ "html": "<div class=\"diagram-plan\"><div class=\"diagram-col\"><div class=\"diagram-node\"><span class=\"diagram-pill accent\">/visual-plan</span><small class=\"diagram-muted\">寫程式碼前 — 架構、UI、重構</small></div><div class=\"diagram-node\"><span class=\"diagram-pill\">/visual-recap</span><small class=\"diagram-muted\">寫程式碼後 — PR、提交、分支、diff</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">Plan MCP 連線器<br><small class=\"diagram-muted\">plan.agent-native.com</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">審閱介面<br><small class=\"diagram-muted\">圖表 · 線框圖 · 帶註解的程式碼 · 評論</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-node\">編碼代理<br><small class=\"diagram-muted\">意見回饋已交回</small></div></div>",
29
29
  "css": ".diagram-plan{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-plan .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-plan .diagram-arrow{font-size:22px;line-height:1}.diagram-plan .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}"
30
30
  }
31
31
  ```
@@ -33,7 +33,7 @@ Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
33
33
  ```an-wireframe
34
34
  {
35
35
  "surface": "desktop",
36
- "html": "<div style='display:grid;grid-template-columns:1fr 250px;gap:14px;padding:16px;min-height:520px;box-sizing:border-box'><main style='display:flex;flex-direction:column;gap:12px;min-width:0'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>結帳改版計畫</h1><div style='flex:1'></div><button>分享</button><button class='primary'>批準</button></div><div class='wf-card' style='display:grid;grid-template-columns:1fr 1fr;gap:10px;min-height:150px'><div class='wf-box'>目前線框圖</div><div class='wf-box'>擬議線框圖</div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:10px'><strong>實施計畫</strong><div class='wf-box'>決策:保留現有結帳外殼</div><div class='wf-box'>帶注釋的程式碼演練</div><div class='wf-box'>開放問題</div></div></main><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>評論</strong><div class='wf-box'>主 CTA 上的標注</div><div class='wf-box'>給代理的問題</div><div class='wf-box'>已解決的文案備注</div><button class='primary'>交回意見回饋</button></aside></div>"
36
+ "html": "<div style='display:grid;grid-template-columns:1fr 250px;gap:14px;padding:16px;min-height:520px;box-sizing:border-box'><main style='display:flex;flex-direction:column;gap:12px;min-width:0'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>結帳改版計畫</h1><div style='flex:1'></div><button>分享</button><button class='primary'>核准</button></div><div class='wf-card' style='display:grid;grid-template-columns:1fr 1fr;gap:10px;min-height:150px'><div class='wf-box'>目前線框圖</div><div class='wf-box'>擬議線框圖</div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:10px'><strong>實施計畫</strong><div class='wf-box'>決策:保留現有結帳外殼</div><div class='wf-box'>帶註解的程式碼演練</div><div class='wf-box'>開放問題</div></div></main><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>評論</strong><div class='wf-box'>主 CTA 上的標注</div><div class='wf-box'>給代理的問題</div><div class='wf-box'>已解決的文案備註</div><button class='primary'>交回意見回饋</button></aside></div>"
37
37
  }
38
38
  ```
39
39
 
@@ -49,7 +49,7 @@ Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
49
49
 
50
50
  使用 Agent-Native CLI。這是推薦的設定,因為它安裝了
51
51
  計畫技能說明,註冊託管計畫 MCP 連線器,**和**執行
52
- 一步完成特定於用戶端的驗證/設定流程,因此您的第一個工具調用不會
52
+ 一步完成特定於用戶端的驗證/設定流程,因此您的第一個工具呼叫不會
53
53
  撞到 OAuth 牆:
54
54
 
55
55
  ```bash
@@ -63,17 +63,17 @@ npx @agent-native/core@latest skills add visual-plan
63
63
  `https://plan.agent-native.com/_agent-native/mcp` — 請參閱 [MCP Clients](/docs/mcp-clients) 以了解特定於用戶端的設定。
64
64
 
65
65
  驗證是在設定時進行一次性瀏覽器登入 - 這是有意為之的
66
- 是讓代理持續存在並共用其生成的計畫的原因。授權是什么
66
+ 是讓代理持續存在並共用其產生的計畫的原因。授權是什麼
67
67
  步驟取決於您的客戶:
68
68
 
69
- - **支持 OAuth 的主機**(Claude 程式碼)獲取僅 URL 的 MCP 條目以及提示
69
+ - **支援 OAuth 的主機**(Claude 程式碼)取得僅 URL 的 MCP 條目以及提示
70
70
  執行`/mcp`並選取**驗證**。
71
71
  - **Codex / Cowork** 執行簡短的瀏覽器設備程式碼流程:CLI 列印程式碼,
72
- 開啟驗證頁面,並在批準後寫入連線器。
72
+ 開啟驗證頁面,並在核准後寫入連線器。
73
73
  - 在 **非互動式 shell 或 CI** 中,會跳過驗證步驟並執行準確的
74
74
  為您列印稍後執行的指令。
75
75
 
76
- 預設情況下,CLI 以它可以設定的每個受支持的本機用戶端為目標。通過
76
+ 預設情況下,CLI 以它可以設定的每個受支援的本機用戶端為目標。透過
77
77
  `--client codex`、`--client claude-code` 或其他特定用戶端,當您
78
78
  想要將設定範圍縮小到一台主機:
79
79
 
@@ -81,7 +81,7 @@ npx @agent-native/core@latest skills add visual-plan
81
81
  npx @agent-native/core@latest skills add visual-plan
82
82
  ```
83
83
 
84
- 通過`--no-connect`註冊連線器而不進行驗證,然後執行
84
+ 透過`--no-connect`註冊連線器而不進行驗證,然後執行
85
85
  `npx @agent-native/core@latest connect https://plan.agent-native.com --client all`
86
86
  當您準備好時,或者選取較窄的 `--client`:
87
87
 
@@ -89,7 +89,7 @@ npx @agent-native/core@latest skills add visual-plan
89
89
  npx @agent-native/core@latest skills add visual-plan --no-connect
90
90
  ```
91
91
 
92
- 要自動生成**每個拉取請求**的回顧,請傳遞 `--with-github-action`。
92
+ 要自動生成**每個 pull request**的回顧,請傳遞 `--with-github-action`。
93
93
  這會編寫一個在每個 PR 上執行 `visual-recap` 技能的 GitHub 操作,並且
94
94
  發布了一個互動式回顧計畫,其中包含內嵌螢幕截圖作為置頂評論 -
95
95
  參見[PR Visual Recap](/docs/pr-visual-recap)。
@@ -102,13 +102,13 @@ npx @agent-native/core@latest skills add visual-plan --with-github-action
102
102
  GitHub Actions 秘密/變數(如果可能)和 `npx @agent-native/core@latest recap doctor`
103
103
  驗證儲存庫是否已準備就緒。
104
104
 
105
- 如果您只想通過開啟Skills CLI來移植指令檔案,請使用:
105
+ 如果您只想透過開啟Skills CLI 來移植指令檔案,請使用:
106
106
 
107
107
  ```bash
108
108
  npx skills@latest add BuilderIO/agent-native --skill visual-plan
109
109
  ```
110
110
 
111
- 這僅安裝技能說明。它不註冊託管的MCP
111
+ 這僅安裝技能說明。它不註冊託管的 MCP
112
112
  連線器,因此當您需要單指令設定時請使用 Agent-Native CLI 路徑。
113
113
 
114
114
  > **更喜歡一次性安裝外掛?** Claude 程式碼和 Codex 可以新增
@@ -122,13 +122,13 @@ npx skills@latest add BuilderIO/agent-native --skill visual-plan
122
122
  [Agent-Native Plans extension](https://marketplace.visualstudio.com/items?itemName=Builder.agent-native)
123
123
  在側面板中開啟相同的計畫審核介面,而不是讓您進入
124
124
  單獨的瀏覽器分頁。計畫工具仍然返回正常的 Web 連結,並且 MCP
125
- 元資料還包括 VS Code 切換 URL:
125
+ 中繼資料還包括 VS Code 切換 URL:
126
126
 
127
127
  ```text
128
128
  vscode://builder.agent-native/open?url=<encoded-plan-url>
129
129
  ```
130
130
 
131
- 擴充功能處理 URI,在 VS Code Web 視圖中開啟解碼後的計畫 URL,
131
+ 擴充功能處理 URI,在 VS Code Web 檢視中開啟解碼後的計畫 URL,
132
132
  並包含一個指令來執行 VS 的現有 Agent Native MCP 連線流程
133
133
  程式碼 / GitHub 副駕駛。這對於 Claude 程式碼或其他程式碼特別有用
134
134
  編碼代理工作流程,其中計畫應位於正在編輯的檔案旁邊。
@@ -139,36 +139,36 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
139
139
 
140
140
  - `/visual-plan` **在**實施之前建立結構化計畫 -
141
141
  架構、後端、重構、UI 或混合產品工作 - 引入
142
- 圖表、線框圖、模型、可點擊原型和帶注釋的程式碼
142
+ 圖表、線框圖、模型、可點選原型和帶註解的程式碼
143
143
  工作需要的演練和檔案樹。
144
144
  - `/visual-recap` 對已經發生的變更進行高空**審查**
145
145
  發生 — PR、提交、分支或 git diff — 作為架構、API、檔案和
146
146
  之前/之後塊而不是原始差異牆。
147
147
 
148
- 代理應首先檢查程式碼庫,然後在出現問題時建立可視化計畫
148
+ 代理應首先檢查程式碼庫,然後在出現問題時建立視覺化計畫
149
149
  錯誤的方向將會付出高昂的代價。返回的計畫連結將在
150
- 瀏覽器或 VS Code,以便您可以注釋、更正、選取選項並詢問
150
+ 瀏覽器或 VS Code,以便您可以註解、更正、選取選項並詢問
151
151
  在程式碼更改開始之前更新。
152
152
 
153
153
  當 Codex、Claude 程式碼、Markdown 或貼上的計畫已存在時,使用
154
- `/visual-plan`;代理保留來源計畫並建置更丰富的評論
154
+ `/visual-plan`;代理保留來源計畫並建置更豐富的評論
155
155
  從它開始,而不是重新開始。
156
156
 
157
157
  如果第一遍仍有可回答的決策,代理可以放置
158
- **開放式問題**表格位於同一計畫的底部。接听並發送
158
+ **開放式問題**表格位於同一計畫的底部。接聽並傳送
159
159
  它向代理啟動針對現有計畫的修訂。
160
160
 
161
- ## 你可以用它做什么
161
+ ## 你可以用它做什麼
162
162
 
163
163
  - **實施前審查。** React 到圖表、線框圖、選項分頁,
164
- 開放問題表格、風險說明、帶注釋的程式碼演練和程式碼
164
+ 開放問題表格、風險說明、帶註解的程式碼演練和程式碼
165
165
  在代理編輯檔案之前進行預覽。
166
- - **直接對計畫發表評論。**將意見回饋固定到文本、圖片、線框或
166
+ - **直接對計畫發表評論。**將意見回饋固定到文字、圖片、線框或
167
167
  畫布位置;選取評論是針對代理還是針對人類
168
- 審稿人; @提及有內聯筹碼的隊友;並將評論解決為
168
+ 審稿人; @提及有行內標籤的隊友;並將評論解決為
169
169
  計畫不斷發展。
170
- - **清楚地將意見回饋意見回饋給客服人員。**文本評論附在最近的位置
171
- 散文塊,視覺注釋包括精確的目標元資料和瀏覽器
170
+ - **清楚地將意見回饋意見回饋給代理。**文字評論附在最近的位置
171
+ 散文塊,視覺註解包括精確的目標中繼資料和瀏覽器
172
172
  交接包括一小部分視覺/畫布評論的重點螢幕截圖
173
173
  位置而不是一張難以閱讀的巨型圖片。
174
174
  - **匯出結果。**保留計畫的 HTML、Markdown 或 JSON 收據
@@ -183,9 +183,9 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
183
183
  當訪客登入時,他們作為訪客建立的計畫將被**認領**到
184
184
  他們的帳戶,因此他們建置的任何內容都不會丟失。
185
185
 
186
- 計畫內聯散文編輯:點擊進入任何文本部分,輸入丰富的格式
186
+ 計畫行內散文編輯:點選進入任何文字部分,輸入豐富的格式
187
187
  編輯器工具列或斜線選單,並且計畫自動儲存基礎降價。評論
188
- 注釋模式暫時將文本部分變為唯讀,以便點擊可以固定
188
+ 註解模式暫時將文字部分變為唯讀,以便點選可以固定
189
189
  意見回饋;離開審閱模式以繼續編輯散文。
190
190
 
191
191
  ## 分享和評論 {#sharing}
@@ -194,7 +194,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
194
194
 
195
195
  - **檢視**公開或共用計畫適用於知道連結的任何人 - 無需帳戶
196
196
  必需。
197
- - **對共用計畫發表評論**需要代理本機帳戶。
197
+ - **對共用計畫發表評論**需要 Agent-Native 帳戶。
198
198
  - **共用**計畫(將其發布到連結、私人共用、審閱者存取權限,
199
199
  跨設備或團隊審核)需要登入。Google 登入會在以下情況出現
200
200
  標準 Google OAuth 環境變數已設定。
@@ -216,7 +216,7 @@ Use /visual-plan in local-files mode. Do not write this plan to the Plan DB.
216
216
  export AGENT_NATIVE_PLANS_MODE=local-files
217
217
  ```
218
218
 
219
- 在此模式下,代理寫入本機 MDX 資料夾,並且不得調用託管
219
+ 在此模式下,代理寫入本機 MDX 資料夾,並且不得呼叫託管
220
220
  規劃 MCP 工具。當您需要該計畫時,請使用儲存庫資料夾,例如 `plans/<slug>/`
221
221
  已使用程式碼簽入。使用臨時或忽略的資料夾,例如
222
222
  `/tmp/agent-native-plans/<slug>/` 或 `.agent-native/plans/<slug>/`,當
@@ -237,17 +237,17 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
237
237
 
238
238
  橋梁 URL 看起來像
239
239
  `https://plan.agent-native.com/local-plans/<slug>?bridge=http://127.0.0.1:...`.
240
- 該頁面是普通的計畫檢視器,但瀏覽器獲取 `plan.mdx`,
240
+ 該頁面是普通的計畫檢視器,但瀏覽器取得 `plan.mdx`,
241
241
  `canvas.mdx`、`prototype.mdx`、`.plan-state.json` 以及來自
242
242
  本機主機橋。計畫內容不會寫入託管資料庫,而是
243
- 未通過託管計畫 actions 發送。保持橋接進程執行
244
- 審查; URL 是您計算機的本機連結,不是可共用的團隊連結。
245
- serve指令預設將開啟的URL寫入`.plan-url`,因此編碼代理可以
243
+ 未通過託管計畫 actions 傳送。保持橋接行程執行
244
+ 審查; URL 是您電腦的本機連結,不是可共用的團隊連結。
245
+ serve指令預設將開啟的 URL 寫入`.plan-url`,因此編碼代理可以
246
246
  捕獲它而不抓取長時間執行的標準輸出;將該檔案視為僅本機檔案
247
- 因為URL包含橋接權杖,所以不要提交它。
247
+ 因為 URL 包含橋接權杖,所以不要提交它。
248
248
 
249
249
  在 macOS 上,`--open` 更喜歡 Chrome/Chromium,因為 Safari 可以阻止託管
250
- HTTPS 通過獲取 HTTP 本機主機橋來計畫頁面。對於無頭
250
+ HTTPS 透過取得 HTTP 本機主機橋來計畫頁面。對於無頭
251
251
  故障排除,執行:
252
252
 
253
253
  ```bash
@@ -264,7 +264,7 @@ npx @agent-native/core@latest plan local verify --dir plans/<slug> --kind plan
264
264
  http://localhost:<port>/local-plans/<slug>
265
265
  ```
266
266
 
267
- 對於儲存庫支持的資料夾,直接本機路由可以攜帶儲存庫相對
267
+ 對於儲存庫支援的資料夾,直接本機路由可以攜帶儲存庫相對
268
268
  資料夾路徑,以便瀏覽器編輯繼續寫入該資料夾:
269
269
 
270
270
  ```text
@@ -286,24 +286,24 @@ http://localhost:<port>/local-plans/<slug>?path=plans%2F<slug>
286
286
  }
287
287
  ```
288
288
 
289
- 直接本機計畫路線包括儲存臨時本機資料夾的選單操作
289
+ 直接本機計畫路由包括儲存臨時本機資料夾的選單操作
290
290
  進入該儲存庫位置。升級後,頁面重新開啟,顯示 `?path=...` 和
291
291
  繼續將 MDX 編輯自動儲存到儲存庫資料夾。
292
292
 
293
293
  本機檔案模式可防止計畫或回顧內容進入 Agent-Native
294
294
  計畫資料庫。它還停用託管共用、瀏覽器評論、計畫歷史紀錄,
295
295
  並發布/匯出收據,直到您明確選取發布。行動
296
- 本機規劃到託管資料庫中,用本機調用`publish-visual-plan`
297
- MDX資料夾路徑;這將上傳計畫,為其分配託管 ID,啟用共用
298
- 並評論,並返回託管的URL。本機檔案模式沒有
299
- 自動使您的編碼代理的 LLM 本機化;選取本機或批準的
296
+ 本機規劃到託管資料庫中,用本機呼叫`publish-visual-plan`
297
+ MDX 資料夾路徑;這將上傳計畫,為其分配託管 ID,啟用共用
298
+ 並評論,並返回託管的 URL。本機檔案模式沒有
299
+ 自動使您的編碼代理的 LLM 本機化;選取本機或核准的
300
300
  模型是否隱私邊界也很重要。
301
301
 
302
302
  ## 桌面本機檔案同步 {#desktop-local-sync}
303
303
 
304
304
  Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這個
305
305
  與本機檔案隱私模式不同:託管計畫資料庫仍然是
306
- 共用、評論、歷史紀錄和實時評論的真實來源,而桌面
306
+ 共用、評論、歷史紀錄和即時評論的真實來源,而桌面
307
307
  可以將目前計畫的來源檔案鏡像到您選取的資料夾。
308
308
 
309
309
  在 Agent Native 桌面中開啟計畫,使用計畫選單的**本機檔案** actions,
@@ -312,7 +312,7 @@ Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這
312
312
  - **連結本機資料夾** — 選取該計畫的 MDX 來源的資料夾。
313
313
  - **同步到本機資料夾** — 寫入 `plan.mdx`,可選 `canvas.mdx`,
314
314
  可選的 `prototype.mdx`、可選的 `.plan-state.json` 和圖片資源。
315
- - **匯入本機編輯** - 讀取資料夾並通過
315
+ - **匯入本機編輯** - 讀取資料夾並透過
316
316
  `import-visual-plan-source` 以及計畫的目前更新時間戳。
317
317
  - **自動同步更改** — 之後繼續匯出託管計畫的最新來源
318
318
  在應用程式中進行的編輯。
@@ -323,20 +323,20 @@ Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這
323
323
 
324
324
  ## 刪除託管計畫資料 {#delete-data}
325
325
 
326
- 已登入的所有者可以從計畫列表中刪除其託管計畫和摘要,或者
326
+ 已登入的所有者可以從計畫清單中刪除其託管計畫和摘要,或者
327
327
  計畫操作選單。
328
328
 
329
- - **軟刪除**將計畫移至**已刪除**分頁,制作正常計畫
330
- 視圖/直接連結停止工作,並通過建立行來刪除公開存取
329
+ - **軟刪除**將計畫移至**已刪除**分頁,製作正常計畫
330
+ 檢視/直接連結停止工作,並透過建立行來刪除公開存取
331
331
  私人。 SQL 行將被保留,以便所有者稍後可以恢復計畫。
332
- - **恢復**可從軟刪除計畫的**已刪除**分頁中獲取。
332
+ - **恢復**可從軟刪除計畫的**已刪除**分頁中取得。
333
333
  - **永久刪除**刪除託管計畫行和計畫範圍的評論,
334
334
  部分、活動事件、版本快照、共用授權、濫用報告和
335
335
  SQL 資產紀錄。 UI 需要在決賽前輸入 `DELETE <plan-id>`
336
336
  按鈕啟用。
337
337
 
338
- 永久刪除會刪除 Plan 應用的資料庫紀錄和 SQL 支持的資產
339
- 字節/引用。如果部署使用外部上傳提供程序,則提供程序
338
+ 永久刪除會刪除 Plan 應用的資料庫紀錄和 SQL 支援的資產
339
+ 位元組/引用。如果部署使用外部上傳提供者,則提供者
340
340
  物件保留遵循該提供者的生命週期,因為共用上傳
341
341
  抽象目前不公開物件刪除。本機檔案隱私模式
342
342
  將來源程式碼保留在本機 MDX 資料夾中;刪除託管資料不會
@@ -355,8 +355,8 @@ Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這
355
355
 
356
356
  如果計畫工具返回 `needs auth`、`Unauthorized` 或“工作階段”
357
357
  已終止`,不要繼續重試。使用
358
- `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`對於 Codex,或在支持 OAuth 的主機中重新執行`/mcp` → **驗證**。開始一個
359
- 在等待該工具之前新建 Codex 線程或重新啟動/重新載入相關用戶端
358
+ `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`對於 Codex,或在支援 OAuth 的主機中重新執行`/mcp` → **驗證**。開始一個
359
+ 在等待該工具之前新建 Codex 對話串或重新啟動/重新載入相關用戶端
360
360
  要更新的註冊表。
361
361
 
362
362
  ## 對於開發者
@@ -373,7 +373,7 @@ pnpm install
373
373
  pnpm dev
374
374
  ```
375
375
 
376
- 託管應用程式支持的技能使用:
376
+ 託管應用程式支援的技能使用:
377
377
 
378
378
  - 應用程式:`https://plan.agent-native.com`
379
379
  - MCP: `https://plan.agent-native.com/_agent-native/mcp`
@@ -384,7 +384,7 @@ pnpm dev
384
384
 
385
385
  架構位於 `templates/plan/server/db/schema.ts` 中。核心表:
386
386
 
387
- | 表格 | 它包含什么 |
387
+ | 表格 | 它包含什麼 |
388
388
  | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
389
389
  | `plans` | 每個計畫或回顧 - `title`、`brief`、`kind`(計畫/回顧)、`status`、`source`、`html`/`markdown`/`content`、`hosted_plan_id/url`、使用統計、`source_url`、 `deleted_at`/`deleted_by` |
390
390
  | `plan_sections` | 計畫中的有序部分 - `type`、`title`、`body`、`html`、`sort_order`、`created_by` |
@@ -393,9 +393,9 @@ pnpm dev
393
393
  | `plan_versions` | 版本歷史紀錄的時間點快照 |
394
394
  | `plan_shares` | 每位主體的份額授予(檢視者/編輯者/管理員) |
395
395
  | `plan_guest_mints` | 訪客工作階段發放限速紀錄 |
396
- | `plan_assets` | 內嵌圖片資源存儲為base64(沒有上傳提供者時的回退) |
396
+ | `plan_assets` | 內嵌圖片資源儲存為base64(沒有上傳提供者時的回退) |
397
397
 
398
- ```an-schema title="規劃資料模型" summary="一個計畫行擁有有序部分以及評論、事件、版本、共用和內聯資產。"
398
+ ```an-schema title="規劃資料模型" summary="一個計畫行擁有有序部分以及評論、事件、版本、共用和行內資產。"
399
399
  {
400
400
  "entities": [
401
401
  { "id": "plans", "name": "plans", "note": "each plan or recap", "fields": [
@@ -473,7 +473,7 @@ Actions 中的 `templates/plan/actions/`:
473
473
  - **版本** — `list-plan-versions`、`get-plan-version`、`restore-plan-version`
474
474
  - **評論和意見回饋** — `get-plan-feedback`、`reply-to-plan-comment`、`resolve-plan-comment`、`consume-plan-feedback`、`delete-plan-comment`
475
475
  - **原型** — `convert-visual-plan-to-prototype`、`create-prototype-plan`
476
- - **上下文和導覽** — `view-screen`、`navigate`
476
+ - **脈絡和導覽** — `view-screen`、`navigate`
477
477
 
478
478
  ### 自訂 MDX 塊 {#custom-mdx-blocks}
479
479
 
@@ -488,7 +488,7 @@ Actions 中的 `templates/plan/actions/`:
488
488
  - `shared/plan-content.ts` 中的規範化執行時型別/架構條目。
489
489
  - 具有 `Read` 和可選 `Edit` React 元件的瀏覽器塊規範。
490
490
 
491
- 保持方塊 `type` 和 MDX `tag` 穩定。 `type` 以標準化存儲
491
+ 保持方塊 `type` 和 MDX `tag` 穩定。 `type` 以標準化儲存
492
492
  計畫JSON; `tag` 是 `plan.mdx` 中的元件名稱。註冊表句柄
493
493
  基本 MDX 屬性 `id`、`title`、`summary` 和 `editable`,因此不要
494
494
  在 `toAttrs` 中重複它們。
@@ -569,7 +569,7 @@ const riskCardServerBlock = defineBlock<RiskCardData>({
569
569
  Read: ServerReadStub,
570
570
  placement: ["block"],
571
571
  label: "Risk card",
572
- description: "一條 markdown 風險說明,嚴重級別可為 low、medium 或 high。",
572
+ description: "一條 markdown 風險說明,嚴重層級可為 low、medium 或 high。",
573
573
  });
574
574
 
575
575
  export function registerPlanBlocks(registry: BlockRegistry): void {
@@ -621,7 +621,7 @@ const riskCardBlock = defineBlock<RiskCardData>({
621
621
  placement: ["block"],
622
622
  editSurface: "panel",
623
623
  label: "Risk card",
624
- description: "一條 markdown 風險說明,嚴重級別可為 low、medium 或 high。",
624
+ description: "一條 markdown 風險說明,嚴重層級可為 low、medium 或 high。",
625
625
  empty: () => ({ severity: "medium", body: "Describe the risk." }),
626
626
  });
627
627
 
@@ -643,11 +643,11 @@ Token refresh failures can strand active reviewer sessions.
643
643
 
644
644
  伺服器註冊表使該來源可匯入/可匯出,而用戶端
645
645
  註冊表使其在 `PlanBlockView` 中呈現。如果該塊應該由
646
- 特工,保持`label`、`description`、`placement`和`empty`精確;那些
647
- 欄位流入實時塊詞匯表。
646
+ 代理,保持`label`、`description`、`placement`和`empty`精確;那些
647
+ 欄位流入即時塊詞匯表。
648
648
 
649
649
  當覆蓋現有塊時,在共用之後註冊覆蓋
650
- 圖書館註冊。 `type` 和 MDX `tag` 的最後註冊均獲勝。
650
+ 資料庫註冊。 `type` 和 MDX `tag` 的最後註冊均獲勝。
651
651
 
652
652
  新增塊後,執行重點計畫測試:
653
653
 
@@ -658,13 +658,13 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
658
658
  ### 路線圖
659
659
 
660
660
  - `app/routes/plans.$id.tsx` — 計畫編輯/審核介面
661
- - `app/routes/plans._index.tsx` — 計畫列表
661
+ - `app/routes/plans._index.tsx` — 計畫清單
662
662
  - `app/routes/share.$token.tsx` — 公開/共用平面圖
663
663
  - `app/routes/local-plans.$slug.tsx` — 本機檔案模式預覽
664
664
 
665
- ### 本機模式(高級、離線) {#local-mode}
665
+ ### 本機模式(進階、離線) {#local-mode}
666
666
 
667
- 對於完全離線、無帳戶的使用,您可以在本機執行計畫應用程式並將其指向本機 MDX 資料夾。對於更嚴格的無資料庫路徑,請使用 [local-files privacy mode](#local-files),它從 MDX 資料夾讀取而不是建立本機 SQL 行。本機模式是一個單獨的高級路徑 - 不是預設的託管流程。
667
+ 對於完全離線、無帳戶的使用,您可以在本機執行計畫應用程式並將其指向本機 MDX 資料夾。對於更嚴格的無資料庫路徑,請使用 [local-files privacy mode](#local-files),它從 MDX 資料夾讀取而不是建立本機 SQL 行。本機模式是一個單獨的進階路徑 - 不是預設的託管流程。
668
668
 
669
669
  ## 事件和通知 {#events}
670
670
 
@@ -679,7 +679,7 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
679
679
 
680
680
  | 欄位 | 型別 | 描述 |
681
681
  | ----------- | --------------------- | ----------------------------------- |
682
- | `planId` | 字串 | 唯一計畫標識符 |
682
+ | `planId` | 字串 | 唯一計畫識別碼 |
683
683
  | `title` | 字串 | 計畫標題 |
684
684
  | `kind` | `"plan"` \| `"recap"` | 這是計畫還是回顧 |
685
685
  | `status` | 字串 | 初始狀態(例如`"review"`) |
@@ -692,7 +692,7 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
692
692
 
693
693
  | 欄位 | 型別 | 描述 |
694
694
  | ------------------ | -------------------------------- | ----------------------------------------------- |
695
- | `planId` | 字串 | 計畫標識符 |
695
+ | `planId` | 字串 | 計畫識別碼 |
696
696
  | `title` | 字串 | 計畫標題 |
697
697
  | `kind` | `"plan"` \| `"recap"` | 計畫或回顧 |
698
698
  | `commentIds` | 字串[] | 新評論的ID |
@@ -708,10 +708,10 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
708
708
 
709
709
  | 欄位 | 型別 | 描述 |
710
710
  | --------------------- | --------------------- | ------------------------- |
711
- | `planId` | 字串 | 本機計畫標識符 |
711
+ | `planId` | 字串 | 本機計畫識別碼 |
712
712
  | `title` | 字串 | 計畫標題 |
713
713
  | `kind` | `"plan"` \| `"recap"` | 計畫或回顧 |
714
- | `hostedPlanId` | 字串 | 託管計畫標識符 |
714
+ | `hostedPlanId` | 字串 | 託管計畫識別碼 |
715
715
  | `url` | 字串 | 託管計畫的完全公開 URL |
716
716
  | `requestedVisibility` | 字串 | `"public"`、`"private"`等 |
717
717
 
@@ -721,7 +721,7 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
721
721
 
722
722
  | 欄位 | 型別 | 描述 |
723
723
  | ----------- | --------------------- | ---------------- |
724
- | `planId` | 字串 | 計畫標識符 |
724
+ | `planId` | 字串 | 計畫識別碼 |
725
725
  | `title` | 字串 | 計畫標題 |
726
726
  | `kind` | `"plan"` \| `"recap"` | 計畫或回顧 |
727
727
  | `oldStatus` | 字串\| 空 | 之前的狀態 |
@@ -731,15 +731,15 @@ pnpm --filter plan test -- plan-mdx plan-block-registry
731
731
 
732
732
  ### 自動化配方 {#automation-recipes}
733
733
 
734
- 這些自動化是通過詢問計畫代理來建立的 - 無需更改程式碼。
735
- 代理使用 `action=define` 調用 `manage-automations`,寫入
734
+ 這些自動化是透過詢問計畫代理來建立的 - 無需更改程式碼。
735
+ 代理使用 `action=define` 呼叫 `manage-automations`,寫入
736
736
  `jobs/<name>.md`資源,事件訂閱立即開始。
737
737
 
738
- #### 當有人對計畫發表評論時通過 Webhook 進行通知
738
+ #### 當有人對計畫發表評論時透過 Webhook 進行通知
739
739
 
740
740
  詢問計畫代理:
741
741
 
742
- > “當有人對計畫新增人工評論時,POST 會向我的 webhook 發送一條訊息。”
742
+ > “當有人對計畫新增人工評論時,POST 會向我的 webhook 傳送一條訊息。”
743
743
 
744
744
  代理建立這樣的自動化:
745
745
 
@@ -763,26 +763,26 @@ Send a POST request to ${keys.NOTIFY_WEBHOOK} with a JSON body containing:
763
763
 
764
764
  1. 轉到 **設定 → 金鑰** 並使用您的名稱新增名為 `NOTIFY_WEBHOOK` 的金鑰
765
765
  webhook URL(例如 Slack 傳入 webhook、通用 HTTP 端點或任何
766
- 通知服務URL)。
766
+ 通知服務 URL)。
767
767
  2. 可以選取在金鑰上設定 URL 允許清單,以限制其可以存取的來源
768
768
  POST 至。
769
769
 
770
770
  `web-request`工具之前解析了`${keys.NOTIFY_WEBHOOK}`伺服器端
771
- 發送 - 原始 URL 永遠不會出現在代理的上下文中。
771
+ 傳送 - 原始 URL 永遠不會出現在代理的脈絡中。
772
772
 
773
773
  **要專門針對 Slack:** 將 `NOTIFY_WEBHOOK` 設定為您的 Slack 傳入
774
774
  網路鉤子 URL
775
775
  (`https://hooks.slack.com/services/…`)。上面的自動化主體已經
776
- 生成一個有效負載 Slack 的傳入 webhook 通過 `text` 或 `blocks` 接受
777
- 欄位 - 如果您想要更丰富,請代理將內文格式化為 Slack 訊息
776
+ 產生一個有效負載 Slack 的傳入 webhook 透過 `text` 或 `blocks` 接受
777
+ 欄位 - 如果您想要更豐富,請代理將內文格式化為 Slack 訊息
778
778
  格式化。
779
779
 
780
780
  #### 當意見回饋針對編碼代理時喚醒編碼代理
781
781
 
782
782
  對於針對編碼代理 (`resolutionTarget === "agent"`) 的意見回饋,請詢問:
783
783
 
784
- > “當計畫注釋針對代理時,使用該計畫執行我的編碼代理
785
- > 摘錄作為上下文。"
784
+ > “當計畫註解針對代理時,使用該計畫執行我的編碼代理
785
+ > 摘錄作為脈絡。"
786
786
 
787
787
  ```yaml
788
788
  ---
@@ -799,14 +799,14 @@ that new agent-targeted feedback has arrived on plan ${planId}: "${excerpt}".
799
799
  Include the plan path so the agent can navigate directly to it.
800
800
  ```
801
801
 
802
- 因為自動化執行完整的代理循環(`mode: agentic`),所以它可以調用
803
- `web-request`,發送通知或調用代理有權存取的任何操作。
804
- 確切的傳遞機制取決於您擁有的通知渠道
802
+ 因為自動化執行完整的代理迴圈(`mode: agentic`),所以它可以呼叫
803
+ `web-request`,傳送通知或呼叫代理有權存取的任何操作。
804
+ 確切的傳遞機制取決於您擁有的通知管道
805
805
  已設定 - 代理會選取最佳的可用選項。
806
806
 
807
- ## 下一步是什么
807
+ ## 下一步是什麼
808
808
 
809
- - [**PR Visual Recap**](/docs/pr-visual-recap) - 在每個拉取請求上自動執行 `/visual-recap`
809
+ - [**PR Visual Recap**](/docs/pr-visual-recap) - 在每個 pull request 上自動執行 `/visual-recap`
810
810
  - [**Automations**](/docs/automations) — 事件觸發和計畫的自動化
811
811
  - [**Plan plugin & marketplace**](/docs/plan-plugin) — 將計畫 skills 安裝為 Claude 程式碼或 Codex 外掛
812
812
  - [**Skills**](/docs/skills-guide) — Agent-Native 如何安裝 skills