周慧慧课程PPT

概述

v7.1.0 新增（2026-11-04）：内容层与交付层补齐 —— 从「画得对」走到「讲得通、交得清」。

① 开篇三问 → 六问（scripts/brief.py）：补 受众 / 演示模式 / 时长 三项必填，

并给出页数节奏表（60 分钟现场讲 25–40 页 / 发出去读 45–70 页；培训课取 20–30 页/小时下段）、

受众 × 模式矩阵（8 格，每格给每页字数与备注要求）、以及三对必撞的组合（精简+发出去读 P0 /

详尽+现场讲 P1 / 高管+60 分钟以上 P1）。核心洞察：每页正文有上下两条线 —— 上限由密度定、

下限由模式定（read 模式下限 180 字）。两条线一旦混成一条，「内容太单薄」这类差评就无从提前拦住。

② 新增 scripts/audit_content.py（内容层审计）：T1 标题必须表态 —— 以「整理 / 汇总 / 一览 /

概述 / 分析 / 总结 / 情况 / 工作」等 30 个词结尾、「背景 / 现状 / 下一步」整句当标题、

「SWOT 分析」这类框架名单独当标题，逐页判不合格，并给三个可套句型（判断句 / 对照句 / 归因句）；

T2 占位符残留 —— XXXX / ○○ / 20XX / lorem / TODO / Text 1 / 单击此处 / 请在这里输入，

按命中文本聚合输出。结构页（封面 / 目录 / 章节 / 封底）自动豁免。

③ 字体分三档（audit_glyph.py）：除原有高危禁用外，新增 F1「能装但字宽不准」

（Georgia / Impact / Consolas / 华文系列…）。这一档不阻断，但它会让 est_need_px 的

「1 汉字 = 字号 px、1 ASCII = 0.52」假设失准，真溢出的页面 A5 可能报 0 项，必须单独提示。

④ 交付四件套（scripts/deliver.py）：成品 + 逐页备注摘要（按版式给该页怎么讲，

按时长给每页建议分钟数）+ 结构解析 json + 变更清单 json（给 --origin 是逐条真 diff）。

⑤ 改旧稿交证据：revamp_old.py --fix 现在自动产出 _变更清单.json（每条改动定位到

页 / 形状 / 改前 / 改后）与 _体检报告.md（扫的是修后文件，证明已清零）。

⑥ 修两个真 bug：audit_glyph._iter_text_runs 遇到自闭合的 rPr 会把下一个 run 当成自己的

子元素（外部稿与客户模板全是这种写法 → G3 漏检、字体归错位）；槽位缺失与字体档位原本互斥

（continue 挡掉了「设了 Georgia 但没设 ea」这类最常见的写法）。

⑦ 骨架仍 36 种 × 六套色系四道门全绿，selfcheck 覆盖 18 个脚本 / 25 份说明书。

v7.0.0 新增（2026-10-26）：正文 6/7/8/9/10 个维度专属的 10 种排法（L42–L51）。此前 L04 最多 4 张卡、L05 最多 6 条、L09 最多 5 条、环形最多 6 个节点——正文一超 6 项只剩"截断"或"挤成一坨"两条路。本次补齐 L42 格阵卡 / L43 图标卡阵 / L44 通栏条带 / L45 双栏纵排 / L46 砖墙瀑布 / L47 环形阵列 / L48 阶梯阵 / L49 编号清单 / L50 分组矩阵 / L51 密排网格，6–8 项有 10 种可选、9–10 项有 9 种可选，选型口诀与每种的安全字数写进 layout_page 注释；骨架总数 26 → 36 种。配套修 preview_grid 一个老 bug：虚线描边的圆被画成圆角方框（虚线分支没看 geom，L47 的环线因此被误判"排版错乱"）。36 骨架 × 六套色系四道门全绿，selfcheck exit 0。

v6.9.0（2026-10-26）：① 循环版式补到 7 种——除原 L13（3–4 维粗环）/ L36（5–6 维正多边形）外，新增 L37 双环（外环阶段 + 内环节拍）/ L38 对向双列（左下行 + 右上行）/ L39 卡片环绕（围一桌）/ L40 阶梯闭环（上行 + 虚线回落）/ L41 蛇形折返（两行折返），并给出「先问循环语义、再挑几何」的七条选型口诀＋一条分水岭（正文见 layout_page 注释）；② 独立卖点「改旧稿」——scripts/revamp_old.py 三档（体检 → 清字 → 出大纲底稿），实测 66 页旧稿灰字 95→0、圈码 32→0；③ 独立卖点「照着客户模板做」——scripts/tpl_extract.py 拆面积加权配色 / 字体 / 字号层级并生成可跑骨架，实测客户模板出稿 P0 0 / P1 0；④ 描述开头新增擅长 / 不擅长边界声明；⑤ 26 种骨架 × 六套色系四道门全绿，selfcheck exit 0。

本 skill 是七份资产的合并终态（v5，2026-09-13）：

① 周慧慧的课程PPT妙招（教学导向强、反「丑/死板」的高保真模板库、教学模型、排版圣经、格式检查手册）；

② soe-premium-course-ppt 国企精品课程工作流 v2（内容工程前端：深度需求理解、行业研究、final_report 逐页可授课脚本、七维质量提升、国企商务风视觉规范、工作坊页面体系）；

③ 职场汇报PPT（workplace-ppt）（叙事框架与内容质量：八大场景叙事框架、标题结论化、素材降维、视觉导演六维、密度松紧松节奏、断行与列宽预留规则）；

④ guizang-PPT-Skill（视觉与排版纪律：P0 缺陷自检命令化、字号双约束与中文大标题降级、图片只裁底部、主题节奏表、视觉+代码双核对）；

⑤ 瑞士风演示文稿（swiss-deck-generator）（组件化版式：KPI 卡 / 分层架构 / 流程步骤 / 柱状 KPI 塔 / 时间线的构图逻辑）；

⑥ 授课课件生成器（teaching-ppt-generator）（教学课件工程：八项设计确认、逐页生成 + 文字防溢出硬规则、演讲备注拆分、质检清单）；

⑦ 用户提供的 8 套真实 PPT 模板（封面 / 章节 / 流程图逆向提炼：cover-and-diagram-library.md 的封面 6 范式 + 正文图表 8 形态 + 照抄级实测坐标）。

分工：① 负责「怎么把每页做得漂亮且可交付」，② 负责「前端把课程内容与国企/工作坊场景吃透」，③④⑤⑥ 补齐「内容质量与排版美学」，⑦ 给出封面与流程图的现成范式与坐标，全部收口到本 skill 的三类缺陷防治与可执行自检。合并后只保留一份技能（「周慧慧课程PPT」），避免多触发冲突。

生成任何页面时优先套用 references/premium-templates.md 的高保真骨架，禁止裸排。 国企 / 央企场景在此之上叠加 references/visual-design-spec.md 的九套配色、8px 网格与三级阴影，以及 references/layout-pattern-library.md 的 28 版式纪律。

做封面 / 目录 / 转场 / 封底时，直接查 references/plane-hero-family.md 抄坐标（四页共用一套斜面折带骨架：纸白 + 右侧三层斜切面 + 45° 角块 + > 折带；旧六套封面范式函数已全部删除）。做正文图表时查 references/cover-and-diagram-library.md 的 8 形态。卡片一律不加顶部通栏色条。

任何课件交付前，references/anti-defect-playbook.md 的 P0 条目必须全过。

做「存量课件重做」（把别家企业 / 别的行业的旧 PPT 换轨重制）时，先读 references/anti-defect-playbook.md 的《场景特例：存量课件重做》一节再动手——原稿若是外包套模板产物，只改文字会越修越脏，应当直接新建空白稿重排；且必须「先统一字号 ≥14pt，再调版式」，顺序反了要返工两遍。

⚠️ 渲染轨道说明（开工前必读，否则会白做）

本 skill 的参考文件里存在三种历史代码形态，它们都不是当前环境的执行轨道，只当作「构图与参数说明书」读：

• references/premium-templates.md / page-templates.md 等 —— PPTD（YAML）形态；
• references/visual-design-spec.md §九、layout-pattern-library.md §J —— HTML/CSS 形态；
• references/pptd-checker.md 提到的 check.sh（/app/.agents/skills/pptx/...）—— 该路径在本环境不存在，检查器无法运行。

当前环境有两条可执行轨道：① 默认 tencent-pptx 技能（产出 .pptx，按 DESIGN.md + STORY.md 组织项目目录）；② 本技能自带的 scripts/pptx_kit.py 自渲染轨道（见下方「⚙️ 可执行渲染轨道」，适合需要精细控制版式、或需要机器替你抓乱码与版面缺陷的场景）。

正确用法：从上述文件中提取字号档、间距刻度（8px 网格）、圆角、阴影层级（L1/L2/L3）、配色比例（60-30-10）、元素分区与视觉动线，再翻译成 tencent-pptx 能落地的版式与参数。

若用户要的是 Ardot 设计稿（设计稿/mockup/画布，而非 .pptx 文件），则改走 ardot-slides 技能。

v3 增量（2026-09-04 三合一）：① 统一技能名与单一入口，消除「周慧慧的课程PPT妙招」与「soe-premium-course-ppt」的双触发冲突；② 补齐渲染轨道说明（PPTD/HTML 降级为说明书，主轨道 tencent-pptx）；③ 补齐七维质量提升的完整论述（问题 / 标准 / 为什么）；④ 新增「适用与不适用场景」边界；⑤ 新增交付验证清单与回复规范；⑥ 参考资料从 3 份扩到 13 份。

v2 增量（2026-09-02 合并）：新增工作坊两维质量门（维度六互动设计 / 维度七讲师备注与节奏）、6 种工作坊专属页面类型、讲师备注四要素、能量曲线与节奏设计、4 种互动设计模板、8px 基准网格、L1/L2/L3 阴影层级、60-30-10 配色面积法则、6 大专业设计原则、6 个核心组件骨架、视觉动线与骨架交叉引用。

v2.1 增量（2026-09-02 专家增强）：新增 references/expert-beautification-tips.md 专家级排版美化锦囊——覆盖配色进阶（让主色"贵"）、字重节奏、图表美化、图片处理、留白呼吸、反 AI 味视觉清单、一致性 design token、封面封底进阶八大主题。与 visual-design-spec.md 的硬规范互补：规范是"必须做"，锦囊是"做了更好"。

v4 增量（2026-09-13 缺陷防治 + 可执行化）：新增 references/anti-defect-playbook.md《版面缺陷防治手册》——把「乱码 / 丑 / 死板」三类顽疾拆到「现象 → 根因 → 修法 → 自检」四级；新增 scripts/ 四条可执行轨道（安全渲染工具箱 pptx_kit.py、版面自检器 check_layout.py、缩略图预览器 preview_grid.py、冒烟测试 build_demo.py），技能从「纯说明书」升级为「可执行 + 可自检」；纠正原文件里两处会导致 .pptx 乱码/变丑的错误建议（CSS 字体回退链、稀有展示字体）。

v5 增量（2026-09-13 封面与图表范式库）：① 新增 references/cover-and-diagram-library.md——从用户提供的 6 套真实 PPT 模板逆向提炼封面 5 范式、章节页 3 式、正文图表 8 形态，附照抄级实测坐标与"为什么好看"的设计意图；② pptx_kit.py 新增封面组件 cover_minimal（v2 加固：左竖条 + 右上浅圆 + 引题刻度，解决"封面大片空白像没做完"）、cover_photo / cover_center / cover_band / section_band、目录 toc_columns、图表 flow_cards（新增 cards=True 白卡浮起 + 中间卡加重）/ flow_steps / flow_stairs / flow_hexchain / flow_timeline；③ 新增 decor() 装饰豁免机制（DECO_* 命名 → 自检器豁免出血）；④ preview_grid.py 升级支持圆角矩形 / 椭圆 / 三角 / 箭头 / 六边形 / 平行四边形 / 梯形 / V 形及旋转，并修正原「用 shape_type 判几何形状」的 bug（导致圆角与三角一直画成直角方块，预览与实际不符）。

v5.1 增量（2026-09-13 下午 · 按用户反馈重做封面 + 清除 AI 痕迹）：① 新增 cover_solid 范式 A6 满版主色封面（逆向自用户追加的「上季度工作汇报-稻壳儿」「年中总结汇报」两套模板：满版品牌色底 + 首行跳色 pop/次行纯白大标题 + 细线夹字 meta 组 + 仅 3 处弱装饰）——解决"封面还是太丑"；Theme 新增 pop 跳色槽位（九套配色各配一枚，深蓝底配琥珀 #F2A413）；② 清除"一眼 AI"痕迹：flow_cards/flow_timeline 删除卡片顶部通栏色条（用户亲手圈出的红线），改实心编号徽章 + 投影层级做主次；③ 治"颜色太淡"：九套主题 tint 全部加深一档（如 #E8EEF5→#D5E2F0），时间线主轴 _lighten 系数 0.55→0.25；④ anti-defect-playbook.md 新增 B11「一眼 AI 的版式痕迹清单」（8 条，含通栏顶条、emoji 项目符号、蓝紫渐变发光等）+ B9 补"辅助色不许淡到隐形"；⑤ _bg/_gradient_bg 自动 decor() 报备，满版主色封面不再误报 B2 色面积。

v5.2 增量（2026-09-13 下午 · 照片蒙版封面 A2 做实，红色系验证）：① cover_photo 补三个参数 —— mask_color（蒙版颜色，默认取主题主色深调而非纯黑，避免照片封面变成"大面积黑"、丢品牌色）、scrim（全幅均匀压暗，压掉照片里的杂物）、title_size；② 汇报人胶囊改为实心白底 + 主色字（原"主色底白字"会融进同色蒙版，实测翻车）；③ 修正 h_title 行高系数（60pt 单行实际约 96px，原系数偏小会与下方细线相撞）+ 标题/日期下移让出安全区；④ image_fill / mask_overlay / scrim 自动 decor() 报备——满幅背景图与蒙版是"底色层"，不再误报 A5 越界与 B2 色面积；⑤ preview_grid.py 支持半透明渐变层（新增 shape_alpha_gradient + make_alpha_tile，抠区域 → alpha 合成 → 贴回）——此前蒙版会被画成实心色块盖住半张照片，导致"预览很难看、打开却正常"的假象；同时把图片裁剪从"顶部对齐"改为居中（与 image_fill 一致）；⑥ 新增 scripts/build_cover_photo_demo.py（红色系两版对比）+ scripts/assets/sample-photo.jpg 内置示例照片；⑦ cover-and-diagram-library.md 的 A2 章节补「防丑七条」（蒙版用主色深调 / 必加 scrim / 胶囊白底 / 选图要一侧天然偏暗 / 去 AI 水印）。

v5.3 增量（2026-09-13 晚 · 按用户要求新增「开工双确认流程」）：① 新增 S0 首次调用必填信息清单（8 项 + 缺失默认处理 + 一次性列完 + 确认前禁止生成），杜绝"信息不全就开做、做完再返工"；② 新增 S1 九个关键节点多方案选择（大纲结构 / 叙事逻辑 / 视觉配色 / 版式模板 / 每页要点 / 数据呈现 / 文案语气 / 动画转场 / 演讲备注），每节点 2–3 个异质方案 + 适用场景 + 取舍 + 推荐标记，选定后才进下一节点；③ 新增 references/kickoff-and-options.md（完整话术、速选池 27 张方案卡、决策记录模板、5 套兜底套餐）。原有 8 步工作流、三类缺陷防治、封面图表范式库、可执行脚本全部保留不变，S0/S1 只是插在其前面的强制前置动作。

