@agent-native/core 0.93.0 → 0.94.1

package/corpus/core/docs/content/locales/pt-BR/template-design.mdx

@@ -11,7 +11,7 @@ Design é um estúdio de prototipagem HTML nativo do agente. Em vez de uma tela
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lançamento do produto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Protótipo HTML gerado</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Deixe o hero mais denso e o CTA mais claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisão</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lançamento do produto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Lance mais rápido com Agent-Native</strong><span class='wf-muted' style='max-width:70%'>Gere um protótipo funcional a partir de um prompt e refine-o no próprio lugar.</span><button class='primary'>Começar</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Deixe o hero mais denso e o CTA mais claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisão</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -134,6 +134,8 @@ pnpm dev
 
 Todos os dados residem em SQL com Drizzle ORM. Esquema: `templates/design/server/db/schema.ts`. Os designs e sistemas de design carregam o padrão `ownableColumns` e uma tabela de compartilhamentos de estrutura correspondente, para que eles se encaixem no modelo de compartilhamento por usuário/por organização.
 
+A tabela abaixo abrange os principais recursos com proprietário: designs, arquivos, modelos, versões e sistemas de design. Outras sete tabelas no mesmo esquema dão suporte a recursos descritos em outras partes deste documento, em vez do modelo de recursos principal: `design_localhost_connections` e `design_localhost_write_grants` (modo de origem localhost), `component_index` (indexação de componentes), `motion_timeline` (movimento), `design_state` (instantâneos do estado do editor), `design_fusion_edits` (modo de fusão do aplicativo completo) e `design_review_snapshot` (instantâneos de revisão).
+
 | Tabela                                   | O que ele contém                                                                                                                              |
 | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | Um projeto de design — `title`, `description`, `project_type` (`prototype`/`other`), o blob `data` JSON e um link `design_system_id` opcional |

package/corpus/core/docs/content/locales/pt-BR/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "Dispatch é o plano de controle do espaço de trabalho: caixa de e
 
 # Envio
 
-> **Veja também:** para uma visão geral conceitual do que o Dispatch faz e quando você deseja, consulte [Dispatch](/docs/dispatch). Esta página é a referência específica do modelo.
+<Callout tone="info">
+
+**Veja também:** para uma visão geral conceitual do que o Dispatch faz e quando você deseja, consulte [Dispatch](/docs/dispatch). Esta página é a referência específica do modelo.
+
+</Callout>
 
 Dispatch é o **plano de controle do espaço de trabalho**. Enquanto outros modelos são aplicativos de domínio (Mail, Calendar, Analytics, Brain), o Dispatch é o aplicativo que você executa _juntamente_ com eles para coordenar tudo: uma caixa de entrada central, um cofre de segredos, trabalhos agendados, integração Slack/Telegram e um agente orquestrador que delega o trabalho do domínio ao aplicativo especializado certo por meio de [A2A](/docs/a2a-protocol).
 

package/corpus/core/docs/content/locales/pt-BR/template-mail.mdx

