zhin.js 1.0.16 → 1.0.18

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # zhin.js
 
+## 1.0.18
+
+### Patch Changes
+
+- d16a69c: fix: test trust publish
+- Updated dependencies [d16a69c]
+  - @zhin.js/logger@0.1.2
+  - @zhin.js/schema@1.0.2
+  - @zhin.js/core@1.0.18
+
+## 1.0.17
+
+### Patch Changes
+
+- Updated dependencies [3bc5d56]
+  - @zhin.js/core@1.0.17
+
 ## 1.0.16
 
 ### Patch Changes

package/lib/index.d.ts

@@ -1,6 +1,21 @@
 export * from '@zhin.js/core';
-import { AppConfig, App } from '@zhin.js/core';
 export { default as logger } from '@zhin.js/logger';
-export declare function createApp(config?: Partial<AppConfig>): Promise<App>;
-export declare function createApp(config_file?: string): Promise<App>;
+declare module "zhin.js" {
+    namespace Plugin {
+        interface Contexts {
+        }
+        interface Extensions {
+            /**
+             * 定义数据库模型
+             * @param name 模型名称
+             * @param definition 模型定义
+             */
+            defineModel<K extends keyof Models>(name: K, definition: import('@zhin.js/core').Definition<Models[K]>): void;
+        }
+    }
+    interface RegisteredAdapters {
+    }
+    interface Models {
+    }
+}
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,eAAe,CAAA;AAE7B,OAAO,EAAE,SAAS,EAAE,GAAG,EAAU,MAAM,eAAe,CAAA;AAKtD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEnD,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAC,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;AACzE,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,eAAe,CAAA;AAE7B,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAOnD,OAAO,QAAQ,SAAS,CAAC;IAEvB,UAAU,MAAM,CAAC;QAEf,UAAU,QAAQ;SAAG;QAErB,UAAU,UAAU;YAClB;;;;eAIG;YACH,WAAW,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;SAC/G;KACF;IAED,UAAU,kBAAkB;KAAG;IAE/B,UAAU,MAAM;KAAG;CACpB"}

package/lib/index.js

@@ -3,23 +3,6 @@
 // ================================================================================================
 // 导出核心框架
 export * from '@zhin.js/core';
-import { App, Config } from '@zhin.js/core';
-import path from 'path';
-import fs from 'fs';
 // 重新导出 logger（作为独立的工具）
 export { default as logger } from '@zhin.js/logger';
-export async function createApp(config_param) {
-    const envFiles = ['.env', `.env.${process.env.NODE_ENV}`].filter(f => fs.existsSync(path.join(process.cwd(), f)));
-    if (config_param === undefined) {
-        config_param = Config.supportedExtensions.map(ext => `zhin.config${ext}`).find(f => fs.existsSync(path.join(process.cwd(), f)));
-    }
-    if (config_param === undefined)
-        throw new Error('No configuration file found and no configuration provided.');
-    const app = new App(config_param);
-    app.watching(envFiles, () => {
-        console.log('Environment file changed, exiting to reload...');
-        process.exit(51);
-    });
-    return app;
-}
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uBAAuB;AACvB,mGAAmG;AAEnG,SAAS;AACT,cAAc,eAAe,CAAA;AAE7B,OAAO,EAAa,GAAG,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,uBAAuB;AACvB,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAInD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,YAAuC;IACnE,MAAM,QAAQ,GAAC,CAAC,MAAM,EAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3G,IAAG,YAAY,KAAG,SAAS,EAAC,CAAC;QACzB,YAAY,GAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAA,EAAE,CAAA,cAAc,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5H,CAAC;IACD,IAAG,YAAY,KAAG,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAC1G,MAAM,GAAG,GAAE,IAAI,GAAG,CAAC,YAAsB,CAAC,CAAC;IAC3C,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAC,GAAE,EAAE;QACtB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAA;QAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,OAAO,GAAG,CAAA;AACd,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uBAAuB;AACvB,mGAAmG;AAEnG,SAAS;AACT,cAAc,eAAe,CAAA;AAC7B,uBAAuB;AACvB,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAA"}

package/lib/log-transport.d.ts

