まずは探索してみよう。権限を選択してください。
計画モードは、プロジェクトと外部状態に対して読み取り専用です。 作業モードでは、変更を準備し、サポートされているワークフローを実行できます。デフォルトでは、編集をレビューし、明示的に 適用 または 拒否 を決定します。対象となるプロジェクト スクリプトに対して、自動適用を個別に承認できます。
計画ターン中に実装が要求された場合、Orca はモードの切り替えを 1 回要求できます。 計画を維持するか、仕事に切り替えるまで待機します。この選択は編集権限とは別のものです。明示的に記憶されたプロジェクト設定により、対象となる作業セッションに新しい自動適用権限を提供できます。
提案書は文書ではありません。
- Orca は、制限されたリクエストスコープのエディターコンテキストをキャプチャします。
- タスクに必要なプロジェクト情報を、限定されたツールを通じて検査します。
- 作業モードでは、不変の提案が準備されます。
- 提案は検証され、専用のレビュー カードに表示されます。
- 適用 または 拒否 を選択するか、明示的に承認された自動適用許可が適格なスクリプト プロポーザルに適用されます。
- 置換する前に、Orca はターゲット、ハッシュ、エディターの状態、検証、および承認を再チェックします。自動編集では、書き込み前に永続化されたチェックポイントも必要です。
ファイル提案はハッシュ バインドされ、古い状態または未保存の状態がチェックされます。自動編集では、同じインラインの赤/緑の差分と拡張レビューが維持されます。元に戻すには競合チェックが行われ、有効なチェックポイントと変更されていないターゲットが必要です。
スコープが定義された権限。
自動適用には、作業モードでの明示的な 編集を許可 の確認が必要です。 addons/ の外側にある、制限されたスタンドアロン プロジェクト .gd のパッチをカバーします。大規模なパッチ、シーン/構成の変更、アドオン スクリプト、およびスクリプト実行の信頼は、明示的なレビューを保持します。複数ファイルのトランザクション承認は提供されません。
このプロジェクトを保存するを確認しない限り、権限はセッションのみです。その正確なプロジェクト設定は EditorSettings にローカルに保存され、設定 → システム → スクリプト編集 で管理できます。新しいセッション、履歴の復元、計画、およびリロードにより、古いランタイム許可がクリアされます。対象となる作業セッションは、保存された設定から新たな権限を取得できます。プランと表示専用の履歴は読み取り専用のままです。
ORCA の横にある緑色の編集アイコンをクリックすると、ターン中を含め、すぐに自動適用を取り消し、記憶されているデフォルトをクリアします。検証、新しいハッシュ、未保存状態のチェック、パス保護は引き続きすべての書き込みに適用されます。チェックポイント ストレージに障害が発生すると、サイレントに権限を再取得することなく自動編集が一時停止されます。
停止 は、それ以上のアクションを防止し、完了した編集を保存します。 元に戻すは、個別の明示的なアクションです。 編集権限を設定する →
明示的に回復します。現在の状態を確認します。
自動スクリプト チェックポイントは、履歴の差分の正確な以前/提案されたソースを保持し、再起動後に競合チェックが行われた状態に戻します。中断されたレコードでは回復のチェックが提供され、編集の再生や復元の許可は得られません。
リカバリは 会話ごとに 64 チェックポイント / 4 MiB に制限されており、各ソース バージョンは最大 256 KiB / 8000 行です。保留中の承認と手動/構造化された元に戻すチェックポイントはメモリのみのままです。 スクリプトの回復について学ぶ →
デザインに縛られる。
- プロジェクトへのアクセスは
res://内に留まり、シンボリック リンクのトラバーサルを拒否し、Orca 独自のアドオン ディレクトリをエージェント ツールから除外します。 - 既知の未保存のスクリプトとシーンは、提案によって上書きできません。
- 既存のファイルには、Orca のファイル リーダーから返される正確な SHA-256 が必要です。
- サポートされている GDScript プロポーザルは、レビュー前および作成直前に検証されます。
- ツールのラウンド、検索、読み取り、応答、ネットワークの非アクティブ性、および所有されているゲーム プロセスには制限があります。
- プロバイダー構成はターンごとにスナップショットされるため、ツール ループがエンドポイントやモデルをサイレントに切り替えることはできません。
何が送信され、保存されているかを把握します。
リクエストとエンドポイント
ツールから返されるプロンプト、添付画像、関連するエディター コンテキスト、およびプロジェクト コンテンツは、選択したプロバイダーに送信される場合があります。ローカルでホストされているエンドポイントは、受信したデータを他の場所に転送する可能性があります。 Orca では、リクエストを受信した後にサーバーが何を行うかを確認できません。
編集可能な LAN およびリモート エンドポイントでは、正確なスキーム、ホスト、および有効なポートを確認する必要があります。 Orca は、暗号化されていない非ループバック HTTP を識別し、プロバイダー チャットやモデル検出リダイレクトに従いません。確認はインフォームド・コンセントであり、信頼性の証明ではありません。
ローカルストレージ
BYOK API 認証情報は、Godot エディターの設定を通じて保存されます。管理対象 Orca アカウントのリフレッシュ/セッション認証情報はオペレーティング システム ボールトを使用しますが、アクセス トークンはメモリ内に残ります。送信された画像やスクリプト参照を含むプロジェクトの会話履歴は、Godot の user:// ストレージにプレーンテキスト JSON としてローカルに保存されます。プロバイダー EditorSettings と会話 JSON は、暗号化された資格情報保管庫ではありません。
自動編集チェックポイントはさらに、ローカル会話 JSON に、限定された正確な以前の/提案されたスクリプト ソースを保存します。これらはプロバイダー継続レポートおよびサポート レポートから除外され、会話とともに削除されます。記憶された自動適用設定は、プロジェクト ファイルと履歴の外にある、exact-project ローカル EditorSettings に保存されます。リカバリレコードが許可を与えることはありません。
保留中の添付ファイルの下書きはメモリ専用です。送信された画像は、プロジェクトを対象とした会話内で重複が排除され、会話の削除または保持によって削除されます。保存された各会話には、16 MiB セッション JSON 制限内で最大 32 個の一意の画像と 8 MiB のデコードされた画像データが保持されます。イメージ参照が欠落しているか破損していると、復元は表示のみになります。
プロジェクトの指導と診断
境界付きルート res://AGENTS.md 命令とプロジェクト スキル カタログ メタデータ (存在する場合) は、プライベート リクエスト スコープのコンテキストに含まれます。選択されたスキル本体は、明示的なスキル読み込みツール呼び出しの後にのみ送信されます。一時指導はターン終了後に再開可能履歴から削除されます。
[バージョン情報] ページでは、バージョンとプロバイダ/リクエストの大まかな状態を含むホワイトリストに登録された診断レポートをコピーできます。これには、資格情報、エンドポイント アドレス、モデル ID、プロジェクトのパスとコンテンツ、会話、モデル出力、ログ、プロセス出力、変更、およびハッシュは含まれません。
明確な限界。より良い期待が高まります。
- Orca 1.7.0 は Godot 4.7.2 をサポートします。現在のところ、より広範な互換性は主張されていません。
- デスクトップ イメージのドロップでは、別の添付ウィンドウを使用する必要があります。メインの Godot エディタに直接ドロップするか、Godot のインポート ハンドラーをドック呼び出しします。ネイティブ添付ファイルのドロップは Linux/X11/Vulkan で確認されました。他のプラットフォーム、レンダラー、分離されたウィンドウについては、引き続き受け入れテストが必要です。
- 画像機能のメタデータと明示的なオーバーライドは、ライブモデルのビジョン品質を確立しません。 PDF、ドキュメント、OCR、自動スクリーンショット キャプチャは含まれません。
- 実行時検証では、制限されたプロセス出力から狭い開始基準または終了基準を評価します。ビジュアルやゲームプレイの正確性を証明することはできません。
- 保留中の承認と手動/構造化された元に戻すチェックポイントは、エディターまたはプラグインを再起動すると存続しません。永続的なリカバリをサポートするのは、制限された自動スクリプト チェックポイントのみです。
- 構造化されたシーン操作は、制約されたノード、値、依存関係、および信号のセットをサポートします。
- Godot は候補の構築中にプロジェクト コードを実行する可能性があるため、スクリプトのアタッチとデタッチには別個の信頼と準備の決定が必要です。これはサンドボックス化ではなく、インフォームド・コンセントです。
Orca は、ソース管理、コード レビュー、バックアップ、プロジェクトのテストを補完します。それらに代わるものではありません。
詳細については、SECURITY.md および DEVELOPMENT.md を参照してください。