speccore 8.3.349 → 8.3.366

package/dist/core/ai-verify/visual-judge.d.ts

@@ -0,0 +1,33 @@
+/**
+ * visual-judge — AI 验证视觉判定兜底（v8.3.350+）
+ *
+ * 三级执行通道的末级兜底：宿主 AI 无多模态能力时，只操作页面截图、不判定，
+ * 在 results.json 中写 judged:false + screenshots。本模块用视觉模型（qwen-vl 默认）
+ * 对「截图 + 预期结果原文」做业务断言，回写判定结果。
+ *
+ * 判定原则：业务断言为主——截图是否符合 plan.json 中该场景的预期结果。
+ */
+import type { VisualModelConfig } from '../ui-verify/visual-model-client';
+import type { AiVerifyPlan, AiVerifyResult, AiVerifyResults } from './types';
+/** 待判定场景（judged:false 且有截图） */
+export interface PendingJudgement {
+    result: AiVerifyResult;
+    screenshotPaths: string[];
+}
+/** 找出 results 中待视觉判定的场景（judged 不为 true 且有截图） */
+export declare function findPendingJudgements(results: AiVerifyResults): PendingJudgement[];
+/**
+ * 用视觉模型判定单个待判定场景。
+ * @param result 待判定结果（会被改写）
+ * @param screenshotPaths 截图相对路径（相对 outDir）
+ * @param outDir 剧本输出目录
+ * @param plan 剧本（取场景标题与预期结果）
+ * @param config 视觉模型配置
+ */
+export declare function judgeScenario(result: AiVerifyResult, screenshotPaths: string[], outDir: string, plan: AiVerifyPlan, config: VisualModelConfig): Promise<void>;
+/**
+ * 兜底判定入口：对 results 中所有待判定场景逐个判定并回写。
+ * 返回判定数量；无待判定场景返回 0。
+ */
+export declare function runAiJudge(resultsPath: string, plan: AiVerifyPlan, config?: VisualModelConfig): Promise<number>;
+//# sourceMappingURL=visual-judge.d.ts.map

