@agent-native/core 0.79.11 → 0.79.15

package/docs/content/locales/zh-TW/creating-templates.md

@@ -1,18 +1,18 @@
 ---
 title: "建立範本"
-description: "如何建立和發布您自己的代理本機應用範本。"
+description: "如何建立和發布您自己的 Agent-Native 應用範本。"
 ---
 
 # 建立範本
 
-範本是完整的、可分叉的代理本機應用程式，可解決實際工作流程。第一方範本使用您使用的相同框架表面建置：用於 UI 的 React 路由、用於資料的 Drizzle SQL、用於操作的 actions、用於代理行為的工作區資源以及輪詢同步，以便代理和 UI 保持一致。
+範本是完整的、可分叉的 Agent-Native 應用程式，可解決實際工作流程。第一方範本使用您使用的相同框架表面建置：用於 UI 的 React 路由、用於資料的 Drizzle SQL、用於操作的 actions、用於代理行為的工作區資源以及輪詢同步，以便代理和 UI 保持一致。
 
 一個好的範本：
 
 - 使用有用的種子資料或空狀態流端對端地解決一個工作流。
-- 將持久狀態存儲在 SQL 中，而不是 JSON 檔案中。
+- 將持久狀態儲存在 SQL 中，而不是 JSON 檔案中。
 - 將應用操作定義為 `defineAction()` actions。
-- 通過應用程式狀態公開導覽和選取。
+- 透過應用程式狀態公開導覽和選取。
 - 為不明顯的工作流程提供清晰的 `AGENTS.md` 和重點 skills。
 - 註冊所需提供者和機密的加入步驟。
 - 作為獨立應用和多應用工作區的一部分工作。
@@ -31,7 +31,7 @@ npx @agent-native/core@latest create my-template --template chat --standalone
 npx @agent-native/core@latest create my-platform
 ```
 
-聊天為您提供驗證、持久聊天線程、SQL 支持的資源、工具、應用程式狀態、actions 和輪詢同步。您新增域模型和產品 UI。
+聊天為您提供驗證、持久聊天對話串、SQL 支援的資源、工具、應用程式狀態、actions 和輪詢同步。您新增域模型和產品 UI。
 
 如果您尚未建置可重複使用的 UI 範本，請使用 [Getting Started](/docs/getting-started#1-create-your-app) 中的無頭入口：定義一個操作，使用 `pnpm agent` 執行它，並在工作流程需要耐用表面時新增 UI。
 
@@ -63,20 +63,20 @@ npx @agent-native/core@latest create my-platform
 }
 ```
 
-不要為應用程式狀態新增 `data/` 目錄。持久應用資料屬於 SQL，UI 通過 actions 或型別化伺服器處理程序讀取它。
+不要為應用程式狀態新增 `data/` 目錄。持久應用資料屬於 SQL，UI 透過 actions 或型別化伺服器處理常式讀取它。
 
-每個範本的四個區域通過一個共用操作介面和一個 SQL 資料庫連線在一起 - 代理和 UI 是執行相同操作的平等合作伙伴：
+每個範本的四個區域透過一個共用操作介面和一個 SQL 資料庫連線在一起 - 代理和 UI 是執行相同操作的平等合作伙伴：
 
