ヘッドレス実行とサーバー側計算

Univer は内容モデル、計算、UI を分離しています。ヘッドレス実行は Node.js で内容ランタイムを動かし、サーバー側計算は univer-rs で重い計算とファイル変換を処理します。アプリと Agent は同じ Snapshot を中心に両者を組み合わせられます。

UI プラグインなしの Node.js 実行

コア、製品モデル、計算、Facade の必要なプラグインを登録し、メニューやツールバーなど DOM 依存の UI プラグインは登録しません。製品構成に応じて Sheet、Doc、Slide、Relational Table、Canvases、PDF を処理できます。Sheets と Docs は Node プリセット、他の製品は対応するプラグイン構成から始めます。

内容操作は Node.js で直接実行します。スクリーンショットとレイアウト検査には別途レンダリング環境を設定します。CLI の Render Runtime はヘッドレスブラウザーを使い PNG と検査結果を返します。

編集時の即時計算と、サーバーのバージョン別計算

フロントエンドとサーバーの両方に数式エンジンがあります。フロントエンドは編集に応答し、サーバーは Snapshot の生成やファイル処理時に、確定した内容のリビジョンを計算します。

• 編集中：ブラウザーが影響を受ける数式を差分計算し、結果をすぐに表示します。Worker での実行も可能です。共同編集は内容の変更を記録・同期します。
• Snapshot 生成時：サーバーのスナップショット保存ポリシーに応じて保存処理を開始し、その処理の対象リビジョンを取得します。univer-rs で計算した後、同じリビジョンの内容と結果をまとめて保存します。
• 再度開くとき：Snapshot 内の有効な計算結果を再利用し、その後の変更を適用して計算を続けることで、全体の重複計算を減らします。

変更は継続的に同期します。サーバー計算は Snapshot の生成時に実行し、対応する内容のリビジョンとともに結果を保存します。

保存済み結果に合わせて初期計算を設定します。

• WHEN_EMPTY：保存済みの値を再利用し、不足する結果だけ計算します。
• NO_CALCULATION：初期計算を省き、アプリが結果を提供します。
• FORCED：保存済み結果を更新するため全数式を再計算します。

これらは初回読み込みの設定です。その後の編集はフロントエンドで計算を続け、サーバーはリビジョン別の Snapshot 生成やファイル処理時に必要に応じて計算します。数式設定、共同編集の概要、ファイル変換を参照してください。

数式エンジンの性能

10 冊のUniver Rust 数式エンジンの性能実測では、Rust の入力読み込み、区間別時間、入力形式の範囲、サンプルのダウンロードを紹介しています。

配列数式の計算と展開

対応する関数と形式の範囲で、Rust は Excel の配列数式とスピル規則に従います。アンカー、展開範囲、各セルの結果を返し、動的配列と従来の配列数式の指定範囲を扱います。

例えば空の A1 に =SEQUENCE(3,2) を入力すると、次の結果になります。

数式は A1 に残り、結果は A1:B3 に展開します。配列が縮むと古い展開値を消去し、展開先が塞がれている場合は #SPILL! を返します。ブラウザー、Agent、ファイル出力で計算済み Snapshot を再利用できます。

関数の対応範囲と Excel の配列動作を参照してください。

Agent の実行と検証につなぐ

既存 Agent のモデル、会話、ツール制御を利用し、AI SDK から Office 操作を提供します。

1. 構造と対象の内容を読み取ります。
2. ヘッドレス環境で Facade による編集と必要な計算を実行します。
3. 計算とコミット完了を待ち、最新状態を読み戻します。
4. 値と構造を検証し、必要なら画像とレイアウトも確認します。

内容操作と視覚的検証を組み合わせられます。人によるレビューには Worktree で変更を隔離し、比較後にマージします。Univer CLIは Agent 向けアプリへの組み立て例です。

導入方法

機能一覧に戻る