midway-fatcms 0.0.18 → 0.0.20

package/src/libs/crud-pro/utils/idgene/generateSnowflakeIdExt.ts

@@ -1,20 +1,25 @@
 /**
- * 128 位雪花 ID 生成器（独立于 MixinUtils.generateSnowflakeId，原 63 位算法不变）
+ * 128 位雪花 ID 生成器（优化版）
  *
  * 位布局（128 bit，无符号，BigInt 拼接后 Base58 编码返回）：
- * - 64 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移
- * - 16 bit 机器ID：0-65535，优先参数 > 环境变量 SNOWFLAKE_MACHINE_ID > process.pid 低 16 位
- * - 48 bit 序列号：同一毫秒内自增，约 2.8e14 个/ms，实际不会耗尽
+ * - 41 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移，可用约 69 年（至 ~2093 年）
+ * - 10 bit 机器ID：0-1023，与标准 64 位雪花 ID 一致，优先参数 > 环境变量 > process.pid
+ * - 77 bit 序列号：同一毫秒内自增，2^77 ≈ 1.5×10²³，无需考虑耗尽
  *
- * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），当前约 21 字符，理论最大 22 字符，建议 VARCHAR(24)
+ * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），左填充 '1' 至恒定 22 字符，建议 VARCHAR(24)
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * 2^128-1 < 58^22，故 22 字符足以覆盖全部 128 位取值范围。
  */
 
 const EPOCH = BigInt(1704067200000); // 2024-01-01 00:00:00 UTC
 
-const TS_SHIFT = BigInt(64);
-const MID_SHIFT = BigInt(48);
-const MID_MASK = BigInt(0xffff);
-const SEQ_MASK = BigInt('0xffffffffffff'); // 48 bit
+const TS_BITS = BigInt(41);
+const MID_BITS = BigInt(10);
+const SEQ_BITS = BigInt(77);
+const TS_MASK = (BigInt(1) << TS_BITS) - BigInt(1); // 41 bit
+const MID_MASK = (BigInt(1) << MID_BITS) - BigInt(1); // 10 bit
+const SEQ_MASK = (BigInt(1) << SEQ_BITS) - BigInt(1); // 77 bit
+const PAD_LENGTH = 22;
 
 const SEQ_START = BigInt(1);
 const DRIFT_TOLERANCE = BigInt(5);
@@ -41,7 +46,7 @@ function encodeBase58(value: bigint): string {
   return result;
 }
 
