clickgo 7.3.2 → 7.4.1

package/doc/clickgo-rag.md

@@ -1186,6 +1186,16 @@ cell 之间的间距，默认 0。
 
 是否使用与 Tag 相同的朴素模式，默认 false。语义色和主题色使用柔和底色、对应文字色及边框；最终外观由主题决定。
 
+#### pulse
+
+`boolean` | `string`
+
+是否启用同色扩散光圈，默认 false。光圈随 `type` 的语义色或主题色变化，实心与朴素模式均支持；圆点、内容及布局尺寸不参与缩放。启用系统“减少动态效果”时显示静态光圈。
+
+这是布尔开关；`string` 仅兼容 XML 属性传值，并非动画名称或多种效果的枚举。可用 `pulse` 开启，或用 `:pulse="online"` 绑定布尔状态。
+
+光圈向组件外侧绘制，放在 Flow 等滚动容器内时需在滚动区域内部留出空间，避免被 overflow 裁切。
+
 #### sub
 
 `boolean` | `string`
@@ -1211,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>
 ```
 
 
@@ -1324,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`。
-
-### 事件
-
-#### anistart
-
-`() => void`
-
-动画开始时触发。
-
-#### aniend
-
-`() => void`
-
-动画结束时触发。
+`'s' | 'm' | 'l' | 'xl'`，默认 `m`，固定占位分别为 `32 / 48 / 64 / 88px`。插槽不会撑大占位，请使用适当尺寸的 Icon 或简短文字。
 
-### 样式
-
-使用 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
 ---
 
@@ -1383,7 +1381,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1391,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`
@@ -1413,13 +1419,13 @@ cell 之间的间距，默认 0。
 
 `number` | `string`
 
-可选开始时间。
+可选开始时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### end
 
 `number` | `string`
 
-可选结束时间。
+可选结束时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### date
 
@@ -1443,7 +1449,7 @@ cell 之间的间距，默认 0。
 
 `boolean` | `string`
 
-选择后是否自动关闭，默认 true。
+是否显示清空按钮，默认 true。
 
 ### 事件
 
@@ -1451,7 +1457,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDateChangedEvent) => void`
 
-值改变后触发，包含 `value`、`zone` 和 `dates` 信息。
+值改变后触发，包含 `before` 和 `value`。month 模式选中月份或清空时触发，归一化外部赋值不视为用户选择。
 
 #### yearmonthchanged
 
@@ -1471,8 +1477,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <date v-model="timestamp"></date>
+<date mode="month" v-model="monthTimestamp" :tz="0"></date>
 ```
 
+
 ## datepanel
 ---
 
@@ -1496,7 +1504,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1504,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
 
@@ -1594,7 +1610,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDatepanelSelectedEvent) => void`
 
-选中日期时触发。
+选中日期时触发。month 模式的 date 固定为 1，month 仍从 0 开始，time 为所选时区的月初毫秒时间戳。
 
 #### range
 
@@ -1614,8 +1630,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <datepanel v-model="timestamp" time></datepanel>
+<datepanel mode="month" v-model="monthTimestamp" :tz="0"></datepanel>
 ```
 
+
 ## daterange
 ---
 
@@ -6224,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`。
 
-背景样式，默认 `dot`。
+#### modelValue
 
-#### gutter
+`string`，当前选中节点 ID，默认空，可用 v-model。移除选中节点时清空绑定，不触发 select。
 
-`number` | `string`
+#### disabled
 
-子元素间距。
+`boolean | string`，默认 false，禁用视图手势、工具栏和节点选择。
 
-#### alignH
+#### label
 
-`string` | `undefined`
+`string`，空间无障碍名称，由应用提供本地化文案。
 
-水平对齐方式。
+### 事件
 
-#### alignV
+#### select
 
-`string` | `undefined`
+`clickgo.control.IObjviewerSelectEvent`：`detail: {nodeId, label}`。点击、Enter 或空格激活不同的可操作节点时触发；重复选择不触发。控件不执行业务跳转。
 
-垂直对齐方式。
+### 方法
 
-### 样式
+- `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`
-
-色调值，默认 `255`。
-
-#### hover
+#### nodeId
 
-`boolean` | `string`
+`string`，默认空，必填的稳定唯一 ID，用于连接和选择。不使用 ref 或 DOM 引用作为端点。
 
-是否启用悬停效果，默认 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
 ---
 
@@ -14117,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)
@@ -14154,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
 
@@ -16707,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:1741](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1741)
 
-Defined in: [lib/control.ts:1737](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1737)
+按稳定节点 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: IObjviewerLineObj
+# Interface: IObjviewerSelectEvent
 
-Defined in: [lib/control.ts:1749](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1749)
+Defined in: [lib/control.ts:1758](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1758)
+
+节点选择事件，仅通知选择，不在控件内执行业务跳转
 
 ## 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
 ---
@@ -18307,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
 ---
 
@@ -21856,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
 
@@ -36452,7 +36533,7 @@ lib/tool/enumerations/ESTATE.md
 
 # Enumeration: ESTATE
 
-Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L593)
+Defined in: [lib/tool.ts:608](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L608)
 
 状态机状态
 
