@agent-native/core 0.85.6 → 0.86.0

package/docs/content/locales/zh-CN/skills-guide.mdx

@@ -118,9 +118,7 @@ Skills 位于 `.agents/skills/<name>/SKILL.md`，包含针对代理的详细指
 
 ## 应用程序支持的 skills {#app-backed-skills}
 
-当前应用支持的 skills 包括 Plan 的 `visual-plan` 和 `visual-recap`、Design
-的 `visual-edit`、Assets 的 `assets`，以及用于仓库内 docs/blog/MDX 编辑的
-`content`。
+当前应用支持的 skills 包括 Plan 的 `visual-plan`、`visual-recap` 和 `visualize-repo`，Design 的 `visual-edit`，Assets 的 `assets`，以及用于仓库支持的 docs/blog/MDX 编辑的 `content`。
 
 应用程序支持的 skills 将代理本机应用程序打包为技能市场工件。该捆绑包可以包含代理指令、导出的 skills、MCP 连接器元数据、托管/本地启动指令和 UI 表面（例如 MCP 应用程序）。
 
@@ -332,6 +330,7 @@ Hosted 是默认安装路径。本地启动是明确的定制，
 ```bash
 # 愉快的路径：导出的指令加上托管的 MCP 连接器。
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/docs/content/locales/zh-CN/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native 计划将您的编码代理的计划转变为结构
 
 # 视觉计划
 
-> **大多数人安装 Plan 作为一项技能，而不是支架式应用程序。** 一个 CLI 命令
-> 添加 `/visual-plan` 和 `/visual-recap` skills 以及托管计划
-> 连接到您的编码代理 - 请参阅 [Plan plugin & marketplace](/docs/plan-plugin)
-> 用于插件和市场路线。分叉计划模板（参见
-> [For developers](#for-developers)) 是辅助路径，用于自托管或
-> 建立在计划本身之上。
+> **大多数人会把 Plan 作为 skill 安装，而不是 scaffolded app。** 一个 CLI 命令会把 `/visual-plan`、`/visual-recap`、`/visualize-repo` skills 和托管的 Plan 连接器添加到你的 coding agent — plugin 和 marketplace 路径见 [Plan plugin & marketplace](/docs/plan-plugin)。Fork Plan 模板（见 [For developers](#for-developers)）是用于自托管或基于 Plan 本身构建的次要路径。
 
 Agent-Native 计划是编码代理的可视化计划模式。它变成了普通
 Codex、Claude 代码、Markdown 或将实施计划粘贴到结构化中
@@ -111,7 +106,7 @@ Codex、Claude 代码、Markdown 或将实施计划粘贴到结构化中
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-该命令安装两个命令：`/visual-plan` 和 `/visual-recap`。
+该命令安装三个命令：`/visual-plan`、`/visual-recap` 和 `/visualize-repo`。
 
 如果您使用的是直接接受 MCP 连接器 URL 的基于聊天的主机
 （而不是 CLI 配置的客户端），连接托管计划连接器
@@ -354,6 +349,25 @@ MDX文件夹路径；这将上传计划，为其分配托管 ID，启用共享
 自动使您的编码代理的 LLM 本地化；选择本地或批准的
 模型是否隐私边界也很重要。
 
+## 仓库可视化文档 {#visualize-repo}
+
+当你想为代码库建立一层持久的可视化文档，而不是一次性的计划或 recap 时，使用 `/visualize-repo`。它会创建或打开本地 Plan MDX workspace，在 `agent-native.json` 中更新 `apps.visualize-repo` 的 local-files 配置，并通过同一个 localhost bridge 提供文档：
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+如果不存在 `agent-native.json`，该命令会引导生成一个，并根据仓库结构推荐一个小的起始集合，例如 `actions/`、`app/components/`、`app/pages/`、`server/db/schema.ts`、`src/`、`packages/`、`templates/`、`docs/` 或 `content/`。你也可以指定具体的 source anchors：
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+起始文件夹默认位于 `.agent-native/visual-docs/repo-overview`。评论会保留在本地 `comments.json` 中，因此审阅者可以为 coding agent 标记章节，agent 也可以在同一次变更中同时更新代码和 MDX。运行 `visualize-repo check` 做本地 lint；当你希望 Plan renderer schema 验证 MDX 时，运行 `visualize-repo verify`。
+
 ## 桌面本地文件同步 {#desktop-local-sync}
 
 Agent Native Desktop 还为托管计划提供了本机本地文件夹桥。这个
@@ -406,6 +420,8 @@ Agent Native Desktop 还为托管计划提供了本机本地文件夹桥。这
 - “在 `main` 和此分支之间的差异上使用 `/visual-recap`。”
 - “在本地文件模式下使用 `/visual-recap`，因此不会将摘要内容写入计划数据库。”
 
+- “运行 `/visualize-repo`，从我们的公共 API 操作和 schema 开始。”
+
 ## 从身份验证错误中恢复 {#auth-errors}
 
 如果计划工具返回 `needs auth`、`Unauthorized` 或“会话”

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

@@ -235,7 +235,7 @@ VITE_AGENT_NATIVE_SESSION_REPLAY_SAMPLE_RATE=0.1
 - URL 会使用与浏览器分析相同的 `scrubUrl()` 辅助函数进行清理。
 - 重放采集仅限 Web 端且为选择性加入（opt-in）；不会录制原生桌面屏幕。
 
-录制期间，会话重放还会捕获浏览器控制台输出（`log`、`info`、`warn`、`error`、`debug`，以及 window 的 `error` / `unhandledrejection`）和网络请求元数据（`fetch` 和 XHR），并将其作为带标签的 rrweb 自定义事件记录下来，以便代理和重放查看器调试用户报告的问题。启用重放后，此项捕获默认开启；可通过 `sessionReplay.console` 和 `sessionReplay.network` 选项进行调整或禁用，两者均可接受布尔值或选项对象。请求/响应的正文和请求头永远不会被捕获，URL 会被清理，消息会被截断，录制器自身的上报/跟踪流量会被排除，并且每个会话的配额（1000 条控制台事件 / 2000 条网络事件）在超出时会附加截断提示。
+录制期间，会话重放还会捕获浏览器控制台输出（`log`、`info`、`warn`、`error`、`debug`，以及 window 的 `error` / `unhandledrejection`）和网络请求元数据（`fetch` 和 XHR），并将其作为带标签的 rrweb 自定义事件记录下来，以便代理和重放查看器调试用户报告的问题。启用重放后，此项捕获默认开启；可通过 `sessionReplay.console` 和 `sessionReplay.network` 选项进行调整或禁用，两者均可接受布尔值或选项对象（`{ maxEvents?: number }`，其中 `network` 还可接受 `captureErrorBodies` 和 `maxErrorBodyLength`）。请求正文和请求头永远不会被捕获；响应正文仅在 5xx（服务器错误）响应下才会被捕获，且只捕获一段有边界、经过脱敏处理的片段（`captureErrorBodies`，默认值为 `true`，长度上限为 `maxErrorBodyLength` 个字符，默认 2048）——非 5xx 响应以及网络失败（状态码 0）的响应永远不会携带正文。URL 会被清理，消息会被截断，录制器自身的上报/跟踪流量会被排除，并且每个会话的配额（1000 条控制台事件 / 2000 条网络事件）在超出时会附加截断提示。
 
 Analytics 模板将重放元数据存储在 SQL（`session_recordings`）中，并通过私有 blob 引用（`session_replay_chunks`）存储数据块。浏览器和代理永远不会收到提供商的 URL。回放通过受限的服务器路由进行，默认的代理工具返回的是摘要或有限范围的重放事件，而非原始数据块表的直接访问权限。
 

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

@@ -264,7 +264,7 @@ if (workspaceConnectionProviderSupports("slack", "messages")) {
 | `google_drive` | 搜索、导入、文档       | 大脑、内容、幻灯片         |
 | `hubspot`      | 搜索、导入、crm        | 分析、大脑、邮件           |
 | `granola`      | 搜索、导入、会议、文档 | 大脑、日历、调度           |
-| `clips`        | 搜索、导入、会议       | 大脑、剪辑、视频           |
+| `clips`        | 搜索、导入、会议       | 大脑、剪辑                 |
 | `generic`      | 搜索、导入、文档       | 自定义 webhooks 和文件投放 |
 
 凭证密钥仅为名称，例如 `SLACK_BOT_TOKEN` 或 `GITHUB_TOKEN`。提供者元数据绝不能包含实际的凭证值。

package/docs/content/locales/zh-TW/cloneable-saas.mdx

@@ -22,7 +22,6 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 | [**Brain**](/docs/template-brain)         | 幹淨的公司聊天由引用的機構記憶、核准的來源、審查門和引文支援。                                  |
 | [**Assets**](/docs/template-assets)       | 用於品牌庫、上傳、參考和品牌圖片/影片產生的數位資產管理器。                                     |
 | [**Slides**](/docs/template-slides)       | Agent-Native Google 幻燈片。基於 React 的簡報由代理直接生成和編輯。                             |
-| [**Video**](/docs/template-videos)        | Remotion 上的程式化動態圖形和產品示範影片。                                                     |
 | [**Analytics**](/docs/template-analytics) | Agent-Native 振幅/混合面板。連線資料來源、提示圖表、固定到儀表板。                              |
 | [**Clips**](/docs/template-clips)         | 非同步螢幕+攝影機錄製，包含轉錄、章節和 AI 摘要。                                               |
 | [**Design**](/docs/template-design)       | Agent 原生 HTML 原型工作室，用於互動式 Alpine/Tailwind 設計。                                   |

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

@@ -1,20 +1,20 @@
 ---
 title: "規劃外掛和市場"
-description: "安裝 Agent-Native 計畫 skills（/visual-plan、/visual-recap）以及託管計畫 MCP 連線器作為 Claude 程式碼或 Codex 外掛，或使用通用 CLI。更新如何進行以及您是否需要提交任何內容。"
+description: "安裝 Agent-Native Plan skills（/visual-plan、/visual-recap、/visualize-repo）以及託管 Plan MCP 連線器，可作為 Claude Code 或 Codex 外掛安裝，也可使用通用 CLI。了解更新如何運作以及是否需要提交任何內容。"
 ---
 
 # 規劃外掛和市場
 
-Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一次安裝即可新增計畫斜線指令 skills **並**連線託管計畫 MCP 連線器，以便代理可以生成計畫，並且 skills 可以將它們直接發布到計畫應用程式中。
+Agent-Native **Plan** 應用程式以一個可安裝的 bundle 提供。一次安裝會新增 Plan 斜線指令 skills，**並**連線託管的 Plan MCP 連線器，讓 agent 可以產生 plans，並讓 skills 直接發布到 Plan 應用程式中。
 
 ## 你得到什麼 {#what-you-get}
 
 一次安裝即可為您提供：
 
-- **兩個 skills** — `/visual-plan`（規範入口點）和 `/visual-recap`。
+- **三個 skills** — `/visual-plan`（規範入口點）、`/visual-recap` 和 `/visualize-repo`。
 - **計畫 MCP 連線器** — 針對 `https://plan.agent-native.com` 上的託管應用程式進行註冊（MCP 端點 `https://plan.agent-native.com/_agent-native/mcp`，伺服器名稱 `plan`）。
 
