@maiyunnet/kebab 7.7.0 → 7.7.1

package/doc/kebab-rag.md

@@ -1385,7 +1385,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"7.7.0"` = `'7.7.0'`
+> `const` **VER**: `"7.7.1"` = `'7.7.1'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -4586,7 +4586,7 @@ lib/crypto/functions/aesDecrypt.md
 
 > **aesDecrypt**(`encrypt`, `key`, `iv`, `method`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:339](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L339)
+Defined in: [lib/crypto.ts:340](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L340)
 
 AES 解密
 
@@ -4628,7 +4628,7 @@ AES 解密
 
 > **aesDecrypt**(`encrypt`, `key`, `iv?`, `method?`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:340](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L340)
+Defined in: [lib/crypto.ts:341](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L341)
 
 AES 解密
 
@@ -4681,7 +4681,7 @@ lib/crypto/functions/aesEncrypt.md
 
 > **aesEncrypt**(`original`, `key`, `iv`, `method`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:226](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L226)
+Defined in: [lib/crypto.ts:227](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L227)
 
 AES 加密
 
@@ -4725,7 +4725,7 @@ AES 加密
 
 > **aesEncrypt**(`original`, `key`, `iv?`, `method?`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:227](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L227)
+Defined in: [lib/crypto.ts:228](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L228)
 
 AES 加密
 
@@ -4780,7 +4780,7 @@ lib/crypto/functions/base64Decode.md
 
 > **base64Decode**(`data`, `encoding`): `Buffer`
 
-Defined in: [lib/crypto.ts:445](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L445)
+Defined in: [lib/crypto.ts:446](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L446)
 
 base64 解码
 
@@ -4806,7 +4806,7 @@ base64 编码的字符串
 
 > **base64Decode**(`data`, `encoding?`): `string`
 
-Defined in: [lib/crypto.ts:446](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L446)
+Defined in: [lib/crypto.ts:447](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L447)
 
 base64 解码
 
@@ -4841,7 +4841,7 @@ lib/crypto/functions/base64Encode.md
 
 > **base64Encode**(`data`): `string`
 
-Defined in: [lib/crypto.ts:431](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L431)
+Defined in: [lib/crypto.ts:432](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L432)
 
 base64 编码
 
@@ -4870,7 +4870,7 @@ lib/crypto/functions/cipherDecrypt.md
 
 > **cipherDecrypt**(`encrypt`, `key`, `iv`, `method`, `output`): `string` \| `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:276](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L276)
+Defined in: [lib/crypto.ts:277](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L277)
 
 cipher 解密
 
@@ -4923,7 +4923,7 @@ lib/crypto/functions/cipherEncrypt.md
 
 > **cipherEncrypt**(`original`, `key`, `iv`, `method`, `output`): `string` \| `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:166](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L166)
+Defined in: [lib/crypto.ts:167](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L167)
 
 cipher 加密，强烈不建议使用 AES_256_ECB
 
@@ -4978,7 +4978,7 @@ lib/crypto/functions/gcmDecrypt.md
 
 > **gcmDecrypt**(`encrypt`, `key`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:354](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L354)
+Defined in: [lib/crypto.ts:355](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L355)
 
 AES 解密
 
@@ -5010,7 +5010,7 @@ AES 解密
 
 > **gcmDecrypt**(`encrypt`, `key`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:355](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L355)
+Defined in: [lib/crypto.ts:356](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L356)
 
 AES 解密
 
@@ -5053,7 +5053,7 @@ lib/crypto/functions/gcmEncrypt.md
 
 > **gcmEncrypt**(`original`, `key`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:241](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L241)
+Defined in: [lib/crypto.ts:242](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L242)
 
 AES GCM 托管加密
 
@@ -5085,7 +5085,7 @@ AES GCM 托管加密
 
 > **gcmEncrypt**(`original`, `key`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:242](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L242)
+Defined in: [lib/crypto.ts:243](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L243)
 
 AES GCM 托管加密
 
@@ -5193,7 +5193,7 @@ lib/crypto/functions/hashHmac.md
 
 > **hashHmac**(`algorithm`, `data`, `key?`, `format?`): `string`
 
-Defined in: [lib/crypto.ts:387](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L387)
+Defined in: [lib/crypto.ts:388](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L388)
 
 hash 或 hmac 加密
 
@@ -5229,7 +5229,7 @@ hash 或 hmac 加密
 
 > **hashHmac**(`algorithm`, `data`, `key`, `format`): `Buffer`
 