@@ -36462,7 +36543,7 @@ Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **COMMENT**: `4`
 
-Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L603)
+Defined in: [lib/tool.ts:618](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L618)
 
 注释
 
@@ -36472,7 +36553,7 @@ Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **NORMAL**: `0`
 
-Defined in: [lib/tool.ts:595](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L595)
+Defined in: [lib/tool.ts:610](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L610)
 
 普通
 
@@ -36482,7 +36563,7 @@ Defined in: [lib/tool.ts:595](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **REG**: `3`
 
-Defined in: [lib/tool.ts:601](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L601)
+Defined in: [lib/tool.ts:616](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L616)
 
 正则
 
@@ -36492,7 +36573,7 @@ Defined in: [lib/tool.ts:601](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **STRING**: `2`
 
-Defined in: [lib/tool.ts:599](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L599)
+Defined in: [lib/tool.ts:614](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L614)
 
 字符串
 
@@ -36502,7 +36583,7 @@ Defined in: [lib/tool.ts:599](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **WORD**: `1`
 
-Defined in: [lib/tool.ts:597](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L597)
+Defined in: [lib/tool.ts:612](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L612)
 
 单词
 
@@ -36519,7 +36600,7 @@ lib/tool/functions/blob2ArrayBuffer.md
 
 > **blob2ArrayBuffer**(`blob`): `Promise`\<`ArrayBuffer`\>
 
-Defined in: [lib/tool.ts:71](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L71)
+Defined in: [lib/tool.ts:86](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L86)
 
 将 blob 对象转换为 ArrayBuffer
 
@@ -36548,7 +36629,7 @@ lib/tool/functions/blob2DataUrl.md
 
 > **blob2DataUrl**(`blob`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:494](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L494)
+Defined in: [lib/tool.ts:509](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L509)
 
 将 blob 对象转换为 base64 url
 
@@ -36579,7 +36660,7 @@ lib/tool/functions/blob2Text.md
 
 > **blob2Text**(`blob`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:485](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L485)
+Defined in: [lib/tool.ts:500](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L500)
 
 将 blob 对象转换为 text
 
@@ -36608,7 +36689,7 @@ lib/tool/functions/clone.md
 
 > **clone**\<`T`\>(`obj`): `T`
 
-Defined in: [lib/tool.ts:98](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L98)
+Defined in: [lib/tool.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L113)
 
 完整的克隆一份数组/对象
 
@@ -36645,7 +36726,7 @@ lib/tool/functions/compar.md
 
 > **compar**(`before`, `after`): `object`
 
-Defined in: [lib/tool.ts:507](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L507)
+Defined in: [lib/tool.ts:522](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L522)
 
 - 对比老值和新值，看看新值中哪些移除了，哪些新增了
 
@@ -36700,9 +36781,9 @@ lib/tool/functions/compressor.md
 
 > **compressor**\<`T`\>(`file`, `options?`): `Promise`\<`false` \| `T`\>
 
-Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L35)
+Defined in: [lib/tool.ts:57](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L57)
 
-压缩一个图片
+压缩图片，质量降档复用同一画布，保留方向校正及等比缩放
 
 ## Type Parameters
 
@@ -36716,33 +36797,30 @@ Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/
 
 `T`
 
-文件或 blob 类型
+图片文件或 Blob；File 输入返回 File，转换格式时同步扩展名和 MIME 类型
 
 ### options?
 
-参数
+[`ICompressorOptions`](../interfaces/ICompressorOptions.md) = `{}`
 
-#### maxHeight?
+压缩参数
 
-`number`
-
-最高高度，默认无限
-
-#### maxWidth?
-
-`number`
-
-最大宽度，默认无限
-
-#### quality?
+## Returns
 
-`number`
+`Promise`\<`false` \| `T`\>
 
-压缩质量，默认 0.8
+压缩后的图片；参数无效、加载或编码失败、指定格式不受支持或无法满足大小上限时返回 false
 
-## Returns
+## Example
 
-`Promise`\<`false` \| `T`\>
+```ts
+const image = await clickgo.tool.compressor(file, {
+    'mimeType': 'image/jpeg',
+    'maxWidth': 2000,
+    'quality': [0.9, 0.6, 0.5],
+    'maxSize': 2 * 1024 * 1024,
+});
+```
 
 lib/tool/functions/decodeText.md
 ---
@@ -36831,7 +36909,7 @@ lib/tool/functions/escapeHTML.md
 
 > **escapeHTML**(`html`): `string`
 
-Defined in: [lib/tool.ts:278](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L278)
+Defined in: [lib/tool.ts:293](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L293)
 
 转义 HTML
 
@@ -36860,7 +36938,7 @@ lib/tool/functions/eventsAttrWrap.md
 
 > **eventsAttrWrap**(`layout`): `string`
 
-Defined in: [lib/tool.ts:188](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L188)
+Defined in: [lib/tool.ts:203](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L203)
 
 对 layout 的 events 事件进行包裹
 
@@ -36889,7 +36967,7 @@ lib/tool/functions/execCommand.md
 
 > **execCommand**(`ac`): `void`
 
-Defined in: [lib/tool.ts:498](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L498)
+Defined in: [lib/tool.ts:513](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L513)
 
 ## Parameters
 
@@ -36914,7 +36992,7 @@ lib/tool/functions/fetch.md
 
 > **fetch**(`url`, `init?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:377](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L377)
+Defined in: [lib/tool.ts:392](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L392)
 
 发起 fetch 请求
 
@@ -36951,7 +37029,7 @@ lib/tool/functions/formatColor.md
 
 > **formatColor**(`color`): `number`[]
 
-Defined in: [lib/tool.ts:294](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L294)
+Defined in: [lib/tool.ts:309](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L309)
 
 将 rgb 或 hsl 等颜色转换为数字数组
 
@@ -36980,7 +37058,7 @@ lib/tool/functions/formatSecond.md
 
 > **formatSecond**(`second`): `string`
 
-Defined in: [lib/tool.ts:519](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L519)
+Defined in: [lib/tool.ts:534](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L534)
 
 将秒数格式化为 0:0:0 的字符串
 
@@ -37007,7 +37085,7 @@ lib/tool/functions/formatTime.md
 
 > **formatTime**(`ts`, `tz?`): `object`
 
-Defined in: [lib/tool.ts:528](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L528)
+Defined in: [lib/tool.ts:543](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L543)
 
 将日期对象或毫秒级时间戳转换为字符串
 
@@ -37054,7 +37132,7 @@ lib/tool/functions/getArray.md
 
 > **getArray**(`param`): `any`[]
 
-Defined in: [lib/tool.ts:270](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L270)
+Defined in: [lib/tool.ts:285](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L285)
 
 根据参数获取最终的数组型，可传入类似 [1,2,3] 或 1,2,3
 
@@ -37083,7 +37161,7 @@ lib/tool/functions/getBoolean.md
 
 > **getBoolean**(`param`): `boolean`
 
-Defined in: [lib/tool.ts:254](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L254)
+Defined in: [lib/tool.ts:269](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L269)
 
 根据参数获取最终的布尔值
 
@@ -37112,7 +37190,7 @@ lib/tool/functions/getClassPrototype.md
 
 > **getClassPrototype**(`obj`, `over?`, `level?`): [`IClassPrototype`](../interfaces/IClassPrototype.md)
 
-Defined in: [lib/tool.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L63)
+Defined in: [lib/tool.ts:78](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L78)
 
 获取 class 的所有 method 和 get/set
 
@@ -37153,7 +37231,7 @@ lib/tool/functions/get.md
 
 > **get**(`url`, `init?`, `opt?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:388](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L388)
+Defined in: [lib/tool.ts:403](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L403)
 
 发起 GET 请求
 
@@ -37200,7 +37278,7 @@ lib/tool/functions/getMimeByPath.md
 
 > **getMimeByPath**(`path`): `object`
 
-Defined in: [lib/tool.ts:214](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L214)
+Defined in: [lib/tool.ts:229](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L229)
 
 根据后缀、文件名或路径获取 mime 类型（简单版，完整版请使用 @litert/mime.js）
 
@@ -37237,7 +37315,7 @@ lib/tool/functions/getNumber.md
 
 > **getNumber**(`param`): `number`
 
-Defined in: [lib/tool.ts:262](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L262)
+Defined in: [lib/tool.ts:277](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L277)
 
 根据参数获取最终的数字型
 
@@ -37266,7 +37344,7 @@ lib/tool/functions/getResponseJson.md
 
 > **getResponseJson**(`url`, `init?`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:414](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L414)
+Defined in: [lib/tool.ts:429](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L429)
 
 发起 GET 请求并解析 JSON 响应
 
@@ -37303,7 +37381,7 @@ lib/tool/functions/hex2rgb.md
 
 > **hex2rgb**(`hex`): `object`
 
-Defined in: [lib/tool.ts:312](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L312)
+Defined in: [lib/tool.ts:327](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L327)
 
 hex 转换为 rgba，#27ae60ff, 27ae60 #fff
 
@@ -37352,7 +37430,7 @@ lib/tool/functions/hsl2rgb.md
 
 > **hsl2rgb**(`h`, `s?`, `l?`, `a?`, `decimal?`): `object`
 
-Defined in: [lib/tool.ts:350](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L350)
+Defined in: [lib/tool.ts:365](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L365)
 
 hsl 字符串转 rgb 数组
 
@@ -37425,7 +37503,7 @@ lib/tool/functions/isEscapeChar.md
 
 > **isEscapeChar**(`code`, `index`): `boolean`
 
-Defined in: [lib/tool.ts:588](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L588)
+Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L603)
 
 判断字符是否是转义字符
 
@@ -37462,7 +37540,7 @@ lib/tool/functions/isEscaped.md
 
 > **isEscaped**(`str`, `pos`): `boolean`
 
-Defined in: [lib/tool.ts:568](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L568)
+Defined in: [lib/tool.ts:583](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L583)
 
 转义字符检查
 检查指定位置的字符是否被转义
@@ -37500,7 +37578,7 @@ lib/tool/functions/isFalsy.md
 
 > **isFalsy**(`val`): `val is TFalsy`
 
-Defined in: [lib/tool.ts:713](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L713)
+Defined in: [lib/tool.ts:728](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L728)
 
 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0）
 
@@ -37529,7 +37607,7 @@ lib/tool/functions/isJson.md
 
 > **isJson**(`value`): `value is TJson`
 
-Defined in: [lib/tool.ts:705](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L705)
+Defined in: [lib/tool.ts:720](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L720)
 
 判断 JS 值是否符合 JSON 数据约束；字符串按数据值接受，不解析其内容
 
@@ -37560,7 +37638,7 @@ lib/tool/functions/isMs.md
 
 > **isMs**(`time`): `boolean`
 
-Defined in: [lib/tool.ts:540](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L540)
+Defined in: [lib/tool.ts:555](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L555)
 
 是否是毫秒
 
@@ -37589,7 +37667,7 @@ lib/tool/functions/isTruthy.md
 
 > **isTruthy**(`val`): `val is any`
 
-Defined in: [lib/tool.ts:721](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L721)
+Defined in: [lib/tool.ts:736](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L736)
 
 判断一个值是否是真实的（不为 null/undefined/空字符串/false/0）
 
@@ -37618,7 +37696,7 @@ lib/tool/functions/layoutAddTagClassAndReTagName.md
 
 > **layoutAddTagClassAndReTagName**(`layout`, `retagname`): `string`
 
-Defined in: [lib/tool.ts:161](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L161)
+Defined in: [lib/tool.ts:176](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L176)
 
 给标签增加 tag-tagname 的 class，同时给标签增加 cg- 前导（仅字符串，不是操作真实 dom）
 
@@ -37653,7 +37731,7 @@ lib/tool/functions/layoutClassPrepend.md
 
 > **layoutClassPrepend**(`layout`, `preps`): `string`
 
-Defined in: [lib/tool.ts:180](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L180)
+Defined in: [lib/tool.ts:195](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L195)
 
 给 class 增加 scope 的随机前缀，给 id 新增前缀
 
@@ -37688,7 +37766,7 @@ lib/tool/functions/layoutInsertAttr.md
 
 > **layoutInsertAttr**(`layout`, `insert`, `opt?`): `string`
 
-Defined in: [lib/tool.ts:171](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L171)
+Defined in: [lib/tool.ts:186](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L186)
 
 给标签追加 attr，即使 attr 存在也会追加上一个新的（非真实 DOM 操作，仅仅是对字符串进行处理）
 
@@ -37735,7 +37813,7 @@ lib/tool/functions/loadAssets.md
 
 > **loadAssets**(`urls`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:686](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L686)
+Defined in: [lib/tool.ts:701](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L701)
 
 批量并行加载 JS 和 CSS；JS 按列表顺序执行，CSS 按列表顺序插入
 
@@ -37774,7 +37852,7 @@ lib/tool/functions/loadLink.md
 
 > **loadLink**(`url`, `pos?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:665](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L665)
+Defined in: [lib/tool.ts:680](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L680)
 
 加载 css 文件
 
@@ -37809,7 +37887,7 @@ lib/tool/functions/loadLinks.md
 
 > **loadLinks**(`urls`, `opt?`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:674](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L674)
+Defined in: [lib/tool.ts:689](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L689)
 
 批量加载 css 文件
 
@@ -37846,7 +37924,7 @@ lib/tool/functions/loadScript.md
 
 > **loadScript**(`url`, `ordered?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:643](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L643)
+Defined in: [lib/tool.ts:658](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L658)
 
 加载脚本
 
@@ -37883,7 +37961,7 @@ lib/tool/functions/loadScripts.md
 
 > **loadScripts**(`urls`, `opt?`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:652](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L652)
+Defined in: [lib/tool.ts:667](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L667)
 
 批量加载 js 文件
 
@@ -37926,7 +38004,7 @@ lib/tool/functions/loadStyle.md
 
 > **loadStyle**(`style`): `void`
 
-Defined in: [lib/tool.ts:696](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L696)
+Defined in: [lib/tool.ts:711](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L711)
 
 加载 css 字符串
 
@@ -37955,7 +38033,7 @@ lib/tool/functions/logicalOr.md
 
 > **logicalOr**\<`T`, `T2`\>(`v1`, `v2`): \[`T`\] *extends* \[[`TFalsy`](../type-aliases/TFalsy.md)\] ? `T2` : `T`
 
-Defined in: [lib/tool.ts:730](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L730)
+Defined in: [lib/tool.ts:745](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L745)
 
 类似 || 运算符的效果
 
@@ -38000,7 +38078,7 @@ lib/tool/functions/match.md
 
 > **match**(`str`, `regs`): `boolean`
 
-Defined in: [lib/tool.ts:138](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L138)
+Defined in: [lib/tool.ts:153](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L153)
 
 传入正则进行匹配 str 是否有一项满足
 
@@ -38035,7 +38113,7 @@ lib/tool/functions/nextFrame.md
 
 > **nextFrame**(): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L113)
