univer-cli

Univer CLI

複数の Unit を含む .univer ファイルを、ターミナルから作成・検査できます。CLI には、分離されたワークツリー、バージョンに一致した Facade のガイダンス、モデルの読み戻し、ブラウザーでのレビュー機能が用意されています。

インストール：

npm install -g univer-cli
univer doctor

CLI を最新の状態に保つ

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

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

新しいバージョンが利用可能な場合は、更新する前に現在の Univer タスクを完了してください。

univer update
univer doctor --json
univer skills get core

univer update から共有デーモンを停止する必要があると報告された場合は、デーモンを停止しても安全であることを確認したうえで、--force を付けて再実行してください。更新後は毎回、core と対象の Unit Skill を再読み込みしてください。

まずはこちらから

このファイルは概要を確認するための入口であり、操作ガイドではありません。タスクで Univer コマンドを使う前に、インストール済み CLI から core Skill 全体を読み込んでください。

univer skills get core          # shared model, workflow, evidence, and handoff
univer skills get core --full   # include direct references and templates

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

コアモデル

• .univer パスは、複数の Unit を含む正式な対象です。必ずファイルを明示的に指定してください。
• Unit は、unitId で識別されるトップレベルの Sheet、Doc、Slide、Base、または Board です。シート名、ページ、テーブル、範囲、図形、レコードは、その Unit 内にあります。
• trunk はレビュー済みのメインラインです。ワークツリーはエージェントによる変更を分離するための領域であり、暗黙のカレントワークツリーはありません。
• コマンドが成功しても、正しく処理された証拠にはなりません。対象モデルを読み戻し、タスク固有の条件を検証し、見た目が重要な場合はレンダリング結果を確認してください。

公開されている CLI と Facade の機能を使用してください。ワークツリーのコミット処理が永続的な書き込み境界であり、マージは明示的なレビュー判断として行います。

Unit Skills

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

univer skills get sheet
univer skills get doc
univer skills get slide
univer skills get base
univer skills get board

univer skills list を使うと、インストール済みの Skill を確認できます。各 Unit Skill には、その作成手順、Facade のエントリーポイント、読み戻しのガイダンス、ビジュアル検証の要件が含まれます。

複数の Unit を組み合わせる場合は、ホストと子の Unit Skills を読み込んだ後に、追加の Topic Skill を読み込んでください。

univer skills get embed

Sheet のセルまたは数式駆動の Shape で Unit 間数式を使用する場合は、ホストと Sheet または Base のソース Unit Skills を読み込んだ後に、その Topic Skill を読み込んでください。

univer skills get cross-unit-formula

タスクの振り分け

タスク	読み込んで使用するもの
スプレッドシートの値、数式、書式、グラフ、またはテーブルの確認や編集	core + sheet
ドキュメントの段落、リッチテキスト、テーブル、グラフ、またはページレイアウトの作成や調整	core + doc
プレゼンテーションのページ、図形、テキスト、または画像の作成やレビュー	core + slide
構造化された Base のテーブル、フィールド、レコード、またはビューの作成や編集	core + base
Board のキャンバス、グラフ、その他の要素の作成や編集	core + board
ある Unit を別の Unit に埋め込む	core + ホスト Unit + 子 Unit + embed
Sheet のセルまたは数式駆動の Shape から Sheet の範囲や Base のテーブル列を読み取る	core + ホスト Unit + ソース Unit + cross-unit-formula

Univer CLI を使う理由

• 1 つの .univer 対象に、unitId で指定する Sheet、Doc、Slide、Base、Board の Unit を含められます。
• ワークツリーによって、レビューとマージが完了するまでエージェントの変更を分離できます。
• オフラインの api show / api find により、インストール済み SDK の Facade シンボルを正確に特定できます。
• ランタイムでの読み戻しとビューアーにより、保存されたモデルとレンダリング結果を確認できます。
• インポート／エクスポートとスクリーンショットには、無関係なファイル書き込みツールではなく、製品のランタイムを使用します。

.univer のストレージを直接編集したり、無関係な書き込みツールで代用したりしないでください。サポートされている手順については、読み込んだ core と Unit Skills に従ってください。

診断

univer --help
univer doctor
univer skills list
univer skills path

正確な構文を確認するには、univer help <command> を使用してください。CLI を利用できない場合、または doctor がランタイムのブロッキング障害を報告した場合は、他のツールに切り替えずに停止し、診断結果を報告してください。