美业全能海报设计

概述

基于「棱镜 API」的美业垂直 AI 海报设计与生成技能。以「全能海报设计」为 API 基准（棱镜 API + generate_poster.py 脚本完全一致），融合「设计哲学先行 + 参数化设计系统」方法论，面向美容/皮肤管理、美发、美甲美睫、轻医美、SPA 养生、大健康等美业场景，把客户需求转化为高质量结构化提示词，调用图片生成模型产出海报并保存到本地。

适用场景

• 美业门店/品牌要设计一张海报（开业、活动、节日、项目推广、会员招募、优惠促销、品牌形象等）
• 需要轻奢、奶油治愈、科技医美、中式养生、日系清新、韩式轻氧等美业专属视觉风格
• 需要把中文文案与视觉需求转成可直接用于 AI 生图的结构化提示词
• 需要基于本地图片或资料库里的图片素材做参考图重绘/改版（如品牌 LOGO、门店实拍、产品图）
• 需要批量生成不同尺寸/分辨率的海报版本（朋友圈 9:16、门头易拉宝 2:3、公众号头图 16:9 等）

安全与密钥原则

• 绝不把真实 Token 写进技能文档或脚本。Token 从环境变量 PRISM_API_TOKEN 读取，或临时由用户运行时提供。
• 若 PRISM_API_TOKEN 未配置且用户未提供，应先询问用户要 Token。
• 资料库相关操作（本地图片上传、drive 节点取下载链接）需要由 agent 通过「资料库」技能调用 connect_open_platform 拿 token 后驱动对应脚本完成；技能本身不硬编码任何 token。
• 不提供跳过 SSL 证书校验的示例；优先检查系统证书、网络与代理。
• 401 → Token 无效/过期；403 → 账号权限/额度。

核心工作流

按以下步骤执行，第 1 步（尺寸/分辨率）为强制步骤，不可跳过。第 2 步（设计哲学）为融合亮点步骤，不可省略。

第 0 步：确认 Token 与模型

1. 读取环境变量 PRISM_API_TOKEN（或 PRISM_BASE_URL，默认 https://lengjing.0c0.cn）。
2. 若未配置 Token，按下方「新用户密钥申请指引」引导用户获取，或直接向用户索要。
3. 默认模型 gpt-image-2（即 Image 2）。可切换为 doubao_img / NanoBanana / nano_banana 2（注意 nano_banana 2 中间有空格）。
4. 可选：先 python scripts/generate_poster.py list --type image 确认渠道能力。

新用户密钥申请指引（无 Token 时必读）

当用户是首次使用、不知道如何获取密钥时，按以下步骤主动引导，不要直接报错：

1. 打开申请入口：访问棱镜 AI 网关平台 https://lengjing.0c0.cn（浏览器打开）。
2. 登录/注册账号：在平台完成登录或注册。
3. 进入「令牌管理」：登录后，在平台页面找到「令牌管理」（Token 管理）入口。
4. 创建 API Token：点击「创建 Token / 新建令牌」，生成一个 API Token。Token 形如 sk-prism- 开头的一串字符。
5. 复制 Token 给到本技能：把 Token 通过以下任一方式提供：
   • 直接在对话里发给 agent（agent 会用它调用脚本）；
   • 或设置到环境变量 PRISM_API_TOKEN（Windows 可用 setx PRISM_API_TOKEN "sk-prism-xxx"）。
6. 验证可用：拿到 Token 后先跑一次连通性验证：

   python scripts/generate_poster.py list --type image --token "sk-prism-xxx"

返回能力列表（含 gpt-image-2）即说明 Token 有效，可正常出图。

提示：若平台登录页或「令牌管理」入口位置有变化，以 https://lengjing.0c0.cn 首页实际导航为准；平台为 React 单页应用，令牌管理是站内前端页面，需登录后可见。Token 是付费/额度凭证，请勿泄露给无关第三方。

第 1 步：询问尺寸与分辨率（必须，客户手动选择）

生成前必须向客户确认两项参数，让客户手动选择，不要替客户默认：

• 分辨率默认 1K：询问时把「1K」作为第一个/默认选项；客户未指定分辨率时一律按 1K 出图（脚本 --image-size 默认值即 1K）。
• 可一次询问「比例」与「分辨率」两个问题，把 1K 作为分辨率默认项。拿到客户明确选择后进入下一步。

第 2 步：构建设计哲学（融合亮点，必做）

在写提示词之前，先用结构化的「设计哲学」把海报的内在系统定下来。 哲学先行，画面才有秩序；哲学翻译成参数，成图才稳定。按下述 5 段结构输出（inline markdown，3-5 句即可，避免空泛形容词）：

1. 核心概念（Concept） — 这张海报要传达的一个核心感受（如「高级」「松弛」「专业」「治愈」）。必须是可执行的，避免「炫酷」这类无法落地的词。
2. 视觉逻辑（Visual Logic） — 构图策略：网格/无网格、信息密度（克制/饱满）、留白策略。美业海报默认留白优先。
3. 系统行为（System Behavior） — 信息层级（主/次/三级）、对齐规则（居中 or 左对齐+一处刻意偏移）、节奏。
4. 参数化变量（Parametric） — 硬性参数：主色数量（≤2 色，不含黑白金）、活跃元素数量（≤5 个）、信息块（≤3 块：标题/副标题/元信息）、字号比例（标题:副题:细节 = 10:3:1）、边距比例（上下留白 ≥15%）。
5. 涌现效果（Emergence） — 执行后观众感受到的氛围（如「一眼看到价格，三秒记住品牌名」）。

