@agent-native/core 0.77.3 → 0.77.4

package/corpus/core/docs/content/locales/zh-CN/tracking.md

@@ -21,7 +21,7 @@ track(
 
 ```an-diagram title="一次 track() 调用，每个提供者" summary="服务器和客户端调用者访问相同的注册表，该注册表将每个事件并行地分发给所有活动的提供者。"
 {
-  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Server code<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Browser code<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
+  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">服务器代码<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">浏览器代码<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">扇出，发送即忘</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
   "css": ".trk{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.trk .diagram-col{display:flex;flex-direction:column;gap:8px}.trk .diagram-arrow{font-size:22px;line-height:1}.trk .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -102,11 +102,11 @@ export default defineAction({
 
 `track()` 也适用于浏览器/应用程序代码。从 `@agent-native/core/client` 导入客户端孪生并以相同的方式调用它 - 它将事件发布到 `POST /_agent-native/track` 的框架路由，后者将其转发到**相同**注册的服务器端提供程序（PostHog、Mixpanel、Amplitude、webhook）。没有分析 SDK 发送到浏览器，也没有提供者密钥暴露在客户端。
 
-```an-api title="The client tracking route"
+```an-api title="客户追踪路线"
 {
   "method": "POST",
   "path": "/_agent-native/track",
-  "summary": "Forward a browser event to the registered server-side providers",
+  "summary": "将浏览器事件转发到注册的服务器端提供商",
   "auth": "Session required + same-origin/CSRF marker (set automatically by the client helper). Not an open analytics relay.",
   "params": [
     { "name": "name", "in": "body", "type": "string", "required": true, "description": "Event name. Capped at 200 characters." },

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

@@ -1,17 +1,17 @@
 ---
 title: "使用您的代理"
-description: "与代理合作的日常循环：它看到您正在查看的内容，您指导它，嵌入它，使用 UI-light，并与它一起共同编辑。"
+description: "与代理合作的日常循环：它看到您正在查看的内容，您指导它，嵌入它，使用 轻 UI，并与它一起共同编辑。"
 ---
 
 # 使用您的代理
 
 agent-native 背后的定义思想是，agent 和 UI 是**平等的伙伴** - 请参阅 [What Is Agent-Native?](/docs/what-is-agent-native) 了解原因。本节介绍该承诺的另一半：一旦代理停靠在您的应用旁边，实际使用该代理的感觉如何。
 
-有一条简单的直通线。代理**看到**您正在查看的内容，您**将其引导**到您想要的内容，您可以**嵌入**它在任何地方，您可以在更合适的情况下完全**UI-light**，并且您可以同时**共同编辑**相同的文档。其中每一个都是本节中的一个页面。
+有一条简单的直通线。代理**看到**您正在查看的内容，您**将其引导**到您想要的内容，您可以**嵌入**它在任何地方，您可以在更合适的情况下完全**轻 UI**，并且您可以同时**共同编辑**相同的文档。其中每一个都是本节中的一个页面。
 
 ```an-diagram title="日复一日的循环" summary="使用对接代理的五种方式 - 每种方式都是本节中的一个页面。"
 {
-  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI-light</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Co-edit</span><small class=\"diagram-muted\">live, side by side</small></div></div>",
+  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>轻 UI</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">协同编辑</span><small class=\"diagram-muted\">实时，并排</small></div></div>",
   "css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
 }
 ```
@@ -49,7 +49,7 @@ agent-native 背后的定义思想是，agent 和 UI 是**平等的伙伴** -
 → [**Drop-in Agent**](/docs/drop-in-agent) — 将 `<AgentPanel>`、`<AgentSidebar>` 和 `sendToAgentChat()` 安装到任何 React 应用程序中。
 → [**Agent Surfaces**](/docs/agent-surfaces) — 选择工作流程是否应为无头、聊天优先、嵌入式或完整应用程序。
 
-## 你可以去UI-light {#ui-light}
+## 你可以去轻 UI {#ui-light}
 
 并非每个应用程序都需要完整的仪表板。当代理*是*产品时，您可以跳过大部分自定义UI：打开应用程序，询问您想要的内容，然后让代理完成其余的工作。代理仍然有其管理界面——历史记录、工作区、设置——但主要交互是对话而不是点击。
 
@@ -67,5 +67,5 @@ agent-native 背后的定义思想是，agent 和 UI 是**平等的伙伴** -
 - [**Agent Mentions**](/docs/agent-mentions) — 使用 `@` 提及来引导
 - [**Voice Input**](/docs/voice-input) — 通过说话进行指导
 - [**Drop-in Agent**](/docs/drop-in-agent) — 将其嵌入任何 React 应用
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) — 当代理是产品时，采用 UI-light
+- [**Pure-Agent Apps**](/docs/pure-agent-apps) — 当代理是产品时，采用 轻 UI
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — 共同编辑同一文档

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

@@ -21,7 +21,7 @@ description: "代理聊天编辑器中的语音听写 - Builder Gemini、BYOK
 
 ```an-diagram title="语音转录提供商后备方案" summary="作曲家录制音频，然后按顺序遍历服务器提供程序，仅当没有可用的服务器提供程序时才转到浏览器 Web Speech API。"
 {
-  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Mic button<br><small class=\"diagram-muted\">records webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">default when Builder connected</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
+  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">麦克风按钮<br><small class=\"diagram-muted\">录制 webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">连接 Builder 后默认使用</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
   "css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -43,17 +43,17 @@ Builder 是最简单的路径：从“设置”连接 Builder.io，默认提供
 ```an-callout
 {
   "tone": "info",
-  "body": "**Credential resolution order:** the route checks the user's own encrypted secret first, then the shared deployment key. A power user with their own key always overrides the shared one. If neither exists, the route returns a 400 the composer recognizes and silently falls back to browser Web Speech."
+  "body": "**凭证解析顺序：**路由首先检查用户自己的加密密钥，然后检查共享部署密钥。拥有自己密钥的高级用户始终会覆盖共享密钥。如果两者都不存在，则路由将返回作曲家识别的 400，并默默地退回到浏览器 Web 语音。"
 }
 ```
 
 ## 路线 {#route}
 
-```an-api title="Voice transcription route"
+```an-api title="语音转录路线"
 {
   "method": "POST",
   "path": "/_agent-native/transcribe-voice",
-  "summary": "Transcribe a recorded audio clip into prompt text",
+  "summary": "将录制的音频片段转录为提示文本",
   "auth": "Active session (Better Auth cookie). Same-origin only.",
   "description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
   "params": [

package/corpus/core/docs/content/locales/zh-CN/what-is-agent-native.md

@@ -26,7 +26,7 @@ description: "为什么大多数人工智能应用感觉是半成品，是什么
 
 大多数团队都在攀登，就像梯子一样，而且大多数人过早地停止了一级。
 
-### Rung 1 — 单个 LLM 调用（反模式） {#rung-one}
+### 第 1 阶 — 单个 LLM 调用（反模式） {#rung-one}
 
 文本框发送提示，AI 返回字符串，然后您显示它。也许用旋转器。用户无法纠正路线，人工智能无法采取行动，无法了解发生了什么或为什么。
 
@@ -52,7 +52,7 @@ description: "为什么大多数人工智能应用感觉是半成品，是什么
 
 ```an-diagram title="阶梯原理" summary="大多数团队停在第 1 级或第 2 级。原生代理是第 3 级——一个真实的应用程序和一个共享操作界面上的真实代理。"
 {
-  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">第 3 阶 · agent-native</span><strong>代理 + UI 作为平等伙伴</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">第 2 阶</span><strong>带工具的聊天</strong><small class=\"diagram-muted\">代理可以行动，但它仍只是聊天窗口。没有仪表盘、列表或快捷键。</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">第 1 阶</span><strong>一次 LLM 调用</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
   "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
 }
 ```
@@ -91,7 +91,7 @@ description: "为什么大多数人工智能应用感觉是半成品，是什么
 
 ```an-diagram title="一套系统，两种方式" summary="代理和 UI 写入相同的操作和相同的数据库。无论一个人做什么，另一个人都会看到。"
 {
-  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL 数据库</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">点击、表单、快捷键</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">自然语言 · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL 数据库</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">界面实时更新</div></div>",
   "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ Agent-native 不仅仅适合开发人员。由于代理可以编辑应用程序
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "5", "label": "工具表面", "note": "`description` 是代理读取的内容，以决定何时将其调用为工具。" },
     { "lines": "6", "label": "类型化契约", "note": "一个 zod `schema` 会验证来自**每个**界面的输入：代理、UI、HTTP、MCP 和 A2A。" },
-    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+    { "lines": "7-10", "label": "一次实施", "note": "`run` 主体是唯一的事实来源。 UI 按钮和代理工具都执行此操作。" }
   ]
 }
 ```

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

@@ -18,7 +18,7 @@ description: "用于 connect-once-use-everywhere 集成的共享提供商元数
 
 ```an-diagram title="连接一次、授予应用程序、重复使用凭据" summary="连接保存提供者元数据（绝不是秘密）和指向保管库的 credentialRefs。每个应用程序授予解锁它。应用程序读取单个就绪状态。"
 {
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, status, scopes, config &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
+  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, 状态、作用域、配置 &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
   "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
 }
 ```
@@ -58,32 +58,32 @@ await upsertWorkspaceConnectionGrant({
 });
 ```
 
-```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+```an-schema title="连接模型" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
 {
   "entities": [
     {
       "id": "conn",
       "name": "workspace_connections",
-      "note": "Named provider account. Never stores secret values.",
+      "note": "指定的提供商帐户。从不存储秘密值。",
       "fields": [
         { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
-        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "provider", "type": "string", "note": "稳定的提供商 ID，e.g。松弛" },
         { "name": "label", "type": "string" },
         { "name": "accountId", "type": "string", "nullable": true },
         { "name": "accountLabel", "type": "string", "nullable": true },
         { "name": "status", "type": "string", "note": "e.g. connected" },
         { "name": "scopes", "type": "string[]", "nullable": true },
-        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "config", "type": "json", "nullable": true, "note": "安全、非秘密配置" },
         { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
       ]
     },
     {
       "id": "grant",
       "name": "workspace_connection_grants",
-      "note": "Per-app permission to use a connection.",
+      "note": "每个应用程序使用连接的权限。",
       "fields": [
         { "name": "connectionId", "type": "string", "fk": "conn.id" },
-        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+        { "name": "appId", "type": "string", "note": "e.g。大脑、分析" }
       ]
     }
   ],
@@ -208,7 +208,7 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ```an-diagram title="连接存储与保管库" summary="金库拥有秘密价值。连接拥有提供者元数据和 credentialRefs（指针）。在执行时，应用程序通过授予的连接解析引用并从保管库读取值。"
 {
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">App action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">never returned to the agent or UI</small></div></div></div>",
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">连接存储</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">状态、作用域、配置</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">应用 action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">绝不返回给代理或 UI</small></div></div></div>",
   "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/corpus/core/docs/content/locales/zh-CN/workspace-management.md

@@ -11,7 +11,7 @@ description: "分支、CODEOWNERS、PR 审查以及 Dispatch 如何与 git 级
 
 ```an-diagram title="两个治理平面" summary="Git 管理代码； Dispatch 控制运行时。它们是互补的——不要将一个复制到另一个中。"
 {
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git / GitHub</span><strong>Code governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR review</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
+  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git 和 GitHub</span><strong>代码治理</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR 评审</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
   "css": ".gov{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.gov .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.gov .gov-list{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}"
 }
 ```
@@ -64,16 +64,16 @@ GitHub 的 CODEOWNERS 文件会根据更改的文件自动将审阅者分配给
 # Framework core — affects every app; platform team reviews all changes
 packages/core/                     @your-org/platform-team
 
-# Dispatch control plane — secrets, integrations, workspace resources
+# 调度控制平面——秘密、集成、工作空间资源
 templates/dispatch/                @your-org/platform-team
 
-# Per-app ownership — each team reviews their own app
+# 每个应用程序所有权 - 每个团队都会审查自己的应用程序
 templates/mail/                    @your-org/mail-team
 templates/analytics/               @your-org/analytics-team
 templates/calendar/                @your-org/calendar-team
 # ... add an entry per app
 
-# Workspace-level config — broad review since it affects everyone
+# 工作区级别配置 - 广泛审查，因为它影响每个人
 .github/                           @your-org/platform-team
 package.json                       @your-org/platform-team
 pnpm-workspace.yaml                @your-org/platform-team
@@ -132,7 +132,7 @@ core:
 
 [Dispatch](/docs/dispatch) 应用程序是工作区的运行时控制平面。它通过运行时治理补充了 git 级治理：
 
-| 关注             | Git / GitHub            | 调度                                      |
+| 关注             | Git 和 GitHub           | 调度                                      |
 | ---------------- | ----------------------- | ----------------------------------------- |
 | 谁可以更改代码   | CODEOWNERS，分支保护    | —                                         |
 | 谁可以访问机密   | —                       | 保险柜政策、拨款、请求工作流程            |

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

@@ -13,7 +13,7 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 
 ```an-diagram title="Claude-Code 工作区，但存储在 SQL 中" summary="相同的定制层——指令、技能、内存、代理、作业、MCP——除了每个文件都是共享多租户数据库中的一行。"
 {
-  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native workspace</span><small class=\"diagram-muted\">rows in one SQL 数据库</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">one codebase, many users, scoped <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
+  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native 工作区</span><small class=\"diagram-muted\">rows in one SQL 数据库</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">一个代码库，多用户，有作用域 <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
   "css": ".ws-map{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ws-map .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:220px}.ws-map .ws-files,.ws-map .ws-rows{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0}.ws-map .diagram-arrow{font-size:24px}"
 }
 ```
@@ -53,7 +53,7 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 
 ```an-diagram title="三个范围，一个有效文件" summary="运行时在读取时解析跨工作区、应用程序和个人范围的相同路径 - 最具体的范围获胜。"
 {
-  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">company-wide defaults from Dispatch</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Organization / app</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
+  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">来自 Dispatch 的公司级默认值</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">组织 / 应用</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
   "css": ".ws-stack{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.ws-stack .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px;min-width:280px}.ws-stack .diagram-arrow{font-size:20px;align-self:center}.ws-stack code{font-size:.85em}.ws-stack .diagram-box{align-self:center;margin-top:4px}"
 }
 ```
@@ -74,7 +74,7 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 3. 保存，切换到**聊天**，询问任何问题 - 客服人员立即遵循新规则。
 
 ```an-callout
-{ "tone": "info", "body": "No restart, no redeploy. `AGENTS.md` is read at the start of every turn, so an edit you save now changes the agent's behavior on the very next message." }
+{ "tone": "info", "body": "无需重新启动，无需重新部署。 `AGENTS.md` 在每个回合开始时都会被读取，因此您现在保存的编辑会更改代理在下一条消息中的行为。" }
 ```
 
 **后续步骤（当您需要时）：**
@@ -96,10 +96,10 @@ description: "Claude - 每个用户的代码级自定义 - skills、内存、指
 适用于新工作区的有用入门包：
 
 ```text
-context/company.md              # what the company does, ICP, products, links
-context/brand.md                # voice, visual identity, spelling, forbidden usage
-context/messaging.md            # positioning, value props, proof points, objections
-instructions/guardrails.md      # compliance, escalation, and approval rules
+context/company.md              # 公司的业务、ICP、产品、链接
+context/brand.md                # 声音、视觉识别、拼写、禁止使用
+context/messaging.md            # 定位、价值支柱、证据点、反对意见
+instructions/guardrails.md      # 合规、升级和批准规则
 skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
 agents/<slug>.md                # reusable custom agent profiles
 ```
@@ -119,7 +119,7 @@ workspace context/brand.md
 ```text
 <!-- context/brand.md -->
 
-# Brand
+# 品牌
 
 - Voice: direct, warm, concrete
 - Use: "workspace", "agent", "team"
@@ -183,18 +183,18 @@ instructions/legal-review-policy.md
 
 这些表面中的每一个 - `AGENTS.md`、skills、内存、自定义代理、MCP 服务器 - 都是相同的底层资源形状：`path` + `scope` + `content`，以相同的方式寻址和解析。
 
-```an-schema title="The workspace resource model" summary="One resource shape backs every workspace file. The runtime keys it by path and scope and resolves the effective value on read."
+```an-schema title="工作区资源模型" summary="一种资源形状支持每个工作区文件。运行时按路径和范围对其进行键控，并解析读取时的有效值。"
 {
   "entities": [
     {
       "id": "resource",
       "name": "workspace resource",
-      "note": "A single file in a user's workspace — instructions, skill, memory, agent, MCP config, or job.",
+      "note": "用户工作区中的单个文件 - 说明、技能、内存、代理、MCP 配置或作业。",
       "fields": [
         { "name": "path", "type": "string", "note": "Canonical path, e.g. AGENTS.md, skills/<slug>/SKILL.md" },
-        { "name": "scope", "type": "workspace | shared | personal", "note": "Which level this row lives at" },
+        { "name": "scope", "type": "workspace | shared | personal", "note": "该行位于哪一层" },
         { "name": "owner", "type": "string", "nullable": true, "note": "u:<email> for personal scope" },
-        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML body" }
+        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML 正文" }
       ]
     }
   ]
@@ -221,12 +221,12 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 {
   "filename": "agents/design.md",
   "language": "markdown",
-  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# Role\n\nYou are a focused design agent.\n\n## Responsibilities\n\n- Review layouts and interaction flows\n- Suggest stronger visual direction\n- Be concise and opinionated",
+  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# 角色\n\n您是一名专注的设计代理。\n\n##职责\n\n-审查布局和交互流程\n-提出更强的视觉方向\n-简洁且有主见",
   "annotations": [
-    { "lines": "2", "label": "@mention handle", "note": "`name` is what appears in the `@`-dropdown and what the main agent delegates to." },
-    { "lines": "3-4", "label": "When to delegate", "note": "The `description` is what the orchestrator reads to decide this profile fits a task." },
-    { "lines": "5", "label": "Model", "note": "`inherit` reuses the main agent's model. Override only when the profile clearly needs a different one." },
-    { "lines": "6", "note": "`tools: inherit` for now — the field is reserved for future per-agent tool policies." }
+    { "lines": "2", "label": "@mention handle", "note": "`name` 是 `@` 下拉列表中显示的内容，也是主代理委托的内容。" },
+    { "lines": "3-4", "label": "何时委托", "note": "`description` 是协调器读取的内容，以确定此配置文件适合任务。" },
+    { "lines": "5", "label": "型号", "note": "`inherit` 重用主代理的模型。仅当配置文件明确需要不同的配置文件时才覆盖。" },
+    { "lines": "6", "note": "`tools: inherit` 目前 - 该字段是为未来的每代理工具策略保留的。" }
   ]
 }
 ```
@@ -303,21 +303,21 @@ Skills 是 `skills/` 路径（最好是 `skills/<name>/SKILL.md`）下的 Markdo
 代理使用这些内置的 actions。您也可以从您自己的 actions 中调用它们：
 
 ```bash
-# List all resources
+# 列出所有资源
 pnpm action resource-list --scope all
 
-# Read a resource
+# 阅读资源
 pnpm action resource-read --path "skills/my-skill/SKILL.md"
 
-# Read inherited workspace context managed by Dispatch
+# 读取由 Dispatch 管理的继承工作区上下文
 pnpm action resource-read --scope workspace --path "context/brand.md"
 
 # Show workspace -> organization/app -> personal precedence for a path
 pnpm action resource-effective --path "context/brand.md"
 
-# Write a resource
-pnpm action resource-write --path "notes/meeting.md" --content "# Meeting Notes..."
+# 写一个资源
+pnpm action resource-write --path "notes/meeting.md" --content "# 会议记录...”
 
-# Delete a resource
+# 删除资源
 pnpm action resource-delete --path "notes/old.md"
 ```

package/corpus/core/docs/content/locales/zh-CN/writing-agent-instructions.md

@@ -1,15 +1,15 @@
 ---
-title: "撰写代理说明和Skills"
+title: "撰写代理说明和技能"
 description: "如何为代理原生应用或模板编写出色的代理指令：AGENTS.md、skills 和工具说明。"
 ---
 
-# 撰写代理说明和Skills
+# 撰写代理说明和技能
 
 代理在代理本机应用程序中的行为仅与您给出的说明一样好。三个表面承载该指导：`AGENTS.md`（地图）、skills（深入研究）和操作/工具描述（代理如何选择正确的工具）。写下每一篇都是为了快速检索，而不是为了散文。
 
 ```an-diagram title="三个创作表面 + 一个运行时表面" summary="AGENTS.md 和工具描述每回合都会加载；按需加载技能； application_state 由您的 UI 实时编写。"
 {
-  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Every turn</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">the map: purpose, core rules, state keys, action + skills index</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Every turn</span><strong>Tool descriptions</strong><small class=\"diagram-muted\">drive tool selection — one precise sentence each</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">On demand</span><strong>Skills</strong><small class=\"diagram-muted\">deep how-to, loaded when the description fires</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">written by your UI: navigation, selection, focus</small></div></div>",
+  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">每一轮</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">地图：用途、核心规则、状态键、action + skills 索引</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">每一轮</span><strong>工具描述</strong><small class=\"diagram-muted\">驱动工具选择 — 每个工具一句精确说明</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">按需</span><strong>技能</strong><small class=\"diagram-muted\">深度指南，在描述匹配时加载</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">由你的 UI 写入：导航、选择、焦点</small></div></div>",
   "css": ".diagram-surfaces{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.diagram-surfaces .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
 }
 ```
@@ -22,28 +22,28 @@ description: "如何为代理原生应用或模板编写出色的代理指令：
 - **核心规则** - 必须始终保持的少数不变量（SQL 中的数据，操作通过 actions，AI 通过代理聊天，模式更改是附加的）。简短、命令式的项目符号。
 - **应用程序状态键** — 代理读取 `navigation`/选择/焦点键以了解用户正在查看的内容及其形状。
 - **操作表** — 操作名称与目的的紧凑表。
-- **Skills 索引** — 存在的 skills 列表以及何时读取每个 skills。
+- **技能 索引** — 存在的 skills 列表以及何时读取每个 skills。
 
 如果一个部分超出了屏幕，那么它就属于一项技能。 `AGENTS.md` 回答“这个应用程序是什么以及我能做什么”，而不是“我到底如何做困难的事情。”
 
 ```markdown
-# Projects App
+# 项目应用程序
 
 One workspace for projects, tasks, and notes. Agent and UI share the same SQL
 data and the same actions.
 
-## Core Rules
+## 核心规则
 
-- Data lives in SQL via Drizzle. Use actions for all writes.
+- Data lives in 通过 Drizzle 使用 SQL. Use actions for all writes.
 - All AI work goes through the agent chat; never call an LLM inline.
 - Schema changes are additive only.
 
-## Application State
+## 应用状态
 
 - `navigation.view`: `home` | `project`
 - `navigation.projectId`: selected project on a project page
 
-## Actions
+## 行动
 
 | Action           | Purpose                     |
 | ---------------- | --------------------------- |
@@ -51,7 +51,7 @@ data and the same actions.
 | `create-project` | Create a project            |
 | `update-project` | Rename or archive a project |
 
-## Skills
+## 技能
 
 - `project-imports` — read before importing legacy CSV exports.
 - `sharing` — read before exposing a project to other users.
@@ -84,12 +84,12 @@ description: >-
 
 ```text
 .agents/skills/project-imports/
-├── SKILL.md            # rule + happy path + do/don't
+├── SKILL.md            # 规则 + 快乐路径 + do/don't
 └── references/
-    └── csv-format.md   # full column spec, encodings, edge cases
+    └── csv-format.md   # 全列规范、编码、边缘情况
 ```
 
-这使始终加载的表面保持较小，并允许深度缩放而不会使上下文膨胀。完整技能格式请参见 [Skills Guide](/docs/skills-guide)。
+这使始终加载的表面保持较小，并允许深度缩放而不会使上下文膨胀。完整技能格式请参见 [技能 Guide](/docs/skills-guide)。
 
 ## 编写面向行动的表格 {#action-tables}
 
@@ -114,9 +114,9 @@ defineAction({
 });
 ```
 
-## Skills vs actions {#skills-vs-actions}
+## 技能 vs actions {#skills-vs-actions}
 
-Skills 和 actions 是互补的。技能是代理阅读的指南；一个
+技能 和 actions 是互补的。技能是代理阅读的指南；一个
 action 是代理可以运行的代码。
 
 | 需要                                       | 使用             |
@@ -151,7 +151,7 @@ action 是代理可以运行的代码。
 | 表面                      | 谁写的                 | 加载时                       | 那里属于什么                                    |
 | ------------------------- | ---------------------- | ---------------------------- | ----------------------------------------------- |
 | `AGENTS.md`说明           | 您（开发者）           | 每个回合，作为方向           | 目的、核心规则、状态键、动作索引、skills索引    |
-| Skills (`SKILL.md`)       | 您（开发者）           | 当客服人员认为技能相关时按需 | 特定模式的分步操作方法，列出了该做/不该做的事情 |
+| 技能 (`SKILL.md`)         | 您（开发者）           | 当客服人员认为技能相关时按需 | 特定模式的分步操作方法，列出了该做/不该做的事情 |
 | 操作描述（工具）          | 您（开发者）           | 每回合，如工具列表           | 操作的作用、返回内容、参数语义                  |
 | `application_state`上下文 | 您的 UI 代码（运行时） | 每回合，作为实时应用状态     | 当前导航、选择、聚焦对象、URL                   |
 
@@ -163,11 +163,11 @@ action 是代理可以运行的代码。
 ## 什么去哪里 {#what-goes-where}
 
 - **AGENTS.md** — 适用于整个应用程序，每回合：目的、核心规则、状态键、操作索引、skills 索引。
-- **Skills** — 针对特定模式的可重用操作方法，按需加载。适用于在该应用中工作的每个人。
+- **技能** — 针对特定模式的可重用操作方法，按需加载。适用于在该应用中工作的每个人。
 - **内存 (`memory/MEMORY.md`)** — 每个用户的偏好和更正，而非编写的指导。
 
 ## 下一步是什么 {#whats-next}
 
-- [Skills Guide](/docs/skills-guide) — 技能文件格式、框架 skills 和应用程序支持的 skills。
+- [技能 Guide](/docs/skills-guide) — 技能文件格式、框架 skills 和应用程序支持的 skills。
 - [Creating Templates](/docs/creating-templates) — `AGENTS.md` 和 skills 如何融入可交付模板。
 - [The four-area checklist](/docs/key-concepts#four-area-checklist) - 每个特征都必须满足的四区域模型。

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.77.3",
+  "version": "0.77.4",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/corpus/core/src/client/i18n.tsx

@@ -585,6 +585,16 @@ function interpolateFallbackMessage(
   });
 }
 
+function humanizeFallbackKey(key: string) {
+  const lastSegment = key.split(".").filter(Boolean).pop() ?? key;
+  const words = lastSegment
+    .replace(/[_-]+/g, " ")
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .trim()
+    .toLowerCase();
+  return words ? words.charAt(0).toUpperCase() + words.slice(1) : key;
+}
+
 function fallbackMessage(key: string, options?: Record<string, unknown>) {
   const count = Number(options?.count);
   const pluralKey =
@@ -594,7 +604,9 @@ function fallbackMessage(key: string, options?: Record<string, unknown>) {
     DEFAULT_ENGLISH_MESSAGES[key] ??
     CORE_FALLBACK_MESSAGES[pluralKey] ??
     CORE_FALLBACK_MESSAGES[key];
-  return template ? interpolateFallbackMessage(template, options) : key;
+  return template
+    ? interpolateFallbackMessage(template, options)
+    : humanizeFallbackKey(key);
 }
 
 export function useT() {