speccore 8.3.341 → 8.3.346

package/dist/core/help-panel.js

@@ -5,40 +5,40 @@ exports.HELP_PANEL = void 0;
 exports.HELP_PANEL = `
 ┌──────────────────────────────────────────────────────────────┐
 │  🧠 = 协作式（支持 --interactive）  ⚡ = 单次执行              │
-│  核心流水线: init → doc2spec → unitize → analyze → taskify    │
-│            → plan → execute → pr → done → spec2doc           │
+│  核心流水线: init → doc2spec → req-doc → unitize → analyze    │
+│            → taskify → plan → execute → verify → pipeline    │
+│            → pr → done → spec2doc                            │
 ├──────────────────────────────────────────────────────────────┤
 │  📥 资产接入                                                  │
 │  🚀 init          ⚡ 初始化项目                                │
 │  📅 iteration     ⚡ 迭代管理                                  │
 │  📝 doc2spec      ⚡ 导入 PRD → Spec MD（AI 精炼推荐）          │
 │  🔪 unitize       ⚡ 切分需求文档 → 功能单元（features/）        │
-│  📤 spec2doc      ⚡ Spec MD → Word/PDF（AI 排版推荐）          │
 │  📦 task new      ⚡ 创建任务                                  │
+│  📤 spec2doc      ⚡ Spec MD → Word/PDF（AI 排版推荐）          │
 ├──────────────────────────────────────────────────────────────┤
 │  🤝 协作决策                                                  │
 │  🔍 analyze       🧠 需求分析+代码审查+多端合成（--full）       │
 │  📊 taskify       🧠 拆功能单元 → 开发任务（Task-*）            │
 │  📋 plan          🧠 执行计划（--interactive）                  │
+│  📝 req-doc       🧠 需求文档化（口语化 → PRD）                 │
 ├──────────────────────────────────────────────────────────────┤
 │  🚀 执行交付                                                  │
 │  💻 execute       ⚡ 自动排序执行                              │
+│  ✅ verify        ⚡ 编译+Lint+单测+UI 冒烟（质量门禁）          │
+│  🚢 pipeline      ⚡ 合并分支 → 构建 → 部署（环境驱动）          │
 │  🔀 pr            🧠 创建PR（--interactive）                   │
 │  ✅ done          🧠 收尾归档（--interactive）                  │
-│  🔄 change        🧠 需求变更（--interactive）                  │
-├──────────────────────────────────────────────────────────────┤
-│  📊 治理                                                     │
-│  ✅ validate      ⚡ 合规校验                                  │
-│  🗑  rename       ⚡ 重命名 Task/迭代                           │
 ├──────────────────────────────────────────────────────────────┤
 │  💡 智能入口                                                  │
 │  speccore             自适应面板（检测阶段 → 提示下一步）          │
 │  speccore ask "..."   自然语言意图识别                          │
 │  speccore next        检测进度：提示下一步（只指引）               │
 │  speccore run         端到端全自动流水线（13 阶段）               │
-│  speccore about       版本信息/功能说明/文档链接                  │
 │  speccore dashboard   可视化仪表盘（迭代/全局）                 │
-│  speccore prompts     提示词库：预置模板 + 自定义提示词           │
+│  speccore status      项目状态面板                             │
+│  speccore about       版本信息/功能说明/文档链接                  │
+│  💡 speccore help --all   查看全部命令（含低频/运维命令）        │
 └──────────────────────────────────────────────────────────────┘
 `;
 //# sourceMappingURL=help-panel.js.map

package/dist/core/page-bundle.d.ts

