iWork Studio

让 AI 安全编辑你的 Numbers、Keynote 和 Pages 文件。

根据你的数据和品牌设计演示文稿，并检查渲染效果。支持阿拉伯语。
每项更改都有备份、经过验证且可撤销；遇到任何风险操作都会拒绝，绝不猜测。

🛡️ 绝不损坏你的文件	🎨 根据你的数据设计	ع 一流的阿拉伯语支持
备份 → 修改副本 → 重新读取并比较 → 原子替换。不会动正在打开的文件。一次调用即可撤销任何更改。	将电子表格转换为符合你品牌规范的 Keynote 演示文稿，包含图表和表格幻灯片，然后检查渲染效果。	在每款应用和每种导出格式中，阿拉伯语和从右到左的文本都能准确往返。

安装 · 试试看 · 安全机制 · 功能介绍 · 所有工具 · 面向 AI Agent · 更新日志

_{15 秒：数据 → 设计精美的演示文稿 → 安全回滚 → 阿拉伯语。高清视频}

_{▶ 观看带声音的演示影片（46 秒）· 阅读发布故事}

安装

就这么简单。安装程序会在需要时安装 uv，而 uv 自带 Python。

• 限制访问范围（推荐）：… | sh -s -- --roots ~/Documents ~/Desktop 将访问范围限制在这些文件夹中。其他客户端：设置 IWORK_STUDIO_ROOTS（以 : 分隔）。
• 减少加载内容（可选）：只使用 Keynote？设置 IWORK_STUDIO_TOOLSETS=keynote,design（可选值为 files、numbers、keynote、pages、design；默认全部启用）。工具越少，AI 越专注，上下文也越精简。Claude Desktop 扩展有一个 Toolsets 字段；在 Claude Code 中：claude mcp add iwork-studio -e IWORK_STUDIO_TOOLSETS=keynote,design -- uvx --from iwork-studio@latest iwork-studio-mcp。Capabilities、read、find、undo 和工具包列表始终会加载。
• **首次运行：**macOS 会询问一次是否允许 Claude 控制 Keynote / Pages / Numbers。点击 OK。（错过了？前往“系统设置” →“隐私与安全性” →“自动化”。）
• **检查是否正常：**询问 “iwork-studio 在这台 Mac 上能做什么？”。
• 移除：uvx --from iwork-studio@latest iwork-studio-mcp uninstall

**正在为他人设置的 AI Agent？**选择适用于对方应用的那一行，运行命令，然后调用 iwork_capabilities。使用这些工具的规则请参阅 AGENTS.md。

直接用英文或阿拉伯文提出需求

**手边没有文件？**可以这样说：“把 iWork Studio 示例复制到我的桌面，并将 sample-sales.numbers 制作成董事会演示文稿。” 示例是合成销售数据，包含英文和阿拉伯文工作表。

“使用 midnight 工具包，为一家太阳能电池板初创公司制作一份 6 页的路演演示文稿，添加演讲者备注，并导出为 PowerPoint。”

“把 sales.numbers 制作成董事会演示文稿：绘制各季度图表，添加地区销售额前列的表格，并使用我们的 Acme 工具包。”

“从 brand.key 中提取字体和颜色，并将其保存为我们的 Acme 工具包。”

“检查 pitch.key，并修复所有溢出或字号太小、难以阅读的内容。”

“用 banking 工具包美化 budget.numbers——并先给我看预览。”

“将 sales.csv 转成 Numbers 文件，把表头设为粗体、填充青绿色，将 B 列显示为 SAR，保留两位小数，并添加合计行。”

“在 pitch.key 中切换到 Gradient 主题，将第 1 张幻灯片的标题设为白色、60 pt，在每张幻灯片之间添加溶解转场，并将 logo.png 放到最后一张幻灯片。”

“在第 4 张幻灯片中添加一张柱状图，显示 2025 年和 2026 年各季度的收入。”

“复制第 3 张幻灯片，将副本移到最前面，并添加演讲者备注：ملاحظات المتحدث”

