@agent-native/core 0.92.12 → 0.94.0

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/extensions.mdx

@@ -11,6 +11,12 @@ description: "使用者在範本內建置的迷你應用程式 - Analytics 中
 
 框架很重要：擴充功能不是通用的“做你想做的”沙箱。它是一個**迷你應用程式，擴充功能了特定範本**（郵件、分析、行事曆、剪輯、設計）並使用該範本的 actions 和資料。郵件擴充功能可以讀取電子郵件。 Analytics 擴充功能讀取儀表板的指標。行事曆擴充功能作用於開啟的事件。它們感覺像是主機產品的一部分，因為它們*是*主機產品的一部分。
 
+> **擴充功能用來新增 UI，而不會重寫主應用程式的 UI。** 擴充功能會顯示在
+> 自己的頁面中，或顯示在範本公開的具名[插槽](#slots)中。它無法將元素注入
+> 任意原生元件中——例如顯示在行事曆的每位與會者旁邊——除非範本在該位置
+> 公開了插槽。如需更深入的自訂，請讓代理編輯範本的原始碼。完整的程式碼
+> 自訂是 Agent Native 的核心能力；擴充功能則是快速、無需部署的自訂層。
+
 使擴充功能發揮作用的三件事：
 
 - **無需程式碼，無需部署。** 代理編寫它們並且它們在幾秒鐘內即可生效。儲存在資料庫中，而不是儲存庫中。

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/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "訊息傳遞"
-description: "透過 Slack、電子郵件、Telegram 或 WhatsApp 與您的代理交談 — 相同的代理、相同的記憶、相同的工具。"
+description: "透過 Slack、Microsoft Teams、Discord 互動、電子郵件、Telegram 或 WhatsApp 與您的代理交談。"
 ---
 
 # 訊息傳遞
 
-將您的代理連線到 Slack、電子郵件、Telegram 或 WhatsApp，以便您可以透過您已使用的應用程式與其聊天。這是同一個代理——相同的記憶、相同的工具、相同的對話串——只是可以從更多的地方存取。
+將您的代理連線到 Slack、Microsoft Teams、Discord 互動、電子郵件、Telegram 或 WhatsApp。它仍使用相同的記憶、工具和對話紀錄。
+
+> **準確的支援範圍：** Teams 會驗證官方 Bot Framework JWT，並回覆原始對話。Discord 支援透過 Ed25519 簽署的 HTTP 互動執行斜線命令和延遲確認；一般伺服器訊息和私訊仍需要 Gateway 執行階段。Telegram 會保留 `message_thread_id`，WhatsApp 會使用傳入的 `wamid` 傳送情境回覆。
+>
+> Teams 需要 `MICROSOFT_TEAMS_APP_ID`、`MICROSOFT_TEAMS_APP_PASSWORD` 和 `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`。Discord 需要 `DISCORD_APPLICATION_ID` 和 `DISCORD_PUBLIC_KEY`。Telegram 還需要 `TELEGRAM_WEBHOOK_SECRET`，WhatsApp 還需要 `WHATSAPP_APP_SECRET`。
 
 > **使用調度範本？** 所有這些都已在 **設定 → 訊息傳送** 中為您做好準備。點選以連線每個平台 - 您無需閱讀本頁面的其餘部分，除非您正在自訂或建置自己的範本。請參閱 [Dispatch](/docs/dispatch) 或 [Dispatch template reference](/docs/template-dispatch)。
 
@@ -78,7 +82,6 @@ description: "透過 Slack、電子郵件、Telegram 或 WhatsApp 與您的代
    - `chat:write` — 讓代理傳送訊息
    - `app_mentions:read` — 讓代理看到它何時被@提及（可選）
    - `im:history` — 讓代理讀取傳送給它的 DM
-   - `assistant:write` — 可選；讓 Slack 在助理對話串中顯示本機“正在思考...”狀態
    - `users:read.email` — 可選；幫助 Mail 等範本驗證 Slack 發件人電子郵件的草稿佇列身分
 3. 點選該頁面頂部的“**安裝到工作區**”。 Slack 將為您提供一個以 `xoxb-` 開頭的 **機器人使用者 OAuth 權杖**。複製它。
 4. 轉到側邊欄中的**基本資訊**並複製**簽名金鑰**。
@@ -123,12 +126,70 @@ Slack 應用程式有一個事件 API 請求 URL。如果同一個 Slack 應用
 
 ### 提示
 
-- **頻道提及** - 機器人僅在被@提及時在頻道中做出回應，以避免噪音。
-- **私信** — 每個私信都被視為與代理的私人對話。
-- **相同的身分，所有管道** — 如果 Slack 使用者與您應用中的註冊使用者具有相同的電子郵件地址，則代理會將他們視為同一個人。
+- **頻道提及** - 使用 @mention 開始工作。只有同一對話串仍有進行中的任務時，未提及機器人的回覆才會繼續任務。
+- **私訊** — 已接受的個人私訊屬於私密對話，並要求已驗證的組織成員或已連結的 Slack 身分。
+- **身分** — 私訊可把驗證過的 Slack 電子郵件對應至同一應用使用者；受管理頻道使用自己的服務身分和政策。
 - **正式環境允許清單** — 設定 `SLACK_ALLOWED_TEAM_IDS`，對於共用 Slack 應用，設定 `SLACK_ALLOWED_API_APP_IDS`，以便有效的簽名金鑰無法被意外的工作區重複使用。
 - **Clips 應用程式展開** — 適用於 Slack 的可安裝 Agent-Native Clips 使用 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET`、`SLACK_SIGNING_SECRET` 和 `/api/slack/oauth/callback`。每個連線的 Slack 工作空間都會在 `app_secrets` 中獲得自己的加密機器人權杖； `SLACK_BOT_TOKEN` 只是傳統的單一工作區後備方案。
 
+### 受管理的 Add to Slack
+
+建議使用受管理的 OAuth。在**設定 → 訊息**中選擇 **Agent manifest**，下載目前主機專用的
+`agent-native-slack-manifest.json`，再從 Slack 的 **App Manifest** 匯入。
+此清單會啟用目前的 `agent_view` 體驗，以及可寫入的 **Messages** 私訊分頁。
+請確認包含以下 Bot Token Scopes：
+
+應用程式圖示不包含在清單中。請在 **Basic Information → Display Information** 上傳
+Agent Native 圖示，讓 Agents 選擇器符合產品品牌。可以使用應用程式公開的
+`icon-512.svg` 作為來源，並在需要時轉換成 Slack 支援的上傳格式。
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+將 OAuth Redirect URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`，
+Event Subscriptions Request URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/webhook`，
+Interactivity Request URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`。
+訂閱 `app_home_opened`、`app_context_changed`、`app_mention`、
+`message.channels`、`message.groups`、`message.im` 和 `message.mpim`。
+設定 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET` 和
+`SLACK_SIGNING_SECRET` 後，在**設定 → 訊息**中點選 **Add to Slack**。
+每個安裝使用獨立的加密權杖，並依工作區、應用、頻道和對話串隔離會話鍵。
+
+變更清單、權限範圍、事件、Agent view 或 Messages 分頁後，請重新安裝 Slack 應用程式。
+`app_home_opened` 用來偵測私訊是否開啟，`app_context_changed` 提供目前檢視的 Slack
+內容，`message.im` 負責傳遞私訊。Slack 管理員可以為整個組織隱藏已安裝的代理，
+每位成員也可從自己的頂端列隱藏代理。若安裝成功但未顯示代理，請檢查這些顯示
+設定，或從 **Tools → Apps** 開啟。
+
+個人 Slack 私訊只接受已驗證的 Agent Native 組織成員，或已連結到該成員的 Slack
+身分。頻道服務主體的政策與預算會和個人身分分開管理。
+
+未提及機器人的回覆只會繼續進行中的對話串；一般頻道聊天不會呼叫代理。有限內容
+包含反應和檔案參照，原生任務卡顯示計畫、進度、取消與核准/拒絕。私訊使用個人
+身分；受管理頻道使用明確的服務身分，以及訪客、Slack Connect 和模型政策。
+頻道記憶只在明確要求時儲存或刪除，絕不自動記憶。在頻道中建立的例程會把結果
+送回同一 Slack。組織、請求者與頻道的每日或每月預算會連同完整稽核脈絡一起執行。
+`assistant:write` 會啟用 Agent View 內容事件；`chat:write` 用於回覆與即時狀態更新。
+
 ## 設定 Telegram {#telegram}
 
 ### 您需要什麼
@@ -435,7 +496,9 @@ POST /_agent-native/integrations/telegram/setup
 | 電子郵件 | `EMAIL_AGENT_ADDRESS`，加上 `RESEND_API_KEY` 或 `SENDGRID_API_KEY` 之一      | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-所有憑證都存在於環境變數中——不是資料庫，也不是來源程式碼。使用側邊欄設定 UI 或託管提供者的環境面板。
+整合憑證會先從整合擁有者的範圍限定密鑰中解析（使用者、組織、再到工作區）；部署環境變數是本機或刻意單一租戶部署的後備方案。設定 UI 會儲存範圍限定密鑰；值絕不會傳回瀏覽器，也不會存入來源程式碼。
+
+內建執行階段轉接器包含 **Slack**、**Telegram**、**WhatsApp Cloud API** 和提供者 webhook 電子郵件（Resend 或 SendGrid）。在實作並註冊已驗證的轉接器之前，Discord 和 Microsoft Teams 無法連線。
 
 ### 對話串和身分 {#threading-and-identity}
 
@@ -481,13 +544,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +570,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +601,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

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` 接入新範本的結構描述