Pages Native

Pages Native

Codex と MCP 向けの Apple Pages ネイティブ書類です。作者：Viames Marino · MIT。

バージョン 0.5.0。 1 台の Mac で Pages 14.5 と macOS 27.0.1 を使用し、ネイティブの受け入れテストで 76 項目に合格しました。これとは別に、ポータブルテスト 70 件に合格しています。その他の Pages／macOS 構成では検証されていません。検証をご覧ください。

Pages Native は、Apple のスクリプティング API を固定の JXA ワーカーと AppleScript ワーカー経由で使用します。書類は .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 EUR が表示され、テキスト項目が別の位置に配置されています。

ネイティブ API では、段落スタイル全体、見出し／リスト、コメント、変更履歴、ハイパーリンク、ヘッダー／フッター、ページ設定、グラフの系列／種類／タイトルを公開していません。保存済みのプロトタイプにすでに含まれている機能は、内容を解釈しないネイティブコピーによって保持できます。グラフデータの作成や編集は保証していません。フォント／サイズ／色の書式設定では、名前付き段落スタイルは割り当てられません。モデル入力中のセマンティックスタイルの保持は、まだ認定されていません。

要件とインストール

• 対話型のログイン済みセッションと Apple Pages がある macOS。
• 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 のインストール環境は認定されません。

互換性レポート、機能、検証、公開、プライバシーをご覧ください。