name: ppt-ququ-vision
description: PPT-ququ 视觉工作台:做 PPT / 公众号图 / 海报 / 配图时使用,内置 8 种视觉风格(暖橙沙龙、手绘涂鸦、创意杂志、钴蓝数据、金棕金融、前沿深色、单色瑞士等),自动匹配适合的风格排版出图。直接说需求即可,如「帮我做份课程 PPT」「给公众号做张封面图」「出一份数据报告 PPT」。适合教师课件、自媒体配图、职场汇报、电商案例。曲红霞原创。
metadata:
agent_created: true
version: "1.0"
author: 曲红霞 (Qu Hongxia)
license: MIT
display_name: PPT-ququ 视觉工作台
tags:
- PPT风格
- 视觉工作台
- 公众号图
- 海报
- 生图预设
- 版式库
- 风格库
- 数据报告
- 电商案例
- 幼小衔接
- 银发赛道
- 课程课件
trigger:
- 用XX风格做PPT
- 视觉工作台
- 风格壳
- 按我的风格出图
- 视觉风格
- 生图预设
- 暖橙沙龙风
- 沙龙PPT
- AI沙龙风格
- 暖橙风格课件
- 手绘风
- 手绘PPT
- 卡通风格
- 涂鸦风
- 儿童插画风
- 创意杂志风
- 杂志风PPT
- 时尚排版
- 杂志封面风
- 钴蓝数据风
- 数据风PPT
- 数据报告风格
- 运营周报风
- 金棕金融风
- 金融风PPT
- 商业方案风格
- 保险理财风
- 古金风格
- 顶级审美
- 高级感
- 高质量设计
- 质感校准
- 大赛级质量
- 前沿深色风
- 深色风PPT
- 科技风PPT
- 毛玻璃风格
- 发布会风
- 深底浅字
- 单色瑞士风
- 瑞士网格
- 极简风PPT
- 黑白极简
- 现代主义风格
- 做PPT
- 生成PPT
- 制作PPT
- PPT排版
- 课件
- 做课件
- 海报
- 做海报
- 公众号封面
- 公众号头图
- 配图
- 封面图
- 演示文稿
- 数据报告
- 幻灯片
PPT-ququ 视觉工作台(一体化)
曲老师自研视觉体系的一体化 SKILL:原 1 个主骨架 + 8 个风格壳合并为单一文件。三层架构不变:版式骨架库(怎么排)+ 风格库(长什么样)+ 生图预设库(配什么图)。
调用时:选定风格 → 组合版式 → 按用途调生图预设 → 叠加顶级审美质量铁律,一键出整套。
一、版式骨架库(10 种版式,全风格通用)
| 版式 | 结构 | 适用 |
|---|---|---|
| L1 封面页 | 大标题 + 副标 + 装饰条 + 底部水印页码 | 开篇 |
| L2 目录页 | 编号圆 + 横向流程 / 纵向列表 | 总览 |
| L3 章节页 | 大数字 + 章节名 + 一句话导语 | 转场 |
| L4 痛点页 | 左侧标题 + 右侧堆叠白卡(痛点+解法) | 痛点→分析 |
| L5 分析页 | 双栏对比 / 三段铺垫 + 底部重色结论条 | 分析 |
| L6 策略页 | 左编号列表 + 右重色块铁律 | 策略 |
| L7 数据页 | 横向条形图 / 渐变进度条 / 表格 + 解释卡 | 数据 |
| L8 流程页 | 图标→箭头→图标→箭头,末端重色节点收口 | 步骤 |
| L9 对比页 | 双卡镜像 + 中间箭头 | 前后/因果 |
| L10 收口页 | 底部满版重色条 / 大字金句 + 动作词 | 结尾 |
二、12 条设计共性(所有风格强制执行)
- 底色统一:全页单浅色底(米黄/浅蓝/米白),不正负混用。例外:前沿深色(深色壳)反向执行——深底浅字,其余 11 条明暗反转(发光代替阴影)
- 配色三元组:底色 + 主文字(深棕/深蓝)+ 单色强调(橙或蓝),绝不超过 3 色
- 左对齐标题:左上粗体大字 + 下方短装饰条(红线/蓝竖条/小圆点)
- 卡片化主体:内容装进白底圆角卡片,描边近乎透明,靠阴影与留白区分
- 强对比终点:每页一个重色块(满版色条/实心圆/深色进度条)收口
- 编号一律实心圆 + 白字,不用方块或罗马数字
- 关键词重音:被强调词涂强调色粗体,普通字深色,次要说明浅灰
- 图标极简:单色线性图标(齿轮/对话泡/对勾/雷达),只做节奏点
- 数据=水平条形或列表:TOP 用渐变横向条形;分类用「标签+数值」列表
- 流程=横向串联:图标→箭头串联,末端重色节点收口
- 底部固定栏:品牌水印(左下)+ 页码(右下),保持系列感
- 图文比约 6:4:文字为主,插画只做隐喻(3D 阶梯/卡通人物),不堆砌
三、风格库(8 风格内嵌)
调用任意风格时,按对应小节的配色 Token 与质感规则执行,并叠加第四节质量铁律。
风格 1 · 暖橙沙龙风(style-warm-orange-salon 并入)
源自参考图 38-43 AI 沙龙套。米黄底 + 暖橙强调 + 深棕文字,圆角卡片 + 胶囊标签 + 重色块收口。温暖、口语化、课堂感。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #FBF6EE | 全页铺底 |
| 卡片底 | #FFFFFF | 白卡主体,描边近透明 |
| 强调色 | #D85A30 | 关键词/胶囊/重色块/编号圆 |
| 主文字 | #412402 | 标题、正文 |
| 次要文字 | #8C7B66 | 说明、脚注 |
| 浅标签底 | #F5E6D8 | 胶囊标签、椭圆标签 |
质感规则:标题下短暖橙/砖红条装饰;白底圆角卡(rx≈12)靠留白分层;编号暖橙实心圆+白字;胶囊标签(浅底橙字或橙底白字);每页底部满版暖橙条白字收口;图标深棕/暖橙单色线性;数据横向暖橙渐变条形或标签+数值列表;页脚左下小红点水印+右下页码(06/10)。
适用场景:课程 PPT、沙龙/讲座分享、培训课件、教学材料(供应链/创新创业/AIGC 课)。
生图预设锚点词:暖橙米黄底,圆角卡片,胶囊标签,单色线性图标,暖橙 #D85A30 强调,深棕文字,大留白,杂志拼贴感
触发词:暖橙沙龙风、沙龙PPT、AI沙龙风格、暖橙风格课件
风格 2 · 手绘涂鸦风(style-hand-drawn 并入)
浅彩底 + 手绘描边涂鸦 + 蜡笔色块,卡通人物 + 对话框 + 箭头涂鸦 + 纸张纹理。亲切、童趣、有温度,适合家庭/教育/银龄人群。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #FFF8EC(暖白)或 #F0F7F4(浅绿白) | 全页铺底 |
| 描边色 | #5B4636(蜡笔棕) | 所有图形描边,略粗(2-3px) |
| 主色块 | #F4A259(暖橙) | 主强调、按钮 |
| 辅色块 | #F7C948(明黄) #6BCB77(草绿) #4FB3CF(天蓝) #F47C7C(珊瑚红) | 多色分区 |
| 文字 | #4A3728 | 标题、正文 |
质感规则:手绘波浪线/虚线边框+纸张纹理+胶带贴纸;卡片不规则手绘矩形或对话框形粗描边;卡通人物(大头小身)复用同一形象做系列感;手绘图标(云朵/太阳/星星/铅笔/书包)带描边;编号手绘圆圈+手写数字或多色圆形贴纸;标题手写体风格、正文清晰黑体;重点对话框高亮+箭头涂鸦+蜡笔色强调;页脚手绘小图章/小尾巴,可省页码。
适用场景:公众号头图与正文(青鸟伴学托管、幼小衔接 30 天打卡、育儿系列)、儿童教育 PPT、银龄科普配图、社区活动海报。
生图预设锚点词:手绘涂鸦风,蜡笔质感,粗描边,卡通人物(大头小身),纸张纹理背景,对话框与箭头涂鸦,多色蜡笔色块,暖橙 #F4A259 主色,内容丰满不留白,温馨童趣
触发词:手绘风、手绘PPT、卡通风格、涂鸦风、儿童插画风
风格 3 · 创意杂志风(style-creative-magazine 并入)
米白底 + 黑字 + 大胆撞色点缀,大标题通栏 + 留白切割 + 醒目编号 + 图文错位。编辑感、设计感、高级但不冷,像一页杂志。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #F7F5F0(米白) | 全页铺底 |
| 主文字 | #1A1A1A | 标题、正文 |
| 撞色主 | #E63946(正红) | 编号、强调、装饰块 |
| 撞色辅 | #1D3557(藏蓝) #F4A261(杏橙) | 次强调、分区色块 |
| 次要文字 | #6B6B6B | 说明、眉题 |
质感规则:眉题(标题上方小号英文/拼音如 EDITORIAL / VOL.01);大标题通栏粗体跨栏排版,与正文字号悬殊;超大号编号数字与标题错位叠放;大量留白靠留白而非边框分割;图文故意错开对齐线;细线或色块条分隔栏目,色块可斜切/跨页;大引号+斜体短句做金句块;正红/藏蓝/杏橙撞色点缀面积小但醒目;杂志式页眉页脚(栏目名+页码)。
适用场景:公众号长文头图与内页、电商案例分析课程 PPT、品牌案例页、产品发布内容、有设计调性的文章配图。
生图预设锚点词:创意杂志拼贴风,米白底,黑字,正红 #E63946 撞色,超大标题通栏,留白切割,醒目大编号,图文错位,细分割线,编辑感,高级设计感
触发词:创意杂志风、杂志风PPT、时尚排版、杂志封面风
风格 4 · 钴蓝数据风(style-cobalt-data 并入)
浅蓝白底 + 钴蓝强调 + 深蓝黑文字,网格线 + 坐标轴 + 数据卡片 + 大数字锚点。理性、精确、可信,像一份专业的数据报告。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #F5F8FC(浅蓝白) | 全页铺底 |
| 卡片底 | #FFFFFF | 数据卡主体,细描边 #E2E8F0 |
| 强调色 | #1D4ED8(钴蓝) | 关键数字/条形/强调词/编号圆 |
| 辅强调 | #38BDF8(浅天蓝) | 次强调、渐变条尾端 |
| 主文字 | #0F172A(深蓝黑) | 标题、正文 |
| 次要文字 | #64748B(灰蓝) | 说明、刻度、脚注 |
| 警戒色 | #DC2626 / #16A34A | 涨跌/正负/好坏对比(中国市场惯例:涨红跌绿) |
质感规则:背景浅色网格参考线(透明度≤10%)强化数据感;图表自带坐标轴与刻度标签标注单位;数据卡=白底细描边+左上小标签(如「Q3 营收」)+中间大数字+底部小趋势;关键指标超大号钴蓝数字+单位小字一眼抓重点;横向渐变条形(钴蓝→天蓝)末端标数值;细线表格(表头浅蓝底)数据右对齐、关键格钴蓝加粗;编号钴蓝实心圆+白字;正负/涨跌用红绿(涨红跌绿),普通高低对比用深浅蓝;底部满版钴蓝条白字或深蓝实心方块收口;页脚左下浅灰数据源水印+右下页码(NN / 33)。
适用场景:数据报告、市场/行业分析、运营周报、财务数据页、教学中的数据模块(供应链数据/电商数据)、竞品数据对比。
生图预设锚点词:浅蓝白底,网格参考线,钴蓝 #1D4ED8 强调,数据卡片,大数字锚点,横向条形图,坐标刻度,理性精确,专业数据报告感,深蓝黑文字
触发词:钴蓝数据风、数据风PPT、数据报告风格、运营周报风
风格 5 · 金棕金融风(style-golden-finance 并入)
米金底 + 深棕文字 + 古金强调,衬线数字 + 金线描边 + 徽章印章 + 趋势箭头。稳重、贵气、可信,像一份高端金融研报。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #FBF7EF(米金) | 全页铺底 |
| 卡片底 | #FFFFFF | 白卡主体,金线描边(1px #E5D5A8) |
| 强调色 | #B8860B(古金) | 关键数字/金条/徽章/编号 |
| 深色块 | #3B2F1E(深棕) | 重色收口、章节底、铁律块 |
| 主文字 | #3B2F1E | 标题、正文 |
| 次要文字 | #8C7B5E(灰棕) | 说明、脚注 |
| 涨跌色 | #DC2626(红) / #16A34A(绿) | 涨红跌绿,中国市场惯例 |
质感规则:圆形金边徽章(「稳健」「优选」)或方形印章式角标,贵气来源;关键数字用衬线粗体显专业年代感;标题下细金线或卡片 1px 金描边;上升箭头/阶梯曲线做收益增长/复利隐喻;底部满版深棕条(米金字)或深棕实心方块收口;编号古金实心圆+白字;金额用「¥ 大数字+小单位」,列表用「标签+数值」,可加轻微金色渐变条形;米金底可带极淡证券纸/斜纹纹理(透明度≤5%);页脚左下研报式水印+右下页码。
适用场景:金融/投资/保险/理财报告、银发赛道商业方案、行业调研、贵价服务介绍、需要「稳重可信」调性的汇报。
生图预设锚点词:米金底,深棕文字,古金 #B8860B 强调,金色细线描边,圆形徽章,衬线数字,上升趋势箭头,低调奢华,专业金融研报感,稳重大气
触发词:金棕金融风、金融风PPT、商业方案风格、保险理财风、古金风格
风格 6 · 顶级审美质量档位(style-premium-aesthetic 并入)
顶级审美 = 质量档位,不是配色壳。 不定义颜色,而定义「高级感」的标准。任何风格做完都要过一遍 10 条质量铁律校准;生图时叠加锚点词提升质感。一句话原则:高级感 = 做减法(少用色、多留白、对齐精确、删除一切多余)。
10 条质量铁律(所有风格默认执行):
| # | 铁律 | 含义 | 自检问题 |
|---|---|---|---|
| 1 | 留白≥30% | 页面至少三成留白,不塞满 | 这一页能再删一块吗? |
| 2 | 色不过三 | 一页 ≤3 个颜色角色(底/文/强调) | 去掉一个颜色会更好看吗? |
| 3 | 对齐强迫症 | 所有元素对齐同一网格,无随手摆放 | 元素边缘能画一条贯穿线吗? |
| 4 | 字号阶梯 | 每页最多 3 个字号层级,比例悬殊 | 大中小是否一眼可辨? |
| 5 | 字距精确 | 标题负字距(-2~0),正文行距 1.5+,中文正常字距 | 字与字的间距均匀吗? |
| 6 | 一个视觉锚点 | 每页只有一个主角(大数字/大图/金句) | 第一眼看到的是唯一主角吗? |
| 7 | 删除装饰 | 无意义的渐变/阴影/边框全部删掉 | 这个元素有功能吗? |
| 8 | 色彩克制 | 强调色面积 ≤10%,宁小勿大 | 强调色像点睛还是像涂鸦? |
| 9 | 细节精细 | 圆角统一、描边 1px、图标同线宽、间距成倍数 | 元素间距是否 8 的倍数? |
| 10 | 系列一致性 | 全篇同一字体族/同一页脚/同一装饰语言 | 抽任一页能认出是同一套吗? |
质感规则(生图与版式通用):摄影级光影(柔和自然光、真实材质,不用塑料感 3D);高级灰阶(次级信息用灰色而非浅色字体);衬线点睛(大标题可用宋体/思源宋,正文无衬线);单色系延伸(同色系不同明度代替多色);边缘处理(卡片不叠厚阴影,用 1px 细描边或大留白区分);排版节奏(段落短、每行短,一句一行,宁断勿挤)。
使用流程:①按所选风格完成版式与配色 → ②逐条过 10 条铁律自检,不合格即改 → ③生图时把锚点词拼接到风格锚点词末尾 → ④全篇统一再过铁律 #10。
生图锚点词(叠加到任意风格锚点后):高级感,克制配色,大面积留白,精确对齐,柔光,真实材质,同色系延伸,衬线标题,摄影级光影,宁简勿繁
触发词:顶级审美、高级感、高质量设计、质感校准、大赛级质量
风格 7 · 前沿深色风(style-frontier-dark 并入)
深空蓝底 + 浅色文字 + 毛玻璃卡片 + 电光强调 + 发光,3D 与流体渐变点缀。未来、科技、沉浸,像一场科技发布会。与浅色壳规则相反:深底浅字,发光代替阴影。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #0B1220(深空蓝) | 全页铺底,可带极暗流体渐变 |
| 面板底 | rgba(255,255,255,0.08) | 毛玻璃卡片(白 8% + 模糊) |
| 强调色 | #38BDF8(电光蓝) | 关键词/光条/按钮/编号 |
| 辅强调 | #A78BFA(电光紫) #22D3EE(青) | 渐变、多节点 |
| 主文字 | #F1F5F9(近白) | 标题、正文 |
| 次要文字 | #94A3B8(灰蓝) | 说明、脚注、刻度 |
| 警戒色 | #F87171 / #34D399 | 涨跌/正负(红涨绿跌,中国市场惯例) |
质感规则(浅色规则的明暗反转):文字一律浅色禁止深字压深底;毛玻璃=半透明白面板+背景模糊(backdrop-filter)+边缘 1px 白 10% 描边;标题/大数字加轻微外发光或霓虹渐变描边(克制使用);页面角落深色流体渐变(深蓝→紫,亮度低)只做氛围;配图 3D 渲染(玻璃/金属/发光材质)尺寸克制;深底极暗网格/星点背景增加科技纵深;编号电光蓝实心圆+深色字或描边圆+浅色字;卡片靠明度分层(底 #0B1220/面板 8% 白/强调条)不用深阴影;底部满版电光蓝渐变条(深色字)或电光描边方块收口;页脚左下深灰品牌水印+右下页码。
适用场景:科技/发布会风格 PPT、AI 与前沿趋势讲解(创新思维课 AI 章节/AIGC 课)、元宇宙数字人、产品发布、视频缩略图、活动主视觉。
生图预设锚点词:深空蓝底,毛玻璃卡片,电光蓝 #38BDF8 发光强调,电光紫渐变,发光文字,3D 玻璃材质,暗网格背景,沉浸科技感,未来主义,高清渲染
触发词:前沿深色风、深色风PPT、科技风PPT、毛玻璃风格、发布会风、深底浅字
风格 8 · 单色瑞士风(style-swiss-mono 并入)
纯白底 + 黑字 + 唯一强调色,瑞士网格 + 无装饰 + 大留白 + 粗边框。极简、现代、设计感拉满,像瑞士平面设计(International Typographic Style)作品。
配色 Token:
| 角色 | 色值 | 用法 |
|---|---|---|
| 底色 | #FFFFFF(纯白) | 全页铺底,唯一允许的底色 |
| 主文字 | #111111(墨黑) | 标题、正文、粗边框 |
| 强调色 | #E63946(红)或 #1D4ED8(蓝)或 #F2C94C(黄),三选一 | 整篇只用一个,用于编号/斜切块/关键词 |
| 次要文字 | #888888(灰) | 说明、页码、刻度 |
| 灰阶 | #F5F5F5(浅灰) #DDDDDD(中灰) | 区块底、分隔线,均不带彩色 |
质感规则:所有元素对齐严格网格(4 或 8 的倍数),可显示网格线作装饰;不用渐变、阴影、圆角(除非设计故意),一切从简;大标题占满版面,文字本身即视觉主体;色块/图片用粗黑边框(2-4px)框起(瑞士风标志);强调色斜切三角/矩形做页面一角收口,不做满版;编号纯数字大字(无圆底)或强调色小方块+数字;大标题左对齐+右侧编号大数字(经典瑞士构图);配图黑白或单色与版面统一;细黑线(1px)分隔栏目替代卡片阴影;页脚左侧黑线+右下「页码/总数」等宽字体如 06 / 33。
适用场景:极简设计感 PPT、产品发布、品牌手册/VI 展示、设计课程、展览海报、需要「高级现代」调性的内容。
生图预设锚点词:瑞士平面设计风,纯白底,墨黑粗体字,单一红色强调,严格网格,粗黑边框,大留白,斜切色块,无装饰,现代主义,极简高级,等宽字体细节
触发词:单色瑞士风、瑞士网格、极简风PPT、黑白极简、现代主义风格
四、生图预设库(8 个 ImageGen prompt 模板)
每个预设 = 画幅 + 构图 + 风格锚点 + 文字规则。风格锚点随所选风格替换(从风格库取该风格的锚点词,顶级审美可叠加)。
| 预设 | 画幅 | 核心构图 | 典型用途 |
|---|---|---|---|
| P1 长文拼贴卡 | 9:16 | 多卡拼贴、每卡一要点、色块分区 | 公众号长图文 |
| P2 电商视觉 | 1:1 / 3:4 | 产品居中 + 场景背景 + 促销元素 | 门店商品图 |
| P3 概念海报 | 3:4 | 中心构图 + 大标题区 + 隐喻图形 | 活动宣发 |
| P4 视频缩略图 | 16:9 | 主体右置 + 左侧大字标题区 | 短视频封面 |
| P5 单色活动海报 | 3:4 | 大色块 + 极简文字 + 留白 | 线下活动 |
| P6 公众号头图 | 2.35:1 | 左文右图 / 居中标题 | 推文封面 |
| P7 知识卡片 | 1:1 | 单要点居中 + 图标装饰 | 教学/科普 |
| P8 场景插画 | 随版式 | 人物 + 场景叙事 | PPT 隐喻配图 |
预设模板示例(P1 长文拼贴卡)
【长文拼贴卡 · 预设】
画幅:9:16 竖版长图
任务:把以下 N 条要点做成拼贴卡——
风格锚点:【替换为所选风格的锚点词】
布局:每张卡片一个要点,卡片间用色块和留白分隔,从上往下阅读
文字:大标题加粗,正文 13-16px,关键数字用强调色高亮
元素:每卡配一个线性小图标,避免真实照片
配色:【替换为所选风格的配色 Token】
其余 7 个预设结构相同,仅画幅/构图/用途不同,调用时按表替换。
五、调用协议
用户说「用 XX 风格做 YYY」时,执行:
- 解析:风格名(匹配风格库 8 节)→ 版式需求(封面/目录/数据/对比/流程/收口按内容选)→ 内容大纲 → 是否需要生图预设
- 从「三、风格库」取该风格的配色 Token + 质感规则(不再跨 skill 加载)
- 按「一、版式骨架库」组织页面,逐页遵守「二、12 条共性」
- 生图:按用途选 P1-P8 预设,填风格锚点词生成
- 全部完成后过「风格 6 顶级审美」10 条铁律自检
- 输出:HTML 母版或 PPT 均可,先出初稿供迭代
一句话调用示例
- 「用手绘风做青鸟伴学公众号头图 + 3 张知识卡片,主题 XX」→ 风格2 + P6/P7
- 「用暖橙沙龙做供应链课程 PPT,封面+痛点+分析+策略+收口」→ 风格1 + L1/L4/L5/L6/L10
- 「用创意杂志做电商案例长图文」→ 风格3 + P1
- 「用钴蓝数据做运营周报」→ 风格4 + L7
- 「用金棕金融做银发赛道商业方案,叠加顶级审美」→ 风格5 + 风格6
- 「用前沿深色做 AIGC 课第一章」→ 风格7 + L3/L10
- 「用单色瑞士做品牌手册」→ 风格8 + L2/L10
六、扩展指南(新增风格)
在「三、风格库」末尾追加一节,复制以下结构,并同步把触发词并入 frontmatter 的 trigger 列表:
### 风格 N · XX 风
一句话特征描述。
**配色 Token**:| 角色 | 色值 | 用法 | 表格
**质感规则**:... **适用场景**:... **生图预设锚点词**:```text ... ``` **触发词**:...
七、工具链执行规范(tencent-pptx / slidep,PPT 场景强制)
用 slidep 工具链批量生成 PPTX 时的踩坑记录与标准流程,避免重复踩坑。
7.1 标准流程
# 每页:写 .slide → 校验 → 写入
slidep-validate "D:/项目/xx/slides/01.slide" --project "D:/项目/xx"
slidep upsert-dsl "xx.pptx" --dsl-file "slides/01.slide"
7.2 三个已知坑(2026-08-30 实测)
- 路径风格:Git Bash 下传给 slidep 的路径必须用
D:/...风格;/d/...会被错误解析成D:\d\...,报File not found。 - 文件名全/半角括号:磁盘文件名可能与用户提供的路径存在全角
()vs 半角()差异,导致 python-pptx / 脚本找不到文件。写路径前先ls核实磁盘真实文件名,不要照抄用户提供的路径。 - 【致命】slidep 不落盘备注:
<Slide notes={...}>是 tencent-pptx 文档支持的规范,validate 也通过,但upsert-dsl写入 PPTX 后ppt/notesSlides/目录为空——备注全部丢失。对"教师备注版"PPT 必须用 zip 注入补救。python-pptx 1.0.2 的slide.notes_slide.notes_text_frame.text = ...在空 notesSlide 上会报 NoneType 错误,不可用。
7.3 备注注入补救(必须执行)
# 全部页写入并校验通过后,统一注入备注:
"C:/Users/ququh/.workbuddy/binaries/python/envs/default/Scripts/python.exe" \
"C:/Users/ququh/.workbuddy/skills/ppt-ququ-vision/scripts/inject_notes.py" \
"D:/项目/xx/xx.pptx" "D:/项目/xx/slides"
脚本原理:从 slides/NN.slide 解析 notes → zip 层面构造 notesSlideN.xml(含 <p:ph type="body"> 占位符)+ 更新 slide rels + [Content_Types].xml。前提:目标 PPTX 自带 notesMasters/notesMaster1.xml(slidep 生成时自带)。
注入后必须验证:
from pptx import Presentation
p = Presentation("xx.pptx")
ok = sum(1 for s in p.slides if s.has_notes_slide and len(s.notes_slide.notes_text_frame.text) >= 20)
print(f"备注完整页数: {ok}/{len(list(p.slides))}") # 必须等于总页数
7.4 自检方案(本机无 LibreOffice / poppler)
本机没有 soffice / pdftoppm,tencent-pptx 自带的 pptx2image.py 转图预览不可用。改用 python-pptx 文本层自检:
- 页码完整性:每页文本含
NN / 33页脚 - 备注完整性:见 7.3 验证代码
- hero 相邻:STORY.md 中的 hero 页两两间隔 ≥2(中间至少隔 1 页)
- 页密度:每页 120-280 字,防溢出/防空洞
- 数据落点:关键数字(如 5000万/10%/8%)在备注中带「含义/影响」判断句