@agent-native/core 0.79.12 → 0.79.15

package/docs/content/locales/zh-TW/template-content.md

@@ -1,11 +1,11 @@
 ---
 title: "內容"
-description: "MDX 的開來源 Obsidian：編輯本機 Markdown/MDX 檔案，生成丰富的互動式自訂塊，並使用 AI 代理進行編寫。"
+description: "MDX 的開放原始碼 Obsidian：編輯本機 Markdown/MDX 檔案，生成豐富的互動式自訂塊，並使用 AI 代理進行編寫。"
 ---
 
 # 內容
 
-內容是 MDX 的開來源 Obsidian：本機檔案友好檔案
+內容是 MDX 的開放原始碼 Obsidian：本機檔案友好檔案
 代理可以在其中讀取、寫入、重新組織和發布頁面的工作空間
 你。開啟檔案，要求“重寫此段落以使其更加簡潔”或“建立一個
 名為第四季度規劃的頁面，其中包含目標、指標和風險的子頁面” - 相同
@@ -14,39 +14,39 @@ description: "MDX 的開來源 Obsidian：編輯本機 Markdown/MDX 檔案，生
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:grid;grid-template-columns:210px 1fr;gap:14px;padding:16px;min-height:500px;box-sizing:border-box'><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Content</strong><span class='wf-pill accent'>第三季度路線圖</span><span class='wf-pill'>Goals</span><span class='wf-pill'>Metrics</span><span class='wf-pill'>Risks</span><hr/><span class='wf-pill'>工程 wiki</span><span class='wf-pill'>閱讀清單</span><span class='wf-pill'>每週同步</span></aside><main style='display:flex;flex-direction:column;gap:12px;min-width:0;padding:8px 20px'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>第三季度路線圖</h1><div style='flex:1'></div><button>分享</button><button class='primary'>Publish</button></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:12px;padding:22px'><h2 style='margin:0'>發布目標</h2><p style='margin:0'>發布 onboarding 流程，縮短設定時間，並紀錄負責人交接。</p><div class='wf-box'>概覽 · 負責人、時間窗口、狀態</div><div class='wf-box'>主要目標</div><div class='wf-box'>工作流表</div></div></main></div>"
+  "html": "<div style='display:grid;grid-template-columns:210px 1fr;gap:14px;padding:16px;min-height:500px;box-sizing:border-box'><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Content</strong><span class='wf-pill accent'>第三季路線圖</span><span class='wf-pill'>Goals</span><span class='wf-pill'>Metrics</span><span class='wf-pill'>Risks</span><hr/><span class='wf-pill'>工程 wiki</span><span class='wf-pill'>閱讀清單</span><span class='wf-pill'>每週同步</span></aside><main style='display:flex;flex-direction:column;gap:12px;min-width:0;padding:8px 20px'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>第三季路線圖</h1><div style='flex:1'></div><button>分享</button><button class='primary'>Publish</button></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:12px;padding:22px'><h2 style='margin:0'>發布目標</h2><p style='margin:0'>發布 onboarding 流程，縮短設定時間，並紀錄負責人交接。</p><div class='wf-box'>概覽 · 負責人、時間視窗、狀態</div><div class='wf-box'>主要目標</div><div class='wf-box'>工作流表</div></div></main></div>"
 }
 ```
 
-當您開啟應用程式時，您將在編輯器旁邊看到一個頁面樹。代理始終知道您正在檢視哪個頁面以及您選取了哪些文本，因此檔案編輯可以保持在目前頁面。
+當您開啟應用程式時，您將在編輯器旁邊看到一個頁面樹。代理始終知道您正在檢視哪個頁面以及您選取了哪些文字，因此檔案編輯可以保持在目前頁面。
 
-```an-diagram title="一份檔案，多名編輯" summary="您和代理都通過相同的 Yjs 管道進行寫入。 SQL 是規範存儲；本機檔案和 Notion 是可選的同步表面。"
+```an-diagram title="一份檔案，多名編輯" summary="您和代理都透過相同的 Yjs 管道進行寫入。 SQL 是規範儲存；本機檔案和 Notion 是可選的同步表面。"
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">你輸入<br><small class=\"diagram-muted\">slash 選單、工具列</small></div><div class=\"diagram-node\">代理編輯<br><small class=\"diagram-muted\">edit-document find/replace</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Yjs CRDT</span><small class=\"diagram-muted\">實時、無衝突合並</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">documents (markdown)<br><small class=\"diagram-muted\">規範 SQL 存儲</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">本機 .md / .mdx<br><small class=\"diagram-muted\">/local-files</small></div><div class=\"diagram-box\">Notion 頁面<br><small class=\"diagram-muted\">拉取 · 推送</small></div></div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">你輸入<br><small class=\"diagram-muted\">slash 選單、工具列</small></div><div class=\"diagram-node\">代理編輯<br><small class=\"diagram-muted\">edit-document find/replace</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Yjs CRDT</span><small class=\"diagram-muted\">即時、無衝突合併</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">documents (markdown)<br><small class=\"diagram-muted\">規範 SQL 儲存</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">本機 .md / .mdx<br><small class=\"diagram-muted\">/local-files</small></div><div class=\"diagram-box\">Notion 頁面<br><small class=\"diagram-muted\">拉取 · 推送</small></div></div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
 
-## 你可以用它做什么
+## 你可以用它做什麼
 
-- **編寫包含標題、列表、表格、程式碼塊、圖片和連結的富文本**。斜線指令（`/`）插入塊；選取文本會快顯格式工具列。
+- **編寫包含標題、清單、表格、程式碼塊、圖片和連結的富文字**。斜線指令（`/`）插入塊；選取文字會快顯格式工具列。
 - **在樹中組織頁面** — 無限嵌套、拖動重新排序、釘選您經常使用的頁面。
-- **搜尋所有內容**，通過標題和內容進行全文搜尋。
-- **像 Obsidian 一樣編輯本機 Markdown/MDX 檔案。**使用 `/local-files` 視圖
+- **搜尋所有內容**，透過標題和內容進行全文搜尋。
+- **像 Obsidian 一樣編輯本機 Markdown/MDX 檔案。**使用 `/local-files` 檢視
   將工作區匯出到檔案，在您自己的工具中編輯它們，預覽
   更改，並將其匯入回來。在本機檔案模式下，內容直接寫入
   選定的 `.md` 或 `.mdx` 檔案。
-- **生成丰富的互動式自訂塊。**註冊本機React元件，
+- **生成豐富的互動式自訂塊。**註冊本機 React 元件，
   將它們插入為 MDX，並讓代理建立或更新元件檔案
   您的檔案。
 - **與 Notion 同步。** 將本機檔案連結到 Notion 頁面，並向任一方向拉取或推送內容。評論也可以雙向同步。
-- **實時協作。**多人（和代理）可以同時編輯同一份檔案。
+- **即時協作。**多人（和代理）可以同時編輯同一份檔案。
 - **與團隊成員共用檔案**或將其公開 - 預設情況下為私人，具有檢視者/編輯者/管理員角色。
 - **向代理詢問任何事情**：“重寫此段落。” “在頂部新增 TL;DR。” “找到我上週的所有會議紀錄。” “讓這個語氣更加正式。”
 
 ## 開始使用
 
-現場演示：[content.agent-native.com](https://content.agent-native.com)。
+線上示範：[content.agent-native.com](https://content.agent-native.com)。
 
 開啟應用程式後，點選側邊欄中的 **+ 新頁面**，為其指定標題，然後開始編寫。要使用代理，請在側邊欄中輸入：
 
@@ -54,41 +54,40 @@ description: "MDX 的開來源 Obsidian：編輯本機 Markdown/MDX 檔案，生
 - “重寫此段落以使其更加簡潔。” （開啟頁面）
 - “新增有關定價的部分，其中包含三個要點。”
 - “將此檔案總結為頂部的 TL;DR。”
-- “從 Notion 中提取最新版本。” （連結 Notion 頁面後）
+- “從 Notion 中擷取最新版本。” （連結 Notion 頁面後）
 
-選取文本並按 Cmd+I 以使代理聚焦於預載入的選取 — “使此內容更加有力”，然後對您突出顯示的內容進行操作。
+選取文字並按 Cmd+I 以使代理聚焦於預載入的選取 — “使此內容更加有力”，然後對您突出顯示的內容進行操作。
 
-## 本機Markdown/MDX檔案 {#local-files}
+## 本機 Markdown/MDX 檔案 {#local-files}
 
-內容可以通過本機檔案往返檔案，無需克隆或執行
+內容可以透過本機檔案往返檔案，無需克隆或執行
 本機內容應用程式。感覺就像 MDX 的黑曜石：檔案保持可檢查
-並且可編輯，同時該應用程式為您提供丰富的編輯器、代理 actions、共用和
-自訂塊。開啟`/local-files`，在瀏覽器或Agent中選取一個資料夾
-Native Desktop，並將目前檔案樹匯出為Markdown/MDX
-`content/`.
-
-每個匯出的檔案都包含檔案元資料的 frontmatter（`id`、`title`、
-`parentId`、`position`、釘選夾/搜尋/可見性標志和 `updatedAt`）加上
-檔案內文為Markdown。您可以在普通編輯器中編輯這些檔案，
+並且可編輯，同時該應用程式為您提供豐富的編輯器、代理 actions、共用和
+自訂塊。開啟 `/local-files`，在瀏覽器或 Agent Native Desktop 中選取一個資料夾，並將目前檔案樹匯出為 Markdown/MDX
+`content/`。
+
+每個匯出的檔案都包含檔案中繼資料的 frontmatter（`id`、`title`、
+`parentId`、`position`、釘選夾/搜尋/可見性標誌和 `updatedAt`）加上
+檔案內文為 Markdown。您可以在普通編輯器中編輯這些檔案，
 然後返回 `/local-files` 預覽並將更改匯入回內容中。
 
 當您想要來源程式碼管理中的內容、想要批處理時，此工作流程非常有用
 使用本機工具編輯檔案，或者希望為偏愛檔案的團隊提供非克隆路徑
 作為審查表面。託管應用程式仍然是共用的事實來源，
-評論、權限和實時協作；本機資料夾是顯式的
+評論、權限和即時協作；本機資料夾是顯式的
 同步表面。
 
 內容還可以在**本機檔案模式**下執行，其中檔案是內容的來源
-真相而不是SQL檔案。將 `agent-native.json` 新增到倉庫，設定
+真相而不是 SQL 檔案。將 `agent-native.json` 新增到倉庫，設定
 `mode: "local-files"`，並設定`docs/`、`blog/`等根，
 `content/` 和 `resources/`。然後標準內容編輯器填充其
 來自本機 `.md`/`.mdx` 檔案的左側邊欄，並將編輯寫回
-通過普通檔案actions選取檔案。將其用於回購優先檔案，
-由 MDX 驅動的博客、資源庫或黑曜石風格的個人內容
+透過普通檔案actions選取檔案。將其用於回購優先檔案，
+由 MDX 驅動的部落格、資源庫或黑曜石風格的個人內容
 元件；當您需要託管協作時切換回資料庫模式並且
-SQL 支持的共用。請參閱 [Local File Mode](/docs/local-file-mode)
+SQL 支援的共用。請參閱 [Local File Mode](/docs/local-file-mode)
 獨立儲存庫布局、設定、自訂 MDX 元件、本機
-`extensions/`小部件、安全正式環境指南。
+`extensions/`小工具、安全正式環境指南。
 
 要將內容本機檔案技能安裝到現有儲存庫中：
 
@@ -96,7 +95,7 @@ SQL 支持的共用。請參閱 [Local File Mode](/docs/local-file-mode)
 npx @agent-native/core@latest skills add content --mode local-files --scope project
 ```
 
