@agent-native/core 0.79.12 → 0.79.15

package/corpus/core/docs/content/locales/zh-TW/drop-in-agent.md

@@ -11,23 +11,23 @@ description: "使用 <AgentPanel>、<AgentSidebar> 和 sendToAgentChat() 將代
 
 > **先決條件：** 伺服器必須執行 `agent-chat-plugin`（它會自動安裝在每個範本中）。如果您是從頭開始，請參閱 [Server](/docs/server)。
 >
-> 需要公開 API 地圖而不是教程？參見[Component API](/docs/components)。
+> 需要公開 API 地圖而不是教學？參見[Component API](/docs/components)。
 
 ## 元件一覽 {#components}
 
-| 元件                  | 它是什么                                           | 什么時候使用它                           |
+| 元件                  | 它是什麼                                           | 什麼時候使用它                           |
 | --------------------- | -------------------------------------------------- | ---------------------------------------- |
 | `<AgentSidebar>`      | 包裝您的根應用布局並新增包含完整代理的可切換側面板 | 您希望代理在每個螢幕上與您的應用一起使用 |
 | `<AgentToggleButton>` | 開啟/關閉 `<AgentSidebar>`（將其放入標頭中）       | 與 `<AgentSidebar>` 配對                 |
 | `<AgentPanel>`        | 原始面板本身 - 聊天 + CLI + 工作區分頁             | 您想要完全控制布局或專用代理頁面         |
 | `<AgentChatSurface>`  | 預接線面板/頁面聊天介面                            | 您想要在沒有側邊欄包裝器的情況下進行聊天 |
-| `<AssistantChat>`     | 具有作曲家/歷史掛鉤的低級聊天渲染器                | 您需要圍繞標準對話 UI 進行自訂鑲邊       |
-| `sendToAgentChat()`   | 以編程方式向聊天發送訊息                           | 將工作交給代理而不是內聯執行的按鈕       |
+| `<AssistantChat>`     | 具有撰寫器/歷史掛鉤的低階聊天渲染器                | 您需要圍繞標準對話 UI 進行自訂鑲邊       |
+| `sendToAgentChat()`   | 以程式化方式向聊天傳送訊息                         | 將工作交給代理而不是行內執行的按鈕       |
 | `useActionMutation()` | 圍繞操作的型別安全前端包裝                         | UI 需要執行代理工具執行的相同操作        |
 
 所有這些都是從`@agent-native/core/client`匯出的。
 