-<Diagram id="doc-block-6n3so7" title={"三條路由，一攬子"} summary={"通用 CLI、Claude Code 外掛和 Codex 外掛都安裝相同的兩個技能以及託管計畫連線器。"}>
+<Diagram id="doc-block-6n3so7" title={"三條路由，一攬子"} summary={"通用 CLI、Claude Code 外掛和 Codex 外掛都會安裝同一組 Plan skills 以及託管的 Plan 連線器。"}>
 
 ```html
 <div class="diagram-routes">
@@ -35,7 +35,8 @@ Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一
   <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>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -76,7 +77,7 @@ Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一
 
 </Diagram>
 
-預設情況下，skills 都會發布到託管的計畫應用 - 他們透過
+預設情況下，`/visual-plan` 和 `/visual-recap` 會發布到託管的 Plan 應用程式 — 它們透過
 MCP 連線器並向您提供連結或行內計畫以供審核。他們從不傾倒
 內嵌 Markdown/ASCII 計畫作為可交付成果放入聊天中。如果計畫工具
 返回`needs auth`、`Unauthorized`或`Session terminated`，重新驗證
@@ -192,13 +193,13 @@ Agent Native 桌面有一個單獨的託管計畫本機檔案同步路徑：
 
 ### 通用技能路由（任意 MCP 主機） {#universal}
 
-適用於任何主機 - Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP 應用程式、Claude Cowork 以及任何其他與 MCP 相容的內容。 Agent-Native CLI 安裝 skills，註冊託管計畫 MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此您的第一個工具呼叫不會遇到 OAuth 牆：
+適用於任何 host — Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP apps、Claude Cowork 以及任何其他 MCP-compatible host。Agent-Native CLI 會安裝 Plan skills，註冊託管的 Plan MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此你的第一次工具呼叫不會遇到 OAuth 牆：
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-這將安裝 `visual-plan` 以及配套的 `visual-recap` 技能，然後註冊 `plan` 連線器，然後執行驗證（OAuth 提示託管/帳戶支援的共用）。有用的標誌：
+這會安裝 `visual-plan` 以及配套的 `visual-recap` 和 `visualize-repo` skills，然後註冊 `plan` 連線器並執行驗證（用於託管/帳戶支援共用的 OAuth 提示）。有用的 flags：
 
 - `--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`。
@@ -234,7 +235,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` 會新增 Plan skills 和 **僅 URL** 的 MCP 設定（套件中沒有 secrets）；`/mcp` → **Authenticate** 完成 OAuth 握手。當你需要本機檔案或自託管模式時，請改用通用 CLI 路徑。
 
 > 市場目錄名為 `agent-native-apps`，計畫外掛為 `agent-native-visual-plans`，因此安裝目標始終為 `agent-native-visual-plans@agent-native-apps`。
 