-/** 解析机器 ID（16 bit） */
+/** 解析机器 ID（10 bit，0-1023） */
 function resolveMachineId(machineId?: number): bigint {
   let mid = Number(machineId);
   if (machineId === undefined || machineId === null || isNaN(mid)) {
@@ -59,10 +64,16 @@ function resolveMachineId(machineId?: number): bigint {
 }
 
 /**
- * 生成 128 位雪花 ID（Base58 字符串）
+ * 生成 128 位雪花 ID（Base58 字符串，恒定 22 字符）
  *
- * @param machineId 机器ID（0-65535），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
- * @returns Base58 编码的 128 位雪花 ID
+ * 位布局：41 bit 时间戳 | 10 bit 机器ID | 77 bit 序列号
+ * 时间戳采用 41 bit（与标准 64 位雪花 ID 一致），毫秒精度，可用约 69 年。
+ * 机器ID 采用 10 bit（0-1023），与标准 64 位雪花 ID 一致，防止多机 ID 冲突。
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * Base58 输出左填充 '1'（零字符）至 22 字符，保证长度恒定且不破坏字典序排序。
+ *
+ * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
+ * @returns Base58 编码的 128 位雪花 ID（恒定 22 字符）
  */
 function generateSnowflakeIdExt(machineId?: number): string {
   const mid = resolveMachineId(machineId);
@@ -82,18 +93,14 @@ function generateSnowflakeIdExt(machineId?: number): string {
 
   if (ts === snowflakeExtLastTs) {
     snowflakeExtSeq = (snowflakeExtSeq + BigInt(1)) & SEQ_MASK;
-    if (snowflakeExtSeq === BigInt(0)) {
-      ts = snowflakeExtLastTs + BigInt(1);
-      snowflakeExtSeq = SEQ_START;
-    }
   } else {
     snowflakeExtSeq = SEQ_START;
   }
 
   snowflakeExtLastTs = ts;
 
-  const id = (ts << TS_SHIFT) | (mid << MID_SHIFT) | snowflakeExtSeq;
-  return encodeBase58(id);
+  const id = ((ts & TS_MASK) << (MID_BITS + SEQ_BITS)) | (mid << SEQ_BITS) | snowflakeExtSeq;
+  return encodeBase58(id).padStart(PAD_LENGTH, BASE58_ALPHABET[0]);
 }
 
 export { generateSnowflakeIdExt, EPOCH as SNOWFLAKE_EXT_EPOCH };

package/src/libs/crud-pro-quick/fixSoftDelete.ts

@@ -1,8 +1,7 @@
-import { KeysOfSimpleSQL } from "@/libs/crud-pro/models/keys";
-import { IRequestModel, IVisitor } from "@/libs/crud-pro/interfaces";
-import { IRequestCfgModel2, ICommonStandardColumns, ICommonStandardColumns2 } from "./models";
-import { DateTimeUtils } from "@/libs/crud-pro/utils/DateTimeUtils";
-
+import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
+import { IRequestModel, IVisitor } from '@/libs/crud-pro/interfaces';
+import { IRequestCfgModel2, ICommonStandardColumns, ICommonStandardColumns2 } from './models';
+import { DateTimeUtils } from '@/libs/crud-pro/utils/DateTimeUtils';
 
 /**
  * 软删除处理函数
@@ -18,14 +17,7 @@ import { DateTimeUtils } from "@/libs/crud-pro/utils/DateTimeUtils";
  * @param params 请求参数（会被修改）
  * @param visitor 获取当前用户信息的函数（用于软删除时记录删除人）
  */
-function fixSoftDelete1(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete1(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   // INSERT 操作：刚插入的数据，肯定是未删除的
   if (KeysOfSimpleSQL.SIMPLE_INSERT === oldSqlSimpleName) {
     if (!params.data) {
@@ -38,12 +30,10 @@ function fixSoftDelete1(
   // DELETE 操作：如果是软删除，修改为 UPDATE 语句
   // 标准软删除：deleted_at 字段为 0 代表未删除，有任意时间戳代表已删除
   if (KeysOfSimpleSQL.SIMPLE_DELETE === oldSqlSimpleName) {
-
     if (!params.condition || Object.keys(params.condition).length === 0) {
       throw new Error('执行删除操作，必须指定删除条件');
     }
 
-
     // 在原有 data 对象上添加软删除字段
     if (!params.data) {
       params.data = {};
@@ -57,10 +47,7 @@ function fixSoftDelete1(
   }
 
   // QUERY 操作：强制查询未删除的记录
-  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
-
+  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
     if (!params.condition) {
       params.condition = {};
     }
@@ -68,15 +55,7 @@ function fixSoftDelete1(
   }
 }
 
-
-function fixSoftDelete2(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete2(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   // INSERT 操作：刚插入的数据，肯定是未删除的
   if (KeysOfSimpleSQL.SIMPLE_INSERT === oldSqlSimpleName) {
     if (!params.data) {
@@ -88,12 +67,10 @@ function fixSoftDelete2(
 
   // DELETE 操作：如果是软删除，修改为 UPDATE 语句
   if (KeysOfSimpleSQL.SIMPLE_DELETE === oldSqlSimpleName) {
-
     if (!params.condition || Object.keys(params.condition).length === 0) {
       throw new Error('执行删除操作，必须指定删除条件');
     }
 
-
     // 在原有 data 对象上添加软删除字段
     if (!params.data) {
       params.data = {};
@@ -108,10 +85,7 @@ function fixSoftDelete2(
   }
 
   // QUERY 操作：强制查询未删除的记录
-  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
-
+  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
     if (!params.condition) {
       params.condition = {};
     }
@@ -119,8 +93,6 @@ function fixSoftDelete2(
   }
 }
 
-
-
 /**
  * 软删除处理函数
  *
@@ -129,14 +101,7 @@ function fixSoftDelete2(
  * @param params 请求参数（会被修改）
  * @param visitor 获取当前用户信息的函数（用于软删除时记录删除人）
  */
-function fixSoftDelete(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   if (cfgModel.enableSoftDelete === true || cfgModel.enableSoftDelete === 'soft') {
     fixSoftDelete1(oldSqlSimpleName, cfgModel, params, visitor);
     return;
@@ -146,11 +111,6 @@ function fixSoftDelete(
     fixSoftDelete2(oldSqlSimpleName, cfgModel, params, visitor);
     return;
   }
-
 }
 
-
-export {
-  fixSoftDelete,
-};
-
+export { fixSoftDelete };

package/src/service/curd/CurdMixService.ts

@@ -10,7 +10,7 @@ import { IRequestCfgModel2 } from '@/models/bizmodels';
 import { CurdMixByLinkToCustomService } from './CurdMixByLinkToCustomService';
 // import { SqlDbType } from '@/libs/crud-pro/models/keys';
 import { ExecuteContext, IExecuteContextCustom } from '@/libs/crud-pro/models/ExecuteContext';
-import { ShardingBase } from "@/libs/crud-sharding";
+import { ShardingBase } from '@/libs/crud-sharding';
 import { IGetQuickCrudParam, IGetShardingCrudParam } from './CurdProService';
 
 export interface ILinkColumnRelationParam {
@@ -50,7 +50,6 @@ export class CurdMixService {
     return this.curdProService.executeCrudByCfg(reqJson, cfgModel);
   }
 
-
   // /**
   //  * @deprecated 请使用 getQuickCrud 替代
   //  * @param sqlDatabase
@@ -67,13 +66,11 @@ export class CurdMixService {
     return this.curdProService.getQuickCrud(param);
   }
 
-
   public getShardingCrud(param: IGetShardingCrudParam): ShardingBase {
     this.prepare();
     return this.curdProService.getShardingCrud(param);
   }
 
-
   async executeSQL(sqlCfgModel: ISqlCfgModel): Promise<ExecuteSQLResult> {
     this.prepare();
     return this.curdProService.executeSQL(sqlCfgModel);

package/src/service/curd/CurdProService.ts

@@ -20,7 +20,7 @@ import { CrudProQuick } from '@/libs/crud-pro-quick';
 import { ShardingBase, ShardingByTimeCrud, ShardingByHashCrud, ShardingByKeyCrud, ShardingByCustomCrud, ShardingType, IShardingConfig } from '@/libs/crud-sharding';
 import { fixCfgModel } from './fixCfgModel';
 import { GLOBAL_STATIC_CONFIG } from '@/libs/global-config/global-config';
-import { fixSoftDelete } from "@/libs/crud-pro-quick/fixSoftDelete";
+import { fixSoftDelete } from '@/libs/crud-pro-quick/fixSoftDelete';
 
 /**
  * getQuickCrud 参数接口
@@ -321,7 +321,6 @@ export class CurdProService extends BaseService {
     return await curdPro.executeCrudByCfg(reqJson, cfgModel);
   }
 
-
   /**
    * 获取 CrudProQuick 工具类
    *
@@ -431,14 +430,14 @@ export class CurdProService extends BaseService {
     return curdPro.getAllTableInfos(query, options);
   }
 
-
   public async loadTableMetaCache(ctx?: any): Promise<void> {
     const { SystemDbName, SystemDbType } = GLOBAL_STATIC_CONFIG.getConfig();
-    await this.getAllTableInfos({
-      sqlDatabase: SystemDbName,
-      sqlDbType: SystemDbType,
-    }, { skipCache: true });
+    await this.getAllTableInfos(
+      {
+        sqlDatabase: SystemDbName,
+        sqlDbType: SystemDbType,
+      },
+      { skipCache: true }
+    );
   }
 }
-
-

package/src/service/curd/fixCfgModel.ts

@@ -1,145 +1,145 @@
-import * as _ from 'lodash';
-import { CTX_VISITOR_ACCOUNT_TYPE, CTX_VISITOR_AVATAR, CTX_VISITOR_ID, CTX_VISITOR_NICKNAME, IRequestCfgModel2 } from '@/models/bizmodels';
-import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
-
-function isSimpleQuery(sqlSimpleName: KeysOfSimpleSQL): boolean {
-  return sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_COUNT || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_PAGE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_ONE;
-}
-
-function fixCfgModel(cfgModel: IRequestCfgModel2) {
-  if (!cfgModel.method) {
-    cfgModel.method = 'anonymous';
-  }
-
-  if (!cfgModel.updateCfg) {
-    cfgModel.updateCfg = {};
-  }
-
-  const sqlSimpleName = cfgModel.sqlSimpleName;
-
-  const enableStandardUpdateCfg = cfgModel.enableStandardUpdateCfg; // 用于设置data字段
-  const enableStandardUpdateCfgCondition = cfgModel.enableStandardUpdateCfgCondition; // 用于设置condition字段
-
-  // 彻底关闭
-  if (enableStandardUpdateCfg === false) {
-    return;
-  }
-
-  const getDataCfgArray = () => {
-    // 明确有配置
-    if (Array.isArray(enableStandardUpdateCfg)) {
-      if (enableStandardUpdateCfg.includes('null')) {
-        return [];
-      }
-      return enableStandardUpdateCfg;
-    }
-    // update 、insert 添加 by
-    return ['by', 'at']; // 创建/修改语句默认添加by
-  };
-
-  const getConditionCfgArray = () => {
-    // 明确有配置
-    if (Array.isArray(enableStandardUpdateCfgCondition)) {
-      if (enableStandardUpdateCfgCondition.includes('null')) {
-        return [];
-      }
-      return enableStandardUpdateCfgCondition;
-    }
-    return [];
-  };
-
-  const dataCfgArray = getDataCfgArray();
-  const conditionCfgArray = getConditionCfgArray();
-
-  const mapping: Record<string, any> = {
-    'condition.created_by': { contextAsString: CTX_VISITOR_ID },
-    'condition.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-
-    'data.created_at': { functionName: 'getCurrentTimeString' },
-    'data.created_by': { contextAsString: CTX_VISITOR_ID },
-    'data.created_avatar': { contextAsString: CTX_VISITOR_AVATAR },
-    'data.created_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
-    'data.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-
-    'data.modified_at': { functionName: 'getCurrentTimeString' },
-    'data.modified_by': { contextAsString: CTX_VISITOR_ID },
-    'data.modified_avatar': { contextAsString: CTX_VISITOR_AVATAR },
-    'data.modified_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
-    'data.modified_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-  };
-
-  const buildUpdateCfgBy = (cfgArray: string[], prefix: string): any => {
-    const obj: any = {};
-    if (Array.isArray(cfgArray)) {
-      for (let i = 0; i < cfgArray.length; i++) {
-        const suffix = cfgArray[i];
-        if (suffix) {
-          const key = `${prefix}_${suffix}`;
-          if (mapping[key]) {
-            obj[key] = mapping[key];
-          }
-        }
-      }
-    }
-    return obj;
-  };
-
-  // 查询语句
-  if (isSimpleQuery(sqlSimpleName)) {
-    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 查询用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj);
-  }
-
-  // 删除语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_DELETE) {
-    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 删除用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj);
-  }
-
-  // 插入语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-
-    // 启用: 雪花ID
-    if (dataCfgArray.includes('idBySnowflakeId')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'generateSnowflakeId' },
-      });
-    }
-
-    // 启用: 扩展的雪花ID： -128bit，base58（建议数据库varchar（24））
-    if (dataCfgArray.includes('idBySnowflakeIdExt')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'generateSnowflakeIdExt' },
-      });
-    }
-
-    // 启用: UUID
-    if (dataCfgArray.includes('idByUUID')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'uuid' },
-      });
-    }
-  }
-
-  // 更新语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_UPDATE) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
-    const updateCfgObj2 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-    _.merge(cfgModel.updateCfg, updateCfgObj2);
-  }
-
-  // 插入或更新
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_OR_UPDATE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_ON_DUPLICATE_UPDATE) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
-    const updateCfgObj2 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
-    const updateCfgObj3 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-    _.merge(cfgModel.updateCfg, updateCfgObj2);
-    _.merge(cfgModel.updateCfg, updateCfgObj3);
-  }
-}
-
-export { fixCfgModel };
+import * as _ from 'lodash';
+import { CTX_VISITOR_ACCOUNT_TYPE, CTX_VISITOR_AVATAR, CTX_VISITOR_ID, CTX_VISITOR_NICKNAME, IRequestCfgModel2 } from '@/models/bizmodels';
+import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
+
+function isSimpleQuery(sqlSimpleName: KeysOfSimpleSQL): boolean {
+  return sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_COUNT || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_PAGE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_ONE;
+}
+
+function fixCfgModel(cfgModel: IRequestCfgModel2) {
+  if (!cfgModel.method) {
+    cfgModel.method = 'anonymous';
+  }
+
+  if (!cfgModel.updateCfg) {
+    cfgModel.updateCfg = {};
+  }
+
+  const sqlSimpleName = cfgModel.sqlSimpleName;
+
+  const enableStandardUpdateCfg = cfgModel.enableStandardUpdateCfg; // 用于设置data字段
+  const enableStandardUpdateCfgCondition = cfgModel.enableStandardUpdateCfgCondition; // 用于设置condition字段
+
+  // 彻底关闭
+  if (enableStandardUpdateCfg === false) {
+    return;
+  }
+
+  const getDataCfgArray = () => {
+    // 明确有配置
+    if (Array.isArray(enableStandardUpdateCfg)) {
+      if (enableStandardUpdateCfg.includes('null')) {
+        return [];
+      }
+      return enableStandardUpdateCfg;
+    }
+    // update 、insert 添加 by
+    return ['by', 'at']; // 创建/修改语句默认添加by
+  };
+
+  const getConditionCfgArray = () => {
+    // 明确有配置
+    if (Array.isArray(enableStandardUpdateCfgCondition)) {
+      if (enableStandardUpdateCfgCondition.includes('null')) {
+        return [];
+      }
+      return enableStandardUpdateCfgCondition;
+    }
+    return [];
+  };
+
+  const dataCfgArray = getDataCfgArray();
+  const conditionCfgArray = getConditionCfgArray();
+
+  const mapping: Record<string, any> = {
+    'condition.created_by': { contextAsString: CTX_VISITOR_ID },
+    'condition.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+
+    'data.created_at': { functionName: 'getCurrentTimeString' },
+    'data.created_by': { contextAsString: CTX_VISITOR_ID },
+    'data.created_avatar': { contextAsString: CTX_VISITOR_AVATAR },
+    'data.created_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
+    'data.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+
+    'data.modified_at': { functionName: 'getCurrentTimeString' },
+    'data.modified_by': { contextAsString: CTX_VISITOR_ID },
+    'data.modified_avatar': { contextAsString: CTX_VISITOR_AVATAR },
+    'data.modified_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
+    'data.modified_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+  };
+
+  const buildUpdateCfgBy = (cfgArray: string[], prefix: string): any => {
+    const obj: any = {};
+    if (Array.isArray(cfgArray)) {
+      for (let i = 0; i < cfgArray.length; i++) {
+        const suffix = cfgArray[i];
+        if (suffix) {
+          const key = `${prefix}_${suffix}`;
+          if (mapping[key]) {
+            obj[key] = mapping[key];
+          }
+        }
+      }
+    }
+    return obj;
+  };
+
+  // 查询语句
+  if (isSimpleQuery(sqlSimpleName)) {
+    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 查询用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj);
+  }
+
+  // 删除语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_DELETE) {
+    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 删除用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj);
+  }
+
+  // 插入语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+
+    // 启用: 雪花ID
+    if (dataCfgArray.includes('idBySnowflakeId')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'generateSnowflakeId' },
+      });
+    }
+
+    // 启用: 扩展的雪花ID： -128bit，base58（建议数据库varchar（24））
+    if (dataCfgArray.includes('idBySnowflakeIdExt')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'generateSnowflakeIdExt' },
+      });
+    }
+
+    // 启用: UUID
+    if (dataCfgArray.includes('idByUUID')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'uuid' },
+      });
+    }
+  }
+
+  // 更新语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_UPDATE) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
+    const updateCfgObj2 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+    _.merge(cfgModel.updateCfg, updateCfgObj2);
+  }
+
+  // 插入或更新
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_OR_UPDATE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_ON_DUPLICATE_UPDATE) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
+    const updateCfgObj2 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
+    const updateCfgObj3 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+    _.merge(cfgModel.updateCfg, updateCfgObj2);
+    _.merge(cfgModel.updateCfg, updateCfgObj3);
+  }
+}
+
+export { fixCfgModel };

package/src/service/proxyapi/ProxyApiLoadService.ts

@@ -5,7 +5,7 @@ import { RouteTrie } from './RouteTrie';
 import { RouteHandler } from './RouteHandler';
 import { IProxyApiEntity, IUpstreamInfo } from '../../models/SystemEntities';
 import { isEntityOK, parseJsonObject } from '../../libs/utils/functions';
-import { BALANCE_STRATEGY } from './ProxyApiUtils';
+import { BALANCE_STRATEGY, normalizePathPrefix } from './ProxyApiUtils';
 import { WeightedRandom } from './WeightedRandom';
 import { WeightedRoundRobin } from './WeightedRoundRobin';
 import { bizMemCacheStore } from '@/service/base/bizmemcache/BizMemCacheStore';
@@ -74,7 +74,8 @@ export class ProxyApiLoadService extends BaseService {
     for (let i = 0; i < entities.length; i++) {
       const entity = entities[i];
       if (entity.status === 1) {
-        const path_prefix2 = '/' + entity.upstream_code + entity.path_prefix;
+        const pathPrefix = normalizePathPrefix(entity.path_prefix);
+        const path_prefix2 = '/' + entity.upstream_code + pathPrefix;
         routeTrie.addRoute(path_prefix2, new RouteHandler(entity));
       }
     }

package/src/service/proxyapi/ProxyApiUtils.ts

@@ -15,6 +15,14 @@ export const BALANCE_STRATEGY = {
  * @param str
  * @param mod
  */
+/** path_prefix 为空表示代理上游根路径；单独的 "/" 会在路由树中注册无效节点，统一归一化为空 */
+export function normalizePathPrefix(path_prefix: string | null | undefined): string {
+  if (path_prefix === '/' || path_prefix == null) {
+    return '';
+  }
+  return path_prefix;
+}
+
 export function stringHashMod(str: string, mod: number): number {
   if (!str) {
     throw new Error('stringHashMod str is required');