用途
paper-comic 的核心用途是「论文方法图解」——把一篇论文的核心方法用视觉图解彻底讲清楚,重点可视化论文到底做了什么、怎么做的。
它只围绕三个对象作图:
- 方法流程:输入→处理→输出,方法到底怎么走。
- 核心机制:最创新的那个部分,拆开来看内部构造。
- 关键结果:只放最重要的实验结果。
它明确不画:相关工作/背景介绍、抽象的「灵感来源」、文字就能说清楚的东西、第 N 个消融实验的柱状图。
主要能力
- 自动分析论文核心方法,提取「可图解内容」:必须图解的是方法整体流程/架构、每个核心创新机制、最有说服力的实验结果;可选图解的是方法变体/扩展、关键数据处理流程、与 baseline 的可视化对比。
- 先推荐生成方案,再向用户确认。默认不直接生成图片:先读论文、给出推荐方案(如建议生成几张、分别是什么),确认范围、张数、语言、风格后再生成。
- 支持两种视觉风格:
- sketchnote(默认):温暖科研笔记风,适合讲清楚论文在做什么、视频宣传、知识分享。
- paper-figure:论文框架图风,适合 README 首屏、论文解读文章、方法总览、技术展示。
- 按论文复杂度推荐页数:封面/传播图 1 页;快速理解 2-3 页;中等(2 个核心方法)4-6 页;复杂(3+ 个核心方法)6-10 页。规则为最少 1 页、最多 10 页,宁少勿多。
- 为每一页写详细内容描述,具体到「箭头从哪到哪、方框里写什么字」,并检查信息密度。
- 自动检测生图后端,不硬编码任何 API。
使用方式
命令行调用示例:
/paper-comic /path/to/paper.pdf
/paper-comic https://arxiv.org/abs/2512.xxxxx
/paper-comic /path/to/paper.pdf --style sketchnote
/paper-comic /path/to/paper.pdf --style paper-figure --language English --pages 1
图片生成后端根据运行环境自动检测:
| 环境 | 自动使用 |
|---|---|
| Codex | 内置 imagegen skill |
| Claude Code | 已安装的生图 skill(如 baoyu-image-gen) |
| Cursor/其他 | 自动检测 → 没有则提示安装 |
不写死任何 API key、token 或 endpoint 在 SKILL.md 里。
生成前必须确认:
只有当用户已明确给出足够完整的生成意图时才可跳过确认,例如「生成一张中文 sketchnote 方法总览图」「生成 4 张:封面、总览、两个机制细节,英文 paper-figure」「按你推荐的全部生成,中文,sketchnote」。若用户只给了论文链接、只说了风格、或只说「生成图解」,仍必须确认,因为风格不等于范围/张数授权。
确认时必须覆盖:
- 图片语言:中文 / English / 双语
- 生成范围:只要封面图、只要方法总览图,还是概述图 + 若干机制细节图 + 结果图
- 推荐张数:基于论文复杂度给出建议并说明原因
- 视觉风格:sketchnote 或 paper-figure
- 用途:README/文章封面/小红书/演示文稿/论文阅读笔记
如果用户没有回答,不要继续生成。
工作流程:Step 1 分析论文 → 提取可图解内容;Step 2 给出推荐并确认需求;Step 3 确定页数;Step 4 为每一页写详细内容描述;Step 5 生成图片(为每页创建 prompt 文件 → 用结构化 prompt 生成);Step 6 输出 [topic]-illustrated.md,包含封面、各页图与讲解以及总结。
适用场景
- 论文阅读笔记与方法讲解
- README 首屏、论文解读文章配图
- 视频宣传、知识分享
- 演示文稿
- 小红书等传播内容
风格规范要点
sketchnote:明亮温暖的浅米白底(接近 #FFF8EA / #FAF4E6),黑色手绘线条与文字,重点用清爽彩铅/马克笔质感强调(深蓝/珊瑚红/橄榄绿/柔和黄色),箭头连线带手绘不完美感,文字为手写体,可加少量服务理解的趣味符号,主体图解占画面 75%-85%,每页右下角有手写页码。不要牛皮纸、旧羊皮纸、暗角、污渍、泛黄边缘或明显做旧纹理。
paper-figure:白底或极浅灰底,干净的矢量感模块(圆角矩形、矩阵小格、流程箭头、分组框、编号步骤),配色克制(黑/深灰为主,1-2 个强调色),结构比原论文图更清楚,标注像论文图注短标签,适合横版 16:9、4:3 或竖版 2:3。
质量标准
好的图解:一眼就知道在讲什么、标注精确简练、流程箭头清晰、关键部分有视觉强调、不看原文也能理解。
差的图解:信息堆砌、文字太多、流程不清晰、画了但没解释、和论文 Figure 1 一模一样。
每一张图的标准:一个完全没读过论文的人,只看这张图 + 图上的标注文字,能不能理解这个机制?能则通过,不能则拆成两张或加更多标注。
限制
- 生成前必须由用户确认范围、张数、语言、风格与用途,未确认不继续生成。
- 页数限制为最少 1 页、最多 10 页。
- 不画相关工作、背景介绍、抽象灵感来源、文字即可说清的内容、多个类似消融实验。
- 生图依赖运行环境已安装的生图能力(如 Codex 内置 imagegen skill、Claude Code 已安装生图 skill),Cursor/其他环境若检测不到会提示安装。
- 不硬编码 API key、token 或 endpoint。
- 收费、价格、平台等信息资料暂未提供。
参考文件
- references/base-prompt.md — 图解生成基础规范(结构、文字、色彩要求)
- references/styles/sketchnote.md — 温暖科研笔记风
- references/styles/paper-figure.md — 论文框架图风