先探索一下。选择您的权限。
计划模式对于项目和外部状态是只读的。 工作模式可以准备更改并运行支持的工作流程。它默认为审核编辑，并做出明确的应用或拒绝决定。您可以为符合条件的项目脚本单独授权自动应用。
如果在计划轮换期间请求实施，Orca可以请求一次切换模式。它等待留在计划中或切换到工作。该选择与编辑权限是分开的；明确记住的项目首选项可以在符合条件的工作会话中提供新的自动应用权限。
提案不是写入。
- 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 帐户刷新/会话凭据使用操作系统保管库，而访问令牌保留在内存中。项目对话历史记录（包括提交的图像和脚本引用）以纯文本 JSON 形式本地存储在 Godot 的 user:// 存储中。提供者 EditorSettings 和会话 JSON 不是加密的凭证库存储。
自动编辑检查点还会在本地会话 JSON 中存储有限的精确先前/建议的脚本源。它们被排除在提供商延续和支持报告之外，并随对话一起删除。记住的自动应用首选项存在于精确项目本地 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。