@agent-native/core 0.79.12 → 0.79.15

package/corpus/core/docs/content/locales/zh-TW/components.md

@@ -1,16 +1,16 @@
 ---
-title: "元件API"
-description: "用於自訂代理 UI、聊天欄位、對話呈現、實時狀態、共用、進度和丰富編輯器的公開 React 建置塊。"
+title: "元件 API"
+description: "用於自訂代理 UI、聊天欄位、對話呈現、即時狀態、共用、進度和豐富編輯器的公開 React 建置塊。"
 ---
 
-# 元件API
+# 元件 API
 
 Agent-Native 附帶了完整的側邊欄，但側邊欄不是合同。
-合約是執行時：聊天流、線程狀態、actions、上下文，
-附件、模型選取、執行和 SQL 支持的同步。使用庫存
-當你需要定制產品UI時，可以選取元件，並下拉一層。
+合約是執行時：聊天流、對話串狀態、actions、脈絡，
+附件、模型選取、執行和 SQL 支援的同步。使用庫存
+當你需要定制產品 UI 時，可以選取元件，並下拉一層。
 
-從聚焦的用戶端子路徑匯入瀏覽器UI：
+從聚焦的用戶端子路徑匯入瀏覽器 UI：
 
 ```tsx
 import { AgentSidebar } from "@agent-native/core/client";
@@ -25,23 +25,23 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 `@agent-native/core/client` 或聚焦的 `@agent-native/core/client/*` 子路徑
 因此捆綁商選取瀏覽器安全的條目。
 
-```an-diagram title="下拉一層，不脫離框架" summary="每個層都保持相同的執行時 - 操作、線程狀態和 SQL-backed 同步 - 同時讓您更好地控制鑲邊。"
+```an-diagram title="下拉一層，不脫離框架" summary="每個層都保持相同的執行時 - 操作、對話串狀態和 SQL-backed 同步 - 同時讓您更好地控制鑲邊。"
 {
   "html": "<div class=\"diagram-layers\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><small class=\"diagram-muted\">圍繞應用的完整側邊欄。80% 的常見場景。</small></div><div class=\"diagram-card layer l2\"><span class=\"diagram-pill\">&lt;AgentPanel&gt; &middot; &lt;AgentChatSurface&gt;</span><small class=\"diagram-muted\">你自己布局中的面板或聊天頁面。</small></div><div class=\"diagram-card layer l3\"><span class=\"diagram-pill\">&lt;AssistantChat&gt; + runtime</span><small class=\"diagram-muted\">Own the chrome; optionally pass a BYO AgentChatRuntime.</small></div><div class=\"diagram-card layer l4\"><span class=\"diagram-pill\">&lt;PromptComposer&gt; &middot; &lt;AgentConversation&gt;</span><small class=\"diagram-muted\">撰寫r and transcript primitives only.</small></div><div class=\"diagram-rail\" data-rough>同一 runtime: actions &middot; thread state &middot; SQL-backed sync</div></div>",
   "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px}.diagram-layers .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-layers .l2{margin-inline-start:24px}.diagram-layers .l3{margin-inline-start:48px}.diagram-layers .l4{margin-inline-start:72px}.diagram-layers .diagram-rail{margin-top:6px;padding:10px 14px;text-align:center}"
 }
 ```
 
-## 代理並聊天UI {#agent-chat-ui}
+## 代理並聊天 UI {#agent-chat-ui}
 
 | API                                  | 匯入路徑                                      | 何時使用                                                    |
 | ------------------------------------ | --------------------------------------------- | ----------------------------------------------------------- |
 | `<AgentSidebar>`                     | `@agent-native/core/client` 或 `/client/chat` | 您希望應用程式週圍有完整的側邊欄。                          |
 | `<AgentToggleButton>`                | `@agent-native/core/client` 或 `/client/chat` | 您為側邊欄渲染自己的標題按鈕。                              |
-| `<AgentPanel>`                       | `@agent-native/core/client` 或 `/client/chat` | 您希望在自己的布局、路線、對話框或側欄中顯示完整面板。      |
+| `<AgentPanel>`                       | `@agent-native/core/client` 或 `/client/chat` | 您希望在自己的布局、路由、對話框或側欄中顯示完整面板。      |
 | `<AgentChatSurface>`                 | `@agent-native/core/client` 或 `/client/chat` | 您希望在面板或頁面模式下聊天，而不需要側邊欄包裝。          |
-| `<AssistantChat>`                    | `@agent-native/core/client`或`/client/chat`   | 您希望擁有週圍的鑲邊，同時保持標準對話和作曲家執行時。      |
-| `<MultiTabAssistantChat>`            | `@agent-native/core/client` 或 `/client/chat` | 您希望框架的線程分頁沒有 `AgentPanel` chrome。              |
+| `<AssistantChat>`                    | `@agent-native/core/client`或`/client/chat`   | 您希望擁有週圍的鑲邊，同時保持標準對話和撰寫器執行時。      |
+| `<MultiTabAssistantChat>`            | `@agent-native/core/client` 或 `/client/chat` | 您希望框架的對話串分頁沒有 `AgentPanel` chrome。            |
 | `createHttpAgentChatRuntime()`       | `@agent-native/core/client` 或 `/client/chat` | 您有一個 BYO 代理端點，用於流式傳輸規範化的聊天事件。       |
 | `createOpenAIAgentsChatRuntime()`    | `@agent-native/core/client` 或 `/client/chat` | 您有一個 OpenAI 代理 SDK 流，並希望圍繞它進行標準聊天 UI。  |
 | `createOpenAIResponsesChatRuntime()` | `@agent-native/core/client` 或 `/client/chat` | 您有一個 OpenAI 回應事件流，並希望將其規範化到聊天 UI 中。  |
@@ -49,20 +49,20 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 | `createClaudeAgentChatRuntime()`     | `@agent-native/core/client`或`/client/chat`   | 您有一個 Claude 代理 SDK 流，並希望將其規範化到聊天 UI 中。 |
 | `createVercelAiChatRuntime()`        | `@agent-native/core/client` 或 `/client/chat` | 您有一個 Vercel AI SDK 流，並希望將其規範化到聊天 UI 中。   |
 | `createAgentChatRuntimeAdapter()`    | `@agent-native/core/client` 或 `/client/chat` | 需要自己將一個`AgentChatRuntime`適配成assistant-ui。        |
-| `createAgentChatAdapter()`           | `@agent-native/core/client` 或 `/client/chat` | 您需要內置 Agent-Native SSE 傳輸作為低級助手 UI 適配器。    |
-| `useChatThreads()`                   | `@agent-native/core/client`或`/client/chat`   | 您需要自訂話題列表、歷史紀錄選取器或範圍聊天 UI。           |
+| `createAgentChatAdapter()`           | `@agent-native/core/client` 或 `/client/chat` | 您需要內建 Agent-Native SSE 傳輸作為低階助手 UI 轉接器。    |
+| `useChatThreads()`                   | `@agent-native/core/client`或`/client/chat`   | 您需要自訂話題清單、歷史紀錄選取器或範圍聊天 UI。           |
 | `sendToAgentChat()`                  | `@agent-native/core/client` 或 `/client/chat` | 產品操作應該將工作交給代理聊天。                            |
 
-`AgentChatRuntime` 是標準聊天 shell 的 BYO 代理合約。通過
+`AgentChatRuntime` 是標準聊天 shell 的 BYO 代理合約。透過
 當外部代理應該為 `runtime` 到 `<AssistantChat>` 供電時
-Agent-Native 保留作曲家、文字紀錄、工具卡和
-本機小部件渲染。上面的連線器是API面；執行時
+Agent-Native 保留撰寫器、文字紀錄、工具卡和
+本機小工具渲染。上面的連線器是 API 面；執行時
 合同和事件形狀在中教授
 [Native 聊天介面 — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
-如果您在無頭代理、丰富聊天、嵌入式 sidecar 之間進行選取
+如果您在無頭代理、豐富聊天、嵌入式 sidecar 之間進行選取
 完整的應用形狀，請參閱 [Agent Surfaces](/docs/agent-surfaces)。
 
-最短的自訂路線仍然是預接線表面：
+最短的自訂路由仍然是預接線表面：
 
 ```tsx
 import { AgentChatSurface } from "@agent-native/core/client/chat";
@@ -100,18 +100,18 @@ function CustomChat({ projectSlug }: { projectSlug: string }) {
 連線器使用情況、標準化事件流以及何時到達
 `createHttpAgentChatRuntime()` 與特定於協議的連線器。
 
-## 聊天欄位和作曲家 {#composer}
+## 聊天欄位和撰寫器 {#composer}
 
 當您需要進行相同的聊天時，請使用`@agent-native/core/client/composer`
-自訂UI內的側邊欄使用的欄位。
+自訂 UI 內的側邊欄使用的欄位。
 
 | API                               | 何時使用                                                                                                       |
 | --------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `<PromptComposer>`                | 您需要一個隨時可以提交的聊天欄位，其中包含附件、斜線指令、參考、貼上文本處理、草稿持久性、語音輸入和提交語義。 |
+| `<PromptComposer>`                | 您需要一個隨時可以提交的聊天欄位，其中包含附件、斜線指令、參考、貼上文字處理、草稿持久性、語音輸入和提交語義。 |
 | `<AgentComposerFrame>`            | 您需要自訂 撰寫r 主體週圍的標準視覺外殼。                                                                      |
-| `<TiptapComposer>`                | 您需要最低級別的丰富聊天欄位。它必須在 Assistant-ui `ThreadPrimitive.Root` / 撰寫r 執行時內呈現。              |
-| `buildPromptComposerSubmission()` | 在調用您自己的提交處理程序之前，您需要相同的附件和貼上文本規範化。                                             |
-| `formatPromptWithAttachments()`   | 您需要將隱藏的附件元資料呈現到提示字串中。                                                                     |
+| `<TiptapComposer>`                | 您需要最低階別的豐富聊天欄位。它必須在 Assistant-ui `ThreadPrimitive.Root` / 撰寫r 執行時內呈現。              |
+| `buildPromptComposerSubmission()` | 在呼叫您自己的提交處理常式之前，您需要相同的附件和貼上文字規範化。                                             |
+| `formatPromptWithAttachments()`   | 您需要將隱藏的附件中繼資料呈現到提示字串中。                                                                   |
 
 大多數自訂 UI 應以 `PromptComposer` 開頭：
 
@@ -136,19 +136,19 @@ import { PromptComposer } from "@agent-native/core/client/composer";
 
 | API                                             | 何時使用                             |
 | ----------------------------------------------- | ------------------------------------ |
-| `<AgentConversation>`                           | 呈現標準化代理訊息列表。             |
+| `<AgentConversation>`                           | 呈現標準化代理訊息清單。             |
 | `<AgentConversationMessageView>`                | 渲染一條標準化訊息。                 |
 | `normalizeCodeAgentTranscriptForConversation()` | 將程式碼代理轉錄事件轉換為對話訊息。 |
-| `useNearBottomAutoscroll()`                     | 在流式傳輸時將自訂腳本固定在底部。   |
+| `useNearBottomAutoscroll()`                     | 在流式傳輸時將自訂指令碼固定在底部。 |
 
 這一層有意做到資料優先：您擁有訊息的來源，並且
 渲染器擁有一致的降價、附件、通知、工件和
-工具調用顯示。
+工具呼叫顯示。
 
-## 本機工具小部件 {#native-tool-widgets}
+## 本機工具小工具 {#native-tool-widgets}
 
-當操作結果應呈現為應用品質 UI 時，請使用本機工具小部件
-內部聊天而不是普通的 JSON。內置可重複使用的輸出包括
+當操作結果應呈現為應用品質 UI 時，請使用本機工具小工具
+內部聊天而不是普通的 JSON。內建可重複使用的輸出包括
 `DataTableWidget`、`DataChartWidget` 和 `DataWidgetResult`；它們被匯出
 來自 `@agent-native/core/client/chat` 和根用戶端條目。請參閱
 [Native 聊天介面](/docs/native-chat-ui) 表示操作結果合約。
@@ -162,23 +162,23 @@ import { PromptComposer } from "@agent-native/core/client/composer";
 | `registerToolRenderer()`         | 您需要特定於產品的本機渲染器來獲得非核心工具結果。                            |
 | `registerReservedToolRenderer()` | 框架程式碼需要一個保留的渲染器，該渲染器在範本渲染器之前獲勝。                |
 
-## 實時協作和線上狀態 {#collab-presence}
+## 即時協作和線上狀態 {#collab-presence}
 
 使用 `@agent-native/core/client/collab` 實現 Liveblocks 式的呈現效果
 協作檔案掛鉤。
 
 | API                                                 | 何時使用                                                          |
 | --------------------------------------------------- | ----------------------------------------------------------------- |
-| `useCollaborativeDoc()`                             | 將富文本編輯器或自訂 Yjs 介面綁定到 `/_agent-native/collab`。     |
-| `usePresence()`                                     | 發布並渲染任意感知欄位：光標、選取、視口、模式。                  |
+| `useCollaborativeDoc()`                             | 將富文字編輯器或自訂 Yjs 介面綁定到 `/_agent-native/collab`。     |
+| `usePresence()`                                     | 發布並渲染任意感知欄位：游標、選取、視口、模式。                  |
 | `<PresenceBar>`                                     | 顯示活躍的人類和代理協作者。                                      |
-| `<LiveCursorOverlay>`                               | 在定位的容器上渲染遠端光標標籤。                                  |
+| `<LiveCursorOverlay>`                               | 在定位的容器上渲染遠端游標標籤。                                  |
 | `<RemoteSelectionRings>`                            | 在 DOM 元素上渲染遠端選取輪廓。                                   |
 | `useFollowUser()`                                   | 跟隨其他參與者的視口或選取。                                      |
-| `useCollaborativeMap()` / `useCollaborativeArray()` | 當富文本內文協作不合適時，使用結構化 Y.Map/Y.Array 狀態進行實驗。 |
+| `useCollaborativeMap()` / `useCollaborativeArray()` | 當富文字內文協作不合適時，使用結構化 Y.Map/Y.Array 狀態進行實驗。 |
 | `dedupeCollabUsersByEmail()`                        | 為同一使用者建置一個沒有重複分頁的自訂頭像堆堆疊。                |
 
-```an-diagram title="存在：人類和智能體共用一個意識層" summary="useCollaborativeDoc 擁有感知執行個體；用戶端掛鉤發布光標和選取；伺服器助手讓代理操作顯示為實時參與者。"
+```an-diagram title="存在：人類和智慧體共用一個意識層" summary="useCollaborativeDoc 擁有感知執行個體；用戶端掛鉤發布游標和選取；伺服器助手讓代理操作顯示為即時參與者。"
 {
   "html": "<div class=\"diagram-presence\"><div class=\"diagram-col\"><div class=\"diagram-node\">Humans<br><small class=\"diagram-muted\">usePresence &middot; cursors, selection</small></div><div class=\"diagram-node diagram-accent\">Agent 操作<br><small class=\"diagram-muted\">agentUpdateSelection()</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">useCollaborativeDoc</span><small class=\"diagram-muted\">awareness layer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;PresenceBar&gt; &middot; &lt;LiveCursorOverlay&gt;<br><small class=\"diagram-muted\">渲染所有人，包括代理</small></div></div>",
   "css": ".diagram-presence{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-presence .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-presence .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-presence .diagram-arrow{font-size:22px;line-height:1}"
@@ -186,7 +186,7 @@ import { PromptComposer } from "@agent-native/core/client/composer";
 ```
 
 想要作為現場參與者出現的伺服器端代理 actions 使用
-較低級別的 `@agent-native/core/collab` 代理存在助手：
+較低階別的 `@agent-native/core/collab` 代理存在助手：
 
 ```ts
 import {
@@ -196,7 +196,7 @@ import {
 } from "@agent-native/core/collab";
 ```
 
-## 丰富的編輯器 {#rich-editor}
+## 豐富的編輯器 {#rich-editor}
 
 當需要共用markdown編輯器時使用`@agent-native/core/client/editor`
 計畫、內容、資源和協作檔案使用的表面
@@ -205,11 +205,11 @@ import {
 | API                              | 何時使用                                                                  |
 | -------------------------------- | ------------------------------------------------------------------------- |
 | `<SharedRichEditor>`             | 您需要具有 Markdown 序列化、可選 Yjs 和應用附加功能的目前可設定編輯器。   |
-| `<RichMarkdownEditor>`           | 您需要共用丰富編輯器的向後兼容別名。                                      |
+| `<RichMarkdownEditor>`           | 您需要共用豐富編輯器的向後相容別名。                                      |
 | `createSharedEditorExtensions()` | 您正在建置自己的 Tiptap 編輯器，但需要框架架構和 Markdown 方言。          |
 | `<SlashCommandMenu>`             | 您需要共用斜線指令 UI 來建立自訂 Tiptap 表面。                            |
-| `<BubbleToolbar>`                | 您需要用於標記、連結和自訂內聯 actions 的共用選取工具列。                 |
-| `createRegistryBlockNode()`      | 您需要在丰富的編輯器中提供註冊表支持的塊節點。                            |
+| `<BubbleToolbar>`                | 您需要用於標記、連結和自訂行內 actions 的共用選取工具列。                 |
+| `createRegistryBlockNode()`      | 您需要在豐富的編輯器中提供註冊表支援的塊節點。                            |
 | `uploadEditorImage()`            | 您希望框架上傳圖片操作位於編輯器的共用圖片塊後面。                        |
 | `useCollabReconcile()`           | 您正在將自訂編輯器介面綁定到 Yjs 檔案，同時將 Markdown 保留為已儲存狀態。 |
 
@@ -226,7 +226,7 @@ import { SharedRichEditor } from "@agent-native/core/client/editor";
 />;
 ```
 
-對於實時編輯，請將其與協作子路徑配對：
+對於即時編輯，請將其與協作子路徑配對：
 
 ```tsx
 import {
@@ -257,7 +257,7 @@ const collab = useCollaborativeDoc({
 ## 工作區資源 {#resources}
 
 當您想要公開相同的內容時，請使用 `@agent-native/core/client/resources`
-為代理面板的“工作空間”分頁提供支持的工作空間資源模型。
+為代理面板的“工作空間”分頁提供支援的工作空間資源模型。
 
 | API                                                                   | 何時使用                                             |
 | --------------------------------------------------------------------- | ---------------------------------------------------- |
@@ -265,9 +265,9 @@ const collab = useCollaborativeDoc({
 | `<ResourceTree>`                                                      | 您想要圍繞框架資料渲染您自己的資源瀏覽器。           |
 | `<ResourceEditor>`                                                    | 您需要所選資源的框架編輯器。                         |
 | `useResourceTree()`                                                   | 您需要一個用於個人、共用或工作區資源的作用域樹。     |
-| `useResource()`                                                       | 您需要一項選定資源的內容和元資料。                   |
+| `useResource()`                                                       | 您需要一項選定資源的內容和中繼資料。                 |
 | `useCreateResource()` / `useUpdateResource()` / `useDeleteResource()` | 您需要圍繞資源生命週期進行自訂控制。                 |
-| `useUploadResource()`                                                 | 您需要將檔案上傳到框架資源存儲中。                   |
+| `useUploadResource()`                                                 | 您需要將檔案上傳到框架資源儲存中。                   |
 
 完整的面板不需要道具：
 
@@ -320,7 +320,7 @@ function WorkspaceResources() {
 }
 ```
 
-## 其他公開UI {#other-ui}
+## 其他公開 UI {#other-ui}
 
 | 區域         | APIs                                                  | 匯入路徑                                  |
 | ------------ | ----------------------------------------------------- | ----------------------------------------- |
@@ -330,13 +330,13 @@ function WorkspaceResources() {
 | 入職         | `useOnboarding()`，入門面板掛鉤                       | `@agent-native/core/client/onboarding`    |
 | 可觀察性     | `<ObservabilityDashboard>`, `<ThumbsFeedback>`        | `@agent-native/core/client/observability` |
 | 資源         | `<ResourcesPanel>`、`<ResourceTree>`、資源掛鉤        | `@agent-native/core/client/resources`     |
-| 丰富的編輯器 | `<SharedRichEditor>`，斜杠指令，塊節點掛鉤            | `@agent-native/core/client/editor`        |
+| 豐富的編輯器 | `<SharedRichEditor>`，斜杠指令，塊節點掛鉤            | `@agent-native/core/client/editor`        |
 
-## 一次性文本完成 {#one-off-text-completion}
+## 一次性文字完成 {#one-off-text-completion}
 
-如果您確實需要原始文本輸入/文本輸出，請將其保留在伺服器端並使用
+如果您確實需要原始文字輸入/文字輸出，請將其保留在伺服器端並使用
 `completeText()` 來自 `@agent-native/core/server`。將面向使用者的用法包裝在
-采取行動，使 UI 和代理共用相同的功能。
+採取行動，使 UI 和代理共用相同的功能。
 
 ```an-callout
 {

package/corpus/core/docs/content/locales/zh-TW/context-awareness.md

@@ -1,56 +1,56 @@
 ---
 title: "情境意識"
-description: "代理如何知道使用者正在檢視的內容：導覽狀態、選取上下文、視圖螢幕、sendToAgentChat 切換、導覽指令和抖動預防。"
+description: "代理如何知道使用者正在檢視的內容：導覽狀態、選取脈絡、檢視螢幕、sendToAgentChat 切換、導覽指令和抖動預防。"
 ---
 
 # 情境意識
 
-> **開發人員頁面。** 此頁面供開發人員連線應用程式的上下文層。對於最終使用者體驗 - 代理如何在對話中使用該上下文 - 請參閱 [Using Your Agent](/docs/using-your-agent)。
+> **開發人員頁面。** 此頁面供開發人員連線應用程式的脈絡層。對於最終使用者體驗 - 代理如何在對話中使用該脈絡 - 請參閱 [Using Your Agent](/docs/using-your-agent)。
 
-代理如何知道使用者正在看什么——以及代理如何控制使用者看到的內容。
+代理如何知道使用者正在看什麼——以及代理如何控制使用者看到的內容。
 
 ## 概述 {#overview}
 
-如果沒有上下文感知，代理就是盲目的。它詢問“哪個電子郵件？”當使用者盯著一個時。它無法作用於目前的選取，無法提供相關建議，也無法修改使用者所看到的內容。借助上下文感知，使用者可以點選一行、突出顯示一個段落、選取一個幻燈片元素或按 Cmd+I，然後說“總結一下”，然後代理就已經知道“這個”的含義。
+如果沒有脈絡感知，代理就是盲目的。它詢問“哪個電子郵件？”當使用者盯著一個時。它無法作用於目前的選取，無法提供相關建議，也無法修改使用者所看到的內容。借助脈絡感知，使用者可以點選一行、突出顯示一個段落、選取一個幻燈片元素或按 Cmd+I，然後說“總結一下”，然後代理就已經知道“這個”的含義。
 
-要了解在哪個曲面中放置什么內容（AGENTS.md、skills、application_state），請參閱 [Writing Agent Instructions — The four surfaces the agent sees](/docs/writing-agent-instructions#four-surfaces)。
+要了解在哪個曲面中放置什麼內容（AGENTS.md、skills、application_state），請參閱 [Writing Agent Instructions — The four surfaces the agent sees](/docs/writing-agent-instructions#four-surfaces)。
 
 六種模式解決了這個問題：
 
-1. **導覽狀態**——UI 在每次路線更改時將 `navigation` 金鑰寫入應用程式狀態
+1. **導覽狀態**——UI 在每次路由更改時將 `navigation` 金鑰寫入應用程式狀態
 2. **目前 URL** - 框架寫入 `__url__`，因此查詢參數對代理可見且可編輯
 3. **選取狀態**——當使用者聚焦、選取或多選有意義的內容時，UI 會寫入 `selection` 鍵
-4. **`view-screen`**——讀取應用程式狀態、獲取上下文資料並返回使用者所見內容的快照的操作
-5. **提示切換** -- 當點擊應成為代理輪次時，UI 控件調用 `sendToAgentChat()`
+4. **`view-screen`**——讀取應用程式狀態、取得脈絡資料並返回使用者所見內容的快照的操作
+5. **提示切換** -- 當點選應成為代理輪次時，UI 控制項呼叫 `sendToAgentChat()`
 6. **`navigate`**——來自代理的一次性指令，告訴 UI 去哪裡
 
-```an-diagram title="代理如何看到您所看到的內容" summary="UI編寫輕量級狀態鍵；螢幕將它們轉化為真實的紀錄；代理可以編寫導覽返回來行動 UI。"
+```an-diagram title="代理如何看到您所看到的內容" summary="UI 編寫輕量級狀態鍵；螢幕將它們轉化為真實的紀錄；代理可以編寫導覽返回來行動 UI。"
 {
-  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">UI 寫入</span><div class=\"diagram-node\">navigation<br><small class=\"diagram-muted\">視圖、開啟的 ID</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">shareable filters</small></div><div class=\"diagram-node\">selection<br><small class=\"diagram-muted\">行、塊、形狀</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">view-screen</span><small class=\"diagram-muted\">reads state &middot; fetches records</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">代理執行<br><small class=\"diagram-muted\">on the real object</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">navigate<br><small class=\"diagram-muted\">代理行動 UI</small></div></div>",
+  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">UI 寫入</span><div class=\"diagram-node\">navigation<br><small class=\"diagram-muted\">檢視、開啟的 ID</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">shareable filters</small></div><div class=\"diagram-node\">selection<br><small class=\"diagram-muted\">行、塊、形狀</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">view-screen</span><small class=\"diagram-muted\">reads state &middot; fetches records</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">代理執行<br><small class=\"diagram-muted\">on the real object</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">navigate<br><small class=\"diagram-muted\">代理行動 UI</small></div></div>",
   "css": ".diagram-ctx{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-ctx .col{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-ctx .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-ctx .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
-## 上下文層 {#context-layers}
+## 脈絡層 {#context-layers}
 
-針對不同的作業使用不同的上下文通道：
+針對不同的作業使用不同的脈絡通道：
 
 | 層                                       | 所有者            | 用它來                                                       |
 | ---------------------------------------- | ----------------- | ------------------------------------------------------------ |
-| `navigation` 應用狀態金鑰                | UI                | 語義路由狀態：目前視圖、開啟的紀錄、活動分頁、穩定 ID        |
-| `__url__` 應用狀態金鑰                   | 框架UI            | 目前路徑名、搜尋字串、哈希和解析的 URL 查詢參數              |
+| `navigation` 應用狀態金鑰                | UI                | 語義路由狀態：目前檢視、開啟的紀錄、活動分頁、穩定 ID        |
+| `__url__` 應用狀態金鑰                   | 框架 UI           | 目前路徑名、搜尋字串、哈希和解析的 URL 查詢參數              |
 | `__set_url__` 應用狀態金鑰               | 代理/框架         | 對 `set-search-params` 和 `set-url-path` 進行一次性 URL 編輯 |
 | `selection` 應用狀態金鑰                 | UI                | 持久的語義選取：行、塊、形狀、資產、訊息                     |
-| `pending-selection-context` 應用狀態金鑰 | UI / `AgentPanel` | 一次性選取的文本附加到下一個聊天回合，通常來自 Cmd+I         |
+| `pending-selection-context` 應用狀態金鑰 | UI / `AgentPanel` | 一次性選取的文字附加到下一個聊天回合，通常來自 Cmd+I         |
 | `view-screen` 動作                       | 代理              | 將應用狀態鍵融入真實紀錄和螢幕摘要                           |
-| `sendToAgentChat()`                      | UI                | 將點擊、指令、評論圖釘或所選專案轉變為聊天提示               |
-| `navigate` 應用狀態金鑰                  | 代理              | 要求UI行動到另一條路線或聚焦另一個物體                       |
+| `sendToAgentChat()`                      | UI                | 將點選、指令、評論圖釘或所選專案轉變為聊天提示               |
+| `navigate` 應用狀態金鑰                  | 代理              | 要求 UI 行動到另一條路由或聚焦另一個物體                     |
 
-簡短版本：URL 查詢參數是可共用過濾器的真實來源，`navigation` 存儲語義 ID 和視圖名稱，`view-screen` 將這些狀態層轉換為有用的資料，而當使用者點選指令時，`sendToAgentChat()` 將 UI 意圖轉換為聊天訊息。
+簡短版本：URL 查詢參數是可共用過濾器的真實來源，`navigation` 儲存語義 ID 和檢視名稱，`view-screen` 將這些狀態層轉換為有用的資料，而當使用者點選指令時，`sendToAgentChat()` 將 UI 意圖轉換為聊天訊息。
 
 ## 導覽狀態 {#navigation-state}
 
-UI 在每次路由更改時將 `navigation` 金鑰寫入應用程式狀態。這告訴代理使用者正在使用哪個視圖、開啟哪個專案以及哪個語義 UI 狀態很重要。
+UI 在每次路由更改時將 `navigation` 金鑰寫入應用程式狀態。這告訴代理使用者正在使用哪個檢視、開啟哪個專案以及哪個語義 UI 狀態很重要。
 
 ```json
 {
@@ -68,7 +68,7 @@ UI 在每次路由更改時將 `navigation` 金鑰寫入應用程式狀態。這
 - 語義別名 - 活動分頁、標籤名稱或其他有助於代理推理的穩定應用概念
 - 輕焦點狀態 - 聚焦行、活動分頁、目前面板
 
-保持 `navigation` 小且語義化。它應該識別目前螢幕，而不是複製整個紀錄或鏡像每個查詢參數。獲取 `view-screen` 中的紀錄，以便代理始終獲取最新資料。
+保持 `navigation` 小且語義化。它應該識別目前螢幕，而不是複製整個紀錄或鏡像每個查詢參數。取得 `view-screen` 中的紀錄，以便代理始終取得最新資料。
 
 代理在行動前閱讀以下內容：
 
@@ -79,9 +79,9 @@ const navigation = await readAppState("navigation");
 // { view: "inbox", threadId: "thread-123", label: "important" }
 ```
 
-## 目前URL和過濾器 {#current-url}
+## 目前 URL 和過濾器 {#current-url}
 
-`AgentPanel` 自動將目前 React 路由器 URL 同步到 `__url__` 應用程式狀態金鑰中。內置代理每次都會將其包含為 `<current-url>` 塊：
+`AgentPanel` 自動將目前 React 路由器 URL 同步到 `__url__` 應用程式狀態金鑰中。內建代理每次都會將其包含為 `<current-url>` 塊：
 
 ```text
 <current-url>
@@ -93,15 +93,15 @@ searchParams:
 </current-url>
 ```
 
-這是可共用過濾器狀態的規範層。如果使用者可以複製 URL 並返回到相同的過濾列表，則該過濾器屬於查詢字串。代理可以使用內置的 `set-search-params` 工具更改這些過濾器：
+這是可共用過濾器狀態的規範層。如果使用者可以複製 URL 並返回到相同的過濾清單，則該過濾器屬於查詢字串。代理可以使用內建的 `set-search-params` 工具更改這些過濾器：
 
 ```text
 set-search-params({ "params": { "f_region": "east", "q": null } })
 ```
 
-僅將 `navigation` 用於幫助 `view-screen` 獲取或匯總正確資料的語義別名。儀表板可能保留 `navigation.dashboardId`，而 `__url__.searchParams` 擁有 `f_region`、`f_dateStart` 和 `q`。
+僅將 `navigation` 用於幫助 `view-screen` 取得或匯總正確資料的語義別名。儀表板可能保留 `navigation.dashboardId`，而 `__url__.searchParams` 擁有 `f_region`、`f_dateStart` 和 `q`。
 
-當`view-screen`返回更丰富的快照時，它可以將重要的URL過濾器複製到友好的`activeFilters`物件中：
+當`view-screen`返回更豐富的快照時，它可以將重要的 URL 過濾器複製到友好的`activeFilters`物件中：
 
 ```ts
 const url = (await readAppState("__url__")) as {
@@ -119,9 +119,9 @@ if (url?.searchParams) {
 
 ## 選取狀態 {#selection-state}
 
-選取是語義 UI 狀態。這就是“我點選的圖表”、“這三行”、“這張幻燈片標題”或“目前電子郵件草稿範圍”如何成為模型可見上下文的方式。
+選取是語義 UI 狀態。這就是“我點選的圖表”、“這三行”、“這張幻燈片標題”或“目前電子郵件草稿範圍”如何成為模型可見脈絡的方式。
 
-使用 `selection` 應用狀態鍵進行持久選取，該選取應該在導覽、空聊天建議或稍後的 `view-screen` 調用中保留下來：
+使用 `selection` 應用狀態鍵進行持久選取，該選取應該在導覽、空聊天建議或稍後的 `view-screen` 呼叫中保留下來：
 
 ```json
 {
@@ -154,21 +154,21 @@ async function syncSelection(selection: unknown | null) {
 
 - 代理可以在 actions 中使用的穩定 ID，例如 `threadId`、`slideId` 或 `assetId`
 - 簡短的人工標籤，以便提示和建議易於閱讀
-- 足夠的文本或元資料來消除物件的歧義
+- 足夠的文字或中繼資料來消除物件的歧義
 - 可選的 UI 定位器，例如代理需要引用視覺元素時的選取器或坐標
 - `capturedAt` 當過時的選取有害時
 
-避免在 `selection` 中存儲機密、完整檔案、大型二進制有效負載或整個 API 回應。存儲 ID 和簡短摘錄，然後讓 `view-screen` 獲取目前的事實來源。
+避免在 `selection` 中儲存機密、完整檔案、大型二進制有效負載或整個 API 回應。儲存 ID 和簡短摘錄，然後讓 `view-screen` 取得目前的事實來源。
 
-### 一次性選定文本 {#pending-selection-context}
+### 一次性選定文字 {#pending-selection-context}
 
-`AgentPanel` 已經處理常見的文本選取流程。當使用者在頁面上選取文本的情況下按 Cmd+I（或 Ctrl+I）時，它：
+`AgentPanel` 已經處理常見的文字選取流程。當使用者在頁面上選取文字的情況下按 Cmd+I（或 Ctrl+I）時，它：
 
 1. 讀取`window.getSelection()`
 2. 將 `{ text, capturedAt }` 寫入 `pending-selection-context`
-3. 聚焦客服人員聊天
+3. 聚焦代理聊天
 
-正式環境代理將該金鑰作為立即選取上下文注入下一回合，並在其過時後忽略它。這是使“選取文本，按 Cmd+I，詢問‘使其更加有力’”工作的路徑，而無需使用者將選取內容複製到提示中。
+正式環境代理將該金鑰作為立即選取脈絡注入下一回合，並在其過時後忽略它。這是使“選取文字，按 Cmd+I，詢問‘使其更加有力’”工作的路徑，而無需使用者將選取內容複製到提示中。
 
 當自訂編輯器的選取不由本機瀏覽器選取表示時，可以編寫相同的鍵：
 
@@ -185,38 +185,38 @@ await setClientAppState(
 );
 ```
 
-使用 `pending-selection-context` 一次性“對這個精確突出顯示的文本進行操作”流程。使用 `selection` 進行持久物件選取，`view-screen` 和動態建議應該不斷看到。
+使用 `pending-selection-context` 一次性“對這個精確突出顯示的文字進行操作”流程。使用 `selection` 進行持久物件選取，`view-screen` 和動態建議應該不斷看到。
 
 ## 檢視螢幕操作 {#view-screen-action}
 
-每個範本都應該有一個 `view-screen` 操作。它讀取導覽和選取狀態，獲取相關資料，並返回使用者所看到內容的快照。這是特工的眼睛。
+每個範本都應該有一個 `view-screen` 操作。它讀取導覽和選取狀態，取得相關資料，並返回使用者所看到內容的快照。這是代理的眼睛。
 
-```an-annotated-code title="檢視螢幕 — 特工的眼睛"
+```an-annotated-code title="檢視螢幕 — 代理的眼睛"
 {
   "filename": "actions/view-screen.ts",
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { readAppState } from \"@agent-native/core/application-state\";\nimport { eq, inArray } from \"drizzle-orm\";\nimport { z } from \"zod\";\nimport { getDb, schema } from \"../server/db/index.js\";\n\nexport default defineAction({\n  description:\n    \"See what the user is currently looking at on screen.\",\n  schema: z.object({}),\n  http: false,\n  run: async () => {\n    const navigation = (await readAppState(\"navigation\")) as any;\n    const selection = (await readAppState(\"selection\")) as any;\n    const screen: Record<string, unknown> = {};\n    if (navigation) screen.navigation = navigation;\n    if (selection) screen.selection = selection;\n\n    const db = getDb();\n\n    // Fetch data based on what the user is viewing\n    if (navigation?.view === \"inbox\") {\n      screen.emailList = await db\n        .select()\n        .from(schema.emails)\n        .where(eq(schema.emails.label, navigation.label));\n    }\n    if (navigation?.threadId) {\n      screen.thread = await db\n        .select()\n        .from(schema.threads)\n        .where(eq(schema.threads.id, navigation.threadId));\n    }\n    if (selection?.kind === \"email.messages\") {\n      screen.selectedMessages = await db\n        .select()\n        .from(schema.emails)\n        .where(inArray(schema.emails.id, selection.messageIds));\n    }\n\n    if (Object.keys(screen).length === 0) {\n      return \"No application state found. Is the app running?\";\n    }\n    return screen;\n  },\n});",
   "annotations": [
-    { "lines": "10-11", "label": "工具表面", "note": "代理讀取此描述，知道它可以調用 `view-screen` 來檢視目前的 UI。" },
-    { "lines": "13", "label": "http: false", "note": "內部操作 - 未通過 HTTP 暴露。代理和 `pnpm action` 調用它，而不是瀏覽器。" },
+    { "lines": "10-11", "label": "工具表面", "note": "代理讀取此描述，知道它可以呼叫 `view-screen` 來檢視目前的 UI。" },
+    { "lines": "13", "label": "http: false", "note": "內部操作 - 未通過 HTTP 暴露。代理和 `pnpm action` 呼叫它，而不是瀏覽器。" },
     { "lines": "15-16", "label": "讀取狀態", "note": "拉取 UI 編寫的輕量級 `navigation` 和 `selection` 鍵。" },
     { "lines": "23-37", "label": "水合物", "note": "將這些 ID 直接從 SQL 轉換為**新鮮**紀錄，以便代理在執行操作之前驗證活動物件。" }
   ]
 }
 ```
 
-代理應在對目前 UI 進行操作之前調用 `pnpm action view-screen`。這是所有範本的硬約定。新增新功能時，更新 `view-screen` 以返回新視圖和任何新選取形狀的資料。
+代理應在對目前 UI 進行操作之前呼叫 `pnpm action view-screen`。這是所有範本的硬約定。新增新功能時，更新 `view-screen` 以返回新檢視和任何新選取形狀的資料。
 
 ```an-callout
 {
   "tone": "info",
-  "body": "**保持 `navigation` 和 `selection` 小。**商店 ID 加上短標籤，而不是整個紀錄。 `view-screen` 根據需要獲取事實來源，因此陳舊或龐大的狀態永遠不會到達代理。"
+  "body": "**保持 `navigation` 和 `selection` 小。**商店 ID 加上短標籤，而不是整個紀錄。 `view-screen` 根據需要取得事實來源，因此陳舊或龐大的狀態永遠不會到達代理。"
 }
 ```
 
 ## 與 `sendToAgentChat()` 快速切換 {#send-to-agent-chat}
 
-有時上下文不應該僅僅處於應用程式狀態。使用者點選按鈕、放下評論圖釘、選取專案並選取“詢問代理”，或者按下工具列中的 AI 指令。那次點擊是一個指令。在瀏覽器UI中，將其交給帶有`sendToAgentChat()`的代理。
+有時脈絡不應該僅僅處於應用程式狀態。使用者點選按鈕、放下評論圖釘、選取專案並選取“詢問代理”，或者按下工具列中的 AI 指令。那次點選是一個指令。在瀏覽器 UI 中，將其交給帶有`sendToAgentChat()`的代理。
 
 ```tsx
 import { sendToAgentChat } from "@agent-native/core/client";
@@ -245,32 +245,32 @@ function askAgentAboutSelection(selection: {
 
 | 欄位                | 含義                                                     |
 | ------------------- | -------------------------------------------------------- |
-| `message`           | 聊天中顯示可見的提示文本                                 |
-| `context`           | 隱藏的模型可見上下文，不顯示為面向使用者的聊天文本       |
-| `submit: true`      | 立即發送；適用於顯式指令按鈕，例如“修複布局”             |
+| `message`           | 聊天中顯示可見的提示文字                                 |
+| `context`           | 隱藏的模型可見脈絡，不顯示為面向使用者的聊天文字         |
+| `submit: true`      | 立即傳送；適用於顯式指令按鈕，例如“修復布局”             |
 | `submit: false`     | 預填以供使用者審核；適合“向代理詢問此事”或模棱兩可的選取 |
 | `openSidebar: true` | 即使面板折疊，代理回應也可見                             |
-| `newTab: true`      | 為更大的建立工作啟動單獨的聊天線程                       |
+| `newTab: true`      | 為更大的建立工作啟動單獨的聊天對話串                     |
 | `type: "code"`      | 當請求涉及更改應用程式來源時路由到程式碼編輯框架         |
 
-`sendToAgentChat()` 是提交的聊天路徑受支持的瀏覽器包裝器，有時在內部被視為 `agentNative.submitChat`。應用程式 UI 應調用包裝器，而不是直接發布 `agentNative.submitChat`，因為包裝器處理本機側邊欄、Builder/Frame 路由、MCP 應用程式主機路由、分頁 ID 和程式碼請求路由。
+`sendToAgentChat()` 是提交的聊天路徑受支援的瀏覽器包裝器，有時在內部被視為 `agentNative.submitChat`。應用程式 UI 應呼叫包裝器，而不是直接發布 `agentNative.submitChat`，因為包裝器處理本機側邊欄、Builder/Frame 路由、MCP 應用程式主機路由、分頁 ID 和程式碼請求路由。
 
-對於沒有瀏覽器側邊欄的節點/腳本上下文，請使用 `agentChat.submit()` 或 `agentChat.prefill()`。伺服器actions一般不應該調用僅瀏覽器的`sendToAgentChat()`；如果某個操作需要開啟 UI 向代理詢問某些內容，請將一個小請求寫入 `application_state` 並讓 UI 橋接器從瀏覽器發送它。
+對於沒有瀏覽器側邊欄的節點/指令碼脈絡，請使用 `agentChat.submit()` 或 `agentChat.prefill()`。伺服器actions一般不應該呼叫僅瀏覽器的`sendToAgentChat()`；如果某個操作需要開啟 UI 向代理詢問某些內容，請將一個小請求寫入 `application_state` 並讓 UI 橋接器從瀏覽器傳送它。
 
-### 點擊提示中的專案 {#clicked-items-in-prompt}
+### 點選提示中的專案 {#clicked-items-in-prompt}
 
 對於“點選 UI 中的專案，它們成為提示的一部分”體驗，請將選取狀態與提示切換相結合：
 
 1. 點選或多選時，寫入語義 `selection` 狀態，以便 `view-screen`、動態建議和未來回合可以看到它。
-2. 如果點擊也是指令，則調用`sendToAgentChat()`，簡潔的可見`message`和更丰富的隱藏`context`。
-3. 在 `view-screen` 中，將選定的 ID 合並到目前紀錄中，以便代理可以在改變物件之前驗證該物件。
+2. 如果點選也是指令，則呼叫`sendToAgentChat()`，簡潔的可見`message`和更豐富的隱藏`context`。
+3. 在 `view-screen` 中，將選定的 ID 合併到目前紀錄中，以便代理可以在改變物件之前驗證該物件。
 4. 當物件不再被選取、刪除或不再相關時，清除 `selection`。
 
-這為使用者提供了神奇的“這就是我的意思”行為，而無需在每個提示中填充大量可見上下文。
+這為使用者提供了神奇的“這就是我的意思”行為，而無需在每個提示中填充大量可見脈絡。
 
 ## 導覽操作 {#navigate-action}
 
-`navigate` 是 `navigation` 的鏡像。其中`navigation`是UI告訴代理使用者在哪裡，`navigate`是代理告訴UI去哪裡。代理將一次性 `navigate` 指令寫入應用程式狀態； UI 讀取它，執行導覽，然後刪除該條目。
+`navigate` 是 `navigation` 的鏡像。其中`navigation`是 UI 告訴代理使用者在哪裡，`navigate`是代理告訴 UI 去哪裡。代理將一次性 `navigate` 指令寫入應用程式狀態； UI 讀取它，執行導覽，然後刪除該條目。
 
 ```ts
 // Agent side -- write a navigate command
@@ -279,24 +279,24 @@ import { writeAppState } from "@agent-native/core/application-state";
 await writeAppState("navigate", { view: "inbox", threadId: "thread-123" });
 ```
 
-在 UI 端，您永遠不會手動輪詢或刪除此金鑰。兩個方向（在每次路由更改時寫入 `navigation` 並使用代理的 `navigate` 指令）均由單個鉤子 [`useNavigationState`](#use-navigation-state) 處理，下一節將對此進行介紹。
+在 UI 端，您永遠不會手動輪詢或刪除此金鑰。兩個方向（在每次路由更改時寫入 `navigation` 並使用代理的 `navigate` 指令）均由單一鉤子 [`useNavigationState`](#use-navigation-state) 處理，下一節將對此進行介紹。
 
-`navigation`金鑰屬於UI；代理絕不能直接寫入。代理寫入 `navigate`，UI 執行行動，該行動更新 `navigation`。
+`navigation`金鑰屬於 UI；代理絕不能直接寫入。代理寫入 `navigate`，UI 執行行動，該行動更新 `navigation`。
 
-當目的地有真實的URL時，請在其上包含同來源的`path`
+當目的地有真實的 URL 時，請在其上包含同來源的`path`
 `navigate` 指令並讓 UI 在回退到該路徑之前選取該路徑
 語義欄位。保持應用程式導覽單通道：不要同時寫入
 `navigate` 和 `__set_url__` 相同的動作。 `__set_url__` 為
-框架URL工具（`set-url-path`、`set-search-params`）和僅URL過濾器
+框架 URL 工具（`set-url-path`、`set-search-params`）和僅 URL 過濾器
 改變。對於在聊天流式傳輸時可以到達的指令，請提交路由
 使用 `navigate(path, { replace: true, flushSync: true })` 而不是包裝它
-在視圖轉換中，使地址欄和可見頁面保持在一起。
+在檢視轉換中，使地址欄和可見頁面保持在一起。
 
 ## useNavigationState 掛鉤 {#use-navigation-state}
 
-`useNavigationState` 是 **您的應用程式的鉤子，而不是框架匯入。** 每個範本都在 `app/hooks/use-navigation-state.ts` 上發布一個，並從應用程式 shell (`root.tsx`) 調用它一次。這是連線兩個方向導覽的單一位置：
+`useNavigationState` 是 **您的應用程式的鉤子，而不是框架匯入。** 每個範本都在 `app/hooks/use-navigation-state.ts` 上發布一個，並從應用程式 shell (`root.tsx`) 呼叫它一次。這是連線兩個方向導覽的單一位置：
 
-- **出站（UI→代理）：**每當路線改變時寫入`navigation`金鑰，因此代理始終知道目前視圖。
+- **出站（UI→代理）：**每當路由改變時寫入`navigation`金鑰，因此代理始終知道目前檢視。
 - **入站（代理 → UI）：**輪詢 `navigate` 指令、執行導覽並刪除指令。
 
 它很短，因為它是真實框架原語 `useAgentRouteState`（從 `@agent-native/core/client` 匯出）的薄包裝。您提供兩個特定於應用程式的功能，框架將完成其餘的工作：
@@ -339,13 +339,13 @@ export function useNavigationState() {
 | `getNavigationState` — 將 URL 對應到語義狀態    | `navigation` 寫入，制表符範圍加上全域後備鍵    |
 | `getCommandPath` — 將 `navigate` 指令對應到路由 | 指令輪詢、讀後刪除、重複指令保護、請求來源標記 |
 
-`useAgentRouteState` 假定為 React 路由器。當導覽不在 URL 中時（向導步驟、畫布選取、非路由器 shell），而是下拉到較低級別的 `useSemanticNavigationState`：您將現成的 `state` 值加上 `navigationKeys`/`commandKeys` 和 `onCommand` 回調，並且它與 React 路由器完全無關。
+`useAgentRouteState` 假定為 React 路由器。當導覽不在 URL 中時（向導步驟、畫布選取、非路由器 shell），而是下拉到較低階別的 `useSemanticNavigationState`：您將現成的 `state` 值加上 `navigationKeys`/`commandKeys` 和 `onCommand` 回調，並且它與 React 路由器完全無關。
 
 ## 抖動預防 {#jitter-prevention}
 
-當代理寫入應用程式狀態時，同步系統可能會導致 UI 重新獲取剛剛寫入的資料。這會產生抖動。解決方案是來源標記：
+當代理寫入應用程式狀態時，同步系統可能會導致 UI 重新取得剛剛寫入的資料。這會產生抖動。解決方案是來源標記：
 
-使用 `@agent-native/core/client` 中的 `setClientAppState`、`writeClientAppState`、`readClientAppState` 和 `deleteClientAppState` 進行瀏覽器端應用程式狀態存取。與`useDbSync({ ignoreSource: TAB_ID })`配對時通過`{ requestSource: TAB_ID }`對UI進行寫入；通過 `{ keepalive: true }` 進行短期寫入，例如卸載期間的選取清理。
+使用 `@agent-native/core/client` 中的 `setClientAppState`、`writeClientAppState`、`readClientAppState` 和 `deleteClientAppState` 進行瀏覽器端應用程式狀態存取。與`useDbSync({ ignoreSource: TAB_ID })`配對時透過`{ requestSource: TAB_ID }`對 UI 進行寫入；透過 `{ keepalive: true }` 進行短期寫入，例如卸載期間的選取清理。
 
 ```ts
 // app/root.tsx
@@ -360,14 +360,14 @@ useDbSync({
 工作原理：
 
 - 代理寫入標記為 `requestSource: "agent"`（操作助手自動執行此操作）
-- UI 寫入通過 `X-Request-Source` 標頭包含分頁的唯一 ID
-- 伺服器存儲每個事件的來源
-- 處理同步事件時，UI 會過濾掉與其自己的 `ignoreSource` 值匹配的事件 - 因此它不會重新獲取剛剛寫入的資料
+- UI 寫入透過 `X-Request-Source` 標頭包含分頁的唯一 ID
+- 伺服器儲存每個事件的來源
+- 處理同步事件時，UI 會過濾掉與其自己的 `ignoreSource` 值匹配的事件 - 因此它不會重新取得剛剛寫入的資料
 - 來自代理、其他分頁和 actions 的事件仍然正常進行
 
 ```an-diagram title="來源標記可阻止自重取抖動" summary="分頁會忽略標有其自己的 TAB_ID 的同步事件，但仍會對代理和其他分頁寫入做出反應。"
 {
-  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">此標籤頁面寫入<br><small class=\"diagram-muted\">X-Request-Source: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>伺服器存儲來源<br>on the event</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">source == TAB_ID &rarr; ignored</div><small class=\"diagram-muted\">無需重新拉取，無閃爍</small><div class=\"diagram-pill ok\">agent / other tab &rarr; applied</div><small class=\"diagram-muted\">介面實時更新</small></div></div>",
+  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">此標籤頁面寫入<br><small class=\"diagram-muted\">X-Request-Source: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>伺服器儲存來源<br>on the event</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">source == TAB_ID &rarr; ignored</div><small class=\"diagram-muted\">無需重新拉取，無閃爍</small><div class=\"diagram-pill ok\">agent / other tab &rarr; applied</div><small class=\"diagram-muted\">介面即時更新</small></div></div>",
   "css": ".diagram-jitter{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jitter .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-jitter .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```