package/docs/content/locales/zh-TW/sharing.mdx

@@ -5,7 +5,7 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 
 # 共用和隱私
 
-使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、影片編輯、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
+使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
 
 它的外觀和工作方式與 Google 檔案類似。相同的共用按鈕、相同的對話框、相同的三層可見性模型、相同的每使用者/每組織授權 - 跨每個範本，無需針對每個應用進行重新設計。
 
@@ -92,7 +92,6 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 - **內容** — 檔案
 - **幻燈片** — 幻燈片
 - **設計** — 設計和資產
-- **影片** — 作品
 - **剪輯** — 螢幕錄製（Loom 風格）
 - **表單** — 表單定義
 - **行事曆** — 活動和預訂連結

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

@@ -118,9 +118,7 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
 
 ## 應用程式支援的 skills {#app-backed-skills}
 
-目前應用支援的 skills 包括 Plan 的 `visual-plan` 和 `visual-recap`、Design
-的 `visual-edit`、Assets 的 `assets`，以及用於儲存庫內 docs/blog/MDX 編輯的
-`content`。
+目前應用支援的 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 應用程式）。
 
@@ -332,6 +330,7 @@ Hosted 是預設安裝路徑。本機啟動是明確的定制，
 ```bash
 # 愉快的路徑：匯出的指令加上託管的 MCP 連線器。
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/docs/content/locales/zh-TW/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native 計畫將您的編碼代理的計畫轉變為結構
 
 # 視覺計畫
 
-> **大多數人安裝 Plan 作為一項技能，而不是支架式應用程式。** 一個 CLI 指令
-> 新增 `/visual-plan` 和 `/visual-recap` skills 以及託管計畫
-> 連線到您的編碼代理 - 請參閱 [Plan plugin & marketplace](/docs/plan-plugin)
-> 用於外掛和市場路由。分叉計畫範本（參見
-> [For developers](#for-developers)) 是輔助路徑，用於自託管或
-> 建立在計畫本身之上。
+> **大多數人會把 Plan 作為 skill 安裝，而不是 scaffolded app。** 一個 CLI 指令會把 `/visual-plan`、`/visual-recap`、`/visualize-repo` skills 和託管的 Plan 連線器新增到你的 coding agent — plugin 和 marketplace 路徑請參閱 [Plan plugin & marketplace](/docs/plan-plugin)。Fork Plan template（見 [For developers](#for-developers)）是用於自託管或基於 Plan 本身建置的次要路徑。
 
 Agent-Native 計畫是編碼代理的視覺化計畫模式。它變成了普通
 Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
@@ -111,7 +106,7 @@ Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-該指令安裝兩個指令：`/visual-plan` 和 `/visual-recap`。
+該指令會安裝三個指令：`/visual-plan`、`/visual-recap` 和 `/visualize-repo`。
 
 如果您使用的是直接接受 MCP 連線器 URL 的基於聊天的主機
 （而不是 CLI 設定的用戶端），連線託管計畫連線器
@@ -354,6 +349,25 @@ MDX 資料夾路徑；這將上傳計畫，為其分配託管 ID，啟用共用
 自動使您的編碼代理的 LLM 本機化；選取本機或核准的
 模型是否隱私邊界也很重要。
 
+## Repository 視覺化文件 {#visualize-repo}
+
+當你想為 codebase 建立一層持久的視覺化文件，而不是一次性的 plan 或 recap 時，使用 `/visualize-repo`。它會建立或開啟本機 Plan MDX workspace，在 `agent-native.json` 中更新 `apps.visualize-repo` 的 local-files 設定，並透過同一個 localhost bridge 提供文件：
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+如果不存在 `agent-native.json`，該指令會引導產生一個，並根據 repository 結構推薦一個小的起始集合，例如 `actions/`、`app/components/`、`app/pages/`、`server/db/schema.ts`、`src/`、`packages/`、`templates/`、`docs/` 或 `content/`。你也可以指定具體的 source anchors：
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+起始資料夾預設位於 `.agent-native/visual-docs/repo-overview`。Comments 會保留在本機 `comments.json` 中，因此 reviewers 可以為 coding agent 標記章節，agent 也可以在同一次變更中同時更新 code 和 MDX。執行 `visualize-repo check` 做本機 lint；當你希望 Plan renderer schema 驗證 MDX 時，執行 `visualize-repo verify`。
+
 ## 桌面本機檔案同步 {#desktop-local-sync}
 
 Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這個
@@ -406,6 +420,8 @@ Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這
 - “在 `main` 和此分支之間的差異上使用 `/visual-recap`。”
 - “在本機檔案模式下使用 `/visual-recap`，因此不會將摘要內容寫入計畫資料庫。”
 
+- “執行 `/visualize-repo`，從我們的公開 API actions 和 schema 開始。”
+
 ## 從驗證錯誤中恢復 {#auth-errors}
 
 如果計畫工具返回 `needs auth`、`Unauthorized` 或“工作階段”

package/docs/content/locales/zh-TW/tracking.mdx

@@ -235,7 +235,7 @@ VITE_AGENT_NATIVE_SESSION_REPLAY_SAMPLE_RATE=0.1
 - URL 會使用瀏覽器分析所用的同一個 `scrubUrl()` 輔助函式進行清理。
 - 重播擷取僅限於網頁，且為選擇加入；它不會錄製原生桌面畫面。
 
-在錄製期間，工作階段重播還會擷取瀏覽器主控台輸出（`log`、`info`、`warn`、`error`、`debug`，以及視窗的 `error`/`unhandledrejection`）與網路請求元資料（`fetch` 與 XHR），並以帶標籤的 rrweb 自訂事件形式儲存，讓代理與重播檢視器能夠偵錯使用者回報的問題。啟用重播後，擷取功能預設為開啟；可透過 `sessionReplay.console` 與 `sessionReplay.network` 選項進行調整或停用，這兩個選項都接受布林值或選項物件。請求/回應主體與標頭永遠不會被擷取，URL 會被清理，訊息會被截斷，記錄器自身的擷取/追蹤流量會被排除，且每個工作階段的預算（1000 個主控台事件／2000 個網路事件）在超過時會加上截斷提示。
+在錄製期間，工作階段重播還會擷取瀏覽器主控台輸出（`log`、`info`、`warn`、`error`、`debug`，以及視窗的 `error`/`unhandledrejection`）與網路請求元資料（`fetch` 與 XHR），並以帶標籤的 rrweb 自訂事件形式儲存，讓代理與重播檢視器能夠偵錯使用者回報的問題。啟用重播後，擷取功能預設為開啟；可透過 `sessionReplay.console` 與 `sessionReplay.network` 選項進行調整或停用，這兩個選項都接受布林值或選項物件（`{ maxEvents?: number }`，其中 `network` 另外還可接受 `captureErrorBodies` 與 `maxErrorBodyLength`）。請求主體與標頭永遠不會被擷取；回應主體僅在 5xx（伺服器錯誤）回應時才會被擷取，且僅擷取一段有邊界、經過遮蔽處理的片段（`captureErrorBodies`，預設為 `true`，上限為 `maxErrorBodyLength` 個字元，預設 2048）——非 5xx 及網路失敗（狀態碼 0）的回應永遠不會帶有主體。URL 會被清理，訊息會被截斷，記錄器自身的擷取/追蹤流量會被排除，且每個工作階段的預算（1000 個主控台事件／2000 個網路事件）在超過時會加上截斷提示。
 
 Analytics 範本將重播中繼資料儲存在 SQL（`session_recordings`）中，並透過私有 blob 參照（`session_replay_chunks`）儲存區塊。瀏覽器與代理永遠不會收到提供者 URL。播放透過範圍受限的伺服器路由進行，且預設代理工具傳回摘要或範圍受限的重播事件，而非原始區塊資料表存取權。
 

package/docs/content/locales/zh-TW/workspace-connections.mdx

@@ -264,7 +264,7 @@ if (workspaceConnectionProviderSupports("slack", "messages")) {
 | `google_drive` | 搜尋、匯入、檔案         | 大腦、內容、幻燈片       |
 | `hubspot`      | 搜尋、匯入、crm          | 分析、大腦、郵件         |
 | `granola`      | 搜尋、匯入、會議、檔案   | 大腦、行事曆、調度       |
-| `clips`        | 搜尋、匯入、會議         | 大腦、剪輯、影片         |
+| `clips`        | 搜尋、匯入、會議         | 大腦、剪輯               |
 | `generic`      | 搜尋、匯入、檔案         | 自訂 webhooks 和檔案投放 |
 
 憑證金鑰僅為名稱，例如 `SLACK_BOT_TOKEN` 或 `GITHUB_TOKEN`。提供者中繼資料絕不能包含實際的憑證值。

package/docs/content/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "Plan plugin & marketplace"
-description: "Install the Agent-Native Plan skills (/visual-plan, /visual-recap) plus the hosted Plan MCP connector as a Claude Code or Codex plugin, or with the universal CLI. How updates work and whether you need to submit anything."
+description: "Install the Agent-Native Plan skills (/visual-plan, /visual-recap, /visualize-repo) plus the hosted Plan MCP connector as a Claude Code or Codex plugin, or with the universal CLI. How updates work and whether you need to submit anything."
 ---
 
 # Plan plugin & marketplace
 
-The Agent-Native **Plan** app ships as one installable bundle. A single install adds both Plan slash-command skills **and** wires up the hosted Plan MCP connector, so the agent can generate plans and the skills can publish them straight into the Plan app.
+The Agent-Native **Plan** app ships as one installable bundle. A single install adds the Plan slash-command skills **and** wires up the hosted Plan MCP connector, so the agent can generate plans and the skills can publish them straight into the Plan app.
 
 ## What you get {#what-you-get}
 
 One install gives you:
 
-- **Two skills** — `/visual-plan` (the canonical entry point) and `/visual-recap`.
+- **Three skills** — `/visual-plan` (the canonical entry point), `/visual-recap`, and `/visualize-repo`.
 - **The Plan MCP connector** — registered against the hosted app at `https://plan.agent-native.com` (MCP endpoint `https://plan.agent-native.com/_agent-native/mcp`, server name `plan`).
 