“填写 offer-letter.pages 中的 Name 和 Date 字段，然后将其导出为受密码保护的 PDF。”

“在 invoice.pages 的表格中，将 B3 的数量设为 12，并将 D9 设为 D2:D8 的合计。”

“找出我本周的 Keynote 演示文稿，并将每个文件都导出为 PowerPoint。”

“撤销对 budget.numbers 的上一次更改。”

功能

⚡ = 随处可用，无需应用（纯 Python）。其他功能都需要在已登录会话的 Mac 上驱动实际应用，包括经典版 iWork 或 Creator Studio 应用。

支持所有文件类型： 在更改前预览（dry_run）、查询元数据、获取预览缩略图、使用 Spotlight 查找文件、检查某个词是否已实际渲染、检查渲染后的字体/大小/颜色、列出备份并撤销操作。

不支持的功能

这是有意为之，以免损坏文件：

• 包含图表的文件无法使用无需应用的工具处理：重写操作可能会在不提示的情况下破坏图表与其数据的关联。由应用驱动的工具（Keynote 幻灯片、主题设置、转场效果、图像；Numbers 公式和排序）可以处理这类文件，并会检查所有图表是否仍然存在。
• Numbers 和 Pages 中的图表无法创建：这些操作无法可靠地通过脚本实现，因此我们选择拒绝操作，而不是点击应用菜单并冒着损坏文件的风险。Keynote 可以添加图表。若要对排序后的数据创建图表，同时不改动 Numbers 图表，可将数据排序到新表格中（使用 numbers_sort 的 to_new_table），再据此创建 Keynote 图表幻灯片。
• Pages仅支持文本和现有表格：替换文本、设置正文、填充占位符和修改表格单元格。无法创建新表格（Pages 15 不支持脚本操作），而且页面布局文稿（例如大多数信件模板）没有正文文本。没有任何 Pages 文件格式解析器，因此不会假装有这样的解析器。
• 公式和行移位：含有公式的表格，只能在不使用应用的情况下追加行和列。在中间插入会导致引用指向错误的单元格。
• Apple 脚本不支持的功能，因此不提供：Numbers 表格样式、Keynote 形状填充和文本对齐、删除 Keynote 表格、编辑主题的母版幻灯片。页面边距和页面设置已列入计划。

不只是编辑，更是设计

六套设计套件能把普通的演示文稿或表格变成适合展示的作品：一组字体搭配（拉丁字母 + 阿拉伯字母，均已随 macOS 附带，无需安装）、经过 WCAG 对比度检查的克制配色，以及一套字号比例。

使用一套套件构建（keynote_build_deck(..., kit="midnight")）、为任何内容重新设计样式（keynote_apply_design、numbers_apply_design），也可以用自己的品牌颜色和字体——系统会检查对比度。Agent 还可以使用设计指南：每张幻灯片表达一个想法、标题直陈要点、数字右对齐、配色克制。

一次设置品牌。 将已有品牌风格的演示文稿或表格交给 iwork_extract_design_kit，它会读取字体（拉丁字母和阿拉伯字母）与颜色，并将其保存为命名套件，可在任何支持套件的地方使用。也可以用 iwork_save_design_kit 直接保存颜色和字体。

幻灯片上的数字。 keynote_build_deck 中的幻灯片可以包含图表或表格，数据可以来自数据集，也可以直接取自 Numbers 表格：标题行定义列，第一列定义行。表格会应用套件的标题栏、字体、交替底色和右对齐数字，并读取回每个单元格。

它会检查自己的工作。 keynote_review_deck 会通过 Keynote 渲染演示文稿，并将每一行绘制内容与对应的文本框进行比较：文本超出幻灯片或溢出文本框属于错误；Keynote 为适应文本而缩小字号、文本框重叠、字号低于 18 pt 以及幻灯片内容过于拥挤属于警告。keynote_slide_image 会将幻灯片作为图像返回，让 Agent 在说“完成”前先检查效果。

安全模型

