用途:生成透明背景的扁平科学图标,样式由项目 figures/theme.json 主题决定,可作为科研图表面板元素、figures:svg-primitives 示意图的一部分,或单独用于海报、幻灯片和基金申请。
主要能力:支持自由描述主题生成图标,也支持从图标模板库(icon bible)按模板或分类生成;支持批量生成与占位符替换;可通过 --colors 覆盖主题调色板,--size 指定尺寸。生成后端包括 Codex CLI image_gen(默认,需已登录 Codex,无需 API key)、OpenAI Images API(--backend api,需 OPENAI_API_KEY)、Atlas Cloud(--backend atlas,需 ATLASCLOUD_API_KEY,默认模型 black-forest-labs/flux-schnell)以及用于测试的 --backend fake。透明度处理默认 --transparency-method auto,PNG 已有干净抠图时不本地处理,否则回退到阈值法;可选 --with rembg --with onnxruntime 启用 birefnet 获得更干净边缘。
使用方式:通过 uv run --with pillow python scripts/generate_icon.py 调用,可传入自由描述或 --template 模板名,配合 --theme figures/theme.json 和 -o 输出路径;--list-templates 列出模板,--category 按分类生成,--batch 批量生成。其他参数包括 --backend、--atlas-model、--codex-bin、--timeout、--verbose、--print-prompt。每次输出旁会写入 <out>.codex.log 日志。
适用场景:需要与项目其他图表风格一致的科研图标,用于论文图、示意图、海报、幻灯片和基金申请。
限制:需要主题文件才能保证风格一致,建议先用 figures:figure-bible 生成并校验 figures/theme.json;生成后建议调用 figures:figure-qa 做质量检查(除非用户传入 no-qa),其栅格分支检查 alpha 通道、边角、调色板合规、分辨率和主色,视觉检查判断图标是否表达预期概念。Codex 后端有 10 秒预检超时,若二进制挂起需按提示修复。Atlas Cloud 为显式选用,不会改变 Codex 优先的自动路由。具体收费、价格和平台支持情况暂未提供。