univer-workspace-cli

Univer Workspace CLI

Univer Workspace ファイルのリモートでの作成と検査に使用します。CLI では、Space の検索、タスクごとの Worktree、バージョンに対応した Facade のガイダンス、モデルの読み戻し、ブラウザーでのレビューが利用できます。

univer-workspace-cli は univer とは独立したものであり、その派生版ではありません。リモートの Workspace ファイルを操作する一方、univer はローカルの univerfiles を操作します。

対象の Workspace をインストールして設定します。

npm install -g univer-workspace-cli
univer-workspace-cli config set workspace.origin https://workspace.example.com
univer-workspace-cli login --json

最初のログインコマンドの確認 URL とコードをユーザーに伝えてから、処理を停止します。ユーザーが承認したことを確認してから --complete を実行してください。承認待ちの間はポーリングしないでください。

univer-workspace-cli login --complete --json
univer-workspace-cli doctor

CLI を最新の状態に保つ

次のコマンドで、インストール済みの CLI と最新の公開リリースを比較できます。

univer-workspace-cli --version
npm view univer-workspace-cli@latest version --registry=https://registry.npmjs.org/

アップグレードする前に、現在の Workspace タスクを完了してください。この CLI には update コマンドがありません。新しいパッケージバージョンを明示的にインストールしてから、運用に使用する Skills を再読み込みしてください。

npm install -g univer-workspace-cli@latest
univer-workspace-cli doctor --json
univer-workspace-cli skills get core

はじめに

このファイルは検出用のエントリーポイントであり、運用ガイドではありません。タスクで Workspace コマンドを使用する前に、インストール済み CLI からコア Skill 全体を読み込んでください。

univer-workspace-cli skills get core          # remote model, workflow, evidence, and handoff
univer-workspace-cli skills get core --full   # include direct references

ランタイム Skills は CLI に同梱されているため、コマンドと Facade API はインストール済みのバージョンに対応しています。

コアモデル

• Workspace のオリジンを 1 つ設定してから、そこで認証します。
• Space は、ユーザーがファイルを参照するためのコンテナーです。そのツリーには nodeId で識別される Node が含まれます。Node に関連付けられた Univer Resource は、resourceId で識別されます。
• Unit は、Resource を Worktree にステージングした後に unitId で識別される、編集可能な Sheet、Doc、Slide、Base、または Board コンテンツです。
• 新しいタスクはすべて、新しい Worktree で開始してください。同じタスクの手直しに限り、既存の Worktree を続けて使用できます。暗黙のカレント Worktree や Unit はありません。
• コマンドの成功は、正しさの根拠にはなりません。保存されたモデルを読み戻し、見た目が重要な場合はレンダリング結果を確認してください。

公開されている CLI と Facade のインターフェイスを使用してください。execute はキャプチャした変更を 1 つの Worktree リビジョンとしてコミットします。マージは引き続き、ユーザーが明示的にレビューして判断します。

Unit Skills

コア Skill の読み込み後、作成を始める前に、対象のトップレベル Unit に対応する Skill を読み込んでください。

univer-workspace-cli skills get sheet
univer-workspace-cli skills get doc
univer-workspace-cli skills get slide
univer-workspace-cli skills get base
univer-workspace-cli skills get board

univer-workspace-cli skills list を使用して、インストール済みの Skill 一覧を確認してください。各 Unit Skill では、その作成手順、注入される Facade ルート、読み戻しのガイダンス、視覚的な検証要件が定義されています。複数の Unit を組み合わせる場合は、Host と Source の Unit Skills の後に、univer-workspace-cli skills get embed または univer-workspace-cli skills get cross-unit-formula も読み込んでください。

タスクの振り分け

タスク	読み込んで使用する Skill
Personal/Team Space ファイルの認証または検出	core
既存のファイルをステージングする、またはタスク用 Worktree に新しい Unit を作成／インポートする	core + 対象 Unit
Sheet の値、数式、書式、チャート、またはテーブルを検査／編集する	core + sheet
Doc の段落、リッチテキスト、テーブル、チャート、またはページネーションを作成／調整する	core + doc
Slide のページ、図形、テキスト、画像、テーブル、またはチャートを作成／レビューする	core + slide
Base のテーブル、フィールド、レコード、ビュー、または数式を検査／編集する	core + base
Board のキャンバスと検証済みの要素を作成／レビューする	core + board
Unit を埋め込む、または別の Unit を使って Chart を作成する	core + Host + Source + embed
数式または数式駆動の Shape で Source のデータを使用する	core + Host + Source + cross-unit-formula
検証、スクリーンショット撮影、エクスポート、準備完了の設定、またはレビュー URL の生成を行う	core + 対象 Unit

Univer Workspace CLI を使う理由

• Space の検出により、リモートファイルを Worktree に入れる前に解決できます。
• Worktree により、レビュー、マージ、または破棄まで、1 つのエージェントタスクを分離できます。
• オフラインの api show / api find で、インストール済み SDK の Facade シンボルを正確に解決できます。
• ランタイムの検査と Workspace のレビューページで、保存結果とレンダリング結果を検証できます。
• インポート／エクスポートとスクリーンショットには、無関係なファイルライターではなく、Workspace 製品のランタイムを使用します。

ローカルのオフィス文書ライターで代用したり、リモート Worktree のライフサイクルを回避したりしないでください。サポートされている手順については、読み込んだコア Skill と Unit Skills に従ってください。

診断

univer-workspace-cli --help
univer-workspace-cli doctor
univer-workspace-cli skills list
univer-workspace-cli skills path

正確な構文については、univer-workspace-cli <command> --help を使用してください。CLI を利用できない場合、Workspace のオリジンが設定されていない場合、認証情報がない場合、または doctor で実行時の致命的な障害が報告された場合は、ツールを切り替えずに停止し、診断結果を報告してください。