@agent-native/core 0.79.12 → 0.79.15

package/docs/content/locales/zh-TW/plan-plugin.md

@@ -7,39 +7,39 @@ description: "安裝 Agent-Native 計畫 skills（/visual-plan、/visual-recap
 
 Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一次安裝即可新增計畫斜線指令 skills **並**連線託管計畫 MCP 連線器，以便代理可以生成計畫，並且 skills 可以將它們直接發布到計畫應用程式中。
 
-## 你得到什么 {#what-you-get}
+## 你得到什麼 {#what-you-get}
 
 一次安裝即可為您提供：
 
 - **兩個 skills** — `/visual-plan`（規範入口點）和 `/visual-recap`。
 - **計畫 MCP 連線器** — 針對 `https://plan.agent-native.com` 上的託管應用程式進行註冊（MCP 端點 `https://plan.agent-native.com/_agent-native/mcp`，伺服器名稱 `plan`）。
 
-```an-diagram title="三條路線，一攬子" summary="通用 CLI、Claude Code 外掛和 Codex 外掛都安裝相同的兩個技能以及託管計畫連線器。"
+```an-diagram title="三條路由，一攬子" summary="通用 CLI、Claude Code 外掛和 Codex 外掛都安裝相同的兩個技能以及託管計畫連線器。"
 {
   "html": "<div class=\"diagram-routes\"><div class=\"diagram-col\"><div class=\"diagram-node\">Universal CLI<br><small class=\"diagram-muted\">skills add visual-plan</small></div><div class=\"diagram-node\">Claude Code 外掛<br><small class=\"diagram-muted\">/plugin install</small></div><div class=\"diagram-node\">Codex 外掛<br><small class=\"diagram-muted\">codex plugin add</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">/visual-plan</span><span class=\"diagram-pill accent\">/visual-recap</span><small class=\"diagram-muted\">two skills</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Plan MCP connector<br><small class=\"diagram-muted\">plan.agent-native.com/_agent-native/mcp</small></div></div>",
   "css": ".diagram-routes{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-routes .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-routes .diagram-arrow{font-size:22px;line-height:1}.diagram-routes .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-routes .center .diagram-pill{margin:2px}"
 }
 ```
 
-預設情況下，skills 都會發布到託管的計畫應用 - 他們通過
-MCP 連線器並向您提供連結或內聯計畫以供審核。他們從不傾倒
+預設情況下，skills 都會發布到託管的計畫應用 - 他們透過
+MCP 連線器並向您提供連結或行內計畫以供審核。他們從不傾倒
 內嵌 Markdown/ASCII 計畫作為可交付成果放入聊天中。如果計畫工具
 返回`needs auth`、`Unauthorized`或`Session terminated`，重新驗證
-連線器而不是退回到內聯輸出。存取權杖是
-壽命長（預設30天，滑動365天刷新），所以這種情況應該很少見；
-當發生這種情況時，輕量級修複是：
+連線器而不是退回到行內輸出。存取權杖是
+壽命長（預設30天，滑動365天重新整理），所以這種情況應該很少見；
+當發生這種情況時，輕量級修復是：
 
 ```bash
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect`通過URL為選定的本機查找並刷新連線器
-用戶端 — 無需重新安裝。重新連線後啟動一個新的Codex線程，這樣
+`reconnect`透過 URL 為選定的本機尋找並重新整理連線器
+用戶端 — 無需重新安裝。重新連線後啟動一個新的Codex對話串，這樣
 工具註冊表重新載入。在 Claude 程式碼中，相當於 `/mcp` →
 **驗證/重新連線**，或與 `--client claude-code` 相同的指令。
 
 例外是明確的**本機檔案隱私模式**。當你要求沒有資料庫時
-寫入或設定`AGENT_NATIVE_PLANS_MODE=local-files`，skills不得調用
+寫入或設定`AGENT_NATIVE_PLANS_MODE=local-files`，skills不得呼叫
 MCP 計畫連線器。他們寫 `plans/<slug>/plan.mdx` 加上可選
 `canvas.mdx`、`prototype.mdx` 和 `.plan-state.json`，然後使用以下指令進行本機預覽：
 
@@ -60,8 +60,8 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
   網路），因此頁面掛在“載入計畫”上。已在 macOS `--open` 上
   更喜歡 Chrome/Chromium/Edge/Brave；如果 Safari 仍然開啟，請重新開啟列印的
   Chromium 瀏覽器中的 URL。
-- **服務的URL被寫入`plans/<slug>/.plan-url`**（用
-  `--url-file`)。後台或無頭代理可以讀取該檔案，而不是
+- **服務的 URL 被寫入`plans/<slug>/.plan-url`**（用
+  `--url-file`)。背景或無頭代理可以讀取該檔案，而不是
   抓取長時間執行的 `serve` 標準輸出。將其視為本機權杖檔案並且
   不要提交。
 - **當沒有可用瀏覽器時進行無頭驗證**：
@@ -71,7 +71,7 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
 - **首先執行 `plan local check`。**它根據計畫驗證 MDX
   渲染器的塊架構（包括 `checklist` 專案等必填欄位
   `id`/`label` 和 `question-form` 問題 `id`/`title`/`mode`)，因此創作
-  錯誤在瀏覽器切換之前出現，而不是作為載入程序卡住。
+  錯誤在瀏覽器切換之前出現，而不是作為載入程式卡住。
 
 對於目前儲存庫中的資料夾，直接本機路由包括 `?path=...`，因此
 本機計畫應用程式可以將瀏覽器編輯儲存到儲存庫資料夾中。計畫
@@ -82,7 +82,7 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
 除非您明確表示，評論、螢幕截圖和計畫歷史紀錄均不可用
 稍後發布。
 
-```an-diagram title="託管模式與本機檔案模式" summary="預設情況下技能通過連線器發布；本機檔案模式將 MDX 寫入磁盤並通過本機主機橋進行預覽。"
+```an-diagram title="託管模式與本機檔案模式" summary="預設情況下技能透過連線器發布；本機檔案模式將 MDX 寫入磁盤並透過本機主機橋進行預覽。"
 {
   "html": "<div class=\"diagram-modes\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">預設 · 託管</span><strong>發布到 Plan 應用</strong><small class=\"diagram-muted\">MCP connector &rarr; hosted DB &rarr; share links, comments, history, screenshots</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">本機檔案隱私</span><strong>將 MDX 寫入磁盤</strong><small class=\"diagram-muted\">plan.mdx + canvas.mdx + prototype.mdx &rarr; localhost bridge &rarr; hosted Plan UI reads local source. No 資料庫寫入s until <code>publish-visual-plan</code>.</small></div></div>",
   "css": ".diagram-modes{display:flex;gap:14px;flex-wrap:wrap}.diagram-modes .diagram-card{flex:1 1 260px;display:flex;flex-direction:column;gap:6px;padding:16px 18px}"
@@ -95,21 +95,21 @@ Agent Native 桌面有一個單獨的託管計畫本機檔案同步路徑：
 計畫資料庫作為事實來源；當目標達到時使用本機檔案隱私模式
 沒有計畫資料庫寫入。
 
-> 外掛（`agent-native-visual-plans`）帶有app id `visual-plans`，這就是為什么Claude程式碼外掛名稱和Codex外掛名稱都是`agent-native-visual-plans`。計畫應用的顯示名稱為“Agent-Native 計畫”。
+> 外掛（`agent-native-visual-plans`）帶有app id `visual-plans`，這就是為什麼 Claude 程式碼外掛名稱和Codex外掛名稱都是`agent-native-visual-plans`。計畫應用的顯示名稱為“Agent-Native 計畫”。
 
 ## 安裝路由 {#install}
 
 有三種方式。**通用 CLI 路由**是我們預設推薦的一種，因為它安裝 skills **並且**允許您在一個流程中選取託管、本機檔案或自託管模式。外掛路由適用於具有一流外掛/市場系統的主機，並預設使用託管計畫。
 
-### 通用技能路線（任意MCP主機） {#universal}
+### 通用技能路由（任意 MCP 主機） {#universal}
 
-適用於任何主機 - Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP 應用程式、Claude Cowork 以及任何其他與 MCP 兼容的內容。 Agent-Native CLI 安裝 skills，註冊託管計畫 MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此您的第一個工具調用不會遇到 OAuth 牆：
+適用於任何主機 - Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP 應用程式、Claude Cowork 以及任何其他與 MCP 相容的內容。 Agent-Native CLI 安裝 skills，註冊託管計畫 MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此您的第一個工具呼叫不會遇到 OAuth 牆：
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-這將安裝 `visual-plan` 以及配套的 `visual-recap` 技能，然後註冊 `plan` 連線器，然後執行驗證（OAuth 提示託管/帳戶支持的共用）。有用的標志：
+這將安裝 `visual-plan` 以及配套的 `visual-recap` 技能，然後註冊 `plan` 連線器，然後執行驗證（OAuth 提示託管/帳戶支援的共用）。有用的標誌：
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — 為其編寫 MCP 設定的本機代理（預設 `all`）。
 - `--no-connect` — 註冊連線器而不進行驗證；稍後執行 `npx @agent-native/core@latest connect https://plan.agent-native.com --client all`，或者選取更窄的 `--client`。
