技能版本 1.0.0

论文配图一键生成

论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。24 种图表(柱状/分组柱/散点/热力图/森林图/斜率图/火山图/ KM 生存曲线/ROC/小提琴/箱线/组合图/PRISMA 流程图/漏斗/BA 一致性/PCA/ 韦恩 2~4 集合/聚类热图/双轴/Cox 多因素回归森林图),9 套配色(含色盲安全 Okabe-Ito 与 NEJM/Lancet/Science 期刊 色板),9 种期刊投稿预设,YAML 流水线一条命令出全套论文图,一次渲染多格式 导出(TIFF/PNG/PDF),支持 Python 编程调用与 --wizard 选图向导,渲染看门狗 +自动降级重试,PDF 重叠+字号双门禁,600dpi 输出。纯本地运行,数据不出机, 中文零配置。

价格

免费

  • 安装:免费

在组织开通时一次性收取;再次读取清单或下载不重复收费。

以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。

如何使用

  1. 为组织安装

    开通即安装:组织固定使用开通时的版本(当前为 1.0.0)。升级到新版本需要取消后重新开通。

  2. 创建凭证

    客户端使用组织凭证读取;绑定到数字人后,数字人使用绑定凭证按需加载。请求中携带:

    Authorization: Bearer $ZGI_MARKET_KEY

  3. 读取清单与安装包

    清单列出版本、文件和校验值;安装包是一个 zip 文件。

    读取清单
    curl "https://market-api.zgi.im/v1/market/skills/academic-figures/manifest" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY"
    下载安装包
    curl "https://market-api.zgi.im/v1/market/skills/academic-figures/package" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY" \
      -o academic-figures.zip

    读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称
academic-figures
说明
论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。24 种图表(柱状/分组柱/散点/热力图/森林图/斜率图/火山图/ KM 生存曲线/ROC/小提琴/箱线/组合图/PRISMA 流程图/漏斗/BA 一致性/PCA/ 韦恩 2~4 集合/聚类热图/双轴/Cox 多因素回归森林图),9 套配色(含色盲安全 Okabe-Ito 与 NEJM/Lancet/Science 期刊 色板),9 种期刊投稿预设,YAML 流水线一条命令出全套论文图,一次渲染多格式 导出(TIFF/PNG/PDF),支持 Python 编程调用与 --wizard 选图向导,渲染看门狗 +自动降级重试,PDF 重叠+字号双门禁,600dpi 输出。纯本地运行,数据不出机, 中文零配置。
适用场景
用户要画图/出图/生成图表时使用:柱状图、散点图、热力图、森林图、KM 生存 曲线、ROC 曲线、小提琴图、箱线图、组合图、流程图、PRISMA 系统综述、Meta 漏斗图、韦恩/欧拉图、PCA 得分图、Bland-Altman 一致性;需要论文/期刊/SCI 配图导出(600dpi、色盲安全);或把数据文件转成学术图表。
会运行代码PythonShell

技能包内含脚本文件,加载技能的运行时可能会执行它们,安装前请先阅读。

SKILL.md 节选

<!--
═══════════ 元数据归档(2026-09-13 frontmatter 规范化)═══════════
ZCode 技能自动发现只识别 frontmatter 白名单键:
  name / description / when_to_use / license / metadata
且 description 超过 1024 字符会被静默丢弃(本技能 v2.x 自动发现
失效根因)。以下键自 frontmatter 移出归档,信息不丢失:
  version: 4.5.0
  date: 2026-10-07
  author: docsor1212
  lang: zh
  metadata: {clawdbot: {emoji: "📊", category: visualization}}
  requires: {python: ">=3.8", pip: [matplotlib, numpy, pymupdf, scipy]}
运行依赖见 requirements.txt 与 scripts/setup_env.py;版本史见文末版本历史。
═════════════════════════════════════════════════════════════════
-->

# Academic Figures — 论文配图一键生成工具

