Pages Native

Pages Native

面向 Codex 和 MCP 的原生 Apple Pages 文档。作者：Viames Marino · MIT。

**版本 0.5.0。**原生验收在一台装有 Pages 14.5 和 macOS 27.0.1 的 Mac 上通过了 76 项检查；另有 70 项可移植测试单独通过。其他 Pages/macOS 配置尚未验证。请参阅验证。

Pages Native 通过固定的 JXA 和 AppleScript 工作进程使用 Apple 的脚本 API。文档保留为 .pages：不转换为 Word、不解析私有格式、不使用剪贴板驱动程序、辅助功能或 UI 自动化。

功能

36 个 MCP 工具涵盖原生文档和模板、富文本、现有的带标签占位符、带公式的表格、文本／形状／图像对象、现有对象几何信息、显式原生导出、不透明备份以及 PDF/PNG 预览。现有文本编辑、占位符填充、文本／单元格格式设置、表格／单元格修改、排序、合并、尺寸、对象和对页更改均设有预览／应用修订防护。**从 0.1 迁移：**修改工具现在默认使用预览模式。使用 mode:"apply" 和对应的 expected_revision 提交完全相同的请求；预览成功不代表编辑已完成。

0.5 新增：可预览的批量原生输出（最多 10 份）、包含已保存原型快照的不可变配方历史记录、结构比较、历史复用和带防护的恢复。批处理和历史记录指南。

0.4 新增：组合模型中的类型化表格字段，以及带相对原型路径、已保存字节指纹、版本计数器和带防护的保存／删除／使用功能的本地可复用配方库。请参阅类型化字段和配方。

0.3 新增：包含原生文本／单元格引用的结构化字面搜索，以及使用必填／默认字段和带修订防护的新建副本功能、基于已保存原型的引导式组合。请参阅搜索和模板。

修改可能部分应用；没有自动回滚功能。Pages 14.5 支持读取占位符标签，但会拒绝通过其脚本 API 更改这些标签。

此合成示例展示了原生表格中的总计 265 欧元，以及单独定位的文本项。

原生 API 不支持完整的段落样式、标题／列表、评论、修订、超链接、页眉／页脚、页面设置或图表系列／类型／标题。已保存原型中已有的功能可通过不透明原生副本保留。不支持创建和编辑图表数据。字体／字号／颜色格式设置不会分配命名段落样式；填充模型期间的语义样式保留尚未通过认证。

要求和安装

• macOS，且有交互式登录会话，并安装 Apple Pages。
• Node.js 22 或更高版本，以及实际控制 Pages 的宿主所需的自动化权限。
• 本地执行。仅限云端的任务无法在用户的 Mac 上运行此工具。

安装公开的 Codex 插件市场并启用 Pages Native：

codex plugin marketplace add viames/pages-native
codex plugin add pages-native@viames-pages

启动新的本地 Codex 任务并运行设置技能。兼容的 MCP 宿主可以运行 node /absolute/path/to/plugins/pages-native/dist/server.mjs；构建后无需在运行时安装 npm。

可选的 PAGES_NATIVE_ALLOWED_ROOTS 是一个现有目录的 JSON 数组。它会限制插件文件路径；它不是 Pages 进程的 macOS 沙盒。

开发

npm ci
npm test
npm run build
npm run test:bundle
npm run test:native
npm run package

可移植测试会验证协议、边界、路径限制、修订规划和超时恢复。test:native 会在明确指定的 Mac 上使用隔离的合成文档控制 Pages；常规 CI 不会认证图形版 Pages 的安装。

请参阅兼容性报告、功能、验证、发布和隐私。