@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/docs/content/locales/zh-CN/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 
 # 工作区
 
-> **哪个工作区文档？** 此页面涵盖 **自定义层** — 工作区*是什么*。对于部署形状（一个单一存储库，许多应用程序），请参阅 [Multi-App Workspaces](/docs/multi-app-workspace)；有关治理（谁审查、批准和拥有什么），请参阅 [Workspace Governance](/docs/workspace-management)。
+<Callout tone="info">
+
+**哪个工作区文档？** 此页面涵盖 **自定义层** — 工作区*是什么*。对于部署形状（一个单一存储库，许多应用程序），请参阅 [Multi-App Workspaces](/docs/multi-app-workspace)；有关治理（谁审查、批准和拥有什么），请参阅 [Workspace Governance](/docs/workspace-management)。
+
+</Callout>
 
 每个代理本机应用程序都附带一个**工作区**：使代理成为您的自定义层。它包含团队指令 (`AGENTS.md`)、共享学习内容 (`LEARNINGS.md`)、个人结构化内存 (`memory/MEMORY.md`)、代理按需拉入的 skills、自定义子代理、计划作业和连接的 MCP 服务器 — 您期望从 Claude 代码 / Codex 设置获得的一切。
 
@@ -81,7 +85,7 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 | 每个项目 `CLAUDE.md` / skills | 每个应用 `AGENTS.md` + 工作区内存资源   |
 | JSON 文件中的 MCP 配置        | JSON 中的 MCP 配置*或*设置 UI，每个范围 |
 
-相同的功能。不同的经济。请参阅 [Templates](/docs/cloneable-saas) 了解为什么这对 SaaS 很重要。
+相同的功能。不同的经济。请参阅 [应用程序](/docs/cloneable-saas) 了解为什么这对 SaaS 很重要。
 
 ## 概述 {#overview}
 
@@ -218,11 +222,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-保持 `context/` 文件简短且真实——代理可以浏览的一些要点：
-
-```text
-<!-- context/brand.md -->
+例如：
 
+```text filename="context/brand.md"
 # 品牌
 
 - Voice: direct, warm, concrete
@@ -387,15 +389,9 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 
 在一个应用程序内使用自定义代理进行委派。当您需要通过 A2A 调用另一个应用程序时，请使用连接的代理。
 
-## @标记 {#at-tagging}
-
-在聊天输入中键入 `@` 以引用工作区项目。光标处会出现一个下拉列表，显示匹配的代理和文件。使用箭头键进行导航并使用 Enter 进行选择。所选项目在输入中显示为内联芯片。
-
-当您发送消息时，**文件/资源**作为代理可以读取的引用进行传递，**自定义代理**使用其配置文件指令在本地运行，并且**连接的代理**通过 A2A 进行调用。
+## @ 标记与 / 斜杠命令 {#at-tagging}
 
-## / 斜线命令 {#slash-commands}
-
-在行首键入 `/` 以调用技能。下拉列表显示可用的 skills 及其名称和描述；选择一个会添加一个内联芯片，并在发送消息时将其内容作为上下文包含在内。如果未配置 skills，则下拉列表链接到这些文档。
+在聊天输入框中键入 `@` 可引用代理、文件或资源，键入 `/` 可调用 skill——两者都会在光标处打开下拉菜单，并在选择项目后添加内联标签。有关完整机制（路由、`MentionProvider`、子代理选择），请参阅[代理提及](/docs/agent-mentions)；有关 skills 的编写和发现方式，请参阅 [Skills 指南](/docs/skills-guide)。
 
 ## 代码与应用程序模式 {#dev-vs-prod}
 
@@ -415,10 +411,6 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 
 请参阅 [Workspace Connections](/docs/workspace-connections) 了解快速入门、connection/grant/credentialRef API 以及具体的 Slack、HubSpot 和 GitHub 示例。
 
----
-
-# 参考
-
 ## 资源API {#resource-api}
 
 可以通过服务器代码、actions 或 REST API 管理资源。
@@ -462,3 +454,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# 会议记录..
 # 删除资源
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## 接下来 {#whats-next}
+
+- [**Skills 指南**](/docs/skills-guide) — 编写 `skills/` 中引用的 skill 文件并设置其范围
+- [**代理提及**](/docs/agent-mentions) — `@` 提及与 `/` 命令的完整机制
+- [**定期作业**](/docs/recurring-jobs) — 调度由 Scheduled Tasks 创建的提示词
+- [**Workspace 治理**](/docs/workspace-management) — 谁负责审核、批准和拥有 workspace 更改
+- [**多应用 Workspace**](/docs/multi-app-workspace) — 一个 workspace 所跨越的部署形态
+- [**Workspace 连接**](/docs/workspace-connections) — 在应用程序之间共享提供商凭据