iWork 应用会轻易地对一个刚被它弄坏的文件说“已保存”。这里绝不相信“已保存”。

backup → change a scratch copy → re-open it and compare → atomic swap
                       ↘ anything off: your file is untouched, the error says why

• 先备份，备份带版本且仅供本地使用：存放于 ~/.iwork-studio/backups/（或 IWORK_STUDIO_BACKUP_DIR），绝不放在文件旁边，以免备份占满或同步到 iCloud Desktop 和 Documents。每个文件保留最近 10 份备份。
• 绝不绕过应用直接修改：如果文件已在 Numbers、Keynote 或 Pages 中打开，就会拒绝写入。否则应用下次保存时可能会悄悄覆盖更改。
• 重新读取并比较：确认只发生了请求的更改，没有其他改动。编辑单元格后会重新读取该单元格，并检查所有其他单元格。插入行后会检查新位置上的每个单元格。幻灯片操作会检查所有其他幻灯片。排序会检查是否只是重新排列；如果表格公式引用了其他行，就会提前拒绝操作，因为 Numbers 自带的排序会破坏公式。对于含图表的文件，会在操作前后统计所有图表；对于含表格的演示文稿，会比较所有表格的单元格。导出内容会由第二个独立工具重新读取。
• 原子替换：文件一次性替换，因此即使崩溃也不会留下不完整的文件。
• 绝不相信应用的“正常”反馈。 应用执行的写入会从磁盘重新读取；如果写入显示“成功”却未实际生效，就会回滚。
• 一次调用即可撤销：iwork_list_backups → iwork_restore_backup。恢复前会先备份当前版本，因此撤销操作也可以撤销。
• 先预览：所有会更改现有文档的写入都需要设置 dry_run=true（恢复和导出除外）。它会在临时副本上执行实际更改并运行所有检查，准确展示将要发生的变化。你的文件不会受到影响。
• 查找和替换会保留格式：在 Pages 中，只会重写包含目标文本的段落。
• 新文件绝不覆盖已有文件。
• 宁可拒绝，也不损坏。 最坏的结果只是明确说“不”，绝不会弄坏文件。

阿拉伯语与 RTL

• 阿拉伯语文本在三个应用中都能精确往返，包括演讲者备注、Pages 占位符和 Pages 表格单元格。
• 在 Pages 中检查段落方向。 如果替换操作将从右向左的段落改为从左向右，则会回滚。Pages 会将新段落设为从左向右，即使内容是阿拉伯语也一样，而且脚本无法更改方向，因此这类情况会被标记：请在 Pages 中设置方向（格式 › 文本）。
• 按原样保留输入的值：阿拉伯-印度数字（١٢٣）、"$1,234.56" 和 =… 文本仍为文本。需要数字时，请传入真正的数值。
• 检查渲染后的 PDF 时，请断言一个阿拉伯语词。PDF 文本层会重新排列多个 RTL 词语。

全部 65 个工具

写入操作标记为有破坏性，读取操作标记为只读，因此客户端可以在写入前询问。每个会更改现有文件的写入操作都支持 dry_run=true 预览。每个工具都有标题和参数说明，并注明应在何时使用它，而不是同类工具。需要更少工具？只加载部分工具集（参见安装中的减少加载）。

如果演示文稿已在 Keynote 中打开，Keynote 幻灯片、主题、切换效果和图片工具会拒绝操作（它们绝不会关闭可能包含未保存内容的窗口）。要全部隐藏这些工具：IWORK_STUDIO_DISABLE_SLIDE_OPS=1。

提示词。 能显示 MCP 提示词的客户端会提供四种现成的工作流：根据大纲制作推介演示文稿、根据 Numbers 表格制作报告演示文稿、使用我的品牌重新设置样式和为这个表格设计样式。每种工作流都会写入设计规则、通过一次调用完成构建、在重新设置样式前预览，并在宣布任务完成前进行设计审查。

面向 AI Agent

