Skip to content
Back to search

literature-report-ppt-builder

Open-source Codex skill for academic literature-report PPT generation

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fangyuanopus--literature-report-ppt-builder/badge.svg)](/listings/fangyuanopus--literature-report-ppt-builder)

HTML

<a href="/listings/fangyuanopus--literature-report-ppt-builder"><img src="/api/listings/fangyuanopus--literature-report-ppt-builder/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Codex

git clone https://github.com/fangyuanopus/literature-report-ppt-builder.git
cp -R literature-report-ppt-builder/skills/academic-slide-pragmatic-fallback \
  ~/.codex/skills/academic-slide-pragmatic-fallback

重启 Codex 会话后即可按自然语言调用。

Claude Code

git clone https://github.com/fangyuanopus/literature-report-ppt-builder.git
mkdir -p ~/.claude/skills
cp -R literature-report-ppt-builder/skills/academic-slide-pragmatic-fallback \
  ~/.claude/skills/academic-slide-pragmatic-fallback

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Literature Report PPT Builder
  2. 把论文主线、真实图源和可讲的结论组织成中文文献汇报 PPT。项目的当前入口是 [academic-slide-pragmatic-fallback](skills/academic-slide-pragmatic-fallback/SKILL.md)。
  3. [English](docs/README.en.md) | 中文
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  5. [![Codex Skill](https://img.shields.io/badge/Codex-Skill-blue)](skills/academic-slide-pragmatic-fallback/SKILL.md)
  6. [![Template](https://img.shields.io/badge/template-editable_PPTX-orange)](skills/academic-slide-pragmatic-fallback/assets/sample-literature-report.pptx)
  7. 核心原则:**真实证据优先;明确交付路线;不把代码输出冒充成 Image2,也不把 Image2 输出冒充成可编辑模板。**
  8. ## 先分析论文,再生成页面
  9. 这个 skill 不是把 PDF 摘要直接塞进模板。完整任务先生成并校验 `paper_analysis.json`,把论文理解变成后续页面规划必须遵守的证据契约:
  10. ```text
  11. 论文主文 + SI
  12. → 逻辑树(对象、问题、策略、方法、结论、局限)
  13. → 图表记录(直接观察到什么、不能单独证明什么)
  14. → 证据链(问题 → 图表 → 解释 → 页面结论)
  15. → 导航与逐页计划
  16. → Route A / B / C 生成与验收
  17. ```
  18. 契约要求每张证据页回溯到真实图表和证据链;每张图必须有来源文件、页码、图/表编号、直接观察和证据边界。这样可以避免“图很好看但不支持标题”、把推测机制说成结论,或在改版时悄悄改变论证顺序。
  19. ```bash
  20. python skills/academic-slide-pragmatic-fallback/scripts/validate_paper_analysis.py \
  21. paper_analysis.json --out paper_analysis_validation.json --fail-on-review
  22. ```
  23. 可直接参考 [分析契约](skills/academic-slide-pragmatic-fallback/references/paper-analysis-contract.md) 和 [可验证示例](skills/academic-slide-pragmatic-fallback/references/paper-analysis.example.json)。
  24. ## 先选交付路线
  25. | 路线 | 产物与定位 | 是否可编辑 | 适用条件 |
  26. | --- | --- | --- | --- |
  27. | A. GPT-image-2 / Image2 全页路线 | 每页为已验收的整页图像,再封装进 PPTX;视觉自由度最高 | 页面内容通常不可逐对象编辑 | 已确认可用的全页 Image2 后端,并能忠实保留论文图裁图 |
  28. | B. 精确模板代码路线 | 直接继承内置 PPT 模板的母版、导航、页脚和文本/图片槽位,替换为当前论文内容 | 是 | 用户明确要求复刻内置模板,并接受固定导航语义 |
  29. | C. 实用代码 fallback | 从空白页按内置红黑灰风格生成可编辑页面 | 是 | 没有可用 Image2,也没有适合继承的干净模板 |
  30. 三条路线都只允许使用论文主文、SI 或用户提供的科学图。不会生成、重绘或语义篡改实验数据图、谱图、显微图、结构图、表格或机理图。
  31. ## 两组示例,分别代表两条路线
  32. ### GPT-image-2 / Image2 全页视觉示例
  33. 以下四页是此前用 GPT-image-2 / Image2-style 全页路线制作的视觉示例。它们用于展示整页图像式交付的视觉上限;不代表代码模板输出,也不承诺对象级编辑。
  34. ![Image2 示例封面](docs/images/demo-slide-01-title.jpg)
  35. ![Image2 示例证据页](docs/images/demo-slide-02-evidence.jpg)
  36. ![Image2 示例对比页](docs/images/demo-slide-03-comparison.jpg)
  37. ![Image2 示例总结页](docs/images/demo-slide-04-summary.jpg)
  38. ### 代码生成:精确继承模板的可编辑示例
  39. 以下页面来自本仓库当前代码路线的真实运行:以油茶籽油水酶法论文图为输入,继承内置模板对象,替换文本、真实图表与图注,并通过构建、结构和模板保真三项审计。它不是 GPT-image-2 输出。
  40. ![代码路线六页总览](docs/images/demo-code-template-overview.png)
  41. ![代码路线:模板继承 + 真实柱状图](docs/images/demo-code-template-evidence.png)
  42. ![代码路线:完整响应面图 + 继承段落强调](docs/images/demo-code-template-response-surface.png)
  43. 这组截图展示的是代码能力边界:模板的导航、标题、边距、页脚、段落和红色强调 run 来自原 PPT;论文图来自原始 PDF 的确定性裁取。为避免把论文图源作为仓库素材再分发,仓库保留预览图而不打包这份测试论文的完整 PPTX。
  44. ## 代码路线可以稳定完成什么
  45. 在当前内置模板和真实图源齐备的前提下,代码路线可以稳定完成:
  46. - 选择并重排不同的模板源页,保留对应的母版、导航、标题、页脚和留白节奏;
  47. - 原位替换文本、图注、图片和多段正文,保留原段落与黑色/红色强调 run 的样式;
  48. - 对论文 PDF 图进行确定性渲染、裁边、等比放置和可读性检查;
  49. - 清理被替换图片的旧关系、旧演讲者备注、旧分节、未使用母版/版式及旧文档元数据;
  50. - 生成可编辑 PPTX,并执行构建报告、结构审计、模板保真审计和逐页预览。
  51. 当前不承诺或主动拒绝:
  52. - 在没有模板的情况下,靠坐标代码像素级复刻任意未知 PPT;
  53. - 复制同一模板源页来无限扩展页数(当前稳定实现要求每页映射不同的源页);
  54. - 把用户任意复杂 PPT、锁定对象或未知母版自动改造成精确模板;
  55. - 生成、补全或重绘科学数据图;
  56. - 把 Image2 的整页位图交付说成对象级可编辑 PPT。
  57. Route C 可以稳定生成干净、可编辑的红黑灰学术页面,但它只遵循样例的视觉语法,不应称为“精确复刻模板”。
  58. ## 怎么调用
  59. ### 默认:让 skill 自己选择路线
  60. ```text
  61. 使用 academic-slide-pragmatic-fallback,把这篇论文和 SI 制作成中文文献汇报 PPT。
  62. 只使用真实论文图;先建立并校验 paper_analysis.json,再从其中导出证据链、导航和页面顺序;若 Image2 不可用,先征得我同意再选择模板代码路线或实用代码 fallback。
  63. ```
  64. ### 要求 GPT-image-2 / Image2 整页交付
  65. ```text
  66. 使用 academic-slide-pragmatic-fallback,并使用已确认可用的 GPT-image-2 / Image2 全页后端生成 PPT。
  67. 每页保留真实论文图裁图,输出 image2_manifest.json 和 image-only 验证结果。
  68. ```
  69. ### 要求复刻内置模板并保持可编辑
  70. ```text
  71. 使用 academic-slide-pragmatic-fallback 的精确模板代码路线。
  72. 按内置 sample-literature-report.pptx 继承对象生成可编辑 PPT;替换所有旧论文内容;使用真实论文图;完成结构审计、模板保真审计和逐页预览。
  73. ```
  74. ## 精确模板代码路线的质量门槛
  75. 精确模板模式必须同时满足:
  76. 1. `build_fallback_template_pptx.py --strict --fail-on-warnings` 通过;
  77. 2. `audit_fallback_template_pptx.py --check-masters --exact-template --fail-on-review` 通过;
  78. 3. `audit_exact_template_fidelity.py --plan ... --build-report ... --fail-on-review` 通过;
  79. 4. 每页渲染预览与源模板对照,确认导航、标题、边距、页脚、图框和留白没有漂移;
  80. 5. PPTX 内没有旧论文图片、备注、分节、未使用母版/版式、重复 ZIP 部件或过期文档元数据。
  81. ## 安装
  82. ### Codex
  83. ```bash
  84. git clone https://github.com/fangyuanopus/literature-report-ppt-builder.git
  85. cp -R literature-report-ppt-builder/skills/academic-slide-pragmatic-fallback \
  86. ~/.codex/skills/academic-slide-pragmatic-fallback
  87. ```
  88. 重启 Codex 会话后即可按自然语言调用。
  89. ### Claude Code
  90. ```bash
  91. git clone https://github.com/fangyuanopus/literature-report-ppt-builder.git
  92. mkdir -p ~/.claude/skills
  93. cp -R literature-report-ppt-builder/skills/academic-slide-pragmatic-fallback \
  94. ~/.claude/skills/academic-slide-pragmatic-fallback
  95. ```
  96. ## 输出与可追溯性
  97. 复杂任务至少维护以下文件:
  98. ```text
  99. deck_order_map.md
  100. paper_analysis.json
  101. paper_analysis_validation.json
  102. figure_source_manifest.md
  103. page_briefs.md
  104. fallback_edit_plan.json
  105. prepared_figure_manifest.json
  106. fallback_build_report.json
  107. structural_audit.json
  108. fidelity_audit.json
  109. rendered_slides/
  110. contact_sheet.png
  111. final_presentation.pptx
  112. ```
  113. Image2 路线还需要 `image2_manifest.json`;代码路线则需要模板槽位清单、构建报告与两类审计报告。不要混用这两组验证声明。
  114. ## 仓库结构
  115. ```text
  116. skills/
  117. academic-slide-pragmatic-fallback/ # 当前维护的入口:Image2、精确模板与实用代码 fallback
  118. SKILL.md
  119. assets/sample-literature-report.pptx
  120. scripts/
  121. validate_paper_analysis.py # 校验论文逻辑、图表、证据链和页面计划的引用关系
  122. build_fallback_template_pptx.py
  123. audit_fallback_template_pptx.py
  124. audit_exact_template_fidelity.py
  125. build_pragmatic_fallback_pptx.py
  126. docs/
  127. images/
  128. demo-slide-*.jpg # GPT-image-2 / Image2 全页视觉示例
  129. demo-code-template-*.png # 代码生成、模板继承示例
  130. academic-slide-minimalist/ # 兼容性保留的旧入口;不再代表当前代码路线
  131. ```
  132. ## 致谢
  133. - [JuneYaooo/gpt-image2-ppt-skills](https://github.com/JuneYaooo/gpt-image2-ppt-skills)
  134. - [LINUX DO](https://linux.do/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.