@@ -134,7 +134,7 @@ npx @agent-native/core@latest recap doctor
 
 > 注意：裸機 `npx skills@latest add BuilderIO/agent-native --skill visual-plan`（Vercel/open Skills CLI）安裝**僅說明** - 它不註冊 MCP 連線器。當您也想連線連線器時，請使用上面的 Agent-Native CLI。
 
-### Claude程式碼（外掛） {#claude-code}
+### Claude 程式碼（外掛） {#claude-code}
 
 公開 `BuilderIO/agent-native` 儲存庫本身就是一個 Claude 程式碼外掛市場，因此您可以直接新增它 - 無需建置步驟。 Claude 內部程式碼：
 
@@ -145,7 +145,7 @@ npx @agent-native/core@latest recap doctor
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` 新增了計畫 skills 和 **僅 URL** MCP 設定（包中沒有秘密）； `/mcp`→**驗證**完成OAuth握手。當您需要本機檔案或自託管模式時，請使用通用 CLI 路由。
+`/plugin install` 新增了計畫 skills 和 **僅 URL** MCP 設定（包中沒有秘密）； `/mcp`→**驗證**完成 OAuth 握手。當您需要本機檔案或自託管模式時，請使用通用 CLI 路由。
 
 > 市場目錄名為 `agent-native-apps`，計畫外掛為 `agent-native-visual-plans`，因此安裝目標始終為 `agent-native-visual-plans@agent-native-apps`。
 
@@ -159,42 +159,42 @@ codex plugin add agent-native-visual-plans@agent-native-apps
 codex mcp login plan   # 瀏覽器中的 OAuth
 ```
 
-安裝後，**啟動新的 Codex 線程**，以便 skills 和 MCP 工具載入到工作階段中。該外掛附帶一個僅限 URL 的連線器（`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`）； `codex mcp login plan` 執行 OAuth 流程。如果您更喜歡使用一個指令來同時安裝和驗證，或者需要本機檔案或自託管模式，則上面的通用 CLI 路由也適用於 Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`)。
+安裝後，**啟動新的 Codex 對話串**，以便 skills 和 MCP 工具載入到工作階段中。該外掛附帶一個僅限 URL 的連線器（`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`）； `codex mcp login plan` 執行 OAuth 流程。如果您更喜歡使用一個指令來同時安裝和驗證，或者需要本機檔案或自託管模式，則上面的通用 CLI 路由也適用於 Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`)。
 
-> **較舊的安裝：**如果您的設定仍然有一個 `agent-native-plans` 條目指向相同的 URL，為 Codex 執行 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`，或者與您的目標 `--client` 執行相同的指令，則將其合並為規範的 `plan` 名稱。
+> **較舊的安裝：**如果您的設定仍然有一個 `agent-native-plans` 條目指向相同的 URL，為 Codex 執行 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`，或者與您的目標 `--client` 執行相同的指令，則將其合併為規範的 `plan` 名稱。
 
 ## 更新 {#updates}
 
 外掛路由自動更新 - 您無需重新打包或重新新增市場來進行日常技能更改：
 
-- **Claude Code** - 市場條目設定 `autoUpdate: true` 並且外掛使用 commit-SHA 版本控制，因此 Claude Code 在啟動時從儲存庫中提取新版本；執行`/reload-plugins`來激活。每次對儲存庫預設分支的推送都會自動到達已安裝的使用者。
-- **Codex** — 外掛 `version` 嵌入了捆綁的 skills 和 MCP 端點（例如 `1.0.0+codex.<hash>`）的內容哈希，因此任何技能或端點更改都會產生新版本。 Codex的啟動自動升級會自行重新安裝設定的git市場；只需**啟動一個新線程**即可獲取更改。日常更新無需手動`codex plugin marketplace upgrade`。
-- **通用 CLI 路線** — 執行 `npx @agent-native/core@latest skills status visual-plan` 來檢查複製的技能資料夾，或執行 `npx @agent-native/core@latest skills update visual-plan` 來刷新它們。當您還想重新註冊/驗證連線器時，重新執行 `skills add visual-plan` 仍然有效。 `@latest` 始終從已發布的 `@agent-native/core` 包中提取目前的 skills。
+- **Claude Code** - 市場條目設定 `autoUpdate: true` 並且外掛使用 commit-SHA 版本控制，因此 Claude Code 在啟動時從儲存庫中擷取新版本；執行`/reload-plugins`來啟用。每次對儲存庫預設分支的推送都會自動到達已安裝的使用者。
+- **Codex** — 外掛 `version` 嵌入了捆綁的 skills 和 MCP 端點（例如 `1.0.0+codex.<hash>`）的內容哈希，因此任何技能或端點更改都會產生新版本。 Codex的啟動自動升級會自行重新安裝設定的git市場；只需**啟動一個新對話串**即可取得更改。日常更新無需手動`codex plugin marketplace upgrade`。
+- **通用 CLI 路由** — 執行 `npx @agent-native/core@latest skills status visual-plan` 來檢查複製的技能資料夾，或執行 `npx @agent-native/core@latest skills update visual-plan` 來重新整理它們。當您還想重新註冊/驗證連線器時，重新執行 `skills add visual-plan` 仍然有效。 `@latest` 始終從已發布的 `@agent-native/core` 包中擷取目前的 skills。
 
