befly 3.0.0 → 3.1.1

package/config/regexAliases.ts

@@ -0,0 +1,51 @@
+/**
+ * 内置正则表达式别名
+ *
+ * 使用方式：在字段定义的 regex 位置使用 @别名 格式
+ * 例如：'字段名|array_text|null|null|null|0|@number'
+ */
+
+export const RegexAliases = {
+    // 数字类型
+    number: '^\\d+$', // 纯数字
+    integer: '^-?\\d+$', // 整数（含负数）
+    float: '^-?\\d+(\\.\\d+)?$', // 浮点数
+    positive: '^[1-9]\\d*$', // 正整数（不含0）
+
+    // 字符串类型
+    word: '^[a-zA-Z]+$', // 纯字母
+    alphanumeric: '^[a-zA-Z0-9]+$', // 字母+数字
+    alphanumeric_: '^[a-zA-Z0-9_]+$', // 字母+数字+下划线
+    lowercase: '^[a-z]+$', // 小写字母
+    uppercase: '^[A-Z]+$', // 大写字母
+
+    // 中文
+    chinese: '^[\\u4e00-\\u9fa5]+$', // 纯中文
+    chinese_word: '^[\\u4e00-\\u9fa5a-zA-Z]+$', // 中文+字母
+
+    // 常用格式
+    email: '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$', // 邮箱
+    phone: '^1[3-9]\\d{9}$', // 中国手机号
+    url: '^https?://', // URL
+    ip: '^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$', // IPv4
+
+    // 特殊格式
+    uuid: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', // UUID
+    hex: '^[0-9a-fA-F]+$', // 十六进制
+    base64: '^[A-Za-z0-9+/=]+$', // Base64
+
+    // 日期时间
+    date: '^\\d{4}-\\d{2}-\\d{2}$', // YYYY-MM-DD
+    time: '^\\d{2}:\\d{2}:\\d{2}$', // HH:MM:SS
+    datetime: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}', // ISO 8601
+
+    // 代码相关
+    variable: '^[a-zA-Z_][a-zA-Z0-9_]*$', // 变量名
+    constant: '^[A-Z][A-Z0-9_]*$', // 常量名（大写）
+
+    // 空值
+    empty: '^$', // 空字符串
+    notempty: '.+' // 非空
+} as const;
+
+export type RegexAliasName = keyof typeof RegexAliases;

package/config/reserved.ts

@@ -25,7 +25,7 @@ export const RESERVED_NAMES = {
     /**
      * 禁止用作 addon 名称
      */
-    addonNames: ['core', 'system', 'admin', 'sys', 'befly', 'app', 'api', 'config', 'utils', 'types']
+    addonNames: ['app', 'api']
 } as const;
 
 /**

package/main.ts

@@ -1,101 +1,47 @@
 /**
- * Befly 框架主入口文件 - TypeScript 版本
- * 提供完整的框架功能：检查系统、加载插件、加载 API、启动 HTTP 服务器
+ * Befly 框架主入口文件
+ * 提供简洁的框架接口，核心逻辑已提取到 lifecycle 层
  */
 
 import { Env } from './config/env.js';
-import { Api } from './utils/api.js';
-import { Yes, No } from './utils/index.js';
+import { Fields } from './config/fields.js';
+import { Yes, No, cleanData } from './utils/index.js';
 import { Logger } from './utils/logger.js';
 import { Jwt } from './utils/jwt.js';
 import { Validator } from './utils/validate.js';
 import { Crypto2 } from './utils/crypto.js';
-import { calcPerfTime } from './utils/index.js';
-import { scanAddons, hasAddonDir } from './utils/addonHelper.js';
-import { Checker } from './lifecycle/checker.js';
-import { Loader } from './lifecycle/loader.js';
-import { Bootstrap } from './lifecycle/bootstrap.js';
+import { DbHelper } from './utils/dbHelper.js';
+import { createSqlClient, getRedis, getSql, getDbHelper, initDatabase, closeDatabase } from './utils/database.js';
+import { RedisHelper } from './utils/redisHelper.js';
+import { Lifecycle } from './lifecycle/lifecycle.js';
 
 import type { Server } from 'bun';
