clickgo 7.3.1 → 7.4.0

package/doc/clickgo-rag.md

@@ -219,6 +219,34 @@ export default class extends clickgo.form.AbstractForm {
 
 `execute(this, name, args, { 'signal': signal })` 支持取消；执行回调通过第二个参数 `context.signal` 配合停止。取消不回滚已发生的修改，忽略 signal 的业务仍可继续，执行占用在回调实际结束后释放。context 包含 taskId、formId、panelId 和 source；source 的 user/agent 仅用于记录，不能作为授权凭据。
 
+## 原生导出文件
+
+应用将内置导出器生成的 Blob 交给 `context.createFile(blob, { fileName, mimeType? })`，再用 `success(data, [file])` 明确交付。框架不重新绘制文件，也不读取本机路径。示例使用文本，实际应用传入自己的 JPG、PDF 等成品 Blob：
+
+```ts
+clickgo.command.register(this, {
+    'name': 'document.export', 'description': 'Export the current document as text.',
+    'inputSchema': { 'type': 'object', 'additionalProperties': false },
+    'exposed': true,
+    'execute': (_args, context) => {
+        const blob = new Blob(['Example text\n'], { 'type': 'text/plain' });
+        const file = context.createFile(blob, { 'fileName': 'example.txt' });
+        return file === false ? clickgo.command.failure('export-failed', 'Could not retain the file')
+            : clickgo.command.success({ 'format': 'txt' }, [file]);
+    },
+});
+```
+
+- 成功结果的 `files` 位于 `data` 外，不参与 `outputSchema` 校验。元数据包含文件名、MIME、原始字节数、有效期、URI、`readCommand` 和 `readChunkSize`；框架使用自己的快照，拒绝伪造、重复或跨 App 句柄。
+- 文件保留 10 分钟，随所属 Panel、Form 或 App 销毁/`clear()` 释放。只允许执行中的 context 创建文件；失败、取消、无效输出或未放入结果的文件自动释放。私有命令的文件不会向代理公开。
+- 每个 App 最多保留 8 份、合计 128 MiB，单文件最多 64 MiB；参数、容量或计时器不可用时 `createFile()` 返回 false，不自动淘汰尚未取走的文件。
+- 应用可用 `releaseFile(this, fileId)` 主动释放旧缓存；Form/Panel 只能管理自身范围，App 可管理整个 App。释放不删除磁盘文件，客户端之后无法再读取该句柄。Demo 在新文件准备好后释放同 Form 的上一次导出，避免连续导出占满缓存。
+- App 首次通过公开命令交付文件后，框架为该 App 自动注册保留命令名 `clickgo.file.read`；它不是 `clickgo.file` 库，也不会为每个 App 启动 MCP 服务。应用不能注册同名命令。JS 和 WebMCP 按元数据调用它，传 `fileId`、`offset`（默认 0）、`length`（默认 49152，最多 393216）读取；每段返回 `file`、`offset`、`nextOffset`、`encoding: base64`、`data`。逐段解码再拼接字节，直到 nextOffset 为 null，避免将二进制输出到对话。
+- 文件按 `taskId + fileId` 隔离；`fileId` 使用 UUID，但不承担跨 App 授权。应用内 `command.execute(this, 'clickgo.file.read', args)` 从 this 取得 taskId；网页公开入口和外部 MCP 调用须提供目标 taskId。
+- Native 的 HTTP/stdio MCP 将同一结果转换为标准 `resource_link`；客户端使用 `resources/read` 获取原文件。URI 为 `clickgo-file:///task/{taskId}/{fileId}`，不是可公网访问的下载地址；不支持资源读取的客户端仍可调用公开的分段命令。缺少浏览器下载事件不代表生成失败。
+
+Demo 的 Library command → Export text file 演示完整流程。
+
 ## 浏览器代理与 WebMCP
 
 框架自动发布 `window['clickgo']['command']`，不需要业务另建桥接文件，也不依赖 WebMCP。代理按以下顺序调用：
@@ -252,7 +280,11 @@ WebMCP 可用时框架自动发布公开命令，无需连接按钮。通过 `aw
 | `publishedTaskIds` | 已完成工具发布的 App ID |
 | `onWebMcpStatusChanged(status)` | Boot、App、Form 接收同一页面级状态，无 taskId、无需 root |
 
-界面先读一次快照，再通过事件更新，无需轮询。事件不回放历史，App 命令变化或发布失败不触发该事件。`connectWebMcp(this)` 仅用于显式重试工具发布，失败返回 false；`disconnectWebMcp(this)` 撤销当前 App 工具，不改变页面状态，之后注册公开命令仍会自动发布。WebMCP 不支持或发布失败时，网页 JS 入口仍可使用。
+界面先读一次快照，再通过事件更新，无需轮询。事件不回放历史，App 命令变化或发布失败不触发该事件。
+
+公开命令注册或移除时框架自动同步，通常无需调用 `connectWebMcp(this)`。仅在发布失败需重试、主动撤销后需恢复，或浏览器稍后才提供 WebMCP 接口时调用；同一浏览器接口下保留已发布工具，只补齐缺失项，不重置 App 的命令或业务状态。发布失败返回 false。
+
+`disconnectWebMcp(this)` 撤销当前 App 工具，不改变页面状态，之后注册公开命令仍会自动发布。WebMCP 不支持或发布失败时，网页 JS 入口仍可使用。
 
 ## 自动生成 AI 接入说明
 
@@ -1154,6 +1186,16 @@ cell 之间的间距，默认 0。
 
 是否使用与 Tag 相同的朴素模式，默认 false。语义色和主题色使用柔和底色、对应文字色及边框；最终外观由主题决定。
 
+#### pulse
+
+`boolean` | `string`
+
+是否启用同色扩散光圈，默认 false。光圈随 `type` 的语义色或主题色变化，实心与朴素模式均支持；圆点、内容及布局尺寸不参与缩放。启用系统“减少动态效果”时显示静态光圈。
+
+这是布尔开关；`string` 仅兼容 XML 属性传值，并非动画名称或多种效果的枚举。可用 `pulse` 开启，或用 `:pulse="online"` 绑定布尔状态。
+
+光圈向组件外侧绘制，放在 Flow 等滚动容器内时需在滚动区域内部留出空间，避免被 overflow 裁切。
+
 #### sub
 
 `boolean` | `string`
@@ -1179,6 +1221,8 @@ cell 之间的间距，默认 0。
 ```xml
 <circle type="primary" size="xl">A</circle>
 <circle type="cg" size="xl" plain>A</circle>
+<circle type="primary" pulse></circle>
+<circle type="cg" :pulse="online"></circle>
 ```
 
 
@@ -1292,48 +1336,34 @@ cell 之间的间距，默认 0。
 ## cube
 ---
 
-立方体 3D 展示组件。
+独立的立方体设备标识，可用于列表、概览卡片或 Objviewer 节点的 icon 插槽。固定占位内以三个 SVG 平面构成三维立方体，按统一视点投影；不监听内容尺寸，也不参与父空间的连接与布局。
 
-### 参数
+鼠标悬停时立方体向上和向前抬升并轻微转动，顶面与侧面的边随透视共同变化；顶面插槽、扫光同步跟随，落地阴影留在原处并变得柔和。外层占位和连线端点保持不变。动效由 CSS 三维面结构管理，无计时器或动画回调依赖；减少动态效果时保持静止立体姿态并关闭扫光，仅保留色彩反馈。
 
-#### hue
+### 参数
 
-`string`
+#### type
 
-色调值，默认 `255`。
+`'default' | 'primary' | 'info' | 'warning' | 'danger' | 'cg'`，默认 `cg`。使用框架语义色和用户主题色，三面明度随主题表面变化。
 
 #### size
 
-`'xs'` | `'s'` | `'m'` | `'mh'` | `'l'` | `'lh'` | `'xl'` | `'xlh'`
+`'s' | 'm' | 'l' | 'xl'`，默认 `m`，固定占位分别为 `32 / 48 / 64 / 88px`。插槽不会撑大占位，请使用适当尺寸的 Icon 或简短文字。
 
-尺寸，默认 `s`。
-
-### 事件
-
-#### anistart
-
-`() => void`
-
-动画开始时触发。
-
-#### aniend
-
-`() => void`
-
-动画结束时触发。
-
-### 样式
-
-使用 CSS 3D 变换实现立方体效果。顶面可通过插槽自定义内容。
+### 插槽
 
-支持鼠标悬停动画效果。具有透视效果和平滑的动画。
+默认插槽显示在顶面中央。Cube 本身不承担选择或动画事件；点击与状态由外层 Button、列表项或 Objviewer-item 负责。
 
 ### 示例
 
 ```xml
-<cube hue="180" size="m" @anistart="onStart">Top</cube>
+<cube type="info" size="m"><icon name="cpu" size="s"></icon></cube>
+<objviewer-item node-id="server" variant="hub" label="Server" status="online">
+    <template v-slot:icon><cube type="cg"><icon name="cpu" size="s"></icon></cube></template>
+</objviewer-item>
 ```
 
+
 ## date
 ---
 
@@ -1351,7 +1381,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1359,6 +1389,14 @@ cell 之间的间距，默认 0。
 
 双向绑定，时间戳毫秒值。
 
+month 模式将值归一到所选时区的当月 1 日 00:00:00.000；外部传入日期也会归一并同步绑定值。固定 UTC 月初时传 `:tz="0"`，不依赖设备时区。
+
+#### mode
+
+`'date'` | `'month'`
+
+选择粒度，默认 date。month 只显示年份和月份，不提供日格或时间选择，并忽略 date、time、hourminute 参数；zone 和 tz 仍按原有规则工作。
+
 #### tz
 
 `number` | `string`
@@ -1381,13 +1419,13 @@ cell 之间的间距，默认 0。
 
 `number` | `string`
 
-可选开始时间。
+可选开始时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### end
 
 `number` | `string`
 
-可选结束时间。
+可选结束时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### date
 
@@ -1411,7 +1449,7 @@ cell 之间的间距，默认 0。
 
 `boolean` | `string`
 
-选择后是否自动关闭，默认 true。
+是否显示清空按钮，默认 true。
 
 ### 事件
 
@@ -1419,7 +1457,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDateChangedEvent) => void`
 
-值改变后触发，包含 `value`、`zone` 和 `dates` 信息。
+值改变后触发，包含 `before` 和 `value`。month 模式选中月份或清空时触发，归一化外部赋值不视为用户选择。
 
 #### yearmonthchanged
 
@@ -1439,8 +1477,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <date v-model="timestamp"></date>
+<date mode="month" v-model="monthTimestamp" :tz="0"></date>
 ```
 
+
 ## datepanel
 ---
 
@@ -1464,7 +1504,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1472,17 +1512,25 @@ cell 之间的间距，默认 0。
 
 双向绑定，时间戳值（毫秒）。
 
+month 模式归一到所选时区的当月 1 日 00:00:00.000；外部传入日期也会归一并同步绑定值。
+
+#### mode
+
+`'date'` | `'month'`
+
+选择粒度，默认 date。month 使用年份导航和十二个月份按钮，隐藏日格与时间选择，忽略 time、hourminute、range 和 cursor。月份按钮复用全部内置语种的月份名称。
+
 #### start
 
 `number` | `string`
 
-可选开始时间（秒/毫秒）。
+可选开始时间（秒/毫秒）。month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### end
 
 `number` | `string`
 
-可选结束时间（秒/毫秒）。
+可选结束时间（秒/毫秒）。month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### tz
 
@@ -1562,7 +1610,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDatepanelSelectedEvent) => void`
 
-选中日期时触发。
+选中日期时触发。month 模式的 date 固定为 1，month 仍从 0 开始，time 为所选时区的月初毫秒时间戳。
 
 #### range
 
@@ -1582,8 +1630,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <datepanel v-model="timestamp" time></datepanel>
+<datepanel mode="month" v-model="monthTimestamp" :tz="0"></datepanel>
 ```
 
+
 ## daterange
 ---
 
@@ -6192,121 +6242,142 @@ noVNC 远程桌面组件。
 ## objviewer
 ---
 
-对象查看器组件，用于在可缩放的画布上展示内容。
+节点关系空间。以稳定 ID 声明节点与连接，自动布局和尺寸测量在控件内部完成；平移、滚轮、双指缩放和视口适应复用 Panzoom。不是 3D 场景或流程编辑器。
 
 ### 参数
 
-#### direction
+#### edges
 
-`'h'` | `'v'`
+`clickgo.control.IObjviewerEdge[]`，默认 `[]`。每条连接含 `source`、`target` 节点 ID，可选 `label`、`status`（`default / online / warning / offline`）。端点不存在时暂不绘制，恢复节点后自动出现。状态与是否启用动画均由应用提供，不从端点猜测。
 
-布局方向，默认 `h`。
+每条连接可独立设置动画：
+
+- `animation`：`none / dash / dots`，默认 `none`；分别为静止连接、流动虚线、静止底线上的多个移动圆点。颜色跟随连接状态，选中关联节点时使用主题色。
+- `direction`：`forward / reverse / both`，默认 `forward`；分别沿 source → target、target → source、同时双向流动。仅改变动画，不交换节点关系或改变布局。
+- `duration`：周期秒数，默认 `3`，限制为 `0.25–60`；dots 为圆点走完整条路径的时间，dash 为虚线纹理的一个动画周期。
+- `dotCount`：dots 模式每个方向的圆点数，默认 `3`，取整并限制为 `1–8`。圆点均匀错开，双向时两组错开半个间隔。
+
+路径随节点、容器与布局变化更新；减少动态效果时隐藏移动圆点并停止虚线动画，保留静止连接。
+
+#### layout
+
+`'auto' | 'radial' | 'tree' | 'manual'`，默认 `auto`。自动模式在 600px 以下容器改为紧凑纵排与侧边关系线，宽容器使用环形。显式 radial 固定环形，以节点的可视标识中心定位；tree 分层适合设备树和依赖概览；manual 使用各节点的 x/y。支持环、孤立节点与多个连通分量，不持续运行力模拟。非紧凑布局使用直线；中心节点的标识与说明共同决定端点，连线遇到说明时止于说明外缘，不穿字或局部绕行。不提供通用避障路由或端口编辑。
+
+#### root
+
+`string`，默认空。优先根节点 ID；未提供时优先无入边节点，再选择连接较多的节点。
+
+#### gap
+
+`number | string`，默认 `48`，环形和分层布局的最小间隔，单位 CSS 像素，限制为 `24–400`。紧凑模式的纵向间隔固定为 24px。
 
 #### bg
 
-`'dot'` | `'grid'`
+`'none' | 'dot' | 'grid'`，默认 `none`。
+
+#### modelValue
 
-背景样式，默认 `dot`。
+`string`，当前选中节点 ID，默认空，可用 v-model。移除选中节点时清空绑定，不触发 select。
 
-#### gutter
+#### disabled
 
-`number` | `string`
+`boolean | string`，默认 false，禁用视图手势、工具栏和节点选择。
 
-子元素间距。
+#### label
 
-#### alignH
+`string`，空间无障碍名称，由应用提供本地化文案。
 
-`string` | `undefined`
+### 事件
 
-水平对齐方式。
+#### select
 
-#### alignV
+`clickgo.control.IObjviewerSelectEvent`：`detail: {nodeId, label}`。点击、Enter 或空格激活不同的可操作节点时触发；重复选择不触发。控件不执行业务跳转。
 
-`string` | `undefined`
+### 方法
 
-垂直对齐方式。
+- `fit()`：恢复完整显示，之后随视口缩放继续适应。
+- `zoom(factor)`：围绕视口中心按相对比例缩放，如 `1.2`。用户缩放/平移后调整窗口保持当前比例和中心；内容边界变化重新适应。
 
-### 样式
+### 插槽与尺寸
 
-支持缩放和平移的画布容器。背景可显示点阵或网格。
+默认插槽仅放直属 objviewer-item，可用 v-for/v-if。节点 ID 必须非空且唯一；无效项隐藏，重复 ID 只使用第一项。`empty` 插槽自定义空态。
 
-可在内部放置 objviewer-item 子组件，支持连接线绘制。
+给容器明确高度或 flex 剩余空间；场景按真实节点尺寸及 48px 留白计算，不用屏幕坐标反推，也无需 addLine、动画回调或延时 refresh。首次完整显示，大图可通过工具栏/手势放大查看文字。0 大小或隐藏视口恢复后自动适应；减少动态效果时连接静止。
 
 ### 示例
 
 ```xml
-<objviewer>
-    <objviewer-item label="Item 1">Content</objviewer-item>
+<objviewer :edges="[{source: 'gateway', target: 'device', status: 'online', animation: 'dots', direction: 'both', duration: 3, dotCount: 3}]" root="gateway" v-model="selected" style="height:420px;">
+    <objviewer-item node-id="gateway" variant="hub" label="Gateway" status="online" icon="cpu"></objviewer-item>
+    <objviewer-item node-id="device" label="Device" description="Branch office" status="online"></objviewer-item>
 </objviewer>
 ```
 
+
 ## objviewer-item
 ---
 
-对象查看器项组件。
+Objviewer 的直属节点。节点自己显示内容和状态，父空间负责位置与连接；不再承担通用 Layout 的职责。
 
 ### 参数
 
-#### hue
-
-`string`
+#### nodeId
 
-色调值，默认 `255`。
-
-#### hover
+`string`，默认空，必填的稳定唯一 ID，用于连接和选择。不使用 ref 或 DOM 引用作为端点。
 
-`boolean` | `string`
-
-是否启用悬停效果，默认 false。
+#### label
 
-#### direction
+`string`，名称，默认空，空时显示 nodeId。
 
-`'h'` | `'v'`
+#### description
 
-布局方向，默认 `h`。
+`string`，辅助说明，默认空，可显示地址、位置、数量等。
 
-#### border
+#### icon
 
-`'solid'` | `'dotted'` | `'dashed'` | `'ani'`
+`string`，框架图标名称，默认空。hub 未提供时显示 cpu。
 
-边框样式，默认 `solid`。
+#### status
 
-#### gutter
+`'default' | 'online' | 'warning' | 'offline'`，默认 `default`。状态通过圆点与本地化文字共同表达，不只依靠颜色；语义色跟随主题。
 
-`number` | `string`
+#### statusLabel
 
-子元素间距。
+`string`，默认空，覆盖状态文字，应用可用于“维护中”等业务状态说明。
 
-#### alignH
+#### variant
 
-`string` | `undefined`
+`'card' | 'hub'`，默认 `card`。卡片为 184px 宽、自然高度；中心节点为 144px 宽，含 72px 圆形标识。名称/描述自动换行，自定义内容的尺寸变化自动通知空间。父空间自动切换紧凑模式时优先展示名称和状态，辅助说明及卡片图标收起；完整说明保留在无障碍描述，应用也可根据选中 ID 显示详情。
 
-水平对齐方式。
+#### pulse
 
-#### alignV
+`boolean | string`，默认 true，仅 online 状态显示 Circle 的同色光圈；减少动态效果时静止。
 
-`string` | `undefined`
+#### disabled
 
-垂直对齐方式。
+`boolean | string`，默认 false，禁止鼠标和键盘选择，状态与内容仍可见。
 
-#### label
+#### x
 
-`string`
+`number | string`，默认 `0`，manual 布局下的内容水平坐标。
 
-标签文本。
+#### y
 
-### 样式
+`number | string`，默认 `0`，manual 布局下的内容垂直坐标。坐标可为负数，空间统一归一化并留白。
 
-作为 objviewer 的子组件，显示单个卡片项。
+### 插槽
 
-支持不同的边框样式和色调。可显示标签文本。
+`icon` 自定义标识，可放 Icon、Cube 或图片；默认插槽在说明下增加内容。节点内独立按钮/输入不触发节点选择。选择事件由 Objviewer 统一发出。
 
 ### 示例
 
 ```xml
-<objviewer-item label="Item 1">Content</objviewer-item>
+<objviewer-item node-id="worker" label="Background worker" status="warning" description="Queue waiting">
+    <tag type="warning" plain size="xs">12 jobs</tag>
+</objviewer-item>
 ```
 
+
 ## page
 ---
 
@@ -7535,6 +7606,14 @@ Enter/Space 请求切换一次展开状态；忽略持续按住时的重复事
 
 禁用可点击项，默认 `false`；禁用时不参与 Tab 导航、不触发 `click`。
 
+### 事件
+
+#### tap
+
+`(event: MouseEvent | KeyboardEvent): void`
+
+可点击项通过鼠标点击、Enter 按下或 Space 释放时触发，参数为原始事件。应用模板使用 `@click` 绑定，框架内部对应 `tap`；普通项或禁用项不触发。
+
 ### 示例
 
 ```xml
@@ -10978,7 +11057,7 @@ lib/command/functions/clear.md
 
 > **clear**(`current`): `void`
 
-Defined in: [lib/command.ts:332](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L332)
+Defined in: [lib/command.ts:89](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L89)
 
 清理所属 Panel、Form 或整个任务的命令
 
@@ -11009,7 +11088,7 @@ lib/command/functions/clearOwner.md
 
 > **clearOwner**(`taskId`, `formId?`, `panelId?`): `void`
 
-Defined in: [lib/command.ts:345](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L345)
+Defined in: [lib/command.ts:101](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L101)
 
 **`Internal`**
 
@@ -11054,9 +11133,12 @@ lib/command/functions/connectWebMcp.md
 
 > **connectWebMcp**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/command.ts:618](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L618)
