speccore 8.3.340 → 8.3.345

package/dist/core/prompt-builder.js

@@ -44,6 +44,7 @@ exports.outputNeedsInfo = outputNeedsInfo;
 exports.resetAssetAudit = resetAssetAudit;
 exports.getAssetAuditText = getAssetAuditText;
 exports.processMarkdownContent = processMarkdownContent;
+exports.collectIterationMediaAssets = collectIterationMediaAssets;
 /**
  * prompt-builder — 统一的 Spec → AI Prompt 构建引擎
  *
@@ -2122,7 +2123,7 @@ async function buildPrompt(command, options) {
                     listLines.push(`| ${priority} | \`${match.file}\` | ${reasons.join(' / ')} (score:${match.score}) | ${clues.join('；') || '—'} |`);
                 }
                 if (sortedMatches.length > 15) {
-                    listLines.push(`| … | 其余 ${sortedMatches.length - 15} 个关联文件 | 运行 \`speccore code-index --show\` 查看全量索引 | — |`);
+                    listLines.push(`| … | 其余 ${sortedMatches.length - 15} 个关联文件 | 运行 \`speccore reindex\` 查看全量索引 | — |`);
                 }
                 listLines.push('');
                 listLines.push('### 🔍 深读协议（宿主 AI 执行）');
@@ -2189,6 +2190,22 @@ async function buildPrompt(command, options) {
         }
         catch { /* 忽略读取失败 */ }
     }
+    // v8.3.344+: 注入迭代素材资产（原型 HTML + 参考截图/设计稿）。
+    // 补齐盲区：010-requirements/prototypes/ 与 assets/ 下未被文档引用的素材此前完全无通道。
+    if ((command === 'execute' || command === 'analyze') && options.iteration) {
+        try {
+            const mediaIterDir = await (0, context_1.getIterationDir)(options.iteration);
+            if (mediaIterDir) {
+                const mediaVision = await (0, vision_engine_1.loadVisionConfig)(cwd);
+                const mediaSpec = await collectIterationMediaAssets(mediaIterDir, mediaVision);
+                if (mediaSpec) {
+                    extraSpecs.push(mediaSpec);
+                    logger_1.logger?.info?.(`   🖼️ 迭代素材: 原型/截图已注入上下文（${Math.round(mediaSpec.content.length / 1000)}K 字符）`);
+                }
+            }
+        }
+        catch { /* 素材扫描失败不阻断 */ }
+    }
     // 加载全局上下文（智能注入）
     const globalContext = await loadGlobalContext(cwd, command, options.platform);
     // 加载知识图谱 → 生成任务关联链（< 500 tokens）
@@ -2240,8 +2257,11 @@ async function buildPrompt(command, options) {
             };
             const rawPrompt = await buildMultiDocPrompt('analyze', ctx, options.analyzeOptions);
             // v8.3.3xx+: rawPrompt 路由会丢弃常规 extraSpecs，阅读清单（CLI 导航 + 宿主 AI 深读）单独追加
