Quest Mode

​

概述

​

核心特性

​

自主编程

• 顶尖模型加持：使用全球领先 AI 模型，一步到位的最优效果
• 需求对齐机制：意图识别、需求澄清、共创 Spec，执行前把任务交代清楚
• 长程任务能力：大幅提升长时间持续执行能力，Agent 监督任务运行完毕
• 质量自主保障：集成结果验证能力，自主验证、修复交付物质量

​

持续自主进化

• 记住你的代码风格和项目规范
• 持续学习领域前沿技术
• 越用越懂你

​

支持更多应用场景

• Spec 驱动开发：先对齐需求与约束，再执行并验收，确保结果清晰、可追溯
• 从想法到产品：支持 0-1 创建网站和原型，集成顶尖视觉模型，大幅提升设计质量和可用性

​

长程与并行

• Local + Remote 并行执行：效率翻倍
• 支持数小时长程任务：自动处理中断和恢复
• 弹性 Sandbox：万级并发支持

​

Skills 扩展能力

• 如果要使用 Skills 能力，Quest 1.0 中只需要安装 Skill 到 {project}/.qoder/skills

​

开始使用

​

切换到 Quest 模式

• Editor 模式：实时协作编程，一问一答
• Quest 模式：任务委派，自主执行，放手交付

1. 打开 Settings > Quest Mode
2. 设置 Quest Mode Layout 选项
3. 选择每次打开项目时默认使用的模式

​

创建任务

​

入口

​

选择场景

• 不选场景：Quest 会自动判断最合适的方式
• 选择 Spec 驱动：一定会生成 Spec 文档
• 选择 搭建网站 / 原型探索：完全跳过 Spec，快速执行

​

Spec 驱动模式

​

适用场景

• 功能开发、Bug 修复、代码重构
• 需要明确技术方案和验收标准
• 多人协作、需要文档留存

​

工作流程

​

1. 需求澄清

• 推荐：让 Quest 自动选择默认答案
• 继续：手动选择后继续
• 跳过：跳过问题，直接对话

​

2. 生成 Spec

• 需求描述
• 设计方案
• 任务拆分
• 验收标准

​

3. 审核 Spec

• 在右侧 Spec Tab 查看完整文档
• 通过对话修改 Spec（点击 运行 前可随时调整）
• 满意后点击 运行 Spec 开始执行

​

4. 执行与监控

• To-do List：实时显示任务进度（对话区）
• Changed Files：查看代码变更（产物区）
• 中途追加：随时在对话框追加需求，Quest 会调整计划

​

5. 验收结果

• Accept（Local 模式）：应用所有修改到工作区
• Reject（Local 模式）：放弃所有修改
• Apply（Parallel 模式）：合并到主分支
• Create PR（Remote 模式）：创建 Pull Request

​

搭建网站 / 原型探索模式

​

适用场景

• 快速创建网站或 App 原型
• 验证产品想法
• 不需要复杂技术文档

​

工作流程

​

1. 描述想法

示例（网站）：
"创建一个旅行博客网站，包含首页、文章列表、文章详情页，
使用现代设计风格，支持响应式布局"

示例（原型）：
"做一个待办事项App，支持添加、删除、标记完成，
用卡片式设计，带优先级标签"

​

2. 自动执行

• Quest 自动选择技术栈（常见 Web 框架）
• 无需 Spec，直接编写代码
• 代码完成后自动运行预览

​

3. 实时预览

• 产物区自动打开 Preview Tab
• 实时查看运行效果
• 如果页面报错，Quest 自动检查并修复

​

4. 迭代优化

"把主色调改成蓝色"
"添加一个搜索框"
"优化移动端显示"

​

执行环境

​

Local（本地）

• 特点：直接在主工作区修改，零启动成本
• 适合：简单任务、快速验证
• 多任务支持：支持多个 Local 任务并行

​

Parallel（并行）

• 特点：后台创建隐藏工作区，主分支保持干净
• 适合：中等复杂任务、多任务并行
• 优势：可以无限次 Apply 迭代

​

Remote（云端）

• 特点：远程容器执行，本地可关机断网
• 适合：复杂长程任务、资源密集型作业
• 依赖：需要配置 Git 仓库（目前支持 GitHub）
• 多任务支持：支持无限制并行

• 有 Git 仓库 → 支持全部三个环境
• 无 Git 仓库 → 只能使用 Local

​

界面布局

​

三栏布局

​

任务列表

• New Quest：创建新任务
• 任务状态：
  • Running：执行中
  • Action Required：等待操作
  • Ready：已完成，可继续对话
  • Error：执行错误
• 任务按最后交互时间排序

​

对话区

• 显示对话历史
• To-do List 实时更新（执行阶段）
• 输入框底部可压缩上下文，优化提示词

​

产物区

• Spec Tab：查看/下载 Spec 文档（Spec 驱动模式）
• Changed Files Tab：查看代码变更、Accept/Discard
• Preview Tab：实时预览运行效果（网站/原型模式）

​

商业化说明

​

使用限制

• Pro 用户：正常使用，但 Credits 耗尽后无法继续
• Free 用户：需要 Credits 才能使用

​

Credits 不足时

• 无法发起新任务
• 任务进行中 Credits 耗尽
• 任务会终止
• 显示升级提示

​

常见操作

​

暂停/继续任务

• 任务执行中，点击 暂停 按钮
• 任务暂停后，点击 继续 恢复执行

​

追加需求

"再加一个用户登录功能"
"优化一下性能"

​

删除任务

• 右键任务或悬停显示菜单
• 点击 Delete 并确认

​

最佳实践

​

写好任务描述

❌ "优化代码"
✅ "重构 UserService，拆分成多个小函数，添加单元测试"

❌ "做个网站"
✅ "创建一个旅行博客，包含首页、文章列表、详情页，使用 Next.js"

• 选择相关文件或代码片段
• 说明期望的技术栈
• 提及设计风格或参考

​

选择合适的场景

• Spec 驱动：复杂功能、需要文档 → 严格执行
• 搭建网站：快速搭建 → 所见即所得
• 原型探索：验证想法 → 快速迭代
• 不确定：不选场景，让 Quest 自动判断

​

选择合适的环境

• Local：改个 Bug、调整样式 → 快速反馈
• Parallel：开发新功能、重构模块 → 隔离安全
• Cloud：复杂重构、数据迁移 → 长程稳定

​

善用 Spec

• 选择 Spec 驱动 场景，确保复杂任务有明确方案
• Spec 生成后通过对话调整，而非手动编辑
• 简单任务选择其他场景，跳过 Spec

​

迭代优化

• 先让 Quest 完成基础版本
• 查看效果后，继续对话调整
• 支持无限次迭代，直到满意