-<Diagram id="doc-block-i1sn3n" title="Three routes, one bundle" summary="The universal CLI, Claude Code plugin, and Codex plugin all install the same two skills plus the hosted Plan connector.">
+<Diagram id="doc-block-i1sn3n" title="Three routes, one bundle" summary="The universal CLI, Claude Code plugin, and Codex plugin all install the same Plan skills plus the hosted Plan connector.">
 
 ```html
 <div class="diagram-routes">
@@ -37,7 +37,8 @@ One install gives you:
   <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>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -78,9 +79,9 @@ One install gives you:
 
 </Diagram>
 
-By default, both skills publish to the hosted Plan app — they create a plan via
-the MCP connector and hand you a link or inline plan to review. They never dump
-an inline Markdown/ASCII plan into chat as the deliverable. If a Plan tool
+By default, `/visual-plan` and `/visual-recap` publish to the hosted Plan app —
+they create a plan via the MCP connector and hand you a link or inline plan to
+review. They never dump an inline Markdown/ASCII plan into chat as the deliverable. If a Plan tool
 returns `needs auth`, `Unauthorized`, or `Session terminated`, re-authenticate
 the connector instead of falling back to inline output. Access tokens are
 long-lived (30-day default, sliding 365-day refresh), so this should be rare;
@@ -194,13 +195,13 @@ There are three ways in. The **universal CLI route** is the one we recommend by
 
 ### Universal skill route (any MCP host) {#universal}
 
-Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs both skills, registers the hosted Plan MCP connector, **and runs auth for the selected local client(s) in the same step**, so your first tool call does not hit an OAuth wall:
+Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs the Plan skills, registers the hosted Plan MCP connector, **and runs auth for the selected local client(s) in the same step**, so your first tool call does not hit an OAuth wall:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-This installs `visual-plan` plus the companion `visual-recap` skill, then registers the `plan` connector, then runs auth (OAuth prompt for hosted/account-backed sharing). Useful flags:
+This installs `visual-plan` plus the companion `visual-recap` and `visualize-repo` skills, then registers the `plan` connector, then runs auth (OAuth prompt for hosted/account-backed sharing). Useful flags:
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — which local agents to write the MCP config for (default `all`).
 - `--no-connect` — register the connector without authenticating; run `npx @agent-native/core@latest connect https://plan.agent-native.com --client all` later, or choose a narrower `--client`.