+Defined in: [lib/tool.ts:128](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L128)
 
 等待浏览器帧
 
@@ -38056,7 +38134,7 @@ lib/tool/functions/parseArrayString.md
 
 > **parseArrayString**(`arrayStr`): `string`[]
 
-Defined in: [lib/tool.ts:578](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L578)
+Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L593)
 
 数组字符串解析器
 解析数组字符串为各元素组成的字符串数组
@@ -38088,7 +38166,7 @@ lib/tool/functions/parseUrl.md
 
 > **parseUrl**(`url`): [`IUrl`](../interfaces/IUrl.md)
 
-Defined in: [lib/tool.ts:463](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L463)
+Defined in: [lib/tool.ts:478](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L478)
 
 传输 url 并解析为 IUrl 对象
 
@@ -38117,7 +38195,7 @@ lib/tool/functions/post.md
 
 > **post**(`url`, `data`, `init?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:402](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L402)
+Defined in: [lib/tool.ts:417](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L417)
 
 发起 POST 请求（除 FormData 外都会转换为 JSON 提交）
 
@@ -38160,7 +38238,7 @@ lib/tool/functions/postResponseEventStream.md
 
 > **postResponseEventStream**(`url`, `data`, `opts?`): `AbortController`
 
-Defined in: [lib/tool.ts:425](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L425)
+Defined in: [lib/tool.ts:440](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L440)
 
 发起 JSON 请求并获得文本 SSE 响应
 
@@ -38235,7 +38313,7 @@ lib/tool/functions/postResponseJson.md
 
 > **postResponseJson**(`url`, `data`, `init?`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:453](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L453)
+Defined in: [lib/tool.ts:468](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L468)
 
 发起 POST 请求并解析 JSON 响应
 
@@ -38278,7 +38356,7 @@ lib/tool/functions/purify.md
 
 > **purify**(`text`): `string`
 
-Defined in: [lib/tool.ts:129](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L129)
+Defined in: [lib/tool.ts:144](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L144)
 
 去除 html 的空白符、换行以及注释
 
@@ -38307,7 +38385,7 @@ lib/tool/functions/queryParse.md
 
 > **queryParse**(`query`): `Record`\<`string`, `string` \| `string`[]\>
 
-Defined in: [lib/tool.ts:557](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L557)
+Defined in: [lib/tool.ts:572](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L572)
 
 将 query string 转换为对象
 
@@ -38336,7 +38414,7 @@ lib/tool/functions/queryStringify.md
 
 > **queryStringify**(`query`, `encode?`): `string`
 
-Defined in: [lib/tool.ts:549](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L549)
+Defined in: [lib/tool.ts:564](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L564)
 
 将对象转换为 query string
 
@@ -38371,7 +38449,7 @@ lib/tool/functions/rand.md
 
 > **rand**(`min`, `max`, `prec?`): `number`
 
-Defined in: [lib/tool.ts:224](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L224)
+Defined in: [lib/tool.ts:239](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L239)
 
 生成范围内的随机数
 
@@ -38412,7 +38490,7 @@ lib/tool/functions/random.md
 
 > **random**(`length?`, `source?`, `block?`): `string`
 
-Defined in: [lib/tool.ts:246](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L246)
+Defined in: [lib/tool.ts:261](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L261)
 
 生成随机字符串
 
@@ -38455,7 +38533,7 @@ lib/tool/functions/request.md
 
 > **request**(`url`, `opt`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:367](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L367)
+Defined in: [lib/tool.ts:382](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L382)
 
 发起一个网络请求，若是返回值是 JSON 则自动解析，否则直接返回字符串
 
@@ -38490,7 +38568,7 @@ lib/tool/functions/rgb2hex.md
 
 > **rgb2hex**(`r`, `g?`, `b?`, `a?`): `string`
 
-Defined in: [lib/tool.ts:304](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L304)
+Defined in: [lib/tool.ts:319](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L319)
 
 将 r, g, b 转换为 hex 字符串，不含 #
 
@@ -38535,7 +38613,7 @@ lib/tool/functions/rgb2hsl.md
 
 > **rgb2hsl**(`r`, `g?`, `b?`, `a?`, `decimal?`): `object`
 
-Defined in: [lib/tool.ts:330](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L330)
+Defined in: [lib/tool.ts:345](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L345)
 
 rgb 字符串转 hsl 数组
 
@@ -38639,7 +38717,7 @@ lib/tool/functions/sizeFormat.md
 
 > **sizeFormat**(`size`, `spliter?`): `string`
 
-Defined in: [lib/tool.ts:80](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L80)
+Defined in: [lib/tool.ts:95](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L95)
 
 将文件大小格式化为带单位的字符串
 
@@ -38674,7 +38752,7 @@ lib/tool/functions/sleepFrame.md
 
 > **sleepFrame**(`count`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:121](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L121)
+Defined in: [lib/tool.ts:136](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L136)
 
 等待浏览器帧
 
@@ -38703,7 +38781,7 @@ lib/tool/functions/sleep.md
 
 > **sleep**(`ms?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:106](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L106)
