@maiyunnet/kebab 9.0.0 → 9.0.2

package/doc/kebab-rag.md

@@ -1355,7 +1355,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.0.0"` = `'9.0.0'`
+> `const` **VER**: `"9.0.2"` = `'9.0.2'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -1402,7 +1402,7 @@ lib/ai/classes/Ai.md
 
 # Class: Ai
 
-Defined in: [lib/ai.ts:58](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L58)
+Defined in: [lib/ai.ts:60](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L60)
 
 ## Constructors
 
@@ -1410,7 +1410,7 @@ Defined in: [lib/ai.ts:58](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **new Ai**(`ctrEtc`, `opt`): `Ai`
 
-Defined in: [lib/ai.ts:71](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L71)
+Defined in: [lib/ai.ts:73](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L73)
 
 #### Parameters
 
@@ -1432,7 +1432,7 @@ Defined in: [lib/ai.ts:71](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `readonly` **link**: `OpenAI`
 
-Defined in: [lib/ai.ts:61](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L61)
+Defined in: [lib/ai.ts:63](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L63)
 
 openai 原生对象
 
@@ -1444,7 +1444,7 @@ openai 原生对象
 
 > **get** **service**(): [`ESERVICE`](../enumerations/ESERVICE.md)
 
-Defined in: [lib/ai.ts:143](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L143)
+Defined in: [lib/ai.ts:149](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L149)
 
 获取当前服务商
 
@@ -1462,7 +1462,7 @@ Defined in: [lib/ai.ts:143](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`ChatCompletion`\>\>
 
-Defined in: [lib/ai.ts:148](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L148)
+Defined in: [lib/ai.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L154)
 
 创建非流式对话
 
@@ -1480,7 +1480,7 @@ Defined in: [lib/ai.ts:148](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`Stream`\<`ChatCompletionChunk`\>\>\>
 
-Defined in: [lib/ai.ts:152](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L152)
+Defined in: [lib/ai.ts:158](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L158)
 
 创建流式对话
 
@@ -1500,7 +1500,7 @@ Defined in: [lib/ai.ts:152](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **embedding**(`body`): `Promise`\<`false` \| `APIPromise`\<`CreateEmbeddingResponse`\>\>
 
-Defined in: [lib/ai.ts:175](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L175)
+Defined in: [lib/ai.ts:181](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L181)
 
 创建向量
 
@@ -1520,7 +1520,7 @@ Defined in: [lib/ai.ts:175](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **image**(`opt`): `Promise`\<`false` \| \{ `list`: `object`[]; `request`: `string`; `seed`: `number`; \}\>
 
-Defined in: [lib/ai.ts:191](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L191)
+Defined in: [lib/ai.ts:197](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L197)
 
 生成图像，不支持 GEMINI、GROK 服务商
 
@@ -1538,7 +1538,7 @@ Defined in: [lib/ai.ts:191](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 `string`[]
 
-参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、VOLCN、VOLAS 服务商
+参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、ALINE、VOLCN、VOLAS 服务商
 
 ###### model
 
@@ -1582,7 +1582,7 @@ Defined in: [lib/ai.ts:191](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **poll**(`opt`): `Promise`\<`false` \| \{ `add?`: `number`; `end?`: `number`; `error?`: `string`; `start?`: `number`; `status`: `"FAILED"` \| `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; `url?`: `string`; \}\>
 
-Defined in: [lib/ai.ts:539](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L539)
+Defined in: [lib/ai.ts:546](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L546)
 
 轮询任务
 
