SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场page-visuals

page-visuals

设计与创作

查看项目

更新于 10-16 06:08

技能介绍

用途

Page Visuals 的工作目标不是“生成好看的图片”，而是在不视觉上歪曲所售产品的前提下支持页面转化。若产品、包装、UI 或材质需要精确呈现，则须按对应路径处理。

必需输入

  • workspace/pages/[page-name]/strategy.json
  • workspace/brand/profile.md
  • workspace/brand/palette.json
  • workspace/pages/[page-name]/copy.md
  • 运营方提供的产品参考、包装参考、截图或图像素材

Provider 策略

以 Page Factory 品牌产物为事实来源：workspace/brand/extract.md 与 workspace/brand/profile.md 定义规范品牌理解；provider 侧的品牌 onboarding 只是图像生成的辅助上下文，不能替代提取与画像。

首选 provider 顺序：Bloom 首轮，Nano Banana 回退，然后在保真对信任至关重要时使用手动/运营方素材。

Provider 选择是强制的。如果本次运行已配置或预期使用 Bloom，必须先检查 Bloom，不得在 Bloom 为预期 provider 时静默替换为 Cowork 原生图像生成、通用内置图像工具或临时提示词。

如果 Bloom 未配置、受阻或无法访问：明确说明；询问运营方是否提供/配置 Bloom、使用 Nano Banana 回退、或提供手动/运营方素材；不得在信任关键的运行中静默继续使用较弱的 provider。

若走 Nano Banana 回退，需确认运营方已提供所需的 adapter/命令或 API 工作流，不能仅因文档出现该名称就假定其存在。

Bloom 专项指引

Bloom 可用时：检查品牌是否已在 Bloom 中存在；若不存在则从来源 URL 进行 onboarding；若 Bloom 品牌上下文薄弱或不完整，用仓库提取的品牌事实、画像与调色板补充；在生成精确产品图前上传产品、包装或 UI 参考；当基础构图良好而修改请求较窄时使用 Bloom 的编辑/缩放。

回退 Nano Banana 的情形：Bloom 不可用或未配置；Bloom onboarding 反复失败；Bloom 额度不足；所需图片在合理重试后仍无法通过视觉 QA rubric。

切换到 Nano Banana 前，须明确说明未使用 Bloom 的原因：不可用、未配置、被运行时阻塞、重试后 QA 失败、额度不足。

Provider 辅助脚本

使用技能本地的图像 provider 入口运行实际图像生成并支持 provider 回退：

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 副本是本地开发便利，并非打包要求。

保真等级（Preservation classes）

每个规划的画面在提示前必须先分类。

  1. 精确产品保真（Exact product preservation）：当产品的形状、材质、包装、UI 或工业设计对信任或理解很重要时使用。要求保留轮廓、比例、材质外观，相关时保留包装与 UI/屏幕内容，并尽可能使用参考。
  2. 品牌化场景保真（Branded environment preservation）：当产品可置于品牌特定语境但不需要完美物体保真时使用。要求匹配调色板与受众世界，保持品牌调性与品类真实感，避免 stock 图式摆拍。
  3. 概念支撑视觉（Concept-support visual）：当图片是解释性、氛围性或背景支撑而非信任关键的产品证明时使用。要求支撑机制或区块职责，从属于文案，不引入虚假产品细节。

画面优先级层级

按以下顺序生成：证明/机制视觉 → 产品清晰度视觉 → 生活向往视觉 → 装饰支撑视觉。若时间或预算有限，先舍弃第 4 项。

必需的画面计划输出

写入 workspace/pages/[page-name]/visuals/index.md：

# Visual Plan: [page-name]
Generated:

| Shot | Section | Preservation class | Purpose | Required refs | Status |
|---|---|---|---|---|---|
| hero-1 | hero | exact product / branded environment / concept support | | | planned |

实际生成视觉后，尽可能用 provider 元数据扩展计划：

## Provider runs

| Shot | Provider | Brand context source | Source image IDs / refs | Result |
|---|---|---|---|---|
| hero-1 | bloom | repo profile + Bloom onboarding | bloom:img_123, local product ref | approved |

同时写入 workspace/pages/[page-name]/visuals/manifest.json，包含机器可读字段：使用的 provider、回退 provider 及原因（如适用）、Bloom 品牌 ID 与图片 ID（如适用）、该画面使用的来源参考、本地输出路径、状态与备注。

提示词规则

始终包含：目标区块与职责、保真等级、构图要求、调色板方向、氛围/光照、保真约束、明确排除项。

  • 精确产品保真：提示词须声明保留物体轮廓与比例、保留材质表面、仅从参考保留包装/UI、不虚构文字或改动品牌标记；provider 支持时在生成前附加或上传参考。
  • 品牌化场景：提示词须声明受众语境、真实使用时刻、通过环境/道具/服装/光照融入调色板、避免刻板 stock 图姿势。
  • 概念支撑：提示词须声明区块职责、极简/抽象程度、不出现承载虚假主张的细节。

截图 / UI 处理

若策略将截图处理标记为必需：保留截图或 UI 参考；不要凭空手绘伪造 UI 精度；若没有真实 UI 素材，提出标记并降级画面计划。

视觉 QA rubric

每张生成的图片都须评分：

维度 阈值
section-fit 8
palette fidelity 8
silhouette / geometry fidelity 8（适用时）
material fidelity 8（适用时）
packaging / UI fidelity 8（适用时）
composition clarity 8
artifact absence 9
text artifact absence 10

任一必需维度不通过即拒绝并重新生成。

失败逻辑

若精确产品保真反复失败：停止使用宽泛品牌氛围提示词；要求更紧的参考；如可用则降级为保留摄影或运营方提供素材；绝不因模型吃力而伪造精确性。

若 Bloom 为首轮 provider 且反复失败：当问题在构图或裁切而非核心保真时，先尝试 provider 原生编辑/缩放，再考虑完全重生成；若 Bloom 仍无法通过 QA，切换到 Nano Banana；若两个 provider 都失败且该画面为信任关键，要求真实运营方素材。

不要让 Cowork 悄悄用自己的默认图像行为替换 Bloom。若运行时无法访问 Bloom，暂停并说明。

Eval 参考

评分标准与通过阈值见 skills/page-qa/references/eval-rubric.md。

交接

视觉获批后，运行 page-build。