+Defined in: [lib/tool.ts:121](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L121)
 
 等待毫秒
 
@@ -38732,7 +38810,7 @@ lib/tool/functions/stateMachine.md
 
 > **stateMachine**(`code`, `start`, `process`): `void`
 
-Defined in: [lib/tool.ts:613](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L613)
+Defined in: [lib/tool.ts:628](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L628)
 
 源码分段状态机，单词按 ASCII 字母、数字、_ 和 $ 识别
 
@@ -38775,7 +38853,7 @@ lib/tool/functions/stylePrepend.md
 
 > **stylePrepend**(`style`, `prep?`): `object`
 
-Defined in: [lib/tool.ts:206](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L206)
+Defined in: [lib/tool.ts:221](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L221)
 
 给 class 前部增加唯一标识符
 
@@ -38818,7 +38896,7 @@ lib/tool/functions/styleUrl2DataUrl.md
 
 > **styleUrl2DataUrl**(`path`, `style`, `files`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L148)
+Defined in: [lib/tool.ts:163](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L163)
 
 将 style 中的 url 转换成 base64 data url
 
@@ -38859,7 +38937,7 @@ lib/tool/functions/teleportGlue.md
 
 > **teleportGlue**(`layout`, `formId`): `string`
 
-Defined in: [lib/tool.ts:197](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L197)
+Defined in: [lib/tool.ts:212](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L212)
 
 对 layout 的 teleport 做转义处理为 vue 识别的内容
 