@@ -1608,9 +1608,9 @@ Defined in: [lib/ai.ts:539](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **video**(`opt`): `Promise`\<`false` \| \{ `request`: `string`; `seed`: `number`; `status`: `"FAILED"` \| `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; \}\>
 
-Defined in: [lib/ai.ts:371](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L371)
+Defined in: [lib/ai.ts:378](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L378)
 
-异步生成视频，仅支持 ALICN、ALIAS
+异步生成视频，仅支持 ALICN、ALIAS、ALINE
 
 #### Parameters
 
@@ -1711,7 +1711,7 @@ Defined in: [lib/ai.ts:19](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 Defined in: [lib/ai.ts:23](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L23)
 
-阿里国际区
+阿里新加坡
 
 ***
 
@@ -1725,21 +1725,31 @@ Defined in: [lib/ai.ts:21](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 ***
 
-### AZURE
+### ALINE
 
-> **AZURE**: `2`
+> **ALINE**: `2`
 
 Defined in: [lib/ai.ts:25](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L25)
 
+阿里美国
+
+***
+
+### AZURE
+
+> **AZURE**: `3`
+
+Defined in: [lib/ai.ts:27](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L27)
+
 微软 Azure
 
 ***
 
 ### AZURE2
 
-> **AZURE2**: `3`
+> **AZURE2**: `4`
 
-Defined in: [lib/ai.ts:27](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L27)
+Defined in: [lib/ai.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L29)
 
 微软 Azure 2
 
@@ -1747,9 +1757,9 @@ Defined in: [lib/ai.ts:27](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 ### AZURE3
 
-> **AZURE3**: `4`
+> **AZURE3**: `5`
 
-Defined in: [lib/ai.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L29)
+Defined in: [lib/ai.ts:31](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L31)
 
 微软 Azure 3
 
@@ -1757,9 +1767,9 @@ Defined in: [lib/ai.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 ### GEMINI
 
-> **GEMINI**: `5`
+> **GEMINI**: `6`
 
-Defined in: [lib/ai.ts:31](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L31)
+Defined in: [lib/ai.ts:33](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L33)
 
 Gemini
 
@@ -1767,9 +1777,9 @@ Gemini
 
 ### GROK
 
-> **GROK**: `6`
+> **GROK**: `7`
 
-Defined in: [lib/ai.ts:33](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L33)
+Defined in: [lib/ai.ts:35](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L35)
 
 Grok
 
@@ -1777,9 +1787,9 @@ Grok
 
 ### VOLAS
 
-> **VOLAS**: `8`
+> **VOLAS**: `9`
 
-Defined in: [lib/ai.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L37)
+Defined in: [lib/ai.ts:39](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L39)
 
 火山引擎国际区
 
@@ -1787,9 +1797,9 @@ Defined in: [lib/ai.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 ### VOLCN
 
-> **VOLCN**: `7`
+> **VOLCN**: `8`
 
-Defined in: [lib/ai.ts:35](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L35)
+Defined in: [lib/ai.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L37)
 
 火山引擎中国大陆区
 
@@ -1806,7 +1816,7 @@ lib/ai/functions/get.md
 
 > **get**(`ctrEtc`, `opt`): [`Ai`](../classes/Ai.md)
 
-Defined in: [lib/ai.ts:594](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L594)
+Defined in: [lib/ai.ts:601](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L601)
 
 创建一个 AI 对象
 
@@ -1864,7 +1874,7 @@ lib/ai/interfaces/IOptions.md
 
 # Interface: IOptions
 
-Defined in: [lib/ai.ts:41](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L41)
+Defined in: [lib/ai.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L43)
 
 选项
 
@@ -1874,7 +1884,7 @@ Defined in: [lib/ai.ts:41](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **endpoint?**: `string`
 
-Defined in: [lib/ai.ts:45](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L45)
+Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L47)
 
 接入点
 
@@ -1884,7 +1894,7 @@ Defined in: [lib/ai.ts:45](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **fetch?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L49)
+Defined in: [lib/ai.ts:51](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L51)
 
 自定义 fetch 函数
 
@@ -1908,7 +1918,7 @@ Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **secretKey?**: `string`
 
-Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L47)
+Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L49)
 
 密钥
 
@@ -1918,7 +1928,7 @@ Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **service**: [`ESERVICE`](../enumerations/ESERVICE.md)
 
-Defined in: [lib/ai.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L43)
+Defined in: [lib/ai.ts:45](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L45)
 
 服务商 -
 
@@ -20497,9 +20507,9 @@ Defined in: [sys/ctr.ts:315](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 ### \_handleFormData()
 
-> `protected` **\_handleFormData**(`events?`): `Promise`\<`boolean`\>
+> `protected` **\_handleFormData**(`events?`, `limits?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:1020](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1020)
+Defined in: [sys/ctr.ts:1021](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1021)
 
 获取 formdata 的信息
 
@@ -20521,6 +20531,22 @@ Defined in: [sys/ctr.ts:1020](https://github.com/maiyunnet/kebab/blob/master/sys
 
 (`name`) => `boolean` \| `undefined`
 
+##### limits?
+
+上传限制
+
+###### allowedExts?
+
+`string`[]
+
+允许的文件扩展名（含点号），如 ['.jpg', '.png', '.pdf']
+
+###### maxFileSize?
+
+`number`
+
+单个文件最大字节数
+
 #### Returns
 
 `Promise`\<`boolean`\>
@@ -21529,7 +21555,7 @@ Defined in: [sys/mod.ts:68](https://github.com/maiyunnet/kebab/blob/master/sys/m
 
 > `protected` **\_keyGenerator**(): `string`
 
-Defined in: [sys/mod.ts:1794](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1794)
+Defined in: [sys/mod.ts:1798](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1798)
 
 当 _key 不为空时，则依据继承此方法的方法自动生成填充 key
 
@@ -21551,7 +21577,7 @@ Defined in: [sys/mod.ts:1794](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(): `Promise`\<`false` \| [`Rows`](Rows.md)\<`Mod`\>\>
 
-Defined in: [sys/mod.ts:1136](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1136)
+Defined in: [sys/mod.ts:1140](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1140)
 
 ##### Returns
 
@@ -21561,7 +21587,7 @@ Defined in: [sys/mod.ts:1136](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Mod`\>\>
 
-Defined in: [sys/mod.ts:1137](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1137)
+Defined in: [sys/mod.ts:1141](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1141)
 
 ##### Parameters
 
@@ -21587,7 +21613,7 @@ Defined in: [sys/mod.ts:1137](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(): `Promise`\<`false` \| `Record`\<`string`, `any`\>[]\>
 
-Defined in: [sys/mod.ts:1315](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1315)
+Defined in: [sys/mod.ts:1319](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1319)
 
 ##### Returns
 
@@ -21597,7 +21623,7 @@ Defined in: [sys/mod.ts:1315](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Record`\<`string`, `any`\>\>\>
 
-Defined in: [sys/mod.ts:1316](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1316)
+Defined in: [sys/mod.ts:1320](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1320)
 
 ##### Parameters
 
@@ -21615,7 +21641,7 @@ Defined in: [sys/mod.ts:1316](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **append**(`sql`): `this`
 
-Defined in: [sys/mod.ts:1703](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1703)
+Defined in: [sys/mod.ts:1707](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1707)
 
 在 sql 最后追加字符串
 
@@ -21635,7 +21661,7 @@ Defined in: [sys/mod.ts:1703](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **by**(`c`, `d?`): `this`
 
-Defined in: [sys/mod.ts:1659](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1659)
+Defined in: [sys/mod.ts:1663](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1663)
 
 ORDER BY
 
@@ -21663,7 +21689,7 @@ ORDER BY
 
 > **contain**(`contain`): `this`
 
-Defined in: [sys/mod.ts:1712](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1712)
+Defined in: [sys/mod.ts:1716](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1716)
 
 设置闭包含数据
 
@@ -21691,7 +21717,7 @@ Defined in: [sys/mod.ts:1712](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **count**(): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1523](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1523)
+Defined in: [sys/mod.ts:1527](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1527)
 
 根据当前条件，筛选出当前条目该有的数据条数
 
@@ -21705,7 +21731,7 @@ Defined in: [sys/mod.ts:1523](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **countSql**(): `string`
 
-Defined in: [sys/mod.ts:1544](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1544)
+Defined in: [sys/mod.ts:1548](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1548)
 
 获取当前条件下的 count 的 SQL 语句
 
@@ -21719,7 +21745,7 @@ Defined in: [sys/mod.ts:1544](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **create**(): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:830](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L830)
+Defined in: [sys/mod.ts:834](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L834)
 
 创建数据
 
@@ -21735,7 +21761,7 @@ true-成功,false-报错,null-唯一键非 _$key 键冲突
 
 > **crossJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1619](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1619)
+Defined in: [sys/mod.ts:1623](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1623)
 
 cross join 方法
 
@@ -21783,7 +21809,7 @@ ON 信息
 
 > **explain**(`all?`): `Promise`\<`string` \| `false`\>
 
-Defined in: [sys/mod.ts:1441](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1441)
+Defined in: [sys/mod.ts:1445](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1445)
 
 ##### Parameters
 
@@ -21799,7 +21825,7 @@ Defined in: [sys/mod.ts:1441](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **explain**(`all`): `Promise`\<`false` \| `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:1442](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1442)
+Defined in: [sys/mod.ts:1446](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1446)
 
 ##### Parameters
 
@@ -21817,7 +21843,7 @@ Defined in: [sys/mod.ts:1442](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **filter**(`s`): `this`
 
-Defined in: [sys/mod.ts:1637](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1637)
+Defined in: [sys/mod.ts:1641](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1641)
 
 筛选器
 
@@ -21851,7 +21877,7 @@ Defined in: [sys/mod.ts:1637](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock`, `array`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1025](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1025)
+Defined in: [sys/mod.ts:1029](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1029)
 
 ##### Parameters
 
@@ -21871,7 +21897,7 @@ Defined in: [sys/mod.ts:1025](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock?`, `array?`): `Promise`\<`false` \| `Mod` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1029](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1029)
+Defined in: [sys/mod.ts:1033](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1033)
 
 ##### Parameters
 
@@ -21893,7 +21919,7 @@ Defined in: [sys/mod.ts:1029](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **firstArray**(`lock?`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1069](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1069)
+Defined in: [sys/mod.ts:1073](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1073)
 
 获取数据库第一个原生对象
 
@@ -21915,7 +21941,7 @@ Defined in: [sys/mod.ts:1069](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [sys/mod.ts:1739](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1739)
+Defined in: [sys/mod.ts:1743](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1743)
 
 获取带 data 的 sql 语句
 
@@ -21943,7 +21969,7 @@ sql 语句
 
 > **fullJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1607](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1607)
+Defined in: [sys/mod.ts:1611](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1611)
 
 full join 方法
 
@@ -21983,7 +22009,7 @@ ON 信息
 
 > **get**(`n`): `any`
 
-Defined in: [sys/mod.ts:822](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L822)
+Defined in: [sys/mod.ts:826](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L826)
 
 获取一个字段值
 
@@ -22005,7 +22031,7 @@ Defined in: [sys/mod.ts:822](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **getData**(): `any`[]
 
-Defined in: [sys/mod.ts:1730](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1730)
+Defined in: [sys/mod.ts:1734](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1734)
 
 获取全部 data
 
@@ -22019,7 +22045,7 @@ Defined in: [sys/mod.ts:1730](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getSql**(): `string`
 
-Defined in: [sys/mod.ts:1723](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1723)
+Defined in: [sys/mod.ts:1727](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1727)
 
 获取 sql 语句
 
@@ -22033,7 +22059,7 @@ Defined in: [sys/mod.ts:1723](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **group**(`c`): `this`
 
-Defined in: [sys/mod.ts:1668](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1668)
+Defined in: [sys/mod.ts:1672](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1672)
 
 GROUP BY
 
@@ -22055,7 +22081,7 @@ GROUP BY
 
 > **having**(`s`): `this`
 
-Defined in: [sys/mod.ts:1628](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1628)
+Defined in: [sys/mod.ts:1632](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1632)
 
 筛选器
 
@@ -22077,7 +22103,7 @@ Defined in: [sys/mod.ts:1628](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **innerJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1595](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1595)
+Defined in: [sys/mod.ts:1599](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1599)
 
 inner join 方法
 
@@ -22117,7 +22143,7 @@ ON 信息
 
 > **join**(`f`, `s?`, `type?`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1559](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1559)
+Defined in: [sys/mod.ts:1563](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1563)
 
 #### Parameters
 
@@ -22161,7 +22187,7 @@ ON 信息
 
 > **langText**(`col`, `lang`): `string`
 
-Defined in: [sys/mod.ts:1774](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1774)
+Defined in: [sys/mod.ts:1778](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1778)
 
 获取字段的可用语种文本
 
@@ -22189,7 +22215,7 @@ Defined in: [sys/mod.ts:1774](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **leftJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1571](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1571)
+Defined in: [sys/mod.ts:1575](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1575)
 
 left join 方法
 
@@ -22229,7 +22255,7 @@ ON 信息
 
 > **limit**(`a`, `b?`): `this`
 
-Defined in: [sys/mod.ts:1681](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1681)
+Defined in: [sys/mod.ts:1685](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1685)
 
 LIMIT
 
@@ -22257,7 +22283,7 @@ LIMIT
 
 > **page**(`count`, `page?`): `this`
 
-Defined in: [sys/mod.ts:1692](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1692)
+Defined in: [sys/mod.ts:1696](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1696)
 
 分页
 
@@ -22285,7 +22311,7 @@ Defined in: [sys/mod.ts:1692](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **refresh**(`lock?`): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:950](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L950)
+Defined in: [sys/mod.ts:954](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L954)
 
 刷新当前模型获取最新数据
 
@@ -22307,7 +22333,7 @@ Defined in: [sys/mod.ts:950](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **remove**(): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:1007](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1007)
+Defined in: [sys/mod.ts:1011](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1011)
 
 移除本条目
 
@@ -22321,7 +22347,7 @@ Defined in: [sys/mod.ts:1007](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **rightJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1583](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1583)
+Defined in: [sys/mod.ts:1587](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1587)
 
 right join 方法
 
@@ -22361,7 +22387,7 @@ ON 信息
 
 > **save**(`where?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L978)
+Defined in: [sys/mod.ts:982](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L982)
 
 更新 set 的数据到数据库，有未保存数据时才保存
 
@@ -22395,7 +22421,7 @@ Defined in: [sys/mod.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **set**\<`T`, `TK`\>(`n`): `void`
 
-Defined in: [sys/mod.ts:783](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L783)
+Defined in: [sys/mod.ts:787](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L787)
 
 ##### Type Parameters
 
@@ -22421,7 +22447,7 @@ Defined in: [sys/mod.ts:783](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **set**\<`T`, `TK`\>(`n`, `v`): `void`
 
-Defined in: [sys/mod.ts:784](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L784)
+Defined in: [sys/mod.ts:788](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L788)
 
 ##### Type Parameters
 
@@ -22453,7 +22479,7 @@ Defined in: [sys/mod.ts:784](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:1746](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1746)
+Defined in: [sys/mod.ts:1750](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1750)
 
 获取值对象，获取的是新创建的数组
 
@@ -22473,7 +22499,7 @@ Defined in: [sys/mod.ts:1746](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **total**(`f?`): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1499](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1499)
+Defined in: [sys/mod.ts:1503](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1503)
 
 获取总条数，自动抛弃 LIMIT，仅用于获取数据的情况（select）
 
@@ -22493,7 +22519,7 @@ Defined in: [sys/mod.ts:1499](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **union**(`f`, `type?`): `this`
 
-Defined in: [sys/mod.ts:1080](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1080)
+Defined in: [sys/mod.ts:1084](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1084)
 
 联合查询表数据
 
@@ -22521,7 +22547,7 @@ Defined in: [sys/mod.ts:1080](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unionAll**(`f`): `this`
 
-Defined in: [sys/mod.ts:1110](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1110)
+Defined in: [sys/mod.ts:1114](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1114)
 
 所有联合查询表数据
 
@@ -22543,7 +22569,7 @@ Defined in: [sys/mod.ts:1110](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unsaved**(): `boolean`
 
-Defined in: [sys/mod.ts:1765](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1765)
+Defined in: [sys/mod.ts:1769](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1769)
 
 当前是否设置了未保存 --=
 
@@ -22557,7 +22583,7 @@ Defined in: [sys/mod.ts:1765](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **updates**(): `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:1754](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1754)
+Defined in: [sys/mod.ts:1758](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1758)
 
 获取当前设置要提交的数据
 
@@ -22571,7 +22597,7 @@ Defined in: [sys/mod.ts:1754](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **upsert**(`conflict`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:920](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L920)
+Defined in: [sys/mod.ts:924](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L924)
 
 插入数据，如果存在则更新（UPSERT）
 
@@ -22593,7 +22619,7 @@ Defined in: [sys/mod.ts:920](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **where**(`s`): `this`
 
-Defined in: [sys/mod.ts:1648](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1648)
+Defined in: [sys/mod.ts:1652](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1652)
 
 是 filter 的别名
 
@@ -22889,7 +22915,7 @@ Defined in: [sys/mod.ts:183](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 #### Param
 
-选项
+选项，lock 需确保 where 条件命中索引，否则可能退化为表锁
 
 #### Call Signature
 
@@ -22925,6 +22951,10 @@ Defined in: [sys/mod.ts:637](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 `string` \| `string`[]
 
+###### lock?
+
+`boolean`
+
 ###### pre?
 
 `string`
@@ -22941,7 +22971,7 @@ Defined in: [sys/mod.ts:637](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:649](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L649)
+Defined in: [sys/mod.ts:650](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L650)
 
 ##### Type Parameters
 
@@ -22977,6 +23007,10 @@ Defined in: [sys/mod.ts:649](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 `string` \| `string`[]
 
+###### lock?
+
+`boolean`
+
 ###### pre?
 
 `string`
@@ -22995,7 +23029,7 @@ Defined in: [sys/mod.ts:649](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **oneArray**(`db`, `s`, `opt?`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:724](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L724)
+Defined in: [sys/mod.ts:727](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L727)
 
 通过 where 条件筛选单条数据返回原生对象
 
@@ -23025,6 +23059,10 @@ Defined in: [sys/mod.ts:724](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 `string` \| `string`[]
 
+###### lock?
+
+`boolean`
+
 ###### pre?
 
 `string`
@@ -23043,7 +23081,7 @@ Defined in: [sys/mod.ts:724](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `static` **primarys**(`db`, `where?`, `opt?`): `Promise`\<`false` \| `any`[]\>
 
-Defined in: [sys/mod.ts:744](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L744)
+Defined in: [sys/mod.ts:748](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L748)
 
 根据 where 条件获取主键值列表
 
@@ -23257,7 +23295,7 @@ select 自定字段
 
 > `static` **toArrayByRecord**\<`T`\>(`obj`): `Record`\<`string`, `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:771](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L771)
+Defined in: [sys/mod.ts:775](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L775)
 
 将 key val 组成的数据列表转换为原生对象模式，获取的是新创建的数组
 
@@ -23716,7 +23754,7 @@ sys/mod/interfaces/IModUnionItem.md
 
 # Interface: IModUnionItem
 
-Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1808)
+Defined in: [sys/mod.ts:1812](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1812)
 
 ## Properties
 
@@ -23724,7 +23762,7 @@ Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **field**: `string`
 
-Defined in: [sys/mod.ts:1809](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1809)
+Defined in: [sys/mod.ts:1813](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1813)
 
 ***
 
@@ -23732,7 +23770,7 @@ Defined in: [sys/mod.ts:1809](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `optional` **where?**: `any`
 
-Defined in: [sys/mod.ts:1810](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1810)
+Defined in: [sys/mod.ts:1814](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1814)
 
 sys/mod/interfaces/IRows.md
 ---
@@ -23745,7 +23783,7 @@ sys/mod/interfaces/IRows.md
 
 # Interface: IRows\<T\>
 
-Defined in: [sys/mod.ts:1802](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1802)
+Defined in: [sys/mod.ts:1806](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1806)
 
 ## Extends
 
@@ -23763,7 +23801,7 @@ Defined in: [sys/mod.ts:1802](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `readonly` **length**: `number`
 
-Defined in: [sys/mod.ts:1803](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1803)
+Defined in: [sys/mod.ts:1807](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1807)
 
 ## Methods
 
@@ -23771,7 +23809,7 @@ Defined in: [sys/mod.ts:1803](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **item**(`index`): `T`
 
-Defined in: [sys/mod.ts:1804](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1804)
+Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1808)
 
 #### Parameters
 
@@ -23789,7 +23827,7 @@ Defined in: [sys/mod.ts:1804](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **toArray**(): `Record`\<`string`, `any`\>[]
 
-Defined in: [sys/mod.ts:1805](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1805)
+Defined in: [sys/mod.ts:1809](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1809)
 
 #### Returns
 

package/index.d.ts

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

package/index.js

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

package/lib/ai.d.ts

@@ -15,22 +15,24 @@ import * as sCtr from '#kebab/sys/ctr.js';
 export declare enum ESERVICE {
     /** --- 阿里中国大陆区 --- */
     'ALICN' = 0,
-    /** --- 阿里国际区 --- */
+    /** --- 阿里新加坡 --- */
     'ALIAS' = 1,
+    /** --- 阿里美国 --- */
+    'ALINE' = 2,
     /** --- 微软 Azure --- */
-    'AZURE' = 2,
+    'AZURE' = 3,
     /** --- 微软 Azure 2 --- */
-    'AZURE2' = 3,
+    'AZURE2' = 4,
     /** --- 微软 Azure 3 --- */
-    'AZURE3' = 4,
+    'AZURE3' = 5,
     /** --- Gemini --- */
-    'GEMINI' = 5,
+    'GEMINI' = 6,
     /** --- Grok --- */
-    'GROK' = 6,
+    'GROK' = 7,
     /** --- 火山引擎中国大陆区 --- */
-    'VOLCN' = 7,
+    'VOLCN' = 8,
     /** --- 火山引擎国际区 --- */
-    'VOLAS' = 8
+    'VOLAS' = 9
 }
 /** --- 选项 --- */
 export interface IOptions {
@@ -64,7 +66,7 @@ export declare class Ai {
         'model': string;
         /** --- 提示词 --- */
         'prompt': string;
-        /** --- 参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、VOLCN、VOLAS 服务商 --- */
+        /** --- 参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、ALINE、VOLCN、VOLAS 服务商 --- */
         'imgs'?: string[];
         /** --- 模型是否自动优化提示词，默认为 false，但有些服务商可能无效 --- */
         'extend'?: boolean;
@@ -87,7 +89,7 @@ export declare class Ai {
         /** --- 请求编号 --- */
         'request': string;
     } | false>;
-    /** --- 异步生成视频，仅支持 ALICN、ALIAS --- */
+    /** --- 异步生成视频，仅支持 ALICN、ALIAS、ALINE --- */
     video(opt: {
         'model': string;
         /** --- 提示词，参考类可用 [I1] 指代图片，如 `[I1] 看向 [I2]` --- */

package/lib/ai.js

@@ -16,22 +16,24 @@ export var ESERVICE;
 (function (ESERVICE) {
     /** --- 阿里中国大陆区 --- */
     ESERVICE[ESERVICE["ALICN"] = 0] = "ALICN";
-    /** --- 阿里国际区 --- */
+    /** --- 阿里新加坡 --- */
     ESERVICE[ESERVICE["ALIAS"] = 1] = "ALIAS";
+    /** --- 阿里美国 --- */
+    ESERVICE[ESERVICE["ALINE"] = 2] = "ALINE";
     /** --- 微软 Azure --- */
-    ESERVICE[ESERVICE["AZURE"] = 2] = "AZURE";
+    ESERVICE[ESERVICE["AZURE"] = 3] = "AZURE";
     /** --- 微软 Azure 2 --- */
-    ESERVICE[ESERVICE["AZURE2"] = 3] = "AZURE2";
+    ESERVICE[ESERVICE["AZURE2"] = 4] = "AZURE2";
     /** --- 微软 Azure 3 --- */
-    ESERVICE[ESERVICE["AZURE3"] = 4] = "AZURE3";
+    ESERVICE[ESERVICE["AZURE3"] = 5] = "AZURE3";
     /** --- Gemini --- */
-    ESERVICE[ESERVICE["GEMINI"] = 5] = "GEMINI";
+    ESERVICE[ESERVICE["GEMINI"] = 6] = "GEMINI";
     /** --- Grok --- */
-    ESERVICE[ESERVICE["GROK"] = 6] = "GROK";
+    ESERVICE[ESERVICE["GROK"] = 7] = "GROK";
     /** --- 火山引擎中国大陆区 --- */
-    ESERVICE[ESERVICE["VOLCN"] = 7] = "VOLCN";
+    ESERVICE[ESERVICE["VOLCN"] = 8] = "VOLCN";
     /** --- 火山引擎国际区 --- */
-    ESERVICE[ESERVICE["VOLAS"] = 8] = "VOLAS";
+    ESERVICE[ESERVICE["VOLAS"] = 9] = "VOLAS";
 })(ESERVICE || (ESERVICE = {}));
 /** --- openai 的连接对象 --- */
 const links = [];
@@ -64,6 +66,10 @@ export class Ai {
                 endpoint = opt.endpoint ?? `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`;
                 break;
             }
+            case ESERVICE.ALINE: {
+                endpoint = opt.endpoint ?? `https://dashscope-us.aliyuncs.com/compatible-mode/v1`;
+                break;
+            }
             case ESERVICE.AZURE: {
                 endpoint = opt.endpoint ?? configAi.endpoint ?? '';
                 break;
@@ -148,9 +154,10 @@ export class Ai {
         const seed = opt.seed ?? lCore.rand(0, 2147483647);
         switch (this._service) {
             case ESERVICE.ALICN:
-            case ESERVICE.ALIAS: {
+            case ESERVICE.ALIAS:
+            case ESERVICE.ALINE: {
                 try {
-                    const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`, {
+                    const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : (this._service === ESERVICE.ALINE ? '-us' : '')}.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`, {
                         'method': 'POST',
                         'headers': {
                             'authorization': `Bearer ${this.link.apiKey}`,
@@ -295,9 +302,9 @@ export class Ai {
             }
         }
     }
-    /** --- 异步生成视频，仅支持 ALICN、ALIAS --- */
+    /** --- 异步生成视频，仅支持 ALICN、ALIAS、ALINE --- */
     async video(opt) {
-        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS) {
+        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS && this._service !== ESERVICE.ALINE) {
             return false;
         }
         const mode = opt.mode ?? 'text';
@@ -373,7 +380,7 @@ export class Ai {
             }
         }
         try {
-            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis`, {
+            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : (this._service === ESERVICE.ALINE ? '-us' : '')}.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis`, {
                 'method': 'POST',
                 'headers': {
                     'authorization': `Bearer ${this.link.apiKey}`,
@@ -432,11 +439,11 @@ export class Ai {
     }
     /** --- 轮询任务 --- */
     async poll(opt) {
-        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS) {
+        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS && this._service !== ESERVICE.ALINE) {
             return false;
         }
         try {
-            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/tasks/${opt.task}`, {
+            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : (this._service === ESERVICE.ALINE ? '-us' : '')}.aliyuncs.com/api/v1/tasks/${opt.task}`, {
                 'method': 'GET',
                 'headers': {
                     'authorization': `Bearer ${this.link.apiKey}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.0.0",
+  "version": "9.0.2",
   "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/cmd.js

@@ -172,6 +172,8 @@ async function run() {
         config.ai['ALICN'].skey ??= '';
         config.ai['ALIAS'] ??= {};
         config.ai['ALIAS'].skey ??= '';
+        config.ai['ALINE'] ??= {};
+        config.ai['ALINE'].skey ??= '';
         config.ai['AZURE'] ??= {};
         config.ai['AZURE'].endpoint ??= '';
         config.ai['AZURE'].skey ??= '';

package/sys/ctr.d.ts

@@ -318,10 +318,16 @@ export declare class Ctr {
     /**
      * --- 获取 formdata 的信息 ---
      * @param events 文件处理情况
+     * @param limits 上传限制
      */
     protected _handleFormData(events?: {
         onfilestart?: (name: string) => boolean | undefined;
         onfiledata?: (chunk: Buffer) => void;
         onfileend?: () => void;
+    }, limits?: {
+        /** --- 单个文件最大字节数 --- */
+        'maxFileSize'?: number;
+        /** --- 允许的文件扩展名（含点号），如 ['.jpg', '.png', '.pdf'] --- */
+        'allowedExts'?: string[];
     }): Promise<boolean>;
 }

package/sys/ctr.js

@@ -833,9 +833,10 @@ export class Ctr {
     /**
      * --- 获取 formdata 的信息 ---
      * @param events 文件处理情况
+     * @param limits 上传限制
      */
-    async _handleFormData(events = {}) {
-        const rtn = await sRoute.getFormData(this._req, events);
+    async _handleFormData(events = {}, limits = {}) {
+        const rtn = await sRoute.getFormData(this._req, events, limits);
         if (!rtn) {
             return false;
         }

package/sys/mod.d.ts

@@ -240,6 +240,7 @@ export default class Mod {
     }): Promise<false | null | (T & Record<string, any>)>;
     static one(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt: {
         'ctr'?: sCtr.Ctr;
+        'lock'?: boolean;
         'pre'?: string;
         'index'?: string | string[];
         'select'?: string | string[];
@@ -248,6 +249,7 @@ export default class Mod {
     }): Promise<false | null | Record<string, any>>;
     static one<T extends Mod>(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt?: {
         'ctr'?: sCtr.Ctr;
+        'lock'?: boolean;
         'pre'?: string;
         'index'?: string | string[];
         'select'?: string | string[];
@@ -262,6 +264,7 @@ export default class Mod {
      */
     static oneArray(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt?: {
         'ctr'?: sCtr.Ctr;
+        'lock'?: boolean;
         'pre'?: string;
         'index'?: string | string[];
         'select'?: string | string[];

package/sys/mod.js

@@ -444,7 +444,7 @@ export default class Mod {
      * --- 通过 where 条件筛选单条数据 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项
+     * @param opt 选项，lock 需确保 where 条件命中索引，否则可能退化为表锁
      */
     static async one(db, s, opt = {}) {
         if (!opt.index) {
@@ -459,7 +459,7 @@ export default class Mod {
             if (opt.by) {
                 o.by(opt.by[0], opt.by[1]);
             }
-            return opt.array ? o.firstArray() : o.first();
+            return opt.array ? o.firstArray(opt.lock) : o.first(opt.lock);
         }
         const indexs = (typeof opt.index === 'string') ? [opt.index] : [...new Set(opt.index)];
         for (const item of indexs) {
@@ -474,7 +474,7 @@ export default class Mod {
             if (opt.by) {
                 row.by(opt.by[0], opt.by[1]);
             }
-            const rowr = await (opt.array ? row.firstArray() : row.first());
+            const rowr = await (opt.array ? row.firstArray(opt.lock) : row.first(opt.lock));
             if (rowr) {
                 return rowr;
             }

package/www/example/ctr/test.js

@@ -3519,7 +3519,9 @@ rtn.push(reader.readBCDString());</pre>${JSON.stringify(rtn)}`);
                 // --- 文生图 ---
                 let model = 'z-image-turbo';
                 let size = [1280, 720];
-                if (ai.service !== lAi.ESERVICE.ALICN && ai.service !== lAi.ESERVICE.ALIAS) {
+                if (ai.service !== lAi.ESERVICE.ALICN &&
+                    ai.service !== lAi.ESERVICE.ALIAS &&
+                    ai.service !== lAi.ESERVICE.ALINE) {
                     switch (ai.service) {
                         case lAi.ESERVICE.AZURE:
                         case lAi.ESERVICE.AZURE2:
@@ -3562,7 +3564,9 @@ rtn.push(reader.readBCDString());</pre>${JSON.stringify(rtn)}`);
                 let model = 'wan2.6-image';
                 let size = [1280, 720];
                 const prompt = '用图1的绘画风格重绘图2的场景，桌上增加一盘番茄炒蛋';
-                if (ai.service !== lAi.ESERVICE.ALICN && ai.service !== lAi.ESERVICE.ALIAS) {
+                if (ai.service !== lAi.ESERVICE.ALICN &&
+                    ai.service !== lAi.ESERVICE.ALIAS &&
+                    ai.service !== lAi.ESERVICE.ALINE) {
                     switch (ai.service) {
                         default: {
                             // --- 火山引擎 ---