全能海报设计

概述

基于「棱镜 API」的 AI 海报设计与生成技能。把用户的海报需求转化为高质量提示词，调用图片生成模型产出海报，并保存到本地。

适用场景

• 用户要设计/生成一张海报（节气、节日、活动、产品、商业宣传等）
• 需要国风、古风、新中式、东方美学、商务风等特定视觉风格的海报
• 需要把中文文案与视觉需求转成可直接用于 AI 生图的结构化提示词
• 需要基于本地图片或资料库里的图片素材做参考图重绘/改版海报
• 需要批量生成不同尺寸/分辨率的海报版本

安全与密钥原则

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

核心工作流

按以下步骤执行，第 1 步（尺寸/分辨率）为强制步骤，不可跳过。

第 0 步：确认 Token 与模型

1. 读取环境变量 PRISM_API_TOKEN（或 PRISM_BASE_URL，默认 https://prism.aixiaogong.vip）。
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://prism.aixiaogong.vip（浏览器打开）。
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://prism.aixiaogong.vip 首页实际导航为准；平台为 React 单页应用，令牌管理是站内前端页面，需登录后可见。Token 是付费/额度凭证，请勿泄露给无关第三方。

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

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

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

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

生成前向客户展示 4 种预设风格供挑选；客户未挑选时默认使用第一种「现代商务科技风」。4 种风格的中英文提示词模板见 references/prompt-guide.md §风格模板库：

1. 现代商务科技风（默认）— 深蓝金配色、科技感、AI/数据元素、会议/企业场景。
2. 古风东方美学风 — 月白/黛蓝/朱砂/金、水墨晕染、汉服/新中式、书法竖排。
3. 新中式高端雅致风 — 留白构图、深木色/黛蓝/金、克制含蓄、电影感光影。
4. 简约清新现代风 — 浅色底、大留白、扁平几何、明亮轻盈、年轻化。

客户指定编号或风格名即按对应风格生成；未指定则默认「现代商务科技风」。

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

棱镜 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:/skill海报/南广生1.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 ...。

第 3 步：组装提示词

根据用户需求，结合 references/prompt-guide.md 的提示词工程方法产出结构化提示词。覆盖七要素（主体 / 面部肤质 / 环境氛围 / 光影 / 道具细节 / 文字排版 / 整体风格）。中文需求可参考芒种案例，先产出中文结构化，再翻译成英文给模型效果更稳。

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

第 4 步：调用脚本生成

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，便于排查。

第 5 步：交付结果

1. 用 present_files 展示生成的海报图片。
2. 简要说明使用的比例、分辨率、模型、参考图来源与最终文件位置。
3. 若生成多张（--n > 1 或 result.urls 多张），一并展示。

任务管理命令

# 查询能力列表
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 检查。

资源文件

• scripts/generate_poster.py — 棱镜 API 完整调用脚本（list / schema / generate / query / cancel），纯标准库无第三方依赖。
• references/prism-api.md — 棱镜 API 接口与参数速查。
• references/prompt-guide.md — 海报提示词工程指南 + 风格模板 + 芒种古风案例。