-安裝程序會複製您的編碼代理的 `content` 技能並寫入或
+安裝程式會複製您的編碼代理的 `content` 技能並寫入或
 使用 `docs/`、`blog/`、`content/` 的內容根更新 `agent-native.json`
 和`resources/`。當本機內容應用、Agent Native 桌面或受信任
 本機網橋正在執行，代理應使用內容actions，例如
@@ -120,45 +119,45 @@ pnpm install
 pnpm dev
 ```
 
-開啟 `http://localhost:8083` 並建立您的第一個頁面。然後要求客服人員“建立一個名為 Onboarding 的頁面，並在其下新增三個子頁面”。
+開啟 `http://localhost:8083` 並建立您的第一個頁面。然後要求代理“建立一個名為 Onboarding 的頁面，並在其下新增三個子頁面”。
 
 ### 主要功能 {#key-features}
 
-**嵌套頁面。**檔案形成一個可拖動的樹，其中包含釘選夾、圖標、排序和頁面級共用。
+**嵌套頁面。**檔案形成一個可拖動的樹，其中包含釘選夾、圖示、排序和頁面級共用。
 
-**丰富的 MDX 編輯器。** Tiptap 支持標題、列表、表格、程式碼塊、圖片、連結、斜線指令、選取工具列和本機 React 元件。
+**豐富的 MDX 編輯器。** Tiptap 支援標題、清單、表格、程式碼塊、圖片、連結、斜線指令、選取工具列和本機 React 元件。
 
