@agent-native/core 0.79.12 → 0.79.15

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

@@ -1,18 +1,18 @@
 ---
-title: "CLI 適配器"
-description: "通過標準適配器介面（適配器指南中介紹的兩個適配器接縫之一）為代理提供對任何 CLI 工具（gh、ffmpeg、stripe）的結構化存取。"
+title: "CLI 轉接器"
+description: "透過標準轉接器介面（轉接器指南中介紹的兩個轉接器接縫之一）為代理提供對任何 CLI 工具（gh、ffmpeg、stripe）的結構化存取。"
 ---
 
-# CLI 適配器
+# CLI 轉接器
 
-> **適合的位置：** CLI 適配器是
+> **適合的位置：** CLI 轉接器是
 > 框架。規範指南是 [Adapters](/docs/sandbox-adapters)，
 > 覆蓋此接縫和 `run-code` 沙箱接縫 - 包括共用
-> 邊缘/無伺服器約束。本頁面是CLI端的快速參考。
+> 邊緣/無伺服器約束。本頁面是 CLI 端的快速參考。
 
-CLI 適配器包裝單個指令行工具（`gh`、`ffmpeg`、`stripe`、`aws`），以便代理可以發現它，檢查它是否已安裝，並使用一致的 stdout/stderr/exit-code 結果執行它。如果沒有這個接縫，每個腳本都會重新發明如何調用 CLI 並解析其輸出。
+CLI 轉接器包裝單一指令行工具（`gh`、`ffmpeg`、`stripe`、`aws`），以便代理可以發現它，檢查它是否已安裝，並使用一致的 stdout/stderr/exit-code 結果執行它。如果沒有這個接縫，每個指令碼都會重新發明如何呼叫 CLI 並解析其輸出。
 