-連線器指向**託管**應用程式，因此計畫應用程式的 actions 和實時工具表面始終反映已部署的版本，無論您何時安裝；只有捆綁的技能說明遵循上述更新機制。
+連線器指向**託管**應用程式，因此計畫應用程式的 actions 和即時工具表面始終反映已部署的版本，無論您何時安裝；只有捆綁的技能說明遵循上述更新機制。
 
-> **維護者：** 市場捆綁包（`.claude-plugin/`、`.agents/plugins/`）是由 `pnpm sync:plan-marketplace` 根據規範計畫 skills 生成的，並由 `pnpm guard:plan-marketplace` 在 CI 中進行驗證，因此發布的市場始終與規範 skills 匹配。編輯技能，執行`pnpm sync:plan-marketplace`，然後提交。
+> **維護者：** 市場捆綁包（`.claude-plugin/`、`.agents/plugins/`）是由 `pnpm sync:plan-marketplace` 根據規範計畫 skills 產生的，並由 `pnpm guard:plan-marketplace` 在 CI 中進行驗證，因此發布的市場始終與規範 skills 匹配。編輯技能，執行`pnpm sync:plan-marketplace`，然後提交。
 
-## 您需要提交什么嗎？ {#submission}
+## 您需要提交什麼嗎？ {#submission}
 
-**分發或安裝此程序不需要提交或審核。** `BuilderIO/agent-native` 是一個自託管的公開 git 市場，因此使用者可以使用上面的指令直接在 **Claude 程式碼和 Codex** 上新增它 - 無需申請或批準。通用 CLI 路線根本不需要市場。
+**分發或安裝此程式不需要提交或審核。** `BuilderIO/agent-native` 是一個自託管的公開 git 市場，因此使用者可以使用上面的指令直接在 **Claude 程式碼和 Codex** 上新增它 - 無需申請或核准。通用 CLI 路由根本不需要市場。
 
-如果您想要公開列表，可選的可發現性：
+如果您想要公開清單，可選的可發現性：
 
-- **Claude 程式碼**有一個社區市場，您可以*可選*提交到列表（提交加上自動審核）。 Anthropic 管理的官方市場由 Anthropic 自行決定列出 — 沒有開放的自助應用程式。兩者都不需要使用上面的安裝指令。
-- **Codex** 有一個 OpenAI 策劃的外掛目錄（一個封閉的允許列表，作為合作伙伴而不是自助提交）。自託管 git 市場和 CLI 路線無需提交即可工作。
+- **Claude 程式碼**有一個社群市場，您可以*可選*提交到清單（提交加上自動審核）。 Anthropic 管理的官方市場由 Anthropic 自行決定列出 — 沒有開放的自助應用程式。兩者都不需要使用上面的安裝指令。
+- **Codex** 有一個 OpenAI 策劃的外掛目錄（一個封閉的允許清單，作為合作伙伴而不是自助提交）。自託管 git 市場和 CLI 路由無需提交即可工作。
 
 簡而言之：將其作為自託管/公開 git 市場發布，使用者直接安裝；僅當您希望將其列出以供發現時才提交到精選目錄。
 
 ## 外掛與技能 {#plugin-vs-skill}
 
-**技能**是代理在工作匹配時讀取的單個 `SKILL.md` 指令檔案。 **外掛**（Claude 程式碼市場外掛或 Codex 外掛）是一個捆綁一個或多個 skills **加上** MCP 連線器和元資料的軟件包，因此主機可以一步安裝所有內容。
+**技能**是代理在工作匹配時讀取的單一 `SKILL.md` 指令檔案。 **外掛**（Claude 程式碼市場外掛或 Codex 外掛）是一個捆綁一個或多個 skills **加上** MCP 連線器和中繼資料的套件，因此主機可以一步安裝所有內容。
 
-在底層，所有三個路由均由 `npx @agent-native/core@latest app-skill` CLI 從同一來源生成：`app-skill pack` 建置市場/外掛適配器，而 `skills add` 是友好的一步安裝程序，還可以註冊和驗證 MCP 連線器。請參閱 [Skills Guide](/docs/skills-guide) 了解應用程式技能清單格式，並參閱 [External Agents](/docs/external-agents) 了解連線任何 MCP 主機和 `npx @agent-native/core@latest connect` 流。
+在底層，所有三個路由均由 `npx @agent-native/core@latest app-skill` CLI 從同一來源生成：`app-skill pack` 建置市場/外掛轉接器，而 `skills add` 是友好的一步安裝程式，還可以註冊和驗證 MCP 連線器。請參閱 [Skills Guide](/docs/skills-guide) 了解應用程式技能清單格式，並參閱 [External Agents](/docs/external-agents) 了解連線任何 MCP 主機和 `npx @agent-native/core@latest connect` 流。
 
-## 下一步是什么 {#whats-next}
+## 下一步是什麼 {#whats-next}
 
 - [**Visual Plans**](/docs/template-plan) — skills 的用途以及如何使用它們
-- [**PR Visual Recap**](/docs/pr-visual-recap) - 在每個拉取請求上自動執行 `/visual-recap`
-- [**Skills Guide**](/docs/skills-guide) - 應用程式支持的 skills 和清單格式
+- [**PR Visual Recap**](/docs/pr-visual-recap) - 在每個 pull request 上自動執行 `/visual-recap`
+- [**Skills Guide**](/docs/skills-guide) - 應用程式支援的 skills 和清單格式
 - [**External Agents**](/docs/external-agents) — 連線任何 MCP 主機和往返工件

package/docs/content/locales/zh-TW/pr-visual-recap.md

@@ -1,15 +1,15 @@
 ---
-title: "公關視覺回顧"
-description: "GitHub 操作，在每個 PR 上執行儲存庫的視覺回顧技能。 LLM 編碼代理讀取差異，發布互動式回顧計畫，顯示資訊檢查，並發布帶有內聯螢幕截圖的粘性 PR 評論。資訊性和非阻塞。"
+title: "PR 視覺回顧"
+description: "GitHub 操作，在每個 PR 上執行儲存庫的視覺回顧技能。 LLM 編碼代理讀取差異，發布互動式回顧計畫，顯示資訊檢查，並發布帶有行內螢幕截圖的置頂 PR 評論。資訊性和非阻塞。"
 ---
 
