现在要完成哪一步？
准备一个项目和可用的模型
- 已安装的 Orbit Agent 桌面应用。官网安装包尚未公开提供，见下载与版本。
- 一个允许 AI 读取的本地项目文件夹。初次尝试建议使用测试项目，不放入密钥或无关私密文件。
- 可用的模型服务地址、模型名称，以及服务要求的认证信息。
- 需要构建或测试代码时，本机还需安装对应的开发工具链。
Orbit Agent 账号、模型服务的 API Key 和远程服务权益是三件不同的事。登录应用不代表模型调用免费，也不自动获得远程执行权限。
完成首次配置
打开桌面应用
打开已核验的桌面版本。登录、注册或找回密码可先访问官网账号中心核验状态；官网登录不代表桌面账号入口已接通，应用连接状态以实际版本提示为准。
选择项目文件夹
在初始工作区点击“选择项目文件夹”，选择本次工作的目录。确认左侧出现正确项目，再开始对话；不要把整个磁盘当作初始项目。
配置并选择模型
在应用设置中添加模型提供方，保存服务地址和认证配置，再从对话输入区选择模型。详细步骤见下方“配置模型”。
检查操作权限
初次使用选择“请求批准”。当任务需要写入文件、运行命令或访问额外目录时，先核对操作内容。
发送一个只读任务
先让模型介绍项目结构。收到回答后，打开相关文件与轨迹，确认结果确实来自所选项目。
连接你自己的模型服务
- 打开应用设置中的模型提供方配置，选择“添加模型提供方”。
- 按服务提供方的资料填写协议类型、服务地址和模型名称，不混用不同服务的地址与模型 ID。
- 根据所选认证方式填写 API Key；本地或其他认证方式以配置页要求为准。不要把密钥写入对话或项目文档。
- 保存后回到对话输入区，选择对应提供方与模型，再发送一个简单问题验证连接。
“已保存配置”不等于“模型已连通”。如果报错，先核对服务地址、凭据权限、余额或配额，再查看错误信息。
模型服务费用、数据处理方式和附件支持由对应提供方决定。发送敏感项目内容前，应确认其使用规则和你的授权范围。
先读懂项目，不急着修改
在所选项目的新对话中，可以输入：
请先阅读当前项目的说明文件和主要目录。
用简短列表说明项目用途、入口和主要模块。
只读取内容，不修改文件，不运行命令。
如果缺少信息，请明确告诉我。完成后检查这三件事
- 回答是否对应你选择的项目，而不是泛泛而谈。
- 引用的文件是否存在，文件内容是否支持相应结论。
- 轨迹中有没有失败、权限不足或未执行的操作。
如果模型没有读取文件，不要把推测当作项目检查结果；可以要求它列出实际读取过的文件。
从最小授权开始
- 请求批准
- 涉及副作用的操作在需要时请求你的确认。批准前核对文件路径、命令、访问范围和可能影响。
- 完全访问
- 可用能力不再逐次询问，但仍受系统安全限制。它不等于无限制运行命令，也不会开启尚未接通的服务。
- 外部工作区
- 项目目录之外的访问需要单独授权。不要因为一次任务就授予无关目录的长期访问权。
权限提示或工具不可用时，不要通过关闭系统安全机制来绕过。先确认该能力在当前版本和环境中是否可用。
把需求说清楚，再逐步推进
整理文档
根据项目现有资料整理一份使用说明。
先给出大纲和需要补充的信息。
等我确认后，再写入指定文档。定位代码问题
分析这个错误与相关代码，列出可能原因和依据。
先提出最小修改方案，不要直接大范围重构。
修改获准后，运行已有的定向测试并报告结果。检查项目数据
读取项目中的指定 CSV 或 JSON 文件。
检查缺失值和字段不一致，输出检查结论。
只读检查，不改动原文件。任务涉及构建、测试、网络或数据修改时，实际执行还取决于本地工具链、模型能力与权限。需要了解完整范围时，查看产品功能。
看回答，也看执行记录
- 文件与预览：核对模型引用的文件和实际内容。
- 变更：查看本次任务涉及的文件操作，再结合项目的版本管理检查差异。
- 终端：查看命令记录、输出和失败原因；模型说“测试通过”不替代真实测试结果。
- 轨迹：查看步骤、工具结果与错误，分清已完成、失败和待批准。
- 恢复中心：任务中断时先看已有记录，确认是否已经产生改动，再决定是否重试。
中断后如何判断
- 先查看原任务状态、变更文件和最后一条工具回执；不直接发送相同任务。
- 若文件或外部状态已变化，逐项核对结果并保存必要备份，再决定继续还是撤销。
- 若状态不明，把任务留待人工复核；不要将“超时”“断线”当作“未执行”。
不要默认任务在重启后会自动续跑，也不要假设失败会自动撤销所有修改。
遇到问题，先检查什么？
提示需要选择项目，无法发送任务
先选择本地项目文件夹，确认项目仍存在且应用有权读取。输入框中的草稿不代表任务已经发送。
配置保存了，但模型没有响应
核对模型服务地址、协议和模型 ID，确认凭据有效且服务配额充足。查看应用显示的错误，不要在公开求助信息中附上 API Key。
文件没有改变，或者命令未执行
检查审批状态和执行轨迹。操作可能尚未获准、被安全限制阻止，或因本机工具链不可用而失败；不要仅凭回答文字判断成功。
任务中断后可以直接再发一遍吗？
先检查变更、终端和恢复记录，确认已有操作是否生效。重复发送可能造成重复改动，不应假设中断前什么都没做。
如何报告问题？
整理应用版本、操作步骤、脱敏后的错误信息和截图。不要提交密码、API Key、验证码、完整私人对话或无关项目文件。当前官网没有公开工单提交服务，请勿向陌生人提供远程访问权限。
页面入口与服务可用是两件事
官网账号是否可用以当前核验结果为准；购买订阅、安装包下载和远程执行仍未开放。受限远程站点的入口不代表已经取得控制权限；详见远程服务。在线更新、生产向量记忆和跨重启自动续跑不作为本指南的可用能力。
- 还没有桌面应用
- 先核对安装包状态。只从官网获取已开放的安装包，并核对版本与 SHA-256。Windows 发布者签名暂不提供；系统安全提示不应直接忽略。
- 想使用账号或找回密码
- 进入账号中心。核验服务状态后再选择登录、注册或找回密码；不要在第三方页面提交密码或验证码。
- 想从另一台设备工作
- 核对远程连接条件。设备在线、身份、权益、桌面审批与本机确认是分别检查的条件。
- 想购买或查看余额
- 查看钱包与订阅边界。没有权威服务端记录时，页面不显示金额、订单成功或权益。
本指南介绍桌面入口与操作方式，不代表已完成所有环境的生产验收。不同版本的名称和可用范围可能不同，以实际提示为准。