SuperAPI AI 工具集

polish-tables-figures

写作与研究

查看项目

更新于 10-16 01:48

技能介绍

用途:把草稿级 LaTeX 浮动体(表格、图)整理为 ACM / IEEE / NeurIPS 风格 / LNCS 等会议审稿人期待看到的形态,包括 booktabs 线型、适应页面预算的列宽、干净的子图布局、符合会议规范的图题、统一的 \cref 引用与色盲友好配色。所有改动仅限呈现层,数值不可改动。

适用时机:有人说“让表格/图更专业”“转为 booktabs”“表格太宽”“overfull hbox”“把图排成子图”“修图题”“配色是否色盲安全”“修 \ref/\cref 混乱”时;位于 tailor-to-venue 之后、preflight-check 之前使用。

输入:主 .tex 文件(含 \documentclass),会自动跟随 \input/\include;可选会议配置 venues/conferences/<venue>-<year>.yml(结构见 venues/schema.yml),用于设定栏数与图题惯例,缺省时从 documentclass 推断;强烈建议在 .tex 旁提供已编译 .log,以便运行列宽(overfull box)检查。

流程:先解析会议惯例,若命名了会议则加载其 profile,并用 python3 scripts/venueyaml.py venues/conferences/<venue>.yml 做校验,格式关键事实需对照 live cfp_url 复核,profile 仅为起点而非事实依据;随后运行检查器:python3 scripts/check_floats.py paper.tex --venue venues/conferences/<venue>-<year>.yml,可用 --json、--strict、--log <file>、--overfull-threshold <pt>、--no-inputs 等参数,退出码为 0 clean、1 findings、2 bad arguments。检查器覆盖 booktabs 风格、\resizebox/微小字号缩放、图题位置、缺失的 \caption/\label/\centering/ACM \Description、标签先于图题、废弃 subfigure 包、双栏会议下 width=\textwidth、位图图形、[h]/[H] 浮动位置、未定义与未引用标签、\ref 与 \cref 混用、“Figure \cref”双前缀、cleveref 加载顺序、句首小写 \cref,以及 .log 中的 Overfull \hbox。

修复顺序:按 references/tables.md 处理表格(机械式 booktabs 转换保留单元格字节内容,再在页面预算内调整列宽:删减→缩写→对齐数字→\tabcolsep→tabularx→table*,绝不使用 \resizebox);按 references/figures.md 处理图(\columnwidth/\linewidth 宽度纪律、figure* 跨栏、subcaption 子图、矢量格式、图内字号、浮动位置);按 references/captions-crossrefs.md 处理图题与交叉引用(各家族图题位置风格、自足式图题、cleveref 设置:最后加载、大写化、\cref 与 \Cref、全篇统一);按 references/color-accessibility.md 处理颜色,先检视论文中实际使用的颜色,再运行 python3 scripts/palettes.py check 4477AA EE6677 …,或 python3 scripts/palettes.py show okabe-ito --format latex|pgfplots|matplotlib,check 会模拟红色盲/绿色盲/蓝色盲及灰度打印并标出易混色对,若图由用户脚本生成则改绘图源码并请用户重新生成,不得声称已改色。之后重新编译并重跑检查器直到 PASS(或剩余 WARN 均为用户批准的有意选择),再交由 preflight-check。

输出:就地修改的 .tex(及绘图脚本)改动,附每个浮动体的简短变更日志与依据的会议惯例,以及最终检查器报告(PASS / PASS-WITH-WARNINGS / FAIL);用户未要求时默认不新建文件。

限制与护栏:绝不改动数据(单元格值、单位、有效数字、坐标轴尺度、误差线与图例含义均不可触碰),仅重排版,数值疑似有误只提醒用户而不代为“修正”;不得编造会议规则,profile 与 live CFP 是唯一来源,二者均无规定时须标注为一般惯例;不自行重生成或重着色结果图,只改用户绘图源码并让用户重跑;加粗最优结果须依据用户给定标准,而非主观判断哪个数字“最好”;顺带发现的引用问题交给 verify-citations,投稿就绪检查交给 preflight-check,绝不代用户提交。该技能惯例面向 CS 会议,迁移到其他领域需调整 references/captions-crossrefs.md 的图题位置惯例与 scripts/check_floats.py 的家族映射(convention_label),booktabs、尺寸与配色建议与领域无关。