-Defined in: [lib/crypto.ts:388](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L388)
+Defined in: [lib/crypto.ts:389](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L389)
 
 hash 或 hmac 加密
 
@@ -5276,7 +5276,7 @@ lib/crypto/functions/hashHmacFile.md
 
 > **hashHmacFile**(`algorithm`, `path`, `key?`, `encoding?`): `Promise`\<`string` \| `false`\>
 
-Defined in: [lib/crypto.ts:406](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L406)
+Defined in: [lib/crypto.ts:407](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L407)
 
 hash 或 hmac 加密文件
 
@@ -5312,7 +5312,7 @@ hash 或 hmac 加密文件
 
 > **hashHmacFile**(`algorithm`, `path`, `key`, `encoding`): `Promise`\<`false` \| `Buffer`\<`ArrayBufferLike`\>\>
 
-Defined in: [lib/crypto.ts:407](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L407)
+Defined in: [lib/crypto.ts:408](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L408)
 
 hash 或 hmac 加密文件
 
@@ -5357,7 +5357,7 @@ lib/crypto/functions/privateDecrypt.md
 
 > **privateDecrypt**(`key`, `buffer`): `Buffer`
 
-Defined in: [lib/crypto.ts:135](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L135)
+Defined in: [lib/crypto.ts:136](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L136)
 
 非对称私钥解密
 
@@ -5392,7 +5392,7 @@ lib/crypto/functions/privateEncrypt.md
 
 > **privateEncrypt**(`key`, `buffer`): `Buffer`
 
-Defined in: [lib/crypto.ts:113](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L113)
+Defined in: [lib/crypto.ts:114](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L114)
 
 非对称私钥加密
 
@@ -5427,7 +5427,7 @@ lib/crypto/functions/publicDecrypt.md
 
 > **publicDecrypt**(`key`, `buffer`): `Buffer`
 
-Defined in: [lib/crypto.ts:124](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L124)
+Defined in: [lib/crypto.ts:125](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L125)
 
 非对称公钥解密
 
@@ -5462,7 +5462,7 @@ lib/crypto/functions/publicEncrypt.md
 
 > **publicEncrypt**(`key`, `buffer`): `Buffer`
 
-Defined in: [lib/crypto.ts:102](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L102)
+Defined in: [lib/crypto.ts:103](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L103)
 
 非对称公钥加密
 
@@ -5499,7 +5499,7 @@ lib/crypto/functions/sign.md
 
 > **sign**(`data`, `privateKey`, `format`, `algorithm?`): `string`
 
-Defined in: [lib/crypto.ts:68](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L68)
+Defined in: [lib/crypto.ts:69](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L69)
 
 非对称加签
 
