@be-link/smart-test 1.0.1-beta.0 → 1.0.1-beta.1

package/dist/cli/index.js

@@ -0,0 +1,618 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { cosmiconfig } from 'cosmiconfig';
+
+/**
+ * 日志级别
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+/**
+ * 日志工具类
+ */
+class Logger {
+    constructor() {
+        this.level = LogLevel.INFO;
+        this.spinner = null;
+    }
+    /**
+     * 设置日志级别
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * 调试日志
+     */
+    debug(message, ...args) {
+        if (this.level <= LogLevel.DEBUG) {
+            console.log(chalk.gray(`[DEBUG] ${message}`), ...args);
+        }
+    }
+    /**
+     * 信息日志
+     */
+    info(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.log(chalk.blue(`ℹ ${message}`), ...args);
+        }
+    }
+    /**
+     * 成功日志
+     */
+    success(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.log(chalk.green(`✓ ${message}`), ...args);
+        }
+    }
+    /**
+     * 警告日志
+     */
+    warn(message, ...args) {
+        if (this.level <= LogLevel.WARN) {
+            console.warn(chalk.yellow(`⚠ ${message}`), ...args);
+        }
+    }
+    /**
+     * 错误日志
+     */
+    error(message, ...args) {
+        if (this.level <= LogLevel.ERROR) {
+            console.error(chalk.red(`✗ ${message}`), ...args);
+        }
+    }
+    /**
+     * 标题（带装饰）
+     */
+    title(message) {
+        console.log();
+        console.log(chalk.cyan.bold(`━━━ ${message} ━━━`));
+        console.log();
+    }
+    /**
+     * 步骤提示
+     */
+    step(current, total, message) {
+        console.log(chalk.blue(`[${current}/${total}] ${message}`));
+    }
+    /**
+     * 提示用户输入
+     */
+    prompt(message) {
+        console.log(chalk.cyan(`👉 ${message}`));
+    }
+    /**
+     * AI 消息
+     */
+    ai(message) {
+        console.log(chalk.magenta(`🤖 ${message}`));
+    }
+    /**
+     * 开始加载动画
+     */
+    startSpinner(message) {
+        this.spinner = ora(message).start();
+        return this.spinner;
+    }
+    /**
+     * 更新加载动画文本
+     */
+    updateSpinner(message) {
+        if (this.spinner) {
+            this.spinner.text = message;
+        }
+    }
+    /**
+     * 停止加载动画（成功）
+     */
+    succeedSpinner(message) {
+        if (this.spinner) {
+            this.spinner.succeed(message);
+            this.spinner = null;
+        }
+    }
+    /**
+     * 停止加载动画（失败）
+     */
+    failSpinner(message) {
+        if (this.spinner) {
+            this.spinner.fail(message);
+            this.spinner = null;
+        }
+    }
+    /**
+     * 停止加载动画
+     */
+    stopSpinner() {
+        if (this.spinner) {
+            this.spinner.stop();
+            this.spinner = null;
+        }
+    }
+    /**
+     * 换行
+     */
+    newLine() {
+        console.log();
+    }
+    /**
+     * 分隔线
+     */
+    divider() {
+        console.log(chalk.gray('─'.repeat(50)));
+    }
+}
+// 导出单例
+const logger = new Logger();
+
+/**
+ * 自定义错误类型
+ */
+class SmartTestError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SmartTestError';
+    }
+}
+/**
+ * 配置错误
+ */
+class ConfigError extends SmartTestError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * 网络错误
+ */
+class NetworkError extends SmartTestError {
+    constructor(message, details) {
+        super(message, 'NETWORK_ERROR', details);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * AI 服务错误
+ */
+class AIServiceError extends SmartTestError {
+    constructor(message, details) {
+        super(message, 'AI_SERVICE_ERROR', details);
+        this.name = 'AIServiceError';
+    }
+}
+/**
+ * 文件系统错误
+ */
+class FileSystemError extends SmartTestError {
+    constructor(message, details) {
+        super(message, 'FILE_SYSTEM_ERROR', details);
+        this.name = 'FileSystemError';
+    }
+}
+/**
+ * 全局错误处理器
+ */
+function handleError(error) {
+    logger.newLine();
+    if (error instanceof SmartTestError) {
+        logger.error(error.message);
+        if (error.details) {
+            logger.debug('错误详情:', error.details);
+        }
+        // 根据不同的错误类型给出建议
+        if (error instanceof ConfigError) {
+            logger.info('提示: 请检查配置文件 .smarttestrc 是否正确');
+        }
+        else if (error instanceof AIServiceError) {
+            logger.info('提示: 请检查 AI API Key 是否配置正确');
+            logger.info('      运行 smart-test init 重新配置');
+        }
+        else if (error instanceof NetworkError) {
+            logger.info('提示: 请检查网络连接是否正常');
+        }
+        else if (error instanceof FileSystemError) {
+            logger.info('提示: 请检查文件路径和权限是否正确');
+        }
+    }
+    else {
+        logger.error(`未知错误: ${error.message}`);
+        logger.debug('错误堆栈:', error.stack);
+    }
+    logger.newLine();
+    process.exit(1);
+}
+/**
+ * 包装异步函数，自动处理错误
+ */
+function withErrorHandling(fn) {
+    return (async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+
+/**
+ * 初始化命令
+ */
+async function initCommand() {
+    logger.title('初始化 Smart Test 配置');
+    // 检查是否已存在配置文件
+    const configPath = path.join(process.cwd(), '.smarttestrc.json');
+    const exists = await fs
+        .access(configPath)
+        .then(() => true)
+        .catch(() => false);
+    if (exists) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: '配置文件已存在，是否覆盖？',
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            logger.info('已取消初始化');
+            return;
+        }
+    }
+    // 交互式收集配置
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'aiApiKey',
+            message: '请输入 AI API Key:',
+            default: process.env.AI_API_KEY || '',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return '请输入有效的 API Key';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'list',
+            name: 'aiModel',
+            message: '选择 AI 模型:',
+            choices: [
+                { name: '通义千问 (qwen3-vl-plus) - 推荐', value: 'qwen3-vl-plus' },
+                { name: 'OpenAI GPT-4 Vision', value: 'gpt-4-vision-preview' },
+            ],
+            default: 'qwen3-vl-plus',
+        },
+        {
+            type: 'input',
+            name: 'testsDir',
+            message: '测试文件目录:',
+            default: './tests/e2e',
+        },
+        {
+            type: 'input',
+            name: 'helpersDir',
+            message: 'Helpers 目录:',
+            default: './tests/helpers',
+        },
+        {
+            type: 'input',
+            name: 'baseURL',
+            message: 'Playwright Base URL:',
+            default: 'http://localhost:8080',
+        },
+        {
+            type: 'list',
+            name: 'naming',
+            message: '文件命名风格:',
+            choices: [
+                { name: 'kebab-case (推荐)', value: 'kebab-case' },
+                { name: 'camelCase', value: 'camelCase' },
+                { name: 'snake_case', value: 'snake_case' },
+            ],
+            default: 'kebab-case',
+        },
+    ]);
+    // 构建配置对象
+    const config = {
+        version: '1.0.0',
+        ai: {
+            model: answers.aiModel,
+            apiKey: answers.aiApiKey,
+            baseURL: answers.aiModel === 'qwen3-vl-plus'
+                ? 'https://dashscope.aliyuncs.com/compatible-mode/v1'
+                : 'https://api.openai.com/v1',
+            timeout: 30000,
+        },
+        output: {
+            testsDir: answers.testsDir,
+            helpersDir: answers.helpersDir,
+            naming: answers.naming,
+        },
+        templates: {
+            mock: 'default',
+            test: 'default',
+        },
+        playwright: {
+            baseURL: answers.baseURL,
+            viewport: {
+                width: 375,
+                height: 667,
+            },
+            browser: 'chromium',
+        },
+    };
+    // 写入配置文件
+    try {
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        logger.success(`配置文件已创建: ${configPath}`);
+        logger.newLine();
+        logger.info('下一步，运行以下命令生成测试:');
+        logger.info('  smart-test generate --page <页面路径>');
+        logger.info('  smart-test record --url <页面URL>');
+    }
+    catch (error) {
+        throw new FileSystemError(`写入配置文件失败: ${error.message}`, error);
+    }
+}
+
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+    version: '1.0.0',
+    ai: {
+        model: 'qwen3-vl-plus',
+        baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        timeout: 30000,
+    },
+    output: {
+        testsDir: './tests/e2e',
+        helpersDir: './tests/helpers',
+        naming: 'kebab-case',
+    },
+    templates: {
+        mock: 'default',
+        test: 'default',
+    },
+    playwright: {
+        baseURL: 'http://localhost:8080',
+        viewport: {
+            width: 375,
+            height: 667,
+        },
+        browser: 'chromium',
+    },
+};
+
+/**
+ * 配置加载器
+ */
+class ConfigLoader {
+    constructor() {
+        this.config = null;
+        this.explorer = cosmiconfig('smarttest');
+    }
+    /**
+     * 加载配置
+     */
+    async load() {
+        if (this.config) {
+            return this.config;
+        }
+        try {
+            const result = await this.explorer.search();
+            if (result && !result.isEmpty) {
+                logger.debug(`配置文件已加载: ${result.filepath}`);
+                this.config = this.mergeConfig(result.config);
+            }
+            else {
+                logger.debug('未找到配置文件，使用默认配置');
+                this.config = { ...DEFAULT_CONFIG };
+            }
+            // 从环境变量读取 API Key
+            if (process.env.AI_API_KEY && !this.config.ai?.apiKey) {
+                this.config.ai = {
+                    ...this.config.ai,
+                    apiKey: process.env.AI_API_KEY,
+                };
+            }
+            return this.config;
+        }
+        catch (error) {
+            throw new ConfigError(`加载配置失败: ${error.message}`, error);
+        }
+    }
+    /**
+     * 合并配置
+     */
+    mergeConfig(userConfig) {
+        return {
+            version: userConfig.version || DEFAULT_CONFIG.version,
+            ai: {
+                ...DEFAULT_CONFIG.ai,
+                ...userConfig.ai,
+            },
+            output: {
+                ...DEFAULT_CONFIG.output,
+                ...userConfig.output,
+            },
+            templates: {
+                ...DEFAULT_CONFIG.templates,
+                ...userConfig.templates,
+            },
+            playwright: {
+                ...DEFAULT_CONFIG.playwright,
+                ...userConfig.playwright,
+            },
+        };
+    }
+    /**
+     * 获取配置
+     */
+    get() {
+        if (!this.config) {
+            throw new ConfigError('配置未加载，请先调用 load()');
+        }
+        return this.config;
+    }
+    /**
+     * 更新配置
+     */
+    update(updates) {
+        if (!this.config) {
+            throw new ConfigError('配置未加载，请先调用 load()');
+        }
+        this.config = this.mergeConfig({ ...this.config, ...updates });
+    }
+    /**
+     * 重置配置
+     */
+    reset() {
+        this.config = null;
+    }
+    /**
+     * 验证配置
+     */
+    validate(config) {
+        // AI 配置验证
+        if (!config.ai?.apiKey) {
+            logger.warn('未配置 AI API Key，某些功能将不可用');
+        }
+        // 输出目录验证
+        if (!config.output?.testsDir || !config.output?.helpersDir) {
+            throw new ConfigError('输出目录配置不完整');
+        }
+        return true;
+    }
+}
+// 导出单例
+const configLoader = new ConfigLoader();
+
+var configLoader$1 = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    configLoader: configLoader
+});
+
+/**
+ * 生成命令
+ */
+async function generateCommand(options) {
+    logger.title('生成测试代码');
+    // 加载配置
+    const config = await configLoader.load();
+    logger.debug('配置已加载:', config);
+    // 确定生成模式
+    let mode = 'hybrid';
+    if (options.url) {
+        mode = 'record';
+    }
+    else if (options.page) {
+        mode = 'analyze';
+    }
+    else if (options.desc) {
+        mode = 'describe';
+    }
+    else if (options.interactive) {
+        mode = 'hybrid';
+    }
+    logger.info(`生成模式: ${mode}`);
+    // TODO: 实现不同的生成模式
+    switch (mode) {
+        case 'record':
+            logger.info('录制模式 - 开发中...');
+            logger.info(`将录制: ${options.url}`);
+            break;
+        case 'analyze':
+            logger.info('代码分析模式 - 开发中...');
+            logger.info(`将分析: ${options.page}`);
+            break;
+        case 'describe':
+            logger.info('描述生成模式 - 开发中...');
+            logger.info(`描述: ${options.desc}`);
+            break;
+        case 'hybrid':
+            logger.info('混合模式 - 开发中...');
+            logger.info('将进入交互式引导...');
+            break;
+    }
+    logger.newLine();
+    logger.warn('此功能正在开发中，敬请期待！');
+    logger.info('当前版本仅支持 smart-test init 命令');
+}
+
+/**
+ * 创建 CLI 程序
+ */
+function createCLI() {
+    const program = new Command();
+    program.name('smart-test').description('AI-powered visual testing for Playwright').version('1.0.0');
+    // 全局选项
+    program.option('-v, --verbose', '详细输出', () => {
+        logger.setLevel(LogLevel.DEBUG);
+    });
+    // ========== init 命令 ==========
+    program
+        .command('init')
+        .description('初始化 Smart Test 配置')
+        .action(withErrorHandling(async () => {
+        await initCommand();
+    }));
+    // ========== generate 命令 ==========
+    program
+        .command('generate')
+        .description('生成测试代码')
+        .option('-p, --page <path>', '页面文件路径（代码分析模式）')
+        .option('-u, --url <url>', '页面 URL（录制模式）')
+        .option('-d, --desc <description>', '页面描述（自然语言模式）')
+        .option('-o, --output <dir>', '输出目录')
+        .option('-i, --interactive', '交互式模式')
+        .option('--dry-run', '预览模式，不写入文件')
+        .action(withErrorHandling(async (options) => {
+        await generateCommand(options);
+    }));
+    // ========== record 命令（generate 的别名）==========
+    program
+        .command('record')
+        .description('录制模式生成测试（generate --url 的别名）')
+        .requiredOption('-u, --url <url>', '页面 URL')
+        .option('-o, --output <dir>', '输出目录')
+        .option('--manual', '手动操作模式')
+        .option('--interactive', '交互式引导')
+        .action(withErrorHandling(async (options) => {
+        await generateCommand({ url: options.url, ...options });
+    }));
+    // ========== config 命令 ==========
+    program
+        .command('config')
+        .description('查看当前配置')
+        .action(withErrorHandling(async () => {
+        const { configLoader } = await Promise.resolve().then(function () { return configLoader$1; });
+        const config = await configLoader.load();
+        logger.title('当前配置');
+        console.log(JSON.stringify(config, null, 2));
+    }));
+    return program;
+}
+/**
+ * 运行 CLI
+ */
+async function run(argv = process.argv) {
+    const program = createCLI();
+    await program.parseAsync(argv);
+}
+
+export { createCLI, run };

package/dist/config/config-loader.d.ts

@@ -0,0 +1,35 @@
+import type { SmartTestConfig } from './config-schema';
+/**
+ * 配置加载器
+ */
+declare class ConfigLoader {
+    private config;
+    private explorer;
+    /**
+     * 加载配置
+     */
+    load(): Promise<SmartTestConfig>;
+    /**
+     * 合并配置
+     */
+    private mergeConfig;
+    /**
+     * 获取配置
+     */
+    get(): SmartTestConfig;
+    /**
+     * 更新配置
+     */
+    update(updates: Partial<SmartTestConfig>): void;
+    /**
+     * 重置配置
+     */
+    reset(): void;
+    /**
+     * 验证配置
+     */
+    validate(config: SmartTestConfig): boolean;
+}
+export declare const configLoader: ConfigLoader;
+export {};
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IA8BtC;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,GAAG,IAAI,eAAe;IAOtB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAO/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO;CAa3C;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}