clickgo 7.3.0 → 7.3.2

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 接入说明
 
@@ -7523,10 +7555,31 @@ Enter/Space 请求切换一次展开状态；忽略持续按住时的重复事
 
 语义颜色，默认 `default`。
 
+#### clickable
+
+`boolean` | `string`
+
+整项可点击，默认 `false`；通过 `@click` 响应激活。启用后支持 Tab 聚焦、Enter 和 Space 激活；平时保持扁平，悬停、按下及键盘聚焦时显示反馈。不嵌套其他交互控件。
+
+#### disabled
+
+`boolean` | `string`
+
+禁用可点击项，默认 `false`；禁用时不参与 Tab 导航、不触发 `click`。
+
+### 事件
+
+#### tap
+
+`(event: MouseEvent | KeyboardEvent): void`
+
+可点击项通过鼠标点击、Enter 按下或 Space 释放时触发，参数为原始事件。应用模板使用 `@click` 绑定，框架内部对应 `tap`；普通项或禁用项不触发。
+
 ### 示例
 
 ```xml
 <statusbar-item type="info">Synchronizing</statusbar-item>
+<statusbar-item clickable @click="chooseEncoding" tip="Change text encoding">UTF-8</statusbar-item>
 ```
 
 
@@ -10965,7 +11018,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 或整个任务的命令
 
@@ -10996,7 +11049,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`**
 
@@ -11041,9 +11094,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
 
@@ -11057,7 +11113,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
 ---
@@ -11072,7 +11128,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
 
@@ -11103,7 +11159,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)
 
 网页入口直接读取框架的任务及命令状态，无需应用或宿主重复发布与清理
 
@@ -11126,7 +11182,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 工具；不改变页面级接入状态，下次公开命令注册时自动发布
 
@@ -11155,9 +11211,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 执行公开命令，与界面共用校验和业务执行器
 
@@ -11191,7 +11247,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
 
@@ -11206,9 +11262,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)
 
 应用界面直接执行已注册的业务命令
 
@@ -11242,7 +11298,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)\>
 
 业务结果
 
@@ -11259,7 +11315,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)
 
 构造业务失败结果，不抛异常
 
@@ -11296,7 +11352,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；代理通过接口实时发现
 
@@ -11333,7 +11389,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)
 
 获取当前环境的统一接入信息，不另行维护命令清单或启用服务
 
@@ -11370,7 +11426,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 前自动调用
 
@@ -11393,7 +11449,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)
 
 获取独立元数据和当前状态，不导出业务函数
 
@@ -11424,7 +11480,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 代理发现目标
 
@@ -11447,7 +11503,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
 
@@ -11477,6 +11533,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
 ---
 
@@ -11527,9 +11620,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)
 
 构造成功结果
 
@@ -11547,6 +11640,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`\>
@@ -11566,7 +11665,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)
 
 取消尚在执行的命令并解除注册；取消是协作式，不回滚已产生的业务效果
 
@@ -11608,6 +11707,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)
@@ -11637,6 +11739,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)
@@ -11652,7 +11755,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)
 
 可展示或导出的接入信息；命令列表始终从对应入口实时查询
 
@@ -11662,7 +11765,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
 
@@ -11678,7 +11781,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
 
@@ -11694,7 +11797,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 凭据
 
@@ -11704,7 +11807,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)
 
 ***
 
@@ -11712,7 +11815,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)
 
 ***
 
@@ -11720,7 +11823,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)
 
 ***
 
@@ -11728,7 +11831,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
 
@@ -11763,7 +11866,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 凭据
 
@@ -11773,7 +11876,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 权限
 
@@ -11788,7 +11891,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)
 
 绑定一个应用实例，只能调用该实例明确公开的命令
 
@@ -11798,7 +11901,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
 
@@ -11826,7 +11929,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
 
@@ -11838,7 +11941,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
 ---
@@ -11851,17 +11954,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)
 
 ***
 
@@ -11869,7 +12003,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)
 
 ***
 
@@ -11877,7 +12011,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)
 
 ***
 
@@ -11885,7 +12019,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)
 
 ***
 
@@ -11893,7 +12027,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
 ---
@@ -11906,7 +12040,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 适配器共享执行函数
 
@@ -11926,7 +12060,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)
 
 行为说明，不代替校验或授权
 
@@ -11966,7 +12100,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)
 
 默认拒绝同一命令并发；业务确认可并行时才开启
 
@@ -11976,7 +12110,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
 
@@ -11988,7 +12122,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 或原因文本为不可用；每次执行重新检查
 
@@ -12002,7 +12136,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
 
@@ -12024,7 +12158,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)
 
 明确允许代理发现并调用；默认只允许应用内部调用
 
@@ -12034,7 +12168,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
 
@@ -12052,7 +12186,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
 
@@ -12064,7 +12198,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
 
@@ -12076,7 +12210,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)
 
 必须已经取得的框架权限；执行入口不弹授权窗
 
@@ -12086,12 +12220,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
 ---
 
@@ -12103,7 +12412,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)
 
 不包含函数或内部对象的独立快照
 
@@ -12117,7 +12426,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)
 
 行为说明，不代替校验或授权
 
@@ -12157,7 +12466,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
 
@@ -12169,7 +12478,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)
 
 ***
 
@@ -12177,7 +12486,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)
 
 ***
 
@@ -12185,7 +12494,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)
 
 ***
 