+Defined in: [lib/command.ts:195](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L195)
 
-显式重同步或重试当前 App 的工具发布；页面接入由框架自动管理
+手动将当前 App 已公开的命令发布到浏览器 WebMCP
+公开命令注册或移除时框架自动同步，通常无需调用。
+仅在发布失败需重试、主动撤销后需恢复，或浏览器稍后才提供 WebMCP 接口时调用。
+同一浏览器接口下保留已发布工具，只补齐缺失项；不重置 App 的命令或业务状态。
 
 ## Parameters
 
@@ -11070,7 +11152,7 @@ Defined in: [lib/command.ts:618](https://github.com/maiyun/clickgo/blob/master/d
 
 `Promise`\<`boolean`\>
 
-是否同步成功；浏览器不支持、App 已退出或注册失败时返回 false
+是否发布成功；浏览器不支持、App 已退出、发布中途撤销或注册失败时返回 false
 
 lib/command/functions/createBridge.md
 ---
@@ -11085,7 +11167,7 @@ lib/command/functions/createBridge.md
 
 > **createBridge**(`current`): [`IBridge`](../interfaces/IBridge.md)
 
-Defined in: [lib/command.ts:557](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L557)
+Defined in: [lib/command.ts:175](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L175)
 
 创建绑定单个 App 的可复用代理接口，调用方无需反复传入 taskId
 
@@ -11116,7 +11198,7 @@ lib/command/functions/createPageBridge.md
 
 > **createPageBridge**(): [`IPageBridge`](../interfaces/IPageBridge.md)
 
-Defined in: [lib/command.ts:571](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L571)
+Defined in: [lib/command.ts:183](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L183)
 
 网页入口直接读取框架的任务及命令状态，无需应用或宿主重复发布与清理
 
@@ -11139,7 +11221,7 @@ lib/command/functions/disconnectWebMcp.md
 
 > **disconnectWebMcp**(`current`): `void`
 
-Defined in: [lib/command.ts:628](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L628)
+Defined in: [lib/command.ts:204](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L204)
 
 撤销当前 App 的 WebMCP 工具；不改变页面级接入状态，下次公开命令注册时自动发布
 
@@ -11168,9 +11250,9 @@ lib/command/functions/executeAgent.md
 
 # Function: executeAgent()
 
-> **executeAgent**(`taskId`, `name`, `args?`, `options?`): `Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
+> **executeAgent**(`taskId`, `name`, `args?`, `options?`): `Promise`\<[`TResult`](../type-aliases/TResult.md)\>
 
-Defined in: [lib/command.ts:547](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L547)
+Defined in: [lib/command.ts:165](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L165)
 
 代理直接按 taskId 执行公开命令，与界面共用校验和业务执行器
 
@@ -11204,7 +11286,7 @@ Defined in: [lib/command.ts:547](https://github.com/maiyun/clickgo/blob/master/d
 
 ## Returns
 
-`Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
+`Promise`\<[`TResult`](../type-aliases/TResult.md)\>
 
 结构化结果；未公开或不存在的命令返回 not-found
 
@@ -11219,9 +11301,9 @@ lib/command/functions/execute.md
 
 # Function: execute()
 
-> **execute**(`current`, `name`, `args?`, `options?`): `Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
+> **execute**(`current`, `name`, `args?`, `options?`): `Promise`\<[`TResult`](../type-aliases/TResult.md)\>
 
-Defined in: [lib/command.ts:534](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L534)
+Defined in: [lib/command.ts:152](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L152)
 
 应用界面直接执行已注册的业务命令
 
@@ -11255,7 +11337,7 @@ Defined in: [lib/command.ts:534](https://github.com/maiyun/clickgo/blob/master/d
 
 ## Returns
 
-`Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
+`Promise`\<[`TResult`](../type-aliases/TResult.md)\>
 
 业务结果
 
@@ -11272,7 +11354,7 @@ lib/command/functions/failure.md
 
 > **failure**(`code`, `message`): [`TResult`](../type-aliases/TResult.md)\<`never`\>
 
-Defined in: [lib/command.ts:203](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L203)
+Defined in: [lib/command.ts:48](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L48)
 
 构造业务失败结果，不抛异常
 
@@ -11309,7 +11391,7 @@ lib/command/functions/getAgentGuide.md
 
 > **getAgentGuide**(`current?`, `options?`): `Promise`\<`string` \| `false` \| `null`\>
 
-Defined in: [lib/command.ts:446](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L446)
+Defined in: [lib/command.ts:139](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L139)
 
 生成简短英文接入说明，不嵌入临时 App ID；代理通过接口实时发现
 
@@ -11346,7 +11428,7 @@ lib/command/functions/getAgentInfo.md
 
 > **getAgentInfo**(`current?`, `options?`): `Promise`\<`false` \| [`IAgentInfo`](../interfaces/IAgentInfo.md) \| `null`\>
 
-Defined in: [lib/command.ts:399](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L399)
+Defined in: [lib/command.ts:128](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L128)
 
 获取当前环境的统一接入信息，不另行维护命令清单或启用服务
 
@@ -11383,7 +11465,7 @@ lib/command/functions/init.md
 
 > **init**(): `void`
 
-Defined in: [lib/command.ts:184](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L184)
+Defined in: [lib/command.ts:28](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L28)
 
 初始化页面级 WebMCP 接入状态，由框架在执行 Boot.main 前自动调用
 
@@ -11406,7 +11488,7 @@ lib/command/functions/list.md
 
 > **list**(`current`): [`IInfo`](../interfaces/IInfo.md)[]
 
-Defined in: [lib/command.ts:362](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L362)
+Defined in: [lib/command.ts:110](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L110)
 
 获取独立元数据和当前状态，不导出业务函数
 
@@ -11437,7 +11519,7 @@ lib/command/functions/listTasks.md
 
 > **listTasks**(): `object`[]
 
-Defined in: [lib/command.ts:386](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L386)
+Defined in: [lib/command.ts:118](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L118)
 
 获取仍可调用的 App 标识与名称，供网页及 Native 代理发现目标
 
@@ -11460,7 +11542,7 @@ lib/command/functions/register.md
 
 > **register**\<`T`\>(`current`, `definition`): `boolean`
 
-Defined in: [lib/command.ts:254](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L254)
+Defined in: [lib/command.ts:68](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L68)
 
 注册命令；重复名称、不支持的 schema 或已销毁的实例返回 false
 
@@ -11490,6 +11572,43 @@ Defined in: [lib/command.ts:254](https://github.com/maiyun/clickgo/blob/master/d
 
 是否注册成功
 
+lib/command/functions/releaseFile.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/command](../index.md) / releaseFile
+
+# Function: releaseFile()
+
+> **releaseFile**(`current`, `fileId`): `boolean`
+
+Defined in: [lib/command.ts:58](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L58)
+
+主动释放旧导出的缓存，释放后代理不能继续读取；不删除磁盘文件
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+文件所属的 App/Form/Panel，Form/Panel 只能释放自身范围
+
+### fileId
+
+`string`
+
+先前交付的文件标识
+
+## Returns
+
+`boolean`
+
+是否找到并释放，已释放或不属于当前范围为 false
+
 lib/command/functions/showPalette.md
 ---
 
@@ -11540,9 +11659,9 @@ lib/command/functions/success.md
 
 # Function: success()
 
-> **success**\<`T`\>(`data`): [`TResult`](../type-aliases/TResult.md)\<`T`\>
+> **success**\<`T`\>(`data`, `files?`): [`TResult`](../type-aliases/TResult.md)\<`T`\>
 
-Defined in: [lib/command.ts:193](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L193)
+Defined in: [lib/command.ts:38](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L38)
 
 构造成功结果
 
@@ -11560,6 +11679,12 @@ Defined in: [lib/command.ts:193](https://github.com/maiyun/clickgo/blob/master/d
 
 可跨入口传输的 JSON 数据
 
+### files?
+
+[`IFileInfo`](../interfaces/IFileInfo.md)[]
+
+本次命令明确交付的框架文件，可省略；不能传入其他 App 的文件
+
 ## Returns
 
 [`TResult`](../type-aliases/TResult.md)\<`T`\>
@@ -11579,7 +11704,7 @@ lib/command/functions/unregister.md
 
 > **unregister**(`current`, `name`): `boolean`
 
-Defined in: [lib/command.ts:307](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L307)
+Defined in: [lib/command.ts:80](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L80)
 
 取消尚在执行的命令并解除注册；取消是协作式，不回滚已产生的业务效果
 
@@ -11621,6 +11746,9 @@ lib/command/index.md
 - [IBridge](interfaces/IBridge.md)
 - [IContext](interfaces/IContext.md)
 - [IDefinition](interfaces/IDefinition.md)
+- [IFileChunk](interfaces/IFileChunk.md)
+- [IFileInfo](interfaces/IFileInfo.md)
+- [IFileOptions](interfaces/IFileOptions.md)
 - [IInfo](interfaces/IInfo.md)
 - [IMetadata](interfaces/IMetadata.md)
 - [IPageBridge](interfaces/IPageBridge.md)
@@ -11650,6 +11778,7 @@ lib/command/index.md
 - [list](functions/list.md)
 - [listTasks](functions/listTasks.md)
 - [register](functions/register.md)
+- [releaseFile](functions/releaseFile.md)
 - [showPalette](functions/showPalette.md)
 - [success](functions/success.md)
 - [unregister](functions/unregister.md)
@@ -11665,7 +11794,7 @@ lib/command/interfaces/IAgentInfo.md
 
 # Interface: IAgentInfo
 
-Defined in: [lib/command.ts:132](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L132)
+Defined in: [lib/command/types.ts:134](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L134)
 
 可展示或导出的接入信息；命令列表始终从对应入口实时查询
 
@@ -11675,7 +11804,7 @@ Defined in: [lib/command.ts:132](https://github.com/maiyun/clickgo/blob/master/d
 
 > **apps**: `object`[]
 
-Defined in: [lib/command.ts:134](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L134)
+Defined in: [lib/command/types.ts:136](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L136)
 
 #### id
 
@@ -11691,7 +11820,7 @@ Defined in: [lib/command.ts:134](https://github.com/maiyun/clickgo/blob/master/d
 
 > **browser**: `object`
 
-Defined in: [lib/command.ts:136](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L136)
+Defined in: [lib/command/types.ts:138](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L138)
 
 #### api
 
@@ -11707,7 +11836,7 @@ Defined in: [lib/command.ts:136](https://github.com/maiyun/clickgo/blob/master/d
 
 > **http**: [`IMcpInfo`](../../native/interfaces/IMcpInfo.md) \| `null`
 
-Defined in: [lib/command.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L148)
+Defined in: [lib/command/types.ts:150](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L150)
 
 只有显式导出且通过 root 检查时才包含 HTTP 凭据
 
@@ -11717,7 +11846,7 @@ Defined in: [lib/command.ts:148](https://github.com/maiyun/clickgo/blob/master/d
 
 > **native**: [`ICommandEntry`](../../native/interfaces/ICommandEntry.md) \| `null`
 
-Defined in: [lib/command.ts:146](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L146)
+Defined in: [lib/command/types.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L148)
 
 ***
 
@@ -11725,7 +11854,7 @@ Defined in: [lib/command.ts:146](https://github.com/maiyun/clickgo/blob/master/d
 
 > **schemaVersion**: `1`
 
-Defined in: [lib/command.ts:133](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L133)
+Defined in: [lib/command/types.ts:135](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L135)
 
 ***
 
@@ -11733,7 +11862,7 @@ Defined in: [lib/command.ts:133](https://github.com/maiyun/clickgo/blob/master/d
 
 > **targetTaskId**: `string` \| `null`
 
-Defined in: [lib/command.ts:135](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L135)
+Defined in: [lib/command/types.ts:137](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L137)
 
 ***
 
@@ -11741,7 +11870,7 @@ Defined in: [lib/command.ts:135](https://github.com/maiyun/clickgo/blob/master/d
 
 > **webMcp**: `object`
 
-Defined in: [lib/command.ts:137](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L137)
+Defined in: [lib/command/types.ts:139](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L139)
 
 #### publishedTaskIds
 
@@ -11776,7 +11905,7 @@ lib/command/interfaces/IAgentOptions.md
 
 # Interface: IAgentOptions
 
-Defined in: [lib/command.ts:120](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L120)
+Defined in: [lib/command/types.ts:122](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L122)
 
 统一接入说明的生成选项；默认不读取或包含 HTTP 凭据
 
@@ -11786,7 +11915,7 @@ Defined in: [lib/command.ts:120](https://github.com/maiyun/clickgo/blob/master/d
 
 > `optional` **includeMcpCredentials?**: `boolean`
 
-Defined in: [lib/command.ts:122](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L122)
+Defined in: [lib/command/types.ts:124](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L124)
 
 仅供应用主动导出 HTTP 连接设置，仍要求当前 App 已有 root 权限
 
@@ -11801,7 +11930,7 @@ lib/command/interfaces/IBridge.md
 
 # Interface: IBridge
 
-Defined in: [lib/command.ts:103](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L103)
+Defined in: [lib/command/types.ts:105](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L105)
 
 绑定一个应用实例，只能调用该实例明确公开的命令
 
@@ -11811,7 +11940,7 @@ Defined in: [lib/command.ts:103](https://github.com/maiyun/clickgo/blob/master/d
 
 > **execute**: (`name`, `args?`, `options?`) => `Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
 
-Defined in: [lib/command.ts:106](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L106)
+Defined in: [lib/command/types.ts:108](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L108)
 
 #### Parameters
 
@@ -11839,7 +11968,7 @@ Defined in: [lib/command.ts:106](https://github.com/maiyun/clickgo/blob/master/d
 
 > **list**: () => [`IInfo`](IInfo.md)[]
 
-Defined in: [lib/command.ts:105](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L105)
+Defined in: [lib/command/types.ts:107](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L107)
 
 #### Returns
 
@@ -11851,7 +11980,7 @@ Defined in: [lib/command.ts:105](https://github.com/maiyun/clickgo/blob/master/d
 
 > **taskId**: `string`
 
-Defined in: [lib/command.ts:104](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L104)
+Defined in: [lib/command/types.ts:106](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L106)
 
 lib/command/interfaces/IContext.md
 ---
@@ -11864,17 +11993,48 @@ lib/command/interfaces/IContext.md
 
 # Interface: IContext
 
-Defined in: [lib/command.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L51)
+Defined in: [lib/command/types.ts:45](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L45)
 
 执行来源仅用于展示与记录，不是授权凭证
 
 ## Properties
 
+### createFile
+
+> **createFile**: (`blob`, `options`) => `false` \| [`IFileInfo`](IFileInfo.md)
+
+Defined in: [lib/command/types.ts:58](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L58)
+
+保留已生成文件；用 success(data, [file]) 明确交付，不读取路径或重新生成
+
+#### Parameters
+
+##### blob
+
+`Blob`
+
+原文件，单份最多 64 MiB；每个 App 最多 8 份、合计 128 MiB
+
+##### options
+
+[`IFileOptions`](IFileOptions.md)
+
+文件名及可选 MIME，默认使用 Blob.type 或 application/octet-stream
+
+#### Returns
+
+`false` \| [`IFileInfo`](IFileInfo.md)
+
+十分钟有效的独立句柄，随所属范围销毁；参数/容量无效返回 false
+仅在本次执行中有效；失败、取消、无效输出及未交付的文件自动释放，私有命令不公开文件
+
+***
+
 ### formId
 
 > **formId**: `string`
 
-Defined in: [lib/command.ts:53](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L53)
+Defined in: [lib/command/types.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L47)
 
 ***
 
@@ -11882,7 +12042,7 @@ Defined in: [lib/command.ts:53](https://github.com/maiyun/clickgo/blob/master/di
 
 > **panelId**: `string`
 
-Defined in: [lib/command.ts:54](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L54)
+Defined in: [lib/command/types.ts:48](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L48)
 
 ***
 
@@ -11890,7 +12050,7 @@ Defined in: [lib/command.ts:54](https://github.com/maiyun/clickgo/blob/master/di
 
 > **signal**: `AbortSignal`
 
-Defined in: [lib/command.ts:56](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L56)
+Defined in: [lib/command/types.ts:50](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L50)
 
 ***
 
@@ -11898,7 +12058,7 @@ Defined in: [lib/command.ts:56](https://github.com/maiyun/clickgo/blob/master/di
 
 > **source**: `"user"` \| `"agent"`
 
-Defined in: [lib/command.ts:55](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L55)
+Defined in: [lib/command/types.ts:49](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L49)
 
 ***
 
@@ -11906,7 +12066,7 @@ Defined in: [lib/command.ts:55](https://github.com/maiyun/clickgo/blob/master/di
 
 > **taskId**: `string`
 
-Defined in: [lib/command.ts:52](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L52)
+Defined in: [lib/command/types.ts:46](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L46)
 
 lib/command/interfaces/IDefinition.md
 ---
@@ -11919,7 +12079,7 @@ lib/command/interfaces/IDefinition.md
 
 # Interface: IDefinition\<T\>
 
-Defined in: [lib/command.ts:79](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L79)
+Defined in: [lib/command/types.ts:81](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L81)
 
 应用声明一次，界面、浏览器代理和 Native 适配器共享执行函数
 
@@ -11939,7 +12099,7 @@ Defined in: [lib/command.ts:79](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **annotations?**: `object`
 
-Defined in: [lib/command.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L67)
+Defined in: [lib/command/types.ts:69](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L69)
 
 行为说明，不代替校验或授权
 
@@ -11979,7 +12139,7 @@ WebMCP 的重要或不可逆现实效果说明
 
 > `optional` **concurrent?**: `boolean`
 
-Defined in: [lib/command.ts:83](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L83)
+Defined in: [lib/command/types.ts:85](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L85)
 
 默认拒绝同一命令并发；业务确认可并行时才开启
 
@@ -11989,7 +12149,7 @@ Defined in: [lib/command.ts:83](https://github.com/maiyun/clickgo/blob/master/di
 
 > **description**: `string`
 
-Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L63)
+Defined in: [lib/command/types.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L65)
 
 #### Inherited from
 
@@ -12001,7 +12161,7 @@ Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **enabled?**: () => `string` \| `boolean`
 
-Defined in: [lib/command.ts:87](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L87)
+Defined in: [lib/command/types.ts:89](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L89)
 
 true 为可用，false 或原因文本为不可用；每次执行重新检查
 
@@ -12015,7 +12175,7 @@ true 为可用，false 或原因文本为不可用；每次执行重新检查
 
 > **execute**: (`args`, `context`) => [`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\> \| `Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
 
-Defined in: [lib/command.ts:88](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L88)
+Defined in: [lib/command/types.ts:90](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L90)
 
 #### Parameters
 
@@ -12037,7 +12197,7 @@ Defined in: [lib/command.ts:88](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **exposed?**: `boolean`
 
-Defined in: [lib/command.ts:81](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L81)
+Defined in: [lib/command/types.ts:83](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L83)
 
 明确允许代理发现并调用；默认只允许应用内部调用
 
@@ -12047,7 +12207,7 @@ Defined in: [lib/command.ts:81](https://github.com/maiyun/clickgo/blob/master/di
 
 > **inputSchema**: [`ISchema`](ISchema.md) & `object`
 
-Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L64)
+Defined in: [lib/command/types.ts:66](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L66)
 
 #### Type Declaration
 
@@ -12065,7 +12225,7 @@ Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/di
 
 > **name**: `string`
 
-Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L61)
+Defined in: [lib/command/types.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L63)
 
 #### Inherited from
 
@@ -12077,7 +12237,7 @@ Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **outputSchema?**: [`ISchema`](ISchema.md)
 
-Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L65)
+Defined in: [lib/command/types.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L67)
 
 #### Inherited from
 
@@ -12089,7 +12249,7 @@ Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **permissions?**: `string`[]
 
-Defined in: [lib/command.ts:85](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L85)
+Defined in: [lib/command/types.ts:87](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L87)
 
 必须已经取得的框架权限；执行入口不弹授权窗
 
@@ -12099,12 +12259,187 @@ Defined in: [lib/command.ts:85](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **title?**: `string`
 
-Defined in: [lib/command.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L62)
+Defined in: [lib/command/types.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L64)
 
 #### Inherited from
 
 [`IMetadata`](IMetadata.md).[`title`](IMetadata.md#title)
 
+lib/command/interfaces/IFileChunk.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/command](../index.md) / IFileChunk
+
+# Interface: IFileChunk
+
+Defined in: [lib/command/file.ts:48](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L48)
+
+每段携带同一份快照信息，便于客户端校验文件及交付状态
+
+## Properties
+
+### data
+
+> **data**: `string`
+
+Defined in: [lib/command/file.ts:53](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L53)
+
+***
+
+### encoding
+
+> **encoding**: `"base64"`
+
+Defined in: [lib/command/file.ts:52](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L52)
+
+***
+
+### file
+
+> **file**: [`IFileInfo`](IFileInfo.md)
+
+Defined in: [lib/command/file.ts:49](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L49)
+
+***
+
+### nextOffset
+
+> **nextOffset**: `number` \| `null`
+
+Defined in: [lib/command/file.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L51)
+
+***
+
+### offset
+
+> **offset**: `number`
+
+Defined in: [lib/command/file.ts:50](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L50)
+
+lib/command/interfaces/IFileInfo.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/command](../index.md) / IFileInfo
+
+# Interface: IFileInfo
+
+Defined in: [lib/command/file.ts:28](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L28)
+
+文件快照元数据；时间为 Unix 毫秒，URI 仅在所属页面生命周期内有效
+
+## Properties
+
+### byteLength
+
+> **byteLength**: `number`
+
+Defined in: [lib/command/file.ts:32](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L32)
+
+***
+
+### createdAt
+
+> **createdAt**: `number`
+
+Defined in: [lib/command/file.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L33)
+
+***
+
+### expiresAt
+
+> **expiresAt**: `number`
+
+Defined in: [lib/command/file.ts:34](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L34)
+
+***
+
+### fileId
+
+> **fileId**: `string`
+
+Defined in: [lib/command/file.ts:29](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L29)
+
+***
+
+### fileName
+
+> **fileName**: `string`
+
+Defined in: [lib/command/file.ts:30](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L30)
+
+***
+
+### mimeType
+
+> **mimeType**: `string`
+
+Defined in: [lib/command/file.ts:31](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L31)
+
+***
+
+### readChunkSize
+
+> **readChunkSize**: `number`
+
+Defined in: [lib/command/file.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L37)
+
+***
+
+### readCommand
+
+> **readCommand**: `string`
+
+Defined in: [lib/command/file.ts:36](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L36)
+
+***
+
+### uri
+
+> **uri**: `string`
+
+Defined in: [lib/command/file.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L35)
+
+lib/command/interfaces/IFileOptions.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/command](../index.md) / IFileOptions
+
+# Interface: IFileOptions
+
+Defined in: [lib/command/file.ts:21](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L21)
+
+发布的是已生成 Blob，不读取路径、不上传或重新生成文件
+
+## Properties
+
+### fileName
+
+> **fileName**: `string`
+
+Defined in: [lib/command/file.ts:22](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L22)
+
+***
+
+### mimeType?
+
+> `optional` **mimeType?**: `string`
+
+Defined in: [lib/command/file.ts:24](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/file.ts#L24)
+
+默认使用 Blob.type；为空时使用 application/octet-stream
+
 lib/command/interfaces/IInfo.md
 ---
 
@@ -12116,7 +12451,7 @@ lib/command/interfaces/IInfo.md
 
 # Interface: IInfo
 
-Defined in: [lib/command.ts:92](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L92)
+Defined in: [lib/command/types.ts:94](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L94)
 
 不包含函数或内部对象的独立快照
 
@@ -12130,7 +12465,7 @@ Defined in: [lib/command.ts:92](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **annotations?**: `object`
 
-Defined in: [lib/command.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L67)
+Defined in: [lib/command/types.ts:69](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L69)
 
 行为说明，不代替校验或授权
 
@@ -12170,7 +12505,7 @@ WebMCP 的重要或不可逆现实效果说明
 
 > **description**: `string`
 
-Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L63)
+Defined in: [lib/command/types.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L65)
 
 #### Inherited from
 
@@ -12182,7 +12517,7 @@ Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/di
 
 > **disabledReason**: `string`
 
-Defined in: [lib/command.ts:98](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L98)
+Defined in: [lib/command/types.ts:100](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L100)
 
 ***
 
@@ -12190,7 +12525,7 @@ Defined in: [lib/command.ts:98](https://github.com/maiyun/clickgo/blob/master/di
 
 > **enabled**: `boolean`
 
-Defined in: [lib/command.ts:97](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L97)
+Defined in: [lib/command/types.ts:99](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L99)
 
 ***
 
@@ -12198,7 +12533,7 @@ Defined in: [lib/command.ts:97](https://github.com/maiyun/clickgo/blob/master/di
 
 > **exposed**: `boolean`
 
-Defined in: [lib/command.ts:96](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L96)
+Defined in: [lib/command/types.ts:98](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L98)
 
 ***
 
@@ -12206,7 +12541,7 @@ Defined in: [lib/command.ts:96](https://github.com/maiyun/clickgo/blob/master/di
 
 > **formId**: `string`
 
-Defined in: [lib/command.ts:94](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L94)
+Defined in: [lib/command/types.ts:96](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L96)
 
 ***
 
@@ -12214,7 +12549,7 @@ Defined in: [lib/command.ts:94](https://github.com/maiyun/clickgo/blob/master/di
 
 > **inputSchema**: [`ISchema`](ISchema.md) & `object`
 
-Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L64)
+Defined in: [lib/command/types.ts:66](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L66)
 
 #### Type Declaration
 
@@ -12232,7 +12567,7 @@ Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/di
 
 > **name**: `string`
 
-Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L61)
+Defined in: [lib/command/types.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L63)
 
 #### Inherited from
 
@@ -12244,7 +12579,7 @@ Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **outputSchema?**: [`ISchema`](ISchema.md)
 
-Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L65)
+Defined in: [lib/command/types.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L67)
 
 #### Inherited from
 
@@ -12256,7 +12591,7 @@ Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/di
 
 > **panelId**: `string`
 
-Defined in: [lib/command.ts:95](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L95)
+Defined in: [lib/command/types.ts:97](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L97)
 
 ***
 
@@ -12264,7 +12599,7 @@ Defined in: [lib/command.ts:95](https://github.com/maiyun/clickgo/blob/master/di
 
 > **running**: `number`
 
-Defined in: [lib/command.ts:99](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L99)
+Defined in: [lib/command/types.ts:101](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L101)
 
 ***
 
@@ -12272,7 +12607,7 @@ Defined in: [lib/command.ts:99](https://github.com/maiyun/clickgo/blob/master/di
 
 > **taskId**: `string`
 
-Defined in: [lib/command.ts:93](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L93)
+Defined in: [lib/command/types.ts:95](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L95)
 
 ***
 
@@ -12280,7 +12615,7 @@ Defined in: [lib/command.ts:93](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **title?**: `string`
 
-Defined in: [lib/command.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L62)
+Defined in: [lib/command/types.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L64)
 
 #### Inherited from
 
@@ -12297,7 +12632,7 @@ lib/command/interfaces/IMetadata.md
 
 # Interface: IMetadata
 
-Defined in: [lib/command.ts:60](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L60)
+Defined in: [lib/command/types.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L62)
 
 与 MCP 工具描述对齐的公开命令元数据
 
@@ -12312,7 +12647,7 @@ Defined in: [lib/command.ts:60](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **annotations?**: `object`
 
-Defined in: [lib/command.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L67)
+Defined in: [lib/command/types.ts:69](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L69)
 
 行为说明，不代替校验或授权
 
@@ -12348,7 +12683,7 @@ WebMCP 的重要或不可逆现实效果说明
 
 > **description**: `string`
 
-Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L63)
+Defined in: [lib/command/types.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L65)
 
 ***
 
@@ -12356,7 +12691,7 @@ Defined in: [lib/command.ts:63](https://github.com/maiyun/clickgo/blob/master/di
 
 > **inputSchema**: [`ISchema`](ISchema.md) & `object`
 
-Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L64)
+Defined in: [lib/command/types.ts:66](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L66)
 
 #### Type Declaration
 
@@ -12370,7 +12705,7 @@ Defined in: [lib/command.ts:64](https://github.com/maiyun/clickgo/blob/master/di
 
 > **name**: `string`
 
-Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L61)
+Defined in: [lib/command/types.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L63)
 
 ***
 
@@ -12378,7 +12713,7 @@ Defined in: [lib/command.ts:61](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **outputSchema?**: [`ISchema`](ISchema.md)
 
-Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L65)
+Defined in: [lib/command/types.ts:67](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L67)
 
 ***
 
@@ -12386,7 +12721,7 @@ Defined in: [lib/command.ts:65](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **title?**: `string`
 
-Defined in: [lib/command.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L62)
+Defined in: [lib/command/types.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L64)
 
 lib/command/interfaces/IPageBridge.md
 ---
@@ -12399,7 +12734,7 @@ lib/command/interfaces/IPageBridge.md
 
 # Interface: IPageBridge
 
-Defined in: [lib/command.ts:110](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L110)
+Defined in: [lib/command/types.ts:112](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L112)
 
 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令
 
@@ -12409,7 +12744,7 @@ Defined in: [lib/command.ts:110](https://github.com/maiyun/clickgo/blob/master/d
 
 > **execute**: (`taskId`, `name`, `args?`, `options?`) => `Promise`\<[`TResult`](../type-aliases/TResult.md)\<[`TJson`](../../tool/type-aliases/TJson.md)\>\>
 
-Defined in: [lib/command.ts:115](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L115)
+Defined in: [lib/command/types.ts:117](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L117)
 
 #### Parameters
 
@@ -12441,7 +12776,7 @@ Defined in: [lib/command.ts:115](https://github.com/maiyun/clickgo/blob/master/d
 
 > **getAgentGuide**: (`taskId?`) => `Promise`\<`string` \| `false` \| `null`\>
 
-Defined in: [lib/command.ts:112](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L112)
+Defined in: [lib/command/types.ts:114](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L114)
 
 #### Parameters
 
@@ -12459,7 +12794,7 @@ Defined in: [lib/command.ts:112](https://github.com/maiyun/clickgo/blob/master/d
 
 > **getAgentInfo**: (`taskId?`) => `Promise`\<`false` \| [`IAgentInfo`](IAgentInfo.md) \| `null`\>
 
-Defined in: [lib/command.ts:111](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L111)
+Defined in: [lib/command/types.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L113)
 
 #### Parameters
 
@@ -12477,7 +12812,7 @@ Defined in: [lib/command.ts:111](https://github.com/maiyun/clickgo/blob/master/d
 
 > **list**: (`taskId`) => [`IInfo`](IInfo.md)[]
 
-Defined in: [lib/command.ts:114](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L114)
+Defined in: [lib/command/types.ts:116](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L116)
 
 #### Parameters
 
@@ -12495,7 +12830,7 @@ Defined in: [lib/command.ts:114](https://github.com/maiyun/clickgo/blob/master/d
 
 > **listTasks**: () => `object`[]
 
-Defined in: [lib/command.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L113)
+Defined in: [lib/command/types.ts:115](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L115)
 
 #### Returns
 
@@ -12512,7 +12847,7 @@ lib/command/interfaces/ISchema.md
 
 # Interface: ISchema
 
-Defined in: [lib/command.ts:15](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L15)
+Defined in: [lib/command/types.ts:9](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L9)
 
 JSON Schema 2020-12 的命令校验子集；不支持的关键字在注册时拒绝
 
@@ -12522,7 +12857,7 @@ JSON Schema 2020-12 的命令校验子集；不支持的关键字在注册时拒
 
 > `optional` **$defs?**: `Record`\<`string`, `boolean` \| `ISchema`\>
 
-Defined in: [lib/command.ts:18](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L18)
+Defined in: [lib/command/types.ts:12](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L12)
 
 ***
 
@@ -12530,7 +12865,7 @@ Defined in: [lib/command.ts:18](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **$ref?**: `string`
 
-Defined in: [lib/command.ts:17](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L17)
+Defined in: [lib/command/types.ts:11](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L11)
 
 ***
 
@@ -12538,7 +12873,7 @@ Defined in: [lib/command.ts:17](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **$schema?**: `string`
 
-Defined in: [lib/command.ts:16](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L16)
+Defined in: [lib/command/types.ts:10](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L10)
 
 ***
 
@@ -12546,7 +12881,7 @@ Defined in: [lib/command.ts:16](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **additionalProperties?**: `boolean` \| `ISchema`
 
-Defined in: [lib/command.ts:26](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L26)
+Defined in: [lib/command/types.ts:20](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L20)
 
 ***
 
@@ -12554,7 +12889,7 @@ Defined in: [lib/command.ts:26](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **allOf?**: (`boolean` \| `ISchema`)[]
 
-Defined in: [lib/command.ts:40](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L40)
+Defined in: [lib/command/types.ts:34](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L34)
 
 ***
 
@@ -12562,7 +12897,7 @@ Defined in: [lib/command.ts:40](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **anyOf?**: (`boolean` \| `ISchema`)[]
 
-Defined in: [lib/command.ts:41](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L41)
+Defined in: [lib/command/types.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L35)
 
 ***
 
@@ -12570,7 +12905,7 @@ Defined in: [lib/command.ts:41](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **const?**: [`TJson`](../../tool/type-aliases/TJson.md)
 
-Defined in: [lib/command.ts:39](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L39)
+Defined in: [lib/command/types.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L33)
 
 ***
 
@@ -12578,7 +12913,7 @@ Defined in: [lib/command.ts:39](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **default?**: [`TJson`](../../tool/type-aliases/TJson.md)
 
-Defined in: [lib/command.ts:21](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L21)
+Defined in: [lib/command/types.ts:15](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L15)
 
 ***
 
@@ -12586,7 +12921,7 @@ Defined in: [lib/command.ts:21](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **description?**: `string`
 
-Defined in: [lib/command.ts:20](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L20)
+Defined in: [lib/command/types.ts:14](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L14)
 
 ***
 
@@ -12594,7 +12929,7 @@ Defined in: [lib/command.ts:20](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **enum?**: [`TJson`](../../tool/type-aliases/TJson.md)[]
 
-Defined in: [lib/command.ts:38](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L38)
+Defined in: [lib/command/types.ts:32](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L32)
 
 ***
 
@@ -12602,7 +12937,7 @@ Defined in: [lib/command.ts:38](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **examples?**: [`TJson`](../../tool/type-aliases/TJson.md)[]
 
-Defined in: [lib/command.ts:22](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L22)
+Defined in: [lib/command/types.ts:16](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L16)
 
 ***
 
@@ -12610,7 +12945,7 @@ Defined in: [lib/command.ts:22](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **exclusiveMaximum?**: `number`
 
-Defined in: [lib/command.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L37)
+Defined in: [lib/command/types.ts:31](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L31)
 
 ***
 
@@ -12618,7 +12953,7 @@ Defined in: [lib/command.ts:37](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **exclusiveMinimum?**: `number`
 
-Defined in: [lib/command.ts:36](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L36)
+Defined in: [lib/command/types.ts:30](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L30)
 
 ***
 
@@ -12626,7 +12961,7 @@ Defined in: [lib/command.ts:36](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **items?**: `boolean` \| `ISchema`
 
-Defined in: [lib/command.ts:27](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L27)
+Defined in: [lib/command/types.ts:21](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L21)
 
 ***
 
@@ -12634,7 +12969,7 @@ Defined in: [lib/command.ts:27](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **maximum?**: `number`
 
-Defined in: [lib/command.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L35)
+Defined in: [lib/command/types.ts:29](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L29)
 
 ***
 
@@ -12642,7 +12977,7 @@ Defined in: [lib/command.ts:35](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **maxItems?**: `number`
 
-Defined in: [lib/command.ts:29](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L29)
+Defined in: [lib/command/types.ts:23](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L23)
 
 ***
 
@@ -12650,7 +12985,7 @@ Defined in: [lib/command.ts:29](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **maxLength?**: `number`
 
-Defined in: [lib/command.ts:32](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L32)
+Defined in: [lib/command/types.ts:26](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L26)
 
 ***
 
@@ -12658,7 +12993,7 @@ Defined in: [lib/command.ts:32](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **minimum?**: `number`
 
-Defined in: [lib/command.ts:34](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L34)
+Defined in: [lib/command/types.ts:28](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L28)
 
 ***
 
@@ -12666,7 +13001,7 @@ Defined in: [lib/command.ts:34](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **minItems?**: `number`
 
-Defined in: [lib/command.ts:28](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L28)
+Defined in: [lib/command/types.ts:22](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L22)
 
 ***
 
@@ -12674,7 +13009,7 @@ Defined in: [lib/command.ts:28](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **minLength?**: `number`
 
-Defined in: [lib/command.ts:31](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L31)
+Defined in: [lib/command/types.ts:25](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L25)
 
 ***
 
@@ -12682,7 +13017,7 @@ Defined in: [lib/command.ts:31](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **not?**: `boolean` \| `ISchema`
 
-Defined in: [lib/command.ts:43](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L43)
+Defined in: [lib/command/types.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L37)
 
 ***
 
@@ -12690,7 +13025,7 @@ Defined in: [lib/command.ts:43](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **oneOf?**: (`boolean` \| `ISchema`)[]
 
-Defined in: [lib/command.ts:42](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L42)
+Defined in: [lib/command/types.ts:36](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L36)
 
 ***
 
@@ -12698,7 +13033,7 @@ Defined in: [lib/command.ts:42](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **pattern?**: `string`
 
-Defined in: [lib/command.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L33)
+Defined in: [lib/command/types.ts:27](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L27)
 
 ***
 
@@ -12706,7 +13041,7 @@ Defined in: [lib/command.ts:33](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **properties?**: `Record`\<`string`, `boolean` \| `ISchema`\>
 
-Defined in: [lib/command.ts:24](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L24)
+Defined in: [lib/command/types.ts:18](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L18)
 
 ***
 
@@ -12714,7 +13049,7 @@ Defined in: [lib/command.ts:24](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **required?**: `string`[]
 
-Defined in: [lib/command.ts:25](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L25)
+Defined in: [lib/command/types.ts:19](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L19)
 
 ***
 
@@ -12722,7 +13057,7 @@ Defined in: [lib/command.ts:25](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **title?**: `string`
 
-Defined in: [lib/command.ts:19](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L19)
+Defined in: [lib/command/types.ts:13](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L13)
 
 ***
 
@@ -12730,7 +13065,7 @@ Defined in: [lib/command.ts:19](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **type?**: `"string"` \| `"number"` \| `"boolean"` \| `"object"` \| `"array"` \| `"integer"` \| `"null"`
 
-Defined in: [lib/command.ts:23](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L23)
+Defined in: [lib/command/types.ts:17](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L17)
 
 ***
 
@@ -12738,7 +13073,7 @@ Defined in: [lib/command.ts:23](https://github.com/maiyun/clickgo/blob/master/di
 
 > `optional` **uniqueItems?**: `boolean`
 
-Defined in: [lib/command.ts:30](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L30)
+Defined in: [lib/command/types.ts:24](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L24)
 
 lib/command/type-aliases/TJson.md
 ---
@@ -12753,7 +13088,7 @@ lib/command/type-aliases/TJson.md
 
 > **TJson** = [`TJson`](../../tool/type-aliases/TJson.md)
 
-Defined in: [lib/command.ts:12](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L12)
+Defined in: [lib/command/types.ts:6](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L6)
 
 命令输入与输出可跨浏览器、Native 和协议传输的 JSON 值
 
@@ -12768,9 +13103,9 @@ lib/command/type-aliases/TResult.md
 
 # Type Alias: TResult\<T\>
 
-> **TResult**\<`T`\> = \{ `data`: `T`; `ok`: `true`; \} \| \{ `error`: \{ `code`: `string`; `message`: `string`; \}; `ok`: `false`; \}
+> **TResult**\<`T`\> = \{ `data`: `T`; `files?`: [`IFileInfo`](../interfaces/IFileInfo.md)[]; `ok`: `true`; \} \| \{ `error`: \{ `code`: `string`; `message`: `string`; \}; `ok`: `false`; \}
 
-Defined in: [lib/command.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L47)
+Defined in: [lib/command/types.ts:41](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L41)
 
 所有入口共用的结果；错误码用于程序判断，message 用于说明
 
@@ -12793,7 +13128,7 @@ lib/command/type-aliases/TWebMcpRegistrationStatus.md
 
 > **TWebMcpRegistrationStatus** = `"idle"` \| `"registering"` \| `"ready"` \| `"failed"`
 
-Defined in: [lib/command.ts:129](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L129)
+Defined in: [lib/command/types.ts:131](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L131)
 
 工具发布诊断状态，不参与页面级接入事件
 
@@ -12810,7 +13145,7 @@ lib/command/type-aliases/TWebMcpStatus.md
 
 > **TWebMcpStatus** = `"unsupported"` \| `"ready"`
 
-Defined in: [lib/command.ts:126](https://github.com/maiyun/clickgo/blob/master/dist/lib/command.ts#L126)
+Defined in: [lib/command/types.ts:128](https://github.com/maiyun/clickgo/blob/master/dist/lib/command/types.ts#L128)
 
 页面级 WebMCP 接入状态；ready 表示浏览器接口可用，不表示某个 App 的工具已发布
 
@@ -13821,8 +14156,8 @@ lib/control/index.md
 - [INavItemSelectEvent](interfaces/INavItemSelectEvent.md)
 - [INumberBeforeChangeEvent](interfaces/INumberBeforeChangeEvent.md)
 - [INumberMinMaxChangeEvent](interfaces/INumberMinMaxChangeEvent.md)
-- [IObjviewerLine](interfaces/IObjviewerLine.md)
-- [IObjviewerLineObj](interfaces/IObjviewerLineObj.md)
+- [IObjviewerEdge](interfaces/IObjviewerEdge.md)
+- [IObjviewerSelectEvent](interfaces/IObjviewerSelectEvent.md)
 - [IPaletteChangedEvent](interfaces/IPaletteChangedEvent.md)
 - [IPanelGoEvent](interfaces/IPanelGoEvent.md)
 - [IPanelWentEvent](interfaces/IPanelWentEvent.md)
@@ -13858,6 +14193,7 @@ lib/control/index.md
 - [TControlPackage](type-aliases/TControlPackage.md)
 - [TDesktopLayoutReason](type-aliases/TDesktopLayoutReason.md)
 - [TDesktopPositions](type-aliases/TDesktopPositions.md)
+- [TObjviewerStatus](type-aliases/TObjviewerStatus.md)
 
 ## Functions
 
@@ -16411,101 +16747,125 @@ Defined in: [lib/control.ts:971](https://github.com/maiyun/clickgo/blob/master/d
 
 [`ICustomEvent`](ICustomEvent.md).[`preventDefault`](ICustomEvent.md#preventdefault)
 
-lib/control/interfaces/IObjviewerLine.md
+lib/control/interfaces/IObjviewerEdge.md
 ---
 
 [**Documents for clickgo**](../../../index.md)
 
 ***
 
-[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerLine
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerEdge
 
-# Interface: IObjviewerLine
+# Interface: IObjviewerEdge
 
-Defined in: [lib/control.ts:1737](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1737)
+Defined in: [lib/control.ts:1741](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1741)
+
+按稳定节点 ID 声明的连接，节点暂不存在时不绘制，不保存 DOM 引用
 
 ## Properties
 
-### end
+### animation?
 
-> **end**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
+> `optional` **animation?**: `"none"` \| `"dash"` \| `"dots"`
 
-Defined in: [lib/control.ts:1741](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1741)
+Defined in: [lib/control.ts:1748](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1748)
+
+默认 none，dash 为流动虚线，dots 为静止底线上的移动圆点
 
 ***
 
-### hue?
+### direction?
 
-> `optional` **hue?**: `string`
+> `optional` **direction?**: `"reverse"` \| `"forward"` \| `"both"`
 
-Defined in: [lib/control.ts:1743](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1743)
+Defined in: [lib/control.ts:1750](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1750)
 
-默认 255
+默认 forward，沿 source 到 target；reverse 反向，both 双向
 
 ***
 
-### name?
+### dotCount?
 
-> `optional` **name?**: `string`
+> `optional` **dotCount?**: `number`
 
-Defined in: [lib/control.ts:1739](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1739)
+Defined in: [lib/control.ts:1754](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1754)
 
--- 可自定义线段的名称
+dots 模式每个方向的圆点数，默认 3，取整并限制为 1–8
 
 ***
 
-### path?
+### duration?
 
-> `optional` **path?**: `string`
+> `optional` **duration?**: `number`
+
+Defined in: [lib/control.ts:1752](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1752)
+
+动画周期，单位秒，默认 3，限制为 0.25–60；dots 为走完整条路径的时间
+
+***
+
+### label?
+
+> `optional` **label?**: `string`
 
 Defined in: [lib/control.ts:1744](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1744)
 
 ***
 
-### start
+### source
 
-> **start**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
+> **source**: `string`
 
-Defined in: [lib/control.ts:1740](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1740)
+Defined in: [lib/control.ts:1742](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1742)
 
 ***
 
-### stroke?
+### status?
 
-> `optional` **stroke?**: `"solid"` \| `"dashed"` \| `"up"` \| `"down"`
+> `optional` **status?**: [`TObjviewerStatus`](../type-aliases/TObjviewerStatus.md)
 
 Defined in: [lib/control.ts:1746](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1746)
 
-默认 solid
+默认 default，连接状态由应用明确提供
+
+***
 
-lib/control/interfaces/IObjviewerLineObj.md
+### target
+
+> **target**: `string`
+
+Defined in: [lib/control.ts:1743](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1743)
+
+lib/control/interfaces/IObjviewerSelectEvent.md
 ---
 
 [**Documents for clickgo**](../../../index.md)
 
 ***
 
-[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerLineObj
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerSelectEvent
+
+# Interface: IObjviewerSelectEvent
 
-# Interface: IObjviewerLineObj
+Defined in: [lib/control.ts:1758](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1758)
 
-Defined in: [lib/control.ts:1749](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1749)
+节点选择事件，仅通知选择，不在控件内执行业务跳转
 
 ## Properties
 
-### obj
+### detail
 
-> **obj**: `HTMLElement` \| [`AbstractControl`](../classes/AbstractControl.md)
+> **detail**: `object`
 
-Defined in: [lib/control.ts:1750](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1750)
+Defined in: [lib/control.ts:1759](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1759)
 
-***
+#### label
 
-### pos
+> **label**: `string`
 
-> **pos**: `"b"` \| `"tr"` \| `"l"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"`
+#### nodeId
 
-Defined in: [lib/control.ts:1751](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1751)
+> **nodeId**: `string`
 
 lib/control/interfaces/IPaletteChangedEvent.md
 ---
@@ -18011,6 +18371,23 @@ Defined in: [lib/control.ts:1321](https://github.com/maiyun/clickgo/blob/master/
 
 图标 ID 到位置的映射，可独立保存和恢复
 
+lib/control/type-aliases/TObjviewerStatus.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / TObjviewerStatus
+
+# Type Alias: TObjviewerStatus
+
+> **TObjviewerStatus** = `"default"` \| `"online"` \| `"warning"` \| `"offline"`
+
+Defined in: [lib/control.ts:1738](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1738)
+
+节点和连接的语义状态，不依赖主题的具体颜色
+
 lib/core/classes/AbstractApp.md
 ---
 
@@ -21560,7 +21937,7 @@ Defined in: [lib/dom.ts:1910](https://github.com/maiyun/clickgo/blob/master/dist
 
 ### pos
 
-`"b"` \| `"tr"` \| `"l"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"`
+`"b"` \| `"tr"` \| `"l"` \| `"rb"` \| `"lt"` \| `"t"` \| `"r"` \| `"bl"`
 
 ## Returns
 
@@ -31443,7 +31820,7 @@ lib/native/functions/activate.md
 
 > **activate**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:443](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L443)
+Defined in: [lib/native.ts:445](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L445)
 
 ## Parameters
 
@@ -31499,7 +31876,7 @@ lib/native/functions/clear.md
 
 > **clear**(`taskId`, `formId?`): `void`
 
-Defined in: [lib/native.ts:286](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L286)
+Defined in: [lib/native.ts:288](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L288)
 
 清除某个窗体或某个任务的所有事件监听
 
@@ -31534,7 +31911,7 @@ lib/native/functions/close.md
 
 > **close**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:455](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L455)
+Defined in: [lib/native.ts:457](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L457)
 
 关闭当前 native 真实窗体，根据配置整个 native 任务可能结束也可能保留 node 不结束
 
@@ -31563,7 +31940,7 @@ lib/native/functions/dialog.md
 
 > **dialog**(`options?`): `Promise`\<`number`\>
 
-Defined in: [lib/native.ts:522](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L522)
+Defined in: [lib/native.ts:524](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L524)
 
 弹出消息框
 
@@ -31625,7 +32002,7 @@ lib/native/functions/getCommandEntry.md
 
 > **getCommandEntry**(): `Promise`\<[`ICommandEntry`](../interfaces/ICommandEntry.md) \| `null`\>
 
-Defined in: [lib/native.ts:159](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L159)
+Defined in: [lib/native.ts:161](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L161)
 
 取得软件自身的 CLI/stdio 入口和启动要求，无需读取连接凭据
 
@@ -31648,7 +32025,7 @@ lib/native/functions/getListenerList.md
 
 > **getListenerList**(`taskId?`): `Record`\<`string`, `Record`\<`string`, `Record`\<`string`, `number`\>\>\>
 
-Defined in: [lib/native.ts:309](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L309)
+Defined in: [lib/native.ts:311](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L311)
 
 获取监听 native 事件的监听统计信息列表
 
@@ -31677,7 +32054,7 @@ lib/native/functions/getMcpInfo.md
 
 > **getMcpInfo**(`current`): `Promise`\<`false` \| [`IMcpInfo`](../interfaces/IMcpInfo.md) \| `null`\>
 
-Defined in: [lib/native.ts:168](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L168)
+Defined in: [lib/native.ts:170](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L170)
 
 读取 Native 主进程启用的 MCP 连接设置
 
@@ -31739,7 +32116,7 @@ lib/native/functions/init.md
 
 > **init**(): `void`
 
-Defined in: [lib/native.ts:553](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L553)
+Defined in: [lib/native.ts:555](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L555)
 
 ## Returns
 
@@ -31818,7 +32195,7 @@ lib/native/functions/invoke.md
 
 > **invoke**(`name`, ...`param`): `Promise`\<`any`\>
 
-Defined in: [lib/native.ts:350](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L350)
+Defined in: [lib/native.ts:352](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L352)
 
 向 native 发送指令
 
@@ -31853,7 +32230,7 @@ lib/native/functions/invokeSys.md
 
 > **invokeSys**(`current`, `name`, ...`param`): `Promise`\<`any`\>
 
-Defined in: [lib/native.ts:363](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L363)
+Defined in: [lib/native.ts:365](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L365)
 
 向 native 发送指令（系统级）
 
@@ -31931,7 +32308,7 @@ lib/native/functions/isMax.md
 
 > **isMax**(): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:546](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L546)
+Defined in: [lib/native.ts:548](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L548)
 
 判断窗体是否是最大化状态
 
@@ -31952,7 +32329,7 @@ lib/native/functions/maximizable.md
 
 > **maximizable**(`current`, `val`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:463](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L463)
+Defined in: [lib/native.ts:465](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L465)
 
 ## Parameters
 
@@ -31981,7 +32358,7 @@ lib/native/functions/max.md
 
 > **max**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:409](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L409)
+Defined in: [lib/native.ts:411](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L411)
 
 ## Parameters
 
@@ -32006,7 +32383,7 @@ lib/native/functions/min.md
 
 > **min**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:417](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L417)
+Defined in: [lib/native.ts:419](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L419)
 
 ## Parameters
 
@@ -32031,7 +32408,7 @@ lib/native/functions/minSize.md
 
 > **minSize**(`current`, `width`, `height`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:398](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L398)
+Defined in: [lib/native.ts:400](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L400)
 
 设置实体窗体的最小尺寸，0 表示不限制对应方向
 
@@ -32072,7 +32449,7 @@ lib/native/functions/off.md
 
 > **off**(`current`, `name`, `formId?`): `void`
 
-Defined in: [lib/native.ts:267](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L267)
+Defined in: [lib/native.ts:269](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L269)
 
 解绑监听的方法
 
@@ -32113,7 +32490,7 @@ lib/native/functions/once.md
 
 > **once**(`current`, `name`, `handler`, `formId?`): `void`
 
-Defined in: [lib/native.ts:252](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L252)
+Defined in: [lib/native.ts:254](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L254)
 
 监听 native 传输过来的事件（仅一次）
 
@@ -32160,7 +32537,7 @@ lib/native/functions/on.md
 
 > **on**(`current`, `name`, `handler`, `once?`, `formId?`): `void`
 
-Defined in: [lib/native.ts:223](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L223)
+Defined in: [lib/native.ts:225](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L225)
 
 监听 native 传输过来的事件
 
@@ -32250,7 +32627,7 @@ lib/native/functions/open.md
 
 > **open**(`options?`): `Promise`\<`string`[] \| `null`\>
 
-Defined in: [lib/native.ts:478](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L478)
+Defined in: [lib/native.ts:480](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L480)
 
 弹出文件选择框
 
@@ -32313,7 +32690,7 @@ lib/native/functions/ping.md
 
 > **ping**(`val`): `Promise`\<`string`\>
 
-Defined in: [lib/native.ts:539](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L539)
+Defined in: [lib/native.ts:541](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L541)
 
 测试与 native 的连通性
 
@@ -32344,7 +32721,7 @@ lib/native/functions/quit.md
 
 > **quit**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:376](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L376)
+Defined in: [lib/native.ts:378](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L378)
 
 直接让整个 native 进程退出
 
@@ -32404,7 +32781,7 @@ lib/native/functions/restore.md
 
 > **restore**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:435](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L435)
+Defined in: [lib/native.ts:437](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L437)
 
 从最小化还原
 
@@ -32431,7 +32808,7 @@ lib/native/functions/save.md
 
 > **save**(`options?`): `Promise`\<`string` \| `null`\>
 
-Defined in: [lib/native.ts:504](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L504)
+Defined in: [lib/native.ts:506](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L506)
 
 弹出文件保存框
 
@@ -32472,7 +32849,7 @@ lib/native/functions/size.md
 
 > **size**(`current`, `width`, `height`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:384](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L384)
+Defined in: [lib/native.ts:386](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L386)
 
 ## Parameters
 
@@ -32505,7 +32882,7 @@ lib/native/functions/unmaximize.md
 
 > **unmaximize**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:426](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L426)
+Defined in: [lib/native.ts:428](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L428)
 
 从最大化还原
 
@@ -32595,7 +32972,7 @@ lib/native/interfaces/ICommandEntry.md
 
 # Interface: ICommandEntry
 
-Defined in: [lib/native.ts:146](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L146)
+Defined in: [lib/native.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L148)
 
 当前 Native 的公开进程入口，不包含 HTTP 连接凭据
 
@@ -32605,7 +32982,7 @@ Defined in: [lib/native.ts:146](https://github.com/maiyun/clickgo/blob/master/di
 
 > **args**: `string`[]
 
-Defined in: [lib/native.ts:150](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L150)
+Defined in: [lib/native.ts:152](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L152)
 
 ***
 
@@ -32613,7 +32990,7 @@ Defined in: [lib/native.ts:150](https://github.com/maiyun/clickgo/blob/master/di
 
 > **command**: `string`
 
-Defined in: [lib/native.ts:149](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L149)
+Defined in: [lib/native.ts:151](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L151)
 
 ***
 
@@ -32621,7 +32998,7 @@ Defined in: [lib/native.ts:149](https://github.com/maiyun/clickgo/blob/master/di
 
 > **mcp**: `object`
 
-Defined in: [lib/native.ts:152](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L152)
+Defined in: [lib/native.ts:154](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L154)
 
 #### discovery
 
@@ -32637,7 +33014,7 @@ Defined in: [lib/native.ts:152](https://github.com/maiyun/clickgo/blob/master/di
 
 > **name**: `string`
 
-Defined in: [lib/native.ts:147](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L147)
+Defined in: [lib/native.ts:149](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L149)
 
 ***
 
@@ -32645,7 +33022,7 @@ Defined in: [lib/native.ts:147](https://github.com/maiyun/clickgo/blob/master/di
 
 > **platform**: `string`
 
-Defined in: [lib/native.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L148)
+Defined in: [lib/native.ts:150](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L150)
 
 ***
 
@@ -32653,7 +33030,7 @@ Defined in: [lib/native.ts:148](https://github.com/maiyun/clickgo/blob/master/di
 
 > **startup**: `"auto"` \| `"existing"`
 
-Defined in: [lib/native.ts:151](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L151)
+Defined in: [lib/native.ts:153](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L153)
 
 lib/native/interfaces/IMcpInfo.md
 ---
@@ -32666,7 +33043,7 @@ lib/native/interfaces/IMcpInfo.md
 
 # Interface: IMcpInfo
 
-Defined in: [lib/native.ts:139](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L139)
+Defined in: [lib/native.ts:141](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L141)
 
 本地 MCP 客户端连接设置；仅向已授权 root 的 App 提供
 
@@ -32676,7 +33053,7 @@ Defined in: [lib/native.ts:139](https://github.com/maiyun/clickgo/blob/master/di
 
 > **token**: `string`
 
-Defined in: [lib/native.ts:142](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L142)
+Defined in: [lib/native.ts:144](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L144)
 
 ***
 
@@ -32684,7 +33061,7 @@ Defined in: [lib/native.ts:142](https://github.com/maiyun/clickgo/blob/master/di
 
 > **transport**: `"streamable-http"`
 
-Defined in: [lib/native.ts:140](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L140)
+Defined in: [lib/native.ts:142](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L142)
 
 ***
 
@@ -32692,7 +33069,7 @@ Defined in: [lib/native.ts:140](https://github.com/maiyun/clickgo/blob/master/di
 
 > **url**: `string`
 
-Defined in: [lib/native.ts:141](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L141)
+Defined in: [lib/native.ts:143](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L143)
 
 lib/native/interfaces/INativeLaunchEvent.md
 ---