跳转到主要内容
Quest Mode 是一项 AI 辅助的编程功能，专为复杂、长时运行的开发任务而设计。你只需用自然语言描述需求，便可将功能开发、缺陷修复、重构与测试等任务交给 AI 执行，从而大幅提升开发效率。
Quest Mode 现已支持本地和远程两种执行模式，可以根据场景选择最符合你需求的选项。
AI 辅助规格说明（Specs）
AI 助手会分析你的项目并自动生成详细的技术设计文档（Spec）。这可确保对任务形成共同理解，并使 AI 的执行与你的目标保持一致。
自主执行
当 Spec 完成或你的需求已澄清后，AI 可开始异步执行任务。你可以通过 操作轨迹 视图实时监控进度，该视图展示执行计划、正在进行的操作以及遇到的任何问题。
AI 辅助任务报告
完成后，AI 会生成任务报告，总结变更、测试结果和验证结论。这有助于你在决定接受或完善结果之前，快速评估工作的质量与完整性。
远程委派
在最终确定 Spec 设计后，你可以按需选择在本地或云端委派执行。我们推荐使用云端执行，可以获得更佳体验，包括融合智能调度、安全沙箱与IDE原生体验等。
- 点击 新建任务。
- 选择相关的上下文（如项目文件或代码片段），并用自然语言输入任务描述。
- 选择工作流
- 设计并执行： 在执行前先定义任务规范。适用于复杂改动。
- 直接执行： 立即执行命令。适用于简单、快速的任务。
- 选择执行环境
-
本地模式： Local： 在本机直接运行任务，使用
git worktree 自动隔离代码变更并防止并发操作产生冲突。适合快速测试和即时反馈。所有文件修改都会应用到你当前的项目。
提示： 建议在 Settings > Quest Mode 中配置启动脚本，以便每当 Qoder 创建新的 worktree 时初始化目录。适用于安装依赖和设置环境，确保每个任务都在一致且可直接运行的状态下启动。
-
远程模式： 将任务委派到强大的云端环境。适合长时或资源密集型作业，使本机保持空闲并在沙盒中更安全。更改会自动同步回 IDE。
依赖： 远程模式需要已配置的 Git 仓库。请先在 Settings > Quest 模式 中完成设置再继续。目前仅官方支持 GitHub。
- 点击 发送 或按 Enter 开始。AI 将根据你的输入开始起草详细的 Spec，或直接执行。
在设计阶段，AI 会：
- 审阅你项目的记忆和工程上下文
- 分析代码库的结构
- 生成一份完整的 Spec 文档
生成 Spec 后，你可以自行编辑，或与 AI 一起打磨。它会自动保存到你项目中的 .qoder/quest 目录。
当你对 Spec 感到满意时，点击右上角的 开始任务 开始执行。
任务开始后，你将进入操作流程视图，其中展示：
- AI 的执行计划
- 实时输出和日志
- 进度状态及任何阻塞项
对于简单任务，AI 可能会跳过生成详细计划，直接执行实现。
你可以随时添加新需求——即使任务正在运行——只需在聊天框中发送消息。AI 会相应调整计划并继续工作。
当任务完成后，系统会切换到任务报告视图。AI 会提供结构化摘要，包括：
- 已完成的代码更改的总结
- 测试结果与验证结论
- 变更文件的详细列表
你可以分别查看每个代码文件的变更，并可以进行以下操作：
本地模式
- 点击 接收 将所有建议的更改应用到本地文件，并归档该任务。
- 点击 废弃 撤销所有更改，将文件恢复到任务运行前的状态。
- 点击 结束 在不应用任何更改的情况下关闭任务。若未修改代码，优先使用此选项。
远程模式
- 点击 检出到本地 将远程分支拉取到本机，以便进一步审查、本地测试或追加编辑。
- 点击 创建 PR 在你的 Git 平台上创建一个 pull request，启动正式的代码评审与合并流程。
- 点击 结束 关闭任务。此操作不具破坏性；远程分支和已创建的 pull request 都会被保留。
如果需要继续处理，返回到 **操作轨迹 **视图，发送新消息，AI 将从上次中断处接着执行。 
