@agent-native/core 0.93.0 → 0.94.1

package/docs/content/locales/pt-BR/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude – Personalização em nível de código por usuário —
 
 # Espaço de trabalho
 
-> **Qual documento do espaço de trabalho?** Esta página aborda a **camada de personalização** — o que _é_ um espaço de trabalho. Para o formato de implantação (um monorepo, muitos aplicativos), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para governança (quem analisa, aprova e possui o quê), consulte [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**Qual documento do espaço de trabalho?** Esta página aborda a **camada de personalização** — o que _é_ um espaço de trabalho. Para o formato de implantação (um monorepo, muitos aplicativos), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para governança (quem analisa, aprova e possui o quê), consulte [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 Todo aplicativo nativo do agente vem com um **espaço de trabalho**: a camada de personalização que torna o agente seu. Ele contém instruções de equipe (`AGENTS.md`), aprendizados compartilhados (`LEARNINGS.md`), memória estruturada pessoal (`memory/MEMORY.md`), skills que o agente recebe sob demanda, subagentes personalizados, trabalhos agendados e servidores MCP conectados — tudo o que você esperaria de uma configuração do Código Claude/Codex.
 
@@ -82,7 +86,7 @@ A diferença: **são linhas SQL, não arquivos do sistema de arquivos.** Cada us
 | `CLAUDE.md`/skills por projeto       | `AGENTS.md` por aplicativo + recursos de memória do espaço de trabalho |
 | Configuração MCP em um arquivo JSON  | Configuração MCP em JSON _ou_ as configurações UI, por escopo          |
 
-Mesmas capacidades. Economia diferente. Consulte [Templates](/docs/cloneable-saas) para saber por que isso é importante para SaaS.
+Mesmas capacidades. Economia diferente. Consulte [Aplicativos](/docs/cloneable-saas) para saber por que isso é importante para SaaS.
 
 ## Visão geral {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-Mantenha os arquivos `context/` curtos e factuais – alguns pontos que o agente pode ler:
-
-```text
-<!-- context/brand.md -->
+Por exemplo:
 
+```text filename="context/brand.md"
 # Marca
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,9 @@ Existem dois tipos de agentes no Workspace:
 
 Use agentes personalizados para delegação em um aplicativo. Use agentes conectados quando precisar ligar para outro aplicativo por A2A.
 
-## @ Marcação {#at-tagging}
-
-Digite `@` na entrada do chat para fazer referência aos itens do espaço de trabalho. Um menu suspenso aparece no cursor mostrando agentes e arquivos correspondentes. Use as teclas de seta para navegar e Enter para selecionar. O item selecionado aparece como um chip embutido na entrada.
-
-Quando você envia uma mensagem, **arquivos/recursos** são passados como referências que o agente pode ler, **agentes personalizados** são executados localmente com suas instruções de perfil e **agentes conectados** são chamados por A2A.
+## Marcação @ e comandos / {#at-tagging}
 
-## /Comandos de barra {#slash-commands}
-
-Digite `/` no início de uma linha para invocar uma habilidade. Um menu suspenso mostra os skills disponíveis com seus nomes e descrições; selecionar um adiciona um chip embutido e inclui seu conteúdo como contexto quando a mensagem é enviada. Se nenhum skills estiver configurado, o menu suspenso leva a esses documentos.
+Digite `@` na entrada do chat para referenciar um agente, arquivo ou recurso, ou `/` para invocar um skill. Ambos abrem uma lista suspensa no cursor e adicionam um chip em linha quando você seleciona um item. Consulte [Menções de agentes](/docs/agent-mentions) para conhecer toda a mecânica (roteamento, `MentionProvider`, seleção de subagente) e o [Guia Skills](/docs/skills-guide) para saber como os skills são criados e descobertos.
 
 ## Modo Código versus Modo Aplicativo {#dev-vs-prod}
 
@@ -416,10 +412,6 @@ O Workspace Connections permite que os aplicativos compartilhem a mesma conta de
 
 Consulte [Workspace Connections](/docs/workspace-connections) para obter o início rápido, conexão/concessão/redencialRef API e exemplos concretos de Slack, HubSpot e GitHub.
 
----
-
-# Referência
-
 ## Recurso API {#resource-api}
 
 Os recursos podem ser gerenciados a partir do código do servidor, actions ou REST API.
@@ -463,3 +455,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# Notas da reuni
 # Excluir um recurso
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## Próximos passos {#whats-next}
+
+- [**Guia Skills**](/docs/skills-guide) — criar e definir o escopo dos arquivos de skill referenciados em `skills/`
+- [**Menções de agentes**](/docs/agent-mentions) — mecânica completa das menções `@` e dos comandos `/`
+- [**Trabalhos recorrentes**](/docs/recurring-jobs) — agendar os prompts criados a partir de tarefas agendadas
+- [**Governança do Workspace**](/docs/workspace-management) — quem revisa, aprova e é responsável pelas alterações no workspace
+- [**Workspaces de vários aplicativos**](/docs/multi-app-workspace) — a forma de implantação abrangida por um workspace
+- [**Conexões do Workspace**](/docs/workspace-connections) — compartilhar credenciais de provedores entre aplicativos

package/docs/content/locales/zh-CN/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 工具** — 由其他代理本机应用通过 A2A 调用。
 - **CLI 命令** - `pnpm action <name>` 用于脚本和开发循环。
 
@@ -560,7 +560,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/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/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/docs/content/locales/zh-CN/authentication.mdx

@@ -15,7 +15,7 @@ Auth 是通过 auth 服务器插件中的 `autoMountAuth(app)` 自动配置的
 - **远程 MCP OAuth：** 适用于 MCP 主机的标准 OAuth 2.1，例如 Claude 代码和 ChatGPT 连接器。
 - **自定义：**通过 `getSession` 回调带来您自己的身份验证。
 
-<Diagram id="doc-block-146mbx9" title={"三种方式，一次会议"} summary={"浏览器访问者、编程 MCP 客户端和自定义提供程序都解析为下游作用域读取的同一 AuthSession。"}>
+<Diagram id="doc-block-146mbx9" title={"三种方式，一次会议"} summary={"浏览器访问者、MCP 主机和自定义提供程序都解析为下游作用域读取的同一 AuthSession。"}>
 
 ```html
 <div class="auth-modes">

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

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-1a8slw0"
   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/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/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/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` 接入新模板的架构