# 让教学资料用起来

知识库与腾讯 ima 教育应用培训。面向教师、教研组长和学校管理人员，120分钟、网页版35页（历史PPT首版30页）。

## 课程文件

- [离线网页演示](index.html)
- [PowerPoint 演示文稿](outputs/知识库与腾讯ima教育应用培训-v1.pptx)
- [逐页演讲稿](docs/261103_1414-知识库与ima教育培训逐页演讲稿.md)
- [课程大纲](docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md)
- [现场练习单](materials/05_现场练习单.md)
- [模拟资料包](materials/)
- [逐页标题索引](src/deck.json)

演示文稿采用16:9画幅，PPT首版为深绿、薄荷绿与白色配色；当前网页版采用浅色背景、深色文字和青绿与紫色强调，文字、图形和表格可编辑，逐页附有讲师备注。使用 PingFang SC 字体，其他电脑若无此字体，可在 PowerPoint 中替换为可用的中文字体并复查排版。

## 维护方式

网页页面源码位于 `src/slides/*.html`，每页一个文件；`src/deck.json` 维护稳定页面ID及播放顺序。修改后运行 `python3 scripts/build_web.py --check`，再运行 `python3 scripts/build_web.py`。双击 `index.html` 即可离线播放，发送这个单文件即可分享。

PPT首版源码位于 `scripts/build.mjs`，其标题索引生成至 `src/pptx-deck.json`。改动PPT内容时同步更新大纲及版本记录，具体见 [AGENTS.md](AGENTS.md)。网页入口生成在项目根目录 `index.html`；PPT、ZIP练习包及预览图保留在 `outputs/`。生成结果不要直接修改，应修改源码后重新构建。

本机重建使用已安装的官方演示文稿运行库。使用该运行库 Node 执行 `scripts/build.mjs`，参数1为仓库绝对路径，参数2为新的输出文件名，例如 `知识库与腾讯ima教育应用培训-v2.pptx`。构建会生成逐页预览、检查文件并导出新版本，保留旧版本。运行库位置见源码开头，换电脑需要调整。

## 演示边界与授课准备

- 官方界面截图取自 https://ima.qq.com/ 的未登录首页，日期2026-11-03。
- 当前案例为九上英语Unit 2 Inspiring People；材料01是教材定位与袁隆平拓展资料，02是讲师设计，03是模拟反思，04是榜样墙模拟指南，均明确标识。
- 预览与文件检查已完成，尚未在 PowerPoint 原生程序中检查。
- 授课前需用实际账号验证登录、Markdown资料导入、原文来源、笔记和共享入口，确认账号可用额度与现场网络。
- 产品参考：https://ima.tencent.com/download 。参考课程：http://gitea.werich.top/speech/Ai_education 。

默认不提交、不推送。

## 网页播放

- 方向键或空格翻页，Home / End 到首尾页。
- M：搜索目录，N：当前页讲师备注，F：全屏，R：阅读模式。
- 手机可左右滑动，阅读模式适合在小屏上查看全文。截图可点击放大。
- 第17、30页可复制提问模板；第29页有12分钟计时器，切页后继续；第31页可勾选完成清单。
- “资料”提供五份Markdown材料及ZIP整包下载，全部内嵌在网页内。
- 备注会显示在当前投影上，按需打开。刷新页面后练习计时和清单重置。
- 生成文件无网络依赖，访问官网或使用ima需要联网。网页不调用AI、不上传资料。

此版仅生成本地网页，尚未发布到公网，也未自动提交或推送。

## 文件组织

```text
index.html              # 网页入口，构建生成，可单独离线分享
src/                    # 网页页面、播放器、样式与顺序清单
scripts/                # 网页与PPT构建脚本
assets/                 # 图片素材
materials/              # 练习资料源码
docs/                   # 课程大纲与逐页演讲稿
outputs/                # PPT、ZIP练习包及预览图
work/                   # 验证记录
```

在仓库根目录运行 `python3 scripts/build_web.py` 会重新生成根目录 `index.html`，并更新 `outputs/培训练习材料.zip`。`--output` 可指定其他HTML输出位置，ZIP练习包始终保存在 `outputs/`。

## 系列课程统一

当前网页版采用第一讲的粒子封面、讲师介绍、五段式提纲、统一页眉页脚和工具栏。新增讲师介绍、提纲、提问与致谢后为35页，核心课程和120分钟时长保留。历史PPT首版仍为30页，尚未回写当前网页的新增结构与视觉样式。

## 当前配色试用

按最新要求，网页版试用浅色背景、深色文字，保留35页内容与系列结构，封面、正文、表格、阅读模式及弹窗同步适配。仅视觉调整，不增加课程大纲版本。历史PPT首版仍保留原文件。

第9页为新增的知识库处理原理图，解释常见RAG的入库与问答阶段。课程仍为120分钟，历史PPT首版保留30页。

## 当前教学案例与讲稿

当前35页网页已统一为人教版九年级上册Unit 2 **Inspiring People**，以用户ima订阅库“人教新版初中英语”中的《九上电子课本.pdf》核对。教材p.11—20对应该139页PDF的第18—27页；版权年份未核定，不用旧版同序号单元替代。四个案例为备课、练习、教研与榜样墙项目。

35页备注含可讲的口播、操作和转场；独立演讲稿见上方链接。讲稿与大纲、页面及材料需要同时维护。课程120分钟含演示和练习。取—用—存贯穿任务，保存后重开，课后补反馈。

历史PPT与`scripts/build.mjs`保留旧30页案例，仅供归档；不是当前英语课程版本。不要用旧PPT脚本重新发布当前课程。教材正文只在原授权入口查阅，材料包不含整本课本。

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