用途:读取设计令牌中已有的品牌契约(含角色调色板、字体、形状及 $extensions 品牌块),通过逐步问卷生成风格一致的插画集。
主要能力:分步询问主题与用途、令牌未覆盖的风格与情绪、数量与变体、尺寸与平台、后端与预算、参考图与额外负面词。可复用上次配方(tokenset.illustrate-recipe.json)。尺寸预设包括 og-image 1200×630、thumbnail-16-9 1280×720、square-post 1080×1080、deck-cover 1920×1080、spot-ui 512×512;预设是向后端请求的尺寸而非缩放。内置去俗套负面词,用户额外负面词会合并。
使用方式:需先有 design-tokens 生成的令牌文件(design.tokens.json 或 <name>.tokens.json);若没有,应先完成设计令牌。运行脚本 scripts/illustrate.py,可用 backends -v 查看后端发现结果。后端发现顺序为:项目 humane.json、~/.humane/config.json、HUMANE_IMAGE_BACKEND 的分层设置,其次 HUMANE_SKILLS_DIR,再次已知技能根目录,最后 PATH。选项包括 gpt-image-2(接受 seed 但当前不发送)、nano-banana(原生参考图风格迁移,无 seed,用首张成功图作后续 --reference)、auto(偏好 gpt-image-2)。批量产物写入 .design/illustration-<batch>/,含 PNG、metadata.json、contact-sheet.html 和保存的配方。无后端时仍写出 prompts.md、metadata.json 和配方,可粘贴到任意图像工具,或用 run --recipe 续跑。
限制:需令牌文件作为风格契约,不可凭空发明品牌风格;无后端不是失败。当前两个后端都不能跨运行精确复现同一批图像,一致性真实但复现不保证。脚本仅依赖标准库,不处理 API 密钥,不内置生成器。测试命令:cd brand-illustrate && python3 -m unittest discover -s tests -v。