aiPptSelfTest.mjs 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482
  1. import { createServer } from "vite"
  2. import { existsSync } from "node:fs"
  3. import { resolve } from "node:path"
  4. import assert from "node:assert/strict"
  5. import { classroomFixture } from "./fixtures/aiPptClassroom.mjs"
  6. import { semanticDesignFixture, densityRegressionFixture, heroImageRegressionFixture } from "./fixtures/aiPptSemanticDesign.mjs"
  7. import { modelDesignFixture } from "./fixtures/aiPptModelDesign.mjs"
  8. import { inquiryFixture } from './fixtures/aiPptInquiry.mjs'
  9. import { lessonRepairFixture } from './fixtures/aiPptLessonRepair.mjs'
  10. import { contentGateFixture } from './fixtures/aiPptContentGate.mjs'
  11. const vite = await createServer({ server: { middlewareMode: true }, appType: "custom", logLevel: "error" })
  12. try {
  13. const { aiCoursewareToSlides } = await vite.ssrLoadModule("/src/utils/aiCoursewareToSlides.ts")
  14. const { inspectAiPptQuality } = await vite.ssrLoadModule("/src/utils/aiPptQuality.ts")
  15. const gateFixture = contentGateFixture(), gateSlides = aiCoursewareToSlides(gateFixture).slides
  16. const layoutCodes = ['out_of_bounds', 'text_overlap', 'text_overflow', 'rendered_text_geometry', 'missing_content', 'small_font']
  17. assert.deepEqual(inspectAiPptQuality(gateFixture, gateSlides).errors.filter(issue => layoutCodes.includes(issue.code)), [], '线上结构回归应完整可读')
  18. const dots = slide => slide.elements.filter(element => element.type === 'shape' && element.path === 'M100,0 A100,100 0 1,1 99.99,0 Z')
  19. assert.equal(dots(gateSlides[2]).length, 4, '一拍一声:四拍四个发声点')
  20. assert.equal(dots(gateSlides[3]).length, 8, '一拍两声:四拍八个发声点')
  21. const cells = slide => slide.elements.filter(element => element.type === 'shape' && element.width > 200 && element.height > 80 && element.height < 200)
  22. assert.deepEqual(cells(gateSlides[2]).map(({left,width}) => ({left,width})), cells(gateSlides[3]).map(({left,width}) => ({left,width})), '两页拍格宽度及位置一致')
  23. assert.equal(gateSlides[5].elements.filter(el => el.type === 'text' && /^[1-9]$/.test(el.content.replace(/<[^>]+>/g, ''))).length, 3, '创编例子不编号成第四个步骤')
  24. const leaked = structuredClone(gateFixture)
  25. leaked.pages[6].interaction.question += '(第一次更响)'
  26. assert(inspectAiPptQuality(leaked, aiCoursewareToSlides(leaked).slides).errors.some(issue => issue.code === 'answer_leak'))
  27. assert(!inspectAiPptQuality(gateFixture, gateSlides).errors.some(issue => issue.code === 'answer_leak'), '正确答案作为候选项不算泄露')
  28. const { teachingReviewIssues } = await vite.ssrLoadModule('/src/utils/aiPptFeedback.ts')
  29. const reviewItems = teachingReviewIssues('第5页:缺少studentContent.example;第10页:题干泄露答案;整课一致性复核暂未完成')
  30. assert.deepEqual(reviewItems.map(issue => issue.pageNo), [5, 10, undefined])
  31. assert(reviewItems.every(issue => issue.severity === 'error') && reviewItems[0].message.includes('学生可见范例'))
  32. const inquiry = inquiryFixture()
  33. const inquiryResult = aiCoursewareToSlides(inquiry)
  34. const inquiryReport = inspectAiPptQuality(inquiry, inquiryResult.slides, {
  35. lessonMinutes: 40, minPages: 9, maxPages: 15, resourceMode: 'teacher_supplement', requireAudio: true, requireVideo: true
  36. })
  37. assert.deepEqual(inquiryReport.errors, [], `无媒体教学样例:${JSON.stringify(inquiryReport.errors)}`)
  38. assert(inquiryResult.slides.every(slide => slide.background.color === '#FAF8F2'), '默认模板必须采用整课主题色')
  39. assert(inquiryResult.slides.every(slide => !slide.elements.some(element => element.type === 'elf')), '媒体由教师补充时不生成空播放器或谱例')
  40. assert(inquiryResult.slides[3].elements.filter(element => element.type === 'shape').length >= 4, '强弱图须绘制为可编辑圆形')
  41. assert(inquiryResult.slides[5].remark.includes('教学示范:') && inquiryResult.slides[5].remark.includes('判断标准:'), '示范与反馈必须进入备注')
  42. const { AI_COURSEWARE_TEMPLATES } = await vite.ssrLoadModule("/src/config/aiCoursewareTemplates.ts")
  43. const { getAiCoursewareTemplateMaster, getTemplateMasterPage, resolveTemplatePageLayout } = await vite.ssrLoadModule("/src/config/aiCoursewareTemplateMasters.ts")
  44. const { resolveAiPptLayout } = await vite.ssrLoadModule("/src/utils/aiPptTemplateEngine.ts")
  45. const page = (pageNo, type, title, layout, points, extra = {}) => ({
  46. pageNo,
  47. type,
  48. title,
  49. bullets: points,
  50. studentContent: { points },
  51. imageKeywords: [],
  52. visualPlan: { layout, visualDensity: "medium" },
  53. ...extra
  54. })
  55. const elementText = element => {
  56. const content = element.type === "text" ? element.content : element.type === "shape" && element.text ? element.text.content : ""
  57. return String(content || "").replace(/<[^>]+>/g, "")
  58. }
  59. const missingStudentTexts = (outline, slides) =>
  60. outline.pages.flatMap((item, index) => {
  61. const expected = [item.studentContent?.headline, ...(item.studentContent?.points || item.bullets || [])].filter(Boolean)
  62. const rendered = (slides[index]?.elements || []).map(elementText).join("\n")
  63. return expected.filter(text => !rendered.includes(text)).map(text => ({ pageNo: item.pageNo, text }))
  64. })
  65. const repairFixture = lessonRepairFixture(inquiry.pages[0].image.url)
  66. const repaired = aiCoursewareToSlides(repairFixture, { enableAnimations: true }).slides
  67. 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)), [])
  68. const repairedCoverImage = repaired[0].elements.find(el => el.type === 'image')
  69. assert(repairedCoverImage.width * repairedCoverImage.height / (1920 * 1080) >= .2, '真实封面结构不得把主图压成小横幅')
  70. const durationBars = repaired[2].elements.filter(el => el.type === 'shape')
  71. assert.equal(durationBars.length, 4, '每个短音独立呈现')
  72. assert(Math.abs(durationBars[0].width / durationBars[1].width - 2) < .01, '时值条严格使用提供的2:1比例')
  73. const pitchLabels = ['do', 're', 'mi'].map(label => repaired[3].elements.find(el => elementText(el) === label))
  74. assert(pitchLabels[0].top > pitchLabels[1].top && pitchLabels[1].top > pitchLabels[2].top, '相对音高逐级升高,不能只是水平流程')
  75. assert(repaired[3].remark.includes('不表示频率'), '图示依据保留在教师备注')
  76. assert(repaired[5].remark.includes('do → re → mi') && !repaired[5].elements.map(elementText).join('').includes('do → re → mi'), '答案仅供教师查看')
  77. for (const slide of repaired) {
  78. assert.equal(slide.animations.length, slide.elements.length, '标题、正文、形状和线条作为整体呈现')
  79. assert.equal(slide.animations[0].trigger, 'auto')
  80. assert(slide.animations.slice(1).every(animation => animation.trigger === 'meantime'), '不按文本元素顺序拆散教学图示')
  81. }
  82. const { imagePreparationMessage, teacherReviewMessage } = await vite.ssrLoadModule('/src/utils/aiPptFeedback.ts')
  83. assert(!imagePreparationMessage({ imageStatus: 'review_rejected', imageReview: '评分45低于65,mustInclude缺失,模型说明...' }).includes('评分'))
  84. assert(teacherReviewMessage('第6页请补充studentContent.steps').includes('学生操作步骤'))
  85. const singingOutline = {
  86. title: "凤鸣山谷的故事",
  87. gradeName: "一年级",
  88. textbookName: "音乐一年级上册",
  89. unitName: "第一单元 奇妙的声音世界",
  90. chapterName: "凤鸣山谷的故事",
  91. courseType: "music",
  92. style: "cartoon",
  93. pages: [
  94. page(1, "cover", "凤鸣山谷的故事", "cover_scene", ["聆听自然的声音", "发现音乐的强弱变化", "用声音和乐器讲故事"], { image: { url: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=" } }),
  95. page(2, "scene_intro", "山谷里传来了什么声音?", "story_stage", ["观察画面", "想一想……"], { interaction: { type: "question", question: "你觉得是谁在歌唱?", options: ["小鸟", "溪水", "风声"] } }),
  96. page(3, "objectives", "今天我们要学会", "goal_cards", ["分辨声音的高低", "感受音乐的强弱", "合作完成声音表演"]),
  97. page(4, "work_context", "走进凤鸣山谷", "split_image", ["清晨的山谷十分安静", "鸟鸣由远处慢慢靠近", "溪水一直轻轻流淌"]),
  98. page(5, "first_listen", "第一次完整聆听", "listen_wave", ["安静听完音乐", "用手势表示声音的远近", "记住最喜欢的声音"], { resourceBindings: [{ resourceId: "song-demo", resourceType: "SONG", name: "凤鸣山谷", contentUrl: "https://example.com/fengming.mp3", verified: true }] }),
  99. page(6, "lyric_read", "读一读山谷歌谣", "lyric_focus", ["小鸟唱得清脆", "溪水流得轻柔", "山风吹得悠长"]),
  100. page(7, "rhythm_practice", "跟着节奏拍一拍", "rhythm_grid", ["小鸟:短短拍", "溪水:连续拍", "山风:长长拍"], {
  101. studentContent: { headline: "跟着节奏拍一拍", points: ["小鸟:短短拍", "溪水:连续拍", "山风:长长拍"] },
  102. activity: { task: "教师示范不同节奏,引导学生模仿", steps: ["选择一种声音", "先慢速练习", "听指挥加入合奏"] }
  103. }),
  104. page(8, "melody_score", "旋律是怎样行走的?", "score_focus", ["向上表示声音变高", "向下表示声音变低", "平直表示保持稳定"]),
  105. page(9, "music_knowledge", "认识声音的强与弱", "knowledge_cards", ["强:有力量但不喊叫", "弱:轻柔但保持清楚", "强弱变化让音乐更生动"]),
  106. page(10, "compare_listen", "两段声音有什么不同?", "compare_listen", ["比较速度", "比较力度"], { interaction: { type: "compare", question: "哪一段更像远处的鸟鸣?", options: ["第一段更轻", "第二段更强", "第一段更慢", "第二段更快"] } }),
  107. page(11, "performance_activity", "合作表演山谷音乐会", "performance_stage", ["保持自己的声部", "关注指挥手势", "结束时一起收声"], { activity: { task: "用声音演出山谷从清晨到热闹的变化", steps: ["分成鸟鸣、溪水、山风三组", "商量进入顺序", "完整表演并互相评价"] } }),
  108. page(12, "summary", "我的音乐收获", "summary_checklist", ["我能分辨声音的高低", "我能表现声音的强弱", "我能与同伴合作表演"], { learningEvidence: "用一种声音表现你心中的凤鸣山谷" })
  109. ]
  110. }
  111. const appreciationOutline = {
  112. ...singingOutline,
  113. title: "月光下的琵琶",
  114. chapterName: "月光下的琵琶",
  115. courseType: "appreciation",
  116. style: "clean",
  117. pages: [
  118. page(1, "cover", "月光下的琵琶", "cover_scene", ["感受民族器乐的音色", "用语言描述音乐意境"]),
  119. page(2, "scene_intro", "月夜里传来了什么声音?", "hero_focus", ["观察演奏场景", "猜一猜正在演奏的乐器"]),
  120. page(3, "objectives", "带着三个问题走进音乐", "objectives", ["辨认琵琶音色", "感受速度与力度", "描述音乐意境"]),
  121. page(4, "first_listen", "完整聆听", "media_focus", ["安静聆听", "记录最打动你的片段", "想象音乐中的画面"]),
  122. page(5, "instrument_guide", "认识琵琶", "split_content", ["观察乐器外形", "了解基本演奏姿势", "辨认清脆明亮的音色"]),
  123. page(6, "music_knowledge", "音乐为什么有层次?", "diagram_focus", ["速度由慢到快", "力度由弱到强", "旋律推动情绪变化"]),
  124. page(7, "compare_listen", "两个片段有什么不同?", "compare", ["比较速度", "比较力度", "比较情绪"]),
  125. page(8, "creative_activity", "为音乐选择一幅画", "activity", ["小组交流选择理由", "用音乐要素支持判断", "向全班分享"]),
  126. page(9, "practice_check", "我能听出来", "summary", ["这是琵琶的音色", "这一段速度更快", "这一段力度更强"]),
  127. page(10, "summary", "我的欣赏收获", "text_focus", ["我能辨认琵琶音色", "我能描述速度和力度", "我能说出音乐带来的想象"])
  128. ]
  129. }
  130. const rhythmOutline = {
  131. ...singingOutline,
  132. title: "节奏变变变",
  133. chapterName: "节奏变变变",
  134. courseType: "rhythm",
  135. pages: [
  136. page(1, "cover", "节奏变变变", "cover_scene", ["发现生活中的节奏", "合作完成节奏接龙"]),
  137. page(2, "scene_intro", "哪些声音有规律?", "hero_focus", ["听脚步声", "听拍球声", "发现重复规律"]),
  138. page(3, "objectives", "今天的节奏任务", "objectives", ["稳定保持节拍", "模仿两种节奏型", "完成小组接龙"]),
  139. page(4, "rhythm_practice", "跟着节拍做动作", "diagram_focus", ["拍手", "跺脚", "拍腿"], { activity: { task: "保持稳定节拍", steps: ["看图模仿", "跟随口令", "独立完成"] } }),
  140. page(5, "compare_listen", "两种节奏一样吗?", "compare", ["比较声音长短", "比较疏密", "说出不同之处"]),
  141. page(6, "rhythm_practice", "组合新的节奏", "diagram_focus", ["选择两个节奏型", "按顺序连接", "反复练熟"], { activity: { task: "组合节奏", steps: ["选择", "连接", "练习"] } }),
  142. page(7, "creative_activity", "小组节奏接龙", "activity", ["保持共同速度", "轮到自己再进入", "结束动作要整齐"]),
  143. page(8, "practice_check", "节奏挑战", "summary", ["我能稳定拍击", "我能听出不同节奏", "我能完成接龙"]),
  144. page(9, "summary", "我的节奏收获", "text_focus", ["节拍要稳定", "节奏有长短疏密", "合作要互相倾听"])
  145. ]
  146. }
  147. const longOutline = {
  148. ...singingOutline,
  149. pages: [
  150. ...singingOutline.pages,
  151. page(13, "music_knowledge", "声音还能怎样变化?", "knowledge_cards", ["比较声音长短", "比较声音高低", "比较声音强弱"]),
  152. page(14, "creative_activity", "设计新的山谷回声", "activity", ["选择声音角色", "设计进入顺序", "合作完整展示"]),
  153. page(15, "summary", "把山谷音乐带回家", "summary", ["记录一种自然声音", "尝试用动作表现", "下节课与同学分享"])
  154. ]
  155. }
  156. const courseVariants = [
  157. { id: "singing", outline: singingOutline, expectedMediaPlaceholders: 0 },
  158. { id: "appreciation-no-lyrics", outline: appreciationOutline, expectedMediaPlaceholders: 0 },
  159. { id: "rhythm-no-lyrics-or-score", outline: rhythmOutline, expectedMediaPlaceholders: 0 },
  160. { id: "long-15-pages", outline: longOutline, expectedMediaPlaceholders: 0 }
  161. ]
  162. const preferences = { lessonMinutes: 40, minPages: 9, maxPages: 15, assetStyle: "illustration", sourceImagePolicy: "balanced", requireAudio: false, requireVideo: false, enableAnimations: true }
  163. const results = []
  164. const testAudio = index => ({ resourceId: `audio-${index}`, resourceType: "SONG", name: `测试音频${index}`, verified: true, contentUrl: `https://example.com/test-${index}.mp3` })
  165. const scoreImage = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
  166. // 此处是契约测试夹具,不是实际教材证据或媒体可播放性认证。
  167. const completeFixture = source => {
  168. const outline = structuredClone(source)
  169. outline.textbookResearch = { exactMatch: true, confidence: "HIGH", sources: [{ url: "https://example.com/test-textbook" }], teachingObjectives: ["用声音表现变化"] }
  170. outline.pages.forEach((item, index) => {
  171. item.durationMinutes = Math.floor(40 / outline.pages.length) + (index < 40 % outline.pages.length ? 1 : 0)
  172. item.teachingPurpose = "用声音表现变化"
  173. item.learningEvidence = "学生能用声音表现一种变化并说明理由"
  174. item.classroomAction = { teacherInstruction: "示范声音变化,邀请学生模仿并说明理由", studentTask: item.studentContent?.headline || item.title }
  175. item.speakerNotes = "示范后留出练习时间,根据学生表现调整难度。"
  176. item.objectiveIds = ["1"]
  177. if (/listen|phrase_sing|expressive_sing/.test(item.type)) item.resourceBindings = /compare/.test(item.type) ? [testAudio(1), testAudio(2)] : [testAudio(1)]
  178. if (item.type === "melody_score") item.resourceBindings = [{ resourceId: "test-score", resourceType: "MUSIC", verified: true, dedicatedPage: true, scoreImageUrl: scoreImage }]
  179. if (item.type === "practice_check") item.interaction = { type: "choice", question: "哪一种声音更轻?", options: ["轻声哼唱", "大声呼喊"], answer: "轻声哼唱", explanation: "比较相同距离下声音的强弱。" }
  180. })
  181. return outline
  182. }
  183. for (const template of AI_COURSEWARE_TEMPLATES) {
  184. for (const variant of courseVariants) {
  185. const outline = { ...completeFixture(variant.outline), templateId: template.id }
  186. const converted = aiCoursewareToSlides(outline, { templateId: template.id, enableAnimations: true })
  187. const report = inspectAiPptQuality(outline, converted.slides, preferences)
  188. const master = getAiCoursewareTemplateMaster(template.id)
  189. const coverMasterPage = getTemplateMasterPage(master, "cover")
  190. const backgrounds = new Set(converted.slides.map(slide => slide.background?.color || slide.background?.image || ""))
  191. const expectedBackgrounds = new Set(master.pages.flatMap(item => item.backgroundImages?.length ? item.backgroundImages : [item.backgroundImage || item.background]))
  192. const unknownBackgrounds = [...backgrounds].filter(item => !expectedBackgrounds.has(item))
  193. const missingBackgroundFiles = [...expectedBackgrounds]
  194. .filter(item => item.startsWith("/"))
  195. .filter(item => !existsSync(resolve("public", item.replace(/^\//, ""))))
  196. const layoutMismatchCount = outline.pages.filter((page, index) => {
  197. const layout = resolveTemplatePageLayout(resolveAiPptLayout(page, index))
  198. const expectedPage = master.pages.find(item => item.layout === layout)
  199. const expectedBackgroundsForPage = expectedPage?.backgroundImages?.length
  200. ? expectedPage.backgroundImages
  201. : expectedPage ? [expectedPage.backgroundImage || expectedPage.background] : []
  202. const actualBackground = converted.slides[index]?.background?.color || converted.slides[index]?.background?.image || ""
  203. return expectedBackgroundsForPage.length > 0 && !expectedBackgroundsForPage.includes(actualBackground)
  204. }).length
  205. const mediaPlaceholderPages = converted.slides
  206. .map((slide, index) => ({
  207. pageNo: index + 1,
  208. found: slide.elements.some(element => {
  209. const content = element.type === "text" ? element.content : element.type === "shape" && element.text ? element.text.content : ""
  210. return String(content).includes("本页需要课堂音视频")
  211. })
  212. }))
  213. .filter(item => item.found)
  214. .map(item => item.pageNo)
  215. const emptyRemarkPages = converted.slides
  216. .map((slide, index) => ({ pageNo: index + 1, empty: index > 0 && !String(slide.remark || "").trim() }))
  217. .filter(item => item.empty)
  218. .map(item => item.pageNo)
  219. const missingVisibleContent = missingStudentTexts(outline, converted.slides)
  220. results.push({
  221. scenario: variant.id,
  222. expectedSlideCount: outline.pages.length,
  223. templateId: template.id,
  224. slideCount: converted.slides.length,
  225. masterPageCount: master.pages.length,
  226. coverMaster: getTemplateMasterPage(master, "cover").id,
  227. contentMaster: getTemplateMasterPage(master, "content").id,
  228. emptySlides: converted.slides.filter(slide => !slide.elements.length).length,
  229. contractPageCount: master.pages.filter(page => page.safeArea && page.reservedZones).length,
  230. coverVisualContractValid: coverMasterPage.backgroundVisual
  231. ? coverMasterPage.slots.find(slot => slot.kind === "image")?.enabled === false
  232. : coverMasterPage.slots.find(slot => slot.kind === "image")?.enabled !== false,
  233. layoutMismatchCount,
  234. expectedMediaPlaceholders: variant.expectedMediaPlaceholders,
  235. mediaPlaceholderPages,
  236. emptyRemarkPages,
  237. missingVisibleContent,
  238. unknownBackgrounds,
  239. missingBackgroundFiles,
  240. errors: report.errors,
  241. warnings: report.warnings
  242. })
  243. }
  244. }
  245. const failures = results.flatMap(result => {
  246. const messages = []
  247. if (result.slideCount !== result.expectedSlideCount) messages.push(`页数不一致:${result.slideCount}`)
  248. if (result.masterPageCount < 10) messages.push(`母版页型不足:${result.masterPageCount}`)
  249. if (result.emptySlides) messages.push(`空白页:${result.emptySlides}`)
  250. if (result.contractPageCount !== result.masterPageCount) messages.push(`空间契约缺失:${result.contractPageCount}/${result.masterPageCount}`)
  251. if (!result.coverVisualContractValid) messages.push("封面背景类型与图片槽契约不一致")
  252. if (result.layoutMismatchCount) messages.push(`视觉布局匹配错误:${result.layoutMismatchCount}`)
  253. if (result.mediaPlaceholderPages.length !== result.expectedMediaPlaceholders) messages.push(`媒体占位页不符合预期:${result.mediaPlaceholderPages.join("、") || "无"}`)
  254. if (result.emptyRemarkPages.length) messages.push(`教师备注为空:${result.emptyRemarkPages.join("、")}`)
  255. if (result.missingVisibleContent.length) messages.push(`学生内容未渲染:${result.missingVisibleContent.map(item => `P${item.pageNo} ${item.text}`).join("、")}`)
  256. if (result.unknownBackgrounds.length) messages.push(`未应用母版背景:${result.unknownBackgrounds.join(",")}`)
  257. if (result.missingBackgroundFiles.length) messages.push(`母版背景文件缺失:${result.missingBackgroundFiles.join(",")}`)
  258. if (result.errors.length) messages.push(...result.errors.map(item => `P${item.pageNo || "-"} ${item.code}: ${item.message}`))
  259. return messages.map(message => `${result.templateId}/${result.scenario}: ${message}`)
  260. })
  261. const valid = { ...completeFixture(rhythmOutline), templateId: "ethnic-flower" }
  262. const render = value => aiCoursewareToSlides(value).slides
  263. const codes = value => inspectAiPptQuality(value, render(value), preferences).errors.map(issue => issue.code)
  264. const noResearch = structuredClone(valid)
  265. noResearch.textbookResearch.exactMatch = false
  266. assert(codes(noResearch).includes("textbook_evidence"))
  267. const missingAudio = structuredClone(valid)
  268. missingAudio.pages[4].resourceBindings = []
  269. assert(!codes(missingAudio).includes("missing_page_audio"))
  270. assert(inspectAiPptQuality(missingAudio, render(missingAudio), preferences).warnings.some(issue => issue.code === "missing_page_audio"))
  271. assert(render(missingAudio)[4].remark.includes("补充对应音频"))
  272. assert(!JSON.stringify(render(missingAudio)).includes("请老师在此补充"))
  273. const noScore = { ...completeFixture(singingOutline), templateId: "ethnic-flower" }
  274. noScore.pages[7].resourceBindings = []
  275. assert(!codes(noScore).includes("missing_score"), '缺少谱例不再阻止课件交付')
  276. assert(inspectAiPptQuality(noScore, render(noScore), preferences).warnings.some(issue => issue.code === 'missing_score'))
  277. assert(render(noScore)[7].elements.some(element => elementText(element).includes('向上表示声音变高')), '缺谱仍保留完整教学内容')
  278. assert.equal(render(noScore)[7].elements.filter(element => element.type === "line").length, 0, "缺谱不得绘制假五线谱")
  279. noScore.pages[7].resourceBindings = [{ resourceType: "MUSIC", resourceId: "verified-score", verified: true, dedicatedPage: true }]
  280. assert(render(noScore)[7].elements.some(element => element.subtype === "elf-sing-play" && element.sid === "verified-score"))
  281. const exercise = render(valid)[7]
  282. assert(exercise.elements.some(element => elementText(element).includes("哪一种声音更轻?")))
  283. assert(exercise.elements.some(element => elementText(element).includes("大声呼喊")))
  284. assert(exercise.remark.includes("参考答案:轻声哼唱") && exercise.remark.includes("比较相同距离"))
  285. const lost = render(valid)
  286. lost[7].elements = lost[7].elements.filter(element => !elementText(element).includes("哪一种声音更轻?"))
  287. assert(inspectAiPptQuality(valid, lost, preferences).errors.some(issue => issue.code === "missing_content"))
  288. const overtime = structuredClone(valid)
  289. overtime.pages[0].durationMinutes += 10
  290. assert(codes(overtime).includes("lesson_duration"))
  291. const dense = structuredClone(valid)
  292. dense.pages[3].studentContent.points = Array.from({length: 24}, (_, index) => `第${index + 1}条超长课堂说明,不应无限缩小字号塞进页面`)
  293. assert(codes(dense).some(code => ["text_overflow", "text_overlap", "out_of_bounds"].includes(code)))
  294. const compareAudio = render(valid)[4].elements.filter(element => element.subtype === "elf-audio")
  295. assert.equal(compareAudio.length, 2)
  296. assert(compareAudio.every(element => !element.autoplay))
  297. const editedCover = structuredClone(valid)
  298. editedCover.pages[0].title = "老师修改后的封面标题"
  299. assert(render(editedCover)[0].elements.some(element => elementText(element).includes("老师修改后的封面标题")))
  300. const noObjectives = structuredClone(valid)
  301. noObjectives.pages.forEach(page => page.objectiveIds = [])
  302. assert(codes(noObjectives).includes("objective_coverage"))
  303. const withVideo = structuredClone(valid)
  304. withVideo.pages[7].resourceBindings = [{resourceType:"VIDEO",resourceId:"test-video",contentUrl:"https://example.com/test.mp4",verified:true}]
  305. assert(render(withVideo)[7].elements.some(element => element.subtype === "elf-video"))
  306. const { getAiPptImageAspectRatios } = await vite.ssrLoadModule("/src/utils/aiPptTemplateEngine.ts")
  307. for (const template of AI_COURSEWARE_TEMPLATES) {
  308. const illustrated = structuredClone(valid)
  309. illustrated.templateId = template.id
  310. const target = illustrated.pages[7]
  311. target.visualPlan = { layout: "text_focus", imagePurpose: "observation", imageFit: "contain" }
  312. target.image = { url: "https://example.com/whole-instrument.png", width: 1800, height: 600, provider: "TEST", reviewStatus: "verified" }
  313. target.requiredVisual = true
  314. const slides = render(illustrated)
  315. const image = slides[7].elements.find(element => element.type === "image" && element.src === target.image.url)
  316. assert(image, `${template.id}: 观察题必须显示教学图片`)
  317. assert.equal(image.clip, undefined, `${template.id}: 不裁掉教学主体`)
  318. assert(Math.abs(image.width / image.height - 3) < 0.001, `${template.id}: 不拉伸教学图片`)
  319. assert(slides[7].elements.some(element => elementText(element).includes(target.interaction.question)))
  320. assert(!inspectAiPptQuality(illustrated, slides, preferences).errors.some(issue => ["missing_visual_render", "out_of_bounds", "text_overlap"].includes(issue.code)))
  321. const ratios = getAiPptImageAspectRatios(template.id)
  322. assert(ratios.split_content > 0 && ratios["split_content:media"] > 0)
  323. const imageSlot = getTemplateMasterPage(getAiCoursewareTemplateMaster(template.id), "content", "split_content").slots.find(slot => slot.kind === "image" && slot.enabled !== false)
  324. assert.equal(ratios["split_content:media"], imageSlot.width / imageSlot.height)
  325. if (template.id === "dark-lute") {
  326. const body = slides[7].elements.find(element => elementText(element).includes(target.interaction.question))
  327. assert.equal(body.defaultColor, "#F7F6F1", "深色背景上的正文必须保持可读")
  328. }
  329. }
  330. const unreviewed = structuredClone(valid)
  331. unreviewed.pages[1].image = { url: "https://example.com/scene.png", provider: "TEST", reviewStatus: "unverified" }
  332. assert(inspectAiPptQuality(unreviewed, render(unreviewed), preferences).warnings.some(issue => issue.code === "image_review"))
  333. const classroom = classroomFixture(scoreImage)
  334. const classroomSlides = render(classroom)
  335. assert.equal(resolveAiPptLayout(classroom.pages[0], 0), "cover_scene", "requiredVisual 不能把封面改成分栏")
  336. assert(new Set(classroom.pages.map(resolveAiPptLayout)).size >= 6, "统一 split 的历史大纲应恢复不同教学版式")
  337. for (const index of [0, 10, 11]) {
  338. assert(!classroomSlides[index].elements.map(elementText).join(" ").includes(classroom.pages[index].classroomAction.studentTask), "教案表述不得进入学生画面")
  339. assert(classroomSlides[index].remark.includes(classroom.pages[index].classroomAction.studentTask), "移出的教师说明必须保留在备注")
  340. }
  341. assert(classroomSlides[6].elements.some(element => element.type === "text" && element.width > 1200), "无图听唱页应使用宽版正文")
  342. assert(classroomSlides[9].elements.some(element => element.type === "text" && element.width > 1200), "无图检测页不得保留半页空白")
  343. const classroomReport = inspectAiPptQuality(classroom, classroomSlides)
  344. 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))
  345. assert.equal(classroomReport.issues.filter(issue => issue.code === "missing_required_visual").length, 6)
  346. assert(classroomReport.issues.filter(issue => issue.code === "missing_required_visual").every(issue => /重新生成|补充/.test(issue.message) && !/模型说明|评分|mustInclude/.test(issue.message)))
  347. // 配图不能迫使对比、活动、总结、目标页统一分栏,也不能在保留版式后丢图。
  348. for (const layout of ["compare", "activity", "summary", "objectives"]) {
  349. for (const template of AI_COURSEWARE_TEMPLATES) {
  350. const sample = structuredClone(valid)
  351. sample.templateId = template.id
  352. sample.pages[1] = page(2, "content", "观察并完成任务", layout, ["找一找主体", "说说变化"], {
  353. image: { url: scoreImage, width: 960, height: 720 }, requiredVisual: true,
  354. visualPlan: { layout, imagePurpose: "observation" }
  355. })
  356. const sampleSlides = render(sample)
  357. assert.equal(resolveAiPptLayout(sample.pages[1], 1), layout)
  358. assert(sampleSlides[1].elements.some(element => element.type === "image"), `${template.id}/${layout} 丢失配图`)
  359. 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)))
  360. }
  361. }
  362. const { PAGE_COMPOSITIONS, compilePageDesign } = await vite.ssrLoadModule('/src/utils/aiPptPageDesign.ts')
  363. let modelDesignChecks = 0
  364. 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])
  365. const modelFixture = modelDesignFixture(scoreImage)
  366. const modelSlides = render(modelFixture)
  367. const modelReport = inspectAiPptQuality(modelFixture, modelSlides)
  368. 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))
  369. assert(!modelReport.issues.some(issue => ['missing_required_visual', 'generated_focal_visual', 'rendered_layout_repeat'].includes(issue.code)), JSON.stringify(modelReport.issues))
  370. assert(new Set(modelSlides.map(slide => JSON.stringify(geometry(slide)))).size >= 8, '模型设计应实际产生不同坐标与内容组织')
  371. for (const template of AI_COURSEWARE_TEMPLATES) {
  372. for (const composition of PAGE_COMPOSITIONS) {
  373. for (const visualShare of [.35, .7]) {
  374. for (const textPresentation of ['plain', 'cards', 'steps', 'grid']) {
  375. for (const illustrated of [true, false]) {
  376. const sample = structuredClone(modelFixture)
  377. sample.templateId = template.id
  378. const target = sample.pages[1] = page(2, 'scene_intro', '观察角色的动作', 'split_content', ['找一找主体', '说说变化'], {
  379. studentContent: { headline: '它在做什么?', points: ['找一找主体', '说说变化'] },
  380. image: illustrated ? { url: scoreImage, width: 960, height: 720 } : undefined,
  381. requiredVisual: false, visualPlan: { composition, visualShare, textPresentation, visualMode: illustrated ? 'generated_image' : 'native_diagram', imagePurpose: illustrated ? 'observation' : 'none' }
  382. })
  383. const slides = render(sample)
  384. 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))
  385. assert.equal(errors.length, 0, `${template.id}/${composition}/${visualShare}/${textPresentation}/${illustrated}: ${JSON.stringify(errors)}`)
  386. assert.equal(slides[1].elements.some(el => el.type === 'image'), illustrated)
  387. const text = slides[1].elements.map(elementText).join(' ')
  388. assert(['它在做什么?', ...target.studentContent.points].every(value => text.includes(value)), '新构图不能遗漏任务和正文')
  389. modelDesignChecks++
  390. }
  391. }
  392. }
  393. }
  394. assert.equal(getAiPptImageAspectRatios(template.id).model_design_v1, 1)
  395. }
  396. const positioned = structuredClone(modelFixture)
  397. positioned.pages[1].visualPlan.composition = 'image_left'
  398. const leftImage = render(positioned)[1].elements.find(el => el.type === 'image')
  399. positioned.pages[1].visualPlan.composition = 'image_right'
  400. const rightImage = render(positioned)[1].elements.find(el => el.type === 'image')
  401. assert(rightImage.left > leftImage.left, '模型选择图右必须改变图片实际位置')
  402. const ratioPage = { title: '观察', visualPlan: { composition: 'image_left', visualMode: 'generated_image', visualShare: .63 } }
  403. const ratioSlot = compilePageDesign(ratioPage, 1, getAiCoursewareTemplateMaster('blank'), false, true, false).slots.find(slot => slot.kind === 'image')
  404. assert.equal(ratioSlot.width / ratioSlot.height, (1440 - 36) * .65 / 640, '前后端主视觉宽高比约定保持一致')
  405. const missingPlannedImage = structuredClone(modelFixture)
  406. missingPlannedImage.pages[1].image = undefined
  407. missingPlannedImage.pages[1].imageStatus = 'budget_exhausted'
  408. assert(inspectAiPptQuality(missingPlannedImage, render(missingPlannedImage)).issues.some(issue => issue.pageNo === 2 && issue.message.includes('单独重新生成')))
  409. const repeatedSlides = structuredClone(modelSlides)
  410. repeatedSlides[2] = structuredClone(modelSlides[1])
  411. repeatedSlides[3] = structuredClone(modelSlides[1])
  412. assert(inspectAiPptQuality(modelFixture, repeatedSlides).issues.some(issue => issue.code === 'rendered_layout_repeat'), '版式名不同但坐标相同也应被检测到')
  413. const semantic = semanticDesignFixture(scoreImage)
  414. const semanticSlides = render(semantic)
  415. 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))
  416. assert.deepEqual(semanticErrors, [], JSON.stringify(semanticErrors))
  417. for (const template of AI_COURSEWARE_TEMPLATES) {
  418. const check = structuredClone(semantic)
  419. check.templateId = template.id
  420. 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))
  421. assert.deepEqual(errors, [], `${template.id}: ${JSON.stringify(errors)}`)
  422. }
  423. const illustratedGroups = structuredClone(semantic)
  424. Object.assign(illustratedGroups.pages[4], { image: { url: scoreImage, width: 960, height: 720 } })
  425. illustratedGroups.pages[4].visualPlan.visualMode = 'generated_image'
  426. illustratedGroups.pages[4].studentContent.comparisonGroups[0].points.push('用手势表现变化')
  427. illustratedGroups.pages[4].studentContent.comparisonGroups[1].points.push('试着模仿它的声音')
  428. 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))
  429. assert.deepEqual(illustratedErrors, [], '图文对比必须为组名、正文和公共提示预留高度')
  430. const textElement = (i, text) => semanticSlides[i].elements.find(el => elementText(el).includes(text))
  431. assert(textElement(3, '风的声音').left < textElement(3, '老虎的声音').left, '两种对比对象必须各在一侧')
  432. assert.equal(semanticSlides[5].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 4, '四个真实任务不能混入引导标题变成五步')
  433. assert.equal(semanticSlides[7].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 2, '结构化步骤只编号两步')
  434. assert(!semanticSlides[7].elements.map(elementText).join(' ').includes('旧正文'), '结构化内容不回退到旧bullets')
  435. assert(semanticSlides[6].elements.filter(el => ['X', 'XX', '-'].includes(elementText(el))).length >= 8, '已有节奏必须产生可编辑符号')
  436. assert(semanticSlides[5].elements.filter(el => el.type === 'shape' && el.width > 200).every(el => el.height < 230), '短任务卡片不应占据整页高度')
  437. assert(textElement(0, '凤鸣山谷的故事').top >= 200, '缺主图封面重新组织标题位置')
  438. const { modelPageContent } = await vite.ssrLoadModule('/src/utils/aiPptContent.ts')
  439. const invalidGroups = structuredClone(semantic.pages[4])
  440. invalidGroups.studentContent.comparisonGroups.push({ label: '第三组', points: ['第三组的完整内容'] })
  441. invalidGroups.studentContent.comparisonGroups.push({ label: '第四组', points: ['第四组的完整内容'] }, { label: '第五组', points: ['第五组的完整内容'] })
  442. assert(modelPageContent(invalidGroups).points.includes('第三组的完整内容'), '异常分组不能丢失正文')
  443. const density = densityRegressionFixture(scoreImage)
  444. const densitySlides = render(density)
  445. 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)), [])
  446. assert.equal(densitySlides[8].elements.filter(el => /^[1-9]$/.test(elementText(el))).length, 3, '新语义字段不得丢失为单个引导标题')
  447. const brokenDensity = structuredClone(densitySlides)
  448. 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 })
  449. assert(inspectAiPptQuality(density, brokenDensity).errors.some(issue => issue.pageNo === 5 && issue.code === 'rendered_text_geometry'), '必须拦截之前坐标检查漏掉的真实高度溢出')
  450. const heroImages = heroImageRegressionFixture(scoreImage)
  451. const heroSlides = render(heroImages)
  452. for (const index of [0, 1, 11]) {
  453. const image = heroSlides[index].elements.find(el => el.type === 'image' && el.src === scoreImage)
  454. assert(image.width * image.height / (1920 * 1080) >= .24, `第 ${index + 1} 页主图不能退化成小横幅`)
  455. assert(Math.abs(image.width / image.height - 1584 / 560) < .001 && !image.clip, '主图保留完整比例,不裁切角色')
  456. const captions = heroImages.pages[index].studentContent.points.map(text => heroSlides[index].elements.find(el => elementText(el) === text))
  457. assert(captions.every(el => el && el.top === captions[0].top && el.top >= image.top + image.height), '短提示完整横排在主图下方')
  458. }
  459. 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)), [])
  460. const longCaption = structuredClone(heroImages)
  461. longCaption.pages[1].studentContent.points[0] = '请仔细观察山谷里的溪水、树木与远山,再和身边的小伙伴一起讨论不同声音的变化以及自己最喜欢的声音,并用动作向大家展示你的发现。'
  462. const longCaptionSlides = render(longCaption)
  463. const longText = longCaptionSlides[1].elements.find(el => elementText(el) === longCaption.pages[1].studentContent.points[0])
  464. assert(longText.width > 1000, '长内容保留整行,不硬塞进三列短提示')
  465. const { aiPptEntryChanged } = await vite.ssrLoadModule('/src/utils/aiPptClientVersion.ts')
  466. const html = '<script type="module" crossorigin src="./assets/index-new.js"></script>'
  467. assert(aiPptEntryChanged(html, 'https://example.com/classroom-ppt/', './assets/index-old.js'))
  468. assert(!aiPptEntryChanged(html, 'https://example.com/classroom-ppt/', 'https://example.com/classroom-ppt/assets/index-new.js'))
  469. assert(!aiPptEntryChanged('<html>login</html>', 'https://example.com/', './assets/index-old.js'))
  470. console.log(JSON.stringify({ passed: failures.length === 0, scenarioCount: results.length, contractChecks: 13, imageTemplateChecks: AI_COURSEWARE_TEMPLATES.length, modelDesignChecks, semanticDesignChecks: 10, regressionChecks: 17,
  471. scenarios: courseVariants.map(item => item.id), ...(process.argv.includes("--verbose") ? { results } : {}), failures }, null, 2))
  472. if (failures.length) process.exitCode = 1
  473. } finally {
  474. await vite.close()
  475. }