befly 2.3.1 → 2.3.3

package/scripts/syncDb.js

@@ -1,295 +1,427 @@
 /**
- * 数据库表结构同步脚本 - 仅支持 MySQL 8.0+
+ * 数据库表结构同步脚本 - 支持 sqlite / mysql / postgresql
+ * 注意：MySQL 提供更完整的在线 ALTER 能力；SQLite/PG 的修改能力有差异，部分操作将跳过或分解。
  */
 
 import path from 'node:path';
 import { Env } from '../config/env.js';
 import { Logger } from '../utils/logger.js';
-import { parseFieldRule, createSqlClient } from '../utils/index.js';
+import { createSqlClient, toSnakeTableName, isType, parseRule } from '../utils/index.js';
 import { __dirtables, getProjectDir } from '../system.js';
 import { checkTable } from '../checks/table.js';
 
-const typeMapping = {
-    number: 'BIGINT',
-    string: 'VARCHAR',
-    text: 'MEDIUMTEXT',
-    array: 'VARCHAR'
-};
+// 顶部管理数据库客户端（按需求使用 Bun SQL 模板，不使用 exec 辅助）
+let sql = null;
 
-// 环境开关读取（支持未在 Env 显式声明的变量，默认值兜底）
-const getFlag = (val, def = 0) => {
-    if (val === undefined || val === null || val === '') return !!def;
-    const n = Number(val);
-    if (!Number.isNaN(n)) return n !== 0;
-    const s = String(val).toLowerCase();
-    return s === 'true' || s === 'on' || s === 'yes';
-};
-
-// 命令行参数
+// 方言与类型映射
+const DB = (Env.DB_TYPE || 'mysql').toLowerCase();
+const IS_MYSQL = DB === 'mysql';
+const IS_PG = DB === 'postgresql' || DB === 'postgres';
+const IS_SQLITE = DB === 'sqlite'; // 命令行参数
 const ARGV = Array.isArray(process.argv) ? process.argv : [];
-const CLI = {
-    DRY_RUN: ARGV.includes('--dry-run')
-};
+const IS_PLAN = ARGV.includes('--plan');
 
