@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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` 接入新模板的架构

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

@@ -5,7 +5,7 @@ description: "skills 如何在代理原生中工作：框架 skills、域 skills
 
 # Skills指南
 
-Skills 是 Markdown 文件，可让代理深入了解特定模式和工作流程。
+Skills 是为代理提供特定模式和工作流深度知识的 Markdown 文件。与其把每条规则都塞进一个系统提示词，不如将知识拆分成专门的文件，仅在任务确实需要时由代理加载——既保持默认上下文精简，又让代理能够按需深入。
 
 ## skills是什么 {#what-are-skills}
 
@@ -120,9 +120,11 @@ Skills 位于 `.agents/skills/<name>/SKILL.md`，包含针对代理的详细指
 
 当前应用支持的 skills 包括 Plan 的 `visual-plan`、`visual-recap` 和 `visualize-repo`，Design 的 `visual-edit`，Assets 的 `assets`，以及用于仓库支持的 docs/blog/MDX 编辑的 `content`。
 
-应用程序支持的 skills 将代理本机应用程序打包为技能市场工件。该捆绑包可以包含代理指令、导出的 skills、MCP 连接器元数据、托管/本地启动指令和 UI 表面（例如 MCP 应用程序）。
+<Callout tone="info">
 
-> **完整详细信息如下：** [App-backed skills — full details](#app-backed-skills-full) 中介绍了应用程序支持的 skills 的机制（清单格式、CLI 命令、市场适配器、自动更新哈希）。
+**完整详细信息如下：** [App-backed skills — full details](#app-backed-skills-full) 中介绍了应用程序支持的 skills 的机制（清单格式、CLI 命令、市场适配器、自动更新哈希）。
+
+</Callout>
 
 ## 创建自定义 skills {#creating-skills}
 
@@ -177,7 +179,11 @@ frontmatter `name` 和 `description` 由代理的工具系统用于技能发现
 
 将文件保存在 `.agents/skills/my-skill/SKILL.md`。目录名称应与 frontmatter 中的 `name` 匹配。
 
-> **另请参阅：** [Writing Agent Instructions](/docs/writing-agent-instructions) 了解如何措辞技能描述、应用渐进式披露以及保持 `AGENTS.md` 的精简。两个页面均使用 `project-imports` 技能作为运行示例。
+<Callout tone="info">
+
+**另请参阅：** [Writing Agent Instructions](/docs/writing-agent-instructions) 了解如何措辞技能描述、应用渐进式披露以及保持 `AGENTS.md` 的精简。两个页面均使用 `project-imports` 技能作为运行示例。
+
+</Callout>
 
 ## 技能范围：运行时与开发 {#skill-scope}
 
@@ -267,33 +273,37 @@ scope: dev
 
 </Diagram>
 
-> **另请参阅：** [Writing Agent Instructions](/docs/writing-agent-instructions) 了解如何措辞技能描述、应用渐进式披露以及保持 `AGENTS.md` 精简。
-
 ## Skills vs AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — 概述。列出所有脚本，描述数据模型，解释应用程序架构。代理首先阅读此内容以了解应用程序。
->
-> **Skills** — 深入研究。每项技能都侧重于一种模式，并包含详细规则、代码示例和“注意事项”列表。当代理需要遵循特定模式时，它会读取这些内容。
+<Callout tone="info">
+
+**AGENTS.md** — 概述。列出所有脚本，描述数据模型，解释应用程序架构。代理首先阅读此内容以了解应用程序。
+
+**Skills** — 深入研究。每项技能都侧重于一种模式，并包含详细规则、代码示例和“注意事项”列表。当代理需要遵循特定模式时，它会读取这些内容。
+
+</Callout>
 
 `AGENTS.md` 告诉代理应用程序的用途。 Skills 告诉代理*如何*正确地做特定的事情。两者都是必需的 - `AGENTS.md` 用于定向，skills 用于执行。
 
 ## Skills 与内存 {#skills-vs-memory}
 
-> **Skills** — 编写的、可重复使用的操作指南。适用于每个用户，在任务匹配时按需调用。
->
-> **内存 (`LEARNINGS.md` / `memory/MEMORY.md`)** — 共享项目学习和每轮都会加载的个人结构化内存。
+<Callout tone="info">
+
+**Skills** — 编写的、可重复使用的操作指南。适用于每个用户，在任务匹配时按需调用。
+
+**内存 (`LEARNINGS.md` / `memory/MEMORY.md`)** — 共享项目学习和每轮都会加载的个人结构化内存。
+
+</Callout>
 
 如果这些知识适用于在应用程序中工作的*每个人*（“总是更喜欢 CTE 而不是子查询”），那么它就是一项技能或共享的 `LEARNINGS.md`。如果它是关于*这个特定用户*（“史蒂夫喜欢简洁的答案”），它就属于 `memory/MEMORY.md`。完整治疗请参见[Workspace Memory](/docs/workspace#memory)。
 
----
+## Skills 与 SQL 资源 {#skills-vs-resources}
 
-# 高级
+本页将 skill 描述为 `.agents/skills/<name>/SKILL.md` 中的文件。[Workspace](/docs/workspace#skills) 则将同一个 skill 描述为路径为 `skills/<slug>/SKILL.md`、范围为 workspace/shared/personal 的 SQL 资源。两者是从不同角度描述同一概念：Code 模式直接读写文件；App 模式将其存储为资源行，因此无需文件系统也能工作。无论采用哪种方式，都请按本页格式编写内容。
 
 ## 应用程序支持的 skills — 完整详细信息 {#app-backed-skills-full}
 
-应用程序支持的 skills 将代理本机应用程序打包为技能市场工件。
-捆绑包可以包含代理指令、导出的 skills、MCP 连接器
-元数据、托管/本地启动说明和 UI 界面，例如 MCP 应用程序。
+以下完整介绍[应用程序支持的 skills](#app-backed-skills) 背后的清单格式、CLI 命令、市场适配器和自动更新哈希：
 
 每个应用程序支持的技能都以应用程序根目录中的 `agent-native.app-skill.json` 开头：
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 `AGENTS.md` 和 `.agents/skills` 保持规范。更新命令还可以修复
 Claude 兼容性链接（`CLAUDE.md` 和 `.claude/skills`），因此 Claude 代码可见
 相同的说明，无需维护第二个副本。
+
+## 接下来 {#whats-next}
+
+- [**编写代理指令**](/docs/writing-agent-instructions) — 编写 skill 描述，并在 AGENTS.md、skills 和内存之间拆分指导
+- [**Workspace**](/docs/workspace#skills) — App 模式下 skills 作为 SQL 资源存储的位置
+- [**代理提及**](/docs/agent-mentions) — 在聊天中调用 skill 的 `/` 命令触发器
+- [**Plan 插件与市场**](/docs/plan-plugin) — 真实应用程序支持的 skill 的端到端安装和自动更新流程

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

@@ -86,6 +86,18 @@ Assets 是一个代理原生工作区，用于创建和管理品牌一致的媒
 - **其他应用程序需要资产选择器或生成器** - 幻灯片、设计、内容、博客编辑器或网站构建器可以嵌入选择器或通过 A2A 调用资产。
 - **您希望编码代理提供品牌媒体** - Codex、Claude Code、Claude 或 ChatGPT 无需离开聊天即可生成和选择资产。
 
+## 你可以用它做什么
+
+- **创建资产库。**按品牌、营销活动、产品或类别对参考图像、视频、规范徽标、样式注释、调色板、文件夹和生成的输出进行分组。
+- **通过聊天生成。** Home 撰写r 和库生成控件使用 `sendToAgentChat()` 将提示发送给代理，以便用户可以检查变体、提供反馈和迭代。
+- **生成图像和视频。** Builder 管理的图像生成在启用后可用，Gemini 负责视频生成以及手动图像回退。
+- **上传并描述参考资料。**从库 UI 或提示作曲家附件按钮添加图像或视频，然后按标题、说明、替代文本、提示、模型、媒体类型、状态、角色、文件夹或集合进行搜索。
+- **保留生成审核日志。**每次运行都会记录提示、模型、宽高比、参考、源资产、沿袭、生成的资产、状态、错误和时间戳，以供以后设计审查。
+- **保持徽标准确性。**代理可以生成占位符区域，服务器将上传的规范徽标合成到最终图像上，而不是依赖图像模型重新绘制它。
+- **嵌入为选择器。**其他应用程序可以 iframe `/picker` 并侦听来自 `@agent-native/embedding` 的 `chooseAsset` 事件，将资产转变为博客编辑器、网站构建器、幻灯片和自定义应用程序的资产选择器/生成器。选择器还会为现有的仅图像主机发出旧版 `chooseImage` 别名。
+- **作为应用程序支持的技能安装。** `agent-native.app-skill.json` 清单会导出资产技能以及 MCP 连接器元数据，以便市场可以将应用程序、其说明及其选择器一起安装。
+- **为其他代理提供服务。**幻灯片、设计、内容、邮件和调度可以通过 A2A 调用资产来列出库、生成批次、创建视频、优化资产、获取导出以及在允许嵌入的情况下渲染内联预览。
+
 ## 开始使用
 
 现场演示：[assets.agent-native.com](https://assets.agent-native.com)。
@@ -108,18 +120,6 @@ Assets 是一个代理原生工作区，用于创建和管理品牌一致的媒
 - “将此上传的图表转换为更清晰的产品解释图片。”
 - “创建视频故事板并将最佳帧集保存到此库。”
 
-## 你可以用它做什么
-
-- **创建资产库。**按品牌、营销活动、产品或类别对参考图像、视频、规范徽标、样式注释、调色板、文件夹和生成的输出进行分组。
-- **通过聊天生成。** Home 撰写r 和库生成控件使用 `sendToAgentChat()` 将提示发送给代理，以便用户可以检查变体、提供反馈和迭代。
-- **生成图像和视频。** Builder 管理的图像生成在启用后可用，Gemini 负责视频生成以及手动图像回退。
-- **上传并描述参考资料。**从库 UI 或提示作曲家附件按钮添加图像或视频，然后按标题、说明、替代文本、提示、模型、媒体类型、状态、角色、文件夹或集合进行搜索。
-- **保留生成审核日志。**每次运行都会记录提示、模型、宽高比、参考、源资产、沿袭、生成的资产、状态、错误和时间戳，以供以后设计审查。
-- **保持徽标准确性。**代理可以生成占位符区域，服务器将上传的规范徽标合成到最终图像上，而不是依赖图像模型重新绘制它。
-- **嵌入为选择器。**其他应用程序可以 iframe `/picker` 并侦听来自 `@agent-native/embedding` 的 `chooseAsset` 事件，将资产转变为博客编辑器、网站构建器、幻灯片和自定义应用程序的资产选择器/生成器。选择器还会为现有的仅图像主机发出旧版 `chooseImage` 别名。
-- **作为应用程序支持的技能安装。** `agent-native.app-skill.json` 清单会导出资产技能以及 MCP 连接器元数据，以便市场可以将应用程序、其说明及其选择器一起安装。
-- **为其他代理提供服务。**幻灯片、设计、内容、邮件和调度可以通过 A2A 调用资产来列出库、生成批次、创建视频、优化资产、获取导出以及在允许嵌入的情况下渲染内联预览。
-
 ## 从编码代理中使用它
 
 生成并选择品牌媒体，无需留下 Codex、Claude 代码、Claude 或 ChatGPT。
@@ -162,10 +162,13 @@ Assets 是一个代理原生工作区，用于创建和管理品牌一致的媒
 
 本文档的其余部分适用于任何分叉资产模板或扩展它的人。
 
-### 脚手架
+### 快速开始
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### 数据模型

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

@@ -201,7 +201,7 @@ Postgres、Neon、D1、Turso 和类似主机。应用程序状态反映
 当前路线、过滤器和所选 ID，以便代理始终了解当前
 导航和选择。
 
-Brain 的模式位于 `templates/brain/server/db/schema.ts` 中。八张桌子：
+Brain 的模式位于 `templates/brain/server/db/schema.ts` 中。九张表：
 
 | 表                       | 它包含什么                                                                                                      |
 | ------------------------ | --------------------------------------------------------------------------------------------------------------- |
@@ -549,3 +549,5 @@ Slack、Granola 和 GitHub 源可以选择进入后台 `autoSync`
 - [**Dispatch template**](/docs/template-dispatch) — 脚手架协调应用
 - [**Workspace**](/docs/workspace) — 跨应用共享资源
 - [**A2A Protocol**](/docs/a2a-protocol) — 跨应用委托
+- [**模板**](/docs/cloneable-saas) — 克隆并拥有的模型，以及可作为起点的所有其他领域模板
+- [**入门**](/docs/getting-started) — 框架基础：actions、应用程序状态和实时同步

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

@@ -17,7 +17,7 @@ search: "Clips 浏览器日志 开发人员日志 控制台日志 网络日志
   />
 </WireframeBlock>
 
-沿着将 Loom + Granola + Wispr Flow 集成到一个应用程序中的思路来思考 — 但代理在每个界面上都是一流的编辑器，并且录音、会议和听写都是您的，而不是 SaaS 供应商的。 Clips 还使共享录音可供代理读取：将普通的 Clips 共享链接粘贴到代理中，它可以“听到”文本形式的文字记录，并“看到”带有时间戳的屏幕帧作为图像 - 无需原始视频。帧查看适用于任何具有图像功能的代理（ChatGPT、Claude 代码、光标、Codex）；纯文本网络聊天仍然可以获得完整的文字记录，并且可以拍摄您上传的帧。
+异步屏幕录制、与日历同步的会议笔记和按键说话语音听写整合在一个应用中 — 代理是每个界面上的一流编辑器，而录音、会议和听写都属于您，而不是 SaaS 供应商。Clips 还让共享录音可供代理读取：将公开 Clips 分享链接或临时的**复制给代理**链接粘贴到代理中，它无需原始视频即可把转录文本作为文字“听到”，并把带时间戳的屏幕帧作为图像“看到”。帧查看适用于任何支持图像的代理（ChatGPT、Claude Code、Cursor、Codex）；纯文本网络聊天仍可获得完整转录文本，并可使用您上传的帧。
 
 <Diagram id="doc-block-pkjyh1" title={"捕获、转录、重用"} summary={"三种捕获类型集中在一个库中；代理进行抄写、标题和总结，然后每个抄本都可以搜索和共享。"}>
 
@@ -83,8 +83,7 @@ search: "Clips 浏览器日志 开发人员日志 控制台日志 网络日志
 - **为每个录音获取自动生成的标题、摘要和章节标记** - 客服人员会填写这些内容并使其保持最新状态。
 - **搜索每一份记录** — 屏幕录像、会议和听写都在一个库中。 “找到我们讨论推出计划的剪辑。”
 - **共享剪辑**以及每个剪辑的权限（公共、团队、私人）。链接跟踪和线索评论也有效。
-- **在 Slack 中预览公共剪辑**，并在播放后使用 Loom 风格的可播放展开
-  工作区安装您的 Clips Slack 应用。
+- **在 Slack 中预览公共剪辑**，工作区安装 Clips Slack 应用后会显示可播放的视频展开预览。
 - **使用 Chrome 扩展程序捕获浏览器日志。**浏览器记录可以
   附加经过编辑的控制台日志和 fetch/XHR 元数据，这对
   产品错误和仅限浏览器的重现。
@@ -508,7 +507,7 @@ UI 中的路由位于 `templates/clips/app/routes/` 下 - 经过身份验证的
 
 ### 密钥actions
 
-每个代理可调用操作都是 `templates/clips/actions/` 中的 TypeScript 文件，自动安装在 `POST /_agent-native/actions/:name` 上，并可作为 `pnpm action <name>` 从 CLI 运行。有~80个actions；有用的分组：
+每个代理可调用操作都是 `templates/clips/actions/` 中的 TypeScript 文件，自动安装在 `POST /_agent-native/actions/:name` 上，并可作为 `pnpm action <name>` 从 CLI 运行。大约有 100 个 actions；有用的分组：
 
 - **录制生命周期** — `create-recording`、`finalize-recording`、`update-recording`、`set-thumbnail`、`archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`、`move-recording`、`tag-recording`。
 - **成绩单和 AI** — `request-transcript`、`cleanup-transcript`、`regenerate-title` / `regenerate-summary` / `regenerate-chapters`、`set-chapters`、`generate-workflow`。 （`cleanup-transcript` 和 `finalize-meeting` 是服务器端媒体管道调用；大多数其他 AI 功能委托给代理聊天。）

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

@@ -11,7 +11,7 @@ Design 是一家代理原生 HTML 原型工作室。该代理不是分层绘图
   <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'>产品发布页面</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>已生成 HTML 原型</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>让 hero 更紧凑，CTA 更清晰。</span><div style='flex:1'></div><button class='primary'>应用修订</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'>产品发布页面</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'>借助 Agent-Native 更快发布</strong><span class='wf-muted' style='max-width:70%'>根据提示生成可运行的原型，然后就地完善。</span><button class='primary'>开始使用</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'>让 hero 更紧凑，CTA 更清晰。</span><div style='flex:1'></div><button class='primary'>应用修订</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -134,6 +134,8 @@ pnpm dev
 
 所有数据通过 Drizzle ORM 存储在 SQL 中。架构：`templates/design/server/db/schema.ts`。设计和设计系统采用标准 `ownableColumns` 和匹配的框架共享表，因此它们可以插入每用户/每组织共享模型。
 
+下表涵盖可拥有的核心资源 — 设计、文件、模板、版本和设计系统。同一架构中的另外七个表支持本文档其他部分介绍的功能，而不是核心资源模型：`design_localhost_connections` 和 `design_localhost_write_grants`（localhost 源模式）、`component_index`（组件索引）、`motion_timeline`（动效）、`design_state`（编辑器状态快照）、`design_fusion_edits`（完整应用融合模式）以及 `design_review_snapshot`（审阅快照）。
+
 | 表                                       | 它包含什么                                                                                                                       |
 | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | 一个设计项目 - `title`、`description`、`project_type` (`prototype` / `other`)、`data` JSON Blob 和可选的 `design_system_id` 链接 |

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

@@ -5,7 +5,11 @@ description: "Dispatch 是工作区控制平面 - 中央收件箱、跨应用编
 
 # 调度
 
-> **另请参阅：** 有关 Dispatch 功能以及何时需要它的概念概述，请参阅 [Dispatch](/docs/dispatch)。此页面是特定于模板的参考。
+<Callout tone="info">
+
+**另请参阅：** 有关 Dispatch 功能以及何时需要它的概念概述，请参阅 [Dispatch](/docs/dispatch)。此页面是特定于模板的参考。
+
+</Callout>
 
 Dispatch 是**工作区控制平面**。其他模板是域应用程序（邮件、日历、分析、大脑），而 Dispatch 是您与它们一起运行以协调一切的应用程序：中央收件箱、机密库、计划作业、Slack/Telegram 集成以及通过 [A2A](/docs/a2a-protocol) 将域工作委托给正确的专业应用程序的协调器代理。
 

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

@@ -362,3 +362,11 @@ UI 中的路由：
 **更改键盘快捷键。** `templates/mail/app/components/email/` 中存在按键绑定处理程序 - 搜索 `useHotkeys` 或 `addEventListener("keydown"` 以查找每个按键的接线位置。
 
 要求代理为您进行任何这些更改。代理可以编辑自己的源代码 - 请参阅 [Self-Modifying Code](/docs/key-concepts#agent-modifies-code)。
+
+## 后续内容
+
+- [**模板**](/docs/cloneable-saas) — 克隆并拥有的模式，以及可作为起点的所有其他领域模板
+- [**开始使用**](/docs/getting-started) — 框架基础：actions、application state 和实时同步
+- [**日历**](/docs/template-calendar) — 涵盖日程安排和预订的相关领域模板
+- [**自动化**](/docs/automations) — Mail 自动分类规则所基于的事件触发引擎
+- [**Actions**](/docs/actions) — 聊天、快捷键和自动化共同调用的 action 系统

package/corpus/core/docs/content/locales/zh-CN/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 @@ interface TrackingEvent {
 ## 下一步是什么
 
 - [**Actions**](/docs/actions) — 大多数跟踪调用的发起位置
-- [**Server Plugins**](/docs/server) - `registerBuiltinProviders()` 在启动时在 core-routes 插件中运行
-- [**Secrets**](/docs/security) — 管理用于跟踪提供商的 API 密钥
+- [**Server Plugins**](/docs/server#server-plugins) - `registerBuiltinProviders()` 在启动时在 core-routes 插件中运行
+- [**安全 — 密钥管理**](/docs/security#secrets) — 管理用于跟踪提供商的 API 密钥

package/corpus/core/docs/content/locales/zh-CN/using-your-agent.mdx

@@ -92,21 +92,14 @@ agent-native 背后的定义思想是，agent 和 UI 是**平等的伙伴** -
 
 代理不是您通过 Tab 键切换到的单独应用程序。它以几个 React 组件的形式提供——一个侧边栏、一个原始面板和一个 `sendToAgentChat()` 调用——您可以将它们放入任何应用程序中。渲染 `<AgentSidebar>` 为每个屏幕提供一个可切换代理，或连接一个按钮将特定任务交给聊天，而不是运行一次性 LLM 调用。
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) — 将 `<AgentPanel>`、`<AgentSidebar>` 和 `sendToAgentChat()` 安装到任何 React 应用程序中。
-→ [**Agent Surfaces**](/docs/agent-surfaces) — 选择工作流程是否应为无头、聊天优先、嵌入式或完整应用程序。
-
 ## 你可以去轻 UI {#ui-light}
 
 并非每个应用程序都需要完整的仪表板。当代理*是*产品时，您可以跳过大部分自定义UI：打开应用程序，询问您想要的内容，然后让代理完成其余的工作。代理仍然有其管理界面——历史记录、工作区、设置——但主要交互是对话而不是点击。
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — 用于 jobs、queues、scripts 和外部 agents 的无浏览器应用。
-
 ## 您与它共同编辑 {#you-co-edit}
 
 当您和代理处理同一份文档时，你们不会轮流处理。通过实时协作，代理的编辑可以与您的编辑一起传输 - 实时光标，不会覆盖 - 与队友的编辑方式相同。您可以在它工作时继续输入，并且它会在发生更改时看到您的更改。
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — 在同一文档中使用实时光标和代理编辑进行多用户协作编辑。
-
 ## 下一步是什么 {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — 代理知道您在看什么

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

@@ -9,6 +9,12 @@ description: "代理聊天编辑器中的语音听写 - Builder Gemini、BYOK
 
 框架会自动处理所有这些。 Builder连接的用户默认获得Builder托管的Gemini Flash-Lite；否则，用户可以携带自己的提供商密钥或退回到浏览器语音识别。
 
+## 实时语音模式 {#realtime-speech-mode}
+
+打开麦克风后，弹出菜单让你在**实时语音对话**和**可编辑听写**之间选择。实时模式需要用户范围的 `OPENAI_API_KEY`，并通过 WebRTC 将浏览器连接到 `gpt-realtime-2.1`。聊天会收起为右下角的语音球；点击语音球即可显示或隐藏聊天，而不会结束对话。
+
+语音模型使用与聊天相同的、经过身份验证的 Agent Native 工具，因此可以一边说话，一边在应用中导航和调用操作。需要审批的操作会保持暂停，直到你批准为止。音频绝不会存储到 SQL 中；Agent Native 只保留精简的会话和转录状态。实时会话最长可持续 60 分钟。
+
 ## 它是如何工作的 {#how-it-works}
 
 作曲家的语音按钮在浏览器中录制音频，然后选择提供商：

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

@@ -423,10 +423,9 @@ Brain's Sources 页面是参考实现。它在 Brain 源记录旁边显示可重
 
 ### 调度控制平面设置
 
-Dispatch 公开了控制平面 actions，该控制平面编写应用程序可以直接调用的相同共享存储函数：
+Dispatch 提供了控制平面 actions，它们使用应用程序可直接调用的相同共享存储函数 — 其中 `upsert-workspace-connection` action 会根据提供商目录验证输入，然后委托给本页所示的同一个 `upsertWorkspaceConnection()`：
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -491,3 +490,11 @@ await upsertWorkspaceConnectionGrant({
 保持严格的边界：提供者元数据可以安全地显示；凭证值保留在保管库中。
 
 </details>
+
+## 后续内容 {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — 通常负责工作区连接设置和保管库的应用
+- [**安全**](/docs/security) — 连接所指向的凭证保管库、机密作用域和访问模型
+- [**入门设置**](/docs/onboarding#checking-workspace-connections-in-onboarding) — 从模板设置清单检查连接就绪状态
+- [**MCP 客户端**](/docs/mcp-clients) — 在工作区中共享 MCP 服务器凭证的相关可复用配置模式
+- [**Brain**](/docs/template-brain) — 基于此模型构建提供商 Sources 页面的参考实现