befly 3.2.1 → 3.3.1

package/commands/syncApi.ts

@@ -0,0 +1,327 @@
+/**
+ * SyncApi 命令 - 同步 API 接口数据到数据库
+ * 说明：遍历所有 API 文件，收集接口路由信息并同步到 core_api 表
+ *
+ * 流程：
+ * 1. 扫描 core/apis 目录下所有 Core API 文件
+ * 2. 扫描项目 apis 目录下所有项目 API 文件
+ * 3. 扫描 node_modules/@befly-addon/* 目录下所有组件 API 文件
+ * 4. 提取每个 API 的 name、method、auth 等信息
+ * 5. 根据接口路径检查是否存在
+ * 6. 存在则更新，不存在则新增
+ * 7. 删除配置中不存在的接口记录
+ */
+
+import { Logger } from '../lib/logger.js';
+import { Database } from '../lib/database.js';
+import { scanAddons, getAddonDir, addonDirExists } from '../util.js';
+import { readdirSync, statSync } from 'node:fs';
+import { join, dirname, relative, basename } from 'pathe';
+
+interface SyncApiOptions {
+    plan?: boolean;
+}
+
+interface ApiInfo {
+    name: string;
+    path: string;
+    method: string;
+    description: string;
+    addonName: string;
+    addonTitle: string;
+}
+
+/**
+ * 递归扫描目录下的所有 .ts 文件
+ */
+function scanTsFiles(dir: string, fileList: string[] = []): string[] {
+    try {
+        const files = readdirSync(dir);
+
+        for (const file of files) {
+            const filePath = join(dir, file);
+            const stat = statSync(filePath);
+
+            if (stat.isDirectory()) {
+                scanTsFiles(filePath, fileList);
+            } else if (file.endsWith('.ts') && !file.endsWith('.d.ts')) {
+                fileList.push(filePath);
+            }
+        }
+    } catch (error: any) {
+        Logger.warn(`扫描目录失败: ${dir}`, error.message);
+    }
+
+    return fileList;
+}
+
+/**
+ * 从 API 文件中提取接口信息
+ */
+async function extractApiInfo(filePath: string, apiRoot: string, type: 'core' | 'app' | 'addon', addonName: string = '', addonTitle: string = ''): Promise<ApiInfo | null> {
+    try {
+        const apiModule = await import(filePath);
+        const apiConfig = apiModule.default;
+
+        if (!apiConfig || !apiConfig.name) {
+            return null;
+        }
+
+        let apiPath = '';
+
+        if (type === 'core') {
+            // Core 接口：保留完整目录层级
+            // 例: apis/menu/all.ts → /api/core/menu/all
+            const relativePath = relative(apiRoot, filePath);
+            const pathWithoutExt = relativePath.replace(/\.ts$/, '');
+            apiPath = `/api/core/${pathWithoutExt}`;
+        } else if (type === 'addon') {
+            // Addon 接口：保留完整目录层级
+            // 例: apis/menu/list.ts → /api/addon/admin/menu/list
+            const relativePath = relative(apiRoot, filePath);
+            const pathWithoutExt = relativePath.replace(/\.ts$/, '');
+            apiPath = `/api/addon/${addonName}/${pathWithoutExt}`;
+        } else {
+            // 项目接口：保留完整目录层级
+            // 例: apis/user/list.ts → /api/user/list
+            const relativePath = relative(apiRoot, filePath);
+            const pathWithoutExt = relativePath.replace(/\.ts$/, '');
+            apiPath = `/api/${pathWithoutExt}`;
+        }
+
+        return {
+            name: apiConfig.name || '',
+            path: apiPath,
+            method: apiConfig.method || 'POST',
+            description: apiConfig.description || '',
+            addonName: type === 'core' ? 'core' : addonName,
+            addonTitle: type === 'core' ? '核心接口' : addonTitle || addonName
+        };
+    } catch (error: any) {
+        Logger.error(`解析 API 文件失败: ${filePath}`, error);
+        return null;
+    }
+}
+
+/**
+ * 扫描所有 API 文件
+ */
+async function scanAllApis(projectRoot: string): Promise<ApiInfo[]> {
+    const apis: ApiInfo[] = [];
+
+    // 1. 扫描 Core 框架 API
+    Logger.info('=== 扫描 Core 框架 API (core/apis) ===');
+    const coreApisDir = join(dirname(projectRoot), 'core', 'apis');
+    try {
+        const coreApiFiles = scanTsFiles(coreApisDir);
+        Logger.info(`  找到 ${coreApiFiles.length} 个核心 API 文件`);
+
+        for (const filePath of coreApiFiles) {
+            const apiInfo = await extractApiInfo(filePath, coreApisDir, 'core', '', '核心接口');
+            if (apiInfo) {
+                apis.push(apiInfo);
+                Logger.info(`  └ ${apiInfo.path} - ${apiInfo.name}`);
+            }
+        }
+
+        // 2. 扫描项目 API
+        Logger.info('\n=== 扫描项目 API (apis) ===');
+        const projectApisDir = join(projectRoot, 'apis');
+        const projectApiFiles = scanTsFiles(projectApisDir);
+        Logger.info(`  找到 ${projectApiFiles.length} 个项目 API 文件`);
+
+        for (const filePath of projectApiFiles) {
+            const apiInfo = await extractApiInfo(filePath, projectApisDir, 'app', '', '项目接口');
+            if (apiInfo) {
+                apis.push(apiInfo);
+                Logger.info(`  └ ${apiInfo.path} - ${apiInfo.name}`);
+            }
+        }
+
+        // 3. 扫描组件 API (node_modules/@befly-addon/*)
+        Logger.info('\n=== 扫描组件 API (node_modules/@befly-addon/*) ===');
+        const addonNames = scanAddons();
+
+        for (const addonName of addonNames) {
+            // addonName 格式: admin, demo 等
+
+            // 检查 apis 子目录是否存在
+            if (!addonDirExists(addonName, 'apis')) {
+                Logger.info(`  [${addonName}] 无 apis 目录，跳过`);
+                continue;
+            }
+
+            const addonApisDir = getAddonDir(addonName, 'apis');
+
+            // 读取 addon 配置
+            const addonConfigPath = getAddonDir(addonName, 'addon.config.json');
+            let addonTitle = addonName;
+            try {
+                const configFile = Bun.file(addonConfigPath);
+                const config = await configFile.json();
+                addonTitle = config.title || addonName;
+            } catch (error) {
+                Logger.debug(`  [${addonName}] 无法读取配置文件，使用默认标题`);
+            }
+
+            const addonApiFiles = scanTsFiles(addonApisDir);
+            Logger.info(`  [${addonName}] 找到 ${addonApiFiles.length} 个 API 文件`);
+
+            for (const filePath of addonApiFiles) {
+                const apiInfo = await extractApiInfo(filePath, addonApisDir, 'addon', addonName, addonTitle);
+                if (apiInfo) {
+                    apis.push(apiInfo);
+                    Logger.info(`    └ ${apiInfo.path} - ${apiInfo.name}`);
+                }
+            }
+        }
+
+        return apis;
+    } catch (error: any) {
+        Logger.error(`接口扫描失败:`, error);
+    }
+}
+
+/**
+ * 同步 API 数据到数据库
+ */
+async function syncApis(helper: any, apis: ApiInfo[]): Promise<{ created: number; updated: number }> {
+    const stats = { created: 0, updated: 0 };
+
+    for (const api of apis) {
+        try {
+            const existing = await helper.getOne({
+                table: 'core_api',
+                where: { path: api.path }
+            });
+
+            if (existing) {
+                await helper.updData({
+                    table: 'core_api',
+                    where: { id: existing.id },
+                    data: {
+                        name: api.name,
+                        method: api.method,
+                        description: api.description,
+                        addonName: api.addonName,
+                        addonTitle: api.addonTitle
+                    }
+                });
+                stats.updated++;
+                Logger.info(`  └ 更新接口: ${api.name} (ID: ${existing.id}, Path: ${api.path})`);
+            } else {
+                const id = await helper.insData({
+                    table: 'core_api',
+                    data: {
+                        name: api.name,
+                        path: api.path,
+                        method: api.method,
+                        description: api.description,
+                        addonName: api.addonName,
+                        addonTitle: api.addonTitle
+                    }
+                });
+                stats.created++;
+                Logger.info(`  └ 新增接口: ${api.name} (ID: ${id}, Path: ${api.path})`);
+            }
+        } catch (error: any) {
+            Logger.error(`同步接口 "${api.name}" 失败:`, error);
+        }
+    }
+
+    return stats;
+}
+
+/**
+ * 删除配置中不存在的记录
+ */
+async function deleteObsoleteRecords(helper: any, apiPaths: Set<string>): Promise<number> {
+    Logger.info(`\n=== 删除配置中不存在的记录 ===`);
+
+    const allRecords = await helper.getAll({
+        table: 'core_api',
+        fields: ['id', 'path', 'name'],
+        where: { state$gte: 0 } // 查询所有状态（包括软删除的 state=0）
+    });
+
+    let deletedCount = 0;
+    for (const record of allRecords) {
+        if (record.path && !apiPaths.has(record.path)) {
+            await helper.delForce({
+                table: 'core_api',
+                where: { id: record.id }
+            });
+            deletedCount++;
+            Logger.info(`  └ 删除记录: ${record.name} (ID: ${record.id}, path: ${record.path})`);
+        }
+    }
+
+    if (deletedCount === 0) {
+        Logger.info('  ✅ 无需删除的记录');
+    }
+
+    return deletedCount;
+}
+
+/**
+ * SyncApi 命令主函数
+ */
+export async function syncApiCommand(options: SyncApiOptions = {}) {
+    try {
+        if (options.plan) {
+            Logger.info('[计划] 同步 API 接口到数据库（plan 模式不执行）');
+            Logger.info('[计划] 1. 扫描 apis 和 addons/*/apis 目录');
+            Logger.info('[计划] 2. 提取每个 API 的配置信息');
+            Logger.info('[计划] 3. 根据 path 检查接口是否存在');
+            Logger.info('[计划] 4. 存在则更新，不存在则新增');
+            Logger.info('[计划] 5. 删除文件中不存在的接口记录');
+            return;
+        }
+
+        Logger.info('开始同步 API 接口到数据库...\n');
+
+        const projectRoot = process.cwd();
+
+        // 连接数据库（SQL + Redis）
+        await Database.connect();
+
+        const helper = Database.getDbHelper();
+
+        // 1. 检查表是否存在
+        Logger.info('=== 检查数据表 ===');
+        const exists = await helper.tableExists('core_api');
+
+        if (!exists) {
+            Logger.error(`❌ 表 core_api 不存在，请先运行 befly syncDb 同步数据库`);
+            process.exit(1);
+        }
+
+        Logger.info(`✅ 表 core_api 存在\n`);
+
+        // 2. 扫描所有 API 文件
+        Logger.info('=== 步骤 2: 扫描 API 文件 ===');
+        const apis = await scanAllApis(projectRoot);
+        const apiPaths = new Set(apis.map((api) => api.path));
+        Logger.info(`\n✅ 共扫描到 ${apis.length} 个 API 接口\n`);
+
+        // 3. 同步 API 数据
+        Logger.info('=== 步骤 3: 同步 API 数据（新增/更新） ===');
+        const stats = await syncApis(helper, apis);
+
+        // 4. 删除文件中不存在的接口
+        const deletedCount = await deleteObsoleteRecords(helper, apiPaths);
+
+        // 5. 输出统计信息
+        Logger.info(`\n=== 接口同步完成 ===`);
+        Logger.info(`新增接口: ${stats.created} 个`);
+        Logger.info(`更新接口: ${stats.updated} 个`);
+        Logger.info(`删除接口: ${deletedCount} 个`);
+        Logger.info(`当前总接口数: ${apis.length} 个`);
+        Logger.info('提示: 接口缓存将在服务器启动时自动完成');
+    } catch (error: any) {
+        Logger.error('API 同步失败:', error);
+        process.exit(1);
+    } finally {
+        await Database?.disconnect();
+    }
+}