v5.5 增量（2026-09-14 · 科技风风格预设 + 一句话入口）：① 新增 references/tech-style.md——从《商机破冰到赢单（第一单元）· 苏州移动政企》16 页逆向提炼的科技风规范（配色色值表、字体层级表、8px 网格与留白表、六种页面类型结构、15 类科技装饰元素、图表与图片处理风格、七个坑、交付自检清单）；② pptx_kit.py 新增主题 THEME_TECH（冰蓝亮色 #0A5CFF）/ THEME_TECH_DEEP（深空蓝） 与科技风页面底色 tech_bg()（ice 冰蓝渐变默认 / grid 密网格 / deep 海军蓝 / split / white）；③ 新增 15 个科技装饰组件：tech_dots / tech_grid / tech_streaks / tech_ring / tech_brackets / tech_circuit / tech_cube / tech_dial / tech_scan / tech_badge / tech_slash / tech_card / tech_progress / tech_stat / slider_scale / grade_bar / tech_table / tech_hdr / tech_banner；④ 新增三大页面范式 tech_cover（封面 T1）/ tech_section（章节过渡 T3）/ tech_end（结尾页 T6）；⑤ 新增风格预设注册表 K.style("科技风" | "科技风深色" | "蓝调商务" | "默认") → Style 对象，.cover() / .page() / .section() / .end() / .bg() 一句调用，从此不必记组件名；⑥ 新增 scripts/build_tech_demo.py（7 页样板：封面 / 目录 / 章节过渡 / 九宫格内容页 / 数据评分页 / 左文右表 / 结尾页）；⑦ 修正两个"预览陷阱"——装饰改「两色混合纯色」替代半透明（预览器不合成 alpha 会画成实心重色）、默认不再用渐变字色。原有 8 步工作流、三类缺陷防治、封面图表范式库、蓝调商务风、可执行脚本全部保留不变。

v5.4 增量（2026-09-14 · 蓝调商务风范式库 + "不要大面积白"）：① 新增 references/blue-biz-style.md——从用户提供的真实政企课件《商机破冰到赢单（第一单元）· 苏州移动政企》16 页逆向提炼的蓝调商务风范式库（配色体系、五种子色系铺底、页眉与标签体系、八种信息密度型版式、照抄级坐标、七个坑）；② pptx_kit.py 新增主题 THEME_BLUE3D（亮蓝 #1E6BF1 + 青/紫/橙彩色点缀）与 Theme.extra / Theme.accent_at() 彩色辅助序列；③ 新增页面底色体系 page_bg() + deco_blobs()——blue 淡蓝渐变（默认）/ split 左蓝右白 / deep 主色深底 / solid 满版主色 / white 慎用，白只留给卡片、卡片浮在有色底上；④ 新增 15 个蓝调组件：hdr_blue / tag_skew / tag_pill / num_block / grad_bar / grad_num / icon_block / kv_card / check_card / time_chip / chevron_row / progress_rail / banner_note / score_table / cover_blue3d；⑤ 新增 scripts/build_blue_demo.py（7 页样板：封面 / 单元扉页 / 九宫格痛点墙 / 左蓝右白对开 / 任务三连 / 单元回顾 / 评分量表）；⑥ 修正自检器两个真缺陷——色面积由"跨页累加"改为按页统计（否则每页 9% 的浅色底会假超标成 55.8%）、相邻卡片边界共线导致文本被归入上一行容器的假溢出（改用严格包含）；⑦ 面积法则升级为「底 55–65% + 白卡 20–28% + 主色 12–18% + 彩色点缀 5–8%」。

v6.0 增量（2026-09-23 · 事业单位/工作汇报轨 + 用途定位 + 可分享安装）：① 新增 references/use-cases.md——S0-0 三问定场景（用途 / 场合与受众 / 风格）+ 十类用途总表（骨架 / 页数换算 / 推荐套餐 / 推荐风格 / 必备页面 / 特有红线）+ 九选一的风格菜单（当时 K.STYLES 为 8 套独立预设 S1–S8 ＋ 1 组组合式 S9；v6.1 起增加 S9 紫色商务、组合式顺延为 S10，口径变十选一）+ 用途→风格推荐矩阵 + 用途→必备页面清单；② 新增 references/gov-report-style.md——事业单位与工作汇报风格规范（配色 / 字体层级 / 网格 / 页面类型 G1–G9 含照抄坐标 / 事业单位特有十项元素：红头页眉、密级标注、落款日期、三线表、公文编号体系、数据口径注释、图表规范、专名表、涉密脱敏、附件提示 / 六段式与四段式叙事框架 / 八条红线 / 交付自检清单）；③ pptx_kit.py 新增主题 THEME_GOV 政务红蓝 / THEME_GOV_BLUE 政务蓝、底色 gov_bg() 四式（paper / paper2 / tint / deep）、九个政务组件（gov_hdr / gov_footer / gov_cover / gov_toc / gov_section / gov_card / gov_kpi_row / gov_table / gov_end）、字距工具 text_spaced()；④ Style 家族扩到 tech / biz / gov 三族，预设从 4 套扩到 8 套（K.style("政务红蓝"|"政务蓝"|"央企深蓝"|"党建红"|"科技风"|"科技风深色"|"蓝调商务"|"默认")）；⑤ 新增 scripts/build_gov_demo.py（8 页事业单位工作汇报样板，自检 P0=0/P1=0）；⑥ 新增 scripts/selfcheck.py（一键安装自检：依赖 / 文件完整性 / 四套样板生成 + 严格自检 / 检查器自证 / 风格清单）；⑦ 新增根目录 README.md 与 INSTALL.md（对外介绍与安装排错），技能从此可打包分享给他人；⑧ audit_color.py 新增 --allow-warm（本轨色板含暖色的轨道放行暖色，只判越界色与灰字——适用 橙红 / 政务红蓝 / 党建红 / 蓝调商务（其 #F5A623 编号块·图标芯片·刻度点点缀会被默认模式误判）。口诀：风格色板上写了橙/红/黄的，就加这个参数）；⑨ 修正四个实测坑：gov_card 项目符号重复、政务巨号数字与单位同行折行、_lighten(主色, 0.78~0.82) 浅调被 color 审计判为越界色、封面汇报人 / 职务同行折行。原有能力（8 步工作流、三类缺陷防治、封面图表范式库、蓝调商务风、科技风、可执行自检）全部保留不变。

v6.1 增量（2026-10-11 · 并入《紫色商务风提示词手册》＋ 固化四条硬规）：① 四条硬规升 P0（文字零灰 / 全 16:9 / 任意连续 10 页版式不重复 / 新增图文混排）——pptx_kit 的 TECH_INK/TECH_INK_DEEP/TECH_GREY/GOV_INK 与 cover_minimal 的两处显式灰字全部改纯黑，新增 TEXT_BLACK/TEXT_WHITE 纪律常量；② 新增线条式标题带 title_band_line() ＋ 底层 _slant_bar()（PARALLELOGRAM + adjustments 斜切），S.page(..., band="line") 与紫色商务轨自动启用——这是「页面标题排版」的默认形态；③ 新增图文混排四骨架 img_text_page(kind="left"|"right"|"top"|"card") ＋ 图片区 img_panel() ＋ 居中 cover 裁剪工具 _cover_crop_tint()（只裁不拉伸、叠加主色罩、圆角 16px，圆角外补页面底色以保证「预览 == PowerPoint」）；④ 新增版式登记与节奏审计 —— tag_layout()/layout_tag() 把 LAYOUT=Lxx 写进 <p:cSld name>（页面上看不见，大纲视图可见），LAYOUT_CODES 提供 L01–L24 语义表（含 L14–L17 四副图文骨架），新增 scripts/audit_rhythm.py（滑动窗口查「连续 N 页版式不重复」＋ 未登记 / 非法编码，含 --selftest）；⑤ 新增紫色商务风轨道 THEME_PURPLE / purple_bg() / cover_purple() / purple_section() / purple_end()，K.style("紫色商务") 等 7 个别名可用，STYLES 从 9 个键扩到 10 个；⑥ 新增 references/purple-biz-style.md 与 scripts/build_purple_demo.py（12 页样板，12 种版式编码，P0=0 / P1=0）；⑦ 修三个实测坑：THEME_PURPLE 必须定义在 STYLES 注册表之前（否则 NameError）、purple_bg 深底别名 violet-deep 漏认会静默落回亮底导致深底白字铺到浅底上隐形、preview_grid 的平行四边形/梯形原先不读 adjustments（斜切条会画成固定 0.25 预设，预览与实际不符）；⑧ check_layout.py 对 IMG_ 前缀图片豁免「图片比例」P1（cover 裁剪在实现上不可能比例失真）；⑨ selfcheck.py 扩到 13 个脚本 / 21 份说明书 / 7 套样板 / 3 个检查器自证。

v6.2 增量（2026-10-20 · 科技风下线 ＋ 章节页统一 ＋ 全色系回归 ＋ 审计器判据修正）：① 科技风下线——用户判定「科技风 PPT 质量太差」，STYLES 从 10 套收敛为 8 套，删除 references/tech-style.md 与 scripts/build_tech_demo.py，Style 家族由 tech/biz/gov 收敛为 biz/gov/purple（tech_* 底层函数保留供历史调用，但不再作为可选风格暴露）；② 章节页统一——新增 section_premium()（墨绿格式定版：深底 + 左轴巨号编号 118pt + 白标题 42pt + 琥珀短横 + 副标题 + 3 条要点 + 右侧压边三段竖柱），Style.section() 全色系一律走它，彻底消灭「白底 + 一条色带」的大面积留白（原 P0-2）；新增 end_premium() 作为商务轨统一结尾页，替代 tech_end；③ 配色审计器判据修正——audit_color.py 判暖色改为按色相（330°–45°、彩度 ≥0.10）＋ 中性容差 14→24，修复「橙红默认轨 50 处越界色 → 过不了自己的审计」（现为 0 处）；--selftest 增补「浅橙 tint / 深棕」两条反证，防止判据再退化；④ 新增全色系回归 scripts/build_all_styles.py——同一套内容横切 8 个色系 × 8 页（封面/目录/章节/左图右文/时间线/表格/大字报/结尾），逐套跑三道门并输出对照表，--only green 可单跑、--no-check 只生成；⑤ 接口与观感修补——gov_end 补 title2（跨色系脚本不再在政务三轨 TypeError）、cover_purple 的 en/org 改纵向流式（修 B3 遮挡）、purple_end 支持 (主句, 说明) 二元组、kv_card 描边由 soft(0.66) 加深到 soft(0.55)（浅底白卡不再糊成一片）、save() 增加版式登记缺失告警；⑥ 「任意连续 10 页版式不重复」升为第一硬规——每页必须登记编码，任一页漏登记即不合格，交付前 audit_rhythm.py E1/E2/E3 三条全绿才允许交。

v6.3 增量（2026-10-20 · 曲线照片族 ＋ 五个图形正文版式 ＋ 色系收敛五套 ＋ 提示词结构）：① 色系收敛为 5 套（用户指定）——STYLES 只剩 党建红 / 紫色商务 / 橙红 / 煤化工墨绿 / 央企深蓝，蓝调商务、政务红蓝、政务蓝连同 build_blue_demo.py / build_gov_demo.py 一并下线；② 新增「曲线 + 照片」版式族——paper() 纸白底 + title_band() 标题带（34pt 标题 + 6px 细横线）+ hero_cover() / hero_toc() / hero_section() 三页共用一条 S 形贝塞尔色块（ribbon()，7px 纸白描缝）；③ 新增五个图形正文版式（对应用户《红色系正文版式》五页实测坐标）——L31 curve_chain 波浪串联 / L32 stat_circles 压边大圆四列 / L33 ring_hub 中心圆环 / L34 pyramid_steps 金字塔四层 / L35 diamond_array 菱形错位阵列，彻底取代「一排等高白卡」；④ 新增自定义几何能力 bezier() + smooth_curve()（custGeom 三次贝塞尔，PowerPoint 可直接编辑），preview_grid.py 同步支持解析 custGeom / 虚线 / 裁剪图，预览与 PowerPoint 一致；⑤ 修两个渲染器真 bug——MSO_ANCHOR 取值被误判（MIDDLE=3 被当成底部对齐，导致所有「垂直居中」的文字在预览里整体下沉）、DECO_ 前缀底图被 B7 误判「图片比例非标准」；⑥ 新增两份说明书 curve-photo-hero.md（含图片生成提示词 7 段式：画面类型/版式骨架/分隔图形/配色/照片主题/留白纪律/质感画质 + 三套成品提示词 + 负面词）与 curve-photo-layouts.md（坐标与雷区）；⑦ build_all_styles.py 升级为 5 套 × 10 页（正好压住「连续 10 页不重复」这条第一硬规）。

v6.4 增量（2026-10-20 · 头部四页全面替换 ＋ 正文图形版式重做 ＋ 色系收敛五套 ＋ 开篇三问）：① 头部四页一次性替换——逆向《封面-目录-转场-封底的样例.pptx》（slidep screenshot 真实渲染 + 母版 custGeom 抠绝对坐标 + 逐行扫像素）得出斜面折带族：纸白 #FEF7F5 + 右侧三层斜切面（切点 739 / 872 / 1232，斜率 −0.42）+ 左下 45° 角块（x 截止 311）+ > 折带推进器（顶点 (392,360)、厚 120）；plane_cover / plane_toc / plane_section / plane_end 四页共用一套骨架；旧六套封面函数 + toc_columns + section_band + section_premium + end_premium + hero_* + ribbon 共 24 个函数全部删除（pptx_kit.py 净减 843 行）。② 正文图形版式重做——按用户《红色系正文版式.pptx》五页实测坐标，保留四个可用版式并全部重画：L31 wave_arrow / L32 circle_cards / L33 ring_callout / L34 pyramid_tiers；第 5 页菱形错位阵列判定「难看」并删除（原 L35），理由：210 菱形内接正方形只有 148，正文塞进去必然压斜边。③ 色系收敛为五套（用户指定）——STYLES 只剩 orange / party / purple / grid / cmcc；新增 THEME_SGCC（国网绿 #005A53 / #00997A，PANTONE 3292C）与 THEME_CMCC（移动蓝 #0085D0 / #00A0E9，PANTONE 3005C）；煤化工墨绿 / 央企深蓝 / 蓝调商务 / 政务两轨全部下线。④ 新增开篇三问——scripts/survey.py 输出「用途（六类）/ 色系（五套）/ 文字密度（三档）」问卷卡，三问定风格与信息量，替代原来含糊的「风格偏好」；S0-0 与 S0 第 3、5 项同步改写。⑤ 标题带改版——title_band() 改 32pt 标题 + 13px 主色横条 y=100（原 6px / y=116 力度太弱），kicker 上移 y=6 避免 B3 判遮挡。⑥ 修六个实测坑——_mix() 方向搞反导致角块与折带全成深色块（t 小才是浅色）、circle_cards 照抄参考稿 379 框高留大块空气（改按 _est_lines 自适应）、圆环正文挤成 3 行窄柱（列宽 196→290）、金字塔标签 250 断行（改 272）、audit_color 目录条目标题灰字 4 处、flow_timeline 卡高 126 溢出（改 158）。⑦ 五套 × 10 页全量回归全绿（P0=0 / P1=0 / 越界 0 / 灰字 0）；selfcheck.py 改 10 脚本 / 23 说明书 / 1 样板 + 回归入口 / 5 风格。

v6.5 增量（2026-10-20 · 色系扩容到六套 · 正红色系上线）：① 新增 正红色系 —— K.style("正红色系")（key red；主 #D9241E / 辅 #A3150F / 浅 #FBDCD8 / 跳色金 #F5B01A / 渐变 #EE5A48；别名 正红、大红、中国红、年会红、表彰红、庆典红）。与党建红 #A4202C 明确分工：正红 = 年会 / 表彰 / 庆典 / 开业 / 节庆 / 销售冲刺（明快有冲劲），党建红 = 党建 / 主题教育 / 事业单位汇报（偏暗庄重）；政治题材一律党建红，喜庆场合一律正红，不混用。② chevron() 折带取色加深（_mix(pc, primary, 0.74→0.84) / 0.96→0.99）：原来混进太多纸白，亮色系（正红 #D9241E、橙 #E85D04）的转场折带被稀释成"珊瑚粉"，正红系尤其明显；加深后折带压得住主色，六套色系一并受益。③ 配套同步：survey.py 第二问改六选一（"员工活动类"默认色系同步改为正红色系）、build_all_styles.py 把 red 加入暖色轨（audit_color --allow-warm）、selfcheck.py 预设检查期望 6 套；六套 × 10 页回归 P0=0 / P1=0 / 越界 0 / 灰字 0 / E1E2E3 全绿。

