# Weekly Literature Report

> 按用户沉淀的周报文献汇报模板，把论文 PDF 一键生成可直接使用的文献汇报 PPTX（封面 Weekly Report + Yifan Wu + 下一个周六日期、Literature Report 分隔页、每篇文献的论文首页截图页与逐图讲解页、图注随图裁剪、编号自动核对修正、中文微软雅黑/西文 Arial 18pt 1.5 倍行距、无备注）。Use when the user asks to 做文献汇报/文献汇报 PPT/周报文献部分/把论文做成 PPT（journal club、组会、论文分享），or provides a paper PDF and wants a deck in this exact weekly-report style.

- Skill: `octgoat/weekly-literature-report` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add octgoat/weekly-literature-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/octgoat/weekly-literature-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: OctGoat (https://skillmd.com/u/octgoat)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/octgoat/weekly-literature-report

---


# Weekly Literature Report

把一个或多个论文 PDF 转成用户的周报文献汇报 PPTX。样式基准 = 用户认可的“完美版”文献汇报（`assets/base-template.pptx` 提供版式）。

## Workflow

1. **提取论文素材**
   ```bash
   python scripts/extract_paper.py --pdf paper.pdf --out work/paper \
     --poppler-prefix <pdftoppm 所在目录，可省略>
   ```
   产出 `work/paper/paper.json`、`title.png`、`fig_<N>_caption.png`（图＋原文图注整块裁剪；预印本编号与正文引用不一致时自动按顺序修正并重绘标签）。
2. **撰写中文内容**（无脑模式：由 Codex 依据 paper.json 的图注与论文正文自动撰写）
   - 编辑 `work/paper/papers.json`（manifest）：每篇文献的中文标题、论文首页页标题、每张图的幻灯片标题与 2–4 条中文描述、可选标记。
   - 字段与写法见 `references/workflow.md`；风格规则见 `references/style.md`。
3. **生成 PPTX**
   ```bash
   node scripts/build_deck.mjs --template assets/base-template.pptx \
     --manifest work/paper/papers.json --assets-dir work/paper --out deck.pptx \
     [--date MM/DD/YYYY]
   ```
   未传 `--date` 时自动取北京时间下一个周六。
4. **QA（必须做）**
   - 用 presentations 技能的渲染工具逐页渲染：无越界、无重叠、标题不换行、文字不超框。
   - 检查：正文 18pt/1.5 倍行距、中西文字体（微软雅黑/Arial）、无空占位符、无备注、页码顺序（结果页可按需隐藏）。
   - 检查每页图注编号与正文引用一致。
5. **交付**：只输出最终 .pptx；中间文件留在工作目录。

## 核心规则（速查）

- 封面：标题 `Weekly Report`（72pt 白字），副标题 `Yifan Wu\nMM/DD/YYYY`（下一个周六，北京时间）。
- 分隔页：`Literature Report`，下方留白。
- 每篇文献：论文首页页（中文主题标题 + PDF 标题区截图 + 底部引用行）＋ 若干图页（左侧图＋图注裁剪、右侧中文描述）。
- 引用行：`期刊缩写, 年份, 卷号, 页码`，期刊缩写与卷号斜体、年份加粗、18pt Arial、居中。
- 编号：按论文正文引用顺序修正预印本图注错误；图注必须随图一起裁进图片。
- 字体：中文微软雅黑、西文 Arial；正文 18pt、1.5 倍行距；内容页标题 48pt、分隔页 80pt。
- 标记：仅当有助于讲解时加（如示意重点、装配接头、结果峰）：红 `#E53935` 或蓝 `#1E5AA8`、1.5pt、无填充椭圆/矩形。
- 默认不生成任何演讲备注。

详细规范见 `references/style.md`；脚本输入输出与清单 schema 见 `references/workflow.md`。