Workspace

Univer Workspace は Univer Office SDK で構築したオープンソースの Office ワークスペースです。編集できる Office コンテンツやデータ連動の Web App を Personal / Team Space にまとめ、共有、共同編集、バージョン管理、変更レビューをつなぎます。リポジトリにはアプリ、デプロイ構成、CLI、デスクトップクライアントが含まれます。

自社環境にデプロイすることも、クラウド体験から始めることもできます。既存 Agent は Workspace CLI で接続し、Workspace Desktop は Agent の会話とワークスペースをローカルアプリにまとめます。いずれも同じサービスとファイルを利用します。

クラウド体験 · Agent を接続 · セルフホスト · Desktop 体験 · ソースとカスタマイズ

まずクラウドで Workspace を体験する

クラウド体験にサインインし、Personal Space またはアクセス可能な Team Space を開きます。文書の作成、編集、整理、共有を試せます。この稼働中のサービスには、次の CLI から Agent も接続できます。体験にはサンプルデータを使用してください。データはリセットされる場合があります。

Workspace Server は ID、Space、権限、ストレージ、共同編集、バージョンを管理し、Web は編集とレビューのブラウザー画面を提供します。プライベート環境でも同じ Server と Web をデプロイします。

既存 Agent をクラウド Workspace に接続する

Agent の実行環境に CLI と発見用 Skill をインストールします。Node.js 22.12 以降が必要で、24 を推奨します。コマンドを実行できる Agent は、自身のモデルと会話を維持したまま利用できます。ブラウザーと Agent が同じ Workspace を使うよう、クラウドの接続先を明示します：

npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai

uvw auth login

uvw auth login --complete

初回のブラウザー承認後は、CLI がセッションを再利用します。Agent ごとのログイン画面や認証統合は不要です。接続した Agent に依頼し、返されたリンクを Web で開けば、同じコンテンツを確認して Office の変更をマージ前にレビューできます。

計算とレビューができる文書から始める

個人 Workspace Space に英語の月次支出表を作成してください。日付、分類、金額と5件のサンプルデータを入れ、合計式と分類別グラフを追加してください。独立した下書きでデータ、数式、表示を検証し、プレビューまたはレビューリンクを渡してください。私の確認前にはマージしないでください。

接続済みエージェントや Desktop に同じタスクを送れます。エージェントが作成・検証し、人が修正依頼、レビュー、マージ判断を行います。オンライン版からも同じ内容を開けます。

同じワークフローを自社環境へ移す

リポジトリには Server と Web が含まれます。デプロイガイドに従って、ドメイン、ログイン、永続ストレージ、実行設定を構成してください。ソース開発は Node.js 24 と pnpm 11 を使用します。

同じ CLI の接続先を変更し、そのサービスのアカウントを承認します。以下の例を実際のサービス URL に置き換えてください：

uvw config set workspace.origin https://workspace.example.comuvw auth login

Agent のツールと Skills は同じまま、自社サービスのファイルと権限を使います。Desktop も接続できます。クライアント登録とコールバック設定は Agent 接続ガイドを参照してください。

Workspace をローカル Desktop クライアントへ

Workspace Desktop は Workspace、Agent ランタイム、Office ツール、プレビューをローカルアプリに統合します。Codex や Cowork のように、目標を伝え、会話の横で文書や Web App を確認し、修正を依頼して成果をレビューできます。

クラウド、自社環境、またはローカルで動く Workspace サービスに接続します。モデルと会話は設定した Agent ホストが担当し、ファイルとアクセス権は接続先 Workspace が管理します。以下の実際のデスクトップ事例で、作成、管理、共同作業の流れを紹介します。

インストールして接続する · 最初のタスク：2つの文書で予算をレビューする

日常の Office 作業にエージェントの流れを取り入れる

Office の成果物には、継続的な編集、数式計算、共同作業、変更レビューが必要です。Desktop はこれらを同じ環境にまとめ、編集・計算・共有できる内容を中心に会話を進めます。

• 文脈を維持： 会話、ファイル、Workspace 資料、ローカル参照を手元に置けます。
• Office と Web App を作成： 編集可能なスプレッドシート、文書、スライド、Relational Table、Canvases と、それらのデータを使う対話型ページを生成します。
• 確認しながら修正： 横で内容を開き、数式とレイアウトを確認して具体的な変更を依頼できます。
• レビュー後に共有： Office の変更は Worktree に保持し、人が差分を確認して共有空間へマージします。

依頼からレビュー可能な成果物へ

通常の会話で Office 文書と Web App を作成・修正し、Space でまとめて管理・共有します。ネイティブ Office の変更は Worktree でレビューしてマージします。HTML 公開とバインディング書き込みは固有の保存・認可フローを使います。次の会話でも同じファイルやデータを参照できます。

