speccore 8.3.47 → 8.3.49

package/dist/core/perf-verify/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 性能基线测试 — 统一导出
+ */
+export * from './types';
+export * from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/perf-verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/perf-verify/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/core/perf-verify/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * 性能基线测试 — 统一导出
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./engine"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/perf-verify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/perf-verify/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAAyB"}

package/dist/core/perf-verify/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 性能基线测试 — 类型定义
+ *
+ * PERF_SPEC.yaml 结构：
+ *   name: 前端构建性能基线
+ *   metrics:
+ *     - name: 构建时间
+ *       type: command
+ *       command: npm run build
+ *       workingDir: ./frontend
+ *       threshold:
+ *         max: 60000
+ *     - name: 产物体积
+ *       type: size
+ *       path: ./frontend/dist
+ *       threshold:
+ *         max: 5242880
+ *     - name: 主包体积
+ *       type: size
+ *       path: ./frontend/dist/index.js
+ *       threshold:
+ *         max: 1048576
+ */
+export interface PerfSpec {
+    name: string;
+    metrics: PerfMetric[];
+}
+export type MetricType = 'command' | 'size' | 'bundle';
+export interface PerfMetric {
+    name: string;
+    type: MetricType;
+    command?: string;
+    workingDir?: string;
+    path?: string;
+    entry?: string;
+    threshold: {
+        min?: number;
+        max?: number;
+        regression?: number;
+    };
+}
+export interface PerfMetricResult {
+    name: string;
+    type: MetricType;
+    passed: boolean;
+    value: number;
+    unit: string;
+    baseline?: number;
+    regression?: number;
+    threshold: {
+        min?: number;
+        max?: number;
+        regression?: number;
+    };
+    message?: string;
+}
+export interface PerfVerifyReport {
+    specName: string;
+    timestamp: string;
+    results: PerfMetricResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        duration: number;
+    };
+}
+export interface PerfVerifyOptions {
+    updateBaseline?: boolean;
+    verbose?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/perf-verify/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/perf-verify/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE;QACT,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAID,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/core/perf-verify/types.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * 性能基线测试 — 类型定义
+ *
+ * PERF_SPEC.yaml 结构：
+ *   name: 前端构建性能基线
+ *   metrics:
+ *     - name: 构建时间
+ *       type: command
+ *       command: npm run build
+ *       workingDir: ./frontend
+ *       threshold:
+ *         max: 60000
+ *     - name: 产物体积
+ *       type: size
+ *       path: ./frontend/dist
+ *       threshold:
+ *         max: 5242880
+ *     - name: 主包体积
+ *       type: size
+ *       path: ./frontend/dist/index.js
+ *       threshold:
+ *         max: 1048576
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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

package/dist/core/quality-gate.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Quality Gate — 质量门禁配置管理
+ *
+ * 三层配置合并：项目级（.speccore.yml）→ 任务级（Task/.meta/quality-gate.yaml）→ 命令行（CLI flags）
+ */
+export interface TaskQualityGateConfig {
+    verify_ui?: {
+        enabled?: boolean;
+        smoke_test?: boolean;
+        visual_check?: boolean;
+        threshold?: 'strict' | 'normal' | 'loose';
+        devices?: string[];
+        browsers?: string[];
+        timeout?: number;
+    };
+}
+export interface ResolvedQualityGate {
+    verify_ui: {
+        enabled: boolean;
+        smoke_test: boolean;
+        visual_check: boolean;
+        threshold: 'strict' | 'normal' | 'loose';
+        devices: string[];
+        browsers: string[];
+        timeout: number;
+    };
+}
+export declare function loadTaskQualityGate(taskDir: string): Promise<TaskQualityGateConfig | null>;
+export interface QualityGateMergeInput {
+    /** 项目级配置（来自 .speccore.yml quality_gates.verify_ui） */
+    projectLevel?: Partial<ResolvedQualityGate['verify_ui']>;
+    /** 任务级配置（来自 Task/.meta/quality-gate.yaml） */
+    taskLevel?: TaskQualityGateConfig['verify_ui'];
+    /** 命令行覆盖 */
+    cliOverrides?: {
+        enabled?: boolean;
+        smokeOnly?: boolean;
+        visualOnly?: boolean;
+        device?: string;
+        browser?: string;
+        timeout?: number;
+    };
+}
+export declare function mergeQualityGate(input: QualityGateMergeInput): ResolvedQualityGate;
+export declare function shouldRunUIVerify(resolved: ResolvedQualityGate): boolean;
+//# sourceMappingURL=quality-gate.d.ts.map

package/dist/core/quality-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../src/core/quality-gate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAmBhG;AAMD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,6CAA6C;IAC7C,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,YAAY;IACZ,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,mBAAmB,CAsClF;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAExE"}

package/dist/core/quality-gate.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Quality Gate — 质量门禁配置管理
+ *
+ * 三层配置合并：项目级（.speccore.yml）→ 任务级（Task/.meta/quality-gate.yaml）→ 命令行（CLI flags）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTaskQualityGate = loadTaskQualityGate;
+exports.mergeQualityGate = mergeQualityGate;
+exports.shouldRunUIVerify = shouldRunUIVerify;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const yaml_parser_1 = require("./yaml-parser");
+const logger_1 = require("../utils/logger");
+// ─────────────────────────────────────────
+// 任务级配置读取
+// ─────────────────────────────────────────
+async function loadTaskQualityGate(taskDir) {
+    const paths = [
+        (0, path_1.join)(taskDir, '.meta', 'quality-gate.yaml'),
+        (0, path_1.join)(taskDir, '.meta', 'quality-gate.yml'),
+        (0, path_1.join)(taskDir, 'quality-gate.yaml'),
+        (0, path_1.join)(taskDir, 'quality-gate.yml'),
+    ];
+    for (const p of paths) {
+        if (await (0, fs_extra_1.pathExists)(p)) {
+            const result = await (0, yaml_parser_1.parseYamlFile)(p);
+            if (result.success && result.data) {
+                logger_1.logger.info(`  📄 加载任务级质量门禁: ${p}`);
+                return result.data;
+            }
+        }
+    }
+    return null;
+}
+function mergeQualityGate(input) {
+    // 默认值
+    const defaults = {
+        enabled: false,
+        smoke_test: true,
+        visual_check: true,
+        threshold: 'normal',
+        devices: ['desktop'],
+        browsers: ['chromium'],
+        timeout: 30000,
+    };
+    // 1. 项目级覆盖
+    const projectMerged = { ...defaults, ...input.projectLevel };
+    // 2. 任务级覆盖
+    const taskMerged = input.taskLevel
+        ? {
+            ...projectMerged,
+            ...input.taskLevel,
+            devices: input.taskLevel.devices || projectMerged.devices,
+            browsers: input.taskLevel.browsers || projectMerged.browsers,
+        }
+        : projectMerged;
+    // 3. 命令行覆盖（最高优先级）
+    const cli = input.cliOverrides;
+    const final = {
+        enabled: cli?.enabled ?? taskMerged.enabled,
+        smoke_test: cli?.smokeOnly === true ? true : cli?.visualOnly === true ? false : taskMerged.smoke_test,
+        visual_check: cli?.visualOnly === true ? true : cli?.smokeOnly === true ? false : taskMerged.visual_check,
+        threshold: taskMerged.threshold,
+        devices: cli?.device ? [cli.device] : taskMerged.devices,
+        browsers: cli?.browser ? [cli.browser] : taskMerged.browsers,
+        timeout: cli?.timeout || taskMerged.timeout,
+    };
+    return { verify_ui: final };
+}
+// ─────────────────────────────────────────
+// 快捷函数：判断任务是否需要 UI 验证
+// ─────────────────────────────────────────
+function shouldRunUIVerify(resolved) {
+    return resolved.verify_ui.enabled;
+}
+//# sourceMappingURL=quality-gate.js.map

package/dist/core/quality-gate.js.map

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

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

@@ -1 +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"}
+{"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,CAqFzB;AA+KD;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG/D"}

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

@@ -27,17 +27,26 @@ async function runVisualCheck(smokeResults, options) {
         // 检查是否存在基准图
         const hasBaseline = await (0, fs_extra_1.pathExists)(baselinePath);
         if (!hasBaseline) {
-            // 首次运行，保存为基准图
+            // 首次运行：保存为基准图 + 单图通用质量扫描
             await (0, fs_extra_1.copy)(currentPath, baselinePath);
+            logger_1.logger.info(`    ✅ 已保存基准图`);
+            // 单图通用质量扫描（无基准图时也能发现问题）
+            const scanResult = await analyzeSingleImage({
+                imagePath: currentPath,
+                scenarioName: smoke.scenarioName,
+                threshold: options.threshold,
+                model: options.visualModel,
+            });
             results.push({
                 scenarioName: smoke.scenarioName,
-                passed: true,
+                passed: scanResult.passed,
                 baselinePath,
                 currentPath,
-                analysis: '首次运行，已保存为基准图',
-                issues: [],
+                analysis: `首次运行，已保存基准图。${scanResult.analysis}`,
+                issues: scanResult.issues,
             });
-            logger_1.logger.info(`    ✅ 已保存基准图`);
+            const icon = scanResult.passed ? '✅' : '⚠️';
+            logger_1.logger.info(`    ${icon} 单图质量扫描: ${scanResult.passed ? '通过' : '发现问题'} (${scanResult.issues.length} 项)`);
             continue;
         }
         if (options.updateBaseline) {
@@ -167,6 +176,37 @@ function parseVisualResponse(response, threshold) {
         };
     }
 }
+async function analyzeSingleImage(options) {
+    try {
+        const imageBase64 = await imageToBase64(options.imagePath);
+        const model = options.model || 'gpt-4o';
+        logger_1.logger.info(`    🤖 调用视觉模型(单图扫描): ${model}`);
+        // TODO: 接入真实视觉模型 API
+        // 当前返回模拟结果，后续替换为真实调用
+        // 视觉模型应分析：
+        // - 页面是否白屏/灰屏
+        // - 是否有明显的布局崩坏
+        // - 文字是否重叠或截断
+        // - 图片是否加载失败
+        // - 是否有明显的 UI 异常（弹窗报错、乱码等）
+        return {
+            passed: true,
+            analysis: '单图质量扫描完成，页面渲染正常，未发现明显的白屏、布局崩坏或文字重叠问题。',
+            issues: [],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            passed: options.threshold !== 'strict',
+            analysis: `单图扫描失败: ${message}`,
+            issues: [{
+                    severity: 'warning',
+                    description: `单图扫描失败: ${message}`,
+                }],
+        };
+    }
+}
 /**
  * 检查视觉模型 API 是否可用
  */

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

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

package/dist/core/unified-config.d.ts

@@ -34,6 +34,15 @@ export interface SpecConfig {
         enforce_testing: boolean;
         enforce_review: boolean;
         require_pr: boolean;
+        verify_ui?: {
+            enabled: boolean;
+            smoke_test: boolean;
+            visual_check: boolean;
+            threshold: 'strict' | 'normal' | 'loose';
+            devices: string[];
+            browsers: string[];
+            timeout: number;
+        };
     };
     arbitration: {
         enabled: boolean;

package/dist/core/unified-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-config.d.ts","sourceRoot":"","sources":["../../src/core/unified-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"unified-config.d.ts","sourceRoot":"","sources":["../../src/core/unified-config.ts"],"names":[],"mappings":"AAaA,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gDAAgD;AAChD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAMhD,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE;YACV,OAAO,EAAE,OAAO,CAAC;YACjB,UAAU,EAAE,OAAO,CAAC;YACpB,YAAY,EAAE,OAAO,CAAC;YACtB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;KAC1C,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;SAAE,CAAC;QACjE,KAAK,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,aAAa,EAAE,OAAO,CAAA;SAAE,CAAC;QACpD,OAAO,EAAE;YAAE,YAAY,EAAE,OAAO,CAAA;SAAE,CAAC;QACnC,IAAI,EAAE;YAAE,gBAAgB,EAAE,OAAO,CAAA;SAAE,CAAC;QACpC,UAAU,EAAE;YAAE,WAAW,EAAE,OAAO,CAAA;SAAE,CAAC;QACrC,IAAI,EAAE;YAAE,UAAU,EAAE,OAAO,CAAA;SAAE,CAAC;QAC9B,QAAQ,EAAE;YAAE,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;SAAE,CAAC;QACxD,MAAM,EAAE;YAAE,cAAc,EAAE,OAAO,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,GAAG,EAAE;QACH,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAC;YAC7C,cAAc,EAAE,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC;YACtB,YAAY,EAAE,OAAO,CAAC;YACtB,aAAa,EAAE,OAAO,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,KAAK,EAAE;YAAE,aAAa,EAAE,OAAO,CAAA;SAAE,CAAC;QAClC,aAAa,EAAE,iBAAiB,EAAE,CAAC;KACpC,CAAC;IACF,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzE;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,GAAG,EAAE;QACH,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,eAAO,MAAM,cAAc,EAAE,UAiC5B,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AASF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAMtD;AAED,iCAAiC;AACjC,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAqDpE;AAED,kBAAkB;AAClB,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAMhE;AAED,mBAAmB;AACnB,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAqDlF;AAED,mCAAmC;AACnC,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAErD;AAMD,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5E;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AA0JD,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,oBAAoB;IACpB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACvE,yBAAyB;IACzB,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,SAAK,GAAG,UAAU,CA2EzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAKlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAiC3D;AAMD,wBAAsB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAmG/D;AAMD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAiF7E;AAibD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAuBhE"}

package/dist/core/unified-config.js

@@ -37,7 +37,20 @@ exports.PROJECT_CURRENT_SCHEMA_VERSION = 1;
 // ─────────────────────────────────────────
 exports.DEFAULT_CONFIG = {
     schema_version: exports.CURRENT_SCHEMA_VERSION,
-    quality_gates: { enforce_testing: true, enforce_review: true, require_pr: true },
+    quality_gates: {
+        enforce_testing: true,
+        enforce_review: true,
+        require_pr: true,
+        verify_ui: {
+            enabled: false,
+            smoke_test: true,
+            visual_check: true,
+            threshold: 'normal',
+            devices: ['desktop'],
+            browsers: ['chromium'],
+            timeout: 30000,
+        },
+    },
     arbitration: { enabled: true, mode: 'full' },
     settings: {
         assignee: { enabled: true, mode: 'loose' },
@@ -623,6 +636,27 @@ function validateConfig(obj) {
                 issues.push(`quality_gates.${key} 必须是布尔值`);
             }
         }
+        // verify_ui 校验
+        if (isObject(obj.quality_gates.verify_ui)) {
+            const vui = obj.quality_gates.verify_ui;
+            for (const key of ['enabled', 'smoke_test', 'visual_check']) {
+                if (vui[key] !== undefined && typeof vui[key] !== 'boolean') {
+                    issues.push(`quality_gates.verify_ui.${key} 必须是布尔值`);
+                }
+            }
+            if (vui.threshold && !['strict', 'normal', 'loose'].includes(vui.threshold)) {
+                issues.push('quality_gates.verify_ui.threshold 必须是 strict/normal/loose 之一');
+            }
+            if (vui.devices !== undefined && !Array.isArray(vui.devices)) {
+                issues.push('quality_gates.verify_ui.devices 必须是数组');
+            }
+            if (vui.browsers !== undefined && !Array.isArray(vui.browsers)) {
+                issues.push('quality_gates.verify_ui.browsers 必须是数组');
+            }
+            if (vui.timeout !== undefined && typeof vui.timeout !== 'number') {
+                issues.push('quality_gates.verify_ui.timeout 必须是数字');
+            }
+        }
     }
     // arbitration
     if (isObject(obj.arbitration)) {