Web SDK

アプリケーション構成

Web SDK、Server SDK、AI SDK の責任範囲と組み合わせ方を説明します。

Univer Office SDK は、埋め込みエディターとヘッドレス1のコンテンツ処理を提供する Web SDK、共同編集とファイルのインポート・エクスポートを提供する Server SDK、エージェントのワークフローを提供する AI SDK で構成されます。

Univer は人と AI Agent が同じ Office コンテンツを操作するアプリケーションの開発ツール群です。人向け Web、AI Agent 向け CLI、両者が共有する Server を提供することも、必要な部分だけ使うこともできます。

SDK の構成

100%
コンポーネント実行環境主な SDKSDK が提供アプリケーションが担当
WebブラウザーWeb SDK対話的な Office 表示と編集UI、製品の操作、ブラウザー統合
CLINode.jsAI SDKAI Agent 向けの検査と編集AI Agent フロー、ツール呼び出し、タスク境界
ServerNode.jsServer SDK（Collaboration、Exchange）自己ホスト共同編集と Office 入出力業務 API、ID、権限、ファイル保存、配置

ドキュメントは Web SDK、Server SDK、AI SDK に分かれ、エディター、共同編集・ファイル交換、AI Agent の内容操作を扱います。

AI SDK は Web SDK のヘッドレス機能を再利用します。3 つは主な開発入口と実行場所を示し、独立した技術スタックでも、アプリケーションコードなしで配置できる完成品でもありません。

ファイルの入出力の統合

Server SDK の @univerjs-pro/exchange-node が Office ファイルと Univer データを相互変換します。アプリケーションがモジュールを組み込み、アップロード・変換・ダウンロード API を提供します。Web SDK はブラウザー操作を担当し、CLI は Node.js で変換を呼べます。ブラウザー設定は各製品の Web SDK 文書で説明します。

  • 共同編集なし： ファイルをスナップショットに変換し、ブラウザーで開いて編集します。出力は最新スナップショットを変換モジュールへ渡します。サーバー変換は必要ですが共同編集サービスは不要です。
  • 共同編集あり： 取り込んだデータを共同編集ドキュメントとして保存します。Web と AI SDK は ID で同じ内容を操作します。出力前に現在の編集を同期し、最新データを読み取って変換します。

変換だけなら Exchange をローカル Node.js またはリモートサービスで利用でき、AI SDK と共同編集は不要です。手順はファイル交換の統合、モジュールの使い方は Office ファイルの入出力を参照してください。

配置構成

構成WebCLIServer用途
ローカルアプリローカルブラウザー／デスクトップ UIローカルプロセスローカルプロセスデスクトップ Office とローカル AI Agent
SaaSブラウザーユーザー端末／クラウド AI Agentリモートサービス複数ユーザーと集中運用
Web + Serverブラウザー—ローカルまたはリモートAI Agent 入口をまだ提供しない
Web のみブラウザー／デスクトップ UI——ローカル、単独、非共同編集

同じマシンでもクライアントとクラウドに分けても実行できます。配置は責任を変えません。Server がある場合、Web と CLI はそれを介して共有内容と製品機能にアクセスします。

入口を選ぶ

目的最初に読むページ
Web に Office エディターを埋め込むWeb SDK
エディターに Office 入出力を追加ファイル交換の統合
Node.js で Office を変換Office ファイルの入出力
自己ホストのリアルタイム共同編集Collaboration SDK 概要
AI Agent に Office 内容を読み書きさせるAI SDK 概要
CLI のヘッドレス Runtime を理解Runtime 再利用と Daemon
AI Agent の変更を人のレビュー用に分離Worktree

迷う場合ははじめにから読んでください。

Footnotes

  1. Headless は、対話型エディター UI をマウントせずに文書内容を操作することです。共同編集、永続化、ファイル変換サービスが含まれるという意味ではありません。 ↩

このガイドはいかがですか？

© 2026 DreamNum Co., Ltd.