SuperAPI AI 工具集

figure-bible

通用与其它

查看项目

更新于 10-16 06:50

技能介绍

用途:figure-bible 是图表工作流的“第零步”,在生成任何图表前为项目建立唯一的 figures/theme.json,统一配色、字体、构图规则和图像模型偏好,避免多张图出现风格漂移。

主要能力:提供两个脚本。init_theme.py 用于脚手架式创建主题,需指定 --journal(nature、science、cell、pnas、poster 或 slide,决定默认页宽与最小字号),可选 --preset(okabe-ito 默认色盲友好八色、tol-bright、wong、neuro-flat)、--primary/--accent/--neutral 覆盖角色色、--reference 添加风格参考图、--codex-model 与 --codex-effort 设置图像模型默认值;--force 可覆盖已有文件。validate_theme.py 用于校验主题,支持 --json 输出机器可读结果,退出码 0 有效、1 有问题、2 为用法或 IO 错误。

使用方式:先运行 init_theme.py 生成主题,再运行 validate_theme.py 校验。其他生成技能(如 figures:ai-full-figure、figures:transparent-icons、figures:scientific-figure、figures:svg-primitives、figures:plot-styling)会读取主题中的 palette、typography、style_tokens/negative_tokens、composition、text 和 model_preferences;QA 技能可用 --palette figures/theme.json 替代预设名进行配色合规检查。

适用场景:新论文、基金申请或海报项目尚无主题文件时;需要多图统一外观时;生成或 QA 技能报告配色漂移且项目无主题可参照时。

限制:单个一次性、无复用需求的图可跳过,使用生成技能默认值即可。一个项目只保留一个 figures/theme.json 并纳入版本控制,不要为同一论文的第二张图另建主题,应编辑现有主题后重新校验;多主题仅适用于真正独立的项目。jsonschema 为可选依赖,未安装时回退到手写结构检查。完整字段表见 references/theme-fields.md,示例见 examples/nature-neuro.theme.json。