@@ -0,0 +1,37 @@
+import { LogTransport } from '@zhin.js/logger';
+import { Plugin } from '@zhin.js/core';
+/**
+ * 数据库日志传输器
+ * 将日志存储到数据库，并自动清理旧日志
+ */
+export declare class DatabaseLogTransport implements LogTransport {
+    private plugin;
+    private stripAnsiRegex;
+    private cleanupTimer?;
+    private maxDays;
+    private maxRecords;
+    private cleanupInterval;
+    constructor(plugin: Plugin);
+    /**
+     * 启动定时清理任务
+     */
+    private startCleanup;
+    /**
+     * 清理旧日志
+     */
+    private cleanupOldLogs;
+    /**
+     * 停止清理任务
+     */
+    stopCleanup(): void;
+    /**
+     * 移除 ANSI 颜色代码
+     */
+    private stripAnsi;
+    write(message: string): void;
+    /**
+     * 保存日志到数据库
+     */
+    private saveToDatabase;
+}
+//# sourceMappingURL=log-transport.d.ts.map

package/lib/log-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-transport.d.ts","sourceRoot":"","sources":["../src/log-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,eAAe,CAAQ;gBAEnB,MAAM,EAAE,MAAM;IAiB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;YACW,cAAc;IAgD5B;;OAEG;IACI,WAAW,IAAI,IAAI;IAO1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqB5B;;OAEG;YACW,cAAc;CAuB7B"}

package/lib/log-transport.js

@@ -0,0 +1,140 @@
+/**
+ * 数据库日志传输器
+ * 将日志存储到数据库，并自动清理旧日志
+ */
+export class DatabaseLogTransport {
+    plugin;
+    stripAnsiRegex = /\x1b\[[0-9;]*m/g;
+    cleanupTimer;
+    maxDays;
+    maxRecords;
+    cleanupInterval;
+    constructor(plugin) {
+        this.plugin = plugin;
+        const configService = plugin.inject('config');
+        const appConfig = configService.get('zhin.config.yml');
+        // 从配置读取日志清理策略
+        const logConfig = appConfig.log || {};
+        this.maxDays = logConfig.maxDays || 7; // 默认保留 7 天
+        this.maxRecords = logConfig.maxRecords || 10000; // 默认最多 10000 条
+        this.cleanupInterval = logConfig.cleanupInterval || 24; // 默认 24 小时清理一次
+        // 启动定时清理
+        this.startCleanup();
+        // 插件销毁时停止清理任务
+        plugin.onDispose(() => this.stopCleanup());
+    }
+    /**
+     * 启动定时清理任务
+     */
+    startCleanup() {
+        // 立即执行一次清理
+        this.cleanupOldLogs().catch(err => {
+            this.plugin.logger.error('[DatabaseLogTransport] Initial cleanup failed:', err.message);
+        });
+        // 设置定时任务
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupOldLogs().catch(err => {
+                this.plugin.logger.error('[DatabaseLogTransport] Scheduled cleanup failed:', err.message);
+            });
+        }, this.cleanupInterval * 60 * 60 * 1000); // 转换为毫秒
+    }
+    /**
+     * 清理旧日志
+     */
+    async cleanupOldLogs() {
+        const db = this.plugin.inject('database');
+        if (!db) {
+            return;
+        }
+        try {
+            const LogModel = db.models.get('SystemLog');
+            if (!LogModel) {
+                return;
+            }
+            // 1. 按时间清理：删除超过 maxDays 天的日志
+            const cutoffDate = new Date();
+            cutoffDate.setDate(cutoffDate.getDate() - this.maxDays);
+            const deletedData = await LogModel
+                .delete({ timestamp: { $lt: cutoffDate } });
+            const deletedCount = typeof deletedData === 'number' ? deletedData : deletedData.length;
+            // 2. 按数量清理：如果日志总数超过 maxRecords，删除最旧的
+            const total = await LogModel.select();
+            const totalCount = total.length;
+            if (totalCount > this.maxRecords) {
+                const excessCount = totalCount - this.maxRecords;
+                // 查找最旧的 excessCount 条日志的 ID
+                const oldestLogs = await LogModel.select('id', 'timestamp').orderBy('timestamp', 'ASC').limit(excessCount);
+                const idsToDelete = oldestLogs.map((log) => log.id);
+                if (idsToDelete.length > 0) {
+                    await LogModel
+                        .delete({ id: { $in: idsToDelete } });
+                }
+            }
+            this.plugin.logger.info(`[DatabaseLogTransport] Log cleanup completed. ` +
+                `Deleted ${deletedData || 0} logs older than ${this.maxDays} days. ` +
+                `Current total: ${Math.max(0, totalCount - (deletedCount || 0))} logs.`);
+        }
+        catch (error) {
+            // 静默处理错误
+            this.plugin.logger.debug('[DatabaseLogTransport] Cleanup error:', error.message, error.stack);
+        }
+    }
+    /**
+     * 停止清理任务
+     */
+    stopCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /**
+     * 移除 ANSI 颜色代码
+     */
+    stripAnsi(str) {
+        return str.replace(this.stripAnsiRegex, '');
+    }
+    write(message) {
+        // 移除 ANSI 颜色代码
+        const cleanMessage = this.stripAnsi(message);
+        // 解析日志消息
+        // 格式: [09-08 04:07:55.852] [INFO] [MyApp]: message
+        const logRegex = /\[[\d-]+ [\d:.]+\] \[(\w+)\] \[([^\]]+)\]: ([\s\S]+)/;
+        const match = cleanMessage.match(logRegex);
+        if (match) {
+            const [, level, name, msg] = match;
+            const source = name.split(':')[0]; // 取第一部分作为 source
+            // 异步存储到数据库，不阻塞日志输出
+            this.saveToDatabase(level.toLowerCase(), name, msg.trim(), source).catch(err => {
+                // 避免日志存储失败导致应用崩溃
+                console.error('[DatabaseLogTransport] Failed to save log:', err.message);
+            });
+        }
+    }
+    /**
+     * 保存日志到数据库
+     */
+    async saveToDatabase(level, name, message, source) {
+        const databaseService = this.plugin.inject('database');
+        if (!databaseService) {
+            return; // 没有数据库则跳过
+        }
+        try {
+            const LogModel = databaseService.models.get('SystemLog');
+            if (!LogModel) {
+                return; // 模型不存在则跳过
+            }
+            await LogModel.insert({
+                level,
+                name,
+                message,
+                source,
+                timestamp: new Date()
+            });
+        }
+        catch (error) {
+            // 静默处理错误，避免干扰主流程
+        }
+    }
+}
+//# sourceMappingURL=log-transport.js.map

