speccore 8.3.46 → 8.3.47

package/dist/core/ui-verify/types.js.map

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

package/dist/core/ui-verify/visual-engine.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Visual Engine — 视觉模型分析引擎
+ *
+ * 对比基准图与当前截图，调用视觉模型分析差异
+ */
+import { VisualResult, SmokeResult } from './types';
+interface VisualOptions {
+    baselineDir: string;
+    screenshotDir: string;
+    diffDir: string;
+    threshold: 'strict' | 'normal' | 'loose';
+    updateBaseline: boolean;
+    visualModel?: string;
+}
+export declare function runVisualCheck(smokeResults: SmokeResult[], options: VisualOptions): Promise<VisualResult[]>;
+/**
+ * 检查视觉模型 API 是否可用
+ */
+export declare function isVisualModelAvailable(): Promise<boolean>;
+export {};
+//# sourceMappingURL=visual-engine.d.ts.map

package/dist/core/ui-verify/visual-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-engine.d.ts","sourceRoot":"","sources":["../../../src/core/ui-verify/visual-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAEjE,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAuEzB;AA6HD;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG/D"}

package/dist/core/ui-verify/visual-engine.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Visual Engine — 视觉模型分析引擎
+ *
+ * 对比基准图与当前截图，调用视觉模型分析差异
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVisualCheck = runVisualCheck;
+exports.isVisualModelAvailable = isVisualModelAvailable;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const logger_1 = require("../../utils/logger");
+async function runVisualCheck(smokeResults, options) {
+    const results = [];
+    await (0, fs_extra_1.ensureDir)(options.baselineDir);
+    await (0, fs_extra_1.ensureDir)(options.diffDir);
+    for (const smoke of smokeResults) {
+        if (!smoke.screenshot) {
+            logger_1.logger.warn(`  ⚠️ ${smoke.scenarioName} 无截图，跳过视觉检查`);
+            continue;
+        }
+        const scenarioSafeName = smoke.scenarioName.replace(/[^a-z0-9]/gi, '_').toLowerCase();
+        const baselinePath = (0, path_1.join)(options.baselineDir, `${scenarioSafeName}.png`);
+        const currentPath = smoke.screenshot;
+        const diffPath = (0, path_1.join)(options.diffDir, `${scenarioSafeName}_diff.png`);
+        logger_1.logger.info(`  🖼️ 视觉检查: ${smoke.scenarioName}`);
+        // 检查是否存在基准图
+        const hasBaseline = await (0, fs_extra_1.pathExists)(baselinePath);
+        if (!hasBaseline) {
+            // 首次运行，保存为基准图
+            await (0, fs_extra_1.copy)(currentPath, baselinePath);
+            results.push({
+                scenarioName: smoke.scenarioName,
+                passed: true,
+                baselinePath,
+                currentPath,
+                analysis: '首次运行，已保存为基准图',
+                issues: [],
+            });
+            logger_1.logger.info(`    ✅ 已保存基准图`);
+            continue;
+        }
+        if (options.updateBaseline) {
+            // 强制更新基准图
+            await (0, fs_extra_1.copy)(currentPath, baselinePath);
+            results.push({
+                scenarioName: smoke.scenarioName,
+                passed: true,
+                baselinePath,
+                currentPath,
+                analysis: '基准图已更新',
+                issues: [],
+            });
+            logger_1.logger.info(`    ✅ 基准图已更新`);
+            continue;
+        }
+        // 调用视觉模型分析差异
+        const visualResult = await analyzeWithVisualModel({
+            baselinePath,
+            currentPath,
+            diffPath,
+            scenarioName: smoke.scenarioName,
+            threshold: options.threshold,
+            model: options.visualModel,
+        });
+        results.push(visualResult);
+        const icon = visualResult.passed ? '✅' : '⚠️';
+        logger_1.logger.info(`    ${icon} ${visualResult.passed ? '通过' : '发现问题'} (${visualResult.issues.length} 项)`);
+    }
+    return results;
+}
+async function analyzeWithVisualModel(options) {
+    try {
+        // 读取图片为 base64
+        const baselineBase64 = await imageToBase64(options.baselinePath);
+        const currentBase64 = await imageToBase64(options.currentPath);
+        // 调用视觉模型 API
+        const response = await callVisualModel({
+            baselineBase64,
+            currentBase64,
+            scenarioName: options.scenarioName,
+            model: options.model,
+        });
+        // 解析响应
+        const { passed, analysis, issues } = parseVisualResponse(response, options.threshold);
+        return {
+            scenarioName: options.scenarioName,
+            passed,
+            baselinePath: options.baselinePath,
+            currentPath: options.currentPath,
+            diffPath: options.diffPath,
+            analysis,
+            issues,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error(`    ❌ 视觉模型调用失败: ${message}`);
+        // 失败时返回警告而非阻断（避免网络问题导致测试失败）
+        return {
+            scenarioName: options.scenarioName,
+            passed: options.threshold !== 'strict',
+            baselinePath: options.baselinePath,
+            currentPath: options.currentPath,
+            analysis: `视觉模型调用失败: ${message}`,
+            issues: [{
+                    severity: 'warning',
+                    description: `视觉模型调用失败: ${message}`,
+                }],
+        };
+    }
+}
+async function imageToBase64(path) {
+    const buffer = await (0, fs_extra_1.readFile)(path);
+    return buffer.toString('base64');
+}
+async function callVisualModel(request) {
+    // TODO: 实现具体的视觉模型调用
+    // 当前为占位实现，后续接入 GPT-4o / Claude 3.5 Sonnet / Qwen-VL
+    const model = request.model || 'gpt-4o';
+    logger_1.logger.info(`    🤖 调用视觉模型: ${model}`);
+    // 这里应该调用实际的 AI API
+    // 示例（OpenAI GPT-4o）:
+    // const response = await openai.chat.completions.create({
+    //   model: 'gpt-4o',
+    //   messages: [
+    //     {
+    //       role: 'system',
+    //       content: '你是一个 UI 视觉测试专家。对比两张截图，分析差异。'
+    //     },
+    //     {
+    //       role: 'user',
+    //       content: [
+    //         { type: 'text', text: `对比 "${request.scenarioName}" 的基准图和当前图，分析是否有视觉差异。` },
+    //         { type: 'image_url', image_url: { url: `data:image/png;base64,${request.baselineBase64}` } },
+    //         { type: 'image_url', image_url: { url: `data:image/png;base64,${request.currentBase64}` } },
+    //       ]
+    //     }
+    //   ]
+    // });
+    // 临时返回模拟结果（后续替换为真实调用）
+    return JSON.stringify({
+        passed: true,
+        analysis: '视觉模型分析完成，未发现明显差异。',
+        issues: [],
+    });
+}
+function parseVisualResponse(response, threshold) {
+    try {
+        const parsed = JSON.parse(response);
+        return {
+            passed: parsed.passed ?? true,
+            analysis: parsed.analysis || '未提供分析',
+            issues: (parsed.issues || []).map((i) => ({
+                severity: i.severity || 'info',
+                description: i.description || '',
+                region: i.region,
+            })),
+        };
+    }
+    catch {
+        // 非 JSON 响应，视为纯文本分析
+        return {
+            passed: threshold !== 'strict',
+            analysis: response,
+            issues: [],
+        };
+    }
+}
+/**
+ * 检查视觉模型 API 是否可用
+ */
+async function isVisualModelAvailable() {
+    // TODO: 检查 API key 是否配置
+    return false; // 当前未实现真实调用
+}
+//# sourceMappingURL=visual-engine.js.map

package/dist/core/ui-verify/visual-engine.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "8.3.46",
+  "version": "8.3.47",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,8 @@
     "fs-extra": "^11.2.0",
     "glob": "^10.3.10",
     "js-yaml": "^4.1.0",
-    "jszip": "^3.10.1"
+    "jszip": "^3.10.1",
+    "playwright": "^1.62.1"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",