设计哲学示例（美业）：

Concept：轻奢但不高冷——贵气藏在留白与香槟金里。Visual Logic：居中主构图，信息密度克制，四周大留白。System Behavior：主标题是唯一视觉锚点，副题与价格用细线分隔，全部垂直居中。Parametric：主色 2（暖白+香槟金，黑色文字）、活跃元素 4（标题/副题/价格/品牌角标）、信息块 3、标题:副题:细节=10:3:1、上下边距 20%。Emergence：顾客第一眼看到品牌名与价格，感到这家店审美在线、值得信任。

之后把哲学翻译进第 4 步的英文提示词（哲学中的参数直接决定提示词里的 color palette / composition / typography 描述）。

第 2.5 步：确认设计风格（6 选 1，默认第一种）

生成前向客户展示 6 种美业预设风格供挑选；客户未挑选时默认使用第一种「轻奢高级感」。6 种风格的中英文提示词模板见 references/meiye-prompt-guide.md §四：

1. 轻奢高级感（默认）— 暖白/香槟金/深灰，大留白，哑光质感，适合皮肤管理、高端美容会所。
2. 奶油治愈风 — 奶油色/浅杏/奶咖，柔和圆润，软糯质感，适合美甲、美睫、日式皮肤管理。
3. 科技医美风 — 冷白/冰蓝/渐变紫，光效线条，专业仪器感，适合轻医美、光电项目、问题肌管理。
4. 中式养生风 — 墨绿/朱砂/檀棕，东方留白，草本/经络元素，适合 SPA、艾灸、康婷大健康体系。
5. 日系清新风 — 浅蓝/白色/木色，干净通透，森系自然，适合美发沙龙、素颜肌概念。
6. 韩式轻氧风 — 柔粉/奶白/薄荷，通透氧气感，元气活力，适合年轻向门店、爆款项目引流。

客户指定编号或风格名即按对应风格生成；未指定则默认「轻奢高级感」。

第 2.8 步：确认美业场景与文案要素（按需）

1. 让客户明确场景类型（参考 references/meiye-prompt-guide.md §五 的 8 大场景模板）：门店开业 / 项目推广 / 会员招募 / 优惠促销 / 节日营销 / 节气养生 / 新品上市 / 品牌形象。
2. 收集美业文案要素（参考 references/meiye-copywriting.md）：门店/品牌名、主打项目、功效卖点、价格/优惠、活动时间、预约电话/微信、地址、二维码占位（用「二维码区域」描述占位，不生成真实码）。
3. 文案要素收集不全时，向客户确认或使用合理占位（如「××美业」「￥999 起」「扫码预约」）。

第 3 步：准备图片素材（参考图，按需）

棱镜 API 的 image_urls 只接受可匿名访问的 http(s) URL（实测：base64 data URL 会被后端拒为 400 invalid_request）。所以无论图片来源是本地文件还是资料库节点，都必须先转成公网直链。本技能不内置上传逻辑，由 agent 配合「资料库」技能完成中转。

情形 A：用户提供的是本地图片路径

让 agent 调用资料库的图片上传能力（manage/upload_image.py），把本地图片（≤10 MiB）转为资料库 CDN 公网直链。upload_image.py 返回的 JSON 含 url 字段（CDN 匿名可读），把该 url 传到 --image-urls。

client 模式下，agent 需先用 connect_open_platform 拿 library token，再按以下命令调用：

printf '%s' "<library_token>" | python3 
  "C:/Users/Administrator/.workbuddy/plugins/cache/workbuddy-builtin/skill-library/0.5.9/manage/upload_image.py" 
  --token-stdin "E:/美业素材/门店LOGO.jpg"

输出 KS_IMAGE_UPLOAD_OK {"url":"https://...","width":...,"height":...}，取 url 字段即可。

情形 B：用户提供的是资料库 drive 节点 ID（如 blk_xxx）

让 agent 调用 drive/get_download_link.py 拿短期预签名 COS 公网 URL，把 download_url 传到 --image-urls：

printf '%s' "<library_token>" | python3 
  "C:/Users/Administrator/.workbuddy/plugins/cache/workbuddy-builtin/skill-library/0.5.9/drive/get_download_link.py" 
  --token-stdin --node-id "blk_xxxxxxxx"

输出 KS_DRIVE_DOWNLOAD {...,"download_url":"https://..."}，取 download_url。

情形 C：用户提供的是任意 http(s) URL（已是公网直链）

直接用，不需要额外处理。

情形 D：纯文生图（无参考图）

跳过本步，不传 --image-urls。

注：多张参考图（最多 9 张）按顺序传入 --image-urls url1 url2 ...。

