@agent-native/core 0.79.12 → 0.79.15

package/docs/content/locales/zh-TW/audit-log.md

@@ -5,21 +5,21 @@ description: "持久的、僅附加的紀錄，紀錄誰更改了哪些應用資
 
 # 審核記錄
 
-每個代理本機應用程式都會獲得開箱即用的審核記錄：一個持久的、完整的、存取範圍的、僅附加的紀錄，紀錄**誰改變了哪些應用程式資料、何時、從哪裡以及（何時是代理）在哪個執行中。** 捕獲在操作接縫處自動進行；您無需為其編寫任何程式碼。
+每個 Agent-Native 應用程式都會獲得開箱即用的審核記錄：一個持久的、完整的、存取範圍的、僅附加的紀錄，紀錄**誰改變了哪些應用程式資料、何時、從哪裡以及（何時是代理）在哪個執行中。** 捕獲在操作接縫處自動進行；您無需為其編寫任何程式碼。
 
 由於代理可以代表您更改資料，因此審核記錄在這裡回答的標題問題不僅僅是“誰編輯了此紀錄”，而是 **“是我還是代理，以及哪個輪次導致了它？”** 框架中沒有其他系統可以回答這個問題。
 
 ## 審計與可觀察性與跟蹤 {#which}
 
-三個系統出於三個不同的原因紀錄“發生了什么”。根據您要問的問題進行選取：
+三個系統出於三個不同的原因紀錄“發生了什麼”。根據您要問的問題進行選取：
 
 | 系統                                     | 它回答的問題                           | 保真度                 | 觀眾                     |
 | ---------------------------------------- | -------------------------------------- | ---------------------- | ------------------------ |
 | **審核記錄**（本頁面）                   | “誰更改了此紀錄，何時更改，是代理嗎？” | **完整、耐用、有範圍** | 使用者、管理員、代理本身 |
-| **[Observability](/docs/observability)** | “代理為什么要這樣做，花費了多少？”     | 采樣跨度遙測           | 開發人員                 |
+| **[Observability](/docs/observability)** | “代理為什麼要這樣做，花費了多少？”     | 取樣跨度遙測           | 開發人員                 |
 | **[Tracking](/docs/tracking)**           | “人們如何使用該產品？”                 | 即發即忘外部 SaaS      | PM/增長                  |
 
-采樣或發送給分析提供者的審核記錄是無用的 - 重點是它是完整的、本機的且可查詢的。所以它是它自己的子系統，而不是其他兩個的模式。
+取樣或傳送給分析提供者的審核記錄是無用的 - 重點是它是完整的、本機的且可查詢的。所以它是它自己的子系統，而不是其他兩個的模式。
 
 ## 自動捕獲的內容 {#captured}
 
@@ -27,15 +27,15 @@ description: "持久的、僅附加的紀錄，紀錄誰更改了哪些應用資
 
 - **操作** — 操作名稱（例如 `delete-recording`）。
 - **演員** - `agent`、`human` 或 `system`，加上演員的電子郵件 - 填充**即使是代理呼叫**，因此您會得到“代理，代表 alice@，...”。
-- **執行連結** - 觸發調用（工具調用）的代理 `threadId` / `turnId`，因此突變可以追溯到確切的代理回合。
+- **執行連結** - 觸發呼叫（工具呼叫）的代理 `threadId` / `turnId`，因此突變可以追溯到確切的代理回合。
 - **Surface** — `tool`（代理）、`frontend`、`http`、`cli`、`mcp` 或 `a2a`。
