title: “Pptx Author — Build PowerPoint decks headless with python-pptx” sidebar_label: “Pptx Author” description: “Build PowerPoint decks headless with python-pptx”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Pptx Author

使用 python-pptx 在无界面模式下创建 PowerPoint 演示文稿。

技能元数据


来源	可选 — 通过 `hermes skills install official/finance/pptx-author` 安装
路径	`optional-skills/finance\pptx-author`
版本	`1.0.0`
开发者	Anthropic（由 Nous Research 改编）
许可协议	Apache-2.0
支持平台	linux、macos、windows
标签	`powerpoint`、`pptx`、`python-pptx`、`presentation`、`finance`
相关技能	`excel-author`、`powerpoint`

参考：完整 SKILL.md 内容

:::info 以下是当触发该技能时 Hermes 会加载的完整技能定义。技能处于激活状态时，智能体将依据此内容执行操作。: ::

pptx-author

使用 python-pptx 在磁盘上生成 .pptx 文件。适用于需要以文件形式输出演示文稿，而非启动实时 PowerPoint 会议的场景。

该技能基于 Anthropic 在 anthropics/financial-services 中发布的 pptx-author 和 pitch-deck 技能改编而来。原版本中的 MCP / Office-JS 相关功能已被移除，因此适用于无界面 Python 环境。

对于已正式发布的、功能更为全面的 PowerPoint 编辑技能（包括幻灯片、演讲者备注、嵌入内容以及媒体文件处理），请参考内置的 powerpoint 技能。该技能采用更为轻量化的设计，专为需要基于模型生成演示文稿的场景而优化——例如商业计划书、管理层备忘录和财报说明等，这类文档中的所有数据都必须能够追溯到对应的源工作表。

输出规范

将结果写入 ./out/<名称>.pptx 文件中。如果 ./out/ 目录不存在，请先创建该目录。
在最终回复中需提供相应的相对路径。

设置说明

pip install "python-pptx>=0.6"

核心规范

每张幻灯片仅阐述一个核心观点

标题应明确传达关键信息，正文则用于加以佐证。例如，“Q3营收”这样的标题较为单薄；而“Q3季度营收同比增长速度提升至14%”则更为有力。

所有数据均需追溯至模型来源

若幻灯片上的数据源自 ./out/model.xlsx，请在脚注中注明对应的表格及单元格位置。

Revenue: $1,250M  (Source: model.xlsx, Inputs!C3)

切勿凭记忆或根据摘要来输入数字——请打开工作簿，读取指定的数据区域，尽可能通过编程方式将演示文稿中的数值与该区域绑定。

当模板已加载时使用公司专用模板

如果存在 ./templates/firm-template.pptx 文件，请将其加载，这样演示文稿就能继承该公司的品牌颜色、字体以及整体布局。

from pptx import Presentation
from pathlib import Path

template = Path("./templates/firm-template.pptx")
prs = Presentation(str(template)) if template.exists() else Presentation()

图表：从模型生成的PNG格式图表优于原生PPTX图表

在图表精度至关重要的场景下（即要求模型的图表样式与演示文稿完全一致），应从原始工作簿中将图表渲染为PNG格式并嵌入其中。而原生的pptx.chart格式图表较为脆弱，且往往无法符合企业的规范要求。

from pptx.util import Inches
slide.shapes.add_picture("./out/charts/football_field.png",
                         Inches(1), Inches(2),
                         width=Inches(8))

无外部发送功能

该智能体仅负责生成文件，不会发送电子邮件、上传内容或发布信息。具体的内容投递工作由编排层负责处理。

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor
from pathlib import Path

template = Path("./templates/firm-template.pptx")
prs = Presentation(str(template)) if template.exists() else Presentation()

# Title slide
slide = prs.slides.add_slide(prs.slide_layouts[0])
slide.shapes.title.text = "Project Aurora — Strategic Alternatives"
slide.placeholders[1].text = "Preliminary Discussion Materials"

# Valuation summary slide (title-only layout)
slide = prs.slides.add_slide(prs.slide_layouts[5])
slide.shapes.title.text = "Valuation implies $38–$52 per share across methodologies"

# Add a table bound to model outputs
rows, cols = 5, 4
tbl_shape = slide.shapes.add_table(rows, cols,
                                   Inches(0.5), Inches(1.5),
                                   Inches(9), Inches(3))
tbl = tbl_shape.table
headers = ["Methodology", "Low ($)", "Mid ($)", "High ($)"]
for c, h in enumerate(headers):
    tbl.cell(0, c).text = h

# In a real deck, read these from the model workbook with openpyxl
data = [
    ("Trading comps",     "35", "41", "48"),
    ("Precedent M&A",     "39", "45", "52"),
    ("DCF (base)",        "36", "43", "51"),
    ("LBO (10% IRR)",     "33", "38", "44"),
]
for r, row in enumerate(data, start=1):
    for c, val in enumerate(row):
        tbl.cell(r, c).text = val

# Embed a chart rendered from the model
slide = prs.slides.add_slide(prs.slide_layouts[5])
slide.shapes.title.text = "Football field — current price $42"
slide.shapes.add_picture("./out/charts/football_field.png",
                         Inches(1), Inches(1.8), width=Inches(8))

Path("./out").mkdir(exist_ok=True)
prs.save("./out/pitch-aurora.pptx")

将演示文稿编号与源工作簿绑定

从 Excel 模型中读取命名区域或特定单元格，从而确保演示文稿编号始终保持一致。

from openpyxl import load_workbook

wb = load_workbook("./out/model.xlsx", data_only=True)
def nr(name):
    """Resolve a named range to its current computed value."""
    rng = wb.defined_names[name]
    sheet, coord = next(rng.destinations)
    return wb[sheet][coord].value

revenue_fy24 = nr("RevenueFY24")
implied_mid  = nr("ImpliedSharePriceBase")

接着使用这些数值来构建演示文稿内容：

slide.shapes.title.text = f"Implied share price of ${implied_mid:.2f} (base case)"

在读取工作簿之前，请务必先重新计算其数值——只有当已有程序计算过该工作表的内容时，openpyxl才能读取到这些计算后的数值。建议首先使用 excel-author 智能体中的重新计算工具，或通过真实的 Excel 会话来打开/保存文件。

商业计划书演示文稿的幻灯片结构清单

典型的银行类商业计划书通常采用以下结构。虽非强制要求，但可作为搭建框架的参考：

封面/标题页
免责声明
目录页
行业现状概述
目标公司概况
市场/行业背景
估值汇总页（“足球场图”）——核心财务数据页
同类交易案例详情
先例交易细节
DCF估值分析总结
杠杆收购/融资方案示例
实施流程考量
附录

何时不宜使用此智能体

正在通过 Office MCP 进行实时 PowerPoint 演示的用户——请直接操作其实时文档。
非财务类的演示文稿（如季度全员会议材料、营销演示文稿）——建议使用更通用的 powerpoint 智能体。
包含大量动画效果、过渡效果或演讲者备注的演示文稿——同样建议使用更通用的 powerpoint 智能体。

出处说明

相关规范参考自 Anthropic 的 Claude for Financial Services 插件套件，采用 Apache-2.0 许可协议。原始代码地址：https://github.com/anthropics/financial-services/tree/main/plugins/agent-plugins/pitch-agent/skills/pptx-author

Keyboard shortcuts

Hermes Agent Docs i18n