@agent-native/core 0.92.12 → 0.94.0

package/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/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/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/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={"三种捕获类型集中在一个库中；代理进行抄写、标题和总结，然后每个抄本都可以搜索和共享。"}>
 
@@ -77,13 +77,13 @@ search: "Clips 浏览器日志 开发人员日志 控制台日志 网络日志
 ## 你可以用它做什么
 
 - **使用内置录音机、网络摄像头覆盖、音频捕获和暂停/修剪来录制屏幕**。
+- **导入公开的 Loom 视频。** 在网页端选择 **录制 → 导入 Loom**，然后粘贴 Loom 分享或嵌入 URL。Clips 会将副本保存到你的资料库，并在可用时导入公开的转录文本。
 - **从日历中捕获会议。** 连接 Google Calendar，在侧边栏中查看即将举行的会议，并在任何一个会议上进行记录。您将在结束时获得实时记录以及 AI 摘要、项目符号注释和行动项目。
 - **一键通听写。** 按住机器上的 Fn，说话，清理后的文本就会放入您正在使用的任何应用程序中。每个听写都保存在可搜索的历史记录中，原始版本和人工智能清理的版本并排保存。
 - **为每个录音获取自动生成的标题、摘要和章节标记** - 客服人员会填写这些内容并使其保持最新状态。
 - **搜索每一份记录** — 屏幕录像、会议和听写都在一个库中。 “找到我们讨论推出计划的剪辑。”
 - **共享剪辑**以及每个剪辑的权限（公共、团队、私人）。链接跟踪和线索评论也有效。
-- **在 Slack 中预览公共剪辑**，并在播放后使用 Loom 风格的可播放展开
-  工作区安装您的 Clips Slack 应用。
+- **在 Slack 中预览公共剪辑**，工作区安装 Clips Slack 应用后会显示可播放的视频展开预览。
 - **使用 Chrome 扩展程序捕获浏览器日志。**浏览器记录可以
   附加经过编辑的控制台日志和 fetch/XHR 元数据，这对
   产品错误和仅限浏览器的重现。
@@ -507,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/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>
@@ -89,6 +89,7 @@ Design 是一家代理原生 HTML 原型工作室。该代理不是分层绘图
 ## 你可以用它做什么
 
 - **生成完整的原型。**描述您需要的屏幕或页面，代理将创建一个具有 Tailwind 样式和 Alpine interactions 的工作 HTML 文档。
+- **从可复用模板开始。** 为广告、单页文档、着陆页等选择固定尺寸的起点，或将任意内联设计保存为模板。提示只调整副本中未锁定的内容，锁定的徽标和背景会保持不变。
 - **比较变体。**从多个方向开始，选择最强的一个，然后继续完善。
 - **视觉上的调整。**使用内置的调整控件进行常见更改，或向代理询问副本、布局、颜色、间距和交互更新。
 - **应用设计系统。**保存并重用设计系统首选项，以便生成的作品更贴近您的品牌。
@@ -133,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/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/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/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/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/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/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 页面的参考实现

package/docs/content/locales/zh-CN/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 
 # 工作区
 
-> **哪个工作区文档？** 此页面涵盖 **自定义层** — 工作区*是什么*。对于部署形状（一个单一存储库，许多应用程序），请参阅 [Multi-App Workspaces](/docs/multi-app-workspace)；有关治理（谁审查、批准和拥有什么），请参阅 [Workspace Governance](/docs/workspace-management)。
+<Callout tone="info">
+
+**哪个工作区文档？** 此页面涵盖 **自定义层** — 工作区*是什么*。对于部署形状（一个单一存储库，许多应用程序），请参阅 [Multi-App Workspaces](/docs/multi-app-workspace)；有关治理（谁审查、批准和拥有什么），请参阅 [Workspace Governance](/docs/workspace-management)。
+
+</Callout>
 
 每个代理本机应用程序都附带一个**工作区**：使代理成为您的自定义层。它包含团队指令 (`AGENTS.md`)、共享学习内容 (`LEARNINGS.md`)、个人结构化内存 (`memory/MEMORY.md`)、代理按需拉入的 skills、自定义子代理、计划作业和连接的 MCP 服务器 — 您期望从 Claude 代码 / Codex 设置获得的一切。
 
@@ -81,7 +85,7 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 | 每个项目 `CLAUDE.md` / skills | 每个应用 `AGENTS.md` + 工作区内存资源   |
 | JSON 文件中的 MCP 配置        | JSON 中的 MCP 配置*或*设置 UI，每个范围 |
 