-- **結果** — `success`、`error`（帶有錯誤程式碼）或 `denied`（被人工審批門阻止）。
-- **輸入** — 調用參數，具有憑證形狀的值 [redacted](#privacy)。
+- **結果** — `success`、`error`（帶有錯誤程式碼）或 `denied`（被人工核准門阻止）。
+- **輸入** — 呼叫參數，具有憑證形狀的值 [redacted](#privacy)。
 - **目標和所有者** — 操作更改的資源，用於 [scope reads](#reading)。
 
 無需接線 - 捕獲透明地連線到 `defineAction`。唯讀的actions會被跳過，並且預設會跳過一些高頻框架actions（app-statesync、context-xray、navigation）以避免記錄泛濫。
 
-## 聲明操作更改了什么 {#target}
+## 聲明操作更改了什麼 {#target}
 
 預設情況下，事件的範圍僅限於 **參與者** - 您可以看到自己的更改以及代理代表您所做的更改。要對*shared*資源進行更改也出現在**所有者的**跟蹤中，並按資源標記事件，請聲明`target`：
 
@@ -73,12 +73,12 @@ export default defineAction({
 
 ## 閱讀蹤跡 {#reading}
 
-每個應用程式中的代理**和**前端都可以使用兩個讀取的actions，調用者的範圍在SQL中 - 它們永遠不會返回其他租戶的行：
+每個應用程式中的代理**和**前端都可以使用兩個讀取的actions，呼叫者的範圍在 SQL 中 - 它們永遠不會返回其他租戶的行：
 
 - **`list-audit-events`** — 按 `targetType` / `targetId`、`actorKind` (`agent` | `human` | `system`)、`status`、`threadId` / `turnId`、`action` 過濾， `sinceMs`、`limit`。
 - **`get-audit-event`** — 按 id 的一個事件，包括其經過編輯的輸入負載。
 
-通過使用 `useActionQuery` 從 UI 調用 `list-audit-events` 來建置活動來源或“誰更改了此”行 - 切勿手寫對審核表的提取：
+透過使用 `useActionQuery` 從 UI 呼叫 `list-audit-events` 來建置活動來源或“誰更改了此”行 - 切勿手寫對審核表的擷取：
 
 ```tsx
 import { useActionQuery } from "@agent-native/core/client";
@@ -90,22 +90,22 @@ const { data } = useActionQuery("list-audit-events", {
 // data.events → [{ action, actorKind, actorEmail, turnId, status, summary, createdAt }, …]
 ```
 
-代理可以調用​​相同的操作 - 詢問它“你對此錄音做了什么更改？”它會從蹤跡中回答。
+代理可以呼叫​​相同的操作 - 詢問它“你對此錄音做了什麼更改？”它會從蹤跡中回答。
 
 ## 隱私和保留 {#privacy}
 
-- **編輯** - 在存儲任何輸入之前，憑證形狀的金鑰和值（權杖、秘密、密碼、承載字串）將被剝離，並截斷超大的有效負載。審核記錄永遠不會成為秘密的輔助存儲。也不要讓 `summary` 文本包含敏感資料。
+- **編輯** - 在儲存任何輸入之前，憑證形狀的金鑰和值（權杖、秘密、密碼、承載字串）將被剝離，並截斷超大的有效負載。審核記錄永遠不會成為秘密的輔助儲存。也不要讓 `summary` 文字包含敏感資料。
 - **僅追加** — 審核行沒有更新或刪除操作。唯一的刪除是保留清除，這使得記錄作為審計跟蹤值得信賴。
-- **租戶隔離** — 讀取範圍僅限於調用者的身分和組織；沒有身分，沒有任何匹配。
+- **租戶隔離** — 讀取範圍僅限於呼叫者的身分和組織；沒有身分，沒有任何匹配。
 
-通過環境設定：
+透過環境設定：
 
 - `AGENT_NATIVE_AUDIT_RETENTION_DAYS` — 行保留多長時間（預設 `365`；`0` = 永遠保留）。
 - `AGENT_NATIVE_AUDIT_ENABLED=false` — 全域終止開關。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Actions**](/docs/actions) — 捕獲發生的 `defineAction` 接縫
 - [**Human-in-the-Loop Approvals**](/docs/human-approval) — 門控 actions，紀錄為 `denied`
 - [**Security & Data Scoping**](/docs/security) — 所有權模型審核讀取重用
-- [**Observability**](/docs/observability) - 代理執行的遙測（另一個“發生了什么”）
+- [**Observability**](/docs/observability) - 代理執行的遙測（另一個“發生了什麼”）

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

@@ -5,17 +5,17 @@ description: "與電子郵件/密碼、社交提供者、組織和 MCP 持有者
 
 # 驗證
 
-代理本機應用程式使用 [Better Auth](https://better-auth.com) 進行帳戶優先設計的驗證。使用者在第一次存取時建立一個帳戶，並從第一天起就獲得真實身分。
+Agent-Native 應用程式使用 [Better Auth](https://better-auth.com) 進行帳戶優先設計的驗證。使用者在第一次存取時建立一個帳戶，並從第一天起就獲得真實身分。
 
 ## 概述 {#overview}
 
-Auth 是通過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的。共有三種模式：
+Auth 是透過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的。共有三種模式：
 
 - **預設：**使用電子郵件/密碼+社交提供者進行更好的驗證。首次存取時顯示的入門頁面。
 - **遠端 MCP OAuth：** 適用於 MCP 主機的標準 OAuth 2.1，例如 Claude 程式碼和 ChatGPT 連線器。
-- **自訂：**通過 `getSession` 回調帶來您自己的驗證。
+- **自訂：**透過 `getSession` 回調帶來您自己的驗證。
 
-```an-diagram title="三種方式，一次會議" summary="瀏覽器訪客、編程 MCP 用戶端和自訂提供程序都解析為下游作用域讀取的同一 AuthSession。"
+```an-diagram title="三種方式，一次會議" summary="瀏覽器訪客、程式化 MCP 用戶端和自訂提供者都解析為下游作用域讀取的同一 AuthSession。"
 {
   "html": "<div class=\"auth-modes\"><div class=\"diagram-col\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Default</span><strong>Better Auth</strong><small class=\"diagram-muted\">email/password &middot; Google &middot; GitHub</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Remote MCP OAuth</span><strong>OAuth 2.1 + PKCE</strong><small class=\"diagram-muted\">Claude Code、ChatGPT 連線器</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Custom</span><strong>getSession callback</strong><small class=\"diagram-muted\">Clerk &middot; Auth0 &middot; Firebase</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">AuthSession</span><small class=\"diagram-muted\">email &middot; orgId &middot; orgRole</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Request context &amp; data scoping</div></div>",
   "css": ".auth-modes{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.auth-modes .diagram-col{display:flex;flex-direction:column;gap:10px}.auth-modes .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.auth-modes .diagram-arrow{font-size:22px;line-height:1}.auth-modes .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -30,10 +30,10 @@ Auth 是通過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的
 | **品質檢查/預覽** | 正常註冊，但可以跳過驗證，因此測試人員無需等待電子郵件 | 使用 `AUTH_SKIP_EMAIL_VERIFICATION=1` 跳過 |
 | **正式環境**      | 正常更好的驗證註冊/登入                                | 必需（設定電子郵件提供者時）               |
 
-一些標志對此進行了調整；完整詳細資訊位於 [Environment Variables](#environment-variables) 表中：
+一些標誌對此進行了調整；完整詳細資訊位於 [Environment Variables](#environment-variables) 表中：
 
 - `AGENT_NATIVE_DISABLE_AUTO_DEV_ACCOUNT=1` — 使用本機開發中的普通註冊頁面而不是自動開發帳戶。
-- `AUTH_DISABLED=true` — 完全跳過登入/註冊，並以一個共用使用者身分執行每個請求（僅限本機開發/預覽/演示，切勿與真實使用者一起進行正式環境）。
+- `AUTH_DISABLED=true` — 完全跳過登入/註冊，並以一個共用使用者身分執行每個請求（僅限本機開發/預覽/示範，切勿與真實使用者一起進行正式環境）。
 - `AUTH_MODE=local` — 僅影響 CLI/代理身分（開發使用者 `pnpm action` 執行時的身分）；它**不是**瀏覽器登入繞過。
 
 ```an-callout
@@ -45,17 +45,17 @@ Auth 是通過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的
 
 ## 更好的驗證（預設） {#better-auth}
 
-預設情況下，Better Auth 支持驗證。它提供：
+預設情況下，Better Auth 支援驗證。它提供：
 
 - 電子郵件/密碼註冊和登入
 - 社交提供者（Google、GitHub 和 35 多個其他提供者）
 - 具有角色和邀請的組織
 - 用於 API 和 A2A 存取的 JWT 權杖
-- 對程序化用戶端的不記名權杖支持
+- 對程式化用戶端的不記名權杖支援
 
-Better Auth 路由安裝在 `/_agent-native/auth/ba/*`。該框架還提供向後兼容的端點：
+Better Auth 路由安裝在 `/_agent-native/auth/ba/*`。此框架還提供向後相容的端點：
 
-- `GET /_agent-native/auth/session` — 獲取目前工作階段
+- `GET /_agent-native/auth/session` — 取得目前工作階段
 - `POST /_agent-native/auth/login` — 電子郵件/密碼登入
 - `POST /_agent-native/auth/register` — 建立帳戶
 - `POST /_agent-native/auth/logout` — 退出
@@ -67,13 +67,13 @@ Better Auth 路由安裝在 `/_agent-native/auth/ba/*`。該框架還提供向
 
 | 部署形狀                                 | Cookie 領域                                                                                                      |
 | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| 獨立應用                                 | 通過 slug（`APP_NAME`，或本機開發中的包名稱）隔離每個應用程式；正式環境中穩定的 `an` 前綴                        |
+| 獨立應用                                 | 透過 slug（`APP_NAME`，或本機開發中的包名稱）隔離每個應用程式；正式環境中穩定的 `an` 前綴                        |
 | 工作區模式（`AGENT_NATIVE_WORKSPACE=1`） | 一個共用領域 - 工作區應用程式共用來源和資料庫                                                                    |
 | 自訂同資料庫子域                         | 選取與 `COOKIE_DOMAIN` 共用 Cookie                                                                               |
 | 第一方託管 (`*.agent-native.com`)        | 每個應用程式的獨立命名空間（每個應用程式都有自己的驗證資料庫）；預設情況下忽略 `COOKIE_DOMAIN=.agent-native.com` |
 
 第一方託管應用程式都有自己的驗證資料庫，因此可以跨應用程式登入
-通過 [Cross-App SSO](/docs/cross-app-sso) 而不是共用 cookie。
+透過 [Cross-App SSO](/docs/cross-app-sso) 而不是共用 cookie。
 這些部署必須提供 `APP_NAME` 或可派生應用 URL（`APP_URL`、`URL`，
 `DEPLOY_PRIME_URL`，或`DEPLOY_URL`）；否則啟動失敗而不是下降
 返回共用的 `an_session` 名稱。有意共用一個驗證資料庫
@@ -93,21 +93,21 @@ Better Auth 路由安裝在 `/_agent-native/auth/ba/*`。該框架還提供向
 AUTH_SKIP_EMAIL_VERIFICATION=1
 ```
 
-設定此標志後，電子郵件/密碼註冊不需要電子郵件
-驗證和註冊驗證電子郵件未發送。僅將其用於品質檢查
+設定此標誌後，電子郵件/密碼註冊不需要電子郵件
+驗證和註冊驗證電子郵件未傳送。僅將其用於品質檢查
 或預覽環境，並使用 `+qa` 地址命名測試帳戶
 (`name+qa@example.com`)，因此很容易識別。
 
 ## 社交提供者 {#social-providers}
 
-設定環境變數以啟用社交登入。 Better Auth 自動檢測它們：
+設定環境變數以啟用社交登入。 Better Auth 自動偵測它們：
 
 ```bash
 # GoogleOAuth
 GOOGLE_SIGN_IN_CLIENT_ID=your-low-scope-sign-in-client-id
 GOOGLE_SIGN_IN_CLIENT_SECRET=your-low-scope-sign-in-client-secret
 
-# 向後兼容的回退以及範本的提供者 OAuth 憑證
+# 向後相容的回退以及範本的提供者 OAuth 憑證
 # 連線到 Google APIs，例如 Gmail 或行事曆。
 GOOGLE_CLIENT_ID=your-client-id
 GOOGLE_CLIENT_SECRET=your-client-secret
@@ -132,16 +132,16 @@ Google API 範圍，或作為部署未拆分時的舊後備
 
 ## 組織 {#organizations}
 
-該框架提供了內置的組織系統。這是框架自己的 `org/` 模塊（由 `organizations` 和 `org_members` 表支持），而不是 Better Auth 的組織外掛，該外掛故意未註冊。每個應用程式都支持：
+此框架提供了內建的組織系統。這是框架自己的 `org/` 模組（由 `organizations` 和 `org_members` 表支援），而不是 Better Auth 的組織外掛，該外掛故意未註冊。每個應用程式都支援：
 
 - 建立組織
 - 邀請具有角色的成員（`owner`、`admin`、`member`）
 - 切換活動組織
-- 通過 `org_id` 列確定每個組織的資料範圍
+- 透過 `org_id` 列確定每個組織的資料範圍
 
 活動組織在工作階段中被跟蹤為 `session.orgId`，切換組織會更改使用者和代理看到的資料。資料作用域本身發生在堆堆疊的更下方——有關完整的 `session.orgId → AGENT_ORG_ID → SQL` 管道和存取防護，請參閱 [Security & Data Scoping](/docs/security#data-scoping)。 [Multi-Tenancy](/docs/multi-tenancy) 檔案涵蓋了組織管理層面。
 
-## 靜態MCP不記名權杖 {#access-tokens}
+## 靜態 MCP 不記名權杖 {#access-tokens}
 
 `ACCESS_TOKEN` 和 `ACCESS_TOKENS` 不是瀏覽器驗證，並且不會將應用程式設為私人。它們僅保留為無法使用 OAuth 流的 MCP/連線用戶端的靜態承載憑證。
 
@@ -155,30 +155,30 @@ ACCESS_TOKENS=token1,token2,token3
 
 設定這些變數永遠不會為訪客呈現權杖登入頁面。 Web 登入保留在 Better Auth 或您的自訂 `getSession` 提供者上。
 
-## 遠端MCP OAuth {#remote-mcp-oauth}
+## 遠端 MCP OAuth {#remote-mcp-oauth}
 
-每個應用程式的 MCP 端點都可以充當標準受保護的 MCP 資源。支持 OAuth 的用戶端只能設定遠端 MCP URL：
+每個應用程式的 MCP 端點都可以充當標準受保護的 MCP 資源。支援 OAuth 的用戶端只能設定遠端 MCP URL：
 
 ```text
 https://mail.agent-native.com/_agent-native/mcp
 ```
 
-未經驗證的 MCP 請求返回指向 `/.well-known/oauth-protected-resource` 的 `WWW-Authenticate` 質詢。然後，用戶端發現應用程式的 OAuth 元資料，動態註冊公開用戶端，開啟應用程式的授權頁面，並與 PKCE 交換授權程式碼以獲取存取和刷新權杖。
+未經驗證的 MCP 請求返回指向 `/.well-known/oauth-protected-resource` 的 `WWW-Authenticate` 質詢。然後，用戶端發現應用程式的 OAuth 中繼資料，動態註冊公開用戶端，開啟應用程式的授權頁面，並與 PKCE 交換授權程式碼以取得存取和重新整理權杖。
 
-```an-diagram title="遠端 MCP OAuth 握手" summary="具有 OAuth 功能的用戶端僅從 MCP URL 引導 — 挑战、發現、動態註冊，然後是 PKCE 程式碼交換。"
+```an-diagram title="遠端 MCP OAuth 握手" summary="具有 OAuth 功能的用戶端僅從 MCP URL 引導 — 質詢、發現、動態註冊，然後是 PKCE 程式碼交換。"
 {
   "html": "<div class=\"mcp-flow\"><div class=\"diagram-node\">1 &middot; MCP request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node warn\">2 &middot; 401 challenge<br><small class=\"diagram-muted\">WWW-Authenticate</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">3 &middot; Discover metadata<br><small class=\"diagram-muted\">.well-known</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">4 &middot; Register client<br><small class=\"diagram-muted\">動態、公開</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">5 &middot; Authorize + PKCE<br><small class=\"diagram-muted\">code exchange</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">6 &middot; Access + refresh<br><small class=\"diagram-muted\">audience-bound</small></div></div>",
   "css": ".mcp-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.mcp-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:8px 12px}.mcp-flow .diagram-arrow{font-size:20px;line-height:1}"
 }
 ```
 
-設定時存取權杖使用 `A2A_SECRET` 進行簽名，否則使用 `BETTER_AUTH_SECRET` 進行簽名。它們攜帶簽名的使用者/組織身分和 `mcp:read`、`mcp:write` 和/或 `mcp:apps` 範圍，並且受眾綁定到確切的 MCP 資源 URL。刷新權杖僅存儲為哈希值並在每次刷新時輪換。工具調用和 MCP Apps 資源讀取在與登入使用者相同的請求上下文中執行；嵌入式 MCP 應用程式 iframe 永遠不會接收原始 OAuth 權杖。
+設定時存取權杖使用 `A2A_SECRET` 進行簽名，否則使用 `BETTER_AUTH_SECRET` 進行簽名。它們攜帶簽名的使用者/組織身分和 `mcp:read`、`mcp:write` 和/或 `mcp:apps` 範圍，並且受眾綁定到確切的 MCP 資源 URL。重新整理權杖僅儲存為雜湊值並在每次重新整理時輪換。工具呼叫和 MCP Apps 資源讀取在與登入使用者相同的請求脈絡中執行；嵌入式 MCP 應用程式 iframe 永遠不會接收原始 OAuth 權杖。
 
 `npx @agent-native/core@latest connect <url> --client claude-code` 為此標準流程寫入僅 URL 的 MCP 條目。對於無法執行遠端 MCP OAuth 的用戶端，請使用“連線”頁面或 `npx @agent-native/core@latest connect --token <token>` 回退來寫入顯式不記名權杖條目。
 
 ## 自帶驗證 {#byoa}
 
-傳遞自訂 `getSession` 回調以使用任何驗證提供程序（Clerk、Auth0、Firebase 等）：
+傳遞自訂 `getSession` 回調以使用任何驗證提供者（Clerk、Auth0、Firebase 等）：
 
 ```ts
 // server/plugins/auth.ts
@@ -227,7 +227,7 @@ export default createAuthPlugin({
 
 `publicPaths`和`protectedPaths`使用前綴匹配，所以`"/admin"`也
 覆蓋 `"/admin/users"`。這些設定僅開啟頁面導覽。框架
-路由（`/_agent-native/*`）和自訂API路由（`/api/*`）仍然需要驗證
+路由（`/_agent-native/*`）和自訂 API 路由（`/api/*`）仍然需要驗證
 除非應用明確新增這些前綴
 `createAuthPlugin({ publicPaths: [...] })`.
 
@@ -260,15 +260,15 @@ function MyComponent() {
 }
 ```
 
-## 登入並返回URL {#sign-in-return-url}
+## 登入並傳回 URL {#sign-in-return-url}
 
-具有**公開頁面**（共用連結、嵌入、營銷頁面）的範本通常需要一個頁面內 CTA 來要求匿名檢視者登入並將他們帶回到他們所在的頁面。該框架為此提供了一個入口點：
+具有**公開頁面**（共用連結、嵌入、行銷頁面）的範本通常需要一個頁面內 CTA 來要求匿名檢視者登入並將他們帶回到他們所在的頁面。此框架為此提供了一個入口點：
 
 ```
 /_agent-native/sign-in?return=<same-origin-path>
 ```
 
-當匿名檢視者點擊此 URL 時，將提供框架的登入頁面。成功登入（任何流程 - 權杖、電子郵件/密碼或 GoogleOAuth）後，檢視者將 302 轉至 `return`。
+當匿名檢視者點選此 URL 時，將提供框架的登入頁面。成功登入（任何流程 - 權杖、電子郵件/密碼或 GoogleOAuth）後，檢視者將 302 轉至 `return`。
 
 `return` 參數被驗證為**同來源路徑**。網路路徑引用 (`//evil.com/...`)、絕對 URL、`data:` / `javascript:` 方案和嵌入式控制字符都回退到 `/`。驗證的路徑是從 URL 解析器重建的，而不是從輸入中回顯。
 
@@ -293,9 +293,9 @@ function SignInCta() {
 
 ### 幕後花絮：GoogleOAuth
 
-兩個流（顯式 `/_agent-native/sign-in` 入口點和書簽路徑情況）都將返回 URL 線程穿過 OAuth 狀態。該狀態是 HMAC 簽名的，因此在運輸過程中無法偽造。在回調中，返回的 URL 在重新導向之前被重新驗證為同來源 - 因此泄漏的簽名金鑰仍然無法轉換為開放重新導向預言機。
+兩個流（顯式 `/_agent-native/sign-in` 入口點和書簽路徑情況）都將傳回 URL 對話串穿過 OAuth 狀態。該狀態是 HMAC 簽名的，因此在運輸過程中無法偽造。在回調中，返回的 URL 在重新導向之前被重新驗證為同來源 - 因此泄漏的簽名金鑰仍然無法轉換為開放重新導向預言機。
 
-如果您的範本直接包裝 `/_agent-native/google/auth-url`（例如郵件和行事曆範本這樣做，以擴大範圍），則接受 `?return=<path>` 查詢並通過 `encodeOAuthState` 的選項物件形式轉發它：
+如果您的範本直接包裝 `/_agent-native/google/auth-url`（例如郵件和行事曆範本這樣做，以擴大範圍），則接受 `?return=<path>` 查詢並透過 `encodeOAuthState` 的選項物件形式轉發它：
 
 ```ts
 const returnUrl = getQuery(event).return;
@@ -326,7 +326,7 @@ const state = encodeOAuthState({
 | `GOOGLE_CLIENT_ID`                      | 舊版 Google 登入回退以及用於 Google API 整合的提供者 OAuth 用戶端 ID                                                 |
 | `GOOGLE_CLIENT_SECRET`                  | 舊版 Google 登入回退以及 Google API 整合的提供者 OAuth 金鑰                                                          |
 | `GITHUB_CLIENT_ID`                      | 啟用GitHub OAuth                                                                                                     |
-| `GITHUB_CLIENT_SECRET`                  | GitHub OAuth秘密                                                                                                     |
+| `GITHUB_CLIENT_SECRET`                  | GitHub OAuth 秘密                                                                                                    |
 | `ACCESS_TOKEN`                          | MCP/連線用戶端的靜態承載回退；不是瀏覽器驗證                                                                         |
 | `ACCESS_TOKENS`                         | MCP/connect 用戶端的逗號分隔靜態承載回退；不是瀏覽器驗證                                                             |
 | `A2A_SECRET`                            | JWT 簽名的 A2A 跨應用驗證的共用金鑰，以及 MCP OAuth 存取權杖簽名（如果存在）                                         |

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

@@ -7,7 +7,7 @@ description: "具有自然語言條件的事件觸發和計畫自動化"
 
 **自動化**是一條規則：_當 X 發生時，執行 Y_ — 用自然語言描述。代理執行指令，因此自動化可以存取代理可以在互動式聊天中使用的每個操作、工具和 MCP 伺服器。
 
-自動化通過 `web-request` 工具使用**事件觸發器**、**自然語言條件**和**出站 HTTP** 擴充功能 [recurring jobs](/docs/recurring-jobs)。它們使用與重複作業相同的 `jobs/<name>.md` 檔案格式、存儲和“建立三種方式”工作流程 - 請參閱 [Recurring Jobs](/docs/recurring-jobs#job-file) 了解共用格式。本頁面僅涵蓋事件驅動自動化的新增內容。
+自動化透過 `web-request` 工具使用**事件觸發器**、**自然語言條件**和**出站 HTTP** 擴充功能 [recurring jobs](/docs/recurring-jobs)。它們使用與重複作業相同的 `jobs/<name>.md` 檔案格式、儲存和“建立三種方式”工作流程 - 請參閱 [Recurring Jobs](/docs/recurring-jobs#job-file) 了解共用格式。本頁面僅涵蓋事件驅動自動化的新增內容。
 
 ```an-diagram title="當X發生時，做Y" summary="總線上觸發事件，可選的自然語言條件對其進行門控，代理執行具有完整工具存取權限的自動化主體。"
 {
@@ -27,17 +27,17 @@ description: "具有自然語言條件的事件觸發和計畫自動化"
 
 ## 建立自動化 {#creating}
 
-### 通過詢問代理
+### 透過詢問代理
 
-> “當有人使用 @builder.io 電子郵件預訂會議時，請通過 Slack 向我發送訊息。”
+> “當有人使用 @builder.io 電子郵件預訂會議時，請透過 Slack 向我傳送訊息。”
 
 代理發現可用事件，確認計畫，並為您編寫自動化。
 
-### 來自設定UI
+### 來自設定 UI
 
 自動化出現在設定面板中。使用者可以在那裡檢視、啟用/停用和刪除它們。
 
-第三條路徑 - 通過 `resourcePut` 手動寫入 `jobs/<name>.md` 檔案 - 與 [recurring jobs](/docs/recurring-jobs#creating) 的工作方式完全相同。對於事件驅動的自動化，您可以將下面的事件觸發 frontmatter 新增到同一檔案中。事件觸發作業設定 `schedule: ""` 並提供 `triggerType: event`、`event` 名稱和可選的 `condition`：
+第三條路徑 - 透過 `resourcePut` 手動寫入 `jobs/<name>.md` 檔案 - 與 [recurring jobs](/docs/recurring-jobs#creating) 的工作方式完全相同。對於事件驅動的自動化，您可以將下面的事件觸發 frontmatter 新增到同一檔案中。事件觸發作業設定 `schedule: ""` 並提供 `triggerType: event`、`event` 名稱和可選的 `condition`：
 
 ```an-annotated-code title="事件觸發的自動化"
 {
@@ -62,16 +62,16 @@ description: "具有自然語言條件的事件觸發和計畫自動化"
 | `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | 自動化如何啟動                                                                                                         |
 | `event`       | 字串                             | _（可選）_   | 要訂閱的事件名稱（僅限事件觸發器）                                                                                     |
 | `condition`   | 字串                             | _（可選）_   | 在調度之前評估自然語言條件                                                                                             |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | 完整的代理循環。 （`"deterministic"` 已保留，但尚未實現 - 設定它的自動化將被跳過。對所有目前自動化使用 `"agentic"`。） |
+| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | 完整的代理迴圈。 （`"deterministic"` 已保留，但尚未實現 - 設定它的自動化將被跳過。對所有目前自動化使用 `"agentic"`。） |
 | `domain`      | 字串                             | _（可選）_   | 分組標籤（郵件、行事曆、剪輯等）                                                                                       |
 
-對於事件觸發器，`schedule`為`""`（空）；對於計畫觸發器，它帶有 cron 表達式。調度程序還寫入與調度程序相同的託管 `lastRun` / `lastStatus` / `lastError` 欄位，以及當條件評估為 false 時的 `"skipped"` 狀態。
+對於事件觸發器，`schedule`為`""`（空）；對於計畫觸發器，它帶有 cron 表達式。調度程式還寫入與調度程式相同的託管 `lastRun` / `lastStatus` / `lastError` 欄位，以及當條件評估為 false 時的 `"skipped"` 狀態。
 
 ## 事件總線 {#event-bus}
 
-整合在模塊載入時註冊事件。總線根據 [Standard Schema](https://standardschema.dev) 定義驗證有效負載並將其分派給訂閱者。
+整合在模組載入時註冊事件。總線根據 [Standard Schema](https://standardschema.dev) 定義驗證有效負載並將其分派給訂閱者。
 
-### 內置事件 {#built-in-events}
+### 內建事件 {#built-in-events}
 
 | 活動                   | 來源                                       |
 | ---------------------- | ------------------------------------------ |
@@ -81,11 +81,11 @@ description: "具有自然語言條件的事件觸發和計畫自動化"
 | `clip.*`               | 剪輯整合                                   |
 | `mail.*`               | 郵件整合                                   |
 
-從代理中使用 `action=list-events` 調用 `manage-automations`，以檢視所有已註冊事件以及目前範本的描述和負載模式。
+從代理中使用 `action=list-events` 呼叫 `manage-automations`，以檢視所有已註冊事件以及目前範本的描述和負載模式。
 
 ### 發出自訂事件 {#emitting-events}
 
-在伺服器外掛中註冊事件型別，然後從 actions 或 webhook 處理程序發出它：
+在伺服器外掛中註冊事件型別，然後從 actions 或 webhook 處理常式發出它：
 
 ```ts
 import { registerEvent, emit } from "@agent-native/core/event-bus";
@@ -119,15 +119,15 @@ emit(
 );
 ```
 
-自動化觸發的發出元資料範圍中的 `owner` - 僅評估同一使用者擁有的自動化（或共用自動化）。
+自動化觸發的發出中繼資料範圍中的 `owner` - 僅評估同一使用者擁有的自動化（或共用自動化）。
 
 ## 條件 {#conditions}
 
 條件是 Claude Haiku 針對事件負載評估的自然語言字串。這是一個是/否分類，而不是生成工作。
 
 - **空或缺失條件** = 無條件（始終觸發）。
-- 結果通過 5 分鐘 TTL 和 500 個條目的 LRU 快取進行記憶（條件 + 負載的 SHA-256）。
-- 有效負載在發送到 Haiku 之前被截斷為 4000 個字符。
+- 結果透過 5 分鐘 TTL 和 500 個條目的 LRU 快取進行記憶（條件 + 負載的 SHA-256）。
+- 有效負載在傳送到 Haiku 之前被截斷為 4000 個字符。
 - 在 API 失敗時，條件評估為 `false`（安全預設值 - 跳過自動化）。
 
 條件範例：
@@ -138,7 +138,7 @@ emit(
 
 ## 網路請求工具 {#web-request}
 
-自動化使用 `web-request` 工具進行出站 HTTP。它支持 URL、標頭和內文中的 `${keys.NAME}` 預留位置：
+自動化使用 `web-request` 工具進行出站 HTTP。它支援 URL、標頭和內文中的 `${keys.NAME}` 預留位置：
 
 ```
 POST to ${keys.SLACK_WEBHOOK}
@@ -148,13 +148,13 @@ Headers: {"Authorization": "Bearer ${keys.API_TOKEN}"}
 Body: {"text": "New booking from ${attendeeEmail}"}
 ```
 
-在代理發出工具調用後，預留位置在**伺服器端**解析 - 原始秘密值永遠不會進入代理的上下文。
+在代理發出工具呼叫後，預留位置在**伺服器端**解析 - 原始秘密值永遠不會進入代理的脈絡。
 
 ### 參數 {#web-request-params}
 
 | 參數         | 型別 | 預設  | 描述                                               |
 | ------------ | ---- | ----- | -------------------------------------------------- |
-| `url`        | 字串 | —     | 完整的URL。可能包含 `${keys.NAME}` 引用。          |
+| `url`        | 字串 | —     | 完整的 URL。可能包含 `${keys.NAME}` 引用。         |
 | `method`     | 字串 | `GET` | HTTP 方法（GET、POST、PUT、PATCH、DELETE、HEAD）。 |
 | `headers`    | 字串 | `{}`  | JSON 標頭物件。可能包含 `${keys.NAME}`。           |
 | `body`       | 字串 | —     | 請求內文。可能包含 `${keys.NAME}`。                |
@@ -162,16 +162,16 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 
 ## 按鍵 {#keys}
 
-金鑰是由使用者或代理建立的用於自動化使用的臨時秘密（例如 `SLACK_WEBHOOK`、`HUBSPOT_API_KEY`）。它們與註冊機密 (`registerRequiredSecret`) 的不同之處在於它們沒有範本定義的元資料或入門步驟。
+金鑰是由使用者或代理建立的用於自動化使用的臨時秘密（例如 `SLACK_WEBHOOK`、`HUBSPOT_API_KEY`）。它們與註冊機密 (`registerRequiredSecret`) 的不同之處在於它們沒有範本定義的中繼資料或入門步驟。
 
-- 通過設定 UI 或 `/_agent-native/secrets/adhoc` API 建立。
-- 每個金鑰都可以有一個 **URL 允許清單**，用於限制金鑰可以發送到哪些來源（來源級別匹配）。
-- 原始值永遠不會暴露給 AI - 只有 `${keys.NAME}` 預留位置出現在代理的上下文中。
+- 透過設定 UI 或 `/_agent-native/secrets/adhoc` API 建立。
+- 每個金鑰都可以有一個 **URL 允許清單**，用於限制金鑰可以傳送到哪些來源（來源層級匹配）。
+- 原始值永遠不會暴露給 AI - 只有 `${keys.NAME}` 預留位置出現在代理的脈絡中。
 - 分辨率從使用者範圍回退到工作區範圍，因此使用者可以覆蓋共用金鑰。
 
 ## 代理工具 {#agent-tools}
 
-所有自動化操作均通過帶有 `action` 參數的單個 `manage-automations` 工具存取：
+所有自動化操作均透過帶有 `action` 參數的單一 `manage-automations` 工具存取：
 
 | 行動          | 目的                                                 |
 | ------------- | ---------------------------------------------------- |
@@ -184,7 +184,7 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 
 附加工具：`web-request` — 出站 HTTP 替換為 `${keys.NAME}`。
 
-## API端點 {#api}
+## API 端點 {#api}
 
 | 端點                                   | 方法   | 描述                         |
 | -------------------------------------- | ------ | ---------------------------- |
@@ -210,7 +210,7 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 
 ```an-diagram title="調度路徑" summary="從觸發事件到完成代理執行，由所有權範圍和自然語言條件控制。"
 {
-  "html": "<div class=\"disp\"><div class=\"diagram-box accent\">event fired on the bus</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">match</span><small class=\"diagram-muted\">load enabled automations subscribed to this event name</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">scope</span><small class=\"diagram-muted\">keep only those owned by the event's owner (or shared)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">condition</span><small class=\"diagram-muted\">Haiku yes/no on the payload &mdash; false &rarr; <code>skipped</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">run</span><small class=\"diagram-muted\"><code>runAgentLoop</code> body 作為提示、payload 作為上下文，5 分鐘超時</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code></small></div></div>",
+  "html": "<div class=\"disp\"><div class=\"diagram-box accent\">event fired on the bus</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">match</span><small class=\"diagram-muted\">load enabled automations subscribed to this event name</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">scope</span><small class=\"diagram-muted\">keep only those owned by the event's owner (or shared)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">condition</span><small class=\"diagram-muted\">Haiku yes/no on the payload &mdash; false &rarr; <code>skipped</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">run</span><small class=\"diagram-muted\"><code>runAgentLoop</code> body 作為提示、payload 作為脈絡，5 分鐘超時</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code></small></div></div>",
   "css": ".disp{display:flex;flex-direction:column;gap:6px;max-width:540px}.disp .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.disp .diagram-box{align-self:flex-start}.disp .diagram-arrow{font-size:18px;align-self:center}"
 }
 ```
@@ -221,9 +221,9 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 
 **代理流程：**
 
-1. 使用 `action=list-events` 調用 `manage-automations` — 找到 `calendar.booking.created`。
+1. 使用 `action=list-events` 呼叫 `manage-automations` — 找到 `calendar.booking.created`。
 2. 與使用者確認計畫。
-3. 使用 `action=define` 調用 `manage-automations`：
+3. 使用 `action=define` 呼叫 `manage-automations`：
    - `name`: `slack-on-builder-booking`
    - `trigger_type`: `event`
    - `event`: `calendar.booking.created`
@@ -231,11 +231,11 @@ Body: {"text": "New booking from ${attendeeEmail}"}
    - `mode`: `agentic`
    - `domain`: `calendar`
    - `body`: `Send a Slack message to #sales with the booking details. Use the web-request tool to POST to ${keys.SLACK_WEBHOOK}.`
-4. 自動化儲存為 `jobs/slack-on-builder-booking.md` 並立即開始監听。
+4. 自動化儲存為 `jobs/slack-on-builder-booking.md` 並立即開始監聽。
 
 ## 更多範例 {#more-examples}
 
-### 當計畫被評論時通過 webhook 通知
+### 當計畫被評論時透過 webhook 通知
 
 詢問計畫代理：_“當有人對計畫新增人工評論時，POST a
 向我的 webhook 發出通知。"_
@@ -257,12 +257,12 @@ POST to ${keys.NOTIFY_WEBHOOK} with a JSON body:
 將 `NOTIFY_WEBHOOK` 設定為任何 HTTP 端點 - Slack 傳入 Webhook，通用
 通知服務，或自訂接收器。 `web-request`工具解決
 `${keys.NOTIFY_WEBHOOK}` 伺服器端；原始的 URL 永遠不會出現在代理的
-上下文。見[Visual Plans — Events and notifications](/docs/template-plan#events)
+脈絡。見[Visual Plans — Events and notifications](/docs/template-plan#events)
 完整的 `plan.commented` 有效負載參考和所有四個計畫事件。
 
-## 下一步是什么
+## 下一步是什麼
 
-- [**Recurring Jobs**](/docs/recurring-jobs) - 計畫觸發的自動化重用相同的計畫程序
-- [**Actions**](/docs/actions) - 自動化可以通過代理循環調用任何註冊的操作
+- [**Recurring Jobs**](/docs/recurring-jobs) - 計畫觸發的自動化重用相同的計畫程式
+- [**Actions**](/docs/actions) - 自動化可以透過代理迴圈呼叫任何註冊的操作
 - [**Security**](/docs/security) - 輸入驗證和秘密處理
 - [**Visual Plans — Events**](/docs/template-plan#events) - 計畫事件參考和自動化秘訣

package/docs/content/locales/zh-TW/blueprint-installer.md

@@ -1,14 +1,14 @@
 ---
-title: "藍圖安裝程序"
-description: "agent-native add 將精心策劃的 Markdown 整合配方列印到標準輸出 - 將其通過管道傳輸到您的編碼代理，該代理將針對您的實時儲存庫應用更改。"
+title: "藍圖安裝程式"
+description: "agent-native add 將精心策劃的 Markdown 整合配方列印到標準輸出 - 將其透過管道傳輸到您的編碼代理，該代理將針對您的即時儲存庫應用更改。"
 ---
 
-# 藍圖安裝程序
+# 藍圖安裝程式
 
-> **這是誰的：** 新增提供者、渠道的主機作者和整合商，
-> 沙箱後端，或通過將配方傳輸到其編碼代理中來對儲存庫進行操作。
+> **這是誰的：** 新增提供者、管道的主機作者和整合商，
+> 沙箱後端，或透過將配方傳輸到其編碼代理中來對儲存庫進行操作。
 
-`agent-native add` 不是\*\*一個為你編寫檔案的愚蠢的腳手架。它將精心策劃的 Markdown _整合藍圖_ 發送到標準輸出。您可以將該藍圖傳輸到您自己的編碼代理（Claude 程式碼、Codex 等）中，該代理將針對具有完整上下文的實時儲存庫應用更改。
+`agent-native add` 不是\*\*一個為你編寫檔案的愚蠢的腳手架。它將精心策劃的 Markdown _整合藍圖_ 傳送到標準輸出。您可以將該藍圖傳輸到您自己的編碼代理（Claude 程式碼、Codex 等）中，該代理將針對具有完整脈絡的即時儲存庫應用更改。
 
 這符合代理應用更改、檔案系統優先的風格：框架提供配方（要接觸的規範檔案、要遵守的規則、驗證步驟），編碼代理進行編輯。
 
@@ -17,7 +17,7 @@ agent-native add provider stripe | claude
 agent-native add channel discord  | codex
 ```
 
-```an-diagram title="新增列印菜譜；您的編碼代理應用它" summary="agent-native 向 stdout 發出 Markdown 藍圖（對 stderr 進行診斷）；您可以將其通過管道傳輸到 Claude Code 或 Codex，這將使用完整的上下文編輯您的實時儲存庫。"
+```an-diagram title="新增列印配方；您的編碼代理應用它" summary="agent-native 向 stdout 發出 Markdown 藍圖（對 stderr 進行診斷）；您可以將其透過管道傳輸到 Claude Code 或 Codex，這將使用完整的脈絡編輯您的即時儲存庫。"
 {
   "html": "<div class=\"diagram-bp\"><div class=\"diagram-node\" data-rough>agent-native add<br><small class=\"diagram-muted\">&lt;kind&gt; &lt;name|URL&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Markdown 藍圖<br><small class=\"diagram-muted\">stdout · 要觸碰的檔案 · 規則 · 驗證</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>編碼 Agent<br><small class=\"diagram-muted\">claude · codex</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">edits your live repo</div></div>",
   "css": ".diagram-bp{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bp .diagram-arrow{font-size:22px;line-height:1}.diagram-bp .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -34,20 +34,20 @@ agent-native add --list                   # list available kinds and blueprints
 
 - 一個赤裸裸的**名字**就能解析出`blueprints/<kind>/<name>.md`精心策劃的藍圖。
 - **URL**（而不是名稱）會發出此類的通用*研究和整合*藍圖，其中嵌入 URL 作為研究起點（URL 是研究種子，而不是已知配方）。
-- 藍圖轉到 **stdout**；診斷會發送到 stderr，因此 `… | claude` 只會收到藍圖。
+- 藍圖轉到 **stdout**；診斷會傳送到 stderr，因此 `… | claude` 只會收到藍圖。
 
 ## 播種藍圖 {#seeded}
 
 `agent-native add --list` 顯示包裝盒中的物品：
 
-| 種類       | 姓名      | 它設定什么                                                             |
+| 種類       | 姓名      | 它設定什麼                                                             |
 | ---------- | --------- | ---------------------------------------------------------------------- |
-| `provider` | `stripe`  | 將提供程序連線到 `provider-api` 基板（目錄/檔案/請求三重奏）。         |
+| `provider` | `stripe`  | 將提供者連線到 `provider-api` 基板（目錄/檔案/請求三重奏）。           |
 | `channel`  | `discord` | 實現 `PlatformAdapter` 入站 Webhook 通道並註冊它。                     |
 | `sandbox`  | `docker`  | 實現 `SandboxAdapter` 接縫以在 Docker 容器中執行 `run-code`。          |
-| `action`   | `crud`    | 新增具有 Zod 架構的單個多表面 `defineAction`（一個 `update` 超過 N）。 |
+| `action`   | `crud`    | 新增具有 Zod 架構的單一多表面 `defineAction`（一個 `update` 超過 N）。 |
 
-每個藍圖都是獨立的：讀取它的編碼代理獲取要接觸的檔案、要遵守的框架規則（actions 是單一事實來源、從不硬編碼秘密、範圍可擁有的資料、為 `packages/*` 來源新增變更集）以及具體的 **驗證** 部分。
+每個藍圖都是獨立的：讀取它的編碼代理取得要接觸的檔案、要遵守的框架規則（actions 是單一事實來源、從不硬編碼秘密、範圍可擁有的資料、為 `packages/*` 來源新增變更集）以及具體的 **驗證** 部分。
 
 ## URL → 研究藍圖 {#url}
 
@@ -57,17 +57,17 @@ agent-native add --list                   # list available kinds and blueprints
 agent-native add provider https://docs.example.com/api | claude
 ```
 
-生成的藍圖告訴編碼代理獲取真實端點的 URL（及其連結到的頁面）、驗證模型、有效負載形狀和簽名/驗證要求（而不是從訓練資料中猜測），然後實施和驗證。它還帶有特定型別的指導（例如，`provider` URL 轉向 `provider-api` 基板；`channel` URL 轉向 `PlatformAdapter`）。
+產生的藍圖告訴編碼代理取得真實端點的 URL（及其連結到的頁面）、驗證模型、有效負載形狀和簽名/驗證要求（而不是從訓練資料中猜測），然後實施和驗證。它還帶有特定型別的指導（例如，`provider` URL 轉向 `provider-api` 基板；`channel` URL 轉向 `PlatformAdapter`）。
 
 ## 新增您自己的藍圖 {#authoring}
 
-將 Markdown 檔案拖放到 `packages/core/blueprints/<kind>/<name>.md` 中。 kind 是子目錄；該名稱是不帶 `.md` 的檔案名。它是自動拾取的 - `--list`、名稱解析和目錄都在執行時讀取目錄。無需更改程式碼即可註冊。
+將 Markdown 檔案拖放到 `packages/core/blueprints/<kind>/<name>.md` 中。 kind 是子目錄；該名稱是不帶 `.md` 的檔名。它是自動拾取的 - `--list`、名稱解析和目錄都在執行時讀取目錄。無需更改程式碼即可註冊。
 
-藍圖 `.md` 檔案通過 `package.json` `files` 中的 `blueprints` 條目發送到已發布的包中，因此最終使用者可以在 `node_modules/@agent-native/core/blueprints/**` 上進行解析。
+藍圖 `.md` 檔案透過 `package.json` `files` 中的 `blueprints` 條目傳送到已發布的包中，因此最終使用者可以在 `node_modules/@agent-native/core/blueprints/**` 上進行解析。
 
-將每個藍圖編寫為編碼代理的指令集，沒有其他上下文。一個好的藍圖具有：
+將每個藍圖編寫為編碼代理的指令集，沒有其他脈絡。一個好的藍圖具有：
 
-1. **一行目標**和“您是代理本機應用程式中的編碼代理，將這些作為真正的來源更改應用”框架。
+1. **一行目標**和“您是 Agent-Native 應用程式中的編碼代理，將這些作為真正的來源更改應用”框架。
 2. **首先閱讀** - *是*合約的確切檔案。
 3. **要接觸的檔案** - 具體路徑以及每個更改的作用。
 4. **要遵守的框架規則** - actions-first，無硬編碼秘密，範圍可擁有的資料，新增可發布包來源的變更集。
@@ -76,8 +76,8 @@ agent-native add provider https://docs.example.com/api | claude
 > [!TIP]
 > 現有型別下的新策劃藍圖不需要程式碼 - 但如果您建立一個全新的型別目錄，該型別也會自動顯示在 `--list` 中。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Sandbox Adapters**](/docs/sandbox-adapters) — `add sandbox docker` 藍圖目標的接縫
 - [**Actions**](/docs/actions) - 每個藍圖建置的單一事實來源
-- [**External Agents**](/docs/external-agents) — 連線將藍圖通過管道傳輸到的編碼代理
+- [**External Agents**](/docs/external-agents) — 連線將藍圖透過管道傳輸到的編碼代理