package/lib/log-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-transport.js","sourceRoot":"","sources":["../src/log-transport.ts"],"names":[],"mappings":"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"}

package/lib/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/lib/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":""}

package/lib/setup.js

@@ -0,0 +1,116 @@
+import { setLevel, LogLevel } from '@zhin.js/logger';
+import { usePlugin, resolveEntry, ConfigService, PermissionService, createCommandService, createComponentService, createCronService, defineDatabaseService, ProcessAdapter, } from '@zhin.js/core';
+import { DatabaseLogTransport } from './log-transport.js';
+import * as path from 'path';
+const plugin = usePlugin();
+const { provide, start, stop, logger, children, import: importPlugin } = plugin;
+// 1. 先加载配置，用户在 zhin.config 中决定启用哪些服务
+const configService = new ConfigService();
+await configService.load('zhin.config.yml', {
+    log_level: LogLevel.INFO,
+    database: {
+        dialect: "sqlite",
+        filename: "./data/test.db"
+    },
+    plugin_dirs: [path.relative(process.cwd(), import.meta.dirname), 'node_modules/@zhin.js', './plugins',],
+    plugins: [],
+    services: ['process', 'config', 'command', 'component', 'permission', 'cron'],
+});
+const appConfig = configService.get('zhin.config.yml');
+const enabledServices = new Set(appConfig.services || ['process', 'config', 'command', 'component', 'permission', 'cron']);
+// 注册配置服务（必须）
+provide({
+    name: 'config',
+    description: '配置服务',
+    value: configService,
+});
+// 2. 可选服务按配置注册
+if (enabledServices.has('process')) {
+    provide({
+        name: 'process',
+        description: '命令行适配器',
+        mounted: async (plugin) => {
+            const adapter = new ProcessAdapter(plugin);
+            await adapter.start();
+            return adapter;
+        },
+        dispose: async (adapter) => {
+            await adapter.stop();
+        }
+    });
+}
+if (enabledServices.has('command')) {
+    provide(createCommandService());
+}
+if (enabledServices.has('component')) {
+    provide(createComponentService());
+}
+if (enabledServices.has('permission')) {
+    provide({
+        name: 'permission',
+        description: '权限管理',
+        value: new PermissionService(),
+    });
+}
+if (enabledServices.has('cron')) {
+    provide(createCronService());
+}
+// 3. 配置生效：日志、数据库、插件加载
+setLevel(appConfig.log_level || LogLevel.INFO);
+if (appConfig.database) {
+    provide(defineDatabaseService(appConfig.database));
+    const logTransport = new DatabaseLogTransport(plugin);
+    // 直接访问 logger 实例的 transports 数组，或使用非递归方式
+    // 检查是否已存在 DatabaseLogTransport（避免重复添加）
+    if (!logger['transports'].some((t) => t instanceof DatabaseLogTransport)) {
+        logger['transports'].push(logTransport);
+    }
+}
+// 4. 启动核心上下文（确保扩展方法可用，比如 addCommand）
+await start();
+// 5. 加载插件（父插件已启动，会自动 start 子插件）
+// 先去重插件列表，避免重复加载
+const pluginNames = new Set(appConfig.plugins || []);
+logger.debug(`Plugin list: ${Array.from(pluginNames).join(', ')}`);
+for (const pluginName of pluginNames) {
+    const dir = appConfig.plugin_dirs?.find((dir) => resolveEntry(path.join(dir, pluginName)));
+    if (dir) {
+        const pluginPath = path.join(process.cwd(), dir, pluginName);
+        logger.debug(`Importing plugin: ${pluginName} from ${pluginPath}`);
+        await importPlugin(pluginPath);
+    }
+}
+logger.debug(`${children.length} plugins loaded`);
+// 6. 优雅关闭（使用 once 防止重复注册）
+const handleSIGTERM = () => {
+    logger.info('Received SIGTERM, shutting down gracefully...');
+    stop();
+    process.exit(0);
+};
+const handleSIGINT = () => {
+    logger.info('Received SIGINT, shutting down gracefully...');
+    stop();
+    process.exit(0);
+};
+// 7. 异常处理
+const handleUncaughtException = (error) => {
+    logger.error('Uncaught exception:', error);
+    stop();
+    process.exit(1);
+};
+const handleUnhandledRejection = (reason) => {
+    logger.error('Unhandled rejection:', reason);
+    stop();
+    process.exit(1);
+};
+// 移除可能存在的旧监听器（防止热重载时累积）
+process.removeListener('SIGTERM', handleSIGTERM);
+process.removeListener('SIGINT', handleSIGINT);
+process.removeListener('uncaughtException', handleUncaughtException);
+process.removeListener('unhandledRejection', handleUnhandledRejection);
+// 注册新监听器
+process.once('SIGTERM', handleSIGTERM);
+process.once('SIGINT', handleSIGINT);
+process.on('uncaughtException', handleUncaughtException);
+process.on('unhandledRejection', handleUnhandledRejection);
+//# sourceMappingURL=setup.js.map