デスクトップに統合される機能

Workspace と Agent の連携を実際の画面で見る

以下の画像と操作シーケンスは、新規のローカル Workspace に接続した macOS デスクトップアプリで撮影しています。アカウント、Space、ファイル名、本文、Agent の会話には英語の架空データを使用しています。

通常の会話で作成し、その場でプレビュー

Build Five-File Launch Demo は、スプレッドシート、文書、スライド、Relational Table、キャンバスを作成した通常のエージェント会話です。実際の会話での引き渡しと、Desktop のブラウザーパネルで編集できる 02 Launch Brief を並べています。会話で修正を依頼し、生成されたファイルを Space で管理・共有できます。

Agent は通常の会話で対話型レポート、業務ページ、ダッシュボードも作成できます。後続の会話では公開済み予算表から 06 Launch Dashboard を作成しました。3つのカードが予算・実績・差額を表示し、比較グラフが HTML View のライブバインディングで6領域のデータに追従します。この例は同じネイティブ表計算を読み取るだけで、書き戻しは行いません。双方向バインディングは実験段階で、変更される可能性があります。

成果物を Space で管理・共有・共同編集

会話で作成した5つのネイティブファイルと 06 Launch Dashboard を Aurora Launch Studio にまとめています。同じ Space で予算、概要文書、3枚のスライド、タスク台帳、プロセス図、Web App を整理し、アクセスを管理してチームと共有します。チームがネイティブ Office 内容を共同編集すると、連携ページも元データに追従します。Web と Desktop は同じファイルを使い、Agent の追加修正は独立した Worktree でレビューを待ちます。

Desktop でコンテンツを開き、草稿をレビュー

実際の Desktop 操作で、ローカル Space のファイルを開き、各製品のネイティブエディターを確認して、実際の Agent 会話に戻ります。内容はアプリ内で引き続き編集できます。

Desktop で共有コンテンツを共同編集

Web と Desktop は同じローカルアカウントで 01 Launch Budget を開きます。Web で入力したメモが実際の Desktop エディターに現れ、Desktop の確認メモも Web に同期されます。画像には2つのメモと同期済み状態が表示されています。これは同一アカウントのクライアント間同期の例です。Agent の草稿は Worktree に分離されています。

対話で生成し、修正してレビューに渡す

Agent は独立した Worktree で 02 Launch Brief を修正します。2週間の承認ゲートと担当者の作業を追加し、再訪率の目標を40%から45%へ変更して、リスクと対策を記録します。画像は実際の会話とネイティブ文書プレビューで、共有元の文書は変更していません。

Worktree と Compare：Desktop で草稿を確認

文書の Review changes から、共有内容と Worktree の提案稿をネイティブ文書ビューで並べて確認できます。スクロールして内容と差分を調べ、受け入れる変更を判断します。画像のデスクトップ統合プレビューは読み取り専用で、この例では草稿をマージしていません。

Desktop で共有設定を確認

Desktop の Space 共有パネルでは、チーム Space のメンバーの役割とリンクのアクセス設定を確認できます。メンバーは役割に応じて共有コンテンツにアクセスし、リンクをコピーしてもアクセス権は追加されません。撮影時に共有権限は変更していません。

1つのデスクトップで5種類のネイティブコンテンツを扱う

英語の Aurora プロジェクトでは架空データを使い、予算、概要文書、プレゼンテーション、タスク台帳、プロセス図をつないでいます。画面は Desktop 内のネイティブ Office エディターです。Agent が操作する同じ内容を人も編集できます。

スクリーンショットはデスクトップ統合のプレビューです。ホストの拡張ポイントで Univer のブランド外観を適用しています。拡張可能な Agent ホストと Space プラグインを組み合わせており、プレビュー版プラグインの配布状況はプロジェクトのリリースに従います。

Sheets：計算できる事業モデル

予算表は6つの作業領域を管理し、Budget、Actual、Variance を数式で計算し、ネイティブの比較グラフを表示します。合計は予算 USD 102,000、実績 USD 100,000、予算内の差額 USD 2,000 です。Agent は Facade API で計算結果を検証します。

Docs：根拠を意思決定につなげる

見出し、段落スタイル、リスト、ネイティブ表で、目的、計画、成功指標、担当者を整理します。続く会話では、同じ編集可能な文書の一部を Worktree で修正できます。

Slides：事業の流れを伝える

3枚のスライドは、編集可能なテキストと図形、統一したスタイルで、価値提案、4段階の計画、成功指標と担当者を説明します。同じアプリでレイアウトの調整と発表ができます。

Relational Table：実行と納品を管理する

6件のタスクに、ステータス、優先度、担当者、期限、メモの型付きフィールドを設定しています。色付き選択肢で進捗と優先度を確認できます。

