ute2e/tools/build-scene-live-report.mjs

import fs from 'node:fs'
import path from 'node:path'
import { fileURLToPath } from 'node:url'

// Evidence is prepared by the real browser run. This script never changes it.
//
// Expected shape (all fields other than `evidence` are optional):
// {
//   date, baseURL, browser, role,
//   evidence: [{ title, status: 'PASS' | 'FAIL' | string, checks: [],
//     screenshot: 'screenshots/example.png', screenshots: [{ path, caption }], details,
//     superseded: true /* historical evidence excluded from current pass counts */ }],
//   correction: { title, summary, previousConclusion, rootCauses: [], fixes: [],
//     verification: [], screenshots: [{ path, caption }] },
//   projects: [{ id, name, finalStatus, finalVersionId, modelId, modelVersionId,
//     cover: { image, width, height, bytes, sizeBytes, assetId, sha256, storageUri } }],
//   finalListScreenshot, issues, followUpIssues, commands, retainedData, cleanup
// }
// Image values must be report-relative PNG/JPEG/WebP paths. Sensitive fields are removed
// before rendering, so evidence may safely retain raw API responses locally.
const reportDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../reports/scene-live-20260905')
const sourcePath = path.join(reportDir, 'evidence.json')
const sensitiveKey = /password|secret|token|ticket|authorization|cookie|signature|credential|api[_-]?key/i
const cleanText = value => String(value ?? '')
  .replace(/\bBearer\s+[^\s"'<>]+/gi, 'Bearer [已隐藏]')
  .replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, '$1[已隐藏]@')
  .replace(/\b((?:access|refresh)?[_-]?token|password|secret|uploadTicket|signature|api[_-]?key|X-Amz-(?:Signature|Credential|Security-Token))\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s,;&}]+)/gi, '$1=[已隐藏]')
  .replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g, '[已隐藏]')

function sanitize(value) {
  if (typeof value === 'string') return cleanText(value)
  if (Array.isArray(value)) return value.map(sanitize)
  if (value && typeof value === 'object') {
    return Object.fromEntries(Object.entries(value)
      .filter(([key]) => !sensitiveKey.test(key))
      .map(([key, item]) => [key, sanitize(item)]))
  }
  return value
}

const data = sanitize(JSON.parse(fs.readFileSync(sourcePath, 'utf8').replace(/^\uFEFF/, '')))
const asArray = value => Array.isArray(value) ? value : value === undefined || value === null ? [] : [value]
const evidence = asArray(data.evidence)
const currentEvidence = evidence.filter(item => item.superseded !== true)
const historicalCount = evidence.length - currentEvidence.length
const correction = data.correction && typeof data.correction === 'object' ? data.correction : null
const projects = asArray(data.projects)
const commands = asArray(data.commands)
const allIssues = asArray(data.issues)
const issueText = issue => typeof issue === 'string' ? issue : JSON.stringify(issue ?? '')
const fsvcTicketFinding = /(?:\bfsvc\b[\s\S]{0,160}(?:upload[\s_-]*ticket|上传票据|票据)|(?:upload[\s_-]*ticket|上传票据|票据)[\s\S]{0,160}\bfsvc\b)/i
const isIndependent = issue => {
  if (!issue) return false
  if (typeof issue === 'object'
      && /^(?:existing|pre-existing|independent|follow-up)$/i.test(issue.scope || issue.category || '')) return true
  const text = issueText(issue)
  return fsvcTicketFinding.test(text)
    || /(?:既存|独立|后续).{0,30}票据|票据.{0,30}(?:既存|独立|后续)/.test(text)
}
const issues = allIssues.filter(issue => !isIndependent(issue))
const independentIssues = [...new Map([...allIssues.filter(isIndependent), ...asArray(data.followUpIssues)]
  .map(issue => [JSON.stringify(issue), issue])).values()]
const passCount = currentEvidence.filter(item => item.status === 'PASS').length
const failCount = currentEvidence.filter(item => item.status === 'FAIL').length
const otherCount = currentEvidence.length - passCount - failCount