@@ -38894,7 +38972,7 @@ lib/tool/functions/unescapeHTML.md
 
 > **unescapeHTML**(`html`): `string`
 
-Defined in: [lib/tool.ts:286](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L286)
+Defined in: [lib/tool.ts:301](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L301)
 
 还原转义后的 HTML
 
@@ -38923,7 +39001,7 @@ lib/tool/functions/urlAtom.md
 
 > **urlAtom**(`url`): `string`
 
-Defined in: [lib/tool.ts:477](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L477)
+Defined in: [lib/tool.ts:492](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L492)
 
 处理 URL 中的 .. / . 等
 
@@ -38950,7 +39028,7 @@ lib/tool/functions/urlResolve.md
 
 > **urlResolve**(`from`, `to`): `string`
 
-Defined in: [lib/tool.ts:472](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L472)
+Defined in: [lib/tool.ts:487](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L487)
 
 将相对路径根据基准路径进行转换
 
@@ -38985,7 +39063,7 @@ lib/tool/functions/weightFormat.md
 
 > **weightFormat**(`weight`, `spliter?`): `string`
 
-Defined in: [lib/tool.ts:89](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L89)
+Defined in: [lib/tool.ts:104](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L104)
 
 将毫克重量格式化为带单位的字符串
 
@@ -39025,6 +39103,7 @@ lib/tool/index.md
 ## Interfaces
 
 - [IClassPrototype](interfaces/IClassPrototype.md)