package/lib/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,SAAS,EAAE,YAAY,EACvB,aAAa,EAAE,iBAAiB,EAChC,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAC/D,qBAAqB,EACrB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EACJ,OAAO,EACP,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;AAElC,qCAAqC;AACrC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAC1C,MAAM,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE;IAC1C,SAAS,EAAE,QAAQ,CAAC,IAAI;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,gBAAgB;KAC3B;IACD,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,EAAE,WAAW,EAAE;IACvG,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC;CAC9E,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAY,iBAAiB,CAAC,CAAC;AAClE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3H,aAAa;AACb,OAAO,CAAC;IACN,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,aAAa;CACrB,CAAC,CAAC;AAEH,eAAe;AACf,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;IACnC,OAAO,CAAC;QACN,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;IACnC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;IACtC,OAAO,CAAC;QACN,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,MAAM;QACnB,KAAK,EAAE,IAAI,iBAAiB,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IAChC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,sBAAsB;AACtB,QAAQ,CAAC,SAAS,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE/C,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;IACvB,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtD,yCAAyC;IACzC,uCAAuC;IACvC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,YAAY,oBAAoB,CAAC,EAAE,CAAC;QAC9E,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,KAAK,EAAE,CAAC;AAEd,gCAAgC;AAChC,iBAAiB;AACjB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AACrD,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,SAAS,UAAU,EAAE,CAAC,CAAC;QACnE,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AACD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,iBAAiB,CAAC,CAAC;AAElD,0BAA0B;AAC1B,MAAM,aAAa,GAAG,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC7D,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,UAAU;AACV,MAAM,uBAAuB,GAAG,CAAC,KAAY,EAAE,EAAE;IAC/C,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,MAAe,EAAE,EAAE;IACnD,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,wBAAwB;AACxB,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACjD,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC/C,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;AACrE,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;AAEvE,SAAS;AACT,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACrC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;AACzD,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,33 @@
+import { Bot, DatabaseConfig, Databases } from "@zhin.js/core";
+import { LogLevel } from "@zhin.js/logger";
+/**
+ * App配置类型，涵盖机器人、数据库、插件、调试等
+ */
+export interface AppConfig<T extends keyof Databases = keyof Databases> {
+    bots?: Bot.Config[];
+    log_level: LogLevel;
+    /** 数据库配置列表 */
+    database?: DatabaseConfig<T>;
+    /** 插件目录列表，默认为 ['./plugins', 'node_modules'] */
+    plugin_dirs?: string[];
+    /** 需要加载的插件列表 */
+    plugins?: string[];
+    /** 启用的内置服务列表，例如 ['process','config','command','component','permission','cron'] */
+    services?: ('process' | 'config' | 'command' | 'component' | 'permission' | 'cron')[];
+    /** 禁用的依赖列表 */
+    disable_dependencies?: string[];
+    /** 是否启用调试模式 */
+    debug?: boolean;
+    /** 日志配置 */
+    log?: {
+        /** 最大日志保留天数，默认 7 天 */
+        maxDays?: number;
+        /** 最大日志条数，默认 10000 条 */
+        maxRecords?: number;
+        /** 自动清理间隔（小时），默认 24 小时 */
+        cleanupInterval?: number;
+    };
+    /** 插件配置（键为插件名，值为配置对象） */
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS;IACpE,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,cAAc;IACd,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC;IACtF,cAAc;IACd,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,GAAG,CAAC,EAAE;QACJ,sBAAsB;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,wBAAwB;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,0BAA0B;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,yBAAyB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zhin.js",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "开箱即用的机器人框架 - 包含进程适配器、HTTP服务、Web控制台和SQLite数据库",
   "type": "module",
   "main": "./lib/index.js",
@@ -8,27 +8,45 @@
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
       "import": "./lib/index.js"
     },
     "./jsx": {
       "types": "./lib/jsx.d.ts",
+      "development": "./src/jsx.ts",
       "import": "./lib/jsx.js"
     },
     "./jsx-runtime": {
       "types": "./lib/jsx-runtime.d.ts",
+      "development": "./src/jsx-runtime.ts",
       "import": "./lib/jsx-runtime.js"
     },
