@agent-native/core 0.92.12 → 0.94.0

package/docs/content/locales/zh-CN/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-cn" 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/docs/content/locales/zh-CN/deployment.mdx

@@ -451,3 +451,11 @@ agent-native 的核心功能之一是代理可以修改应用程序的源代码
 ## 多实例部署 {#multi-instance}
 
 代理本机应用程序通过 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/docs/content/locales/zh-CN/extensions.mdx

@@ -11,6 +11,12 @@ description: "用户在模板内构建的迷你应用程序 - Analytics 中的
 
 框架很重要：扩展不是通用的“做你想做的”沙箱。它是一个**迷你应用程序，扩展了特定模板**（邮件、分析、日历、剪辑、设计）并使用该模板的 actions 和数据。邮件扩展可以读取电子邮件。 Analytics 扩展读取仪表板的指标。日历扩展作用于打开的事件。它们感觉像是主机产品的一部分，因为它们*是*主机产品的一部分。
 
+> **扩展用于添加 UI，而不会重写宿主应用的 UI。** 扩展会显示在自己的页面中，
+> 或显示在模板公开的命名[插槽](#slots)中。它不能向任意原生组件中注入元素
+> ——例如显示在日历的每位参与者旁边——除非模板在该位置公开了插槽。
+> 如需更深入的自定义，请让代理编辑模板的源代码。完整的代码自定义是 Agent
+> Native 的核心能力；扩展则是快速、无需部署的自定义层。
+
 使扩展发挥作用的三件事：
 
 - **无需代码，无需部署。** 代理编写它们并且它们在几秒钟内即可生效。存储在数据库中，而不是存储库中。

package/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/key-concepts.mdx

@@ -11,11 +11,9 @@ description: "代理本机应用程序的工作原理：首先是 actions、SQL
 
 每个代理本机应用程序都由三部分协同工作：
 
-> **代理** — 读取数据、写入数据、运行 actions 和修改代码的自主 AI。可使用 skills 和说明进行定制。
->
-> **应用** — 试剂周围的产品表面。一开始这可能只是操作、丰富的聊天、小型控制平面或带有仪表板、流程和可视化的完整 React 界面。
->
-> **计算机** — 数据库、浏览器、代码执行。代理直接使用SQL和内置工具进行工作； MCP 服务器是可选的附加组件，而不是基础。
+- **代理** — 读取数据、写入数据、运行 actions 和修改代码的自主 AI。可使用 skills 和说明进行定制。
+- **应用** — 试剂周围的产品表面。一开始这可能只是操作、丰富的聊天、小型控制平面或带有仪表板、流程和可视化的完整 React 界面。
+- **计算机** — 数据库、浏览器、代码执行。代理直接使用SQL和内置工具进行工作； MCP 服务器是可选的附加组件，而不是基础。
 
 <Diagram id="doc-block-sight" 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_ 是在您的应用程序旁边托管代理的环境 - 在本地是嵌入
 
 代理本机应用程序包括一个嵌入式代理面板，该面板与应用程序 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/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/multi-tenancy.mdx

@@ -17,7 +17,7 @@ description: "每个代理本机应用程序都是开箱即用的多租户 - 组
 - **组织切换** — 会话跟踪活动组织 (`session.orgId`)，切换它会更改用户和代理看到的数据。
 - **每组织数据隔离** — 每个查询都会自动限定到活动组织。
 
-如果您正在评估 CRM、项目跟踪器、支持收件箱或任何团队工具的原生代理，那么多租户基础已经存在。所有第一方模板都是多租户的 - 请参阅 [Cloneable SaaS templates](/docs/cloneable-saas) 获取列表。
+如果您正在评估 CRM、项目跟踪器、支持收件箱或任何团队工具的原生代理，那么多租户基础已经存在。所有第一方模板都是多租户的 - 请参阅 [模板](/docs/cloneable-saas) 获取列表。
 
 <Diagram id="doc-block-ssxv49" title={"组织成员资格和隔离"} summary={"用户以 owner/admin/member 身份加入组织。每个可拥有的行都带有拥有它的租户的 org_id ，并且没有行跨越边界泄漏。"}>
 
@@ -117,8 +117,8 @@ description: "每个代理本机应用程序都是开箱即用的多租户 - 组
 
 这与用于每用户范围的管道相同。对于 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 的单一存储库中托管多个代理本机应用程序
+- [**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/docs/content/locales/zh-CN/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-10l6a1l" 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-yxyssw" 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-yxyssw" 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/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/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 @@ export default runMigrations(
 
 </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/docs/content/locales/zh-CN/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "共享和隐私"
-description: "Google Docs 风格的共享，内置于框架中。每个用户创建的资源（文档、仪表板、设计、演示文稿、剪辑、录音、表单）都会获得相同的默认私有模型以及一致的共享 UI。"
+description: "框架内置了熟悉且一致的共享方式。用户创建的每种资源（文档、仪表板、设计、演示文稿、剪辑、录音和表单）都采用相同的默认私有模型和一致的共享 UI。"
 ---
 
 # 共享和隐私
 
 用户在代理原生应用程序中创建的每个资源（文档、仪表板、设计、演示文稿、屏幕录制、会议记录、表单、预订链接）**默认情况下对创建者来说是私有的**。仅当创建者明确共享它或将其可见性更改为 `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` 接入新模板的架构