+- [ICompressorOptions](interfaces/ICompressorOptions.md)
 - [IDecodedText](interfaces/IDecodedText.md)
 - [IRequestOptions](interfaces/IRequestOptions.md)
 - [ITextEncoding](interfaces/ITextEncoding.md)
@@ -39130,7 +39209,7 @@ lib/tool/interfaces/IClassPrototype.md
 
 # Interface: IClassPrototype
 
-Defined in: [lib/tool.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L47)
+Defined in: [lib/tool.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L62)
 
 类原型信息
 
@@ -39140,7 +39219,7 @@ Defined in: [lib/tool.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/
 
 > **access**: `Record`\<`string`, \{ `get`: `any`; `set`: `any`; \}\>
 
-Defined in: [lib/tool.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L51)
+Defined in: [lib/tool.ts:66](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L66)
 
 访问器列表，key 为属性名，value 为包含 get 和 set 的对象，例如：{'prop1': { 'get': function() { ... }, 'set': function(v) { ... } }}
 
@@ -39150,10 +39229,75 @@ Defined in: [lib/tool.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/
 
 > **method**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/tool.ts:49](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L49)
+Defined in: [lib/tool.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L64)
 
 方法列表，key 为方法名，value 为函数体，例如：{'method1': function() { ... }}
 
+lib/tool/interfaces/ICompressorOptions.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/tool](../index.md) / ICompressorOptions
+
+# Interface: ICompressorOptions
+
+Defined in: [lib/tool.ts:31](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L31)
+
+图片压缩参数，未指定大小上限时仅使用第一档质量
+
+## Properties
+
+### maxHeight?
+
+> `optional` **maxHeight?**: `number`
+
+Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L35)
+
+最高高度，默认无限
+
+***
+
+### maxSize?
+
+> `optional` **maxSize?**: `number`
+
+Defined in: [lib/tool.ts:41](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L41)
+
+文件大小上限，单位字节，须为正有限数；各档都超限时返回 false，不再额外缩小尺寸或降质
+
+***
+
+### maxWidth?
+
+> `optional` **maxWidth?**: `number`
+
+Defined in: [lib/tool.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L33)
+
+最大宽度，默认无限
+
+***
+
+### mimeType?
+
+> `optional` **mimeType?**: `"auto"` \| `"image/jpeg"` \| `"image/png"` \| `"image/webp"`
+
+Defined in: [lib/tool.ts:39](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L39)
+
+输出格式，默认 auto 保留压缩器的自动选择；JPEG 的透明区域填白
+
+***
+
+### quality?
+
+> `optional` **quality?**: `number` \| readonly `number`[]
+
+Defined in: [lib/tool.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L37)
+
+编码质量，取值 0 至 1，默认 0.8；数组按顺序尝试，仅 JPEG/WebP 支持调节质量
+
 lib/tool/interfaces/IDecodedText.md
 ---
 