+    "./setup": {
+      "types": "./lib/setup.d.ts",
+      "development": "./src/setup.ts",
+      "import": "./lib/setup.js"
+    },
     "./jsx-dev-runtime": {
       "types": "./lib/jsx-dev-runtime.d.ts",
+      "development": "./src/jsx-dev-runtime.ts",
       "import": "./lib/jsx-dev-runtime.js"
     }
   },
   "dependencies": {
-    "@zhin.js/core": "1.0.16",
-    "@zhin.js/logger": "0.1.1"
+    "yaml": "^2.3.4",
+    "dotenv": "^16.3.1",
+    "@zhin.js/core": "1.0.18",
+    "@zhin.js/schema": "1.0.2",
+    "@zhin.js/logger": "0.1.2"
   },
   "devDependencies": {
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "@types/node": "^24.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "packages/zhin"
   },
   "scripts": {
     "build": "tsc",

package/src/index.ts

@@ -4,26 +4,31 @@
 
 // 导出核心框架
 export * from '@zhin.js/core'
-import logger from '@zhin.js/logger'
-import { AppConfig, App, Config } from '@zhin.js/core'
-import path from 'path'
-import fs from 'fs'
-
 // 重新导出 logger（作为独立的工具）
 export { default as logger } from '@zhin.js/logger'
 
-export async function createApp(config?:Partial<AppConfig>): Promise<App>
-export async function createApp(config_file?:string): Promise<App>
-export async function createApp(config_param?:string|Partial<AppConfig>): Promise<App>  {
-    const envFiles=['.env',`.env.${process.env.NODE_ENV}`].filter(f=>fs.existsSync(path.join(process.cwd(),f)))
-    if(config_param===undefined){
-        config_param=Config.supportedExtensions.map(ext=>`zhin.config${ext}`).find(f=>fs.existsSync(path.join(process.cwd(),f)))
+// ================================================================================================
+// 模块声明 - 允许插件通过 declare module "zhin.js" 扩展类型
+// ================================================================================================
+// 重新声明可扩展接口，使得 declare module "zhin.js" 可以正确合并类型
+// 这些接口会与 @zhin.js/core 中的原始定义合并
+declare module "zhin.js" {
+  // 重新导出 Plugin 命名空间中的可扩展接口
+  namespace Plugin {
+    // 可扩展的 Context 注册表
+    interface Contexts {}
+    // 扩展方法
+    interface Extensions {
+      /**
+       * 定义数据库模型
+       * @param name 模型名称
+       * @param definition 模型定义
+       */
+      defineModel<K extends keyof Models>(name: K, definition: import('@zhin.js/core').Definition<Models[K]>): void;
     }
-    if(config_param===undefined) throw new Error('No configuration file found and no configuration provided.')
-    const app= new App(config_param as string);
-    app.watching(envFiles,()=>{
-        console.log('Environment file changed, exiting to reload...')
-        process.exit(51)
-    })
-    return app
-}
+  }
+  // 可扩展的适配器注册表
+  interface RegisteredAdapters {}
+  // 可扩展的数据模型注册表
+  interface Models {}
+}

package/src/log-transport.ts

@@ -0,0 +1,167 @@
+import { LogTransport } from '@zhin.js/logger'
+import { Plugin } from '@zhin.js/core'
+import { AppConfig } from './types.js'
+
+/**
+ * 数据库日志传输器
+ * 将日志存储到数据库，并自动清理旧日志
+ */
+export class DatabaseLogTransport implements LogTransport {
+  private plugin: Plugin
+  private stripAnsiRegex = /\x1b\[[0-9;]*m/g
+  private cleanupTimer?: NodeJS.Timeout
+  private maxDays: number
+  private maxRecords: number
+  private cleanupInterval: number
+
+  constructor(plugin: Plugin) {
+    this.plugin = plugin
+    const configService = plugin.inject('config')!
+    const appConfig = configService.get<AppConfig>('zhin.config.yml')
+    // 从配置读取日志清理策略
+    const logConfig = appConfig.log || {}
+    this.maxDays = logConfig.maxDays || 7 // 默认保留 7 天
+    this.maxRecords = logConfig.maxRecords || 10000 // 默认最多 10000 条
+    this.cleanupInterval = logConfig.cleanupInterval || 24 // 默认 24 小时清理一次
+    
+    // 启动定时清理
+    this.startCleanup()
+    
+    // 插件销毁时停止清理任务
+    plugin.onDispose(() => this.stopCleanup())
+  }
+
+  /**
+   * 启动定时清理任务
+   */
+  private startCleanup(): void {
+    // 立即执行一次清理
+    this.cleanupOldLogs().catch(err => {
+      this.plugin.logger.error('[DatabaseLogTransport] Initial cleanup failed:', err.message)
+    })
+
+    // 设置定时任务
+    this.cleanupTimer = setInterval(() => {
+      this.cleanupOldLogs().catch(err => {
+        this.plugin.logger.error('[DatabaseLogTransport] Scheduled cleanup failed:', err.message)
+      })
+    }, this.cleanupInterval * 60 * 60 * 1000) // 转换为毫秒
+  }
+
+  /**
+   * 清理旧日志
+   */
+  private async cleanupOldLogs(): Promise<void> {
+    const db=this.plugin.inject('database')
+    if (!db) {
+      return
+    }
+
+    try {
+      const LogModel = db.models.get('SystemLog')
+      if (!LogModel) {
+        return
+      }
+
+      // 1. 按时间清理：删除超过 maxDays 天的日志
+      const cutoffDate = new Date()
+      cutoffDate.setDate(cutoffDate.getDate() - this.maxDays)
+      
+      const deletedData = await LogModel
+        .delete({ timestamp: { $lt: cutoffDate } })
+      const deletedCount = typeof deletedData === 'number' ? deletedData : deletedData.length
+      // 2. 按数量清理：如果日志总数超过 maxRecords，删除最旧的
+      const total = await LogModel.select()
+      const totalCount = total.length
+
+      if (totalCount > this.maxRecords) {
+        const excessCount = totalCount - this.maxRecords
+        
+        // 查找最旧的 excessCount 条日志的 ID
+        const oldestLogs: any[] = await LogModel.select('id','timestamp').orderBy('timestamp', 'ASC').limit(excessCount)
+        
+        const idsToDelete = oldestLogs.map((log: any) => log.id)
+        
+        if (idsToDelete.length > 0) {
+          await LogModel
+            .delete({ id: { $in: idsToDelete } })
+        }
+      }
+
+      this.plugin.logger.info(
+        `[DatabaseLogTransport] Log cleanup completed. ` +
+        `Deleted ${deletedData || 0} logs older than ${this.maxDays} days. ` +
+        `Current total: ${Math.max(0, totalCount - (deletedCount || 0))} logs.`
+      )
+    } catch (error) {
+      // 静默处理错误
+      this.plugin.logger.debug('[DatabaseLogTransport] Cleanup error:', (error as Error).message,(error as Error).stack)
+    }
+  }
+
+  /**
+   * 停止清理任务
+   */
+  public stopCleanup(): void {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer)
+      this.cleanupTimer = undefined
+    }
+  }
+
+  /**
+   * 移除 ANSI 颜色代码
+   */
+  private stripAnsi(str: string): string {
+    return str.replace(this.stripAnsiRegex, '')
+  }
+
+  write(message: string): void {
+    // 移除 ANSI 颜色代码
+    const cleanMessage = this.stripAnsi(message)
+    
+    // 解析日志消息
+    // 格式: [09-08 04:07:55.852] [INFO] [MyApp]: message
+    const logRegex = /\[[\d-]+ [\d:.]+\] \[(\w+)\] \[([^\]]+)\]: ([\s\S]+)/
+    const match = cleanMessage.match(logRegex)
+    
+    if (match) {
+      const [, level, name, msg] = match
+      const source = name.split(':')[0] // 取第一部分作为 source
+      
+      // 异步存储到数据库，不阻塞日志输出
+      this.saveToDatabase(level.toLowerCase(), name, msg.trim(), source).catch(err => {
+        // 避免日志存储失败导致应用崩溃
+        console.error('[DatabaseLogTransport] Failed to save log:', err.message)
+      })
+    }
+  }
+
+  /**
+   * 保存日志到数据库
+   */
+  private async saveToDatabase(level: string, name: string, message: string, source: string): Promise<void> {
+    const databaseService=this.plugin.inject('database')
+    if (!databaseService) {
+      return // 没有数据库则跳过
+    }
+
+    try {
+      const LogModel = databaseService.models.get('SystemLog')
+      if (!LogModel) {
+        return // 模型不存在则跳过
+      }
+
+      await LogModel.insert({
+        level,
+        name,
+        message,
+        source,
+        timestamp: new Date()
+      })
+    } catch (error) {
+      // 静默处理错误，避免干扰主流程
+    }
+  }
+}
+

