页面视觉
任务不是“制作漂亮的图片”。任务是在不视觉上欺骗所售商品的前提下，支持转化。
如果产品、包装、UI或材料需要精确性，请相应路由。
必需输入
workspace/pages/[page-name]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[page-name]/copy.md- 操作员提供的任何产品参考、包装参考、截图或图像资产
提供商策略
将页面工厂品牌成品作为事实来源。
workspace/brand/extract.md和workspace/brand/profile.md定义了规范的品牌理解- 提供商侧的品牌引导是图像生成的上下文支持，不能替代品牌提取或分析
- 首选提供商顺序：Bloom 首次通过，Nano Banana 备用，然后是对保真度至关重要的手动/操作员资产
提供商选择是强制性的。
如果 Bloom 已配置或预期运行，你必须首先检查 Bloom。 当 Bloom 是预期提供商时，不要静默替换为 Cowork 原生的图像生成、通用内置图像工具或即兴图像提示。
如果 Bloom 未配置、被阻止或无法连接：
- 明确说明这一点
- 询问操作员是否：
- 提供/配置 Bloom
- 使用 Nano Banana 备用
- 提供手动/操作员资产
- 在保真度关键运行中，不要静默继续使用较弱的提供商
如果使用 Nano Banana 作为备用路径，确认操作员已提供所需的适配器/命令或基于 API 的工作流。 不要仅仅因为文档中出现“Nano Banana”就假定它存在。
Bloom 特定指南
当 Bloom 可用时：
- 检查该品牌是否已存在于 Bloom 中
- 如果不存在，从源 URL 引导品牌
- 如果 Bloom 品牌上下文较弱或不完整，使用仓库中提取的品牌事实、分析和调色板进行填充
- 在生成精确产品镜头之前，先上传产品、包装或 UI 参考
- 当基础构图很强且更改请求很窄时，使用 Bloom 的编辑/调整大小功能
在以下情况下回退到 Nano Banana：
- Bloom 不可用或未配置
- Bloom 引导反复失败
- Bloom 积分不足
- 在合理重试后，所需图像仍未能通过视觉质量评估标准
在切换到 Nano Banana 之前，明确说明未使用 Bloom 的原因：
- 不可用
- 未配置
- 被运行时阻止
- 重试后质量评估失败
- 积分不足
提供商助手
使用技能本地的图像提供商入口点，通过提供商回退机制运行实际的图像生成：
bash skills/page-visuals/scripts/image-provider.sh \
--page-name [page-name] \
--shot-id [shot-id] \
--prompt "[prompt]" \
--preservation-class [exact_product|branded_environment|concept_support]
对于仅上传技能文件夹的 Cowork 或任何运行时，使用 skills/page-visuals/scripts/ 作为主要接口。
仓库根目录的 /scripts 副本是本地开发的便利，不是打包要求。
保护类别
每个计划的视觉元素在提示之前必须进行分类。
1. 精确产品保护
当产品的形状、材料、包装、UI 或工业设计对信任或理解至关重要时使用。
要求：
- 保留轮廓
- 保留比例
- 保留材料外观
- 保留相关包装
- 保留相关 UI/屏幕内容
- 尽可能使用参考
2. 品牌环境保护
当产品可以放在品牌特定上下文中，但不需要完美的对象保真度时使用。
要求：
- 匹配调色板和目标受众的世界观
- 保持品牌氛围和品类真实感
- 避免库存图片式的布景
3. 概念支持视觉
当图像用于解释、营造氛围或作为背景支撑，而非信任关键的产品证明时使用。
要求：
- 支持机制或章节的任务
- 保持对文案的从属地位
- 不要引入虚假的产品细节
镜头优先级层次
按此顺序生成：
- 证明/机制视觉
- 产品清晰度视觉
- 生活方式向往视觉
- 装饰性支持视觉
如果时间或预算有限，优先放弃第4项。
必需的镜头计划输出
写入 workspace/pages/[page-name]/visuals/index.md：
# 视觉计划: [page-name]
生成日期:
| 镜头 | 章节 | 保护类别 | 目的 | 所需参考 | 状态 |
|---|---|---|---|---|---|
| hero-1 | 首屏 | 精确产品 / 品牌环境 / 概念支持 | | | 已计划 |
当实际生成视觉时，尽可能扩展计划，加入提供商元数据：
## 提供商运行
| 镜头 | 提供商 | 品牌上下文来源 | 源图像 ID / 参考 | 结果 |
|---|---|---|---|---|
| hero-1 | bloom | 仓库分析 + Bloom 引导 | bloom:img_123, 本地产品参考 | 已批准 |
同时写入 workspace/pages/[page-name]/visuals/manifest.json，包含机器可读字段：
- 使用的提供商
- 备用提供商及备用原因（如适用）
- Bloom 品牌 ID 和图像 ID（如适用）
- 镜头使用的源参考
- 本地输出路径
- 状态和备注
提示规则
始终包含：
- 目标章节和任务
- 保护类别
- 构图要求
- 调色板方向
- 氛围/光照
- 保真度约束
- 明确的排除项
对于精确产品保护
提示必须说明：
- 保留对象轮廓和比例
- 保留材料表面处理
- 仅根据参考保留包装/UI
- 没有虚构的文本或更改的品牌标志
- 在提供商支持的情况下，生成前附上或上传参考
对于品牌环境
提示必须说明：
- 受众上下文
- 真实的使用场景
- 通过环境、道具、服装或光照实现调色板集成
- 没有千篇一律的库存图片姿势
对于概念支持
提示必须说明：
- 章节任务
- 极简主义/抽象程度
- 没有虚假的主张性细节
截图/UI 处理
如果策略标记需要处理截图：
- 保留截图或 UI 参考
- 不要凭想象伪造 UI 精确度
- 如果没有真实的 UI 资产，提出标记并降级镜头计划
视觉质量评估标准
每个生成的图像都必须打分：
| 维度 | 分数 /10 | 通过阈值 |
|---|---|---|
| 章节匹配度 | 8 | |
| 调色板保真度 | 8 | |
| 轮廓/几何保真度 | 8 (如适用) | |
| 材料保真度 | 8 (如适用) | |
| 包装/UI 保真度 | 8 (如适用) | |
| 构图清晰度 | 8 | |
| 无伪影 | 9 | |
| 无文字伪影 | 10 |
如果任何必需维度未通过，拒绝并重新生成。
失败逻辑
如果精确产品保真度反复失败：
- 停止使用松散的品牌氛围提示
- 要求更严格的参考
- 如果可用，降级为保留的摄影或操作员提供的资产
- 决不能因为模型难以处理而伪造精确性
如果 Bloom 作为首次通过提供商反复失败：
- 当问题在于构图或裁剪而非核心保真度时，先尝试提供商的编辑/调整大小，再完全重新生成
- 如果 Bloom 仍无法通过质量评估，切换到 Nano Banana
- 如果两个提供商都失败且镜头对信任至关重要，要求提供真实操作员资产
不要让 Cowork 静默地用自己的默认图像行为替换 Bloom。 如果运行时无法访问 Bloom，暂停并说明情况。
评估参考
有关评分标准和通过阈值，请参阅 skills/page-qa/references/eval-rubric.md。
移交
在视觉元素获得批准后，运行 page-build。