@maiyunnet/kebab 9.4.1 → 9.6.0

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.4.1"` = `'9.4.1'`
+> `const` **VER**: `"9.6.0"` = `'9.6.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -3258,7 +3258,7 @@ lib/core/functions/clone.md
 
 > **clone**\<`T`\>(`obj`): `T`
 
-Defined in: [lib/core.ts:1124](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1124)
+Defined in: [lib/core.ts:1167](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1167)
 
 完整的克隆一份数组/对象
 
@@ -3322,7 +3322,7 @@ lib/core/functions/debug.md
 
 > **debug**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1158](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1158)
+Defined in: [lib/core.ts:1201](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1201)
 
 打印调试信息，线上环境不会打印
 
@@ -3357,7 +3357,7 @@ lib/core/functions/display.md
 
 > **display**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1171](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1171)
+Defined in: [lib/core.ts:1214](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1214)
 
 向控制台直接显示内容，一般情况下禁止使用
 
@@ -3462,7 +3462,7 @@ lib/core/functions/getLog.md
 
 > **getLog**(`opt`): `Promise`\<`false` \| `any`[] \| `string`[][] \| `null`\>
 
-Defined in: [lib/core.ts:1031](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1031)
+Defined in: [lib/core.ts:1074](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1074)
 
 获取日志内容为一个数组
 
@@ -3603,7 +3603,7 @@ lib/core/functions/loadEnv.md
 
 > **loadEnv**(`dir`): `Promise`\<`void`\>
 
-Defined in: [lib/core.ts:1223](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1223)
+Defined in: [lib/core.ts:1266](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1266)
 
 加载 .env 文件到 process.env，若文件不存在则跳过
 
@@ -3632,7 +3632,7 @@ lib/core/functions/log.md
 
 > **log**(`opt`, `msg`, `fend?`): `void`
 
-Defined in: [lib/core.ts:920](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L920)
+Defined in: [lib/core.ts:963](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L963)
 
 写入文件日志
 
@@ -3673,7 +3673,7 @@ lib/core/functions/ls.md
 
 > **ls**(`opt`): `Promise`\<`object`[]\>
 
-Defined in: [lib/core.ts:1085](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1085)
+Defined in: [lib/core.ts:1128](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1128)
 
 获取目录内文件/文件夹列表
 
@@ -3997,9 +3997,9 @@ lib/core/functions/removeGlobal.md
 
 # Function: removeGlobal()
 
-> **removeGlobal**(`key`, `hosts?`): `Promise`\<`string`[]\>
+> **removeGlobal**(`key`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:750](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L750)
+Defined in: [lib/core.ts:782](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L782)
 
 移除某个跨线程/跨内网服务器全局变量
 
@@ -4013,13 +4013,13 @@ Defined in: [lib/core.ts:750](https://github.com/maiyunnet/kebab/blob/master/lib
 
 ### hosts?
 
-`string`[]
+`string`[] \| `"config"`
 
 局域网列表
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/resolveEnvVars.md
 ---
@@ -4034,7 +4034,7 @@ lib/core/functions/resolveEnvVars.md
 
 > **resolveEnvVars**(`obj`): `void`
 
-Defined in: [lib/core.ts:1253](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1253)
+Defined in: [lib/core.ts:1296](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1296)
 
 将配置对象中的 ${ENV_VAR} 占位符替换为 process.env 的值
 
@@ -4061,9 +4061,9 @@ lib/core/functions/sendNpm.md
 
 # Function: sendNpm()
 
-> **sendNpm**(`path`, `hosts?`): `Promise`\<`string`[]\>
+> **sendNpm**(`path`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:663](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L663)
+Defined in: [lib/core.ts:683](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L683)
 
 向本机或局域网 RPC 发送 npm install 操作
 
@@ -4079,11 +4079,11 @@ Defined in: [lib/core.ts:663](https://github.com/maiyunnet/kebab/blob/master/lib
 
 `string`[] \| `"config"`
 
-局域网列表
+局域网列表，不填则代表本机
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sendPackage.md
 ---
@@ -4096,9 +4096,9 @@ lib/core/functions/sendPackage.md
 
 # Function: sendPackage()
 
-> **sendPackage**(`content`, `hosts?`): `Promise`\<`string`[]\>
+> **sendPackage**(`content`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:865](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L865)
+Defined in: [lib/core.ts:904](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L904)
 
 向本机或局域网 RPC 发送 package.json 更新操作
 
@@ -4118,7 +4118,7 @@ package.json 文件内容
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sendPm2.md
 ---
@@ -4131,9 +4131,9 @@ lib/core/functions/sendPm2.md
 
 # Function: sendPm2()
 
-> **sendPm2**(`name`, `action?`, `hosts?`): `Promise`\<`string`[]\>
+> **sendPm2**(`name`, `action?`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:620](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L620)
+Defined in: [lib/core.ts:636](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L636)
 
 向本机或局域网 RPC 发送 PM2 操作
 
@@ -4159,7 +4159,7 @@ PM2 操作类型
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sendProject.md
 ---
@@ -4172,9 +4172,9 @@ lib/core/functions/sendProject.md
 
 # Function: sendProject()
 
-> **sendProject**(`path`, `key`, `value`, `hosts?`): `Promise`\<`string`[]\>
+> **sendProject**(`path`, `key`, `value`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:822](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L822)
+Defined in: [lib/core.ts:857](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L857)
 
 向本机或局域网 RPC 发送项目配置更新操作
 
@@ -4206,7 +4206,7 @@ Defined in: [lib/core.ts:822](https://github.com/maiyunnet/kebab/blob/master/lib
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sendReload.md
 ---
@@ -4219,7 +4219,7 @@ lib/core/functions/sendReload.md
 
 # Function: sendReload()
 
-> **sendReload**(`hosts?`): `Promise`\<`string`[]\>
+> **sendReload**(`hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 Defined in: [lib/core.ts:535](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L535)
 