package/src/setup.ts

@@ -0,0 +1,145 @@
+
+import { setLevel, LogLevel } from '@zhin.js/logger';
+import {
+  usePlugin, resolveEntry,
+  ConfigService, PermissionService,
+  createCommandService, createComponentService, createCronService,
+  defineDatabaseService,
+  ProcessAdapter,
+} from '@zhin.js/core';
+import { AppConfig } from './types.js';
+import { DatabaseLogTransport } from './log-transport.js';
+import * as path from 'path';
+
+const plugin = usePlugin();
+const {
+  provide,
+  start, stop,
+  logger, children,
+  import: importPlugin } = plugin;
+
+// 1. 先加载配置，用户在 zhin.config 中决定启用哪些服务
+const configService = new ConfigService();
+await configService.load('zhin.config.yml', {
+  log_level: LogLevel.INFO,
+  database: {
+    dialect: "sqlite",
+    filename: "./data/test.db"
+  },
+  plugin_dirs: [path.relative(process.cwd(), import.meta.dirname), 'node_modules/@zhin.js', './plugins',],
+  plugins: [],
+  services: ['process', 'config', 'command', 'component', 'permission', 'cron'],
+});
+const appConfig = configService.get<AppConfig>('zhin.config.yml');
+const enabledServices = new Set(appConfig.services || ['process', 'config', 'command', 'component', 'permission', 'cron']);
+
+// 注册配置服务（必须）
+provide({
+  name: 'config',
+  description: '配置服务',
+  value: configService,
+});
+
+// 2. 可选服务按配置注册
+if (enabledServices.has('process')) {
+  provide({
+    name: 'process',
+    description: '命令行适配器',
+    mounted: async (plugin) => {
+      const adapter = new ProcessAdapter(plugin);
+      await adapter.start();
+      return adapter;
+    },
+    dispose: async (adapter) => {
+      await adapter.stop();
+    }
+  });
+}
+
+if (enabledServices.has('command')) {
+  provide(createCommandService());
+}
+
+if (enabledServices.has('component')) {
+  provide(createComponentService());
+}
+
+if (enabledServices.has('permission')) {
+  provide({
+    name: 'permission',
+    description: '权限管理',
+    value: new PermissionService(),
+  });
+}
+
+if (enabledServices.has('cron')) {
+  provide(createCronService());
+}
+
+// 3. 配置生效：日志、数据库、插件加载
+setLevel(appConfig.log_level || LogLevel.INFO);
+
+if (appConfig.database) {
+  provide(defineDatabaseService(appConfig.database));
+  const logTransport = new DatabaseLogTransport(plugin);
+  // 直接访问 logger 实例的 transports 数组，或使用非递归方式
+  // 检查是否已存在 DatabaseLogTransport（避免重复添加）
+  if (!logger['transports'].some((t: any) => t instanceof DatabaseLogTransport)) {
+    logger['transports'].push(logTransport);
+  }
+}
+
+// 4. 启动核心上下文（确保扩展方法可用，比如 addCommand）
+await start();
+
+// 5. 加载插件（父插件已启动，会自动 start 子插件）
+// 先去重插件列表，避免重复加载
+const pluginNames = new Set(appConfig.plugins || []);
+logger.debug(`Plugin list: ${Array.from(pluginNames).join(', ')}`);
+for (const pluginName of pluginNames) {
+  const dir = appConfig.plugin_dirs?.find((dir: string) => resolveEntry(path.join(dir, pluginName)));
+  if (dir) {
+    const pluginPath = path.join(process.cwd(), dir, pluginName);
+    logger.debug(`Importing plugin: ${pluginName} from ${pluginPath}`);
+    await importPlugin(pluginPath);
+  }
+}
+logger.debug(`${children.length} plugins loaded`);
+
+// 6. 优雅关闭（使用 once 防止重复注册）
+const handleSIGTERM = () => {
+  logger.info('Received SIGTERM, shutting down gracefully...');
+  stop();
+  process.exit(0);
+};
+
+const handleSIGINT = () => {
+  logger.info('Received SIGINT, shutting down gracefully...');
+  stop();
+  process.exit(0);
+};
+
+// 7. 异常处理
+const handleUncaughtException = (error: Error) => {
+  logger.error('Uncaught exception:', error);
+  stop();
+  process.exit(1);
+};
+
+const handleUnhandledRejection = (reason: unknown) => {
+  logger.error('Unhandled rejection:', reason);
+  stop();
+  process.exit(1);
+};
+
+// 移除可能存在的旧监听器（防止热重载时累积）
+process.removeListener('SIGTERM', handleSIGTERM);
+process.removeListener('SIGINT', handleSIGINT);
+process.removeListener('uncaughtException', handleUncaughtException);
+process.removeListener('unhandledRejection', handleUnhandledRejection);
+
+// 注册新监听器
+process.once('SIGTERM', handleSIGTERM);
+process.once('SIGINT', handleSIGINT);
+process.on('uncaughtException', handleUncaughtException);
+process.on('unhandledRejection', handleUnhandledRejection);

