@agent-native/core 0.93.0 → 0.94.0

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

@@ -5,7 +5,7 @@ description: "skills 如何在 Agent-Native 中工作：框架 skills、域 skil
 
 # 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`，以及用於 repository 支援的 docs/blog/MDX 編輯的 `content`。
 
-應用程式支援的 skills 將 Agent-Native 應用程式打包為技能市場工件。該捆綁包可以包含代理指令、匯出的 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 @@ Agent-Native 執行時從 `.agents/skills/` 讀取 skills。 Claude 程式碼獨
 
 </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 將 Agent-Native 應用程式打包為技能市場工件。
-捆綁包可以包含代理指令、匯出的 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-TW/template-assets.mdx

@@ -86,6 +86,18 @@ Assets 是一個 Agent-Native 工作區，用於建立和管理品牌一致的
 - **其他應用程式需要資產選取器或生成器** - 幻燈片、設計、內容、部落格編輯器或網站建置器可以嵌入選取器或透過 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 是一個 Agent-Native 工作區，用於建立和管理品牌一致的
 - “將此上傳的圖表轉換為更清晰的產品解釋圖片。”
 - “建立影片故事板並將最佳幀集儲存到此庫。”
 
-## 你可以用它做什麼
-
-- **建立資產庫。**按品牌、行銷活動、產品或類別對參考圖片、影片、規範徽標、樣式註解、調色板、資料夾和產生的輸出進行分組。
-- **透過聊天生成。** 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 是一個 Agent-Native 工作區，用於建立和管理品牌一致的
 
 本檔案的其餘部分適用於任何分叉資產範本或擴充功能它的人。
 
-### 腳手架
+### 快速開始
 
 ```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-TW/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-TW/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-11lg5ws" 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-TW/template-design.mdx

@@ -11,7 +11,7 @@ Design 是一家 Agent-Native 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-TW/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-TW/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-TW/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-TW/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-TW/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-TW/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/corpus/core/docs/content/locales/zh-TW/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>
 
 每個 Agent-Native 應用程式都附帶一個**工作區**：使代理成為您的自訂層。它包含團隊指令 (`AGENTS.md`)、共用學習內容 (`LEARNINGS.md`)、個人結構化記憶 (`memory/MEMORY.md`)、代理按需拉入的 skills、自訂子代理、計畫作業和連線的 MCP 伺服器 — 您期望從 Claude 程式碼 / Codex 設定獲得的一切。
 
@@ -82,7 +86,7 @@ description: "Claude - 每個使用者的程式碼級自訂 - skills、記憶、
 | 每個專案 `CLAUDE.md` / skills | 每個應用 `AGENTS.md` + 工作區記憶資源   |
 | JSON 檔案中的 MCP 設定        | JSON 中的 MCP 設定*或*設定 UI，每個範圍 |
 
-相同的功能。不同的經濟。請參閱 [Templates](/docs/cloneable-saas) 了解為什麼這對 SaaS 很重要。
+相同的功能。不同的經濟。請參閱 [應用程式](/docs/cloneable-saas) 了解為什麼這對 SaaS 很重要。
 
 ## 概述 {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-保持 `context/` 檔案簡短且真實——代理可以瀏覽的一些要點：
-
-```text
-<!-- context/brand.md -->
+例如：
 