Canvases：戦略と実行をつなぐ

ネイティブ図形、テキスト、コネクターで Align → Activate → Share → Learn の4段階を示し、短いメモで作業と根拠を結びます。

インストールして接続する

拡張可能な Agent デスクトップに Space プラグインをインストールして有効化し、Space からサービスに接続してモデルとブランド外観を設定する方法もあります。本ページの画面はこの構成です。完成版 Desktop とプレビュープラグインは配布経路が異なるため、使用する版のリリース情報またはリポジトリの手順に従ってください。

1. GitHub Releases から Desktop を選びます。agent-v タグの Windows x64、macOS Apple Silicon、Linux x64 が対象です。デスクトップ提供は実験段階で、公開版の状況を確認してください。

2. Settings → Workspace で接続先を指定し、ブラウザーでログイン・認可します。既存サービス、またはローカル環境に接続できます。

3. Models 設定で対応するプロバイダー、モデル、認証情報を設定します。Workspace ログインとは別の設定です。モデル設定を参照してください。

4. アクセスできる個人またはチーム Space を追加し、会話を作って @ で資料を参照します。下のタスクでプレビューと変更レビューを試してください。

インストーラーはエージェントと Office ツールを含みます。Workspace サービスはローカルまたはサーバーで別途実行し、モデル接続も設定します。

最初のタスク：2つの文書で予算をレビューする

現在の Space に英語の Budget Review シートを作成してください。Department、Budget、Actual、Variance の8行の部門サンプルを入れ、差異と合計を数式にし、予算と実績のグラフを追加してください。超過支出を説明しシートにリンクする短い文書も作成してください。Office 変更は同じ Worktree に保持し、データ・数式・結果を検査してプレビューと差分を開き、私の承認までマージしないでください。

続けて「Marketing の予算を10%減らし、要約を更新して」と依頼し、値と文書の差分を確認してから受け入れます。

実際のセッション：モデルから意思決定メモへ

Aurora のデスクトップセッションは、元ファイルの読み取り、ネイティブ文書の修訂、後続レビューをつなぎます。既存の草稿は Ready のまま人間の承認を待ちます。実際のデスクトップ会話とネイティブの Worktree 比較をご覧ください。

リポジトリを基に独自の Workspace を作る

ここまでのアプリは Office SDK を組み合わせたものです。Workspace リポジトリを起点に、コンテンツランタイムと共同編集を再利用し、業務フロー、Skills、ツール、画面をチームに合わせて変更できます。

変更する場所を見つける

Skills：作業環境の理解からタスクの完了まで

既存 Agent 向けの Skills

既存のエージェントに入れる univer-workspace-cli Skill は、接続、対象の特定、ガイドの読み込みを案内する入口です。完全なランタイム Skills は CLI に同梱され、コマンドと Facade API のバージョンに対応します。Desktop の内蔵プラグインもタスク向けガイドとツールを提供します。

uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-view

まず core、次に対象製品やトピックを読み込みます。skills get に参考パスが表示され、uvw skills read <name> <path> で個別に、--full でまとめて読めます。既存エージェントは CLI、Desktop は会話に統合したツールとガイドを使います。

Desktop 内の作業ガイド

能力プラグインには univer Skill と参照資料が同梱されます。Space と文書の特定、Office API、Worktree の作成・確認・引き渡しを案内します。エージェントは API を調べ、ネイティブ内容に実行し、結果を検査できます。

機能プラグインは、ファイル探索、Headless Facade 編集、構造化検査、インポート・エクスポート、Worktree 管理をつなぎます。このプレビューは草稿をレビュー可能な状態にし、公開にはデプロイしたアプリのレビューとマージの手順を使います。同じ Office ランタイムに業務 Skills、テンプレート、ツールを追加できます。

プレビュープラグインには9つの Skills が含まれます。共通 Skill は検索、ID、納品の流れを、製品別 Skill は API と検証方法を説明します。Agent はタスクに必要なガイドを読みます。

Agent の実行ループと Office 機能を分けて組み立てる

Skills が作業を案内し、ツールが Headless ランタイムで構造化コンテンツを操作し、ネイティブエディターが人向けの表示と編集を担います。Workspace はファイルと共同作業の文脈を提供します。モデル、業務ツール、ブランド外観を変更しても、Office エンジンを作り直す必要はありません。

依頼 → ツール → 編集可能な内容 → プレビュー → レビュー → 共有、という流れを再利用できます。Office SDK が Office 層、ホストが会話と実行ループを担います。既存アプリとプラグインを拡張することも独自ホストに接続することもできます。

自社の業務フローへ拡張する

実装を確認する

Desktop のビルドと配布 · エージェントアプリと設定 · すべての例

Office Lab