02-ima/AGENTS.md

# 演示文稿协作约定

- 本仓库用于“知识库与腾讯 ima 教育应用”培训，参考项目为 `speech/Ai_education`。
- 当前大纲为 `docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md`。后续修改PPT或网页课程内容，必须在同一次任务中同步维护大纲，检查目标、页序、页数、时长、案例、练习与成果要求。
- 修订大纲保留文件名及 `created_at`，递增 `revision`，追加 `revisions`；仅视觉调整无需虚增大纲版本。

## 网页维护

- 网页页面源码为 `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` 生成根目录 `index.html` 与 `outputs/培训练习材料.zip`。根目录 `index.html` 和 `outputs/` 均为生成结果，禁止直接编辑。
- `work/` 仅放验证记录或临时工作，不运行历史修补脚本。

## PPT与内容一致性

- 已提交PPT首版保存在 `outputs/知识库与腾讯ima教育应用培训-v1.pptx`，其旧制作源码为 `scripts/build.mjs`，标题索引为 `src/pptx-deck.json`。不得用PPT构建覆盖网页清单 `src/deck.json`。
- 当前网页版为35页系列统一版，历史PPT首版保留30页；新增结构与视觉尚未回写历史PPT。后续修改课程内容时同步维护网页、大纲及后续发布的PPT版本。历史PPT保留原样，未重新生成的旧版不能声称已同步。
- 模拟教学与校务资料必须保留模拟标识，不得描述为真实课标、学校制度或产品实测结果。
- 第13页为产品官网首屏截图，第15页为未登录Web应用首页截图。登录后的导入、来源点击、笔记及共享操作仍需授课账号验证。
- 保留不属于当前任务的改动。默认不提交、不推送。

## 系列视觉与结构

- 网页保留第一讲的粒子封面、讲师介绍、五段式提纲、统一页眉页脚及提问致谢结构；按用户最新要求试用浅色背景、深色文字，辅以深青绿和紫色强调。新增内容遵循当前浅色样式。
- 课程时长120分钟，网页版35页；调整页序时同步大纲、README与页码说明。

## 当前英语案例与讲稿

- 以用户指定ima订阅库“人教新版初中英语”中的《九上电子课本.pdf》为准：Unit 2 Inspiring People，139页PDF，教材p.11—20对应PDF第18—27页；版权年份未核定，不套用旧版同序号单元。
- 当前四案例为备课、练习、教研、榜样墙项目。材料01是教材定位与袁隆平拓展资料，02是讲师设计，03是模拟反思，04是项目模拟指南，05是练习单。
- 逐页演讲稿位于docs/，通过README入口定位，与页面data-note、大纲及练习材料同次维护。35页120分钟，含演示、练习与交流。
- 本次已查看登录的ima教材原页，尚未验证问答与回存；教材查阅不等于产品操作全流程实测。历史PPT和旧制作脚本保留旧案例，不用于发布当前英语版。

- 当前主案例为袁隆平拓展教学，材料01含科技部人物资料来源与讲师自编英文短文；不得标作教材p.16—17课文，不挪用其他科学家的经历。