@@ -39216,7 +39360,7 @@ lib/tool/interfaces/IRequestOptions.md
 
 # Interface: IRequestOptions
 
-Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L850)
+Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L865)
 
 请求选项
 
@@ -39226,7 +39370,7 @@ Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **body?**: `FormData`
 
-Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L853)
+Defined in: [lib/tool.ts:868](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L868)
 
 ***
 
@@ -39234,7 +39378,7 @@ Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **credentials?**: `boolean`
 
-Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L851)
+Defined in: [lib/tool.ts:866](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L866)
 
 ***
 
@@ -39242,7 +39386,7 @@ Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **end?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:862](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L862)
+Defined in: [lib/tool.ts:877](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L877)
 
 #### Returns
 
@@ -39254,7 +39398,7 @@ Defined in: [lib/tool.ts:862](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **error?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L865)
+Defined in: [lib/tool.ts:880](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L880)
 
 #### Returns
 
@@ -39266,7 +39410,7 @@ Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **headers?**: `HeadersInit`
 
-Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L856)
+Defined in: [lib/tool.ts:871](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L871)
 
 ***
 
@@ -39274,7 +39418,7 @@ Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **load?**: (`res`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:864](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L864)
+Defined in: [lib/tool.ts:879](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L879)
 
 #### Parameters
 
@@ -39292,7 +39436,7 @@ Defined in: [lib/tool.ts:864](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **method?**: `"GET"` \| `"POST"`
 
-Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L852)
+Defined in: [lib/tool.ts:867](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L867)
 
 ***
 
@@ -39300,7 +39444,7 @@ Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **progress?**: (`loaded`, `total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:863](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L863)
+Defined in: [lib/tool.ts:878](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L878)
 
 #### Parameters
 
@@ -39322,7 +39466,7 @@ Defined in: [lib/tool.ts:863](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **responseType?**: `XMLHttpRequestResponseType`
 
-Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L855)
+Defined in: [lib/tool.ts:870](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L870)
 
 ***
 
@@ -39330,7 +39474,7 @@ Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **start?**: (`total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L861)
+Defined in: [lib/tool.ts:876](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L876)
 
 #### Parameters
 
@@ -39348,7 +39492,7 @@ Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **timeout?**: `number`
 
-Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L854)
+Defined in: [lib/tool.ts:869](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L869)
 
 ***
 
@@ -39356,7 +39500,7 @@ Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadEnd?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L860)
+Defined in: [lib/tool.ts:875](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L875)
 
 #### Returns
 
@@ -39368,7 +39512,7 @@ Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadProgress?**: (`loaded`, `total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L859)
+Defined in: [lib/tool.ts:874](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L874)
 
 #### Parameters
 
@@ -39390,7 +39534,7 @@ Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadStart?**: (`total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:858](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L858)
+Defined in: [lib/tool.ts:873](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L873)
 
 #### Parameters
 
@@ -39448,7 +39592,7 @@ lib/tool/interfaces/IUrl.md
 
 # Interface: IUrl
 
-Defined in: [lib/tool.ts:835](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L835)
+Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L850)
 
 网址对象
 
@@ -39458,7 +39602,7 @@ Defined in: [lib/tool.ts:835](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **auth**: `string` \| `null`
 
-Defined in: [lib/tool.ts:836](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L836)
+Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L851)
 
 ***
 
@@ -39466,7 +39610,7 @@ Defined in: [lib/tool.ts:836](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **hash**: `string` \| `null`
 
-Defined in: [lib/tool.ts:837](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L837)
+Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L852)
 
 ***
 
@@ -39474,7 +39618,7 @@ Defined in: [lib/tool.ts:837](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **host**: `string` \| `null`
 
-Defined in: [lib/tool.ts:838](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L838)
+Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L853)
 
 ***
 
@@ -39482,7 +39626,7 @@ Defined in: [lib/tool.ts:838](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **hostname**: `string` \| `null`
 
-Defined in: [lib/tool.ts:839](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L839)
+Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L854)
 
 ***
 
@@ -39490,7 +39634,7 @@ Defined in: [lib/tool.ts:839](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **pass**: `string` \| `null`
 
-Defined in: [lib/tool.ts:840](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L840)
+Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L855)
 
 ***
 
@@ -39498,7 +39642,7 @@ Defined in: [lib/tool.ts:840](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **path**: `string` \| `null`
 
-Defined in: [lib/tool.ts:841](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L841)
+Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L856)
 
 ***
 
