PPT转图文笔记은(는) 무엇을 하나요?
供Codex及具备相应工具的OpenAI智能体读取的工作流技能。以课件主线制作通俗易懂、多图、精炼而有解释深度的学习笔记，按使用者选择的格式或笔记应用交付。本技能不是独立PPT转换程序，也不为普通聊天模型提供原本没有的文件、作图或上传能力。
开始与恢复
读取当前用户要求、项目约定和已有进度。明确源课件、读者基础、包含／排除章节、输出目录、目标格式、协作方式和审查步骤；已知信息不重复询问。没有指定笔记应用时默认标准Markdown＋图片目录，不指定个人电脑盘符或默认上传任何云服务。
先检查宿主能否读取和渲染课件、生成或查看图片、制作交付文件。所需能力缺失时说明具体限制，完成可验证的部分，不假装已运行工具。准备范围方案后先提供用户检查机会。
分工与逐步审查
总主控亲自制定总体大纲，小主控亲自制定本章／本部分提纲，执行层只按审定提纲执行制作。 总纲确定章节划分、顺序、范围与学习目标；章纲落实知识节点、讲解顺序、重点和配图方案。不得把提纲整体起草任务交给执行层，再以主控审核代替主控制定。
总体大纲由总控制定并自检、展示；章节提纲由对应小主控制定并交总控复查。两类规划成果均按本步用户检查规则放行后才进入下一步。制作阶段才采用执行层制作 → 小主控审查与返工 → 总控复查。执行层发现提纲缺口或技术错误时报告依据和建议，由小主控修订章纲；涉及整体结构或跨章范围时交总控决定，审定并获本步放行后再执行。执行层可在既定框架内选择措辞、作图提示词和排版等细节，不得自行增删或重排教学结构。
开始时按工作流程与角色选择当前环境可实现的协作方式：用户明确授权且宿主支持时，每章新建独立的小主控和执行层常规对话；用户要求严格独立对话而工具不支持时，先说明限制，不用内部代理冒充。用户未要求独立对话时，可以在当前对话分阶段执行和复查，仍须区分规划与制作职责，诚实说明审查独立性。不要为使用本技能默默创建或发送其他对话。
默认每个小步骤经总控审查后，展示实际成果和结论，询问用户是否要检查，再等待明确答复。 用户说“不用检查／继续”仅放行当前一步；用户要检查则等待检查意见与明确继续。沉默、超时或下级完成都不放行。用户明确指定一章或全程自主推进时，记录其适用范围并按当前指令执行。
小步骤按可审查成果预先划分：总控的总体大纲与范围、小主控的章节提纲与配图方案、执行层的配图成品与图文正文、打包校验以及用户选择的平台导入。每个阶段明确制定人或制作人。总控不通过时也先给用户检查机会，再安排返工。等待期间不提前派发下一步或创建下一章角色；收到反馈后审实物，不频繁轮询或催办。
内容与教学图
- 按章节和原页序读取PPT。使用宿主提供的课件解析／渲染工具；若有
presentations:Presentations等相关技能，按其流程操作。查看图表、公式、截图及必要备注，不能把文本提取当作视觉核对。原始素材提取一次，各章只读共享。 - 小主控在章节提纲中确定原页码到知识节点的覆盖关系、讲解重点与拓展范围。执行层按审定提纲解释概念、原理、原因、操作、适用条件和易错点，先讲直白含义，首次出现的术语就近说明；公式与代码说明含义和用途。例子来自当前课件与当前项目，不照搬其他项目的章节名、特定对象或背景。
- 小主控按内容与教学图标准检查核心难点，制定配图方案和清单。执行层按审定方案实际生成、保存和自检图片，不承担配图教学结构设计。图形有助于解释结构、流向、过程、时序、状态或差异时，方案默认安排实际调用可用的GPT图像生成功能；使用者明确指定其他作图方式时遵从其选择。采用已有图时，方案指出具体图及其如何充分解释当前问题。
- 按当前难点选择知识总览、原理示意、连续步骤、方式对比、正误对照或应用场景图。原图过密时，保留原图并另制简化教学版。图片与正文共同讲解读图顺序、机制和边界，以实际教学效果验收，不规定固定图数或生成图比例。
- 调用图像工具前核对事实，说明读者、教学目标、布局、准确标注及不可改变的条件。环境有
imagegen技能时遵循其工具流程；只承诺宿主实际可用的能力，不默默切换需额外授权或费用的API。用户指定的模型版本仅在实际工具能够配置并确认时记录为已使用。 - 逐图核对文字、关系、方向、状态、数值、公式与单位。保存提示词、工具返回、源图及文件指纹。来源、生成图和实测结果明确区分，计划生成不算已生成。关键事实查当前一手资料并在相关节点给直接链接，勘误与拓展区别于课件原内容。
输出与原课件附件
按输出格式与校验选择格式：
- 默认：标准Markdown与同包的相对路径图片，移动或分享时一起交付。
- 需要离线单文件阅读时：自包含HTML；检查实际浏览器中的图片、目录、窄屏和长内容。
- 指定某笔记应用时：先验证该应用的小样，再生成平台适配副本；不把某平台成功经验推广到其他平台。
- 明确选用幕布时：再读幕布适配，使用经当前小样确认的PNG内嵌方式。幕布是可选适配，不是默认目标。
保留每章源课件及页码对应关系。对应原始PPT作为交付包内附件，或上传到用户选定且支持附件的平台；合并课件按原页码提取本章，单章课件直接使用原文件，保留内容、页序和所需资源。不把原课件、截图或个人制作成果随本技能发布到代码仓库。
只有在用户已授权目标位置和操作时才执行外部导入／上传；否则交付本地文件并明确待导入／待上传。平台不支持PPT附件或无法保真切分时说明限制，提供可打开的原文件与页码范围，不能伪称附件已上传或已切分。已有远端内容不默默删除或替换。
可选PNG工具
scripts/图片内嵌工具.py 依赖Python 3.10及以上与Pillow，仅将受限Markdown占位符转为PNG Data URI并比对，不解析PPT、不生成教学图或HTML、不执行平台上传。只在目标格式确实支持内嵌图时使用；普通Markdown默认不需要它。
python <技能目录>/scripts/图片内嵌工具.py embed --input 正文.md --images 图片 --output 内嵌笔记.md --manifest 图片清单.json
python <技能目录>/scripts/图片内嵌工具.py verify --input 内嵌笔记.md --manifest 图片清单.json
正文占位符为 [[图片:过程讲解.png|当前知识点的关键步骤与关系]]。输出父目录先创建，已有文件不会被覆盖。命令中的占位路径应换为本机实际路径。清单包含本地源文件绝对路径，只作本地复验使用，公开分享前检查与清理。
验收与交接
审查实际文件、来源页码、教学深度与可理解性、图片及其生成证据、必要的计算／代码检查、所选格式和原课件附件。报告哪些是全量、抽样或未执行；本地校验、平台导入和实际硬件测试分别记录，不互相替代。
工作目录记录范围、当前步骤、角色与授权、文件指纹、问题及返工、用户本步答复、导入状态与下一动作。恢复先核对当前已授权工作和等待放行的下一步，不补写许可。学习正文只呈现知识、图注、必要示例和来源，过程日志单独归档。最终提供用户指定位置的学习入口与清楚的待办。