-const FLAGS = {
-    // DRY-RUN 改为命令行参数控制，忽略环境变量
-    DRY_RUN: CLI.DRY_RUN, // 仅打印计划，不执行
-    MERGE_ALTER: getFlag(Env.SYNC_MERGE_ALTER, 1), // 合并每表多项 DDL
-    ONLINE_INDEX: getFlag(Env.SYNC_ONLINE_INDEX, 1), // 索引操作使用在线算法
-    DISALLOW_SHRINK: getFlag(Env.SYNC_DISALLOW_SHRINK, 1), // 禁止长度收缩
-    ALLOW_TYPE_CHANGE: getFlag(Env.SYNC_ALLOW_TYPE_CHANGE, 0) // 允许类型变更
+// 字段类型映射（按方言）
+const typeMapping = {
+    number: IS_SQLITE ? 'INTEGER' : 'BIGINT',
+    string: IS_SQLITE ? 'TEXT' : IS_PG ? 'character varying' : 'VARCHAR',
+    text: IS_MYSQL ? 'MEDIUMTEXT' : 'TEXT',
+    array: IS_SQLITE ? 'TEXT' : IS_PG ? 'character varying' : 'VARCHAR'
 };
 
-// 计算期望的默认值（与 information_schema 返回的值对齐）
-// 规则：当默认值为 'null' 时按类型提供默认值：number→0，string→""，array→"[]"；text 永不设置默认值
-const getExpectedDefault = (fieldType, fieldDefaultValue) => {
-    if (fieldType === 'text') return null; // TEXT 不设置默认
-    if (fieldDefaultValue !== undefined && fieldDefaultValue !== null && fieldDefaultValue !== 'null') {
-        return fieldDefaultValue; // 保留显式默认值（数字或字符串，包含空字符串）
-    }
-    // 规则为 'null' 时的内置默认
-    switch (fieldType) {
-        case 'number':
-            return 0;
-        case 'string':
-            return '';
-        case 'array':
-            return '[]';
-        default:
-            return null;
-    }
+// 全局统计
+const globalCount = {
+    // 表级
+    processedTables: 0,
+    createdTables: 0,
+    modifiedTables: 0,
+    // 字段与索引级
+    addFields: 0,
+    typeChanges: 0,
+    maxChanges: 0, // 映射为长度变化
+    minChanges: 0, // 最小值不参与 DDL，比对保留为0
+    defaultChanges: 0,
+    nameChanges: 0, // 字段显示名（注释）变更
+    indexCreate: 0,
+    indexDrop: 0
 };
 
-const normalizeDefault = (val) => (val === null || val === undefined ? null : String(val));
-
-// 获取字段的SQL定义
-const getColumnDefinition = (fieldName, rule) => {
-    const [fieldDisplayName, fieldType, fieldMin, fieldMaxLength, fieldDefaultValue, fieldHasIndex] = parseFieldRule(rule);
-
-    let sqlType = typeMapping[fieldType];
-    if (!sqlType) throw new Error(`不支持的数据类型: ${fieldType}`);
+// PG 兼容类型变更识别：无需数据重写的宽化型变更
+const isPgCompatibleTypeChange = (currentType, newType) => {
+    const c = String(currentType || '').toLowerCase();
+    const n = String(newType || '').toLowerCase();
+    // varchar -> text 视为宽化
+    if (c === 'character varying' && n === 'text') return true;
+    // text -> character varying 非宽化（可能截断），不兼容
+    return false;
+};
 
-    // 根据字段类型设置SQL类型和长度
-    if (fieldType === 'string' || fieldType === 'array') {
-        const maxLength = parseInt(fieldMaxLength);
-        sqlType = `VARCHAR(${maxLength})`;
+// 数据库版本检查（按方言）
+const ensureDbVersion = async () => {
+    if (!sql) throw new Error('SQL 客户端未初始化');
+    if (IS_MYSQL) {
+        const r = await sql`SELECT VERSION() AS version`;
+        const version = r[0].version;
+        const majorVersion = parseInt(String(version).split('.')[0], 10);
+        if (!Number.isFinite(majorVersion) || majorVersion < 8) {
+            throw new Error(`此脚本仅支持 MySQL 8.0+，当前版本: ${version}`);
+        }
+        Logger.info(`MySQL 版本: ${version}`);
+        return;
     }
-
-    // 统一强制 NOT NULL
-    let columnDef = `\`${fieldName}\` ${sqlType} NOT NULL`;
-
-    // 设置默认值：类型非 text 时总是设置（显式默认或内置默认）
-    const expectedDefault = getExpectedDefault(fieldType, fieldDefaultValue);
-    if (fieldType !== 'text' && expectedDefault !== null) {
-        if (fieldType === 'number') {
-            columnDef += ` DEFAULT ${expectedDefault}`;
-        } else {
-            columnDef += ` DEFAULT \"${String(expectedDefault).replace(/\"/g, '\\"')}\"`;
+    if (IS_PG) {
+        const r = await sql`SELECT version() AS version`;
+        const versionText = r[0].version;
+        Logger.info(`PostgreSQL 版本: ${versionText}`);
+        const m = /PostgreSQL\s+(\d+)/i.exec(versionText);
+        const major = m ? parseInt(m[1], 10) : NaN;
+        if (!Number.isFinite(major) || major < 17) {
+            throw new Error(`此脚本要求 PostgreSQL >= 17，当前: ${versionText}`);
         }
+        return;
     }
-    // text 类型不设置默认值
-
-    // 添加字段注释（使用第1个属性作为字段显示名称）
-    if (fieldDisplayName && fieldDisplayName !== 'null') {
-        columnDef += ` COMMENT "${fieldDisplayName.replace(/"/g, '\\"')}"`;
+    if (IS_SQLITE) {
+        const r = await sql`SELECT sqlite_version() AS version`;
+        const version = r[0].version;
+        Logger.info(`SQLite 版本: ${version}`);
+        // 强制最低版本：SQLite ≥ 3.50.0
+        const [maj, min, patch] = String(version)
+            .split('.')
+            .map((v) => parseInt(v, 10) || 0);
+        const vnum = maj * 10000 + min * 100 + patch; // 3.50.0 -> 35000
+        if (!Number.isFinite(vnum) || vnum < 35000) {
+            throw new Error(`此脚本要求 SQLite >= 3.50.0，当前: ${version}`);
+        }
+        return;
     }
-
-    return columnDef;
 };
 
-// 通用执行器：直接使用 Bun SQL 参数化（MySQL 使用 '?' 占位符）
-const exec = async (client, query, params = []) => {
-    if (params && params.length > 0) {
-        return await client.unsafe(query, params);
+// 判断表是否存在（返回布尔值）
+const tableExists = async (tableName) => {
+    if (!sql) throw new Error('SQL 客户端未初始化');
+    if (IS_MYSQL) {
+        const res = await sql`SELECT COUNT(*) AS count FROM information_schema.TABLES WHERE TABLE_SCHEMA = ${Env.DB_NAME} AND TABLE_NAME = ${tableName}`;
+        return (res[0]?.count || 0) > 0;
+    }
+    if (IS_PG) {
+        const res = await sql`SELECT COUNT(*)::int AS count FROM information_schema.tables WHERE table_schema = 'public' AND table_name = ${tableName}`;
+        return (res[0]?.count || 0) > 0;
     }
-    return await client.unsafe(query);
+    if (IS_SQLITE) {
+        const res = await sql`SELECT name FROM sqlite_master WHERE type='table' AND name = ${tableName}`;
+        return res.length > 0;
+    }
+    return false;
 };
 
-// 获取表的现有列信息
-const getTableColumns = async (client, tableName) => {
-    const result = await exec(
-        client,
-        `SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT, COLUMN_TYPE
-         FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? ORDER BY ORDINAL_POSITION`,
-        [Env.MYSQL_DB || 'test', tableName]
-    );
-
+// 获取表的现有列信息（按方言）
+const getTableColumns = async (tableName) => {
     const columns = {};
-    result.forEach((row) => {
-        columns[row.COLUMN_NAME] = {
-            type: row.DATA_TYPE,
-            columnType: row.COLUMN_TYPE,
-            length: row.CHARACTER_MAXIMUM_LENGTH,
-            nullable: row.IS_NULLABLE === 'YES',
-            defaultValue: row.COLUMN_DEFAULT,
-            comment: row.COLUMN_COMMENT
-        };
-    });
+    if (IS_MYSQL) {
+        const result = await sql`
+            SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT, COLUMN_TYPE
+            FROM information_schema.COLUMNS
+            WHERE TABLE_SCHEMA = ${Env.DB_NAME} AND TABLE_NAME = ${tableName}
+            ORDER BY ORDINAL_POSITION
+        `;
+        for (const row of result) {
+            columns[row.COLUMN_NAME] = {
+                type: row.DATA_TYPE,
+                columnType: row.COLUMN_TYPE,
+                length: row.CHARACTER_MAXIMUM_LENGTH,
+                nullable: row.IS_NULLABLE === 'YES',
+                defaultValue: row.COLUMN_DEFAULT,
+                comment: row.COLUMN_COMMENT
+            };
+        }
+    } else if (IS_PG) {
+        const result = await sql`SELECT column_name, data_type, character_maximum_length, is_nullable, column_default
+                        FROM information_schema.columns
+                        WHERE table_schema = 'public' AND table_name = ${tableName}
+                        ORDER BY ordinal_position`;
+        // 获取列注释
+        const comments = await sql`SELECT a.attname AS column_name, col_description(c.oid, a.attnum) AS column_comment
+                          FROM pg_class c
+                          JOIN pg_attribute a ON a.attrelid = c.oid
+                          JOIN pg_namespace n ON n.oid = c.relnamespace
+                          WHERE c.relkind = 'r' AND n.nspname = 'public' AND c.relname = ${tableName} AND a.attnum > 0`;
+        const commentMap = {};
+        for (const r of comments) commentMap[r.column_name] = r.column_comment;
+        for (const row of result) {
+            columns[row.column_name] = {
+                type: row.data_type,
+                columnType: row.data_type,
+                length: row.character_maximum_length,
+                nullable: String(row.is_nullable).toUpperCase() === 'YES',
+                defaultValue: row.column_default,
+                comment: commentMap[row.column_name] ?? null
+            };
+        }
+    } else if (IS_SQLITE) {
+        const result = await sql`PRAGMA table_info(${sql(tableName)})`;
+        for (const row of result) {
+            let baseType = String(row.type || '').toUpperCase();
+            let length = null;
+            const m = /^(\w+)\s*\((\d+)\)/.exec(baseType);
+            if (m) {
+                baseType = m[1];
+                length = Number(m[2]);
+            }
+            columns[row.name] = {
+                type: baseType.toLowerCase(),
+                columnType: baseType.toLowerCase(),
+                length: length,
+                nullable: row.notnull === 0,
+                defaultValue: row.dflt_value,
+                comment: null
+            };
+        }
+    }
     return columns;
 };
 
-// 获取表的现有索引信息
-const getTableIndexes = async (client, tableName) => {
-    const result = await exec(
-        client,
-        `SELECT INDEX_NAME, COLUMN_NAME FROM information_schema.STATISTICS
-         WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND INDEX_NAME != 'PRIMARY' ORDER BY INDEX_NAME`,
-        [Env.MYSQL_DB || 'test', tableName]
-    );
-
+// 获取表的现有索引信息（单列索引）
+const getTableIndexes = async (tableName) => {
     const indexes = {};
-    result.forEach((row) => {
-        if (!indexes[row.INDEX_NAME]) indexes[row.INDEX_NAME] = [];
-        indexes[row.INDEX_NAME].push(row.COLUMN_NAME);
-    });
+    if (IS_MYSQL) {
+        const result = await sql`
+                        SELECT INDEX_NAME, COLUMN_NAME
+                        FROM information_schema.STATISTICS
+                        WHERE TABLE_SCHEMA = ${Env.DB_NAME}
+                            AND TABLE_NAME = ${tableName}
+                            AND INDEX_NAME != 'PRIMARY'
+                        ORDER BY INDEX_NAME
+                `;
+        for (const row of result) {
+            if (!indexes[row.INDEX_NAME]) indexes[row.INDEX_NAME] = [];
+            indexes[row.INDEX_NAME].push(row.COLUMN_NAME);
+        }
+    } else if (IS_PG) {
+        const result = await sql`SELECT indexname, indexdef FROM pg_indexes WHERE schemaname = 'public' AND tablename = ${tableName}`;
+        for (const row of result) {
+            const m = /\(([^)]+)\)/.exec(row.indexdef);
+            if (m) {
+                const col = m[1].replace(/\"/g, '').replace(/"/g, '').trim();
+                indexes[row.indexname] = [col];
+            }
+        }
+    } else if (IS_SQLITE) {
+        const list = await sql`PRAGMA index_list(${sql(tableName)})`;
+        for (const idx of list) {
+            const info = await sql`PRAGMA index_info(${sql(idx.name)})`;
+            const cols = info.map((r) => r.name);
+            if (cols.length === 1) indexes[idx.name] = cols;
+        }
+    }
     return indexes;
 };
 
-// 构建索引操作 SQL（统一使用 ALTER TABLE 并尽量在线）
+// 构建索引操作 SQL（统一使用在线策略）
 const buildIndexSQL = (tableName, indexName, fieldName, action) => {
-    const parts = [];
-    if (action === 'create') {
-        parts.push(`ADD INDEX \`${indexName}\` (\`${fieldName}\`)`);
-    } else {
-        parts.push(`DROP INDEX \`${indexName}\``);
-    }
-    if (FLAGS.ONLINE_INDEX) {
+    if (IS_MYSQL) {
+        const parts = [];
+        action === 'create' ? parts.push(`ADD INDEX \`${indexName}\` (\`${fieldName}\`)`) : parts.push(`DROP INDEX \`${indexName}\``);
+        // 始终使用在线算法
         parts.push('ALGORITHM=INPLACE');
         parts.push('LOCK=NONE');
+        return `ALTER TABLE \`${tableName}\` ${parts.join(', ')}`;
+    }
+    if (IS_PG) {
+        if (action === 'create') {
+            // 始终使用 CONCURRENTLY
+            return `CREATE INDEX CONCURRENTLY IF NOT EXISTS "${indexName}" ON "${tableName}"("${fieldName}")`;
+        }
+        return `DROP INDEX CONCURRENTLY IF EXISTS "${indexName}"`;
     }
-    return `ALTER TABLE \`${tableName}\` ${parts.join(', ')}`;
+    // SQLite
+    if (action === 'create') return `CREATE INDEX IF NOT EXISTS "${indexName}" ON "${tableName}"("${fieldName}")`;
+    return `DROP INDEX IF EXISTS "${indexName}"`;
 };
 
-// 创建表
-const createTable = async (client, tableName, fields) => {
-    const columns = [
-        //
-        '`id` BIGINT PRIMARY KEY COMMENT "主键ID"',
-        '`created_at` BIGINT NOT NULL DEFAULT 0 COMMENT "创建时间"',
-        '`updated_at` BIGINT NOT NULL DEFAULT 0 COMMENT "更新时间"',
-        '`deleted_at` BIGINT NOT NULL DEFAULT 0 COMMENT "删除时间"',
-        '`state` BIGINT NOT NULL DEFAULT 0 COMMENT "状态字段"'
-    ];
-
-    const indexes = [
-        //
-        'INDEX `idx_created_at` (`created_at`)',
-        'INDEX `idx_updated_at` (`updated_at`)',
-        'INDEX `idx_state` (`state`)'
-    ];
-
-    // 添加自定义字段和索引
-    for (const [fieldName, rule] of Object.entries(fields)) {
-        columns.push(getColumnDefinition(fieldName, rule));
-
-        // 使用第6个属性判断是否设置索引
-        const ruleParts = parseFieldRule(rule);
-        const fieldHasIndex = ruleParts[5]; // 第6个属性
-        if (fieldHasIndex === '1') {
-            indexes.push(`INDEX \`idx_${fieldName}\` (\`${fieldName}\`)`);
-        }
-    }
-
-    const createTableSQL = `
-        CREATE TABLE \`${tableName}\` (
-            ${columns.join(',\n            ')},
-            ${indexes.join(',\n            ')}
-        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_as_cs
-    `;
-
-    if (FLAGS.DRY_RUN) {
-        Logger.info(`[计划] ${createTableSQL.replace(/\n+/g, ' ')}`);
+// 创建表（尽量精简但保持既有行为）
+const createTable = async (tableName, fields) => {
+    // 统一列定义数组：包含系统字段与业务字段
+    const colDefs = [];
+
+    // 1) 固定字段
+    if (IS_MYSQL) {
+        colDefs.push('`id` BIGINT PRIMARY KEY COMMENT "主键ID"');
+        colDefs.push('`created_at` BIGINT NOT NULL DEFAULT 0 COMMENT "创建时间"');
+        colDefs.push('`updated_at` BIGINT NOT NULL DEFAULT 0 COMMENT "更新时间"');
+        colDefs.push('`deleted_at` BIGINT NOT NULL DEFAULT 0 COMMENT "删除时间"');
+        colDefs.push('`state` BIGINT NOT NULL DEFAULT 0 COMMENT "状态字段"');
     } else {
-        await exec(client, createTableSQL);
+        colDefs.push('"id" INTEGER PRIMARY KEY');
+        colDefs.push('"created_at" INTEGER NOT NULL DEFAULT 0');
+        colDefs.push('"updated_at" INTEGER NOT NULL DEFAULT 0');
+        colDefs.push('"deleted_at" INTEGER NOT NULL DEFAULT 0');
+        colDefs.push('"state" INTEGER NOT NULL DEFAULT 0');
+    }
+
+    // 2) 业务字段
+    for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+        const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+        const sqlType = ['string', 'array'].includes(fieldType) ? `${typeMapping[fieldType]}(${fieldMax})` : typeMapping[fieldType];
+        const defaultSql = ['number', 'string', 'array'].includes(fieldType) ? (isType(fieldDefault, 'number') ? ` DEFAULT ${fieldDefault}` : ` DEFAULT '${fieldDefault}'`) : '';
+        if (IS_MYSQL) {
+            colDefs.push(`\`${fieldKey}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${String(fieldName).replace(/"/g, '\\"')}"`);
+        } else {
+            colDefs.push(`"${fieldKey}" ${sqlType} NOT NULL${defaultSql}`);
+        }
+    }
+
+    // 3) CREATE TABLE 语句
+    const cols = colDefs.join(',\n            ');
+    let createSQL;
+    if (IS_MYSQL) {
+        createSQL = `CREATE TABLE \`${tableName}\` (\n            ${cols}\n        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_as_cs`;
+    } else {
+        createSQL = `CREATE TABLE "${tableName}" (\n            ${cols}\n        )`;
+    }
+
+    if (IS_PLAN) {
+        Logger.info(`[计划] ${createSQL.replace(/\n+/g, ' ')}`);
+    } else {
+        await sql.unsafe(createSQL);
         Logger.info(`[新建表] ${tableName}`);
     }
+
+    // 4) PG: 列注释（SQLite 不支持；MySQL 已在列定义中）
+    if (IS_PG) {
+        const commentPairs = [
+            ['id', '主键ID'],
+            ['created_at', '创建时间'],
+            ['updated_at', '更新时间'],
+            ['deleted_at', '删除时间'],
+            ['state', '状态字段']
+        ];
+        for (const [name, cmt] of commentPairs) {
+            const stmt = `COMMENT ON COLUMN "${tableName}"."${name}" IS '${cmt}'`;
+            if (IS_PLAN) {
+                Logger.info(`[计划] ${stmt}`);
+            } else {
+                await sql.unsafe(stmt);
+            }
+        }
+        for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+            const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+            const stmt = `COMMENT ON COLUMN "${tableName}"."${fieldKey}" IS '${fieldName}'`;
+            if (IS_PLAN) {
+                Logger.info(`[计划] ${stmt}`);
+            } else {
+                await sql.unsafe(stmt);
+            }
+        }
+    }
+
+    // 5) 索引：系统字段 + 业务字段（按规则）
+    for (const sysField of ['created_at', 'updated_at', 'state']) {
+        const stmt = buildIndexSQL(tableName, `idx_${sysField}`, sysField, 'create');
+        if (IS_PLAN) {
+            Logger.info(`[计划] ${stmt}`);
+        } else {
+            await sql.unsafe(stmt);
+        }
+    }
+    for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+        const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+        if (fieldIndex === 1) {
+            const stmt = buildIndexSQL(tableName, `idx_${fieldKey}`, fieldKey, 'create');
+            if (IS_PLAN) {
+                Logger.info(`[计划] ${stmt}`);
+            } else {
+                await sql.unsafe(stmt);
+            }
+        }
+    }
 };
 
 // 比较字段定义变化
-const compareFieldDefinition = (existingColumn, newRule, fieldName) => {
-    const ruleParts = parseFieldRule(newRule);
-    const [fieldDisplayName, fieldType, fieldMin, fieldMaxLength, fieldDefaultValue] = ruleParts;
+const compareFieldDefinition = (existingColumn, newRule, colName) => {
+    const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(newRule);
     const changes = [];
 
-    // 检查长度变化（string和array类型）
-    if (fieldType === 'string' || fieldType === 'array') {
-        if (fieldMaxLength === 'null') {
-            throw new Error(`string/array 类型字段的最大长度未设置，必须指定最大长度`);
-        }
-        const newMaxLength = parseInt(fieldMaxLength);
-        if (existingColumn.length !== newMaxLength) {
-            changes.push({ type: 'length', current: existingColumn.length, new: newMaxLength });
+    // 检查长度变化（string和array类型） - SQLite 不比较长度
+    if (!IS_SQLITE && (fieldType === 'string' || fieldType === 'array')) {
+        if (existingColumn.length !== fieldMax) {
+            changes.push({
+                type: 'length',
+                current: existingColumn.length,
+                new: fieldMax
+            });
         }
     }
 
-    // 检查注释变化（使用第1个属性作为字段显示名称）
-    if (fieldDisplayName && fieldDisplayName !== 'null') {
+    // 检查注释变化（MySQL/PG 支持列注释）
+    if (!IS_SQLITE) {
         const currentComment = existingColumn.comment || '';
-        if (currentComment !== fieldDisplayName) {
-            changes.push({ type: 'comment', current: currentComment, new: fieldDisplayName });
+        if (currentComment !== fieldName) {
+            changes.push({
+                type: 'comment',
+                current: currentComment,
+                new: fieldName
+            });
         }
     }
 
-    // 检查数据类型变化
-    const expectedDbType = {
-        number: 'bigint',
-        string: 'varchar',
-        text: 'mediumtext',
-        array: 'varchar'
-    }[fieldType];
-
-    if (existingColumn.type.toLowerCase() !== expectedDbType) {
-        changes.push({ type: 'datatype', current: existingColumn.type, new: expectedDbType });
+    // 检查数据类型变化（按方言）
+    if (existingColumn.type.toLowerCase() !== typeMapping[fieldType].toLowerCase()) {
+        changes.push({
+            type: 'datatype',
+            current: existingColumn.type,
+            new: typeMapping[fieldType].toLowerCase()
+        });
     }
 
     // 检查默认值变化（按照生成规则推导期望默认值）
-    const expectedDefault = getExpectedDefault(fieldType, fieldDefaultValue);
-    const currDef = normalizeDefault(existingColumn.defaultValue);
-    const newDef = normalizeDefault(expectedDefault);
-    if (currDef !== newDef) {
-        changes.push({ type: 'default', current: existingColumn.defaultValue, new: expectedDefault });
-    }
-
-    // 检查可空性变化（统一期望 NOT NULL）
-    const expectedNullable = false; // 期望 NOT NULL
-    if (existingColumn.nullable !== expectedNullable) {
-        // existingColumn.nullable 为 true 表示可空
+    if (String(existingColumn.defaultValue) !== String(fieldDefault)) {
         changes.push({
-            type: 'nullability',
-            current: existingColumn.nullable ? 'NULL' : 'NOT NULL',
-            new: expectedNullable ? 'NULL' : 'NOT NULL'
+            type: 'default',
+            current: existingColumn.defaultValue,
+            new: fieldDefault
         });
     }
 
-    return { hasChanges: changes.length > 0, changes };
+    return changes;
 };
 
 // 生成字段 DDL 子句（不含 ALTER TABLE 前缀）
-const generateDDLClause = (fieldName, rule, isAdd = false) => {
-    const columnDef = getColumnDefinition(fieldName, rule);
-    const operation = isAdd ? 'ADD COLUMN' : 'MODIFY COLUMN';
-    return `${operation} ${columnDef}`;
+const generateDDLClause = (fieldKey, fieldRule, isAdd = false) => {
+    const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+    const sqlType = ['string', 'array'].includes(fieldType) ? `${typeMapping[fieldType]}(${fieldMax})` : typeMapping[fieldType];
+    const defaultSql = ['number', 'string', 'array'].includes(fieldType) ? (isType(fieldDefault, 'number') ? ` DEFAULT ${fieldDefault}` : ` DEFAULT '${fieldDefault}'`) : '';
+    if (IS_MYSQL) {
+        return `${isAdd ? 'ADD COLUMN' : 'MODIFY COLUMN'} \`${fieldKey}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${String(fieldName).replace(/"/g, '\\"')}"`;
+    }
+    if (IS_PG) {
+        if (isAdd) return `ADD COLUMN IF NOT EXISTS "${fieldKey}" ${sqlType} NOT NULL${defaultSql}`;
+        // PG 修改：类型与非空可分条执行，生成 TYPE 改变；非空另由上层统一控制
+        return `ALTER COLUMN "${fieldKey}" TYPE ${sqlType}`;
+    }
+    // SQLite 仅支持 ADD COLUMN（>=3.50.0：支持 IF NOT EXISTS）
+    if (isAdd) return `ADD COLUMN IF NOT EXISTS "${fieldKey}" ${sqlType} NOT NULL${defaultSql}`;
+    return '';
 };
 
 // 安全执行DDL语句
-const executeDDLSafely = async (client, sql) => {
+const executeDDLSafely = async (stmt) => {
     try {
-        await exec(client, sql);
+        await sql.unsafe(stmt);
         return true;
     } catch (error) {
-        // INSTANT失败时尝试INPLACE
-        if (sql.includes('ALGORITHM=INSTANT')) {
-            const inplaceSql = sql.replace(/ALGORITHM=INSTANT/g, 'ALGORITHM=INPLACE');
+        // MySQL 专用降级路径
+        if (stmt.includes('ALGORITHM=INSTANT')) {
+            const inplaceSql = stmt.replace(/ALGORITHM=INSTANT/g, 'ALGORITHM=INPLACE');
             try {
-                await exec(client, inplaceSql);
+                await sql.unsafe(inplaceSql);
                 return true;
             } catch (inplaceError) {
                 // 最后尝试传统DDL：移除 ALGORITHM/LOCK 附加子句后执行
-                const traditionSql = sql
+                const traditionSql = stmt
                     .replace(/,\s*ALGORITHM=INPLACE/g, '')
                     .replace(/,\s*ALGORITHM=INSTANT/g, '')
                     .replace(/,\s*LOCK=(NONE|SHARED|EXCLUSIVE)/g, '');
-                await exec(client, traditionSql);
+                await sql.unsafe(traditionSql);
                 return true;
             }
         } else {
@@ -298,276 +430,296 @@ const executeDDLSafely = async (client, sql) => {
     }
 };
 
+// SQLite 重建表迁移（简化版：仅处理新增/修改字段，不处理复杂约束与复合索引）
+const rebuildSqliteTable = async (tableName, fields) => {
+    // 1. 读取现有列顺序
+    const info = await sql`PRAGMA table_info(${sql(tableName)})`;
+    const existingCols = info.map((r) => r.name);
+    const targetCols = ['id', 'created_at', 'updated_at', 'deleted_at', 'state', ...Object.keys(fields)];
+    const tmpTable = `${tableName}__tmp__${Date.now()}`;
+
+    // 2. 创建新表（使用当前定义）
+    await createTable(tmpTable, fields);
+
+    // 3. 拷贝数据（按交集列）
+    const commonCols = targetCols.filter((c) => existingCols.includes(c));
+    if (commonCols.length > 0) {
+        const colsSql = commonCols.map((c) => `"${c}"`).join(', ');
+        await sql.unsafe(`INSERT INTO "${tmpTable}" (${colsSql}) SELECT ${colsSql} FROM "${tableName}"`);
+    }
+
+    // 4. 删除旧表并重命名
+    await sql.unsafe(`DROP TABLE "${tableName}"`);
+    await sql.unsafe(`ALTER TABLE "${tmpTable}" RENAME TO "${tableName}"`);
+};
+
+// 将表结构计划应用到数据库（执行 DDL/索引/注释等）
+const applyTablePlan = async (tableName, fields, plan) => {
+    if (!plan || !plan.changed) return;
+
+    // SQLite: 仅支持部分 ALTER；需要时走重建
+    if (IS_SQLITE) {
+        if (plan.modifyClauses.length > 0 || plan.defaultClauses.length > 0) {
+            if (IS_PLAN) Logger.info(`[计划] 重建表 ${tableName} 以应用列修改/默认值变化`);
+            else await rebuildSqliteTable(tableName, fields);
+        } else {
+            for (const c of plan.addClauses) {
+                const stmt = `ALTER TABLE "${tableName}" ${c}`;
+                if (IS_PLAN) Logger.info(`[计划] ${stmt}`);
+                else await sql.unsafe(stmt);
+            }
+        }
+    } else {
+        const clauses = [...plan.addClauses, ...plan.modifyClauses];
+        if (clauses.length > 0) {
+            const suffix = IS_MYSQL ? ', ALGORITHM=INSTANT, LOCK=NONE' : '';
+            const stmt = IS_MYSQL ? `ALTER TABLE \`${tableName}\` ${clauses.join(', ')}${suffix}` : `ALTER TABLE "${tableName}" ${clauses.join(', ')}`;
+            if (IS_PLAN) Logger.info(`[计划] ${stmt}`);
+            else if (IS_MYSQL) await executeDDLSafely(stmt);
+            else await sql.unsafe(stmt);
+        }
+    }
+
+    // 默认值专用 ALTER（SQLite 不支持）
+    if (plan.defaultClauses.length > 0) {
+        if (IS_SQLITE) {
+            Logger.warn(`SQLite 不支持修改默认值，表 ${tableName} 的默认值变更已跳过`);
+        } else {
+            const suffix = IS_MYSQL ? ', ALGORITHM=INSTANT, LOCK=NONE' : '';
+            const stmt = IS_MYSQL ? `ALTER TABLE \`${tableName}\` ${plan.defaultClauses.join(', ')}${suffix}` : `ALTER TABLE "${tableName}" ${plan.defaultClauses.join(', ')}`;
+            if (IS_PLAN) Logger.info(`[计划] ${stmt}`);
+            else if (IS_MYSQL) await executeDDLSafely(stmt);
+            else await sql.unsafe(stmt);
+        }
+    }
+
+    // 索引操作
+    for (const act of plan.indexActions) {
+        const stmt = buildIndexSQL(tableName, act.indexName, act.fieldName, act.action);
+        if (IS_PLAN) {
+            Logger.info(`[计划] ${stmt}`);
+        } else {
+            try {
+                await sql.unsafe(stmt);
+                if (act.action === 'create') {
+                    Logger.info(`[索引变化] 新建索引 ${tableName}.${act.indexName} (${act.fieldName})`);
+                } else {
+                    Logger.info(`[索引变化] 删除索引 ${tableName}.${act.indexName} (${act.fieldName})`);
+                }
+            } catch (error) {
+                Logger.error(`${act.action === 'create' ? '创建' : '删除'}索引失败: ${error.message}`);
+                throw error;
+            }
+        }
+    }
+
+    // PG 列注释
+    if (IS_PG && plan.commentActions && plan.commentActions.length > 0) {
+        for (const stmt of plan.commentActions) {
+            if (IS_PLAN) Logger.info(`[计划] ${stmt}`);
+            else await sql.unsafe(stmt);
+        }
+    }
+
+    // 计数
+    globalCount.modifiedTables++;
+};
+
 // 同步表结构
-const syncTable = async (client, tableName, fields) => {
-    const existingColumns = await getTableColumns(client, tableName);
-    const existingIndexes = await getTableIndexes(client, tableName);
-    const systemFields = ['id', 'created_at', 'updated_at', 'deleted_at', 'state'];
+const modifyTable = async (tableName, fields) => {
+    const existingColumns = await getTableColumns(tableName);
+    const existingIndexes = await getTableIndexes(tableName);
     let changed = false;
 
     const addClauses = [];
     const modifyClauses = [];
     const defaultClauses = [];
     const indexActions = [];
-    // 变更统计（按字段粒度）
-    const changeStats = {
-        addFields: 0,
-        datatype: 0,
-        length: 0,
-        default: 0,
-        comment: 0,
-        nullability: 0,
-        indexCreate: 0,
-        indexDrop: 0
-    };
-
-    // 同步字段
-    for (const [fieldName, rule] of Object.entries(fields)) {
-        if (existingColumns[fieldName]) {
-            const comparison = compareFieldDefinition(existingColumns[fieldName], rule, fieldName);
-            if (comparison.hasChanges) {
-                // 打印具体变动项并统计
-                for (const c of comparison.changes) {
-                    const label = { length: '长度', datatype: '类型', comment: '注释', default: '默认值' }[c.type] || c.type;
-                    Logger.info(`[字段变更] ${tableName}.${fieldName} ${label}: ${c.current ?? 'NULL'} -> ${c.new ?? 'NULL'}`);
-                    if (c.type in changeStats) changeStats[c.type]++;
+
+    for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+        if (existingColumns[fieldKey]) {
+            const comparison = compareFieldDefinition(existingColumns[fieldKey], fieldRule, fieldKey);
+            if (comparison.length > 0) {
+                for (const c of comparison) {
+                    const label =
+                        {
+                            length: '长度',
+                            datatype: '类型',
+                            comment: '注释',
+                            default: '默认值'
+                        }[c.type] || c.type;
+                    Logger.info(`[字段变更] ${tableName}.${fieldKey} ${label}: ${c.current ?? 'NULL'} -> ${c.new ?? 'NULL'}`);
+                    // 全量计数：全局累加
+                    if (c.type === 'datatype') globalCount.typeChanges++;
+                    else if (c.type === 'length') globalCount.maxChanges++;
+                    else if (c.type === 'default') globalCount.defaultChanges++;
+                    else if (c.type === 'comment') globalCount.nameChanges++;
                 }
-                // 风险护栏：长度收缩/类型变更
-                const ruleParts = parseFieldRule(rule);
-                const [, fType, , fMax, fDef] = ruleParts;
-                if ((fType === 'string' || fType === 'array') && existingColumns[fieldName].length && fMax !== 'null') {
-                    const newLen = parseInt(fMax);
-                    if (existingColumns[fieldName].length > newLen && FLAGS.DISALLOW_SHRINK) {
-                        Logger.warn(`[跳过危险变更] ${tableName}.${fieldName} 长度收缩 ${existingColumns[fieldName].length} -> ${newLen} 已被跳过（设置 SYNC_DISALLOW_SHRINK=0 可放开）`);
-                        // 如果仅有 shrink 一个变化，仍可能还有默认/注释变化要处理
+                const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+                if ((fieldType === 'string' || fieldType === 'array') && existingColumns[fieldKey].length) {
+                    if (existingColumns[fieldKey].length > fieldMax) {
+                        Logger.warn(`[跳过危险变更] ${tableName}.${fieldKey} 长度收缩 ${existingColumns[fieldKey].length} -> ${fieldMax} 已被跳过（设置 SYNC_DISALLOW_SHRINK=0 可放开）`);
                     }
                 }
-                const expectedDbType = {
-                    number: 'bigint',
-                    string: 'varchar',
-                    text: 'mediumtext',
-                    array: 'varchar'
-                }[parseFieldRule(rule)[1]];
-                if (existingColumns[fieldName].type.toLowerCase() !== expectedDbType && !FLAGS.ALLOW_TYPE_CHANGE) {
-                    Logger.warn(`[跳过危险变更] ${tableName}.${fieldName} 类型变更 ${existingColumns[fieldName].type} -> ${expectedDbType} 已被跳过（设置 SYNC_ALLOW_TYPE_CHANGE=1 可放开）`);
-                    // 继续处理默认值/注释等非类型变更
+                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');
+
+                // 严格限制：除 string/array 互转外，禁止任何字段类型变更；一旦发现，立即终止同步
+                // 说明：string 与 array 在各方言下映射同为 VARCHAR/character varying/TEXT，compare 不会将其视为类型变更
+                if (hasTypeChange) {
+                    const currentSqlType = String(existingColumns[fieldKey].type || '').toLowerCase();
+                    const newSqlType = String(typeMapping[fieldType] || '').toLowerCase();
+                    // 明确抛错，阻止后续任何 DDL 应用
+                    throw new Error(`禁止字段类型变更: ${tableName}.${fieldKey} ${currentSqlType} -> ${newSqlType}。仅允许 string<->array 互相切换`);
                 }
 
-                // 判断是否“仅默认值变化”
-                const onlyDefaultChanged = comparison.changes.every((c) => c.type === 'default');
-                if (onlyDefaultChanged) {
-                    const expectedDefault = getExpectedDefault(parseFieldRule(rule)[1], parseFieldRule(rule)[4]);
-                    if (expectedDefault === null) {
-                        defaultClauses.push(`ALTER COLUMN \`${fieldName}\` DROP DEFAULT`);
-                    } else {
-                        const isNumber = parseFieldRule(rule)[1] === 'number';
-                        const v = isNumber ? expectedDefault : `"${String(expectedDefault).replace(/"/g, '\\"')}"`;
-                        defaultClauses.push(`ALTER COLUMN \`${fieldName}\` SET DEFAULT ${v}`);
-                    }
-                } else {
-                    // 判断是否需要跳过 MODIFY：包含收缩或类型变更时跳过
-                    let skipModify = false;
-                    const hasLengthChange = comparison.changes.some((c) => c.type === 'length');
-                    if (hasLengthChange && (fType === 'string' || fType === 'array') && existingColumns[fieldName].length && fMax !== 'null') {
-                        const newLen = parseInt(fMax);
-                        if (existingColumns[fieldName].length > newLen && FLAGS.DISALLOW_SHRINK) {
-                            skipModify = true;
+                // 默认值变化处理：
+                if (defaultChanged) {
+                    const v = fieldType === 'number' ? fieldDefault : `'${fieldDefault}'`;
+                    if (IS_PG) {
+                        defaultClauses.push(`ALTER COLUMN "${fieldKey}" SET DEFAULT ${v}`);
+                    } else if (IS_MYSQL && onlyDefaultChanged) {
+                        // MySQL 的 TEXT/BLOB 不允许 DEFAULT，跳过 text 类型
+                        if (fieldType !== 'text') {
+                            defaultClauses.push(`ALTER COLUMN \`${fieldKey}\` SET DEFAULT ${v}`);
                         }
                     }
-                    const hasTypeChange = comparison.changes.some((c) => c.type === 'datatype');
-                    if (hasTypeChange && !FLAGS.ALLOW_TYPE_CHANGE) {
-                        skipModify = true;
+                }
+
+                // 若不仅仅是默认值变化，继续生成修改子句
+                if (!onlyDefaultChanged) {
+                    let skipModify = false;
+                    if (hasLengthChange && (fieldType === 'string' || fieldType === 'array') && existingColumns[fieldKey].length) {
+                        const oldLen = existingColumns[fieldKey].length;
+                        const isShrink = oldLen > fieldMax;
+                        if (isShrink) skipModify = true;
                     }
-                    if (!skipModify) {
-                        // 合并到 MODIFY COLUMN 子句
-                        modifyClauses.push(generateDDLClause(fieldName, rule, false));
+                    if (hasTypeChange) {
+                        if (IS_PG && isPgCompatibleTypeChange(existingColumns[fieldKey].type, typeMapping[fieldType].toLowerCase())) {
+                            Logger.info(`[PG兼容类型变更] ${tableName}.${fieldKey} ${existingColumns[fieldKey].type} -> ${typeMapping[fieldType].toLowerCase()} 允许执行`);
+                        }
                     }
+                    if (!skipModify) modifyClauses.push(generateDDLClause(fieldKey, fieldRule, false));
                 }
                 changed = true;
             }
         } else {
-            // 新增字段日志
-            const [disp, fType, fMin, fMax, fDef, fIdx] = parseFieldRule(rule);
-            const lenPart = fType === 'string' || fType === 'array' ? ` 长度:${parseInt(fMax)}` : '';
-            const expectedDefault = getExpectedDefault(fType, fDef);
-            Logger.info(`[新增字段] ${tableName}.${fieldName} 类型:${fType}${lenPart} 默认:${expectedDefault ?? 'NULL'}`);
-            addClauses.push(generateDDLClause(fieldName, rule, true));
+            const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+            const lenPart = fieldType === 'string' || fieldType === 'array' ? ` 长度:${parseInt(fieldMax)}` : '';
+            Logger.info(`[新增字段] ${tableName}.${fieldKey} 类型:${fieldType}${lenPart} 默认:${fieldDefault ?? 'NULL'}`);
+            addClauses.push(generateDDLClause(fieldKey, fieldRule, true));
             changed = true;
-            changeStats.addFields++;
+            globalCount.addFields++;
         }
     }
 
-    // 同步索引
-    for (const [fieldName, rule] of Object.entries(fields)) {
-        const ruleParts = parseFieldRule(rule);
-        const fieldHasIndex = ruleParts[5]; // 使用第6个属性判断是否设置索引
-        const indexName = `idx_${fieldName}`;
-
-        if (fieldHasIndex === '1' && !existingIndexes[indexName]) {
-            indexActions.push({ action: 'create', indexName, fieldName });
+    for (const sysField of ['created_at', 'updated_at', 'state']) {
+        const idxName = `idx_${sysField}`;
+        if (!existingIndexes[idxName]) {
+            indexActions.push({ action: 'create', indexName: idxName, fieldName: sysField });
+            changed = true;
+            globalCount.indexCreate++;
+        }
+    }
+    for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+        const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+        const indexName = `idx_${fieldKey}`;
+        if (fieldIndex === 1 && !existingIndexes[indexName]) {
+            indexActions.push({ action: 'create', indexName, fieldName: fieldKey });
             changed = true;
-            changeStats.indexCreate++;
-        } else if (fieldHasIndex !== '1' && existingIndexes[indexName] && existingIndexes[indexName].length === 1) {
-            indexActions.push({ action: 'drop', indexName, fieldName });
+            globalCount.indexCreate++;
+        } else if (!(fieldIndex === 1) && existingIndexes[indexName] && existingIndexes[indexName].length === 1) {
+            indexActions.push({ action: 'drop', indexName, fieldName: fieldKey });
             changed = true;
-            changeStats.indexDrop++;
+            globalCount.indexDrop++;
+        }
+    }
+
+    const commentActions = [];
+    if (IS_PG) {
+        for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+            if (existingColumns[fieldKey]) {
+                const [fieldName, fieldType, fieldMin, fieldMax, fieldDefault, fieldIndex, fieldRegx] = parseRule(fieldRule);
+                const curr = existingColumns[fieldKey].comment || '';
+                const want = fieldName && fieldName !== 'null' ? String(fieldName) : '';
+                if (want !== curr) {
+                    commentActions.push(`COMMENT ON COLUMN "${tableName}"."${fieldKey}" IS ${want ? `'${want}'` : 'NULL'}`);
+                    changed = true;
+                }
+            }
         }
     }
-    return { changed, addClauses, modifyClauses, defaultClauses, indexActions, metrics: changeStats };
+    // 仅当存在实际动作时才认为有变更（避免仅日志的收缩跳过被计为修改）
+    changed = addClauses.length > 0 || modifyClauses.length > 0 || defaultClauses.length > 0 || indexActions.length > 0 || commentActions.length > 0;
+    const plan = { changed, addClauses, modifyClauses, defaultClauses, indexActions, commentActions };
+    // 将计划应用（包含 --plan 情况下仅输出）
+    if (plan.changed) {
+        await applyTablePlan(tableName, fields, plan);
+    }
+    return plan;
 };
 
 // 主同步函数
 const SyncDb = async () => {
-    let client = null;
-
     try {
         Logger.info('开始数据库表结构同步...');
+        // 重置全局统计，避免多次调用累加
+        for (const k of Object.keys(globalCount)) {
+            if (typeof globalCount[k] === 'number') globalCount[k] = 0;
+        }
 
         // 验证表定义文件
-        const tableValidationResult = await checkTable();
-        if (!tableValidationResult) {
+        if (!(await checkTable())) {
             throw new Error('表定义验证失败');
         }
 
-        // 建立数据库连接并检查版本（统一工具函数）
-        client = await createSqlClient({ max: 1 });
-        const result = await client`SELECT VERSION() AS version`;
-        const version = result[0].version;
-
-        if (version.toLowerCase().includes('mariadb')) {
-            throw new Error('此脚本仅支持 MySQL 8.0+，不支持 MariaDB');
-        }
-
-        const majorVersion = parseInt(version.split('.')[0]);
-        if (majorVersion < 8) {
-            throw new Error(`此脚本仅支持 MySQL 8.0+，当前版本: ${version}`);
-        }
-
-        Logger.info(`MySQL 版本检查通过: ${version}`);
+        // 建立数据库连接并检查版本（按方言）
+        // 在顶层也保留 sql 引用，便于未来需要跨函数访问
+        sql = await createSqlClient({ max: 1 });
+        await ensureDbVersion();
 
         // 扫描并处理表文件
         const tablesGlob = new Bun.Glob('*.json');
         const directories = [__dirtables, getProjectDir('tables')];
-        let processedCount = 0;
-        let createdTables = 0;
-        let modifiedTables = 0;
-        // 全局统计
-        const overall = {
-            addFields: 0,
-            typeChanges: 0,
-            maxChanges: 0, // 映射为长度变化
-            minChanges: 0, // 最小值不参与 DDL，比对保留为0
-            defaultChanges: 0,
-            nameChanges: 0, // 字段显示名（注释）变更
-            indexCreate: 0,
-            indexDrop: 0
-        };
+        // 统计使用全局 globalCount
 
         for (const dir of directories) {
-            try {
-                for await (const file of tablesGlob.scan({ cwd: dir, absolute: true, onlyFiles: true })) {
-                    const tableName = path.basename(file, '.json');
-                    const tableDefinition = await Bun.file(file).json();
-                    const result = await exec(client, 'SELECT COUNT(*) as count FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?', [Env.MYSQL_DB || 'test', tableName]);
-                    const exists = result[0].count > 0;
-
-                    if (exists) {
-                        const plan = await syncTable(client, tableName, tableDefinition);
-                        if (plan.changed) {
-                            // 汇总统计
-                            if (plan.metrics) {
-                                overall.addFields += plan.metrics.addFields;
-                                overall.typeChanges += plan.metrics.datatype;
-                                overall.maxChanges += plan.metrics.length;
-                                overall.defaultChanges += plan.metrics.default;
-                                overall.indexCreate += plan.metrics.indexCreate;
-                                overall.indexDrop += plan.metrics.indexDrop;
-                                overall.nameChanges += plan.metrics.comment;
-                            }
-                            // 合并执行 ALTER TABLE 子句
-                            if (FLAGS.MERGE_ALTER) {
-                                const clauses = [...plan.addClauses, ...plan.modifyClauses];
-                                if (clauses.length > 0) {
-                                    const sql = `ALTER TABLE \`${tableName}\` ${clauses.join(', ')}, ALGORITHM=INSTANT, LOCK=NONE`;
-                                    if (FLAGS.DRY_RUN) {
-                                        Logger.info(`[计划] ${sql}`);
-                                    } else {
-                                        await executeDDLSafely(client, sql);
-                                    }
-                                }
-                            } else {
-                                // 分别执行
-                                for (const c of plan.addClauses) {
-                                    const sql = `ALTER TABLE \`${tableName}\` ${c}, ALGORITHM=INSTANT, LOCK=NONE`;
-                                    if (FLAGS.DRY_RUN) Logger.info(`[计划] ${sql}`);
-                                    else await executeDDLSafely(client, sql);
-                                }
-                                for (const c of plan.modifyClauses) {
-                                    const sql = `ALTER TABLE \`${tableName}\` ${c}, ALGORITHM=INSTANT, LOCK=NONE`;
-                                    if (FLAGS.DRY_RUN) Logger.info(`[计划] ${sql}`);
-                                    else await executeDDLSafely(client, sql);
-                                }
-                            }
-
-                            // 默认值专用 ALTER
-                            if (plan.defaultClauses.length > 0) {
-                                const sql = `ALTER TABLE \`${tableName}\` ${plan.defaultClauses.join(', ')}, ALGORITHM=INSTANT, LOCK=NONE`;
-                                if (FLAGS.DRY_RUN) Logger.info(`[计划] ${sql}`);
-                                else await executeDDLSafely(client, sql);
-                            }
-
-                            // 索引操作
-                            for (const act of plan.indexActions) {
-                                const sql = buildIndexSQL(tableName, act.indexName, act.fieldName, act.action);
-                                if (FLAGS.DRY_RUN) {
-                                    Logger.info(`[计划] ${sql}`);
-                                } else {
-                                    try {
-                                        await exec(client, sql);
-                                        if (act.action === 'create') {
-                                            Logger.info(`[索引变化] 新建索引 ${tableName}.${act.indexName} (${act.fieldName})`);
-                                        } else {
-                                            Logger.info(`[索引变化] 删除索引 ${tableName}.${act.indexName} (${act.fieldName})`);
-                                        }
-                                    } catch (error) {
-                                        Logger.error(`${act.action === 'create' ? '创建' : '删除'}索引失败: ${error.message}`);
-                                        throw error;
-                                    }
-                                }
-                            }
-
-                            modifiedTables++;
-                        }
-                    } else {
-                        await createTable(client, tableName, tableDefinition);
-                        createdTables++;
-                        // 新建表已算作变更
-                        modifiedTables += 0;
-                        // 创建表统计：按需求仅汇总创建表数量
-                    }
+            for await (const file of tablesGlob.scan({ cwd: dir, absolute: true, onlyFiles: true })) {
+                const tableName = toSnakeTableName(path.basename(file, '.json'));
+                const tableDefinition = await Bun.file(file).json();
+                const existsTable = await tableExists(tableName);
 
-                    processedCount++;
+                if (existsTable) {
+                    await modifyTable(tableName, tableDefinition);
+                } else {
+                    await createTable(tableName, tableDefinition);
+                    globalCount.createdTables++;
                 }
-            } catch (error) {
-                Logger.warn(`扫描目录 ${dir} 出错: ${error.message}`);
+                globalCount.processedTables++;
             }
         }
 
         // 显示统计信息（扩展维度）
-        Logger.info(`统计 - 创建表: ${createdTables}`);
-        Logger.info(`统计 - 字段新增: ${overall.addFields}`);
-        Logger.info(`统计 - 字段名称变更: ${overall.nameChanges}`);
-        Logger.info(`统计 - 字段类型变更: ${overall.typeChanges}`);
-        Logger.info(`统计 - 字段最小值变更: ${overall.minChanges}`);
-        Logger.info(`统计 - 字段最大值变更: ${overall.maxChanges}`);
-        Logger.info(`统计 - 字段默认值变更: ${overall.defaultChanges}`);
+        Logger.info(`统计 - 处理表总数: ${globalCount.processedTables}`);
+        Logger.info(`统计 - 创建表: ${globalCount.createdTables}`);
+        Logger.info(`统计 - 修改表: ${globalCount.modifiedTables}`);
+        Logger.info(`统计 - 字段新增: ${globalCount.addFields}`);
+        Logger.info(`统计 - 字段名称变更: ${globalCount.nameChanges}`);
+        Logger.info(`统计 - 字段类型变更: ${globalCount.typeChanges}`);
+        Logger.info(`统计 - 字段最小值变更: ${globalCount.minChanges}`);
+        Logger.info(`统计 - 字段最大值变更: ${globalCount.maxChanges}`);
+        Logger.info(`统计 - 字段默认值变更: ${globalCount.defaultChanges}`);
         // 索引新增/删除分别打印
-        Logger.info(`统计 - 索引新增: ${overall.indexCreate}`);
-        Logger.info(`统计 - 索引删除: ${overall.indexDrop}`);
+        Logger.info(`统计 - 索引新增: ${globalCount.indexCreate}`);
+        Logger.info(`统计 - 索引删除: ${globalCount.indexDrop}`);
 
-        if (processedCount === 0) {
+        if (globalCount.processedTables === 0) {
             Logger.warn('没有找到任何表定义文件');
         }
+
+        // 保持单一职责：此处不再触发开发管理员同步
     } catch (error) {
         Logger.error(`数据库同步失败: ${error.message}`);
         Logger.error(`错误详情: ${error.stack}`);
@@ -579,9 +731,9 @@ const SyncDb = async () => {
         }
         process.exit(1);
     } finally {
-        if (client) {
+        if (sql) {
             try {
-                await client.close();
+                await sql.close();
             } catch (error) {
                 Logger.warn('关闭数据库连接时出错:', error.message);
             }
@@ -589,8 +741,8 @@ const SyncDb = async () => {
     }
 };
 
-// 如果直接运行此脚本
-if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('dbSync.js')) {
+// 如果直接运行此脚本（Bun 支持 import.meta.main）
+if (import.meta.main) {
     SyncDb().catch((error) => {
         console.error('❌ 数据库同步失败:', error);
         process.exit(1);