package/src/types.ts

@@ -0,0 +1,34 @@
+import { Bot, DatabaseConfig, Databases } from "@zhin.js/core";
+import { LogLevel } from "@zhin.js/logger";
+
+/**
+ * App配置类型，涵盖机器人、数据库、插件、调试等
+ */
+export interface AppConfig<T extends keyof Databases = keyof Databases> {
+  bots?: Bot.Config[];
+  log_level: LogLevel;
+  /** 数据库配置列表 */
+  database?: DatabaseConfig<T>;
+  /** 插件目录列表，默认为 ['./plugins', 'node_modules'] */
+  plugin_dirs?: string[];
+  /** 需要加载的插件列表 */
+  plugins?: string[];
+  /** 启用的内置服务列表，例如 ['process','config','command','component','permission','cron'] */
+  services?: ('process' | 'config' | 'command' | 'component' | 'permission' | 'cron')[];
+  /** 禁用的依赖列表 */
+  disable_dependencies?: string[];
+  /** 是否启用调试模式 */
+  debug?: boolean;
+  /** 日志配置 */
+  log?: {
+    /** 最大日志保留天数，默认 7 天 */
+    maxDays?: number;
+    /** 最大日志条数，默认 10000 条 */
+    maxRecords?: number;
+    /** 自动清理间隔（小时），默认 24 小时 */
+    cleanupInterval?: number;
+  };
+  /** 插件配置（键为插件名，值为配置对象） */
+  [key: string]: any;
+}
+