RunWhale
ホームに戻る

よくある質問

RunWhale の疑問にお答えします

使い始める方法、端末上で動く処理、プロジェクトの制限、問題発生時の確認事項を紹介します。

最終更新:

以下から質問を選んでください。回答は、特定のプロバイダー、端末バージョン、配布経路を前提とせず、現在の製品の対応範囲を説明します。

はじめに

初めてエージェントを使う前に何が必要ですか?

設定 → モデルでプロバイダーとモデルを選び、有効な API キーを保存して端末をオンラインにします。その後、Web・Expo プロジェクトを作るか、対応リポジトリを読み込みます。

Web と Expo のどちらを選べばよいですか?

React のサイトを Web プレビューで動かすなら Web を選びます。RunWhale の固定のネイティブコンテナ内で React Native プロジェクトを動かすなら Expo を選びます。どちらも同じプロジェクト・エージェントの作業手順を使えます。

既存のリポジトリを読み込めますか?

RunWhale の Web・Expo ランタイムに対応していれば読み込めます。runwhale.json でエントリーポイントとプレビュー対象を指定します。未対応のネイティブコード、バイナリ、ビルド手順を必要とするリポジトリには対応していません。

ローカル実行とデータ

すべてローカルで動きますか?オフラインで使えますか?

ファイル、エージェントの制御、セッション、Node.js・TypeScript ツール、対応タスク、Git、Metro、プレビューは端末上で動作します。モデル推論は設定したリモートプロバイダーを使用します。Git のネットワーク操作や未キャッシュの依存関係の取得にもネットワークが必要なため、オフライン製品ではありません。

どのプロジェクト情報がモデルプロバイダーに送られますか?

エージェントの実行時には、依頼と回答に必要なプロジェクトやセッションの情報を選択したプロバイダーに送ります。依頼によっては、ソースコード、ファイル内容、画像、ツールの結果、会話履歴が含まれます。

API と Git の認証情報はどこに保存されますか?

モデル API キーと端末の Git 秘密鍵は、iOS キーチェーンまたは Android Keystore に保管されます。プロジェクトファイル、環境変数、Git 設定、エージェントセッション、ログ、プレビューバンドルには書き込まれません。

対応範囲と制限

非公開の Git リポジトリを使えますか?

GitHub のリポジトリを SSH で利用できます。設定 → Git SSH キーで端末の公開鍵を生成またはコピーし、GitHub に登録して、リポジトリの SSH URL を使います。秘密鍵は安全なストレージに残り、アクセスにはネットワークと GitHub 上の権限が必要です。

すべての npm パッケージをインストールできますか?

いいえ。npm レジストリの対応する純粋な JavaScript パッケージが対象です。ライフサイクルスクリプトとバイナリリンクは無効です。Git・パス依存、ネイティブアドオンやバイナリ、動的な Expo 設定プラグイン、プロジェクト固有のネイティブ SDK には対応していません。権限モードによってはインストールの承認を求められます。

独立した iOS・Android アプリをビルドできますか?

いいえ。ユーザープロジェクトは RunWhale 内の Web・React Native プレビューとして実行されます。Xcode、Gradle、EAS、IPA、APK のビルドは起動しません。

エージェントや Metro はバックグラウンドでも動き続けますか?

バックグラウンドでの継続動作を前提にしないでください。特に現在の製品では、iOS のバックグラウンド中にエージェントや Metro を継続実行しません。作業中やプレビューの準備中は RunWhale を前面に保ってください。

トラブルシューティング

エージェントが起動しないのはなぜですか?

選択したプロバイダーに有効な API キーが保存され、端末がオンラインであることを確認します。ローカルランタイムのエラーが出た場合は、プロジェクトを変更する前にランタイムを再起動して試してください。

Web・ネイティブプレビューが開かないのはなぜですか?

実行 / 再読み込みをタップし、runwhale.json に意図したプレビュー対象と対応する Web・ネイティブのエントリーが設定されているか確認します。Metro やプレビューの診断を読み、機密情報を含まない正確なメッセージを修正依頼に使ってください。

Git の clone・fetch・pull・push が失敗するのはなぜですか?

対応する HTTPS URL または GitHub SSH URL を使っているか確認し、ブランチ、接続、リモートの権限を確認します。SSH の場合は現在の端末公開鍵が GitHub に登録されている必要があります。pull には作業ツリーがクリーンであることも必要で、認証情報を埋め込んだ URL は拒否されます。

サポートへの報告には何を含めればよいですか?

RunWhale のバージョン、端末と OS、試した操作、正確なエラー、最小限の再現手順、機密情報を含まない診断を添えてください。API キー、秘密鍵、認証情報、非公開のプロジェクト内容、個人情報、未確認のログやスクリーンショットは含めないでください。

まだ解決しませんか?

最初から最後までの手順はガイドをご覧ください。非公開の相談や再現可能な問題はサポートにお問い合わせください。