@maiyunnet/kebab 5.3.1 → 6.1.0

package/README.md

@@ -32,7 +32,7 @@ You can also use pm2 to start the project by running:
 
 ## Library
 
-Buffer, Captcha, Consistent, Core, Cron, Crypto, Db (MySQL), Dns (DNSPod, Alibaba Cloud), Fs, Jwt, Kv (Redis), Lan, Net, S3, Scan, Session, Sql, Ssh (Shell, Sftp), Text, Time, Ws, Zip, Zlib.
+Ai, Buffer, Captcha, Consistent, Core, Cron, Crypto, Db (MySQL, PostgreSQL), Dns (DNSPod, Alibaba Cloud), Fs, Kv (Redis), Lan, Lang, Net, S3, Scan, Session, Socket, Sql, Ssh (Shell, Sftp), Text, Time, Turnstile (Cloudflare, Tencent Cloud), Vector (Milvus), Ws, Zip, Zlib.
 
 ## Partial Features
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "5.3.1";
+export declare const VER = "6.1.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;
@@ -25,7 +25,7 @@ export declare const MOD_CWD: string;
 export type Json = any;
 /** --- 数据库值的类型 --- */
 export type DbValue = string | number | null | Record<string, Json>;
-/** --- 动态目录配置文件 --- */
+/** --- 目录配置文件 --- */
 export interface IConfig {
     'set': {
         'timezone': number;
@@ -43,7 +43,6 @@ export interface IConfig {
     }> & {
         'default': 'MYSQL' | 'PGSQL';
     };
-    'jwt': IConfigJwt;
     'kv': IConfigKv;
     'route': Record<string, string>;
     'session': {

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '5.3.1';
+export const VER = '6.1.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */
@@ -15,7 +15,11 @@ const dirname = imu.slice(0, imu.lastIndexOf('/'));
 export const ROOT_PATH = dirname + '/';
 export const LIB_PATH = ROOT_PATH + 'lib/';
 export const SYS_PATH = ROOT_PATH + 'sys/';
-const cwd = process.cwd().replace(/\\/g, '/');
+let cwd = process.cwd().replace(/\\/g, '/');
+if (cwd.endsWith('source')) {
+    // --- 开发环境下，cwd 在 source 的上级目录 ---
+    cwd = cwd.slice(0, -7);
+}
 /** --- 执行根目录，以 / 结尾 --- */
 export const ROOT_CWD = cwd + '/';
 export const CONF_CWD = ROOT_CWD + 'conf/';

package/lib/ai.d.ts

@@ -5,6 +5,7 @@
  */
 import * as openai from 'openai';
 import * as streaming from 'openai/streaming';
+import * as kebab from '#kebab/index.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 /**
  * --- 参考：https://help.aliyun.com/zh/model-studio/what-is-model-studio ---
@@ -37,8 +38,8 @@ export interface IOptions {
 export declare class Ai {
     /** --- openai 原生对象，建议只读 --- */
     readonly link: openai.OpenAI;
-    private readonly _ctr;
-    constructor(ctr: sCtr.Ctr, opt: IOptions);
+    private readonly _ctr?;
+    constructor(ctrEtc: sCtr.Ctr | kebab.IConfigAi, opt: IOptions);
     /** --- 创建非流式对话 --- */
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Chat.ChatCompletion> | false>;
     /** --- 创建流式对话 --- */
@@ -50,4 +51,4 @@ export declare class Ai {
  * --- 创建一个 AI 对象 ---
  * @param opt 选项
  */
-export declare function get(ctr: sCtr.Ctr, opt: IOptions): Ai;
+export declare function get(ctrEtc: sCtr.Ctr | kebab.IConfigAi, opt: IOptions): Ai;

package/lib/ai.js

@@ -5,6 +5,7 @@
  */
 import * as openai from 'openai';
 import * as lCore from '#kebab/lib/core.js';
+import * as sCtr from '#kebab/sys/ctr.js';
 /**
  * --- 参考：https://help.aliyun.com/zh/model-studio/what-is-model-studio ---
  * --- 阿里模型：https://help.aliyun.com/zh/model-studio/getting-started/models ---
@@ -26,10 +27,17 @@ export var ESERVICE;
 /** --- openai 的连接对象 --- */
 const links = [];
 export class Ai {
-    constructor(ctr, opt) {
-        this._ctr = ctr;
-        const config = ctr.getPrototype('_config');
-        const secretKey = opt.secretKey ?? config.ai?.[ESERVICE[opt.service]]?.skey ?? '';
+    constructor(ctrEtc, opt) {
+        let configAi = null;
+        if (ctrEtc instanceof sCtr.Ctr) {
+            this._ctr = ctrEtc;
+            const config = ctrEtc.getPrototype('_config');
+            configAi = config.ai[ESERVICE[opt.service]];
+        }
+        else {
+            configAi = ctrEtc;
+        }
+        const secretKey = opt.secretKey ?? configAi.skey ?? '';
         let endpoint;
         switch (opt.service) {
             case ESERVICE.ALICN: {
@@ -41,15 +49,15 @@ export class Ai {
                 break;
             }
             case ESERVICE.AZURE: {
-                endpoint = opt.endpoint ?? config.ai?.[ESERVICE[opt.service]]?.endpoint ?? '';
+                endpoint = opt.endpoint ?? configAi.endpoint ?? '';
                 break;
             }
             case ESERVICE.AZURE2: {
-                endpoint = opt.endpoint ?? config.ai?.[ESERVICE[opt.service]]?.endpoint ?? '';
+                endpoint = opt.endpoint ?? configAi.endpoint ?? '';
                 break;
             }
             case ESERVICE.AZURE3: {
-                endpoint = opt.endpoint ?? config.ai?.[ESERVICE[opt.service]]?.endpoint ?? '';
+                endpoint = opt.endpoint ?? configAi.endpoint ?? '';
                 break;
             }
             default: {
@@ -79,7 +87,7 @@ export class Ai {
         }
         catch (e) {
             lCore.debug('[AI][CHAT]', e);
-            lCore.log(this._ctr, `[AI][CHAT] ${e.message}`, '-error');
+            lCore.log(this._ctr ?? {}, `[AI][CHAT] ${e.message}`, '-error');
             return false;
         }
     }
@@ -90,7 +98,7 @@ export class Ai {
         }
         catch (e) {
             lCore.debug('[AI][EMBEDDING]', e);
-            lCore.log(this._ctr, `[AI][EMBEDDING] ${e.message}`, '-error');
+            lCore.log(this._ctr ?? {}, `[AI][EMBEDDING] ${e.message}`, '-error');
             return false;
         }
     }
@@ -99,6 +107,6 @@ export class Ai {
  * --- 创建一个 AI 对象 ---
  * @param opt 选项
  */
-export function get(ctr, opt) {
-    return new Ai(ctr, opt);
+export function get(ctrEtc, opt) {
+    return new Ai(ctrEtc, opt);
 }

package/lib/buffer.d.ts

@@ -4,12 +4,16 @@ export declare class Reader {
     /** --- 当前读取位置 --- */
     private _offset;
     constructor(buffer: Buffer);
-    /** --- 读取一个无符号8位整数, BYTE --- */
+    /** --- 读取一个无符号 8 位整数, BYTE --- */
     readUInt8(): number;
-    /** --- 读取一个无符号16位整数（大端模式），WORD --- */
+    /** --- 读取一个无符号 16 位整数（大端模式），WORD --- */
     readUInt16BE(): number;
-    /** --- 读取一个无符号32位整数（大端模式）, DWORD --- */
+    /** --- 读取一个无符号 16 位整数（小端模式） --- */
+    readUInt16LE(): number;
+    /** --- 读取一个无符号 32 位整数（大端模式）, DWORD --- */
     readUInt32BE(): number;
+    /** --- 读取一个无符号 32 位整数（小端模式） --- */
+    readUInt32LE(): number;
     /** --- 读取一个 BCD 编码的字符串（每个字节表示两个数字）--- */
     readBCDString(length?: number): string;
     /** --- 读取普通 string --- */
@@ -45,6 +49,6 @@ export declare class Writer {
 export declare function getReader(buffer: Buffer): Reader;
 /**
  * --- Buffer Writer 对象 ---
- * @param buffer 要读取的 buffer
+ * @param size 缓冲区大小
  */
 export declare function getWriter(size: number): Writer;

package/lib/buffer.js

@@ -5,24 +5,36 @@ export class Reader {
         this._offset = 0;
         this._buffer = buffer;
     }
-    /** --- 读取一个无符号8位整数, BYTE --- */
+    /** --- 读取一个无符号 8 位整数, BYTE --- */
     readUInt8() {
         const value = this._buffer.readUInt8(this._offset);
         this._offset += 1;
         return value;
     }
-    /** --- 读取一个无符号16位整数（大端模式），WORD --- */
+    /** --- 读取一个无符号 16 位整数（大端模式），WORD --- */
     readUInt16BE() {
         const value = this._buffer.readUInt16BE(this._offset);
         this._offset += 2;
         return value;
     }
-    /** --- 读取一个无符号32位整数（大端模式）, DWORD --- */
+    /** --- 读取一个无符号 16 位整数（小端模式） --- */
+    readUInt16LE() {
+        const value = this._buffer.readUInt16LE(this._offset);
+        this._offset += 2;
+        return value;
+    }
+    /** --- 读取一个无符号 32 位整数（大端模式）, DWORD --- */
     readUInt32BE() {
         const value = this._buffer.readUInt32BE(this._offset);
         this._offset += 4;
         return value;
     }
+    /** --- 读取一个无符号 32 位整数（小端模式） --- */
+    readUInt32LE() {
+        const value = this._buffer.readUInt32LE(this._offset);
+        this._offset += 4;
+        return value;
+    }
     /** --- 读取一个 BCD 编码的字符串（每个字节表示两个数字）--- */
     readBCDString(length) {
         length ??= this._buffer.length - this._offset;
@@ -113,7 +125,7 @@ export function getReader(buffer) {
 }
 /**
  * --- Buffer Writer 对象 ---
- * @param buffer 要读取的 buffer
+ * @param size 缓冲区大小
  */
 export function getWriter(size) {
     return new Writer(size);

package/lib/core.d.ts

@@ -40,14 +40,23 @@ export declare function setCookie(ctr: sCtr.Ctr, name: string, value: string, op
  * @param prec 保留几位小数
  */
 export declare function rand(min: number, max: number, prec?: number): number;
+/** --- 数字字符集 --- */
 export declare const RANDOM_N = "0123456789";
+/** --- 大写字母字符集 --- */
 export declare const RANDOM_U = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+/** --- 小写字母字符集 --- */
 export declare const RANDOM_L = "abcdefghijklmnopqrstuvwxyz";
+/** --- 大写字母 + 数字字符集 --- */
 export declare const RANDOM_UN: string;
+/** --- 小写字母 + 数字字符集 --- */
 export declare const RANDOM_LN: string;
+/** --- 小写字母 + 大写字母字符集 --- */
 export declare const RANDOM_LU: string;
+/** --- 小写字母 + 大写字母 + 数字字符集 --- */
 export declare const RANDOM_LUN: string;
+/** --- 验证码字符集 --- */
 export declare const RANDOM_V = "ACEFGHJKLMNPRSTWXY34567";
+/** --- 小写字母 + 大写字母 + 数字字符集 + 特殊字符字符集 --- */
 export declare const RANDOM_LUNS: string;
 /**
  * --- 生成随机字符串 ---
@@ -56,7 +65,6 @@ export declare const RANDOM_LUNS: string;
  * @param block 排除的字符
  */
 export declare function random(length?: number, source?: string, block?: string): string;
-export declare const CONVERT62_CHAR = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
 /**
  * --- 将 10 进制转换为 62 进制 ---
  * @param n 10 进制数字最大 9223372036854775807n
@@ -82,13 +90,18 @@ export declare function checkType(val: any, type: any, tree?: string): string;
 /**
  * --- 获取 MUID ---
  * @param ctr Ctr 对象
- * @param opt len: 8 - 32, 默认 8; bin: 是否含有大小写, 默认 true; key: 多样性混合, 默认空; insert: 插入指定字符, 最好不超过 2 字符，默认空，num: 是否含有数字，默认 true
+ * @param opt 参数
  */
 export declare function muid(ctr: sCtr.Ctr, opt?: {
+    /** --- 8 - 32, 默认 8 --- */
     'len'?: number;
+    /** --- 是否含有大小写, 默认 true --- */
     'bin'?: boolean;
+    /** --- 多样性混合, 默认空 --- */
     'key'?: string;
+    /** --- 插入指定字符, 最好不超过 2 字符，默认空 --- */
     'insert'?: string;
+    /** --- 是否含有数字, 默认 true --- */
     'num'?: boolean;
 }): string;
 /**
@@ -96,7 +109,9 @@ export declare function muid(ctr: sCtr.Ctr, opt?: {
  * @param ctr
  */
 export declare function ip(ctr: sCtr.Ctr | http.IncomingHttpHeaders, req?: http2.Http2ServerRequest | http.IncomingMessage): string;
+/** --- 使用 X-Forwarded-For 的 CDN 厂商 --- */
 export declare const REAL_IP_X = "x-forwarded-for";
+/** --- 使用的是 Cloudflare --- */
 export declare const REAL_IP_CF = "cf-connecting-ip";
 /**
  * --- 获取直连 IP（安全 IP） ---
@@ -117,9 +132,9 @@ export declare function objectSort<T extends Record<string, any>>(o: T): T;
 /**
  * --- 将对象的所有属性清除包括键，不会破坏引用关系，对象变量依然保证是引用状态 ---
  * @param obj 要清除的对象
- * @patam deep 也将子项都清空，如果子项有独立引用的话也要清空的话则要设置为 true
+ * @param deep 也将子项都清空，如果子项有独立引用的话也要清空的话则要设置为 true
  */
-export declare function emptyObject(obj: Record<string, kebab.Json>, deep?: boolean): void;
+export declare function emptyObject(obj: Record<string, any>, deep?: boolean): void;
 /**
  * --- 调用前自行创建 passThrough，并且调用 pipe 绑定到应该绑定的对象，然后再调用本函数 ---
  * @param passThrough passThrough 对象
@@ -145,12 +160,12 @@ export declare function sendRestart(hosts?: string[] | 'config'): Promise<string
 /** --- 跨进程全局变量 --- */
 export declare const global: Record<string, any>;
 /**
- * --- 设置跨线程/跨内网服务器的全局变量 ---
+ * --- 设置跨线程/指定的局域网主机的全局变量 ---
  * @param key 变量名
  * @param data 变量值
  * @param hosts 局域网列表
  */
-export declare function setGlobal(key: string, data: kebab.Json, hosts?: string[] | 'config'): Promise<string[]>;
+export declare function setGlobal(key: string, data: any, hosts?: string[] | 'config'): Promise<string[]>;
 /**
  * --- 移除某个跨线程/跨内网服务器全局变量 ---
  * @param key 变量名
@@ -160,7 +175,7 @@ export declare function removeGlobal(key: string, hosts?: string[]): Promise<str
 /**
  * --- 上传并覆盖代码文件，config.json、kebab.json、.js.map、.ts, .gitignore 不会被覆盖和新建 ---
  * @param sourcePath zip 文件
- * @param path 要覆盖到的路径，无所谓是否 / 开头 / 结尾，是对方 kebab 的根据路开始算起
+ * @param path 要更新的目标路径，无所谓是否 / 开头 / 结尾，是对方 kebab 的根据路径开始算起
  * @param hosts 局域网多机部署，不设置默认本机部署
  * @param config 是否自动更新 config 的 set.staticVer 为最新，默认更新
  * @param strict 严格模式，只有存在的文件才会被覆盖，不存在则中途直接报错，默认为 true
@@ -175,17 +190,16 @@ export interface ILogOptions {
     'urlFull'?: string;
     'hostname'?: string;
     'req'?: http2.Http2ServerRequest | http.IncomingMessage | null;
-    'get'?: Record<string, kebab.Json>;
+    'get'?: Record<string, any>;
     'cookie'?: Record<string, string>;
-    'jwt'?: Record<string, any>;
     'session'?: Record<string, any>;
     'headers'?: http.IncomingHttpHeaders;
 }
 /**
  * --- 写入文件日志 ---
+ * @param opt 选项
  * @param msg 自定义内容
  * @param fend 文件名追加
- * @param opt 选项
  */
 export declare function log(opt: sCtr.Ctr | ILogOptions, msg: string, fend?: string): void;
 /**

package/lib/core.js

@@ -62,14 +62,23 @@ export function rand(min, max, prec = 0) {
     return Math.round(Math.random() * (max - min) + min) / p;
 }
 // --- 随机 ---
+/** --- 数字字符集 --- */
 export const RANDOM_N = '0123456789';
+/** --- 大写字母字符集 --- */
 export const RANDOM_U = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+/** --- 小写字母字符集 --- */
 export const RANDOM_L = 'abcdefghijklmnopqrstuvwxyz';
+/** --- 大写字母 + 数字字符集 --- */
 export const RANDOM_UN = RANDOM_U + RANDOM_N;
+/** --- 小写字母 + 数字字符集 --- */
 export const RANDOM_LN = RANDOM_L + RANDOM_N;
+/** --- 小写字母 + 大写字母字符集 --- */
 export const RANDOM_LU = RANDOM_L + RANDOM_U;
+/** --- 小写字母 + 大写字母 + 数字字符集 --- */
 export const RANDOM_LUN = RANDOM_L + RANDOM_U + RANDOM_N;
+/** --- 验证码字符集 --- */
 export const RANDOM_V = 'ACEFGHJKLMNPRSTWXY34567';
+/** --- 小写字母 + 大写字母 + 数字字符集 + 特殊字符字符集 --- */
 export const RANDOM_LUNS = RANDOM_LUN + '()`~!@#$%^&*-+=_|{}[]:;"<>,.?/]"';
 /**
  * --- 生成随机字符串 ---
@@ -95,7 +104,7 @@ export function random(length = 8, source = RANDOM_LN, block = '') {
     }
     return temp;
 }
-export const CONVERT62_CHAR = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const CONVERT62_CHAR = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
 /**
  * --- 将 10 进制转换为 62 进制 ---
  * @param n 10 进制数字最大 9223372036854775807n
@@ -241,7 +250,7 @@ export function checkType(val, type, tree = 'root') {
 /**
  * --- 获取 MUID ---
  * @param ctr Ctr 对象
- * @param opt len: 8 - 32, 默认 8; bin: 是否含有大小写, 默认 true; key: 多样性混合, 默认空; insert: 插入指定字符, 最好不超过 2 字符，默认空，num: 是否含有数字，默认 true
+ * @param opt 参数
  */
 export function muid(ctr, opt = {}) {
     const len = opt.len ?? 8;
@@ -289,7 +298,9 @@ export function ip(ctr, req) {
         return req.socket.remoteAddress ?? '';
     }
 }
+/** --- 使用 X-Forwarded-For 的 CDN 厂商 --- */
 export const REAL_IP_X = 'x-forwarded-for';
+/** --- 使用的是 Cloudflare --- */
 export const REAL_IP_CF = 'cf-connecting-ip';
 /**
  * --- 获取直连 IP（安全 IP） ---
@@ -338,7 +349,7 @@ export function objectSort(o) {
 /**
  * --- 将对象的所有属性清除包括键，不会破坏引用关系，对象变量依然保证是引用状态 ---
  * @param obj 要清除的对象
- * @patam deep 也将子项都清空，如果子项有独立引用的话也要清空的话则要设置为 true
+ * @param deep 也将子项都清空，如果子项有独立引用的话也要清空的话则要设置为 true
  */
 export function emptyObject(obj, deep = false) {
     const keys = Object.keys(obj);
@@ -484,7 +495,7 @@ export async function sendRestart(hosts) {
 /** --- 跨进程全局变量 --- */
 export const global = {};
 /**
- * --- 设置跨线程/跨内网服务器的全局变量 ---
+ * --- 设置跨线程/指定的局域网主机的全局变量 ---
  * @param key 变量名
  * @param data 变量值
  * @param hosts 局域网列表
@@ -535,7 +546,7 @@ export async function removeGlobal(key, hosts) {
 /**
  * --- 上传并覆盖代码文件，config.json、kebab.json、.js.map、.ts, .gitignore 不会被覆盖和新建 ---
  * @param sourcePath zip 文件
- * @param path 要覆盖到的路径，无所谓是否 / 开头 / 结尾，是对方 kebab 的根据路开始算起
+ * @param path 要更新的目标路径，无所谓是否 / 开头 / 结尾，是对方 kebab 的根据路径开始算起
  * @param hosts 局域网多机部署，不设置默认本机部署
  * @param config 是否自动更新 config 的 set.staticVer 为最新，默认更新
  * @param strict 严格模式，只有存在的文件才会被覆盖，不存在则中途直接报错，默认为 true
@@ -579,9 +590,9 @@ export async function updateCode(sourcePath, path, hosts, config = true, strict
 }
 /**
  * --- 写入文件日志 ---
+ * @param opt 选项
  * @param msg 自定义内容
  * @param fend 文件名追加
- * @param opt 选项
  */
 export function log(opt, msg, fend = '') {
     (async () => {
@@ -589,7 +600,6 @@ export function log(opt, msg, fend = '') {
         let headers;
         let get;
         let cookie;
-        let jwt;
         let session;
         let wpath;
         let urlFull;
@@ -599,7 +609,6 @@ export function log(opt, msg, fend = '') {
             headers = opt.getPrototype('_headers');
             get = opt.getPrototype('_get');
             cookie = opt.getPrototype('_cookie');
-            jwt = opt.getPrototype('_jwt');
             session = opt.getPrototype('_session');
             const config = opt.getPrototype('_config');
             wpath = config.const.path;
@@ -611,7 +620,6 @@ export function log(opt, msg, fend = '') {
             headers = opt.headers ?? {};
             get = opt.get ?? {};
             cookie = opt.cookie ?? {};
-            jwt = opt.jwt ?? {};
             session = opt.session ?? {};
             wpath = opt.path ?? '';
             urlFull = opt.urlFull ?? '';
@@ -630,7 +638,7 @@ export function log(opt, msg, fend = '') {
         }
         path += h + '.csv';
         if (!await lFs.isFile(path)) {
-            if (!await lFs.putContent(path, 'TIME,UNIX,URL,COOKIE,SESSION,JWT,USER_AGENT,REALIP,CLIENTIP,OS,PROCESS,MESSAGE\n', {
+            if (!await lFs.putContent(path, 'TIME,UNIX,URL,COOKIE,SESSION,USER_AGENT,REALIP,CLIENTIP,OS,PROCESS,MESSAGE\n', {
                 'encoding': 'utf8',
                 'mode': 0o777
             })) {
@@ -642,7 +650,6 @@ export function log(opt, msg, fend = '') {
             lTime.stamp().toString() + '","' +
             urlFull + wpath + (Object.keys(get).length ? '?' + lText.queryStringify(get).replace(/"/g, '""') : '') + '","' +
             lText.queryStringify(cookie).replace(/"/g, '""') + '","' +
-            lText.stringifyJson(jwt).replace(/"/g, '""') + '","' +
             lText.stringifyJson(session).replace(/"/g, '""') + '","' +
             (headers['user-agent']?.replace(/"/g, '""') ?? 'No HTTP_USER_AGENT') + '","' +
             realIp.replace(/"/g, '""') + '","' +
@@ -795,7 +802,7 @@ export function debug(message, ...optionalParams) {
  */
 export function display(message, ...optionalParams) {
     // eslint-disable-next-line no-console
-    console.log(message, ...optionalParams);
+    console.log(`KE-DISPLAY ${lTime.format(null, 'Y-m-d H:i:s')}`, message, ...optionalParams);
 }
 /**
  * --- 让 res 发送头部（前提是头部没有被发送才能调用本方法 ---

package/lib/crypto.d.ts

@@ -73,8 +73,10 @@ export declare const AES_256_CBC = "aes-256-cbc";
 export declare const AES_256_CTR = "aes-256-ctr";
 /** --- 非流直接使用 GCM --- */
 export declare const AES_256_GCM = "aes-256-gcm";
+/** --- SM4 如果未设置 iv，则默认这个 --- */
 export declare const SM4_ECB = "sm4-ecb";
 export declare const SM4_CBC = "sm4-cbc";
+/** --- SM4 一般用这个，设置 iv，自动就切换成了这个 --- */
 export declare const SM4_CFB = "sm4-cfb";
 /**
  * --- cipher 加密，强烈不建议使用 AES_256_ECB ---
@@ -82,6 +84,7 @@ export declare const SM4_CFB = "sm4-cfb";
  * @param key 密钥 32 个英文字母和数字
  * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
+ * @param output 输出类型
  */
 export declare function cipherEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64' | 'buffer'): string | Buffer | false;
 /**
@@ -117,6 +120,7 @@ export declare function sm4Encrypt(original: string | Buffer, key: crypto.Cipher
  * @param key 密钥 32 个英文字母和数字
  * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
+ * @param output 输出类型
  */
 export declare function cipherDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary' | 'buffer'): string | Buffer | false;
 /**
@@ -132,8 +136,7 @@ export declare function aesDecrypt(encrypt: string | Buffer, key: crypto.CipherK
  * --- AES 解密 ---
  * @param encrypt 需解密的字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
+ * @param output 输出类型
  */
 export declare function gcmDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, output: 'buffer'): Buffer | false;
 export declare function gcmDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, output?: 'binary'): string | false;
@@ -154,6 +157,12 @@ export declare function sm4Decrypt(encrypt: string | Buffer, key: crypto.CipherK
  */
 export declare function hashHmac(algorithm: string, data: Buffer | string, key?: crypto.CipherKey, format?: 'hex' | 'base64'): string;
 export declare function hashHmac(algorithm: string, data: Buffer | string, key: crypto.CipherKey | undefined, format: 'buffer'): Buffer;
+/**
+ * --- hash 或 hmac 加密文件 ---
+ * @param algorithm 加密方式，如 md5、sha256、sm3 等
+ * @param path 文件路径
+ * @param key 设置则采用 hmac 加密
+ */
 export declare function hashHmacFile(algorithm: string, path: string, key?: crypto.CipherKey, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string | false>;
 export declare function hashHmacFile(algorithm: string, path: string, key: crypto.CipherKey, encoding: 'buffer'): Promise<Buffer | false>;
 /**

package/lib/crypto.js

@@ -97,15 +97,18 @@ export const AES_256_CBC = 'aes-256-cbc';
 export const AES_256_CTR = 'aes-256-ctr';
 /** --- 非流直接使用 GCM --- */
 export const AES_256_GCM = 'aes-256-gcm';
-export const SM4_ECB = 'sm4-ecb'; // --- SM4 如果未设置 iv，则默认这个 ---
+/** --- SM4 如果未设置 iv，则默认这个 --- */
+export const SM4_ECB = 'sm4-ecb';
 export const SM4_CBC = 'sm4-cbc';
-export const SM4_CFB = 'sm4-cfb'; // --- SM4 一般用这个，设置 iv，自动就切换成了这个 ---
+/** --- SM4 一般用这个，设置 iv，自动就切换成了这个 --- */
+export const SM4_CFB = 'sm4-cfb';
 /**
  * --- cipher 加密，强烈不建议使用 AES_256_ECB ---
  * @param original 原始字符串
  * @param key 密钥 32 个英文字母和数字
  * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
+ * @param output 输出类型
  */
 export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, output = 'base64') {
     try {
@@ -184,6 +187,7 @@ export function sm4Encrypt(original, key, iv = '', method = SM4_ECB, output = 'b
  * @param key 密钥 32 个英文字母和数字
  * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
+ * @param output 输出类型
  */
 export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, output = 'binary') {
     try {
@@ -265,12 +269,6 @@ export function hashHmac(algorithm, data, key, format = 'hex') {
         return cry.digest(format);
     }
 }
-/**
- * --- hash 或 hmac 加密文件 ---
- * @param algorithm 加密方式，如 md5、sha256、sm3 等
- * @param path 文件路径
- * @param key 设置则采用 hmac 加密
- */
 export function hashHmacFile(algorithm, path, key, encoding = 'hex') {
     return new Promise(function (resolve) {
         const cry = key ? crypto.createHmac(algorithm, key) : crypto.createHash(algorithm);

package/lib/db/conn.js

@@ -276,7 +276,7 @@ export class Connection {
             return false;
         }
     }
-    // --- 事务，只能在独占连接中使用，pool 创建事务返回独占连接，commit 或 rollback 释放连接回池 ---
+    // --- 事务，只能在独占连接中使用，pool 创建事务返回独占连接，commit 或 rollback 释放连接回连接池 ---
     async beginTransaction() {
         if (this._using) {
             try {

package/lib/db.d.ts

@@ -6,7 +6,7 @@
 import * as kebab from '#kebab/index.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 import { Connection } from './db/conn.js';
-import { Pool } from './db/pool.js';
+import { Pool, IConnectionInfo, getConnectionList } from './db/pool.js';
 import { Transaction } from './db/tran.js';
 /** --- 服务商定义 --- */
 export declare enum ESERVICE {
@@ -53,10 +53,12 @@ export interface IPacket {
 }
 /**
  * --- 获取 Db Pool 对象 ---
- * @param etc 配置信息可留空
+ * @param ctrEtc 控制器对象或数据库配置信息
+ * @param opt 选项
+ * @returns Db Pool 对象
  */
 export declare function get(ctrEtc: sCtr.Ctr | kebab.IConfigDb, opt?: {
     /** --- 服务商，默认 PGSQL --- */
     'service'?: ESERVICE;
 }): Pool;
-export { Connection, Pool, Transaction };
+export { Connection, Pool, IConnectionInfo, getConnectionList, Transaction };

package/lib/db.js

@@ -5,7 +5,7 @@
  */
 import * as sCtr from '#kebab/sys/ctr.js';
 import { Connection } from './db/conn.js';
-import { Pool } from './db/pool.js';
+import { Pool, getConnectionList } from './db/pool.js';
 import { Transaction } from './db/tran.js';
 /** --- 服务商定义 --- */
 export var ESERVICE;
@@ -15,7 +15,9 @@ export var ESERVICE;
 })(ESERVICE || (ESERVICE = {}));
 /**
  * --- 获取 Db Pool 对象 ---
- * @param etc 配置信息可留空
+ * @param ctrEtc 控制器对象或数据库配置信息
+ * @param opt 选项
+ * @returns Db Pool 对象
  */
 export function get(ctrEtc, opt = {}) {
     if (ctrEtc instanceof sCtr.Ctr) {
@@ -30,4 +32,4 @@ export function get(ctrEtc, opt = {}) {
         'service': opt.service ?? ESERVICE.PGSQL,
     });
 }
-export { Connection, Pool, Transaction };
+export { Connection, Pool, getConnectionList, Transaction };