用途
该技能面向需要制作或审查科学图表的场景,目标是在优化外观之前先保留科学含义。它适用于图表设计、多面板布局,以及使用 Matplotlib、Seaborn 或 Plotly 生成可直接用于发表的图表。技能强调区分通用原则与特定出版商的时效性规则,保留原始数据与变换过程,冗余使用颜色,并在交付后检查文件本身而非信任绘图默认值。
主要能力
- 提供不可妥协的护栏:不得为改善图表而篡改、隐藏、编造或选择性增强数据;保留原始表格/图像、排除项、缺失值编码、分析代码、归一化、分箱、图像调整和随机种子;不得推断期刊要求,需确认确切期刊、文章类型、图表类型和提交阶段并核实其现行官方指南;不得声称某个调色板、DPI 值、格式或自动化报告使图表可访问或符合期刊要求;不得静默连接缺失观测、抑制不便的点、将图像上采样伪装为细节增加,或调整坐标轴/双轴以夸大结论;交互式与静态输出应作为不同交付物,交互悬停不能替代标签、替代文本、键盘访问、可访问数据表或静态回退。
- 提供工作流程:定义证据与目标(记录受众与媒介、确切出版商/期刊、文章类型、提交阶段、预期最终宽度、变量语义、单位、样本/重复结构、缺失/删失值、估计量与不确定性定义、变换、源数据路径与输出来源);选择诚实编码(优先使用共同尺度上的位置,检查条形/面积是否包含零、点/线是否可非零、不确定性命名、原始观测展示、缺失数据区分、面积/体积缩放、对数轴标注、分箱/平滑记录、归一化公式、双轴处理、图像处理);内建设计可访问性(颜色加标记、线型、阴影、直接标签或面板分隔;根据数据语义选择定性、顺序、发散或循环颜色;在渲染尺寸下审计前景/背景对比度;明确缺失和超出范围的值;提供替代文本、复杂图表的更长描述和底层数据;将 WCAG 2.2 作为网络指南,正常文本 4.5:1、大文本 3:1、理解所需图形对象 3:1,颜色不能是唯一线索);使用限定样式实现(Matplotlib 面向对象 API 和临时样式上下文,layout="constrained" 支持颜色条、嵌套 GridSpec、子图和 subplot_mosaic,之后不要调用 tight_layout();颜色归一化使用 TwoSlopeNorm、LogNorm、CenteredNorm、SymLogNorm、BoundaryNorm 等;Seaborn 0.13.2 使用当前 errorbar API;Plotly 使用 write_html() 交互和 write_image()/plotly.io.write_images() 静态输出,Kaleido 1.3.0 需要 Chrome/Chromium,当前静态格式为 PNG、JPEG、WebP、SVG、PDF,EPS 仅 Kaleido v0 支持,不要传递已弃用的 engine= 或使用 Orca/plotly.io.kaleido.scope,width、height、scale 控制像素,scale=3 并非固有“300 DPI”,WebGL 轨迹在 PDF/SVG 中嵌入栅格内容,完全离线导出需要本地外部资源);显式导出并记录来源(使用 export_figure,导出器拒绝隐式覆盖、原子写入、为嵌入栅格保留矢量 DPI、使用 TIFF LZW、可使用 PDF/PS Type 42 字体,但不验证科学内容或出版商接受度;可编辑字体方面,PDF/PS Type 42 嵌入 TrueType 字体,svg.fonttype="none" 保持文本可编辑/可搜索但不嵌入字体,svg.fonttype="path" 保留字形外观但丢失可编辑/可搜索文本;除非需要透明度,否则使用不透明显式背景);检查、比较和审查(检查文件元数据、审计调色板对比度/灰度分离、与带日期的出版商快照比较、在最终尺寸下查看、手动审查字体、嵌入栅格、裁剪、图例、比例尺、图像完整性、图注、替代文本和源数据、上传前立即重新检查目标期刊页面)。
- 提供固定快照:示例和冒烟测试使用 2026-07-23 当前的直接包固定版本,通过 uv run --isolated --no-project --python 3.13 配合 matplotlib==3.11.1、seaborn==0.13.2、plotly==6.9.0、kaleido==1.3.0、pillow==12.3.0、pypdf==6.14.2 运行。这是带日期的直接依赖快照,不是传递锁定;精确重放请使用项目的 uv lock;该技能有意不附带依赖锁。
- 提供捆绑 CLI:所有辅助工具都是确定性的、无网络的、有界的,在相关情况下拒绝符号链接输入/目标,除非显式 --force 否则拒绝覆盖。包括:检查栅格/矢量元数据(image_metadata.py,支持 Pillow 栅格、SVG、PDF、EPS/PS,报告尺寸、DPI/有效 DPI、模式、alpha、ICC 存在、压缩、页面大小和保守的第一页 PDF 字体资源,但不检查矢量容器中的每个嵌入栅格);审计调色板对比度和灰度(palette_audit.py,报告精确 WCAG sRGB 对比度以及成对 CIE L* 灰度筛选,灰度阈值是启发式而非标准);规划/筛选出版商导出(export_plan.py,可添加 --input figure.pdf 筛选机器可读属性,配置文件是 2026-07-23 访问的官方来源快照,不是自动合规规则);预览样式(style_preview.py);检查/写入样式和冒烟测试导出(style_presets.py --list/--show,figure_export.py --demo)。
- 提供资产:assets/publication.mplstyle(通用印刷起点)、assets/nature.mplstyle(带日期的旗舰 Nature 视觉起点,不是合规预设)、assets/presentation.mplstyle(更大的投影显示样式)、assets/color_palettes.py(可导入的 Okabe-Ito 和 Paul Tol 值及元数据)、assets/publisher_profiles.json(带日期的机器可读规划快照)。Matplotlib 样式文件省略十六进制颜色中的 #,因为 # 在 .mplstyle 解析中开始注释。
- 提供参考:references/publication_guidelines.md(完整性、欺骗性编码、可访问性、静态/交互输出)、references/color_palettes.md(调色板语义、精确值、WCAG 对比度、灰度注意事项、颜色管理)、references/journal_requirements.md(阶段特定的官方出版商快照)、references/matplotlib_examples.md(当前可运行的 Matplotlib/Seaborn/Plotly 模式)、references/sources.md(官方 URL、日期、版本和研究基础)。
- 提供最终审查清单:原始数据/图像和变换代码已保留;缺失值、排除项、分箱、归一化和不确定性明确;基线、尺度、限制和面积/体积编码诚实;颜色冗余且渲染对比度已审查;图表在适用处有可访问描述/数据替代;导出后检查物理尺寸、DPI、格式、字体、透明度和文件大小;针对确切期刊和阶段验证出版商规则;没有自动化报告被呈现为科学、可访问性或合规认证。
使用方式
通过 uv run --isolated --no-project --python 3.13 配合固定版本包运行示例脚本或捆绑 CLI。例如检查图像元数据:uv run --isolated --no-project --python 3.13 --with "pillow==12.3.0" python scripts/image_metadata.py figure.tiff --format tiff --mode RGB --min-dpi 300 --target-width-mm 85 --alpha-policy forbid。审计调色板:uv run --isolated --no-project --python 3.13 python scripts/palette_audit.py --palette okabe_ito_on_white --background FFFFFF --role graphical。规划导出:uv run --isolated --no-project --python 3.13 python scripts/export_plan.py --publisher nature --figure-type combination --width single --phase final。预览样式:uv run --isolated --no-project --python 3.13 --with "matplotlib==3.11.1" python scripts/style_preview.py --output outputs/style-preview --style default --palette okabe_ito_on_white --formats png,svg。检查样式:uv run --isolated --no-project --python 3.13 python scripts/style_presets.py --list 或 --show nature。冒烟测试导出:uv run --isolated --no-project --python 3.13 --with "matplotlib==3.11.1" python scripts/figure_export.py --demo outputs/export-smoke --manifest。
适用场景
适用于需要制作或审查科学图表的科研人员、数据科学家和出版相关人员,尤其是涉及多面板布局、期刊提交、可访问性要求、颜色语义和来源记录的场景。
限制
该技能不验证科学内容或出版商接受度;自动化报告不构成科学、可访问性或合规认证;灰度屏幕有用但不是完整的色觉或可访问性测试;捆绑 CLI 不检查矢量容器中的每个嵌入栅格;出版商配置文件是带日期的快照,不是自动合规规则;该技能有意不附带依赖锁,精确重放需使用项目的 uv lock。