@@ -0,0 +1,25 @@
+/** 包内 HTML 模板目录（dist/core → 包根 templates/html，与 ask/init 现有定位同源） */
+export declare function htmlTemplateDir(): string;
+/** ask 引导页跳转的四个模式页 */
+export declare const ASK_MODE_PAGES: readonly string[];
+/** 从包内模板复制单个 HTML 到项目 outputs/（存在才复制，幂等覆盖） */
+export declare function copyHtmlTemplate(cwd: string, file: string): Promise<string>;
+/** 联动生成提示词库页（失败不阻断主流程） */
+export declare function ensurePromptsPage(cwd: string): Promise<void>;
+/**
+ * 幂等生成 ask 引导页家族：
+ * onboarding 主页面 + 四个模式页 + 帮助页（onboarding 的跳转目标全部补齐）
+ * 返回 onboarding 页面路径，供 [SPECCORE_ONBOARD] 标记使用。
+ */
+export declare function ensureAskPages(cwd: string): Promise<string>;
+/**
+ * 幂等生成项目配置引导页（setup-guide 内「查看提示词库」链接 → prompts，
+ * 两者一起补齐）。返回 setup-guide 页面路径。
+ */
+export declare function ensureSetupGuidePage(cwd: string, projectName?: string, pkgVersion?: string): Promise<string>;
+/**
+ * 幂等补齐项目名片（welcome 页）的全部跳转目标：
+ * onboarding 家族（含帮助页 + 提示词库）；已初始化项目再补配置引导页。
+ */
+export declare function ensureWelcomeTargets(cwd: string, isInit: boolean): Promise<void>;
+//# sourceMappingURL=page-bundle.d.ts.map

package/dist/core/page-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-bundle.d.ts","sourceRoot":"","sources":["../../src/core/page-bundle.ts"],"names":[],"mappings":"AAiBA,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,sBAAsB;AACtB,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAK3C,CAAC;AAEF,8CAA8C;AAC9C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjF;AAED,0BAA0B;AAC1B,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWjE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlH;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF"}

package/dist/core/page-bundle.js