const html = value => cleanText(value).replace(/[&<>"']/g, char => ({
  '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
})[char])
const md = value => html(value).replaceAll('\\', '\\\\').replace(/[|\[\]*_`]/g, char => `\\${char}`).replace(/\r?\n/g, ' ')
const url = value => String(value).replaceAll('\\', '/').split('/').map(encodeURIComponent).join('/')
const pretty = value => typeof value === 'string' ? value : JSON.stringify(value, null, 2)
const recorded = value => value === undefined || value === null || value === '' ? '未记录' : value
const statusClass = value => value === 'PASS' ? 'pass' : value === 'FAIL' ? 'fail' : 'neutral'
const imageFields = new Set(['screenshot', 'screenshots', 'coverImage', 'image', 'finalListScreenshot'])
const imagePaths = new Set()

function imageRefs(value) {
  return asArray(value).flatMap(item => {
    if (!item) return []
    if (typeof item === 'string') return [{ path: item, caption: '' }]
    if (typeof item === 'object') {
      const imagePath = item.path || item.src || item.image
      if (typeof imagePath === 'string' && imagePath) return [{ path: imagePath, caption: item.caption || item.title || '' }]
    }
    throw new Error('图片引用应为相对路径字符串或 { path, caption } 对象。')
  })
}

function collectImages(value) {
  if (Array.isArray(value)) return value.forEach(collectImages)
  if (!value || typeof value !== 'object') return
  for (const [key, item] of Object.entries(value)) {
    if (imageFields.has(key)) imageRefs(item).forEach(ref => imagePaths.add(ref.path))
    else collectImages(item)
  }
}
collectImages(data)

// Fail before writing either report when any referenced image is missing or unsafe.
const realReportDir = fs.realpathSync(reportDir)
for (const relative of imagePaths) {
  if (path.isAbsolute(relative) || /^[a-z][a-z\d+.-]*:/i.test(relative)
      || !/\.(png|jpe?g|webp)$/i.test(relative)) {
    throw new Error(`图片必须是报告目录中的 PNG/JPEG/WebP 相对路径：${relative}`)
  }
  const absolute = path.resolve(reportDir, relative.replaceAll('\\', '/'))
  const underRoot = path.relative(reportDir, absolute)
  if (underRoot === '..' || underRoot.startsWith(`..${path.sep}`) || path.isAbsolute(underRoot)
      || !fs.existsSync(absolute) || !fs.statSync(absolute).isFile() || fs.statSync(absolute).size === 0) {
    throw new Error(`图片不存在、为空或越出报告目录：${relative}`)
  }
  const realRelative = path.relative(realReportDir, fs.realpathSync(absolute))
  if (realRelative === '..' || realRelative.startsWith(`..${path.sep}`) || path.isAbsolute(realRelative)) {
    throw new Error(`图片链接目标越出报告目录：${relative}`)
  }
}

function picturesOf(item) {
  const refs = [item.screenshot, item.screenshots, item.coverImage].flatMap(imageRefs)
  return refs.filter((ref, index) => refs.findIndex(other => other.path === ref.path) === index)
    .map(ref => item.superseded === true
      ? { ...ref, caption: `历史截图（不作为修复后的视觉通过证据）：${ref.caption || '原测试现场'}` }
      : ref)
}
const coverOf = project => imageRefs(project.cover?.image || project.coverImage || project.cover?.screenshot)[0]
const finalList = imageRefs(data.finalListScreenshot)[0] || [...evidence].reverse()
  .filter(item => /(?:最终|倒序|排序).*列表|列表.*(?:最终|倒序|排序)/.test(item.title || ''))
  .flatMap(picturesOf)[0]
const figure = (ref, caption, className = '') => ref
  ? `<figure class="${className}"><a href="${html(url(ref.path))}" target="_blank" rel="noopener"><img src="${html(url(ref.path))}" alt="${html(ref.caption || caption)}" loading="lazy"></a><figcaption>${html(ref.caption || caption)} · 点击查看原图</figcaption></figure>`
  : '<p class="muted">尚未记录本地图片。</p>'
const mdImage = (ref, caption) => ref
  ? `[![${md(ref.caption || caption)}](${url(ref.path)})](${url(ref.path)})`
  : '尚未记录本地图片。'
const extraOf = item => Object.fromEntries(Object.entries(item)
  .filter(([key]) => !['title', 'status', 'checks', 'screenshot', 'screenshots', 'coverImage'].includes(key)))
const checkText = check => typeof check === 'string' ? check : pretty(check)
const evidenceStatus = item => item.superseded === true ? '历史记录（已更正）' : recorded(item.status)
const correctionSections = correction ? [
  ['原结论与漏验', asArray(correction.previousConclusion)],
  ['根因', asArray(correction.rootCauses)],
  ['修复内容', asArray(correction.fixes)],
  ['修复后验证', asArray(correction.verification)],
].filter(([, items]) => items.length) : []
const correctionPictures = correction ? picturesOf(correction) : []
const correctionHtml = correction ? `<section class="correction" aria-label="测试结论更正"><h2>${html(correction.title || '狐狸场景验证更正')}</h2>${correction.summary ? `<p>${html(correction.summary)}</p>` : ''}${correctionSections.map(([title, items]) => `<h3>${html(title)}</h3><ul>${items.map(item => `<li>${html(checkText(item))}</li>`).join('')}</ul>`).join('')}<div class="images ${correctionPictures.length === 1 ? 'single' : ''}">${correctionPictures.map(ref => figure(ref, '修复后视觉验证')).join('')}</div><p class="muted">下方标为“历史记录（已更正）”的检查及截图保留用于追溯，不计入当前通过率，也不作为狐狸已经可见的证据。</p></section>` : ''
const correctionMarkdown = correction ? [
  `## ${md(correction.title || '狐狸场景验证更正')}`, '',
  ...(correction.summary ? [`> **测试结论更正：** ${md(correction.summary)}`, ''] : []),
  ...correctionSections.flatMap(([title, items]) => [`### ${md(title)}`, '', ...items.map(item => `- ${md(checkText(item))}`), '']),
  ...correctionPictures.flatMap(ref => [mdImage(ref, '修复后视觉验证'), '']),
  '下方标为“历史记录（已更正）”的检查及截图保留用于追溯，不计入当前通过率，也不作为狐狸已经可见的证据。', '',
] : []
const projectStatus = project => recorded(project.finalStatus || project.status)
const projectVersion = project => recorded(project.finalVersionId || project.currentVersionId || project.cover?.versionId)
const commandParts = item => typeof item === 'string'
  ? { command: item, result: '未记录执行结果' }
  : { command: item.command || item.cmd || item.name || '命令未记录',
      result: pretty(Object.fromEntries(Object.entries(item).filter(([key]) => !['command', 'cmd', 'name'].includes(key)))) }
const featureText = '场景保存截图封面及列表按创建时间倒序的功能已实施。本报告记录使用现有模型创建真实场景、保存当前三维视口封面及异常回退的实际验证结果。'
const environment = `${recorded(data.date)} · ${recorded(data.baseURL)} · ${recorded(data.browser)} · ${recorded(data.role)}`
const retainedText = data.retainedData ? pretty(data.retainedData) : projects.length
  ? `本次创建的 ${projects.length} 条场景保留在开发环境：${projects.map(project => `${project.id}（${project.name || '未命名'}）`).join('、')}。模型引用固定到下表记录的已发布版本。`
  : '尚未记录保留场景。'
const cleanupText = data.cleanup ? pretty(data.cleanup) : '未记录额外清理操作；报告不据此宣称测试文件或历史版本已删除。'
const limitations = [
  '手动保存从当前三维视口生成封面；新封面与场景内容、模型引用在同一次工程更新中关联保存。发布前的保存沿用该流程。',
  '截图或封面上传失败时保留旧封面；工程是否保存成功以实际更新请求为准。版本冲突不覆盖其他已保存的内容。',
  '自动恢复及重新打开工程不生成或上传新封面；恢复后的修改需由用户保存后更新封面。',
  '列表按创建时间倒序展示。再次保存不会改变创建时间，也不应因此改变创建时间排序。',
  ...asArray(data.limitations).map(checkText),
]
const independentText = '既存受控文件资产的 fsvc URI 分支未完整覆盖上传票据绑定校验，属于本次场景封面变更前已存在的问题。本次保留现有流程，后续应独立补齐校验并验证历史资产、版本复制与引用兼容性；不计入本次场景功能失败数。'
const countText = `当前证据项通过 ${passCount} / ${currentEvidence.length}；失败 ${failCount}；其他或未标注 ${otherCount}；已更正历史记录 ${historicalCount}；已校验图片文件 ${imagePaths.size}。`

const outputHtml = `<!doctype html>
<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>真实场景与截图封面验证报告 · ${html(data.date)}</title>
<style>
.correction{margin:24px 0;padding:22px 24px;border:2px solid #c56b13;border-left-width:7px;border-radius:12px;background:#fff7e8}.correction h2{margin-top:0;color:#823b08}.correction h3{margin-top:18px}.correction li{white-space:pre-wrap;overflow-wrap:anywhere}
:root{color-scheme:light;--ink:#172d35;--muted:#536872;--line:#dbe5e7;--accent:#10664e}*{box-sizing:border-box}body{margin:0;background:#f2f6f6;color:var(--ink);font:15px/1.7 system-ui,"Microsoft YaHei",sans-serif}main{max-width:1180px;margin:auto;padding:38px 28px 60px}header{padding-bottom:20px;border-bottom:1px solid var(--line)}.eyebrow{font-size:12px;letter-spacing:.12em;font-weight:700;color:var(--accent)}h1{font-size:32px;line-height:1.4;margin:7px 0 12px}h2{font-size:23px;margin:30px 0 14px}h3{font-size:17px;margin:0 0 8px}p{margin:8px 0 12px}.muted,figcaption{color:var(--muted)}a{color:var(--accent);text-underline-offset:3px}.stats{display:flex;flex-wrap:wrap;gap:12px;margin:22px 0}.stat{background:white;border:1px solid var(--line);border-radius:10px;padding:12px 18px;min-width:150px}.stat strong{display:block;font-size:25px}.covers,.checks{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:18px}.card,.check,.panel{background:white;border:1px solid var(--line);border-radius:12px;padding:20px;min-width:0}.meta{display:grid;grid-template-columns:auto 1fr;gap:4px 12px;font-size:13px}.meta dt{color:var(--muted)}.meta dd{margin:0;overflow-wrap:anywhere}figure{margin:12px 0 0}figure img{display:block;width:100%;height:auto;background:#edf1f1;border:1px solid var(--line);border-radius:7px}.cover-image img{aspect-ratio:16/9;object-fit:contain}figcaption{font-size:12px;margin-top:5px}.images{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.images.single{grid-template-columns:1fr}.badge{display:inline-block;padding:1px 9px;border-radius:12px;font-size:12px;font-weight:700;white-space:nowrap}.pass{background:#e1f3eb;color:#0c6144}.fail{background:#fde8e8;color:#ab2323}.neutral{background:#edf0f4;color:#425566}.check-title{display:flex;align-items:flex-start;justify-content:space-between;gap:10px}details{margin-top:12px}summary{cursor:pointer;color:var(--accent);font-size:13px}pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#f4f7f8;border-radius:7px;padding:12px;font:12px/1.6 ui-monospace,Consolas,monospace;max-height:360px;overflow:auto}ul{padding-left:21px}.assertions{font-size:13px}.assertions li{margin:6px 0;white-space:pre-wrap;overflow-wrap:anywhere}table{width:100%;border-collapse:collapse;font-size:13px}th,td{padding:9px 11px;border-bottom:1px solid var(--line);text-align:left;vertical-align:top}th{background:#f4f7f8}td{overflow-wrap:anywhere}.command{margin-bottom:16px}.command h3{font-family:ui-monospace,Consolas,monospace;font-size:13px;overflow-wrap:anywhere}footer{margin-top:28px;color:var(--muted);font-size:12px}@media(max-width:760px){main{padding:24px 16px 40px}h1{font-size:26px}.covers,.checks{grid-template-columns:1fr}.stat{flex:1;min-width:115px}.panel,.card,.check{padding:15px}.table-wrap{overflow:auto}}@media print{body{background:white}main{max-width:none;padding:0}.card,.check,figure{break-inside:avoid}.checks{display:block}.check{margin-bottom:14px}pre{max-height:none}a{color:inherit}}
</style></head><body><main>
<header><div class="eyebrow">SCENE LIVE · 功能已实施</div><h1>真实场景与截图封面验证报告</h1><p>${html(featureText)}</p><p class="muted">${html(environment)}</p><a href="report.md">Markdown 报告</a></header>
${correctionHtml}
<div class="stats"><div class="stat"><strong>${passCount} / ${currentEvidence.length}</strong>当前证据项通过</div><div class="stat"><strong>${failCount}</strong>失败</div><div class="stat"><strong>${otherCount}</strong>其他或未标注</div>${historicalCount ? `<div class="stat"><strong>${historicalCount}</strong>已更正历史记录</div>` : ''}<div class="stat"><strong>${imagePaths.size}</strong>图片文件已校验</div></div>
<h2>保留场景与封面证据</h2><div class="covers">${projects.map(project => {
  const cover = project.cover || {}
  return `<article class="card"><h3>${html(project.name || `场景 ${project.id}`)}</h3>${figure(coverOf(project), `场景 ${project.id} 保存后封面回读证据`, 'cover-image')}<dl class="meta"><dt>场景 / 状态</dt><dd>${html(project.id)} / ${html(projectStatus(project))}</dd><dt>当前工程版本</dt><dd>${html(projectVersion(project))}</dd><dt>引用模型 / 版本</dt><dd>${html(recorded(project.modelId))} / ${html(recorded(project.modelVersionId))}</dd><dt>封面大小</dt><dd>${html(recorded(cover.sizeBytes ?? cover.bytes))} 字节${cover.width && cover.height ? ` · ${html(cover.width)} × ${html(cover.height)}` : ''}</dd></dl><details><summary>封面持久化与项目证据</summary><pre>${html(pretty(project))}</pre></details></article>`
}).join('') || '<p>尚未记录场景项目。</p>'}</div>
<h2>最终列表与创建时间倒序</h2><section class="panel">${figure(finalList, '保留场景的实际封面与创建时间倒序列表')}</section>
<h2>逐项验证记录</h2><p class="muted">通过数仅统计未被更正且 status 明确为 PASS 的当前证据项；历史记录单独标注。checks 用于展示实际断言，不重复累加。故障注入中的预期错误响应不等于用例失败；缺少状态时不推断通过。图片文件存在校验不等于视觉内容验证。</p><div class="checks">${evidence.map((item, index) => {
  const pictures = picturesOf(item)
  const extra = extraOf(item)
  return `<article class="check"><div class="check-title"><h3>${index + 1}. ${html(item.title || '未命名检查')}</h3><span class="badge ${item.superseded === true ? 'neutral' : statusClass(item.status)}">${html(evidenceStatus(item))}</span></div>${asArray(item.checks).length ? `<ul class="assertions">${asArray(item.checks).map(check => `<li>${html(checkText(check))}</li>`).join('')}</ul>` : ''}${Object.keys(extra).length ? `<details><summary>检查详情</summary><pre>${html(pretty(extra))}</pre></details>` : ''}<div class="images ${pictures.length === 1 ? 'single' : ''}">${pictures.map(ref => figure(ref, /\.jpe?g$/i.test(ref.path) ? '实际生成的场景封面' : '浏览器现场')).join('')}</div></article>`
}).join('') || '<p>尚未记录验证结果。</p>'}</div>
<h2>数据保留与清理</h2><section class="panel"><pre>${html(retainedText)}</pre><div class="table-wrap"><table><thead><tr><th>场景</th><th>模型 / 发布版本</th><th>最终状态</th><th>当前版本</th></tr></thead><tbody>${projects.map(project => `<tr><td>${html(project.id)} · ${html(project.name)}</td><td>${html(recorded(project.modelId))} / ${html(recorded(project.modelVersionId))}</td><td>${html(projectStatus(project))}</td><td>${html(projectVersion(project))}</td></tr>`).join('')}</tbody></table></div><pre>${html(cleanupText)}</pre></section>
<h2>本次问题记录</h2><section class="panel">${issues.length ? issues.map(issue => `<pre>${html(pretty(issue))}</pre>`).join('') : '<p>当前证据未登记本次新增的未解决问题。</p>'}</section>
<h2>后续独立事项</h2><section class="panel"><p>${html(independentText)}</p>${independentIssues.map(issue => `<pre>${html(pretty(issue))}</pre>`).join('')}</section>
<h2>实际命令与结果</h2><section class="panel">${commands.length ? commands.map(item => { const entry = commandParts(item); return `<div class="command"><h3>${html(entry.command)}</h3><pre>${html(entry.result)}</pre></div>` }).join('') : '<p>evidence.json 尚未记录命令结果；不据此宣称构建或命令行测试通过。</p>'}</section>
<h2>当前行为与限制</h2><section class="panel"><ul>${limitations.map(item => `<li>${html(item)}</li>`).join('')}</ul></section>
<footer>报告来自 evidence.json，生成过程不修改原始证据。所有引用图片已校验存在且非空，点击可查看原图。通过数随证据更新，不固定用例数量。</footer>
</main></body></html>`

const outputMarkdown = [
  '# 真实场景与截图封面验证报告', '', featureText, '', md(environment), '', ...correctionMarkdown, countText, '',
  '## 保留场景与封面证据', '',
  ...projects.flatMap(project => [
    `### ${md(project.name || `场景 ${project.id}`)}`, '',
    `场景 ${md(project.id)}；状态 ${md(projectStatus(project))}；当前版本 ${md(projectVersion(project))}；引用模型 ${md(recorded(project.modelId))} / 发布版本 ${md(recorded(project.modelVersionId))}。`, '',
    mdImage(coverOf(project), `场景 ${project.id} 保存后封面回读证据`), '',
    '<details><summary>封面持久化与项目证据</summary>', '', '<pre>', html(pretty(project)), '</pre>', '', '</details>', '',
  ]),
  '## 最终列表与创建时间倒序', '', mdImage(finalList, '保留场景的封面与创建时间倒序列表'), '',
  '## 逐项验证记录', '',
  '通过数仅统计未被更正且 status 明确为 PASS 的当前证据项；历史记录单独标注。checks 不重复累加。预期故障响应不等于用例失败，缺少状态不推断通过。图片文件存在校验不等于视觉内容验证。', '',
  '| 序号 | 检查项 | 结果 | 图片 |', '|---|---|---|---|',
  ...evidence.map((item, index) => `| ${index + 1} | ${md(item.title || '未命名检查')} | ${md(evidenceStatus(item))} | ${picturesOf(item).map((ref, i) => `[图片 ${i + 1}](${url(ref.path)})`).join(' · ') || '—'} |`), '',
  ...evidence.flatMap((item, index) => [
    `### ${index + 1}. ${md(item.title || '未命名检查')} · ${md(evidenceStatus(item))}`, '',
    ...asArray(item.checks).map(check => `- ${md(checkText(check))}`), '',
    ...(Object.keys(extraOf(item)).length ? ['<details><summary>检查详情</summary>', '', '<pre>', html(pretty(extraOf(item))), '</pre>', '', '</details>', ''] : []),
    ...picturesOf(item).flatMap(ref => [mdImage(ref, '验证现场'), '']),
  ]),
  '## 数据保留与清理', '', '<pre>', html(retainedText), '</pre>', '',
  '| 场景 | 模型 / 发布版本 | 最终状态 | 当前版本 |', '|---|---|---|---|',
  ...projects.map(project => `| ${md(project.id)} · ${md(project.name)} | ${md(recorded(project.modelId))} / ${md(recorded(project.modelVersionId))} | ${md(projectStatus(project))} | ${md(projectVersion(project))} |`), '',
  '<pre>', html(cleanupText), '</pre>', '',
  '## 本次问题记录', '',
  ...(issues.length ? issues.flatMap(issue => ['<pre>', html(pretty(issue)), '</pre>', '']) : ['当前证据未登记本次新增的未解决问题。', '']),
  '## 后续独立事项', '', independentText, '',
  ...independentIssues.flatMap(issue => ['<pre>', html(pretty(issue)), '</pre>', '']),
  '## 实际命令与结果', '',
  ...(commands.length ? commands.flatMap(item => { const entry = commandParts(item); return [`**${md(entry.command)}**`, '', '<pre>', html(entry.result), '</pre>', ''] })
    : ['evidence.json 尚未记录命令结果；不据此宣称构建或命令行测试通过。', '']),
  '## 当前行为与限制', '', ...limitations.map(item => `- ${item}`), '',
  '报告来自 evidence.json，未修改原始证据；所有引用图片已校验存在且非空，点击可查看原图。通过数随证据更新。', '',
].join('\n')

fs.writeFileSync(path.join(reportDir, 'index.html'), outputHtml, 'utf8')
fs.writeFileSync(path.join(reportDir, 'report.md'), outputMarkdown, 'utf8')
console.log(JSON.stringify({ report: 'reports/scene-live-20260905/index.html', passed: passCount,
  total: currentEvidence.length, historical: historicalCount, failed: failCount, other: otherCount, imagesValidated: imagePaths.size,
  projectsRecorded: projects.length, commandsRecorded: commands.length }))