Paper Comic - 论文漫画生成
将学术论文转化为连贯的教育漫画，用视觉叙事让复杂概念易于理解。
使用方法
/paper-comic /path/to/paper.pdf
/paper-comic /path/to/paper.pdf --style tech
/paper-comic # 然后粘贴论文内容画风选项
| 画风 | 特点 | 适用论文 |
|---|---|---|
| classic | 清线风格，简洁专业，易于理解 | 通用，大多数论文（默认） |
| tech | 科技风，电路元素，霓虹光效 | AI/计算机/工程类 |
| warm | 温暖风，亲和力强，怀旧感 | 心理学/认知科学/教育类 |
| chalk | 粉笔风，黑板效果，学术感 | 数学/物理/理论类 |
输出结构
[output-dir]/
├── outline.md # 大纲和分镜
├── characters/
│ ├── characters.md # 角色定义
│ └── characters.png # 角色参考图
├── prompts/
│ ├── 00-cover.md # 封面 prompt
│ └── XX-page.md # 各页 prompt
├── 00-cover.png # 封面
└── XX-page.png # 各页漫画输出目录：
- 有源文件：
[source-dir]/comic/ - 无源文件：
comic-outputs/YYYY-MM-DD/[topic-slug]/
工作流程
第一步：分析论文
- 读取论文内容（PDF 或 Markdown）
- 提取核心信息：
- 论文标题、作者 - 研究背景和动机 - 核心创新点（1-3 个） - 关键方法/算法 - 主要实验结果
- 根据论文领域自动推荐画风（或使用用户指定）
第二步：设计叙事结构
四段式结构（适合 8-12 页漫画）：
| 阶段 | 页数 | 内容 |
|---|---|---|
| 引入 | 1-2 页 | 问题背景，为什么需要这个研究 |
| 探索 | 2-3 页 | 现有方法的局限，引出创新点 |
| 核心 | 3-5 页 | 详细讲解创新方法，用比喻可视化 |
| 总结 | 1-2 页 | 实验结果，意义和展望 |
第三步：定义角色
创建 characters/characters.md：
必要角色：
- 导师：知识讲解者，睿智亲和
- 学生：代表读者，提问和学习
- 概念化身（可选）：将抽象概念拟人化
角色一致性要求：
- 导师和学生必须出现在 ≥60% 的页面
- 每页明确标注出场角色
- 角色外观在所有页面保持一致
第四步：创建分镜
创建 outline.md，包含：
- 元数据（标题、画风、页数）
- 封面设计
- 每页的分格布局和内容
分镜要求：
- 每页 3-5 个分格
- 标注每格的角色、场景、对话
- 对话全部使用中文
- 公式用图示表达，不写文字公式
第五步：生成图片
使用 baoyu-gemini-web 生成（需要 Google 账号认证）：
# 获取技能安装路径（假设通过 npx skills add 安装）
SKILL_DIR="$HOME/.claude/skills/baoyu-gemini-web"
# 或者如果在其他位置：
# SKILL_DIR="$HOME/.codex/skills/baoyu-gemini-web"
# 生成角色参考图
npx -y bun "$SKILL_DIR/scripts/main.ts" \
--promptfiles references/base-prompt.md characters/characters.md \
--image characters/characters.png \
--sessionId comic-[topic]-[timestamp]
# 生成各页（使用相同 sessionId 保持一致性）
npx -y bun "$SKILL_DIR/scripts/main.ts" \
--promptfiles references/base-prompt.md prompts/XX-page.md \
--image XX-page.png \
--sessionId comic-[topic]-[timestamp]关键：使用相同的 --sessionId 确保角色外观一致。
首次运行：会打开 Chrome 浏览器进行 Google 账号认证，之后 Cookie 会被缓存。
第六步：输出文档
生成 [topic]-paper-comic.md：
# [论文标题] - 漫画解读
## 概览
- **论文**：[标题]
- **画风**：[选择的画风]
- **页数**：[N]
- **生成时间**：[YYYY-MM-DD]
## 漫画页面
### 封面
### 第 1 页
**内容**：[简述本页讲解的内容]
...
## 核心知识点
1. [知识点1]
2. [知识点2]
3. [知识点3]重要原则
文字要求
- 所有对话和旁白必须是中文
- 专业术语：中文 + 英文，如"梯度下降 (Gradient Descent)"
- 文字必须清晰可读，不模糊
公式处理
- 不要用文字写公式
- 用图示/比喻表达公式含义
- 例：梯度下降 → 画小球滚下山坡
画面连贯性
- 角色外观全程一致
- 场景风格统一
- 叙事逻辑清晰递进
参考文件
references/base-prompt.md- 基础 prompt 模板references/styles/classic.md- 清线风格references/styles/tech.md- 科技风格references/styles/warm.md- 温暖风格references/styles/chalk.md- 粉笔风格