@maiyunnet/kebab 5.0.4 → 5.2.0

package/index.d.ts

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

package/index.js

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

package/lib/ai.d.ts

@@ -43,6 +43,8 @@ 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>;
+    /** --- 创建向量 --- */
+    embedding(body: openai.default.EmbeddingCreateParams): Promise<openai.APIPromise<openai.default.CreateEmbeddingResponse> | false>;
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/ai.js

@@ -83,6 +83,17 @@ export class Ai {
             return false;
         }
     }
+    /** --- 创建向量 --- */
+    async embedding(body) {
+        try {
+            return await this.link.embeddings.create(body);
+        }
+        catch (e) {
+            lCore.debug('[AI][EMBEDDING]', e);
+            lCore.log(this._ctr, `[AI][EMBEDDING] ${e.message}`, '-error');
+            return false;
+        }
+    }
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/crypto.d.ts

@@ -24,6 +24,13 @@ export declare function generateKeyPair(type: string, options?: {
     'public': string | Buffer;
     'private': string | Buffer;
 }>;
+/**
+ * --- 非对称加签 ---
+ * @param data 数据
+ * @param privateKey 私钥
+ * @param format 输出格式
+ * @param algorithm 哈希方式
+ */
 export declare function sign(data: crypto.BinaryLike, privateKey: crypto.KeyLike | crypto.SignKeyObjectInput | crypto.SignPrivateKeyInput | crypto.SignJsonWebKeyInput, format: 'hex' | 'base64' | 'binary', algorithm?: string): string;
 export declare function sign(data: crypto.BinaryLike, privateKey: crypto.KeyLike | crypto.SignKeyObjectInput | crypto.SignPrivateKeyInput | crypto.SignJsonWebKeyInput, format?: 'buffer', algorithm?: string): Buffer;
 /**
@@ -77,10 +84,31 @@ export declare const SM4_CFB = "sm4-cfb";
  * @param method 加密方法
  */
 export declare function cipherEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64' | 'buffer'): string | Buffer | false;
+/**
+ * --- AES 加密 ---
+ * @param original 原始字符串
+ * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
+ * @param method 加密方法
+ * @param output 输出类型
+ */
 export declare function aesEncrypt(original: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function aesEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64'): string | false;
+/**
+ * --- AES GCM 托管加密 ---
+ * @param original 原始字符串
+ * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
+ * @param output 输出类型
+ */
 export declare function gcmEncrypt(original: string | Buffer, key: crypto.CipherKey, output: 'buffer'): Buffer | false;
 export declare function gcmEncrypt(original: string | Buffer, key: crypto.CipherKey, output?: 'base64'): string | false;
+/**
+ * --- SM4 加密 ---
+ * @param original 原始字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function sm4Encrypt(original: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function sm4Encrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64'): string | false;
 /**
@@ -91,12 +119,39 @@ export declare function sm4Encrypt(original: string | Buffer, key: crypto.Cipher
  * @param method 加密方法
  */
 export declare function cipherDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary' | 'buffer'): string | Buffer | false;
+/**
+ * --- AES 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function aesDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function aesDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary'): string | false;
+/**
+ * --- AES 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 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;
+/**
+ * --- SM4 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function sm4Decrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function sm4Decrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary'): string | false;
+/**
+ * --- hash 或 hmac 加密 ---
+ * @param algorithm 哈希方式
+ * @param data 源数据
+ * @param key 设置则采用 hmac 加密
+ */
 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;
 export declare function hashHmacFile(algorithm: string, path: string, key?: crypto.CipherKey, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string | false>;

package/lib/crypto.js

@@ -39,13 +39,6 @@ export function generateKeyPair(type, options = {}) {
         });
     });
 }
-/**
- * --- 非对称加签 ---
- * @param data 数据
- * @param privateKey 私钥
- * @param format 输出格式
- * @param algorithm 哈希方式
- */
 export function sign(data, privateKey, format = 'buffer', algorithm = 'sha256') {
     const sign = crypto.createSign(algorithm);
     sign.update(data);
@@ -165,26 +158,12 @@ export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, outp
         return false;
     }
 }