-**實時協作。** Yjs 使多個編輯者和代理編輯保持同步，而不會相互幹擾。
+**即時協作。** Yjs 使多個編輯者和代理編輯保持同步，而不會相互幹擾。
 
-**搜尋和評論。**全文搜尋、錨定評論、版本歷史紀錄和恢復流程內置於檔案介面中。
+**搜尋和評論。**全文搜尋、錨定評論、版本歷史紀錄和恢復流程內建於檔案介面中。
 
 **同步表面。**檔案可以與 Notion 或本機 Markdown/MDX 資料夾同步，其中 SQL 充當協作快取/歷史紀錄層。
 
 ### 本機檔案同步
 
 受保護的 `/local-files` 路由使用瀏覽器檔案系統存取 API，或
-保護Agent Native桌面內的本機資料夾橋，以進行讀寫
+保護 Agent Native 桌面內的本機資料夾橋，以進行讀寫
 使用者選取的資料夾中的 Markdown/MDX 檔案。連結資料夾後
 匯入後，選取的檔案被視為權限：開啟頁面讀取
 檔案，普通編輯器先儲存寫入檔案。 SQL 然後更新為
-現有檔案UI、搜尋和版本面板的快取/歷史層，不
+現有檔案 UI、搜尋和版本面板的快取/歷史層，不
 作為真相的來源。右上角頁面選單公開本機來源路徑：
 相對路徑始終可用，絕對路徑在真正的本機檔案中可用
-模式和 Agent Native 桌面，以及在 Finder 中顯示可通過
-桌面橋或伺服器支持的本機檔案模式。
+模式和 Agent Native 桌面，以及在 Finder 中顯示可透過
+桌面橋或伺服器支援的本機檔案模式。
 
-批量同步路由調用：
+批量同步路由呼叫：
 
 - `export-content-source` — 讀取可存取的檔案樹並返回
   確定性 `content/` 檔案包。
 - `import-content-source` - 驗證檔案，建立新的私人檔案，
-  更新調用者具有編輯存取權限的檔案，保留版本
+  更新呼叫者具有編輯存取權限的檔案，保留版本
   歷史紀錄，並拒絕無效的父週期。
 
 來源格式位於 `shared/content-source.ts`。將該檔案保留為
