@maiyunnet/kebab 9.10.1 → 9.11.1

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.10.1"` = `'9.10.1'`
+> `const` **VER**: `"9.11.1"` = `'9.11.1'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -1407,7 +1407,7 @@ lib/ai/classes/Ai.md
 
 # Class: Ai
 
-Defined in: [lib/ai.ts:60](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L60)
+Defined in: [lib/ai.ts:67](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L67)
 
 ## Constructors
 
@@ -1415,7 +1415,7 @@ Defined in: [lib/ai.ts:60](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **new Ai**(`ctrEtc`, `opt`): `Ai`
 
-Defined in: [lib/ai.ts:73](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L73)
+Defined in: [lib/ai.ts:80](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L80)
 
 #### Parameters
 
@@ -1437,7 +1437,7 @@ Defined in: [lib/ai.ts:73](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `readonly` **link**: `OpenAI`
 
-Defined in: [lib/ai.ts:63](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L63)
+Defined in: [lib/ai.ts:70](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L70)
 
 openai 原生对象
 
@@ -1449,7 +1449,7 @@ openai 原生对象
 
 > **get** **service**(): [`ESERVICE`](../enumerations/ESERVICE.md)
 
-Defined in: [lib/ai.ts:149](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L149)
+Defined in: [lib/ai.ts:164](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L164)
 
 获取当前服务商
 
@@ -1467,7 +1467,7 @@ Defined in: [lib/ai.ts:149](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`ChatCompletion`\>\>
 
-Defined in: [lib/ai.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L154)
+Defined in: [lib/ai.ts:169](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L169)
 
 创建非流式对话
 
@@ -1485,7 +1485,7 @@ Defined in: [lib/ai.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`Stream`\<`ChatCompletionChunk`\>\>\>
 
-Defined in: [lib/ai.ts:158](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L158)
+Defined in: [lib/ai.ts:173](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L173)
 
 创建流式对话
 
@@ -1505,7 +1505,7 @@ Defined in: [lib/ai.ts:158](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **embedding**(`body`): `Promise`\<`false` \| `APIPromise`\<`CreateEmbeddingResponse`\>\>
 
-Defined in: [lib/ai.ts:181](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L181)
+Defined in: [lib/ai.ts:222](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L222)
 
 创建向量
 
@@ -1525,7 +1525,7 @@ Defined in: [lib/ai.ts:181](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **image**(`opt`): `Promise`\<`false` \| \{ `list`: `object`[]; `request`: `string`; `seed`: `number`; \}\>
 
-Defined in: [lib/ai.ts:197](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L197)
+Defined in: [lib/ai.ts:238](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L238)
 
 生成图像，不支持 GEMINI、GROK 服务商
 
@@ -1587,7 +1587,7 @@ Defined in: [lib/ai.ts:197](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **poll**(`opt`): `Promise`\<`false` \| \{ `add?`: `number`; `end?`: `number`; `error?`: `string`; `start?`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; `url?`: `string`; \}\>
 
-Defined in: [lib/ai.ts:546](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L546)
+Defined in: [lib/ai.ts:599](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L599)
 
 轮询任务
 
@@ -1609,11 +1609,53 @@ Defined in: [lib/ai.ts:546](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 ***
 
+### response()
+
+创建 Response
+
+#### Call Signature
+
+> **response**(`body`): `Promise`\<`false` \| `APIPromise`\<`Response`\>\>
+
+Defined in: [lib/ai.ts:196](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L196)
+
+创建非流式 Response
+
+##### Parameters
+
+###### body
+
+`ResponseCreateParamsNonStreaming`
+
+##### Returns
+
+`Promise`\<`false` \| `APIPromise`\<`Response`\>\>
+
+#### Call Signature
+
+> **response**(`body`): `Promise`\<`false` \| `APIPromise`\<`Stream`\<`ResponseStreamEvent`\>\>\>
+
+Defined in: [lib/ai.ts:200](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L200)
+
+创建流式 Response
+
+##### Parameters
+
+###### body
+
+`ResponseCreateParamsStreaming`
+
+##### Returns
+
+`Promise`\<`false` \| `APIPromise`\<`Stream`\<`ResponseStreamEvent`\>\>\>
+
+***
+
 ### video()
 
 > **video**(`opt`): `Promise`\<`false` \| \{ `request`: `string`; `seed`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; \}\>
 
-Defined in: [lib/ai.ts:378](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L378)
+Defined in: [lib/ai.ts:428](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L428)
 
 异步生成视频，仅支持 ALICN、ALIAS、ALINE
 
@@ -1790,6 +1832,26 @@ Grok
 
 ***
 
+### OFOX
+
+> **OFOX**: `11`
+
+Defined in: [lib/ai.ts:46](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L46)
+
+OfoxAI
+
+***
+
+### OPENROUTER
+
+> **OPENROUTER**: `10`
+
+Defined in: [lib/ai.ts:44](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L44)
+
+OpenRouter
+
+***
+
 ### VOLAS
 
 > **VOLAS**: `9`
@@ -1821,7 +1883,7 @@ lib/ai/functions/get.md
 
 > **get**(`ctrEtc`, `opt`): [`Ai`](../classes/Ai.md)
 
-Defined in: [lib/ai.ts:601](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L601)
+Defined in: [lib/ai.ts:657](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L657)
 
 创建一个 AI 对象
 
@@ -1879,7 +1941,7 @@ lib/ai/interfaces/IOptions.md
 
 # Interface: IOptions
 
-Defined in: [lib/ai.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L43)
+Defined in: [lib/ai.ts:50](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L50)
 
 选项
 
@@ -1889,7 +1951,7 @@ Defined in: [lib/ai.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **endpoint?**: `string`
 
-Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L47)
+Defined in: [lib/ai.ts:54](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L54)
 
 接入点
 
@@ -1899,7 +1961,7 @@ Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **fetch?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [lib/ai.ts:51](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L51)
+Defined in: [lib/ai.ts:58](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L58)
 
 自定义 fetch 函数
 
@@ -1923,7 +1985,7 @@ Defined in: [lib/ai.ts:51](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **secretKey?**: `string`
 
-Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L49)
+Defined in: [lib/ai.ts:56](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L56)
 
 密钥
 
@@ -1933,7 +1995,7 @@ Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **service**: [`ESERVICE`](../enumerations/ESERVICE.md)
 
-Defined in: [lib/ai.ts:45](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L45)
+Defined in: [lib/ai.ts:52](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L52)
 
 服务商 -
 
@@ -3258,7 +3320,7 @@ lib/core/functions/clone.md
 
 > **clone**\<`T`\>(`obj`): `T`
 
-Defined in: [lib/core.ts:1162](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1162)
+Defined in: [lib/core.ts:1164](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1164)
 
 完整的克隆一份数组/对象
 
@@ -3322,7 +3384,7 @@ lib/core/functions/debug.md
 
 > **debug**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1196](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1196)
+Defined in: [lib/core.ts:1198](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1198)
 
 打印调试信息，线上环境不会打印
 
@@ -3357,7 +3419,7 @@ lib/core/functions/display.md
 
 > **display**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1209](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1209)
+Defined in: [lib/core.ts:1211](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1211)
 
 向控制台直接显示内容，一般情况下禁止使用
 
@@ -3462,7 +3524,7 @@ lib/core/functions/getLog.md
 
 > **getLog**(`opt`): `Promise`\<`false` \| \{ `list`: `any`[] \| `string`[][]; `total`: `number`; \}\>
 
-Defined in: [lib/core.ts:1074](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1074)
+Defined in: [lib/core.ts:1076](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1076)
 
 获取日志内容为一个数组
 
@@ -3597,7 +3659,7 @@ lib/core/functions/loadEnv.md
 
 > **loadEnv**(`dir`): `Promise`\<`void`\>
 
-Defined in: [lib/core.ts:1261](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1261)
+Defined in: [lib/core.ts:1263](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1263)
 
 加载 .env 文件到 process.env，若文件不存在则跳过
 
@@ -3667,7 +3729,7 @@ lib/core/functions/ls.md
 
 > **ls**(`opt`): `Promise`\<`object`[]\>
 
-Defined in: [lib/core.ts:1123](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1123)
+Defined in: [lib/core.ts:1125](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1125)
 
 获取目录内文件/文件夹列表
 
@@ -4028,7 +4090,7 @@ lib/core/functions/resolveEnvVars.md
 
 > **resolveEnvVars**(`obj`): `void`
 
-Defined in: [lib/core.ts:1291](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1291)
+Defined in: [lib/core.ts:1293](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1293)
 
 将配置对象中的 ${ENV_VAR} 占位符替换为 process.env 的值
 
@@ -4470,7 +4532,7 @@ lib/core/functions/writeEventStreamHead.md
 
 > **writeEventStreamHead**(`res`): `void`
 
-Defined in: [lib/core.ts:1231](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1231)
+Defined in: [lib/core.ts:1233](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1233)
 
 ## Parameters
 
@@ -4495,7 +4557,7 @@ lib/core/functions/writeHead.md
 
 > **writeHead**(`res`, `statusCode`, `headers?`): `void`
 
-Defined in: [lib/core.ts:1220](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1220)
+Defined in: [lib/core.ts:1222](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1222)
 
 让 res 发送头部（前提是头部没有被发送才能调用本方法
 
@@ -4536,7 +4598,7 @@ lib/core/functions/write.md
 
 > **write**(`res`, `data`): `void`
 
-Defined in: [lib/core.ts:1243](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1243)
+Defined in: [lib/core.ts:1245](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1245)
 
 向 res 发送数据
 
@@ -19204,7 +19266,7 @@ lib/undici/response/classes/Response.md
 
 # Class: Response
 
-Defined in: [lib/undici/response.ts:12](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L12)
+Defined in: [lib/undici/response.ts:13](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L13)
 
 ## Constructors
 
@@ -19212,7 +19274,7 @@ Defined in: [lib/undici/response.ts:12](https://github.com/maiyunnet/kebab/blob/
 
 > **new Response**(`req`): `Response`
 
-Defined in: [lib/undici/response.ts:25](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L25)
+Defined in: [lib/undici/response.ts:26](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L26)
 
 #### Parameters
 
@@ -19230,7 +19292,7 @@ Defined in: [lib/undici/response.ts:25](https://github.com/maiyunnet/kebab/blob/
 
 > **error**: `Error` \| `null` = `null`
 
-Defined in: [lib/undici/response.ts:20](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L20)
+Defined in: [lib/undici/response.ts:21](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L21)
 
 ***
 
@@ -19238,7 +19300,7 @@ Defined in: [lib/undici/response.ts:20](https://github.com/maiyunnet/kebab/blob/
 
 > **headers**: [`THttpHeaders`](../../type-aliases/THttpHeaders.md) \| `null` = `null`
 
-Defined in: [lib/undici/response.ts:18](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L18)
+Defined in: [lib/undici/response.ts:19](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L19)
 
 返回的 headers
 
@@ -19248,7 +19310,7 @@ Defined in: [lib/undici/response.ts:18](https://github.com/maiyunnet/kebab/blob/
 
 > **getContent**(): `Promise`\<`Buffer`\<`ArrayBufferLike`\> \| `null`\>
 
-Defined in: [lib/undici/response.ts:32](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L32)
+Defined in: [lib/undici/response.ts:33](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L33)
 
 读取所有内容到内存
 
@@ -19262,7 +19324,7 @@ Defined in: [lib/undici/response.ts:32](https://github.com/maiyunnet/kebab/blob/
 
 > **getJson**(): `Promise`\<`any`\>
 
-Defined in: [lib/undici/response.ts:63](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L63)
+Defined in: [lib/undici/response.ts:66](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L66)
 
 读取所有内容为 JSON，失败返回 null
 
@@ -19276,7 +19338,7 @@ Defined in: [lib/undici/response.ts:63](https://github.com/maiyunnet/kebab/blob/
 
 > **getRawStream**(): `BodyReadable` & `BodyMixin` \| `null`
 
-Defined in: [lib/undici/response.ts:124](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L124)
+Defined in: [lib/undici/response.ts:128](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L128)
 
 获取原生响应读取流对象
 
@@ -19290,7 +19352,7 @@ Defined in: [lib/undici/response.ts:124](https://github.com/maiyunnet/kebab/blob
 
 > **getStream**(): `BrotliDecompress` \| `Gunzip` \| `Inflate` \| `BodyReadable` & `BodyMixin` \| `null`
 
-Defined in: [lib/undici/response.ts:88](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L88)
+Defined in: [lib/undici/response.ts:92](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L92)
 
 获取响应读取流对象
 
@@ -19304,7 +19366,7 @@ Defined in: [lib/undici/response.ts:88](https://github.com/maiyunnet/kebab/blob/
 
 > **getText**(): `Promise`\<`string` \| `null`\>
 
-Defined in: [lib/undici/response.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L49)
+Defined in: [lib/undici/response.ts:51](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L51)
 
 读取所有内容为文本
 
@@ -19318,7 +19380,7 @@ Defined in: [lib/undici/response.ts:49](https://github.com/maiyunnet/kebab/blob/
 
 > **setContent**(`v`): `void`
 
-Defined in: [lib/undici/response.ts:80](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L80)
+Defined in: [lib/undici/response.ts:84](https://github.com/maiyunnet/kebab/blob/master/lib/undici/response.ts#L84)
 
 用户自定义的 content 内容
 
@@ -19469,9 +19531,9 @@ Defined in: [lib/vector.ts:85](https://github.com/maiyunnet/kebab/blob/master/li
 
 ***
 
-### seach()
+### search()
 
-> **seach**(`data`): `Promise`\<`false` \| `object`[]\>
+> **search**(`data`): `Promise`\<`false` \| `object`[]\>
 
 Defined in: [lib/vector.ts:35](https://github.com/maiyunnet/kebab/blob/master/lib/vector.ts#L35)
 
@@ -23703,7 +23765,7 @@ Defined in: [sys/mod.ts:68](https://github.com/maiyunnet/kebab/blob/master/sys/m
 
 > `protected` **\_keyGenerator**(): `string`
 
-Defined in: [sys/mod.ts:1785](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1785)
+Defined in: [sys/mod.ts:1797](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1797)
 
 当 _key 不为空时，则依据继承此方法的方法自动生成填充 key
 
@@ -23725,7 +23787,7 @@ Defined in: [sys/mod.ts:1785](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(): `Promise`\<`false` \| [`Rows`](Rows.md)\<`Mod`\>\>
 
-Defined in: [sys/mod.ts:1127](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1127)
+Defined in: [sys/mod.ts:1139](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1139)
 
 ##### Returns
 
@@ -23735,7 +23797,7 @@ Defined in: [sys/mod.ts:1127](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **all**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Mod`\>\>
 