package/{scripts → commands}/syncDb/apply.ts

@@ -6,8 +6,8 @@
  * - 应用表结构变更计划
  */
 
-import { Logger } from '../../utils/logger.js';
-import { parseRule } from '../../utils/helper.js';
+import { Logger } from '../../lib/logger.js';
+import { parseRule } from '../../util.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';

package/{scripts → commands}/syncDb/constants.ts

@@ -2,13 +2,14 @@
  * syncDb 常量定义模块
  *
  * 包含：
- * - 数据库版本要求
+ * - 数据库类型判断
+ * - 版本要求
+ * - 数据类型映射
  * - 系统字段定义
- * - 索引字段配置
- * - 字段变更类型标签
  */
 
 import { Env } from '../../config/env.js';
+import type { Dialect } from './types.js';
 
 /**
  * 数据库版本要求
@@ -47,12 +48,17 @@ export const CHANGE_TYPE_LABELS = {
 } as const;
 
 /**
- * MySQL 表配置（支持环境变量自定义）
+ * MySQL 表配置
+ *
+ * 固定配置说明：
+ * - ENGINE: InnoDB（支持事务、外键）
+ * - CHARSET: utf8mb4（完整 Unicode 支持，包括 Emoji）
+ * - COLLATE: utf8mb4_0900_ai_ci（MySQL 8.0 推荐，不区分重音和大小写）
  */
 export const MYSQL_TABLE_CONFIG = {
-    ENGINE: Env.MYSQL_ENGINE || 'InnoDB',
-    CHARSET: Env.MYSQL_CHARSET || 'utf8mb4',
-    COLLATE: Env.MYSQL_COLLATE || 'utf8mb4_0900_as_cs'
+    ENGINE: 'InnoDB',
+    CHARSET: 'utf8mb4',
+    COLLATE: 'utf8mb4_0900_ai_ci'
 } as const;
 
 // 数据库类型判断

