企业官网建设流程全解析

• AI 技能

导读：本文围绕 guizang-ppt-skill 的截图处理规范（references/screenshot-framing.md）展开，讲解如何把用户提供的产品截图、网页截图、代码截图、设计稿截图，处理成符合模板槽位比例、又保持内容保真的图片资产。读完你会掌握「优先级判定 → 7 个语义参数 → 双风格映射 → 内置背景资产复用 → 截图类型决策 → 背景生成提示词」的完整实操链路，并理解它与模板、版式、校验器之间的协作关系。

为什么需要一套截图美化语义规则

guizang-ppt-skill 生成的是单文件 HTML 横向翻页 PPT，模板预设了大量图片槽位（21:9 顶图、16:10 主图、4:3 侧图、1:1 方图、多图网格等）。当用户提供的原始截图比例不可控时，直接硬塞进槽位会出现三种典型问题：

1. 比例错位：2592×1798 之类的原图比例在固定槽位里撑出奇怪的空白或溢出（这正是 references/layouts.md 反复强调「永远用标准比例」的原因）；
2. 内容被裁：关键 UI 文字、数据、标题栏被cover裁掉，失去证据价值；
3. 风格漂移：截图自带品牌色、花哨背景，和当前 deck 的电子杂志风或瑞士国际主义风完全不搭。

为此，仓库定义了 references/screenshot-framing.md 这套「截图美化语义规则」。它的目标类似 CleanShot X 的「截图居中 + 背景填充 + 统一比例」，但不默认让图像模型重画截图——保真优先，程序化处理优先。

处理优先级：程序化适配 > GPT-M 2.0 重构

文档把截图处理方式按优先级划分为三层，这是整条链路的决策总纲：

1. 程序化适配优先：截图内容、文字、UI 细节需要保真时，不要重画。做法是创建目标比例画布，把原截图等比缩放后放入画布；
2. GPT-M 2.0 只做重构：只有原图过长、过窄、信息太乱，或者需要UI 情景化 / 概念化表达时，才使用「截图再设计 / UI 情景图」；
3. 模板槽位先行：先确定 slide 版式和图片槽位比例，再决定截图适配参数——即「先让内容适配模板，再处理图片比例」。

这条优先级与 SKILL.md 中的截图需求约定完全一致：截图需要保真时，先读screenshot-framing.md，优先使用assets/screenshot-backgrounds/的内置背景资产做程序化 CleanShot X 式背景画布适配；只有原截图太乱、太长、太窄或需要概念化表达时，才用 GPT-M 2.0 做截图再设计。

开始前询问：5 个必须澄清的问题

在主流程 Step 1（需求澄清）中，只要用户可能提供截图，就必须先问清楚这 5 件事：

• 截图位置：截图在哪个文件夹？是否包含网页、App、代码、dashboard、设计稿或旧 PPT？
• 处理目的：这批截图要保真展示、统一美化、重新设计成 UI 情景图，还是混合处理？
• 落位槽位：最终要放进哪些槽位——21:9 顶图、16:10 主图、4:3 侧图、1:1 方图，还是多图网格？
• 内容约束：是否必须保留所有文字和数据？是否需要隐藏账号、头像、项目名等敏感信息？
• 构图偏好：希望居中、左上、右下，还是根据页面内容自动判断？

运行环境差异也要注意：在 Claude Code 中用 Ask Question /ask_question做这些澄清；在 Codex 中用普通对话询问，不要调用 Ask Question 机制。

处理链路：版式 → 处理方式 → 背景 → 合成

文档给出了四步处理链路，每一步都是顺序依赖关系：

1. 先匹配版式：根据内容选择模板 layout，确定截图槽位尺寸和比例；
2. 再选处理方式：
   • 要保真 → 程序化适配，不重画截图；
   • 要统一视觉但不改内容 → 程序化适配 + 主题背景；
   • 原图不可用或需要解释概念 → 走 GPT-M 2.0 截图再设计；
3. 再选择背景：优先使用内置背景资产，不应该每张截图临时生成一种风格；
4. 最后合成截图：创建目标比例画布，背景cover铺满，截图等比缩放后按padding和alignment放入。