> 📊 **24种图表 · 9套配色(含色盲安全+期刊色板) · 零配置中文 · 600dpi出版级输出 · PDF/TIFF/SVG全支持 · 渲染看门狗+中文诊断**
> 纯本地运行 · 数据不出本机 · Python一条命令搞定 · 内置校验+验证门禁

> ⚡ **三条最常用边界**:投稿 PDF 加 `--verify`(仅 PDF 生效);`--journal` 会锁定图宽(`--width` 被忽略);cluster_heatmap >3000 行自动降采样到 2000 行。

**一条命令,输出即验证:**
```bash
python3 scripts/gen_figure.py -t bar -d data.json -o fig.pdf --theme okabe-ito --verify
# 或一键投稿包(自动加 --verify + 色盲安全主题 + pdf,png 多格式,v3.8)
python3 scripts/gen_figure.py -t bar -d data.json -o fig --pub-ready
# 退出码含义见下方「数据校验与退出码」;--verify 检出重叠 = exit 2(修复机制,不要交付)
```

## ✨ 核心亮点

| 特性 | 说明 |
|------|------|
| 📊 **24种图表** | 见下方「图表类型」全表;v4.2 加 slope 斜率图,v4.4 加 volcano 火山图(组学差异表达) |
| 🎨 **9套配色** | **Okabe-Ito色盲安全**(Nature Methods 金标准)、GLM 素雅莫兰迪、NEJM/Lancet/Science 期刊色板等 |
| 📐 **期刊预设** | `--journal nature/lancet/nejm/science/cma/cn-core`:官方栏宽、字号、字体族、600dpi 一键应用 |
| 🧭 **上手向导** | `--wizard` 四问生成完整命令(非交互环境自动打印选图决策树) |
| 🛡️ **数据校验** | 18种类型/别名全覆盖的结构校验;致命错误→exit 1 不落盘,警告→继续运行 |
| ⏱️ **渲染看门狗** | 超时强制中断并给中文建议(exit 5);内存不足自动降级重试(v2.8) |
| ✅ **验证门禁** | `--verify` 像素级重叠检查(exit 2);`audit_pdf.py` 字号门禁(期刊最小字号) |
| 🇨🇳 **中文零配置** | 自动检测中文字体(含字典键、补充平面),彻底告别乱码 |
| 📈 **统计标注** | 误差棒、显著性标记(p值星号)、趋势线、置信区间、Cox PH 假设检验提示 |
| 🧩 **组合图** | 多面板A+B+C,每个面板可放任意图表类型,期刊figure标准布局 |
| 📄 **多格式输出** | PNG 600dpi + SVG + PDF + TIFF + EPS;`--multi-format` 一次多格式 |

## 图表类型

| 类别 | 类型 | 命令 | 核心功能 |
|------|------|------|---------|
| 比较 | 柱状图 | `-t bar` | 分组柱状图、误差棒、显著性标记、斜纹填充 |
| 比较 | 水平柱状图 | `-t hbar` | 横向柱状图、比率标注("4.96x") |
| 比较 | 分组柱状图 | `-t grouped_bar` | 组×系列双变量分组;`--show-ratio` 组间比率标注 |
| 构成 | 堆叠柱状图 | `-t stacked_bar` | 构成比、百分比标签、总计标注 |
| 分布 | 箱线图 | `-t box` | 箱线图+抖动散点 |
| 分布 | 小提琴图 | `-t violin` | 密度估计、内置均值/中位线 |
| 配对 | 前后配对图 | `-t paired` | 个体前后连线+配对检验(n≥6 才标注,效力提示) |
| 趋势 | 散点图 | `-t scatter` | 趋势线、相关系数、分组着色、点标签 |

SKILL.md 不止这些内容,安装后可阅读全文。

技能包内容