@@ -12193,7 +12502,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)
 
 ***
 
@@ -12201,7 +12510,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
 
@@ -12219,7 +12528,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
 
@@ -12231,7 +12540,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
 
@@ -12243,7 +12552,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)
 
 ***
 
@@ -12251,7 +12560,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)
 
 ***
 
@@ -12259,7 +12568,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)
 
 ***
 
@@ -12267,7 +12576,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
 
@@ -12284,7 +12593,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 工具描述对齐的公开命令元数据
 
@@ -12299,7 +12608,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)
 
 行为说明，不代替校验或授权
 
@@ -12335,7 +12644,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)
 
 ***
 
@@ -12343,7 +12652,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
 
@@ -12357,7 +12666,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)
 
 ***
 
@@ -12365,7 +12674,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)
 
 ***
 
@@ -12373,7 +12682,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
 ---
@@ -12386,7 +12695,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)
 
 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令
 
@@ -12396,7 +12705,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
 
@@ -12428,7 +12737,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
 
@@ -12446,7 +12755,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
 
@@ -12464,7 +12773,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
 
@@ -12482,7 +12791,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
 
@@ -12499,7 +12808,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 的命令校验子集；不支持的关键字在注册时拒绝
 
@@ -12509,7 +12818,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)
 
 ***
 
@@ -12517,7 +12826,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)
 
 ***
 
@@ -12525,7 +12834,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)
 
 ***
 
@@ -12533,7 +12842,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)
 
 ***
 
@@ -12541,7 +12850,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)
 
 ***
 
@@ -12549,7 +12858,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)
 
 ***
 
@@ -12557,7 +12866,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)
 
 ***
 
@@ -12565,7 +12874,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)
 
 ***
 
@@ -12573,7 +12882,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)
 
 ***
 
@@ -12581,7 +12890,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)
 
 ***
 
@@ -12589,7 +12898,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)
 
 ***
 
@@ -12597,7 +12906,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)
 
 ***
 
@@ -12605,7 +12914,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)
 
 ***
 
@@ -12613,7 +12922,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)
 
 ***
 
@@ -12621,7 +12930,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)
 
 ***
 
@@ -12629,7 +12938,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)
 
 ***
 
@@ -12637,7 +12946,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)
 
 ***
 
@@ -12645,7 +12954,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)
 
 ***
 
@@ -12653,7 +12962,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)
 
 ***
 
@@ -12661,7 +12970,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)
 
 ***
 
@@ -12669,7 +12978,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)
 
 ***
 
@@ -12677,7 +12986,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)
 
 ***
 
@@ -12685,7 +12994,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)
 
 ***
 
@@ -12693,7 +13002,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)
 
 ***
 
@@ -12701,7 +13010,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)
 
 ***
 
@@ -12709,7 +13018,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)
 
 ***
 
@@ -12717,7 +13026,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)
 
 ***
 
@@ -12725,7 +13034,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
 ---
@@ -12740,7 +13049,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 值
 
@@ -12755,9 +13064,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 用于说明
 
@@ -12780,7 +13089,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)
 
 工具发布诊断状态，不参与页面级接入事件
 
@@ -12797,7 +13106,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 的工具已发布
 
@@ -31430,7 +31739,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
 
@@ -31486,7 +31795,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)
 
 清除某个窗体或某个任务的所有事件监听
 
@@ -31521,7 +31830,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 不结束
 
@@ -31550,7 +31859,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)
 
 弹出消息框
 
@@ -31612,7 +31921,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 入口和启动要求，无需读取连接凭据
 
@@ -31635,7 +31944,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 事件的监听统计信息列表
 
@@ -31664,7 +31973,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 连接设置
 
@@ -31726,7 +32035,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
 
@@ -31805,7 +32114,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 发送指令
 
@@ -31840,7 +32149,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 发送指令（系统级）
 
@@ -31918,7 +32227,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)
 
 判断窗体是否是最大化状态
 
@@ -31939,7 +32248,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
 
@@ -31968,7 +32277,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
 
@@ -31993,7 +32302,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
 
@@ -32018,7 +32327,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 表示不限制对应方向
 
@@ -32059,7 +32368,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)
 
 解绑监听的方法
 
@@ -32100,7 +32409,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 传输过来的事件（仅一次）
 
@@ -32147,7 +32456,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 传输过来的事件
 
@@ -32237,7 +32546,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)
 
 弹出文件选择框
 
@@ -32300,7 +32609,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 的连通性
 
@@ -32331,7 +32640,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 进程退出
 
@@ -32391,7 +32700,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)
 
 从最小化还原
 
@@ -32418,7 +32727,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)
 
 弹出文件保存框
 
@@ -32459,7 +32768,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
 
@@ -32492,7 +32801,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)
 
 从最大化还原
 
@@ -32582,7 +32891,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 连接凭据
 
@@ -32592,7 +32901,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)
 
 ***
 
@@ -32600,7 +32909,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)
 
 ***
 
@@ -32608,7 +32917,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
 
@@ -32624,7 +32933,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)
 
 ***
 
@@ -32632,7 +32941,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)
 
 ***
 
@@ -32640,7 +32949,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
 ---
@@ -32653,7 +32962,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 提供
 
@@ -32663,7 +32972,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)
 
 ***
 
@@ -32671,7 +32980,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)
 
 ***
 
@@ -32679,7 +32988,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
 ---