Files
ai-agent-book/chapter2/agent-skills-ppt/skills/pptx/reference.md
T
liqiang b119135836
Build latest book artifacts / build (push) Canceled after 0s
dependency resolution / resolve (3.11) (push) Canceled after 0s
dependency resolution / resolve (3.13) (push) Canceled after 0s
deploy-pages / build (push) Canceled after 0s
deploy-pages / deploy (push) Canceled after 0s
i18n consistency check / check (push) Canceled after 0s
provider adoption tests / test (chapter2/context-compression) (push) Canceled after 0s
provider adoption tests / test (chapter2/prompt-injection) (push) Canceled after 0s
provider adoption tests / test (chapter2/system-hint) (push) Canceled after 0s
provider adoption tests / test (chapter3/log-sanitization) (push) Canceled after 0s
web-search-agent tests / test (push) Canceled after 0s
web-search-agent tests / agentbook (push) Canceled after 0s
ai-agent-book 精选快照(<2MB 代码与文档,来自 github.com/bojieli/ai-agent-book)
2026-08-20 13:12:50 +00:00

1.7 KiB

pptx Skill —— 技术细则(第三层 / 渐进式披露最深一层)

本文件对应本书「渐进式披露」的第三层:只有当 Agent 需要控制版式、配色, 或排查生成问题时才会读取,平时不占用上下文。

版式约定

生成器使用 python-pptx 的空白版式(slide_layouts[6]),并手动摆放文本框, 从而完全掌控排版,不依赖模板占位符:

  • 画布尺寸:10 x 7.5 英寸(4:3)。
  • 标题页:深蓝底(RGB 1F4E79),白色居中大标题(40pt)+ 浅蓝副标题(20pt)。
  • 内容页:白底,顶部深蓝色条内放页标题(26pt 白字),下方为要点列表(18pt)。

配色

名称 RGB 用途
ACCENT #1F4E79 标题页底 / 色条
DARK #222222 正文文字
LIGHT #F2F5FA 备用浅背景

python-pptx 关键点

  • Presentation() 新建演示文稿;prs.slides.add_slide(layout) 增页。
  • 文本必须放进 text_frame,逐段 add_paragraph()、逐段 add_run() 设置字体。
  • 纯色页背景:slide.background.fill.solid() 后设 fore_color.rgb
  • 形状类型 1 对应矩形(MSO_SHAPE.RECTANGLE),用于顶部色条。
  • 保存:prs.save(path),扩展名必须是 .pptx

校验建议

生成后重新打开文件即可验证有效性:

from pptx import Presentation
prs = Presentation("output/deck.pptx")
print(len(list(prs.slides)))               # 页数
for s in prs.slides:                        # 每页第一个文本
    for shp in s.shapes:
        if shp.has_text_frame and shp.text_frame.text.strip():
            print(shp.text_frame.text.strip().splitlines()[0]); break