clickgo 7.0.0 → 7.1.0

package/doc/clickgo-rag.md

@@ -31101,7 +31101,7 @@ lib/native/functions/activate.md
 
 > **activate**(`current`): `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:405](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L405)
 
 ## Parameters
 
@@ -31113,6 +31113,37 @@ Defined in: [lib/native.ts:384](https://github.com/maiyun/clickgo/blob/master/di
 
 `Promise`\<`boolean`\>
 
+lib/native/functions/checkUpdates.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / checkUpdates
+
+# Function: checkUpdates()
+
+> **checkUpdates**(`current`): `Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+Defined in: [lib/native/update.ts:28](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L28)
+
+检测软件更新，主进程须 launcher({ updates: true }) 并配置 build.publish
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+当前 App 或窗体，要求 root 权限
+
+## Returns
+
+`Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+检测状态；开发/便携/未启用返回 disabled，无权限为 false，网页/旧宿主为 null
+
 lib/native/functions/clear.md
 ---
 
@@ -31126,7 +31157,7 @@ lib/native/functions/clear.md
 
 > **clear**(`taskId`, `formId?`): `void`
 
-Defined in: [lib/native.ts:227](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L227)
+Defined in: [lib/native.ts:248](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L248)
 
 清除某个窗体或某个任务的所有事件监听
 
@@ -31161,7 +31192,7 @@ lib/native/functions/close.md
 
 > **close**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:396](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L396)
+Defined in: [lib/native.ts:417](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L417)
 
 关闭当前 native 真实窗体，根据配置整个 native 任务可能结束也可能保留 node 不结束
 
@@ -31190,7 +31221,7 @@ lib/native/functions/dialog.md
 
 > **dialog**(`options?`): `Promise`\<`number`\>
 
-Defined in: [lib/native.ts:463](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L463)
+Defined in: [lib/native.ts:484](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L484)
 
 弹出消息框
 
@@ -31208,6 +31239,37 @@ Defined in: [lib/native.ts:463](https://github.com/maiyun/clickgo/blob/master/di
 
 点击的按钮索引
 
+lib/native/functions/downloadUpdate.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / downloadUpdate
+
+# Function: downloadUpdate()
+
+> **downloadUpdate**(`current`): `Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+Defined in: [lib/native/update.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L37)
+
+下载检测到的版本，合并并发下载，由 Native 校验文件
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+当前 App 或窗体，要求 root 权限，业务须先取得用户确认
+
+## Returns
+
+`Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+downloaded 表示校验完成，未就绪/失败为 error；无权限为 false，不支持为 null
+
 lib/native/functions/getCommandEntry.md
 ---
 
@@ -31221,7 +31283,7 @@ lib/native/functions/getCommandEntry.md
 
 > **getCommandEntry**(): `Promise`\<[`ICommandEntry`](../interfaces/ICommandEntry.md) \| `null`\>
 
-Defined in: [lib/native.ts:100](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L100)
+Defined in: [lib/native.ts:121](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L121)
 
 取得软件自身的 CLI/stdio 入口和启动要求，无需读取连接凭据
 
@@ -31244,7 +31306,7 @@ lib/native/functions/getListenerList.md
 
 > **getListenerList**(`taskId?`): `Record`\<`string`, `Record`\<`string`, `Record`\<`string`, `number`\>\>\>
 
-Defined in: [lib/native.ts:250](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L250)
+Defined in: [lib/native.ts:271](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L271)
 
 获取监听 native 事件的监听统计信息列表
 
@@ -31273,7 +31335,7 @@ lib/native/functions/getMcpInfo.md
 
 > **getMcpInfo**(`current`): `Promise`\<`false` \| [`IMcpInfo`](../interfaces/IMcpInfo.md) \| `null`\>
 
-Defined in: [lib/native.ts:109](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L109)
+Defined in: [lib/native.ts:130](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L130)
 
 读取 Native 主进程启用的 MCP 连接设置
 
@@ -31291,6 +31353,37 @@ Defined in: [lib/native.ts:109](https://github.com/maiyun/clickgo/blob/master/di
 
 连接设置；未启用为 null，无权限为 false
 
+lib/native/functions/getUpdateState.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / getUpdateState
+
+# Function: getUpdateState()
+
+> **getUpdateState**(`current`): `Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+Defined in: [lib/native/update.ts:55](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L55)
+
+读取 Native 软件级更新状态快照
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+当前 App 或窗体，要求 root 权限
+
+## Returns
+
+`Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+当前状态，无权限为 false，网页或旧宿主不支持为 null
+
 lib/native/functions/init.md
 ---
 
@@ -31304,7 +31397,7 @@ lib/native/functions/init.md
 
 > **init**(): `void`
 
-Defined in: [lib/native.ts:494](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L494)
+Defined in: [lib/native.ts:515](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L515)
 
 ## Returns
 
@@ -31323,7 +31416,7 @@ lib/native/functions/initSysId.md
 
 > **initSysId**(`id`): `void`
 
-Defined in: [lib/native.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L33)
+Defined in: [lib/native.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L35)
 
 初始化系统级 ID，仅能设置一次
 
@@ -31339,6 +31432,37 @@ Defined in: [lib/native.ts:33](https://github.com/maiyun/clickgo/blob/master/dis
 
 `void`
 
+lib/native/functions/installUpdate.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / installUpdate
+
+# Function: installUpdate()
+
+> **installUpdate**(`current`): `Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+Defined in: [lib/native/update.ts:46](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L46)
+
+安装本进程已下载的版本并重启，业务须先保存文档并确认
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+当前 App 或窗体，要求 root 权限
+
+## Returns
+
+`Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+restarting 表示安装开始；异步失败由 onUpdateState 通知，无权限为 false，不支持为 null
+
 lib/native/functions/invoke.md
 ---
 
@@ -31352,7 +31476,7 @@ lib/native/functions/invoke.md
 
 > **invoke**(`name`, ...`param`): `Promise`\<`any`\>
 
-Defined in: [lib/native.ts:291](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L291)
+Defined in: [lib/native.ts:312](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L312)
 
 向 native 发送指令
 
@@ -31387,7 +31511,7 @@ lib/native/functions/invokeSys.md
 
 > **invokeSys**(`current`, `name`, ...`param`): `Promise`\<`any`\>
 
-Defined in: [lib/native.ts:304](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L304)
+Defined in: [lib/native.ts:325](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L325)
 
 向 native 发送指令（系统级）
 
@@ -31415,6 +31539,43 @@ Defined in: [lib/native.ts:304](https://github.com/maiyun/clickgo/blob/master/di
 
 `Promise`\<`any`\>
 
+lib/native/functions/invokeUpdate.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / invokeUpdate
+
+# Function: invokeUpdate()
+
+> **invokeUpdate**(`current`, `action`): `Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+Defined in: [lib/native.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L51)
+
+接入固定的软件更新动作，不允许网页提供地址或安装路径
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+已确认有效的任务
+
+### action
+
+`"check"` \| `"download"` \| `"install"` \| `"state"`
+
+固定更新动作
+
+## Returns
+
+`Promise`\<`false` \| [`IUpdateState`](../interfaces/IUpdateState.md) \| `null`\>
+
+更新状态；任务失效为 false，旧宿主缺少能力时为 null
+
 lib/native/functions/isMax.md
 ---
 
