# パッケージ一覧

> コンテンツ、共同編集、コンパイル、描画、プロセス、アプリケーションの用途別に AI SDK パッケージを選びます。

- Human documentation: [https://docs.univer.ai/ja-JP/ai/packages](https://docs.univer.ai/ja-JP/ai/packages)

- Agent Markdown: [https://docs.univer.ai/ja-JP/ai/packages.md](https://docs.univer.ai/ja-JP/ai/packages.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.1.0`

- Source: [packages.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/ai/packages.ja-JP.mdx)

---

AI SDK は現在 25 個の独立したパッケージを公開しています。必要な基礎パッケージだけを入れ、同じ行のコマンドプリセットの標準操作が製品に合う場合に追加してください。

## 2 種類のパッケージの役割

| 役割             | 提供するもの                                                  |
| -------------- | ------------------------------------------------------- |
| 基礎パッケージ        | Commander に依存せず、コマンド名・出力・終了動作を決めない構造化 TypeScript API    |
| コマンドプリセットパッケージ | 基礎パッケージを利用するネイティブ Commander `Command`。標準の引数、ヘルプ、端末操作を提供 |

コマンドプリセットの名前は通常 `-command` で終わります。すべての基礎パッケージにプリセットが必要なわけではありません。

## コンテンツと共同編集のランタイム

| タスク                        | 基礎パッケージ                                                                                                                        | コマンドプリセットパッケージ                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| 標準のヘッドレス Univer を作成        | [`@univer-cli/headless-univer`](https://www.npmjs.com/package/@univer-cli/headless-univer)                                     | —                                                                                                                |
| Univer Facade API をオフライン検索 | [`@univer-cli/api-reference`](https://www.npmjs.com/package/@univer-cli/api-reference)                                         | [`@univer-cli/api-reference-command`](https://www.npmjs.com/package/@univer-cli/api-reference-command)           |
| Facade 実行の準備とバインド          | [`@univer-cli/content-execution`](https://www.npmjs.com/package/@univer-cli/content-execution)                                 | —                                                                                                                |
| Sheet、Doc、Slide の内容を読む     | [`@univer-cli/content-inspection`](https://www.npmjs.com/package/@univer-cli/content-inspection)                               | [`@univer-cli/content-inspection-command`](https://www.npmjs.com/package/@univer-cli/content-inspection-command) |
| 1 つの共同編集 Unit を実行          | [`@univer-cli/univer-collaboration-runtime`](https://www.npmjs.com/package/@univer-cli/univer-collaboration-runtime)           | —                                                                                                                |
| Worker で共同編集ランタイムを再利用      | [`@univer-cli/univer-collaboration-runtime-pool`](https://www.npmjs.com/package/@univer-cli/univer-collaboration-runtime-pool) | —                                                                                                                |

## コンテンツのコンパイル

| タスク                           | 基礎パッケージ                                                                                      | コマンドプリセットパッケージ                                                                                               |
| ----------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| SVG を Slide Facade コードに変換     | [`@univer-cli/svg-facade`](https://www.npmjs.com/package/@univer-cli/svg-facade)             | [`@univer-cli/svg-facade-command`](https://www.npmjs.com/package/@univer-cli/svg-facade-command)             |
| Typst バンドルを Doc Facade コードに変換 | [`@univer-cli/doc-typst-facade`](https://www.npmjs.com/package/@univer-cli/doc-typst-facade) | [`@univer-cli/doc-typst-facade-command`](https://www.npmjs.com/package/@univer-cli/doc-typst-facade-command) |

## レンダリングと診断

| タスク                     | 基礎パッケージ                                                                                                | コマンドプリセットパッケージ                                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Unit の PNG を撮影          | [`@univer-cli/unit-screenshot`](https://www.npmjs.com/package/@univer-cli/unit-screenshot)             | [`@univer-cli/unit-screenshot-command`](https://www.npmjs.com/package/@univer-cli/unit-screenshot-command)   |
| Slide レイアウトを検査          | [`@univer-cli/unit-layout-lint`](https://www.npmjs.com/package/@univer-cli/unit-layout-lint)           | [`@univer-cli/unit-layout-lint-command`](https://www.npmjs.com/package/@univer-cli/unit-layout-lint-command) |
| Render Page の提供とブラウザー操作 | [`@univer-cli/univer-render-runtime`](https://www.npmjs.com/package/@univer-cli/univer-render-runtime) | —                                                                                                            |
| Render Page を構成・ビルド     | [`@univer-cli/univer-render-page`](https://www.npmjs.com/package/@univer-cli/univer-render-page)       | —                                                                                                            |

## プロセスとライフサイクル

| タスク                              | 基礎パッケージ                                                                                                            | コマンドプリセットパッケージ                                                                           |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| キーごとに状態を持つオブジェクトを排他的に取得・キャッシュ・破棄 | [`@univer-cli/generic-keyed-instance-pool`](https://www.npmjs.com/package/@univer-cli/generic-keyed-instance-pool) | —                                                                                        |
| 複数の CLI プロセスからローカル常駐プロセスへアクセス    | [`@univer-cli/daemon`](https://www.npmjs.com/package/@univer-cli/daemon)                                           | [`@univer-cli/daemon-command`](https://www.npmjs.com/package/@univer-cli/daemon-command) |

## アプリケーション補助

| タスク                   | 基礎パッケージ                                                                                      | コマンドプリセットパッケージ                                                                                               |
| --------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| アプリケーション設定の宣言・読み取り・保存 | [`@univer-cli/config`](https://www.npmjs.com/package/@univer-cli/config)                     | [`@univer-cli/config-command`](https://www.npmjs.com/package/@univer-cli/config-command)                     |
| 視覚リソースの検索・キャッシュ・出力    | [`@univer-cli/resource-library`](https://www.npmjs.com/package/@univer-cli/resource-library) | [`@univer-cli/resource-library-command`](https://www.npmjs.com/package/@univer-cli/resource-library-command) |

## 選び方

1. 業務の目的に合う基礎パッケージから始めます。
2. 標準の Commander 操作が製品に合う場合だけプリセットを追加します。
3. CLI、Web、Server が Unit を共有する場合は、データベースに直接アクセスせず共同編集ランタイムを使います。
4. 再利用、プロセス間アクセス、ブラウザー描画が必要になってからプール、Daemon、Render Runtime を追加します。
5. 対象パッケージの README で公開 API、所有権、破棄動作を確認します。

概念と基本的な使い方は[ドキュメントの読み込みと操作](https://docs.univer.ai/ja-JP/ai/content-operations.md)、[視覚的検査](https://docs.univer.ai/ja-JP/ai/visual-inspection.md)、[ランタイム再利用と Daemon](https://docs.univer.ai/ja-JP/ai/runtime-architecture.md)を参照してください。
