ym-training-courseware

生成带章节导航与课堂提问页的HTML培训课件，适合内训讲师。 当用户提到「培训课件」「内训PPT」「课程讲义」「教学幻灯片」时使用。

培训课件生成器 (ym-training-courseware)

把一次内训设计成「带章节导航 + 课堂提问页」的 HTML 课件。讲师先填课程设计表（页码 / 章节 / 类型 / 知识点 / 时长 / 互动方式），模型再按表逐页生成 courseware.html：左侧固定章节导航可点击跳转，每讲完一章跟一个课堂提问页（含 2 个问题 + 参考答案），页脚显示「第 X / Y 页 · 当前章节」。不做在线判分、不管理学员数据。

何时使用

• 用户说「培训课件」「内训 PPT」「课程讲义」「教学幻灯片」时
• 用户是企业内训讲师，要讲新员工培训、工具使用培训等，手里有知识点清单但不知道怎么排页时
• 用户明确课程主题、受众（新员工 / 在岗 / 管理层）、总时长、知识点清单时

运行前提

• 环境：纯文本 / HTML 生成，无需 Python、无需联网、无需任何依赖
• 输入：一份按 templates/courseware-plan.md 填好的课程设计表；若用户只给零散要点，先帮其落成设计表再生成
• 输出：当前目录下生成 courseware.html，同名会覆盖
• 节奏依据：references/teaching-rhythm.md（成人注意力节奏：每 8~10 分钟一个互动、开场给目标、结尾有练习）
• 产出是放映/自学两用的本地 HTML，不依赖服务器；讲师可离线打开、投屏或发链接
• 所有教学内容以用户提供的知识点清单为准，模型只做排版与结构组织，不增删事实

输入契约

项	必需	说明
课程主题	必需	用一句主题句说明讲什么，用作封面标题
受众	必需	新员工 / 在岗 / 管理层；影响措辞深浅与举例
总时长	必需	分钟数；用于推算总页数与互动节奏
知识点清单	必需	每个知识点一行：名称 + 一句话内容；每个知识点拆成独立页

缺失处理：

• 缺知识点清单 → 用 templates/courseware-plan.md 请用户每行补一个知识点，不要替用户编造教学内容
• 缺受众 / 时长 → 默认「在岗 + 45 分钟」，并在封面副标题注明「受众/时长未指定，按默认生成」
• 知识点过多塞不进时长 → 按每分钟约 1 页重排，提示用户合并或削减；提问页算 2 分钟时间预算
• 时长极短（如 15 分钟）→ 仍保证「封面 + 学习目标 + 至少 1 章 + 总结 + 练习 + 结尾」最小骨架

执行步骤

1. 填课程设计表 — 复制 templates/courseware-plan.md，按列填：页码 / 章节 / 类型（封面 / 目标 / 知识 / 提问 / 总结 / 练习 / 结尾）/ 知识点 / 时长 / 互动方式。每章至少 1 个知识页 + 1 个提问页。

2. 推算页数 — 用 references/teaching-rhythm.md 的节奏核对：总页数约等于总时长（每分钟约 1 页），提问页额外占 2 分钟时间预算。例如 45 分钟、8 个知识点 → 目标 40~50 页。若超出，合并知识页或减少提问页。

3. 生成 courseware.html — 按设计表逐页写出单文件 HTML：

   • 左侧固定章节导航（每个章节一个可点击项，点击跳到该章第一页）
   • 内容区每页一个 section（id 为 page-N），知识页每页只讲一个概念
   • 每章末一个「课堂提问」页，含 2 个问题 + 折叠/可见的参考答案
   • 页脚固定显示「第 X / Y 页 · 当前章节」
   • 翻页交互：←/→、空格、PgUp/PgDn、Home/End；左侧导航点击跳转

4. 验收 — 浏览器打开 courseware.html，确认：导航点击能跳转、页脚页码与章节正确、每个提问页都带参考答案、字号不小于 18px。

设计表到页面的映射示例

以「45 分钟新员工培训、8 个知识点分 4 章」为例，设计表的前几行映射为页面：

设计表行	生成页面	关键要素
封面行	page-1 封面页	主题 + 受众 + 时长写在副标题
目标行	page-2 学习目标页	3~5 条可衡量目标
第一章知识行	page-3 知识页	只讲「工牌与门禁办理」一个概念
第一章提问行	page-4 课堂提问页	2 题 + 参考答案区块
第二章知识行×2	page-5、page-6 知识页	每个概念独立一页
第二章提问行	page-7 课堂提问页	2 题 + 参考答案
…	…	每章重复「知识 → 提问」
总结行	总结页	回顾四章 + 行动号召
练习行	练习页	3 题 + 答案
结尾行	结尾页	谢谢 + 资料链接