+```text filename="context/brand.md"
 # 品牌
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,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}
 
@@ -416,10 +412,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 管理資源。
@@ -463,3 +455,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/corpus/core/docs/content/mcp-apps.mdx

@@ -5,7 +5,7 @@ description: "Author and embed interactive MCP App UIs inside Claude, ChatGPT, a
 
 # MCP Apps
 
-**This page: inline UIs in Claude/ChatGPT.** Authoring MCP App resources and the embed bridge that renders a real app route inside a compatible host's chat. This page is also the single home for the **client support matrix** ([below](#client-support)).
+**This page: inline UIs in Claude/ChatGPT.** Authoring MCP App resources and the embed bridge that renders a real app route inside a compatible host's chat. This page is also the single home for the **host support matrix** ([below](#client-support)).
 
 | If you want to…                                              | Read                                     |
 | ------------------------------------------------------------ | ---------------------------------------- |
@@ -13,7 +13,7 @@ description: "Author and embed interactive MCP App UIs inside Claude, ChatGPT, a
 | Give your agent more tools (consume other MCP servers)       | [MCP Clients](/docs/mcp-clients)         |
 | Build inline UIs that render in Claude/ChatGPT               | **This page** — MCP Apps                 |
 | Build generated inline UI inside Agent-Native chat           | [Generative UI](/docs/generative-ui)     |
-| Lower-level MCP server reference (auth, tools, custom mount) | [MCP Protocol](/docs/mcp-protocol)       |
+| Lower-level MCP server reference (auth, tools, custom mount) | [MCP Server](/docs/mcp-protocol)         |
 
 MCP Apps are the official `io.modelcontextprotocol/ui` extension that lets compatible hosts — Claude, Claude Desktop, ChatGPT, VS Code GitHub Copilot, Goose, Postman, MCPJam, and Cursor — render interactive UIs inline in chat. In agent-native apps, every MCP App is a **real React route**, not a separate plain-HTML widget.
 
@@ -95,22 +95,6 @@ Do not hand-write one-off plain HTML MCP Apps for product UI; if the action need
 
 </Diagram>
 
-```ts
-import { embedApp } from "@agent-native/core";
-
-export default defineAction({
-  // ...description, schema, run, link...
-  mcpApp: {
-    resource: embedApp({
-      title: "Review draft",
-      description: "Open the generated draft in the real Mail compose UI.",
-      iframeTitle: "Agent-Native Mail",
-      openLabel: "Open in Mail",
-    }),
-  },
-});
-```
-
 <AnnotatedCode
   id="doc-block-exq36i"
   title="The mcpApp resource config"
@@ -159,7 +143,7 @@ MCP App embeds are route embeds, not separate mini-products. `embedApp()` starts
       <strong>Claude web</strong
       ><span class="diagram-pill accent">single-frame transplant</span
       ><small class="diagram-muted"
-        >hydrates signed app HTML in Claude's iframe, then direct`ui/_` host
+        >hydrates signed app HTML in Claude's iframe, then direct `ui/*` host
         bridge</small
       >
     </div>
@@ -167,7 +151,7 @@ MCP App embeds are route embeds, not separate mini-products. `embedApp()` starts
       <strong>ChatGPT web</strong
       ><span class="diagram-pill accent">controlled route iframe</span
       ><small class="diagram-muted"
-        >`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage
+        >`window.openai` host APIs · `agentNative.mcpHost.*` postMessage
         relay</small
       >
     </div>
@@ -214,19 +198,17 @@ MCP App embeds are route embeds, not separate mini-products. `embedApp()` starts
 
 Claude web uses a single-frame transplant path: the resource document fetches the signed app HTML and hydrates it inside Claude's MCP App iframe because Claude does not reliably allow app-owned child iframes or external frame navigation. ChatGPT web gets a controlled route iframe because its Apps bridge gives us stable `window.openai` host APIs and bounded height control. All paths point at the same signed app route and render the normal route and React components. Design embedded routes so a reload with the same signed URL reconstructs the same view.
 
-For same-app `open_app({ embed: true })`, the framework mints the embed-start ticket during the original tool call and stores the signed start URL in hidden tool metadata. Custom actions can return `embedStartUrl` for the same fast path; the MCP layer strips that ticket-bearing URL from model-visible `structuredContent` and normal open-link metadata. When no embed start URL is present, the resource falls back to the app-only `create_embed_session` helper. This keeps production hosts that restrict iframe-initiated tool calls on the direct route without leaking one-time app session URLs into the transcript. If a user reopens an old chat after a one-time start ticket has expired, the start route returns a small refresh page and posts `agentNative.embedSessionExpired` to the wrapper; `embedApp()` clears the stale start URL and mints a fresh ticket through `create_embed_session` when it still has the original app route.
-
-ChatGPT gets a dedicated compatibility path through `window.openai`: the launch document reads `toolInput`, `toolOutput`, and `toolResponseMetadata` directly, then calls `create_embed_session` via `window.openai.callTool(...)`. Standard MCP Apps hosts use the `ui/*` JSON-RPC bridge. Directly hydrated routes can call `ui/update-model-context`, `ui/message`, `ui/open-link`, and `ui/request-display-mode` through the host bridge helpers. Claude's transplanted route uses the same direct `ui/*` host bridge after hydration. When the ChatGPT or explicit diagnostic iframe path is used, the wrapper relays the same host actions over `agentNative.mcpHost.*` postMessage requests. Keep the result shape identical for both paths: return a focused `link` and concise structured content.
-
-Do not set standard `_meta.ui.domain` to an app URL. MCP Apps treats that field as host-specific: Claude validates `{hash}.claudemcpcontent.com`-style sandbox domains, while ChatGPT uses its own `openai/widgetDomain` metadata. Omit `ui.domain` unless you are deliberately emitting a host-specific value; the host will choose a default sandbox origin.
-
-Extension pages keep their sandbox in MCP chat embeds without navigating a second route iframe. Normal app usage renders `/_agent-native/extensions/:id/render` as a sandboxed child iframe. In MCP chat bridge mode the framework renders the same extension document as sandboxed `srcDoc` inside the route iframe, avoiding host `frame-ancestors` / `X-Frame-Options` failures while preserving `sandbox="allow-scripts allow-forms"`.
+A few bridge mechanics worth knowing:
 
-The resource shell owns the outer host size. `embedApp({ height })` defaults to `560px`, clamps the shell to `320-900px`, and reserves `44px` for the small toolbar, so the route viewport is `height - 44px`. Keep embedded app routes internally scrollable and let the launcher report that bounded intrinsic height rather than the full document height; otherwise host auto-resize can turn a normal app page into a very tall chat artifact. A changed shell only affects new MCP App resources and new tool calls. Old ChatGPT/Claude conversation frames can keep the previous resource behavior, so verify sizing with a fresh inline render before judging a fix.
+- **Embed-start tickets are reused, not re-minted, when possible.** For same-app `open_app({ embed: true })`, the framework mints the embed-start ticket during the original tool call and stores the signed start URL in hidden tool metadata. Custom actions can return `embedStartUrl` for the same fast path; the MCP layer strips that ticket-bearing URL from model-visible `structuredContent` and normal open-link metadata. When no embed start URL is present, the resource falls back to the app-only `create_embed_session` helper — this keeps production hosts that restrict iframe-initiated tool calls on the direct route without leaking one-time app session URLs into the transcript. If a user reopens an old chat after a one-time start ticket has expired, the start route returns a small refresh page and posts `agentNative.embedSessionExpired` to the wrapper; `embedApp()` clears the stale start URL and mints a fresh ticket through `create_embed_session` when it still has the original app route.
+- **ChatGPT's compatibility path** reads `toolInput`, `toolOutput`, and `toolResponseMetadata` directly through `window.openai`, then calls `create_embed_session` via `window.openai.callTool(...)`. Standard MCP Apps hosts use the `ui/*` JSON-RPC bridge instead — directly hydrated routes call `ui/update-model-context`, `ui/message`, `ui/open-link`, and `ui/request-display-mode` through the host bridge helpers, and Claude's transplanted route uses that same direct `ui/*` bridge after hydration. When the ChatGPT or explicit diagnostic iframe path is used, the wrapper relays the same host actions over `agentNative.mcpHost.*` postMessage requests instead. Keep the result shape identical for both paths: return a focused `link` and concise structured content.
+- **Don't set standard `_meta.ui.domain` to an app URL.** MCP Apps treats that field as host-specific: Claude validates `{hash}.claudemcpcontent.com`-style sandbox domains, while ChatGPT uses its own `openai/widgetDomain` metadata. Omit `ui.domain` unless you are deliberately emitting a host-specific value; the host will choose a default sandbox origin.
+- **Extension pages keep their sandbox** in MCP chat embeds without navigating a second route iframe. Normal app usage renders `/_agent-native/extensions/:id/render` as a sandboxed child iframe; in MCP chat bridge mode the framework renders the same extension document as sandboxed `srcDoc` inside the route iframe, avoiding host `frame-ancestors` / `X-Frame-Options` failures while preserving `sandbox="allow-scripts allow-forms"`.
+- **The resource shell owns the outer host size.** `embedApp({ height })` defaults to `560px`, clamps the shell to `320-900px`, and reserves `44px` for the small toolbar, so the route viewport is `height - 44px`. Keep embedded app routes internally scrollable and let the launcher report that bounded intrinsic height rather than the full document height — otherwise host auto-resize can turn a normal app page into a very tall chat artifact. A changed shell only affects new MCP App resources and new tool calls; old ChatGPT/Claude conversation frames can keep the previous resource behavior, so verify sizing with a fresh inline render before judging a fix.
 
 ### Embed modes {#embed-modes}
 
-Claude uses the single-frame transplant path by default. You can also force it in other hosts with `embedMode: "transplant"` or `frame: "transplant"` when debugging host module-loading behavior. You can force the nested diagnostic iframe with `embedMode: "iframe"`, `renderMode: "iframe"`, `nested: true`, or `frame: "iframe"`. If the iframe is blocked, `embedApp()` replaces it with an open-app fallback: the user can retry inline, open a freshly minted embed session through the host, or use the visible route URL. Keep the action's `link` target useful on its own because it is still the universal escape hatch.
+Claude uses the single-frame transplant path by default. You can also force it in other hosts with `embedMode: "transplant"` when debugging host module-loading behavior, or force the nested diagnostic iframe with `embedMode: "iframe"`. `embedMode` is the canonical option name; `renderMode`, `frame`, and `nested: true` (for the iframe case) are recognized aliases kept for compatibility — prefer `embedMode` in new code. If the iframe is blocked, `embedApp()` replaces it with an open-app fallback: the user can retry inline, open a freshly minted embed session through the host, or use the visible route URL. Keep the action's `link` target useful on its own because it is still the universal escape hatch.
 
 When testing Claude through ngrok, use a production build (`npx @agent-native/core@latest build` then `npx @agent-native/core@latest start`) or a deployed preview/production URL. Claude's single-frame transplant path works with production asset chunks; raw Vite dev modules such as `/app/root.tsx` can be protected by app auth and fail dynamic imports from the Claude resource origin.
 
@@ -249,7 +231,7 @@ Embedded routes can use `updateMcpAppModelContext()`, `openMcpAppHostLink()`, `r
 
 Display mode is best-effort. The in-app `McpAppRenderer` currently reports an inline web host context and an inline-only display mode; external hosts may honor larger display requests, ignore them, or reply with an unsupported-mode error. Always keep the inline route usable.
 
-## Client support and caching {#client-support}
+## Host support and caching {#client-support}
 
 The current official MCP Apps client list includes Claude, Claude Desktop, VS Code GitHub Copilot, Goose, Postman, MCPJam, ChatGPT, and Cursor; host support still varies by plan, release channel, and client version, so check the [MCP extension support matrix](https://modelcontextprotocol.io/extensions/client-matrix). ChatGPT custom MCP apps are available through developer mode for Business and Enterprise/Edu workspaces on ChatGPT web; see OpenAI's [developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-apps-in-chatgpt-beta) notes.
 
@@ -261,9 +243,9 @@ Claude and ChatGPT can cache tool and resource metadata for an existing custom c
 
 Test MCP Apps with the lightweight fixtures around `embedApp()` and `McpAppRenderer`; they cover CSP, host context, app launch, and bridge message behavior without needing a real external host. When validating ChatGPT or Claude web, trigger a fresh tool call after shell changes and measure the visible iframe. Previously rendered frames in the same conversation may still show cached height or launch behavior.
 
-## Related {#related}
+## What's next {#whats-next}
 
 - [External Agents](/docs/external-agents) — connecting Claude, ChatGPT, Codex, and Cursor to hosted apps; MCP Apps compatibility matrix; catalog tiers; deep links.
-- [MCP Protocol](/docs/mcp-protocol) — the auto-mounted MCP server, auth, tools, and `ask-agent`.
+- [MCP Server](/docs/mcp-protocol) — the auto-mounted MCP server, auth, tools, and `ask-agent`.
 - [Actions](/docs/actions) — `defineAction`, the `link` builder, `publicAgent`.
 - [Generative UI](/docs/generative-ui) — generated inline UI inside the app's own chat.