一条硬规则贯穿始终：默认不要裁掉截图内容。只有截图已经按目标槽位重新生成，或者用户明确允许裁切时，才使用cover裁切。

7 个语义参数：每次处理前必须确定

每次处理截图前，先确定这 7 个参数。这是本规则的核心操作面：

参数在模板侧的实际落位

这些参数不是抽象概念，它们在 HTML 模板里有对应的容器与类名。例如 references/layouts.md 中：

• 左文右图主图用.frame-img.r-16x10/.frame-img.r-4x3（对应ratio）；
• 图片网格用.frame-img.h-22/.frame-img.h-26固定高度（对应统一高度与compact密度）；
• 信息图 / 截图再设计用.frame-img.r-16x9.fit-contain（对应fit-contain保真策略，避免文字被裁切）；
• 瑞士风单张大图用 S22 的.frame-img.r-21x9铺满（references/layouts-swiss.md）。

也就是说，ratio最终会翻译成具体的比例类或data-image-slot声明（如s22-hero-21x9/s15-grid-21x9/s16-brief-21x9），这是 scripts/validate-swiss-deck.mjs 静态校验会拦截的硬约束。

风格映射：Style A 电子杂志风 vs Style B 瑞士国际主义

Style A · 电子杂志风

• 背景：paper/blurred/ 低饱和gradient
• 质感：纸张、墨水、胶片颗粒、暖白、低对比
• 截图：可用小圆角和轻微阴影，但不要像 SaaS 营销卡片
• 背景资产：优先使用assets/screenshot-backgrounds/style-a/下对应主题的 16:9 crop-safe WebP，截图合成时按槽位裁切
• 推荐语义：

ratio:16:10, background:paper, padding:standard, inset:balanced, shadow:editorial, corners:small, alignment:center

Style B · 瑞士国际主义

• 背景：plain/grid/dot-matrix
• 色彩：只允许当前锚点色作为极低占比强调；不要大面积亮色块
• 截图：直角、无阴影、无圆角、少量 hairline 或顶部 accent 线
• 背景资产：优先使用assets/screenshot-backgrounds/style-b/下对应主题色的 16:9 crop-safe WebP，只用当前 accent，不要混色
• 推荐语义：

ratio:21:9, background:grid, padding:standard, inset:subtle, shadow:none, corners:square, alignment:center

注意两套风格对截图处理的约束与模板本身的审美规则严格对齐：Style A 允许轻微圆角与柔和阴影（references/themes.md 的纸感审美），Style B 则必须直角、无阴影、无渐变、单一锚点色（references/themes-swiss.md 的「不要用渐变 / 阴影 / 圆角」「不允许混搭多个高亮色」硬规则）。

背景强度规则：背景是托底，不是主视觉

截图背景的定位是「托底」，永远不能抢截图本身的风头：

• 如果alignment不确定，背景中心和四角都必须安静，不要放显眼色块；
• 如果截图要放在右下角，右下角不能有强色块；其他位置同理；
• 瑞士风锚点色只做5%–8% 视觉占比的淡线、点阵或极浅几何场，不要生成高亮蓝条、大色块、霓虹渐变；
• 背景不能有文字、logo、图标、人物、设备、边框、明显主体或方向性构图；
• 背景必须crop-safe：裁成21:9、16:10、4:3、1:1都不能暴露「被裁掉」的痕迹。

这一规则与 references/checklist.md 的 P0-D 条目互相印证：截图外侧背景应该是安静托底，不能比截图本身更抢眼；Swiss 风截图不得出现圆角和投影。

内置主题背景资产：9 套 WebP 优先复用

本 Skill 已经内置一组 GPT-M 2.0 预生成背景。处理截图时优先使用这些资产，不要实时调用 GPT-M 2.0 重新生成背景。只有用户明确要求新风格、现有主题缺失、或背景与内容明显不匹配时，才生成新的背景。

背景图之后由程序复用到每张截图中。不要把背景当作单张 slide 来画——背景图内部不能有标题、页脚、边框、logo、人物或明显主体。

Style A · 5 套主题背景

Style B · 4 套主题背景

