Fmode 整页设计图技能

概述

★ 先读这一节：技能给的是判断力，不是模板

核心原则：不要被禁令和模板约束住。每次拿到新材料，先问三件事：

1. 这份材料最有力的东西是什么？ （数字 / 案例 / 对比 / 流程 / 故事）
2. 怎么让零基础的人三秒看懂？ （视觉焦点在哪）
3. 什么视觉能承载这个观点？ （让内容决定风格，不是套模板）

完整方法论见 references/能力放大方法论.md（npm 安装后位于 skills/fmode-slide-design/能力放大方法论.md），包含：

• 非文字化表达（三层转化法：具象化 → 情绪化 → 对比化）
• 海量文字结构化（四步压缩法 + 布局语义对应表）
• 按主题自适应（判断矩阵 + 风格驱动力）
• 参考图渲染技巧（什么时候用、怎么算比例）
• Prompt 写法（从命令到导演）
• 质量五问自检

风格不设限：3D、玻璃、卡通、纯色块、写实摄影——都可以用，取决于这一页要讲什么、给谁讲。下面的禁忌清单是特定项目的教训记录，不是通用规则，用前判断适用性。

〇、使用时机铁律（2026-10-14 用户定调）

本技能 = 整套展示型 PPT 的整页图生成（每页一图、风格统一、适合演讲/汇报）。

⚠️ 不要把整页图插进长文正文（Word/HTML 图文报告）——风格与文字排版出戏。

判断口诀：这页是「给人看的氛围展示」还是「给文读的信息说明」？前者整页图，后者单图。

整页 AI 设计图生成规范（演示稿专用）

一、核心原则（决定成败）

每个页面 = 一张 AI 生成的完整设计图（不是"底图 + 程序贴字"）。

• 文字由 AI 一起生成：实测 gpt-image-2.5-sunburst 渲染中文质量高（无错字/缺笔）
• 页面所有视觉元素（背景氛围、卡片、图标、装饰、文字）在同一次生成中完成，风格天然统一
• 输出 16:9，用于直接拼成 PPTX（每页一张满屏图）

反面教材：深色背景 + 程序绘制的纯色块和文字 → 设计感差、空洞。

二、Prompt 结构公式

[整体风格定位] + [背景氛围] + [版式分区] + [核心内容元素] + [逐条文字] + [配色] + [质感要求]

必写要素（缺一不可）

1. 风格定位：浅色高级感商务演示页 / 精致科技风汇报页
2. 背景氛围：写清具体景物 —— 城市天际线剪影 / 远山云雾 / 水面倒影 / 光晕 / 粒子
3. 版式分区：顶部标题区 + 中部N栏卡片 + 底部胶囊横幅 + 四角辅助信息
4. 内容元素：卡片数量、每张卡含什么（图标+标题+说明）
5. 逐条文字：把所有要显示的中文逐字写进 prompt（关键！）
6. 配色：写具体色值（见下）
7. 质感：柔和投影 + 圆角 + 玻璃质感 + 光效

Prompt 模板