-# 公關視覺回顧
+# PR 視覺回顧
 
-PR Visual Recap 是一個 GitHub 操作，它將每個拉取請求轉變為**可視化程式碼審查**。每次推送時，LLM 編碼代理都會根據 PR 差異執行最新的捆綁 [`visual-recap`](/docs/template-plan) 技能（或者 `VISUAL_RECAP_SKILL_SOURCE=repo` 時您的儲存庫的提交副本），向託管計畫應用程式發布結構化回顧計畫，在執行時顯示資訊性 `Visual Recap` 檢查，並更新插入**一條粘性 PR 評論**，該評論連結到互動式計畫，並在評論中嵌入**內聯螢幕截圖**。
+PR Visual Recap 是一個 GitHub 操作，它將每個 pull request 轉變為**視覺化程式碼審查**。每次推送時，LLM 編碼代理都會根據 PR 差異執行最新的捆綁 [`visual-recap`](/docs/template-plan) 技能（或者 `VISUAL_RECAP_SKILL_SOURCE=repo` 時您的儲存庫的提交副本），向託管計畫應用程式發布結構化回顧計畫，在執行時顯示資訊性 `Visual Recap` 檢查，並更新插入**一條置頂 PR 評論**，該評論連結到互動式計畫，並在評論中嵌入**行內螢幕截圖**。
 
-這不是確定性差異渲染器。該操作調用真正的編碼代理（預設情況下為 Claude 程式碼 CLI，或 OpenAI Codex CLI），該代理讀取更改，決定重要內容，並通過調用計畫 MCP 工具 `create-visual-recap`（與 `/visual-recap` 斜線指令使用的工具相同）來編寫概要。您將獲得變化的高空模式/API/前後視圖，而不是原始差異牆。
+這不是確定性差異渲染器。該操作呼叫真正的編碼代理（預設情況下為 Claude 程式碼 CLI，或 OpenAI Codex CLI），該代理讀取更改，決定重要內容，並透過呼叫計畫 MCP 工具 `create-visual-recap`（與 `/visual-recap` 斜線指令使用的工具相同）來編寫概要。您將獲得變化的高空模式/API/前後檢視，而不是原始差異牆。
 
-回顧是**資訊性且非阻塞**。它建立一個檢查行，以便審閱者可以看到生成正在進行中，但這不是必需的檢查，它永遠不會阻止 PR，也永遠不會取代讀取實際的差異。粘性評論是一種審閱輔助工具，而不是簽字。
+回顧是**資訊性且非阻塞**。它建立一個檢查行，以便審閱者可以看到生成正在進行中，但這不是必需的檢查，它永遠不會阻止 PR，也永遠不會取代讀取實際的差異。置頂評論是一種審閱輔助工具，而不是簽字。
 
 ## 它的作用
 
@@ -17,46 +17,46 @@ PR Visual Recap 是一個 GitHub 操作，它將每個拉取請求轉變為**可
 
 1. 收集 PR 基礎和頭部之間的有界差異。
 2. 使用 `Visual recap in progress` 建立資訊性 `Visual Recap` GitHub 檢查。
-3. 針對該差異執行設定的編碼代理。代理會讀取捆綁的 `visual-recap` 技能指南（或您的儲存庫固定副本）並撰寫回顧，並通過 `create-visual-recap` 發布。
+3. 針對該差異執行設定的編碼代理。代理會讀取捆綁的 `visual-recap` 技能指南（或您的儲存庫固定副本）並撰寫回顧，並透過 `create-visual-recap` 發布。
 4. 讀取代理寫給 `recap-url.txt` 的已發布計畫 URL。
 5. 在無頭 Chrome 中開啟 URL 並截取明暗模式下渲染的平面圖。
-6. 將 PNG 上傳到“計畫”應用上已簽名的公開圖片路線。
-7. 在互動式回顧的連結旁邊插入一條粘性公關評論，將螢幕截圖**內聯**嵌入到 `<picture>` 元素（通過 GitHub 的迷彩圖片代理提供）。
+6. 將 PNG 上傳到“計畫”應用上已簽名的公開圖片路由。
+7. 在互動式回顧的連結旁邊插入一條置頂 PR 評論，將螢幕截圖**行內**嵌入到 `<picture>` 元素（透過 GitHub 的camo 圖片代理提供）。
 8. 以成功、跳過或中立的方式完成 `Visual Recap` 檢查。
 
-```an-diagram title="每次 PR 推送都會發生什么" summary="有界差異為真正的編碼代理提供資訊，該代理編寫了回顧；工作流程會對其進行螢幕截圖並插入一條粘性評論。"
+```an-diagram title="每次 PR 推送都會發生什麼" summary="有界差異為真正的編碼代理提供資訊，該代理編寫了回顧；工作流程會對其進行螢幕截圖並插入一條置頂評論。"
 {
   "html": "<div class=\"diagram-recap\"><div class=\"diagram-node\">PR 推送<br><small class=\"diagram-muted\">bounded base&hellip;head diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">編碼 Agent<br><small class=\"diagram-muted\">Claude Code / Codex 讀取 diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-visual-recap</span><small class=\"diagram-muted\">publishes recap plan</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">無頭 Chrome<br><small class=\"diagram-muted\">light + dark screenshots</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">一條置頂 PR 評論<br><small class=\"diagram-muted\">inline screenshot + plan link</small></div></div><div class=\"diagram-foot diagram-muted\">Plus an informational <span class=\"diagram-pill\">Visual Recap</span> check &mdash; non-blocking, never required.</div>",
   "css": ".diagram-recap{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-recap .diagram-arrow{font-size:20px;line-height:1}.diagram-recap .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-recap .diagram-foot{flex-basis:100%;margin-top:10px;font-size:13px}"
 }
 ```
 
-重新推送會更新相同的計畫和相同的粘性評論 - 沒有孤立的計畫，沒有垃圾評論。
+重新推送會更新相同的計畫和相同的置頂評論 - 沒有孤立的計畫，沒有垃圾評論。
 
 ## 安裝
 
 互動安裝套餐時，Agent-Native CLI 詢問是否新增
-自動公關視覺回顧。同意寫入 GitHub 操作，或新增它
+自動 PR 視覺回顧。同意寫入 GitHub 操作，或新增它
 隨時明確：
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-這將安裝 `visual-plan` 技能（其中包括操作執行的 `visual-recap` 技能）並將 `.github/workflows/pr-visual-recap.yml` 寫入您的儲存庫。工作流程通過 `npx @agent-native/core@latest recap <subcommand>` 調用**發布的 CLI 子指令** — 包括 `gate`、`collect-diff`、`block-reference`、`scan`、`build-prompt`、`publish`、`shot`、`comment`、`check` 和`usage` - 因此沒有任何內容作為幫助程序腳本複製到您的儲存庫中。 `setup`和`doctor`是您本機執行的互動式助手； `gate` 是工作流程在每次回顧之前執行的安全門步驟。
+這將安裝 `visual-plan` 技能（其中包括操作執行的 `visual-recap` 技能）並將 `.github/workflows/pr-visual-recap.yml` 寫入您的儲存庫。工作流程透過 `npx @agent-native/core@latest recap <subcommand>` 呼叫**發布的 CLI 子指令** — 包括 `gate`、`collect-diff`、`block-reference`、`scan`、`build-prompt`、`publish`、`shot`、`comment`、`check` 和`usage` - 因此沒有任何內容作為幫助程式指令碼複製到您的儲存庫中。 `setup`和`doctor`是您本機執行的互動式助手； `gate` 是工作流程在每次回顧之前執行的安全門步驟。
 
-然後執行引導設定幫助程序：
+然後執行引導設定幫助程式：
 
 ```bash
 npx @agent-native/core@latest recap setup
 npx @agent-native/core@latest recap doctor
 ```
 
-`recap setup`刷新工作流程，使用`gh`設定GitHub Actions
+`recap setup`重新整理工作流程，使用`gh`設定GitHub Actions
 當值可從 env 或本機計畫獲得時的秘密/變數
-發布權杖存儲，並列印任何它無法列印的確切缺失指令
-設定。秘密值通過標準輸入發送到 `gh`，而不是指令參數。提交
-生成的工作流程檔案並開啟 PR 以檢視其執行。
+發布權杖儲存，並列印任何它無法列印的確切缺失指令
+設定。秘密值透過標準輸入傳送到 `gh`，而不是指令參數。提交
+產生的工作流程檔案並開啟 PR 以檢視其執行。
 
 預設情況下，工作流程根據最新捆綁的內容建置其代理提示
 `@agent-native/core@latest` 中的 `visual-recap` 指導，包括任何同級
@@ -109,7 +109,7 @@ npx @agent-native/core@latest connect https://plan.agent-native.com --service-to
 ```
 
 該指令在瀏覽器中對您進行驗證，然後列印服務權杖