@@ -0,0 +1,144 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASK_MODE_PAGES = void 0;
+exports.htmlTemplateDir = htmlTemplateDir;
+exports.copyHtmlTemplate = copyHtmlTemplate;
+exports.ensurePromptsPage = ensurePromptsPage;
+exports.ensureAskPages = ensureAskPages;
+exports.ensureSetupGuidePage = ensureSetupGuidePage;
+exports.ensureWelcomeTargets = ensureWelcomeTargets;
+/**
+ * HTML 页面家族联动生成（v8.3.342+）
+ *
+ * 背景：welcome / ask / init 等命令弹出的 HTML 页面之间存在相对跳转
+ * （如项目名片 → ask 引导页 → 四个模式页 → 帮助页），此前各命令只生成
+ * 自己的主页面，跳转目标依赖其他命令跑过——首次使用某个命令时点击
+ * 链接即 404，或 outputs/ 被清理后链路永久断掉（ask 的版本 marker 还在）。
+ *
+ * 本模块提供幂等的页面家族补齐：任何入口命令生成主页面后调用
+ * ensureXxx，保证跳转目标必达。所有联动失败均不阻断主流程。
+ *
+ * 注意：对 ask.ts 采用运行时动态 import，避免 static 循环依赖
+ * （ask.ts 会静态 import 本模块）。
+ */
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+/** 包内 HTML 模板目录（dist/core → 包根 templates/html，与 ask/init 现有定位同源） */
+function htmlTemplateDir() {
+    return (0, path_1.join)(__dirname, '..', '..', 'templates', 'html');
+}
+/** ask 引导页跳转的四个模式页 */
+exports.ASK_MODE_PAGES = [
+    'speccore-ask-explain.html',
+    'speccore-ask-guide.html',
+    'speccore-ask-match.html',
+    'speccore-ask-pipeline.html',
+];
+/** 从包内模板复制单个 HTML 到项目 outputs/（存在才复制，幂等覆盖） */
+async function copyHtmlTemplate(cwd, file) {
+    const src = (0, path_1.join)(htmlTemplateDir(), file);
+    const dest = (0, path_1.join)(cwd, 'outputs', file);
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(cwd, 'outputs'));
+    if (await (0, fs_extra_1.pathExists)(src))
+        await (0, fs_extra_1.copy)(src, dest);
+    return dest;
+}
+/** 联动生成提示词库页（失败不阻断主流程） */
+async function ensurePromptsPage(cwd) {
+    try {
+        const { generatePromptsPage } = await Promise.resolve().then(() => __importStar(require('../commands/prompts')));
+        await generatePromptsPage((0, path_1.join)(cwd, 'outputs', 'speccore-prompts.html'));
+    }
+    catch { /* 联动失败不阻断 */ }
+}
+/**
+ * 幂等生成 ask 引导页家族：
+ * onboarding 主页面 + 四个模式页 + 帮助页（onboarding 的跳转目标全部补齐）
+ * 返回 onboarding 页面路径，供 [SPECCORE_ONBOARD] 标记使用。
+ */
+async function ensureAskPages(cwd) {
+    const { renderOnboardingHtml } = await Promise.resolve().then(() => __importStar(require('../commands/ask')));
+    const html = renderOnboardingHtml();
+    const outPath = (0, path_1.join)(cwd, 'outputs', 'speccore-ask-onboarding.html');
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(cwd, 'outputs'));
+    await (0, fs_extra_1.writeFile)(outPath, html);
+    for (const f of [...exports.ASK_MODE_PAGES, 'speccore-help.html']) {
+        await copyHtmlTemplate(cwd, f);
+    }
+    await ensurePromptsPage(cwd);
+    return outPath;
+}
+/**
+ * 幂等生成项目配置引导页（setup-guide 内「查看提示词库」链接 → prompts，
+ * 两者一起补齐）。返回 setup-guide 页面路径。
+ */
+async function ensureSetupGuidePage(cwd, projectName, pkgVersion) {
+    const name = projectName || (0, path_1.basename)(cwd);
+    const templatePath = (0, path_1.join)(htmlTemplateDir(), 'speccore-setup-guide.html');
+    let template;
+    if (await (0, fs_extra_1.pathExists)(templatePath)) {
+        template = await (0, fs_extra_1.readFile)(templatePath, 'utf-8');
+    }
+    else {
+        // 降级：模板缺失时给出可读提示（不应该发生）
+        template = '<!DOCTYPE html><html><body><h1>SpecCore 配置引导</h1><p>模板文件缺失，请检查包内 templates/html/speccore-setup-guide.html</p></body></html>';
+    }
+    const html = template
+        .replace(/\{\{PROJECT_NAME\}\}/g, name)
+        .replace(/\{\{VERSION\}\}/g, pkgVersion || '0.0.0');
+    const outputPath = (0, path_1.join)(cwd, 'outputs', 'speccore-setup-guide.html');
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(cwd, 'outputs'));
+    await (0, fs_extra_1.writeFile)(outputPath, html);
+    await ensurePromptsPage(cwd);
+    return outputPath;
+}
+/**
+ * 幂等补齐项目名片（welcome 页）的全部跳转目标：
+ * onboarding 家族（含帮助页 + 提示词库）；已初始化项目再补配置引导页。
+ */
+async function ensureWelcomeTargets(cwd, isInit) {
+    await ensureAskPages(cwd);
+    if (isInit) {
+        let pkgVersion = '0.0.0';
+        try {
+            const pkg = await (0, fs_extra_1.readFile)((0, path_1.join)(cwd, 'package.json'), 'utf-8');
+            pkgVersion = JSON.parse(pkg).version || pkgVersion;
+        }
+        catch { /* 读不到用默认 */ }
+        await ensureSetupGuidePage(cwd, (0, path_1.basename)(cwd), pkgVersion);
+    }
+}
+//# sourceMappingURL=page-bundle.js.map

package/dist/core/page-bundle.js.map

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

package/dist/core/prompt-builder.d.ts

@@ -165,4 +165,13 @@ export declare function processMarkdownContent(content: string, filePath: string
     maxLinkChars?: number;
     maxSvgChars?: number;
 }): Promise<string>;
+/**
+ * v8.3.344+: 扫描迭代素材资产（原型 HTML + 参考截图/设计稿/提取图片）。
+ * 补齐盲区：此前只有「被已加载文档以 Markdown 链接引用」的资产会进入上下文，
+ * 010-requirements/prototypes/ 与 assets/ 下未被引用的原型/截图完全无通道。
+ * 策略：CLI 渲染 HTML 原型语义结构（ARIA 树 + 截图）与视觉描述关键图片，
+ * 其余列路径清单——宿主 AI 按需打开原文件。限额防撑爆上下文。
+ * 导出供单测直接调用（构造临时迭代目录即可验证注入行为）。
+ */
+export declare function collectIterationMediaAssets(iterDir: string, visionConfig?: VisionModelConfig): Promise<TaskExtraSpec | null>;
 //# sourceMappingURL=prompt-builder.d.ts.map

package/dist/core/prompt-builder.d.ts.map

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

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 构建引擎
  *
@@ -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';