左侧导航只列章节名（封面/目标/总结/练习/结尾归为「概览」或各自成项），点击跳到该章第一页；页脚「当前章节」取该页所属章节名。

页面结构（强制）

按以下顺序生成，章节数必须与知识点分组一致：

1. 封面页（主题 + 受众 + 时长）
2. 学习目标页（3~5 条可衡量目标）
3. 每章：知识页（每页一个概念）→ 章末「课堂提问」页（2 题 + 参考答案）
4. 总结页（回顾要点 + 一句行动号召）
5. 练习页（3 题，可附答案）
6. 结尾页（谢谢 + 联系方式 / 资料链接）

输出格式

单个自包含 HTML 文件 courseware.html：

• 布局：左侧固定侧栏（章节导航，宽度约 22vw）+ 右侧内容区（滚动 / 翻页）
• 每页一个 section，id 为 page-1、page-2…，首屏只显示当前页
• 章节导航项用锚点链接指向对应 page-id，点击平滑滚动或翻到该页
• 课堂提问页结构：问题 1 / 问题 2 + 「参考答案」区块（默认可见或点击展开）
• 页脚：第 X / Y 页 · 当前章节：Z
• 字号基准不小于 18px，正文行高 1.7，投影清晰

能力边界

• 不做在线答题与自动判分；提问页只提供参考答案，不收集学员作答
• 不管理学员名单、出勤、成绩等数据
• 不生成配图 / 插画；图片由讲师自行插入（后续版本考虑）
• 不导出 .pptx / PDF，不联网、不上传任何数据
• 不替讲师编造事实性教学内容；知识点以用户提供的清单为准
• 不自动发邮件/消息通知学员，仅产出本地文件

与同类技能的区别

• 本技能面向内训讲师，强制「章节导航 + 课堂提问页 + 练习页」，结构由课程设计表驱动，无转换脚本（模型直接生成 HTML）。
• ym-html-deck-builder 面向通用分享，输入是自由大纲，无提问/练习结构。
• ym-report-slide-gen 面向领导汇报，强制结论先行 + 数据表格，输入是四类素材。

常见坑

1. 一页塞 200 字以上 — 现象：学员跟不上、投影看不清。原因：把一章全堆一页。规避：知识页每页只讲一个概念，控制在 80~120 字 + 1 个要点列表；超了拆页。

2. 全程无互动 — 现象：讲师一直讲，学员走神。原因：没按节奏插互动。规避：每章末必有「课堂提问」页（2 题 + 参考答案），且每 8~10 分钟至少一个互动，依据 references/teaching-rhythm.md。

3. 字号小于 18px 投影看不清 — 现象：投到幕布后小字糊成一片。原因：用了网页正文级字号。规避：正文基准 18px 起、标题更大，行高 1.7；生成后在投影分辨率（如 1920×1080）下自检可读性。

4. 导航与章节对不上 — 现象：点导航跳错页、页脚章节名错位。原因：章节 id 与导航项或页脚未同步。规避：先按设计表定好 page-id 与章节名，导航项、页脚「当前章节」都从同一份映射生成，不手填两遍。

5. 提问页缺参考答案 — 现象：讲师现场答不上来、学员无法自学。原因：只放问题忘了给答案。规避：每个提问页必须含「参考答案」区块；验收时逐页检查无空白答案。

6. 页数与时长脱节 — 现象：45 分钟排了 90 页讲不完，或 15 分钟只 5 页水。原因：没按每分钟约 1 页推算。规避：用设计表的总时长列累计，目标页数 ≈ 时长（±10），提问页额外计 2 分钟。

验收用例

• 正常：45 分钟新员工培训、8 个知识点 → 页数落在 40~50；章节数 = 知识点分组数；每章有提问页且带参考答案；页脚页码随翻页推进。
• 边界 1：15 分钟短训 → 仍含封面 + 学习目标 + 至少 1 章（知识 + 提问）+ 总结 + 练习 + 结尾最小骨架。
• 边界 2：受众=管理层 → 措辞偏决策视角、举例偏经营，而非操作细节。
• 失败：空知识点清单 → 停下请用户补，不生成空 courseware.html。

目录说明

• templates/courseware-plan.md — 课程设计表模板（列：页码 / 章节 / 类型 / 知识点 / 时长 / 互动方式），先填表再生成
• references/teaching-rhythm.md — 成人注意力节奏参考（每 8~10 分钟一个互动、开场给目标、结尾有练习）