NKF PPT1.0
Overview
将用户上传的培训大纲/讲义等附件，转换为同一视觉体系下的两个成品（每次必做，缺一不可）：
- 网页版 HTML PPT——单文件、双击即开、适配线下大屏投影与线上分享
- 飞书在线 Slides（同款 PPTX）——在线可编辑、可演示，并同步导出本地 .pptx 供讲师二次修改
两个版本共享同一内容与设计系统，形成「分享走网页版、编辑走 Slides/PPTX 版」的双版闭环。
视觉定位（本技能的核心卖点）：对标全网商业 PPT 大咖的视觉手法——一页一概念、CRAP 排版四原则、60-30-10 配色、电影感 letterbox/胶片齿孔/电影蒙版、杂志网格分栏、毛笔书法题字 + 思源黑体正文、AI 生成大图蒙版主题图。详见 references/visual-styles.md。
Workflow
Step 1 读取附件全文
- 附件为 docx 时，使用
wordskill 的读取脚本完整读取：scripts/read.py -d 0+ python-docx 补充读取表格（document.tables）。 - 完整提取：封面（主标题/副标题/讲师姓名/联系方式）、目录、正文知识点、案例、数据、表格、提问、小结等全部内容。
- 读取产物保存为 Markdown 中间文件，作为后续所有分页与排版的事实基准。
Step 2 内容规划与分页
- 按附件原文逻辑顺序分页，不遗漏任何内容（知识点、案例、数据、表格、提问、小结），不打乱章节顺序。
- 长段落做合理断页：关键数字、结论、注意事项必须保留，禁止概括性删减。
- 封面页自动提取文档主标题、副标题；讲师姓名/电话作为占位信息呈现（原文有则照录，无则留占位）。
- 附件中只有目录标题、没有正文展开的章节：目录列全全部章节名，正文不编造（保持原文范围）。
- 每页逻辑连贯、正文精简提炼，拒绝整页大段长文；重点关键词高亮加粗。
Step 3 视觉与素材准备
- 先 Read references/visual-styles.md 选定本稿视觉基元（电影感/杂志感/国风笔刷三选一或组合），用 references/design-system.md 的设计 token 统一全稿。
- 配图（每稿必做）：封面、章节过渡页、结尾页至少各 1 张主题大图；内容页按需配图。图片统一用 AI 生图技能生成（电影感/杂志感风格，与咖啡棕+鎏金配色统一），流程见 references/image-workflow.md。
- 字体体系：标题/封面/章节引题用毛笔书法体（飞书 Slides：
马善政毛笔楷体/钟齐志莽行书；HTML 用系统书法回退栈），正文用思源黑体。详见 design-system.md 字体节。 - 生成素材全部落本地文件，供 Step 4（HTML base64 内嵌）与 Step 5（Slides media-upload）复用。
Step 4 制作网页版 HTML PPT
- 产出单文件 HTML：全部样式与脚本内嵌，不依赖外部 js/css 文件，不跳转外链，无弹窗、无广告。
- 视觉与交互规范见 references/html-spec.md。
- 用 references/design-system.md 的设计 token 统一全稿风格。
- 电脑浏览器双击即可演示，适配线下大屏投影（16:9）。
Step 5 制作同款飞书在线 Slides（PPTX）
- 使用
pptskill 的标准两步创建流程：+create建空白幻灯片 → 逐页+add-slide提交（每页开启 lint）。 - 图片素材先
+media-upload上传拿file_token，写入<img src>；禁止 http(s) 外链图。 - 内容与 HTML 版完全一致（同一设计系统、同一分页、同一案例对照结构）。
- 逐页处理 lint 反馈（溢出/重叠/对比度等），完成后
+xml-get回读核对，+screenshot逐页目检。 - 用
lark-cli drive +export --doc-type slides --file-extension pptx导出 PPTX 本地文件。 - 详细流程与踩坑点见 references/pptx-workflow.md。
Step 6 验证与交付
- 按 references/validation.md 的验收清单逐项核对。
- 用
present_files交付（三个通道全交）：
1. HTML 文件（本地路径或已发布链接）
2. 飞书 Slides 在线链接（+create返回的url）
3. PPTX 本地文件（drive +export导出的 .pptx） - 最终回复附简短验证记录（页数、lint 结论、截图确认范围、视觉元素核对）。
Hard Constraints
- 严禁遗漏附件内容：知识点、案例、数据、表格、提问、小结必须全部还原，可用 HTML 表格/列表还原原文表格/清单。
- 不编造原文缺失内容：附件未提供的章节正文不得虚构补全。
- 每次必出双版：HTML 版 + 飞书在线 Slides 版（并导出本地 PPTX），缺一不可。
- 视觉对标大咖基线：一页一概念、留白充足、视觉层级分明、电影/杂志级蒙版与装饰，拒绝平庸模板感。
- 全篇简体中文、全角标点、禁止 emoji（正文、标题、备注任何位置均不可出现）。
- 回复与交付语言与用户一致。
- 颜色、字号、间距等视觉元素以设计系统 token 为准，全稿统一。
Resources
- references/visual-styles.md：商业 PPT 大咖视觉手法研究基线（CRAP/一页一概念/60-30-10/电影感/杂志感/国风笔刷，含实现清单）
- references/design-system.md：视觉设计系统（配色 token、毛笔字体体系、装饰、页型版式、图片蒙版规范）
- references/image-workflow.md：AI 生图/图片技能集成流程（生图→落盘→base64 内嵌 HTML / media-upload 上传 Slides）
- references/html-spec.md：网页版 HTML 的交互规范与技术约束
- references/content-rules.md：内容处理与分页规则
- references/pptx-workflow.md：PPTX 制作、lint、截图、导出流程
- references/validation.md：交付前验收清单与验证记录要求