第 4 步：组装提示词（哲学 → 参数 → 英文提示词）

根据第 2 步的设计哲学与第 2.8 步的场景/文案，结合 references/meiye-prompt-guide.md 的美业提示词工程产出结构化提示词。覆盖七要素（主体 / 面部肤质 / 环境氛围 / 光影 / 道具细节 / 文字排版 / 整体风格）+ 美业专属要素（场景 / 风格 / 色彩 / 文案占位）。

不要在提示词里写死像素尺寸。尺寸由 --aspect-ratio 与 --image-size 参数控制。

提示词必须包含的硬约束（来自设计哲学参数化）：

• color palette: ≤2 main colors + neutrals（主色不超过 2 个）
• max 3 information blocks（最多 3 个信息块：标题/副标题/元信息）
• max 5 active elements（最多 5 个活跃元素）
• generous negative space（大留白，除非客户要求饱满排版）
• title : subtitle : meta ≈ 10 : 3 : 1（字号层级）
• no watermark（无水印）

第 5 步：调用脚本生成

python scripts/generate_poster.py generate 
  --prompt "你的提示词" 
  --aspect-ratio "9:16" 
  --image-size "1K" 
  --model gpt-image-2 
  --image-urls "https://cdn.example.com/ref1.jpg" "https://cdn.example.com/ref2.jpg" 
  --output-dir "./outputs" 
  --token "$PRISM_API_TOKEN"

脚本会自动：提交任务 → 分段重试轮询 → 下载图片（按响应头 content-type 判真实扩展名）→ 输出本地路径。

结果保存（防覆盖）：每个任务的结果保存到 --output-dir 下的独立子目录，目录名形如 <时间戳>_<task_id 短标识>（如 20260823_235301_ff60040c），目录内文件按 poster_1.png、poster_2.jpg 顺序编号。多个任务并行或多次运行互不覆盖，所有结果全部保留。生成时脚本会打印实际保存目录路径，交付时请以打印出的目录为准取图。

重试机制（内置）：脚本采用「单次超时 + 多次重试」策略，规避接口瞬时宕机、网络抖动、任务排队拥堵造成的偶发失败——

超过 --max-retries 次仍未拿到结果时，脚本会打印失败原因（最后任务状态 / 网络异常 / 接口错误）并退出非 0，便于排查。

第 6 步：交付结果

1. 用 present_files 展示生成的海报图片。
2. 简要说明使用的设计哲学、风格、比例、分辨率、模型、参考图来源与最终文件位置。
3. 若生成多张（--n > 1 或 result.urls 多张），一并展示。
4. 交付时附一句「是否调整文案/换风格/换比例重出」的引导，便于迭代。

任务管理命令

# 查询能力列表
python scripts/generate_poster.py list --type image --token "$PRISM_API_TOKEN"

# 查询模型参数
python scripts/generate_poster.py schema --capability gpt-image-2 --token "$PRISM_API_TOKEN"

# 提交任务后查询进度
python scripts/generate_poster.py query --task-no "<task_id>" --token "$PRISM_API_TOKEN"

# 取消任务
python scripts/generate_poster.py cancel --task-no "<task_id>" --token "$PRISM_API_TOKEN"

常见问题

• 401 未授权：棱镜 Token 无效/过期；检查 PRISM_API_TOKEN。
• 400 invalid_request / fail_to_submit_task：image_urls 用了 base64 data URL 或被棱镜后端拒；改用公网 http(s) URL（用资料库 upload_image.py / get_download_link.py 中转）。
• 400 参数错误：--aspect-ratio / --image-size 取值需在可选范围内（实测 gpt-image-2 比例多了 21:9）。
• 任务一直 processing：图片生成较慢，脚本默认最多等 600s，可加 --max-wait 调大。
• 余额不足 / 限流 429：账号问题，提示用户充值或降低并发。
• 结果文件扩展名与实际不符：脚本已按响应头 content-type 修正；如仍异常可手动 file 检查。
• AI 生图文字乱码：中文长文案在 AI 生图中易乱码，建议海报文案控制在标题+副标题两级；重要价格/数字尽量简短。
• bash 传长提示词报 unrecognized arguments：提示词内含直双引号（如 title "问题肌焕肤计划"）会被 shell 解析拆开。推荐做法：先把提示词写入临时文件再传，如 --prompt "$(cat /tmp/prompt.txt)"；或在 Python 脚本内直接调用 generate() 函数传参。

资源文件

• scripts/generate_poster.py — 棱镜 API 完整调用脚本（list / schema / generate / query / cancel），纯标准库无第三方依赖。与「全能海报设计」完全一致。
• references/prism-api.md — 棱镜 API 接口与参数速查（与「全能海报设计」一致）。
• references/meiye-prompt-guide.md — 美业海报提示词工程指南：设计哲学模板 + 6 大美业风格库 + 8 大场景模板 + 参数化硬约束。
• references/meiye-copywriting.md — 美业文案要素清单与占位符规范。

出品方:郑州易企软件科技有限公司&易企OPC社区版本:1.1.0 联系VX:yiqizhinanzhen郑州易企软件科技有限公司&易企OPC社区一OPC社群变现第一站