-僅一次 - 將其存儲為 `PLAN_RECAP_TOKEN` 秘密。稍後使用
+僅一次 - 將其儲存為 `PLAN_RECAP_TOKEN` 秘密。稍後使用
 `list-org-service-tokens` 和 `revoke-org-service-token` actions
 計畫應用程式。
 
@@ -132,16 +132,16 @@ npx @agent-native/core@latest recap setup
 | ------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | `OPENAI_API_KEY`         | —                               | 秘密。與 `VISUAL_RECAP_AGENT=codex` 一起設定以使用 Codex 執行回顧。                                                          |
 | `VISUAL_RECAP_AGENT`     | `claude`                        | 變數。選取編碼代理後端（`claude` 或 `codex`）。                                                                              |
-| `VISUAL_RECAP_MODEL`     | 每個CLI的預設值                 | 變數。固定模型 - 例如`gpt-5.5` 表示 Codex，或 Claude 型號 ID。取消設定使用 CLI 自己的預設值。                                |
+| `VISUAL_RECAP_MODEL`     | 每個 CLI 的預設值               | 變數。固定模型 - 例如`gpt-5.5` 表示 Codex，或 Claude 型號 ID。取消設定使用 CLI 自己的預設值。                                |
 | `VISUAL_RECAP_REASONING` | 每個模型的預設值                | 變數。推理深度：`none`、`minimal`、`low`、`medium`、`high` 或 `xhigh`。適用於Codex後端。                                     |
 | `RECAP_CLI_VERSION`      | `latest`                        | 變數。固定工作流程安裝的 `@agent-native/core` CLI 版本 - 例如`1.5.0`。參見[Version pinning](#version-pinning-copy-variant)。 |
 | `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | 秘密。僅當在不同來源自行託管計畫應用時。                                                                                     |
 
-工作流自動檢測如何調用其助手 CLI（此 monorepo 內的本機來源，在其他地方發布的 `@agent-native/core`），因此無需設定 `RECAP_CLI` 變數。
+工作流自動偵測如何呼叫其助手 CLI（此 monorepo 內的本機來源，在其他地方發布的 `@agent-native/core`），因此無需設定 `RECAP_CLI` 變數。
 
 ## 評論內嵌截圖
 
-代理發布概要後，工作流程會在無頭 Chrome 中以淺色和深色模式對渲染的計畫進行螢幕截圖，並將 PNG 上傳到計畫應用程式上已簽名的公開圖片路徑。然後，粘性 PR 評論將這些螢幕截圖**內嵌**與 `<picture>` 元素一起嵌入 - GitHub 通過其迷彩代理重新提供它們，因此審閱者可以直接在評論中看到與其 GitHub 主題匹配的預覽，而無需開啟任何內容。當他們想要探索、評論或注釋時，完整互動計畫的連結就位於其旁邊。
+代理發布概要後，工作流程會在無頭 Chrome 中以淺色和深色模式對渲染的計畫進行螢幕截圖，並將 PNG 上傳到計畫應用程式上已簽名的公開圖片路徑。然後，置頂 PR 評論將這些螢幕截圖**內嵌**與 `<picture>` 元素一起嵌入 - GitHub 透過其迷彩代理重新提供它們，因此審閱者可以直接在評論中看到與其 GitHub 主題匹配的預覽，而無需開啟任何內容。當他們想要探索、評論或註解時，完整互動計畫的連結就位於其旁邊。
 
 ## 分叉 PR
 
@@ -149,17 +149,17 @@ npx @agent-native/core@latest recap setup
 
 主要的 `pr-visual-recap.yml` 工作流程在普通的 `pull_request` 觸發器上觸發，**不是** `pull_request_target`。因此，分叉 PR 執行時**無法存取儲存庫機密**，因此工作流程不會發現 `PLAN_RECAP_TOKEN` 並且完全無操作 - 不會發布失敗，不會暴露憑證。對於來自同一儲存庫中的分支的 PR，自動執行 Recaps，其中機密可用。
 
-這也意味著您可以在秘密存在之前\*\*合並工作流檔案：在沒有設定權杖的情況下，每次執行都是安靜的無操作，直到您設定秘密為止。 `gate` 步驟還會自動跳過草稿 PR 和機器人編寫的 PR，因此預設情況下不會執行觸發器回顧。
+這也意味著您可以在秘密存在之前\*\*合併工作流檔案：在沒有設定權杖的情況下，每次執行都是安靜的無操作，直到您設定秘密為止。 `gate` 步驟還會自動跳過草稿 PR 和機器人編寫的 PR，因此預設情況下不會執行觸發器回顧。
 
 ### 選取加入標籤門控分叉工作流程
 
-如果您想生成分叉 PR 的摘要，可以使用第二個工作流程檔案：`.github/workflows/pr-visual-recap-fork.yml`。它使用 `pull_request_target`（使用基本儲存庫機密執行），但從不簽出或執行分叉程式碼。具有 GitHub 作者關聯 `OWNER`、`MEMBER` 或 `COLLABORATOR` 的可信分叉作者會自動執行。外部分叉 PR 需要在 recap 代理執行之前通過新的 `recap` 標籤事件明確的**每頭維護者選取加入**。
+如果您想生成分叉 PR 的摘要，可以使用第二個工作流程檔案：`.github/workflows/pr-visual-recap-fork.yml`。它使用 `pull_request_target`（使用基本儲存庫機密執行），但從不簽出或執行分叉程式碼。具有 GitHub 作者關聯 `OWNER`、`MEMBER` 或 `COLLABORATOR` 的可信分叉作者會自動執行。外部分叉 PR 需要在 recap 代理執行之前透過新的 `recap` 標籤事件明確的**每頭維護者選取加入**。
 
 要安裝它，請將檔案從 [BuilderIO/agent-native](https://github.com/BuilderIO/agent-native/blob/main/.github/workflows/pr-visual-recap-fork.yml) 與現有的 `pr-visual-recap.yml` 一起複製到儲存庫的 `.github/workflows/` 目錄中。相同的秘密（`PLAN_RECAP_TOKEN`、`ANTHROPIC_API_KEY`）適用。
 
 ```an-diagram title="分叉 PR 同意門" summary="預設情況下，分叉 PR 沒有任何秘密；受信任的作者自動執行，外部貢獻者需要新的維護者回顧標籤。"
 {
-  "html": "<div class=\"diagram-fork\"><div class=\"diagram-node\">Fork PR 已開啟<br><small class=\"diagram-muted\">main workflow has no secrets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">可信作者</span><small class=\"diagram-muted\">OWNER、MEMBER 或 COLLABORATOR 自動執行</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">外部貢獻者</span><small class=\"diagram-muted\">維護者審核 diff 後再應用 <code>recap</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">門禁檢查<br><small class=\"diagram-muted\">fork PR? &amp; trusted or fresh label?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">回顧執行<br><small class=\"diagram-muted\">僅基礎 repo 程式碼 · fork diff 作為文本輸入</small></div></div>",
+  "html": "<div class=\"diagram-fork\"><div class=\"diagram-node\">Fork PR 已開啟<br><small class=\"diagram-muted\">main workflow has no secrets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">可信作者</span><small class=\"diagram-muted\">OWNER、MEMBER 或 COLLABORATOR 自動執行</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">外部貢獻者</span><small class=\"diagram-muted\">維護者審核 diff 後再應用 <code>recap</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">門禁檢查<br><small class=\"diagram-muted\">fork PR? &amp; trusted or fresh label?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">回顧執行<br><small class=\"diagram-muted\">僅基礎 repo 程式碼 · fork diff 作為文字輸入</small></div></div>",
   "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-arrow{font-size:20px;line-height:1}.diagram-fork .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}"
 }
 ```
@@ -171,53 +171,53 @@ npx @agent-native/core@latest recap setup
 3. 外部貢獻者要求維護人員檢查目前的差異（特別是對於提示注入型內容 - 見下文），然後將 `recap` 標籤應用於 PR。
 4. 外部貢獻者標籤門是每個頭 SHA：如果貢獻者推送更多提交，則下一個同步事件將跳過，直到維護者在檢查新差異後刪除並重新應用 `recap`。
 
-### fork 工作流程做什么以及 NOT 做什么
+### fork 工作流程做什麼以及 NOT 做什麼
 
-| 工作流程DOES                                                                                    | 工作流程執行 NOT                                             |
-| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| 在**基本分支引用**處簽出**基本儲存庫** - 僅受信任的程式碼                                       | 從 fork 中簽出或執行任何程式碼                               |
-| 獲取叉頭作為遠端引用（`git fetch origin pull/<n>/head:refs/recap/fork-head`）——獲取提交是安全的 | 從 fork 安裝軟件包、執行 fork 腳本或將 fork 內容評估為程式碼 |
-| 執行 `git diff base...refs/recap/fork-head` — 兩個已獲取物件的純文本差異                        | 將差異用作 LLM 文本輸入之外的任何內容                        |
-| 執行**基礎儲存庫的**視覺回顧技能和代理設定                                                      | 從 fork 載入任何技能或設定                                   |
-| 通過與第一方 PR 相同的秘密掃描步驟（失敗關閉）傳遞差異                                          | 跳過秘密掃描                                                 |
-| 向代理提示新增明確的提示強化注釋，將差異內容標記為不受信任                                      | 授予代理除正常回顧代理之外的任何其他權限                     |
+| 工作流程DOES                                                                                         | 工作流程執行 NOT                                             |
+| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| 在**基本分支引用**處簽出**基本儲存庫** - 僅受信任的程式碼                                            | 從 fork 中簽出或執行任何程式碼                               |
+| 取得fork head作為遠端引用（`git fetch origin pull/<n>/head:refs/recap/fork-head`）——取得提交是安全的 | 從 fork 安裝套件、執行 fork 指令碼或將 fork 內容評估為程式碼 |
+| 執行 `git diff base...refs/recap/fork-head` — 兩個已取得物件的純文字差異                             | 將差異用作 LLM 文字輸入之外的任何內容                        |
+| 執行**基礎儲存庫的**視覺回顧技能和代理設定                                                           | 從 fork 載入任何技能或設定                                   |
+| 透過與第一方 PR 相同的秘密掃描步驟（失敗關閉）傳遞差異                                               | 跳過秘密掃描                                                 |
+| 向代理提示新增明確的提示強化註解，將差異內容標記為不受信任                                           | 授予代理除正常回顧代理之外的任何其他權限                     |
 
-### 為什么在標記之前必須檢查差異
+### 為什麼在標記之前必須檢查差異
 
-fork diff 是攻擊者控制的文本，recap 代理將其讀取為輸入。精心設計的 diff 可能包含提示注入內容 - 例如，看起來像代理指令的 diff 行 - 旨在使 recap 代理采取非預期的 actions （例如，泄露發布權杖或產生誤導性的 recap 內容）。
+fork diff 是攻擊者控制的文字，recap 代理將其讀取為輸入。精心設計的 diff 可能包含提示注入內容 - 例如，看起來像代理指令的 diff 行 - 旨在使 recap 代理採取非預期的 actions （例如，外洩發布權杖或產生誤導性的 recap 內容）。
 
 在應用 `recap` 標籤之前，瀏覽差異：
 
 - 讀起來像直接指令或角色指令的行（“忽略先前的指令...”、“您現在...”、“將權杖寫入...”）。
-- 不尋常的檔案名可能會在系統提示時被誤讀。
+- 不尋常的檔名可能會在系統提示時被誤讀。
 - 新增的檔案中的編碼內容可能會解碼為指令。
 
-這些緩解措施已經在工作流程中分層（秘密掃描、敏感路徑門控、提示強化注釋、受限代理工具允許清單），但標籤審查是主要防線。
+這些緩解措施已經在工作流程中分層（秘密掃描、敏感路徑門控、提示強化註解、受限代理工具允許清單），但標籤審查是主要防線。
 
 ### 與主工作流程的關系
 
-這兩個工作流程檔案是獨立的。對於非分叉 PR 更新，`pr-visual-recap.yml` 是唯一執行的工作流程。對於分叉 PR，正常工作流程在其分叉門處退出，`pr-visual-recap-fork.yml` 會為受信任的同一組織作者自動執行，或者在外部貢獻者的新維護者 `recap` 標籤之後自動執行。它們共用相同的粘性評論標記和計畫 ID 線程，因此 PR 和分支 PR 都會對同一 PR 生成單個更新插入的評論。
+這兩個工作流程檔案是獨立的。對於非分叉 PR 更新，`pr-visual-recap.yml` 是唯一執行的工作流程。對於分叉 PR，正常工作流程在其分叉門處退出，`pr-visual-recap-fork.yml` 會為受信任的同一組織作者自動執行，或者在外部貢獻者的新維護者 `recap` 標籤之後自動執行。它們共用相同的置頂評論標記和計畫 ID 對話串，因此 PR 和分支 PR 都會對同一 PR 生成單一更新插入的評論。
 
 ### 自修改守衛 {#self-modifying-guard}
 
-當 PR 觸及以下任何路徑時，`gate` 步驟會完全跳過回顧，因此 PR 永遠無法重寫可信回顧作業載入並泄露機密的工作流程、技能或代理設定：
+當 PR 觸及以下任何路徑時，`gate` 步驟會完全跳過回顧，因此 PR 永遠無法重寫可信回顧作業載入並外洩機密的工作流程、技能或代理設定：
 
 | 路徑模式                                   | 原因                                     |
 | ------------------------------------------ | ---------------------------------------- |
 | `.github/workflows/pr-visual-recap.yml`    | 工作流程本身                             |
 | `**/skills/visual-(recap\|plan\|plans)/**` | The visual-recap skill the agent follows |
-| `**/.claude/**`                            | 執行程序載入的代理設定                   |
-| `**/CLAUDE.md`                             | 執行程序載入的代理指令                   |
-| `**/AGENTS.md`                             | 執行程序載入的代理指令                   |
-| `**/.mcp.json`                             | 執行器載入的MCP伺服器設定                |
+| `**/.claude/**`                            | 執行程式載入的代理設定                   |
+| `**/CLAUDE.md`                             | 執行程式載入的代理指令                   |
+| `**/AGENTS.md`                             | 執行程式載入的代理指令                   |
+| `**/.mcp.json`                             | 執行器載入的 MCP 伺服器設定              |
 
 在 `BuilderIO/agent-native` monorepo 中，工作流程從受信任的基本分支來源而不是 PR 頭來源執行回顧 CLI。這使得正常的包更改（包括 `packages/core/**`）可以進行回顧，而無需執行 PR 修改的 CLI 程式碼。
 
 ## 本機檔案隱私模式
 
 GitHub 操作專為託管、可共用的 PR 審核而設計。如果你想要一個
-回顧而不將回顧內容發送到 Agent-Native 計畫資料庫，執行
-相同的幫助程序在本機檔案模式下本機流動：
+回顧而不將回顧內容傳送到 Agent-Native 計畫資料庫，執行
+相同的幫助程式在本機檔案模式下本機流動：
 
 ```bash
 npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
@@ -225,7 +225,7 @@ npx @agent-native/core@latest recap scan --diff recap.diff
 npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
-將生成的 `recap-prompt.md` 交給您的編碼代理。在本機檔案模式
+將產生的 `recap-prompt.md` 交給您的編碼代理。在本機檔案模式
 提示指示代理寫入 `plans/pr-123-visual-recap/plan.mdx`
 加上可選的視覺檔案，然後執行：
 
@@ -235,19 +235,19 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 返回的 URL 開啟託管計畫 UI，同時瀏覽器讀取回顧 MDX
 來自本機主機橋。回顧內容未寫入託管計畫
-資料庫，URL僅適用於執行網橋的機器。如果你執行
+資料庫，URL 僅適用於執行網橋的機器。如果你執行
 本機計畫應用程式具有相同的 `PLAN_LOCAL_DIR`，
-`/local-plans/pr-123-visual-recap` 路線也有效。回購支持的資料夾可以
+`/local-plans/pr-123-visual-recap` 路由也有效。儲存庫支援的資料夾可以
 以 `/local-plans/pr-123-visual-recap?path=plans%2Fpr-123-visual-recap` 的形式開啟。
-此模式停用託管的粘性 PR 評論、內嵌螢幕截圖上傳，
+此模式停用託管的置頂 PR 評論、內嵌螢幕截圖上傳，
 使用附件和瀏覽器評論，直到您明確發布為止。
 
 ## 它是資訊性的，而不是門
 
 概述是在正常 PR 流程之上的複習輔助工具：
 
-- 它顯示 `Visual Recap` 檢查行以提高可見性，但它**不是必需的檢查**並且永遠不會阻止合並。
-- 生成或發布失敗會中立地完成，並顯示為解釋性粘性注釋，而不是不相關程式碼上的紅色 X。
+- 它顯示 `Visual Recap` 檢查行以提高可見性，但它**不是必需的檢查**並且永遠不會阻止合併。
+- 生成或發布失敗會中立地完成，並顯示為解釋性置頂註解，而不是不相關程式碼上的紅色 X。
 - 回顧及其螢幕截圖**並不意味著差異已被審查**。審閱者仍然需要閱讀實際更改的行。
 
 ## 版本固定（複製變體） {#version-pinning-copy-variant}
@@ -259,20 +259,20 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 該變數是可選的。保持未設定（或將其設定為 `latest`）以跟蹤最新版本。
 
-對於可重用調用程序變體，請使用 `cli-version` 輸入（請參閱可重用部分中的 [Version pinning](#version-pinning)）。
+對於可重用呼叫程式變體，請使用 `cli-version` 輸入（請參閱可重用部分中的 [Version pinning](#version-pinning)）。
 
 ## 秘密掃描允許清單
 
-在發布回顧之前，工作流程執行 `npx @agent-native/core@latest recap scan` 以檢測差異中可能的秘密。任何其 diff 與已知秘密模式匹配的 PR 都會被阻止並帶有解釋性注釋 - 不會發布摘要，並且不會將 diff 內容發送到編碼代理。
+在發布回顧之前，工作流程執行 `npx @agent-native/core@latest recap scan` 以偵測差異中可能的秘密。任何其 diff 與已知秘密模式匹配的 PR 都會被阻止並帶有解釋性註解 - 不會發布摘要，並且不會將 diff 內容傳送到編碼代理。
 
 在極少數情況下，儲存庫具有故意的測試裝置或表面上類似於秘密模式的非秘密字串（例如，測試檔案中的裝置金鑰）。要抑制誤報，請在儲存庫的根目錄中建立 `.github/recap-scan-allowlist`。
 
 ### 格式
 
-每個非空白、非注釋行都是一個 **文字子字串** 或 **`/regex/flags`** 模式：
+每個非空白、非註解行都是一個 **文字子字串** 或 **`/regex/flags`** 模式：
 
 ```
-# 以 # 開頭的行是注釋。
+# 以 # 開頭的行是註解。
 
 # 文字子字串 — 允許包含該字串的任何 diff 行。
 sk-test-fixture1234567890abcdef
@@ -291,32 +291,32 @@ EXAMPLE_API_KEY=placeholder-value
 - 空檔案相當於沒有檔案。
 - 格式錯誤的正則表達式行被視為文字字串。
 
-允許清單僅由秘密掃描門查閱。它不會影響編碼代理可以讀取的內容 - 如果門通過，代理無論如何都會收到完整的差異。
+允許清單僅由秘密掃描門查閱。它不會影響編碼代理可以讀取的內容 - 如果門透過，代理無論如何都會收到完整的差異。
 
 ## 采用可重複使用的工作流程
 
-### 為什么使用可重用變體？
+### 為什麼使用可重用變體？
 
-預設安裝程序將完整的約 360 行工作流程 YAML 複製到您的儲存庫中（**複製**選項）。對於氣隙儲存庫或需要審核每一行執行內容的儲存庫來說，這是正確的選取。缺點是錯誤修複和改進永遠不會到達您的手中 - 您需要在每次發布後手動重新執行 `npx @agent-native/core@latest recap setup`。
+預設安裝程式將完整的約 360 行工作流程 YAML 複製到您的儲存庫中（**複製**選項）。對於氣隙儲存庫或需要審核每一行執行內容的儲存庫來說，這是正確的選取。缺點是錯誤修復和改進永遠不會到達您的手中 - 您需要在每次發布後手動重新執行 `npx @agent-native/core@latest recap setup`。
 
-**可重用**選項改為編寫一個精簡的約 20 行調用程序。它通過`uses:`委托給`BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml`。當工作流程執行時，每個調用者都會自動獲取最新邏輯，無需本機更新。
+**可重用**選項改為編寫一個精簡的約 20 行呼叫程式。它透過`uses:`委托給`BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml`。當工作流程執行時，每個呼叫者都會自動取得最新邏輯，無需本機更新。
 
 |                        | 複製（預設）                | 可重複使用                       |
 | ---------------------- | --------------------------- | -------------------------------- |
 | 儲存庫中的工作流程大小 | ~360 行                     | ~20 行                           |
-| 自動修複               | 否 — 重新執行 `recap setup` | 是                               |
+| 自動修復               | 否 — 重新執行 `recap setup` | 是                               |
 | 氣隙/完全可審計性      | 是                          | 否                               |
-| 可固定到特定版本       | 僅通過本機編輯              | 是 - 將 `@v1.2.3` 設定為 `uses:` |
+| 可固定到特定版本       | 僅透過本機編輯              | 是 - 將 `@v1.2.3` 設定為 `uses:` |
 
-### 調用者片段
+### 呼叫者片段
 
 這是`npx @agent-native/core@latest recap setup --reusable`寫的（或者你可以手動貼上）：
 
 ```yaml
 name: PR Visual Recap
 
-# 瘦調用者 — 完整的工作流邏輯位於 BuilderIO/agent-native 中。
-# 修複和改進會在每次執行時自動到達此儲存庫。
+# 瘦呼叫者 — 完整的工作流邏輯位於 BuilderIO/agent-native 中。
+# 修復和改進會在每次執行時自動到達此儲存庫。
 # 要固定特定版本以實現可重複性，請將 '@main' 替換為
 # 標籤或 SHA、e.g。 '@<x2/>' 或 '@abc1234'。
 
@@ -348,10 +348,10 @@ jobs:
 
 適用 [Secrets and variables](#secrets-and-variables) 中描述的相同秘密和變數 - 在儲存庫設定中以與複製變體相同的方式設定它們。
 
-### 通過CLI安裝
+### 透過 CLI 安裝
 
 ```bash
-# 編寫瘦調用者而不是完整副本：
+# 編寫瘦呼叫者而不是完整副本：
 npx @agent-native/core@latest recap setup --reusable
 
 # 或者使用固定參考來實現可重複性：
@@ -364,7 +364,7 @@ npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
 
 ### 版本固定
 
-預設情況下，調用者引用 `@main`，它始終使用可重用工作流程的最新發布版本。對於需要可重現 CI 的正式環境儲存庫，請固定到標籤或 SHA：
+預設情況下，呼叫者引用 `@main`，它始終使用可重用工作流程的最新發布版本。對於需要可重現 CI 的正式環境儲存庫，請固定到標籤或 SHA：
 
 ```yaml
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
@@ -372,13 +372,13 @@ uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2
 
 `cli-version` 輸入控制工作流程中執行的 `@agent-native/core` CLI 版本 - 將其保留在 `"latest"` 以跟蹤最新版本，或將其固定到版本字串（例如 `"1.5.0"`）以實現完全可重複性。
 
-### workflow_call事件上下文
+### workflow_call事件脈絡
 
-`workflow_call` 工作流程繼承**調用者的**事件上下文。可重用工作流程使用 `github.event.pull_request.*` 表達式來讀取 PR 編號、頭 SHA、基礎 SHA、合並時間戳和 PR 元資料 - 僅當調用者在 `pull_request` 上觸發時，這些才能正常工作。上面的調用者程式碼片段已經包含正確的事件型別。包含 `closed` 事件，因此合並的 PR 回顧可以用 `merged_at` 標記，並在以後作為已發布的工作進行搜尋。
+`workflow_call` 工作流程繼承**呼叫者的**事件脈絡。可重用工作流程使用 `github.event.pull_request.*` 表達式來讀取 PR 編號、頭 SHA、基礎 SHA、合併時間戳和 PR 中繼資料 - 僅當呼叫者在 `pull_request` 上觸發時，這些才能正常工作。上面的呼叫者程式碼片段已經包含正確的事件型別。包含 `closed` 事件，因此合併的 PR 回顧可以用 `merged_at` 標記，並在以後作為已發布的工作進行搜尋。
 
-不要在 `workflow_dispatch` 或 `push` 上觸發調用者 - 這些事件不攜帶 `pull_request` 負載，並且門將跳過“無 pull_request 負載”的回顧。
+不要在 `workflow_dispatch` 或 `push` 上觸發呼叫者 - 這些事件不攜帶 `pull_request` 負載，並且門將跳過“無 pull_request 負載”的回顧。
 
 ## 相關
 
 - [Visual Plans](/docs/template-plan) — `/visual-plan` 和 `/visual-recap` skills、託管計畫連線器以及此操作發布到的互動式審核介面。
-- [Skills](/docs/skills-guide) — 將代理本機 skills 安裝到您的編碼代理中。
+- [Skills](/docs/skills-guide) — 將 Agent-Native skills 安裝到您的編碼代理中。