-```an-diagram title="範本的四個區域如何連線" summary="UI 和代理都通過相同的操作到達 SQL；應用程式狀態和輪詢同步使它們保持一致。"
+```an-diagram title="範本的四個區域如何連線" summary="UI 和代理都透過相同的操作到達 SQL；應用程式狀態和輪詢同步使它們保持一致。"
 {
-  "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">React 介面<br><small class=\"diagram-muted\">app/routes · 元件</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">AGENTS.md · skills</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">行動</span><small class=\"diagram-muted\">defineAction()</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>通過 Drizzle 使用 SQL<br><small class=\"diagram-muted\">additive schema</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">輪詢ing sync</div></div>",
+  "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">React 介面<br><small class=\"diagram-muted\">app/routes · 元件</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">AGENTS.md · skills</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">行動</span><small class=\"diagram-muted\">defineAction()</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>透過 Drizzle 使用 SQL<br><small class=\"diagram-muted\">additive schema</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">輪詢ing sync</div></div>",
   "css": ".diagram-tmpl{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-tmpl .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-tmpl .diagram-arrow{font-size:22px;line-height:1}.diagram-tmpl .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
 
-## SQL中的模型資料 {#data-models}
+## SQL 中的模型資料 {#data-models}
 
-使用框架 Drizzle 幫助程序定義域表，以便架構在 SQLite、Postgres、D1、Turso、Supabase、Neon 和其他支持的後端之間保持可移植性：
+使用框架 Drizzle 幫助程式定義域表，以便架構在 SQLite、Postgres、D1、Turso、Supabase、Neon 和其他支援的後端之間保持可移植性：
 
 ```ts
 // server/db/schema.ts
@@ -106,9 +106,9 @@ export const projects = table("projects", {
 export const projectShares = createSharesTable("project_shares");
 ```
 
-架構更改必須是附加的。 `server/plugins/db.ts`中通過`runMigrations()`新增表和列；切勿使用破壞性的 SQL、`drizzle-kit push`、表重命名或列刪除。
+架構更改必須是附加的。 `server/plugins/db.ts`中透過`runMigrations()`新增表和列；切勿使用破壞性的 SQL、`drizzle-kit push`、表重新命名或列刪除。
 
-對於應用程式讀取和寫入，請使用 Drizzle 的查詢生成器和 `drizzle-orm` 的可移植運算符。當Drizzle可以表達查詢時，不要使用原始SQL編寫產品程式碼，並且不要在範本中從`drizzle-orm/sqlite-core`或`drizzle-orm/pg-core`匯入。
+對於應用程式讀取和寫入，請使用 Drizzle 的查詢生成器和 `drizzle-orm` 的可移植運算符。當 Drizzle 可以表達查詢時，不要使用原始 SQL 編寫產品程式碼，並且不要在範本中從`drizzle-orm/sqlite-core`或`drizzle-orm/pg-core`匯入。
 
 ```ts
 // server/plugins/db.ts
@@ -139,7 +139,7 @@ export default runMigrations(
 
 ## 將操作定義為行動 {#actions}
 
-行動 是應用行為的單一事實來源。代理將它們作為工具調用，前端通過鉤子調用它們，其他應用程式可以通過 MCP/A2A 存取它們。
+行動 是應用行為的單一事實來源。代理將它們作為工具呼叫，前端透過鉤子呼叫它們，其他應用程式可以透過 MCP/A2A 存取它們。
 
 ```an-annotated-code title="actions/create-project.ts"
 {
@@ -148,18 +148,18 @@ export default runMigrations(
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { getDb } from \"../server/db/index.js\";\nimport { nanoid } from \"nanoid\";\nimport { z } from \"zod\";\nimport * as schema from \"../server/db/schema\";\n\nexport default defineAction({\n  description: \"Create a project.\",\n  schema: z.object({\n    title: z.string().min(1).describe(\"Project title\"),\n  }),\n  run: async ({ title }, ctx) => {\n    const db = getDb();\n    const id = nanoid();\n    await db.insert(schema.projects).values({\n      id,\n      title,\n      ownerEmail: ctx.userEmail,\n      orgId: ctx.orgId,\n    });\n    return { id, title };\n  },\n});",
   "annotations": [
     { "lines": "2", "note": "`getDb` is created per app via `createGetDb(schema)` in `server/db/index.ts`." },
-    { "lines": "8", "label": "工具表面", "note": "`description` 是代理讀取的內容，以決定何時將此操作作為工具調用。" },
+    { "lines": "8", "label": "工具表面", "note": "`description` 是代理讀取的內容，以決定何時將此操作作為工具呼叫。" },
     { "lines": "9-11", "label": "型別化契約", "note": "一個 zod `schema` 會驗證來自代理、UI、HTTP、MCP 和 A2A 的輸入。" },
     { "lines": "18-19", "label": "範圍寫入", "note": "從 `ctx` 標記 `ownerEmail` / `orgId`，以便該行正確地確定共用和存取檢查的範圍。" }
   ]
 }
 ```
 
-使用 `http: { method: "GET" }` 或 `readOnly: true` 表示唯讀 actions。僅將 `parallelSafe: true` 用於變異 actions，這些 actions 可以安全地與同輪工具調用同時執行。將 `toolCallable: false` 用於不應從沙盒工具執行的高爆炸半徑 actions。
+使用 `http: { method: "GET" }` 或 `readOnly: true` 表示唯讀 actions。僅將 `parallelSafe: true` 用於變異 actions，這些 actions 可以安全地與同輪工具呼叫同時執行。將 `toolCallable: false` 用於不應從沙盒工具執行的高爆炸半徑 actions。
 
 ## 建置 UI {#ui}
 
-路由位於 `app/routes/` 中並使用 React Router v8 檔案路由。通過actions或API處理程序查詢資料，並預設使突變樂觀。
+路由位於 `app/routes/` 中並使用 React Router v8 檔案路由。透過actions或 API 處理常式查詢資料，並預設使突變樂觀。
 
 ```tsx
 import { useActionMutation, useActionQuery } from "@agent-native/core/client";
@@ -176,7 +176,7 @@ export default function ProjectsPage() {
 }
 ```
 
-在應用程式 shell 附近連線一次實時同步，以便在代理、另一個分頁或操作更改資料時刷新 React 查詢快取：
+在應用程式 shell 附近連線一次即時同步，以便在代理、另一個分頁或操作更改資料時重新整理 React 查詢快取：
 
 ```tsx
 import { useDbSync } from "@agent-native/core/client";
@@ -189,7 +189,7 @@ export function AppSync() {
 }
 ```
 
-**代理原生承諾：代理寫入顯示在 UI 中，無需手動刷新。** `useActionQuery` 是簡單路徑 - 當變異操作發出 `source: "action"` 時，每個鉤子都會重新獲取。如果您使用自訂金鑰（例如，讀取整合狀態的低級用戶端幫助程序）獲取原始 `useQuery`，請將每個來源計數器折疊到 queryKey 中以進行有針對性的刷新：
+**Agent-Native 承諾：代理寫入顯示在 UI 中，無需手動重新整理。** `useActionQuery` 是簡單路徑 - 當變異操作發出 `source: "action"` 時，每個鉤子都會重新取得。如果您使用自訂金鑰（例如，讀取整合狀態的低階用戶端幫助程式）取得原始 `useQuery`，請將每個來源計數器折疊到 queryKey 中以進行有針對性的重新整理：
 
 ```tsx
 import { useChangeVersions } from "@agent-native/core/client";
@@ -202,14 +202,14 @@ useQuery({
 });
 ```
 
-常見來源：`"action"`（每個成功的代理操作 - 可靠的後備）、`"app-state"`、`"settings"`，以及您的商店通過 `recordChange` 發出的任何自訂資源來源。完整模式請參見 `real-time-sync` 技能。
+常見來源：`"action"`（每個成功的代理操作 - 可靠的後備）、`"app-state"`、`"settings"`，以及您的商店透過 `recordChange` 發出的任何自訂資源來源。完整模式請參見 `real-time-sync` 技能。
 
 ## 新增應用程式狀態 {#application-state}
 
 應用程式狀態是代理如何了解使用者所看到的內容。至少新增：
 
 - 一個 UI 鉤子，當路由、所選紀錄、活動分頁或編輯器選取發生更改時，它會寫入語義 `navigation` 狀態。
-- 讀取該狀態並返回目前螢幕快照的 `view-screen` 操作。
+- 讀取該狀態並返回目前螢幕截圖的 `view-screen` 操作。
 - 一個 `navigate` 操作，寫入一次性 `navigate` 指令以供 UI 使用。
 
 使用 `useAgentRouteState` 作為 UI 掛鉤，以便應用程式狀態寫入、分頁範圍指令讀取、讀取後刪除和重複指令保護保持一致：
@@ -232,7 +232,7 @@ export function useNavigationState() {
 }
 ```
 
-在 URL 查詢參數中保留可共用過濾器。框架將它們公開為 `<current-url>` 代理，內置代理可以使用 `set-search-params` 更改它們； `navigation` 應儲存語義 ID 和別名，而不是完整查詢字串的第二個副本。
+在 URL 查詢參數中保留可共用過濾器。框架將它們公開為 `<current-url>` 代理，內建代理可以使用 `set-search-params` 更改它們； `navigation` 應儲存語義 ID 和別名，而不是完整查詢字串的第二個副本。
 
 對於應用導覽，首選包含同來源的 `navigate` 指令
 `path`（當 URL 已知時）。同一動作不要寫為 `__set_url__`；
@@ -262,14 +262,14 @@ export default defineAction({
 
 ## 謹慎使用 API 路由 {#api-routes}
 
-首選 actions 進行應用操作。僅為無法幹淨地成為 actions 的表面建立自訂 Nitro 路線：
+首選 actions 進行應用操作。僅為無法幹淨地成為 actions 的表面建立自訂 Nitro 路由：
 
 - 檔案上傳或二進制流。
 - 公開匿名頁面和webhooks。
-- OAuth 回呼和特定於提供者的協議處理程序。
+- OAuth 回呼和特定於提供者的協議處理常式。
 - 伺服器渲染的公開內容。
 
-在使用存取助手之前，接觸可擁有資料的自訂路由必須調用 `getSession(event)` 並將資料庫工作包裝在 `runWithRequestContext({ userEmail, orgId }, fn)` 中。
+在使用存取助手之前，接觸可擁有資料的自訂路由必須呼叫 `getSession(event)` 並將資料庫工作包裝在 `runWithRequestContext({ userEmail, orgId }, fn)` 中。
 
 ## 編寫代理指令 {#write-agents-md}
 
@@ -284,7 +284,7 @@ One workspace for projects, tasks, and notes.
 
 ## 核心規則
 
-- Data lives in 通過 Drizzle 使用 SQL. Use actions for all writes; schema is additive.
+- Data lives in 透過 Drizzle 使用 SQL. Use actions for all writes; schema is additive.
 - Use `view-screen` before acting on "this project" if the screen is unclear.
 
 ## 應用狀態
@@ -300,15 +300,15 @@ One workspace for projects, tasks, and notes.
 | `create-project` | Create a project         |
 ```
 
-每當新增新操作、路線、狀態鍵或重複操作時更新 `AGENTS.md`
+每當新增新操作、路由、狀態鍵或重複操作時更新 `AGENTS.md`
 工作流程。 [Writing Agent Instructions](/docs/writing-agent-instructions) 是
-完整指南 - 如何保持 `AGENTS.md` 可略讀，這四個分別屬於什么
+完整指南 - 如何保持 `AGENTS.md` 可略讀，這四個分別屬於什麼
 指導面，以及如何表達技能和工具描述，以便代理
 可靠地觸發它們。
 
 ## 新增Skills {#skills}
 
-使用 skills 來獲取會使 `AGENTS.md` 膨脹的詳細模式：特定於提供者的 API、匯入/匯出格式、複雜的編輯流程或域術語。
+使用 skills 來取得會使 `AGENTS.md` 膨脹的詳細模式：特定於提供者的 API、匯入/匯出格式、複雜的編輯流程或域術語。
 
 ```markdown
 ---
@@ -327,7 +327,7 @@ Use this skill when the user uploads a legacy project CSV.
 - Save rejected rows as a note attached to the import summary.
 ```
 
-將範本 skills 存儲在 `.agents/skills/<name>/SKILL.md` 中。如果使用者應該能夠在執行時編輯指南，也可以通過工作區資源來顯示它。
+將範本 skills 儲存在 `.agents/skills/<name>/SKILL.md` 中。如果使用者應該能夠在執行時編輯指南，也可以透過工作區資源來顯示它。
 
 ## 註冊設定步驟 {#onboarding}
 
@@ -370,23 +370,23 @@ export default defineNitroPlugin(() => {
 
 清單：
 
-- 通過框架代理聊天外掛或 `mountA2A()` 掛載 A2A，以便同級應用程式可以調用您的代理。
+- 透過框架代理聊天外掛或 `mountA2A()` 掛載 A2A，以便同級應用程式可以呼叫您的代理。
 - 保持代理卡描述足夠具體，以便 Dispatch 準確地安排工作。
 - 註冊所需的機密/加入，以便設定出現在側欄中，並且 Dispatch 可以管理共用憑證。
 - 將橫切指令保留在工作區 `AGENTS.md` 或工作區資源中，而不是複製到每個應用程式中。
-- 對所有可擁有的資源使用共用/存取幫助程序，以便組織範圍內的工作空間保持隔離。
+- 對所有可擁有的資源使用共用/存取幫助程式，以便組織範圍內的工作空間保持隔離。
 
 ## 發布範本 {#publishing}
 
 分享之前：
 
 1. 執行 `pnpm install`、`pnpm typecheck` 和範本的測試。
-2. 驗證其是否可以在未設定可選提供程序金鑰的情況下正常工作。
+2. 驗證其是否可以在未設定可選提供者金鑰的情況下正常工作。
 3. 檢查驗證、共用和兩個使用者資料隔離。
 4. 紀錄所需的環境變數和入門步驟。
-5. 通過附加遷移包含範例或種子行，而不是跟蹤的執行時資料檔案。
+5. 透過附加遷移包含範例或種子行，而不是跟蹤的執行時資料檔案。
 
-可以從 GitHub 儲存庫建立社區範本：
+可以從 GitHub 儲存庫建立社群範本：
 
 ```bash
 npx @agent-native/core@latest create my-app --template github:user/repo
@@ -398,14 +398,14 @@ npx @agent-native/core@latest create my-app --template github:user/repo
 
 當您在框架 monorepo 中工作並需要生成時
 工作區使用未發布的包或範本更改，使用
-本機包標志：
+本機包標誌：
 
 ```bash
 AGENT_NATIVE_CREATE_USE_LOCAL_CORE=1 pnpm --filter @agent-native/core create my-platform
 ```
 
-生成的工作空間連結本機`@agent-native/core`和
-`@agent-native/dispatch` 軟件包，因此更改為 Core API、Dispatch 工作區
+產生的工作空間連結本機`@agent-native/core`和
+`@agent-native/dispatch` 套件，因此更改為 Core API、Dispatch 工作區
 可以在發布之前測試行為或第一方範本。包裹
-`prepack` 腳本在連結之前建置 `dist`，這會保留生成的
+`prepack` 指令碼在連結之前建置 `dist`，這會保留產生的
 工作空間指向目前建置輸出。

package/docs/content/locales/zh-TW/cross-app-sso.md

@@ -1,39 +1,39 @@
 ---
-title: "跨應用SSO"
-description: "使用 Dispatch 作為身分授權，通過身分聯合在每個託管代理本機應用程式中登入一次 - 每個應用程式選取加入，可通過單個環境變數進行逆轉。"
+title: "跨應用 SSO"
+description: "使用 Dispatch 作為身分授權，透過身分聯合在每個託管 Agent-Native 應用程式中登入一次 - 每個應用程式選取加入，可透過單一環境變數進行逆轉。"
 ---
 
-# 跨應用SSO
+# 跨應用 SSO
 
-`*.agent-native.com` 上的每個託管應用程式都使用其**自己的獨立使用者存儲**執行自己的部署。 `mail.agent-native.com`和`calendar.agent-native.com`不共用資料庫、工作階段表或cookie域。因此，“登入一次，使用每個應用程式”不能是共用 cookie — 它必須是**身分聯合**，其中 [Dispatch](/docs/dispatch) 充當工作區的身分授權機構。
+`*.agent-native.com` 上的每個託管應用程式都使用其**自己的獨立使用者儲存**執行自己的部署。 `mail.agent-native.com`和`calendar.agent-native.com`不共用資料庫、工作階段表或cookie域。因此，“登入一次，使用每個應用程式”不能是共用 cookie — 它必須是**身分聯合**，其中 [Dispatch](/docs/dispatch) 充當工作區的身分授權機構。
 
-這與 [A2A](/docs/a2a-protocol) 和 [External Agents](/docs/external-agents) 已經使用的信任原語相同 - 在請求邊界驗證的 `A2A_SECRET` 簽名的 JWT - 應用於人工登入路徑，而不是代理到代理的調用。
+這與 [A2A](/docs/a2a-protocol) 和 [External Agents](/docs/external-agents) 已經使用的信任原語相同 - 在請求邊界驗證的 `A2A_SECRET` 簽名的 JWT - 應用於人工登入路徑，而不是代理到代理的呼叫。
 
-> **統一部署與每個域部署。** 如果您在一個來源（`your-agents.com/mail`、`your-agents.com/calendar`）託管所有應用程式，您已經通過單個 cookie 域獲得共用登入 - 無需聯合。僅當應用程式在不同的域上執行時，才需要跨應用程式 SSO。參見[Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)。
+> **統一部署與每個域部署。** 如果您在一個來源（`your-agents.com/mail`、`your-agents.com/calendar`）託管所有應用程式，您已經透過單一 cookie 域獲得共用登入 - 無需聯合。僅當應用程式在不同的域上執行時，才需要跨應用程式 SSO。參見[Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)。
 
-## 什么以及為什么 {#what-why}
+## 什麼以及為什麼 {#what-why}
 
-每個應用程式的使用者存儲意味著瀏覽器 cookie 沒有一個可以被每個應用程式信任的地方。相反，聯合模型將一個應用程式命名為 **Dispatch** 作為身分授權機構。任何其他應用程式都可以委托“這個人是誰？”要調度，取回使用者已驗證電子郵件的短暫簽名斷言，然後**通過電子郵件將其連結到其自己的本機帳戶**。
+每個應用程式的使用者儲存意味著瀏覽器 cookie 沒有一個可以被每個應用程式信任的地方。相反，聯合模型將一個應用程式命名為 **Dispatch** 作為身分授權機構。任何其他應用程式都可以委托“這個人是誰？”要調度，取回使用者已驗證電子郵件的短暫簽名斷言，然後**透過電子郵件將其連結到其自己的本機帳戶**。
 
 連結規則故意狹窄和附加：
 
-- **現有同一電子郵件使用者→連結。**本機帳戶與經過驗證的電子郵件匹配並按原樣重複使用。它**永遠不會被修改、重命名或刪除** - 聯合層只會讀取它並為其建立一個工作階段。
+- **現有同一電子郵件使用者→連結。**本機帳戶與經過驗證的電子郵件匹配並按原樣重複使用。它**永遠不會被修改、重新命名或刪除** - 聯合層只會讀取它並為其建立一個工作階段。
 - **新電子郵件 → 建立。** 為該經過驗證的電子郵件建立一個新的本機帳戶，然後建立一個正常的本機工作階段。
 
-這使得部署安全，即使它會導致人們退出。 **預計會登出。** 當應用程式開啟此功能時，現有工作階段將結束，並且使用者通過 Dispatch 重新進行驗證。但他們總是重新登入**同一個電子郵件匹配帳戶，所有資料都完好無損**，因為身分行只會*新增到* — 永遠不會被銷毀、重命名或重新指向。
+這使得部署安全，即使它會導致人們退出。 **預計會登出。** 當應用程式開啟此功能時，現有工作階段將結束，並且使用者透過 Dispatch 重新進行驗證。但他們總是重新登入**同一個電子郵件匹配帳戶，所有資料都完好無損**，因為身分行只會*新增到* — 永遠不會被銷毀、重新命名或重新指向。
 
 ## 它是如何工作的 {#how-it-works}
 
 該流程是標準授權 → 簽名權杖 → 回調重新導向，其中電子郵件是唯一跨越信任邊界的內容。
 
-```an-diagram title="身分聯合流程" summary="Dispatch 對人員進行驗證，並返回一件事的短暫簽名斷言 - 經過驗證的電子郵件。該應用程式通過電子郵件連結並建立自己的本機工作階段。"
+```an-diagram title="身分聯合流程" summary="Dispatch 對人員進行驗證，並返回一件事的短暫簽名斷言 - 經過驗證的電子郵件。該應用程式透過電子郵件連結並建立自己的本機工作階段。"
 {
-  "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>用戶端應用</strong><small class=\"diagram-muted\">own user store</small></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill\">authorize</span></div><div class=\"diagram-card\" data-rough><strong>Dispatch</strong><small class=\"diagram-muted\">identity authority</small><span class=\"diagram-pill accent\">authenticates human</span></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill accent\">302 + signed JWT</span></div><div class=\"diagram-card\" data-rough><strong>應用回調</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">通過郵箱即時關聯</span><span class=\"diagram-pill ok\">mint local session</span></div></div>",
+  "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>用戶端應用</strong><small class=\"diagram-muted\">own user store</small></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill\">authorize</span></div><div class=\"diagram-card\" data-rough><strong>Dispatch</strong><small class=\"diagram-muted\">identity authority</small><span class=\"diagram-pill accent\">authenticates human</span></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill accent\">302 + signed JWT</span></div><div class=\"diagram-card\" data-rough><strong>應用回調</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">透過信箱即時關聯</span><span class=\"diagram-pill ok\">mint local session</span></div></div>",
   "css": ".diagram-sso{display:flex;align-items:stretch;gap:12px;flex-wrap:wrap}.diagram-sso .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px}.diagram-sso .diagram-step{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px}.diagram-sso .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
-1. **應用程式→調度（授權）。**應用程式將使用者發送到身分授權機構：
+1. **應用程式→調度（授權）。**應用程式將使用者傳送到身分授權機構：
 
    ```
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
@@ -49,7 +49,7 @@ description: "使用 Dispatch 作為身分授權，通過身分聯合在每個
   “summary”：“Dispatch（身分授權）對人員進行驗證並使用簽名的身分權杖重新導向回來”，
   "auth": "調度工作階段（如果沒有則互動式登入）",
   “參數”：[
-    { "name": "app", "in": "query", "type": "string", "required": true, "description": "請求的應用程式標識符。" },
+    { "name": "app", "in": "query", "type": "string", "required": true, "description": "請求的應用程式識別碼。" },
     { "name": "redirect_uri", "in": "query", "type": "string", "required": true, "description": "應用程式回調 URL。根據嚴格的允許清單進行驗證（預設為 `\*.agent-native.com`或 localhost）。" },
     { "name": "state", "in": "query", "type": "string", "required": true, "description": "CSRF 狀態在重新導向上回顯。" }
   ],
@@ -63,20 +63,20 @@ description: "使用 Dispatch 作為身分授權，通過身分聯合在每個
 
    ```
 
-2. **Dispatch 對人員進行驗證。** 如果使用者已有 Dispatch 工作階段，則這是透明的。如果沒有，Dispatch 將顯示其自己的正常登入資訊（電子郵件/密碼、Google 等 — 請參閱 [Authentication](/docs/authentication)）。 Dispatch 只是一個常規的代理原生應用程式；它沒有執行特殊的驗證模式。
+2. **Dispatch 對人員進行驗證。** 如果使用者已有 Dispatch 工作階段，則這是透明的。如果沒有，Dispatch 將顯示其自己的正常登入資訊（電子郵件/密碼、Google 等 — 請參閱 [Authentication](/docs/authentication)）。 Dispatch 只是一個一般的 Agent-Native 應用程式；它沒有執行特殊的驗證模式。
 
-3. **調度→應用程式（簽名身分權杖）。**調度根據嚴格的允許清單驗證`redirect_uri`，並302重新導向回應用程式的`redirect_uri`，攜帶短暫的**`A2A_SECRET`簽名身分JWT**。權杖的聲明故意最小化：
+3. **調度→應用程式（簽名身分權杖）。**調度根據嚴格的允許清單驗證`redirect_uri`，並302重新導向回應用程式的`redirect_uri`，攜帶短暫的**`A2A_SECRET`簽名身分 JWT**。權杖的聲明故意最小化：
 
    | 聲明         | 含義                                        |
    | ------------ | ------------------------------------------- |
    | `sub`        | 身分機構的穩定使用者ID                      |
    | `email`      | 使用者的**已驗證**電子郵件 - 唯一的加入金鑰 |
-   | `name`       | 顯示名稱（非權威，僅適用於UI）              |
+   | `name`       | 顯示名稱（非權威，僅適用於 UI）             |
    | `org_domain` | 工作空間/組織域（如果存在）                 |
    | `scope`      | 始終為 `"identity"` — 此權杖僅授權登入      |
    | `exp`        | **≤ 2 分鐘** 距問題                         |
 
-4. **應用程式通過電子郵件驗證和 JIT 連結。**應用程式使用自己的 `A2A_SECRET` 驗證權杖簽名，檢查 `scope: "identity"` 和 `exp`，然後嚴格通過經過驗證的電子郵件執行**即時連結**：
+4. **應用程式透過電子郵件驗證和 JIT 連結。**應用程式使用自己的 `A2A_SECRET` 驗證權杖簽名，檢查 `scope: "identity"` 和 `exp`，然後嚴格透過經過驗證的電子郵件執行**即時連結**：
    - 如果具有該電子郵件地址的本機使用者存在 → 不加修改地重新使用它。
    - 如果沒有 → 為該電子郵件建立本機使用者。
 
@@ -99,8 +99,8 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 
 - **短暫的簽名權杖。**身分斷言是 `A2A_SECRET` 簽名的 JWT，具有 **≤ 2 分鐘** 到期時間和 `scope: "identity"`。它授權單次登入，並且不能長時間重播或重新用於 API/A2A 存取。
 - **嚴格的 `redirect_uri` 允許清單。** 預設情況下，調度僅重新導向到 `*.agent-native.com` 或本機主機。任意、方案相關 (`//host`) 和跨域重新導向目標都會被拒絕，因此權限無法轉變為開放重新導向或權杖滲透預言機。
-- **從經過驗證的權杖僅通過電子郵件加入。** 跨越信任邊界的*唯一*事物是簽名權杖中經過驗證的電子郵件。該應用程式不接受來自線路的使用者 ID、角色、組織成員資格或任何特權狀態 - 它從匹配的帳戶在本機派生所有內容。
-- **僅新增身分寫入。**連結可以不受影響地重複使用現有的同一電子郵件帳戶，也可以插入一個新帳戶。此路徑上不會發生任何身分行的更新、重命名、重新指向或刪除。
+- **從經過驗證的權杖僅透過電子郵件加入。** 跨越信任邊界的*唯一*事物是簽名權杖中經過驗證的電子郵件。該應用程式不接受來自線路的使用者 ID、角色、組織成員資格或任何特權狀態 - 它從匹配的帳戶在本機派生所有內容。
+- **僅新增身分寫入。**連結可以不受影響地重複使用現有的同一電子郵件帳戶，也可以插入一個新帳戶。此路徑上不會發生任何身分行的更新、重新命名、重新指向或刪除。
 - **預設情況下關閉。**如果取消設定 `AGENT_NATIVE_IDENTITY_HUB_URL`，則整個功能將處於惰性狀態。
 
 ```an-callout
@@ -114,7 +114,7 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 
 ```an-diagram title="JIT-link 決定" summary="連結以經過驗證的電子郵件為關鍵，並且僅是附加的 - 現有帳戶不變地重複使用，新電子郵件建立新的本機使用者。"
 {
-  "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>已驗證郵箱<br><small class=\"diagram-muted\">來自已簽名身分 JWT</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-branch\"><div class=\"diagram-box\" data-rough>Local user exists?<span class=\"diagram-pill ok\">yes &rarr; reuse unchanged</span><span class=\"diagram-pill accent\">no &rarr; create local user</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>簽發普通本機工作階段</div></div></div>",
+  "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>已驗證信箱<br><small class=\"diagram-muted\">來自已簽名身分 JWT</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-branch\"><div class=\"diagram-box\" data-rough>Local user exists?<span class=\"diagram-pill ok\">yes &rarr; reuse unchanged</span><span class=\"diagram-pill accent\">no &rarr; create local user</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>簽發普通本機工作階段</div></div></div>",
   "css": ".diagram-jit{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-node{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-jit .diagram-branch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-box{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-jit .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -127,17 +127,17 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.yourcompany.com
 ```
 
-**重新導向允許列表。** 集線器（調度）在發出權杖之前驗證授權端點上的 `redirect_uri`。允許名單在`templates/dispatch/server/lib/identity-sso.ts`中設定：
+**重新導向允許清單。** 集線器（調度）在發出權杖之前驗證授權端點上的 `redirect_uri`。允許名單在`templates/dispatch/server/lib/identity-sso.ts`中設定：
 
 - **預設值：** 僅 `*.agent-native.com` 和 localhost（`DEFAULT_ALLOWED_HOST_SUFFIXES` 常量）。
-- **擴充功能它：**在 Dispatch 部署上設定 `IDENTITY_SSO_ALLOWED_HOST_SUFFIXES` 環境變數，並使用逗號分隔的其他主機後綴列表：
+- **擴充功能它：**在 Dispatch 部署上設定 `IDENTITY_SSO_ALLOWED_HOST_SUFFIXES` 環境變數，並使用逗號分隔的其他主機後綴清單：
 
   ```bash
   # 除預設值外還允許 yourcompany.com 子域
   IDENTITY_SSO_ALLOWED_HOST_SUFFIXES=".yourcompany.com,.staging.yourcompany.com"
   ```
 
-  每個條目都被標準化為點前綴後綴 (`.yourcompany.com`)，因此後綴檢查既足夠又最不容易發生 — 無需按應用程式列表保持同步。與所有內容匹配的條目（空或只是 `.`）將被過濾掉。
+  每個條目都被標準化為點前綴後綴 (`.yourcompany.com`)，因此後綴檢查既足夠又最不容易發生 — 無需按應用程式清單保持同步。與所有內容匹配的條目（空或只是 `.`）將被過濾掉。
 
 - 無論 `IDENTITY_SSO_ALLOWED_HOST_SUFFIXES` 為何，**Localhost** 始終允許本機開發用戶端應用程式。
 
@@ -145,7 +145,7 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.yourcompany.com
 
 ## 金絲雀推出執行手冊 {#canary-rollout}
 
-切換和回滾是**每個應用程式部署的單個環境變數**。一次推出一個應用程式，驗證，然後擴充功能。不要同時在每個應用程式上設定變數。
+切換和回滾是**每個應用程式部署的單一環境變數**。一次推出一個應用程式，驗證，然後擴充功能。不要同時在每個應用程式上設定變數。
 
 **1。部署程式碼——沒有行為改變。**
 使用 `AGENT_NATIVE_IDENTITY_HUB_URL` **將版本發布到每個應用程式**到處都未設定\*\*。確認正常登入在幾個應用程式上仍然有效。
@@ -157,13 +157,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.yourcompany.com
 AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 ```
 
-保留所有其他應用程式的環境未設定。重新部署/重新啟動，以便它獲取變數。
+保留所有其他應用程式的環境未設定。重新部署/重新啟動，以便它取得變數。
 
 **3。驗證金絲雀（清單）。**
 
 - 登出應用程式。
 - 登入螢幕現在顯示**“使用 Agent-Native 登入”**。點選它。
-- 您將進入 **Dispatch** 並完成登入（如果已經登入，則直接通過）。
+- 您將進入 **Dispatch** 並完成登入（如果已經登入，則直接透過）。
 - 您將被重新導向**返回應用程式並登入** — 並且它是您之前擁有的**相同的現有帳戶**（同一電子郵件），而不是新帳戶。
 - **應用資料完好無損** — 您的現有紀錄、設定和組織範圍與原來完全相同。
 - **現有的直接登入仍然有效** - 電子郵件/密碼和 Google 登入繼續與 SSO 一起使用。
@@ -174,9 +174,9 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 驗證一個應用程式後，對下一個應用程式重複步驟 2-3 - 一次在一個部署上設定 `AGENT_NATIVE_IDENTITY_HUB_URL`。切勿批量啟用。
 
 **5。回滾 = 取消設定該應用程式部署上的環境變數。**
-要恢復任何應用程式，**從該應用程式的環境中刪除 `AGENT_NATIVE_IDENTITY_HUB_URL` 並重新部署/重新啟動它。**應用程式立即返回到其之前的驗證行為。 **沒有資料更改可以撤消** - 僅新增了標識行，取消設定變數只會使聯合路徑再次休眠。每個應用的割接和回滾都是獨立且可逆的。
+要恢復任何應用程式，**從該應用程式的環境中刪除 `AGENT_NATIVE_IDENTITY_HUB_URL` 並重新部署/重新啟動它。**應用程式立即返回到其之前的驗證行為。 **沒有資料更改可以復原** - 僅新增了識別行，取消設定變數只會使聯合路徑再次休眠。每個應用的割接和回滾都是獨立且可逆的。
 
-> 啟用每個應用程式時，Rollout 會將使用者登出（他們通過 Dispatch 重新進行驗證），但他們始終會重新登入到**相同的電子郵件匹配帳戶，並且資料完好無損**，因為身分行永遠不會被銷毀或重命名 - 只是新增。
+> 啟用每個應用程式時，Rollout 會將使用者登出（他們透過 Dispatch 重新進行驗證），但他們始終會重新登入到**相同的電子郵件匹配帳戶，並且資料完好無損**，因為身分行永遠不會被銷毀或重新命名 - 只是新增。
 
 ## 相關 {#related}
 

package/docs/content/locales/zh-TW/database.md

@@ -1,13 +1,13 @@
 ---
 title: "資料庫"
-description: "將便攜式 SQL 資料庫連線到您的代理本機應用，並編寫與提供者無關的 Drizzle 程式碼。"
+description: "將便攜式 SQL 資料庫連線到您的 Agent-Native 應用，並編寫與提供者無關的 Drizzle 程式碼。"
 ---
 
 # 資料庫
 
-代理本機應用程式使用 [Drizzle ORM](https://orm.drizzle.team) 並支持便攜式 SQL 後端。對於本機開發之外的任何內容，請通過設定 `DATABASE_URL` 連線持久性 SQL 資料庫 - Postgres、libSQL/Turso 或另一個 Drizzle 兼容後端。取消設定該變數後，應用程式將回退到零設定本機 SQLite 檔案，以便您可以立即開始開發。
+Agent-Native 應用程式使用 [Drizzle ORM](https://orm.drizzle.team) 並支援便攜式 SQL 後端。對於本機開發之外的任何內容，請透過設定 `DATABASE_URL` 連線持久性 SQL 資料庫 - Postgres、libSQL/Turso 或另一個 Drizzle 相容後端。取消設定該變數後，應用程式將回退到零設定本機 SQLite 檔案，以便您可以立即開始開發。
 
-```an-diagram title="一個模式，多個後端" summary="應用程式程式碼使用框架的與方言無關的幫助程序。執行時從 DATABASE_URL 自動檢測方言； unset 表示本機 SQLite 檔案。"
+```an-diagram title="一個模式，多個後端" summary="應用程式的程式碼使用框架的與方言無關的幫助程式。執行時從 DATABASE_URL 自動偵測方言； 未設定表示本機 SQLite 檔案。"
 {
   "html": "<div class=\"diagram-db\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">@agent-native/core/db/schema</span><small class=\"diagram-muted\">table · text · integer · real · now</small><small class=\"diagram-muted\">+ Drizzle query DSL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>DATABASE_URL<br><small class=\"diagram-muted\">dialect auto-detected</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Postgres<br><small class=\"diagram-muted\">Neon · Supabase</small></span><span class=\"diagram-pill\">libSQL / Turso</span><span class=\"diagram-pill\">Cloudflare D1</span><span class=\"diagram-pill warn\">SQLite file<br><small class=\"diagram-muted\">unset = local dev only</small></span></div></div>",
   "css": ".diagram-db{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-db .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-db .diagram-arrow{font-size:22px;line-height:1}.diagram-db .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
@@ -18,11 +18,11 @@ description: "將便攜式 SQL 資料庫連線到您的代理本機應用，並
 
 當未設定 `DATABASE_URL` 時，應用程式會在 `data/app.db` 處建立 SQLite 資料庫。這是本機開發的零設定預設設定 - 無需設定。它僅用於開發；對於正式環境，將 `DATABASE_URL` 設定為持久 SQL 資料庫。
 
-不要依賴該本機檔案來部署應用程式。容器、無伺服器功能和預覽環境可能會重置其檔案系統，這意味著本機 SQLite 檔案可能會在重新啟動之間消失。在正式環境使用之前將 `DATABASE_URL` 設定為持久託管資料庫。
+不要依賴該本機檔案來部署應用程式。容器、無伺服器功能和預覽環境可能會重設其檔案系統，這意味著本機 SQLite 檔案可能會在重新啟動之間消失。在正式環境使用之前將 `DATABASE_URL` 設定為持久託管資料庫。
 
 ## 連線正式環境資料庫 {#production}
 
-在 `.env` 檔案或部署提供程序環境中設定 `DATABASE_URL` 以連線託管資料庫。圖爾索不是必需的；使用適合您的部署的與 Drizzle 兼容的 SQL 後端：
+在 `.env` 檔案或部署提供者環境中設定 `DATABASE_URL` 以連線託管資料庫。圖爾索不是必需的；使用適合您的部署的與 Drizzle 相容的 SQL 後端：
 
 ```bash
 # Neon 託管的 Postgres 資料庫
@@ -39,15 +39,15 @@ DATABASE_URL=libsql://my-db-org.turso.io
 DATABASE_AUTH_TOKEN=your-token
 ```
 
-框架自動檢測 URL 的方言並相應地設定 Drizzle。內置適配器涵蓋 Postgres URL、libSQL/Turso URL、SQLite 檔案 URL 和 Cloudflare D1 綁定。常見的正式環境選取包括 Neon、Supabase、Turso/libSQL、普通 Postgres、持久 SQLite 和 Builder.io 託管環境（如果可用）。
+框架自動偵測 URL 的方言並相應地設定 Drizzle。內建轉接器涵蓋 Postgres URL、libSQL/Turso URL、SQLite 檔案 URL 和 Cloudflare D1 綁定。常見的正式環境選取包括 Neon、Supabase、Turso/libSQL、普通 Postgres、持久 SQLite 和 Builder.io 託管環境（如果可用）。
 
-## Builder.io託管資料庫 {#builder-managed}
+## Builder.io 託管資料庫 {#builder-managed}
 
 *計畫（尚不可用）：*連線到 Builder.io 時，您的應用將能夠使用自動設定的託管資料庫，無需連線字串。
 
 ## 資料庫用戶端所在的位置 {#db-client}
 
-每個範本通過從 `@agent-native/core/db` 調用 `createGetDb(schema)` 來建立一個惰性的單例 Drizzle 用戶端。規範位置是 `server/db/index.ts`：
+每個範本透過從 `@agent-native/core/db` 呼叫 `createGetDb(schema)` 來建立一個惰性的單例 Drizzle 用戶端。規範位置是 `server/db/index.ts`：
 
 ```ts
 // server/db/index.ts
@@ -61,7 +61,7 @@ export const getDb = createGetDb(schema);
 
 ## 與方言無關的架構和查詢 {#schema}
 
-應用程式資料庫程式碼應使用 Drizzle 的架構並查詢 DSL，以便它可以跨提供程序執行。切勿在產品程式碼中編寫僅 SQLite 語法（`INSERT OR REPLACE`、`AUTOINCREMENT`、`datetime('now')`）或僅 Postgres 語法。
+應用程式資料庫程式碼應使用 Drizzle 的架構並查詢 DSL，以便它可以跨提供者執行。切勿在產品程式碼中編寫僅 SQLite 語法（`INSERT OR REPLACE`、`AUTOINCREMENT`、`datetime('now')`）或僅 Postgres 語法。
 
 使用 `@agent-native/core/db/schema` 中的框架架構助手：
 
@@ -82,7 +82,7 @@ export const tasks = table("tasks", {
 | 幫手      | 目的                                                          |
 | --------- | ------------------------------------------------------------- |
 | `table`   | 定義一個表——委托給`pgTable`或`sqliteTable`                    |
-| `text`    | 文本欄，支持`{ enum: [...] }`                                 |
+| `text`    | 文字欄，支援`{ enum: [...] }`                                 |
 | `integer` | 整數列，`{ mode: "boolean" }` 對應到 Postgres 布爾值          |
 | `real`    | 浮動列 - SQLite 上的 `real`、Postgres 上的 `double precision` |
 | `now`     | `.default(now())` 與方言無關的目前時間戳                      |
@@ -112,7 +112,7 @@ export const tasks = table("tasks", {
 
 切勿直接從 `drizzle-orm/sqlite-core` 或 `drizzle-orm/pg-core` 匯入。始終使用 `@agent-native/core/db/schema`。
 
-存儲面向使用者的資料的表必須包含 `owner_email` 列，以便框架的 SQL 級別範圍可以筛選經過驗證的使用者的行 - 請參閱 [Security](/docs/security#data-scoping)。還支持與其他使用者或組織共用的表應改為傳播 `...ownableColumns()`，這會在一次調用中新增 `owner_email`、`org_id` 和 `visibility` — 請參閱 [Sharing](/docs/sharing#building)。
+儲存面向使用者的資料的表必須包含 `owner_email` 列，以便框架的 SQL 層級範圍可以篩選經過驗證的使用者的行 - 請參閱 [Security](/docs/security#data-scoping)。還支援與其他使用者或組織共用的表應改為傳播 `...ownableColumns()`，這會在一次呼叫中新增 `owner_email`、`org_id` 和 `visibility` — 請參閱 [Sharing](/docs/sharing#building)。
 
 對於讀取和寫入，請使用 Drizzle 的查詢生成器和 `drizzle-orm` 中的可移植運算符：
 
@@ -134,7 +134,7 @@ await db.update(tasks).set({ done: true }).where(eq(tasks.id, taskId));
 
 ## 原始 SQL 逃生艙口 {#raw-sql}
 
-原始 SQL 不是預設的應用程式碼 API。僅將其用於附加遷移、執行狀況檢查、仔細審查 Drizzle 無法表達的高級查詢或一次性維護。保持參數化且與方言無關。對於 Drizzle 模式中的時間戳，優先選取 `.default(now())`；對於遷移 SQL，請使用 `runMigrations()`，以便框架支持的兼容性重寫和方言門控語句保持集中。
+原始 SQL 不是預設的應用程式碼 API。僅將其用於附加遷移、執行狀況檢查、仔細審查 Drizzle 無法表達的進階查詢或一次性維護。保持參數化且與方言無關。對於 Drizzle 模式中的時間戳，優先選取 `.default(now())`；對於遷移 SQL，請使用 `runMigrations()`，以便框架支援的相容性重寫和方言門控語句保持集中。
 
 對於您確實需要 Drizzle 查詢之外的原始 SQL 的情況：
 
@@ -151,16 +151,16 @@ await db.update(tasks).set({ done: true }).where(eq(tasks.id, taskId));
 所有資料庫架構更新都必須**嚴格附加**。
 
 - **不要刪除表或列。**
-- **不要重命名表或列。**重命名列或表看起來像是 Drizzle 的 drop + create 序列，這將永久刪除您現有的正式環境資料。
-- 如果需要重命名或替換某一列，請在舊列旁邊新增新列，更新應用程式程式碼以讀取/寫入兩者，遷移資料，並且僅在沒有活動部署引用舊列時才在後續版本中停用舊列。
+- **不要重新命名表或列。**重新命名列或表看起來像是 Drizzle 的 drop + create 序列，這將永久刪除您現有的正式環境資料。
+- 如果需要重新命名或替換某一列，請在舊列旁邊新增新列，更新應用程式的程式碼以讀取/寫入兩者，遷移資料，並且僅在沒有活動部署引用舊列時才在後續版本中停用舊列。
 
 > [!WARNING]
 > **切勿針對正式環境資料庫執行 `drizzle-kit push`。**
-> 範本資料庫模式僅定義特定於應用程式的域表；它們沒有定義中央框架表（`user`、`session`、`application_state` 等）。如果您在正式環境環境中執行 `drizzle-kit push`，Drizzle 會將這些框架表檢測為“不在架構中”並嘗試刪除它們，從而立即導致系統範圍內的故障和資料丟失。
+> 範本資料庫模式僅定義特定於應用程式的域表；它們沒有定義中央框架表（`user`、`session`、`application_state` 等）。如果您在正式環境環境中執行 `drizzle-kit push`，Drizzle 會將這些框架表偵測為“不在架構中”並嘗試刪除它們，從而立即導致系統範圍內的故障和資料丟失。
 
 ### 安全遷移路徑
 
-不應直接推送，而應通過在應用程式啟動時執行的 SQL 遷移來應用架構更改。通過調用框架的 `runMigrations()` 幫助程序，在伺服器外掛（例如 `server/plugins/db.ts`）中實現附加遷移：
+不應直接推送，而應透過在應用程式啟動時執行的 SQL 遷移來應用架構更改。透過呼叫框架的 `runMigrations()` 幫助程式，在伺服器外掛（例如 `server/plugins/db.ts`）中實現附加遷移：
 
 ```an-annotated-code title="附加遷移外掛"
 {
@@ -168,7 +168,7 @@ await db.update(tasks).set({ done: true }).where(eq(tasks.id, taskId));
   "language": "ts",
   "code": "import { runMigrations } from \"@agent-native/core/db\";\n\nexport default runMigrations(\n  [\n    {\n      version: 1,\n      sql: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS sort_order INTEGER NOT NULL DEFAULT 0`,\n    },\n    {\n      // Dialect-gated: runs only on the matching backend. Omit the other key\n      // to make it a no-op on that dialect.\n      version: 2,\n      sql: {\n        postgres: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS tsv tsvector`,\n        sqlite: `SELECT 1`, // no-op; tsvector is Postgres-only\n      },\n    },\n  ],\n  { table: \"my_app_migrations\" },\n);",
   "annotations": [
-    { "lines": "6-7", "label": "僅新增劑", "note": "`ADD COLUMN IF NOT EXISTS` 可以安全地重新執行並且永遠不會丟失資料。重命名看起來像 drop+create 為 Drizzle，所以改為新增然後遷移。" },
+    { "lines": "6-7", "label": "僅新增劑", "note": "`ADD COLUMN IF NOT EXISTS` 可以安全地重新執行並且永遠不會丟失資料。重新命名看起來像 drop+create 為 Drizzle，所以改為新增然後遷移。" },
     { "lines": "13-16", "label": "方言門控", "note": "Pass an object keyed by dialect to run different SQL per backend. Make the other key a no-op (`SELECT 1`) for Postgres-only or SQLite-only features." },
     { "lines": "19", "label": "每個應用程式版本表", "note": "每個應用程式都會跟蹤自己的應用版本，因此遷移在重新啟動和執行個體之間是冪等的。" }
   ]
@@ -177,7 +177,7 @@ await db.update(tasks).set({ done: true }).where(eq(tasks.id, taskId));
 
 ## 環境變數 {#environment-variables}
 
-| 變數                  | 目的                                                     |
-| --------------------- | -------------------------------------------------------- |
-| `DATABASE_URL`        | 持久化SQL連線字串（未設定=本機SQLite，僅對本機開發持久） |
-| `DATABASE_AUTH_TOKEN` | 需要單獨權杖的提供者的驗證權杖，例如 Turso/libSQL        |
+| 變數                  | 目的                                                        |
+| --------------------- | ----------------------------------------------------------- |
+| `DATABASE_URL`        | 持久化 SQL 連線字串（未設定=本機 SQLite，僅對本機開發持久） |
+| `DATABASE_AUTH_TOKEN` | 需要單獨權杖的提供者的驗證權杖，例如 Turso/libSQL           |