@@ -31428,7 +31589,7 @@ lib/native/functions/isMax.md
 
 > **isMax**(): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:487](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L487)
+Defined in: [lib/native.ts:508](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L508)
 
 判断窗体是否是最大化状态
 
@@ -31449,7 +31610,7 @@ lib/native/functions/maximizable.md
 
 > **maximizable**(`current`, `val`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:404](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L404)
+Defined in: [lib/native.ts:425](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L425)
 
 ## Parameters
 
@@ -31478,7 +31639,7 @@ lib/native/functions/max.md
 
 > **max**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:350](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L350)
+Defined in: [lib/native.ts:371](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L371)
 
 ## Parameters
 
@@ -31503,7 +31664,7 @@ lib/native/functions/min.md
 
 > **min**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:358](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L358)
+Defined in: [lib/native.ts:379](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L379)
 
 ## Parameters
 
@@ -31528,7 +31689,7 @@ lib/native/functions/minSize.md
 
 > **minSize**(`current`, `width`, `height`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:339](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L339)
+Defined in: [lib/native.ts:360](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L360)
 
 设置实体窗体的最小尺寸，0 表示不限制对应方向
 
@@ -31569,7 +31730,7 @@ lib/native/functions/off.md
 
 > **off**(`current`, `name`, `formId?`): `void`
 