-            const readingList = extraSpecs.find(s => s.name === '📖 相关源码阅读清单');
-            const finalRawPrompt = readingList ? `${rawPrompt}\n\n${readingList.content}` : rawPrompt;
+            // v8.3.344+: 素材资产（原型/截图）同样随路由追加，保证 analyze 阶段也能看到视觉素材
+            const carryOver = extraSpecs.filter(s => s.name === '📖 相关源码阅读清单' || s.name.startsWith('🖼️ 迭代素材资产'));
+            const finalRawPrompt = carryOver.length > 0
+                ? `${rawPrompt}\n\n${carryOver.map(s => s.content).join('\n\n')}`
+                : rawPrompt;
             return {
                 marker: '[SPECCORE_PROMPT]',
                 version: '1.0',
@@ -3004,6 +3024,118 @@ async function processMarkdownContent(content, filePath, seenPaths, visionConfig
     processed = await inlineMarkdownImages(processed, baseDir, seenPaths, visionConfig, options?.maxSvgChars ?? 2000);
     return processed;
 }
+/**
+ * v8.3.344+: 扫描迭代素材资产（原型 HTML + 参考截图/设计稿/提取图片）。
+ * 补齐盲区：此前只有「被已加载文档以 Markdown 链接引用」的资产会进入上下文，
+ * 010-requirements/prototypes/ 与 assets/ 下未被引用的原型/截图完全无通道。
+ * 策略：CLI 渲染 HTML 原型语义结构（ARIA 树 + 截图）与视觉描述关键图片，
+ * 其余列路径清单——宿主 AI 按需打开原文件。限额防撑爆上下文。
+ * 导出供单测直接调用（构造临时迭代目录即可验证注入行为）。
+ */
+async function collectIterationMediaAssets(iterDir, visionConfig) {
+    const reqDir = (0, path_1.join)(iterDir, '010-requirements');
+    const scanRoots = [
+        (0, path_1.join)(reqDir, 'prototypes'),
+        (0, path_1.join)(reqDir, 'assets'),
+    ];
+    const htmlFiles = [];
+    const imageFiles = [];
+    for (const root of scanRoots) {
+        if (!(await (0, fs_extra_1.pathExists)(root)))
+            continue;
+        await walkMediaFiles(root, htmlFiles, imageFiles, 3);
+    }
+    if (htmlFiles.length === 0 && imageFiles.length === 0)
+        return null;
+    const lines = [];
+    lines.push('## 🖼️ 迭代素材资产（原型 HTML + 参考截图/设计稿）');
+    lines.push('');
+    lines.push('> 以下素材来自迭代需求目录（010-requirements/prototypes/ 与 assets/）。');
+    lines.push('> CLI 已渲染 HTML 原型语义结构与截图、描述关键图片；');
+    lines.push('> 宿主 AI 请按需打开原文件/截图查看完整视觉细节（多模态宿主可直接读截图 PNG）。');
+    lines.push('');
+    // 1. HTML 原型：ARIA 语义树 + 截图路径，渲染失败降级纯文本
+    const MAX_HTML = 3;
+    const MAX_ARIA_CHARS = 1200;
+    for (const htmlPath of htmlFiles.slice(0, MAX_HTML)) {
+        const rel = (0, path_1.relative)(iterDir, htmlPath);
+        const proto = await (0, html_prototype_1.renderHtmlPrototype)(htmlPath);
+        lines.push(`### 原型: \`${rel}\``);
+        lines.push('');
+        if (proto?.accessibilityTree) {
+            const tree = proto.accessibilityTree.length > MAX_ARIA_CHARS
+                ? proto.accessibilityTree.slice(0, MAX_ARIA_CHARS) + '\n…(结构截断)'
+                : proto.accessibilityTree;
+            lines.push('```yaml');
+            lines.push(tree);
+            lines.push('```');
+            if (proto.screenshotPath) {
+                lines.push(`> 📷 截图: \`${proto.screenshotPath}\`（多模态宿主可直接查看）`);
+            }
+            recordAssetAudit(rel, '原型已渲染（ARIA 结构 + 截图）');
+        }
+        else {
+            const htmlContent = await (0, fs_extra_1.readFile)(htmlPath, 'utf-8').catch(() => '');
+            lines.push('> ⚠️ Playwright 渲染失败，以下为纯文本降级提取；宿主 AI 请直接打开 HTML 查看。');
+            lines.push('');
+            lines.push((0, rag_engine_1.extractHtmlText)(htmlContent).slice(0, MAX_ARIA_CHARS));
+            recordAssetAudit(rel, '原型纯文本降级（请宿主打开原文件）');
+        }
+        lines.push('');
+    }
+    if (htmlFiles.length > MAX_HTML) {
+        const rest = htmlFiles.slice(MAX_HTML).map(p => `\`${(0, path_1.relative)(iterDir, p)}\``).join(', ');
+        lines.push(`> 其余 ${htmlFiles.length - MAX_HTML} 个原型未注入（宿主 AI 可按需打开）: ${rest}`);
+        lines.push('');
+    }
+    // 2. 参考图片：视觉模型描述前 N 张，其余列路径 + 大小
+    const MAX_IMAGES = 10;
+    const MAX_VISION = 3;
+    lines.push('### 参考图片（截图/设计稿/提取素材）');
+    lines.push('');
+    let visionUsed = 0;
+    for (const imgPath of imageFiles.slice(0, MAX_IMAGES)) {
+        const rel = (0, path_1.relative)(iterDir, imgPath);
+        if ((0, vision_engine_1.isVisionEnabled)(visionConfig) && visionUsed < MAX_VISION) {
+            const result = await (0, vision_engine_1.describeImage)(imgPath, visionConfig);
+            if (result.success) {
+                visionUsed++;
+                lines.push(`- **${rel}**（视觉描述）: ${result.description.slice(0, 300)}`);
+                recordAssetAudit(rel, '视觉模型已描述');
+                continue;
+            }
+        }
+        const size = await (0, fs_extra_1.stat)(imgPath).then(s => `${(s.size / 1024).toFixed(1)}KB`).catch(() => '?');
+        lines.push(`- \`${rel}\`（${size}，宿主 AI 请打开查看）`);
+        recordAssetAudit(rel, '图片已列入清单（宿主 AI 请打开查看）');
+    }
+    if (imageFiles.length > MAX_IMAGES) {
+        lines.push(`> 其余 ${imageFiles.length - MAX_IMAGES} 张图片未列出。`);
+    }
+    return {
+        name: '🖼️ 迭代素材资产（原型/截图/设计稿）',
+        path: 'iteration-media-assets.md',
+        content: lines.join('\n'),
+    };
+}
+/** 递归收集素材文件（HTML 原型 + 图片），限深度防爆炸 */
+async function walkMediaFiles(dir, htmlOut, imgOut, maxDepth, depth = 0) {
+    if (depth > maxDepth)
+        return;
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+        const p = (0, path_1.join)(dir, e.name);
+        if (e.isDirectory()) {
+            await walkMediaFiles(p, htmlOut, imgOut, maxDepth, depth + 1);
+        }
+        else if (/\.html?$/i.test(e.name)) {
+            htmlOut.push(p);
+        }
+        else if (/\.(png|jpe?g|gif|webp|svg)$/i.test(e.name)) {
+            imgOut.push(p);
+        }
+    }
+}
 function generateExamples(command, req) {
     const iter = req.provided.iteration || 'Q1';
     const task = req.availableOptions?.tasks?.[0] || 'Task-001';