@@ -236,7 +237,7 @@ The public `BuilderIO/agent-native` repo is itself a Claude Code plugin marketpl
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` adds both Plan skills and a **URL-only** MCP config (no secrets in the package); `/mcp` → **Authenticate** completes the OAuth handshake. Use the universal CLI route instead when you want local-files or self-hosted mode.
+`/plugin install` adds the Plan skills and a **URL-only** MCP config (no secrets in the package); `/mcp` → **Authenticate** completes the OAuth handshake. Use the universal CLI route instead when you want local-files or self-hosted mode.
 
 > The marketplace catalog is named `agent-native-apps` and the Plan plugin is `agent-native-visual-plans`, so the install target is always `agent-native-visual-plans@agent-native-apps`.
 

package/docs/content/sharing.mdx

@@ -5,7 +5,7 @@ description: "Google-Docs-style sharing, built into the framework. Every user-cr
 
 # Sharing & Privacy
 
-Every resource a user creates in an agent-native app — a document, a dashboard, a design, a deck, a video edit, a screen recording, a meeting transcript, a form, a booking link — is **private to the creator by default**. Other people see it only when the creator explicitly shares it, or changes its visibility to `org` or `public`.
+Every resource a user creates in an agent-native app — a document, a dashboard, a design, a deck, a screen recording, a meeting transcript, a form, a booking link — is **private to the creator by default**. Other people see it only when the creator explicitly shares it, or changes its visibility to `org` or `public`.
 
 It looks and works like Google Docs. The same share button, the same dialog, the same three-tier visibility model, the same per-user/per-org grants — across every template, with no per-app reinvention.
 
@@ -92,7 +92,6 @@ Every template that stores user-authored work uses this model. Concretely:
 - **Content** — documents
 - **Slides** — decks
 - **Design** — designs and assets
-- **Video** — compositions
 - **Clips** — screen recordings (Loom-style)
 - **Forms** — form definitions
 - **Calendar** — events and booking links

package/docs/content/skills-guide.mdx

@@ -120,9 +120,9 @@ Domain skills follow the same format as framework skills. They encode patterns s
 
 App-backed skills package an agent-native app as a skill marketplace artifact. The bundle can include agent instructions, exported skills, MCP connector metadata, hosted/local launch instructions, and UI surfaces such as MCP Apps.
 
-Current app-backed skills include `visual-plan` and `visual-recap` from Plan,
-`visual-edit` from Design, `assets` from Assets, and `content` for repo-backed
-docs/blog/MDX editing.
+Current app-backed skills include `visual-plan`, `visual-recap`, and
+`visualize-repo` from Plan, `visual-edit` from Design, `assets` from Assets, and
+`content` for repo-backed docs/blog/MDX editing.
 
 > **Full details below:** the mechanics of app-backed skills (manifest format, CLI commands, marketplace adapters, auto-update hashing) are covered in [App-backed skills — full details](#app-backed-skills-full).
 
@@ -332,6 +332,7 @@ offline work, or privacy-sensitive use.
 ```bash
 # Happy path: exported instructions plus hosted MCP connector.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/docs/content/template-plan.mdx

