Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.

Quest Mode

概述

Quest Mode 是 Qoder 的自主编程功能，让 Agent 端到端完成开发任务。你只需描述目标，Quest 会自主澄清需求、规划方案、执行代码、验证结果——无需持续人工介入。

核心理念：Define the goal. Review the result.

---

核心特性

自主编程

Agent 自主完成高质量、端到端、可交付的结果，无需持续人工介入：

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

持续自主进化

不只是执行，更会主动进化：

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

支持更多应用场景

Quest 对用户输入进行意图识别，自动路由最适配的能力：

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

长程与并行

任务可在本地和云端同时运行数小时，遇到问题自动修复，交付前自动完成验收：

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

Skills 扩展能力

通过 Skills 扩展 Quest 的能力边界：

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

---

开始使用

切换到 Quest 模式

Qoder 提供两种工作模式：

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

切换方式：点击左上角的 Editor / Quest 切换按钮

设置默认模式：

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

---

创建任务

入口

点击左侧任务列表顶部的 New Quest 按钮

选择场景

Quest 提供三种场景，根据需求选择：

场景	适用情况	Quest 行为
Spec 驱动	复杂功能开发、重构、需要严格质量把控	先对齐需求范围，设计实施方案和验收标准，再开始执行
搭建网站	0-1创建网站、快速原型	描述你要搭建的网站，Quest 会搭建页面和整体结构
原型探索	快速验证想法、创意实验	从一个想法开始，Quest 会将其转化为可运行的原型

场景选择规则：

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

注意：任务开始后，不能切换场景。

---

Spec 驱动模式

适用场景

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

工作流程

1. 需求澄清

输入任务后，Quest 可能会提出澄清问题（以选择题形式）：

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

2. 生成 Spec

选择 Spec 驱动 场景后，Quest 会生成结构化 Spec 文档：

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

Spec 会在产物区的 Spec Tab 展示，支持流式输出和下载。

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. 迭代优化

继续对话调整：

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

---

执行环境

Quest 支持三种执行环境，根据任务特点选择：

Local（本地）

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

Worktree（并行）

• 特点：后台创建隐藏工作区，主分支保持干净
• 适合：中等复杂任务、多任务并行
• 优势：可以无限次 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：实时预览运行效果（网站/原型模式）

---

商业化说明

使用限制

所有用户都需要 Credits 才能使用 Quest：

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

Credits 不足时

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

---

常见操作

暂停/继续任务

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

追加需求

执行过程中，直接在输入框发送新需求：

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

Quest 会调整计划并继续工作。

删除任务

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

---

最佳实践

写好任务描述

清晰具体：

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

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

提供上下文：

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

选择合适的场景

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

选择合适的环境

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

善用 Spec

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

迭代优化

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