v6.6 增量（2026-10-21 · 实课体检后的三项加固：15 页窗口 ＋ 版式总量上限 ＋ 乱码字符门）：

起因是用户拿 v6.5 实跑了两份课件（28 页《把一天过明白》、47 页《WorkBuddy 实战》），学员反馈「部分页面乱码」「排版相似度特别高、重复比较多」。逐页拆开后定位到三条真因：

① 乱码真凶不是字体，是字符——两个文件 477/743 个 run 的 latin/ea/cs 三槽位 100% 齐全（latin=Arial、ea=cs=微软雅黑），字体链没问题；问题在 47 页那份的 P43 用了 ①～⑯ 共 16 个圈码、P10 用了 ⋯。圈码 Unicode 归「带圈字母数字」（U+2460–24FF），PowerPoint 判给 latin，而 Arial 缺 ⑪ 之后全部圈码 → 学员机器上变方块。本机不报错、换机就崩，只能靠清单拦，不能靠肉眼。

② 版式重复是判据漏了——旧 audit_rhythm 只判「连续 10 页」，47 页那份里 L03 用了 4 次、L11/L20/L22/L04/L05/L09/L21/L13 各 3 次，但间隔都散在 10 页以外 → 全部放行。几何指纹另证：P5/P15/P25/P35 结构完全相同（24 个形状、尺寸量化一致），正好每 10 页一轮。

③ 章节页没变体——4 个章节页全是同一种 L03，加重了"每章长得一样"的观感。

对应三项加固：

（1）判据收紧：audit_rhythm.py 窗口 10 → 15，新增 E4「同一正文版式全篇 ≤2 次」、E5「封面/目录/封底各 1 次」、W3「章节页 >3 个必须 ≥2 种变体」；selftest 从 3 条扩到 5 条，逐条造违规样例试咬（现五条全 ✅）。

（2）组件补变体：plane_section() 新增 variant="A"/"B"/"C" 三套视觉——A 纸白浅调（原样）/ B 深底反白（折带亮于底色 + 白色标题）/ C 巨号编号（150pt 编号压折带 + 左侧主色竖条），登记 L03A/L03B/L03C；S.section(..., variant="B") 直接用。save() 从"只警告未登记"升级为保存即点名四类问题（未登记 / 正文超 2 次 / 15 页重复 / 高危字符页码）。

（3）新增乱码门：scripts/audit_glyph.py —— G1 高危字符（圈码 / emoji / ⋯，附 U+ 码点）/ G2 字体链（latin 必须 Arial 系、ea/cs 必须中文字体）/ G3 三槽位缺失；--fix 输出.pptx 把圈码就地换成 (1)(2)…。selfcheck.py 脚本数 10 → 11，--selftest 纳入第 4 步。

v6.6b 增量（2026-10-21 · 判据收紧后的配套扩容：正文骨架 11 → 20 种）：

为什么必须跟着扩：「同一版式全篇 ≤2 次」这条硬规一落地，47 页课件就要 20 种骨架，而 v6.5 真正「一行出一页」的只有 11 种（其中 4 个是图形族）—— 判据不放宽、组件不扩容，等于让人无路可走，只能偷偷复用。

① layout_page() 成为正文唯一入口：新增 5 个整页版式 —— L07 中心辐射（实心环 + 四角卡）/ L10 汇聚式（n 卡向下汇成一条成果带）/ L13 环形循环（渐变环 + 右侧条目）/ L16 通栏带 + 卡（无照片版上图下文）/ L21 甘特进度轨（时间刻度 + 阶段条），并把 v6.4 的 L31–L34 图形族接入同一入口（BODY_LAYOUTS 路由 + 字段归一化 title/head/label）。合计 20 种骨架，一行一页、自动铺底 + 标题带 + 登记编码。

② note 落位定死：L05/L08/L09/L12/L22 内部无 lead 位 → 统一落 y=122（标题带正下方）；图形族内容铺到 y=640 → note 只能落 646–678、宽 1000（避开页码）。放 640 以内必然压图，check_layout 的 B3 会报。

③ 八个实测坑（都已在代码里修掉，写下来防回归）：13.5pt 也算「低于 14pt」（B1 不看整数，别指望四舍五入）；L22 三行 0.035 斑马纹合计 27.6% 触发 B2 → 去掉底纹只留细线；L10 成果带原高 152 占 21.4% → bh2 = min(152, …)；变体 C 的 150pt 编号压住英文小标 → 英文标下移到 y=340（仅 C 生效）；章节页 en 原本在 plane_bg() 之前画、被底色盖掉 → 移到函数末尾最后画；L19 巨号字「说清楚」在 118pt 折行压正文 → _bg_sz = min(118, 300/len(txt)) 按字数回算；卡内 • 项目符触发 H1 → 用 bullet="" 或改画小方块；_brand 机构名 w=300 装不下「中国人民财产保险股份有限公司」→ 按 len*27+14 算需求宽度、左下角左端固定向左扩。

④ 回归与验收：六套色系 × 26 页四道门全绿（暖色轨加 --allow-warm）；两份重做稿 —— 29 页 / 19 种版式、47 页 / 20 种版式各 2 次，check_layout --strict P0=0 P1=0、audit_rhythm E1/E4/E5 全 ✅、audit_glyph G1/G2/G3 全 ✅、audit_color 无越界色无灰字。比旧稿：15 页窗口撞版式 14 处 → 0 处，圈码 16 个 → 0 个，体积 141MB → 142KB。

v6.8 增量（2026-10-26 · 循环图结构重做：把"左图右列表"改成"标签贴外圈"）：

学员拿 v6.7 出的五维样例反馈"第 2 页排版太丑"，并自己拖了一版正确的排版（五维循环样例-修改.pptx 第 3 页）。

对照后确认丑的不是配色、是结构，三条真因：

① 编号说了两遍 —— 节点上标 01–05，右栏列表又标一遍 01–05，等于把同一件事说两次；

② 图形与文字割裂 —— 左边一张图、右边一份列表，中间一大块空，读的人要在两个区域之间来回对照才能知道"第 3 步画在图的哪儿"；

③ 重心偏左 —— 图形只占页宽 25%，沦为装饰，真正的内容全在右栏。

改法：图形居中（cx=640）+ 每个标签贴着自己的节点绕外圈排，对齐方向按方位定 —— 上/下居中、左侧右对齐、右侧左对齐，即"文字一律朝图形靠"，眼睛从节点移到文字是连续动作。

同一个病 L13 也有（左边粗环 + 右边四行列表），一并改：环改浅底 + 主色描边（原实心渐变 386px 的红块视觉重量远大于四个标签，页面重心被环吃掉），四个节点贴在环上、标签绕外圈。两个版式现在只差节点数，视觉语言统一。

落地细节：标签高按最长正文回算（TH = 26 + 22×行数 + 6），再由 TH 反推多边形半径与圆心，任何文案量下都不压边、不出页；五边形两个底角标签各向内收 45px（否则 250 宽的框左右必重叠）；环厚定为 节点直径 + 8，让节点内缘与内圆留 4px 空隙 —— 不留给缝，节点会压进内圆 3px，check_layout 的 A5 会把节点编号当成"内圆容器里的文字"判溢出（实测误报一次）。

另修工具链：preview_grid.py 缺中文标点禁则，把"…下周照做。"断成"…下周照做" + "。"，末行孤零零一个句号，看图的人以为版式崩了 —— 而 PowerPoint 自己会做禁则。预览必须和 PowerPoint 长得一样，否则每次看图都在误判版式（本轮连续误判两次）。现已补行首禁则 + 行尾禁则。

回归：六套 × 21 骨架四道门全绿；selfcheck 六步 exit 0。

v6.7 增量（2026-10-26 · SkillHub 反馈闭环：灰字清零 + 五六维循环图 + 图形页错乱 + 安装即红叉）：

市场侧数据：下载 427、评分 1 分、显示版本 V1.0.2（包内实际是 6.6.x 内容）。逐条复现学员反馈后改五处：

① 灰字判据升级——旧判据「通道差 ≤10」只咬得住 #595959 这类中性灰，冷蓝灰 #8C9BA8 被判成"蓝系合规"，学员看到的就是"字是灰的"。改按 HLS：饱和度 ≤0.20 且亮度 0.18–0.97 即判灰（#8C9BA8 / #AEB6C2 全落网，近黑 #1A1A1A 与主色深浅派生放行）。同一份旧稿，旧判据报 49 处、新判据报 95 处。

② 两条路一起修灰字——audit_color.py --fix-grey 输出.pptx 一键把灰字改成浅底纯黑 / 深底纯白（按所在页底色亮度判，学员手里的旧稿也能直接修）；K.save() 默认 auto_fix_grey=True，落盘前自动扫一遍，实测旧稿 95 处 → 0 处。

③ 五/六维循环图——ring_callout（L13）只在环上放 4 点，传 5–6 项被 items[:4] 静默丢掉（"五个维度出不来"的真因）。新增 L36 cycle_polygon：n 个节点摆在正五/六边形顶点、顺时针三角箭头连成闭环、中心母题 + 右侧 n 行条目；layout_page("L13", items=6 项) 自动改走 L36。L13 顺带修 12.5pt→14pt、右侧条目等分到内容区下沿。

④ 图形页"文字错乱"四处真因——L31 波浪页首尾节点的文字框被夹到页边、框心偏离节点最多 59px → 改按 half=min(118, ax-56, 1232-ax) 始终居中；L32 压边大圆卡片只铺到 y≈480、下半页 160px 全空 → 圆放大到 176、卡片铺到 596、标题下补细分隔线、正文 15pt；L33 虚线气泡固定 152 高但两行正文只占 100（"框比字高、框里全是空气"）→ 按 _est_lines 回算高度 118 起；L34 金字塔编号与条目顺序相反（items[0] 在顶层却标 04，学员照编号念就念反）→ 改 row+1，顶层 01。

⑤ 装了就是红叉——SkillHub 安装会丢弃 scripts/assets/，selfcheck 第 3 步报 ❌「示例照片缺失」。这张图只服务照片样板、不影响任何功能，改为 ⚠ 提示不计失败（否则学员装完第一屏就是红的）。

另修两处工具链：preview_grid.py 带描边的椭圆被画成矩形框（违反"预览要和 PowerPoint 一样"，圆环页因此被误判错乱）；layout_page 入口加容量告警——任何版式传入项数超过容量都打印"后 N 项未绘制"并计入 save() 汇总，不再静默截断。

回归：六套 × 21 骨架四道门全绿；selfcheck 六步 exit 0（安装版实测同样 exit 0）。

v5.7 增量（2026-09-21 · 改版重制工程纪律，对标「只重写某一章、其余已定稿」的活儿）：新增 references/anti-defect-playbook.md 缺陷五 E1–E4——① E1 zip 部件重名：drop_slides 删 sldIdLst 后 add_slide() 新建的 part 会复用「已删但仍在包内」的 part 名 → save() 抛 Duplicate name: ppt/slides/slideNN.xml，PowerPoint 提示修复；正解是复用既有页面载体（_clear 清空 spTree 重画）而不是删页后新建（13 页只新建 5 页、复用 8 页），配套坑是页序平移必须 base_n = len(sldIdLst) - len(rest)（取"最后一页"会把整段逆序）；② E2 生成侧自检必须用「卡片容器口径」——只写 _ck(文本, 框宽, 字号, 框高) 查不出卡内溢出（本轮漏检 22 处 A5），正确口径 avail = card_bottom - CARD_PAD(8) - box_top 与 check_layout 的 A5 同源，封装 _ckc / _ckp；③ E3 一页列数 ≥6 时不要放两行以上正文——窄卡里 12pt 一行只放 11~12 字，写 20 字必折行且第二行只坐 3~5 字，属结构性孤行、改文案改不完；≥9 项改「左右两栏速览清单（每项一行 ≤20 字）」后孤行与尾行同时归零（附项数→容器→正文上限对照表）；④ E4 定稿页只允许技术性修补 + 独立打印——_fix_base.apply() 五类客观缺陷（补 a:ea/a:cs、删空文本框、名义 normAutofit→noAutofit、明显笔误、12pt→14pt），凡是动了字号必须重跑 audit_text.py（本轮 P05 动了字号立刻冒出新孤行）。配套给 xlsx-formula-cache-inject 补两行关键坑：openpyxl.save() 会抹掉已注入的 <v>，顺序必须是「设重算 → save → 注入」，注入后绝不能再 save；依赖 SUMIF/COUNTIF/VLOOKUP 的公式改由 Python 侧算好常量注入。