-Defined in: [sys/mod.ts:1128](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1128)
+Defined in: [sys/mod.ts:1140](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1140)
 
 ##### Parameters
 
@@ -23761,7 +23823,7 @@ Defined in: [sys/mod.ts:1128](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(): `Promise`\<`false` \| `Record`\<`string`, `any`\>[]\>
 
-Defined in: [sys/mod.ts:1306](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1306)
+Defined in: [sys/mod.ts:1318](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1318)
 
 ##### Returns
 
@@ -23771,7 +23833,7 @@ Defined in: [sys/mod.ts:1306](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **allArray**(`key`): `Promise`\<`false` \| `Record`\<`string`, `Record`\<`string`, `any`\>\>\>
 
-Defined in: [sys/mod.ts:1307](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1307)
+Defined in: [sys/mod.ts:1319](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1319)
 
 ##### Parameters
 
@@ -23789,7 +23851,7 @@ Defined in: [sys/mod.ts:1307](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **append**(`sql`): `this`
 
-Defined in: [sys/mod.ts:1694](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1694)
+Defined in: [sys/mod.ts:1706](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1706)
 
 在 sql 最后追加字符串
 
@@ -23809,7 +23871,7 @@ Defined in: [sys/mod.ts:1694](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **by**(`c`, `d?`): `this`
 
-Defined in: [sys/mod.ts:1650](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1650)
+Defined in: [sys/mod.ts:1662](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1662)
 
 ORDER BY
 
@@ -23837,7 +23899,7 @@ ORDER BY
 
 > **contain**(`contain`): `this`
 
-Defined in: [sys/mod.ts:1703](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1703)
+Defined in: [sys/mod.ts:1715](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1715)
 
 设置闭包含数据
 
@@ -23865,7 +23927,7 @@ Defined in: [sys/mod.ts:1703](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **count**(): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1514](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1514)
+Defined in: [sys/mod.ts:1526](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1526)
 
 根据当前条件，筛选出当前条目该有的数据条数
 
@@ -23879,7 +23941,7 @@ Defined in: [sys/mod.ts:1514](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **countSql**(): `string`
 
-Defined in: [sys/mod.ts:1535](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1535)
+Defined in: [sys/mod.ts:1547](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1547)
 
 获取当前条件下的 count 的 SQL 语句
 
@@ -23909,7 +23971,7 @@ true-成功,false-报错,null-唯一键非 _$key 键冲突
 
 > **crossJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1610](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1610)
+Defined in: [sys/mod.ts:1622](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1622)
 
 cross join 方法
 
@@ -23957,7 +24019,7 @@ ON 信息
 
 > **explain**(`all?`): `Promise`\<`string` \| `false`\>
 
-Defined in: [sys/mod.ts:1432](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1432)
+Defined in: [sys/mod.ts:1444](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1444)
 
 ##### Parameters
 
@@ -23973,7 +24035,7 @@ Defined in: [sys/mod.ts:1432](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **explain**(`all`): `Promise`\<`false` \| `Record`\<`string`, `any`\>\>
 
-Defined in: [sys/mod.ts:1433](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1433)
+Defined in: [sys/mod.ts:1445](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1445)
 
 ##### Parameters
 
@@ -23991,7 +24053,7 @@ Defined in: [sys/mod.ts:1433](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **filter**(`s`): `this`
 
-Defined in: [sys/mod.ts:1628](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1628)
+Defined in: [sys/mod.ts:1640](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1640)
 
 筛选器
 
@@ -24025,7 +24087,7 @@ Defined in: [sys/mod.ts:1628](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock`, `array`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1016](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1016)
+Defined in: [sys/mod.ts:1028](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1028)
 
 ##### Parameters
 
@@ -24045,7 +24107,7 @@ Defined in: [sys/mod.ts:1016](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **first**(`lock?`, `array?`): `Promise`\<`false` \| `Mod` & `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1020](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1020)
+Defined in: [sys/mod.ts:1032](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1032)
 
 ##### Parameters
 
@@ -24067,7 +24129,7 @@ Defined in: [sys/mod.ts:1020](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **firstArray**(`lock?`): `Promise`\<`false` \| `Record`\<`string`, `any`\> \| `null`\>
 
-Defined in: [sys/mod.ts:1060](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1060)
+Defined in: [sys/mod.ts:1072](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1072)
 
 获取数据库第一个原生对象
 
@@ -24089,7 +24151,7 @@ Defined in: [sys/mod.ts:1060](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [sys/mod.ts:1730](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1730)
+Defined in: [sys/mod.ts:1742](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1742)
 
 获取带 data 的 sql 语句
 
@@ -24117,7 +24179,7 @@ sql 语句
 
 > **fullJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1598](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1598)
+Defined in: [sys/mod.ts:1610](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1610)
 
 full join 方法
 
@@ -24179,7 +24241,7 @@ Defined in: [sys/mod.ts:813](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **getData**(): `any`[]
 
-Defined in: [sys/mod.ts:1721](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1721)
+Defined in: [sys/mod.ts:1733](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1733)
 
 获取全部 data
 
@@ -24193,7 +24255,7 @@ Defined in: [sys/mod.ts:1721](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getSql**(): `string`
 
-Defined in: [sys/mod.ts:1714](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1714)
+Defined in: [sys/mod.ts:1726](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1726)
 
 获取 sql 语句
 
@@ -24207,7 +24269,7 @@ Defined in: [sys/mod.ts:1714](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **group**(`c`): `this`
 
-Defined in: [sys/mod.ts:1659](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1659)
+Defined in: [sys/mod.ts:1671](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1671)
 
 GROUP BY
 
@@ -24229,7 +24291,7 @@ GROUP BY
 
 > **having**(`s`): `this`
 
-Defined in: [sys/mod.ts:1619](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1619)
+Defined in: [sys/mod.ts:1631](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1631)
 
 筛选器
 
@@ -24251,7 +24313,7 @@ Defined in: [sys/mod.ts:1619](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **innerJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1586](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1586)
+Defined in: [sys/mod.ts:1598](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1598)
 
 inner join 方法
 
@@ -24291,7 +24353,7 @@ ON 信息
 
 > **join**(`f`, `s?`, `type?`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1550](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1550)
+Defined in: [sys/mod.ts:1562](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1562)
 
 #### Parameters
 
@@ -24335,7 +24397,7 @@ ON 信息
 
 > **langText**(`col`, `lang`): `string`
 
-Defined in: [sys/mod.ts:1765](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1765)
+Defined in: [sys/mod.ts:1777](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1777)
 
 获取字段的可用语种文本
 
@@ -24363,7 +24425,7 @@ Defined in: [sys/mod.ts:1765](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **leftJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1562](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1562)
+Defined in: [sys/mod.ts:1574](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1574)
 
 left join 方法
 
@@ -24403,7 +24465,7 @@ ON 信息
 
 > **limit**(`a`, `b?`): `this`
 
-Defined in: [sys/mod.ts:1672](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1672)
+Defined in: [sys/mod.ts:1684](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1684)
 
 LIMIT
 
@@ -24431,7 +24493,7 @@ LIMIT
 
 > **page**(`count`, `page?`): `this`
 
-Defined in: [sys/mod.ts:1683](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1683)
+Defined in: [sys/mod.ts:1695](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1695)
 
 分页
 
@@ -24481,7 +24543,7 @@ Defined in: [sys/mod.ts:941](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **remove**(): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:998](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L998)
+Defined in: [sys/mod.ts:1006](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1006)
 
 移除本条目
 
@@ -24495,7 +24557,7 @@ Defined in: [sys/mod.ts:998](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **rightJoin**(`f`, `s`, `index?`, `pre?`): `this`
 
-Defined in: [sys/mod.ts:1574](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1574)
+Defined in: [sys/mod.ts:1586](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1586)
 
 right join 方法
 
@@ -24535,7 +24597,7 @@ ON 信息
 
 > **save**(`where?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/mod.ts:969](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L969)
+Defined in: [sys/mod.ts:973](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L973)
 
 更新 set 的数据到数据库，有未保存数据时才保存
 
@@ -24627,7 +24689,7 @@ Defined in: [sys/mod.ts:775](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:1737](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1737)
+Defined in: [sys/mod.ts:1749](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1749)
 
 获取值对象，获取的是新创建的数组
 
@@ -24647,7 +24709,7 @@ Defined in: [sys/mod.ts:1737](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **total**(`f?`): `Promise`\<`number`\>
 
-Defined in: [sys/mod.ts:1490](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1490)
+Defined in: [sys/mod.ts:1502](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1502)
 
 获取总条数，自动抛弃 LIMIT，仅用于获取数据的情况（select）
 
@@ -24667,7 +24729,7 @@ Defined in: [sys/mod.ts:1490](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **union**(`f`, `type?`): `this`
 
-Defined in: [sys/mod.ts:1071](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1071)
+Defined in: [sys/mod.ts:1083](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1083)
 
 联合查询表数据
 
@@ -24695,7 +24757,7 @@ Defined in: [sys/mod.ts:1071](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unionAll**(`f`): `this`
 
-Defined in: [sys/mod.ts:1101](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1101)
+Defined in: [sys/mod.ts:1113](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1113)
 
 所有联合查询表数据
 
@@ -24717,7 +24779,7 @@ Defined in: [sys/mod.ts:1101](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **unsaved**(): `boolean`
 
-Defined in: [sys/mod.ts:1756](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1756)
+Defined in: [sys/mod.ts:1768](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1768)
 
 当前是否设置了未保存 --=
 
@@ -24731,7 +24793,7 @@ Defined in: [sys/mod.ts:1756](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **updates**(): `Record`\<`string`, `any`\>
 
-Defined in: [sys/mod.ts:1745](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1745)
+Defined in: [sys/mod.ts:1757](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1757)
 
 获取当前设置要提交的数据
 
@@ -24767,7 +24829,7 @@ Defined in: [sys/mod.ts:911](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **where**(`s`): `this`
 
-Defined in: [sys/mod.ts:1639](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1639)
+Defined in: [sys/mod.ts:1651](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1651)
 
 是 filter 的别名
 
@@ -25941,7 +26003,7 @@ sys/mod/interfaces/IModUnionItem.md
 
 # Interface: IModUnionItem
 
-Defined in: [sys/mod.ts:1799](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1799)
+Defined in: [sys/mod.ts:1811](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1811)
 
 ## Properties
 
@@ -25949,7 +26011,7 @@ Defined in: [sys/mod.ts:1799](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **field**: `string`
 
-Defined in: [sys/mod.ts:1800](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1800)
+Defined in: [sys/mod.ts:1812](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1812)
 
 ***
 
@@ -25957,7 +26019,7 @@ Defined in: [sys/mod.ts:1800](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `optional` **where?**: `any`
 
-Defined in: [sys/mod.ts:1801](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1801)
+Defined in: [sys/mod.ts:1813](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1813)
 
 sys/mod/interfaces/IRows.md
 ---
@@ -25970,7 +26032,7 @@ sys/mod/interfaces/IRows.md
 
 # Interface: IRows\<T\>
 
-Defined in: [sys/mod.ts:1793](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1793)
+Defined in: [sys/mod.ts:1805](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1805)
 
 ## Extends
 
@@ -25988,7 +26050,7 @@ Defined in: [sys/mod.ts:1793](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `readonly` **length**: `number`
 
-Defined in: [sys/mod.ts:1794](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1794)
+Defined in: [sys/mod.ts:1806](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1806)
 
 ## Methods
 
@@ -25996,7 +26058,7 @@ Defined in: [sys/mod.ts:1794](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **item**(`index`): `T`
 
-Defined in: [sys/mod.ts:1795](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1795)
+Defined in: [sys/mod.ts:1807](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1807)
 
 #### Parameters
 
@@ -26014,7 +26076,7 @@ Defined in: [sys/mod.ts:1795](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **toArray**(): `Record`\<`string`, `any`\>[]
 
-Defined in: [sys/mod.ts:1796](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1796)
+Defined in: [sys/mod.ts:1808](https://github.com/maiyunnet/kebab/blob/master/sys/mod.ts#L1808)
 
 #### Returns
 

package/index.d.ts

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

package/index.js

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

package/lib/ai.d.ts

@@ -32,7 +32,11 @@ export declare enum ESERVICE {
     /** --- 火山引擎中国大陆区 --- */
     'VOLCN' = 8,
     /** --- 火山引擎国际区 --- */
-    'VOLAS' = 9
+    'VOLAS' = 9,
+    /** --- OpenRouter --- */
+    'OPENROUTER' = 10,
+    /** --- OfoxAI --- */
+    'OFOX' = 11
 }
 /** --- 选项 --- */
 export interface IOptions {
@@ -59,6 +63,10 @@ export declare class Ai {
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Chat.ChatCompletion> | false>;
     /** --- 创建流式对话 --- */
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsStreaming): Promise<openai.APIPromise<streaming.Stream<openai.default.Chat.ChatCompletionChunk>> | false>;
+    /** --- 创建非流式 Response --- */
+    response(body: openai.default.Responses.ResponseCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Responses.Response> | false>;
+    /** --- 创建流式 Response --- */
+    response(body: openai.default.Responses.ResponseCreateParamsStreaming): Promise<openai.APIPromise<streaming.Stream<openai.default.Responses.ResponseStreamEvent>> | false>;
     /** --- 创建向量 --- */
     embedding(body: openai.default.EmbeddingCreateParams): Promise<openai.APIPromise<openai.default.CreateEmbeddingResponse> | false>;
     /** --- 生成图像，不支持 GEMINI、GROK 服务商 --- */

package/lib/ai.js

@@ -34,6 +34,11 @@ export var ESERVICE;
     ESERVICE[ESERVICE["VOLCN"] = 8] = "VOLCN";
     /** --- 火山引擎国际区 --- */
     ESERVICE[ESERVICE["VOLAS"] = 9] = "VOLAS";
+    // --- 以下为第三方服务商 ---
+    /** --- OpenRouter --- */
+    ESERVICE[ESERVICE["OPENROUTER"] = 10] = "OPENROUTER";
+    /** --- OfoxAI --- */
+    ESERVICE[ESERVICE["OFOX"] = 11] = "OFOX";
 })(ESERVICE || (ESERVICE = {}));
 /** --- openai 的连接对象 --- */
 const links = [];
@@ -94,6 +99,14 @@ export class Ai {
                 endpoint = opt.endpoint ?? `https://ark.ap-southeast.bytepluses.com/api/v3`;
                 break;
             }
+            case ESERVICE.OPENROUTER: {
+                endpoint = opt.endpoint ?? `https://openrouter.ai/api/v1`;
+                break;
+            }
+            case ESERVICE.OFOX: {
+                endpoint = opt.endpoint ?? `https://api.ofox.ai/v1`;
+                break;
+            }
             default: {
                 // --- ESERVICE.AZURE3 ---
                 endpoint = opt.endpoint ?? configAi.endpoint ?? '';
@@ -136,6 +149,19 @@ export class Ai {
             return false;
         }
     }
+    /** --- 创建 Response --- */
+    async response(body) {
+        try {
+            return await this.link.responses.create(body);
+        }
+        catch (e) {
+            if (!e.message.includes('Input data may contain inappropriate content')) {
+                lCore.debug('[AI][RESPONSE]', e);
+                lCore.log(this._ctr ?? {}, `[AI][RESPONSE] ${e.message}`, '-error');
+            }
+            return false;
+        }
+    }
     /** --- 创建向量 --- */
     async embedding(body) {
         try {
@@ -151,6 +177,9 @@ export class Ai {
     }
     /** --- 生成图像，不支持 GEMINI、GROK 服务商 --- */
     async image(opt) {
+        if (!this.link.apiKey) {
+            return false;
+        }
         const seed = opt.seed ?? lCore.rand(0, 2147483647);
         switch (this._service) {
             case ESERVICE.ALICN:
@@ -300,6 +329,12 @@ export class Ai {
                     return false;
                 }
             }
+            case ESERVICE.OPENROUTER: {
+                return false;
+            }
+            case ESERVICE.OFOX: {
+                return false;
+            }
         }
     }
     /** --- 异步生成视频，仅支持 ALICN、ALIAS、ALINE --- */
@@ -307,6 +342,9 @@ export class Ai {
         if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS && this._service !== ESERVICE.ALINE) {
             return false;
         }
+        if (!this.link.apiKey) {
+            return false;
+        }
         const mode = opt.mode ?? 'text';
         const imgs = opt.imgs ?? [];
         const resolution = opt.resolution ?? '720p';
@@ -442,6 +480,9 @@ export class Ai {
         if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS && this._service !== ESERVICE.ALINE) {
             return false;
         }
+        if (!this.link.apiKey) {
+            return false;
+        }
         try {
             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',

package/lib/core.js

@@ -858,7 +858,9 @@ export function log(opt, msg, fend = '') {
             'cf': '',
             'x': ''
         };
-        const [y, m, d, h] = lTime.format(null, 'Y-m-d-H').split('-');
+        /** --- 文件和内容统一使用同一时间点 --- */
+        const now = new Date();
+        const [y, m, d, h] = lTime.format(null, 'Y-m-d-H', now).split('-');
         let path = kebab.LOG_CWD + hostname + fend + '/' + y + '/' + m + '/' + d + '/';
         const rtn = await lFs.mkdir(path, 0o777);
         if (!rtn) {
@@ -869,8 +871,8 @@ export function log(opt, msg, fend = '') {
             // --- JSON Lines 格式 ---
             path += h + '.jsonl';
             const entry = lText.stringifyJson({
-                'time': lTime.format(null, 'H:i:s'),
-                'unix': lTime.stamp(),
+                'time': lTime.format(null, 'H:i:s', now),
+                'unix': lTime.stamp(now),
                 'url': urlFull + wpath + (Object.keys(get).length ? '?' + lText.queryStringify(get) : ''),
                 'cookie': cookie,
                 'session': session,
@@ -900,8 +902,8 @@ export function log(opt, msg, fend = '') {
                 }
             }
             await lFs.putContent(path, '"' +
-                lText.csvescape(lTime.format(null, 'H:i:s')) + '","' +
-                lText.csvescape(lTime.stamp().toString()) + '","' +
+                lText.csvescape(lTime.format(null, 'H:i:s', now)) + '","' +
+                lText.csvescape(lTime.stamp(now).toString()) + '","' +
                 lText.csvescape(urlFull + wpath + (Object.keys(get).length ? '?' + lText.queryStringify(get) : '')) + '","' +
                 lText.csvescape(lText.queryStringify(cookie)) + '","' +
                 lText.csvescape(lText.stringifyJson(session)) + '","' +

package/lib/undici/response.d.ts

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

package/lib/undici/response.js

@@ -1,5 +1,6 @@
 import * as zlib from 'zlib';
 import * as lBuffer from '#kebab/lib/buffer.js';
+import * as lCore from '#kebab/lib/core.js';
 import * as lText from '#kebab/lib/text.js';
 export class Response {
     /** --- httpClient 请求对象 --- */
@@ -26,7 +27,8 @@ export class Response {
             }
             return this._req ? await lBuffer.getFull(stream) : null;
         }
-        catch {
+        catch (e) {
+            lCore.log({}, '[Undici][Response][getContent] ' + e.message, '-error');
             return null;
         }
     }
@@ -39,7 +41,8 @@ export class Response {
             }
             return buf.toString('utf-8');
         }
-        catch {
+        catch (e) {
+            lCore.log({}, '[Undici][Response][getText] ' + e.message, '-error');
             return null;
         }
     }
@@ -52,7 +55,8 @@ export class Response {
             }
             return lText.parseJson(text);
         }
-        catch {
+        catch (e) {
+            lCore.log({}, '[Undici][Response][getJson] ' + e.message, '-error');
             return null;
         }
     }

package/lib/vector.d.ts

@@ -23,7 +23,7 @@ export declare class Vector {
     private readonly _etc;
     constructor(etc: kebab.IConfigVector);
     /** --- 搜索 --- */
-    seach(data: {
+    search(data: {
         /** --- 表名 --- */
         'collection': string;
         /** --- 查询的向量 --- */

package/lib/vector.js

@@ -8,7 +8,7 @@ export class Vector {
         this._etc = etc;
     }
     /** --- 搜索 --- */
-    async seach(data) {
+    async search(data) {
         const body = {
             'dbName': this._etc.name,
             'collectionName': data.collection,
@@ -27,15 +27,15 @@ export class Vector {
         try {
             const res = await lUndici.postJsonResponseJson(`http://${this._etc.host}:${this._etc.port}/v2/vectordb/entities/search`, body, { 'headers': { 'Authorization': `Bearer ${this._etc.user}:${this._etc.pwd}` } });
             if (res?.code !== 0) {
-                lCore.log({}, '[VECTOR][seach][error] ' + (res?.message ?? ''), '-error');
-                lCore.debug('[VECTOR][seach]', res);
+                lCore.log({}, '[VECTOR][search][error] ' + (res?.message ?? ''), '-error');
+                lCore.debug('[VECTOR][search]', res);
                 return false;
             }
             return res.data;
         }
         catch (e) {
-            lCore.log({}, '[VECTOR][seach][error] ' + e.message, '-error');
-            lCore.debug('[VECTOR][seach]', e);
+            lCore.log({}, '[VECTOR][search][error] ' + e.message, '-error');
+            lCore.debug('[VECTOR][search]', e);
             return false;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.10.1",
+  "version": "9.11.1",
   "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

@@ -191,6 +191,10 @@ async function run() {
         config.ai['VOLCN'].skey ??= '';
         config.ai['VOLAS'] ??= {};
         config.ai['VOLAS'].skey ??= '';
+        config.ai['OPENROUTER'] ??= {};
+        config.ai['OPENROUTER'].skey ??= '';
+        config.ai['OFOX'] ??= {};
+        config.ai['OFOX'].skey ??= '';
         // --- config - vector ---
         config.vector ??= {};
         config.vector.host ??= '127.0.0.1';

package/sys/master.js

@@ -386,6 +386,7 @@ function createRpcListener() {
                         '.nyc_output',
                         'tmp',
                         'temp',
+                        'AGENTS.md',
                     ]);
                     for (const path in ls) {
                         /** --- 带 / 开头的 zip 中文件完整路径，例如 "/www/pika/ctr/api.js" --- */

package/sys/mod.js

@@ -681,6 +681,10 @@ export default class Mod {
      */
     async refresh(lock = false) {
         const cstr = this.constructor;
+        if (!this._data[cstr._$primary]) {
+            lCore.log(this._ctr ?? {}, '[MOD][refresh] primary key not found', '-error');
+            return false;
+        }
         this._sql.select('*', cstr._$table + (this._index ? ('_' + this._index[0]) : '')).where([{
                 [cstr._$primary]: this._data[cstr._$primary]
             }]);
@@ -711,6 +715,10 @@ export default class Mod {
             return true;
         }
         const cstr = this.constructor;
+        if (!this._data[cstr._$primary]) {
+            lCore.log(this._ctr ?? {}, '[MOD][save] primary key not found', '-error');
+            return false;
+        }
         const updates = {};
         for (const k in this._updates) {
             updates[k] = this._data[k];
@@ -736,6 +744,10 @@ export default class Mod {
      */
     async remove() {
         const cstr = this.constructor;
+        if (!this._data[cstr._$primary]) {
+            lCore.log(this._ctr ?? {}, '[MOD][remove] primary key not found', '-error');
+            return false;
+        }
         this._sql.delete(cstr._$table + (this._index ? ('_' + this._index[0]) : '')).where([{
                 [cstr._$primary]: this._data[cstr._$primary]
             }]);

package/www/example/ctr/test.js

@@ -140,6 +140,7 @@ export default class extends sCtr.Ctr {
             `<br><br><b>Ai:</b>`,
             `<br><a href="${this._config.const.urlBase}test/ai-stream">View "test/ai-stream"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ai?action=chat">View "test/ai?action=chat"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=response">View "test/ai?action=response"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ai?action=text-to-image">View "test/ai?action=text-to-image"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ai?action=image-to-image">View "test/ai?action=image-to-image"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ai?action=text-to-video">View "test/ai?action=text-to-video"</a>`,
@@ -1728,12 +1729,12 @@ exec: ${JSON.stringify(exec)}<br><br>`);
     }
     async vector() {
         const vector = lVector.get(this);
-        const res = await vector.seach({
+        const res = await vector.search({
             'collection': 'ai_wiki_content',
             'metric': 'COSINE',
             'data': [0.4100031323819555, 0.7188991736586672, 0.32890290245747833, 0.9187961849628559, 0.023142186415922916, 0.45239563148580797, 0.23537591588175988, 0.6848990771759962, 0.9865744633216178, 0.8239142304110896, 0.997768380245414, 0.3012929412655765, 0.13731236076734943, 0.5126131685642945, 0.9806290097015617, 0.1870468071764284, 0.17178642706602143, 0.4016660911946244, 0.15484433366942607, 0.29719222215610386, 0.3103748731148619, 0.6892950176658315, 0.01785695346759608, 0.08539564964986557, 0.2655959514380064, 0.9964617086704073, 0.2838371937684081, 0.14987010598298633, 0.6228479079557896, 0.8080833516756243, 0.15438562173495285, 0.5078008662168574, 0.27262149922940804, 0.23104911473240675, 0.6266656488428926, 0.8553958245035254, 0.11699454830789868, 0.2300336351244865, 0.3042943975707315, 0.20182231286864427, 0.14334825938359863, 0.5272057735967806, 0.6568390179350452, 0.11388912236667226, 0.4916225414998463, 0.4913046496135085, 0.6301252401085475, 0.26051075673874036, 0.17023441587522825, 0.371755148312803, 0.5831318953846139, 0.9756820442368113, 0.6818893859710211, 0.5188330204766185, 0.7868335112863099, 0.7263293211859105, 0.15777067513918275, 0.25071428052177835, 0.9055952502390328, 0.39066574162485046, 0.6694768856781026, 0.904527206408617, 0.5359679189729842, 0.42923033393177423, 0.6959492373261136, 0.4721197667950616, 0.6861043448179791, 0.05188999799541438, 0.7346607591003518, 0.1574483630625012, 0.9141756884547747, 0.9116789303557802, 0.7609450526832306, 0.7763073356227885, 0.7334996162535046, 0.8036447394427264, 0.21291521237560262, 0.4628513517221038, 0.005054981316060525, 0.6289756103407573, 0.9376033918403373, 0.79713161153396, 0.1795021378890418, 0.32421299215073773, 0.5585715705291334, 0.1964507020528392, 0.9170965358836494, 0.44199069294404825, 0.46924875851341463, 0.005915168915280544, 0.4519648598811945, 0.7817208441823769, 0.39630447274483926, 0.874803477246406, 0.02593537985516514, 0.03494415508402371, 0.6948556600612117, 0.02531235612016558, 0.3252859275909026, 0.6124602304575255, 0.6662991517754546, 0.054786469959723805, 0.09541281916656552, 0.047971618444194286, 0.9888851535738363, 0.09923862294731634, 0.37389883211204245, 0.0510449762242422, 0.5140187522339308, 0.9165108670272317, 0.473682888066292, 0.7553395418192084, 0.48450479101753663, 0.22080081972551513, 0.8461012374988566, 0.32711442729081885, 0.46740436391036244, 0.9330234279632854, 0.7456194346850014, 0.8575560505025164, 0.2617623984893922, 0.6418053194775086, 0.607749877895083, 0.2176063100000032, 0.5366633111896186, 0.9689538808794083, 0.8226310778269623, 0.4813948057818185]
         });
-        const echo = [`<pre>const res = await vector.seach({
+        const echo = [`<pre>const res = await vector.search({
     'collection': 'oas_wiki',
     'metric': 'COSINE',
     'data': [0.4100031323819555, 0.7188991736586672, 0.32890290245747833, ...]
@@ -4095,11 +4096,13 @@ rtn.push(reader.readBCDString());</pre>${JSON.stringify(rtn)}`);
         return echo.join('') + '<br>' + this._getEnd();
     }
     async ai() {
+        this.timeout = 60_000 * 10;
         const echo = [`<pre>const ai = lAi.get(this, {
     'service': lAi.ESERVICE.${lText.htmlescape(this._get['service']?.toUpperCase() ?? 'ALICN')},
 });</pre>`];
         const ai = lAi.get(this, {
             'service': lAi.ESERVICE[this._get['service']?.toUpperCase() ?? 'ALICN'] ?? lAi.ESERVICE.ALICN,
+            'endpoint': this._get['service'] === 'ofox' ? 'https://api.ofox.io/v1' : undefined,
         });
         switch (this._get['action']) {
             case 'text-to-image': {
@@ -4243,6 +4246,128 @@ rtn.push(reader.readBCDString());</pre>${JSON.stringify(rtn)}`);
                 }
                 break;
             }
+            case 'response': {
+                // --- Responses API：多轮对话 + Function Calling + 数据库存储方案 ---
+                let model = ai.service === lAi.ESERVICE.ALICN ? 'qwen3.5-flash' : 'openai/gpt-5-nano';
+                const responseInstructions = 'You are Kebab, a helpful assistant. Do not mention any model names or AI identity. Respond in Chinese.';
+                // --- 工具定义 ---
+                const responseTools = [
+                    {
+                        'type': 'function',
+                        'name': 'get_weather',
+                        'description': '获取指定城市的当前天气，返回 `false`: 调用失败, `null`: 无数据, 成功: 温度和天气',
+                        'parameters': {
+                            'type': 'object',
+                            'required': ['city'],
+                            'properties': {
+                                'city': { 'type': 'string', 'description': '城市名称，如"北京"' },
+                            },
+                        },
+                    },
+                ];
+                // --- 模拟本地工具执行 ---
+                const execTool = (name, argsJson) => {
+                    const args = lText.parseJson(argsJson);
+                    if (!args) {
+                        return 'false';
+                    }
+                    if (name === 'get_weather') {
+                        const table = {
+                            '北京': { 'temp': '22°C', 'condition': '晴' },
+                            '上海': { 'temp': '28°C', 'condition': '多云' },
+                        };
+                        return table[args['city']] ? lText.stringifyJson(table[args['city']]) : 'null';
+                    }
+                    return 'false';
+                };
+                // --- 完整对话历史（同时作为数据库存储内容） ---
+                const conversation = [];
+                // --- 运行一轮（自动处理 function_call 循环） ---
+                const runTurn = async (userMsg) => {
+                    conversation.push({ 'role': 'user', 'content': userMsg });
+                    let data = await ai.response({
+                        'model': model,
+                        'store': false,
+                        'reasoning': {
+                            'effort': 'minimal',
+                        },
+                        'instructions': responseInstructions,
+                        'input': conversation,
+                        'tools': responseTools,
+                    });
+                    while (data) {
+                        const calls = data.output.filter(item => item.type === 'function_call');
+                        if (!calls.length) {
+                            // --- 无工具调用，追加 assistant 回复，供下一轮使用 ---
+                            conversation.push({ 'role': 'assistant', 'content': data.output_text });
+                            return data;
+                        }
+                        // --- 将 function_call 追加到 conversation ---
+                        for (const call of calls) {
+                            conversation.push({
+                                'type': 'function_call',
+                                'name': call.name,
+                                'arguments': call.arguments,
+                                'call_id': call.call_id,
+                            });
+                        }
+                        // --- 全部追加完后再统一执行工具，将结果追加到 conversation，再次调用 ---
+                        for (const call of calls) {
+                            conversation.push({
+                                'type': 'function_call_output',
+                                'call_id': call.call_id,
+                                'output': execTool(call.name, call.arguments),
+                            });
+                        }
+                        data = await ai.response({
+                            'model': model,
+                            'store': false,
+                            'reasoning': {
+                                'effort': 'minimal',
+                            },
+                            'instructions': responseInstructions,
+                            'input': conversation,
+                            'tools': responseTools,
+                        });
+                    }
+                    return false;
+                };
+                // --- 第一轮：自我介绍 + 查北京天气（触发 Function Calling） ---
+                const d1str = '你是谁？今天北京天气怎么样？';
+                const d1 = await runTurn(d1str);
+                if (!d1) {
+                    echo.push('Turn 1 Failed');
+                    break;
+                }
+                echo.push(`<b>第一轮（触发 get_weather 工具）：</b><br>${d1str + '<br>' + lText.htmlescape(d1.output_text)}<br><br>`);
+                // --- 第二轮：续接上文，查上海天气 ---
+                const d2str = '那上海呢？';
+                const d2 = await runTurn(d2str);
+                if (!d2) {
+                    echo.push('Turn 2 Failed');
+                    break;
+                }
+                echo.push(`<b>第二轮（conversation 续接，自动触发工具）：</b><br>${d2str + '<br>' + lText.htmlescape(d2.output_text)}<br><br>`);
+                // --- 第三轮：基于前两轮结果直接推理，无需工具 ---
+                const d3str = '两个城市比较，今天哪个更适合出行？';
+                const d3 = await runTurn(d3str);
+                if (!d3) {
+                    echo.push('Turn 3 Failed');
+                    break;
+                }
+                echo.push(`<b>第三轮（直接推理）：</b><br>${d3str + '<br>' + lText.htmlescape(d3.output_text)}<br>`);
+                // --- 数据库存储格式 ---
+                // --- conversation 顺序：user → function_call → function_call_output → assistant → user → ... ---
+                echo.push(`<hr><b>数据库存储 input：</b><pre>${lText.htmlescape(lText.stringifyJson(conversation, 4))}</pre>`);
+                // --- 从头重建（直接将 dbRecord.input 发送即可） ---
+                echo.push(`<hr><b>从头重建：</b><pre>${lText.htmlescape(`const replay = await ai.response({
+    'model': model,
+    'instructions': instructions,
+    'input': conversation,
+    'tools': tools,
+});`)}</pre>`);
+                break;
+            }
             default: {
                 // --- CHAT ---
                 let model = ai.service === lAi.ESERVICE.ALICN ? 'qwen-plus' : 'doubao-seed-2-0-mini-260215';