@@ -4234,7 +4234,7 @@ Defined in: [lib/core.ts:535](https://github.com/maiyunnet/kebab/blob/master/lib
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sendRestart.md
 ---
@@ -4247,9 +4247,9 @@ lib/core/functions/sendRestart.md
 
 # Function: sendRestart()
 
-> **sendRestart**(`hosts?`): `Promise`\<`string`[]\>
+> **sendRestart**(`hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:575](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L575)
+Defined in: [lib/core.ts:583](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L583)
 
 向主进程（或局域网同代码机子）发送广播将进行 restart 操作，停止监听并启动新进程，老进程在连接全部断开后自行销毁
 主要用作不间断的代码热更新
@@ -4262,7 +4262,7 @@ Defined in: [lib/core.ts:575](https://github.com/maiyunnet/kebab/blob/master/lib
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/setCookie.md
 ---
@@ -4322,9 +4322,9 @@ lib/core/functions/setGlobal.md
 
 # Function: setGlobal()
 
-> **setGlobal**(`key`, `data`, `hosts?`): `Promise`\<`string`[]\>
+> **setGlobal**(`key`, `data`, `hosts?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:709](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L709)
+Defined in: [lib/core.ts:733](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L733)
 
 设置跨线程/指定的局域网主机的全局变量
 
@@ -4350,7 +4350,7 @@ Defined in: [lib/core.ts:709](https://github.com/maiyunnet/kebab/blob/master/lib
 
 ## Returns
 
-`Promise`\<`string`[]\>
+`Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
 lib/core/functions/sleep.md
 ---
@@ -4423,7 +4423,7 @@ lib/core/functions/updateCode.md
 
 > **updateCode**(`sourcePath`, `path`, `hosts?`, `config?`, `strict?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:762](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L762)
+Defined in: [lib/core.ts:797](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L797)
 
 上传并覆盖代码文件，config.json、kebab.json、.js.map、.ts, .gitignore 不会被覆盖和新创建
 
@@ -4476,7 +4476,7 @@ lib/core/functions/writeEventStreamHead.md
 
 > **writeEventStreamHead**(`res`): `void`
 
-Defined in: [lib/core.ts:1193](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1193)
+Defined in: [lib/core.ts:1236](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1236)
 
 ## Parameters
 
@@ -4501,7 +4501,7 @@ lib/core/functions/writeHead.md
 
 > **writeHead**(`res`, `statusCode`, `headers?`): `void`
 
-Defined in: [lib/core.ts:1182](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1182)
+Defined in: [lib/core.ts:1225](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1225)
 
 让 res 发送头部（前提是头部没有被发送才能调用本方法
 
@@ -4542,7 +4542,7 @@ lib/core/functions/write.md
 
 > **write**(`res`, `data`): `void`
 
-Defined in: [lib/core.ts:1205](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1205)
+Defined in: [lib/core.ts:1248](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1248)
 
 向 res 发送数据
 
@@ -4714,7 +4714,7 @@ lib/core/interfaces/ILogOptions.md
 
 # Interface: ILogOptions
 
-Defined in: [lib/core.ts:903](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L903)
+Defined in: [lib/core.ts:946](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L946)
 
 log 设置的选项
 
@@ -4724,7 +4724,7 @@ log 设置的选项
 
 > `optional` **cookie?**: `Record`\<`string`, `string`\>
 
-Defined in: [lib/core.ts:909](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L909)
+Defined in: [lib/core.ts:952](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L952)
 
 ***
 
@@ -4732,7 +4732,7 @@ Defined in: [lib/core.ts:909](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **get?**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/core.ts:908](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L908)
+Defined in: [lib/core.ts:951](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L951)
 
 ***
 
@@ -4740,7 +4740,7 @@ Defined in: [lib/core.ts:908](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **headers?**: `IncomingHttpHeaders`
 
-Defined in: [lib/core.ts:911](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L911)
+Defined in: [lib/core.ts:954](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L954)
 
 ***
 
@@ -4748,7 +4748,7 @@ Defined in: [lib/core.ts:911](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **hostname?**: `string`
 
-Defined in: [lib/core.ts:906](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L906)
+Defined in: [lib/core.ts:949](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L949)
 
 ***
 
@@ -4756,7 +4756,7 @@ Defined in: [lib/core.ts:906](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **path?**: `string`
 
-Defined in: [lib/core.ts:904](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L904)
+Defined in: [lib/core.ts:947](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L947)
 
 ***
 
@@ -4764,7 +4764,7 @@ Defined in: [lib/core.ts:904](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **req?**: `IncomingMessage` \| `Http2ServerRequest` \| `null`
 
-Defined in: [lib/core.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L907)
+Defined in: [lib/core.ts:950](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L950)
 
 ***
 
@@ -4772,7 +4772,7 @@ Defined in: [lib/core.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **session?**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/core.ts:910](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L910)
+Defined in: [lib/core.ts:953](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L953)
 
 ***
 
@@ -4780,7 +4780,7 @@ Defined in: [lib/core.ts:910](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **urlFull?**: `string`
 
-Defined in: [lib/core.ts:905](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L905)
+Defined in: [lib/core.ts:948](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L948)
 
 lib/core/type-aliases/TPm2Action.md
 ---
@@ -4795,7 +4795,7 @@ lib/core/type-aliases/TPm2Action.md
 
 > **TPm2Action** = `"start"` \| `"stop"` \| `"restart"`
 
-Defined in: [lib/core.ts:612](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L612)
+Defined in: [lib/core.ts:628](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L628)
 
 PM2 操作类型
 
@@ -4869,7 +4869,7 @@ lib/core/variables/global.md
 
 > `const` **global**: `Record`\<`string`, `any`\> = `{}`
 
-Defined in: [lib/core.ts:701](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L701)
+Defined in: [lib/core.ts:725](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L725)
 
 跨进程全局变量
 
@@ -13675,7 +13675,7 @@ Defined in: [lib/sql.ts:69](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **append**(`sql`): `this`
 
-Defined in: [lib/sql.ts:926](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L926)
+Defined in: [lib/sql.ts:980](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L980)
 
 在 sql 最后追加字符串
 
@@ -13695,7 +13695,7 @@ Defined in: [lib/sql.ts:926](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **by**(`c`, `d?`): `this`
 
-Defined in: [lib/sql.ts:682](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L682)
+Defined in: [lib/sql.ts:736](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L736)
 
 ORDER BY
 
@@ -13723,7 +13723,7 @@ ORDER BY
 
 > **copy**(`f?`, `opt?`): `Sql`
 
-Defined in: [lib/sql.ts:750](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L750)
+Defined in: [lib/sql.ts:804](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L804)
 
 创建一个本对象的一个新的 sql 对象拷贝
 
@@ -13751,7 +13751,7 @@ Defined in: [lib/sql.ts:750](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **crossJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:431](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L431)
+Defined in: [lib/sql.ts:485](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L485)
 
 cross join 方法
 
@@ -13791,7 +13791,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **delete**(`f`): `this`
 
-Defined in: [lib/sql.ts:319](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L319)
+Defined in: [lib/sql.ts:373](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L373)
 
 'xx'
 
@@ -13813,7 +13813,7 @@ Defined in: [lib/sql.ts:319](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **field**(`str`, `pre?`, `suf?`): `string`
 
-Defined in: [lib/sql.ts:937](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L937)
+Defined in: [lib/sql.ts:991](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L991)
 
 对字段进行包裹
 
@@ -13845,7 +13845,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅请在 field 表名时
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [lib/sql.ts:916](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L916)
+Defined in: [lib/sql.ts:970](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L970)
 
 获取带 data 的 sql 语句
 
@@ -13869,7 +13869,7 @@ Defined in: [lib/sql.ts:916](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **fullJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:420](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L420)
+Defined in: [lib/sql.ts:474](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L474)
 
 full join 方法
 
@@ -13909,7 +13909,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **getData**(): [`DbValue`](../../../index/type-aliases/DbValue.md)[]
 
-Defined in: [lib/sql.ts:900](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L900)
+Defined in: [lib/sql.ts:954](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L954)
 
 获取全部 data
 
@@ -13923,7 +13923,7 @@ Defined in: [lib/sql.ts:900](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getPre**(): `string`
 
-Defined in: [lib/sql.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L907)
+Defined in: [lib/sql.ts:961](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L961)
 
 获取定义的 pre
 
@@ -13937,7 +13937,7 @@ Defined in: [lib/sql.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getSql**(): `string`
 
-Defined in: [lib/sql.ts:884](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L884)
+Defined in: [lib/sql.ts:938](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L938)
 
 获取 sql 语句
 
@@ -13951,7 +13951,7 @@ Defined in: [lib/sql.ts:884](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **group**(`c`): `this`
 
-Defined in: [lib/sql.ts:706](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L706)
+Defined in: [lib/sql.ts:760](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L760)
 
 GROUP BY
 
@@ -13973,7 +13973,7 @@ GROUP BY
 
 > **having**(`s?`): `this`
 
-Defined in: [lib/sql.ts:438](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L438)
+Defined in: [lib/sql.ts:492](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L492)
 
 having 后置筛选器，用法类似 where
 
@@ -13993,7 +13993,7 @@ having 后置筛选器，用法类似 where
 
 > **innerJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:409](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L409)
+Defined in: [lib/sql.ts:463](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L463)
 
 inner join 方法
 
@@ -14061,7 +14061,7 @@ Defined in: [lib/sql.ts:99](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **join**(`f`, `s?`, `type?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:361](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L361)
+Defined in: [lib/sql.ts:415](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L415)
 
 join 方法
 
@@ -14107,7 +14107,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **leftJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:387](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L387)
+Defined in: [lib/sql.ts:441](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L441)
 
 left join 方法
 
@@ -14147,7 +14147,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **limit**(`a`, `b?`): `this`
 
-Defined in: [lib/sql.ts:726](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L726)
+Defined in: [lib/sql.ts:780](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L780)
 
 LIMIT（limit、offset, limit）
 
@@ -14175,7 +14175,7 @@ LIMIT（limit、offset, limit）
 
 > **lock**(): `this`
 
-Defined in: [lib/sql.ts:741](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L741)
+Defined in: [lib/sql.ts:795](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L795)
 
 追加消极锁，通常不建议使用
 
@@ -14189,7 +14189,7 @@ Defined in: [lib/sql.ts:741](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **rightJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:398](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L398)
+Defined in: [lib/sql.ts:452](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L452)
 
 right join 方法
 
@@ -14229,7 +14229,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **select**(`c`, `f`): `this`
 
-Defined in: [lib/sql.ts:210](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L210)
+Defined in: [lib/sql.ts:264](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L264)
 
 '*', 'xx'
 
@@ -14257,7 +14257,7 @@ Defined in: [lib/sql.ts:210](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **union**(`lsql`, `type?`): `this`
 
-Defined in: [lib/sql.ts:331](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L331)
+Defined in: [lib/sql.ts:385](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L385)
 
 联查另一个 sql 对象
 
@@ -14285,7 +14285,7 @@ sql 对象
 
 > **unionAll**(`lsql`): `this`
 
-Defined in: [lib/sql.ts:349](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L349)
+Defined in: [lib/sql.ts:403](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L403)
 
 所有联查另一个 sql 对象
 
@@ -14307,7 +14307,7 @@ sql 对象
 
 > **update**(`f`, `s`): `this`
 
-Defined in: [lib/sql.ts:251](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L251)
+Defined in: [lib/sql.ts:305](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L305)
 
 UPDATE SQL 方法
 
@@ -14331,6 +14331,48 @@ UPDATE SQL 方法
 
 ***
 
+### updateByValues()
+
+> **updateByValues**(`table`, `key`, `cols`, `rows`): `this`
+
+Defined in: [lib/sql.ts:214](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L214)
+
+批量 UPDATE，以子查询作为数据源，纯更新语义（不会插入新行）
+MySQL: UPDATE t INNER JOIN (SELECT col AS alias ... UNION ALL SELECT ...) AS tmp ON t.key=tmp.key SET t.c=tmp.c
+PostgreSQL: UPDATE t SET c=tmp.c FROM (VALUES ($1,...)) AS tmp(cols) WHERE t.key=tmp.key
+
+#### Parameters
+
+##### table
+
+`string`
+
+表名
+
+##### key
+
+`string`
+
+用于定位的主键/唯一键字段名
+
+##### cols
+
+`string`[]
+
+要更新的列名数组（不含 key）
+
+##### rows
+
+`any`[][]
+
+数据行数组，每行顺序为 [keyVal, col1Val, col2Val, ...]（与 [key, ...cols] 对应）
+
+#### Returns
+
+`this`
+
+***
+
 ### upsert()
 
 > **upsert**(`data`, `conflict?`): `this`
@@ -14391,7 +14433,7 @@ Defined in: [lib/sql.ts:118](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **where**(`s`): `this`
 
-Defined in: [lib/sql.ts:472](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L472)
+Defined in: [lib/sql.ts:526](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L526)
 
 筛选器
 1. 'city': 'bj', 'type': '2'
@@ -14534,7 +14576,7 @@ lib/sql/functions/aoMix.md
 
 > **aoMix**(`arr`): `Record`\<`string`, `string` \| `number` \| [`Json`](../../../index/type-aliases/Json.md)\>
 
-Defined in: [lib/sql.ts:1279](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1279)
+Defined in: [lib/sql.ts:1376](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1376)
 
 将数组兑换为组合的对象（Array/Object mix）
 
@@ -14563,7 +14605,7 @@ lib/sql/functions/column.md
 
 > **column**(`field`): `object`
 
-Defined in: [lib/sql.ts:1300](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1300)
+Defined in: [lib/sql.ts:1397](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1397)
 
 创建字段对象
 
@@ -14602,7 +14644,7 @@ lib/sql/functions/format.md
 
 > **format**(`sql`, `data`, `service?`): `string`
 
-Defined in: [lib/sql.ts:1241](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1241)
+Defined in: [lib/sql.ts:1338](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1338)
 
 返回代入后的完整 SQL 字符串，这并不安全不能直接执行，只是用来调试打印 sql 语句
 
@@ -14643,7 +14685,7 @@ lib/sql/functions/get.md
 
 > **get**(`opt`): [`Sql`](../classes/Sql.md)
 
-Defined in: [lib/sql.ts:1213](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1213)
+Defined in: [lib/sql.ts:1310](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1310)
 
 创建 sql 对象
 
@@ -14696,7 +14738,7 @@ lib/sql/functions/json.md
 
 > **json**(`obj`): `any`
 
-Defined in: [lib/sql.ts:1338](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1338)
+Defined in: [lib/sql.ts:1435](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1435)
 
 将对象转换为 JSON 字符串并避开类型检查，用于适配 PostgreSQL 的 jsonb 字段
 
@@ -14725,7 +14767,7 @@ lib/sql/functions/value.md
 
 > **value**(`val`): `object`
 
-Defined in: [lib/sql.ts:1319](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1319)
+Defined in: [lib/sql.ts:1416](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1416)
 
 创建字面量值对象，用于 where 条件中 v[0] 需要是值而非字段名的场景
 例：[value('hello'), 'IN', column('tags')]
@@ -23660,7 +23702,7 @@ Defined in: [sys/mod.ts:68](https://github.com/maiyunnet/kebab/blob/master/sys/m
 
 > `protected` **\_keyGenerator**(): `string`
 
-Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1808)
+Defined in: [sys/mod.ts:1778](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1778)
 
 当 _key 不为空时，则依据继承此方法的方法自动生成填充 key
 
@@ -23682,7 +23724,7 @@ Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(): `Promise`\<`false` \| [`Rows`](Rows.md)\<`Mod`\>\>
 
-Defined in: [sys/mod.ts:1150](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1150)
+Defined in: [sys/mod.ts:1120](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1120)
 
 ##### Returns
 
@@ -23692,7 +23734,7 @@ Defined in: [sys/mod.ts:1150](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Mod`\>\>
 
-Defined in: [sys/mod.ts:1151](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1151)
+Defined in: [sys/mod.ts:1121](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1121)
 
 ##### Parameters
 
@@ -23718,7 +23760,7 @@ Defined in: [sys/mod.ts:1151](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(): `Promise`\<`false` \| `Record`\<`string`, `any`\>[]\>
 
-Defined in: [sys/mod.ts:1329](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1329)
+Defined in: [sys/mod.ts:1299](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1299)
 
 ##### Returns
 
@@ -23728,7 +23770,7 @@ Defined in: [sys/mod.ts:1329](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Record`\<`string`, `any`\>\>\>
 
-Defined in: [sys/mod.ts:1330](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1330)
+Defined in: [sys/mod.ts:1300](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1300)
 
 ##### Parameters
 
@@ -23746,7 +23788,7 @@ Defined in: [sys/mod.ts:1330](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **append**(`sql`): `this`
 
-Defined in: [sys/mod.ts:1717](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1717)
+Defined in: [sys/mod.ts:1687](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1687)
 
 在 sql 最后追加字符串
 
@@ -23766,7 +23808,7 @@ Defined in: [sys/mod.ts:1717](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **by**(`c`, `d?`): `this`
 
-Defined in: [sys/mod.ts:1673](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1673)
+Defined in: [sys/mod.ts:1643](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1643)
 
 ORDER BY
 
@@ -23794,7 +23836,7 @@ ORDER BY
 
 > **contain**(`contain`): `this`
 
-Defined in: [sys/mod.ts:1726](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1726)
+Defined in: [sys/mod.ts:1696](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1696)
 
 设置闭包含数据
 
@@ -23822,7 +23864,7 @@ Defined in: [sys/mod.ts:1726](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **count**(): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1537](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1537)
+Defined in: [sys/mod.ts:1507](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1507)
 
 根据当前条件，筛选出当前条目该有的数据条数
 
@@ -23836,7 +23878,7 @@ Defined in: [sys/mod.ts:1537](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **countSql**(): `string`
 
-Defined in: [sys/mod.ts:1558](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1558)
+Defined in: [sys/mod.ts:1528](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1528)
 
 获取当前条件下的 count 的 SQL 语句
 
@@ -23850,7 +23892,7 @@ Defined in: [sys/mod.ts:1558](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **create**(): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:844](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L844)
+Defined in: [sys/mod.ts:814](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L814)
 
 创建数据
 
@@ -23866,7 +23908,7 @@ true-成功,false-报错,null-唯一键非 _$key 键冲突
 
 > **crossJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1633](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1633)
+Defined in: [sys/mod.ts:1603](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1603)
 
 cross join 方法
 
@@ -23914,7 +23956,7 @@ ON 信息
 
 > **explain**(`all?`): `Promise`\<`string` \| `false`\>
 
-Defined in: [sys/mod.ts:1455](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1455)
+Defined in: [sys/mod.ts:1425](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1425)
 
 ##### Parameters
 
@@ -23930,7 +23972,7 @@ Defined in: [sys/mod.ts:1455](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **explain**(`all`): `Promise`\<`false` \| `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:1456](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1456)
+Defined in: [sys/mod.ts:1426](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1426)
 
 ##### Parameters
 
@@ -23948,7 +23990,7 @@ Defined in: [sys/mod.ts:1456](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **filter**(`s`): `this`
 
-Defined in: [sys/mod.ts:1651](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1651)
+Defined in: [sys/mod.ts:1621](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1621)
 
 筛选器
 
@@ -23982,7 +24024,7 @@ Defined in: [sys/mod.ts:1651](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock`, `array`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1039](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1039)
+Defined in: [sys/mod.ts:1009](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1009)
 
 ##### Parameters
 
@@ -24002,7 +24044,7 @@ Defined in: [sys/mod.ts:1039](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock?`, `array?`): `Promise`\<`false` \| `Mod` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1043](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1043)
+Defined in: [sys/mod.ts:1013](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1013)
 
 ##### Parameters
 
@@ -24024,7 +24066,7 @@ Defined in: [sys/mod.ts:1043](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **firstArray**(`lock?`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1083](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1083)
+Defined in: [sys/mod.ts:1053](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1053)
 
 获取数据库第一个原生对象
 
@@ -24046,7 +24088,7 @@ Defined in: [sys/mod.ts:1083](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [sys/mod.ts:1753](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1753)
+Defined in: [sys/mod.ts:1723](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1723)
 
 获取带 data 的 sql 语句
 
@@ -24074,7 +24116,7 @@ sql 语句
 
 > **fullJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1621](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1621)
+Defined in: [sys/mod.ts:1591](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1591)
 
 full join 方法
 
@@ -24114,7 +24156,7 @@ ON 信息
 
 > **get**(`n`): `any`
 
-Defined in: [sys/mod.ts:836](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L836)
+Defined in: [sys/mod.ts:806](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L806)
 
 获取一个字段值
 
@@ -24136,7 +24178,7 @@ Defined in: [sys/mod.ts:836](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **getData**(): `any`[]
 
-Defined in: [sys/mod.ts:1744](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1744)
+Defined in: [sys/mod.ts:1714](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1714)
 
 获取全部 data
 
@@ -24150,7 +24192,7 @@ Defined in: [sys/mod.ts:1744](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getSql**(): `string`
 
-Defined in: [sys/mod.ts:1737](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1737)
+Defined in: [sys/mod.ts:1707](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1707)
 
 获取 sql 语句
 
@@ -24164,7 +24206,7 @@ Defined in: [sys/mod.ts:1737](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **group**(`c`): `this`
 
-Defined in: [sys/mod.ts:1682](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1682)
+Defined in: [sys/mod.ts:1652](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1652)
 
 GROUP BY
 
@@ -24186,7 +24228,7 @@ GROUP BY
 
 > **having**(`s`): `this`
 
-Defined in: [sys/mod.ts:1642](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1642)
+Defined in: [sys/mod.ts:1612](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1612)
 
 筛选器
 
@@ -24208,7 +24250,7 @@ Defined in: [sys/mod.ts:1642](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **innerJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1609](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1609)
+Defined in: [sys/mod.ts:1579](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1579)
 
 inner join 方法
 
@@ -24248,7 +24290,7 @@ ON 信息
 
 > **join**(`f`, `s?`, `type?`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1573](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1573)
+Defined in: [sys/mod.ts:1543](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1543)
 
 #### Parameters
 
@@ -24292,7 +24334,7 @@ ON 信息
 
 > **langText**(`col`, `lang`): `string`
 
-Defined in: [sys/mod.ts:1788](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1788)
+Defined in: [sys/mod.ts:1758](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1758)
 
 获取字段的可用语种文本
 
@@ -24320,7 +24362,7 @@ Defined in: [sys/mod.ts:1788](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **leftJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1585](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1585)
+Defined in: [sys/mod.ts:1555](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1555)
 
 left join 方法
 
@@ -24360,7 +24402,7 @@ ON 信息
 
 > **limit**(`a`, `b?`): `this`
 
-Defined in: [sys/mod.ts:1695](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1695)
+Defined in: [sys/mod.ts:1665](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1665)
 
 LIMIT
 
@@ -24388,7 +24430,7 @@ LIMIT
 
 > **page**(`count`, `page?`): `this`
 
-Defined in: [sys/mod.ts:1706](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1706)
+Defined in: [sys/mod.ts:1676](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1676)
 
 分页
 
@@ -24416,7 +24458,7 @@ Defined in: [sys/mod.ts:1706](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **refresh**(`lock?`): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:964](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L964)
+Defined in: [sys/mod.ts:934](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L934)
 
 刷新当前模型获取最新数据
 
@@ -24438,7 +24480,7 @@ Defined in: [sys/mod.ts:964](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **remove**(): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:1021](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1021)
+Defined in: [sys/mod.ts:991](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L991)
 
 移除本条目
 
@@ -24452,7 +24494,7 @@ Defined in: [sys/mod.ts:1021](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **rightJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1597](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1597)
+Defined in: [sys/mod.ts:1567](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1567)
 
 right join 方法
 
@@ -24492,7 +24534,7 @@ ON 信息
 
 > **save**(`where?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:992](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L992)
+Defined in: [sys/mod.ts:962](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L962)
 
 更新 set 的数据到数据库，有未保存数据时才保存
 
@@ -24526,7 +24568,7 @@ Defined in: [sys/mod.ts:992](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **set**\<`T`, `TK`\>(`n`): `void`
 
-Defined in: [sys/mod.ts:797](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L797)
+Defined in: [sys/mod.ts:767](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L767)
 
 ##### Type Parameters
 
@@ -24552,7 +24594,7 @@ Defined in: [sys/mod.ts:797](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **set**\<`T`, `TK`\>(`n`, `v`): `void`
 
-Defined in: [sys/mod.ts:798](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L798)
+Defined in: [sys/mod.ts:768](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L768)
 
 ##### Type Parameters
 
@@ -24584,7 +24626,7 @@ Defined in: [sys/mod.ts:798](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **toArray**\<`TC`\>(): [`TOnlyProperties`](../type-aliases/TOnlyProperties.md)\<`InstanceType`\<`TC`\>\> & `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:1760](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1760)
+Defined in: [sys/mod.ts:1730](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1730)
 
 获取值对象，获取的是新创建的数组
 
@@ -24604,7 +24646,7 @@ Defined in: [sys/mod.ts:1760](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **total**(`f?`): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1513](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1513)
+Defined in: [sys/mod.ts:1483](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1483)
 
 获取总条数，自动抛弃 LIMIT，仅用于获取数据的情况（select）
 
@@ -24624,7 +24666,7 @@ Defined in: [sys/mod.ts:1513](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **union**(`f`, `type?`): `this`
 
-Defined in: [sys/mod.ts:1094](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1094)
+Defined in: [sys/mod.ts:1064](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1064)
 
 联合查询表数据
 
@@ -24652,7 +24694,7 @@ Defined in: [sys/mod.ts:1094](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unionAll**(`f`): `this`
 
-Defined in: [sys/mod.ts:1124](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1124)
+Defined in: [sys/mod.ts:1094](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1094)
 
 所有联合查询表数据
 
@@ -24674,7 +24716,7 @@ Defined in: [sys/mod.ts:1124](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unsaved**(): `boolean`
 
-Defined in: [sys/mod.ts:1779](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1779)
+Defined in: [sys/mod.ts:1749](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1749)
 
 当前是否设置了未保存 --=
 
@@ -24688,7 +24730,7 @@ Defined in: [sys/mod.ts:1779](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **updates**(): `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:1768](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1768)
+Defined in: [sys/mod.ts:1738](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1738)
 
 获取当前设置要提交的数据
 
@@ -24702,7 +24744,7 @@ Defined in: [sys/mod.ts:1768](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **upsert**(`conflict`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:934](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L934)
+Defined in: [sys/mod.ts:904](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L904)
 
 插入数据，如果存在则更新（UPSERT）
 
@@ -24724,7 +24766,7 @@ Defined in: [sys/mod.ts:934](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **where**(`s`): `this`
 
-Defined in: [sys/mod.ts:1662](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1662)
+Defined in: [sys/mod.ts:1632](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1632)
 
 是 filter 的别名
 
@@ -24778,7 +24820,7 @@ Defined in: [sys/mod.ts:175](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **find**\<`T`\>(`db`, `val`, `opt?`): `Promise`\<`false` \| `T` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:620](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L620)
+Defined in: [sys/mod.ts:590](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L590)
 
 根据主键（或 key 字段）获取对象
 
@@ -24838,7 +24880,7 @@ Defined in: [sys/mod.ts:620](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **getCreate**\<`T`\>(`db`, `opt?`): `T`
 
-Defined in: [sys/mod.ts:602](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L602)
+Defined in: [sys/mod.ts:572](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L572)
 
 获取创建对象，通常用于新建数据库条目
 
@@ -25026,7 +25068,7 @@ Defined in: [sys/mod.ts:193](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **one**(`db`, `s`, `opt`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:647](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L647)
+Defined in: [sys/mod.ts:617](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L617)
 
 ##### Parameters
 
@@ -25076,7 +25118,7 @@ Defined in: [sys/mod.ts:647](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **one**\<`T`\>(`db`, `s`, `opt?`): `Promise`\<`false` \| `T` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:660](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L660)
+Defined in: [sys/mod.ts:630](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L630)
 
 ##### Type Parameters
 
@@ -25134,7 +25176,7 @@ Defined in: [sys/mod.ts:660](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **oneArray**(`db`, `s`, `opt?`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:737](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L737)
+Defined in: [sys/mod.ts:707](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L707)
 
 通过 where 条件筛选单条数据返回原生对象
 
@@ -25186,7 +25228,7 @@ Defined in: [sys/mod.ts:737](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **primarys**(`db`, `where?`, `opt?`): `Promise`\<`false` \| `any`[]\>
 
-Defined in: [sys/mod.ts:758](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L758)
+Defined in: [sys/mod.ts:728](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L728)
 
 根据 where 条件获取主键值列表
 
@@ -25334,7 +25376,7 @@ Defined in: [sys/mod.ts:334](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **select**\<`T`\>(`db`, `c`, `opt?`): `T` & `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:543](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L543)
+Defined in: [sys/mod.ts:513](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L513)
 
 select 自定字段
 
@@ -25400,7 +25442,7 @@ select 自定字段
 
 > `static` **toArrayByRecord**\<`T`\>(`obj`): `Record`\<`string`, `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:785](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L785)
+Defined in: [sys/mod.ts:755](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L755)
 
 将 key val 组成的数据列表转换为原生对象模式，获取的是新创建的数组
 
@@ -25544,7 +25586,7 @@ Defined in: [sys/mod.ts:413](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **updateList**(`db`, `data`, `key`, `opt?`): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:447](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L447)
+Defined in: [sys/mod.ts:449](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L449)
 
 批量更新数据
 
@@ -25560,13 +25602,15 @@ Defined in: [sys/mod.ts:447](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 `Record`\<`string`, `any`\>[]
 
-数据列表
+数据列表，每个元素必须包含 key 字段，其余字段为要更新的列；
+            支持稀疏数据（不同元素可以拥有不同的列集合），内部会自动按列集合分组批量执行
 
 ##### key
 
 `string`
 
-用于定位的主键或唯一键字段名
+用于定位记录的字段名（主键或唯一键），该字段仅用于 WHERE 条件匹配，不会被更新；
+           data 中每个元素都必须包含此字段，否则该元素会被跳过
 
 ##### opt?
 
@@ -25626,7 +25670,7 @@ Defined in: [sys/mod.ts:184](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **where**\<`T`\>(`db`, `s?`, `opt?`): `T` & `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:573](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L573)
+Defined in: [sys/mod.ts:543](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L543)
 
 通过 where 条件获取模型
 
@@ -25891,7 +25935,7 @@ sys/mod/interfaces/IModUnionItem.md
 
 # Interface: IModUnionItem
 
-Defined in: [sys/mod.ts:1822](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1822)
+Defined in: [sys/mod.ts:1792](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1792)
 
 ## Properties
 
@@ -25899,7 +25943,7 @@ Defined in: [sys/mod.ts:1822](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **field**: `string`
 
-Defined in: [sys/mod.ts:1823](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1823)
+Defined in: [sys/mod.ts:1793](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1793)
 
 ***
 
@@ -25907,7 +25951,7 @@ Defined in: [sys/mod.ts:1823](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `optional` **where?**: `any`
 
-Defined in: [sys/mod.ts:1824](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1824)
+Defined in: [sys/mod.ts:1794](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1794)
 
 sys/mod/interfaces/IRows.md
 ---
@@ -25920,7 +25964,7 @@ sys/mod/interfaces/IRows.md
 
 # Interface: IRows\<T\>
 
-Defined in: [sys/mod.ts:1816](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1816)
+Defined in: [sys/mod.ts:1786](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1786)
 
 ## Extends
 
@@ -25938,7 +25982,7 @@ Defined in: [sys/mod.ts:1816](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `readonly` **length**: `number`
 
-Defined in: [sys/mod.ts:1817](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1817)
+Defined in: [sys/mod.ts:1787](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1787)
 
 ## Methods
 
@@ -25946,7 +25990,7 @@ Defined in: [sys/mod.ts:1817](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **item**(`index`): `T`
 
-Defined in: [sys/mod.ts:1818](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1818)
+Defined in: [sys/mod.ts:1788](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1788)
 
 #### Parameters
 
@@ -25964,7 +26008,7 @@ Defined in: [sys/mod.ts:1818](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **toArray**(): `Record`\<`string`, `any`\>[]
 
-Defined in: [sys/mod.ts:1819](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1819)
+Defined in: [sys/mod.ts:1789](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1789)
 
 #### Returns