Files
02-ima/AGENTS.md
T

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保留原样,未重新生成的旧版不能声称已同步。
  • 模拟教学与校务资料必须保留模拟标识,不得描述为真实课标、学校制度或产品实测结果。
  • 官方截图为未登录首页,登录后的导入、来源点击、笔记及共享操作仍需授课账号验证。
  • 保留不属于当前任务的改动。默认不提交、不推送。