-Defined in: [lib/native.ts:208](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L208)
+Defined in: [lib/native.ts:229](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L229)
 
 解绑监听的方法
 
@@ -31610,7 +31771,7 @@ lib/native/functions/once.md
 
 > **once**(`current`, `name`, `handler`, `formId?`): `void`
 
-Defined in: [lib/native.ts:193](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L193)
+Defined in: [lib/native.ts:214](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L214)
 
 监听 native 传输过来的事件（仅一次）
 
@@ -31657,7 +31818,7 @@ lib/native/functions/on.md
 
 > **on**(`current`, `name`, `handler`, `once?`, `formId?`): `void`
 
-Defined in: [lib/native.ts:164](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L164)
+Defined in: [lib/native.ts:185](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L185)
 
 监听 native 传输过来的事件
 
@@ -31697,6 +31858,43 @@ Defined in: [lib/native.ts:164](https://github.com/maiyun/clickgo/blob/master/di
 
 `void`
 
+lib/native/functions/onUpdateState.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / onUpdateState
+
+# Function: onUpdateState()
+
+> **onUpdateState**(`current`, `handler`): `void`
+
+Defined in: [lib/native/update.ts:65](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L65)
+
+监听软件级公开状态及下载进度；不包含 URL、凭据或文件路径
+
+## Parameters
+
+### current
+
+[`TCurrent`](../../core/type-aliases/TCurrent.md)
+
+当前 App 或窗体，不要求 root；控制更新仍须 root
+
+### handler
+
+(`state`) => `void` \| `Promise`\<`void`\>
+
+状态回调，业务不需要定义 Native 事件名
+
+## Returns
+
+`void`
+
+无返回值；窗体或任务销毁时自动解除，网页/旧宿主不会投递
+
 lib/native/functions/open.md
 ---
 
@@ -31710,7 +31908,7 @@ lib/native/functions/open.md
 
 > **open**(`options?`): `Promise`\<`string`[] \| `null`\>
 
-Defined in: [lib/native.ts:419](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L419)
+Defined in: [lib/native.ts:440](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L440)
 
 弹出文件选择框
 
@@ -31773,7 +31971,7 @@ lib/native/functions/ping.md
 
 > **ping**(`val`): `Promise`\<`string`\>
 
-Defined in: [lib/native.ts:480](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L480)
+Defined in: [lib/native.ts:501](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L501)
 
 测试与 native 的连通性
 
@@ -31804,7 +32002,7 @@ lib/native/functions/quit.md
 
 > **quit**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:317](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L317)
+Defined in: [lib/native.ts:338](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L338)
 
 直接让整个 native 进程退出
 