@@ -39506,7 +39650,7 @@ Defined in: [lib/tool.ts:841](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **pathname**: `string`
 
-Defined in: [lib/tool.ts:842](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L842)
+Defined in: [lib/tool.ts:857](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L857)
 
 ***
 
@@ -39514,7 +39658,7 @@ Defined in: [lib/tool.ts:842](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **port**: `string` \| `null`
 
-Defined in: [lib/tool.ts:844](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L844)
+Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L859)
 
 ***
 
@@ -39522,7 +39666,7 @@ Defined in: [lib/tool.ts:844](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **protocol**: `string` \| `null`
 
-Defined in: [lib/tool.ts:843](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L843)
+Defined in: [lib/tool.ts:858](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L858)
 
 ***
 
@@ -39530,7 +39674,7 @@ Defined in: [lib/tool.ts:843](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **query**: `string` \| `null`
 
-Defined in: [lib/tool.ts:845](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L845)
+Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L860)
 
 ***
 
@@ -39538,7 +39682,7 @@ Defined in: [lib/tool.ts:845](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **user**: `string` \| `null`
 
-Defined in: [lib/tool.ts:846](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L846)
+Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L861)
 
 lib/tool/type-aliases/TFalsy.md
 ---
@@ -39553,7 +39697,7 @@ lib/tool/type-aliases/TFalsy.md
 
 > **TFalsy** = `false` \| `""` \| `0` \| `null` \| `undefined` \| *typeof* `NaN`
 
-Defined in: [lib/tool.ts:872](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L872)
+Defined in: [lib/tool.ts:887](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L887)
 
 虚假值类型
 
@@ -39570,7 +39714,7 @@ lib/tool/type-aliases/TJson.md
 
 > **TJson** = `null` \| `boolean` \| `number` \| `string` \| `TJson`[] \| \{\[`key`: `string`\]: `TJson`; \}
 
-Defined in: [lib/tool.ts:869](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L869)
+Defined in: [lib/tool.ts:884](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L884)
 
 JSON 数据值，不包含 undefined、BigInt、函数和非有限数
 
@@ -39604,7 +39748,7 @@ lib/tool/variables/lang.md
 
 > `const` **lang**: `object`
 
-Defined in: [lib/tool.ts:735](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L735)
+Defined in: [lib/tool.ts:750](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L750)
 
 语言相关
 
@@ -39701,7 +39845,7 @@ lib/tool/variables/RANDOM_L.md
 
 > `const` **RANDOM\_L**: `"abcdefghijklmnopqrstuvwxyz"` = `'abcdefghijklmnopqrstuvwxyz'`
 
-Defined in: [lib/tool.ts:230](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L230)
+Defined in: [lib/tool.ts:245](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L245)
 
 lib/tool/variables/RANDOM_LN.md
 ---
@@ -39716,7 +39860,7 @@ lib/tool/variables/RANDOM_LN.md
 
 > `const` **RANDOM\_LN**: `string`
 
-Defined in: [lib/tool.ts:233](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L233)
+Defined in: [lib/tool.ts:248](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L248)
 
 lib/tool/variables/RANDOM_LU.md
 ---
@@ -39731,7 +39875,7 @@ lib/tool/variables/RANDOM_LU.md
 
 > `const` **RANDOM\_LU**: `string`
 
-Defined in: [lib/tool.ts:234](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L234)
+Defined in: [lib/tool.ts:249](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L249)
 
 lib/tool/variables/RANDOM_LUN.md
 ---
@@ -39746,7 +39890,7 @@ lib/tool/variables/RANDOM_LUN.md
 
 > `const` **RANDOM\_LUN**: `string`
 
-Defined in: [lib/tool.ts:235](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L235)
+Defined in: [lib/tool.ts:250](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L250)
 
 lib/tool/variables/RANDOM_LUNS.md
 ---
@@ -39761,7 +39905,7 @@ lib/tool/variables/RANDOM_LUNS.md
 
 > `const` **RANDOM\_LUNS**: `string`
 
-Defined in: [lib/tool.ts:237](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L237)
+Defined in: [lib/tool.ts:252](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L252)
 
 lib/tool/variables/RANDOM_N.md
 ---
@@ -39776,7 +39920,7 @@ lib/tool/variables/RANDOM_N.md
 
 > `const` **RANDOM\_N**: `"0123456789"` = `'0123456789'`
 
-Defined in: [lib/tool.ts:228](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L228)
+Defined in: [lib/tool.ts:243](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L243)
 
 lib/tool/variables/RANDOM_U.md
 ---
@@ -39791,7 +39935,7 @@ lib/tool/variables/RANDOM_U.md
 
 > `const` **RANDOM\_U**: `"ABCDEFGHIJKLMNOPQRSTUVWXYZ"` = `'ABCDEFGHIJKLMNOPQRSTUVWXYZ'`
 
-Defined in: [lib/tool.ts:229](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L229)
+Defined in: [lib/tool.ts:244](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L244)
 
 lib/tool/variables/RANDOM_UN.md
 ---
@@ -39806,7 +39950,7 @@ lib/tool/variables/RANDOM_UN.md
 
 > `const` **RANDOM\_UN**: `string`
 
-Defined in: [lib/tool.ts:232](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L232)
+Defined in: [lib/tool.ts:247](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L247)
 
 lib/tool/variables/RANDOM_V.md
 ---
@@ -39821,7 +39965,7 @@ lib/tool/variables/RANDOM_V.md
 
 > `const` **RANDOM\_V**: `"ACEFGHJKLMNPRSTWXY34567"` = `'ACEFGHJKLMNPRSTWXY34567'`
 
-Defined in: [lib/tool.ts:236](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L236)
+Defined in: [lib/tool.ts:251](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L251)
 
 lib/zip/classes/Zip.md
 ---