feat: 添加知识库培训离线网页及互动练习

AGENTS.md

@@ -1,16 +1,24 @@
 # 演示文稿协作约定
 
-- 本仓库用于“知识库与腾讯 ima 教育应用”培训；参考仓库为 `speech/Ai_education`。
-- 当前课程大纲：`docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md`，是课程结构、逐页主题与讲解内容的维护依据。
-- 后续新增、删除、调整顺序或修改 PPT／HTML 演示内容时，必须在同一次任务中同步更新大纲，不得只修改演示文稿。
-- 涉及课程内容时，同步检查培训目标、课程安排、页码、页数、时长、案例、练习及成果要求，确保与演示内容一致；仅视觉或排版调整无需虚增大纲版本。
-- 修订大纲时保留原文件名和 `created_at`，递增 `revision`，向 `revisions` 追加修改时间与内容，必要时更新 `summary`。
-- 开始修改前先读取当前大纲；任务完成前检查大纲与实际演示内容的一致性。尚未制作或验证的演示与产品操作应如实注明。
-- 保留工作区中不属于当前任务的改动。默认不提交、不推送。
+- 本仓库用于“知识库与腾讯 ima 教育应用”培训，参考项目为 `speech/Ai_education`。
+- 当前大纲为 `docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md`。后续修改PPT或网页课程内容，必须在同一次任务中同步维护大纲，检查目标、页序、页数、时长、案例、练习与成果要求。
+- 修订大纲保留文件名及 `created_at`，递增 `revision`，追加 `revisions`；仅视觉调整无需虚增大纲版本。
 
-## 当前制作源文件
+## 网页维护
 
-- 当前 PowerPoint 的内容与版式源码为 `scripts/build.mjs`，构建生成 `src/deck.json` 标题索引、预览和 `outputs/*.pptx`。
-- 不直接编辑生成结果。内容改动需同步源码、大纲与实际标题索引，重新生成并检查。
-- `materials/` 是培训模拟资料，必须保留模拟标识，不得描述为真实课标、学校制度或产品实测结果。
-- 当前使用的是未登录官方首页截图；登录后的操作仍需授课账号验证，不得将讲师备注中的演示计划表述为已验证。
+- 网页页面源码为 `src/slides/*.html`，每个文件对应一页，含正文、`data-title`、`data-chapter`、`data-note` 和页内样式。
+- 修改前读取 `src/deck.json`，按稳定页面 ID 定位文件，文件名不使用页码。增删及排序由该清单控制。
+- 页内样式选择器以 `:scope` 开头，公共媒体查询与动画放在 `src/styles/theme.css`。公共容器和播放器分别为 `src/shell.html`、`src/runtime/player.js`。
+- 页内脚本由构建器包裹，可使用 `root` 查询本页。不得查询其他页面或在全局保存页内状态。计时器由公共播放器统一维护。
+- 图片放在 `assets/`，页面通过 `src="asset:文件名.png"` 引用；不在页面源码粘贴 Base64。`materials/` 为练习资料，构建时自动内嵌。
+- 不手写页码、总页数、section ID、active 或可见状态。页脚用 `{{PAGE_NUMBER}}` 与 `{{PAGE_COUNT}}`。
+- `python3 scripts/build_web.py --check` 检查；`python3 scripts/build_web.py` 生成 `outputs/index.html` 与ZIP练习包。`outputs/` 为生成结果，禁止直接编辑。
+- `work/` 仅放验证记录或临时工作，不运行历史修补脚本。
+
+## PPT与内容一致性
+
+- 已提交PPT首版保存在 `outputs/知识库与腾讯ima教育应用培训-v1.pptx`，其旧制作源码为 `scripts/build.mjs`，标题索引为 `src/pptx-deck.json`。不得用PPT构建覆盖网页清单 `src/deck.json`。
+- 当前30页网页对应PPT首版，后续修改课程内容时同步维护网页、大纲及后续发布的PPT版本。历史PPT保留原样，未重新生成的旧版不能声称已同步。
+- 模拟教学与校务资料必须保留模拟标识，不得描述为真实课标、学校制度或产品实测结果。
+- 官方截图为未登录首页，登录后的导入、来源点击、笔记及共享操作仍需授课账号验证。
+- 保留不属于当前任务的改动。默认不提交、不推送。