-相同的功能。不同的经济。请参阅 [Templates](/docs/cloneable-saas) 了解为什么这对 SaaS 很重要。
+相同的功能。不同的经济。请参阅 [应用程序](/docs/cloneable-saas) 了解为什么这对 SaaS 很重要。
 
 ## 概述 {#overview}
 
@@ -218,11 +222,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-保持 `context/` 文件简短且真实——代理可以浏览的一些要点：
-
-```text
-<!-- context/brand.md -->
+例如：
 
+```text filename="context/brand.md"
 # 品牌
 
 - Voice: direct, warm, concrete
@@ -387,15 +389,9 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 
 在一个应用程序内使用自定义代理进行委派。当您需要通过 A2A 调用另一个应用程序时，请使用连接的代理。
 
-## @标记 {#at-tagging}
-
-在聊天输入中键入 `@` 以引用工作区项目。光标处会出现一个下拉列表，显示匹配的代理和文件。使用箭头键进行导航并使用 Enter 进行选择。所选项目在输入中显示为内联芯片。
-
-当您发送消息时，**文件/资源**作为代理可以读取的引用进行传递，**自定义代理**使用其配置文件指令在本地运行，并且**连接的代理**通过 A2A 进行调用。
+## @ 标记与 / 斜杠命令 {#at-tagging}
 
-## / 斜线命令 {#slash-commands}
-
-在行首键入 `/` 以调用技能。下拉列表显示可用的 skills 及其名称和描述；选择一个会添加一个内联芯片，并在发送消息时将其内容作为上下文包含在内。如果未配置 skills，则下拉列表链接到这些文档。
+在聊天输入框中键入 `@` 可引用代理、文件或资源，键入 `/` 可调用 skill——两者都会在光标处打开下拉菜单，并在选择项目后添加内联标签。有关完整机制（路由、`MentionProvider`、子代理选择），请参阅[代理提及](/docs/agent-mentions)；有关 skills 的编写和发现方式，请参阅 [Skills 指南](/docs/skills-guide)。
 
 ## 代码与应用程序模式 {#dev-vs-prod}
 
@@ -415,10 +411,6 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 
 请参阅 [Workspace Connections](/docs/workspace-connections) 了解快速入门、connection/grant/credentialRef API 以及具体的 Slack、HubSpot 和 GitHub 示例。
 
----
-
-# 参考
-
 ## 资源API {#resource-api}
 
 可以通过服务器代码、actions 或 REST API 管理资源。
@@ -462,3 +454,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# 会议记录..
 # 删除资源
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## 接下来 {#whats-next}
+
+- [**Skills 指南**](/docs/skills-guide) — 编写 `skills/` 中引用的 skill 文件并设置其范围
+- [**代理提及**](/docs/agent-mentions) — `@` 提及与 `/` 命令的完整机制
+- [**定期作业**](/docs/recurring-jobs) — 调度由 Scheduled Tasks 创建的提示词
+- [**Workspace 治理**](/docs/workspace-management) — 谁负责审核、批准和拥有 workspace 更改
+- [**多应用 Workspace**](/docs/multi-app-workspace) — 一个 workspace 所跨越的部署形态
+- [**Workspace 连接**](/docs/workspace-connections) — 在应用程序之间共享提供商凭据

package/docs/content/locales/zh-TW/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 工具** — 由其他 Agent-Native 應用透過 A2A 呼叫。
 - **CLI 指令** - `pnpm action <name>` 用於指令碼和開發迴圈。
 
@@ -558,7 +558,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-TW/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-TW/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-TW/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-TW/authentication.mdx

@@ -15,7 +15,7 @@ Auth 是透過 auth 伺服器外掛中的 `autoMountAuth(app)` 自動設定的
 - **遠端 MCP OAuth：** 適用於 MCP 主機的標準 OAuth 2.1，例如 Claude 程式碼和 ChatGPT 連線器。
 - **自訂：**透過 `getSession` 回調帶來您自己的驗證。
 
-<Diagram id="doc-block-4yfl8j" title={"三種方式，一次會議"} summary={"瀏覽器訪客、程式化 MCP 用戶端和自訂提供者都解析為下游作用域讀取的同一 AuthSession。"}>
+<Diagram id="doc-block-4yfl8j" title={"三種方式，一次會議"} summary={"瀏覽器訪客、MCP 主機和自訂提供者都解析為下游作用域讀取的同一 AuthSession。"}>
 
 ```html
 <div class="auth-modes">

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

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-xwc8h5"
   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";