SciDiagram PPTX｜科研图示原生复现

把科研框架图、机制图和流程图，重建为真正可编辑的 PowerPoint 形状、文字、连接线与可替换局部图片。

研究框架 · 技术路线 · 机制模型 · 算法流程 · 学术图示

案例 · 安装 · 使用 · 适用边界 · English

真实案例

预览均由对应的 editable.pptx 实际渲染。每个案例同时提供参考原图、单页可编辑 PPTX 与实际执行的 build.mjs。

六个案例均按 Skill 的标准三件套公开；其中局部照片、实验结果或模型截图以独立、可替换的图片对象保留，不用整页截图冒充编辑性。

安装

在 Codex 中输入：

请使用 $skill-installer 安装：
https://github.com/SciToolsmith/sci-diagram-pptx/tree/main/skills/sci-diagram-pptx

安装后可用 $sci-diagram-pptx 显式调用。如果没有立即出现，请重启 Codex。

使用

上传参考图后，直接提出目标：

$sci-diagram-pptx 把这张科研流程图忠实重建为原生可编辑 PPTX，
保留文字、公式、层级和连线关系，不要重新设计。

同一个 Skill 提供三条清晰路径：

目标	说法示例	结果
重建	“把这张图复刻成原生可编辑 PPTX”	原图、单页 PPTX、实际执行的 `build.mjs`
修复	“修复这个 PPTX 的第 3 页，其他页面不变”	新 PPTX、`build.mjs` 与重新执行修复所需的最少输入依赖
检查	“只检查这个 PPTX 的第 3 页，不要修改”	只返回诊断，不创建交付文件夹

多页文件应明确目标页；多个目标页会逐页深检，不默认把整个 deck 当作反复优化任务。Codex 桌面优先使用内置 Presentations / Artifact Tool；宿主配置完整依赖后，Linux 服务也可固定使用 PptxGenJS。一次任务只使用一个后端，不在生成途中切换。

便携路线要求 Node.js 20+、PptxGenJS 4.0.x、Python 3.10+、LibreOffice 和 pdftoppm。当前阶段用于标准形状、文字、连线和局部图片的 Reconstruction，不宣称能导入并保留现有多页 PPTX。以下命令以 Ubuntu/Debian 和仓库根目录为例：

sudo apt-get update
sudo apt-get install -y --no-install-recommends \
  libreoffice-impress poppler-utils fonts-noto-cjk fonts-noto-core fonts-liberation
python3 -m pip install -r requirements-ci.txt
npm ci --ignore-scripts --no-audit --no-fund
SCI_DIAGRAM_RUNTIME=pptxgenjs \
  node skills/sci-diagram-pptx/scripts/probe_runtime.mjs \
    --runtime pptxgenjs --task-dir "$PWD"
python3 -B tests/test_portable_runtime.py

$skill-installer 只安装 Skill，不替宿主安装上述系统或 Node 依赖。生产宿主应在用户任务开始前固定依赖，并把实际任务目录传给 --task-dir 复检；把生成的 build.mjs 视为不受信任的任务代码，在隔离目录中关闭网络并限制进程、时间、内存和文件系统访问，不向任务暴露服务凭据。

适用边界

适合	不适合
研究框架图、理论框架与技术路线	柱状图、折线图、散点图、热图等数据图
科研流程图、机制图与算法流程图	以照片、显微图或实验图像本身为主要交付内容
科研系统结构图、概念模型	普通商业组织图、海报或自由创意设计
含数学符号或公式的学术图示	以坐标轴、尺度和数据几何承载证据的图件
带局部照片、实验结果或模型截图的混合框架图	需要凭低清截图重造关键数据、曲线或实验细节的任务
已有科研图示 PPTX 的结构修复	翻译、论文写作或统计分析本身

一个简单判断：含义主要由节点、标签与连接关系承载，用本 Skill；含义主要由坐标轴、尺度与数据承载，用 SciPlot。

交付原则

常规重建交付一个职责清晰的文件夹：

