用途:generate-graphic 是 brand-forge 中的可选栅格引擎,用于生成符合品牌调性的营销图形,例如主视觉、广告素材、背景或纹理。品牌体系中的 logo、社交图、文档等其余部分保持矢量且零权限,本技能是唯一会调用外部图像服务商的路径,仅在用户明确需要照片或插画类图形时运行。
主要能力:通过 lib/raster.mjs 构建品牌感知提示词,把配色、图像风格与语气写入提示,并将品牌禁忌转为 Avoid 子句;通过 lib/genimage.mjs 调用服务商生成图像;可通过 lib/composite.mjs 在结果上叠加清晰的矢量 logo 与说明文字。文字被刻意排除在图像之外,改以矢量方式叠加。
使用方式:需先用 /brand-new 创建有效品牌档案,读取其 color-system.json、typography.json 与 visual-identity.md。必须同时满足两个开启信号:BRAND_FORGE_RASTER=1 以及服务商密钥(默认 GEMINI_API_KEY,或 OPENAI_API_KEY)。密钥从环境变量读取并作为请求头发送,不写入 URL,也不落盘。需 PATH 中有 Node.js 且对 output/ 目录有写权限。典型流程为校验开启信号、定位并校验品牌档案、构建提示词、生成图像、可选叠加 logo 与文字、交由 visual-guardian 子代理检查配色与可读性,最后写出文件并报告路径。
输出:output/ 下的栅格 PNG,以及可选的矢量叠加 SVG(引用该 PNG,含 logo 与说明文字),可用 /brand-export 合并为单个 PNG。仅生成本地文件,不会自动发布或上传。
限制与错误处理:未设置 BRAND_FORGE_RASTER 时停止并说明如何开启,同时提供矢量替代方案;缺少服务商密钥时停止并指明所需环境变量;用户要求在图中嵌入文字时提示模型渲染文字不可靠,并将文字路由到矢量引擎;服务商调用失败会退避重试,仍失败则报错且不留半成品文件;档案未通过 validateProfile 时报告问题字段并停止。可用 /brand-status 排查开启信号,参考 references/brand-raster-prompting.md 调试偏离品牌的结果。具体服务商、价格与效果等资料暂未提供。