apple/creator-studio-doc-format
开发工具一个用于读取、创建和编辑 Keynote .keyx 演示文稿的 Python 库,适合需要程序化生成或处理演示文件的开发者。
项目介绍
这是 Apple 维护的 Python 库,用于处理 Keynote Interchange Format(.keyx)文件。它可以读取从 Keynote 导出的演示文稿中的幻灯片、文本、图片、表格、图表和样式,也可以从零或基于主题的版式与样式创建演示文稿,并在保存前按格式规则校验编辑结果。库自身负责解析和写入该格式,因此不需要 Keynote、Apple 设备或网络连接,适合在自动化流程中批量生成或处理演示文件。
快速使用
需要 Python 3.13 或更高版本,从 PyPI 安装:
pip install creator-studio-doc-format
README 的快速示例会创建一个包含文本框的 Presentation,包进 KeyxDocument 后保存为 hello.keyx(见快速开始):
from creator_studio_doc_format.core import *
title = Textbox(
geometry=Geometry(position=Position(x=160, y=440), size=Size(width=1600, height=200)),
stroke=Stroke(empty=True),
layout_properties=LayoutProperties(vertical_alignment="center"),
paragraph_properties=ParagraphProperties(
alignment="center",
character_properties=CharacterProperties(font_size=96),
),
text=Text(string="Hello, Keynote"),
)
slide = Slide(contents=[SlideObject(object=CanvasObject(textbox=title))])
doc = KeyxDocument(
Presentation(
theme=KeynoteTheme(name="White", locale="en_US"),
slide_size=Size(width=1920, height=1080),
slides=[slide],
)
)
doc.save("hello.keyx")
生成的文件可在 Keynote 中打开。每种幻灯片内容都有对应的可运行脚本,放在示例目录。从创建第一份演示文稿到校验、遍历文档的完整流程见指南,所有公开符号的说明见 API 参考。
使用约束
- 必须使用 Python 3.13 及以上版本。
- 输入输出都是
.keyx文件;预览需要 Apple 设备上的 Keynote,在其他平台转成 PDF 等格式要依赖单独的 Creator Studio Document Exporting API,而不是这个库。 - 目前只接受问题反馈,不开源代码或文档贡献。
- 采用 Apache 2.0 许可证。
Agent skill
仓库附带一个 creator-studio-doc-format skill,教编程 Agent 使用这个库,可从最新 Release 安装:gh skill install apple/creator-studio-doc-format creator-studio-doc-format。任何能读取 SKILL.md 目录的 Agent 也可以直接使用skill 目录,前提是先装好库本身。
HotRepo 点评
项目在 2026-11-19 登上 HotRepo 新项目榜,这是它被记录的第一天,一小时的观察窗口内新增 16 Star,累计 117 Star。观察窗口很短,仓库也刚建立,这反映的是早期关注度而非持续热度。实际价值在于它绕开了 Keynote 设备和网络,在服务端 Python 环境里处理 Apple 掌控的文档格式,让自动生成演示文稿变得可行;目前尚无全部语言日榜的最好名次记录,这与项目刚进入统计期相符。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。