共 82 个文件,合计 818.1 KiB

  • README.md3.9 KiB
  • SKILL.md23.7 KiB
  • _meta.json109 B
  • examples/README.md1.7 KiB
  • examples/example_bar.json184 B
  • examples/example_box.json177 B
  • examples/example_composite.json291 B
  • examples/example_diagram.json397 B
  • examples/example_dual.json149 B
  • examples/example_forest.json381 B
  • examples/example_heatmap.json425 B
  • examples/example_km.json190 B
  • examples/example_line.json269 B
  • examples/example_prisma.json268 B
  • examples/example_roc.json280 B
  • examples/example_scatter.json206 B
  • examples/example_stacked.json184 B
  • mcp/MCP_SUBMISSION.md1.7 KiB
  • mcp/README.md2.3 KiB
  • mcp/pyproject.toml716 B
  • mcp/server.py13.7 KiB
  • mcp/sync_engine.sh1.5 KiB
  • references/advanced.md6.7 KiB
  • references/changelog.md60.5 KiB
  • references/cheatsheet.md4.7 KiB
  • references/clinical-lab-trends.md3.9 KiB
  • references/composite-layouts.md4.8 KiB
  • references/data-formats.md16.7 KiB
  • references/faq.md10.9 KiB
  • references/limits.md8.4 KiB
  • references/pitfalls.md14.5 KiB
  • references/python-api.md5.4 KiB
  • references/quickstart.md4.2 KiB
  • references/reverse-engineering-colors.md3.0 KiB
  • references/v1.5-upgrade-analysis.md4.4 KiB
  • scripts/af_diagnostics.py9.8 KiB
  • scripts/af_draw.py109.8 KiB
  • scripts/af_shared.py3.3 KiB
  • scripts/af_v23_charts.py65.5 KiB
  • scripts/af_v23_stats.py32.8 KiB
  • scripts/af_wizard.py5.0 KiB
  • scripts/audit_pdf.py2.6 KiB
  • scripts/detect_cjk_font.py1.8 KiB
  • scripts/gen_figure.py164.2 KiB
  • scripts/gen_legend.py8.9 KiB
  • scripts/journal/cell.json140 B
  • scripts/journal/cma.json163 B
  • scripts/journal/cn-core.json163 B
  • scripts/journal/ieee.json150 B
  • scripts/journal/jama.json140 B
  • scripts/journal/lancet.json140 B
  • scripts/journal/nature.json144 B
  • scripts/journal/nejm.json144 B
  • scripts/journal/science.json144 B
  • scripts/setup_env.py3.1 KiB
  • scripts/verify_overlap_pixel.py7.4 KiB
  • templates/01-meta-forest.json1.3 KiB
  • templates/02-rct-baseline-bar.json903 B
  • templates/03-survival-km.json1.2 KiB
  • templates/04-diagnostic-roc.json944 B
  • templates/05-correlation-heatmap.json797 B
  • templates/06-prisma-review.json784 B
  • templates/07-dose-response-line.json753 B
  • templates/08-panel-composite.json1.5 KiB
  • templates/09-survey-stacked.json809 B
  • templates/10-cn-journal-hbar.json918 B
  • templates/11-rct-grouped-bar.json975 B
  • templates/12-dose-response-scatter.json880 B
  • templates/13-qol-box.json917 B
  • templates/14-cytokine-violin.json903 B
  • templates/15-lab-trend-dual-axis.json800 B
  • templates/16-study-design-diagram.json1.4 KiB
  • templates/README.md2.6 KiB
  • templates/bland_altman.json469 B
  • templates/cluster_heatmap.json766 B
  • templates/funnel.json738 B
  • templates/paired.json403 B
  • templates/pca.json1.0 KiB
  • templates/slope.json563 B
  • templates/venn.json823 B
  • templates/volcano.json734 B
  • tests/run_tests.py178.3 KiB

来源与审核

审核状态
尚未审核,内容来自上游来源
许可证
未说明

审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。