この一覧で、機能とそのパッケージ、公開のソースを対応付けます。すべてのアプリがインストールすべき依存関係の一覧ではありません。依存関係はアプリのマニフェストとロックファイルで決まります。プラグインと共通のインターフェースについては プラグイン一覧 と API リファレンス を参照してください。
この一覧の使い方
- アプリテンプレートにすでに組み込まれているランタイムとサービスを優先します。
src/やdist/の下の非公開の依存ファイルではなく、パッケージのルートか、package.jsonで宣言された公開のサブパスをインポートします。- サーバーのライブラリーはサーバーのコードにとどめ、クライアントのコードではブラウザー互換の入口を使います。
- プラグインは実行時の拡張を提供します。UI Registry は、利用側のプロジェクトにインストールされる編集可能なソースを提供します。それぞれの依存関係と更新は別々に管理します。
アプリのランタイム
| パッケージ | 用途 |
|---|---|
@nocobase/app-client | クライアントのアプリ、ルート、サービス、React の拡張 |
@nocobase/app-server | サーバーのアプリ、HTTP、設定、リソースの組み込み |
@nocobase/app-cli | アプリのコマンドと、開発・ビルドのツール |
@nocobase/app-websocket | WebSocket の取り決めと Node のサーバーのアダプター |
コアライブラリー
| パッケージ | 用途 |
|---|---|
@nocobase/api-client | HTTP のリクエスト、ストリーミングのレスポンス、リモートの Repository |
@nocobase/authorization | 認可、権限セット、データ範囲 |
@nocobase/caching | キャッシュのインターフェースとアダプター |
@nocobase/config | 設定の取得元、パーサー、マージ |
@nocobase/db | データモデル、照会、マイグレーション、トランザクション、データベースの拡張 |
@nocobase/drive | ファイルストレージとストレージのドライバー |
@nocobase/i18n | クライアントとサーバーの多言語化のランタイム |
@nocobase/jobs | バックグラウンドジョブと定期的なスケジュール |
@nocobase/lifecycle | レコードの状態、遷移、コミット後の影響 |
@nocobase/logging | ログのインターフェース、形式、出力 |
@nocobase/mailer | SMTP、Resend などによるメールの配信 |
@nocobase/queue | キュー、投入側、コンシューマー |
@nocobase/realtime | リアルタイムのメッセージ、クライアントの購読、サーバーのトピックの認可 |
@nocobase/repository-input | ブラウザーとサーバーで共有する照会の入力の取り決めとビルダー |
@nocobase/secrets | バージョン付きのキーと機密データの暗号化 |
@nocobase/service-provider | サービスコンテナ、トークン、依存性注入、ライフサイクル |
@nocobase/session | セッションとセッションの保存先 |
@nocobase/snowflake | Snowflake の ID の生成 |
@nocobase/document-extractor | 分離したドキュメントのテキスト抽出 |
@nocobase/markdown-mermaid | React Markdown での Mermaid の図 |
データベースのダイアレクト
| パッケージ | 用途 |
|---|---|
@nocobase/db-sqlite | SQLite |
@nocobase/db-postgres | PostgreSQL |
@nocobase/db-mysql | MySQL と MariaDB |
@nocobase/db-mssql | Microsoft SQL Server |
@nocobase/db-oracle | Oracle Database |
商用のダイアレクトには @nocobase/db-dameng、@nocobase/db-kingbase、@nocobase/db-oceanbase があります。接続のモードとバージョンの確認については データベースの対応状況とバージョンの互換性 を参照してください。
エージェントとリモートコマンドのパッケージ
| パッケージ | 用途 |
|---|---|
@nocobase/acp-bridge | ACP でローカルのコーディングエージェントを接続する |
@nocobase/agent-protocol | アプリ、Runner、リモートの CLI の通信プロトコル |
@nocobase/agent-runner | アプリに接続し、エージェントの実行を引き受けて実行する |
@nocobase/app-cli-client | アプリにサインインし、公開されたリモートの業務コマンドを呼び出す |
@nocobase/cli-envelope | CLI の JSON 出力の取り決めと Node のバージョンのチェック |
開発とテストのツール
| パッケージ | 用途 |
|---|---|
@nocobase/app-skills | アプリ開発、アップグレード、デプロイ、プラグイン開発のスキル |
@nocobase/app-testing | アプリとプラグインのテストのヘルパー |
@nocobase/db-testing | 分離したデータベースの環境と移植可能なテストのヘルパー |
@nocobase/db-testkit | データベースのダイアレクトで共有する統合テストの取り決め |
@nocobase/dev-config | 共有の TypeScript、ESLint、Vitest、Vite などの設定 |
@nocobase/create-app | アプリのひな形の生成 |
@nocobase/create-plugin | プラグインのひな形の生成 |
デプロイとホスティングのツール
| パッケージ | 用途 |
|---|---|
@nocobase/app-installer | デプロイのアーカイブからアプリをインストール、アップグレード、ロールバックする |
@nocobase/app-host | アプリのランタイムのホスティング |
@nocobase/app-host-docker | App Host の Docker のホスティングのバックエンド |
インストールとバージョン
依存関係の再現には、プロジェクトのロックファイルを使います。アップグレードでは、テンプレート、ランタイム、プラグインの peer 依存関係、データベースのダイアレクトをまとめて確認します。パッケージのバージョン番号はそれぞれ独立しており、メジャーバージョンで NocoBase 2 と 3 のどちらに属するかは決まりません。
アプリは pnpm create @nocobase/app@beta で、プラグインは pnpm create @nocobase/plugin@beta で作成します。その実装のパッケージは @nocobase/create-app と @nocobase/create-plugin です。アプリの中のコマンドについては コマンドラインリファレンス を参照してください。
検証の範囲
パッケージの名前、場所、用途は、2026-10-27 に Core のリビジョン 015404ecd0db と照合しました。ベータ版のバージョンは恒久的な互換性の基準ではありません。利用できるインターフェースは、インストールされた公開の入口と型の宣言で決まります。