-```an-diagram title="安裝型號" summary="<AgentSidebar> 包裝您現有的布局。您的路線在主要區域中呈現；代理面板安裝在它們旁邊。 <AgentPanel> 是沒有包裝紙的同一面板。"
+```an-diagram title="安裝型號" summary="<AgentSidebar> 包裝您現有的布局。您的路由在主要區域中呈現；代理面板安裝在它們旁邊。 <AgentPanel> 是沒有包裝紙的同一面板。"
 {
   "html": "<div class=\"diagram-mount\"><div class=\"diagram-box sidebar\" data-rough><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><div class=\"inner\"><div class=\"diagram-node main\">你的應用程式<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node panel\">代理面板<br><small class=\"diagram-muted\">chat &middot; CLI &middot; workspace</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card alt\"><span class=\"diagram-pill\">&lt;AgentPanel&gt;</span><small class=\"diagram-muted\">same panel, no wrapper &mdash; you own the layout</small></div></div>",
   "css": ".diagram-mount{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mount .sidebar{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-mount .inner{display:flex;gap:10px}.diagram-mount .main{flex:2}.diagram-mount .panel{flex:1}.diagram-mount .alt{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-mount .diagram-arrow{font-size:22px;line-height:1}"
@@ -37,39 +37,39 @@ description: "使用 <AgentPanel>、<AgentSidebar> 和 sendToAgentChat() 將代
 ## 80%的情況：`<AgentSidebar>` {#sidebar}
 
 最常見的設定是在任何螢幕上從右側開啟側邊欄。
-用 `<AgentSidebar>` 包裹現有的根布局；無論你傳遞什么
+用 `<AgentSidebar>` 包裹現有的根布局；無論你傳遞什麼
 孩子們留在主應用程式區域。代理聊天位於側面板。
 
 ```an-annotated-code title="用 <AgentSidebar> 包裝根布局"
 {
   "filename": "app/root.tsx",
   "language": "tsx",
-  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"我能幫什么？\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
+  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"我能幫什麼？\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
   "annotations": [
     { "lines": "6", "label": "包裝紙", "note": "`<AgentSidebar>` wraps your whole layout. It adds the toggleable side panel; everything you pass as children stays in the main app area." },
-    { "lines": "8-12", "label": "啟動提示", "note": "`suggestions` 在空聊天中呈現為可點擊的筹碼。" },
-    { "lines": "13", "label": "上下文感知芯片", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
+    { "lines": "8-12", "label": "啟動提示", "note": "`suggestions` 在空聊天中呈現為可點選的標籤。" },
+    { "lines": "13", "label": "脈絡感知標籤", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
     { "lines": "18-20", "label": "切換按鈕", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
     { "lines": "22-24", "label": "你的應用程式", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
   ]
 }
 ```
 
-就是這樣。使用者現在在每個頁面上都有一個可切換代理 - 具有聊天歷史紀錄、工作區分頁、CLI 終端、語音輸入和全屏模式。通過 `localStorage` 重新載入，狀態仍然存在。
+就是這樣。使用者現在在每個頁面上都有一個可切換代理 - 具有聊天歷史紀錄、工作區分頁、CLI 終端、語音輸入和全螢幕模式。透過 `localStorage` 重新載入，狀態仍然存在。
 
 ### 道具
 
-- **`children`** — 您的應用程式的正常布局和路線。在主區域渲染；代理面板在桌面上安裝在其旁邊，在行動/全屏上安裝在其上方。
+- **`children`** — 您的應用程式的正常布局和路由。在主區域渲染；代理面板在桌面上安裝在其旁邊，在行動/全螢幕上安裝在其上方。
 - **`emptyStateText`** — 聊天沒有訊息時顯示的問候語。預設值：`"How can I help you?"`。
-- **`suggestions`** — 啟動提示在空時呈現為可點擊的筹碼。
-- **`dynamicSuggestions`** — 上下文感知提示芯片與 `suggestions` 合並。預設啟用；傳遞 `false` 僅顯示靜態建議，或傳遞 `{ max, includeStatic, getSuggestions }` 進行自訂。
+- **`suggestions`** — 啟動提示在空時呈現為可點選的標籤。
+- **`dynamicSuggestions`** — 脈絡感知提示標籤與 `suggestions` 合併。預設啟用；傳遞 `false` 僅顯示靜態建議，或傳遞 `{ max, includeStatic, getSuggestions }` 進行自訂。
 - **`defaultSidebarWidth`** — 初始像素寬度（僅安裝；使用者調整大小並覆蓋儲存的值）。預設值：`380`。
 - **`position`** — `"left"` 或 `"right"`。預設值：`"right"`。
 - **`defaultOpen`** — 側邊欄是否開始開啟（僅限桌面）。預設值：`false`。
 
 ## 另外20%：`<AgentPanel>` {#panel}
 
-當您需要完全控制布局時 - 專用的 `/chat` 路線、您管理的側欄中的嵌入式面板或快顯窗口 - 直接渲染 `<AgentPanel>`：
+當您需要完全控制布局時 - 專用的 `/chat` 路由、您管理的側欄中的嵌入式面板或快顯視窗 - 直接渲染 `<AgentPanel>`：
 
 ```tsx
 // app/routes/agent.tsx
@@ -91,14 +91,14 @@ export default function AgentRoute() {
 - **`defaultMode`** — `"chat"` 或 `"cli"`。預設值：`"chat"`。
 - **`className`** — 外部容器的 CSS 類。
 - **`onCollapse`** — 如果提供，標題中會出現折疊按鈕。
-- **`isFullscreen`** / **`onToggleFullscreen`** — 如果您想要 Claude 樣式的居中列，請連線外部全屏狀態。
+- **`isFullscreen`** / **`onToggleFullscreen`** — 如果您想要 Claude 樣式的居中列，請連線外部全螢幕狀態。
 - **`storageKey`** — `localStorage` 金鑰的命名空間。當您在同一頁面中渲染多個面板（不同的應用程式執行個體或工作區）時很有用。
 
 完整道具：`@agent-native/core/client` 中的 `AgentPanelProps`。
 
-## 編程訊息：`sendToAgentChat()` {#send}
+## 程式化訊息：`sendToAgentChat()` {#send}
 
-將工作交給代理的按鈕（而不是執行內聯 `llm()` 調用 - [ladder](/docs/what-is-agent-native#the-ladder) 的反模式）：
+將工作交給代理的按鈕（而不是執行行內 `llm()` 呼叫 - [ladder](/docs/what-is-agent-native#the-ladder) 的反模式）：
 
 ```tsx
 import { sendToAgentChat } from "@agent-native/core/client";
@@ -119,11 +119,11 @@ import { sendToAgentChat } from "@agent-native/core/client";
 ### 選項
 
 - **`message`** — 聊天中顯示的可見提示。
-- **`context`** - 附加到提示的隱藏上下文（選定的文本、光標位置、目前實體 ID - 代理應該知道但使用者不應看到兩次的任何內容）。
+- **`context`** - 附加到提示的隱藏脈絡（選定的文字、游標位置、目前實體 ID - 代理應該知道但使用者不應看到兩次的任何內容）。
 - **`submit`** — `true` 自動執行，`false` 預填充但等待。省略使用專案預設值。
-- **`newTab`** — 為此提示建立一個單獨的聊天線程。
-- **`background`** — 使用 `newTab`，執行時無需聚焦新線程。隱藏執行在 `RunsTray` 中進行跟蹤。
-- **`openSidebar`** — 設定為 `false` 以進行後台/靜默發送。預設開啟側邊欄，以便使用者看到回應。
+- **`newTab`** — 為此提示建立一個單獨的聊天對話串。
+- **`background`** — 使用 `newTab`，執行時無需聚焦新對話串。隱藏執行在 `RunsTray` 中進行跟蹤。
+- **`openSidebar`** — 設定為 `false` 以進行背景/靜默傳送。預設開啟側邊欄，以便使用者看到回應。
 - **`type`** — `"content"`（預設）將工作保留在嵌入式應用程式代理中。 `"code"` 路由到程式碼編輯框架（對於代理編寫的程式碼更改，請參閱 [Frames](/docs/frames)）。
 
 `sendToAgentChat` 返回一個穩定的 `tabId`，您可以使用它來跟蹤聊天執行。
@@ -141,11 +141,11 @@ sendToAgentChat({
 });
 ```
 
-這仍然是一個使用工具、actions、線程狀態和執行執行的完整代理
+這仍然是一個使用工具、actions、對話串狀態和執行執行的完整代理
 跟蹤。它根本不會從使用者目前的側邊欄狀態中竊取焦點。
 
-當嵌入相同的路由作為MCP App時，提交
-`sendToAgentChat()` 呼叫將轉發至支持的聊天主機；參見
+當嵌入相同的路由作為 MCP App 時，提交
+`sendToAgentChat()` 呼叫將轉發至支援的聊天主機；參見
 [Client](/docs/client#sendtoagentchat) 用於 MCP 應用橋接行為。
 
 如果您想要載入狀態，請使用 `useSendToAgentChat()` 鉤子 - 它返回 `send` 和 `isGenerating`：
@@ -161,22 +161,22 @@ const { send, isGenerating } = useSendToAgentChat();
 `<AgentSidebar>`和`<AgentPanel>`涵蓋了大多數應用程式。當您需要擁有
 圍繞代理進行布局，或者您想要與代理進行對話
 您在其他地方建置，放下一層 - 但繼續讓框架擁有
-執行時、actions 和 SQL 支持的狀態：
+執行時、actions 和 SQL 支援的狀態：
 
 - **在標準執行時擁有 chrome。**使用 `<AgentChatSurface>`
   專用聊天路由，或者當您需要自訂標題時為 `<AssistantChat>`，
   分頁，以及標準對話週圍的空白狀態。完整圖層圖 —
-  每個元件、鉤子、編寫器和適配器，以及匯入路徑 - 都位於
+  每個元件、鉤子、編寫器和轉接器，以及匯入路徑 - 都位於
   [Component API](/docs/components#agent-chat-ui).
 - **自帶代理執行時。**如果您在其他地方建置的代理應該
-  在 Agent-Native 保留作曲家、文字紀錄和工具的同時推動對話
-  卡片、批準和本機小部件，將 `AgentChatRuntime` 傳遞給
+  在 Agent-Native 保留撰寫器、文字紀錄和工具的同時推動對話
+  卡片、核准和本機小工具，將 `AgentChatRuntime` 傳遞給
   `<AssistantChat runtime={...} />`。連線器
   （`createHttpAgentChatRuntime()` 和 OpenAI / Claude / Vercel AI / AG-UI
   helpers）和事件契約紀錄在
   [Native 聊天介面 — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
 
-無論您選取哪一層，都將 actions 和 SQL 支持的應用程式狀態保留為合約，
+無論您選取哪一層，都將 actions 和 SQL 支援的應用程式狀態保留為合約，
 並避免從產品 UI 直接發布到 `/_agent-native/agent-chat`。如果一個
 真正的自訂表面缺少指定的助手，請先新增該助手
 用戶端程式碼不會學習第二個臨時傳輸。
@@ -204,9 +204,9 @@ const { mutate, isPending } = useActionMutation("reply-to-email");
 }
 ```
 
-## 選取+光標感知 {#selection}
+## 選取+游標感知 {#selection}
 
-代理可以在應用程式狀態下通過 `navigation` 和 `selection` 鍵檢視使用者選取的內容 - 文本、單元格、幻燈片、聯系人。當目前螢幕使它們相關時，空聊天還使用這些鍵提供動態建議，例如“總結此選取”或“改進此幻燈片”。如果您希望使用 Cmd-I（或類似鍵）將選定的範圍作為上下文發送到聊天中，請參閱 [Context Awareness](/docs/context-awareness)。
+代理可以在應用程式狀態下透過 `navigation` 和 `selection` 鍵檢視使用者選取的內容 - 文字、單元格、幻燈片、聯絡人。當目前螢幕使它們相關時，空聊天還使用這些鍵提供動態建議，例如“總結此選取”或“改進此幻燈片”。如果您希望使用 Cmd-I（或類似鍵）將選定的範圍作為脈絡傳送到聊天中，請參閱 [Context Awareness](/docs/context-awareness)。
 
 ## 將它們放在一起 {#putting-it-together}
 
@@ -250,11 +250,11 @@ export default function Root() {
 </Button>
 ```
 
-使用者在標題中看到一個聊天按鈕，可以開啟它，並可以與客服人員交談。您的按鈕將工作交給同一個代理，而不是執行一次性 LLM 調用。
+使用者在標題中看到一個聊天按鈕，可以開啟它，並可以與代理交談。您的按鈕將工作交給同一個代理，而不是執行一次性 LLM 呼叫。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Actions**](/docs/actions) — `defineAction()` 和 `useActionMutation()`
 - [**Context Awareness**](/docs/context-awareness) — 選取、導覽、檢視螢幕
-- [**Workspace**](/docs/workspace) —“工作空間”分頁包含的內容（skills、內存、MCP 伺服器、計畫作業）
+- [**Workspace**](/docs/workspace) —“工作空間”分頁包含的內容（skills、記憶、MCP 伺服器、計畫作業）
 - [**Voice Input**](/docs/voice-input) — 聊天編輯器中的麥克風

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

@@ -1,54 +1,54 @@
 ---
 title: "持久的簡歷"
-description: "當託管代理執行被中斷並恢復時，已完成的副作用工具調用不會重新執行 - 從持久帳本派生的工具調用記錄會阻止重複發送、收費和票證。"
+description: "當託管代理執行被中斷並恢復時，已完成的副作用工具呼叫不會重新執行 - 從持久帳本派生的工具呼叫記錄會阻止重複傳送、收費和票證。"
 ---
 
 # 持久的簡歷
 
 > **這是誰的：**任何想要了解框架如何執行的人
-> 恢復可避免重複的副作用。這是內置行為——有
+> 恢復可避免重複的副作用。這是內建行為——有
 > 無需連線。
 
-託管代理執行被中斷：無伺服器函數在中途遇到硬超時，網關在 45 秒時斷開連線，套接字暫停，平台冷啟動。該框架已經通過儲存對話前綴並重新執行 LLM 調用（“從上次中斷的地方繼續”）來恢復。但僅恢復就有一個明顯的優勢：如果被中斷的嘗試**已經發送了一封電子郵件或建立了一個票證**，那么天真的簡歷可以再次做到這一點。
+託管代理執行被中斷：無伺服器函式在中途遇到硬超時，閘道在 45 秒時斷開連線，socket 暫停，平台冷啟動。此框架已經透過儲存對話前綴並重新執行 LLM 呼叫（“從上次中斷的地方繼續”）來恢復。但僅恢復就有一個明顯的優勢：如果被中斷的嘗試**已經傳送了一封電子郵件或建立了一個票證**，那麼天真的簡歷可以再次做到這一點。
 
-持久的簡歷彌補了這一差距。恢復時，框架知道哪個副作用工具調用已經完成，並拒絕在兩層重新執行它們。
+持久的簡歷彌補了這一差距。恢復時，框架知道哪個副作用工具呼叫已經完成，並拒絕在兩層重新執行它們。
 
-```an-diagram title="兩層可阻止簡歷上重複的副作用" summary="記錄讀取持久帳本並對之前的調用進行分類；第 1 層告訴模型，第 2 層硬阻止與已完成條目匹配的重新分派寫入。"
+```an-diagram title="兩層可阻止簡歷上重複的副作用" summary="記錄讀取持久帳本並對之前的呼叫進行分類；第 1 層告訴模型，第 2 層硬阻止與已完成條目匹配的重新分派寫入。"
 {
   "html": "<div class=\"diagram-durable\"><div class=\"diagram-box\" data-rough>Run-event ledger<br><small class=\"diagram-muted\">tool_start / tool_done</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><strong>Tool-call journal</strong><small class=\"diagram-ok\">completed = start+done</small><small class=\"diagram-warn\">interrupted = start, no done</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">Layer 1 · prompt note &rarr; model</div><div class=\"diagram-pill accent\">第 2 層 · 硬阻塞重新派發寫入</div></div></div>",
   "css": ".diagram-durable{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-durable .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-durable .diagram-arrow{font-size:22px;line-height:1}.diagram-durable .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
 
-## 工具調用記錄 {#journal}
+## 工具呼叫記錄 {#journal}
 
-記錄是**對持久執行事件分類帳的純粹讀取** - 熱路徑中沒有新的紀錄掛鉤。它對目前回合已紀錄的工具調用進行分類：
+記錄是**對持久執行事件分類帳的純粹讀取** - 熱路徑中沒有新的紀錄掛鉤。它對目前回合已紀錄的工具呼叫進行分類：
 
-- **已完成** — `tool_start` 與匹配的 `tool_done`。調用執行，它的副作用發生，並且它的結果被紀錄。 **不要重新執行。**
+- **已完成** — `tool_start` 與匹配的 `tool_done`。呼叫執行，它的副作用發生，並且它的結果被紀錄。 **不要重新執行。**
 - **中斷** — `tool_start`，**沒有**匹配 `tool_done`。通話開始了，它的副作用可能已經發生，也可能沒有發生，而中斷則吞噬了結果。結果未知。
 
-匹配反映了如何在其他地方重建耐用轉彎：`tool_done` 與最舊的仍開啟的 `tool_start` 配對，使用相同的工具名稱（每個工具 FIFO）。 `clear` 事件（廢棄的部分輸出）會重置每輪計數，因此廢棄的部分輸出不會留下虛擬的開放調用。
+匹配反映了如何在其他地方重建耐用轉彎：`tool_done` 與最舊的仍開啟的 `tool_start` 配對，使用相同的工具名稱（每個工具 FIFO）。 `clear` 事件（廢棄的部分輸出）會重設每輪計數，因此廢棄的部分輸出不會留下虛擬的開放呼叫。
 
 ## 第1層：提示級日記筆記 {#prompt-note}
 
-當執行恢復時（軟超時、網關超時或任何可恢復的傳輸錯誤），框架會在“從上次停止的地方繼續”輕推之後，將**結構化記錄注釋**附加到恢復提示中。該注釋以純文本形式告訴模型：
+當執行恢復時（軟超時、閘道超時或任何可恢復的傳輸錯誤），框架會在“從上次停止的地方繼續”輕推之後，將**結構化記錄註解**附加到恢復提示中。該註解以純文字形式告訴模型：
 
-- 哪個工具調用**已經完成**（結果很短），因此它會重用它們並且**不會**重新執行它們，並且
-- 哪個工具調用被**因未知結果而中斷**，因此它會在假設成功或失敗之前驗證狀態。
+- 哪個工具呼叫**已經完成**（結果很短），因此它會重用它們並且**不會**重新執行它們，並且
+- 哪個工具呼叫被**因未知結果而中斷**，因此它會在假設成功或失敗之前驗證狀態。
 
-當記錄為空時（沒有工具活動的回合，或幹淨的延續），不會附加任何額外內容，並且恢復行為與之前的情況相同。該注釋是盡力而為的：失敗的帳本讀取永遠不會阻止本來會成功的恢復。
+當記錄為空時（沒有工具活動的回合，或幹淨的延續），不會附加任何額外內容，並且恢復行為與之前的情況相同。該註解是盡力而為的：失敗的帳本讀取永遠不會阻止本來會成功的恢復。
 
 ## 第2層：工具層硬塊 {#hard-block}
 
-提示資訊是建議性的 - 一個表現良好的模型會注意到它，但模型並不能保證。因此循環也在工具層強制執行它。
+提示資訊是建議性的 - 一個表現良好的模型會注意到它，但模型並不能保證。因此迴圈也在工具層強制執行它。
 
-在循環在恢復的塊中執行之前，它會對記錄進行一次快照（僅捕獲此邏輯回合的**之前**塊）。當模型重新分派工具名稱**和輸入**與已完成的日記條目匹配的**寫入**工具時，循環會短路：它返回日記結果而不是執行操作，並注意該調用已在之前中斷的嘗試中完成，並且不會重新執行以避免重複的副作用。
+在迴圈在恢復的塊中執行之前，它會對記錄進行一次快照（僅捕獲此邏輯回合的**之前**塊）。當模型重新分派工具名稱**和輸入**與已完成的日記條目匹配的**寫入**工具時，迴圈會短路：它返回日記結果而不是執行操作，並注意該呼叫已在之前中斷的嘗試中完成，並且不會重新執行以避免重複的副作用。
 
 關鍵屬性：
 
 - **僅限寫入工具。**唯讀 (`readOnly` / GET) actions 永遠不會被阻止 - 重新讀取是安全且冪等的。
-- **內容尋址。** 匹配基於工具名稱 + 輸入簽名，因此輪流中位於不同位置的恢復調用仍然匹配； _ different_ 調用（不同的參數）被視為新鮮調用並正常執行。
-- **消費一次。**每個已完成的條目在匹配時都會被聲明，因此同一輪中兩個真正不同的相同的新調用不會在一個記錄完成時同時短路。
+- **內容尋址。** 匹配基於工具名稱 + 輸入簽名，因此輪流中位於不同位置的恢復呼叫仍然匹配； _ different_ 呼叫（不同的參數）被視為新鮮呼叫並正常執行。
+- **消費一次。**每個已完成的條目在匹配時都會被聲明，因此同一輪中兩個真正不同的相同的新呼叫不會在一個記錄完成時同時短路。
 - **新呼叫未受影響。**首輪呼叫會看到空記錄；正常執行沒有任何變化。
 
 ```an-callout
@@ -62,4 +62,4 @@ description: "當託管代理執行被中斷並恢復時，已完成的副作用
 
 - [**Real-Time Sync**](/docs/real-time-collaboration) — 持久執行帳本如何流式傳輸到用戶端並在重新連線時重播。
 - [**Actions**](/docs/actions) — `readOnly` 將讀取標記為可以安全地重新執行；其他一切都被視為副作用。
-- [**In-Loop Processors**](/docs/processors) — 另一個循環內部硬化接縫。
+- [**In-Loop Processors**](/docs/processors) — 另一個迴圈內部硬化接縫。