befly 3.10.18 → 3.10.19

package/{sync/syncTable.ts → dist/sync/syncTable.js}

@@ -5,104 +5,20 @@
  * - 历史上该能力拆分在 packages/core/sync/syncTable/* 多个模块中
  * - 现在按项目要求，将所有实现合并到本文件（目录 packages/core/sync/syncTable/ 已删除）
  */
-
-import type { DbDialectName } from "../lib/dbDialect.ts";
-import type { BeflyContext } from "../types/befly.ts";
-import type { DbResult, SqlInfo } from "../types/database.ts";
-import type { ColumnInfo, FieldChange, IndexInfo, TablePlan } from "../types/sync.ts";
-import type { FieldDefinition } from "../types/validate.ts";
-import type { ScanFileResult } from "../utils/scanFiles.ts";
-
 import { snakeCase } from "es-toolkit/string";
-
-import { CacheKeys } from "../lib/cacheKeys.ts";
-import { getDialectByName, getSyncTableColumnsInfoQuery, getSyncTableIndexesQuery } from "../lib/dbDialect.ts";
-import { Logger } from "../lib/logger.ts";
-
-type SqlExecutor = {
-    unsafe<T = any>(sqlStr: string, params?: unknown[]): Promise<DbResult<T, SqlInfo>>;
-};
-
-type MySqlTableExistsRow = { count: number };
-type MySqlColumnInfoRow = {
-    COLUMN_NAME: string;
-    DATA_TYPE: string;
-    COLUMN_TYPE: string;
-    CHARACTER_MAXIMUM_LENGTH: number | null;
-    IS_NULLABLE: "YES" | "NO";
-    COLUMN_DEFAULT: any;
-    COLUMN_COMMENT: string | null;
-};
-
-type PgTableExistsRow = { count: number };
-type PgColumnInfoRow = {
-    column_name: string;
-    data_type: string;
-    character_maximum_length: number | null;
-    is_nullable: string;
-    column_default: any;
-};
-type PgColumnCommentRow = {
-    column_name: string;
-    column_comment: string;
-};
-
-type MySqlIndexRow = {
-    INDEX_NAME: string;
-    COLUMN_NAME: string;
-};
-
-type PgIndexRow = {
-    indexname: string;
-    indexdef: string;
-};
-
-type SqliteTableInfoRow = {
-    name: string;
-    type: string;
-    notnull: number;
-    dflt_value: any;
-};
-
-type SqliteIndexListRow = { name: string };
-type SqliteIndexInfoRow = { name: string };
-
-type DbDialect = DbDialectName;
-
-/* ========================================================================== */
-/* 对外导出面
- *
- * 约束：本文件仅导出一个函数：syncTable。
- * - 生产代码：通过 await syncTable(ctx, items) 执行同步。
- * - 测试：通过 syncTable.TestKit 访问纯函数/常量（不再导出零散函数）。
- */
-/* ========================================================================== */
-
-/**
- * 文件导航（推荐阅读顺序）
- * 1) syncTable(ctx, items) 入口（本段下方）
- * 2) 版本/常量/方言判断（DB_VERSION_REQUIREMENTS 等）
- * 3) 通用 DDL 工具（quote/type/default/ddl/index SQL）
- * 4) Runtime I/O（只读元信息：表/列/索引/版本）
- * 5) plan/apply（写变更：建表/改表/SQLite 重建）
- */
-
-type SyncTableFn = ((ctx: BeflyContext, items: ScanFileResult[]) => Promise<void>) & {
-    TestKit: typeof SYNC_TABLE_TEST_KIT;
-};
-
+import { CacheKeys } from "../lib/cacheKeys.js";
+import { getDialectByName, getSyncTableColumnsInfoQuery, getSyncTableIndexesQuery } from "../lib/dbDialect.js";
+import { Logger } from "../lib/logger.js";
 /**
  * 数据库同步命令入口（函数模式）
  */