-/**
- * --- AES 加密 ---
- * @param original 原始字符串
- * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
- * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
- * @param method 加密方法
- * @param output 输出类型
- */
 export function aesEncrypt(original, key, iv = '', method = AES_256_ECB, output = 'base64') {
     if (iv !== '') {
         method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherEncrypt(original, key, iv, method, output);
 }
-/**
- * --- AES GCM 托管加密 ---
- * @param original 原始字符串
- * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
- * @param output 输出类型
- */
 export function gcmEncrypt(original, key, output = 'base64') {
     const iv = lCore.random(12, lCore.RANDOM_LUNS);
     const rtn = cipherEncrypt(original, key, iv, AES_256_GCM, output);
@@ -193,13 +172,6 @@ export function gcmEncrypt(original, key, output = 'base64') {
     }
     return typeof rtn === 'string' ? iv + rtn : Buffer.concat([Buffer.from(iv), rtn]);
 }
-/**
- * --- SM4 加密 ---
- * @param original 原始字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function sm4Encrypt(original, key, iv = '', method = SM4_ECB, output = 'base64') {
     if (iv !== '') {
         method = method === SM4_ECB ? SM4_CFB : method;
@@ -268,48 +240,21 @@ export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, outpu
         return false;
     }
 }
-/**
- * --- AES 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
- * @param method 加密方法
- */
 export function aesDecrypt(encrypt, key, iv = '', method = AES_256_ECB, output = 'binary') {
     if (iv !== '') {
         method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherDecrypt(encrypt, key, iv, method, output);
 }
-/**
- * --- AES 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function gcmDecrypt(encrypt, key, output = 'binary') {
     return cipherDecrypt(typeof encrypt === 'string' ? encrypt.slice(12) : encrypt.subarray(12), key, typeof encrypt === 'string' ? encrypt.slice(0, 12) : encrypt.subarray(0, 12).toString(), AES_256_GCM, output);
 }
-/**
- * --- SM4 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function sm4Decrypt(encrypt, key, iv = '', method = SM4_ECB, output = 'binary') {
     if (iv !== '') {
         method = method === SM4_ECB ? SM4_CFB : method;
     }
     return cipherDecrypt(encrypt, key, iv, method, output);
 }
-/**
- * --- hash 或 hmac 加密 ---
- * @param algorithm 哈希方式
- * @param data 源数据
- * @param key 设置则采用 hmac 加密
- */
 export function hashHmac(algorithm, data, key, format = 'hex') {
     const cry = key ? crypto.createHmac(algorithm, key) : crypto.createHash(algorithm);
     cry.update(data);

package/lib/sql.js

@@ -474,7 +474,12 @@ export class Sql {
         let field = this.field(f, pre || this._pre, suf ? ('#' + suf) : '');
         if (pre) {
             // --- 处理不同 pre 的 as 前缀问题 ---
-            field = field.replace(new RegExp(`AS \`${pre}(.+?)\``), `AS \`${this._pre}$1\``);
+            if (this._service === ESERVICE.MYSQL) {
+                field = field.replace(new RegExp(`AS \`${pre}(.+?)\``), `AS \`${this._pre}$1\``);
+            }
+            else {
+                field = field.replace(new RegExp(`AS "${pre}"."(.+?)"`), `AS "${this._pre}"."$1"`);
+            }
         }
         let sql = ' ' + type + ' JOIN ' + field;
         if (Array.isArray(s) ? s.length : Object.keys(s).length) {

package/package.json

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

package/sys/mod.d.ts

@@ -40,6 +40,8 @@ export default class Mod {
     protected static _$key: string;
     /** --- 若使用 _$key 并且有多个 unique 索引，这里指定 _$key 的索引名 --- */
     protected static _$index: string;
+    /** --- 前缀，顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
+    protected static _$pre: string | null;
     /** --- 要 update 的内容 --- */
     protected _updates: Record<string, boolean>;
     /** --- 模型获取的属性 --- */
@@ -94,7 +96,8 @@ export default class Mod {
      * @param opt 选项
      */
     static insert(db: lDb.Pool | lDb.Transaction, cs: string[] | Record<string, any>, vs?: any[] | any[][], opt?: {
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string;
     }): Promise<boolean | null | false>;
     /**
@@ -105,7 +108,8 @@ export default class Mod {
      * @param opt 选项
      */
     static insertSql(db: lDb.Pool | lDb.Transaction, cs: string[] | Record<string, any>, vs?: any[] | any[][], opt?: {
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string;
     }): string;
     /**
@@ -116,7 +120,8 @@ export default class Mod {
      */
     static removeByWhere(db: lDb.Pool | lDb.Transaction, where: string | kebab.Json, opt?: {
         'raw'?: boolean;
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string | string[];
         'by'?: [string | string[], 'DESC' | 'ASC'];
         'limit'?: [number, number?];
@@ -129,7 +134,8 @@ export default class Mod {
      */
     static removeByWhereSql(db: lDb.Pool | lDb.Transaction, where: string | kebab.Json, opt?: {
         'raw'?: boolean;
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string;
         'by'?: [string | string[], 'DESC' | 'ASC'];
         'limit'?: [number, number?];
@@ -143,7 +149,8 @@ export default class Mod {
      */
     static updateByWhere(db: lDb.Pool | lDb.Transaction, data: kebab.Json, where: string | kebab.Json, opt?: {
         'raw'?: boolean;
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string | string[];
         'by'?: [string | string[], 'DESC' | 'ASC'];
         'limit'?: [number, number?];
@@ -157,7 +164,8 @@ export default class Mod {
      */
     static updateByWhereSql(db: lDb.Pool | lDb.Transaction, data: kebab.Json, where: string | kebab.Json, opt?: {
         'raw'?: boolean;
-        'pre'?: sCtr.Ctr | string;
+        'pre'?: string;
+        'ctr'?: sCtr.Ctr;
         'index'?: string;
         'by'?: [string | string[], 'DESC' | 'ASC'];
         'limit'?: [number, number?];
@@ -335,7 +343,7 @@ export default class Mod {
      * @param s ON 信息
      * @param type 类型
      * @param index 给本表增加 index 分表项
-     * @param pre 前缀
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     join(f: string, s?: kebab.Json, type?: string, index?: string, pre?: string): this;
     /**
@@ -343,6 +351,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     leftJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -350,6 +359,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     rightJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -357,6 +367,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     innerJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -364,6 +375,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     fullJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -371,6 +383,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     crossJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**

package/sys/mod.js

@@ -7,7 +7,6 @@ import * as lSql from '#kebab/lib/sql.js';
 import * as lDb from '#kebab/lib/db.js';
 import * as lCore from '#kebab/lib/core.js';
 import * as lText from '#kebab/lib/text.js';
-import * as sCtr from '#kebab/sys/ctr.js';
 /** --- 条数列表 --- */
 class Rows {
     constructor(initialItems = []) {
@@ -54,6 +53,8 @@ export default class Mod {
     static { this._$key = ''; }
     /** --- 若使用 _$key 并且有多个 unique 索引，这里指定 _$key 的索引名 --- */
     static { this._$index = ''; }
+    /** --- 前缀，顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
+    static { this._$pre = null; }
     /**
      * --- 构造函数 ---
      * @param ctr Ctr 对象
@@ -79,7 +80,7 @@ export default class Mod {
         /** --- 导入数据库连接 --- */
         this._db = opt.db;
         /** --- 新建 sql 对象 --- */
-        this._sql = lSql.get(opt.pre ?? opt.ctr, {
+        this._sql = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': this._db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         if (opt.index) {
@@ -118,7 +119,7 @@ export default class Mod {
      * @param opt 选项
      */
     static async insert(db, cs, vs, opt = {}) {
-        const sq = lSql.get(opt.pre, {
+        const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         if (!vs) {
@@ -127,7 +128,7 @@ export default class Mod {
             sq.values(cs);
             const r = await db.execute(sq.getSql(), sq.getData());
             if (r.packet === null) {
-                lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[insert, mod] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1), '-error');
+                lCore.log(opt.ctr ?? {}, '[MOD][insert] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1), '-error');
                 return false;
             }
             return r.packet.affected ? true : null;
@@ -147,7 +148,7 @@ export default class Mod {
             sq.values(cs, vs.slice(i * line, (i + 1) * line));
             const r = await db.execute(sq.getSql(), sq.getData());
             if (r.packet === null) {
-                lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[insert, mod] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1), '-error');
+                lCore.log(opt.ctr ?? {}, '[MOD][insert] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1), '-error');
                 return false;
             }
             if (r.packet.affected) {
@@ -165,7 +166,7 @@ export default class Mod {
      * @param opt 选项
      */
     static insertSql(db, cs, vs, opt = {}) {
-        const sq = lSql.get(opt.pre, {
+        const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         sq.insert(this._$table + (opt.index ? ('_' + opt.index) : '')).values(cs, vs);
@@ -181,7 +182,7 @@ export default class Mod {
         const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
         let ar = 0;
         for (const index of indexs) {
-            const sq = lSql.get(opt.pre, {
+            const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
                 'service': db.getService() ?? lDb.ESERVICE.PGSQL,
             });
             sq.delete(this._$table + (index ? ('_' + index) : '')).where(where);
@@ -193,7 +194,7 @@ export default class Mod {
             }
             const r = await db.execute(sq.getSql(), sq.getData());
             if (r.packet === null) {
-                lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[MOD][removeByWhere] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
+                lCore.log(opt.ctr ?? {}, '[MOD][removeByWhere] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
                 return false;
             }
             if (r.packet.affected) {
@@ -209,7 +210,7 @@ export default class Mod {
      * @param opt 选项
      */
     static removeByWhereSql(db, where, opt = {}) {
-        const sq = lSql.get(opt.pre, {
+        const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         sq.delete(this._$table + (opt.index ? ('_' + opt.index) : '')).where(where);
@@ -232,7 +233,7 @@ export default class Mod {
         const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
         let ar = 0;
         for (const index of indexs) {
-            const sq = lSql.get(opt.pre, {
+            const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
                 'service': db.getService() ?? lDb.ESERVICE.PGSQL,
             });
             sq.update(this._$table + (index ? ('_' + index) : ''), data).where(where);
@@ -244,7 +245,7 @@ export default class Mod {
             }
             const r = await db.execute(sq.getSql(), sq.getData());
             if (r.packet === null) {
-                lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[MOD][updateByWhere] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
+                lCore.log(opt.ctr ?? {}, '[MOD][updateByWhere] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
                 return false;
             }
             if (r.packet.affected) {
@@ -261,7 +262,7 @@ export default class Mod {
      * @param opt 选项
      */
     static updateByWhereSql(db, data, where, opt = {}) {
-        const sq = lSql.get(opt.pre, {
+        const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         sq.update(this._$table + (opt.index ? ('_' + opt.index) : ''), data).where(where);
@@ -408,7 +409,7 @@ export default class Mod {
      * @param opt 选项
      */
     static async primarys(db, where = '', opt = {}) {
-        const sq = lSql.get(opt.pre ?? opt.ctr, {
+        const sq = lSql.get(opt.pre ?? this.constructor._$pre ?? opt.ctr, {
             'service': db.getService() ?? lDb.ESERVICE.PGSQL,
         });
         sq.select(this._$primary, this._$table + (opt.index ? ('_' + opt.index) : '')).where(where);
@@ -435,7 +436,7 @@ export default class Mod {
         return rtn;
     }
     /**
-     * --- 设置一个/多个属性 ---
+     * --- 设置一个/多个属性，值为 underfind 则不会被更新 ---
      * @param n 字符串或键/值
      * @param v 可能是数字
      */
@@ -1085,7 +1086,7 @@ export default class Mod {
      * @param s ON 信息
      * @param type 类型
      * @param index 给本表增加 index 分表项
-     * @param pre 前缀
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     join(f, s = [], type = 'INNER', index = '', pre = '') {
         this._sql.join(f, s, type, index ? '_' + index : '', pre);
@@ -1096,6 +1097,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     leftJoin(f, s, index = '', pre = '') {
         this._sql.leftJoin(f, s, index ? '_' + index : '', pre);
@@ -1106,6 +1108,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     rightJoin(f, s, index = '', pre = '') {
         this._sql.rightJoin(f, s, index ? '_' + index : '', pre);
@@ -1116,6 +1119,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     innerJoin(f, s, index = '', pre = '') {
         this._sql.innerJoin(f, s, index ? '_' + index : '', pre);
@@ -1126,6 +1130,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     fullJoin(f, s, index = '', pre = '') {
         this._sql.fullJoin(f, s, index ? '_' + index : '', pre);
@@ -1136,6 +1141,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     crossJoin(f, s, index = '', pre = '') {
         this._sql.crossJoin(f, s, index ? '_' + index : '', pre);

package/www/example/ctr/test.js

@@ -573,7 +573,8 @@ Result:<pre id="result">Nothing.</pre>` + this._getEnd();
             await mTest.removeByWhere(db, [
                 ['token', 'LIKE', 'test_%'],
             ], {
-                'pre': this._get['s'] === 'pgsql' ? 'm' : this,
+                'ctr': this,
+                'pre': this._get['s'] === 'pgsql' ? 'm' : undefined,
             });
             return this._location('test/mod-test' + (this._get['s'] === 'pgsql' ? '?s=pgsql' : ''));
         }
@@ -834,7 +835,7 @@ CREATE TABLE \`m_test_data_0\` (
             ]);
         }
         const res = await mTestData.insert(db, ['test_id', 'content', 'time_add'], datas, {
-            'pre': this,
+            'ctr': this,
             'index': '0',
         });
         echo.push('<br><br>Result: ' + JSON.stringify(res));