@@ -5537,7 +5537,7 @@ Defined in: [lib/crypto.ts:68](https://github.com/maiyunnet/kebab/blob/master/li
 
 > **sign**(`data`, `privateKey`, `format?`, `algorithm?`): `Buffer`
 
-Defined in: [lib/crypto.ts:71](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L71)
+Defined in: [lib/crypto.ts:72](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L72)
 
 非对称加签
 
@@ -5586,7 +5586,7 @@ lib/crypto/functions/sm4Decrypt.md
 
 > **sm4Decrypt**(`encrypt`, `key`, `iv`, `method`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:372](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L372)
+Defined in: [lib/crypto.ts:373](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L373)
 
 SM4 解密
 
@@ -5628,7 +5628,7 @@ SM4 解密
 
 > **sm4Decrypt**(`encrypt`, `key`, `iv?`, `method?`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:373](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L373)
+Defined in: [lib/crypto.ts:374](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L374)
 
 SM4 解密
 
@@ -5681,7 +5681,7 @@ lib/crypto/functions/sm4Encrypt.md
 
 > **sm4Encrypt**(`original`, `key`, `iv`, `method`, `output`): `false` \| `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [lib/crypto.ts:259](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L259)
+Defined in: [lib/crypto.ts:260](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L260)
 
 SM4 加密
 
@@ -5723,7 +5723,7 @@ SM4 加密
 
 > **sm4Encrypt**(`original`, `key`, `iv?`, `method?`, `output?`): `string` \| `false`
 
-Defined in: [lib/crypto.ts:260](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L260)
+Defined in: [lib/crypto.ts:261](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L261)
 
 SM4 加密
 
@@ -5774,7 +5774,7 @@ lib/crypto/functions/uuid.md
 
 > **uuid**(`options?`): `string`
 
-Defined in: [lib/crypto.ts:459](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L459)
+Defined in: [lib/crypto.ts:460](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L460)
 
 生成 uuid
 
@@ -5803,7 +5803,7 @@ lib/crypto/functions/verify.md
 
 > **verify**(`data`, `object`, `signature`, `algorithm`): `boolean`
 
-Defined in: [lib/crypto.ts:89](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L89)
+Defined in: [lib/crypto.ts:90](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L90)
 
 非对称验签
 
@@ -5894,7 +5894,7 @@ lib/crypto/variables/AES_256_CBC.md
 
 > `const` **AES\_256\_CBC**: `"aes-256-cbc"` = `'aes-256-cbc'`
 
-Defined in: [lib/crypto.ts:146](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L146)
+Defined in: [lib/crypto.ts:147](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L147)
 
 一般不用，兼容性场景下用
 
@@ -5911,7 +5911,7 @@ lib/crypto/variables/AES_256_CTR.md
 
 > `const` **AES\_256\_CTR**: `"aes-256-ctr"` = `'aes-256-ctr'`
 
-Defined in: [lib/crypto.ts:148](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L148)
+Defined in: [lib/crypto.ts:149](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L149)
 
 设置 iv 会自动切换为 CTR，流式下使用，非流直接使用 GCM
 
@@ -5928,7 +5928,7 @@ lib/crypto/variables/AES_256_ECB.md
 
 > `const` **AES\_256\_ECB**: `"aes-256-ecb"` = `'aes-256-ecb'`
 
-Defined in: [lib/crypto.ts:144](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L144)
+Defined in: [lib/crypto.ts:145](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L145)
 
 勿使用，无 iv 默认，但勿使用
 
@@ -5945,7 +5945,7 @@ lib/crypto/variables/AES_256_GCM.md
 
 > `const` **AES\_256\_GCM**: `"aes-256-gcm"` = `'aes-256-gcm'`
 
-Defined in: [lib/crypto.ts:150](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L150)
+Defined in: [lib/crypto.ts:151](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L151)
 
 非流直接使用 GCM
 
@@ -5962,7 +5962,7 @@ lib/crypto/variables/SM4_CBC.md
 
 > `const` **SM4\_CBC**: `"sm4-cbc"` = `'sm4-cbc'`
 
-Defined in: [lib/crypto.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L154)
+Defined in: [lib/crypto.ts:155](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L155)
 
 lib/crypto/variables/SM4_CFB.md
 ---
@@ -5977,7 +5977,7 @@ lib/crypto/variables/SM4_CFB.md
 
 > `const` **SM4\_CFB**: `"sm4-cfb"` = `'sm4-cfb'`
 
-Defined in: [lib/crypto.ts:156](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L156)
+Defined in: [lib/crypto.ts:157](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L157)
 
 SM4 一般用这个，设置 iv，自动就切换成了这个
 
@@ -5994,7 +5994,7 @@ lib/crypto/variables/SM4_ECB.md
 
 > `const` **SM4\_ECB**: `"sm4-ecb"` = `'sm4-ecb'`
 
-Defined in: [lib/crypto.ts:153](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L153)
+Defined in: [lib/crypto.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/crypto.ts#L154)
 
 SM4 如果未设置 iv，则默认这个
 
@@ -9874,13 +9874,13 @@ Defined in: [lib/net/formdata.ts:22](https://github.com/maiyunnet/kebab/blob/mas
 
 ### Constructor
 
-> **new FormData**(`opts?`): `FormData`
+> **new FormData**(`options?`): `FormData`
 
-Defined in: node\_modules/@types/node/stream.d.ts:163
+Defined in: node\_modules/@types/node/stream.d.ts:98
 
 #### Parameters
 
-##### opts?
+##### options?
 
 `ReadableOptions`\<`Readable`\>
 
@@ -20703,7 +20703,7 @@ Defined in: [sys/mod.ts:68](https://github.com/maiyunnet/kebab/blob/master/sys/m
 
 > `protected` **\_keyGenerator**(): `string`
 
-Defined in: [sys/mod.ts:1752](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1752)
+Defined in: [sys/mod.ts:1758](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1758)
 
 当 _key 不为空时，则依据继承此方法的方法自动生成填充 key
 
@@ -20725,7 +20725,7 @@ Defined in: [sys/mod.ts:1752](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(): `Promise`\<`false` \| [`Rows`](Rows.md)\<`Mod`\>\>
 
-Defined in: [sys/mod.ts:1119](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1119)
+Defined in: [sys/mod.ts:1125](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1125)
 
 ##### Returns
 
@@ -20735,7 +20735,7 @@ Defined in: [sys/mod.ts:1119](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Mod`\>\>
 
-Defined in: [sys/mod.ts:1120](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1120)
+Defined in: [sys/mod.ts:1126](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1126)
 
 ##### Parameters
 
@@ -20761,7 +20761,7 @@ Defined in: [sys/mod.ts:1120](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(): `Promise`\<`false` \| `Record`\<`string`, `any`\>[]\>
 
-Defined in: [sys/mod.ts:1294](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1294)
+Defined in: [sys/mod.ts:1300](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1300)
 
 ##### Returns
 
@@ -20771,7 +20771,7 @@ Defined in: [sys/mod.ts:1294](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Record`\<`string`, `any`\>\>\>
 
-Defined in: [sys/mod.ts:1295](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1295)
+Defined in: [sys/mod.ts:1301](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1301)
 
 ##### Parameters
 
@@ -20789,7 +20789,7 @@ Defined in: [sys/mod.ts:1295](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **append**(`sql`): `this`
 
-Defined in: [sys/mod.ts:1661](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1661)
+Defined in: [sys/mod.ts:1667](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1667)
 
 在 sql 最后追加字符串
 
@@ -20809,7 +20809,7 @@ Defined in: [sys/mod.ts:1661](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **by**(`c`, `d`): `this`
 
-Defined in: [sys/mod.ts:1617](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1617)
+Defined in: [sys/mod.ts:1623](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1623)
 
 ORDER BY
 
@@ -20837,7 +20837,7 @@ ORDER BY
 
 > **contain**(`contain`): `this`
 
-Defined in: [sys/mod.ts:1670](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1670)
+Defined in: [sys/mod.ts:1676](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1676)
 
 设置闭包含数据
 
@@ -20865,7 +20865,7 @@ Defined in: [sys/mod.ts:1670](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **count**(): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1483](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1483)
+Defined in: [sys/mod.ts:1489](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1489)
 
 根据当前条件，筛选出当前条目该有的数据条数
 
@@ -20879,7 +20879,7 @@ Defined in: [sys/mod.ts:1483](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **countSql**(): `string`
 
-Defined in: [sys/mod.ts:1503](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1503)
+Defined in: [sys/mod.ts:1509](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1509)
 
 获取当前条件下的 count 的 SQL 语句
 
@@ -20909,7 +20909,7 @@ true-成功,false-报错,null-唯一键非 _$key 键冲突
 
 > **crossJoin**(`f`, `s`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1577](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1577)
+Defined in: [sys/mod.ts:1583](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1583)
 
 cross join 方法
 
@@ -20957,7 +20957,7 @@ ON 信息
 
 > **explain**(`all?`): `Promise`\<`string` \| `false`\>
 
-Defined in: [sys/mod.ts:1416](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1416)
+Defined in: [sys/mod.ts:1422](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1422)
 
 ##### Parameters
 
@@ -20973,7 +20973,7 @@ Defined in: [sys/mod.ts:1416](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **explain**(`all`): `Promise`\<`false` \| `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:1417](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1417)
+Defined in: [sys/mod.ts:1423](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1423)
 
 ##### Parameters
 
@@ -20991,7 +20991,7 @@ Defined in: [sys/mod.ts:1417](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **filter**(`s`): `this`
 
-Defined in: [sys/mod.ts:1595](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1595)
+Defined in: [sys/mod.ts:1601](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1601)
 
 筛选器
 
@@ -21025,7 +21025,7 @@ Defined in: [sys/mod.ts:1595](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock`, `array`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1008](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1008)
+Defined in: [sys/mod.ts:1014](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1014)
 
 ##### Parameters
 
@@ -21045,7 +21045,7 @@ Defined in: [sys/mod.ts:1008](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock?`, `array?`): `Promise`\<`false` \| `Mod` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1012](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1012)
+Defined in: [sys/mod.ts:1018](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1018)
 
 ##### Parameters
 
@@ -21067,7 +21067,7 @@ Defined in: [sys/mod.ts:1012](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **firstArray**(`lock`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1052](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1052)
+Defined in: [sys/mod.ts:1058](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1058)
 
 获取数据库第一个原生对象
 
@@ -21089,7 +21089,7 @@ Defined in: [sys/mod.ts:1052](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [sys/mod.ts:1697](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1697)
+Defined in: [sys/mod.ts:1703](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1703)
 
 获取带 data 的 sql 语句
 
@@ -21117,7 +21117,7 @@ sql 语句
 
 > **fullJoin**(`f`, `s`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1565](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1565)
+Defined in: [sys/mod.ts:1571](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1571)
 
 full join 方法
 
@@ -21179,7 +21179,7 @@ Defined in: [sys/mod.ts:811](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **getData**(): `any`[]
 
-Defined in: [sys/mod.ts:1688](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1688)
+Defined in: [sys/mod.ts:1694](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1694)
 
 获取全部 data
 
@@ -21193,7 +21193,7 @@ Defined in: [sys/mod.ts:1688](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getSql**(): `string`
 
-Defined in: [sys/mod.ts:1681](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1681)
+Defined in: [sys/mod.ts:1687](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1687)
 
 获取 sql 语句
 
@@ -21207,7 +21207,7 @@ Defined in: [sys/mod.ts:1681](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **group**(`c`): `this`
 
-Defined in: [sys/mod.ts:1626](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1626)
+Defined in: [sys/mod.ts:1632](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1632)
 
 GROUP BY
 
@@ -21229,7 +21229,7 @@ GROUP BY
 
 > **having**(`s`): `this`
 
-Defined in: [sys/mod.ts:1586](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1586)
+Defined in: [sys/mod.ts:1592](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1592)
 
 筛选器
 
@@ -21251,7 +21251,7 @@ Defined in: [sys/mod.ts:1586](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **innerJoin**(`f`, `s`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1553](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1553)
+Defined in: [sys/mod.ts:1559](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1559)
 
 inner join 方法
 
@@ -21291,7 +21291,7 @@ ON 信息
 
 > **join**(`f`, `s`, `type`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1517](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1517)
+Defined in: [sys/mod.ts:1523](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1523)
 
 #### Parameters
 
@@ -21335,7 +21335,7 @@ ON 信息
 
 > **langText**(`col`, `lang`): `string`
 
-Defined in: [sys/mod.ts:1732](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1732)
+Defined in: [sys/mod.ts:1738](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1738)
 
 获取字段的可用语种文本
 
@@ -21363,7 +21363,7 @@ Defined in: [sys/mod.ts:1732](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **leftJoin**(`f`, `s`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1529](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1529)
+Defined in: [sys/mod.ts:1535](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1535)
 
 left join 方法
 
@@ -21403,7 +21403,7 @@ ON 信息
 
 > **limit**(`a`, `b`): `this`
 
-Defined in: [sys/mod.ts:1639](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1639)
+Defined in: [sys/mod.ts:1645](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1645)
 
 LIMIT
 
@@ -21431,7 +21431,7 @@ LIMIT
 
 > **page**(`count`, `page`): `this`
 
-Defined in: [sys/mod.ts:1650](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1650)
+Defined in: [sys/mod.ts:1656](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1656)
 
 分页
 
@@ -21459,7 +21459,7 @@ Defined in: [sys/mod.ts:1650](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **refresh**(`lock`): `Promise`\<`boolean` \| `null`\>
 
-Defined in: [sys/mod.ts:933](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L933)
+Defined in: [sys/mod.ts:939](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L939)
 
 刷新当前模型获取最新数据
 
@@ -21481,7 +21481,7 @@ Defined in: [sys/mod.ts:933](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **remove**(): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:990](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L990)
+Defined in: [sys/mod.ts:996](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L996)
 
 移除本条目
 
@@ -21495,7 +21495,7 @@ Defined in: [sys/mod.ts:990](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **rightJoin**(`f`, `s`, `index`, `pre`): `this`
 
-Defined in: [sys/mod.ts:1541](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1541)
+Defined in: [sys/mod.ts:1547](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1547)
 
 right join 方法
 
@@ -21535,7 +21535,7 @@ ON 信息
 
 > **save**(`where?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:961](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L961)
+Defined in: [sys/mod.ts:967](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L967)
 
 更新 set 的数据到数据库，有未保存数据时才保存
 
@@ -21627,7 +21627,7 @@ Defined in: [sys/mod.ts:773](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:1704](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1704)
+Defined in: [sys/mod.ts:1710](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1710)
 
 获取值对象，获取的是新创建的数组
 
@@ -21647,7 +21647,7 @@ Defined in: [sys/mod.ts:1704](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **total**(`f`): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1459](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1459)
+Defined in: [sys/mod.ts:1465](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1465)
 
 获取总条数，自动抛弃 LIMIT，仅用于获取数据的情况（select）
 
@@ -21667,7 +21667,7 @@ Defined in: [sys/mod.ts:1459](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **union**(`f`, `type`): `this`
 
-Defined in: [sys/mod.ts:1063](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1063)
+Defined in: [sys/mod.ts:1069](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1069)
 
 联合查询表数据
 
@@ -21695,7 +21695,7 @@ Defined in: [sys/mod.ts:1063](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unionAll**(`f`): `this`
 
-Defined in: [sys/mod.ts:1093](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1093)
+Defined in: [sys/mod.ts:1099](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1099)
 
 所有联合查询表数据
 
@@ -21717,7 +21717,7 @@ Defined in: [sys/mod.ts:1093](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unsaved**(): `boolean`
 
-Defined in: [sys/mod.ts:1723](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1723)
+Defined in: [sys/mod.ts:1729](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1729)
 
 当前是否设置了未保存 --=
 
@@ -21731,7 +21731,7 @@ Defined in: [sys/mod.ts:1723](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **updates**(): `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:1712](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1712)
+Defined in: [sys/mod.ts:1718](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1718)
 
 获取当前设置要提交的数据
 
@@ -21745,7 +21745,7 @@ Defined in: [sys/mod.ts:1712](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **upsert**(`conflict`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:903](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L903)
+Defined in: [sys/mod.ts:909](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L909)
 
 插入数据，如果存在则更新（UPSERT）
 
@@ -21767,7 +21767,7 @@ Defined in: [sys/mod.ts:903](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **where**(`s`): `this`
 
-Defined in: [sys/mod.ts:1606](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1606)
+Defined in: [sys/mod.ts:1612](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1612)
 
 是 filter 的别名
 
@@ -22870,7 +22870,7 @@ sys/mod/interfaces/IModUnionItem.md
 
 # Interface: IModUnionItem
 
-Defined in: [sys/mod.ts:1766](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1766)
+Defined in: [sys/mod.ts:1772](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1772)
 
 ## Properties
 
@@ -22878,7 +22878,7 @@ Defined in: [sys/mod.ts:1766](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **field**: `string`
 
-Defined in: [sys/mod.ts:1767](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1767)
+Defined in: [sys/mod.ts:1773](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1773)
 
 ***
 
@@ -22886,7 +22886,7 @@ Defined in: [sys/mod.ts:1767](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `optional` **where**: `any`
 
-Defined in: [sys/mod.ts:1768](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1768)
+Defined in: [sys/mod.ts:1774](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1774)
 
 sys/mod/interfaces/IRows.md
 ---
@@ -22899,7 +22899,7 @@ sys/mod/interfaces/IRows.md
 
 # Interface: IRows\<T\>
 
-Defined in: [sys/mod.ts:1760](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1760)
+Defined in: [sys/mod.ts:1766](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1766)
 
 ## Extends
 
@@ -22917,7 +22917,7 @@ Defined in: [sys/mod.ts:1760](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `readonly` **length**: `number`
 
-Defined in: [sys/mod.ts:1761](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1761)
+Defined in: [sys/mod.ts:1767](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1767)
 
 ## Methods
 
@@ -22925,7 +22925,7 @@ Defined in: [sys/mod.ts:1761](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **item**(`index`): `T`
 
-Defined in: [sys/mod.ts:1762](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1762)
+Defined in: [sys/mod.ts:1768](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1768)
 
 #### Parameters
 
@@ -22943,7 +22943,7 @@ Defined in: [sys/mod.ts:1762](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **toArray**(): `Record`\<`string`, `any`\>[]
 
-Defined in: [sys/mod.ts:1763](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1763)
+Defined in: [sys/mod.ts:1769](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1769)
 
 #### Returns
 

package/index.d.ts

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

package/index.js

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

package/lib/crypto.js

@@ -31,6 +31,7 @@ export function generateKeyPair(type, options = {}) {
         };
         options.privateKeyEncoding.type ??= 'pkcs8';
         options.privateKeyEncoding.format ??= 'pem';
+        /** --- 由于 generateKeyPair 重载过多且 options 为 any，此处参数也采用 any --- */
         crypto.generateKeyPair(type, options, (err, publicKey, privateKey) => {
             resolve({
                 'private': privateKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "7.7.0",
+  "version": "7.7.1",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -22,30 +22,30 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.943.0",
-    "@aws-sdk/lib-storage": "^3.943.0",
+    "@aws-sdk/client-s3": "^3.971.0",
+    "@aws-sdk/lib-storage": "^3.971.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.1.0",
     "@litert/websocket": "^0.2.8",
     "@types/ssh2": "^1.15.5",
-    "@zilliz/milvus2-sdk-node": "^2.6.5",
-    "ejs": "^3.1.10",
+    "@zilliz/milvus2-sdk-node": "^2.6.9",
+    "ejs": "^4.0.1",
     "jszip": "^3.10.1",
-    "mysql2": "^3.15.3",
+    "mysql2": "^3.16.1",
     "node-cron": "^4.2.1",
-    "openai": "^6.10.0",
-    "pg": "^8.16.3",
+    "openai": "^6.16.0",
+    "pg": "^8.17.1",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.153"
+    "tencentcloud-sdk-nodejs": "^4.1.172"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^24.10.1",
-    "@types/pg": "^8.15.6",
-    "typedoc": "^0.28.15",
+    "@types/node": "^25.0.9",
+    "@types/pg": "^8.16.0",
+    "typedoc": "^0.28.16",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3"
   }

package/sys/master.js

@@ -3,8 +3,8 @@
  * Date: 2019-5-2 21:03:42
  * Last: 2020-3-7 10:33:17, 2022-07-22 13:40:10, 2022-09-06 22:40:58, 2024-2-7 01:44:59, 2024-7-2 15:17:09, 2025-6-13 13:06:43, 2025-12-5 13:15:03
  */
+import cluster from 'cluster';
 import * as os from 'os';
-import * as cluster from 'cluster';
 import * as http from 'http';
 // --- 库和定义 ---
 import * as kebab from '#kebab/index.js';
@@ -22,7 +22,7 @@ const workerList = {};
  */
 async function run() {
     // --- 设置 cluster 调度策略为 round-robin（在支持的平台上启用负载均衡） ---
-    cluster.default.schedulingPolicy = cluster.default.SCHED_RR;
+    cluster.schedulingPolicy = cluster.SCHED_RR;
     // --- 读取配置文件 ---
     const configContent = await lFs.getContent(kebab.CONF_CWD + 'config.json', 'utf8');
     if (!configContent) {
@@ -48,7 +48,7 @@ async function run() {
     for (let i = 0; i < cpuLengthMax; ++i) {
         await createChildProcess(i);
     }
-    cluster.default.on('listening', function (worker, address) {
+    cluster.on('listening', function (worker, address) {
         // --- 子进程开始监听 ---
         lCore.display(`[master] Listening: worker ${worker.process.pid ?? 'undefined'}, Address: ${address.address}:${address.port}.`);
     }).on('exit', function (worker, code) {
@@ -419,7 +419,7 @@ async function checkWorkerLost() {
  * @param cpu CPU ID
  */
 async function createChildProcess(cpu) {
-    const worker = cluster.default.fork();
+    const worker = cluster.fork();
     if (!worker.process.pid) {
         return;
     }

package/sys/mod.js

@@ -615,8 +615,11 @@ export default class Mod {
                 }
                 // --- 未处理的错误 ---
                 const service = this._db.getService();
-                lCore.debug('[MOD][create0][' + cstr._$table + ']', service !== null ? lDb.ESERVICE[service] : 'NONE', r);
                 lCore.log(this._ctr ?? {}, '[MOD][create0][' + cstr._$table + '] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
+                if (lCore.globalConfig.debug) {
+                    lCore.debug('[MOD][create0][' + cstr._$table + ']', service !== null ? lDb.ESERVICE[service] : 'NONE', r);
+                    lCore.debug(this._sql.format());
+                }
                 return false;
             }
         }
@@ -626,8 +629,11 @@ export default class Mod {
             r = await this._db.execute(this._sql.getSql(), this._sql.getData());
             if (r.error) {
                 if (r.error.errno !== 1062) {
-                    lCore.debug('[MOD][create1][' + cstr._$table + ']', r);
                     lCore.log(this._ctr ?? {}, '[MOD][create1][' + cstr._$table + '] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
+                    if (lCore.globalConfig.debug) {
+                        lCore.debug('[MOD][create1][' + cstr._$table + ']', r);
+                        lCore.debug(this._sql.format());
+                    }
                     return false;
                 }
                 return null;

package/www/example/ctr/agent.d.ts

@@ -0,0 +1,8 @@
+import * as sCtr from '#kebab/sys/ctr.js';
+export default class extends sCtr.Ctr {
+    /**
+     * --- Agent 示例接口 ---
+     * --- 访问：/agent?q=上海天气怎么样？ ---
+     */
+    index(): Promise<string>;
+}

package/www/example/ctr/agent.js

@@ -0,0 +1,68 @@
+import * as sCtr from '#kebab/sys/ctr.js';
+import * as lAi from '#kebab/lib/ai.js';
+import * as lFs from '#kebab/lib/fs.js';
+import * as lText from '#kebab/lib/text.js';
+/** --- Skill 导入 --- */
+import sWeather from '../skill/weather.js';
+export default class extends sCtr.Ctr {
+    /**
+     * --- Agent 示例接口 ---
+     * --- 访问：/agent?q=上海天气怎么样？ ---
+     */
+    async index() {
+        // --- 1. 获取用户问题 ---
+        const userPrompt = this._get['q'] ?? '你好';
+        // --- 2. 加载系统提示词 ---
+        const systemPrompt = await lFs.getContent(`${this._config.const.rootPath}www/example/prompt/agent.txt`, 'utf8') ?? '';
+        // --- 3. 初始化 AI ---
+        const ai = lAi.get(this, {
+            'service': lAi.ESERVICE.ALICN,
+        });
+        // --- 4. 准备消息 ---
+        const messages = [
+            { 'role': 'system', 'content': systemPrompt },
+            { 'role': 'user', 'content': userPrompt },
+        ];
+        // --- 5. 第一次对话，传入 Skills 定义 ---
+        const res = await ai.chat({
+            'model': 'qwen-plus',
+            'messages': messages,
+            'tools': [sWeather.definition],
+        });
+        if (!res) {
+            return '系统错误';
+        }
+        const message = res.choices[0].message;
+        // --- 6. 如果 AI 决定调用工具 ---
+        if (message.tool_calls && message.tool_calls.length > 0) {
+            messages.push(message);
+            for (const toolCall of message.tool_calls) {
+                if (toolCall.function.name === 'get_weather') {
+                    // --- 解析参数并执行 ---
+                    const args = lText.parseJson(toolCall.function.arguments);
+                    if (args === false) {
+                        continue;
+                    }
+                    const result = await sWeather.execute(args);
+                    // --- 将结果反馈给消息流 ---
+                    messages.push({
+                        'role': 'tool',
+                        'tool_call_id': toolCall.id,
+                        'name': 'get_weather',
+                        'content': result,
+                    });
+                }
+            }
+            // --- 7. 第二次对话，获取最终文本回复 ---
+            const finalRes = await ai.chat({
+                'model': 'qwen-plus',
+                'messages': messages,
+            });
+            if (finalRes) {
+                return finalRes.choices[0].message.content ?? '未能生成回复';
+            }
+        }
+        // --- 如果不需要工具调用，直接返回内容 ---
+        return message.content ?? '未能生成回复';
+    }
+}

package/www/example/skill/weather.d.ts

@@ -0,0 +1,15 @@
+import type * as openai from 'openai';
+/**
+ * --- 获取天气预报的 Skill ---
+ */
+export default class {
+    /** --- Skill 的定义，供 AI 模型识别 --- */
+    static definition: openai.default.Chat.ChatCompletionTool;
+    /**
+     * --- 执行获取天气的逻辑 ---
+     * @param args AI 传过来的参数
+     */
+    static execute(args: {
+        'city': string;
+    }): Promise<string>;
+}

package/www/example/skill/weather.js

@@ -0,0 +1,36 @@
+/**
+ * --- 获取天气预报的 Skill ---
+ */
+export default class default_1 {
+    /** --- Skill 的定义，供 AI 模型识别 --- */
+    static definition = {
+        'type': 'function',
+        'function': {
+            'name': 'get_weather',
+            'description': '获取指定城市的天气信息',
+            'parameters': {
+                'type': 'object',
+                'properties': {
+                    'city': {
+                        'type': 'string',
+                        'description': '城市名称，例如“上海”、“北京”',
+                    },
+                },
+                'required': ['city'],
+            },
+        },
+    };
+    /**
+     * --- 执行获取天气的逻辑 ---
+     * @param args AI 传过来的参数
+     */
+    static async execute(args) {
+        // --- 这里是模拟获取天气的逻辑，实际开发中可以调用第三方 API ---
+        const weathers = {
+            '上海': '晴朗，25℃',
+            '北京': '多云，20℃',
+            '广州': '阵雨，28℃',
+        };
+        return weathers[args.city] ?? `抱歉，暂不支持查询 ${args.city} 的天气。`;
+    }
+}