package/dist/core/ai-verify/visual-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-judge.d.ts","sourceRoot":"","sources":["../../../src/core/ai-verify/visual-judge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,kCAAkC,CAAC;AAG7F,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE7E,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,EAAE,CAIlF;AAiBD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,MAAM,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/core/ai-verify/visual-judge.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * visual-judge — AI 验证视觉判定兜底（v8.3.350+）
+ *
+ * 三级执行通道的末级兜底：宿主 AI 无多模态能力时，只操作页面截图、不判定，
+ * 在 results.json 中写 judged:false + screenshots。本模块用视觉模型（qwen-vl 默认）
+ * 对「截图 + 预期结果原文」做业务断言，回写判定结果。
+ *
+ * 判定原则：业务断言为主——截图是否符合 plan.json 中该场景的预期结果。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPendingJudgements = findPendingJudgements;
+exports.judgeScenario = judgeScenario;
+exports.runAiJudge = runAiJudge;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const visual_model_client_1 = require("../ui-verify/visual-model-client");
+const logger_1 = require("../../utils/logger");
+/** 找出 results 中待视觉判定的场景（judged 不为 true 且有截图） */
+function findPendingJudgements(results) {
+    return results.results
+        .filter((r) => r.judged !== true && Array.isArray(r.screenshots) && r.screenshots.length > 0)
+        .map((r) => ({ result: r, screenshotPaths: r.screenshots || [] }));
+}
+/** 业务断言 prompt：预期结果 + 截图 → passed/analysis */
+function buildJudgementPrompt(scenarioTitle, expected) {
+    const expectLines = expected.length > 0 ? expected.map((e) => `- ${e}`).join('\n') : '（无明确预期，请判断页面是否正常渲染、无明显错误）';
+    return `你是一个 Web 功能验收测试员。请判断「${scenarioTitle}」的页面截图是否符合以下预期结果：
+
+预期结果：
+${expectLines}
+
+请仅依据截图内容判定（无法从截图确认的事项视为不符合预期），并按以下 JSON 格式输出，不要输出其他内容：
+{
+  "passed": true/false,
+  "analysis": "判定理由（中文，200字以内）：截图中的哪些可见内容支持或否定预期"
+}`;
+}
+/**
+ * 用视觉模型判定单个待判定场景。
+ * @param result 待判定结果（会被改写）
+ * @param screenshotPaths 截图相对路径（相对 outDir）
+ * @param outDir 剧本输出目录
+ * @param plan 剧本（取场景标题与预期结果）
+ * @param config 视觉模型配置
+ */
+async function judgeScenario(result, screenshotPaths, outDir, plan, config) {
+    const scenario = plan.scenarios.find((s) => s.id === result.scenarioId);
+    const title = scenario?.title || result.scenarioId;
+    const expected = scenario?.expected || [];
+    // 依次尝试截图，取第一张可读的
+    let currentImageBase64 = null;
+    for (const shot of screenshotPaths) {
+        const abs = (0, path_1.isAbsolute)(shot) ? shot : (0, path_1.join)(outDir, shot);
+        try {
+            currentImageBase64 = (await (0, fs_extra_1.readFile)(abs)).toString('base64');
+            break;
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!currentImageBase64) {
+        result.judged = true;
+        result.executor = 'visual-judge';
+        result.passed = false;
+        result.reason = '视觉判定失败：截图文件缺失或无法读取';
+        return;
+    }
+    let verdict;
+    try {
+        // 业务断言：用自定义 prompt 替代内置 UI 质量扫描（预期结果 + 截图 → passed/analysis）
+        verdict = await (0, visual_model_client_1.callVisualModel)(config, {
+            scenarioName: title,
+            currentImageBase64,
+            threshold: 'normal',
+            customPrompt: buildJudgementPrompt(title, expected),
+        });
+    }
+    catch (error) {
+        result.judged = true;
+        result.executor = 'visual-judge';
+        result.passed = false;
+        result.reason = `视觉模型调用失败: ${error.message || String(error)}`;
+        return;
+    }
+    result.executor = 'visual-judge';
+    result.judged = true;
+    result.passed = verdict.passed;
+    result.reason = verdict.analysis || (verdict.passed ? '截图符合预期' : '截图不符合预期');
+}
+/**
+ * 兜底判定入口：对 results 中所有待判定场景逐个判定并回写。
+ * 返回判定数量；无待判定场景返回 0。
+ */
+async function runAiJudge(resultsPath, plan, config) {
+    const outDir = (0, path_1.dirname)(resultsPath);
+    const results = JSON.parse(await (0, fs_extra_1.readFile)(resultsPath, 'utf-8'));
+    const pending = findPendingJudgements(results);
+    if (pending.length === 0) {
+        logger_1.logger.info('ℹ️ 没有待视觉判定的场景（所有场景均已判定或缺少截图）');
+        return 0;
+    }
+    if (!config) {
+        logger_1.logger.error('❌ 未配置视觉模型（.speccore.yml 的 quality_gates.verify_ui.visual_model 或环境变量 DASHSCOPE_API_KEY）');
+        throw new Error('视觉模型不可用，无法执行 --ai-judge 兜底判定');
+    }
+    if (!(await (0, visual_model_client_1.isVisualModelAvailable)(config))) {
+        logger_1.logger.error('❌ 视觉模型不可用：未配置 API Key（DASHSCOPE_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY）');
+        throw new Error('视觉模型不可用，无法执行 --ai-judge 兜底判定');
+    }
+    logger_1.logger.info(`🤖 视觉判定兜底：${pending.length} 个场景待判定（provider: ${config.provider}）`);
+    for (const item of pending) {
+        const before = item.result.passed;
+        await judgeScenario(item.result, item.screenshotPaths, outDir, plan, config);
+        const mark = item.result.passed ? '✅' : '❌';
+        logger_1.logger.info(`   ${mark} ${item.result.scenarioId}（判定前 passed=${before}）`);
+    }
+    // 判定结果回写 results.json（executor/judged/passed/reason 已被改写）
+    await (0, fs_extra_1.writeFile)(resultsPath, JSON.stringify(results, null, 2), 'utf-8');
+    return pending.length;
+}
+//# sourceMappingURL=visual-judge.js.map

package/dist/core/ai-verify/visual-judge.js.map

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

package/dist/core/analyze-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-engine.d.ts","sourceRoot":"","sources":["../../src/core/analyze-engine.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW;IACX,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACvC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAMD,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA6F9E;AA2+BD,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjE;AAoaD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqDxD;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA8CxD;AAoHD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsJnC;AAiOD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAgM/B"}
+{"version":3,"file":"analyze-engine.d.ts","sourceRoot":"","sources":["../../src/core/analyze-engine.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW;IACX,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACvC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAMD,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA6F9E;AA2+BD,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjE;AAoaD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsDxD;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA8CxD;AAoHD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsJnC;AAiOD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAgM/B"}

package/dist/core/analyze-engine.js

@@ -1419,7 +1419,8 @@ async function analyzeSingleFeature(iterDir, featureName) {
     if (archImpact.modules.length === 0 && archImpact.risks.length === 0) {
         r += `_未检测到明显架构影响_\n\n`;
     }
-    r += `## 3. 需求原文\n\n${content}\n`;
+    // v8.3.366: 需求原文按配额注入（超大 SOURCE.md 截断 + 阅读清单，防 token 顶爆）
+    r += `## 3. 需求原文\n\n${(0, ai_context_generator_1.buildBudgetedReqSection)([`## 来源: ${featureReqPath}\n\n${content}`]).section}\n`;
     // v8.3.122+: 写入 020-specs/{feature}/overview/ 与规范一致
     const overviewDir = (0, path_1.join)(iterDir, '020-specs', featureName, 'overview');
     await (0, fs_extra_1.ensureDir)(overviewDir);