-export const syncTable = (async (ctx: BeflyContext, items: ScanFileResult[]): Promise<void> => {
+export const syncTable = (async (ctx, items) => {
     try {
         // 记录处理过的表名（用于清理缓存）
-        const processedTables: string[] = [];
-
+        const processedTables = [];
         if (!Array.isArray(items)) {
             throw new Error("syncTable(items) 参数必须是数组");
         }
-
         if (!ctx) {
             throw new Error("syncTable(ctx, items) 缺少 ctx");
         }
@@ -115,7 +31,6 @@ export const syncTable = (async (ctx: BeflyContext, items: ScanFileResult[]): Pr
         if (!ctx.config) {
             throw new Error("syncTable(ctx, items) 缺少 ctx.config");
         }
-
         // DbDialect 归一化（允许值与映射关系）：
         //
         // | ctx.config.db.type 输入 | 归一化 dbDialect |
@@ -128,39 +43,34 @@ export const syncTable = (async (ctx: BeflyContext, items: ScanFileResult[]): Pr
         // - 这里的归一化
         // - ensureDbVersion / runtime I/O / DDL 分支
         const dbType = String(ctx.config.db?.type || "mysql").toLowerCase();
-        let dbDialect: DbDialect = "mysql";
+        let dbDialect = "mysql";
         if (dbType === "postgres" || dbType === "postgresql") {
             dbDialect = "postgresql";
-        } else if (dbType === "sqlite") {
+        }
+        else if (dbType === "sqlite") {
             dbDialect = "sqlite";
         }
-
         // 检查数据库版本（复用 ctx.db 的现有连接/事务）
         await ensureDbVersion(dbDialect, ctx.db);
-
         const databaseName = ctx.config.db?.database || "";
-        const runtime: SyncRuntime = {
+        const runtime = {
             dbDialect: dbDialect,
             db: ctx.db,
             dbName: databaseName
         };
-
         // 处理传入的 tables 数据（来自 scanSources）
         for (const item of items) {
             if (!item || item.type !== "table") {
                 continue;
             }
-
             if (item.source !== "app" && item.source !== "addon" && item.source !== "core") {
                 Logger.warn(`syncTable 跳过未知来源表定义: source=${String(item.source)} fileName=${String(item.fileName)}`);
                 continue;
             }
-
             // 确定表名：
             // - addon 表：addon_{addonName}_{fileName}
             // - app/core 表：{fileName}
             const baseTableName = snakeCase(item.fileName);
-
             let tableName = baseTableName;
             if (item.source === "addon") {
                 if (!item.addonName || String(item.addonName).trim() === "") {
@@ -168,45 +78,39 @@ export const syncTable = (async (ctx: BeflyContext, items: ScanFileResult[]): Pr
                 }
                 tableName = `addon_${snakeCase(item.addonName)}_${baseTableName}`;
             }
-
             const tableDefinition = item.content;
             if (!tableDefinition || typeof tableDefinition !== "object") {
                 throw new Error(`syncTable 表定义无效: table=${tableName}`);
             }
-
             // 为字段属性设置默认值：表定义来自 JSON/扫描结果，字段可能缺省。
             // 缺省会让 diff/DDL 生成出现 undefined vs null 等差异，导致错误的变更判断。
             for (const fieldDef of Object.values(tableDefinition)) {
                 applyFieldDefaults(fieldDef);
             }
-
             const existsTable = await tableExistsRuntime(runtime, tableName);
-
             if (existsTable) {
-                await modifyTableRuntime(runtime, tableName, tableDefinition as any);
-            } else {
-                await createTable(runtime, tableName, tableDefinition as any);
+                await modifyTableRuntime(runtime, tableName, tableDefinition);
+            }
+            else {
+                await createTable(runtime, tableName, tableDefinition);
             }
-
             // 记录处理过的表名（用于清理缓存）
             processedTables.push(tableName);
         }
-
         // 清理 Redis 缓存（如果有表被处理）
         if (processedTables.length > 0) {
             const cacheKeys = processedTables.map((tableName) => CacheKeys.tableColumns(tableName));
             await ctx.redis.delBatch(cacheKeys);
         }
-    } catch (error: any) {
+    }
+    catch (error) {
         Logger.error({ err: error }, "数据库同步失败");
         throw error;
     }
-}) as SyncTableFn;
-
+});
 /* ========================================================================== */
 /* 版本/常量/运行时方言状态 */
 /* ========================================================================== */
-
 /**
  * 数据库版本要求
  */
@@ -215,8 +119,7 @@ const DB_VERSION_REQUIREMENTS = {
     POSTGRES_MIN_MAJOR: 17,
     SQLITE_MIN_VERSION: "3.50.0",
     SQLITE_MIN_VERSION_NUM: 35000 // 3 * 10000 + 50 * 100
-} as const;
-
+};
 /**
  * 字段变更类型的中文标签映射
  */
@@ -227,8 +130,7 @@ const CHANGE_TYPE_LABELS = {
     default: "默认值",
     nullable: "可空约束",
     unique: "唯一约束"
-} as const;
-
+};
 /**
  * MySQL 表配置
  */
@@ -236,24 +138,14 @@ const MYSQL_TABLE_CONFIG = {
     ENGINE: "InnoDB",
     CHARSET: "utf8mb4",
     COLLATE: "utf8mb4_0900_ai_ci"
-} as const;
-
-type SystemFieldMeta = {
-    name: "id" | "created_at" | "updated_at" | "deleted_at" | "state";
-    comment: string;
-    needsIndex: boolean;
-    mysqlDdl: string;
-    pgDdl: string;
-    sqliteDdl: string;
 };
-
 /**
  * 系统字段定义：三处会用到
  * - createTable：建表时追加系统字段列定义
  * - modifyTable：对已存在的表补齐缺失的系统字段
  * - SYSTEM_INDEX_FIELDS：从 needsIndex 派生默认系统索引集合
  */
-const SYSTEM_FIELDS: ReadonlyArray<SystemFieldMeta> = [
+const SYSTEM_FIELDS = [
     {
         name: "id",
         comment: "主键ID",
@@ -295,23 +187,19 @@ const SYSTEM_FIELDS: ReadonlyArray<SystemFieldMeta> = [
         sqliteDdl: "INTEGER NOT NULL DEFAULT 1"
     }
 ];
-
 /**
  * 需要创建索引的系统字段
  */
-const SYSTEM_INDEX_FIELDS: ReadonlyArray<string> = SYSTEM_FIELDS.filter((f) => f.needsIndex).map((f) => f.name);
-
-const SYSTEM_FIELD_META_MAP: Record<string, SystemFieldMeta> = {};
+const SYSTEM_INDEX_FIELDS = SYSTEM_FIELDS.filter((f) => f.needsIndex).map((f) => f.name);
+const SYSTEM_FIELD_META_MAP = {};
 for (const f of SYSTEM_FIELDS) {
     SYSTEM_FIELD_META_MAP[f.name] = f;
 }
-
 const SYNC_TABLE_TEST_KIT = {
     DB_VERSION_REQUIREMENTS: DB_VERSION_REQUIREMENTS,
     CHANGE_TYPE_LABELS: CHANGE_TYPE_LABELS,
     MYSQL_TABLE_CONFIG: MYSQL_TABLE_CONFIG,
     SYSTEM_INDEX_FIELDS: SYSTEM_INDEX_FIELDS,
-
     getTypeMapping: getTypeMapping,
     quoteIdentifier: quoteIdentifier,
     escapeComment: escapeComment,
@@ -326,12 +214,10 @@ const SYNC_TABLE_TEST_KIT = {
     generateDDLClause: generateDDLClause,
     isCompatibleTypeChange: isCompatibleTypeChange,
     compareFieldDefinition: compareFieldDefinition,
-
     tableExistsRuntime: tableExistsRuntime,
     getTableColumnsRuntime: getTableColumnsRuntime,
     getTableIndexesRuntime: getTableIndexesRuntime,
-
-    createRuntime: (dbDialect: DbDialect, db: SqlExecutor, dbName: string = ""): SyncRuntime => {
+    createRuntime: (dbDialect, db, dbName = "") => {
         return {
             dbDialect: dbDialect,
             db: db,
@@ -339,10 +225,8 @@ const SYNC_TABLE_TEST_KIT = {
         };
     }
 };
-
 // 测试能力挂载（避免导出零散函数，同时确保运行时存在）
 syncTable.TestKit = SYNC_TABLE_TEST_KIT;
-
 // 防御性：避免运行时被误覆盖（只读），但仍保持可枚举/可访问。
 Object.defineProperty(syncTable, "TestKit", {
     value: SYNC_TABLE_TEST_KIT,
@@ -350,11 +234,10 @@ Object.defineProperty(syncTable, "TestKit", {
     enumerable: true,
     configurable: false
 });
-
 /**
  * 获取字段类型映射（根据当前数据库类型）
  */
-function getTypeMapping(dbDialect: DbDialect): Record<string, string> {
+function getTypeMapping(dbDialect) {
     return {
         number: dbDialect === "sqlite" ? "INTEGER" : dbDialect === "postgresql" ? "BIGINT" : "BIGINT",
         string: dbDialect === "sqlite" ? "TEXT" : dbDialect === "postgresql" ? "character varying" : "VARCHAR",
@@ -365,32 +248,27 @@ function getTypeMapping(dbDialect: DbDialect): Record<string, string> {
         array_number_text: dbDialect === "mysql" ? "MEDIUMTEXT" : "TEXT"
     };
 }
-
 /* ========================================================================== */
 /* 通用工具与 DDL 片段生成 */
 /* ========================================================================== */
-
 /**
  * 根据数据库类型引用标识符
  */
-function quoteIdentifier(dbDialect: DbDialect, identifier: string): string {
+function quoteIdentifier(dbDialect, identifier) {
     return getDialectByName(dbDialect).quoteIdent(identifier);
 }
-
 /**
  * 转义 SQL 注释中的双引号
  */
-function escapeComment(str: string): string {
+function escapeComment(str) {
     return String(str).replace(/"/g, '\\"');
 }
-
 // 注意：这里刻意不封装“logFieldChange/formatFieldList”之类的一次性工具函数，
 // 以减少抽象层级（按项目要求：能直写就直写）。
-
 /**
  * 为字段定义应用默认值
  */
-function applyFieldDefaults(fieldDef: any): void {
+function applyFieldDefaults(fieldDef) {
     fieldDef.detail = fieldDef.detail ?? "";
     fieldDef.min = fieldDef.min ?? 0;
     fieldDef.max = fieldDef.max ?? (fieldDef.type === "number" ? Number.MAX_SAFE_INTEGER : 100);
@@ -401,18 +279,16 @@ function applyFieldDefaults(fieldDef: any): void {
     fieldDef.unsigned = fieldDef.unsigned ?? true;
     fieldDef.regexp = fieldDef.regexp ?? null;
 }
-
 /**
  * 判断是否为字符串或数组类型（需要长度参数）
  */
-function isStringOrArrayType(fieldType: string): boolean {
+function isStringOrArrayType(fieldType) {
     return fieldType === "string" || fieldType === "array_string" || fieldType === "array_number_string";
 }
-
 /**
  * 获取 SQL 数据类型
  */
-function getSqlType(dbDialect: DbDialect, fieldType: string, fieldMax: number | null, unsigned: boolean = false): string {
+function getSqlType(dbDialect, fieldType, fieldMax, unsigned = false) {
     const typeMapping = getTypeMapping(dbDialect);
     if (isStringOrArrayType(fieldType)) {
         return `${typeMapping[fieldType]}(${fieldMax})`;
@@ -423,15 +299,13 @@ function getSqlType(dbDialect: DbDialect, fieldType: string, fieldMax: number |
     }
     return baseType;
 }
-
 /**
  * 处理默认值：将 null 或 'null' 字符串转换为对应类型的默认值
  */
-function resolveDefaultValue(fieldDefault: any, fieldType: string): any {
+function resolveDefaultValue(fieldDefault, fieldType) {
     if (fieldDefault !== null && fieldDefault !== "null") {
         return fieldDefault;
     }
-
     switch (fieldType) {
         case "number":
             return 0;
@@ -448,31 +322,28 @@ function resolveDefaultValue(fieldDefault: any, fieldType: string): any {
             return fieldDefault;
     }
 }
-
 /**
  * 生成 SQL DEFAULT 子句
  */
-function generateDefaultSql(actualDefault: any, fieldType: string): string {
+function generateDefaultSql(actualDefault, fieldType) {
     if (fieldType === "text" || fieldType === "array_text" || actualDefault === "null") {
         return "";
     }
-
     if (fieldType === "number" || fieldType === "string" || fieldType === "array_string" || fieldType === "array_number_string") {
         if (typeof actualDefault === "number" && !Number.isNaN(actualDefault)) {
             return ` DEFAULT ${actualDefault}`;
-        } else {
+        }
+        else {
             const escaped = String(actualDefault).replace(/'/g, "''");
             return ` DEFAULT '${escaped}'`;
         }
     }
-
     return "";
 }
-
 /**
  * 构建索引操作 SQL（统一使用在线策略）
  */
-function buildIndexSQL(dbDialect: DbDialect, tableName: string, indexName: string, fieldName: string, action: "create" | "drop"): string {
+function buildIndexSQL(dbDialect, tableName, indexName, fieldName, action) {
     // 说明（策略取舍）：
     // - MySQL：通过 ALTER TABLE 在线添加/删除索引；配合 ALGORITHM/LOCK 以降低阻塞。
     // - PostgreSQL：CREATE/DROP INDEX CONCURRENTLY 尽量减少锁表（代价是执行更慢/有并发限制）。
@@ -480,123 +351,108 @@ function buildIndexSQL(dbDialect: DbDialect, tableName: string, indexName: strin
     const tableQuoted = quoteIdentifier(dbDialect, tableName);
     const indexQuoted = quoteIdentifier(dbDialect, indexName);
     const fieldQuoted = quoteIdentifier(dbDialect, fieldName);
-
     if (dbDialect === "mysql") {
-        const parts: string[] = [];
+        const parts = [];
         if (action === "create") {
             parts.push(`ADD INDEX ${indexQuoted} (${fieldQuoted})`);
-        } else {
+        }
+        else {
             parts.push(`DROP INDEX ${indexQuoted}`);
         }
         return `ALTER TABLE ${tableQuoted} ALGORITHM=INPLACE, LOCK=NONE, ${parts.join(", ")}`;
     }
-
     if (dbDialect === "postgresql") {
         if (action === "create") {
             return `CREATE INDEX CONCURRENTLY IF NOT EXISTS ${indexQuoted} ON ${tableQuoted}(${fieldQuoted})`;
         }
         return `DROP INDEX CONCURRENTLY IF EXISTS ${indexQuoted}`;
     }
-
     if (action === "create") {
         return `CREATE INDEX IF NOT EXISTS ${indexQuoted} ON ${tableQuoted}(${fieldQuoted})`;
     }
     return `DROP INDEX IF EXISTS ${indexQuoted}`;
 }
-
 /**
  * 获取单个系统字段的列定义（用于 ADD COLUMN 或 CREATE TABLE）
  */
-function getSystemColumnDef(dbDialect: DbDialect, fieldName: string): string | null {
+function getSystemColumnDef(dbDialect, fieldName) {
     const meta = SYSTEM_FIELD_META_MAP[fieldName];
-    if (!meta) return null;
-
+    if (!meta)
+        return null;
     const colQuoted = quoteIdentifier(dbDialect, meta.name);
     if (dbDialect === "mysql") {
         return `${colQuoted} ${meta.mysqlDdl} COMMENT "${escapeComment(meta.comment)}"`;
     }
-
     if (dbDialect === "postgresql") {
         return `${colQuoted} ${meta.pgDdl}`;
     }
-
     return `${colQuoted} ${meta.sqliteDdl}`;
 }
-
 /**
  * 构建系统字段列定义
  */
-function buildSystemColumnDefs(dbDialect: DbDialect): string[] {
-    const defs: string[] = [];
+function buildSystemColumnDefs(dbDialect) {
+    const defs = [];
     for (const f of SYSTEM_FIELDS) {
         const d = getSystemColumnDef(dbDialect, f.name);
-        if (d) defs.push(d);
+        if (d)
+            defs.push(d);
     }
     return defs;
 }
-
 /**
  * 构建业务字段列定义
  */
-function buildBusinessColumnDefs(dbDialect: DbDialect, fields: Record<string, FieldDefinition>): string[] {
-    const colDefs: string[] = [];
-
+function buildBusinessColumnDefs(dbDialect, fields) {
+    const colDefs = [];
     for (const [fieldKey, fieldDef] of Object.entries(fields)) {
         const dbFieldName = snakeCase(fieldKey);
         const colQuoted = quoteIdentifier(dbDialect, dbFieldName);
-
         const sqlType = getSqlType(dbDialect, fieldDef.type, fieldDef.max, fieldDef.unsigned);
-
         const actualDefault = resolveDefaultValue(fieldDef.default, fieldDef.type);
         const defaultSql = generateDefaultSql(actualDefault, fieldDef.type);
-
         const uniqueSql = fieldDef.unique ? " UNIQUE" : "";
         const nullableSql = fieldDef.nullable ? " NULL" : " NOT NULL";
-
         if (dbDialect === "mysql") {
             colDefs.push(`${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql} COMMENT "${escapeComment(fieldDef.name)}"`);
-        } else {
+        }
+        else {
             colDefs.push(`${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql}`);
         }
     }
-
     return colDefs;
 }
-
 /**
  * 生成字段 DDL 子句（不含 ALTER TABLE 前缀）
  */
-function generateDDLClause(dbDialect: DbDialect, fieldKey: string, fieldDef: FieldDefinition, isAdd: boolean = false): string {
+function generateDDLClause(dbDialect, fieldKey, fieldDef, isAdd = false) {
     // 说明（策略取舍）：
     // - MySQL：ADD/MODIFY 一条子句内可同时表达类型/可空/默认值/注释（同步成本低）。
     // - PostgreSQL：modify 场景这里仅生成 TYPE 变更；默认值/注释等由其他子句或 commentActions 处理。
     // - SQLite：不支持标准化的 MODIFY COLUMN，这里仅提供 ADD COLUMN；复杂变更通过 rebuildSqliteTable 完成。
     const dbFieldName = snakeCase(fieldKey);
     const colQuoted = quoteIdentifier(dbDialect, dbFieldName);
-
     const sqlType = getSqlType(dbDialect, fieldDef.type, fieldDef.max, fieldDef.unsigned);
-
     const actualDefault = resolveDefaultValue(fieldDef.default, fieldDef.type);
     const defaultSql = generateDefaultSql(actualDefault, fieldDef.type);
-
     const uniqueSql = fieldDef.unique ? " UNIQUE" : "";
     const nullableSql = fieldDef.nullable ? " NULL" : " NOT NULL";
-
     if (dbDialect === "mysql") {
         return `${isAdd ? "ADD COLUMN" : "MODIFY COLUMN"} ${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql} COMMENT "${escapeComment(fieldDef.name)}"`;
     }
     if (dbDialect === "postgresql") {
-        if (isAdd) return `ADD COLUMN IF NOT EXISTS ${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql}`;
+        if (isAdd)
+            return `ADD COLUMN IF NOT EXISTS ${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql}`;
         return `ALTER COLUMN ${colQuoted} TYPE ${sqlType}`;
     }
-    if (isAdd) return `ADD COLUMN IF NOT EXISTS ${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql}`;
+    if (isAdd)
+        return `ADD COLUMN IF NOT EXISTS ${colQuoted} ${sqlType}${uniqueSql}${nullableSql}${defaultSql}`;
     return "";
 }
-
 /**
  * 安全执行 DDL 语句（MySQL 降级策略）
  */
-async function executeDDLSafely(db: SqlExecutor, stmt: string): Promise<boolean> {
+async function executeDDLSafely(db, stmt) {
     // MySQL DDL 兼容性/可用性兜底：
     // - 优先执行原语句（通常含 ALGORITHM=INSTANT）。
     // - 若 INSTANT 不可用（版本/表结构限制），降级为 INPLACE 再试。
@@ -604,16 +460,17 @@ async function executeDDLSafely(db: SqlExecutor, stmt: string): Promise<boolean>
     try {
         await db.unsafe(stmt);
         return true;
-    } catch (error: any) {
+    }
+    catch (error) {
         if (stmt.includes("ALGORITHM=INSTANT")) {
             const inplaceSql = stmt.replace(/ALGORITHM=INSTANT/g, "ALGORITHM=INPLACE");
             try {
                 await db.unsafe(inplaceSql);
                 return true;
-            } catch {
+            }
+            catch {
                 let traditionSql = stmt;
                 traditionSql = traditionSql.replace(/\bALGORITHM\s*=\s*(INPLACE|INSTANT)\b\s*,?\s*/g, "").replace(/\bLOCK\s*=\s*(NONE|SHARED|EXCLUSIVE)\b\s*,?\s*/g, "");
-
                 traditionSql = traditionSql
                     .replace(/,\s*,/g, ", ")
                     .replace(/,\s*$/g, "")
@@ -622,16 +479,16 @@ async function executeDDLSafely(db: SqlExecutor, stmt: string): Promise<boolean>
                 await db.unsafe(traditionSql);
                 return true;
             }
-        } else {
+        }
+        else {
             throw error;
         }
     }
 }
-
 /**
  * 判断是否为兼容的类型变更（宽化型变更，无数据丢失风险）
  */
-function isCompatibleTypeChange(currentType: string, newType: string): boolean {
+function isCompatibleTypeChange(currentType, newType) {
     // 说明：该函数用于“自动同步”里的安全阈值判断。
     // - 允许：宽化型变更（不收缩、不改变语义大类），例如：
     //   - INT -> BIGINT（或 tinyint/smallint/mediumint -> 更宽的整型）
@@ -640,50 +497,28 @@ function isCompatibleTypeChange(currentType: string, newType: string): boolean {
     // - 禁止：收缩型变更（BIGINT -> INT、TEXT -> VARCHAR）以及跨大类变更（需人工评估/迁移）。
     const c = String(currentType || "").toLowerCase();
     const n = String(newType || "").toLowerCase();
-
-    if (c === n) return false;
-
+    if (c === n)
+        return false;
     const cBase = c
         .replace(/\s*unsigned/gi, "")
         .replace(/\([^)]*\)/g, "")
         .trim();
-
     const nBase = n
         .replace(/\s*unsigned/gi, "")
         .replace(/\([^)]*\)/g, "")
         .trim();
-
     const intTypes = ["tinyint", "smallint", "mediumint", "int", "integer", "bigint"];
     const cIntIdx = intTypes.indexOf(cBase);
     const nIntIdx = intTypes.indexOf(nBase);
     if (cIntIdx !== -1 && nIntIdx !== -1 && nIntIdx > cIntIdx) {
         return true;
     }
-
-    if (cBase === "varchar" && (nBase === "text" || nBase === "mediumtext" || nBase === "longtext")) return true;
-    if (cBase === "character varying" && nBase === "text") return true;
-
+    if (cBase === "varchar" && (nBase === "text" || nBase === "mediumtext" || nBase === "longtext"))
+        return true;
+    if (cBase === "character varying" && nBase === "text")
+        return true;
     return false;
 }
-
-type SyncRuntime = {
-    /**
-     * 当前数据库方言（mysql/postgresql/sqlite），决定 SQL 片段与元信息查询方式。
-     * 约束：必须与 ctx.config.db.type 一致（经归一化）。
-     */
-    dbDialect: DbDialect;
-    /**
-     * SQL 执行器：必须复用 ctx.db。
-     * 约束：syncTable 内部禁止新建 DB 连接/事务；runtime 仅保存引用，不拥有生命周期。
-     */
-    db: SqlExecutor;
-    /**
-     * 数据库名：主要用于 MySQL information_schema 查询。
-     * 约束：PG/SQLite 可以传空字符串；不要在非 MySQL 方言依赖该值。
-     */
-    dbName: string;
-};
-
 /* ========================================================================== */
 /* runtime I/O（只读：读库/元信息查询）
  *
@@ -693,43 +528,41 @@ type SyncRuntime = {
  * - 对外不再保留 dbDialect/db/dbName 形式的 wrapper；统一使用 runtime 形态（更直写）。
  */
 /* ========================================================================== */
-
 // ---------------------------------------------------------------------------
 // 读：表是否存在
 // ---------------------------------------------------------------------------
-
-async function tableExistsRuntime(runtime: SyncRuntime, tableName: string): Promise<boolean> {
-    if (!runtime.db) throw new Error("SQL 执行器未初始化");
+async function tableExistsRuntime(runtime, tableName) {
+    if (!runtime.db)
+        throw new Error("SQL 执行器未初始化");
     try {
         // 统一交由方言层构造 SQL；syncTable 仅决定“要查哪个 schema/db”。
         // - MySQL：传 runtime.dbName（information_schema.table_schema）
         // - PostgreSQL：固定 public（项目约定）
         // - SQLite：忽略 schema
-        let schema: string | undefined = undefined;
+        let schema = undefined;
         if (runtime.dbDialect === "mysql") {
             schema = runtime.dbName;
-        } else if (runtime.dbDialect === "postgresql") {
+        }
+        else if (runtime.dbDialect === "postgresql") {
             schema = "public";
         }
-
         const q = getDialectByName(runtime.dbDialect).tableExistsQuery(tableName, schema);
-        const res = await runtime.db.unsafe<MySqlTableExistsRow[] | PgTableExistsRow[]>(q.sql, q.params);
+        const res = await runtime.db.unsafe(q.sql, q.params);
         return (res.data?.[0]?.count || 0) > 0;
-    } catch (error: any) {
+    }
+    catch (error) {
         const errMsg = String(error?.message || error);
-        const outErr: any = new Error(`runtime I/O 失败: op=tableExists table=${tableName} err=${errMsg}`);
-        if (error?.sqlInfo) outErr.sqlInfo = error.sqlInfo;
+        const outErr = new Error(`runtime I/O 失败: op=tableExists table=${tableName} err=${errMsg}`);
+        if (error?.sqlInfo)
+            outErr.sqlInfo = error.sqlInfo;
         throw outErr;
     }
 }
-
 // ---------------------------------------------------------------------------
 // 读：列信息
 // ---------------------------------------------------------------------------
-
-async function getTableColumnsRuntime(runtime: SyncRuntime, tableName: string): Promise<{ [key: string]: ColumnInfo }> {
-    const columns: { [key: string]: ColumnInfo } = {};
-
+async function getTableColumnsRuntime(runtime, tableName) {
+    const columns = {};
     try {
         // 方言差异说明：
         // - MySQL：information_schema.columns 最完整，包含 COLUMN_TYPE 与 COLUMN_COMMENT。
@@ -737,10 +570,9 @@ async function getTableColumnsRuntime(runtime: SyncRuntime, tableName: string):
         // - SQLite：PRAGMA table_info 仅提供 type/notnull/default 等有限信息，无列注释。
         if (runtime.dbDialect === "mysql") {
             const q = getSyncTableColumnsInfoQuery({ dialect: "mysql", table: tableName, dbName: runtime.dbName });
-            const result = await runtime.db.unsafe<MySqlColumnInfoRow[]>(q.columns.sql, q.columns.params);
+            const result = await runtime.db.unsafe(q.columns.sql, q.columns.params);
             for (const row of result.data) {
                 const defaultValue = row.COLUMN_DEFAULT;
-
                 columns[row.COLUMN_NAME] = {
                     type: row.DATA_TYPE,
                     columnType: row.COLUMN_TYPE,
@@ -751,13 +583,14 @@ async function getTableColumnsRuntime(runtime: SyncRuntime, tableName: string):
                     comment: row.COLUMN_COMMENT
                 };
             }
-        } else if (runtime.dbDialect === "postgresql") {
+        }
+        else if (runtime.dbDialect === "postgresql") {
             const q = getSyncTableColumnsInfoQuery({ dialect: "postgresql", table: tableName, dbName: runtime.dbName });
-            const result = await runtime.db.unsafe<PgColumnInfoRow[]>(q.columns.sql, q.columns.params);
-            const comments = q.comments ? (await runtime.db.unsafe<PgColumnCommentRow[]>(q.comments.sql, q.comments.params)).data : [];
-            const commentMap: { [key: string]: string } = {};
-            for (const r of comments) commentMap[r.column_name] = r.column_comment;
-
+            const result = await runtime.db.unsafe(q.columns.sql, q.columns.params);
+            const comments = q.comments ? (await runtime.db.unsafe(q.comments.sql, q.comments.params)).data : [];
+            const commentMap = {};
+            for (const r of comments)
+                commentMap[r.column_name] = r.column_comment;
             for (const row of result.data) {
                 columns[row.column_name] = {
                     type: row.data_type,
@@ -769,9 +602,10 @@ async function getTableColumnsRuntime(runtime: SyncRuntime, tableName: string):
                     comment: commentMap[row.column_name] ?? null
                 };
             }
-        } else if (runtime.dbDialect === "sqlite") {
+        }
+        else if (runtime.dbDialect === "sqlite") {
             const q = getSyncTableColumnsInfoQuery({ dialect: "sqlite", table: tableName, dbName: runtime.dbName });
-            const result = await runtime.db.unsafe<SqliteTableInfoRow[]>(q.columns.sql, q.columns.params);
+            const result = await runtime.db.unsafe(q.columns.sql, q.columns.params);
             for (const row of result.data) {
                 let baseType = String(row.type || "").toUpperCase();
                 let max = null;
@@ -791,23 +625,21 @@ async function getTableColumnsRuntime(runtime: SyncRuntime, tableName: string):
                 };
             }
         }
-
         return columns;
-    } catch (error: any) {
+    }
+    catch (error) {
         const errMsg = String(error?.message || error);
-        const outErr: any = new Error(`runtime I/O 失败: op=getTableColumns table=${tableName} err=${errMsg}`);
-        if (error?.sqlInfo) outErr.sqlInfo = error.sqlInfo;
+        const outErr = new Error(`runtime I/O 失败: op=getTableColumns table=${tableName} err=${errMsg}`);
+        if (error?.sqlInfo)
+            outErr.sqlInfo = error.sqlInfo;
         throw outErr;
     }
 }
-
 // ---------------------------------------------------------------------------
 // 读：索引信息（单列索引）
 // ---------------------------------------------------------------------------
-
-async function getTableIndexesRuntime(runtime: SyncRuntime, tableName: string): Promise<IndexInfo> {
-    const indexes: IndexInfo = {};
-
+async function getTableIndexesRuntime(runtime, tableName) {
+    const indexes = {};
     try {
         // 方言差异说明：
         // - MySQL：information_schema.statistics 直接给出 index -> column 映射。
@@ -815,14 +647,16 @@ async function getTableIndexesRuntime(runtime: SyncRuntime, tableName: string):
         // - SQLite：PRAGMA index_list + index_info；同样仅收集单列索引，避免多列索引误判。
         if (runtime.dbDialect === "mysql") {
             const q = getSyncTableIndexesQuery({ dialect: "mysql", table: tableName, dbName: runtime.dbName });
-            const result = await runtime.db.unsafe<MySqlIndexRow[]>(q.sql, q.params);
+            const result = await runtime.db.unsafe(q.sql, q.params);
             for (const row of result.data) {
-                if (!indexes[row.INDEX_NAME]) indexes[row.INDEX_NAME] = [];
+                if (!indexes[row.INDEX_NAME])
+                    indexes[row.INDEX_NAME] = [];
                 indexes[row.INDEX_NAME].push(row.COLUMN_NAME);
             }
-        } else if (runtime.dbDialect === "postgresql") {
+        }
+        else if (runtime.dbDialect === "postgresql") {
             const q = getSyncTableIndexesQuery({ dialect: "postgresql", table: tableName, dbName: runtime.dbName });
-            const result = await runtime.db.unsafe<PgIndexRow[]>(q.sql, q.params);
+            const result = await runtime.db.unsafe(q.sql, q.params);
             for (const row of result.data) {
                 const m = /\(([^)]+)\)/.exec(row.indexdef);
                 if (m) {
@@ -830,38 +664,39 @@ async function getTableIndexesRuntime(runtime: SyncRuntime, tableName: string):
                     indexes[row.indexname] = [col];
                 }
             }
-        } else if (runtime.dbDialect === "sqlite") {
+        }
+        else if (runtime.dbDialect === "sqlite") {
             const quotedTable = quoteIdentifier("sqlite", tableName);
-            const list = await runtime.db.unsafe<SqliteIndexListRow[]>(`PRAGMA index_list(${quotedTable})`);
+            const list = await runtime.db.unsafe(`PRAGMA index_list(${quotedTable})`);
             for (const idx of list.data) {
                 const quotedIndex = quoteIdentifier("sqlite", idx.name);
-                const info = await runtime.db.unsafe<SqliteIndexInfoRow[]>(`PRAGMA index_info(${quotedIndex})`);
+                const info = await runtime.db.unsafe(`PRAGMA index_info(${quotedIndex})`);
                 const cols = info.data.map((r) => r.name);
-                if (cols.length === 1) indexes[idx.name] = cols;
+                if (cols.length === 1)
+                    indexes[idx.name] = cols;
             }
         }
-
         return indexes;
-    } catch (error: any) {
+    }
+    catch (error) {
         const errMsg = String(error?.message || error);
-        const outErr: any = new Error(`runtime I/O 失败: op=getTableIndexes table=${tableName} err=${errMsg}`);
-        if (error?.sqlInfo) outErr.sqlInfo = error.sqlInfo;
+        const outErr = new Error(`runtime I/O 失败: op=getTableIndexes table=${tableName} err=${errMsg}`);
+        if (error?.sqlInfo)
+            outErr.sqlInfo = error.sqlInfo;
         throw outErr;
     }
 }
-
 // ---------------------------------------------------------------------------
 // 读：数据库版本
 // ---------------------------------------------------------------------------
-
 /**
  * 数据库版本检查（按方言）
  */
-async function ensureDbVersion(dbDialect: DbDialect, db: SqlExecutor): Promise<void> {
-    if (!db) throw new Error("SQL 执行器未初始化");
-
+async function ensureDbVersion(dbDialect, db) {
+    if (!db)
+        throw new Error("SQL 执行器未初始化");
     if (dbDialect === "mysql") {
-        const r = await db.unsafe<Array<{ version: string }>>("SELECT VERSION() AS version");
+        const r = await db.unsafe("SELECT VERSION() AS version");
         if (!r.data || r.data.length === 0 || !r.data[0]?.version) {
             throw new Error("无法获取 MySQL 版本信息");
         }
@@ -872,9 +707,8 @@ async function ensureDbVersion(dbDialect: DbDialect, db: SqlExecutor): Promise<v
         }
         return;
     }
-
     if (dbDialect === "postgresql") {
-        const r = await db.unsafe<Array<{ version: string }>>("SELECT version() AS version");
+        const r = await db.unsafe("SELECT version() AS version");
         if (!r.data || r.data.length === 0 || !r.data[0]?.version) {
             throw new Error("无法获取 PostgreSQL 版本信息");
         }
@@ -886,9 +720,8 @@ async function ensureDbVersion(dbDialect: DbDialect, db: SqlExecutor): Promise<v
         }
         return;
     }
-
     if (dbDialect === "sqlite") {
-        const r = await db.unsafe<Array<{ version: string }>>("SELECT sqlite_version() AS version");
+        const r = await db.unsafe("SELECT sqlite_version() AS version");
         if (!r.data || r.data.length === 0 || !r.data[0]?.version) {
             throw new Error("无法获取 SQLite 版本信息");
         }
@@ -903,13 +736,11 @@ async function ensureDbVersion(dbDialect: DbDialect, db: SqlExecutor): Promise<v
         return;
     }
 }
-
 /**
  * 比较字段定义变化
  */
-function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo, fieldDef: FieldDefinition): FieldChange[] {
-    const changes: FieldChange[] = [];
-
+function compareFieldDefinition(dbDialect, existingColumn, fieldDef) {
+    const changes = [];
     // SQLite 元信息能力较弱：
     // - 列注释：sqlite 无 information_schema 注释，PRAGMA table_info 也不提供 comment
     // - 字符串长度：sqlite 类型系统宽松，长度/类型信息不稳定（易产生误报）
@@ -923,7 +754,6 @@ function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo
             });
         }
     }
-
     if (dbDialect !== "sqlite") {
         const currentComment = existingColumn.comment || "";
         if (currentComment !== fieldDef.name) {
@@ -934,11 +764,9 @@ function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo
             });
         }
     }
-
     const typeMapping = getTypeMapping(dbDialect);
     const expectedType = typeMapping[fieldDef.type].toLowerCase();
     const currentType = existingColumn.type.toLowerCase();
-
     if (currentType !== expectedType) {
         changes.push({
             type: "datatype",
@@ -946,7 +774,6 @@ function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo
             expected: expectedType
         });
     }
-
     const expectedNullable = fieldDef.nullable;
     if (existingColumn.nullable !== expectedNullable) {
         changes.push({
@@ -955,7 +782,6 @@ function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo
             expected: expectedNullable
         });
     }
-
     const expectedDefault = resolveDefaultValue(fieldDef.default, fieldDef.type);
     if (String(existingColumn.defaultValue) !== String(expectedDefault)) {
         changes.push({
@@ -964,18 +790,15 @@ function compareFieldDefinition(dbDialect: DbDialect, existingColumn: ColumnInfo
             expected: expectedDefault
         });
     }
-
     return changes;
 }
-
 /* ========================================================================== */
 /* plan/apply & 建表/改表（核心同步逻辑） */
 /* ========================================================================== */
-
 /**
  * SQLite 重建表迁移（简化版）
  */
-async function rebuildSqliteTable(runtime: SyncRuntime, tableName: string, fields: Record<string, FieldDefinition>): Promise<void> {
+async function rebuildSqliteTable(runtime, tableName, fields) {
     // 说明：SQLite ALTER TABLE 能力有限（尤其是修改列类型/默认值/约束）。
     // 策略：创建临时表 -> 复制“交集列”数据 -> 删除旧表 -> 临时表改名。
     // - 只复制 targetCols 与 existingCols 的交集，避免因新增列/删除列导致 INSERT 失败。
@@ -983,66 +806,66 @@ async function rebuildSqliteTable(runtime: SyncRuntime, tableName: string, field
     if (runtime.dbDialect !== "sqlite") {
         throw new Error(`rebuildSqliteTable 仅支持 sqlite 方言，当前: ${String(runtime.dbDialect)}`);
     }
-
     const quotedSourceTable = quoteIdentifier("sqlite", tableName);
-    const info = await runtime.db.unsafe<SqliteTableInfoRow[]>(`PRAGMA table_info(${quotedSourceTable})`);
+    const info = await runtime.db.unsafe(`PRAGMA table_info(${quotedSourceTable})`);
     const existingCols = info.data.map((r) => r.name);
     const businessCols = Object.keys(fields).map((k) => snakeCase(k));
     const targetCols = ["id", "created_at", "updated_at", "deleted_at", "state", ...businessCols];
     const tmpTable = `${tableName}__tmp__${Date.now()}`;
-
     await createTable(runtime, tmpTable, fields);
-
     const commonCols = targetCols.filter((c) => existingCols.includes(c));
     if (commonCols.length > 0) {
         const colsSql = commonCols.map((c) => quoteIdentifier("sqlite", c)).join(", ");
         const quotedTmpTable = quoteIdentifier("sqlite", tmpTable);
         await runtime.db.unsafe(`INSERT INTO ${quotedTmpTable} (${colsSql}) SELECT ${colsSql} FROM ${quotedSourceTable}`);
     }
-
     await runtime.db.unsafe(`DROP TABLE ${quotedSourceTable}`);
     const quotedTmpTable = quoteIdentifier("sqlite", tmpTable);
     await runtime.db.unsafe(`ALTER TABLE ${quotedTmpTable} RENAME TO ${quotedSourceTable}`);
 }
-
 /**
  * 将表结构计划应用到数据库
  */
-async function applyTablePlan(runtime: SyncRuntime, tableName: string, fields: Record<string, FieldDefinition>, plan: TablePlan): Promise<void> {
-    if (!plan || !plan.changed) return;
-
+async function applyTablePlan(runtime, tableName, fields, plan) {
+    if (!plan || !plan.changed)
+        return;
     // A) 结构变更（ADD/MODIFY）：SQLite 走重建表；其余方言走 ALTER TABLE
     if (runtime.dbDialect === "sqlite") {
         if (plan.modifyClauses.length > 0 || plan.defaultClauses.length > 0) {
             await rebuildSqliteTable(runtime, tableName, fields);
-        } else {
+        }
+        else {
             for (const c of plan.addClauses) {
                 const stmt = `ALTER TABLE ${quoteIdentifier(runtime.dbDialect, tableName)} ${c}`;
                 await runtime.db.unsafe(stmt);
             }
         }
-    } else {
+    }
+    else {
         const clauses = [...plan.addClauses, ...plan.modifyClauses];
         if (clauses.length > 0) {
             const tableQuoted = quoteIdentifier(runtime.dbDialect, tableName);
             const stmt = runtime.dbDialect === "mysql" ? `ALTER TABLE ${tableQuoted} ALGORITHM=INSTANT, LOCK=NONE, ${clauses.join(", ")}` : `ALTER TABLE ${tableQuoted} ${clauses.join(", ")}`;
-            if (runtime.dbDialect === "mysql") await executeDDLSafely(runtime.db, stmt);
-            else await runtime.db.unsafe(stmt);
+            if (runtime.dbDialect === "mysql")
+                await executeDDLSafely(runtime.db, stmt);
+            else
+                await runtime.db.unsafe(stmt);
         }
     }
-
     // B) 默认值变更：SQLite 不支持在线修改默认值（需要重建表），其余方言按子句执行
     if (plan.defaultClauses.length > 0) {
         if (runtime.dbDialect === "sqlite") {
             Logger.warn(`SQLite 不支持修改默认值，表 ${tableName} 的默认值变更已跳过`);
-        } else {
+        }
+        else {
             const tableQuoted = quoteIdentifier(runtime.dbDialect, tableName);
             const stmt = runtime.dbDialect === "mysql" ? `ALTER TABLE ${tableQuoted} ALGORITHM=INSTANT, LOCK=NONE, ${plan.defaultClauses.join(", ")}` : `ALTER TABLE ${tableQuoted} ${plan.defaultClauses.join(", ")}`;
-            if (runtime.dbDialect === "mysql") await executeDDLSafely(runtime.db, stmt);
-            else await runtime.db.unsafe(stmt);
+            if (runtime.dbDialect === "mysql")
+                await executeDDLSafely(runtime.db, stmt);
+            else
+                await runtime.db.unsafe(stmt);
         }
     }
-
     // C) 索引动作：不同方言的 DDL 策略由 buildIndexSQL 统一生成
     for (const act of plan.indexActions) {
         const stmt = buildIndexSQL(runtime.dbDialect, tableName, act.indexName, act.fieldName, act.action);
@@ -1050,15 +873,16 @@ async function applyTablePlan(runtime: SyncRuntime, tableName: string, fields: R
             await runtime.db.unsafe(stmt);
             if (act.action === "create") {
                 Logger.debug(`[索引变化] 新建索引 ${tableName}.${act.indexName} (${act.fieldName})`);
-            } else {
+            }
+            else {
                 Logger.debug(`[索引变化] 删除索引 ${tableName}.${act.indexName} (${act.fieldName})`);
             }
-        } catch (error: any) {
+        }
+        catch (error) {
             Logger.error({ err: error, table: tableName, index: act.indexName, field: act.fieldName }, `${act.action === "create" ? "创建" : "删除"}索引失败`);
             throw error;
         }
     }
-
     // D) PG 列注释：独立 SQL 执行（COMMENT ON COLUMN）
     if (runtime.dbDialect === "postgresql" && plan.commentActions && plan.commentActions.length > 0) {
         for (const stmt of plan.commentActions) {
@@ -1066,20 +890,16 @@ async function applyTablePlan(runtime: SyncRuntime, tableName: string, fields: R
         }
     }
 }
-
 /**
  * 创建表（包含系统字段和业务字段）
  */
-async function createTable(runtime: SyncRuntime, tableName: string, fields: Record<string, FieldDefinition>, systemIndexFields: ReadonlyArray<string> = SYSTEM_INDEX_FIELDS): Promise<void> {
+async function createTable(runtime, tableName, fields, systemIndexFields = SYSTEM_INDEX_FIELDS) {
     const colDefs = [...buildSystemColumnDefs(runtime.dbDialect), ...buildBusinessColumnDefs(runtime.dbDialect, fields)];
-
     const cols = colDefs.join(",\n            ");
     const tableQuoted = quoteIdentifier(runtime.dbDialect, tableName);
     const { ENGINE, CHARSET, COLLATE } = MYSQL_TABLE_CONFIG;
     const createSQL = runtime.dbDialect === "mysql" ? `CREATE TABLE ${tableQuoted} (\n            ${cols}\n        ) ENGINE=${ENGINE} DEFAULT CHARSET=${CHARSET} COLLATE=${COLLATE}` : `CREATE TABLE ${tableQuoted} (\n            ${cols}\n        )`;
-
     await runtime.db.unsafe(createSQL);
-
     if (runtime.dbDialect === "postgresql") {
         for (const f of SYSTEM_FIELDS) {
             const escaped = String(f.comment).replace(/'/g, "''");
@@ -1087,11 +907,9 @@ async function createTable(runtime: SyncRuntime, tableName: string, fields: Reco
             const stmt = `COMMENT ON COLUMN ${tableQuoted}.${colQuoted} IS '${escaped}'`;
             await runtime.db.unsafe(stmt);
         }
-
         for (const [fieldKey, fieldDef] of Object.entries(fields)) {
             const dbFieldName = snakeCase(fieldKey);
             const colQuoted = quoteIdentifier(runtime.dbDialect, dbFieldName);
-
             const fieldName = fieldDef.name && fieldDef.name !== "null" ? String(fieldDef.name) : "";
             const escaped = fieldName.replace(/'/g, "''");
             const valueSql = fieldName ? `'${escaped}'` : "NULL";
@@ -1099,14 +917,11 @@ async function createTable(runtime: SyncRuntime, tableName: string, fields: Reco
             await runtime.db.unsafe(stmt);
         }
     }
-
-    const indexTasks: Array<Promise<unknown>> = [];
-
-    let existingIndexes: Record<string, string[]> = {};
+    const indexTasks = [];
+    let existingIndexes = {};
     if (runtime.dbDialect === "mysql") {
         existingIndexes = await getTableIndexesRuntime(runtime, tableName);
     }
-
     for (const sysField of systemIndexFields) {
         const indexName = `idx_${sysField}`;
         if (runtime.dbDialect === "mysql" && existingIndexes[indexName]) {
@@ -1115,10 +930,8 @@ async function createTable(runtime: SyncRuntime, tableName: string, fields: Reco
         const stmt = buildIndexSQL(runtime.dbDialect, tableName, indexName, sysField, "create");
         indexTasks.push(runtime.db.unsafe(stmt));
     }
-
     for (const [fieldKey, fieldDef] of Object.entries(fields)) {
         const dbFieldName = snakeCase(fieldKey);
-
         if (fieldDef.index === true && fieldDef.unique !== true) {
             const indexName = `idx_${dbFieldName}`;
             if (runtime.dbDialect === "mysql" && existingIndexes[indexName]) {
@@ -1128,75 +941,63 @@ async function createTable(runtime: SyncRuntime, tableName: string, fields: Reco
             indexTasks.push(runtime.db.unsafe(stmt));
         }
     }
-
     if (indexTasks.length > 0) {
         await Promise.all(indexTasks);
     }
 }
-
-async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, fields: Record<string, FieldDefinition>): Promise<TablePlan> {
+async function modifyTableRuntime(runtime, tableName, fields) {
     // 1) 读取现有元信息（列/索引）
     const existingColumns = await getTableColumnsRuntime(runtime, tableName);
     const existingIndexes = await getTableIndexesRuntime(runtime, tableName);
-
     // 2) 规划变更（先 plan，后统一 apply）
     let changed = false;
-
-    const addClauses: string[] = [];
-    const modifyClauses: string[] = [];
-    const defaultClauses: string[] = [];
-    const indexActions: Array<{ action: "create" | "drop"; indexName: string; fieldName: string }> = [];
-
+    const addClauses = [];
+    const modifyClauses = [];
+    const defaultClauses = [];
+    const indexActions = [];
     // 3) 对比业务字段：新增/变更（类型/长度/可空/默认值/注释）
     for (const [fieldKey, fieldDef] of Object.entries(fields)) {
         const dbFieldName = snakeCase(fieldKey);
-
         if (existingColumns[dbFieldName]) {
             const comparison = compareFieldDefinition(runtime.dbDialect, existingColumns[dbFieldName], fieldDef);
             if (comparison.length > 0) {
                 for (const c of comparison) {
-                    const changeLabel = CHANGE_TYPE_LABELS[c.type as keyof typeof CHANGE_TYPE_LABELS] || "未知";
+                    const changeLabel = CHANGE_TYPE_LABELS[c.type] || "未知";
                     Logger.debug(`  ~ 修改 ${dbFieldName} ${changeLabel}: ${c.current} -> ${c.expected}`);
                 }
-
                 if (isStringOrArrayType(fieldDef.type) && existingColumns[dbFieldName].max && fieldDef.max !== null) {
-                    if (existingColumns[dbFieldName].max! > fieldDef.max) {
+                    if (existingColumns[dbFieldName].max > fieldDef.max) {
                         Logger.warn(`[跳过危险变更] ${tableName}.${dbFieldName} 长度收缩 ${existingColumns[dbFieldName].max} -> ${fieldDef.max} 已被跳过（需手动处理）`);
                     }
                 }
-
                 const hasTypeChange = comparison.some((c) => c.type === "datatype");
                 const hasLengthChange = comparison.some((c) => c.type === "length");
                 const onlyDefaultChanged = comparison.every((c) => c.type === "default");
                 const defaultChanged = comparison.some((c) => c.type === "default");
-
                 if (hasTypeChange) {
                     const typeChange = comparison.find((c) => c.type === "datatype");
                     const currentType = String(typeChange?.current || "").toLowerCase();
                     const typeMapping = getTypeMapping(runtime.dbDialect);
                     const expectedType = typeMapping[fieldDef.type]?.toLowerCase() || "";
-
                     if (!isCompatibleTypeChange(currentType, expectedType)) {
                         const errorMsg = [`禁止字段类型变更: ${tableName}.${dbFieldName}`, `当前类型: ${typeChange?.current}`, `目标类型: ${typeChange?.expected}`, "说明: 仅允许宽化型变更（如 INT->BIGINT, VARCHAR->TEXT），其他类型变更需要手动处理"].join("\n");
                         throw new Error(errorMsg);
                     }
                     Logger.debug(`[兼容类型变更] ${tableName}.${dbFieldName} ${currentType} -> ${expectedType}`);
                 }
-
                 if (defaultChanged) {
                     const actualDefault = resolveDefaultValue(fieldDef.default, fieldDef.type);
-
-                    let v: string | null = null;
+                    let v = null;
                     if (actualDefault !== "null") {
                         const defaultSql = generateDefaultSql(actualDefault, fieldDef.type);
                         v = defaultSql.trim().replace(/^DEFAULT\s+/, "");
                     }
-
                     if (v !== null && v !== "") {
                         if (runtime.dbDialect === "postgresql") {
                             const colQuoted = quoteIdentifier(runtime.dbDialect, dbFieldName);
                             defaultClauses.push(`ALTER COLUMN ${colQuoted} SET DEFAULT ${v}`);
-                        } else if (runtime.dbDialect === "mysql" && onlyDefaultChanged) {
+                        }
+                        else if (runtime.dbDialect === "mysql" && onlyDefaultChanged) {
                             if (fieldDef.type !== "text") {
                                 const colQuoted = quoteIdentifier(runtime.dbDialect, dbFieldName);
                                 defaultClauses.push(`ALTER COLUMN ${colQuoted} SET DEFAULT ${v}`);
@@ -1204,26 +1005,26 @@ async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, field
                         }
                     }
                 }
-
                 if (!onlyDefaultChanged) {
                     let skipModify = false;
                     if (hasLengthChange && isStringOrArrayType(fieldDef.type) && existingColumns[dbFieldName].max && fieldDef.max !== null) {
-                        const isShrink = existingColumns[dbFieldName].max! > fieldDef.max;
-                        if (isShrink) skipModify = true;
+                        const isShrink = existingColumns[dbFieldName].max > fieldDef.max;
+                        if (isShrink)
+                            skipModify = true;
                     }
-
-                    if (!skipModify) modifyClauses.push(generateDDLClause(runtime.dbDialect, fieldKey, fieldDef, false));
+                    if (!skipModify)
+                        modifyClauses.push(generateDDLClause(runtime.dbDialect, fieldKey, fieldDef, false));
                 }
                 changed = true;
             }
-        } else {
+        }
+        else {
             addClauses.push(generateDDLClause(runtime.dbDialect, fieldKey, fieldDef, true));
             changed = true;
         }
     }
-
     // 4) 补齐系统字段（除 id 外）
-    const systemFieldNames = SYSTEM_FIELDS.filter((f) => f.name !== "id").map((f) => f.name) as string[];
+    const systemFieldNames = SYSTEM_FIELDS.filter((f) => f.name !== "id").map((f) => f.name);
     for (const sysFieldName of systemFieldNames) {
         if (!existingColumns[sysFieldName]) {
             const colDef = getSystemColumnDef(runtime.dbDialect, sysFieldName);
@@ -1234,7 +1035,6 @@ async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, field
             }
         }
     }
-
     // 5) 索引动作：系统字段索引 + 业务字段单列索引
     for (const sysField of SYSTEM_INDEX_FIELDS) {
         const idxName = `idx_${sysField}`;
@@ -1244,28 +1044,25 @@ async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, field
             changed = true;
         }
     }
-
     for (const [fieldKey, fieldDef] of Object.entries(fields)) {
         const dbFieldName = snakeCase(fieldKey);
-
         const indexName = `idx_${dbFieldName}`;
         if (fieldDef.index && !fieldDef.unique && !existingIndexes[indexName]) {
             indexActions.push({ action: "create", indexName: indexName, fieldName: dbFieldName });
             changed = true;
-        } else if (!fieldDef.index && existingIndexes[indexName] && existingIndexes[indexName].length === 1) {
+        }
+        else if (!fieldDef.index && existingIndexes[indexName] && existingIndexes[indexName].length === 1) {
             indexActions.push({ action: "drop", indexName: indexName, fieldName: dbFieldName });
             changed = true;
         }
     }
-
     // 6) PG 注释动作（MySQL 在列定义里带 COMMENT；SQLite 无列注释）
-    const commentActions: string[] = [];
+    const commentActions = [];
     if (runtime.dbDialect === "postgresql") {
         const tableQuoted = quoteIdentifier(runtime.dbDialect, tableName);
         for (const [fieldKey, fieldDef] of Object.entries(fields)) {
             const dbFieldName = snakeCase(fieldKey);
             const colQuoted = quoteIdentifier(runtime.dbDialect, dbFieldName);
-
             if (existingColumns[dbFieldName]) {
                 const curr = existingColumns[dbFieldName].comment || "";
                 const want = fieldDef.name && fieldDef.name !== "null" ? String(fieldDef.name) : "";
@@ -1277,11 +1074,9 @@ async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, field
             }
         }
     }
-
     // 7) 汇总计划并应用
     changed = addClauses.length > 0 || modifyClauses.length > 0 || defaultClauses.length > 0 || indexActions.length > 0 || commentActions.length > 0;
-
-    const plan: TablePlan = {
+    const plan = {
         changed: changed,
         addClauses: addClauses,
         modifyClauses: modifyClauses,
@@ -1289,10 +1084,8 @@ async function modifyTableRuntime(runtime: SyncRuntime, tableName: string, field
         indexActions: indexActions,
         commentActions: commentActions
     };
-
     if (plan.changed) {
         await applyTablePlan(runtime, tableName, fields, plan);
     }
-
     return plan;
 }