mcpField
S
sci-html

sci-html

github.com/shzhao27208文档处理213182 次安装11 周前更新
代码仓库

关于 sci-html

sci-html 是 Aut_Sci_Write 套件中用于制作浏览器学术演示文稿的 Skill，面向需要分享 HTML 幻灯片的研究者。它可从 Markdown、JSON 或论文 PDF 生成包含图表资源的目录式演示文稿。

主要功能

  1. 01从 Markdown 或 JSON 生成幻灯片
  2. 02从 PDF 提取内容并制作演示文稿
  3. 03输出含本地图片资源的 HTML 目录
  4. 04支持键盘、鼠标和全屏导航

适用场景

  1. 01将论文 PDF 转为浏览器演示文稿
  2. 02把 Markdown 内容整理成学术幻灯片

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shzhao27208/aut_sci_write --skill sci-html

安装后在 Claude Code 中输入/sci-html确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_meta.json
.gitignore
conftest.py
LICENSE
pyproject.toml
README.md
requirements.txt
archives/
.keep
examples/
sample_outline.md
sample_slides.md
uconversion_review.md
scripts/
generate_html_deck.py
src/sci_html/
__init__.py
cli.py
models.py
paper_pipeline.py
parser.py
renderer.py
src/sci_html/integrations/
__init__.py
src/sci_html/integrations/extract/
__init__.py
core_insights.py
SKILL.sci-extract.md
templates/
deck.js
index.html.j2
tests/
_path.py
test_paper_pipeline.py
test_parser.py
test_renderer.py
themes/
academic-blue.css
journal-dark.css

详细介绍

Sci HTML

使用此技能可在 Aut_Sci_Write 套件中创建基于浏览器的学术幻灯片。它可以使用准备好的 Markdown/JSON，也可以从 PDF 开始，完成从论文到结构化洞见、提取图表和 HTML 幻灯片的完整工作流。

需要可分享的浏览器输出时，使用 sci-html。用户需要真正的 .pptx 文件时，使用 sci-ppt。用户只想要文本分析、不需要演示文稿时，使用 sci-extract。

适用场景

当用户需要 HTML 幻灯片、可点击的演示网页、基于浏览器的学术演示文稿、Markdown 转幻灯片、论文摘要转网页演示文稿、PDF 论文转 HTML 报告，或带左右导航的 PPT 风格 HTML 文件时，使用此技能。

输出

始终创建一个幻灯片目录，其中包含 index.html、deck.json、assets/style.css、assets/deck.js，以及复制到 assets/figures/ 下的本地图表。

不要创建单文件 HTML。目录形式是标准模式，因为它便于维护演示文稿，也能避免嵌入的资源过大。

工作流

  1. 将用户的源内容解析为幻灯片模型。
  2. 视需要添加封面、目录、章节、总结和结束页。
  3. 验证图片路径和幻灯片结构。
  4. 渲染 HTML、CSS 和 JS。
  5. 告知用户输出路径和导航控件。

PDF 论文工作流

对于源 PDF，使用集成的 paper 命令，而不是要求单独使用 sci-extract 或 sci-figure 技能：

python scripts/generate_html_deck.py paper paper.pdf -o out/paper-report --author "Presenter"

在 Aut_Sci_Write 仓库根目录下工作时，运行：

python skills/sci-html/scripts/generate_html_deck.py paper paper.pdf -o skills/sci-html/out/paper-report --author "Presenter"

此命令会生成 structured_insights.json、figure_manifest.json、figures/ 下的提取文件、生成的 {paper-stem}-deck.md，以及最终的 index.html。

PDF 工作流使用从 sci-extract 和 sci-figure 复制而来的内置集成。它需要 PyMuPDF、pdfplumber、numpy、opencv-python、Pillow 和 pytesseract；Tesseract OCR 为可选项，仅影响子图 OCR。

集成的 sci-extract 逻辑会识别原始研究与综述文献。原始研究幻灯片侧重于问题、方法、结果、创新、应用和局限。综述、调查、系统综述、范围综述和荟萃分析幻灯片侧重于范围、分类体系、证据基础、共识、争议、证据质量、研究空白、未来方向以及重要图表。用户希望覆盖自动路由结果时，使用 --paper-type auto|research|review。

演示文稿标记语法

  • 在 Markdown 幻灯片块顶部添加 layout: section，即可创建章节分隔页。
  • 在 layout: section 下方添加 subtitle: 01，即可显示章节编号。
  • 使用 **key phrase** 或 ==key phrase== 添加红色强调。
  • 项目符号应简洁；生成的项目符号幻灯片默认使用带编号的要点卡片。
  • 幻灯片只有一到两条内容项目符号时，将其渲染为不带可见编号的普通陈述。
  • 幻灯片标题和论文标题过长时，会自动缩小标题并加宽其行宽，使标题保持在页面内。
  • 稀疏的幻灯片会根据标题和项目符号中的关键词自动添加含蓄的主题装饰，以填补空白区域，无需额外图片资源。

导航控件

生成的幻灯片支持鼠标点击、点击左侧三分之一区域切换到上一张、明确的“上一张”/“下一张”按钮、左右方向键、空格键、Home/End、F 全屏，以及 #/3 之类的 URL 哈希状态。

设计规则

幻灯片应保持学术性、易读，并适合演示。避免长段落。优先使用图表、简洁的编号要点、章节分隔和鲜明的层级。使用装饰性但不喧宾夺主的视觉图案来减少空白。章节页和结束页应居中。默认转义用户提供的 HTML。不要将 API 密钥或 .env 值写入生成的幻灯片。

Aut_Sci_Write 集成

  • sci-html 是该套件的输出技能之一，与 sci-ppt 并列。
  • 论文工作流会在本地复用 Aut_Sci_Write 的提取和图表处理逻辑，因此用户无需在生成演示文稿前手动串联 sci-extract 和 sci-figure。
  • 请将生成的演示文稿保存在 out/ 或用户选择的其他输出文件夹中。根据仓库和软件包的规则，这些输出会被有意忽略。
  • 请勿为此技能创建或要求使用技能本地的 .env 文件；除用户自行安装的可选依赖项外，该技能可离线运行。

评论

支持 Markdown