演示文稿工坊
从结构化内容生成可编辑 PowerPoint，并通过布局与内容检查降低交付缺陷。
- Star 数
- ★ 79
- 最近更新
- 11 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 68/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 研究人员把 CSV 数据整理成带科学图表、方法说明和局限性的实验室报告幻灯片。
- 不适合
- 只需要文字头脑风暴、不需要演示文稿文件的用户
- 希望直接修改 PPTX、且没有可用工作区源文件的用户
- 源码审查
- 68/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
presentation-skill 是一个面向编码代理的技能和 Codex 插件，用于制作可编辑的 PowerPoint 演示文稿。它以 outline.json 作为源文件，由 Python 脚本协调流程，并使用基于 pptxgenjs 的渲染器构建 .pptx；工作区模式还会生成带稳定对象 ID 和语义信息的 deck_ir.json。用户可选择快速单次制 deck 或可迭代、可审计的工作区流程。验证环节包含几何、内容和可选的渲染视觉检查，并可为高风险交付绑定精确文件哈希的审阅回执。项目也提供其他编码代理可用的同一 SKILL.md；核心生成不需要 LibreOffice，但渲染验证需要 LibreOffice soffice 和 Poppler pdftoppm（如需使用该验证方式）。
代理先编写 outline.json，并可通过 python3 scripts/present.py brief 为快速制 deck 获取路由简报，或通过 python3 scripts/present.py init 建立工作区。随后运行 python3 scripts/present.py finalize 从大纲生成 .pptx 并执行 QA，或在工作区中运行 python3 scripts/present.py build 重新构建。PptxGenJS 渲染器生成可编辑的文本、图表和表格；qa_gate.py 检查几何问题、占位内容及映射的源内容保留情况，并可在渲染可用时检查幻灯片图像。内容保留检查不等同于事实核查，也不保证覆盖所有源字段。
- 研究人员把 CSV 数据整理成带科学图表、方法说明和局限性的实验室报告幻灯片。
- 临床团队制作包含状态表格、图表和显微图像的可编辑数据报告。
- 董事会秘书根据决策需求制作含差异图表和负责人表格的董事会备忘演示文稿。
- 创业公司团队用 KPI、统计和对比版式准备投资者更新。
- 政策或编辑团队把证据和论点组织成风格统一、可反复构建的简报。
如何安装或部署这个 Agent？
可将仓库安装为 Codex 插件、通过 skills.sh 安装为技能，或复制到本地 Codex 技能目录。插件方式需在 Codex 的 /plugins 中安装 Presentation Skill 市场条目：
codex plugin marketplace add siril9/presentation-skill --ref v0.14.0本地技能安装需要 Python 和 Node.js：
git clone https://github.com/siril9/presentation-skill "${CODEX_HOME:-$HOME/.codex}/skills/presentation-skill"
cd "${CODEX_HOME:-$HOME/.codex}/skills/presentation-skill"
npm install
npm run setup:python
npm run doctor核心生成无需 LibreOffice。若要执行渲染验证，需安装 LibreOffice soffice 和 Poppler pdftoppm。可选的数据工作流可能还需要 markitdown[pptx]、matplotlib、pandas 或 openpyxl。
如何使用这个 Agent？
先为一次性演示文稿生成简报：
python3 scripts/present.py brief \
--topic "Q3 retention review" \
--prompt "Board decision with a variance chart and owner table" \
--profile auto \
--output quick_deck_agent_brief.json根据简报编写 outline.json 后，生成并验证 .pptx：
python3 scripts/present.py finalize \
--outline /absolute/path/outline.json \
--output /absolute/path/out.pptx \
--qa-dir /absolute/path/pptx-qa需要后续迭代的演示文稿可先初始化工作区，再编辑其中的 outline.json 并运行构建命令：
python3 scripts/present.py init \
--workspace /absolute/path/decks/my-deck \
--title "My Deck Title" \
--prompt "Original request" \
--profile auto \
--style-preset auto
python3 scripts/present.py build \
--workspace /absolute/path/decks/my-deck这个 Agent 有哪些优点和局限？
- 以 outline.json 为可重建源文件，适合审阅、迭代和后续重建，而不只是交付单个 PPTX。
- 提供 16 种内容版式、13 个风格系列和 8 套整套演示文稿构成语法，支持按内容选择结构。
- QA 覆盖几何、占位内容和映射的源内容保留；可选渲染检查能发现纯几何规则难以发现的问题。
- 原生图表和表格保持可编辑，工作区还可记录对象 ID、语义意图和证据链接。
- 本地安装涉及 Node.js、Python、npm 依赖及 Python 环境准备，setup:python 还需安装并验证运行依赖。
- 基于渲染的验证另需 LibreOffice soffice 和 Poppler pdftoppm；没有它们时无法完成该渲染检查路径。
- README 明确说明内容保留检查不是事实核查，也不覆盖每个源字段。
- 直接修改已有 PPTX 的流程以源文件可用为前提；若有工作区源文件，文档建议修改源文件。
这个 Agent 与同类方案有什么区别？
项目支持通过 skills.sh 提供给其他编码代理使用同一 SKILL.md，也提供 Codex 插件形式。README 未说明与其他演示文稿生成器的功能对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| 演示文稿工坊 当前 | 68 · 存在缺口 | Agent 插件 / 技能免费 | ★ 79 | 11 天前 | Python | Codex |
| PPTAgent（DeepPresenter） | 34 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.1k | 28 天前 | Python | — |
| PPT Master — AI 原生 PowerPoint 生成器 | 0 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 64k | 今天 | Python | Claude Code |
| PPT Agent | 41 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 912 | 4 个月前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示，工具以本地工作区、注册动作、路径约束及只读参考检查为主，并强调源文件、哈希绑定审阅和不覆盖审计输入；因此最小权限、外部影响和回滚得分较高。确认流程仅在高风险交付中描述，未普遍说明执行动作前的用户确认；敏感数据处理与依赖安全也缺少专门策略或审计证据。来源署名仅有许可证版权和仓库元数据，维护者责任与身份未由策展登记核实。
README、包元数据和测试材料在版本、工作流与 QA 描述上大体一致；运行时诊断和多层检查有明确说明。依赖有精确版本，且提供导入诊断和修复命令，但未见完整安全审计或依赖可用性保障。错误报告、退出码和失败时清除陈旧审阅材料在测试中有具体覆盖；本审查未执行这些测试。
文档覆盖快速单次演示、可重建工作区、已有幻灯片编辑，以及实验室、临床、董事会、投资者和政策场景，适配范围清晰。能力边界也有说明，例如 QA 不等于事实核验，渲染需要 LibreOffice/Poppler；但不同入口和后备路径较多，触发关键词及环境前置条件仍有一定复杂度。
文件分层、安装方式、运行命令和项目结构均有较完整说明；示例和发布说明丰富，MIT 许可证明确，版本历史具体。已知限制包括非事实核验、可选渲染依赖及非临床合成数据。扣分在于维护责任/支持时限未明确，别名很多，FAQ 信息主要分散在文档而非集中问答。
产品以 JSON 为源构建可编辑 PPTX，并提供原生图表/表格、重建流程、布局与内容 QA、无障碍检查和审阅收据，输出的可用性及相对普通截图式生成的增益有充分文档支持。成本收益得分略低：本地 Python/Node 环境、可选渲染工具和复杂工作区流程对简单演示可能偏重。
README 的主要功能陈述可在包脚本、测试文件、示例及发布材料中找到对应佐证，且文档区分合成研究、生成器基准和事实验证的边界。交叉佐证并非每项功能都达到独立复核；不少细节来自同一仓库的自述或测试代码。材料能区分静态设计声明与实际验证，但本次没有执行运行或测试，因此信心保持低。
- QA 检查布局、内容保留和无障碍信号，不构成事实核查；重要数据仍需人工核验。
- 核心流程需要本地 Python 与 Node，渲染审查还依赖 LibreOffice 和 Poppler；合成研究示例不代表真实临床或科学结果。
- 依赖虽有固定版本，但所给材料没有提供完整依赖安全审计或敏感数据处理策略。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.14.0 v0.14.0: Evidence-led methods, figures, and readable layouts
发布说明摘录
v0.14.0 - Methods and figures that carry the evidence Methods and figures stay readable, editable where practical, and tied to source. - Native ordered methods preserve 2-4 editable titles and details, with flow_layout: auto | strip | bands. Authored reading order is retained. - Scientific figures offer panel-grid, primary-rail, ledger-rail, and strip-readout layouts with figure_frame: open | ruled | panel. Evidence, captions and interpretation receive space at readable sizes. - Measured sidebars allocate room for declared headings and interpretation …在 GitHub 查看 ↗ -
v0.13.1 v0.13.1: See the slides, share the skill
发布说明摘录
v0.13.1 - See the slides, share the skill This is a showcase and distribution update with a small readability repair, not a new layout engine or a model benchmark. - The README previews fewer, larger actual slides: lab evidence and tables, editorial storytelling and a full-slide metric, and operational processes and decisions. The earlier library editorial source is rebuilt unchanged with the current renderer, rather than presented as an old screenshot. - Agent discovery metadata is current and ships with both the skill package …在 GitHub 查看 ↗ -
v0.13.0 v0.13.0 - Content-preserving builds, smaller repairs
发布说明摘录
v0.13.0 - Content-preserving builds, smaller repairs The model composes the story and design. The skill preserves editable source, fits the evidence, and reports what needs attention. - Shared layout allocation reserves room for captions, bottom callouts, and footers. Content and readable type take priority over decorative framing. - Numbered action panels keep their authored reading order, aligned peer boxes, and consistent padding. Editorial evidence gets clearer left insets and separation between figures, labels, and supporting text. …在 GitHub 查看 ↗