课堂教学 PPT 轻量版
本包与 wb-edu-ppt 二选一即可。轻量版不包含引擎,支持教师提供本地完整解压的 ppt-master,也支持复用 WorkBuddy 已安装的版本;不自动安装、升级或覆盖它。来源见 来源说明。
输入与教学适配
读取教师指定的教材和确认方案,优先使用 02_教学方案.json 与对应 Markdown。核对真实确认依据和当前版本;没有确认的方案先做大纲供教师讨论。
读取 课堂表达规范,整理制作简报:年级学科、目标编号、活动顺序、页数意图、教材图片路径、学生任务、教师备注和输出位置。保存到独立课题目录,不写入技能目录。
复用当前引擎
- 优先使用教师在当前任务中明确指定的本地路径,同一任务后续沿用已确认路径,除非教师更换。接受以下三种输入,并仅在给定范围内检查对应入口,不扫描整台电脑:
-SKILL.md的绝对路径:以其所在目录作为引擎根目录。
- 技能目录:检查该目录下的SKILL.md。
- 仓库解压根目录:检查该目录下的skills/ppt-master/SKILL.md。
校验入口的技能名称为ppt-master,不能把本轻量版或仓库根目录误当成引擎。给定路径有多个有效入口时请教师指定一个;路径不存在、不可读或指向 ZIP 时说明具体问题,请提供完整解压后的入口,不静默切换其他版本。ZIP 本身不是可执行引擎,不只复制单个SKILL.md。 - 教师未指定路径时,从宿主提供的已安装技能信息中定位
ppt-master。两者都不可用时,只需请教师提供本地解压后的入口路径,无需要求先上架或安装到技能商店。不猜测个人电脑路径,也不把本次路径写入共享技能包。 - 将选定入口解析为绝对路径,简要告知使用的路径和版本。读取其
SKILL.md,以该文件所在目录作为SKILL_DIR交给引擎流程,按实际版本执行完整性检查和路由。完整性检查失败时停止,不修改或绕过检查。所有脚本与资源路径从此根目录展开,命令中的含空格路径正确引用;不依赖终端当前目录。不要求一个虚构的 Skill API。 - 优先复用宿主可用的 Python,按选定流程检查实际依赖;Windows 的
python3不可用时使用python或宿主提供的 Python 绝对路径。下载解压不等于依赖已安装;缺少解释器、依赖或执行权限时报告具体阻塞,不自动安装软件。项目输出保存到独立课题目录,不写入引擎目录。 - 将教学简报、教材和确认方案交给引擎,保留适用的确认节点。以引擎当前版本的路由为准:新建课件、保留原生PPT设计编辑、创建可复用模板等由实际需求决定。
- 本包不保证不同引擎版本具有相同过程。需要固定版本复现时,可指定本项目归档的6.6.0完整解压版,或使用包含完整6.6.0引擎的
wb-edu-ppt主包。
本地路径调用示例
教师将完整仓库解压后,找到其中的 skills/ppt-master/SKILL.md,使用自己电脑上的实际路径,例如:
> 使用课堂教学PPT轻量版。我的本地 PPT Master 入口是 D:\教学工具\ppt-master\skills\ppt-master\SKILL.md。请先检查该引擎及运行环境,再根据我提供的教材和已确认教学方案制作可编辑PPTX,保存到 D:\备课\本课课件。
上述路径只是示例,不作为默认值。宿主需要能够读取这些目录并执行脚本;本地解压调用不能绕过电脑的执行权限限制。
交付检查
检查目标与活动对应、学生任务说明、投影可读性、教材图文准确性及题目答案分离。完成引擎导出和校验后返回实际 .pptx 及保存路径。
如果引擎或实际所需依赖不可用,明确说明阻塞位置;不把HTML或Markdown称为PPTX。媒体或动画未实际验证时,不声称已验证。