文档答题站生成器

要解决的问题

把一份试卷或题库变成可用的答题网站，难点不在前端，而在无损还原。"加粗的词""画线的句子"经纯文本提取后就丢了；材料题、对话、图表被拍平成一行行单选题后，子题会失去共同的 stimulus_id；试卷附带的答案页和批注副本一旦混入统计，站点题量就与来源对不上。

核心能力与关键步骤

技能以逐阶段确认的状态机运行，不会因为"答案看起来很明显"就跳过关卡：

• 先定主题：处理文档之前先确认主题与视觉风格，已有文档保留但暂不处理。
• 显式确认文档：文档到位后只做结构检查，再明确询问"这是用于生成答题游戏的题库或试卷文档吗？"，不从文件名或历史对话推断意图。答案是否定则停止，转入题库转化的新范围。
• 批量收集信息：站名、年级、学科、单局题量、奖励机制、Edge TTS 语音偏好与部署目标一次性问完。交互是固定契约：点选即作答，答对触发 5 秒自动下一题，答错停留待手动 Next，朗读开始即取消该题倒计时。
• 规范化题库：按 references/question-bank-schema.md 归一化并保留原文措辞与答案；共享材料建模为顶层 stimulus，用 stimulus_id 关联子题；带答案的图片抽取为本地资源，source_ref 保留页码级溯源；格式化标记编码为 [[marked text]]，渲染为全角加粗样式，TTS 前剥离标记语法。
• 讲解与音频：来源无讲解时基于题干、已验证答案与完整材料逐题生成解释，用 explanation_origin 标注来源；每题生成唯一本地 Edge TTS MP3，禁止用浏览器 speechSynthesis 替代。
• 完整站点：按 references/site-blueprint.md 交付首页、顺序/随机模式、只读答题回顾、错题本、8–12 枚独立生成的徽章、每屏独立 URL 与可下载的 Scan to Visit 海报。

适用边界与注意点

• 纯文本提取不足以处理"加粗/加点/画线"类题目：技能会检查字形或样式 run，无法确定标记范围时写入歧义报告，而不是发布猜测版本。
• 不会为缺失答案编造内容；歧义答案、残缺选项与重复题都会被标记。
• Edge TTS 被阻断时报告阻塞并保持站点不完整，不会静默省略朗读。