所有内置背景都是1920×1080 级别的 16:9 WebP。程序化合成时，先把背景cover到目标画布，再裁成21:9/16:10/4:3/1:1等截图槽位。背景必须四角安静，因为截图可能居中、左上、右下或被裁成不同尺寸。

截图类型决策：原始素材 → 推荐处理方式

与图文混排决策树的衔接

在 SKILL.md 的图文混排决策树中，截图角色判断与此表完全联动：证据截图 / UI / 代码 / dashboard保真优先，关键文字和数据不能被裁掉；需要统一比例时，优先程序化背景画布 +.fit-contain，不要为了铺满而裁掉 UI 内容。多图组则必须统一比例、高度、容器处理和 caption 密度——不要一张contain、另一张cover。

生成背景图提示词：仅在需要新增背景资产时使用

常规截图美化不要实时生成背景，直接使用上方内置资产。只有需要扩充背景库时才用本节提示词。

Style A 背景

16:9 crop-safe screenshot background for an editorial magazine / e-ink PPT system. Warm off-white paper texture, subtle ink wash, fine film grain, low contrast, quiet center and quiet corners, no text, no logo, no objects, no border, no focal subject. Suitable for cropping to 21:9, 16:10, 4:3, or 1:1.

Style B 背景

16:9 crop-safe screenshot background for a Swiss International Style PPT system. Pure off-white base, ultra-subtle 16-column grid and sparse dot matrix, one accent color only: [theme color], used at very low opacity as thin lines or tiny dots, no large bright color blocks. Quiet center and quiet corners, no text, no logo, no objects, no border, no focal subject. Suitable for cropping to 21:9, 16:10, 4:3, or 1:1.

注意两份提示词都反复出现的「quiet center and quiet corners / no text / no logo / no objects / no border / no focal subject」以及「Suitable for cropping to 21:9, 16:10, 4:3, or 1:1」——这正是「背景强度规则」与「crop-safe」约束在生成环节的显式编码。Style B 提示词还要求one accent color only，与 references/themes-swiss.md 的「单一锚点色」原则一致。

实战工作流：把截图处理接入 PPT 生成主流程

把上面的规则落进 guizang-ppt-skill 的完整工作流，一次截图处理的执行顺序是：

1. Step 1 澄清：按「开始前询问」清单确认截图位置、目的、槽位、内容约束、构图偏好（在 Codex 中用普通对话，在 Claude Code 中用 Ask Question）；
2. 确定风格与版式：根据风格 A/B 选模板（assets/template.html或 assets/template-swiss.html），再按 references/layouts.md（风格 A 10 种布局）或 references/layouts-swiss.md（风格 B S01–S22 锁定版式）确定图片槽位比例；
3. 确定 7 个语义参数：ratio跟随槽位，background跟随主题，其余按截图类型和风格映射选择；
4. 选择内置背景：从assets/screenshot-backgrounds/style-a/或style-b/中按主题选一张（示例见上表），程序化cover到目标画布；
5. 合成截图：截图等比缩放后按padding/alignment放入画布，默认不裁内容；
6. 落位 HTML：按 references/image-prompts.md 与 SKILL.md 的规范，将结果放入对应.frame-img（风格 A）或 S22 / S15 / S16 图片槽位（风格 B），需要时写data-image-slot；
7. 校验与自检：风格 B 运行node scripts/validate-swiss-deck.mjs path/to/index.html，再对照 references/checklist.md 的图片类检查项（直角无阴影、同组同比例、不裁关键文字、背景不抢镜）逐项确认。

关键结论

• 保真优先：截图内容、文字、UI 细节需要保真时一律程序化适配，GPT-M 2.0 重构只是「长、窄、乱、需概念化」场景的兜底手段；
• 槽位先行：ratio等 7 个语义参数全部跟随模板槽位，而不是原图比例；
• 资产复用：9 套内置 16:9 crop-safe WebP 背景（Style A 5 套 + Style B 4 套）应优先复用，背景是安静的托底，绝不当主视觉；
• 可验证：crop-safe 与背景强度由背景生成提示词显式约束，截图落位由 scripts/validate-swiss-deck.mjs 与 references/checklist.md 在生成后进行校验，形成「规则 → 生成 → 校验」的闭环。

• AI 技能