-import type { Plugin } from './types/plugin.js';
-import type { ApiRoute, ApiHandler } from './types/api.js';
-import type { BeflyContext, BeflyOptions, RequestContext } from './types/befly.js';
+import type { BeflyContext, BeflyOptions } from './types/befly.js';
 
 /**
  * Befly 框架核心类
+ * 职责：管理应用上下文和生命周期
  */
 export class Befly {
-    /** API 路由映射表 */
-    private apiRoutes: Map<string, ApiRoute>;
-
-    /** 插件列表 */
-    private pluginLists: Plugin[];
+    /** 生命周期管理器 */
+    private lifecycle: Lifecycle;
 
     /** 应用上下文 */
     public appContext: BeflyContext;
 
-    /** 应用配置选项 */
-    private appOptions: BeflyOptions;
-
-    // 原构造函数被替换
     constructor(options: BeflyOptions = {}) {
-        this.apiRoutes = new Map();
-        this.pluginLists = [];
+        this.lifecycle = new Lifecycle(options);
         this.appContext = {};
-        this.appOptions = options;
-    }
-
-    /**
-     * 系统检查（已提取到 lifecycle/checker.ts）
-     */
-    async initCheck(): Promise<void> {
-        await Checker.run();
-    }
-
-    /**
-     * 加载插件（已提取到 lifecycle/loader.ts）
-     */
-    async loadPlugins(): Promise<void> {
-        await Loader.loadPlugins(this);
-    }
-
-    /**
-     * 加载API路由（已提取到 lifecycle/loader.ts）
-     */
-    async loadApis(dirName: string, options?: { isAddon?: boolean; addonName?: string }): Promise<void> {
-        await Loader.loadApis(dirName, this.apiRoutes, options);
     }
 
     /**
      * 启动服务器
+     * @param callback - 启动完成后的回调函数
      */
     async listen(callback?: (server: Server) => void): Promise<void> {
-        const serverStartTime = Bun.nanoseconds();
-        Logger.info('开始启动 Befly 服务器...');
-
-        // 执行启动前的检查和加载
-        await this.initCheck();
-        await this.loadPlugins();
-        await this.loadApis('core');
-
-        // 加载 addon APIs
-        const addons = scanAddons();
-        for (const addon of addons) {
-            if (hasAddonDir(addon, 'apis')) {
-                await this.loadApis(addon, { isAddon: true, addonName: addon });
-            }
-        }
-
-        await this.loadApis('app');
-
-        const totalStartupTime = calcPerfTime(serverStartTime);
-        Logger.info(`服务器启动准备完成，总耗时: ${totalStartupTime}`);
-
-        // 启动HTTP服务器（路由处理逻辑已提取到 router/*.ts）
-        await Bootstrap.start(this, callback);
+        await this.lifecycle.start(this.appContext, callback);
     }
 }
 
-// 核心类已通过 export class 导出
-export { Env, Api, Jwt, Validator, Crypto2, Logger, Yes, No };
-export type { ApiOptions, FieldRules } from './types/api.js';
+// 核心类和工具导出（只导出运行时代码，不导出类型）
+export { Env, Fields, Jwt, Validator, Crypto2, Logger, Yes, No, cleanData, DbHelper, createSqlClient, RedisHelper, getRedis, getSql, getDbHelper, initDatabase, closeDatabase };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.0.0",
+    "version": "3.1.1",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -9,37 +9,19 @@
         "registry": "https://registry.npmjs.org"
     },
     "main": "main.ts",
