SuperAPI AI 工具集

paper-figure

写作与研究

查看项目

更新于 10-15 17:03

技能介绍

用途

Paper Figure 用于基于实验数据自动生成论文所需的所有图表与表格,目标是产出可直接用于投稿的出版质量图形。当用户提出“画图”“作图”“generate figures”“paper figures”或需要为实验结果绘制图表时触发。

主要能力

技能明确区分了可自动生成与不可自动生成的图形类型。

可自动生成的部分:

  • 数据驱动图形:折线图(训练曲线)、柱状图(方法对比)、散点图、热力图、箱线图/小提琴图。
  • 对比表格:以 LaTeX 形式输出,用于比较已有方法的界、方法特性、消融结果。
  • 多面板图形:由多个子图组合成的网格,例如数据集×方法的 3×3 组合。

不能自动生成、需手工处理的部分:

  • 架构图/流程图:模型架构、数据流图、系统概览。技能最多生成粗略的 TikZ 骨架,实际仍需自行用 draw.io、Figma 或 TikZ 绘制。
  • 生成图像网格:例如 GAN/扩散模型的生成样本,来自运行模型本身而非本技能。
  • 照片/截图:真实图像、界面截图、定性示例。

按资料说明,对于典型的机器学习论文,该技能可处理约 60% 的图形(全部数据图与表格),其余约 40%(主图、架构图、定性结果)需手工制作并放入 figures/ 目录,技能会将其识别为“已有图形”并保留。

使用方式

技能提供一组可配置常量:STYLE(publication 默认、poster、slide)、DPI(300)、FORMAT(pdf 矢量优先、png 回退)、COLOR_PALETTE(tab10、Set2、colorblind)、FONT_SIZE(10)、FIG_DIR(figures/)、REVIEWER_MODEL(gpt-6-astra,经 Codex MCP 用于图形质量审查)。

输入包括:PAPER_PLAN.md 中的图形计划表、实验数据(figures/ 或项目根目录下的 JSON、CSV、屏幕日志)、需要保留的已有手工图形。若不存在 PAPER_PLAN.md,则扫描数据文件并询问用户要生成哪些图。

工作流分为若干步骤:

  1. 读取图形计划,解析计划表,识别哪些可自动生成、哪些需手工、哪些是表格。
  2. 建立共享样式配置脚本 paper_plot_style.py,统一字体、DPI、颜色、边框等设置,并提供 save_fig 函数。
  3. 按决策树自动选择图形类型:X=时间/步数且 Y=指标用折线图(0.48\textwidth);方法×单指标用柱状图;方法×多指标用分组柱状/雷达图(0.95\textwidth);两个连续变量用散点图;矩阵用热力图;分布比较用箱线/小提琴图;多数据集用多面板;已有工作比较用 LaTeX 表格。
  4. 为每张图生成独立 Python 脚本,从 JSON/CSV 读取数据,避免硬编码,并示范了折线图、带数值标注的柱状图、LaTeX 对比表的写法。架构图标注为手工处理。
  5. 运行所有脚本,校验输出文件存在且非空,并重新打开渲染后的 PDF/PNG 进行自检(标签无裁切、图例不遮挡数据、数字可读)。
  6. 为每张图生成 LaTeX 引用片段,汇总保存到 figures/latex_includes.tex。
  7. 将图形描述与标题发送给 REVIEWER_MODEL 审查,检查标题是否信息完整且自洽、图形类型是否匹配数据、对比是否公平清晰、是否缺少基线或消融、是否有更有效的可视化方式。
  8. 执行质量检查清单。

质量检查清单

清单分为“正确性”和“规范性”两部分。资料强调正确性规则始终生效,不因审美偏好被覆盖:被排除的数据不得进入汇总(要么整体消失,要么以空心/斜线标记并注明);标题和类断言文字需与每一行数据对照,若有类别与断言矛盾需加限定说明;只有在相同条件下测量的结果才能作为视觉同级比较,N、预算、协议不同需分开或注明;每个含汇总标记的面板要标注 n 和重复单位;渲染后的 PDF/PNG 需完成自检。

规范性规则作为强默认值,可在明确说明的情况下被覆盖,但其中矢量 PDF 输出与图内不加标题被列为硬性关键规则,不可覆盖:字体在印刷尺寸下可读、灰度下颜色可区分、标题只放在 LaTeX \caption{} 中、图例不遮挡数据、坐标轴带单位且标签达到出版质量、图宽适配单栏或通栏、PDF 为矢量、去掉 matplotlib 默认标题、衬线字体与正文一致、色盲可访问。

输出结构

figures/ 目录下包含:paper_plot_style.py(共享样式)、每张图的生成脚本、生成的图形 PDF、latex_includes.tex(LaTeX 片段)、TABLE_*.tex(独立表格文件)。

关键规则

每张图必须可复现,生成脚本与输出一同保存;不得硬编码数据,必须从 JSON/CSV 读取;所有图使用矢量 PDF,PNG 仅作回退;无装饰性元素(无背景色、3D 效果、图表垃圾);所有图风格一致;色盲安全;每图一个脚本便于重跑;图内不加标题;对比表格也视为图形,输出为独立 .tex 文件。

局限

架构/流程类图、生成样本网格、照片与截图无法自动生成,需手工制作。技能未提供收费、价格、平台等具体信息。