@@ -31833,7 +32031,7 @@ lib/native/functions/restore.md
 
 > **restore**(`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:397](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L397)
 
 从最小化还原
 
@@ -31860,7 +32058,7 @@ lib/native/functions/save.md
 
 > **save**(`options?`): `Promise`\<`string` \| `null`\>
 
-Defined in: [lib/native.ts:445](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L445)
+Defined in: [lib/native.ts:466](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L466)
 
 弹出文件保存框
 
@@ -31901,7 +32099,7 @@ lib/native/functions/size.md
 
 > **size**(`current`, `width`, `height`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:325](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L325)
+Defined in: [lib/native.ts:346](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L346)
 
 ## Parameters
 
@@ -31934,7 +32132,7 @@ lib/native/functions/unmaximize.md
 
 > **unmaximize**(`current`): `Promise`\<`boolean`\>
 
-Defined in: [lib/native.ts:367](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L367)
+Defined in: [lib/native.ts:388](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L388)
 
 从最大化还原
 
@@ -31968,20 +32166,27 @@ lib/native/index.md
 
 - [ICommandEntry](interfaces/ICommandEntry.md)
 - [IMcpInfo](interfaces/IMcpInfo.md)
+- [IUpdateProgress](interfaces/IUpdateProgress.md)
+- [IUpdateState](interfaces/IUpdateState.md)
 
 ## Functions
 
 - [activate](functions/activate.md)
+- [checkUpdates](functions/checkUpdates.md)
 - [clear](functions/clear.md)
 - [close](functions/close.md)
 - [dialog](functions/dialog.md)
+- [downloadUpdate](functions/downloadUpdate.md)
 - [getCommandEntry](functions/getCommandEntry.md)
 - [getListenerList](functions/getListenerList.md)
 - [getMcpInfo](functions/getMcpInfo.md)
+- [getUpdateState](functions/getUpdateState.md)
 - [init](functions/init.md)
 - [initSysId](functions/initSysId.md)
+- [installUpdate](functions/installUpdate.md)
 - [invoke](functions/invoke.md)
 - [invokeSys](functions/invokeSys.md)
+- [invokeUpdate](functions/invokeUpdate.md)
 - [isMax](functions/isMax.md)
 - [max](functions/max.md)
 - [maximizable](functions/maximizable.md)
@@ -31990,6 +32195,7 @@ lib/native/index.md
 - [off](functions/off.md)
 - [on](functions/on.md)
 - [once](functions/once.md)
+- [onUpdateState](functions/onUpdateState.md)
 - [open](functions/open.md)
 - [ping](functions/ping.md)
 - [quit](functions/quit.md)
@@ -32009,7 +32215,7 @@ lib/native/interfaces/ICommandEntry.md
 
 # Interface: ICommandEntry
 
-Defined in: [lib/native.ts:87](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L87)
+Defined in: [lib/native.ts:108](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L108)
 
 当前 Native 的公开进程入口，不包含 HTTP 连接凭据
 
@@ -32019,7 +32225,7 @@ Defined in: [lib/native.ts:87](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **args**: `string`[]
 
-Defined in: [lib/native.ts:91](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L91)
+Defined in: [lib/native.ts:112](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L112)
 
 ***
 
@@ -32027,7 +32233,7 @@ Defined in: [lib/native.ts:91](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **command**: `string`
 
-Defined in: [lib/native.ts:90](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L90)
+Defined in: [lib/native.ts:111](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L111)
 
 ***
 
@@ -32035,7 +32241,7 @@ Defined in: [lib/native.ts:90](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **mcp**: `object`
 
-Defined in: [lib/native.ts:93](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L93)
+Defined in: [lib/native.ts:114](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L114)
 
 #### discovery
 
@@ -32051,7 +32257,7 @@ Defined in: [lib/native.ts:93](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **name**: `string`
 
-Defined in: [lib/native.ts:88](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L88)
+Defined in: [lib/native.ts:109](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L109)
 
 ***
 
@@ -32059,7 +32265,7 @@ Defined in: [lib/native.ts:88](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **platform**: `string`
 
-Defined in: [lib/native.ts:89](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L89)
+Defined in: [lib/native.ts:110](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L110)
 
 ***
 
@@ -32067,7 +32273,7 @@ Defined in: [lib/native.ts:89](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **startup**: `"auto"` \| `"existing"`
 
-Defined in: [lib/native.ts:92](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L92)
+Defined in: [lib/native.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L113)
 
 lib/native/interfaces/IMcpInfo.md
 ---
@@ -32080,7 +32286,7 @@ lib/native/interfaces/IMcpInfo.md
 
 # Interface: IMcpInfo
 
-Defined in: [lib/native.ts:80](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L80)
+Defined in: [lib/native.ts:101](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L101)
 
 本地 MCP 客户端连接设置；仅向已授权 root 的 App 提供
 
@@ -32090,7 +32296,7 @@ Defined in: [lib/native.ts:80](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **token**: `string`
 
-Defined in: [lib/native.ts:83](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L83)
+Defined in: [lib/native.ts:104](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L104)
 
 ***
 
@@ -32098,7 +32304,7 @@ Defined in: [lib/native.ts:83](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **transport**: `"streamable-http"`
 
-Defined in: [lib/native.ts:81](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L81)
+Defined in: [lib/native.ts:102](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L102)
 
 ***
 
@@ -32106,7 +32312,117 @@ Defined in: [lib/native.ts:81](https://github.com/maiyun/clickgo/blob/master/dis
 
 > **url**: `string`
 
-Defined in: [lib/native.ts:82](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L82)
+Defined in: [lib/native.ts:103](https://github.com/maiyun/clickgo/blob/master/dist/lib/native.ts#L103)
+
+lib/native/interfaces/IUpdateProgress.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / IUpdateProgress
+
+# Interface: IUpdateProgress
+
+Defined in: [lib/native/update.ts:5](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L5)
+
+下载进度：百分比 0–100，其余值为字节数或字节/秒
+
+## Properties
+
+### bytesPerSecond
+
+> **bytesPerSecond**: `number`
+
+Defined in: [lib/native/update.ts:9](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L9)
+
+***
+
+### percent
+
+> **percent**: `number`
+
+Defined in: [lib/native/update.ts:6](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L6)
+
+***
+
+### total
+
+> **total**: `number`
+
+Defined in: [lib/native/update.ts:8](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L8)
+
+***
+
+### transferred
+
+> **transferred**: `number`
+
+Defined in: [lib/native/update.ts:7](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L7)
+
+lib/native/interfaces/IUpdateState.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/native](../index.md) / IUpdateState
+
+# Interface: IUpdateState
+
+Defined in: [lib/native/update.ts:13](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L13)
+
+Native 软件级更新状态，不含更新源、凭据和安装路径
+
+## Properties
+
+### currentVersion
+
+> **currentVersion**: `string`
+
+Defined in: [lib/native/update.ts:16](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L16)
+
+***
+
+### errorCode?
+
+> `optional` **errorCode?**: `"check-failed"` \| `"download-failed"` \| `"not-ready"` \| `"install-failed"`
+
+Defined in: [lib/native/update.ts:20](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L20)
+
+***
+
+### progress?
+
+> `optional` **progress?**: [`IUpdateProgress`](IUpdateProgress.md)
+
+Defined in: [lib/native/update.ts:18](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L18)
+
+***
+
+### reason?
+
+> `optional` **reason?**: `"not-enabled"` \| `"development"` \| `"portable"`
+
+Defined in: [lib/native/update.ts:19](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L19)
+
+***
+
+### status
+
+> **status**: `"error"` \| `"idle"` \| `"checking"` \| `"available"` \| `"up-to-date"` \| `"disabled"` \| `"downloading"` \| `"downloaded"` \| `"restarting"`
+
+Defined in: [lib/native/update.ts:14](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L14)
+
+***
+
+### version?
+
+> `optional` **version?**: `string`
+
+Defined in: [lib/native/update.ts:17](https://github.com/maiyun/clickgo/blob/master/dist/lib/native/update.ts#L17)
 
 lib/native/namespaces/secret/functions/get.md
 ---