v5.6 增量（2026-09-21 · 双色纪律 + 整套"去 AI 味"重设计 + 配色审计器）：甲方提出「排版形式过于相似、重复度高、AI 生成痕迹明显」「灰色字全部改纯黑」「彩色元素只有绿色和蓝色，不要橙红黄」时走这一套。① 新增 references/blue-biz-style.md §10 双色纪律 + 整套去 AI 味重设计（病症→动作对照 / 双色主题 THEME_PSBC2 写法与三条铁律 / 页眉三式轮换与 hdr_b 内容 y≥176 铁律 / 相邻页不同型的版型池与三条落地口诀 / 深底页码不得为灰 / 孤行分档口径 / 六个新坑 / 批量改文案的 count==1 保命写法 / 四关验收清单）；② 新增 references/anti-defect-playbook.md 缺陷四 D1–D4「配色纪律与伪通过的检查器」——灰字残留（判据 r==g==b 且非纯黑白，深底浅色字改纯白）、暖色残留（Theme.extra / pop 会轮询取色，删色要连它们一起清）、检查器假通过（显式 RGB 的 ColorFormat.type 是 "RGB (1)"，旧写法会让检查器一个 run 都读不到却给出 ✅；必须拿"确定有缺陷的旧版"反证 + --selftest）、孤行分档；③ 新增 scripts/audit_color.py（成品侧配色审计器：文字与填充的暖色 / 越界色 / 灰字五类计数 + 逐处明细 + --selftest 自证；判定用色相关系而非色值白名单，派生色不误报）；④ pptx_kit.py 修正 footer(dark=True) 的页码色由 LINE(#E3E3E3) 改纯白（深底上灰字违反"灰字全改黑"指标）；⑤ 交付前质检由三关扩为四关：build 容量预检 → check_layout --strict → audit_color --selftest + audit_color → audit_text，再叠缩略图整套核对与跨机字体核对。新增核心纪律两条：「删色不能靠肉眼，必须跑审计器」「任何专项检查器都要先拿有缺陷的旧版反证一次」。

🧭 固定流程（v5.3 · 每次制作 PPT 必走，优先级最高）

两条铁律，优先级高于本文件其余全部章节（含三类缺陷防治与 8 步工作流）：

① 首次调用先列必填清单，不生成内容；② 九个关键节点，每节点给 2–3 个差异化方案，等用户选定后再进入下一节点。

展开说明书：references/kickoff-and-options.md（话术模板 + 27 张方案卡 + 决策记录模板 + 5 套兜底套餐）。

S0-0 · 先用六问定位「这是哪一类 PPT、给谁看、讲多久」（在清单之前）

为什么不直接问八项：同一段内容做成「课程 PPT」和做成「工作汇报 PPT」，页数、密度、标题写法、页面类型、配色纪律全不一样。用途定错，后面全错。

但只有用途不够。 v7.1 起补上受众 / 演示模式 / 时长三项必填：不知道给谁看，就不知道讲什么、藏什么；不知道讲多久，就没法判断页数是多是少；不知道是现场讲还是发出去读，就不知道该把字写多还是写少 —— 最后这一条是培训课件最高频的差评来源（按现场讲的密度做完，课后直接发 PDF，学员看到一页三四行字，投诉"内容太单薄"）。

一键打印：python scripts/brief.py（六问卡，可整段贴给用户）｜python scripts/brief.py --table（页数节奏表 + 受众 × 模式矩阵）。

完整矩阵与判断依据：references/brief-and-pacing.md。

六问（合并成一次回复发出，不要分三轮问）

五条纪律

① Q2 必须带上"按 Q1 建议用哪一套"的推荐，不能只抛菜单。② Q3 决定拆页阈值——精简档超过 6 条拆页、标准档超过 8 条拆页、详尽档允许到 10 条但正文不得低于 14pt。③ Q4–Q6 不收「你定」。这三项决定页数与字量，猜错整稿方向就偏了。用户说不清时给二选一，别自己填：「这份是发到群里让大家自己看的，还是你站着讲？」「大概讲 20 分钟还是一个小时？」④ 答完六问先跑 brief.py，拿页数区间与每页字数上下限。出现 P0 冲突（如「精简 + 发出去读」）或页数超区间，要先说清楚，别闷头排 —— 排完再说等于返工。⑤ Q1–Q3 用户说「你定」→ 按推荐组合直接走并声明所选；Q4–Q6 必须问到具体选项。

每页还要单独答一句：这页的结论是什么

六问定的是整份稿；每页标题必须写成这一页的判断句，不是目录标签。写成「工作完成情况」「经验总结」「SWOT 分析」的，scripts/audit_content.py 会逐页判不合格；同一支脚本还查 XXXX / ○○ / Text 1 / 单击此处 这类占位符残留。二十组正反例与三个可套句型：references/title-and-placeholder-rules.md。

用途→骨架 / 页数换算 / 必备页面 / 特有红线：references/use-cases.md。三问速查（历史兼容）：python scripts/survey.py --table。

S0 · 首次调用：先列必填信息清单（暂停生成）

触发条件（满足任一即执行）：本次会话第一次被要求做 PPT；或开一个新的 PPT 项目；或用户提供的信息不足以确定下表 ≥4 项。

执行动作：不写大纲、不生成任何页面，先一次性输出下面这张清单，请用户确认或补充。

S0 六条规则

1. 先走 S0-0 六问，再一次性列完 8 项，禁止挤牙膏式一条条追问。
2. 允许部分作答：用户只答几项，其余按默认走，并在回复中逐条声明默认值。
3. 允许一句话放行：用户说「直接做 / 你定 / 按默认 / 别问了」→ 全表按默认填充并声明 → 直接进 N1。
4. 历史记忆优先回填：工作区记忆（MEMORY.md、往期日志）或上文已有的信息直接填表，标注「来源：历史记忆 / 上文」，只问真正缺的项。
5. 极简三问模式：<10 页、内部草稿、用户明显赶时间 → 只问「主题 / 受众 / 页数」，其余全按默认。
6. ⛔ 确认前禁止开工：用户确认或明确「按默认」之前，禁止写大纲、禁止生成任何页面。

回复模板见 references/kickoff-and-options.md §1.3，照抄改即可。

S1 · 九个关键节点：每节点 2–3 个差异化方案（等选再走）

S1 六条规则

1. 一次给完该节点的 2–3 个方案，逐个节点推进，不一次甩完 9 个节点。
2. 方案必须异质：保守 vs 激进、结构 vs 叙事、克制 vs 高冲击；换词不算新方案。
3. 每张卡四件套：一句话是什么 / 适用场景 / 取舍（优点＋代价）/ 是否推荐（⭐）。
4. ⛔ 未获选择不进下一节点；用户说「你定 / 按推荐来」→ 采用 ⭐ 推荐项并在回复中声明。
5. 允许打包：用户可一次选多个节点，也可说「剩下全部按推荐」。
6. 决策留痕：每节点最终选择写入 DESIGN.md 的「决策记录」段，后续所有页保持一致；中途改选必须回头改已生成的页。

兜底套餐（用户说「你定」时直接声明套用哪一套）：十一套——十类用途各一套 ＋ U1 另附「国企精品课」变体（共 11 行，见 references/kickoff-and-options.md §4）。

🛑 开工前必读：三类版面缺陷防治（最高优先级）

用户实测反馈的高频问题就三件：① 乱码 / 方块字 / 字体变样；② 丑、难看、像没设计过；③ 死板、一页页长得一样。

完整手册见 references/anti-defect-playbook.md（P0 条目是交付红线，一条不过不许交付）。以下是必须刻在脑子里的骨架：

三条硬规则（不设例外）

1. ⛔ 页面禁用 emoji。✅❌⚠️★💡 在 .pptx 里跨机器极不稳定，会变方块。改用中文字体必含的符号（√ × ★ ● ◆ →）或绘制形状。
2. ⛔ 禁止 normAutofit（自动缩排文字）。PowerPoint 会把正文悄悄压到 6pt——这是"丑"的最隐蔽成因。超框就加高文本框或拆页，绝不缩字号。
3. ⛔ 交付前必须跨机核对（防乱码唯一可靠手段）：把 .pptx 拷到另一台没装你字体的电脑，或用 WPS 与 PowerPoint 各开一次，看标题有没有变宋体、变方块。

生成前三道拦截（缺一不可）：① 主题节奏表（每页标 深hero/浅hero/浅底/深底）；② 版式调度表（同版式连续 ≤2 页、同章节 ≥2–3 种版式）；③ 字体安全声明（写进 DESIGN.md，锁定 latin/ea/cs 三槽位与禁用字体清单）。详见手册「生成前三道拦截」。

⚙️ 可执行渲染轨道（技能不再只有说明书）

本技能同时提供说明书（references/）与可执行轨道（scripts/）。需要完全掌控版式、并让机器替你抓缺陷时，用 scripts/ 这条轨道。

cd <技能目录>/scripts

# 0  开工六问（每次动手前的第一件事）
#    python brief.py                        # 打印六问卡：用途 / 色系 / 密度 / 受众 / 演示模式 / 时长
#    python brief.py --table                # 页数节奏表（live / read / video 三列）+ 受众 × 模式矩阵
#    python brief.py --use 课程 --audience 高管 --mode live --minutes 60 --pages 31
#        → 建议页数区间、每页正文上下两条线、P0 冲突（最典型：精简 + 发出去读）
#    ⚠️ 受众 / 演示模式 / 时长 **必填**：不知道是发还是讲，就不知道该把字写多还是写少。
#    python survey.py --table               # 三问速查卡（历史兼容，只给用途/色系/密度）

# 0b 改旧稿（用户丢来一份旧 PPT + 一堆资料）—— 整理思路 → 整合内容 → 美化排版
#    python revamp_old.py 旧稿.pptx                      # 只体检：灰字 / 圈码 / <14pt / 槽位 / 版式 / 每页字数
#    python revamp_old.py 旧稿.pptx --report 体检.md --outline 大纲.txt   # 体检报告 + 逐页大纲底稿
#    python revamp_old.py 旧稿.pptx --fix 修好的.pptx     # 清字：灰字改黑白 + 圈码替换 + 补三槽位
#        → 自动产出「修好的_变更清单.json」（每条改动定位到 页/形状/改前/改后）
#        → 自动产出「修好的_体检报告.md」（扫修后文件，证明灰字/圈码/槽位已清零）
#        ⚠️ 改旧稿必须交证据：学员问"我原来那段话呢"，翻清单即可答，不用开两个文件对。
#    ⚠️ 顺序不能反：先 --fix 清干净，再按新大纲 layout_page 逐页重排。
#       带着脏字重排，脏字会被整批搬进新稿，等于白干。
#
# 0c 照着客户模板做（甲方给了自家模板，要求"就按这个样式"）
#    python tpl_extract.py 客户模板.pptx -o ./tpl         # 拆配色 / 字体 / 字号层级 / 页型
#    # 产出：theme_snippet.py（Theme + Style 代码）/ build_custom.py（可直接跑的空骨架）/ 模板拆解.md
#    cd ./tpl && python build_custom.py 试稿.pptx          # 骨架先出 2 页验证色与字对不对
#    拆完后：颜色与字体跟客户模板走，几何骨架仍是本技能斜面折带族（别照抄客户的错骨架）
#    ⚠️ 拆出来的骨架文字全是占位符，出第一版后立刻跑 audit_content.py —— 别把模板提示语发给客户
#
# 0d 交付四件套（出稿之后，别再只交一个 pptx）
#    python deliver.py 成品.pptx --out ./交付 --minutes 60 --topic "主题" --gate
#        → ① 成品_交付版.pptx（备注页已写入逐页摘要）
#          ② 每页备注摘要.md      ← 打印版：要点 + 该页怎么讲 + 建议分钟数
#          ③ 结构解析.json        ← 每页 版式码 / 角色 / 标题 / 字数 / 要点 / 时长
#          ④ 变更清单.json        ← 加 --origin 旧稿.pptx 就是逐条真 diff
#    python deliver.py 成品.pptx --out ./交付 --origin 旧稿.pptx       # 改旧稿必带 --origin
#    ⚠️ 备注摘要按「版式」给讲法（L19 停 3 秒只念一句、L22 只讲结论列不念数字），
#       按时长给每页分钟数（结构页固定 0.5 分钟，其余在正文页间均分）。
#
# 0e 六道门（交付前逐道跑，全绿再交）
#    python check_layout.py 成品.pptx --strict      # 版面：越界 / 溢出 / 遮挡 / 字号 / normAutofit
#    python audit_color.py  成品.pptx --allow-warm  # 配色：越界色 / 灰字（暖色轨加 --allow-warm）
#    python audit_rhythm.py 成品.pptx               # 节奏：15 页窗口不重复 + 同版式全篇 ≤2 次
#    python audit_glyph.py  成品.pptx               # 乱码：圈码 / 字体三档 / 三槽位
#    python audit_text.py   成品.pptx               # 孤行：末行只剩 1–5 字
#    python audit_content.py 成品.pptx              # 内容：标题表态 + 占位符残留
#
# 1  冒烟测试：一键验证「渲染 → 自检」链路通不通（8 页样板）
python build_plane_demo.py demo.pptx

# 2  生成课件：写你自己的 build_xxx.py，import pptx_kit 组合页面
#    见 build_plane_demo.py 的 8 页骨架（封面 / 目录 / 转场 / 波浪箭头 / 压边大圆 /
#    圆环四向 / 金字塔 / 封底）
#    写页面前的取数顺序：plane-hero-family.md（四页骨架 + 坐标）
#      → plane-body-layouts.md（四个图形版式抄坐标）
#      → cover-and-diagram-library.md（正文图表 8 形态）
#      → premium-templates.md（套骨架）
#
#    ⭐ 头部四页（v6.4 唯一入口，四页共用一套几何）
#       S.cover(prs, title=..., subtitle=..., brand="中国移动", presenter=..., date=...)
#       S.toc(prs, [("一级", "二级"), ...])
#       S.section(prs, index="01", title=..., sub=..., points=[...])
#       S.end(prs, title=..., subtitle=...)
#       或直接调组件：
#       K.plane_cover(prs, title=..., theme=T)
#       K.plane_toc(prs, items, theme=T)
#       K.plane_section(prs, index="01", title=..., theme=T)
#       K.plane_end(prs, title=..., theme=T)
#       骨架三件套：plane_bg()（三层斜切面）/ _corner()（45 度角块）/ chevron()（">" 折带）
#       ⛔ 不要再自己拼「左文右图」或「满版主色」封面 —— 旧六套封面函数已删除
#
#    ⭐ 全色系回归（改任何组件后必跑）—— v6.5：6 套 x 10 页
#       python build_all_styles.py                              # 出到 ./style-samples/
#       python build_all_styles.py --only grid,cmcc              # 只跑某几套
#       10 页骨架：封面 / 目录 / 转场 / 波浪箭头 / 压边大圆 / 圆环 / 金字塔 / 时间线 / 大字报 / 封底
#       一次生成 + 三道检查（版面 / 配色 / 版式节奏），输出对照表 —— 哪个色系被带崩一眼看见
#
#    ⭐ 四个图形正文版式（v6.4，替代「一排等高白卡」）
#       s = K.blank(prs); K.paper(s, T); K.title_band(s, "页面标题", T, kicker="MODULE 01", page=4)
#       K.wave_arrow(s, title, [{"head":..., "body":...}] * 4, theme=T, tag="L31")
#       K.circle_cards(s, title, [{"num":"26%","label":...,"body":...}] * 4, theme=T, tag="L32")
#       K.ring_callout(s, title, items4, center=("可控", "副句"), theme=T, tag="L33")
#       K.pyramid_tiers(s, title, items4, theme=T, tag="L34")     # items 由高层到低层写
#       ⛔ 这四页不要再套白卡；一页只有一个视觉主体；正文一律放在图形外面
#
#    ⭐ 整页版式工厂 layout_page（v6.6b · 正文页唯一入口，36 种骨架「一行出一页」）
#       为什么有它：v6.5 只有 11 种「一行出一页」的骨架，而 v6.6 硬规要求
#       「同一正文版式全篇 ≤2 次」——47 页课件至少要 20 种。判据一收紧，
#       组件必须同步扩容，否则规则等于让人无路可走。v6.6 补 5 个整页版式并把
#       v6.4 的四个图形版式接进同一入口；v6.9 再补 5 种循环图（L37–L41）。
#
#       s = K.layout_page(prs, "L09", "一天三段，各段只做该做的事",
#                         items=[{"title":..., "body":...}], theme=T,
#                         kicker="MODULE 01", page=6, note="口径：…")
#       自动铺纸白底 + 标题带 + 登记 LAYOUT=，不用再手工 tag_layout。
#
#       code   版式名        items 写法                        项数
#       L04    并列卡片流    [{title,body}]                    3–4
#       L05    编号步骤条    [{title,body}]                    3–5
#       L06    横向时间轴    [{time,title,body}]               3–5
#       L07    中心辐射      big + unit + [{title,body}]（四角） 4
#       L08    台阶递进      [{title,body}]                    3–5
#       L09    通栏看板      [{title,body}]                    3–5
#       L10    汇聚式        lead + [{title,body}] → 底部成果条 3–5
#       L11    左右对照      [{title,items:[..]}] × 2           2
#       L12    漏斗递进      [{title,body}]                    4–5
#       L13    环形循环      big + unit + [{title,body}]      3–4（粗环 + 标签贴外圈）
#       L16    通栏带 + 卡   lead + [{tag,title,body}]         3–4（无照片时用它）
#       L19    大字报        big + unit + lead                 1 个数字
#       L20    矩阵象限      [{title,tag,body}]                4
#       L21    甘特进度轨    [{title,body,start,span}]         3–5
#       L22    表格          head=[列名] + rows=[[..]]         3–6 行
#       L23    金句          quote + lead                      —
#       L31–L34 图形族        自动交接（items 认 head/body，L32 另认 num/label）
#       L36    循环·五六维    big + unit + [{title,body}]      5–6（正五/六边形）
#       L37    循环·双环      big + unit + [{title,body}]      3–6（外环阶段 + 内环节拍）
#       L38    循环·对向双列  big + unit + [{title,body}]      4–6（左下行 + 右上行）
#       L39    循环·卡片环绕  big + unit + [{title,body}]      4–6（卡片围一桌）
#       L40    循环·阶梯闭环  big + unit + [{title,body}]      4–6（上行 + 虚线回落）
#       L41    循环·蛇形折返  big + unit + [{title,body}]      4–6（两行折返闭环）
#       ── 以下是 v7.0 多维度族：正文 6–10 个维度专用 ──
#       L42    多维·格阵卡    [{title,body}]                    6–10（3×2/4×2/3×3/5×2）
#       L43    多维·图标卡阵  [{title,body}]                    6–10（圆图标 + 中轴对称）
#       L44    多维·通栏条带  [{title,body}]                    6–10（一行一条，序号+标题+正文）
#       L45    多维·双栏纵排  [{title,body}]                    6–10（左右各半，圆点+标题+正文）
#       L46    多维·砖墙瀑布  [{title,body}]                    6–10（3–4 列，列间错位）
#       L47    多维·环形阵列  big/center + [{title}]            6–8（**只吃短名**，带环线）
#       L48    多维·阶梯阵    [{title,body}]                    6–10（每行 3 项，逐行内收）
#       L49    多维·编号清单  [{title,body}]                    6–10（双列超大序号 + 横线）
#       L50    多维·分组矩阵  [{group,title,body}]              6–10（2–3 块浅底面板）
#       L51    多维·密排网格  [{title,body}]                    6–10（无卡，十字细线，密度最高）
#
#       ⭐ 循环图怎么选（7 种形态 + 1 条分水岭，v6.9 定稿）——先问"循环的语义是什么"，再挑几何：
#          ① 3–4 个维度、纯"转一圈"             → L13 环形循环（粗环 + 节点，最省地方）
#          ② 5–6 个维度、要均匀铺                → L36 正五/六边形（顶点布点 + 顺时针箭头）
#          ③ 一圈里还有一圈（阶段 × 节拍）        → L37 双环（外环阶段、内环节拍、中心周期）
#          ④ **两方**来回推（甲方↔乙方 / 教↔学）  → L38 对向双列（左列下行、右列上行、首尾横连）
#          ⑤ **多方**围坐（生态圈 / 圆桌机制）    → L39 卡片环绕（n 卡围一桌，中心写母题）
#          ⑥ 一轮比一轮**高**，做完回起点再来    → L40 阶梯闭环（上行台阶 + 虚线回落）
#          ⑦ 5–6 步长流程但要闭环、版面又不够宽  → L41 蛇形折返（两行折返 + 左端回流）
#          ✖ 分水岭：只是"有先后顺序"、不闭环      → **别用循环图**，用 L05 流程链 / L06 时间轴
#          七种形态的统一纪律（v6.8 起）：**图形居中、标签贴着自己那个节点、对齐一律朝图形**
#          （上/下居中、左侧右对齐、右侧左对齐）。⛔ 不做「左图右列表」——编号会说两遍、
#          图形沦为装饰、用户还得跨区域对照。传 L13 但给了 5–6 项时自动改走 L36。
#          标签正文建议 ≤26 字（两行以内）；超了标签自动加高、图形跟着收小，不压边。
#
#       ⭐⭐ 正文有 6 / 7 / 8 / 9 / 10 个维度时怎么排（v7.0 新增 · 10 种版式）
#          **先看可选数**：6–8 项有 10 种可选，9–10 项有 9 种（只剩 L47 放不下）。
#          按"这批维度是什么关系"挑，不要按"哪个好看"挑：
#
#            ① 彼此并列、权重相当、每条一两句     → **L42 格阵卡**（最稳，3×2/4×2/3×3/5×2 自动选）
#            ② 并列但要"对称、不偏谁"            → L43 图标卡阵（圆图标在上、标题正文居中）
#            ③ 每条都很短、像清单                 → L44 通栏条带（一行一条，10 条也排得下）
#            ④ 每条要写两三句、但不值得配卡        → L45 双栏纵排（有圆点）/ L49 编号清单（有巨号 01–10）
#            ⑤ 想让画面活一点、别太规整            → L46 砖墙瀑布（列与列纵向错开）
#            ⑥ 有层次、范围逐级收窄                → L48 阶梯阵（左边缘连成斜线，末行收尾）
#            ⑦ 这 n 项其实能归类                  → L50 分组矩阵（组名取 items 里的 `group` 字段）
#            ⑧ 密度优先、当速查表用                → L51 密排网格（无卡无底纹，十字细线切格）
#            ⑨ 每个维度只有 4–6 字短名             → L47 环形阵列（唯一带环线的，n≤8）
#            ✖ 超过 10 项                          → **拆页**，别再挤（B6 单页 620 字上限也会拦）
#
#          自动接管规则（不会静默丢内容，一律打印告警）：
#            · 传 L13 给 5–6 项 → 改走 L36；给 7 项以上 → 改走 L42
#            · 传 L47 给 9–10 项（环形标签会挤成一坨）→ 改走 L42
#            · 传 L47 且给了 body → 提示改走 L42/L45（L47 只放短名，正文放不下）
#
#          ⚠️ 每种的"安全字数"（超了报 A5 溢出、差一个字会报末行孤字；改几何必须重算）：
#            L42  6/9 项 34 字 ｜ 7/8 项 24 字 ｜ 10 项 18 字
#            L43  比 L42 再减 2 字（圆图标占了高度）
#            L44  26 字（单行，条高 41–72px 撑不满两行）
#            L45  50 字（两行）        L49  48 字（两行）
#            L46  6 项 34 ｜ 7/8 项 24 ｜ 9/10 项 22
#            L48  6 项 22 ｜ 7–9 项 26 ｜ 10 项 22
#            L50  2 组 50 字 ｜ 3 组 30 字          L51  6–8 项 52 ｜ 9 项 30 ｜ 10 项 40
#            L47  只放 4–6 字短名，不给 body
#
#          三条统一纪律（v7.0 定）：① 卡标 ≥15pt、正文 ≥14pt，**绝不为了塞进去缩字号**，
#          放不下就换版式或拆页；② 卡内文案在正文区**垂直居中**（等比等高的卡里顶对齐会
#          空出下半截，像没写完）；③ 卡宽按"列数"算、不按"这一行实际几项"算，否则 3 项行
#          381px、2 项行 542px，同页卡宽忽大忽小、台阶读成参差网格。
#
#       note（口径 / 提示语）落位已定死，放错必压东西：
#         · L05/L08/L09/L12/L22 内部没有 lead 位 → note 落 y=122（标题带正下方）
#         · 图形族 L31–L34 / 循环族 L36–L41 / 多维度族 L42–L51 内容铺到 y=640 → note 只能落 646–678、宽 1000（避开页码）
#         · 有 lead 位的版式（L04/L06/L16/L19/L23/L10）note 会被 lead 吸收，别重复写
#
#       ⛔ 三条硬约束：① 正文一律 ≥14pt，**13.5pt 也判「低于下限」**；
#       ② 单色面积 ≤20%，斑马纹底纹、整条成果带都算面积（L22 三行 0.035 底纹 = 27.6% 触发 B2）；
#       ③ 图形页正文一律放在图形**外面**（菱形 / 三角形内接区放不下正文）。
#
#    ⭐ 紫色商务风（银行条线 / 竞赛辅导 / 紫版汇报）
#       S = K.style("紫色商务")   # 别名：商务紫 / 紫色 / 紫 / purple / 银行紫 / 竞赛紫
#       底色：K.purple_bg(s, "mist"|"deep"|"solid"|"split", theme=K.THEME_PURPLE)
#             ⚠️ deep 深紫只允许转场页与结尾页；别名 violet-deep 也认（漏认会静默落回亮底 → 白字隐形）
#       头部四页与其它色系共用 plane_* 骨架，只是换主题色
#
#    ⭐ 线条式标题带（紫色商务轨自动启用）
#       K.title_band_line(s, "页面标题", sub="PART 01", theme=TH, tag="标签", up="单元")
#       ⚠️ 标签胶囊必须放三段行右端（放标题行会与满宽标题框判为遮挡）
#
#    ⭐ 图片 + 文字四骨架
#       K.img_text_page(s, kind="left", theme=TH, image="photo.jpg", layout="L14",
#                       title=..., sub=..., cards=[{"title":..., "body":...}])
#       # kind: left 左图右文(L14) / right 右图左文(L15) / top 上图下文(L16) / card 卡内嵌图(L17)
#       # 图片一律居中 cover 裁剪 + 主色罩 10% + 圆角 16px，只裁不拉伸；无图时自动降级为占位框
#
#    ⭐ 版式登记（硬规 3「连续 15 页不重复 + 全篇同版式 ≤2 次」的落页面动作）
#       K.tag_layout(s, "L04")        # 或 S.page(..., layout="L04")
#       print(K.LAYOUT_CODES)         # 语义表；交付前跑 audit_rhythm.py 核对

# 3  版面自检（P0 必须清零）
python check_layout.py demo.pptx               # 常规
python check_layout.py demo.pptx --strict      # 对外交付：P1 也阻断
python check_layout.py --selftest              # 自证检查器能抓到缺陷（勿省）
python audit_color.py demo.pptx --allow-warm   # 橙 / 红 / 国网绿 加；紫 / 移动蓝 不加
python audit_rhythm.py demo.pptx               # 节奏：连续 15 页不重复 + 全篇同版式 ≤2（E1–E5 必绿）
python audit_glyph.py demo.pptx               # 乱码：圈码/emoji/字体链（G1–G3 必绿，--fix 可修）

# 4  缩略图整套核对（抓「死板」最有效的一招；本机无渲染器时也能看图）
python preview_grid.py demo.pptx --cols 2

脚本分工一览（18 个可执行脚本）

渲染轨道的优先级：默认走 tencent-pptx（产出 .pptx，省事）；需要精细控制版式、或在无网 / 无内置技能时，走 scripts/pptx_kit.py 自渲染。两条轨道共用同一套设计参数（8px 网格 + 字号档 + L1/L2/L3；面积法则按所选视觉轨道取「60-30-10」或「纸白 55-65 / 斜切面 20-28 / 主色 12-18 / 点缀 5-8」），产出观感一致。

渲染轨道的优先级：默认走 tencent-pptx（产出 .pptx，省事）；需要精细控制版式、或在无网/无内置技能时，走 scripts/pptx_kit.py 自渲染。两条轨道共用同一套设计参数（8px 网格 + 字号档 + L1/L2/L3；面积法则按所选视觉轨道取「60-30-10」或「底 55-65 / 白卡 20-28 / 主色 12-18 / 彩色 5-8」），产出观感一致。

模式选择（开工前先定）

叠加层：工作坊增强（Workshop Overlay）

工作坊 / 内训师培养 / 师课共建类课件，无论是否国企，都在此之上再叠一层。 判断依据：课件要「现场带教、学员当场产出」，而非单向讲授。

两条主模式共用同一套 8 步工作流与同一执行轨道，工作坊增强层叠加在两者之上。区别仅在于「前端内容吃透的深度」「视觉轨道（配色与版式库）的选择」与「是否启用工作坊页面体系」。

核心工作流（8 步，不可跳过）

⚠️ 前置动作：走这 8 步之前，必须先完成「🧭 固定流程」的 S0（必填信息清单确认）；第 3 / 4 / 6 / 8 步开工前，先过对应节点的 S1 多方案选择（N1–N9），用户选定后再动手。S0/S1 不替代本工作流，只是插在它前面的强制确认层。

1. 读取全部输入材料 —— 文档、大纲、参考图、风格指引、既有模板。未读完不进入下一步。
2. 需求分析 —— 受众、页数、内容模式、视觉参考、品牌色、图片限制、评分标准（参赛必备）；国企模式追加「业务背景五问 + 视觉规范提取」。
3. 内容规划 —— 基于教学模型 / final_report 设计模块结构与页面大纲（每页 = 1 个知识点 / 1 个技能步骤）；国企模式遵循「模块结构 + 导入页 + 验收关卡」。
4. 视觉设计 —— 定配色、字体、画布比例、页面类型体系；产出 design.md（含 12+ 布局模式预排）；国企模式套用九套配色 + 28 版式。必须同时产出「生成前三道拦截」：主题节奏表（每页标 深hero/浅hero/浅底/深底）+ 版式调度表（同版式连续 ≤2 页）+ 字体安全声明（锁定 latin/ea/cs 三槽位与禁用字体清单）。
5. 大纲文档 —— 编写 outline.md（每页类型 / 标题 / 要点 / 数量维度 3-8）；国企模式由 final_report 转换。
6. 页面生成 —— 按执行轨道产出（默认 tencent-pptx：先 DESIGN.md 视觉规范 + STORY.md 逐页内容，再生成 .pptx；版面骨架套 premium-templates.md）。需要精细控版防乱码时走自渲染轨道 scripts/pptx_kit.py（set_font() 三槽位 + no_autofit() + 预制组件）。
7. 版面缺陷自检 + 七维质量提升 —— 先跑 scripts/check_layout.py（P0 清零，改动检查器后先 --selftest），再用 scripts/preview_grid.py 做缩略图整套核对与跨机核对（见 7.1）；国企模式过七维质量门（工作坊课件七维全过）。
8. 交付与记忆沉淀 —— 输出 .pptx + outline.md（国企模式附 final_report.md）+ DESIGN.md +（工作坊必附）speaker-notes.md，用 present_files 呈现，写入工作区记忆。交付说明中须列出字体安全声明与跨机核对结果。

前置内容工程（国企精品模式必走；工作坊课件必走，强烈推荐）

本段来自 soe-premium 工作流。精品课程 PPT 成败 80% 在前端——先把甲方业务、学员痛点、行业标杆、逐页脚本吃透，再交给周慧慧引擎生成。

执行范围：A（需求理解）→ B（行业研究）→ C（final_report）→ D（内容结构标准）→ E（转 outline）。

• 国企精品模式：全走。
• 工作坊课件（含非国企）：可跳过 A.2 视觉规范与 B 行业研究，但 C 的工作坊节奏规划、D-5/D-6/D-7/D-8 必须走。
• 标准模式：跳过本章，直接从第 3 步做 outline。

A. 深度需求理解与约束提取

A.1 业务背景五问

从用户输入与附件中提取：

1. 甲方是谁：企业名称、行业属性（国企 / 民企 / 外企）、文化风格偏好
2. 参训对象：岗位层级、人数、已有基础、痛点是什么
3. 课程用途：工作坊现场带教？后续内训师讲授？领导汇报？
4. 交付链路：几天工作坊？几次辅导？几审几校？决定课程阶段划分
5. 讲师定位：用户是开发者还是讲授者？开发者重内容详实，讲授者重表达设计

A.2 视觉规范提取

主动询问或从输入提取；国企 / 央企通常有严格视觉约束：

• 主色与辅助色（如中国移动蓝 #0055A5）、禁止色（如禁止红黄绿高饱和）
• 字体要求（如微软雅黑）、字号层级（封面 / 模块标题 / 正文 / 注释）
• 版式多样性要求（如 28 种版式交叉、连续两页不重复）
• 图片元素约束（如仅中国元素、禁止外国人 / 娱乐化图片）
• 比例（默认 16:9）

若用户未明确视觉规范，按 S0-0 的 Q2 在六套色系里选：橙色系 #E85D04 / 党建红 #A4202C / 正红色系 #D9241E / 紫色商务 #6D42A6 / 国家电网绿 #005A53 / 中国移动蓝 #0085D0，按甲方行业属性与课程类型取最匹配的一套（原 visual-design-spec.md 的 A–I 九套配色已下线，仅作历史参考）；版式构图见 references/layout-pattern-library.md（28 种版式）。

A.3 内容来源处理

• 完整读取，不跳读：用 read 或 parse_document 完整解析用户文档，不只读前 200 行就动手
• 保留结构：逐页规划文档保持其结构，仅做增强而非重写
• 不省略不限制：用户说「不省略、不限制字数」时，所有内容完整呈现

B. 行业优秀经验研究

精品课程「精品」在于融入行业成熟方法论与标杆实践，而非凭空编写。

• 研究方向（2-3 个）：同行业标杆（如通信业内训师培养）、成熟方法论（ADDIE / 柯氏四级 / 复盘五问）、同岗位实践（HR / 销售经理能力模型）
• 执行：用搜索工具构造 4-6 条精准查询（含具体企业名 + 方法论名 + 场景词），如「中国移动 内训师培养 课程开发 最佳实践」「ADDIE 模型 课程开发流程 企业培训」
• 融入原则：研究点嵌入对应知识点之后，有明确课程位置、与上下文逻辑衔接、标注来源（哪个企业 / 哪个模型），保存为 research_best_practices.md

C. 撰写 final_report 逐页可授课脚本

final_report.md 是整个 PPT 的唯一内容真相源——不是大纲，而是逐页详细内容脚本（讲师拿到即可照本授课）。结构：

# [课程标题] — PPT 内容规划

## 项目背景
（甲方、参训对象、课程用途、交付链路、讲师定位）

## 视觉设计规范
（主色、辅助色、字体字号、8px 间距刻度、阴影层级、版式规则、图片约束、标题排版规范）

## 工作坊节奏规划        ← 工作坊课件必写
（能量曲线匹配：上午高能量段排高密度讲授，午后 13:30-14:30 低谷段排动手演练；标注各时段对应的页面范围）

## PPT 页面规划（共 N 页）

### P1 [页面标题]（时段·时长）
- **页面类型**：封面 / 模块分隔 / 导入 / 知识讲解 / ★活动指令 / 同伴互评 / 验收关卡 / 行动计划
- **版式建议**：封面 / 时间轴 / 矩阵图 / 流程图 / ...（含骨架组合，见 layout-pattern-library.md §J）
- **正文内容**：6-15 行详细文字，可直接授课参考
- **示例 / 案例**：甲方真实业务场景示例
- **讲师备注**：              ← 工作坊课件每页必写
  - 时间：讲授 X' + 互动 Y'
  - 重点：本页必须讲透的核心点
  - 误区：学员常犯错误及纠正话术
  - 过渡：承上启下的过渡句
- **互动设计**：（如适用）提问 / 演练 / 讨论 / 点评的类型与参数

撰写要点：

• 正文 6-15 行：写完整句子、操作步骤、判断标准，非关键词提词器。宁可多写不可少写——用户可自行删减，少了就得自己补。
• 版式逐页标注：从 28 种中选，连续两页不重复；骨架组合查 layout-pattern-library.md §J。
• 示例必须本土化：用甲方真实岗位 / 流程 / 痛点 / 数据，禁止「某公司」「某员工」式泛化示例。
• 模块结构完整：模块分隔页 → 【导入】页 → 知识讲解页 ×N → ★验收关卡页。
• 工作坊课件追加：开场区【课堂公约】+ 分组角色分工页；每个演练环节 ★活动指令页（六要素）+ 同伴互评页；结营区训后行动计划页；每页标时段与能量匹配。

⚠️ 行数与要点的关系（易混淆，务必分清）：

final_report 每页 6-15 行完整文字 → 转 outline.md 时提炼为 3-8 个要点 → 落到 PPTD 页面上是 3-8 个视觉元素。

三者是「讲稿 → 提纲 → 版面」的逐级压缩关系，不是同一个数字。第 3 步「单页不超过 8 个要点」约束的是 outline 与版面，不约束 final_report。

D. 内容结构标准（详见 references/content-structure-guide.md）

D-1 模块内部结构：模块分隔页 + 【导入】页（每模块必有）+ 知识讲解页 ×N + ★验收关卡页（每模块必有），形成「学-练-验」闭环

D-2 导入页三要素：问题引入 / 知识点预告 / 与上模块衔接（模板 A 问题型 / B 案例型 / C 数据型）

D-3 验收关卡：验收维度表（维度 + 标准 + 配分 + 自评），总分 ≥80 且单项不低于 60% 配分通过；标准必须可观察，先自评再互评最后导师评审

D-4 行业经验嵌入：ADDIE / 柯氏四级 / 选育用留 / 教学设计五线谱 / SCQA / 复盘五问 / 金字塔原理 / PPT 四化等嵌入对应知识点之后，标题含「行业经验——」前缀并注来源

D-5 工作坊 6 种专属页面类型（工作坊课件必有，详见 content-structure-guide.md §八）

D-6 讲师备注四要素（工作坊课件每页必写，详见 content-structure-guide.md §九）

备注只写在 final_report 与讲师视图中，不落到 PPTD 页面的可见元素上；若用户要求「备注栏可见」，才作为独立文本框排入。

D-7 能量曲线与节奏匹配（详见 content-structure-guide.md §十）

D-8 互动设计 4 类模板（每个知识模块至少「提问 1 + 演练 1 + 讨论 1 + 点评 1」，详见 content-structure-guide.md §十一）

• 提问：开放式（引发思考）/ 封闭式（确认理解）/ 追问式（深挖原因）/ 假设式（激发创造）——标注类型与等待时长
• 演练：目标 → 输入 → 操作（分步+每步时长）→ 产出 → 验收
• 讨论：议题 → 形式（同桌 2 人/小组 4 人/全班）→ 时长 → 角色（谁记录谁汇报）→ 产出
• 点评：对象 → 3 个维度 → 方式（导师/同伴/自评）→ 话术模板「先肯定 → 再建议 → 后示范」

D-9 正文详化边界：写完整句子 / 操作步骤 / 判断标准，非关键词提词器；但不是写教案（不写「讲师说/学员反应」脚本），也不是写教材（不做学术综述），而是写「讲师拿到能照讲、能展开举例」的授课参考稿。

E. final_report → outline 转换

国企精品模式 / 工作坊模式：完成 final_report 后，将其逐页（P1…PN）转换为周慧慧的 outline.md（每页 = [页面类型] [标题] + 要点 + 备注），进入第 6 步生成。

页面类型映射表（final_report → 页面 10 型）

转换原则：

• 每页 final_report 的 6-15 行正文 → outline 提炼为 3-8 个要点，不整段搬上版面。
• 保留 final_report 标注的版式建议与时段/能量标注，写入该页 outline 的「备注」行，供第 4 步 design.md 编排版式节奏时使用。
• 讲师备注四要素不进 outline 正文，单独汇总到 speaker-notes.md 或 final_report 原文件，避免污染版面。

第 1 步：读取输入材料

阅读优先级（详见 references/workflow.md）：

1. 用户上传文档（PDF / DOCX / PPTX）— 全文读取
2. 参考图或风格指引
3. 既有 PPT 模板

• PDF：用读取工具抽取文本；若抽取为空（图片型 PDF），用 pymupdf/fitz 转 PNG 逐页视觉检查。
• 国企模式遵循 A.3「完整读取、不跳读、保留结构、不省略」，先读完所有材料再开工。

第 2 步：需求分析框架

接到需求先明确（详见 references/workflow.md 的 Step 2 表格）：

国企模式追加（A.1/A.2）：明确甲方行业属性与 VI 色、参训对象痛点、交付链路（几审几校）、讲师定位；从九套配色选主色，记录禁止色与图片约束。

关键原则：课程 PPT 是「教学工具」而非「阅读文档」，每页必须有明确教学目的（告知 / 示范 / 练习 / 总结）。

第 3 步：内容规划与教学模型

页面数量分配公式（N 页）

• 封面 + 目录 + 章节页：约 8-12%
• 核心内容页：约 70-75%
• 实战 / 练习 / 工具页：约 10-15%
• 封底：1 页

必备教学模型（按需选用，详见 references/teaching-models.md）

常用速查：五星教学法（聚焦问题→激活旧知→示证新知→应用新知→融会贯通）｜课程心电图（开场→讲授→互动→练习→总结 节奏曲线）｜STAR 案例法（情境→任务→行动→结果）｜ABCD 目标法（受众→行为→条件→程度）｜4C / 6D / ADDIE 课程开发框架。

模型选择指南：技能类微课 → STAR + 五星；知识类课程 → 4C + ABCD；参赛课件 → 课程心电图 + 6 维评估；工作坊 → 五星 + 4C + 问练议评闭环；认证培训 → ADDIE + ABCD；国企精品课程 → 五星 + 4C + 行业经验嵌入（见 D/E）；国企工作坊 → 上述全部 + 工作坊增强层（D-5/D-6/D-7/D-8）。

每页内容数量维度

3 点（黄金三角）/ 4 点（四象限）/ 5 点（五星）/ 6 点（六边形）/ 7 点（流程）/ 8 点（要素清单）。禁忌：单页不超过 8 个要点，信息过载会摧毁教学效果。

国企模式内容结构（见 references/content-structure-guide.md）

• 每个知识模块 = 模块分隔页 → 【导入】页 → 知识讲解页 ×N → ★验收关卡页
• 导入页用甲方真实痛点场景引入；验收关卡用甲方场景作为验收案例
• 行业经验页嵌入对应知识点之后，标题含「行业经验——」前缀并注来源

第 4 步：视觉设计规范

画布比例（默认 16:9）

课程 PPT 默认使用 16:9 宽屏（1280×720）。所有 bounds 满足 x+w ≤ 1280、y+h ≤ 720。

仅在用户明确要求或既有模板为 16:10 时，才用 1280×800（x+w ≤ 1280、y+h ≤ 800）。references/premium-templates.md 与 references/summary-report-layouts.md 的 bounds 按 1280×720 设计，套用时不改比例。

轨道换算（重要）：1280×720 px 是 PPTD 的画布坐标系。走 tencent-pptx 时按 96 dpi 换算——px ÷ 96 = 英寸，即 1280×720 px = 13.333×7.5 英寸，正好是标准 16:9 页面尺寸；字号同理，PPTD 的 px 值 ÷ 96×72 = 磅值（如 32px ≈ 24pt）。按比例整体换算，不要逐元素拍脑袋改数字。

视觉轨道（关键 · v6.5 起为六套预设 ＋ 一套斜面折带骨架）

一句话：六套预设只改色，骨架全用斜面折带族（纸白 + 右侧三层斜切面 + 45° 角块 + > 折带）。换色 = 换 K.style(...) 一行，不动任何坐标。

骨架（四页共用 · 详见 references/plane-hero-family.md）

几何（1280x720）:
  paper:   "#FEF7F5"           # 纸白底 paper()：主色往白推 96.5%，六套各得一张"纸"
  plane:   x=739 / 872 / 1232  # 右侧三层斜切面，斜率 -0.42，每层差一档深调
  corner:  0-311 / 0-311       # 左下 45 度角块（_CORNER_W = 311）
  chevron: apex=(392,360)      # ">" 折带推进器，厚 120，指向右
  title:   32pt 纯黑           # title_band()：标题 y=30 h=56
  bar:     13px 主色横条 y=100  # 标题带下沿色条（原 6px / y=116 太弱，已改）
  safe:    x 52-1232 / y 150-660

六套色系（K.STYLES，v6.5 全量 · 其余全部删除）

• 一句话调用：S = K.style("橙红" | "党建红" | "正红色系" | "紫色商务" | "国家电网绿色" | "中国移动蓝色")；短名别名全兼容（橙红/橙色/默认、党建/党课/红、正红/大红/中国红/年会红/表彰红/庆典红、紫/商务紫/银行紫、国网/电网绿/绿色、移动蓝/移动/通信蓝）。
• 色值依据：国网绿取 PANTONE 3292C（#005A53）；移动蓝取 PANTONE 3005C（RGB 0,133,208 = #0085D0）。甲方有明确 VI 时只换这三个色值，骨架一个字不动。
• 配色审计：橙色系 / 党建红 / 正红色系 / 国家电网绿（pop 是金色）跑 audit_color.py 要加 --allow-warm；紫色商务 / 中国移动蓝属冷色系，不加。
• 面积法则：纸白 55–65% ｜ 斜切面 20–28% ｜ 主色实心 12–18% ｜ pop 点缀 5–8%（pop 不铺面）。
• ⛔ 没有灰字、没有纯白底：正文一律纯黑 #000000，深底纯白；底色走 paper() 的暖白。#666666 是历史 PPTD 取值，已作废。
• ⛔ 不要在大面积纯白上铺白卡：白只留给"卡内浅底"，页面底色永远是有温度的纸白。

正文四个图形版式（详见 references/plane-body-layouts.md）

L31 wave_arrow 波浪串线箭头 ｜ L32 circle_cards 压边大圆四列 ｜ L33 ring_callout 中心圆环四向 ｜ L34 pyramid_tiers 金字塔四层。一页只有一个视觉主体，正文一律放在图形外面；⛔ 不再退回「一排等高白卡」；⛔ 卡片顶部通栏色条永久禁用；⛔ 图形高度必须填满 y150–640，不许全挂在上半部。

历史资料定位：references/visual-design-spec.md 的国企九套配色 A–I、references/blue-biz-style.md、references/gov-report-style.md 全部降级为历史参考（构图原理与红线可查，但没有对应预设可调，K.style("央企深蓝") / K.style("蓝调商务") / K.style("煤化工墨绿") 会抛 KeyError）。v6.3 的曲线照片族（curve-photo-hero.md / curve-photo-layouts.md / hero_* / ribbon）已废弃并删除，新课件一律用斜面折带族。

国企轨道附加规范（详见 references/visual-design-spec.md）

① 60-30-10 配色面积法则：60% 中性底（白/极浅灰）+ 30% 支撑色（中浅灰/主色浅底）+ 10% 主色（标题条/编号/关键节点）。

主色面积超过 20% 就会显得压抑廉价——这是国企 PPT「色块堆砌」的病根。自检：眯眼模糊看页面，主色应只出现在少数焦点位置。

② 8px 基准网格（1280×720 画布）：所有间距取 8 的倍数，禁止 17/23/31px 这类随意值。

• 四周安全边距 48px（封面可放宽到 64px）；正文区底部留 ≥64px 防投影裁切；元素间最小间距 16px。
• 隐形 12 列网格：内容区 1184px，每列约 99px、列间距 16px；元素对齐到列边界。
• 与 premium-aesthetic 字号档的关系：字号档管「字多大」，8px 网格管「间距多大」，两者并行不冲突。

③ L1/L2/L3 阴影层级（PPTD 用 outerShdw 实现）：

• 一页最多两种阴影层级；卡片圆角统一 8px（标题色块条可用 4px），禁止直角或 >16px 大圆角；禁止彩色阴影。

④ 6 大专业设计原则（逐页对照自检）

1. 单页单一视觉重心：一页只允许一个「第一眼焦点」（大编号/核心数据/关键结论/场景图），其余都是支撑。
2. 视觉动线：Z 型（封面/章节页/图文并排，左上→右上→左下→右下）；F 型（信息密集正文页，左侧自上而下扫读）；对角线（阶梯/递进类）。标题忌居右、要点序号忌居右。
3. 视觉权重平衡：不对称平衡为主（一侧大色块/大图，另一侧多个小元素聚拢配重），避免一头沉。
4. 亲密性原则：相关知识点的标题+正文+示例靠近（16-24px），不同知识点拉开（48-64px）；用间距分组而非线条分组。
5. 对比与节奏：标题与正文字号对比 ≥2 倍；编号可超大（60-100pt）；卡片高度错落，避免全部等高。
6. 黄金分割留白：正文区与留白约 8:5 或 3:2；正文占 60% 时留白 40%；信息密集页留白可降至 30%，低于 25% 显拥挤。

字体规范（漂亮的关键，详见 references/premium-aesthetic.md §1）

⚠️ 本节已按「缺陷一 · 乱码」修正，原写法有坑，务必按下面的版本执行。

旧写法是「展示字体 汉仪雅酷黑 75W / 腾讯体… + 回退链 , Microsoft YaHei, sans-serif」——这两条在 .pptx 轨道上是错的：

① 汉仪雅酷黑 / 腾讯体 / 思源黑体属于客户机大概率没装的商业字体，PowerPoint 找不到会静默降级（不报错、不掉字，只是悄悄变丑，最难排查）；

② 回退链是 CSS 概念，PPTX 的 typeface 只认单一字体名，写带逗号的字符串等于没设。

完整成因与修法见 references/anti-defect-playbook.md 缺陷一 A1 / A2。

「丑 / 死板」的首要元凶是默认字体 + 小字号。 但造"展示感"不等于必须用稀有字体——加粗 + 放大字号 + 压缩字距同样有效，而且零乱码风险。

• 字体安全四层策略（按顺序取）

• .pptx 轨道必须同时设置 latin / ea / cs 三个字体槽位（中文走 ea，只写 run.font.name 只设了 latin → 中文掉回宋体）。直接用 scripts/pptx_kit.py 的 set_font() 一行搞定；手写时见手册 A1 的代码片段。
• 字号层级（px；1px≈0.75pt，即 ×0.75 = 磅值）：封面主标题 56–72（绝不低于 48）｜章节水印 100–150｜章节/模块标题 48–60｜页面标题 32–40（绝不低于 28）｜卡标 18–22｜正文 15–18（不低于 13）｜注释/页码 11–13（不低于 11）
  • 落到 .pptx 的磅值速查：封面 54pt｜章节 45pt｜页标题 30pt｜卡标 16pt｜正文 14pt｜注释 11pt｜巨号锚点 80pt。自检器按这套下限判定，低于即报 P0。
• 铁律：① 正文 ≥14pt、注释 ≥11pt；② 标题一律粗体；③ 封面/章节/封底用展示字体或第②层方案；④ 每页 ≥1 个「品牌色巨号锚点」放大到正文 3–5 倍

页面类型体系（周慧慧 10 型）

政务 / 工作汇报轨另有一套页面类型 G1–G9（封面红头式 / 目录 / 章节过渡 / 总体情况 / 主要成效 / 完成情况明细 / 存在问题 / 下一步举措 / 结尾页），见 references/gov-report-style.md §4。

⛔ 禁止裸排（最高优先级）：生成任何页面时，必须先打开 references/premium-templates.md，复制对应类型高保真 YAML 骨架（展示字体+品牌色锚点+装饰几何+柔和投影），只替换文字。 不得从空白拼「标题+灰卡+默认字号」。

版式库（按优先级）：

1. references/premium-templates.md ⭐【默认首选】1280×720 高保真 YAML，蒸馏自用户 14 份真实精美 PPT
2. references/layout-pattern-library.md —— 国企 28 版式库（封面/目录/流程/内容/模型五类，去 AI 味关键点、版式选用决策表），国企模式必备补充；§J 提供「工作坊页面类型→版式→骨架」速查与高频版式骨架组合映射，工作坊模式直接查这一节

2.5 references/visual-design-spec.md §六/§七 —— 8px 网格 + L1/L2/L3 阴影层级，国企模式所有 bounds 与 outerShdw 参数的取值依据

1. references/page-templates.md —— 通用语法骨架（fallback）
2. references/summary-report-layouts.md —— 工作总结/汇报/计划类原型（C1–C7 + B1–B10）
3. references/layout-patterns.md —— 周慧慧 12+ 布局模式（设计灵感）
4. references/timeline-flow-layouts.md —— 时间线/流程图专题（T1–T7）

第 5 步：大纲文档（outline.md）

每页格式：

## 第 N 页：[页面类型] [标题]
- 内容要点1
- 内容要点2
- 内容要点3
- ...（3-8 个要点）
备注：特殊说明（图示类型、表格结构、AI 提示词需求等）

关键原则：先完成全部大纲再生成页面；每页内容量匹配页面类型；教学逻辑连贯（前页铺垫、后页回应）。标题必须「结论式」（✅ AI 工具三问法：需求-场景-效果 ❌ AI 工具介绍）。国企模式：由 final_report 逐页转换（见 E），保留每页版式建议与示例本土化标注。

第 6 步：页面生成规范

⚠️ 执行轨道（先看这里）：本章下方展示的是 PPTD（YAML）写法，那套渲染器（含 check.sh）在本环境不可用。

实际执行时按以下优先级选轨道：

1. 默认主轨道 —— tencent-pptx 技能（产出 .pptx）：在项目目录建 DESIGN.md（视觉规范，内容同下方 design.md 要求）+ STORY.md（逐页内容，由 final_report.md / outline.md 转换），然后按其流程生成，最后用 present_files 呈现文件。
2. 设计稿轨道 —— ardot-slides：用户要的是「设计稿 / mockup / 画布」而非 .pptx 文件时走这条。
3. 生成后修改：已产出的 .pptx 一律用 tencent-local-office-edit 编辑，禁止回退到源文件重跑。

下方 PPTD 的 YAML 结构、元素类型、尺寸速算、格式陷阱仍然全部有效——它们定义的是「版面应该怎么排、多宽多高、什么会出错」，把这些参数翻译成所选轨道的实现即可。

设计文档（design.md，强烈建议）

参考 references/workflow.md 的 Step 4：写 design.md 必须预先列出 12+ 种布局模式在各页使用计划，避免视觉单调。含：Profile 基线声明、风格基线、风格细节（色/字/容器/图）、布局系统、风格使用规则、风险禁用清单、完整 theme YAML。国企模式：theme.colors 用九套配色之一；布局系统注明 28 版式池与「连续两页不重复」纪律；标题区采用「主色色块条 + 左对齐 + 模块编号角标 + 2px 浅灰分隔线」（见 references/visual-design-spec.md §四）；并声明 8px 间距刻度、L1/L2/L3 阴影层级与 60-30-10 配色面积分配，三者写进「风格细节」与「风险禁用清单」。工作坊模式：布局系统须额外列出 6 种工作坊专属页面类型在各页的分布，并附「问-练-议-评」闭环清单与能量曲线时段分配表。

高级感与节奏（圣经 references/premium-aesthetic.md，现成 YAML references/premium-templates.md）：

• 目录页必备：≥10 页课件含 1 页目录
• 封面/章节/封底调用模板：直接复制 premium-templates.md 对应 YAML（含渐变底、水印数字、装饰、投影），只换文字；微调配色遵循「换肤不动结构」
• 柔和投影：所有卡片加 outerShdw（opacity 0.06–0.14、blur 10–18、offsetY 3–6）统一
• 渐变与奶油底节奏：封面/章节/封底品牌色→奶白渐变；正文页纯白与奶油 #FCF8F3 交替
• 版面多元化：错落卡片/阶梯上升/脊线流程/重叠圆徽；连续两版面不重复；构图契合知识点数量（3 点三角、4 点四象限…）
• 页眉三式轮换：hdr_a（小色块+标题）/ hdr_b（大号水印编号）/ hdr_c（竖条+右上标签）
• 装饰元素：菱形/圆点阵/超大浅色水印数字/★/✓，低透明自由分布但绝不出框
• 国企模式另需：标题区结构化（色块条+角标+分隔线）、图片仅中国元素、禁高饱和色

主文件结构（PPTD 历史写法示例，仅作结构参考）

pageType: presentation
theme:
  colors: { ... }
  textStyles: { ... }
  tableStyles: { ... }
pages:
  - file: pages/p01_cover.page
  - file: pages/p02_toc.page

走 tencent-pptx 时的等价结构：主文件 = DESIGN.md（theme 部分）+ STORY.md（pages 部分）；逐页内容再交给生成流程产出 .pptx。

生成顺序（严格）

1. 先定全局：DESIGN.md（配色 / 字体 / 字号档 / 8px 网格 / 阴影层级 / 版式池）+ STORY.md 骨架（页码与标题清单）
2. 再逐页填充 STORY.md（第 1,2,3… 页顺序写；多页内容可并行起草）
3. 每确定一页内容，立即落地该页的版面参数（位置 / 尺寸 / 层级），避免前后不一致
4. 最后生成 .pptx 并按 7.1 人工自检清单逐页核对

文本框尺寸速算（详见 references/workflow.md）

• 行高 ≈ fontSize × 1.5；wrap: false：标题/标签/徽章/数字/导航；wrap: true（默认）：正文

致命格式陷阱（完整版 references/pptd-checker.md）

• 表格：必须用 columnWidths + rowHeights + rows（Cell 数组），禁止简写
• 颜色变量：color: "$primary"（YAML 字符串引用，勿裸写 color: $primary）
• 文本框高度：4 行 14px 文字至少 94px（4×21+10）
• 元素重叠：文本不得相互遮挡，须完全在背景 shape 内；底部留 40px 安全区

页面 YAML 结构示例

pageType: content
background:
  type: solid
  color: "$white"
elements:
  - elementId: p01-marker
    elementType: shape
    bounds: [60, 30, 16, 16]
    shapeName: rect
    fill: {type: solid, color: "$primary"}
  - elementId: p01-title
    elementType: text
    bounds: [60, 70, 800, 45]
    content:
      fontSize: 32
      color: "$dark"
      fontFamily: "MiSans, Microsoft YaHei"
      align: [left, middle]
      wrap: false
      text: |
        <p><strong>页面标题</strong></p>

第 7 步：格式自检 + 七维质量提升

7.1 版面缺陷自检（脚本自动 + 人工视觉，双轨必做）

v4 起本技能自带可执行检查器，原 check.sh（/app/.agents/skills/pptx/scripts/check.sh）在本环境不可用的问题已解决。

完整清单与成因见 references/anti-defect-playbook.md；references/pptd-checker.md 的 10 大陷阱与 workflow.md 的速算表仍然有效。

第一轨 · 脚本自检（抓客观缺陷，产出 .pptx 后立刻跑）

cd <技能目录>/scripts
python check_layout.py 课件.pptx            # 常规：P0 必须清零
python check_layout.py 课件.pptx --strict   # 对外交付：P1 也清零
python check_layout.py --selftest           # 首次使用或改动检查器后必跑：自证它真能咬人
python audit_color.py --selftest            # 同上：配色审计器也要先自证能咬人（勿省）
python audit_color.py 课件.pptx             # 暖色 0 / 越界色 0 / 灰字 0
python audit_text.py 课件.pptx              # 末行孤行审计：只留 2.5~5 字的正常尾行

check_layout.py 不管孤行（末行只剩 1~5 个字的"断尾"），也不管配色。长文档（30 页以上）

必须补跑 audit_text.py 与 audit_color.py；两者直接读成品每个 text_frame / 每个 run 的颜色，

能覆盖 pptx_kit 内部绘制的表格行、流程卡、banner_note 标签、页码等生成脚本看不到的部分。

四层质检闭环与页眉双断言口径见 references/blue-biz-style.md §9；

双色纪律（灰字全改黑 / 彩色只用绿和蓝）的整套做法见 §10，配套缺陷条目见

references/anti-defect-playbook.md 缺陷四 D1–D4。

⚠️ 检查器"假通过"是真实发生过的事故（D3）：audit_color.py 初版用

str(c.type) != "MSO_THEME_COLOR.NOT_THEME_COLOR" 判显式 RGB，而 python-pptx 实际返回

"RGB (1)"，导致 1139 个 run 全被跳过——含金色 #D9B65C 的旧版也报 ✅ 合规。

铁律：任何专项检查器，先拿一个"确定有缺陷的旧版"跑一遍；不报错说明检查器坏了，

不是文件对了。等价地，判填充类型要写 "SOLID" in str(sh.fill.type)（实际是 "SOLID (1)"）。

自动拦截项与对应缺陷：越界（A5）、中文 run 未设 ea 字体（A1）、高危商业字体（A1）、字体名含逗号（A2）、emoji 与缺字形符号（A4）、文本溢出卡片或画出画布（A5/B6）、文字互相遮挡（B3）、正文或注释字号低于下限（B1）、命中 normAutofit（A3）、单一非中性色面积 >20%（B2）、图片非标准比例（B7）、表格行数 >8（A6）、单页文字量过大（B6）、连续同构图（C1）。

第二轨 · 人工视觉核对（抓「丑」与「死板」，脚本抓不到）

python preview_grid.py 课件.pptx --cols 2   # 本机无 PowerPoint / WPS 也能先看图

1. 单页核对：标题区是否结构化？正文 ≥14pt？是否有巨号锚点？是否有 1–2 种装饰？卡片是否组内统一、组间错落？断行有没有出现行首标点？
2. 缩略图整套核对（抓"死板"最有效的一招，看 *_grid.png）：一眼能看出几个章节吗？有连续多页长得一样吗？有连续多页都很满吗？有某页突然换了一套设计语言吗？核心页比普通页更有视觉权重吗？
3. 跨机核对（防乱码唯一可靠手段）：拷到另一台没装你字体的电脑，或 WPS 与 PowerPoint 各开一次，看标题有没有变宋体 / 变方块。
4. 对比度与填充：正文与背景 ≥4.5:1；大面积空白块、卡片空一截 → 补内容或收缩容器。

修复优先级：P0 全部（越界 → 乱码 → 溢出 → 遮挡 → 字号）→ 死板（重排整套节奏，再改单页）→ 丑（对比 / 焦点 / 留白 / 统一）→ 一致性。逐项清零后再交付。

7.2 七维质量提升（五维基础 + 工作坊两维）

对 final_report / outline 逐页过七维自检，任一不达标回到对应页修改后再生成：

配套子检查（维度六、七的落地判据）：

• 开场区有【课堂公约】页 + 分组角色分工页？结营区有训后行动计划页？
• 每个演练环节都有 ★活动指令页 + 同伴互评页？互评有评审维度表与规则？
• 每页 final_report 都标了时段与能量匹配？

7.3 七维判据详解（为什么要这么要求）

标准模式（非国企非工作坊）可选择性应用前三维中的「标题排版 / 正文详化 / 示例本土化」，使通用课件也更专业；维度六、七仅工作坊课件强制。

国企 + 工作坊（如央企内训师培养工作坊）七维全过，这是精品课件的质量底线。

第 8 步：交付与记忆沉淀

8.1 交付物（按 tencent-pptx 轨道）

1. .pptx 成品文件——必交付，用 present_files 呈现给用户
2. outline.md 内容大纲（国企 / 工作坊模式附 final_report.md）
3. DESIGN.md 视觉设计说明（含配色轨道、字号档、8px 网格、阴影层级、版式池）
4. （可选）research_best_practices.md 行业研究
5. （工作坊模式必附）speaker-notes.md 讲师备注汇编——按页汇总时间分配 / 重点强调 / 常见误区 / 过渡话术，供讲师备课与课程传承

交付时总结：页数、模块结构、设计亮点、所走模式（标准 / 国企精品 / 工作坊增强）、七维自检结果。

8.2 交付验证（生成后必查）

• 页数：实际产出页数与 final_report / outline 规划页数一致吗？不一致说明规划稿没被完整读取，回头查格式。
• 标题：逐页标题与规划稿各页标题对得上吗？有没有串行、漏页、重复页？
• 版式节奏：连续两页版式是否重复？主色面积有没有超过 20%？
• 示例：页面上出现的示例是甲方场景，还是又滑回了通用泛化表述？

8.3 回复规范

向用户回复时保持简洁：

• 说清交付的页数、所走模式、核心设计决策
• 不罗列内部工具名、参数名、模型名、文件名路径细节
• 不承诺下载后的播放行为（平台转换行为不受本 skill 控制）

8.4 记忆沉淀

将本次项目关键信息写入工作区记忆目录（<workspace>/.workbuddy/memory/YYYY-MM-DD.md，按日期追加；跨客户复用的约定同步写入同目录 MEMORY.md）：

• 甲方背景、参训对象、课程用途、所走模式
• 视觉设计规范（主色轨道、辅助色、字体、版式规则）
• 已交付成果（页数、七维质量提升调整记录、工作坊互动与备注完备度）
• 用户偏好（内容详实度、示例风格、版式要求）

后续为同一客户制作新 PPT 时可复用，避免重复询问视觉规范。

关键设计原则

• 教学优先：每页有明确教学目的；复杂概念用「图示 + 口诀」双重编码；案例页含「情境→冲突→解决→启示」完整叙事；国企模式加「导入页 + 验收关卡」闭环。
• 做中学（工作坊核心）：工作坊课件不是「讲完再练」，而是「讲一点、练一点、评一点」。每个知识模块必须以 ★活动指令页收口，让学员当场产出可交付成果——课件的最高价值是学员的产出，不是讲师的 PPT。
• 讲师可传承：讲师备注四要素 + 结构化标题区 + 详化正文，让任何拿到课件的讲师都能标准化授课，不依赖个人经验、不靠老讲师口口相传。
• 视觉层次：每页最多 3 个层级（标题→要点→注释）；色块/卡片分组；关键数字放大至正文 2-3 倍作锚点；国企模式遵守「每页 ≤3 色 + 结构化标题区」。
• 一致性：同类型页面布局一致；章节页统一视觉语言（仅换编号与标题）；列表符号、卡片圆角、阴影全课件统一。
• 视觉单调预防：design.md 预排 12+ 布局模式，连续两版面不重复（含页眉 hdr_a/b/c 轮换）；国企模式叠加 28 版式池纪律；卡片统一 outerShdw 柔和投影、正文奶油底交替、装饰自由分布不出框。
• 反「丑 / 死板」双保险：周慧慧的「展示字体 + 巨号锚点 + 柔和投影」与 soe-premium 的「结构化标题区 + 去 AI 味版式 + 示例本土化」共同确保课件既漂亮又有企业专业度。
• 节奏服从能量：午后 13:30-14:30 是注意力低谷，此时段排动手演练而非纯讲授；上午高能量段排高密度知识输入。违背能量曲线的排课，内容再好也讲不进去。
• 实操上，直接以 references/premium-templates.md 的模板库为骨架来源，配色按模式切换，国企场景辅以 references/visual-design-spec.md 与 references/layout-pattern-library.md。

参考资料索引（25 份说明书 + 18 个可执行脚本）

最常打开的十个文件：references/plane-hero-family.md（v6.4 唯一头部语言：斜面折带四页骨架 + 照抄坐标 + 配图提示词 7 段式）+ references/plane-body-layouts.md（四个图形正文版式坐标表 + 六套取色 + 雷区）+ references/brief-and-pacing.md（v7.1 开工六问 + 受众×模式 12 格矩阵 + 页数节奏表）+ references/title-and-placeholder-rules.md（v7.1 标题必须表态 + 占位符 17 类）+ references/survey-and-density.md（用途 / 色系 / 文字密度三问 + 密度分档）+ references/use-cases.md（用途→骨架 / 页数 / 必备页面 / 红线）+ references/kickoff-and-options.md（必填清单话术 + 九节点方案速选池）+ references/anti-defect-playbook.md（出了乱码 / 丑 / 死板先翻它）+ references/cover-and-diagram-library.md（正文图表 8 形态抄坐标）+ references/premium-aesthetic.md（漂亮配方圣经）。

⚠️ 参考文件都是「构图与参数说明书」，不是可执行代码；真正的可执行轨道是 scripts/ 十七个脚本（工具箱 pptx_kit + 六问 brief / 三问 survey + 自检 check_layout / 孤行审计 audit_text / 配色审计 audit_color / 节奏审计 audit_rhythm / 乱码与字体 audit_glyph / 标题与占位符 audit_content + 预览 preview_grid + 样板 build_plane_demo + 回归 build_all_styles + 骨架台 test_layouts + 改旧稿 revamp_old + 拆模板 tpl_extract + 四件套 deliver + 安装自检 selfcheck）。PPTD YAML 与 HTML/CSS 片段需翻译成当前执行轨道（tencent-pptx 或 scripts/pptx_kit.py）的实现。详见顶部「渲染轨道说明」与「可执行渲染轨道」。

🆕 开工六问与内容层纪律（v7.1）

• references/brief-and-pacing.md 🆕⭐ —— 《开工六问与页数节奏》：Q4 受众四类（内部 / 高管 / 外部客户 / 会议）、Q5 演示模式三类（现场讲 / 发出去读 / 异步看视频）、Q6 时长 → 页数节奏表 10 档；正文上下两条线（body_max 密度定、body_floor 模式定）；三对必撞组合（精简+发出去读 P0 / 详尽+现场讲 P1 / 高管+60 分钟以上 P1）；12 格受众×模式矩阵（关心什么 / 标题写法 / 每页字数 / 备注要求 / 风险）。
• references/title-and-placeholder-rules.md 🆕⭐ —— 《标题必须表态 + 占位符残留》：T1 三类不合格标题（「整理汇总一览」结尾 / 纯标签 / 框架名单独当标题）+ 20 组正反例 + 三个可套句式（判断句 / 对照句 / 归因句）；T2 占位符 17 类清单（XXXX / 20XX / ○○ / lorem / TODO / [insert / Text N / 单击此处 / 请在这里输入）；结构页豁免规则；与改旧稿的关系（先清字再重排）。
• scripts/brief.py 🆕 —— 六问 + 节奏表 + 冲突检测，--selftest 自证 7 条。
• scripts/audit_content.py 🆕 —— T1 标题表态 + T2 占位符，--selftest 自证 6 条。
• scripts/deliver.py 🆕 —— 交付四件套（成品 + 每页备注摘要.md + 结构解析.json + 变更清单.json），备注按 40+ 版式码查讲法库，run_gate() 跑六道门。
• scripts/revamp_old.py 🆕 v7.1 加交证据 —— --fix 现在自动产出 <stem>_变更清单.json（逐条 {page, shape, kind, old, new, why}）+ <stem>_体检报告.md（扫修后文件）；新增 --changes / --recheck / --no-evidence。

🆕 斜面折带族（v6.4 · 当前唯一头部语言）

• references/plane-hero-family.md 🆕⭐ —— 《斜面折带族：封面 / 目录 / 转场 / 封底》。做头部四页先翻这一份。
  • §1 骨架总图：纸白 #FEF7F5 + 右侧三层斜切面（切点 739 / 872 / 1232，斜率 −0.42）+ 45° 角块（x ≤ 311）+ > 折带（apex 392,360 / 厚 120）
  • §2 四页内容位（封面 / 目录 / 转场 / 封底各段 y 起点与字号档）
  • §3 六套色系的斜切面取色阶（_mix(deep(0.02), deep(0.52), t) 局部底锚定法，深调偏亮的紫 / 蓝必须这样取）
  • §4 调用示例（S.cover/toc/section/end 与 K.plane_*）
  • §5 雷区六条｜§6 附：需要配图时的提示词 7 段式（画面类型 / 版式骨架 / 分隔图形 / 配色 / 主题 / 留白纪律 / 质感画质 + 负面词）
• references/plane-body-layouts.md 🆕⭐ —— 《四个图形正文版式》：L31 wave_arrow / L32 circle_cards / L33 ring_callout / L34 pyramid_tiers，含照抄坐标、正文容量上限、图形钉底铺满 y150–640 的算法、五个雷区。
• scripts/build_plane_demo.py 🆕 —— 8 页斜面折带样板（封面 / 目录 / 转场 / 波浪箭头 / 压边大圆 / 圆环四向 / 金字塔 / 封底），第一行 S = K.style("中国移动蓝") 即可整份换色系。

🆕 开篇三问（v6.4）

• references/survey-and-density.md 🆕⭐ —— 《开篇三问与文字密度》：Q1 六类用途 / Q2 六套色系（含推荐映射）/ Q3 三档密度（每页条数、正文字号下限、拆页阈值、每页字数上限）；三问话术照抄即用。
• scripts/survey.py 🆕 —— 问卷卡打印器：--table 出问卷、--purpose 汇报 看预填建议。

开工双确认流程（v5.3）

• references/kickoff-and-options.md ⭐ —— §1 S0 八项必填清单（话术 + 默认处理 + 六条规则）｜§2 S1 九节点速选池（27 张方案卡）｜§3 决策记录模板｜§4 兜底套餐。S0-0 三问已改为 v6.4 的「用途 / 色系 / 文字密度」。

用途定位（v6.0，v6.4 换色系）

• references/use-cases.md ⭐ —— §1 三问定场景｜§2 十类用途总表（骨架 / 页数换算 / 推荐套餐 / 特有红线）｜§2.1 用途→必备页面清单｜§3 六套色系菜单（橙色系 / 党建红 / 正红色系 / 紫色商务 / 国家电网绿 / 中国移动蓝，含色值与 K.style() 调用名）｜§4 用途 × 场合 × 色系交叉校验表。
• scripts/build_all_styles.py —— 6 套色系 × 10 页全回归（同内容横切六套 + 三道门 + 对照表），改组件后必跑。

封面与图表范式库（v5，v6.4 收口）

• references/cover-and-diagram-library.md ⭐ —— 做正文图表时抄坐标。
  • §1 封面构图六范式的原理（⚠️ v6.4 起封面 / 目录 / 转场 / 封底一律走斜面折带族，六个封面函数已删除，此节只读构图意图）
  • §2 章节页（→ 已统一为 plane_section）｜§3 目录 2 式（→ 已统一为 plane_toc）
  • §4 正文图表 8 形态：D1 并列卡片流｜D2 箭头递进｜D3 编号步骤条｜D4 阶梯递进｜D5 六边形链｜D6 横向时间线（上下交错）｜D7 矩阵｜D8 泳道
  • §5 选用决策表：按「讲什么」选范式，不按「好看」选

缺陷防治与可执行轨道（v4 起）

• references/anti-defect-playbook.md ⭐ —— 《版面缺陷防治手册》（乱码 A1–A6 / 丑 B1–B13 / 死板 C1–C6 / 配色纪律 D1–D4 / 改版重制 E1–E4 / v6.4 新增 V1–V7：图形内接区放正文 / 图形没铺满 / _mix 方向反 / 照抄框高 / 窄柱正文 / 深灰字，每条含「现象 → 根因 → 修法 → 自检」）。用户一说「乱码 / 很丑 / 很死板」就先翻这一份。
• scripts/pptx_kit.py —— 安全渲染工具箱：set_font() 写全 latin/ea/cs；no_autofit()；8px 网格 snap/SP；六套 Theme（各含 pop 跳色与 grad2）；L1/L2/L3 shadow()；decor() 豁免；组件 hdr/title_zone/card/callout/chip/anchor_number/watermark/footer；头部四页 plane_cover/plane_toc/plane_section/plane_end + 骨架件 plane_bg/_corner/chevron/poly；四个图形版式 wave_arrow/circle_cards/ring_callout/pyramid_tiers；几何 bezier/smooth_curve；页面级操作 clear_slide/slide_at/move_page/zip_health/page_timing（见 playbook 缺陷五 E1）。
• scripts/check_layout.py —— 7 类 P0 + 6 类 P1；--strict 对外交付 / --json 流水线 / --selftest 自证；DECO_ 前缀视为纯装饰，豁免出血与色面积。
• scripts/audit_color.py —— 暖色 / 越界色 / 灰字五类计数 + 逐处明细；判定用色相关系而非色值白名单（_lighten/_darken 派生色不误报）。坑：显式 RGB 的 ColorFormat.type 是 "RGB (1)"，旧写法会跳过全部 run 给出假 ✅；填充类型同理要写 "SOLID" in str(...)。
• scripts/audit_rhythm.py —— 「连续 15 页不重复 + 全篇同版式 ≤2 次」E1–E5；读 <p:cSld name="LAYOUT=Lxx">，语义表 K.LAYOUT_CODES。
• scripts/audit_glyph.py —— 「页面文字不会变方块」G1–G3；圈码 / emoji / ⋯ / 字体链，--fix 可修旧稿。
• scripts/audit_text.py —— 末行孤行审计（check_layout 不管折行）；末行 ≤1.5 字必修，2.5–5 字属正常尾行。
• scripts/preview_grid.py —— 缩略图预览（圆角 / 椭圆 / 多边形 / custGeom / 虚线 / 裁剪图 / 渐变形状遮罩全支持）；看图只谈版式与密度，不谈字体细节。
• scripts/selfcheck.py —— 一键安装自检（依赖 / 文件完整性 / 样板 + 回归入口 / 三个检查器自证 / 5 风格清单）。分享给别人后让对方先跑这一条。

历史资料（已下线轨道，仅作参考，无 K.style() 入口）

• references/blue-biz-style.md / references/gov-report-style.md / references/visual-design-spec.md（A–I 九套配色）—— 蓝调商务 / 政务两轨 / 央企深蓝均已下线，但公文红线（政治表述不改写、姓名职务逐字核、数据有口径来源、涉密不上网、不混两种红）、双色纪律、去 AI 味手法、8px 网格与 L1/L2/L3 阴影仍有效，可查阅取用。
• references/curve-photo-hero.md / references/curve-photo-layouts.md —— 已删除（v6.3 曲线照片族整族下线）。

参考说明书

• references/premium-templates.md ⭐ 【默认首选】 —— 高保真可直接复制的 YAML 模板库（1280×720，蒸馏自用户 14 份真实精美 PPT）。生成任何页面优先套用，只换文字、保留装饰与字体。
• references/premium-aesthetic.md ⭐ —— 精美高级感排版圣经（展示字体+超大粗体标题+品牌色巨号锚点+克制装饰+柔和投影/渐变底；字体表与字号档、配色体系、装饰几何、材质节奏、强制规范与禁忌）。⚠️ §1 字体表里的稀有商业字体按「缺陷一 · 字体安全四层策略」降级使用。
• references/visual-design-spec.md —— 国企商务风视觉设计规范（九套配色方案 A–I、60-30-10 配色面积法则、8px 基准网格与间距系统、L1/L2/L3 阴影层级、6 大专业设计原则、6 个核心组件骨架、字体、28 种版式清单、标题排版、图片约束、模板色转译原则）。国企/央企模式必读。
  • §一 色彩（含 60-30-10）｜§二 字体｜§三 28 版式清单｜§四 标题排版｜§五 图片规范｜§六 8px 网格｜§七 阴影层级｜§八 6 大设计原则｜§九 核心组件骨架（⚠️ HTML/CSS 写法，仅提取构图逻辑，勿照搬代码）
• references/layout-pattern-library.md —— 28 种版式构图库（基础 12 类 + 模板提炼 16 类；去 AI 味关键点、课程场景示例、版式选用决策表、模板来源映射、视觉动线与骨架交叉引用）。国企模式版式补充。
  • §A–E 各版式构图规则｜§F 基础 12 类补充｜§G 去 AI 味微设计｜§H 版式选用决策表｜§I 模板来源映射｜§J 视觉动线与骨架组合映射（含工作坊页面类型→版式→骨架速查）
• references/content-structure-guide.md 🆕 —— 精品课程内容结构指南（模块结构、导入页模板 A/B/C、验收关卡设计、行业经验嵌入位置、正文详化写作、示例本土化清单、6 种工作坊专属页面类型、讲师备注四要素、能量曲线与节奏设计、4 种互动设计模板）。国企/工作坊模式内容规划必读。
  • §一～§七 通用内容结构｜§八 工作坊 6 种专属页面类型｜§九 讲师备注四要素｜§十 能量曲线与节奏匹配｜§十一 互动设计 4 类模板
• references/expert-beautification-tips.md 🆕 —— 专家级排版美化锦囊（配色进阶 / 字重节奏 / 图表美化 / 图片处理 / 留白呼吸 / 反 AI 味清单 / 一致性 design token / 封面封底进阶）。与 visual-design-spec 互补：规范"必须做"，锦囊"做了更好"。所有模式可用。
• references/workflow.md —— 输入读取、需求分析、design.md 规范、图片策略、文本框速算
• references/layout-patterns.md —— 周慧慧 12+ 布局模式库（含 1280×720 bounds 示例）
• references/timeline-flow-layouts.md —— 时间线/流程图专题布局（T1–T7）
• references/summary-report-layouts.md —— 工作总结/汇报/计划类排版（C1–C7 封面 + B1–B10 正文）
• references/teaching-models.md —— 教学模型完整说明与 PPT 应用
• references/page-templates.md —— 各页面类型通用语法 YAML 骨架（fallback）
• references/pptd-checker.md —— 10 大格式陷阱 + 检查器问题分类修复（整合手册）。检查器脚本本环境不可用，按 7.1 人工自检清单逐页核对。

适用与不适用场景

适用（本 skill 主导）：

• 企业培训课程 PPT：内训课件、认证培训、微课课件、参赛课件
• 国企 / 央企精品课程、内训师培养项目课程开发、师课共建工作坊
• 工作坊课件、讲师授课参考 PPT（要求「现场带教、学员当场产出」）
• 培训项目方案汇报 PPT、经验萃取与课程体系设计类课件
• 事业单位 / 党政机关的工作总结与专项汇报（半年/年度/专项，需红头式封面、公文编号、三线表与数据口径）
• 企业工作汇报 / 述职 / 季度总结 / 年度总结 / 项目汇报（需结论先行、成效数据、问题与下一步计划）
• 招商推介 / 项目推介 / 政企合作提案（区位优势、产业配套、政策支持、效益测算、落地路径）
• 工作总结 / 述职 / 计划 / 复盘类演示文稿（10 页以上、需章节划分与教学逻辑）

不适用（转交其他技能）：

• 编辑 / 美化 / 翻译已有 .pptx 文件 → 走 tencent-local-office-edit
• 用户要的是设计稿 / mockup / Ardot 画布而非文件 → 走 ardot-slides
• 纯数据可视化仪表盘 → 走 website 类技能
• 营销海报 / 单页 key-visual → 走 poster / image 类技能
• 非课程类、10 页以内的简易商务汇报 → 直接用 tencent-pptx，无需本 skill 的前置内容工程与七维质量门
• 少于 10 页的简易 pitch deck、纯图片品牌展示、单一主题短页 → 不适用