↑

论文配图一键生成v1.0.0

academic-figures515 KB

面向科研论文投稿场景,通过一条命令将 JSON/CSV 数据转换为 40 种出版级统计图表(KM 曲线、森林图、校准曲线、PRISMA 流程图等),支持 9 套期刊配色与 600dpi 多格式输出。用户提及「画个 ROC 曲线」「做 Meta 分析的漏斗图」「投稿 Nature 的图」或需要组合多面板 figure 时触发。

0 0 0 0 更新于 2026-10-28 18:12

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 专为生物医学与生命科学论文配图设计,内置 40 种统计与可视化图表类型,覆盖从基础描述统计到高阶临床研究的完整作图需求。用户只需准备标准 JSON 数据文件,即可通过单条命令输出 600dpi 的 PDF、TIFF、SVG 或 PNG 文件,并自动完成数据校验、色盲安全配色、中文字体检测与像素级重叠验证。图表类型包括 KM 生存曲线(含竞争风险 Aalen-Johansen 模式)、Meta 分析三件套(森林图/漏斗图/Galbraith 径向图)、预测模型六件套(ROC/校准曲线/决策曲线/列线图/RCS/亚组森林图)、PRISMA 流程图、CONSORT 式流程图、肿瘤学瀑布图与游泳图等。组合图功能支持多面板 A+B+C 的期刊标准 figure 布局,配合 --pub-ready 一键生成投稿包。

技能包含

  • SKILL.md:技能主说明(本文件),含触发条件、40 种图表命令速查、校验规则与退出码
  • scripts/gen_figure.py:核心渲染引擎,单命令出图,支持 --wizard 选图向导与 --quick 自动选型
  • scripts/setup_env.py:环境一键准备,含依赖安装、CJK 字体检测与缓存清理
  • scripts/audit_pdf.py:投稿前字号门禁检查
  • examples/:28 个示例文件,涵盖 16 种图型的标准 schema 与 13 个真实世界临床/组学/Meta 分析数据集
  • references/quickstart.md:独立快速入门,含完整选图决策树与上手四步
  • references/cheatsheet.md:全参数速查手册
  • references/limits.md:能力边界与超限行为说明(含看门狗超时/内存降级机制)
  • references/data-formats.md:JSON schema 详解与 CSV/Excel 兼容说明
  • references/composite-layouts.md:多面板组合图拼版规则与 span 跨行跨列用法
  • references/color-guide.md:9 套配色方案(含 Okabe-Ito 色盲安全与 NEJM/Lancet/Science 期刊色板)
  • references/python-api.md:Python 内调用与 subprocess 集成方式
  • references/faq.md / references/pitfalls.md:常见问题与中文环境避坑指南
  • mcp/:MCP 服务器适配代码与端到端测试(server.py、tests/e2e.py 等)
  • .github/workflows/tests.yml:持续集成验证门禁

核心能力

  • 单命令出图:python3 scripts/gen_figure.py -t 图型 -d 数据.json -o 输出 完成渲染,支持 40 种图表类型
  • 投稿级验证:--verify 像素重叠检查(exit 2 即返修)、--pub-ready 自动启用色盲安全主题 + 多格式输出 + 验证门禁
  • 期刊预设直出:--journal nature/lancet/nejm/science/cma/cn-core 锁定官方栏宽、字号、DPI,忽略自定义宽度
  • 中文零配置:--cjk 自动检测数据中文字符并匹配系统 CJK 字体,含生僻字与补充平面支持
  • 统计内建:KM 的 log-rank 与中位生存 CI、forest --stats cox 多因素 Cox 回归与 PH 检验、ROC 的 DeLong 对比、Meta 的 Egger 偏倚检验等
  • 智能防护:18 种 schema 结构校验(致命错误 exit 1 不落盘)、自适应超时看门狗(30~1800s)、内存不足自动降级重试
  • 组合图拼版:-t composite 多面板布局,panel_labels 自动角标,span 跨行跨列,含占位重叠检测

应用场景

用户怎么说本技能做什么
"帮我画一张 KM 生存曲线,要风险表和 log-rank P 值"用 -t km 输出阶梯函数图,自动附加删失标记、风险表、中位生存 95%CI;若 events≥2 编码自动切换 Aalen-Johansen 竞争风险模式
"Meta 分析要森林图加漏斗图,再做个 Egger 检验"分别用 -t forest、-t funnel --egger 生成;Galbraith 径向图 -t galbraith 补充异质性与离群点可视化
"预测模型需要 ROC、校准曲线、决策曲线、列线图"依次用 -t roc、-t calibration、-t dca、-t nomogram 出图;六件套可后期用 -t composite 拼为多面板 figure
"投稿 Nature,图要双栏宽、600dpi、色盲安全"加 --journal nature --verify(或 --pub-ready),自动应用 Nature 栏宽/字号/DPI,锁定色盲安全 Okabe-Ito 配色,输出前通过像素重叠与字号门禁
"数据里有中文分组,之前 matplotlib 乱码"加 --cjk,引擎递归检测数据内中文字符,自动调用系统 CJK 字体;无字体环境运行 setup_env.py 检测并提示安装
"要做亚组森林图,但还没拟合 Cox 模型"用 -t subgroup --stats cox,引擎逐层拟合 Cox 回归(Efron 核),输出 HR+95%CI 与似然比 P 交互,直接可视化
"系统综述的 PRISMA 流程图,数字要对得上"-t prisma 自动校验各阶段数字自洽,对不上拒绝出图;lang=zh 输出中文标准版
"想把 A 图的柱状图和 B 图的箱线图拼成一个 figure"-t composite 定义多面板布局,每面板指定独立图表类型与数据源,panel_labels:true 自动加粗角标,支持 span 跨行跨列