package/corpus/core/docs/content/locales/zh-TW/actions.mdx

@@ -11,7 +11,7 @@ Actions 是您的應用所做的任何事情的唯一事實來源。使用 `defi
 - **型別安全 React 掛鉤** - 前端的 `useActionQuery("name")` 和 `useActionMutation("name")`，從架構推斷的型別。
 - **指令式用戶端呼叫** — 當鉤子不適合時 `callAction("name", params)`。
 - **框架傳輸** — 由這些鉤子後面的框架自動安裝，並可供外部 HTTP 用戶端使用。
-- **MCP 工具** - 暴露給 Claude、ChatGPT 自訂 MCP 應用、Claude 桌面/程式碼、游標、Codex 和任何其他 MCP 用戶端。
+- **MCP 工具** - 暴露給 Claude、ChatGPT 自訂 MCP 應用、Claude 桌面/程式碼、游標、Codex 和任何其他 MCP 主機。
 - **A2A 工具** — 由其他 Agent-Native 應用透過 A2A 呼叫。
 - **CLI 指令** - `pnpm action <name>` 用於指令碼和開發迴圈。
 
@@ -558,7 +558,7 @@ export default defineAction({
 });
 ```
 
-保留 `link` 作為 CLI 和非 UI MCP 用戶端的後備；這也是嵌入的啟動目標。嵌入橋 - 已簽名的嵌入啟動工作階段、移植與受控幀渲染、`ui/*` 主橋、CSP 和高度限制 - 歸 [External Agents](/docs/external-agents#mcp-app-bridge) 所有。
+保留 `link` 作為 CLI 和非 UI MCP 主機的後備；這也是嵌入的啟動目標。嵌入橋 - 已簽名的嵌入啟動工作階段、移植與受控幀渲染、`ui/*` 主橋、CSP 和高度限制 - 歸 [External Agents](/docs/external-agents#mcp-app-bridge) 所有。
 
 ## 標準actions {#standard-actions}
 

package/corpus/core/docs/content/locales/zh-TW/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.mdx

@@ -136,8 +136,7 @@ pnpm install
 
 然後定義持久操作：
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -488,12 +487,11 @@ iframe/picker 模式，以及較低階別的橋 APIs。
 聊天需要豐富 UI 時的小工具結果，並且僅在使用者時新增全螢幕
 需要瀏覽、比較、設定或協作持久物件。
 
-## 相關檔案 {#related-docs}
+## 下一步 {#related-docs}
 
-- [Actions](/docs/actions) — 定義一次無頭操作。
-- [Native 聊天介面](/docs/native-chat-ui) — 在聊天中呈現鍵入的操作結果。
-- [Drop-in Agent](/docs/drop-in-agent) — 安裝聊天、側邊欄或面板表面。
-- [Component API](/docs/components) — 較低階別的 React 聊天/合成片段。
-- [Embedding SDK](/docs/embedding-sdk) — 將 Agent-Native 新增到現有應用。
-- [External Agents](/docs/external-agents) — 將 MCP 相容主機連線到應用。
-- [A2A Protocol](/docs/a2a-protocol) — 從其他座席呼叫座席。
+- [**Actions**](/docs/actions) — 只需定義一次操作；上述每個介面都會呼叫同一個操作
+- [**Native 聊天介面**](/docs/native-chat-ui) — 在聊天中將型別化的 action 結果呈現為表格、圖表和卡片
+- [**Generative UI**](/docs/generative-ui) — 在聊天中產生暫時或持久化的沙盒 UI
+- [**Automation-First Apps**](/docs/pure-agent-apps) — 面向作業、佇列、指令碼和外部代理的完整無瀏覽器模式
+- [**External Agents**](/docs/external-agents) — 將 MCP 相容主機連線到應用
+- [**A2A Protocol**](/docs/a2a-protocol) — 從其他 Agent-Native 應用呼叫代理

package/corpus/core/docs/content/locales/zh-TW/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

package/corpus/core/docs/content/locales/zh-TW/authentication.mdx

@@ -15,7 +15,7 @@ Auth 是透過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的
 - **遠端 MCP OAuth：** 適用於 MCP 主機的標準 OAuth 2.1，例如 Claude 程式碼和 ChatGPT 連線器。
 - **自訂：**透過 `getSession` 回調帶來您自己的驗證。
 
-<Diagram id="doc-block-4yfl8j" title={"三種方式，一次會議"} summary={"瀏覽器訪客、程式化 MCP 用戶端和自訂提供者都解析為下游作用域讀取的同一 AuthSession。"}>
+<Diagram id="doc-block-4yfl8j" title={"三種方式，一次會議"} summary={"瀏覽器訪客、MCP 主機和自訂提供者都解析為下游作用域讀取的同一 AuthSession。"}>
 
 ```html
 <div class="auth-modes">

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

@@ -470,10 +470,12 @@ function WorkspaceResources() {
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -488,3 +490,11 @@ export default defineAction({
 使用 `sendToAgentChat({ background: true, openSidebar: false })` 代替
 工作需要工具、狀態、可審計性、使用者指導或多步驟
 推理。
+
+## 下一步 {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — 透過教學優先的引導掛載 `<AgentSidebar>` 和 `<AgentPanel>`
+- [**Native Chat UI**](/docs/native-chat-ui) — 資料小工具和自訂轉譯器背後的操作結果契約
+- [**Actions**](/docs/actions) — `defineAction()`、結構描述以及這些元件呼叫的操作介面
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — 深入了解協作掛鉤和在線狀態元件
+- [**Sharing**](/docs/sharing) — 為可擁有資源連接 `<ShareButton>` 和 `<ShareDialog>`

package/corpus/core/docs/content/locales/zh-TW/creating-templates.mdx

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-xwc8h5"
   title={"範本專案結構"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ npx @agent-native/core@latest create my-platform
 
 使用框架 Drizzle 幫助程式定義域表，以便架構在 SQLite、Postgres、D1、Turso、Supabase、Neon 和其他支援的後端之間保持可移植性：
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ export const projectShares = createSharesTable("project_shares");
 
 對於應用程式讀取和寫入，請使用 Drizzle 的查詢生成器和 `drizzle-orm` 的可移植運算符。當 Drizzle 可以表達查詢時，不要使用原始 SQL 編寫產品程式碼，並且不要在範本中從`drizzle-orm/sqlite-core`或`drizzle-orm/pg-core`匯入。
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ export function useNavigationState() {
 `path`（當 URL 已知時）。同一動作不要寫為 `__set_url__`；
 該金鑰是為框架 URL 工具和僅 URL 過濾器更改保留的。
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/corpus/core/docs/content/locales/zh-TW/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "使用 Dispatch 作為身分授權，透過身分聯合在每個
 
 這與 [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)。
+<Callout tone="info">
+
+**統一部署與每個域部署。** 如果您在一個來源（`your-agents.com/mail`、`your-agents.com/calendar`）託管所有應用程式，您已經透過單一 cookie 域獲得共用登入 - 無需聯合。僅當應用程式在不同的域上執行時，才需要跨應用程式 SSO。參見[Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)。
+
+</Callout>
 
 ## 什麼以及為什麼 {#what-why}
 
@@ -86,15 +90,17 @@ description: "使用 Dispatch 作為身分授權，透過身分聯合在每個
 
 </Diagram>
 
-1. **應用程式→調度（授權）。**應用程式將使用者傳送到身分授權機構：
+1. **應用 → Dispatch（授權）。** 應用端的 `GET /_agent-native/identity/login` 路由（「使用 Agent-Native 登入」按鈕連結到的路由）建立重新導向，並將使用者傳送到身分授權機構：
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &狀態=<csrf-state>
    ```
 
+   `redirect_uri` 是此應用自己的 `GET /_agent-native/identity/callback` 路由，也就是在步驟 3 中接收簽署權杖的路由。
+
 <Endpoint id="cross-app-sso-identity-authorize-zh-tw" title={"身分授權端點"} method="GET" path="/_agent-native/identity/authorize" summary={"Dispatch（身分授權）對人員進行驗證並使用簽名的身分權杖重新導向回來"} auth={"調度工作階段（如果沒有則互動式登入）"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ description: "使用 Dispatch 作為身分授權，透過身分聯合在每個
    | `scope`      | 始終為 `"identity"` — 此權杖僅授權登入      |
    | `exp`        | **≤ 2 分鐘** 距問題                         |
 
-4. **應用程式透過電子郵件驗證和 JIT 連結。**應用程式使用自己的 `A2A_SECRET` 驗證權杖簽名，檢查 `scope: "identity"` 和 `exp`，然後嚴格透過經過驗證的電子郵件執行**即時連結**：
+4. **應用透過電子郵件驗證並進行 JIT 連結。** 應用的 `GET /_agent-native/identity/callback` 路由使用自己的 `A2A_SECRET` 驗證權杖簽章，檢查 `scope: "identity"` 和 `exp`，然後**嚴格依已驗證電子郵件執行即時連結**：
    - 如果具有該電子郵件地址的本機使用者存在 → 不加修改地重新使用它。
    - 如果沒有 → 為該電子郵件建立本機使用者。
 
@@ -288,9 +294,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 **5。回滾 = 取消設定該應用程式部署上的環境變數。**
 要恢復任何應用程式，**從該應用程式的環境中刪除 `AGENT_NATIVE_IDENTITY_HUB_URL` 並重新部署/重新啟動它。**應用程式立即返回到其之前的驗證行為。 **沒有資料更改可以復原** - 僅新增了識別行，取消設定變數只會使聯合路徑再次休眠。每個應用的割接和回滾都是獨立且可逆的。
 
-> 啟用每個應用程式時，Rollout 會將使用者登出（他們透過 Dispatch 重新進行驗證），但他們始終會重新登入到**相同的電子郵件匹配帳戶，並且資料完好無損**，因為身分行永遠不會被銷毀或重新命名 - 只是新增。
+<Callout tone="info">
+
+啟用每個應用程式時，Rollout 會將使用者登出（他們透過 Dispatch 重新進行驗證），但他們始終會重新登入到**相同的電子郵件匹配帳戶，並且資料完好無損**，因為身分行永遠不會被銷毀或重新命名 - 只是新增。
+
+</Callout>
 
-## 相關 {#related}
+## 下一步 {#whats-next}
 
 - [Authentication](/docs/authentication) — 本機驗證模式、工作階段、組織、`A2A_SECRET` 環境變數。
 - [A2A Protocol](/docs/a2a-protocol) — 已簽名的 JWT，它重用的邊界驗證信任模型。

package/corpus/core/docs/content/locales/zh-TW/deployment.mdx

@@ -451,3 +451,11 @@ agent-native 的核心功能之一是代理可以修改應用程式的來源程
 ## 多執行個體部署 {#multi-instance}
 
 Agent-Native 應用程式透過 Drizzle 將所有狀態儲存在 SQL 中，並透過 [polling](/docs/key-concepts#polling-sync) 與資料庫同步 UI — 無檔案系統狀態、無置頂工作階段、無記憶快取。這意味著多執行個體和無伺服器部署開箱即用：將每個執行個體指向同一個 `DATABASE_URL`，它們會自動聚合。請參閱 [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) 和 [Portability](/docs/key-concepts#hosting-agnostic)。
+
+## 下一步
+
+- [**Database**](/docs/database#production) — 在首次生產部署前選擇持久化 SQL 後端
+- [**Security**](/docs/security) — 本頁提到的生產檢查清單和選用旗標
+- [**Authentication**](/docs/authentication) — 所選驗證模式的 OAuth 憑證和環境變數
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — `deploy` 單一來源建置背後的工作區模型
+- [**Frames**](/docs/frames) — 用於生產 UI 編輯的嵌入式代理面板與 Builder.io 雲端框架

package/corpus/core/docs/content/locales/zh-TW/external-agents.mdx

@@ -136,13 +136,8 @@ OAuth 代幣。 ChatGPT 可以保留已審查或已發布的連線器工具
 工具或 MCP 應用中繼資料更改。如果您仍然有舊的每應用連線器
 與調度、重新整理或重新連線每個過時的連線器一起啟用；正在更新
 Dispatch 不會重寫 ChatGPT 或 Claude 的快取行事曆/郵件/等。
-快照。範圍是：
-
-| 範圍        | 它能實現什麼                               |
-| ----------- | ------------------------------------------ |
-| `mcp:read`  | 唯讀工具和工具/資源發現                    |
-| `mcp:write` | 起草、更新和其他修改actions                |
-| `mcp:apps`  | 行內 MCP 應用程式、圖表、儀表板、草稿和 UI |
+快照。`mcp:read` / `mcp:write` / `mcp:apps` 範圍與下文
+[標準遠端 MCP OAuth](#standard-oauth) 中介紹的相同。
 
 Cursor、Goose、Postman、MCPJam 和 VS Code GitHub Copilot 使用相同的遙控器
 當其建置支援遠端 OAuth 時，MCP URL 透過自己的 MCP 伺服器 UI

package/corpus/core/docs/content/locales/zh-TW/key-concepts.mdx

@@ -11,11 +11,9 @@ Agent-Native 應用程式如何在幕後工作 - 原則和架構。此頁面為
 
 每個 Agent-Native 應用程式都由三部分協同工作：
 
-> **代理** — 讀取資料、寫入資料、執行 actions 和修改程式碼的自主 AI。可使用 skills 和說明進行定制。
->
-> **應用** — 試劑週圍的產品表面。一開始這可能只是操作、豐富的聊天、小型控制平面或帶有儀表板、流程和視覺化的完整 React 介面。
->
-> **電腦** — 資料庫、瀏覽器、程式碼執行。代理直接使用 SQL 和內建工具進行工作； MCP 伺服器是可選的附加元件，而不是基礎。
+- **代理** — 讀取資料、寫入資料、執行 actions 和修改程式碼的自主 AI。可使用 skills 和說明進行定制。
+- **應用** — 試劑週圍的產品表面。一開始這可能只是操作、豐富的聊天、小型控制平面或帶有儀表板、流程和視覺化的完整 React 介面。
+- **電腦** — 資料庫、瀏覽器、程式碼執行。代理直接使用 SQL 和內建工具進行工作； MCP 伺服器是可選的附加元件，而不是基礎。
 
 <Diagram id="doc-block-1apqpo9" title={"代理、應用程式和電腦"} summary={"三層在一個共用的 SQL 儲存上協同工作。代理和應用程式讀取和寫入相同的資料。"}>
 
@@ -274,8 +272,7 @@ sendToAgentChat({
 
 當代理需要做一些複雜的事情時——呼叫 API、處理資料、查詢資料庫——它會執行一個**操作**。 Actions 是 `actions/` 中的 TypeScript 檔案，匯出預設的 `defineAction()`：
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -373,9 +370,8 @@ _frame_ 是在您的應用程式旁邊託管代理的環境 - 在本機是嵌入
 
 Agent-Native 應用程式包括一個嵌入式代理面板，該面板與應用程式 UI 一起提供 AI 代理。這就是架構發揮作用的原因：代理需要電腦（資料庫、瀏覽器、程式碼執行），而應用程式需要代理來進行 AI 工作。
 
-> **嵌入式代理面板** - 每個應用程式中內建聊天和可選的 CLI 終端。支援 Claude 程式碼、Codex、Gemini、OpenCode 和 Builder.io。在本機執行。免費且開放原始碼。
->
-> **雲端** — 透過即時協作、視覺化編輯、角色和權限部署到任何雲端。最適合團隊。
+- **嵌入式代理面板** - 每個應用程式中內建聊天和可選的 CLI 終端。支援 Claude 程式碼、Codex、Gemini、OpenCode 和 Builder.io。在本機執行。免費且開放原始碼。
+- **雲端** — 透過即時協作、視覺化編輯、角色和權限部署到任何雲端。最適合團隊。
 
 ## 情境感知 {#context-awareness}
 
@@ -447,14 +443,11 @@ UI 在路由變更時寫入此資訊；代理在採取任何操作之前都會
 
 這就是“以及其他所有東西”，否則你需要自己將它們粘合在一起。
 
-## 深入研究 {#deep-dives}
-
-有關特定模式的詳細指導：
+## 下一步 {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — 願景和理念
-- [Context Awareness](/docs/context-awareness) — 導覽狀態、檢視螢幕、導覽指令
-- [Skills Guide](/docs/skills-guide) — 框架 skills，域 skills，建立自訂 skills
-- [Native 聊天介面](/docs/native-chat-ui) — 操作聲明的表格、圖表和 BYO 執行時狀態
-- [Agent Surfaces](/docs/agent-surfaces) — 無頭、豐富的聊天、嵌入式 sidecar 和完整應用路徑
-- [A2A Protocol](/docs/a2a-protocol) — 代理間通信
-- [Multi-App Workspace](/docs/multi-app-workspace) — 在一個單一儲存庫中託管多個應用程式，並具有共用驗證、skills、元件和憑證
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — 這些規則背後的願景和理念
+- [**Context Awareness**](/docs/context-awareness) — 深入了解導覽狀態、view-screen 和 navigate 指令
+- [**Skills Guide**](/docs/skills-guide) — 框架 skills、領域 skills 以及建立自訂 skills
+- [**Native Chat UI**](/docs/native-chat-ui) — action 宣告的表格、圖表和自備執行階段支援
+- [**Agent Surfaces**](/docs/agent-surfaces) — 聊天、原生行內 UI、完整應用頁面、嵌入式 sidecar、自動化和外部代理路徑
+- [**A2A Protocol**](/docs/a2a-protocol) — 代理間通訊

package/corpus/core/docs/content/locales/zh-TW/multi-tenancy.mdx

@@ -17,7 +17,7 @@ description: "每個 Agent-Native 應用程式都是開箱即用的多租戶 -
 - **組織切換** — 工作階段跟蹤活動組織 (`session.orgId`)，切換它會更改使用者和代理看到的資料。
 - **每組織資料隔離** — 每個查詢都會自動限定到活動組織。
 
-如果您正在評估 CRM、專案跟蹤器、支援收件箱或任何團隊工具的原生代理，那麼多租戶基礎已經存在。所有第一方範本都是多租戶的 - 請參閱 [Cloneable SaaS templates](/docs/cloneable-saas) 取得清單。
+如果您正在評估 CRM、專案跟蹤器、支援收件箱或任何團隊工具的原生代理，那麼多租戶基礎已經存在。所有第一方範本都是多租戶的 - 請參閱 [範本](/docs/cloneable-saas) 取得清單。
 
 <Diagram id="doc-block-1yxf5fa" title={"組織成員資格和隔離"} summary={"使用者以 owner/admin/member 身分加入組織。每個可擁有的行都帶有擁有它的租戶的 org_id ，並且沒有行跨越邊界泄漏。"}>
 
@@ -117,8 +117,8 @@ description: "每個 Agent-Native 應用程式都是開箱即用的多租戶 -
 
 這與用於每使用者範圍的管道相同。對於 SQL 層級的機制、`ownableColumns()` 合約和 `accessFilter` / `resolveAccess` / `assertAccess` 防護，請參閱 [Security → Data Scoping](/docs/security#data-scoping) — 範圍界定管道的單一事實來源。
 
-## 相關檔案 {#related}
+## 下一步 {#related}
 
-- [Authentication](/docs/authentication#organizations) — 工作階段、社交提供者和組織管理介面
-- [Security → Data Scoping](/docs/security#data-scoping) - SQL 級隔離、`ownableColumns()` 合約和存取防護
-- [Multi-App Workspace](/docs/multi-app-workspace) — 在具有共用驗證和 RBAC 的單一儲存庫中託管多個 Agent-Native 應用程式
+- [**Authentication**](/docs/authentication#organizations) — 工作階段、社交提供者和組織管理介面
+- [**Security — Data Scoping**](/docs/security#data-scoping) — SQL 層級隔離、`ownableColumns()` 合約和存取防護
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — 在一個 monorepo 中託管多個 Agent-Native 應用，共用驗證和 RBAC

package/corpus/core/docs/content/locales/zh-TW/notifications.mdx

@@ -113,6 +113,7 @@ await notify(
 | `inbox`   | 持久化到`notifications`表；驅動鈴 UI | 始終開啟 - 原語的一部分。                          |
 | `webhook` | POST JSON 到已設定的 URL             | `NOTIFICATIONS_WEBHOOK_URL` 環境變數在啟動時設定。 |
 
+電子郵件、Slack 和 webhook 一律與收件匣一起註冊。傳送時會優先使用每則通知中繼資料的 URL 或收件者，然後退回使用相符的環境變數。如果兩者皆未設定，該頻道在發送時不會執行任何動作。
 Webhook 通道根據所有者的臨時 [secrets](/docs/security) 解析 URL 和 `NOTIFICATIONS_WEBHOOK_AUTH` 中的 `${keys.NAME}` 引用，因此原始值永遠不會進入代理的脈絡。強制執行每鍵 URL 允許清單 - 自動化 `web-request` 工具使用相同的規則。
 
 <Diagram id="doc-block-ff63b6" title={"管道和嚴重性"} summary={"收件箱始終開啟； webhook 需要一個環境變數；自訂頻道在啟動時註冊。嚴重性驅動徽章樣式並傳遞到每個管道。"}>
@@ -203,7 +204,7 @@ await notify(
 
 從任何伺服器外掛註冊自訂通道。
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 透過 core-routes 外掛安裝在 `/_agent-native/notifications/*`。所有路由的範圍僅限於經過驗證的工作階段的電子郵件。
 
-| 方法     | 路徑                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| 方法     | 路徑                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-te34xy" title={"列出通知"} summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"列出目前使用者的最近通知"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-te34xy" title={"列出通知"} method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"列出目前使用者的最近通知"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ interface NotificationMeta {
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "ISO 時間戳記游標 — 傳回在此時間之前建立的通知，用於分頁。"
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ interface NotificationMeta {
 
 ## UI 元件 {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

package/corpus/core/docs/content/locales/zh-TW/processors.mdx

@@ -49,8 +49,11 @@ description: "迴圈內部觀察者/護欄掛鉤，用於監視模型的流輸
 
 </Diagram>
 
-> [!WARNING]
-> 處理器是**設定**，不是工具，不是操作，也不是創作 DSL。處理器僅觀察、改變它們自己的流範圍狀態和 `abort()`。它們從不定義應用程式行為、替換 actions 或出現在模型中。應用程式操作屬於[actions](/docs/actions)。
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+處理器是**設定**，不是工具，不是操作，也不是創作 DSL。處理器僅觀察、改變它們自己的流範圍狀態和 `abort()`。它們從不定義應用程式行為、替換 actions 或出現在模型中。應用程式操作屬於[actions](/docs/actions)。
+
+</Callout>
 
 ## 掛鉤 {#hooks}
 
@@ -131,10 +134,13 @@ await runAgentLoop({
 
 **未使用時零開銷。**僅當提供至少一個處理器時，迴圈才會建置處理器鏈；當 `processors` 被省略或為空時，沒有任何接縫程式碼執行，並且迴圈逐位元組不變。掛鉤按註冊順序執行，可以是同步的，也可以是非同步的。
 
-> [!NOTE]
-> 迴圈級接縫是今天的可交付成果，可由子代理、A2A、MCP 和測試直接呼叫。透過 HTTP 聊天處理常式對話串化 `processors`（因此每個請求解析器可以在不直接呼叫 `runAgentLoop` 的情況下設定它們）是尚未連線的便利管道 - 現在在 `runAgentLoop` 呼叫站點設定處理器。
+<Callout id="doc-block-proc1note" tone="info">
+
+迴圈級接縫是今天的可交付成果，可由子代理、A2A、MCP 和測試直接呼叫。透過 HTTP 聊天處理常式對話串化 `processors`（因此每個請求解析器可以在不直接呼叫 `runAgentLoop` 的情況下設定它們）是尚未連線的便利管道 - 現在在 `runAgentLoop` 呼叫站點設定處理器。
+
+</Callout>
 
-## 相關
+## 下一步
 
 - [**Durable Resume**](/docs/durable-resume) — 迴圈如何在中斷中幸存下來而不重新執行已完成的副作用。
 - [**Custom Agents & Teams**](/docs/agent-teams) - 子代理執行相同的迴圈並可以攜帶自己的處理器。

package/corpus/core/docs/content/locales/zh-TW/server.mdx

@@ -92,8 +92,7 @@ server/routes/
 
 每條路由匯出一個`defineEventHandler`：
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -133,8 +132,7 @@ export default defineEventHandler(() => ({
 
 對於唯讀狀態 endpoint，請保持為 action：
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -167,8 +165,7 @@ GET /_agent-native/actions/get-status?service=billing
 工具、聊天紀錄或執行狀態，使用 `completeText()` 作為顯式轉義
 孵化。
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -233,8 +230,7 @@ Actions 由框架自動安裝並與請求脈絡一起執行。自訂路由則不
 
 外掛位於 `server/plugins/` 中並在啟動時執行。將它們用於遷移、提供者設定、重複作業、整合轉接器和框架外掛設定。
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -412,8 +408,10 @@ Agent-Native 不依賴於檔案系統觀察程式或置頂記憶狀態。當 act
 
 </Diagram>
 
-> [!WARNING]
-> 不要依賴返回回應後未等待的承諾 — 無伺服器主機會凍結執行。請參閱 [Messaging](/docs/messaging) 以了解規範整合佇列。
+<Callout tone="warning">
+  不要依賴返回回應後未等待的承諾 — 無伺服器主機會凍結執行。請參閱
+  [Messaging](/docs/messaging) 以了解規範整合佇列。
+</Callout>
 
 ## 進階：逃生艙口 {#advanced-escape-hatches}
 
@@ -455,3 +453,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## 後續步驟
+
+- [**Actions**](/docs/actions) — 預設操作介面；只有在不適用時才使用自訂路由
+- [**資料庫**](/docs/database) — 自訂路由和 actions 都會匯入的 `getDb()`/`schema` 模式
+- [**安全性**](/docs/security#access-guards) — `accessFilter`/`assertAccess` 和完整的資料範圍模型
+- [**訊息傳遞**](/docs/messaging) — 傳入 webhook 的標準整合佇列模式
+- [**MCP 通訊協定**](/docs/mcp-protocol) — 此伺服器自動掛載的 `/_agent-native/mcp` 端點

package/corpus/core/docs/content/locales/zh-TW/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "共用和隱私"
-description: "Google Docs 風格的共用，內建於框架中。每個使用者建立的資源（檔案、儀表板、設計、簡報、剪輯、錄音、表單）都會獲得相同的預設私人模型以及一致的共用 UI。"
+description: "框架內建了熟悉且一致的共享方式。使用者建立的每種資源（文件、儀表板、設計、簡報、剪輯、錄音和表單）都採用相同的預設私人模型和一致的共享 UI。"
 ---
 
 # 共用和隱私
 
 使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
 
-它的外觀和工作方式與 Google 檔案類似。相同的共用按鈕、相同的對話框、相同的三層可見性模型、相同的每使用者/每組織授權 - 跨每個範本，無需針對每個應用進行重新設計。
+所有地方都使用一種熟悉的共享模型：相同的共享按鈕、相同的對話框、相同的三級可見性模型，以及相同的按使用者和按組織授權，涵蓋每個範本，無需為每個應用程式重新實作。
 
 ## 為什麼選取一種模型 {#why}
 
@@ -92,7 +92,7 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 - **內容** — 檔案
 - **幻燈片** — 幻燈片
 - **設計** — 設計和資產
-- **剪輯** — 螢幕錄製（Loom 風格）
+- **剪輯** — 螢幕錄製
 - **Plan** — visual plans and PR recaps
 - **表單** — 表單定義
 - **行事曆** — 活動和預訂連結
@@ -115,7 +115,7 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 
 - 可見性選取器（`Private` / `Organization` / `Public link`）。
 - “新增人員或團隊”自動完成 - 搜尋組織中的使用者或貼上電子郵件。
-- 用於個人電子郵件授權的 Google 檔案樣式 `通知 people` 核取方塊。
+- 用於個別電子郵件授權的 `通知人員` 核取方塊。
 - 包含角色選取器和刪除控制項的目前授權清單。
 - 尊重目前可見性的複製連結按鈕。
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 `server/db/index.ts` 中的一次註冊電話：
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 共用依賴於框架更廣泛的資料範圍模型 - 對可擁有表的清單/讀/寫存取透過 `accessFilter()` / `resolveAccess()` / `assertAccess()`，並且 `org_id` 標記的資源在組織中不可見。有關完整管道、CI 防護和威脅面，請參閱 [Security → Data Scoping](/docs/security#data-scoping)。
 
-## 另請參閱 {#see-also}
+## 後續步驟 {#see-also}
 
-- [Security & Data Scoping](/docs/security) - 共用所依賴的存取過濾器和所有權模型。
-- [Authentication](/docs/authentication) — 工作階段、組織以及身分如何流入請求脈絡。
-- [Extensions](/docs/extensions#sharing) — 在沙盒迷你應用表面中共用。
-- [Creating Templates](/docs/creating-templates) — 將 `ownableColumns` 連線到新範本的架構中。
+- [**安全性 — 資料範圍**](/docs/security#data-scoping) — 共享所依賴的存取篩選和擁有權模型
+- [**驗證**](/docs/authentication) — 工作階段、組織，以及身分如何流入要求內容
+- [**Extensions**](/docs/extensions#sharing) — 沙箱化迷你應用程式介面中的共享
+- [**建立範本**](/docs/creating-templates) — 將 `ownableColumns` 接入新範本的結構描述