pptList/scripts/aiPptSelfTest.mjs

import { createServer } from "vite"
import { existsSync } from "node:fs"
import { resolve } from "node:path"
import assert from "node:assert/strict"
import { classroomFixture } from "./fixtures/aiPptClassroom.mjs"
import { semanticDesignFixture, densityRegressionFixture, heroImageRegressionFixture } from "./fixtures/aiPptSemanticDesign.mjs"
import { modelDesignFixture } from "./fixtures/aiPptModelDesign.mjs"
import { inquiryFixture } from './fixtures/aiPptInquiry.mjs'
import { lessonRepairFixture } from './fixtures/aiPptLessonRepair.mjs'

const vite = await createServer({ server: { middlewareMode: true }, appType: "custom", logLevel: "error" })

try {
  const { aiCoursewareToSlides } = await vite.ssrLoadModule("/src/utils/aiCoursewareToSlides.ts")
  const { inspectAiPptQuality } = await vite.ssrLoadModule("/src/utils/aiPptQuality.ts")
  const inquiry = inquiryFixture()
  const inquiryResult = aiCoursewareToSlides(inquiry)
  const inquiryReport = inspectAiPptQuality(inquiry, inquiryResult.slides, {
    lessonMinutes: 40, minPages: 9, maxPages: 15, resourceMode: 'teacher_supplement', requireAudio: true, requireVideo: true
  })
  assert.deepEqual(inquiryReport.errors, [], `无媒体教学样例：${JSON.stringify(inquiryReport.errors)}`)
  assert(inquiryResult.slides.every(slide => slide.background.color === '#FAF8F2'), '默认模板必须采用整课主题色')
  assert(inquiryResult.slides.every(slide => !slide.elements.some(element => element.type === 'elf')), '媒体由教师补充时不生成空播放器或谱例')
  assert(inquiryResult.slides[3].elements.filter(element => element.type === 'shape').length >= 4, '强弱图须绘制为可编辑圆形')
  assert(inquiryResult.slides[5].remark.includes('教学示范：') && inquiryResult.slides[5].remark.includes('判断标准：'), '示范与反馈必须进入备注')
  const { AI_COURSEWARE_TEMPLATES } = await vite.ssrLoadModule("/src/config/aiCoursewareTemplates.ts")
  const { getAiCoursewareTemplateMaster, getTemplateMasterPage, resolveTemplatePageLayout } = await vite.ssrLoadModule("/src/config/aiCoursewareTemplateMasters.ts")
  const { resolveAiPptLayout } = await vite.ssrLoadModule("/src/utils/aiPptTemplateEngine.ts")

  const page = (pageNo, type, title, layout, points, extra = {}) => ({
    pageNo,
    type,
    title,
    bullets: points,
    studentContent: { points },
    imageKeywords: [],
    visualPlan: { layout, visualDensity: "medium" },
    ...extra
  })
  const elementText = element => {
    const content = element.type === "text" ? element.content : element.type === "shape" && element.text ? element.text.content : ""
    return String(content || "").replace(/<[^>]+>/g, "")
  }
  const missingStudentTexts = (outline, slides) =>
    outline.pages.flatMap((item, index) => {
      const expected = [item.studentContent?.headline, ...(item.studentContent?.points || item.bullets || [])].filter(Boolean)
      const rendered = (slides[index]?.elements || []).map(elementText).join("\n")
      return expected.filter(text => !rendered.includes(text)).map(text => ({ pageNo: item.pageNo, text }))
    })
  const repairFixture = lessonRepairFixture(inquiry.pages[0].image.url)
  const repaired = aiCoursewareToSlides(repairFixture, { enableAnimations: true }).slides
  assert.deepEqual(inspectAiPptQuality(repairFixture, repaired).errors.filter(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font', 'invalid_teaching_diagram'].includes(issue.code)), [])
  const repairedCoverImage = repaired[0].elements.find(el => el.type === 'image')
  assert(repairedCoverImage.width * repairedCoverImage.height / (1920 * 1080) >= .2, '真实封面结构不得把主图压成小横幅')
  const durationBars = repaired[2].elements.filter(el => el.type === 'shape')
  assert.equal(durationBars.length, 4, '每个短音独立呈现')
  assert(Math.abs(durationBars[0].width / durationBars[1].width - 2) < .01, '时值条严格使用提供的2:1比例')
  const pitchLabels = ['do', 're', 'mi'].map(label => repaired[3].elements.find(el => elementText(el) === label))
  assert(pitchLabels[0].top > pitchLabels[1].top && pitchLabels[1].top > pitchLabels[2].top, '相对音高逐级升高，不能只是水平流程')
  assert(repaired[3].remark.includes('不表示频率'), '图示依据保留在教师备注')
  assert(repaired[5].remark.includes('do → re → mi') && !repaired[5].elements.map(elementText).join('').includes('do → re → mi'), '答案仅供教师查看')
  for (const slide of repaired) {
    assert.equal(slide.animations.length, slide.elements.length, '标题、正文、形状和线条作为整体呈现')
    assert.equal(slide.animations[0].trigger, 'auto')
    assert(slide.animations.slice(1).every(animation => animation.trigger === 'meantime'), '不按文本元素顺序拆散教学图示')
  }
  const { imagePreparationMessage, teacherReviewMessage } = await vite.ssrLoadModule('/src/utils/aiPptFeedback.ts')
  assert(!imagePreparationMessage({ imageStatus: 'review_rejected', imageReview: '评分45低于65，mustInclude缺失，模型说明...' }).includes('评分'))
  assert(teacherReviewMessage('第6页请补充studentContent.steps').includes('学生操作步骤'))

  const singingOutline = {
    title: "凤鸣山谷的故事",
    gradeName: "一年级",
    textbookName: "音乐一年级上册",
    unitName: "第一单元 奇妙的声音世界",
    chapterName: "凤鸣山谷的故事",
    courseType: "music",
    style: "cartoon",
    pages: [
      page(1, "cover", "凤鸣山谷的故事", "cover_scene", ["聆听自然的声音", "发现音乐的强弱变化", "用声音和乐器讲故事"], { image: { url: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=" } }),
      page(2, "scene_intro", "山谷里传来了什么声音？", "story_stage", ["观察画面", "想一想……"], { interaction: { type: "question", question: "你觉得是谁在歌唱？", options: ["小鸟", "溪水", "风声"] } }),
      page(3, "objectives", "今天我们要学会", "goal_cards", ["分辨声音的高低", "感受音乐的强弱", "合作完成声音表演"]),
      page(4, "work_context", "走进凤鸣山谷", "split_image", ["清晨的山谷十分安静", "鸟鸣由远处慢慢靠近", "溪水一直轻轻流淌"]),
      page(5, "first_listen", "第一次完整聆听", "listen_wave", ["安静听完音乐", "用手势表示声音的远近", "记住最喜欢的声音"], { resourceBindings: [{ resourceId: "song-demo", resourceType: "SONG", name: "凤鸣山谷", contentUrl: "https://example.com/fengming.mp3", verified: true }] }),
      page(6, "lyric_read", "读一读山谷歌谣", "lyric_focus", ["小鸟唱得清脆", "溪水流得轻柔", "山风吹得悠长"]),
      page(7, "rhythm_practice", "跟着节奏拍一拍", "rhythm_grid", ["小鸟：短短拍", "溪水：连续拍", "山风：长长拍"], {
        studentContent: { headline: "跟着节奏拍一拍", points: ["小鸟：短短拍", "溪水：连续拍", "山风：长长拍"] },
        activity: { task: "教师示范不同节奏，引导学生模仿", steps: ["选择一种声音", "先慢速练习", "听指挥加入合奏"] }
      }),
      page(8, "melody_score", "旋律是怎样行走的？", "score_focus", ["向上表示声音变高", "向下表示声音变低", "平直表示保持稳定"]),
      page(9, "music_knowledge", "认识声音的强与弱", "knowledge_cards", ["强：有力量但不喊叫", "弱：轻柔但保持清楚", "强弱变化让音乐更生动"]),
      page(10, "compare_listen", "两段声音有什么不同？", "compare_listen", ["比较速度", "比较力度"], { interaction: { type: "compare", question: "哪一段更像远处的鸟鸣？", options: ["第一段更轻", "第二段更强", "第一段更慢", "第二段更快"] } }),
      page(11, "performance_activity", "合作表演山谷音乐会", "performance_stage", ["保持自己的声部", "关注指挥手势", "结束时一起收声"], { activity: { task: "用声音演出山谷从清晨到热闹的变化", steps: ["分成鸟鸣、溪水、山风三组", "商量进入顺序", "完整表演并互相评价"] } }),
      page(12, "summary", "我的音乐收获", "summary_checklist", ["我能分辨声音的高低", "我能表现声音的强弱", "我能与同伴合作表演"], { learningEvidence: "用一种声音表现你心中的凤鸣山谷" })
    ]
  }
  const appreciationOutline = {
    ...singingOutline,
    title: "月光下的琵琶",
    chapterName: "月光下的琵琶",
    courseType: "appreciation",
    style: "clean",
    pages: [
      page(1, "cover", "月光下的琵琶", "cover_scene", ["感受民族器乐的音色", "用语言描述音乐意境"]),
      page(2, "scene_intro", "月夜里传来了什么声音？", "hero_focus", ["观察演奏场景", "猜一猜正在演奏的乐器"]),
      page(3, "objectives", "带着三个问题走进音乐", "objectives", ["辨认琵琶音色", "感受速度与力度", "描述音乐意境"]),
      page(4, "first_listen", "完整聆听", "media_focus", ["安静聆听", "记录最打动你的片段", "想象音乐中的画面"]),
      page(5, "instrument_guide", "认识琵琶", "split_content", ["观察乐器外形", "了解基本演奏姿势", "辨认清脆明亮的音色"]),
      page(6, "music_knowledge", "音乐为什么有层次？", "diagram_focus", ["速度由慢到快", "力度由弱到强", "旋律推动情绪变化"]),
      page(7, "compare_listen", "两个片段有什么不同？", "compare", ["比较速度", "比较力度", "比较情绪"]),
      page(8, "creative_activity", "为音乐选择一幅画", "activity", ["小组交流选择理由", "用音乐要素支持判断", "向全班分享"]),
      page(9, "practice_check", "我能听出来", "summary", ["这是琵琶的音色", "这一段速度更快", "这一段力度更强"]),
      page(10, "summary", "我的欣赏收获", "text_focus", ["我能辨认琵琶音色", "我能描述速度和力度", "我能说出音乐带来的想象"])
    ]
  }
  const rhythmOutline = {
    ...singingOutline,
    title: "节奏变变变",
    chapterName: "节奏变变变",
    courseType: "rhythm",
    pages: [
      page(1, "cover", "节奏变变变", "cover_scene", ["发现生活中的节奏", "合作完成节奏接龙"]),
      page(2, "scene_intro", "哪些声音有规律？", "hero_focus", ["听脚步声", "听拍球声", "发现重复规律"]),
      page(3, "objectives", "今天的节奏任务", "objectives", ["稳定保持节拍", "模仿两种节奏型", "完成小组接龙"]),
      page(4, "rhythm_practice", "跟着节拍做动作", "diagram_focus", ["拍手", "跺脚", "拍腿"], { activity: { task: "保持稳定节拍", steps: ["看图模仿", "跟随口令", "独立完成"] } }),
      page(5, "compare_listen", "两种节奏一样吗？", "compare", ["比较声音长短", "比较疏密", "说出不同之处"]),
      page(6, "rhythm_practice", "组合新的节奏", "diagram_focus", ["选择两个节奏型", "按顺序连接", "反复练熟"], { activity: { task: "组合节奏", steps: ["选择", "连接", "练习"] } }),
      page(7, "creative_activity", "小组节奏接龙", "activity", ["保持共同速度", "轮到自己再进入", "结束动作要整齐"]),
      page(8, "practice_check", "节奏挑战", "summary", ["我能稳定拍击", "我能听出不同节奏", "我能完成接龙"]),
      page(9, "summary", "我的节奏收获", "text_focus", ["节拍要稳定", "节奏有长短疏密", "合作要互相倾听"])
    ]
  }
  const longOutline = {
    ...singingOutline,
    pages: [
      ...singingOutline.pages,
      page(13, "music_knowledge", "声音还能怎样变化？", "knowledge_cards", ["比较声音长短", "比较声音高低", "比较声音强弱"]),
      page(14, "creative_activity", "设计新的山谷回声", "activity", ["选择声音角色", "设计进入顺序", "合作完整展示"]),
      page(15, "summary", "把山谷音乐带回家", "summary", ["记录一种自然声音", "尝试用动作表现", "下节课与同学分享"])
    ]
  }
  const courseVariants = [
    { id: "singing", outline: singingOutline, expectedMediaPlaceholders: 0 },
    { id: "appreciation-no-lyrics", outline: appreciationOutline, expectedMediaPlaceholders: 0 },
    { id: "rhythm-no-lyrics-or-score", outline: rhythmOutline, expectedMediaPlaceholders: 0 },
    { id: "long-15-pages", outline: longOutline, expectedMediaPlaceholders: 0 }
  ]
  const preferences = { lessonMinutes: 40, minPages: 9, maxPages: 15, assetStyle: "illustration", sourceImagePolicy: "balanced", requireAudio: false, requireVideo: false, enableAnimations: true }
  const results = []
  const testAudio = index => ({ resourceId: `audio-${index}`, resourceType: "SONG", name: `测试音频${index}`, verified: true, contentUrl: `https://example.com/test-${index}.mp3` })
  const scoreImage = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
  // 此处是契约测试夹具，不是实际教材证据或媒体可播放性认证。
  const completeFixture = source => {
    const outline = structuredClone(source)
    outline.textbookResearch = { exactMatch: true, confidence: "HIGH", sources: [{ url: "https://example.com/test-textbook" }], teachingObjectives: ["用声音表现变化"] }
    outline.pages.forEach((item, index) => {
      item.durationMinutes = Math.floor(40 / outline.pages.length) + (index < 40 % outline.pages.length ? 1 : 0)
      item.teachingPurpose = "用声音表现变化"
      item.learningEvidence = "学生能用声音表现一种变化并说明理由"
      item.classroomAction = { teacherInstruction: "示范声音变化，邀请学生模仿并说明理由", studentTask: item.studentContent?.headline || item.title }
      item.speakerNotes = "示范后留出练习时间，根据学生表现调整难度。"
      item.objectiveIds = ["1"]
      if (/listen|phrase_sing|expressive_sing/.test(item.type)) item.resourceBindings = /compare/.test(item.type) ? [testAudio(1), testAudio(2)] : [testAudio(1)]
      if (item.type === "melody_score") item.resourceBindings = [{ resourceId: "test-score", resourceType: "MUSIC", verified: true, dedicatedPage: true, scoreImageUrl: scoreImage }]
      if (item.type === "practice_check") item.interaction = { type: "choice", question: "哪一种声音更轻？", options: ["轻声哼唱", "大声呼喊"], answer: "轻声哼唱", explanation: "比较相同距离下声音的强弱。" }
    })
    return outline
  }

  for (const template of AI_COURSEWARE_TEMPLATES) {
    for (const variant of courseVariants) {
      const outline = { ...completeFixture(variant.outline), templateId: template.id }
      const converted = aiCoursewareToSlides(outline, { templateId: template.id, enableAnimations: true })
      const report = inspectAiPptQuality(outline, converted.slides, preferences)
      const master = getAiCoursewareTemplateMaster(template.id)
      const coverMasterPage = getTemplateMasterPage(master, "cover")
      const backgrounds = new Set(converted.slides.map(slide => slide.background?.color || slide.background?.image || ""))
      const expectedBackgrounds = new Set(master.pages.flatMap(item => item.backgroundImages?.length ? item.backgroundImages : [item.backgroundImage || item.background]))
      const unknownBackgrounds = [...backgrounds].filter(item => !expectedBackgrounds.has(item))
      const missingBackgroundFiles = [...expectedBackgrounds]
        .filter(item => item.startsWith("/"))
        .filter(item => !existsSync(resolve("public", item.replace(/^\//, ""))))
      const layoutMismatchCount = outline.pages.filter((page, index) => {
        const layout = resolveTemplatePageLayout(resolveAiPptLayout(page, index))
        const expectedPage = master.pages.find(item => item.layout === layout)
        const expectedBackgroundsForPage = expectedPage?.backgroundImages?.length
          ? expectedPage.backgroundImages
          : expectedPage ? [expectedPage.backgroundImage || expectedPage.background] : []
        const actualBackground = converted.slides[index]?.background?.color || converted.slides[index]?.background?.image || ""
        return expectedBackgroundsForPage.length > 0 && !expectedBackgroundsForPage.includes(actualBackground)
      }).length
      const mediaPlaceholderPages = converted.slides
        .map((slide, index) => ({
          pageNo: index + 1,
          found: slide.elements.some(element => {
            const content = element.type === "text" ? element.content : element.type === "shape" && element.text ? element.text.content : ""
            return String(content).includes("本页需要课堂音视频")
          })
        }))
        .filter(item => item.found)
        .map(item => item.pageNo)
      const emptyRemarkPages = converted.slides
        .map((slide, index) => ({ pageNo: index + 1, empty: index > 0 && !String(slide.remark || "").trim() }))
        .filter(item => item.empty)
        .map(item => item.pageNo)
      const missingVisibleContent = missingStudentTexts(outline, converted.slides)
      results.push({
        scenario: variant.id,
        expectedSlideCount: outline.pages.length,
        templateId: template.id,
        slideCount: converted.slides.length,
        masterPageCount: master.pages.length,
        coverMaster: getTemplateMasterPage(master, "cover").id,
        contentMaster: getTemplateMasterPage(master, "content").id,
        emptySlides: converted.slides.filter(slide => !slide.elements.length).length,
        contractPageCount: master.pages.filter(page => page.safeArea && page.reservedZones).length,
        coverVisualContractValid: coverMasterPage.backgroundVisual
          ? coverMasterPage.slots.find(slot => slot.kind === "image")?.enabled === false
          : coverMasterPage.slots.find(slot => slot.kind === "image")?.enabled !== false,
        layoutMismatchCount,
        expectedMediaPlaceholders: variant.expectedMediaPlaceholders,
        mediaPlaceholderPages,
        emptyRemarkPages,
        missingVisibleContent,
        unknownBackgrounds,
        missingBackgroundFiles,
        errors: report.errors,
        warnings: report.warnings
      })
    }
  }

  const failures = results.flatMap(result => {
    const messages = []
    if (result.slideCount !== result.expectedSlideCount) messages.push(`页数不一致：${result.slideCount}`)
    if (result.masterPageCount < 10) messages.push(`母版页型不足：${result.masterPageCount}`)
    if (result.emptySlides) messages.push(`空白页：${result.emptySlides}`)
    if (result.contractPageCount !== result.masterPageCount) messages.push(`空间契约缺失：${result.contractPageCount}/${result.masterPageCount}`)
    if (!result.coverVisualContractValid) messages.push("封面背景类型与图片槽契约不一致")
    if (result.layoutMismatchCount) messages.push(`视觉布局匹配错误：${result.layoutMismatchCount}`)
    if (result.mediaPlaceholderPages.length !== result.expectedMediaPlaceholders) messages.push(`媒体占位页不符合预期：${result.mediaPlaceholderPages.join("、") || "无"}`)
    if (result.emptyRemarkPages.length) messages.push(`教师备注为空：${result.emptyRemarkPages.join("、")}`)
    if (result.missingVisibleContent.length) messages.push(`学生内容未渲染：${result.missingVisibleContent.map(item => `P${item.pageNo} ${item.text}`).join("、")}`)
    if (result.unknownBackgrounds.length) messages.push(`未应用母版背景：${result.unknownBackgrounds.join(",")}`)
    if (result.missingBackgroundFiles.length) messages.push(`母版背景文件缺失：${result.missingBackgroundFiles.join(",")}`)
    if (result.errors.length) messages.push(...result.errors.map(item => `P${item.pageNo || "-"} ${item.code}: ${item.message}`))
    return messages.map(message => `${result.templateId}/${result.scenario}: ${message}`)
  })

  const valid = { ...completeFixture(rhythmOutline), templateId: "ethnic-flower" }
  const render = value => aiCoursewareToSlides(value).slides
  const codes = value => inspectAiPptQuality(value, render(value), preferences).errors.map(issue => issue.code)
  const noResearch = structuredClone(valid)
  noResearch.textbookResearch.exactMatch = false
  assert(codes(noResearch).includes("textbook_evidence"))
  const missingAudio = structuredClone(valid)
  missingAudio.pages[4].resourceBindings = []
  assert(!codes(missingAudio).includes("missing_page_audio"))
  assert(inspectAiPptQuality(missingAudio, render(missingAudio), preferences).warnings.some(issue => issue.code === "missing_page_audio"))
  assert(render(missingAudio)[4].remark.includes("补充对应音频"))
  assert(!JSON.stringify(render(missingAudio)).includes("请老师在此补充"))
  const noScore = { ...completeFixture(singingOutline), templateId: "ethnic-flower" }
  noScore.pages[7].resourceBindings = []
  assert(!codes(noScore).includes("missing_score"), '缺少谱例不再阻止课件交付')
  assert(inspectAiPptQuality(noScore, render(noScore), preferences).warnings.some(issue => issue.code === 'missing_score'))
  assert(render(noScore)[7].elements.some(element => elementText(element).includes('向上表示声音变高')), '缺谱仍保留完整教学内容')
  assert.equal(render(noScore)[7].elements.filter(element => element.type === "line").length, 0, "缺谱不得绘制假五线谱")
  noScore.pages[7].resourceBindings = [{ resourceType: "MUSIC", resourceId: "verified-score", verified: true, dedicatedPage: true }]
  assert(render(noScore)[7].elements.some(element => element.subtype === "elf-sing-play" && element.sid === "verified-score"))
  const exercise = render(valid)[7]
  assert(exercise.elements.some(element => elementText(element).includes("哪一种声音更轻？")))
  assert(exercise.elements.some(element => elementText(element).includes("大声呼喊")))
  assert(exercise.remark.includes("参考答案：轻声哼唱") && exercise.remark.includes("比较相同距离"))
  const lost = render(valid)
  lost[7].elements = lost[7].elements.filter(element => !elementText(element).includes("哪一种声音更轻？"))
  assert(inspectAiPptQuality(valid, lost, preferences).errors.some(issue => issue.code === "missing_content"))
  const overtime = structuredClone(valid)
  overtime.pages[0].durationMinutes += 10
  assert(codes(overtime).includes("lesson_duration"))
  const dense = structuredClone(valid)
  dense.pages[3].studentContent.points = Array.from({length: 24}, (_, index) => `第${index + 1}条超长课堂说明，不应无限缩小字号塞进页面`)
  assert(codes(dense).some(code => ["text_overflow", "text_overlap", "out_of_bounds"].includes(code)))
  const compareAudio = render(valid)[4].elements.filter(element => element.subtype === "elf-audio")
  assert.equal(compareAudio.length, 2)
  assert(compareAudio.every(element => !element.autoplay))
  const editedCover = structuredClone(valid)
  editedCover.pages[0].title = "老师修改后的封面标题"
  assert(render(editedCover)[0].elements.some(element => elementText(element).includes("老师修改后的封面标题")))
  const noObjectives = structuredClone(valid)
  noObjectives.pages.forEach(page => page.objectiveIds = [])
  assert(codes(noObjectives).includes("objective_coverage"))
  const withVideo = structuredClone(valid)
  withVideo.pages[7].resourceBindings = [{resourceType:"VIDEO",resourceId:"test-video",contentUrl:"https://example.com/test.mp4",verified:true}]
  assert(render(withVideo)[7].elements.some(element => element.subtype === "elf-video"))
  const { getAiPptImageAspectRatios } = await vite.ssrLoadModule("/src/utils/aiPptTemplateEngine.ts")
  for (const template of AI_COURSEWARE_TEMPLATES) {
    const illustrated = structuredClone(valid)
    illustrated.templateId = template.id
    const target = illustrated.pages[7]
    target.visualPlan = { layout: "text_focus", imagePurpose: "observation", imageFit: "contain" }
    target.image = { url: "https://example.com/whole-instrument.png", width: 1800, height: 600, provider: "TEST", reviewStatus: "verified" }
    target.requiredVisual = true
    const slides = render(illustrated)
    const image = slides[7].elements.find(element => element.type === "image" && element.src === target.image.url)
    assert(image, `${template.id}: 观察题必须显示教学图片`)
    assert.equal(image.clip, undefined, `${template.id}: 不裁掉教学主体`)
    assert(Math.abs(image.width / image.height - 3) < 0.001, `${template.id}: 不拉伸教学图片`)
    assert(slides[7].elements.some(element => elementText(element).includes(target.interaction.question)))
    assert(!inspectAiPptQuality(illustrated, slides, preferences).errors.some(issue => ["missing_visual_render", "out_of_bounds", "text_overlap"].includes(issue.code)))
    const ratios = getAiPptImageAspectRatios(template.id)
    assert(ratios.split_content > 0 && ratios["split_content:media"] > 0)
    const imageSlot = getTemplateMasterPage(getAiCoursewareTemplateMaster(template.id), "content", "split_content").slots.find(slot => slot.kind === "image" && slot.enabled !== false)
    assert.equal(ratios["split_content:media"], imageSlot.width / imageSlot.height)
    if (template.id === "dark-lute") {
      const body = slides[7].elements.find(element => elementText(element).includes(target.interaction.question))
      assert.equal(body.defaultColor, "#F7F6F1", "深色背景上的正文必须保持可读")
    }
  }
  const unreviewed = structuredClone(valid)
  unreviewed.pages[1].image = { url: "https://example.com/scene.png", provider: "TEST", reviewStatus: "unverified" }
  assert(inspectAiPptQuality(unreviewed, render(unreviewed), preferences).warnings.some(issue => issue.code === "image_review"))
  const classroom = classroomFixture(scoreImage)
  const classroomSlides = render(classroom)
  assert.equal(resolveAiPptLayout(classroom.pages[0], 0), "cover_scene", "requiredVisual 不能把封面改成分栏")
  assert(new Set(classroom.pages.map(resolveAiPptLayout)).size >= 6, "统一 split 的历史大纲应恢复不同教学版式")
  for (const index of [0, 10, 11]) {
    assert(!classroomSlides[index].elements.map(elementText).join(" ").includes(classroom.pages[index].classroomAction.studentTask), "教案表述不得进入学生画面")
    assert(classroomSlides[index].remark.includes(classroom.pages[index].classroomAction.studentTask), "移出的教师说明必须保留在备注")
  }
  assert(classroomSlides[6].elements.some(element => element.type === "text" && element.width > 1200), "无图听唱页应使用宽版正文")
  assert(classroomSlides[9].elements.some(element => element.type === "text" && element.width > 1200), "无图检测页不得保留半页空白")
  const classroomReport = inspectAiPptQuality(classroom, classroomSlides)
  assert(!classroomReport.errors.some(issue => ["out_of_bounds", "text_overlap", "text_overflow", "rendered_text_geometry", "missing_content", "small_font"].includes(issue.code)), JSON.stringify(classroomReport.errors))
  assert.equal(classroomReport.issues.filter(issue => issue.code === "missing_required_visual").length, 6)
  assert(classroomReport.issues.filter(issue => issue.code === "missing_required_visual").every(issue => /重新生成|补充/.test(issue.message) && !/模型说明|评分|mustInclude/.test(issue.message)))
  // 配图不能迫使对比、活动、总结、目标页统一分栏，也不能在保留版式后丢图。
  for (const layout of ["compare", "activity", "summary", "objectives"]) {
    for (const template of AI_COURSEWARE_TEMPLATES) {
      const sample = structuredClone(valid)
      sample.templateId = template.id
      sample.pages[1] = page(2, "content", "观察并完成任务", layout, ["找一找主体", "说说变化"], {
        image: { url: scoreImage, width: 960, height: 720 }, requiredVisual: true,
        visualPlan: { layout, imagePurpose: "observation" }
      })
      const sampleSlides = render(sample)
      assert.equal(resolveAiPptLayout(sample.pages[1], 1), layout)
      assert(sampleSlides[1].elements.some(element => element.type === "image"), `${template.id}/${layout} 丢失配图`)
      assert(!inspectAiPptQuality(sample, sampleSlides).errors.some(issue => issue.pageNo === 2 && ["out_of_bounds", "text_overlap", "text_overflow", "rendered_text_geometry", "missing_content"].includes(issue.code)))
    }
  }
  const { PAGE_COMPOSITIONS, compilePageDesign } = await vite.ssrLoadModule('/src/utils/aiPptPageDesign.ts')
  let modelDesignChecks = 0
  const geometry = slide => slide.elements.filter(el => ['text', 'image', 'shape'].includes(el.type)).map(el => [el.type, el.left, el.top, el.width, el.height])
  const modelFixture = modelDesignFixture(scoreImage)
  const modelSlides = render(modelFixture)
  const modelReport = inspectAiPptQuality(modelFixture, modelSlides)
  assert(!modelReport.errors.some(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code)), JSON.stringify(modelReport.errors))
  assert(!modelReport.issues.some(issue => ['missing_required_visual', 'generated_focal_visual', 'rendered_layout_repeat'].includes(issue.code)), JSON.stringify(modelReport.issues))
  assert(new Set(modelSlides.map(slide => JSON.stringify(geometry(slide)))).size >= 8, '模型设计应实际产生不同坐标与内容组织')
  for (const template of AI_COURSEWARE_TEMPLATES) {
    for (const composition of PAGE_COMPOSITIONS) {
      for (const visualShare of [.35, .7]) {
        for (const textPresentation of ['plain', 'cards', 'steps', 'grid']) {
          for (const illustrated of [true, false]) {
            const sample = structuredClone(modelFixture)
            sample.templateId = template.id
            const target = sample.pages[1] = page(2, 'scene_intro', '观察角色的动作', 'split_content', ['找一找主体', '说说变化'], {
              studentContent: { headline: '它在做什么？', points: ['找一找主体', '说说变化'] },
              image: illustrated ? { url: scoreImage, width: 960, height: 720 } : undefined,
              requiredVisual: false, visualPlan: { composition, visualShare, textPresentation, visualMode: illustrated ? 'generated_image' : 'native_diagram', imagePurpose: illustrated ? 'observation' : 'none' }
            })
            const slides = render(sample)
            const errors = inspectAiPptQuality(sample, slides).errors.filter(issue => issue.pageNo === 2 && ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code))
            assert.equal(errors.length, 0, `${template.id}/${composition}/${visualShare}/${textPresentation}/${illustrated}: ${JSON.stringify(errors)}`)
            assert.equal(slides[1].elements.some(el => el.type === 'image'), illustrated)
            const text = slides[1].elements.map(elementText).join(' ')
            assert(['它在做什么？', ...target.studentContent.points].every(value => text.includes(value)), '新构图不能遗漏任务和正文')
            modelDesignChecks++
          }
        }
      }
    }
    assert.equal(getAiPptImageAspectRatios(template.id).model_design_v1, 1)
  }
  const positioned = structuredClone(modelFixture)
  positioned.pages[1].visualPlan.composition = 'image_left'
  const leftImage = render(positioned)[1].elements.find(el => el.type === 'image')
  positioned.pages[1].visualPlan.composition = 'image_right'
  const rightImage = render(positioned)[1].elements.find(el => el.type === 'image')
  assert(rightImage.left > leftImage.left, '模型选择图右必须改变图片实际位置')
  const ratioPage = { title: '观察', visualPlan: { composition: 'image_left', visualMode: 'generated_image', visualShare: .63 } }
  const ratioSlot = compilePageDesign(ratioPage, 1, getAiCoursewareTemplateMaster('blank'), false, true, false).slots.find(slot => slot.kind === 'image')
  assert.equal(ratioSlot.width / ratioSlot.height, (1440 - 36) * .65 / 640, '前后端主视觉宽高比约定保持一致')
  const missingPlannedImage = structuredClone(modelFixture)
  missingPlannedImage.pages[1].image = undefined
  missingPlannedImage.pages[1].imageStatus = 'budget_exhausted'
  assert(inspectAiPptQuality(missingPlannedImage, render(missingPlannedImage)).issues.some(issue => issue.pageNo === 2 && issue.message.includes('单独重新生成')))
  const repeatedSlides = structuredClone(modelSlides)
  repeatedSlides[2] = structuredClone(modelSlides[1])
  repeatedSlides[3] = structuredClone(modelSlides[1])
  assert(inspectAiPptQuality(modelFixture, repeatedSlides).issues.some(issue => issue.code === 'rendered_layout_repeat'), '版式名不同但坐标相同也应被检测到')
  const semantic = semanticDesignFixture(scoreImage)
  const semanticSlides = render(semantic)
  const semanticErrors = inspectAiPptQuality(semantic, semanticSlides).errors.filter(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code))
  assert.deepEqual(semanticErrors, [], JSON.stringify(semanticErrors))
  for (const template of AI_COURSEWARE_TEMPLATES) {
    const check = structuredClone(semantic)
    check.templateId = template.id
    const errors = inspectAiPptQuality(check, render(check)).errors.filter(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code))
    assert.deepEqual(errors, [], `${template.id}: ${JSON.stringify(errors)}`)
  }
  const illustratedGroups = structuredClone(semantic)
  Object.assign(illustratedGroups.pages[4], { image: { url: scoreImage, width: 960, height: 720 } })
  illustratedGroups.pages[4].visualPlan.visualMode = 'generated_image'
  illustratedGroups.pages[4].studentContent.comparisonGroups[0].points.push('用手势表现变化')
  illustratedGroups.pages[4].studentContent.comparisonGroups[1].points.push('试着模仿它的声音')
  const illustratedErrors = inspectAiPptQuality(illustratedGroups, render(illustratedGroups)).errors.filter(issue => issue.pageNo === 5 && ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code))
  assert.deepEqual(illustratedErrors, [], '图文对比必须为组名、正文和公共提示预留高度')
  const textElement = (i, text) => semanticSlides[i].elements.find(el => elementText(el).includes(text))
  assert(textElement(3, '风的声音').left < textElement(3, '老虎的声音').left, '两种对比对象必须各在一侧')
  assert.equal(semanticSlides[5].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 4, '四个真实任务不能混入引导标题变成五步')
  assert.equal(semanticSlides[7].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 2, '结构化步骤只编号两步')
  assert(!semanticSlides[7].elements.map(elementText).join(' ').includes('旧正文'), '结构化内容不回退到旧bullets')
  assert(semanticSlides[6].elements.filter(el => ['X', 'XX', '-'].includes(elementText(el))).length >= 8, '已有节奏必须产生可编辑符号')
  assert(semanticSlides[5].elements.filter(el => el.type === 'shape' && el.width > 200).every(el => el.height < 230), '短任务卡片不应占据整页高度')
  assert(textElement(0, '凤鸣山谷的故事').top >= 200, '缺主图封面重新组织标题位置')
  const { modelPageContent } = await vite.ssrLoadModule('/src/utils/aiPptContent.ts')
  const invalidGroups = structuredClone(semantic.pages[4])
  invalidGroups.studentContent.comparisonGroups.push({ label: '第三组', points: ['第三组的完整内容'] })
  assert(modelPageContent(invalidGroups).points.includes('第三组的完整内容'), '异常分组不能丢失正文')
  const density = densityRegressionFixture(scoreImage)
  const densitySlides = render(density)
  assert.deepEqual(inspectAiPptQuality(density, densitySlides).errors.filter(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code)), [])
  assert.equal(densitySlides[8].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 3, '新语义字段不得丢失为单个引导标题')
  const brokenDensity = structuredClone(densitySlides)
  brokenDensity[4].elements.filter(el => el.type === 'text' && density.pages[4].studentContent.points.some(point => elementText(el).includes(point))).forEach((el, i) => { el.top = 783.915 + i * 55.6875; el.height = 41.1075 })
  assert(inspectAiPptQuality(density, brokenDensity).errors.some(issue => issue.pageNo === 5 && issue.code === 'rendered_text_geometry'), '必须拦截之前坐标检查漏掉的真实高度溢出')
  const heroImages = heroImageRegressionFixture(scoreImage)
  const heroSlides = render(heroImages)
  for (const index of [0, 1, 11]) {
    const image = heroSlides[index].elements.find(el => el.type === 'image' && el.src === scoreImage)
    assert(image.width * image.height / (1920 * 1080) >= .24, `第 ${index + 1} 页主图不能退化成小横幅`)
    assert(Math.abs(image.width / image.height - 1584 / 560) < .001 && !image.clip, '主图保留完整比例，不裁切角色')
    const captions = heroImages.pages[index].studentContent.points.map(text => heroSlides[index].elements.find(el => elementText(el) === text))
    assert(captions.every(el => el && el.top === captions[0].top && el.top >= image.top + image.height), '短提示完整横排在主图下方')
  }
  assert.deepEqual(inspectAiPptQuality(heroImages, heroSlides).errors.filter(issue => ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font'].includes(issue.code)), [])
  const longCaption = structuredClone(heroImages)
  longCaption.pages[1].studentContent.points[0] = '请仔细观察山谷里的溪水、树木与远山，再和身边的小伙伴一起讨论不同声音的变化以及自己最喜欢的声音，并用动作向大家展示你的发现。'
  const longCaptionSlides = render(longCaption)
  const longText = longCaptionSlides[1].elements.find(el => elementText(el) === longCaption.pages[1].studentContent.points[0])
  assert(longText.width > 1000, '长内容保留整行，不硬塞进三列短提示')
  const { aiPptEntryChanged } = await vite.ssrLoadModule('/src/utils/aiPptClientVersion.ts')
  const html = '<script type="module" crossorigin src="./assets/index-new.js"></script>'
  assert(aiPptEntryChanged(html, 'https://example.com/classroom-ppt/', './assets/index-old.js'))
  assert(!aiPptEntryChanged(html, 'https://example.com/classroom-ppt/', 'https://example.com/classroom-ppt/assets/index-new.js'))
  assert(!aiPptEntryChanged('<html>login</html>', 'https://example.com/', './assets/index-old.js'))
  console.log(JSON.stringify({ passed: failures.length === 0, scenarioCount: results.length, contractChecks: 13, imageTemplateChecks: AI_COURSEWARE_TEMPLATES.length, modelDesignChecks, semanticDesignChecks: 10, regressionChecks: 17,
    scenarios: courseVariants.map(item => item.id), ...(process.argv.includes("--verbose") ? { results } : {}), failures }, null, 2))
  if (failures.length) process.exitCode = 1
} finally {
  await vite.close()
}