-檔案名、frontmatter、解析和序列化的單一合約。
+檔名、frontmatter、解析和序列化的單一合約。
 
-本機檔案工作區還可以通過
+本機檔案工作區還可以透過
 設定的`components`資料夾。內容開發伺服器匯入 PascalCase
 從這些檔案匯出，渲染匹配的 MDX 標籤，例如 `<ImpactCounter />`
 在編輯器內，並在本機元件下的斜線選單中公開它們。
@@ -192,8 +191,8 @@ export const ImpactCounterInputs = {
 };
 ```
 
-在本機MDX中使用它作為`<ImpactCounter />`，或者從編輯器斜杠插入
-本機元件下的選單。匯出輸入元資料時，選取
+在本機 MDX 中使用它作為`<ImpactCounter />`，或者從編輯器斜杠插入
+本機元件下的選單。匯出輸入中繼資料時，選取
 編輯器中的元件顯示一個角落編輯按鈕，用於重寫 MDX 屬性
 在本機檔案中。
 
@@ -208,7 +207,7 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
 
 ### 評論
 
-對帶有引用文本錨點、回複和解決狀態的檔案進行線程化評論。由 `document_comments` 桌子和 `app/components/editor/CommentsSidebar.tsx` 提供支持。 Actions：`list-comments`、`add-comment`。 Notion評論可以通過`sync-notion-comments`雙向同步。
+對帶有引用文字錨點、回覆和解決狀態的檔案進行對話串化評論。由 `document_comments` 桌子和 `app/components/editor/CommentsSidebar.tsx` 提供支援。 Actions：`list-comments`、`add-comment`。 Notion 評論可以透過`sync-notion-comments`雙向同步。
 
 ### 版本歷史
 
@@ -216,7 +215,7 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
 
 ### 分享和可見性
 
-預設情況下，檔案是私人的。您可以更改對 `org` 或 `public` 的可見性，或授予每個使用者和每個組織角色（`viewer`、`editor`、`admin`）。該框架的自動安裝共用 actions 開箱即用：
+預設情況下，檔案是私人的。您可以更改對 `org` 或 `public` 的可見性，或授予每個使用者和每個組織角色（`viewer`、`editor`、`admin`）。此框架的自動安裝共用 actions 開箱即用：
 
 - `share-resource --resourceType document --resourceId <id> --principalType user --principalId <email> --role editor`
 - `unshare-resource` / `list-resource-shares` / `set-resource-visibility`
@@ -231,17 +230,17 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
 
 由於代理會看到您目前的螢幕，因此大多數提示不需要您明確引用檔案。當您開啟一個頁面時，“this”表示該頁面。
 
-對於小型編輯，代理使用 `edit-document --find ... --replace ...`，因此只有更改的文本流經 Yjs — 您將看到差異應用到位，而不是整個頁面重新渲染。對於更大的重寫，它使用 `update-document --content ...`。
+對於小型編輯，代理使用 `edit-document --find ... --replace ...`，因此只有更改的文字流經 Yjs — 您將看到差異應用到位，而不是整個頁面重新渲染。對於更大的重寫，它使用 `update-document --content ...`。
 
-如果您選取文本並按 Cmd+I（或將焦點放在代理面板上），則選取內容將與您的下一條訊息一起作為上下文行動，因此“使此內容更加有力”會針對您突出顯示的內容進行操作。
+如果您選取文字並按 Cmd+I（或將焦點放在代理面板上），則選取內容將與您的下一條訊息一起作為脈絡行動，因此“使此內容更加有力”會針對您突出顯示的內容進行操作。
 
 ### 資料庫和屬性
 
-檔案可以託管內聯資料庫 - Notion 樣式的表，其中每一行本身就是一個檔案。代理可以通過 actions 建立資料庫、新增專案、設定列定義以及設定屬性值：`create-content-database`、`add-database-item`、`set-document-property`。屬性定義（型別、可見性、選項、位置）位於 `document_property_definitions` 中；每行值位於 `document_property_values` 中。
+檔案可以託管行內資料庫 - Notion 樣式的表，其中每一行本身就是一個檔案。代理可以透過 actions 建立資料庫、新增專案、設定列定義以及設定屬性值：`create-content-database`、`add-database-item`、`set-document-property`。屬性定義（型別、可見性、選項、位置）位於 `document_property_definitions` 中；每行值位於 `document_property_values` 中。
 
 ### 額外的actions
 
-除了資料模型中的 CRUD 表面之外，範本還提供了 `export-document` 用於將頁面轉換為 Markdown 或 HTML、`transcribe-media` 用於將腳本附加到頁面，以及 `restore-document-version` 用於回滾到較早的快照。
+除了資料模型中的 CRUD 表面之外，範本還提供了 `export-document` 用於將頁面轉換為 Markdown 或 HTML、`transcribe-media` 用於將指令碼附加到頁面，以及 `restore-document-version` 用於回滾到較早的快照。
 
 ### 資料模型
 
@@ -249,13 +248,13 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
 
 - **`documents`** — 頁面樹。列：`id`、`parent_id`、`title`、`content`（降價）、`icon`、`position`、`is_favorite`、`visibility`、`owner_email`、`org_id`、`created_at`、 `updated_at`。
 - **`document_versions`** — 版本歷史紀錄的標題和內容的完整快照。使用`restore-document-version`回滾。
-- **`document_comments`** — 帶有 `thread_id`、`parent_id`、`quoted_text`、`resolved` 的線程注釋以及用於雙向 Notion 同步的可選 `notion_comment_id`。
+- **`document_comments`** — 帶有 `thread_id`、`parent_id`、`quoted_text`、`resolved` 的對話串註解以及用於雙向 Notion 同步的可選 `notion_comment_id`。
 - **`document_sync_links`** — 每個 Notion 連結檔案一行跟蹤遠端頁面 ID、上次同步時間、衝突狀態、內容哈希和錯誤。
-- **`document_property_definitions`** — 內聯資料庫的列定義：名稱、型別、可見性、選項和位置。
-- **`content_databases`** — 附加到 `document_id` 的內聯資料庫物件，帶有標題和視圖設定 JSON。
-- **`content_database_items`** — 內聯資料庫中的行，每行將 `database_id` 連結到 `document_id`。
+- **`document_property_definitions`** — 行內資料庫的列定義：名稱、型別、可見性、選項和位置。
+- **`content_databases`** — 附加到 `document_id` 的行內資料庫物件，帶有標題和檢視設定 JSON。
+- **`content_database_items`** — 行內資料庫中的行，每行將 `database_id` 連結到 `document_id`。
 - **`document_property_values`** — 每個檔案的屬性值（`property_id` → `value_json`）。
-- **`document_shares`** — 通過 `createSharesTable` 建立的每使用者和每組織撥款。
+- **`document_shares`** — 透過 `createSharesTable` 建立的每使用者和每組織撥款。
 
 ```an-schema title="內容資料模型" summary="Nine tables in server/db/schema.ts. documents is the page tree; the rest hang off it for versions, comments, Notion sync, inline databases, and sharing."
 {
@@ -291,7 +290,7 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
     {
       "id": "document_comments",
       "name": "document_comments",
-      "note": "帶有引用文本錨的線索評論",
+      "note": "帶有引用文字錨的線索評論",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "document_id", "type": "id", "fk": "documents.id" },
@@ -317,7 +316,7 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
     {
       "id": "content_databases",
       "name": "content_databases",
-      "note": "附加到檔案的內聯資料庫物件",
+      "note": "附加到檔案的行內資料庫物件",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "document_id", "type": "id", "fk": "documents.id" },
@@ -338,7 +337,7 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
     {
       "id": "document_property_definitions",
       "name": "document_property_definitions",
-      "note": "內聯資料庫的列定義",
+      "note": "行內資料庫的列定義",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "name", "type": "string" },
@@ -383,20 +382,20 @@ The browser **Local files** picker can read and write `.md` and `.mdx` files on
 }
 ```
 
-內容以降價形式存儲。編輯器在內存中與 Tiptap JSON 模型進行相互轉換； SQL 行始終是降價的，因此 actions、搜尋和 Notion 同步可以在單一規範格式上執行。
+內容以降價形式儲存。編輯器在記憶中與 Tiptap JSON 模型進行相互轉換； SQL 行始終是降價的，因此 actions、搜尋和 Notion 同步可以在單一規範格式上執行。
 
-所有可擁有的表都包括通過 `ownableColumns()` 的 `owner_email` 和 `org_id`，因此從建立那一刻起，每一行的範圍都僅限於登入使用者（以及可選的活動組織）。
+所有可擁有的表都包括透過 `ownableColumns()` 的 `owner_email` 和 `org_id`，因此從建立那一刻起，每一行的範圍都僅限於登入使用者（以及可選的活動組織）。
 
 ### 自訂它
 
 改變行為時要注意的四個地方：
 
 - **`actions/`** — 代理或 UI 可以執行的每個操作。使用`defineAction`新增一個像`actions/publish-to-wordpress.ts`這樣的新檔案，雙方都可以免費獲得。現有actions主要：`create-document.ts`、`edit-document.ts`、`update-document.ts`、`delete-document.ts`、`list-documents.ts`、`search-documents.ts`、`get-document.ts`、`pull-notion-page.ts`、`push-notion-page.ts`、`add-comment.ts`、`view-screen.ts`、 `navigate.ts`。
-- **`app/routes/`** — 頁面表面。 `_app.tsx` 是無路徑布局，保持側邊欄和代理面板安裝； `_app._index.tsx`為落地視圖； `_app.page.$id.tsx`是編輯器路線； `_app.team.tsx`是團隊設定頁面。
+- **`app/routes/`** — 頁面表面。 `_app.tsx` 是無路徑布局，保持側邊欄和代理面板安裝； `_app._index.tsx`為落地檢視； `_app.page.$id.tsx`是編輯器路由； `_app.team.tsx`是團隊設定頁面。
 - **`app/components/editor/`** — Tiptap 編輯器。在`extensions/`下新增新的節點型別，並在`DocumentEditor.tsx`中註冊。氣泡工具列、斜杠選單和懸停預覽都是您可以編輯的元件檔案。
 - **`.agents/skills/`** — 代理在行動前閱讀的指南。如果您新增新功能（例如，CMS 發布管道），請將 `SKILL.md` 放入新技能資料夾中，以便代理正確使用它。現有skills：`document-editing`、`notion-integration`、`real-time-sync`、`delegate-to-agent`、`storing-data`、`self-modifying-code`、`security`、`frontend-design`、`create-skill`、`capture-learnings`。
 - **`AGENTS.md`** — 帶有操作備忘單和常見工作表的頂級代理指南。每當您新增主要功能時更新它，以便代理無需探索即可發現它。
-- **`server/db/schema.ts`** — 資料模型。此處新增列或表。內容範本沒有 `db:push` 腳本；它依賴於在啟動時執行的嚴格附加遷移。編輯 `server/db/schema.ts`，編寫匹配的附加遷移，並在下次應用啟動時應用更改 - 架構更新絕不能刪除、重命名或破壞性地更改現有表或列（有關準則，請參閱 [Database](/docs/database#migrations)）。
-- **`shared/notion-markdown.ts`** — 降價到 Notion 塊的轉換。如果您新增需要通過 Notion 往返的新塊型別，請擴充功能此功能。
+- **`server/db/schema.ts`** — 資料模型。此處新增列或表。內容範本沒有 `db:push` 指令碼；它依賴於在啟動時執行的嚴格附加遷移。編輯 `server/db/schema.ts`，編寫匹配的附加遷移，並在下次應用啟動時應用更改 - 架構更新絕不能刪除、重新命名或破壞性地更改現有表或列（有關準則，請參閱 [Database](/docs/database#migrations)）。
+- **`shared/notion-markdown.ts`** — 降價到 Notion 塊的轉換。如果您新增需要透過 Notion 往返的新塊型別，請擴充功能此功能。
 
 代理可以自行進行所有這些更改 - 要求它“向檔案新增標籤列並將其公開在側邊欄中”，它將更新架構、遷移、連線 UI 並編寫操作。

package/docs/content/locales/zh-TW/template-design.md

@@ -1,11 +1,11 @@
 ---
 title: "設計"
-description: "代理原生 HTML 原型工作室 — 使用代理生成、完善、預覽和匯出互動式 Alpine/Tailwind 設計。"
+description: "Agent-Native HTML 原型工作室 — 使用代理生成、完善、預覽和匯出互動式 Alpine/Tailwind 設計。"
 ---
 
 # 設計
 
-Design 是一家代理原生 HTML 原型工作室。該代理不是分層繪圖畫布，而是生成完整的獨立 Alpine/Tailwind HTML 原型，將它們渲染在 iframe 中，並允許您通過提示和調整控件來最佳化結果。
+Design 是一家 Agent-Native HTML 原型工作室。該代理不是分層繪圖畫布，而是產生完整的獨立 Alpine/Tailwind HTML 原型，將它們渲染在 iframe 中，並允許您透過提示和調整控制項來最佳化結果。
 
 ```an-wireframe
 {
@@ -14,7 +14,7 @@ Design 是一家代理原生 HTML 原型工作室。該代理不是分層繪圖
 }
 ```
 
-當您開啟應用程式時，生成的原型位於工作區的中心，預覽模式、提示修訂和匯出控件觸手可及。代理正式環境的所有東西都是真實的 HTML，您可以精煉、匯出或移交。
+當您開啟應用程式時，產生的原型位於工作區的中心，預覽模式、提示修訂和匯出控制項觸手可及。代理正式環境的所有東西都是真實的 HTML，您可以精煉、匯出或移交。
 
 ```an-diagram title="一件神器，無需翻譯" summary="代理生成獨立的 Alpine/Tailwind HTML； iframe、可編輯來源和每個匯出都讀取相同的檔案。連結的設計系統將權杖輸入到每個通道中。"
 {
@@ -25,29 +25,29 @@ Design 是一家代理原生 HTML 原型工作室。該代理不是分層繪圖
 
 ## 何時采摘
 
-- **您想要一個精美的登陸頁面概念、產品 UI 方向或品牌探索**，可以讓工具保持真實的 HTML — 而不是分層的畫布。
+- **您想要一個精美的到達頁面概念、產品 UI 方向或品牌探索**，可以讓工具保持真實的 HTML — 而不是分層的畫布。
 - **您需要一個可用的互動式原型**，具有 Alpine interactions 和 Tailwind 樣式，而不是靜態模型。
-- **您想要快速比較方向**，生成一些變體，選取最強的，然後不斷完善。
+- **您想要快速比較方向**，產生一些變體，選取最強的，然後不斷完善。
 - **您想要自己擁有的設計輸出** — 匯出 HTML、ZIP 或 PDF，或將原型交給編碼工具。
 
-## 你可以用它做什么
+## 你可以用它做什麼
 
-- **生成完整的原型。**描述您需要的螢幕或頁面，代理將建立一個具有 Tailwind 樣式和 Alpine interactions 的工作 HTML 檔案。
+- **產生完整的原型。**描述您需要的螢幕或頁面，代理將建立一個具有 Tailwind 樣式和 Alpine interactions 的工作 HTML 檔案。
 - **比較變體。**從多個方向開始，選取最強的一個，然後繼續完善。
-- **視覺上的調整。**使用內置的調整控件進行常見更改，或向代理詢問副本、布局、顏色、間距和互動更新。
-- **應用設計系統。**儲存並重用設計系統偏好設定，以便生成的作品更貼近您的品牌。
-- **匯入參考。**引入現有的 HTML 或參考材料作為新設計階段的上下文。
-- **匯出真實檔案。**從生成的原型中匯出 HTML、ZIP 或 PDF。
+- **視覺上的調整。**使用內建的調整控制項進行常見更改，或向代理詢問副本、布局、顏色、間距和互動更新。
+- **應用設計系統。**儲存並重用設計系統偏好設定，以便產生的作品更貼近您的品牌。
+- **匯入參考。**引入現有的 HTML 或參考材料作為新設計階段的脈絡。
+- **匯出真實檔案。**從產生的原型中匯出 HTML、ZIP 或 PDF。
 
 ## 開始使用
 
-現場演示：[design.agent-native.com](https://design.agent-native.com)。
+線上示範：[design.agent-native.com](https://design.agent-native.com)。
 
-1. **描述工件。**詢問螢幕、流程、登陸頁面或視覺效果
+1. **描述工件。**詢問螢幕、流程、到達頁面或視覺效果
    你想要的方向。包括受眾、基調和任何產品限制。
-2. **比較方向。**生成一些變體，選取最強的一個，然後
+2. **比較方向。**產生一些變體，選取最強的一個，然後
    不斷完善而不是重新開始。
-3. **調整細節。**使用調整控件進行常見的視覺變化，或詢問
+3. **調整細節。**使用調整控制項進行常見的視覺變化，或詢問
    布局、複製、回應式和互動更改的代理。
 4. **有用時匯出。**原型完成後下載 HTML、ZIP 或 PDF
    已準備好交給其他工具或隊友。
@@ -75,14 +75,14 @@ pnpm dev
 
 ### 資料模型
 
-所有資料通過 Drizzle ORM 存儲在 SQL 中。架構：`templates/design/server/db/schema.ts`。設計和設計系統采用標準 `ownableColumns` 和匹配的框架共用表，因此它們可以插入每使用者/每組織共用模型。
+所有資料透過 Drizzle ORM 儲存在 SQL 中。架構：`templates/design/server/db/schema.ts`。設計和設計系統采用標準 `ownableColumns` 和匹配的框架共用表，因此它們可以插入每使用者/每組織共用模型。
 
-| 表                                       | 它包含什么                                                                                                                       |
+| 表                                       | 它包含什麼                                                                                                                       |
 | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | 一個設計專案 - `title`、`description`、`project_type` (`prototype` / `other`)、`data` JSON Blob 和可選的 `design_system_id` 連結 |
 | `design_files`                           | 屬於某個設計的各個檔案（`filename`、`content`、`file_type` 預設為 `html`）                                                       |
 | `design_versions`                        | 具有可選 `label` 的設計的時間點 `snapshot`，用於歷史紀錄和回滾                                                                   |
-| `design_systems`                         | 可重複使用的品牌標記 - `data`（顏色/版式/間距）、`assets`、`custom_instructions` 和 `is_default` 標志                            |
+| `design_systems`                         | 可重複使用的品牌標記 - `data`（顏色/版式/間距）、`assets`、`custom_instructions` 和 `is_default` 標誌                            |
 | `design_shares` / `design_system_shares` | 框架共用將主體（使用者或組織）對應到角色（檢視者、編輯者、管理員）的表                                                           |
 
 ```an-schema title="設計資料模型" summary="設計擁有其檔案和版本化快照，並且可以選取連結可重用的設計系統。設計和系統都是可擁有的，每個都有一個框架共用表。"
@@ -133,26 +133,26 @@ pnpm dev
 }
 ```
 
-設計專案在包含內容之前是一個外殼：`create-design` 生成一個空行 (`data: "{}"`)，然後 `generate-design` 寫入實際的獨立 HTML/JSX 檔案。生成的工件、可編輯來源以及每個匯出都來自同一個 HTML，因此沒有單獨的“AI 模型”格式需要翻譯。連結設計系統提供代幣和 `custom_instructions`，代理在每一代傳遞中都會兌現這些代幣和 `custom_instructions`。
+設計專案在包含內容之前是一個外殼：`create-design` 產生一個空行 (`data: "{}"`)，然後 `generate-design` 寫入實際的獨立 HTML/JSX 檔案。產生的工件、可編輯來源以及每個匯出都來自同一個 HTML，因此沒有單獨的“AI 模型”格式需要翻譯。連結設計系統提供代幣和 `custom_instructions`，代理在每一代傳遞中都會兌現這些代幣和 `custom_instructions`。
 
-UI 中的路由位於 `templates/design/app/routes/` 下：`_index.tsx`（列表）、`design.$id.tsx`（編輯）、`present.$id.tsx`（演示）、`design-systems.tsx` 和 `design-systems_.setup.tsx`、`templates.tsx`、`examples.tsx`，以及 `settings.tsx` 和`team.tsx`。
+UI 中的路由位於 `templates/design/app/routes/` 下：`_index.tsx`（清單）、`design.$id.tsx`（編輯）、`present.$id.tsx`（示範）、`design-systems.tsx` 和 `design-systems_.setup.tsx`、`templates.tsx`、`examples.tsx`，以及 `settings.tsx` 和`team.tsx`。
 
 ### 金鑰actions
 
-每個代理可調用操作都是 `templates/design/actions/` 中的 TypeScript 檔案，自動安裝在 `POST /_agent-native/actions/:name` 上，並可作為 `pnpm action <name>` 從 CLI 執行。分組：
+每個代理可呼叫操作都是 `templates/design/actions/` 中的 TypeScript 檔案，自動安裝在 `POST /_agent-native/actions/:name` 上，並可作為 `pnpm action <name>` 從 CLI 執行。分組：
 
-- **設計** - `create-design`（空殼）、`generate-design`（寫入生成的 HTML/JSX 內容）、`update-design`、`get-design`、`list-designs`、`duplicate-design`、`delete-design` 和 `apply-tweaks` 用於持久儲存實時調整旋鈕值（強調色、密度等）。
+- **設計** - `create-design`（空殼）、`generate-design`（寫入產生的 HTML/JSX 內容）、`update-design`、`get-design`、`list-designs`、`duplicate-design`、`delete-design` 和 `apply-tweaks` 用於持久儲存即時調整旋鈕值（強調色、密度等）。
 - **檔案** - `create-file`、`update-file`、`list-files`、`delete-file` 用於設計專案內的檔案。
 - **設計系統** - `create-design-system`、`update-design-system`、`get-design-system`、`list-design-systems`、`delete-design-system`、`set-default-design-system` 和 `analyze-brand-assets` 用於在分析之前收集品牌資料。
 - **匯入** - `import-code`、`import-figma`、`import-github`、`import-from-url`、`import-document` (DOCX/PPTX/PDF/XLSX) 和 `import-design-project` 將設計系統從現有專案中提升出來。
 - **匯出和移交** - `export-html`、`export-pdf`、`export-svg`、`export-zip` 和 `export-coding-handoff` 將設計轉變為編碼工具移交。
-- **上下文和導覽** - `view-screen`（目前設計、開啟的檔案、視圖、待決問題或變體網格）、`get-design-snapshot`（外部代理繼續的目前狀態）和 `navigate`。
+- **脈絡和導覽** - `view-screen`（目前設計、開啟的檔案、檢視、待決問題或變體網格）、`get-design-snapshot`（外部代理繼續的目前狀態）和 `navigate`。
 
 ### 與代理合作
 
-代理始終知道您開啟了什么。目前設計、開啟的檔案、活動視圖以及任何待處理的問題或變體網格均由 `view-screen` 返回並注入到每條訊息中，因此您可以說“使此更密集”或“匯出此變體”，而無需命名設計。
+代理始終知道您開啟了什麼。目前設計、開啟的檔案、活動檢視以及任何待處理的問題或變體網格均由 `view-screen` 返回並注入到每條訊息中，因此您可以說“使此更密集”或“匯出此變體”，而無需命名設計。
 
-因為設計只是獨立的 HTML/JSX 檔案，所以代理編輯 iframe 渲染和每個匯出來自的相同來源 - 沒有單獨的“AI 模型”格式需要翻譯。連結設計系統提供代幣和代理在每一代通行證上兌現的 `custom_instructions`。在預覽中選取文本或區域，然後按 Cmd+I 將代理集中在該部分上。
+因為設計只是獨立的 HTML/JSX 檔案，所以代理編輯 iframe 渲染和每個匯出來自的相同來源 - 沒有單獨的“AI 模型”格式需要翻譯。連結設計系統提供代幣和代理在每一代通行證上兌現的 `custom_instructions`。在預覽中選取文字或區域，然後按 Cmd+I 將代理集中在該部分上。
 
 ### 自訂它
 
@@ -160,14 +160,14 @@ UI 中的路由位於 `templates/design/app/routes/` 下：`_index.tsx`（列表
 
 - “使用我們的權杖和範例元件新增可重用的電子商務設計系統。”
 - “新增一個匯出步驟，將 ZIP 上傳到我們的內部審核系統。”
-- “讓我貼上現有的登陸頁面 HTML 並向代理詢問三個更強的版本。”
+- “讓我貼上現有的到達頁面 HTML 並向代理詢問三個更強的版本。”
 - “為產品頁面、儀表板和入門螢幕簡介新增已儲存的提示庫。”
 - “新增自訂 PDF 匯出預設以供利益相關者審核。”
 
-代理根據需要編輯路線、元件、actions 和 SQL 支持的模型。請參閱 [Templates](/docs/cloneable-saas) 了解完整克隆、自訂、部署流程，如果這是您的第一個代理本機範本，請參閱 [Getting Started](/docs/getting-started)。
+代理根據需要編輯路由、元件、actions 和 SQL 支援的模型。請參閱 [Templates](/docs/cloneable-saas) 了解完整克隆、自訂、部署流程，如果這是您的第一個 Agent-Native 範本，請參閱 [Getting Started](/docs/getting-started)。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Templates**](/docs/cloneable-saas) — 克隆自有模型
 - [**Context Awareness**](/docs/context-awareness) — 代理如何知道使用者正在檢視的內容
-- [**Creating Templates**](/docs/creating-templates) — 代理原生範本的目前建置模式
+- [**Creating Templates**](/docs/creating-templates) — Agent-Native 範本的目前建置模式