-    "types": "main.ts",
+    "types": "./types/index.d.ts",
     "exports": {
         ".": {
-            "types": "./main.ts",
             "default": "./main.ts"
         },
         "./types": {
-            "types": "./types/index.ts",
-            "default": "./types/index.ts"
-        },
-        "./types/*": {
-            "types": "./types/*.ts",
-            "default": "./types/*.ts"
-        },
-        "./utils": {
-            "types": "./utils/index.ts",
-            "default": "./utils/index.ts"
-        },
-        "./utils/*": {
-            "types": "./utils/*.ts",
-            "default": "./utils/*.ts"
-        },
-        "./config": {
-            "types": "./config/env.ts",
-            "default": "./config/env.ts"
+            "types": "./types/index.d.ts",
+            "default": "./types/index.d.ts"
         }
     },
-    "bin": {
-        "befly": "./bin/befly.ts"
+    "scripts": {
+        "bundler": "bun build ./main.ts --outfile ./main.single.ts --minify --target bun"
     },
-    "scripts": {},
     "keywords": [
         "bun",
         "api",
@@ -56,7 +38,6 @@
     "homepage": "https://chensuiyi.me",
     "license": "Apache-2.0",
     "files": [
-        "bin/",
         "apis/",
         "checks/",
         "config/",
@@ -85,7 +66,5 @@
     "engines": {
         "bun": ">=1.3.0"
     },
-    "devDependencies": {
-        "@types/bun": "latest"
-    }
+    "gitHead": "ac46f8ed275518b2494b47323df5ed37feb6fb7d"
 }

package/plugins/db.ts

@@ -5,8 +5,8 @@
 
 import { Env } from '../config/env.js';
 import { Logger } from '../utils/logger.js';
-import { createSqlClient } from '../utils/index.js';
-import { SqlHelper } from '../utils/sqlHelper.js';
+import { createSqlClient } from '../utils/database.js';
+import { DbHelper } from '../utils/dbHelper.js';
 import type { Plugin } from '../types/plugin.js';
 import type { BeflyContext } from '../types/befly.js';
 
@@ -17,16 +17,21 @@ const dbPlugin: Plugin = {
     name: '_db',
     after: ['_redis'],
 
-    async onInit(befly: BeflyContext): Promise<SqlHelper | Record<string, never>> {
+    async onInit(befly: BeflyContext): Promise<DbHelper | Record<string, never>> {
         let sql: any = null;
 
         try {
             if (Env.DB_ENABLE === 1) {
                 // 创建 Bun SQL 客户端（内置连接池），并确保连接验证成功后再继续
-                sql = await createSqlClient();
+                // 从环境变量读取连接超时配置
+                const connectionTimeout = process.env.DB_CONNECTION_TIMEOUT ? parseInt(process.env.DB_CONNECTION_TIMEOUT) : 5000;
+
+                sql = await createSqlClient({
+                    connectionTimeout
+                });
 
                 // 创建数据库管理器实例，直接传入 sql 对象
-                const dbManager = new SqlHelper(befly, sql);
+                const dbManager = new DbHelper(befly, sql);
 
                 Logger.info('数据库插件初始化成功');
                 return dbManager;
@@ -35,11 +40,7 @@ const dbPlugin: Plugin = {
                 return {};
             }
         } catch (error: any) {
-            Logger.error({
-                msg: '数据库初始化失败',
-                message: error.message,
-                stack: error.stack
-            });
+            Logger.error('数据库初始化失败', error);
 
             // 清理资源
             if (sql) {

package/plugins/redis.ts

@@ -5,7 +5,8 @@
 
 import { Env } from '../config/env.js';
 import { Logger } from '../utils/logger.js';
-import { RedisHelper, initRedisClient, getRedisClient } from '../utils/redisHelper.js';
+import { RedisHelper } from '../utils/redisHelper.js';
+import { initRedisOnly } from '../utils/database.js';
 import type { Plugin } from '../types/plugin.js';
 import type { BeflyContext } from '../types/befly.js';
 
@@ -19,8 +20,8 @@ const redisPlugin: Plugin = {
     async onInit(befly: BeflyContext): Promise<typeof RedisHelper | Record<string, never>> {
         try {
             if (Env.REDIS_ENABLE === 1) {
-                // 初始化 Redis 客户端（带连接测试）
-                await initRedisClient();
+                // 初始化 Redis 客户端（统一使用 database.ts 的连接管理）
+                await initRedisOnly();
 
                 Logger.info('Redis 插件初始化成功', {
                     host: Env.REDIS_HOST,
@@ -35,12 +36,7 @@ const redisPlugin: Plugin = {
                 return {};
             }
         } catch (error: any) {
-            Logger.error({
-                msg: 'Redis 初始化失败',
-                message: error.message,
-                code: error.code,
-                stack: error.stack
-            });
+            Logger.error('Redis 初始化失败', error);
 
             // 插件内禁止直接退出进程，抛出异常交由主流程统一处理
             throw error;

package/scripts/syncDb/apply.ts

@@ -7,7 +7,7 @@
  */
 
 import { Logger } from '../../utils/logger.js';
-import { parseRule } from '../../utils/tableHelper.js';
+import { parseRule } from '../../utils/helper.js';
 import { IS_MYSQL, IS_PG, IS_SQLITE, CHANGE_TYPE_LABELS, typeMapping } from './constants.js';
 import { logFieldChange, resolveDefaultValue, isStringOrArrayType } from './helpers.js';
 import { executeDDLSafely, buildIndexSQL } from './ddl.js';
@@ -151,8 +151,8 @@ export async function applyTablePlan(sql: SQL, tableName: string, fields: Record
                     Logger.info(`[索引变化] 删除索引 ${tableName}.${act.indexName} (${act.fieldName})`);
                 }
             } catch (error: any) {
-                Logger.error(`${act.action === 'create' ? '创建' : '删除'}索引失败: ${error.message}`);
-                Logger.error(`表名: ${tableName}, 索引名: ${act.indexName}, 字段: ${act.fieldName}`);
+                Logger.error(`${act.action === 'create' ? '创建' : '删除'}索引失败:`, error);
+                Logger.warn(`表名: ${tableName}, 索引名: ${act.indexName}, 字段: ${act.fieldName}`);
                 throw error;
             }
         }

package/scripts/syncDb/constants.ts

@@ -66,5 +66,6 @@ export 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'
+    array_string: IS_SQLITE ? 'TEXT' : IS_PG ? 'character varying' : 'VARCHAR',
+    array_text: IS_MYSQL ? 'MEDIUMTEXT' : 'TEXT'
 };

package/scripts/syncDb/ddl.ts

@@ -9,8 +9,9 @@
  */
 
 import { Logger } from '../../utils/logger.js';
-import { parseRule } from '../../utils/tableHelper.js';
-import { IS_MYSQL, IS_PG, IS_SQLITE, SYSTEM_INDEX_FIELDS, typeMapping } from './constants.js';
+import { parseRule, toSnakeCase } from '../../utils/helper.js';
+import type { ParsedFieldRule, AnyObject } from '../../types/common.js';
+import { IS_MYSQL, IS_PG, typeMapping } from './constants.js';
 import { quoteIdentifier, resolveDefaultValue, generateDefaultSql, getSqlType, escapeComment } from './helpers.js';
 import type { SQL } from 'bun';
 
@@ -78,6 +79,9 @@ export function buildBusinessColumnDefs(fields: Record<string, string>): string[
     const colDefs: string[] = [];
 
     for (const [fieldKey, fieldRule] of Object.entries(fields)) {
+        // 转换字段名为下划线格式
+        const dbFieldName = toSnakeCase(fieldKey);
+
         const parsed = parseRule(fieldRule);
         const { name: fieldName, type: fieldType, max: fieldMax, default: fieldDefault } = parsed;
         const sqlType = getSqlType(fieldType, fieldMax);
@@ -87,9 +91,9 @@ export function buildBusinessColumnDefs(fields: Record<string, string>): string[
         const defaultSql = generateDefaultSql(actualDefault, fieldType);
 
         if (IS_MYSQL) {
-            colDefs.push(`\`${fieldKey}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${escapeComment(fieldName)}"`);
+            colDefs.push(`\`${dbFieldName}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${escapeComment(fieldName)}"`);
         } else {
-            colDefs.push(`"${fieldKey}" ${sqlType} NOT NULL${defaultSql}`);
+            colDefs.push(`"${dbFieldName}" ${sqlType} NOT NULL${defaultSql}`);
         }
     }
 
@@ -105,6 +109,9 @@ export function buildBusinessColumnDefs(fields: Record<string, string>): string[
  * @returns DDL 子句
  */
 export function generateDDLClause(fieldKey: string, fieldRule: string, isAdd: boolean = false): string {
+    // 转换字段名为下划线格式
+    const dbFieldName = toSnakeCase(fieldKey);
+
     const parsed = parseRule(fieldRule);
     const { name: fieldName, type: fieldType, max: fieldMax, default: fieldDefault } = parsed;
     const sqlType = getSqlType(fieldType, fieldMax);
@@ -114,15 +121,15 @@ export function generateDDLClause(fieldKey: string, fieldRule: string, isAdd: bo
     const defaultSql = generateDefaultSql(actualDefault, fieldType);
 
     if (IS_MYSQL) {
-        return `${isAdd ? 'ADD COLUMN' : 'MODIFY COLUMN'} \`${fieldKey}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${escapeComment(fieldName)}"`;
+        return `${isAdd ? 'ADD COLUMN' : 'MODIFY COLUMN'} \`${dbFieldName}\` ${sqlType} NOT NULL${defaultSql} COMMENT "${escapeComment(fieldName)}"`;
     }
     if (IS_PG) {
-        if (isAdd) return `ADD COLUMN IF NOT EXISTS "${fieldKey}" ${sqlType} NOT NULL${defaultSql}`;
+        if (isAdd) return `ADD COLUMN IF NOT EXISTS "${dbFieldName}" ${sqlType} NOT NULL${defaultSql}`;
         // PG 修改：类型与非空可分条执行，生成 TYPE 改变；非空另由上层统一控制
-        return `ALTER COLUMN "${fieldKey}" TYPE ${sqlType}`;
+        return `ALTER COLUMN "${dbFieldName}" TYPE ${sqlType}`;
     }
     // SQLite 仅支持 ADD COLUMN（>=3.50.0：支持 IF NOT EXISTS）
-    if (isAdd) return `ADD COLUMN IF NOT EXISTS "${fieldKey}" ${sqlType} NOT NULL${defaultSql}`;
+    if (isAdd) return `ADD COLUMN IF NOT EXISTS "${dbFieldName}" ${sqlType} NOT NULL${defaultSql}`;
     return '';
 }
 

package/scripts/syncDb/helpers.ts

@@ -9,7 +9,8 @@
  */
 
 import { IS_MYSQL, IS_PG, typeMapping } from './constants.js';
-import { isType } from '../../utils/typeHelper.js';
+import { isType } from '../../utils/helper.js';
+import { Logger } from '../../utils/logger.js';
 
 /**
  * 根据数据库类型引用标识符
@@ -158,7 +159,7 @@ export function escapeComment(str: string): string {
  * @param changeLabel - 变更类型的中文标签
  */
 export function logFieldChange(tableName: string, fieldName: string, changeType: string, oldValue: any, newValue: any, changeLabel: string): void {
-    console.log(`   修改表 ${tableName} 的字段 ${fieldName} 的${changeLabel}: ${oldValue} -> ${newValue}`);
+    Logger.info(`   修改表 ${tableName} 的字段 ${fieldName} 的${changeLabel}: ${oldValue} -> ${newValue}`);
 }
 
 /**

package/scripts/syncDb/index.ts

@@ -10,10 +10,11 @@
 import path from 'node:path';
 import { Logger } from '../../utils/logger.js';
 import { Env } from '../../config/env.js';
-import { createSqlClient, toSnakeTableName } from '../../utils/dbHelper.js';
+import { createSqlClient } from '../../utils/database.js';
+import { toSnakeCase } from '../../utils/helper.js';
 import checkTable from '../../checks/table.js';
-import { __dirtables, getProjectDir } from '../../system.js';
-import { scanAddons, hasAddonDir, getAddonDir } from '../../utils/addonHelper.js';
+import { paths } from '../../paths.js';
+import { scanAddons, getAddonDir, addonDirExists } from '../../utils/helper.js';
 
 // 导入模块化的功能
 import { ensureDbVersion } from './version.js';
@@ -63,30 +64,27 @@ export const SyncDb = async (): Promise<void> => {
         }
 
         // 阶段1：验证表定义文件
-        perfTracker.markPhase('validation');
+        perfTracker.markPhase('表定义验证');
         if (!(await checkTable())) {
             throw new Error('表定义验证失败');
         }
-        Logger.info(`✓ 表定义验证完成，耗时: ${perfTracker.getPhaseTime('validation')}`);
+        Logger.info(`✓ 表定义验证完成，耗时: ${perfTracker.getPhaseTime('表定义验证')}`);
 
         // 阶段2：建立数据库连接并检查版本
-        perfTracker.markPhase('connection');
+        perfTracker.markPhase('数据库连接');
         sql = await createSqlClient({ max: 1 });
         await ensureDbVersion(sql);
-        Logger.info(`✓ 数据库连接建立，耗时: ${perfTracker.getPhaseTime('connection')}`);
+        Logger.info(`✓ 数据库连接建立，耗时: ${perfTracker.getPhaseTime('数据库连接')}`);
 
         // 阶段3：扫描表定义文件
-        perfTracker.markPhase('scan');
+        perfTracker.markPhase('扫描表文件');
         const tablesGlob = new Bun.Glob('*.json');
-        const directories: Array<{ path: string; isCore: boolean; addonName?: string }> = [
-            { path: __dirtables, isCore: true },
-            { path: getProjectDir('tables'), isCore: false }
-        ];
+        const directories: Array<{ path: string; isCore: boolean; addonName?: string }> = [{ path: paths.projectTableDir, isCore: false }];
 
         // 添加所有 addon 的 tables 目录
         const addons = scanAddons();
         for (const addon of addons) {
-            if (hasAddonDir(addon, 'tables')) {
+            if (addonDirExists(addon, 'tables')) {
                 directories.push({
                     path: getAddonDir(addon, 'tables'),
                     isCore: false,
@@ -109,16 +107,16 @@ export const SyncDb = async (): Promise<void> => {
                 }
             }
         }
-        perfTracker.finishPhase('scan');
-        Logger.info(`✓ 扫描完成，发现 ${totalTables} 个表定义文件，耗时: ${perfTracker.getPhaseTime('scan')}`);
+        perfTracker.finishPhase('扫描表文件');
+        Logger.info(`✓ 扫描完成，发现 ${totalTables} 个表定义文件，耗时: ${perfTracker.getPhaseTime('扫描表文件')}`);
 
         // 阶段4：处理表文件
-        perfTracker.markPhase('process');
+        perfTracker.markPhase('同步处理');
         let processedCount = 0;
 
         for (const dirConfig of directories) {
             const { path: dir, isCore, addonName } = dirConfig;
-            const dirType = isCore ? '内核' : addonName ? `组件[${addonName}]` : '项目';
+            const dirType = addonName ? `组件${addonName}` : '项目';
 
             for await (const file of tablesGlob.scan({
                 cwd: dir,
@@ -134,14 +132,11 @@ export const SyncDb = async (): Promise<void> => {
                 }
 
                 // 确定表名前缀：
-                // - 核心表：sys_ 前缀
-                // - addon 表：{addonName}_ 前缀
+                // - addon 表：addon_{addonName}_ 前缀
                 // - 项目表：无前缀
-                let tableName = toSnakeTableName(fileName);
-                if (isCore) {
-                    tableName = `sys_${tableName}`;
-                } else if (addonName) {
-                    tableName = `${addonName}_${tableName}`;
+                let tableName = toSnakeCase(fileName);
+                if (addonName) {
+                    tableName = `addon_${addonName}_${tableName}`;
                 }
 
                 processedCount++;
@@ -161,8 +156,8 @@ export const SyncDb = async (): Promise<void> => {
             }
         }
 
-        perfTracker.finishPhase('process');
-        Logger.info(`✓ 表处理完成，耗时: ${perfTracker.getPhaseTime('process')}`);
+        perfTracker.finishPhase('同步处理');
+        Logger.info(`✓ 表处理完成，耗时: ${perfTracker.getPhaseTime('同步处理')}`);
 
         // 阶段5：显示统计信息
         Logger.info('\n=== 同步统计信息 ===');
@@ -186,14 +181,7 @@ export const SyncDb = async (): Promise<void> => {
         // 输出性能统计
         perfTracker.logStats();
     } catch (error: any) {
-        Logger.error(`数据库同步失败: ${error.message}`);
-        Logger.error(`错误详情: ${error.stack}`);
-        if (error.code) {
-            Logger.error(`错误代码: ${error.code}`);
-        }
-        if (error.errno) {
-            Logger.error(`错误编号: ${error.errno}`);
-        }
+        Logger.error(`数据库同步失败`, error);
         process.exit(1);
     } finally {
         if (sql) {
@@ -209,7 +197,7 @@ export const SyncDb = async (): Promise<void> => {
 // 如果直接运行此脚本（Bun 支持 import.meta.main）
 if (import.meta.main) {
     SyncDb().catch((error) => {
-        console.error('❌ 数据库同步失败:', error);
+        Logger.error('数据库同步失败', error);
         process.exit(1);
     });
 }

package/scripts/syncDb/state.ts

@@ -6,6 +6,8 @@
  * - 进度信息记录
  */
 
+import { Logger } from '../../utils/logger.js';
+
 /**
  * 阶段统计信息
  */
@@ -67,13 +69,13 @@ export class PerformanceTracker {
      * 输出所有阶段统计
      */
     logStats(): void {
-        console.log('\n⏱️  性能统计:');
+        Logger.info('\n⏱️  性能统计:');
         for (const [phase, stats] of this.phases) {
             const duration = stats.duration || Date.now() - stats.startTime;
             const timeStr = duration > 1000 ? `${(duration / 1000).toFixed(2)}s` : `${duration}ms`;
-            console.log(`   ${phase}: ${timeStr}`);
+            Logger.info(`   ${phase}: ${timeStr}`);
         }
-        console.log(`   总耗时: ${this.getTotalTime()}`);
+        Logger.info(`   总耗时: ${this.getTotalTime()}`);
     }
 }
 
@@ -85,20 +87,20 @@ export class ProgressLogger {
      * 记录表处理进度
      */
     logTableProgress(current: number, total: number, tableName: string): void {
-        console.log(`\n[${current}/${total}] 处理表: ${tableName}`);
+        Logger.info(`\n[${current}/${total}] 处理表: ${tableName}`);
     }
 
     /**
      * 记录字段变更进度
      */
     logFieldChangeProgress(current: number, total: number, fieldName: string, changeType: string): void {
-        console.log(`   [${current}/${total}] 修改字段 ${fieldName} (${changeType})`);
+        Logger.info(`   [${current}/${total}] 修改字段 ${fieldName} (${changeType})`);
     }
 
     /**
      * 记录索引创建进度
      */
     logIndexProgress(current: number, total: number, indexName: string): void {
-        console.log(`   [${current}/${total}] 创建索引: ${indexName}`);
+        Logger.info(`   [${current}/${total}] 创建索引: ${indexName}`);
     }
 }