NestSpace ユーザーマニュアル¶
Android 上でアプリレベルの仮想スペースを実行する実験的なオープンソースプロジェクトです。
クイックスタート · アプリのインストールと管理 · よくある質問 · GitHub
NestSpace を選ぶ理由¶
- アクセシビリティサービスを有効にする必要がない：画面の観察、タップ、入力はアプリ内部のチャネルで直接行います。
- adb が不要：APK のインストール、複製（マルチインスタンス）、デスクトップの整理、AI アシスタントの利用まで、すべてスマートフォン上で完結します。
- root が不要：通常のアプリと同じようにインストールするだけで使え、システムを変更しません。
- Android バージョンの要件が緩い：Android 7.0（API 24）以降に対応し、7.1、15、16、17 で動作確認済みです。
まず知っておくべき制限¶
- アプリの互換性が最大の変動要因：すべてのアプリが正常に動作するわけではありません。加固（パッカー）、ネイティブ SDK、ホットアップデートなどが問題を引き起こす可能性があります。こうした問題は個別に対応して解決できるため、遭遇した場合は issue の提出を歓迎します。
- 同時に実行できる仮想アプリの数には制限がある：スマートフォンのメモリとコンテナスロットの制約により、同時に実行できるコンテナプロセスは最大 16 個です。デフォルトでは自動管理され、メモリが逼迫すると最も長く使われていないバックグラウンドコンテナを終了します。
マニュアルの構成¶
使い方¶
| ドキュメント | 内容 |
|---|---|
| クイックスタート | インストール、初回起動、アプリのインポート、起動と複製（マルチインスタンス） |
| アプリのインストールと管理 | APK / split のインストール、検証ルール、インスタンスとデータの分離、アンインストール |
| デスクトップと外観 | デスクトップアイコン、フォルダ、並べ替え、壁紙、実行管理 |
| 設定の詳細 | スペース設定の各項目とオプション |
| AI アシスタント | モデル設定、ストリーミング対話、音声アシスタント、自動メモリ／スキル起草、スケジュールタスク |
| 内蔵ブラウザ | タブ、ヘッドレスモード、ダウンロードとアップロード、プロキシ、ユーザーへの引き継ぎ |
| MCP 制御サービス | PC 接続、Token、LAN、CLI、外部 MCP |
| よくある質問 | インストール失敗、黒画面、バックグラウンドでの終了、接続失敗など |
リファレンス¶
| ドキュメント | 内容 |
|---|---|
| アーキテクチャと制限 | コンテナの実装、プロセスモデル、既知の制限 |
| MCP ツールリファレンス | すべての MCP ツールとパラメータ |
| アプリ / ウェブサイト知識パック | 知識パックの形式、マッチング、追加方法 |
| ソースからのビルド | 環境要件、ビルドコマンド、CI |
| nestspace-mcp CLI | コマンドラインクライアントのインストールと使用方法 |
| 技術設計 | 完全な技術設計（開発参考） |
表記規則¶
- 本文書における「空间设置」（スペース設定）は、デスクトップ上のスペース設定アイコンを指します。
- 「应用管理」（アプリ管理）、「模型设置」（モデル設定）などは、いずれもスペース設定内のサブページです。
- NestSpace は実験的なプロジェクトであり、アプリの互換性と同時実行数には制限があります。詳細はアーキテクチャと制限を参照してください。