@maiyunnet/kebab 9.4.0 → 9.5.0

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.4.0"` = `'9.4.0'`
+> `const` **VER**: `"9.5.0"` = `'9.5.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -3460,7 +3460,7 @@ lib/core/functions/getLog.md
 
 # Function: getLog()
 
-> **getLog**(`opt`): `Promise`\<`false` \| `string`[][] \| `null`\>
+> **getLog**(`opt`): `Promise`\<`false` \| `any`[] \| `string`[][] \| `null`\>
 
 Defined in: [lib/core.ts:1031](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1031)
 
@@ -3522,7 +3522,7 @@ Defined in: [lib/core.ts:1031](https://github.com/maiyunnet/kebab/blob/master/li
 
 ## Returns
 
-`Promise`\<`false` \| `string`[][] \| `null`\>
+`Promise`\<`false` \| `any`[] \| `string`[][] \| `null`\>
 
 lib/core/functions/ip.md
 ---
@@ -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:1776](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1776)
 
 当 _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:1118](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1118)
 
 ##### 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:1119](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1119)
 
 ##### 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:1297](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1297)
 
 ##### 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:1298](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1298)
 
 ##### 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:1685](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1685)
 
 在 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:1641](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1641)
 
 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:1694](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1694)
 
 设置闭包含数据
 
@@ -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:1505](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1505)
 
 根据当前条件，筛选出当前条目该有的数据条数
 
@@ -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:1526](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1526)
 
 获取当前条件下的 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:812](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L812)
 
 创建数据
 
@@ -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:1601](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1601)
 
 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:1423](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1423)
 
 ##### 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:1424](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1424)
 
 ##### 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:1619](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1619)
 
 筛选器
 
@@ -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:1007](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1007)
 
 ##### 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:1011](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1011)
 
 ##### 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:1051](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1051)
 
 获取数据库第一个原生对象
 
@@ -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:1721](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1721)
 
 获取带 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:1589](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1589)
 
 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:804](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L804)
 
 获取一个字段值
 
@@ -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:1712](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1712)
 
 获取全部 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:1705](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1705)
 
 获取 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:1650](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1650)
 
 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:1610](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1610)
 
 筛选器
 
@@ -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:1577](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1577)
 
 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:1541](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1541)
 
 #### 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:1756](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1756)
 
 获取字段的可用语种文本
 
@@ -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:1553](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1553)
 
 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:1663](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1663)
 
 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:1674](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1674)
 
 分页
 
@@ -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:932](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L932)
 
 刷新当前模型获取最新数据
 
@@ -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:989](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L989)
 
 移除本条目
 
@@ -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:1565](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1565)
 
 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:960](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L960)
 
 更新 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:765](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L765)
 
 ##### 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:766](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L766)
 
 ##### 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:1728](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1728)
 
 获取值对象，获取的是新创建的数组
 
@@ -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:1481](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1481)
 
 获取总条数，自动抛弃 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:1062](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1062)
 
 联合查询表数据
 
@@ -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:1092](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1092)
 
 所有联合查询表数据
 
@@ -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:1747](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1747)
 
 当前是否设置了未保存 --=
 
@@ -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:1736](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1736)
 
 获取当前设置要提交的数据
 
@@ -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:902](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L902)
 
 插入数据，如果存在则更新（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:1630](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1630)
 
 是 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:588](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L588)
 
 根据主键（或 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:570](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L570)
 
 获取创建对象，通常用于新建数据库条目
 
@@ -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:615](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L615)
 
 ##### 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:628](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L628)
 
 ##### 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:705](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L705)
 
 通过 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:726](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L726)
 
 根据 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:511](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L511)
 
 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:753](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L753)
 
 将 key val 组成的数据列表转换为原生对象模式，获取的是新创建的数组
 
@@ -25626,7 +25668,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:541](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L541)
 
 通过 where 条件获取模型
 
@@ -25891,7 +25933,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:1790](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1790)
 
 ## Properties
 
@@ -25899,7 +25941,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:1791](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1791)
 
 ***
 
@@ -25907,7 +25949,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:1792](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1792)
 
 sys/mod/interfaces/IRows.md
 ---
@@ -25920,7 +25962,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:1784](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1784)
 
 ## Extends
 
@@ -25938,7 +25980,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:1785](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1785)
 
 ## Methods
 
@@ -25946,7 +25988,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:1786](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1786)
 
 #### Parameters
 
@@ -25964,7 +26006,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:1787](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1787)
 
 #### Returns
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.4.0";
+export declare const VER = "9.5.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.4.0';
+export const VER = '9.5.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/core.d.ts

@@ -268,7 +268,7 @@ export declare function getLog(opt: {
     'limit'?: number;
     /** --- 获取局域网服务器的日志，为空代表获取本机的 --- */
     'host'?: string;
-}): Promise<string[][] | null | false>;
+}): Promise<string[][] | kebab.Json[] | null | false>;
 /**
  * --- 获取目录内文件/文件夹列表 ---
  * @param opt 参数

package/lib/sql.d.ts

@@ -69,6 +69,16 @@ export declare class Sql {
      * @param conflict 冲突字段，PostgreSQL 用于指定 ON CONFLICT 字段；MySQL 时忽略，因为会对所有唯一键冲突执行更新
      */
     upsert(data: kebab.Json, conflict?: string | string[]): this;
+    /**
+     * --- 批量 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 ---
+     * @param table 表名
+     * @param key 用于定位的主键/唯一键字段名
+     * @param cols 要更新的列名数组（不含 key）
+     * @param rows 数据行数组，每行顺序为 [keyVal, col1Val, col2Val, ...]（与 [key, ...cols] 对应）
+     */
+    updateByValues(table: string, key: string, cols: string[], rows: any[][]): this;
     /**
      * --- '*', 'xx' ---
      * @param c 字段字符串或字段数组
@@ -237,6 +247,11 @@ export declare class Sql {
     private _isValue;
     /** --- 获取占位符 --- */
     private _placeholder;
+    /**
+     * --- 返回 PostgreSQL VALUES 第一行的显式类型转换后缀，用于帮助 PostgreSQL 推断 VALUES 派生表列类型 ---
+     * @param v 要处理的值
+     */
+    private _pgCastSuffix;
     /**
      * --- 处理单个值,检测数据类型并返回 SQL 和 data ---
      * @param v 要处理的值

package/lib/sql.js

@@ -166,6 +166,59 @@ export class Sql {
         }
         return this;
     }
+    /**
+     * --- 批量 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 ---
+     * @param table 表名
+     * @param key 用于定位的主键/唯一键字段名
+     * @param cols 要更新的列名数组（不含 key）
+     * @param rows 数据行数组，每行顺序为 [keyVal, col1Val, col2Val, ...]（与 [key, ...cols] 对应）
+     */
+    updateByValues(table, key, cols, rows) {
+        this._data = [];
+        this._placeholderCounter = 1;
+        const allCols = [key, ...cols];
+        const quotedTable = this.field(table, this._pre);
+        const quotedKey = this.field(key);
+        if (this._service === ESERVICE.MYSQL) {
+            // --- MySQL 8.0.19+ VALUES ROW() 派生表语法 ---
+            const valueParts = [];
+            for (const row of rows) {
+                const parts = row.map(v => {
+                    const result = this._processValue(v);
+                    if (result.data.length > 0) {
+                        this._data.push(...result.data);
+                    }
+                    return result.sql;
+                });
+                valueParts.push(`ROW(${parts.join(', ')})`);
+            }
+            const tmpCols = allCols.map(c => this.field(c)).join(', ');
+            const setClauses = cols.map(c => `t.${this.field(c)} = tmp.${this.field(c)}`).join(', ');
+            this._sql = [`UPDATE ${quotedTable} t INNER JOIN (VALUES ${valueParts.join(', ')}) AS tmp(${tmpCols}) ON t.${quotedKey} = tmp.${quotedKey} SET ${setClauses}`];
+        }
+        else {
+            // --- PostgreSQL 使用 UPDATE FROM (VALUES ...) ---
+            const valueParts = [];
+            for (let ri = 0; ri < rows.length; ri++) {
+                const row = rows[ri];
+                const parts = row.map(v => {
+                    const result = this._processValue(v);
+                    if (result.data.length > 0) {
+                        this._data.push(...result.data);
+                    }
+                    // --- 第一行加显式类型转换，帮助 PostgreSQL 推断 VALUES 派生表的列类型 ---
+                    return ri === 0 ? result.sql + this._pgCastSuffix(v) : result.sql;
+                });
+                valueParts.push(`(${parts.join(', ')})`);
+            }
+            const tmpCols = allCols.map(c => this.field(c)).join(', ');
+            const setClauses = cols.map(c => `${this.field(c)} = tmp.${this.field(c)}`).join(', ');
+            this._sql = [`UPDATE ${quotedTable} t SET ${setClauses} FROM (VALUES ${valueParts.join(', ')}) AS tmp(${tmpCols}) WHERE t.${quotedKey} = tmp.${quotedKey}`];
+        }
+        return this;
+    }
     /**
      * --- '*', 'xx' ---
      * @param c 字段字符串或字段数组
@@ -984,6 +1037,48 @@ export class Sql {
     _placeholder() {
         return this._service === ESERVICE.MYSQL ? '?' : `$${this._placeholderCounter++}`;
     }
+    /**
+     * --- 返回 PostgreSQL VALUES 第一行的显式类型转换后缀，用于帮助 PostgreSQL 推断 VALUES 派生表列类型 ---
+     * @param v 要处理的值
+     */
+    _pgCastSuffix(v) {
+        if (v === null || v === undefined) {
+            return '';
+        }
+        if (typeof v === 'number') {
+            return Number.isInteger(v) ? '::bigint' : '::float8';
+        }
+        if (typeof v === 'boolean') {
+            return '::boolean';
+        }
+        if (v instanceof Buffer) {
+            return '::bytea';
+        }
+        if (Array.isArray(v)) {
+            // --- 函数式语法 ['FUNC(?)', [...]]，不加转换 ---
+            if (typeof v[0] === 'string' && v[0].includes('(')) {
+                return '';
+            }
+            // --- POLYGON ---
+            if (v[0]?.y !== undefined) {
+                return '::polygon';
+            }
+            // --- JSON 数组或 PG 原生数组（text[]、int[] 等），
+            //     不加转换，由 pg 驱动与目标列类型决定 ---
+            return '';
+        }
+        if (typeof v === 'object') {
+            // --- POINT ---
+            if (v.y !== undefined) {
+                return '::point';
+            }
+            // --- JSON 对象（用户应通过 sql.json() 包裹为字符串后传入），不加转换 ---
+            return '';
+        }
+        // --- string：保持 unknown 类型，兼容 text/varchar/jsonb 等目标列类型；
+        //     使用 sql.json() 包裹的 jsonb 数据经此路径，unknown 可隐式 cast 到 jsonb ---
+        return '';
+    }
     /**
      * --- 处理单个值,检测数据类型并返回 SQL 和 data ---
      * @param v 要处理的值

package/lib/undici/response.d.ts

@@ -31,7 +31,7 @@ export declare class Response {
     /**
      * --- 获取响应读取流对象 ---
      */
-    getStream(): zlib.BrotliDecompress | zlib.Gunzip | zlib.Inflate | (import("undici/types/readable").default & undici.Dispatcher.BodyMixin) | null;
+    getStream(): (import("undici/types/readable").default & undici.Dispatcher.BodyMixin) | zlib.Gunzip | zlib.Inflate | zlib.BrotliDecompress | null;
     /**
      * --- 获取原生响应读取流对象 ---
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.4.0",
+  "version": "9.5.0",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/master.js

@@ -523,9 +523,15 @@ function createRpcListener() {
                     let limit = msg.limit ?? 100;
                     /** --- 剩余 offset --- */
                     let offset = msg.offset ?? 0;
+                    /**
+                     * --- csv 格式：string[][] 每行是字段数组，顺序与表头一致 ---
+                     * --- [['H:i:s', unix, url, cookie, session, userAgent, realIp, cfIp, xIp, osMem, procMem, message], ...] ---
+                     * --- jsonl 格式：object[] 每行是解析后的 JSON 对象 ---
+                     * --- [{ time, unix, url, cookie, session, userAgent, realIp, cfIp, xIp, osMem, procMem, message }, ...] ---
+                     */
                     const rtn = await new Promise(resolve => {
                         const list = [];
-                        /** --- 当前行号 --- */
+                        /** --- 当前行号（jsonl 无表头，csv 有表头，两者处理逻辑不同）--- */
                         let line = 0;
                         /** --- 当前行数据 --- */
                         let packet = '';
@@ -552,34 +558,44 @@ function createRpcListener() {
                                 buf = buf.slice(index + 1);
                                 ++line;
                                 // --- 先执行下本次完成的 ---
-                                if (line > 1) {
+                                // --- csv：line > 1 跳过表头行；jsonl：无表头，line >= 1 即可处理 ---
+                                if (format === 'jsonl' ? line >= 1 : line > 1) {
                                     if (offset === 0) {
                                         if (!msg.search || packet.includes(msg.search)) {
-                                            const result = [];
-                                            let currentField = '';
-                                            let inQuotes = false;
-                                            for (let i = 0; i < packet.length; ++i) {
-                                                const char = packet[i];
-                                                if (char === '"') {
-                                                    if (inQuotes && packet[i + 1] === '"') {
-                                                        currentField += '"';
-                                                        ++i;
+                                            if (format === 'jsonl') {
+                                                const obj = lText.parseJson(packet);
+                                                if (obj) {
+                                                    list.push(obj);
+                                                    --limit;
+                                                }
+                                            }
+                                            else {
+                                                const result = [];
+                                                let currentField = '';
+                                                let inQuotes = false;
+                                                for (let i = 0; i < packet.length; ++i) {
+                                                    const char = packet[i];
+                                                    if (char === '"') {
+                                                        if (inQuotes && packet[i + 1] === '"') {
+                                                            currentField += '"';
+                                                            ++i;
+                                                        }
+                                                        else {
+                                                            inQuotes = !inQuotes;
+                                                        }
+                                                    }
+                                                    else if (char === ',' && !inQuotes) {
+                                                        result.push(currentField);
+                                                        currentField = '';
                                                     }
                                                     else {
-                                                        inQuotes = !inQuotes;
+                                                        currentField += char;
                                                     }
                                                 }
-                                                else if (char === ',' && !inQuotes) {
-                                                    result.push(currentField);
-                                                    currentField = '';
-                                                }
-                                                else {
-                                                    currentField += char;
-                                                }
+                                                result.push(currentField);
+                                                list.push(result);
+                                                --limit;
                                             }
-                                            result.push(currentField);
-                                            list.push(result);
-                                            --limit;
                                         }
                                     }
                                     else {

package/sys/mod.js

@@ -313,66 +313,43 @@ export default class Mod {
         if (!data.length) {
             return true;
         }
-        // --- 获取所有涉及的字段（除了 key） ---
-        const columns = new Set();
+        // --- 按列集合分组（处理稀疏数据，保证每组内所有行的列完全一致）---
+        const groups = new Map();
         for (const item of data) {
-            for (const k in item) {
-                if (k !== key) {
-                    columns.add(k);
-                }
+            const itemCols = Object.keys(item).filter(k => k !== key).sort();
+            if (itemCols.length === 0) {
+                continue;
+            }
+            const groupKey = itemCols.join('\0');
+            if (!groups.has(groupKey)) {
+                groups.set(groupKey, []);
             }
+            groups.get(groupKey).push(item);
         }
-        if (columns.size === 0) {
+        if (groups.size === 0) {
             return true;
         }
-        const cols = Array.from(columns);
-        // --- 计算分批大小 ---
-        // --- 每个字段需要 2 个占位符 (WHEN ? THEN ?)，加上 WHERE IN (?) 的 1 个 ---
-        // --- Total params per row = cols.length * 2 + 1 ---
-        const paramCountPerRow = cols.length * 2 + 1;
-        const batchSize = Math.floor(60000 / paramCountPerRow);
-        const batches = [];
-        for (let i = 0; i < data.length; i += batchSize) {
-            batches.push(data.slice(i, i + batchSize));
-        }
-        for (const batch of batches) {
-            const sq = lSql.get({
-                'service': db.getService() ?? lDb.ESERVICE.PGSQL,
-                'ctr': opt.ctr,
-                'pre': opt.pre ?? this._$pre,
-            });
-            const updates = {};
-            const keys = [];
-            for (const col of cols) {
-                let caseSql = `(CASE ${sq.field(key)}`;
-                const params = [];
-                let hasUpdate = false;
-                for (const item of batch) {
-                    if (item[col] !== undefined) {
-                        caseSql += ` WHEN ? THEN ?`;
-                        params.push(item[key], item[col]);
-                        hasUpdate = true;
-                    }
-                }
-                if (hasUpdate) {
-                    caseSql += ` ELSE ${sq.field(col)} END)`;
-                    updates[col] = [caseSql, params];
+        const tableName = this._$table + (opt.index ? ('_' + opt.index) : '');
+        for (const [, groupItems] of groups) {
+            const cols = Object.keys(groupItems[0]).filter(k => k !== key).sort();
+            const allCols = [key, ...cols];
+            // --- 每行占位符数量 = key + 所有列，分批避免超出数据库参数上限 ---
+            const batchSize = Math.floor(60000 / allCols.length);
+            for (let i = 0; i < groupItems.length; i += batchSize) {
+                const batch = groupItems.slice(i, i + batchSize);
+                const sq = lSql.get({
+                    'service': db.getService() ?? lDb.ESERVICE.PGSQL,
+                    'ctr': opt.ctr,
+                    'pre': opt.pre ?? this._$pre,
+                });
+                const rows = batch.map(item => allCols.map(c => item[c] ?? null));
+                sq.updateByValues(tableName, key, cols, rows);
+                const r = await db.execute(sq.getSql(), sq.getData());
+                if (r.packet === null) {
+                    lCore.log(opt.ctr ?? {}, '[MOD][updateList] ' + (lText.stringifyJson(r.error?.message ?? '').slice(1, -1) + ' - ' + sq.format()).replaceAll('"', '""'), '-error');
+                    return false;
                 }
             }
-            // --- 收集 keys ---
-            for (const item of batch) {
-                keys.push(item[key]);
-            }
-            if (Object.keys(updates).length === 0) {
-                continue;
-            }
-            sq.update(this._$table + (opt.index ? ('_' + opt.index) : ''), updates)
-                .where({ [key]: keys });
-            const r = await db.execute(sq.getSql(), sq.getData());
-            if (r.packet === null) {
-                lCore.log(opt.ctr ?? {}, '[MOD][updateList] ' + (lText.stringifyJson(r.error?.message ?? '').slice(1, -1) + ' - ' + sq.format()).replaceAll('"', '""'), '-error');
-                return false;
-            }
         }
         return true;
     }

package/www/example/ctr/test.js

@@ -1395,11 +1395,21 @@ for (let i = 0; i < 30000; ++i) {
         const echo = [];
         echo.push('<table style="width: 100%;">');
         if (list) {
-            echo.push('<tr><th>TIME</th><th>UNIX</th><th>URL</th><th>COOKIE</th><th>SESSION</th><th>USER_AGENT</th><th>REALIP</th><th>CLIENTIP</th><th>OS</th><th>PROCESS</th><th>MESSAGE</th></tr>');
+            echo.push('<tr><th>TIME</th><th>UNIX</th><th>URL</th><th>COOKIE</th><th>SESSION</th><th>USER_AGENT</th><th>REALIP</th><th>CFIP</th><th>XIP</th><th>OS</th><th>PROCESS</th><th>MESSAGE</th></tr>');
             for (const row of list) {
                 echo.push('<tr>');
-                for (const item of row) {
-                    echo.push('<td>' + lText.htmlescape(item) + '</td>');
+                if (Array.isArray(row)) {
+                    // --- csv 格式：string[] ---
+                    for (const item of row) {
+                        echo.push('<td>' + lText.htmlescape(item) + '</td>');
+                    }
+                }
+                else {
+                    // --- jsonl 格式：object ---
+                    const r = row;
+                    for (const val of [r.time, r.unix, r.url, r.cookie, r.session, r.userAgent, r.realIp, r.cfIp, r.xIp, r.osMem, r.procMem, r.message]) {
+                        echo.push('<td>' + lText.htmlescape(typeof val === 'string' ? val : lText.stringifyJson(val) ?? '') + '</td>');
+                    }
                 }
                 echo.push('</tr>');
             }