用途:paper-figures 用于把表格数据(CSV、JSON 或内联表格)加一段自然语言描述,渲染成可发表的 PNG 图表,并产出可复现的 matplotlib 脚本。适用于论文或实验中的 figure、plot、chart、visualize、render 需求。
主要能力:输出始终包含独立脚本 plot.py(加载数据、用 matplotlib 渲染、以 plt.savefig(..., dpi=300, bbox_inches="tight") 保存)和渲染出的 plot.png;在可写文件系统时还生成 figure-spec.md(编码前的图表规格)、audit.md(渲染后审计清单与修复)和 final-status.md(PASSED、PASSED_WITH_WARNINGS、REPAIRED 或 FAILED_NEEDS_HANDOFF)。支持折线、柱状、散点、饼图、KDE、小提琴、气泡、龙卷风、环形、热力图等类型,以及多面板 gridspec 组合。
使用方式:依赖 pip install matplotlib pandas numpy scipy。工作流为:规划图表、检查数据、写 figure-spec.md、选择 matplotlib 惯用法、应用出版级默认样式、编写并运行脚本、审计结果。运行 python plot.py 生成 PNG;可用时运行 python scripts/validate_figure.py --output-dir <output-dir> --spec <output-dir>/figure-spec.md 校验。输出目录由用户指定,未指定则写入当前工作目录,文件名固定为 plot.py 和 plot.png。
限制:描述是意图、CSV 是事实,冲突时以 CSV 为准;不得静默丢弃数据或添加未要求的元素;不合成数据、不做未提及的聚合;视觉检查不可靠,需结构化审计;存在阻塞性歧义时需提一个具体问题。具体收费、平台支持等信息暂未提供。