浅色高级感商务演示页，16:9。
背景：白灰渐变(白→#F5F7FA)，远景有城市天际线剪影与远山、淡蓝色光晕、细微粒子。
版式：顶部标题区、中部三栏卡片、底部横向总结条、四角辅助信息。
中部三张等宽白色卡片(圆角16px、1px浅灰边框、柔和投影)，每张含圆形渐变图标、
标题、两行说明文字，右上角有淡色大号编号水印。
文字内容：
主标题「产教融合 智创未来」红金渐变粗宋体大字号居中
副标题「把技术带进课堂 把人才送进产业」深蓝色黑体
卡片1「未来飞马」软件定制研发、软硬集成综合解决方案
卡片2「未来全栈」AGI全栈工程师认证体系与人才输送
卡片3「Z0创投」技术天使投资、创业孵化
底部条「以真实项目驱动教育创新」
配色：主色科技蓝#1E88E5，强调色#C8102E，点缀金#D4AF37，文字#1F2A44。
质感：柔和投影、玻璃拟态、光晕、精致克制，信息层次分明。

三、视觉规范

定稿范式：餐饮课 v5（2026-10-13 用户确认「可以定稿了」）

客户对餐饮课的最终定调：「只把背景简单化，那些小图标呀、装饰型的元素要保留」。这是一个可复用的成熟范式 —— 背景去实景、装饰全保留：

规律：实景照片背景一眼廉价、且压不住文字；纯渐变背景 + 精致装饰件才是「高级」。

字体现制（客户指定，必须写进 prompt）

字体要求(严格执行)：大标题用「方正超粗黑简体」——笔画极粗、方正有力、无衬线中文黑体标题字；
正文、说明、小字用「微软雅黑」细体——笔画纤细均匀的现代无衬线黑体。不要用宋体衬线字。

CSS 落地：--f-head:"方正超粗黑简体","FZChaoCuHei","Microsoft YaHei",sans-serif; --f-body:"Microsoft YaHei","Microsoft YaHei Light",sans-serif;

⚠️ 最高铁则：配色与风格按「行业 + 主题」综合选定（2026-10-13 用户钦点）

审美标准固定不变（浅色高级感、每页一张 AI 整页图、元素丰富不空洞、留白充足、文字层级分明）；配色与风格必须随行业和主题变化，不要把某一次定稿的颜色当成通用模板到处套。

选型方法：先问「这个行业的人每天看什么颜色」，提炼 2–3 个行业色构成主色系统；强调色只做点缀不做主色；同色系深浅做层次；全页主色不超过 3 个。做新行业前先说明选色理由，再出图。

以下为「科技 / 政企」实例（产教融合演示稿定稿 · 2026-10-09 用户确认）

定稿风格三要素（不可改）

1. 高饱和红 #C00000 作强调色（不要降饱和，用户明确要求）
2. 主标题红金渐变：#C00000 → #F5A623，粗宋体
3. 浅色渐变底 + 元素丰富（不空洞）：白→浅灰蓝渐变，中下部城市天际线剪影、远山层叠、水面倒影、淡蓝光晕、粒子光点、蓝色发光弧线

红色使用铁则（2026-10-09 用户最终定调）

正文页红色占比 ≤1.5%，只允许两处：

1. 左上角章节缎带标签（暗红 #A61B1B 渐变→#7F1D1D，白字，约300×80px），右端带折角
2. 重要数字点缀（关键指标数字用红，其余数字用深蓝）

正文页其余全部蓝白科技风：

• 背景：白→浅蓝渐变（#FFFFFF→#EAF4FF），浅蓝光晕，底部城市天际线剪影+青蓝发光地平线+粒子
• 主标题：深蓝 #0B3A82 粗体（不用红金渐变，那只用于封面）
• 图标/按钮：亮蓝 #0B6BFF
• 卡片：白底 24px圆角 + 1px 浅蓝边 #E6F0FA + 柔和投影 rgba(10,80,180,.08)
• 编号水印：浅蓝 #D8E7F6
• 底部：蓝色胶囊条（不是红色）

封面页例外：保持红金渐变主标题（用户已确认）

配色

必备元素（保证不空洞）

• 左上章节缎带（正文页唯一红色块）
• 顶部主标题（深蓝粗体）+ 副标题
• 中部白色圆角卡片矩阵（24px圆角、浅蓝边框、柔和投影、蓝色圆形图标、右上角浅蓝大号编号水印）
• 底部蓝色胶囊总结条
• 四角辅助小字（中英混排、手写体slogan）
• 背景：城市天际线 + 青蓝发光地平线 + 光晕 + 粒子

旧版配色（已废弃）

低饱和暗红 #A8322F ← 已否决「红色不要降低饱和度」正文页满篇红（红胶囊条/红绶带多处） ← 已否决「不需要太多红色元素，只需左上角点缀+重要数字点缀」

版式分区（1920×1080 基准）

顶部页眉    y=0–90     左标语 / 中绶带 / 右口号
主标题区    y=90–240   主标题(120–140px) + 副标题(56–64px)
卡片区      y=280–700  3列或4列等宽，卡片间距 20–40px
总结横幅    y=610–700  红色/蓝色胶囊条
底部        y=700–1080 城市带 + 左党徽/品牌 + 右页码
四角        安全边距 60–80px

卡片设计

• 尺寸：3列约 466×420 / 4列约 355×150
• 圆角 16px，填充 #FFFFFF→#F7F9FC 渐变，边框 1px #E8ECF2
• 阴影 0 6px 16px rgba(0,0,0,.06)
• 内嵌：圆形图标 56px（渐变底+白图标）、标题 22px 加粗、说明 14px
• 右上角：超大编号水印（48px，红色 12% 透明）

文字层级

装饰元素（提升设计感的关键）

• 绶带/横幅（章节标识，如「壹·企业实力」）
• 顶部左右标语 + 细红线
• 底部胶囊总结条
• 背景城市天际线 / 远山 / 光晕 / 粒子
• 侧边竖排标语
• 中英混排（英文提升专业感）

四、生成流程

cd <你的工作目录>   # 放置 fmode-image 脚本的目录
SKILL_IMAGE_OUTPUT=<输出目录> node fmode-image.mjs --slide "<完整prompt>" <名称>

• 模型：gpt-image-2.5-sunburst（fmode-image.mjs 内置）
• 尺寸：1792×1024（16:9 合规）
• 成本：¥0.5/张
• 并发策略：4 线程并发，22 页约 5 分钟

⚠️ 批量出图铁则（80 页实战教训）

1. 并发不得超过 3：并发 6 会打满服务端队列 → 接口连续 10+ 分钟零响应（单张 curl 也超时）。

并发 3 稳定，单张约 80–130 秒。

1. 必须断点续传：每张出图前先 existsSync(输出路径) 跳过，否则中断后重跑浪费全部成本。
2. 必须自动重试：单张失败重试 3–5 次，退避 8s × 重试次数；偶发 timeout 重试即成功。
3. 进度要落盘可见：每张完成打印 OK pNN (耗时s) [done/total]，便于用 ls *.png | wc -l 核对进度。
4. 不同页码段拆成独立进程跑，避免单进程跑太久被环境清理。

五、真实照片的融合（必做）

用户明确要求：有真实照片必须放真实照片。

做法：

1. Prompt 里显式预留照片位：画面右下角预留一块干净留白区域(约30%宽度)用于放置实拍照片
2. AI 生成后，用 Pillow 把真实照片圆角贴入预留位
3. 加 1px 品牌色边框 + 图注（程序绘制，字体清晰）

禁止：用 AI 重画真实场景（会把签约照/实训现场变成假的）。

六、质量检查清单

出图后逐项核对（用 vision_analyze）：

• [ ] 中文无错字、无缺笔、无乱码
• [ ] 主标题醒目、字号够大（投影可见）
• [ ] 版式分区清晰，无空白未填充区域
• [ ] 卡片/模块对齐整齐，间距均匀
• [ ] 有背景氛围（不是纯色块）
• [ ] 配色统一，不超过3个主色
• [ ] 无空洞感（视觉元素丰富但不杂乱）
• [ ] 真实照片清晰、图注与内容匹配

七、常见问题

选型铁律（本轮实证）

• 能用 AI 整页生成的，就不要用程序画：程序画的块状排版"元素极度贫乏，属于骨架状态"（视觉评审原话），且文件体积能直接反映信息量（程序画 ≈70KB vs AI 整页 ≈2MB）。
• 但 AI 也不是万能的：需要"精确内容"的页面（证书、表格、编号清单）用 AI 生成反而失真 —— 这类页面用程序精确排版 + 真实素材，其余页面用 AI 整页生成。
• 判断标准：这一页的核心价值是"氛围感"还是"信息准确"？前者用 AI，后者用程序。

八、成品交付

1. 22张整页图 → 预览拼图发用户确认风格
2. 用户确认后 → 用 python-pptx 拼成 16:9 PPTX（每页一张满屏图）
3. 同时保留单页 PNG 供替换

九、出图通道故障切换（2026-10 实战，必读）

通道性能实测对比

sunburst 拥堵的处理流程

1. 探活：用极小 prompt（"a red dot"）发一次，curl -m 240，返回 HTTP 000 即不可用
2. 先排除欠费：GET /v1/dashboard/billing/subscription 返回 has_payment_method:true 说明正常；报 model_not_found / No available channel 是没配渠道，不是余额问题，也不是欠费
3. 确认拥堵后切 seedream，按下方改写提示词

Seedream 提示词改写铁律（不遵守页面必被污染）

Seedream 会把提示词里的技术参数当正文画上去。必须删除：

• ❌ 所有色值代码（#0F4C5C、#B8860B）→ 改成白话「主色深青色，点缀暗金色」
• ❌「16:9」「PSD」「图层」「字号层级」等技术词
• ❌ 重复描述（同一句说两遍会画出重影文字）
• ✅ 保留：标题用《》、内容一句话列清、哪侧留白
• ✅ 出图后必须逐页 vision 验收：查色值泄漏、文字重影、错字

skill-image.mjs 两个坑

• 内部硬编码 AbortSignal.timeout(300000)（第 112 行），拥堵时改成 900000
• 文件名是第三个参数且工具自动补 .png；传 name 不要传 name.png（否则得到 name.png.png，而存在性检查看 name.png 会永远判失败）

批量生成不要指望一次跑完

• PAGES[i] 索引越界会 IndexError 直接中断整批（25 项传 24 是合法的，但 26 项传 25 就崩）
• 后台进程会被环境清理；分批 6-7 页 + 后台跑 + 显式查缺 + 手动补跑才可靠
• 并发 3 稳定；并发过高反而全部超时

十、同一客户多套 PPT 的风格差异化

同一客户连续两套 PPT 用同色系会被批「没区分」，先问清或主动区分。

十一、真实截图融入（关键页必做）

不要凭记忆画界面。流程：浏览器实跑业务 → 截真实界面 → 2 倍 LANCZOS 放大 + 锐化 1.3 → 按页面留白区写死坐标贴入（圆角 12px + 白边 2px + 深青阴影 GaussianBlur 8）。

坑：不要靠算法自动检测虚线框边界（会溢出压字）。直接写死坐标，贴完用 vision 复验有没有遮挡文字。优先在生成时让 AI 画出虚线占位框（sunburst 能做到，seedream 做不到），再把截图精确覆盖上去。

十三、平面设计风格（Flat）— 用户嫌 3D 太花时的转法

现象：3D 立体、玻璃质感、发光特效堆砌，初看炫，翻几页就"晕了"，还掩盖了内容。用户原话："有些太花哨了，要减少 3D 感，更多是平面设计呈现会更好，不然看起来晕了"

转法：把"禁"写进 style 前缀（只说"平面设计"不够，AI 会自己加 3D）

一张完整的16:9顶级战略咨询演示设计稿。严格的平面设计风格（Flat Design）：
纯色块拼接、几何矩形分割、细直线、大量留白、极简扁平图标。
深海军蓝#0A2540背景，米白#F5F1E8文字，金色#C9A227仅用于强调线和数字。
严禁3D立体、严禁玻璃质感、严禁光影渐变球体、严禁发光特效、严禁照片实景。
文字全部清晰锐利、字号层级分明、无错别字。设计感来自排版和留白，不是来自特效。

效果：体积从 2.8MB/页 降到 220KB/页，整套 16 页仅 3.5MB。

金句密度：每页底部一条"金句条"

用户验收明确要"金句"。可复用写法——在每页 prompt 末加：

底部一整条深色缎带，白字金句一行「……」

验收通过的示例：

• 当生成免费，稀缺的就只剩判断和组织
• 客户买的不是人天，而是结果
• 报告是交付物，签字是责任
• 先有本体，后有 AI
• 工具变了，组织不变，等于没变。
• 从八个能用的工具，到一张可复用的资产网

必须有一张"整页金句页"：深蓝底 + 中央超大金字 + 出处小字。

分层矩阵：L1/L2/L3 优于"地图"

用户原话："没有点亮的生态位，应该也是 L1 L2 L3 这样层次感，而不是真的地图"

用 3D 地形图表达战略分层会被读成地理图，层次也不清。正确做法是平面水平分带矩阵：

• 左侧大号金色 L 标签（L1 / L2 / L3）
• 每层一条水平分割线，右侧纯色矩形方块写项目名
• 右端竖排小标注写该层定位（击穿场景 / 组织提效 / 单点深钻）
• "未来态"用同一套结构：已点亮=金色实心块，待点亮=灰色虚线框 + 具体项目名（不能只写"待补充"）

反面教训：不要丢掉用户说"到位"的表达

用户在 v2 沉掉了 v1 的"三件正在发生的事"，专门要求找回来。铁律：用户明确肯定过的表达句式/认知框架，换风格时必须原封保留，只换视觉不换语义。

强化写法（配英文标注 + 口语化注解）：

1. 生成的成本趋近于零（COST → 0）— 报告·方案·图表，AI 都能做
2. 判断的价值被重新定价（JUDGEMENT × VALUE）— 能不能通过·能不能落地·钱从哪来
3. 组织的差距大于个人的差距（ORGANIZATION > INDIVIDUAL）— 十个聪明人，不如一套跑得动的系统

十四、建筑/设计院汇报的高级感基准（同济项目五轮迭代实证）

设计风格演进路径（用户逐轮否决，照这个顺序走）

关键区分（这轮最大收获）：

• 用户说「去掉 3D」不等于「去掉设计感」
• 「平面设计」在建筑语境下 = 建筑语言做配图（剖面线稿、轴测图、网格系统、结构节点大样、等比线），不是扁平图标
• 线条要 1px 级细而准，不要粗描边

可复用的 style 前缀（已验证出品）

一张完整的16:9高端建筑设计咨询汇报设计稿。
【审美定位】建筑事务所提案级别的高级感——克制的黑白灰加单一主色，大量留白，
网格化严谨排版，字体层级克制精准。参考瑞士平面设计（Swiss Style）与建筑方案册的气质。
【配色】底色纯白#FFFFFF 与 极浅暖灰#F5F4F2 交替；文字深炭黑#1C1C1E；
主色仅用一种：建筑蓝灰#3C5A78 或 砖红#A6522C（二选一，全页统一）；辅助细线浅灰#D8D5D0。
【视觉元素】用建筑语言做配图：剖面线稿、轴测图、网格系统、细线条构成的抽象建筑立面、
结构节点示意、等比线。线条细而准（1px 级），不要粗描边。
【严禁】严禁卡通插画、严禁扁平可爱图标、严禁圆润卡通小人、严禁彩色渐变块、
严禁3D渲染、严禁发光特效、严禁emoji感图形。
【排版】左对齐为主，文字块之间有严格对齐关系，页码和栏目标签用极小的等宽字体。
【严禁自造信息】除页面内容中明确写出的文字外，不得自行添加任何年份、日期、编号、
标语、部门名、英文口号或署名。年份一律为 2026。

「严禁自造信息」是必需的

实测 AI 会往页脚加「2024」、封面加一堆英文口号（"A BETTER TOMORROW" 之类）、栏目标签加无关数字。不加这条约束，每页都要返工。

咨询方视角的站位（给甲方做咨询时的标题分寸）

用户原话：「我们是咨询公司给 TJAD 的咨询项目，我们不能说他们的未来，有些越俎代庖」

• ❌ TJAD 未来 —— AI 原生的咨询设计集团（替甲方定未来）
• ✅ 迈向 AI 原生的咨询设计集团 —— 基于八项目实践的观察与建议，加小字 咨询方视角 · 供院方参考
• 结语用「路怎么走，请院方判断」
• 尾页用「或许不是用了 AI 的…而是…那一种」——用「或许」「那一种」把结论权还给甲方

金句必须专家级，不能口语

用户明确否决的口语化写法 → 专业化改写：

法则：去掉「不稀奇」「不是要来的」「是极限」这类口头语；改用「存在天然上限」「依据应当是」「不等于」这类判断句式。

面向甲方的汇报定调：正面夸，不要负面框架

用户否决了引用麦肯锡「工具变了，组织不变，等于没变」的整页金句，理由：「这次要夸夸八个项目已经是组织变化创新的试点成果，TJAD 跑的比别人快一步，只是需要巩固」

改法：新增一页正面定调

标题：这八个项目，本身已经是一次组织创新的试点

正文：不是先有 AI 再找场景，而是各部门从自己最痛的环节出发，各自找路、各自跑通——这本身就是一次自下而上的组织试点。

佐证：N 个小队分属哪些部门 / 多长时间从选题到可运行原型 / 几个被列为重点 / 每个都跑在真实数据上不是 demo

「待点亮」的生态位必须有出处，不能随意起名

用户原话：「空白部分也没有沿着这些项目中提到的未来计划展开，有点儿随意起名」

正确做法：每条续接都从已经跑通的那个项目长出来，并标注档案出处：

• 资金谋划 → 财务评价与实施方案深化（档案原文「扩展为打透到实施方案/财务评价报告」）
• 教育部评估 → 项目管理数字分身（档案流水线：资料清单→上传→AI初审→流转→报告→人复核）
• 产业招商 → 园区存量画像 / 企业深度画像（档案「招商的对象不只是增量，还有存量」）
• 稳评助手 → 从长宁扩展到全上海（档案原文）
• 底部一句话：「每一条续接，都是从已经跑通的这一个长出来的，不是另起一摊」

汇报要有诉求页收尾，不能只讲成果

用户指出「结尾收的太平了」。收尾必须加一页具体诉求（要机制/要归口/要验证机会），并配金句「组织投入的依据，应当是已经验证的成果，而不是尚未兑现的承诺」。

十五、配图必须服务于论点（同济 v6 六轮迭代最终定论）

用户否决的两轮，指向同一个问题

• v5：用建筑剖面图/轴测图做配图 → 「画面用到了建筑设计，但是和内容完全无关了」
• v4：用浅色卡通矢量插画 → 「有些卡通化了，不够大气」

结论：配图的「风格对」不等于「配图对」。用户要看的是这张图在解释这一页的什么。

做法：每页先想清「论点 → 视觉化」，再写 prompt

写 prompt 的方式：不要写「配一幅建筑风格的插图」，要写「配图：左侧文档线稿正在碎裂成虚线碎片，没有去向（表达：不可验证）」

表现力：从"克制学术"到"有张力"的调法

用户原话：「设计太沉闷，太克制了，不够有表现力」

调法（写进 style 前缀）：

1. 主标题要非常大（占页面 1/4 ~ 1/3），不要平均用力
2. 关键数字用超大字号（占该行一半宽）
3. 大胆用深色块与白色区域对撞，制造翻页节奏
4. 每页必须有一个明确的视觉焦点，让观众三秒内知道这页在说什么
5. 配色不要只用单一蓝灰：白 + 深墨蓝 #14213D + 中蓝 #2E5EAA + 亮青 #00A6B8 + 赭金 #C9911F
6. 左右分栏可做成语义对撞（左深色=否定/AI生成，右白底蓝框=肯定/TJAD交付）

结尾要有开创性，不能用「把问题留给甲方」的方式收

用户原话：「最后收敛的，不够有开创性，把问题全部留给了院方，给到了压力，而不是用远景去带动动力」

错误收法：

• 「路怎么走，请院方判断」（被动、把球踢回去）
• 「需要院里的三件事」（像伸手要资源）

正确收法（三段式）：

1. 远景页：三年后是什么样子——用「现在的样子 → 三年后的样子」三组对比，具体、可想象
   • 金句：「这不是 N 个工具的终点，是一家咨询设计集团换一种方式运转的起点。」
2. 底气页：为什么是我们，而不是别人——把护城河讲出来（口径/案例/专业边界）
3. 诉求页：改语气为「要让这条路走通，需要三块垫脚石」，附着在愿景之后，不是伸手
   • 底部小字：「这三件事不是前置条件，是让已经跑起来的东西不退回去的最小投入。」
4. 结语：「方向已经不模糊了。剩下的是把它走完。」

心法：面向甲方的汇报，收尾要用远方吸引，不是用问题施压。压力让人防守，远景让人前进。

十六、向客户/校方提报方案的铁则（服装定制 × 教育行业实战，用户明确要求）

铁则1：先立 SOP，再动手做图

用户原话：「首先要立标准，首先要梳理它的 SOP……如果文本稿件都没有过关，达不到那种讲完了就能成单的程度……到达这个程度的文案之后，才是生成 PPT 纯图的 PPT」

五阶段不可跳步：理解对方 → 梳理自己 → 文案过审（卡点） → 确定视觉 → 批量出图。跳过阶段一二三直接出图 = 必然返工。

铁则2：口径以内部分材料为准，官网只用来理解文化

用户原话：「按照内部材料的商机统一名称。官网，你只需要看一下他本身的文化就可以，不用直接用它的名字，以内部的口径为准」

• 客户名称 → 内部商机口径
• 学龄段/产品范围 → 内部打样单口径
• 官网/校方口径 → 只用来核对内部口径是否在范围内
• 无中文的校训/理念 → 直接用英文原句，更高级，不刻意翻译

铁则3：真实性要求只针对产品，不针对模特

用户原话：「模特允许是 AI 生成的，但必须是中国适龄阶段跟学校年龄阶段一样的学生……我们要求必须真实的，那是服装跟产品，并不是模特」

• 服装/产品/logo → 必须真实素材，AI 只出背景+预留空位再贴入
• 模特 → 可 AI 生成，但学龄段必须匹配（幼儿园配幼儿园、高中配高中），且符合人群特征
• 用户补充：「模特好看一点没关系的」

铁则4：素材要找对地方——先看 HTML 里引用了什么

用户纠正过我一次：「我说有原图就是有原图的，你找错位置了，不在 MD 文档里，是在对应的 HTML 文件里」

• 不要只查磁盘上有没有这个文件就断言"不存在"
• 先看 HTML 的 <img src> 实际指向哪、index.md 里有没有完整的生成参数
• 图丢了但参数在 → 照参数重新生成（记录 prompt/尺寸/用途的 index.md 比图片本身更值钱）

铁则5：对外长网页必须去 AI 化

用户原话：「里边有哪些什么资源来自于什么、引用了什么的，这种太 AI 化的表达要全都删掉。就正常的长网页报告」

• ❌「来源：storage/…」「图注：素材引用自…」「示意图 · AI 生成」「◈ 真实截图」「方法论示意」
• ✅ 图注只说明这张图讲了什么，不解释这张图哪来的

铁则6：静态页上传踩坑

• STS 通道会静默失败（文件传上去但 S3 对外路径读不到）
• 文件名必须 ASCII（中文名静默失败）
• 正确做法：云函数通道 putViaCloudFunction + ASCII 临时副本名

十七、近期实战复盘（2026-10 跨项目沉淀）

17.1 五套风格配方的适用判断

结论：不是选一个套上去，是让内容决定。数据密集页用理性，故事页用影像，混用反而有节奏。

17.2 抽象概念的场景化翻译（最重要的一条）

用户原话：「你都已经可以用画图了，那何必去画一些简单的流程图呢？往真实的应用的图片、真实的场景的图片，特别是老板焦虑，你放老板焦虑的图片，画的流程图根本不够直观」

翻译对照：

关键：流程图该有还得有（逻辑不能砍），但升级为「场景 + 流程双层」——底层真实场景，上层叠清晰标注。

17.3 海量文字结构化

四步压缩法：提炼主线（一句话）→ 分层归组（3-5组）→ 建立关系（并列/递进/因果/包含/对比/循环/时间）→ 视觉承载

布局语义对应：

• 递进 → 阶梯上升、箭头链
• 并列 → 等宽分栏、网格
• 因果 → 左右流转、汇聚
• 包含 → 嵌套、同心圆
• 对比 → 左右分屏、异色
• 循环 → 环形、回路
• 时间 → 横向时间轴、甘特

密度调节：该丰富时用网格+图标+编号撑起密度；该凝练时一页只留一句大字加大量留白。

17.4 参考图渲染铁律

优先级：真实产品图 > 实物照片 > 高清示意图 > AI 描述

踩过的坑：

• AI 画校服 → 领型、条纹、徽章全错（必须用真实产品图做参考）
• 客服给的"形象图"本身也是 AI 生成的（要验，别当真图）
• 统一拉成 16:9 → 竖版截图被压扁（逐个算 scale = min(宽比,高比)）
• 素材比例跨度大（0.6 到 2.5）→ 分组处理，竖版按高度约束、横版按宽度约束

17.5 去 AI 化

删掉这些：「来源：storage/…」「示意图 · AI 生成」「◈ 真实截图」「实拍」等所有说明图片来源的标注。

改成：只写画面在讲什么（如「小学部课堂 · POLO 与 PE 短袖」）。

原则：配图只说明这张图讲了什么，不解释这张图哪来的。

17.6 文案专家级化

口语 vs 专家级：

• ❌「快一步不稀奇，稀奇的是八个部门自己迈出来的」
• ✅「真正值得记录的，不是进度上的领先，而是八个部门各自从业务痛点出发、独立完成验证的组织能力」

规律：避开「不稀奇」「不是要来的」「是极限」这类口头语，改用「存在天然上限」「依据应当是」「不等于」这类判断句式。

十八、申报表/文档类填写：截图要真生成，不要留空

教训：填写「青年开源种子计划申报表」时，用户要求把「项目演示画面截图」直接生成填进去，我先只写了 5 个演示场景的文字说明，被指出「你直接用 skill-image 生成，或者直接用 FMODE-APP 的项目截图，直接填进去啊」。

正确做法：

1. 表格里凡是提到「演示」「截图」「界面」的字段，必须真的放图，不能只写文字描述
2. 用 skill-image 生成界面截图时，style 前缀要写「高保真软件界面截图，深色专业开发者工具风格，等宽字体显示技术内容，像真实的工程控制台截图，不要插画不要卡通」
3. 截图中要包含真实感的细节才能可信：任务ID、时间戳、日志流、状态标签、进度条、版本号
4. 插入 docx 用 paragraph.add_run().add_picture(path, width=Cm(15.5))，每张图下配一行图注（8pt）

验证：填完后用 len([r for r in doc.part.rels.values() if "image" in r.reltype]) 统计内嵌图片数，确认与预期一致。

十九、开源协议默认 MPL-2.0

用户项目默认协议是 MPL-2.0（Mozilla Public License 2.0），不是 Apache 2.0 或 MIT。MPL-2.0 的特点：文件级 copyleft（修改的文件必须开源，但可与闭源代码链接），适合「核心开源 + 商业服务」双轨模式。填写任何申报/资质表格时，协议栏默认填 MPL-2.0，除非用户明确指定其他协议。