<图名>_editable/
├── source.<原扩展名>  # 用户上传原图的逐字节副本
├── editable.pptx       # 单页原生可编辑重建
└── build.mjs           # 实际执行的构建源码

从上传原图裁出的局部照片或结果图直接嵌入 PPTX，不额外交付裁剪文件。只有用户另外提供、且构建实际依赖的高清或矢量素材，才增加可选 assets/ 目录。

确认目标 → 梳理结构 → 原生重建 → 渲染 + 结构检查 → 若有阻断项，集中修复一次 → 停止并交付或报告

单页原生可编辑：PPTX 只保留重建页，优先使用 PowerPoint 形状、文本框和连接线；照片、实验结果与复杂小图保留为独立、可替换的局部图片，不用整页截图冒充编辑性。
方向与拓扑显式：构建源码明确记录关系的起点、终点、方向、双向性和标签，不依据圆形或环形排布猜测循环。
可对照、可执行：源图保持外置；build.mjs 是实际运行并生成该 PPTX 的源码，声明所用后端和版本，不包含本机绝对路径，也不依赖未交付的本地 helper。
科学含义优先：保护文字、公式、方向和拓扑；歧义可能改变含义时先询问用户。
聚焦验证：完成一次全图渲染和一次结构检查；只为明显阻断项集中修复一次，第二次检查后停止并报告，不无休止追逐像素微差。
跨平台务实：editable.pptx 优先使用稳定的标准形状、独立文本框、明确字体和留白；仅在公式、自定义几何、密集文字等兼容风险存在或用户明确要求时，增加一次真实 PowerPoint 冒烟检查。

查看完整 Skill 工作流与质量规则

仓库 CI 检查 Skill 元数据、脚本和确定性结构规则；它不能替代科学含义核验，也不声称不同 PowerPoint 渲染器完全等价。

python3 -m pip install -r requirements-ci.txt
python3 tests/test_panel_crop.py
python3 tests/test_check.py
npm ci --ignore-scripts --no-audit --no-fund
python3 tests/test_portable_runtime.py

最后两条命令验证 PptxGenJS 合成构建、运行时探测和 LibreOffice 渲染；需要先安装上文列出的系统依赖。LibreOffice 通过只代表服务器可打开与导出，不等于所有 PowerPoint 平台像素一致。

欢迎通过 Issues 或 Pull Requests 贡献修复。请勿提交来源不明的论文截图、第三方素材或带本机隐私信息的文件。

许可与声明

仓库代码以 Apache License 2.0 发布；示例参考图若包含第三方内容，其权利仍以原始来源为准，不因收录而获得额外授权。用户应确认输入素材的使用权，并在交付前核验文字、公式、箭头方向与科学含义。

SciDiagram PPTX 是独立社区项目，与 OpenAI、Microsoft、Nature、Springer Nature 或任何期刊不存在官方隶属关系。

What it does

SciDiagram PPTX reconstructs scientific frameworks, mechanism diagrams, and research flowcharts as native editable PowerPoint shapes, text, connectors, and replaceable local image insets. It can also repair named slides in an existing PPTX or inspect named slides without modification. It preserves content and explicit edge direction instead of redesigning the source or hiding it behind a full-slide bitmap.

For charts whose evidence is encoded by axes, scales, and data-driven geometry, use SciPlot instead.

Install

Use $skill-installer to install:
https://github.com/SciToolsmith/sci-diagram-pptx/tree/main/skills/sci-diagram-pptx

Invoke

$sci-diagram-pptx Reconstruct this scientific flowchart as a native editable PPTX.
Preserve all labels, formulas, hierarchy, directions, and connections. Do not redesign it.

Delivery

Each reconstruction is returned as one folder containing the unchanged uploaded source, a single-slide native editable editable.pptx, and the actual build.mjs used to generate it. Crops taken from the upload are embedded as replaceable picture objects and do not add separate delivery files. Independently supplied high-resolution assets are included only when the build requires them.

Reproducible examples

Each public example contains the reference image, a single-slide editable PPTX, and the exact build.mjs used to generate it.

Sci Diagram PPTX

At a glance

README