package/{scripts → commands}/syncDb/ddl.ts

@@ -8,12 +8,14 @@
  * - 构建系统列和业务列定义
  */
 
-import { Logger } from '../../utils/logger.js';
-import { parseRule, toSnakeCase } from '../../utils/helper.js';
-import type { ParsedFieldRule, AnyObject } from '../../types/common.js';
+import { snakeCase } from 'es-toolkit/string';
+import { parseRule } from '../../util.js';
+import { Logger } from '../../lib/logger.js';
 import { IS_MYSQL, IS_PG, typeMapping } from './constants.js';
 import { quoteIdentifier, resolveDefaultValue, generateDefaultSql, getSqlType, escapeComment } from './helpers.js';
+
 import type { SQL } from 'bun';
+import type { ParsedFieldRule, AnyObject } from 'befly/types/common.js';
 
 /**
  * 构建索引操作 SQL（统一使用在线策略）
@@ -80,7 +82,7 @@ export function buildBusinessColumnDefs(fields: Record<string, string>): string[
 
     for (const [fieldKey, fieldRule] of Object.entries(fields)) {
         // 转换字段名为下划线格式
-        const dbFieldName = toSnakeCase(fieldKey);
+        const dbFieldName = snakeCase(fieldKey);
 
         const parsed = parseRule(fieldRule);
         const { name: fieldName, type: fieldType, max: fieldMax, default: fieldDefault } = parsed;
@@ -110,7 +112,7 @@ export function buildBusinessColumnDefs(fields: Record<string, string>): string[
  */
 export function generateDDLClause(fieldKey: string, fieldRule: string, isAdd: boolean = false): string {
     // 转换字段名为下划线格式
-    const dbFieldName = toSnakeCase(fieldKey);
+    const dbFieldName = snakeCase(fieldKey);
 
     const parsed = parseRule(fieldRule);
     const { name: fieldName, type: fieldType, max: fieldMax, default: fieldDefault } = parsed;

package/{scripts → commands}/syncDb/helpers.ts

@@ -1,16 +1,14 @@
 /**
- * syncDb 辅助函数模块
+ * syncDb 辅助工具模块
  *
  * 包含：
- * - SQL 标识符引用
- * - 日志格式化
- * - 类型判断工具
+ * - 标识符引用（反引号/双引号转义）
  * - 默认值处理
+ * - 日志输出格式化
  */
 
 import { IS_MYSQL, IS_PG, typeMapping } from './constants.js';
-import { isType } from '../../utils/helper.js';
-import { Logger } from '../../utils/logger.js';
+import { Logger } from '../../lib/logger.js';
 
 /**
  * 根据数据库类型引用标识符
@@ -86,7 +84,7 @@ export function generateDefaultSql(actualDefault: any, fieldType: 'number' | 'st
 
     // 仅 number/string/array 类型设置默认值
     if (fieldType === 'number' || fieldType === 'string' || fieldType === 'array') {
-        if (isType(actualDefault, 'number')) {
+        if (typeof actualDefault === 'number' && !Number.isNaN(actualDefault)) {
             return ` DEFAULT ${actualDefault}`;
         } else {
             // 字符串需要转义单引号：' -> ''
@@ -99,39 +97,41 @@ export function generateDefaultSql(actualDefault: any, fieldType: 'number' | 'st
 }
 
 /**
- * 判断是否为字符串或数组类型（需要长度限制的类型）
+ * 判断是否为字符串或数组类型（需要长度参数）
  *
  * @param fieldType - 字段类型
- * @returns 是否为 string 或 array
+ * @returns 是否为字符串或数组类型
  *
  * @example
  * isStringOrArrayType('string') // => true
- * isStringOrArrayType('array') // => true
+ * isStringOrArrayType('array_string') // => true
+ * isStringOrArrayType('array_text') // => false
  * isStringOrArrayType('number') // => false
  * isStringOrArrayType('text') // => false
  */
 export function isStringOrArrayType(fieldType: string): boolean {
-    return fieldType === 'string' || fieldType === 'array';
+    return fieldType === 'string' || fieldType === 'array_string';
 }
 
 /**
  * 获取 SQL 数据类型
  *
- * @param fieldType - 字段类型（number/string/text/array）
- * @param fieldMax - 最大长度（string/array 类型需要）
+ * @param fieldType - 字段类型（number/string/text/array_string/array_text）
+ * @param fieldMax - 最大长度（string/array_string 类型需要）
  * @returns SQL 类型字符串
  *
  * @example
  * getSqlType('string', 100) // => 'VARCHAR(100)'
  * getSqlType('number', null) // => 'BIGINT'
- * getSqlType('text', null) // => 'TEXT'
- * getSqlType('array', 500) // => 'VARCHAR(500)'
+ * getSqlType('text', null) // => 'MEDIUMTEXT'
+ * getSqlType('array_string', 500) // => 'VARCHAR(500)'
+ * getSqlType('array_text', null) // => 'MEDIUMTEXT'
  */
 export function getSqlType(fieldType: string, fieldMax: number | null): string {
     if (isStringOrArrayType(fieldType)) {
         return `${typeMapping[fieldType]}(${fieldMax})`;
     }
-    return typeMapping[fieldType];
+    return typeMapping[fieldType] || 'TEXT';
 }
 
 /**
@@ -149,7 +149,7 @@ export function escapeComment(str: string): string {
 }
 
 /**
- * 记录字段变更信息（带缩进和格式化）
+ * 记录字段变更信息（紧凑格式）
  *
  * @param tableName - 表名
  * @param fieldName - 字段名
@@ -159,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 {
-    Logger.info(`   修改表 ${tableName} 的字段 ${fieldName} 的${changeLabel}: ${oldValue} -> ${newValue}`);
+    Logger.info(`  ~ 修改 ${fieldName} ${changeLabel}: ${oldValue} -> ${newValue}`);
 }
 
 /**

package/{scripts → commands}/syncDb/index.ts

@@ -7,14 +7,14 @@
  * - 提供统计信息和错误处理
  */
 
-import path from 'node:path';
-import { Logger } from '../../utils/logger.js';
+import { basename } from 'pathe';
+import { snakeCase } from 'es-toolkit/string';
+import { Logger } from '../../lib/logger.js';
 import { Env } from '../../config/env.js';
-import { createSqlClient } from '../../utils/database.js';
-import { toSnakeCase } from '../../utils/helper.js';
+import { scanAddons, addonDirExists, getAddonDir } from '../../util.js';
+import { Database } from '../../lib/database.js';
 import checkTable from '../../checks/table.js';
 import { paths } from '../../paths.js';
-import { scanAddons, getAddonDir, addonDirExists } from '../../utils/helper.js';
 
 // 导入模块化的功能
 import { ensureDbVersion } from './version.js';
@@ -72,22 +72,27 @@ export const SyncDb = async (): Promise<void> => {
 
         // 阶段2：建立数据库连接并检查版本
         perfTracker.markPhase('数据库连接');
-        sql = await createSqlClient({ max: 1 });
+        sql = await Database.connectSql({ max: 1 });
         await ensureDbVersion(sql);
         Logger.info(`✓ 数据库连接建立，耗时: ${perfTracker.getPhaseTime('数据库连接')}`);
 
         // 阶段3：扫描表定义文件
         perfTracker.markPhase('扫描表文件');
         const tablesGlob = new Bun.Glob('*.json');
-        const directories: Array<{ path: string; isCore: boolean; addonName?: string }> = [{ path: paths.projectTableDir, isCore: false }];
-
-        // 添加所有 addon 的 tables 目录
+        const directories: Array<{ path: string; type: 'core' | 'app' | 'addon'; addonName?: string }> = [
+            // 1. core 框架表（core_ 前缀）
+            { path: paths.coreTableDir, type: 'core' },
+            // 2. 项目表（无前缀）
+            { path: paths.projectTableDir, type: 'app' }
+        ];
+
+        // 添加所有 addon 的 tables 目录（addon_{name}_ 前缀）
         const addons = scanAddons();
         for (const addon of addons) {
             if (addonDirExists(addon, 'tables')) {
                 directories.push({
                     path: getAddonDir(addon, 'tables'),
-                    isCore: false,
+                    type: 'addon',
                     addonName: addon
                 });
             }
@@ -101,7 +106,7 @@ export const SyncDb = async (): Promise<void> => {
                 absolute: true,
                 onlyFiles: true
             })) {
-                const fileName = path.basename(file, '.json');
+                const fileName = basename(file, '.json');
                 if (!fileName.startsWith('_')) {
                     totalTables++;
                 }
@@ -115,15 +120,15 @@ export const SyncDb = async (): Promise<void> => {
         let processedCount = 0;
 
         for (const dirConfig of directories) {
-            const { path: dir, isCore, addonName } = dirConfig;
-            const dirType = addonName ? `组件${addonName}` : '项目';
+            const { path: dir, type, addonName } = dirConfig;
+            const dirType = type === 'core' ? '核心' : type === 'addon' ? `组件${addonName}` : '项目';
 
             for await (const file of tablesGlob.scan({
                 cwd: dir,
                 absolute: true,
                 onlyFiles: true
             })) {
-                const fileName = path.basename(file, '.json');
+                const fileName = basename(file, '.json');
 
                 // 跳过以下划线开头的文件（这些是公共字段规则，不是表定义）
                 if (fileName.startsWith('_')) {
@@ -131,17 +136,26 @@ export const SyncDb = async (): Promise<void> => {
                     continue;
                 }
 
-                // 确定表名前缀：
-                // - addon 表：addon_{addonName}_ 前缀
-                // - 项目表：无前缀
-                let tableName = toSnakeCase(fileName);
-                if (addonName) {
-                    tableName = `addon_${addonName}_${tableName}`;
+                // 确定表名：
+                // - core 表：core_{表名}
+                //   例如：user.json → core_user
+                // - addon 表：{addonName}_{表名}
+                //   例如：admin addon 的 user.json → admin_user
+                // - 项目表：{表名}
+                //   例如：user.json → user
+                let tableName = snakeCase(fileName);
+                if (type === 'core') {
+                    // core 框架表，添加 core_ 前缀
+                    tableName = `core_${tableName}`;
+                } else if (type === 'addon') {
+                    // addon 表，添加 {addonName}_ 前缀
+                    // 使用 snakeCase 统一转换（admin → admin）
+                    const addonNameSnake = snakeCase(addonName!);
+                    tableName = `${addonNameSnake}_${tableName}`;
                 }
 
                 processedCount++;
-                progressLogger.logTableProgress(processedCount, totalTables, tableName);
-                Logger.info(`  类型: ${dirType}`);
+                progressLogger.logTableProgress(processedCount, totalTables, tableName, dirType);
 
                 const tableDefinition = await Bun.file(file).json();
                 const existsTable = await tableExists(sql!, tableName);
@@ -186,7 +200,7 @@ export const SyncDb = async (): Promise<void> => {
     } finally {
         if (sql) {
             try {
-                await sql.close();
+                await Database.disconnectSql();
             } catch (error: any) {
                 Logger.warn('关闭数据库连接时出错:', error.message);
             }

package/{scripts → commands}/syncDb/sqlite.ts

@@ -5,7 +5,7 @@
  * - SQLite 重建表迁移（处理列修改等不支持的操作）
  */
 
-import { Logger } from '../../utils/logger.js';
+import { Logger } from '../../lib/logger.js';
 import { createTable } from './tableCreate.js';
 import type { SQL } from 'bun';
 

package/{scripts → commands}/syncDb/state.ts

@@ -6,7 +6,8 @@
  * - 进度信息记录
  */
 
-import { Logger } from '../../utils/logger.js';
+import type { SQL } from 'bun';
+import { Logger } from '../../lib/logger.js';
 
 /**
  * 阶段统计信息
@@ -84,10 +85,15 @@ export class PerformanceTracker {
  */
 export class ProgressLogger {
     /**
-     * 记录表处理进度
+     * 记录表处理进度（紧凑格式）
+     * @param current 当前进度
+     * @param total 总数
+     * @param tableName 表名
+     * @param dirType 目录类型（核心/项目/组件名）
      */
-    logTableProgress(current: number, total: number, tableName: string): void {
-        Logger.info(`\n[${current}/${total}] 处理表: ${tableName}`);
+    logTableProgress(current: number, total: number, tableName: string, dirType?: string): void {
+        const typeInfo = dirType ? ` (${dirType})` : '';
+        Logger.info(`[${current}/${total}] ${tableName}${typeInfo}`);
     }
 
     /**