| name | paper-to-slides |
| description | 从论文 PDF Workflow：本地 MinerU 提取 Markdown，在 Cursor/Codex 会话内生成 Marp 幻灯（不使用额外 LLM/生图 API），再本地导出 pptx/PDF。Use when the user wants paper-to-slides, paper to PPT, thesis deck, or Marp export without OpenAI/Gemini/OpenRouter keys. |
Paper → Slides（本地工具 + 会话内模型）
Short description: 论文 PDF → Marp（零额外交互 API）。Do not invoke or configure any additional external model API for this workflow.
目标与硬约束
- 产出：可演讲的幻灯片（优先 Marp 源文件 → 导出 PPTX / PDF）。
- 禁止：为本工作流单独购买或配置 OpenAI / Anthropic / Gemini / OpenRouter 等外部推理或生图 API。
允许且推荐：在 Cursor / Codex 已订阅的会话内完成提纲、叙事、逐页文案与 Marp 生成（这不算「再买 API」）。
- 本地解析：PDF → Markdown 使用 MinerU 包装脚本（
.tools/mineru-md.sh）；脚本保存在 vault 内，Python 环境默认保存在本机 ~/Library/Application Support/WorldModelVault/envs/，与 Vault Setup.md 一致。
不要使用 HKUDS/Paper2Slides 等默认依赖云端 Key 的一键工具，除非用户明确说已自行改为全本地后端（本 skill 不展开）。
何时启用
用户在做：组会幻灯、读书报告、论文分享、把项目中的 PDF 变成可讲 deck，且希望 skill 化、可重复、不绑新 API。
推荐目录（可按项目调整）
- MinerU 输出（中间产物）：
3-Projects/<项目>/assets/mineru-out/<论文短名>/ 或 2-Learnings/EmbodiedWorld/assets/mineru-out/<短名>/
- Marp 源文件：
3-Projects/<项目>/decks/YYYY-MM-DD-<论文短名>.md（或同级 decks/ 下）
- 导出 PPTX/PDF：与
.md 同目录的 exports/，避免和 Obsidian 笔记 clutter
若用户已在 3-Projects/.../Paper Cards.md 有 paper card，可优先对齐其中的标题、链接与配图路径。
工作流（Agent 按顺序执行）
-
确认输入
PDF 路径；听众（导师/同门/外行）；时长或页数上限；语言（中文/英文）。
-
本地提取（若尚无可靠 Markdown）
在 vault 根执行：
.tools/mineru-md.sh "/path/to/paper.pdf" "3-Projects/<项目>/assets/mineru-out/<短名>"
在输出目录中找到主 Markdown（以 MinerU 实际结构为准，常为 *.md 或子目录中的 md）。
-
在会话内理解论文
阅读 MinerU md（与必要图片路径）；整理：问题、方法、实验、结论、限制；标出必须在幻灯上出现的图（用相对 Marp 文件的路径或复制/引用到 decks/assets/）。
-
生成 Marp 文稿
新建或更新 decks/...md，包含：
- 顶部 YAML：
marp: true、theme（若用户无偏好用 default 或 gaia）、paginate: true、size: 16:9
- 每页用
--- 分页；标题页、大纲、贡献/方法、实验、结论、备份页（可选）
- 正文以 bullet 为主，避免长段粘贴；数字与主张需可在 md 中溯源
- 图片：
，确保相对 Marp 文件可解析
-
导出（用户本机，Agent 只给命令）
-
质量检查清单（口头提醒用户）
字体是否嵌入、公式是否需截图、图是否模糊、是否需加一句「复现/数据来自原文表 X」。
Marp 最小示例（写入真实文件时按论文替换）
---
marp: true
theme: default
paginate: true
size: 16:9
---
# 论文标题
作者（会议 / arXiv） · 你的名字 · YYYY-MM-DD
---
# 我们在讲什么
- 问题：…
- 挑战：…
---
# 方法概览
- …
---
# 实验与结论
- …
与 llm-wiki / paper card 的关系
- Paper card（
#### 标题块）：适合文献档案与精读笔记。
- 本 skill：面向口述叙事与分页结构，输出 Marp/PPTX。
二者可链接同一批 assets/ 图，但不要互相覆盖「唯一真源」：MinerU md 保持提取层；Marp 保持演讲层。
常见分叉
| 需求 | 做法 |
|---|
| 只要提纲、不要文件 | 仍按步骤 3 输出分页大纲，由用户贴进 Keynote |
| PDF 已是幻灯式逐页 | 考虑矢量保留的 pdf→pptx 工具；本 skill 仍以「论文全文」为主场景 |
| 公式很多 | Marp 有限；建议关键式一行展示，其余放附录页或截图 |
Agent 自检
- 是否避免引导用户配置新的云端 API？
- 是否优先 mineru-md.sh 而非要求用户手抄 PDF？
- Marp 里图片路径是否相对于 md 文件可打开？
- 是否把导出命令写清楚，而不是假设用户已熟悉 Marp？
