| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482 |
- 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'
- import { contentGateFixture } from './fixtures/aiPptContentGate.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 gateFixture = contentGateFixture(), gateSlides = aiCoursewareToSlides(gateFixture).slides
- const layoutCodes = ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font']
- assert.deepEqual(inspectAiPptQuality(gateFixture, gateSlides).errors.filter(issue => layoutCodes.includes(issue.code)), [], '线上结构回归应完整可读')
- const dots = slide => slide.elements.filter(element => element.type === 'shape' && element.path === 'M100,0 A100,100 0 1,1 99.99,0 Z')
- assert.equal(dots(gateSlides[2]).length, 4, '一拍一声:四拍四个发声点')
- assert.equal(dots(gateSlides[3]).length, 8, '一拍两声:四拍八个发声点')
- const cells = slide => slide.elements.filter(element => element.type === 'shape' && element.width > 200 && element.height > 80 && element.height < 200)
- assert.deepEqual(cells(gateSlides[2]).map(({left,width}) => ({left,width})), cells(gateSlides[3]).map(({left,width}) => ({left,width})), '两页拍格宽度及位置一致')
- assert.equal(gateSlides[5].elements.filter(el => el.type === 'text' && /^[1-9]$/.test(el.content.replace(/<[^>]+>/g, ''))).length, 3, '创编例子不编号成第四个步骤')
- const leaked = structuredClone(gateFixture)
- leaked.pages[6].interaction.question += '(第一次更响)'
- assert(inspectAiPptQuality(leaked, aiCoursewareToSlides(leaked).slides).errors.some(issue => issue.code === 'answer_leak'))
- assert(!inspectAiPptQuality(gateFixture, gateSlides).errors.some(issue => issue.code === 'answer_leak'), '正确答案作为候选项不算泄露')
- const { teachingReviewIssues } = await vite.ssrLoadModule('/src/utils/aiPptFeedback.ts')
- const reviewItems = teachingReviewIssues('第5页:缺少studentContent.example;第10页:题干泄露答案;整课一致性复核暂未完成')
- assert.deepEqual(reviewItems.map(issue => issue.pageNo), [5, 10, undefined])
- assert(reviewItems.every(issue => issue.severity === 'error') && reviewItems[0].message.includes('学生可见范例'))
- 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: ['第三组的完整内容'] })
- invalidGroups.studentContent.comparisonGroups.push({ label: '第四组', points: ['第四组的完整内容'] }, { 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()
- }
|