@@ -6,11 +6,11 @@ description: "Agent-Native Plans turns your coding agent's plan into a structure
 # Visual Plans
 
 > **Most people install Plan as a skill, not a scaffolded app.** One CLI command
-> adds the `/visual-plan` and `/visual-recap` skills plus the hosted Plan
-> connector to your coding agent — see [Plan plugin & marketplace](/docs/plan-plugin)
-> for the plugin and marketplace routes. Forking the Plan template (covered under
-> [For developers](#for-developers)) is the secondary path, for self-hosting or
-> building on Plan itself.
+> adds the `/visual-plan`, `/visual-recap`, and `/visualize-repo` skills plus
+> the hosted Plan connector to your coding agent — see
+> [Plan plugin & marketplace](/docs/plan-plugin) for the plugin and marketplace
+> routes. Forking the Plan template (covered under [For developers](#for-developers))
+> is the secondary path, for self-hosting or building on Plan itself.
 
 Agent-Native Plans is visual plan mode for coding agents. It turns an ordinary
 Codex, Claude Code, Markdown, or pasted implementation plan into a structured
@@ -115,7 +115,8 @@ hit an OAuth wall:
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-The command installs both commands: `/visual-plan` and `/visual-recap`.
+The command installs three commands: `/visual-plan`, `/visual-recap`, and
+`/visualize-repo`.
 
 If you are using a chat-based host that accepts MCP connector URLs directly
 (rather than a CLI-configured client), connect the hosted Plans connector at
@@ -358,6 +359,35 @@ and commenting, and returns the hosted URL. Local-files mode does not
 automatically make your coding agent's LLM local; choose a local or approved
 model if that privacy boundary matters too.
 
+## Repo visual docs {#visualize-repo}
+
+Use `/visualize-repo` when you want a durable visual documentation layer for a
+codebase instead of a one-off plan or recap. It creates or opens a local Plan
+MDX workspace, updates `agent-native.json` with an `apps.visualize-repo`
+local-files section, and serves the docs through the same localhost bridge:
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+If no `agent-native.json` exists, the command bootstraps one and recommends a
+small starter set from the repo structure, such as `actions/`,
+`app/components/`, `app/pages/`, `server/db/schema.ts`, `src/`, `packages/`,
+`templates/`, `docs/`, or `content/`. You can target specific source anchors:
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+The starter folder lives at `.agent-native/visual-docs/repo-overview` by
+default. Comments stay local in `comments.json`, so reviewers can mark sections
+for a coding agent and the agent can update both code and MDX in the same
+change. Run `visualize-repo check` for local lint, and `visualize-repo verify`
+when you want the Plan renderer schema to validate the MDX.
+
 ## Desktop local file sync {#desktop-local-sync}
 
 Agent Native Desktop also gives hosted Plans a native local-folder bridge. This
@@ -409,6 +439,7 @@ touch local files.
 - "Run `/visual-recap` on this PR so I can review the shape of the change first."
 - "Use `/visual-recap` on the diff between `main` and this branch."
 - "Use `/visual-recap` in local-files mode so no recap content is written to the Plan DB."
+- "Run `/visualize-repo` and start with our public API actions and schema."
 
 ## Recovering from auth errors {#auth-errors}
 

package/docs/content/tracking.mdx

@@ -235,7 +235,7 @@ Privacy defaults are intentionally conservative but still useful for playback:
 - URLs are scrubbed with the same `scrubUrl()` helper used by browser analytics.
 - Replay capture is web-only and opt-in; it does not record native desktop screens.
 
-While recording, session replay also captures browser console output (`log`, `info`, `warn`, `error`, `debug`, plus window `error` / `unhandledrejection`) and network request metadata (`fetch` and XHR) as tagged rrweb custom events, so agents and the replay viewer can debug user-reported issues. Capture is on by default when replay is enabled; tune or disable it with the `sessionReplay.console` and `sessionReplay.network` options, each accepting a boolean or an options object (`{ maxEvents?: number }`). Request/response bodies and headers are never captured, URLs are scrubbed, messages are truncated, the recorder's own ingest/tracking traffic is excluded, and per-session budgets (1000 console / 2000 network events) add a truncation notice when exceeded.
+While recording, session replay also captures browser console output (`log`, `info`, `warn`, `error`, `debug`, plus window `error` / `unhandledrejection`) and network request metadata (`fetch` and XHR) as tagged rrweb custom events, so agents and the replay viewer can debug user-reported issues. Capture is on by default when replay is enabled; tune or disable it with the `sessionReplay.console` and `sessionReplay.network` options, each accepting a boolean or an options object (`{ maxEvents?: number }`, with `network` additionally accepting `captureErrorBodies` and `maxErrorBodyLength`). Request bodies and headers are never captured; response bodies are captured only as a bounded, redacted snippet for 5xx (server error) responses (`captureErrorBodies`, default true, capped at `maxErrorBodyLength` chars, default 2048) — non-5xx and network-failure responses never carry a body. URLs are scrubbed, messages are truncated, the recorder's own ingest/tracking traffic is excluded, and per-session budgets (1000 console / 2000 network events) add a truncation notice when exceeded.
 
 The Analytics template stores replay metadata in SQL (`session_recordings`) and stores chunks through private blob refs (`session_replay_chunks`). Browsers and agents never receive provider URLs. Playback goes through scoped server routes and the default agent tools return summaries or bounded replay events, not raw chunk table access.
 

package/docs/content/workspace-connections.mdx

@@ -264,7 +264,7 @@ The initial provider ids are:
 | `google_drive` | search, import, docs           | brain, content, slides         |
 | `hubspot`      | search, import, crm            | analytics, brain, mail         |
 | `granola`      | search, import, meetings, docs | brain, calendar, dispatch      |
-| `clips`        | search, import, meetings       | brain, clips, videos           |
+| `clips`        | search, import, meetings       | brain, clips                   |
 | `generic`      | search, import, docs           | custom webhooks and file drops |
 
 Credential keys are names only, such as `SLACK_BOT_TOKEN` or `GITHUB_TOKEN`. Provider metadata must never include actual credential values.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.85.6",
+  "version": "0.86.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -204,8 +204,8 @@
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@react-router/dev": "^8.0.1",
-    "@react-router/fs-routes": "^8.0.1",
+    "@react-router/dev": "^8.1.0",
+    "@react-router/fs-routes": "^8.1.0",
     "@resvg/resvg-js": "^2.6.2",
     "@rrweb/record": "2.0.1",
     "@sentry/browser": "10.60.0",
@@ -280,8 +280,8 @@
     "@assistant-ui/tap": "^0.5.14",
     "@excalidraw/excalidraw": "0.18.1",
     "@excalidraw/mermaid-to-excalidraw": "2.2.2",
-    "@react-router/dev": "^8.0.1",
-    "@react-router/fs-routes": "^8.0.1",
+    "@react-router/dev": "^8.1.0",
+    "@react-router/fs-routes": "^8.1.0",
     "@supabase/supabase-js": "^2.49.0",
     "@tabler/icons-react": "^3.40.0",
     "@tailwindcss/typography": "^0.5.20",
@@ -309,7 +309,7 @@
     "playwright": "^1.61.1",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "react-router": "^8.0.1",
+    "react-router": "^8.1.0",
     "tailwindcss": "^4.2.4",
     "typescript": "^6.0.3",
     "vite": "8.1.0",