-```an-diagram title="CLI 適配器 → 註冊表 → 操作面" summary="ShellCliAdapter 包裝二進制檔案； CliRegistry 收集適配器以供發現； defineAction 在代理 + UI 操作介面上公開一個調用。"
+```an-diagram title="CLI 轉接器 → 註冊表 → 操作面" summary="ShellCliAdapter 包裝二進制檔案； CliRegistry 收集轉接器以供發現； defineAction 在代理 + UI 操作介面上公開一個呼叫。"
 {
   "html": "<div class=\"diagram-cli\"><div class=\"diagram-node\" data-rough>gh · ffmpeg · stripe<br><small class=\"diagram-muted\">command-line tools</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>ShellCliAdapter<br><small class=\"diagram-muted\">isAvailable · execute</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>CliRegistry<br><small class=\"diagram-muted\">describe() for discovery</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">defineAction</div></div>",
   "css": ".diagram-cli{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-cli .diagram-arrow{font-size:22px;line-height:1}.diagram-cli .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -21,7 +21,7 @@ CLI 適配器包裝單個指令行工具（`gh`、`ffmpeg`、`stripe`、`aws`）
 
 ## 介面 {#the-interface}
 
-每個 CLI 適配器都實現 `CliAdapter`：
+每個 CLI 轉接器都實現 `CliAdapter`：
 
 ```ts
 import type { CliAdapter, CliResult } from "@agent-native/core/adapters/cli";
@@ -40,7 +40,7 @@ interface CliResult {
 }
 ```
 
-## ShellCli適配器 {#shell-adapter}
+## ShellCli轉接器 {#shell-adapter}
 
 對於大多數 CLI，您不需要自訂類 - `ShellCliAdapter` 使用合理的預設值包裝任何二進制檔案：
 
@@ -60,13 +60,13 @@ const ffmpeg = new ShellCliAdapter({
 });
 ```
 
-選項：`command`（必填）、`description`（必填）、`name`（預設為 `command`）、`env`（與 `process.env` 合並）、`cwd`（預設為 `process.cwd()`）和 `timeoutMs`（預設） `30000`）。
+選項：`command`（必填）、`description`（必填）、`name`（預設為 `command`）、`env`（與 `process.env` 合併）、`cwd`（預設為 `process.cwd()`）和 `timeoutMs`（預設） `30000`）。
 
 對於自訂驗證、輸出解析或前/後處理，請直接實現 `CliAdapter`，而不是使用 `ShellCliAdapter`。
 
 ## 註冊表 {#registry}
 
-`CliRegistry` 收集適配器，以便代理可以發現執行時可用的內容：
+`CliRegistry` 收集轉接器，以便代理可以發現執行時可用的內容：
 
 ```ts
 import { CliRegistry, ShellCliAdapter } from "@agent-native/core/adapters/cli";
@@ -86,7 +86,7 @@ const result = await gh?.execute(["pr", "list", "--json", "title,url"]);
 
 ## 從actions使用 {#from-actions}
 
-將 CLI 調用包裝在 `defineAction` 中以將其公開在操作介面上 - 當程式碼在伺服器操作介面內執行時需要 `defineAction`；否則直接在 `scripts/` 檔案中使用適配器。切勿在動作中調用 `process.exit`；相反，會拋出錯誤。
+將 CLI 呼叫包裝在 `defineAction` 中以將其公開在操作介面上 - 當程式碼在伺服器操作介面內執行時需要 `defineAction`；否則直接在 `scripts/` 檔案中使用轉接器。切勿在動作中呼叫 `process.exit`；相反，會拋出錯誤。
 
 ```ts
 // actions/list-prs.ts
@@ -119,11 +119,11 @@ export default defineAction({
 });
 ```
 
-## 邊缘和無伺服器 {#edge-serverless}
+## 邊緣和無伺服器 {#edge-serverless}
 
-CLI 適配器使用 `node:child_process`，它在邊缘/工作線程執行時（Cloudflare Workers、Netlify Edge Functions）上不存在。在標準 Node.js 環境中執行 CLI 適配器端點和工作。此約束與沙箱接縫共用 - 請參閱 [Adapters](/docs/sandbox-adapters#edge-serverless) 中的完整討論。
+CLI 轉接器使用 `node:child_process`，它在邊緣/工作對話串執行時（Cloudflare Workers、Netlify Edge Functions）上不存在。在標準 Node.js 環境中執行 CLI 轉接器端點和工作。此約束與沙箱接縫共用 - 請參閱 [Adapters](/docs/sandbox-adapters#edge-serverless) 中的完整討論。
 
-## 下一步是什么
+## 下一步是什麼
 
-- [**Adapters**](/docs/sandbox-adapters) — 兩個適配器接縫的規範指南。
-- [**Actions**](/docs/actions) — 操作面 CLI 適配器通常被包裹在其中。
+- [**Adapters**](/docs/sandbox-adapters) — 兩個轉接器接縫的規範指南。
+- [**Actions**](/docs/actions) — 操作面 CLI 轉接器通常被包裹在其中。

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

@@ -1,21 +1,21 @@
 ---
 title: "用戶端"
-description: "用於代理本機應用程式的 React 掛鉤和實用程序：sendToAgentChat、可選代理聊天上下文狀態、useDbSync、useAgentChatGenerate 和 cn。"
+description: "用於 Agent-Native 應用程式的 React 掛鉤和實用程式：sendToAgentChat、可選代理聊天脈絡狀態、useDbSync、useAgentChatGenerate 和 cn。"
 ---
 
 # 用戶端
 
-`@agent-native/core` 為代理本機應用程式的瀏覽器端提供 React 掛鉤和實用程序。
+`@agent-native/core` 為 Agent-Native 應用程式的瀏覽器端提供 React 掛鉤和實用程式。
 
 這些用戶端/React API 是從 `@agent-native/core` 和 `@agent-native/core/client` 匯出的。為了清晰和正確的捆綁，從 `@agent-native/core/client`（瀏覽器條目）匯入它們，因為預設情況下裸 `@agent-native/core` 根解析為 Node 建置。
 
 對於基於檔案的路由 - 新增頁面、動態參數和導覽 - 請參閱 [Routing](/docs/routing)。
 
-## 獲取和修改資料 {#fetching-mutating}
+## 取得和修改資料 {#fetching-mutating}
 
-從瀏覽器讀取和寫入應用程式資料的主要方式是通過操作掛鉤。切勿手寫 `fetch` 調用 `/_agent-native/*` 路由 - 請改用命名助手（請參閱 [Actions](/docs/actions)）。
+從瀏覽器讀取和寫入應用程式資料的主要方式是透過操作掛鉤。切勿手寫 `fetch` 呼叫 `/_agent-native/*` 路由 - 請改用命名助手（請參閱 [Actions](/docs/actions)）。
 
-```an-diagram title="瀏覽器資料循環" summary="鉤子通過動作進行讀寫； useDbSync 監視資料庫，以便代理和後台寫入自動重新獲取相同的快取。"
+```an-diagram title="瀏覽器資料迴圈" summary="鉤子透過動作進行讀寫； useDbSync 監視資料庫，以便代理和背景寫入自動重新取得相同的快取。"
 {
   "html": "<div class=\"diagram-client\"><div class=\"diagram-col\"><div class=\"diagram-node\">useActionQuery<br><small class=\"diagram-muted\">cached read</small></div><div class=\"diagram-node\">useActionMutation<br><small class=\"diagram-muted\">write + invalidate</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-box\" data-rough>Actions<br><small class=\"diagram-muted\">/_agent-native/actions/*</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>SQL 資料庫</strong></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">useDbSync &rarr; refetch on change</div></div>",
   "css": ".diagram-client{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-client .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-client .diagram-arrow{font-size:22px;line-height:1}"
@@ -42,7 +42,7 @@ await callAction("archive-lead", { leadId });
 
 ## sendToAgentChat（選取） {#sendtoagentchat}
 
-通過 postMessage 向代理聊天發送訊息——這是從 UI 互動中委派 AI 工作的常用方法。傳遞 `context` 來隱藏模型上下文，傳遞 `submit: true` 來立即發送，或者傳遞 `submit: false` 來預先填寫使用者首先審閱的草稿。
+透過 postMessage 向代理聊天傳送訊息——這是從 UI 互動中委派 AI 工作的常用方法。傳遞 `context` 來隱藏模型脈絡，傳遞 `submit: true` 來立即傳送，或者傳遞 `submit: false` 來預先填寫使用者首先審閱的草稿。
 
 ```ts
 import { sendToAgentChat } from "@agent-native/core/client";
@@ -63,20 +63,20 @@ sendToAgentChat({
 ```
 
 在使用 `embedApp()` 建立的 MCP 應用嵌入中，自動提交訊息
-（`submit`省略或`true`）被轉發到MCP應用程式主橋，這
-要求包含主機新增隱藏上下文並發送可見使用者回合。
+（`submit`省略或`true`）被轉發到 MCP 應用程式主橋，這
+要求包含主機新增隱藏脈絡並傳送可見使用者回合。
 `context` 保持模型可見，而不發布為面向使用者的聊天。
 `submit: false` 保留本機預填充/審核行為，因為 MCP 應用不會
 定義標準草稿預填充 API。在內部，這是提交的聊天路徑
-有時會以 `agentNative.submitChat` 的形式出現；應用程式碼應該調用
+有時會以 `agentNative.submitChat` 的形式出現；應用程式碼應該呼叫
 `sendToAgentChat()` 而不是直接發布該事件。
 
-### 後台靜默發送 {#background-send}
+### 背景靜默傳送 {#background-send}
 
 當 UI 操作應該啟動真正的代理工作時，請使用 `background: true`
-開啟或聚焦側邊欄。這仍然會建立一個正常的聊天線程/執行，
-使用代理的工具/actions/context，並通過以下方式保持工作可觀察
-執行托盤；它不是原始的一次性模型調用。
+開啟或聚焦側邊欄。這仍然會建立一個正常的聊天對話串/執行，
+使用代理的工具/actions/context，並透過以下方式保持工作可觀察
+執行托盤；它不是原始的一次性模型呼叫。
 
 ```ts
 const tabId = sendToAgentChat({
@@ -97,35 +97,35 @@ overwrite the user's active conversation. Use the returned `tabId` if the UI
 
 | 選項                  | 型別        | 描述                                                              |
 | --------------------- | ----------- | ----------------------------------------------------------------- |
-| `message`             | `string`    | 發送到聊天的可見提示                                              |
-| `context`             | `string?`   | 附加隱藏上下文（聊天UI中未顯示）                                  |
+| `message`             | `string`    | 傳送到聊天的可見提示                                              |
+| `context`             | `string?`   | 附加隱藏脈絡（聊天 UI 中未顯示）                                  |
 | `submit`              | `boolean?`  | true = 自動提交，false = 僅預填充                                 |
-| `newTab`              | `boolean?`  | 為此提示建立單獨的聊天線程                                        |
+| `newTab`              | `boolean?`  | 為此提示建立單獨的聊天對話串                                      |
 | `background`          | `boolean?`  | 使用 `newTab`，在不聚焦分頁的情況下執行並在 `RunsTray` 中顯示執行 |
 | `openSidebar`         | `boolean?`  | 設定 false 來提交/預填充而不開啟側邊欄                            |
-| `projectSlug`         | `string?`   | 結構化上下文的可選專案段                                          |
+| `projectSlug`         | `string?`   | 結構化脈絡的可選專案段                                            |
 | `preset`              | `string?`   | 下游消費者的可選預設名稱                                          |
 | `referenceImagePaths` | `string[]?` | 可選的參考圖片路徑                                                |
 
-## 客服人員聊天上下文狀態（高級） {#agent-chat-context-state}
+## 代理聊天脈絡狀態（進階） {#agent-chat-context-state}
 
-上下文狀態 API 是 UI 的可選管道，需要雙向同步
-暫存上下文芯片：在編輯器之外渲染目前暫存專案，
+脈絡狀態 API 是 UI 的可選管道，需要雙向同步
+暫存脈絡標籤：在編輯器之外渲染目前暫存專案，
 反映某個專案是否已附加，或提供明確的
-刪除/清除控件。
+刪除/清除控制項。
 
-不要為了簡單的“將其發送給代理”而聯系這些助手，或者
+不要為了簡單的“將其傳送給代理”而聯絡這些助手，或者
 “預填寫此草稿以供審核”流程。將 `sendToAgentChat()` 與 `context` 結合使用
 還有 `submit`。
 
-| API                               | 何時使用                                        |
-| --------------------------------- | ----------------------------------------------- |
-| `useAgentChatContext()`           | React 元件需要實時暫存上下文列表                |
-| `setAgentChatContextItem(item)`   | 指令式程式碼應暫存或替換一個鍵控上下文項        |
-| `listAgentChatContext()`          | 非 React 程式碼需要暫存上下文的一次性快照       |
-| `removeAgentChatContextItem(key)` | UI 應通過其穩定的 `key` 刪除一個暫存上下文項    |
-| `clearAgentChatContext()`         | UI 應清除所有暫存上下文，例如在視圖或模式重置後 |
-| `refreshAgentChatContext()`       | 指令程式碼應該重新讀取最新的持久上下文快照      |
+| API                               | 何時使用                                      |
+| --------------------------------- | --------------------------------------------- |
+| `useAgentChatContext()`           | React 元件需要即時暫存脈絡清單                |
+| `setAgentChatContextItem(item)`   | 指令式程式碼應暫存或替換一個鍵控脈絡項        |
+| `listAgentChatContext()`          | 非 React 程式碼需要暫存脈絡的一次性快照       |
+| `removeAgentChatContextItem(key)` | UI 應透過其穩定的 `key` 刪除一個暫存脈絡項    |
+| `clearAgentChatContext()`         | UI 應清除所有暫存脈絡，例如在檢視或模式重設後 |
+| `refreshAgentChatContext()`       | 指令程式碼應該重新讀取最新的持久脈絡快照      |
 
 `useAgentChatContext()` 返回 `{ items, set, remove, clear, refresh }`。
 
@@ -181,22 +181,22 @@ function SelectionContextButton({ record }: { record: { id: string } }) {
 
 ### AgentChatContextSetOptions {#agentchatcontextsetoptions}
 
-| 選項          | 型別       | 描述                                        |
-| ------------- | ---------- | ------------------------------------------- |
-| `key`         | `string`   | 用於替換現有塊的穩定標識符                  |
-| `title`       | `string`   | 作曲家芯片中顯示的短標籤                    |
-| `context`     | `string`   | 下一個提交的提示中包含隱藏上下文            |
-| `openSidebar` | `boolean?` | 預設為true；靜默地將 false 傳遞給舞台上下文 |
+| 選項          | 型別       | 描述                                      |
+| ------------- | ---------- | ----------------------------------------- |
+| `key`         | `string`   | 用於替換現有塊的穩定識別碼                |
+| `title`       | `string`   | 撰寫器標籤中顯示的短標籤                  |
+| `context`     | `string`   | 下一個提交的提示中包含隱藏脈絡            |
+| `openSidebar` | `boolean?` | 預設為true；靜默地將 false 傳遞給舞台脈絡 |
 
 ## 詢問使用者問題（選取） {#ask-user-question}
 
-通過應用程式碼向使用者提出多項選取問題，並將其內聯呈現
-代理小組，並**等待他們的答複**。它是用戶端的孿生
-代理的內置`ask-question`工具：它將`GuidedQuestionPayload`寫入
+透過應用程式碼向使用者提出多項選取問題，並將其行內呈現
+代理小組，並**等待他們的答覆**。它是用戶端的孿生
+代理的內建`ask-question`工具：它將`GuidedQuestionPayload`寫入
 `"guided-questions"` 應用程式狀態金鑰（已安裝的位置
 `GuidedQuestionFlow` 渲染它）並顯示代理面板，所以問題是
 可見。與代理工具不同——其答案會返回給代理——
-`askUserQuestion()` **解析調用者的答案**，因此 UI 可以
+`askUserQuestion()` **解析呼叫者的答案**，因此 UI 可以
 在上面分支。
 
 當 UI 之前需要做出一個小決定（2-4 個選項）時使用它
@@ -226,20 +226,20 @@ if (length) {
 每個選項都是`{ label, value?, description?, preview?, recommended? }`； `value`
 預設為`label`，`preview`在
 選項。承諾以選定的 `value`（或 `value[]` 時）解析
-`allowMultiple`)，使用者選取“其他”時的自由文本字串，或 `null`
+`allowMultiple`)，使用者選取“其他”時的自由文字字串，或 `null`
 如果他們跳過——它將保持待定狀態，直到使用者回答。需要代理面板
 要安裝（每個範本中都有）。
 
-代理通過其 `ask-question` 工具到達相同的 UI：更願意讓
-當 _it_ 遇到一個無法從上下文解析的真正分叉時，代理會詢問；使用
+代理透過其 `ask-question` 工具到達相同的 UI：更願意讓
+當 _it_ 遇到一個無法從脈絡解析的真正分叉時，代理會詢問；使用
 `askUserQuestion()`，當 _UI_ 需要對選取進行操作時。
 
-## MCP應用程式主橋 {#mcp-app-host-bridge}
+## MCP 應用程式主橋 {#mcp-app-host-bridge}
 
 作為 MCP 應用嵌入的路由應該是 URL-first：載入目前工件
-路徑/查詢參數，渲染真實的React路由或聚焦的共用元件，
+路徑/查詢參數，渲染真實的 React 路由或聚焦的共用元件，
 並且僅將主機橋用於主機擁有的行為。 `@agent-native/core/client`
-匯出助手嵌入的路由調用：
+匯出助手嵌入的路由呼叫：
 
 ```ts
 import {
@@ -251,7 +251,7 @@ import {
 } from "@agent-native/core/client";
 ```
 
-`getMcpAppHostContext()`讀取最新推送的主機上下文快照；
+`getMcpAppHostContext()`讀取最新推送的主機脈絡快照；
 `useMcpAppHostContext()` 訂閱 React 元件的更改。請求
 助手（`openMcpAppHostLink`、`requestMcpAppDisplayMode`，
 `updateMcpAppModelContext`) 在嵌入式 MCP 應用框架之外返回 `false`，或
@@ -259,13 +259,13 @@ import {
 從嵌入式路由自動提交提示。
 
 橋本身 - `ui/*` JSON-RPC 訊息、`agentNative.mcpHost.*`
-包裝器中繼、移植與受控幀渲染、主機上下文以及
+包裝器中繼、移植與受控幀渲染、主機脈絡以及
 顯示模式請求 — 屬於
 [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## 動態建議 {#dynamic-suggestions}
 
-`<AgentSidebar>`、`<AgentPanel>` 和 `<AssistantChat>` 預設將靜態 `suggestions` 與上下文感知建議合並。當可見空聊天時，框架從應用程式狀態中讀取 `navigation`、`selection`、`pending-selection-context` 和目前 URL，然後提供與目前螢幕匹配的提示芯片。
+`<AgentSidebar>`、`<AgentPanel>` 和 `<AssistantChat>` 預設將靜態 `suggestions` 與脈絡感知建議合併。當可見空聊天時，框架從應用程式狀態中讀取 `navigation`、`selection`、`pending-selection-context` 和目前 URL，然後提供與目前螢幕匹配的提示標籤。
 
 ```tsx
 <AgentSidebar
@@ -276,11 +276,11 @@ import {
 </AgentSidebar>
 ```
 
-設定 `dynamicSuggestions={false}` 僅保留靜態芯片。當應用程式需要來自同一應用程式狀態上下文的確定性特定於域的芯片時，傳遞 `getSuggestions`。
+設定 `dynamicSuggestions={false}` 僅保留靜態標籤。當應用程式需要來自同一應用程式狀態脈絡的確定性特定於域的標籤時，傳遞 `getSuggestions`。
 
 ## useAgentChatGenerate() {#useagentchatgenerating}
 
-React 鉤子，通過載入狀態跟蹤包裝 sendToAgentChat：
+React 鉤子，透過載入狀態跟蹤包裝 sendToAgentChat：
 
 ```ts
 import { useAgentChatGenerating } from "@agent-native/core/client";
@@ -303,11 +303,11 @@ function GenerateButton() {
 }
 ```
 
-當您調用 `send()` 時，`isGenerating` 變為 true，並在代理完成生成時自動重置為 false。
+當您呼叫 `send()` 時，`isGenerating` 變為 true，並在代理完成生成時自動重設為 false。
 
 ## useDbSync（選項？） {#usedbsync}
 
-React 掛鉤（以前稱為 `useFileWatcher`），用於偵听 SSE 上的資料庫更改，回退到輪詢，並使保持 UI 與代理寫入保持一致的框架查詢快取無效：
+React 掛鉤（以前稱為 `useFileWatcher`），用於偵聽 SSE 上的資料庫更改，回退到輪詢，並使保持 UI 與代理寫入保持一致的框架查詢快取無效：
 
 ```ts
 import { useDbSync } from "@agent-native/core/client";
@@ -331,22 +331,22 @@ function App() {
 | 選項               | 型別               | 描述                                                                                   |
 | ------------------ | ------------------ | -------------------------------------------------------------------------------------- |
 | `queryClient`      | `QueryClient?`     | React-查詢用戶端快取失效                                                               |
-| `queryKeys`        | `string[]?`        | 已棄用並被忽略；為舊的調用站點保留                                                     |
+| `queryKeys`        | `string[]?`        | 已棄用並被忽略；為舊的呼叫站點保留                                                     |
 | `pollUrl`          | `string?`          | 輪詢端點 URL。預設值：`"/_agent-native/poll"`                                          |
 | `sseUrl`           | `string \| false?` | SSE endpoint URL. Default: `"/_agent-native/events"`; pass `false` to use polling only |
 | `interval`         | `number?`          | 輪詢間隔（以毫秒為單位）。預設值：`2000`                                               |
 | `fallbackInterval` | `number?`          | SSE 不可用時的回退輪詢間隔。預設值：`15000`                                            |
 | `pauseWhenHidden`  | `boolean?`         | 當瀏覽器分頁隱藏時暫停輪詢。預設值：`true`                                             |
-| `ignoreSource`     | `string?`          | 要忽略的每個分頁請求來源，以便分頁不會從其自己的寫入中重新獲取                         |
+| `ignoreSource`     | `string?`          | 要忽略的每個分頁請求來源，以便分頁不會從其自己的寫入中重新取得                         |
 | `onEvent`          | `(data) => void`   | SSE/polling 收到更改事件時的可選回調                                                   |
 
-對於普通CRUD，優先選取`useActionQuery`和`useActionMutation`；變異 actions 會發出 `source: "action"` 並且這些鉤子會自動重新獲取。
+對於普通CRUD，優先選取`useActionQuery`和`useActionMutation`；變異 actions 會發出 `source: "action"` 並且這些鉤子會自動重新取得。
 
 ## useChangeVersion / useChangeVersions {#use-change-version}
 
-框架使用更改版本將 React 查詢快取與後台代理、cron 作業或其他使用者所做的更改同步。
+框架使用更改版本將 React 查詢快取與背景代理、cron 作業或其他使用者所做的更改同步。
 
-當任何伺服器端資料庫發生突變時，伺服器都會使用特定的 `source` 金鑰紀錄更改事件。用戶端的 `useDbSync` 偵听器接收這些事件並增加該來源的本機更改版本計數器。通過將版本計數器折疊到 React 查詢鍵中，每當後端通知用戶端新活動時，查詢就會自動重新獲取。
+當任何伺服器端資料庫發生突變時，伺服器都會使用特定的 `source` 金鑰紀錄更改事件。用戶端的 `useDbSync` 偵聽器接收這些事件並增加該來源的本機更改版本計數器。透過將版本計數器折疊到 React 查詢鍵中，每當後端通知用戶端新活動時，查詢就會自動重新取得。
 
 - **`useChangeVersion(source: string): number`** — 返回一個計數器，每當指定的 `source` 發生突變時該計數器就會遞增。
 - **`useChangeVersions(sources: readonly string[]): number`** — 返回多個來源的版本計數器之和。
@@ -373,10 +373,10 @@ function DashboardView({ id }) {
 
 ### 延遲模型和失效行為
 
-- **UI-發起的突變：**當您使用 `useActionMutation` 從 UI 執行操作時，突變會在成功時立即觸發 `source: "action"` 本機事件。這會根據該操作觸發所有查詢鍵的**即時、樂觀的重新獲取**，從而避免視覺延遲。
-- **後台或代理突變：** 當 AI 代理、Webhook 或後台工作人員突變資料時，更新會廣播到用戶端。用戶端的 `useDbSync` 可以立即通過 SSE（伺服器發送的事件）捕獲此資訊，也可以回退到 **2 秒輪詢滴答**。然後查詢金鑰版本會發生變化，從而觸發後台重新獲取。
+- **UI-發起的突變：**當您使用 `useActionMutation` 從 UI 執行操作時，突變會在成功時立即觸發 `source: "action"` 本機事件。這會根據該操作觸發所有查詢鍵的**即時、樂觀的重新取得**，從而避免視覺延遲。
+- **背景或代理突變：** 當 AI 代理、Webhook 或背景工作人員突變資料時，更新會廣播到用戶端。用戶端的 `useDbSync` 可以立即透過 SSE（伺服器傳送的事件）捕獲此資訊，也可以回退到 **2 秒輪詢滴答**。然後查詢金鑰版本會發生變化，從而觸發背景重新取得。
 
-```an-diagram title="重新獲取的兩條路徑" summary="本機突變會立即使自己的快取失效；遠端寫入通過 SSE 到達此分頁，或作為後備的輪詢標記。"
+```an-diagram title="重新取得的兩條路徑" summary="本機突變會立即使自己的快取失效；遠端寫入透過 SSE 到達此分頁，或作為後備的輪詢標記。"
 {
   "html": "<div class=\"diagram-latency\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">此標籤頁面</span><strong>useActionMutation</strong><small class=\"diagram-muted\">fires source: \"action\" on success &rarr; instant local refetch</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">代理 · webhook · 其他標籤頁面</span><strong>遠端寫入</strong><small class=\"diagram-muted\">SSE push, or the ~2s polling tick as fallback &rarr; version bumps &rarr; background refetch</small></div></div></div>",
   "css": ".diagram-latency .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-latency .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px}"
@@ -385,7 +385,7 @@ function DashboardView({ id }) {
 
 ## cn（...輸入） {#cn}
 
-合並類名的實用程序（clsx + tailwind-merge）：
+合併類名的實用程式（clsx + tailwind-merge）：
 
 ```ts
 import { cn } from "@agent-native/core/client";

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

@@ -5,30 +5,30 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 
 # 範本
 
-想要發布您自己的人工智能分析工具嗎？郵件用戶端？表格生成器？選取一個範本，您只需幾分鐘即可獲得一個可執行的 SaaS — 代理、資料庫、驗證和部署管道已連線完畢。
+想要發布您自己的人工智慧分析工具嗎？郵件用戶端？表格生成器？選取一個範本，您只需幾分鐘即可獲得一個可執行的 SaaS — 代理、資料庫、驗證和部署管道已連線完畢。
 
-大多數“範本”都會為您提供一個空白的腳手架和一個很長的 TODO 列表。代理本機翻轉了這一點。每一個都是**完整的 SaaS 級產品** - 在第一天就已經可以執行，已經可以發貨，並且完全由您來定制、品牌化和部署。將它們視為可克隆的 SaaS，而不是入門工具包：您正在分叉成品，而不是盯著樣板檔案。
+大多數“範本”都會為您提供一個空白的腳手架和一個很長的 TODO 清單。Agent-Native 翻轉了這一點。每一個都是**完整的 SaaS 級產品** - 在第一天就已經可以執行，已經可以發貨，並且完全由您來定制、品牌化和部署。將它們視為可克隆的 SaaS，而不是入門工具包：您正在分叉成品，而不是盯著樣板檔案。
 
 ## 可用範本 {#catalog}
 
 每一個都是您今天可以使用的真實應用程式，以及您自己版本的啟動板。
 
-| 範本                                      | 它是什么                                                                                      |
-| ----------------------------------------- | --------------------------------------------------------------------------------------------- |
-| [**Chat**](/docs/template-chat)           | 最小的聊天優先應用程式，具有持久線程、actions、驗證以及通往自訂 UI 或您自己的後端的幹淨路徑。 |
-| [**Mail**](/docs/template-mail)           | 特工本機超人。收件箱、標籤、人工智能分類、鍵盤優先、通過代理起草和發送。                      |
-| [**Calendar**](/docs/template-calendar)   | 本機代理 Google Calendar。活動、同步、公開預訂連結、代理驅動的調度。                          |
-| [**Content**](/docs/template-content)     | MDX 的開來源黑曜石。本機Markdown/MDX、Tiptap編輯器、Notion同步、實時多使用者協作。            |
-| [**Brain**](/docs/template-brain)         | 幹淨的公司聊天由引用的機構記憶、批準的來源、審查門和引文支持。                                |
-| [**Assets**](/docs/template-assets)       | 用於品牌庫、上傳、參考和品牌圖片/影片生成的數字資產管理器。                                   |
-| [**Slides**](/docs/template-slides)       | 代理原生 Google 幻燈片。基於React的套牌由代理直接生成和編輯。                                 |
-| [**Video**](/docs/template-videos)        | Remotion 上的程序化動態圖形和產品演示影片。                                                   |
-| [**Analytics**](/docs/template-analytics) | 代理本機振幅/混合面板。連線資料來源、提示圖表、固定到儀表板。                                 |
-| [**Clips**](/docs/template-clips)         | 非同步螢幕+攝像頭錄製，包含轉錄、章節和 AI 摘要。                                             |
-| [**Design**](/docs/template-design)       | Agent 原生 HTML 原型工作室，用於互動式 Alpine/Tailwind 設計。                                 |
-| [**Forms**](/docs/template-forms)         | 代理原生 Typeform。建置、共用、收集提交內容並將其路由到 Slack、表格、webhooks 或 Discord。    |
-| [**Plan**](/docs/template-plan)           | 帶有圖表、線框圖和注釋的視覺計畫和公關概述。                                                  |
-| [**Dispatch**](/docs/template-dispatch)   | 工作區控制平面：共用秘密、可重用整合、Slack/Telegram、計畫作業。                              |
+| 範本                                      | 它是什麼                                                                                        |
+| ----------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| [**Chat**](/docs/template-chat)           | 最小的聊天優先應用程式，具有持久對話串、actions、驗證以及通往自訂 UI 或您自己的後端的幹淨路徑。 |
+| [**Mail**](/docs/template-mail)           | Agent-Native 超人。收件箱、標籤、人工智慧分類、鍵盤優先、透過代理起草和傳送。                   |
+| [**Calendar**](/docs/template-calendar)   | 本機代理 Google Calendar。活動、同步、公開預訂連結、代理驅動的調度。                            |
+| [**Content**](/docs/template-content)     | MDX 的開放原始碼黑曜石。本機 Markdown/MDX、Tiptap 編輯器、Notion 同步、即時多使用者協作。       |
+| [**Brain**](/docs/template-brain)         | 幹淨的公司聊天由引用的機構記憶、核准的來源、審查門和引文支援。                                  |
+| [**Assets**](/docs/template-assets)       | 用於品牌庫、上傳、參考和品牌圖片/影片產生的數位資產管理器。                                     |
+| [**Slides**](/docs/template-slides)       | Agent-Native Google 幻燈片。基於 React 的簡報由代理直接生成和編輯。                             |
+| [**Video**](/docs/template-videos)        | Remotion 上的程式化動態圖形和產品示範影片。                                                     |
+| [**Analytics**](/docs/template-analytics) | Agent-Native 振幅/混合面板。連線資料來源、提示圖表、固定到儀表板。                              |
+| [**Clips**](/docs/template-clips)         | 非同步螢幕+攝影機錄製，包含轉錄、章節和 AI 摘要。                                               |
+| [**Design**](/docs/template-design)       | Agent 原生 HTML 原型工作室，用於互動式 Alpine/Tailwind 設計。                                   |
+| [**Forms**](/docs/template-forms)         | Agent-Native Typeform。建置、共用、收集提交內容並將其路由到 Slack、表格、webhooks 或 Discord。  |
+| [**Plan**](/docs/template-plan)           | 帶有圖表、線框圖和註解的視覺計畫和 PR 概述。                                                    |
+| [**Dispatch**](/docs/template-dispatch)   | 工作區控制平面：共用秘密、可重用整合、Slack/Telegram、計畫作業。                                |
 
 不需要域範本？當您想要一個使用者可以立即交談的基本應用程式時，請使用 [Chat](/docs/template-chat)，或者使用 [Pure-Agent Apps](/docs/pure-agent-apps) 首先開始操作。
 
@@ -38,20 +38,20 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 
 每個範本都附帶通常需要數月才能建置的部件：
 
-- **工作代理** — 已經連線到應用程式，已經能夠在您的資料上獲取 actions，已經能夠了解您正在檢視的內容。請參閱 [Messaging the agent](/docs/messaging) 了解其工作原理。
+- **工作代理** — 已經連線到應用程式，已經能夠在您的資料上取得 actions，已經能夠了解您正在檢視的內容。請參閱 [Messaging the agent](/docs/messaging) 了解其工作原理。
 - **Auth** — 登入、工作階段、組織、多租戶隔離。已經完成了。
 - **資料庫** — 每個範本都有其架構、查詢和遷移準備就緒。帶上您自己的 SQL 資料庫（Postgres、SQLite、Turso、D1）——框架會進行調整。
-- **實時 UI** — 螢幕與代理的操作保持同步。在聊天中點擊“草稿電子郵件”，草稿立即出現在您的收件箱中。
+- **即時 UI** — 螢幕與代理的操作保持同步。在聊天中點選“草稿電子郵件”，草稿立即出現在您的收件箱中。
 - **部署就緒** — 推送到 Netlify、Vercel、Cloudflare、AWS 或執行 Node.js 的任何其他地方。沒有供應商鎖定。
 - **品牌掛鉤** - 名稱、顏色、徽標、文案都很容易更改。
 
-這不是理論上的主張。該框架的作者在郵件範本上執行他的實際收件箱，在行事曆範本上執行他的實際行事曆，在分析範本上執行他的實際分析。範本是日常驅動軟件。
+這不是理論上的主張。此框架的作者在郵件範本上執行他的實際收件箱，在行事曆範本上執行他的實際行事曆，在分析範本上執行他的實際分析。範本是日常驅動軟體。
 
-## 你做什么 {#what-you-do}
+## 你做什麼 {#what-you-do}
 
 從“我想要自己的 SaaS”到“我擁有自己的 SaaS”的路徑很短：
 
-```an-diagram title="分叉並定制" summary="選取一個成品，對其進行品牌化，用簡單的英語對其進行改進，然後將其發送到您自己的域。"
+```an-diagram title="分叉並定制" summary="選取一個成品，對其進行品牌化，用簡單的英語對其進行改進，然後將其傳送到您自己的域。"
 {
   "html": "<div class=\"diagram-fork\"><div class=\"diagram-card\"><span class=\"diagram-pill\">1</span><strong>Pick</strong><small class=\"diagram-muted\">a complete template</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2</span><strong>Brand</strong><small class=\"diagram-muted\">名稱、顏色、Logo、文案</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">3</span><strong>Customize</strong><small class=\"diagram-muted\">ask the agent &#8635;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">4</span><strong>Ship</strong><small class=\"diagram-muted\">your own domain</small></div></div>",
   "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px}.diagram-fork .diagram-arrow{font-size:22px;line-height:1}"
@@ -59,22 +59,22 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 ```
 
 1. **選取一個範本。**使用 CLI 選取器，或瀏覽檔案並選取一個開始。
-2. **打造品牌。**更改名稱、顏色、徽標和文案。大多數範本都將其公開在單個設定檔案中。
-3. **自訂它。** 要求代理新增您需要的列，更改收件箱分組的方式，連線到您的內部 API，新增新視圖。代理編輯程式碼；您檢視差異。
+2. **打造品牌。**更改名稱、顏色、徽標和文案。大多數範本都將其公開在單一設定檔案中。
+3. **自訂它。** 要求代理新增您需要的列，更改收件箱分組的方式，連線到您的內部 API，新增新檢視。代理編輯程式碼；您檢視差異。
 4. **發貨。**執行部署指令。您現在在自己的域中擁有自己的正式環境 SaaS。
 
-步驟 2-4 通常需要幾天而不是幾個月的時間。第 3 步是開放式的 - 通過與代理交談，用簡單的英語來說，您的分叉 SaaS 會隨著時間的推移而發展。
+步驟 2-4 通常需要幾天而不是幾個月的時間。第 3 步是開放式的 - 透過與代理交談，用簡單的英語來說，您的分叉 SaaS 會隨著時間的推移而發展。
 
-## 為什么這是實用的 {#why}
+## 為什麼這是實用的 {#why}
 
-傳統的程式碼庫分叉模型會大規模當機：每個使用者維護自己的收件箱听起來像是一場維護噩夢。兩個框架決策使其發揮作用：
+傳統的程式碼庫分叉模型會大規模當機：每個使用者維護自己的收件箱聽起來像是一場維護噩夢。兩個框架決策使其發揮作用：
 
 1. **代理進行維護。**您無需編寫程式碼來新增列或連線新的整合 - 您可以詢問代理。所以“你自己的分叉收件箱”是一個功能，而不是一個負擔。
-2. **每使用者自訂，無需每使用者程式碼。** Skills、內存、指令、連線的 MCP 伺服器和子代理都位於 SQL 中。每個使用者都有自己的定制層；共用程式碼庫同時託管所有這些內容。
+2. **每使用者自訂，無需每使用者程式碼。** Skills、記憶、指令、連線的 MCP 伺服器和子代理都位於 SQL 中。每個使用者都有自己的定制層；共用程式碼庫同時託管所有這些內容。
 
 結果：Claude - 每個使用者的程式碼級靈活性，以及正常的 SaaS 部署經濟性。
 
-```an-diagram title="為什么每使用者分叉規模" summary="有兩個想法使分叉和定制模型保持實用：代理進行維護，每個使用者的定制位於 SQL 中，而不是每個使用者的程式碼中。"
+```an-diagram title="為什麼每使用者分叉規模" summary="有兩個想法使分叉和定制模型保持實用：代理進行維護，每個使用者的定制位於 SQL 中，而不是每個使用者的程式碼中。"
 {
   "html": "<div class=\"diagram-why\"><div class=\"diagram-panel\" data-rough><strong>分享d codebase</strong><small class=\"diagram-muted\">一個應用，一次部署</small><div class=\"diagram-pill accent\">agent does the maintenance</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>SQL 中的使用者層</strong><small class=\"diagram-muted\">skills · 記憶 · 指令 · MCP · 子代理</small><div class=\"diagram-pill ok\">no per-user code</div></div></div>",
   "css": ".diagram-why{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-why .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 18px;min-width:240px;flex:1}.diagram-why .diagram-arrow{font-size:24px;line-height:1}"
@@ -87,7 +87,7 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 
 ## 嘗試一下技巧 {#try-with-a-skill}
 
-還沒有準備好搭建腳手架嗎？您可以使用單個指令將代理本機超級功能新增到已使用的編碼代理中 - 無需應用程式。請參閱 [Skills Guide](/docs/skills-guide#app-backed-skills)。
+還沒有準備好搭建腳手架嗎？您可以使用單一指令將 Agent-Native 超級功能新增到已使用的編碼代理中 - 無需應用程式。請參閱 [Skills Guide](/docs/skills-guide#app-backed-skills)。
 
 ## 在此基礎上建置
 
@@ -109,6 +109,6 @@ npx @agent-native/core@latest create my-platform
 
 填寫`.env`（主要是`ANTHROPIC_API_KEY`和`DATABASE_URL`）、`pnpm install`、`pnpm dev`，就可以了。沒有“TODO：實現登入”，沒有預留位置路由。
 
-部署目標：任何 Nitro 兼容主機（Node、Cloudflare、Netlify、Vercel、Deno、Lambda、Bun）和任何 Drizzle 兼容 SQL 資料庫（SQLite、Postgres、Turso、D1、Supabase、Neon）。對於工作區，`npx @agent-native/core@latest deploy` 一次建置每個應用程式並將它們發送到單個來源。參見[Deployment](/docs/deployment)。
+部署目標：任何 Nitro 相容主機（Node、Cloudflare、Netlify、Vercel、Deno、Lambda、Bun）和任何 Drizzle 相容 SQL 資料庫（SQLite、Postgres、Turso、D1、Supabase、Neon）。對於工作區，`npx @agent-native/core@latest deploy` 一次建置每個應用程式並將它們傳送到單一來源。參見[Deployment](/docs/deployment)。
 
 要創作和發布您自己的範本，請參閱 [Creating Templates](/docs/creating-templates)。