@@ -362,3 +362,11 @@ O correio é seu para alterar. Tudo o que é importante reside em alguns lugares
 **Alteração de atalhos de teclado.** Manipuladores de atalhos de teclado ficam em `templates/mail/app/components/email/`. Pesquise `useHotkeys` ou `addEventListener("keydown"` para descobrir onde cada tecla está conectada.
 
 Peça ao agente para fazer qualquer uma dessas alterações para você. O agente pode editar sua própria fonte — consulte [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## O que vem a seguir
+
+- [**Modelos**](/docs/cloneable-saas) — o modelo de clonar e possuir, além de todos os outros modelos de domínio para começar
+- [**Primeiros passos**](/docs/getting-started) — os fundamentos da estrutura: ações, estado do aplicativo e sincronização ao vivo
+- [**Calendário**](/docs/template-calendar) — um modelo de domínio relacionado para agendamento e reservas
+- [**Automações**](/docs/automations) — o mecanismo acionado por eventos sobre o qual as regras de triagem automática do Mail são criadas
+- [**Ações**](/docs/actions) — o sistema de ações que chat, atalhos e automações chamam

package/corpus/core/docs/content/locales/pt-BR/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ A estrutura também rastreia `builder connect clicked` de CTAs do Connect Builde
 ## O que vem a seguir
 
 - [**Actions**](/docs/actions) — onde se origina a maioria das chamadas de rastreamento
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()` é executado no plugin core-routes na inicialização
-- [**Secrets**](/docs/security) — gerencie chaves API para provedores de rastreamento
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()` é executado no plugin core-routes na inicialização
+- [**Segurança — Gerenciamento de segredos**](/docs/security#secrets) — gerencie chaves API para provedores de rastreamento

package/corpus/core/docs/content/locales/pt-BR/using-your-agent.mdx

@@ -92,21 +92,14 @@ Na maioria das vezes você orienta o agente digitando no chat. Duas coisas torna
 
 O agente não é um aplicativo separado que você acessa. Ele é fornecido como um punhado de componentes React – uma barra lateral, um painel bruto e uma chamada `sendToAgentChat()` – que você coloca em qualquer aplicativo. Renderize `<AgentSidebar>` para dar a cada tela um agente alternável ou conecte um botão para entregar uma tarefa específica ao chat em vez de executar uma chamada LLM única.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) — monte `<AgentPanel>`, `<AgentSidebar>` e `sendToAgentChat()` em qualquer aplicativo React.
-→ [**Agent Surfaces**](/docs/agent-surfaces) — escolha se o fluxo de trabalho deve ser headless, chat-first, incorporado ou um aplicativo completo.
-
 ## Você pode usar UI leve {#ui-light}
 
 Nem todo aplicativo precisa de um painel completo. Quando o agente _é_ o produto, você pode pular a maior parte do UI personalizado: abra o aplicativo, peça o que deseja e deixe o agente fazer o resto. O agente ainda tem sua superfície de gerenciamento (histórico, espaço de trabalho, configurações), mas a interação principal é a conversa, e não os cliques.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — apps sem navegador para jobs, filas, scripts e agents externos.
-
 ## Você coedita com ele {#you-co-edit}
 
 Quando você e o agente estão trabalhando no mesmo documento, vocês não se revezam. Com a colaboração em tempo real, as edições do agente são transmitidas junto com as suas — cursores ativos, sem substituições — da mesma forma que um colega de equipe faria. Você pode continuar digitando enquanto ele funciona e ele verá as alterações conforme elas acontecem.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — edição colaborativa multiusuário com cursores ativos e edições de agente no mesmo documento.
-
 ## O que vem a seguir {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — o agente sabe o que você está vendo

package/corpus/core/docs/content/locales/pt-BR/voice-input.mdx

@@ -9,6 +9,12 @@ Todo aplicativo nativo do agente possui um microfone no compositor de bate-papo.
 
 A estrutura lida com tudo isso automaticamente. Os usuários conectados ao Builder obtêm o Gemini Flash-Lite hospedado no Builder por padrão; caso contrário, os usuários poderão trazer sua própria chave de provedor ou recorrer ao reconhecimento de fala do navegador.
 
+## Modo de voz em tempo real {#realtime-speech-mode}
+
+Ao abrir o microfone, um popover permite escolher entre **Conversa em tempo real** e **Ditado editável**. O modo em tempo real exige uma `OPENAI_API_KEY` no escopo do usuário e conecta o navegador ao `gpt-realtime-2.1` por WebRTC. O chat se recolhe em uma esfera de voz no canto inferior direito; clique nela para mostrar ou ocultar o chat sem encerrar a conversa.
+
+O modelo de voz usa as mesmas ferramentas autenticadas do Agent Native que o chat, portanto pode navegar pelo aplicativo e chamar ações enquanto fala. Ações que exigem aprovação permanecem pausadas até você aprová-las. O áudio nunca é armazenado no SQL; o Agent Native mantém apenas um estado compacto da sessão e da transcrição. Uma sessão em tempo real dura no máximo 60 minutos.
+
 ## Como funciona {#how-it-works}
 
 O botão de voz do compositor grava o áudio no navegador e depois escolhe um provedor:

package/corpus/core/docs/content/locales/pt-BR/workspace-connections.mdx

@@ -425,10 +425,9 @@ Não duplique o armazenamento OAuth/token em cada aplicativo. O registro de cone
 
 ### Configuração do plano de controle de despacho
 
-O Dispatch expõe o plano de controle actions que escreve as mesmas funções de armazenamento compartilhado que um aplicativo poderia chamar diretamente:
+O Dispatch expõe actions do plano de controle que usam as mesmas funções de armazenamento compartilhado que um aplicativo poderia chamar diretamente — sua action `upsert-workspace-connection` valida a entrada em relação ao catálogo de provedores e então delega para a mesma `upsertWorkspaceConnection()` mostrada nesta página:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ O catálogo de provedores e o armazenamento de concessões são a base para uma
 Mantenha os limites rígidos: os metadados do provedor podem ser exibidos com segurança; os valores das credenciais permanecem no cofre.
 
 </details>
+
+## O que vem a seguir {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — o aplicativo que normalmente gerencia a configuração de conexões do espaço de trabalho e o cofre
+- [**Segurança**](/docs/security) — o cofre de credenciais, o escopo de segredos e o modelo de acesso para os quais as conexões apontam
+- [**Integração**](/docs/onboarding#checking-workspace-connections-in-onboarding) — verificar a prontidão da conexão na lista de configuração de um modelo
+- [**Clientes MCP**](/docs/mcp-clients) — compartilhar credenciais de servidores MCP no espaço de trabalho como um padrão relacionado de configuração reutilizável
+- [**Brain**](/docs/template-brain) — a implementação de referência de uma página Sources de provedores criada sobre este modelo

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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