• AGENTS.md：适用于任何 Agent（Codex、Cursor、Copilot、Gemini；Claude Code 通过 CLAUDE.md 读取）的设置和使用规则。
• MCP 说明：服务在连接时会发送规则，因此即使没有此仓库，模型也能获取这些规则。
• 技能：skill-pack/SKILL.md，Claude Code 会在此仓库中自动发现此文件；其他基于技能的 Agent 可运行 bash skill-pack/install.sh。其中包含为不使用 MCP 的 Agent 提供 JSON 输出的 CLI 脚本。
• llms.txt：简短、机器可读的摘要。

**约定：**输入 JSON，输出 JSON。错误均有明确类型，并说明应告知用户的内容，例如 ChartRefusalError、DocumentOpenError、PagesOutOfScopeError、AquaSessionError（此处没有 Mac GUI），等等。写入操作遭拒时，不要试图绕过限制后重试。

Python

pip install iwork-studio      # Python 3.12

from iwork_studio import numbers_structure, numbers_format, numbers_io, keynote_io, keynote_slides, exporter, backups

from iwork_studio import keynote_deck, design, review

keynote_deck.build_deck("pitch.key", [{"title": "شمس", "body": "Clean energy for every home"},
                                      {"title": "Why now", "body": ["Trust", "Access"]},
                                      {"title": "Riyadh leads growth", "chart": {"type": "bar", "from": "sales.numbers"}}],
                        kit="midnight")                                  # macOS + Keynote
review.review_deck("pitch.key")["findings"]                              # macOS + Keynote
design.extract_kit("brand.numbers", name="Acme", save=True)
numbers_structure.import_csv("sales.csv", "sales.numbers")
design.apply_to_numbers("sales.numbers", "banking")
numbers_format.set_cell_style("sales.numbers", "A1:D1", bold=True, fill_color="#1A7F79", font_color="#FFFFFF")
numbers_format.set_number_format("sales.numbers", "B2:B99", "currency", currency_code="SAR", decimal_places=2)
numbers_io.edit_cell("sales.numbers", "B2", 2500)
keynote_io.edit_text("pitch.key", "2025", "2026")
keynote_slides.set_presenter_notes("pitch.key", 1, "ملاحظات")          # macOS + Keynote
exporter.export("pitch.key", "pptx")                                     # macOS + Keynote
backups.restore_backup("sales.numbers", backups.list_backups("sales.numbers")[0]["name"])

pure Python file parsers (headless, deterministic)  →  .numbers everything, .key text
the real app via AppleScript / JXA                   →  .key slides & theming, .pages text & tables, formulas, sort, export, render checks
MCP server · CLI scripts · skill                     →  thin wrappers over the same library and the same safety model

src/iwork_studio/   numbers_io · numbers_format · numbers_structure · keynote_io · keynote_slides · keynote_theme
                    keynote_deck · keynote_table · design · review · preview · pages_io · app_ops · exporter
                    helpers · format_check · render_verify · pdf · backups · apps · mcp_server
mcpb/               Claude Desktop extension manifest (scripts/build_mcpb.sh builds the .mcpb)
skill-pack/         SKILL.md · CLI scripts · references (capabilities, traps, pins); also the Claude Code plugin
.claude-plugin/     plugin marketplace (one plugin: skill-pack/)
tests/              headless suite (CI) · `pytest -m aqua` = live suite for a Mac with iWork
install.sh          one-line setup for the Claude desktop app

git clone https://github.com/Arkanji/iwork-studio.git && cd iwork-studio
uv run --extra test pytest -m "not aqua"      # headless suite, what CI runs
uv run --extra test pytest -m aqua            # live suite: a Mac with Numbers, Keynote and Pages
scripts/live.sh                               # the same, unattended: logs to ~/.iwork-studio/probes, quits the apps it opened

iWork 在不同版本间会有变化。如果出现问题，请查看功能和陷阱，运行实时测试套件，并记录发生的变化。新的写入路由必须遵循安全模型，并附带证明可回滚的测试。请在 iCloud 同步文件夹之外克隆仓库。

许可证

MIT，包含陷阱。拿去吧。