2.5 KiB
2.5 KiB
演示文稿协作约定
- 本仓库用于“知识库与腾讯 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。 - 当前30页网页对应PPT首版,后续修改课程内容时同步维护网页、大纲及后续发布的PPT版本。历史PPT保留原样,未重新生成的旧版不能声称已同步。
- 模拟教学与校务资料必须保留模拟标识,不得描述为真实课标、学校制度或产品实测结果。
- 官方截图为未登录首页,登录后的导入、来源点击、笔记及共享操作仍需授课账号验证。
- 保留不属于当前任务的改动。默认不提交、不推送。