跳转到主要内容
Quest Mode 是 Qoder 的自主编程功能，让 Agent 端到端完成开发任务。你只需描述目标，Quest 会自主澄清需求、规划方案、执行代码、验证结果——无需持续人工介入。 核心理念：Define the goal. Review the result.

​
核心特性

自主编程

顶尖模型加持，需求对齐机制，长程任务能力，质量自主保障——Agent 端到端交付高质量结果

持续自主进化

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

多场景适配

意图识别自动路由：Spec 驱动开发确保结果可追溯，从想法到产品 0-1 创建网站和原型

长程与并行

Local + Worktree + Remote 三环境并行数小时，自动处理中断恢复，弹性 Sandbox 万级并发

Skills 扩展

安装 Skill 到项目即可使用，内置多个开箱即用的 Skill 命令

​
切换到 Quest 模式

Qoder 提供两种工作模式：
  • Editor 模式：实时协作编程，一问一答
  • Quest 模式：任务委派，自主执行，放手交付
切换方式：点击左上角的 Editor / Quest 切换按钮
在 Qoder Settings > Quest Mode 中可以设置 Quest Mode Layout，选择每次打开项目时默认使用的模式。

​
创建任务

点击左侧任务列表顶部的 创建 Quest 按钮。

​
选择场景

Quest 提供三种场景，根据需求选择：
场景适用情况Quest 行为
Spec 驱动复杂功能开发、重构、需要严格质量把控先对齐需求范围，设计实施方案和验收标准，再开始执行
原型探索快速验证想法、前端原型、创意实验从一个想法开始，Quest 会将其转化为可运行的原型
创建工具快速搭建自动化工具描述你需要的工具，Quest 会创建可运行的自动化工具
场景选择规则：
  • 不选场景：Quest 会自动判断最合适的方式
  • 选择 Spec 驱动：一定会生成 Spec 文档
  • 选择 原型探索 / 创建工具：完全跳过 Spec，快速执行
任务开始后不能切换场景，请在开始前确认。

​
Spec 驱动

适用场景：功能开发、Bug 修复、代码重构；需要明确技术方案和验收标准；多人协作、需要文档留存。 工作流程：
1

需求澄清

输入任务后，Quest 可能会以选择题形式提出澄清问题：
  • Recommend：让 Quest 自动选择默认答案
  • Continue：手动选择后继续
  • Skip：跳过问题，直接对话
2

生成 Spec

Quest 会生成结构化 Spec 文档：
  • 需求描述
  • 设计方案
  • 任务拆分
  • 验收标准
Spec 在产物区的 Spec Tab 展示，支持流式输出和下载。
3

审核 Spec

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

执行与监控

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

验收结果

执行完成后：
  • Accept（Local）：应用所有修改到工作区
  • Reject（Local）：放弃所有修改
  • Apply（Worktree）：合并到主分支
  • Create PR（Remote）：创建 Pull Request

​
原型探索

适用场景：快速创建网站或 App 原型；验证产品想法；不需要复杂技术文档。 工作流程：
1

描述想法

直接描述你想要的网站/原型：
示例：
"创建一个旅行博客网站，包含首页、文章列表、文章详情页，
使用现代设计风格，支持响应式布局"

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

自动执行

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

实时预览

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

迭代优化

继续对话调整：
"把主色调改成蓝色"
"添加一个搜索框"
"优化移动端显示"

​
创建工具

适用场景：快速搭建自动化工具、CLI 脚本、数据处理管线等。 工作流程：
1

描述需求

直接描述你想要的工具：
"创建一个批量图片压缩工具，支持 PNG 和 JPEG 格式"
"做一个 CSV 数据清洗脚本，自动去重和格式化"
2

自动执行

  • Quest 自动选择合适的技术方案
  • 无需 Spec，直接编写代码
  • 完成后自动运行验证
3

迭代优化

继续对话调整功能或添加新特性，直到满意。

​
选择执行环境

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

​
本地模式

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

​
Worktree模式

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

​
远程模式

  • 特点：远程容器执行，本地可关机断网
  • 适合：复杂长程任务、资源密集型作业
  • 依赖：需要配置 Git 仓库（目前支持 GitHub）
  • 多任务支持：支持无限制并行
默认环境：
  • 有 Git 仓库 → 支持全部三个环境
  • 无 Git 仓库 → 只能使用 Local
所有执行环境都支持多任务并行。

​
暂停/继续任务

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

​
追加需求

执行过程中，直接在输入框发送新需求： 
"再加一个用户登录功能"
"优化一下性能"
Quest 会调整计划并继续工作。

​
编辑已发送消息

该功能在除 Experts 模式以外的所有模式中均可使用。
你可以在对话中直接修改此前发送的消息并重新提交。当提示词表达不够准确、上下文需要调整或想切换模型重新获取回复时，无需重新开启对话，直接编辑原消息即可。 进入编辑状态后，你可以：
  • 修改提示词：重新编辑你输入的文字内容，优化问题描述或调整指令表达
  • 修改附带上下文：增删或替换消息中附带的上下文信息，如文件、代码片段等
  • 切换模型与模式：在编辑状态下切换到不同的模型或对话模式，以获得更合适的回复
点击你此前发送的消息气泡即可进入编辑状态。修改完成后重新提交，Qoder 将基于更新后的内容重新生成回复。
工作区文件将回滚：重新提交编辑后的消息时，工作区中的代码和文件会回滚到该轮对话之前的状态。从这条消息开始（包括这条消息在内）产生的所有文件变更都将被丢弃。例如，你在第 3 轮对话中修改了一段代码，随后回到第 2 轮对话进行编辑并重新提交，那么第 2 轮和第 3 轮中所有文件改动都会被撤销，工作区会恢复到第 1 轮对话结束后的状态。你可以在 Diff View 中同步查看变更回滚的结果。编辑状态下暂不支持上下文压缩和一键优化提示词功能，需手动调整。

​
删除任务

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

​
界面布局

Quest Mode 采用三栏布局：左侧为任务列表，中间为对话区，右侧为产物区。

​
任务列表

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

​
对话区

  • 显示对话历史
  • To-do List 实时更新（执行阶段）
  • 输入框底部可压缩上下文，优化提示词
  • 在输入框中使用 @ 可引用文件、文件夹、代码符号等上下文——详见上下文
  • 点击输入框右侧的麦克风图标可使用语音输入

​
产物区

  • Spec Tab：查看/下载 Spec 文档（Spec 驱动场景）
  • Changed Files Tab：查看代码变更、Accept/Discard
  • Preview Tab：实时预览运行效果（原型探索 / 创建工具场景）

​
扩展能力

​
内置 Skills

通过 Skills 扩展 Quest 的能力边界——将 Skill 安装到 {project}/.qoder/skills 即可使用。Quest 还内置了多个可在对话中直接调用的 Skill：
  • /create-skill-ui：为 Skill 创建交互式 HTML Widget 界面
  • /vercel-deploy：通过自动化工作流将 Web 项目部署到 Vercel
  • /create-skill：创建一个新的 Skill
  • /create-subagent：创建一个新的自定义智能体
  • /generate-structured-prd：生成结构化 PRD 文档

​
Skill UI

Skill UI 支持 Agent 在执行过程中直接渲染可交互的 HTML 组件，例如表单、图表、配置面板等。生成的组件内嵌在对话流中，你可以直接在会话内完成交互操作，无需跳转到外部页面。首次使用时需要让 Agent 为对应 Skill 创建界面。 在 Quest Mode 的对话中使用 /create-skill-ui 命令。Agent 会为指定 Skill 创建 HTML Widget 界面，你可以通过实时预览迭代设计后保存为模板文件。

​
Vercel Deploy

/vercel-deploy 是 Quest Mode 下的一键部署能力。通过自动化工作流，将你的 Web 项目部署到 Vercel，覆盖 CLI 安装、OAuth 授权、项目构建到正式上线的完整流程。 在 Quest Mode 的对话中使用 /vercel-deploy 命令，Qoder 将自动启动部署工作流。首次部署时，Qoder 会引导你完成 Vercel OAuth 登录授权。按照提示在浏览器中完成账号关联即可。授权完成后，Qoder 将自动执行项目构建并部署到 Vercel 生产环境。部署成功后，你会获得一个可访问的线上链接。
  • 需要 Vercel 账号：部署前需确保你已注册 Vercel 账号。若尚未注册，可在授权流程中完成创建。
  • 项目需为可构建的 Web 应用：Vercel 支持 Next.js、React、Vue、Svelte 等主流框架。如果项目缺少有效的构建配置，部署可能会失败。建议在部署前确认项目可在本地正常构建。

​
Supabase 集成

Supabase 是一个开源的 Firebase 替代方案，提供 PostgreSQL 数据库、用户认证、文件存储和实时数据同步等后端服务。Quest Mode 支持直接授权并连接 Supabase 项目，让你在 IDE 内一站式完成前端开发与后端数据管理，无需在浏览器和编辑器之间来回切换。 你可以同时连接多个 Supabase 项目，并在 IDE 内直接预览数据库表结构（Schema），实时掌握后端数据模型。 核心功能：
  • 多项目连接：支持授权并连接多个 Supabase 项目，方便在不同环境（开发、测试、生产）或不同业务之间快速切换。
  • 数据库表结构预览：在 IDE 内直接查看已连接项目的数据库表结构，包括表名、字段、类型和关系等信息，无需打开 Supabase Dashboard。
  • 增强的数据库能力：AI 智能体可以感知你的数据库结构，根据任务需求自动生成建表语句、数据模式和查询逻辑，确保前后端数据模型一致。
  • 一键授权：通过 OAuth 授权流程安全连接 Supabase，无需手动配置 API Key 或连接字符串。
支持的 Supabase 服务：
  • 数据库（PostgreSQL） — 完整的 SQL 支持，用于存储和查询应用数据。AI 可根据你的指令自动生成所需的表和数据模式。详情参阅 Supabase Database 文档。
  • 用户认证 — 安全管理用户注册、登录和访问权限。支持多种认证方式，包括邮箱/密码登录以及 Google、GitHub 等 OAuth 登录。详情参阅 Supabase Auth 文档。
  • 文件存储 — 通过 Supabase Storage 上传和管理图片或其他文件，适用于用户头像、文件上传及各种静态媒体资源。详情参阅 Supabase Storage 文档。
  • 实时更新 — 将数据变更实时推送到应用，支持在线聊天、动态信息流、协作式仪表板等场景。详情参阅 Supabase Realtime 文档。
如何使用： 在 Quest Mode 下构建项目时，如果 AI 判断有必要连接 Supabase，它会在聊天面板中给出提示。你也可以随时主动连接：
1

准备 Supabase 项目

前往 Supabase 注册账号，并创建组织和项目。
2

授权连接

在 Quest Mode 中，点击工具面板顶部的 Supabase 标签页，点击 Authorize 按钮，按照提示完成 OAuth 授权流程，选择你的 Supabase 组织并确认授权。
3

关联项目

授权完成后，面板中会显示你的组织和项目列表。找到目标项目，点击 Connect 按钮即可将当前 Quest 项目与 Supabase 项目关联。
4

开始开发

连接成功后，你可以直接在 Supabase 面板中预览数据库表结构，AI 也将基于这些结构信息辅助你的开发工作。
Qoder 项目只能连接到处于活跃状态的 Supabase 项目。如需切换组织，可点击组织名称旁的切换按钮。
适用场景：
  • 全栈应用快速搭建：在 Quest Mode 中描述应用需求，AI 自动生成前端界面并配置 Supabase 后端，包括数据库建表、认证流程和存储策略。
  • 数据模型设计与验证：通过 IDE 内的表结构预览，实时检查 AI 生成的数据模型是否符合预期，及时调整后继续开发。
  • 多环境管理：同时连接开发和生产环境的 Supabase 项目，在不同环境之间方便地查看和对比数据结构。
AI 生成的数据库操作（如建表、修改 Schema）会直接作用于已连接的 Supabase 项目。对生产环境的操作，请在确认无误后再执行。
  • 权限安全：授权过程通过 OAuth 进行，Qoder 不会存储你的 Supabase 密码。建议仅授权必要的组织和项目，遵循最小权限原则。
  • 网络依赖：Supabase 集成需要网络连接以访问 Supabase 云端服务。请确保网络环境正常。

​
计费说明

​
限制

所有用户都需要 Credits 才能使用 Quest：
  • Ultra / Pro+ 用户：订阅包含更高的每月 Credits 配额
  • Pro 用户：订阅包含每月 Credits 配额，Credits 耗尽后无法继续使用
  • Free 用户：包含有限的免费 Credits，可购买额外 Credits 继续使用 Quest

​
Credits 不足时

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

​
最佳实践

​
写好任务描述

任务描述越清晰，Quest 的执行效果越好。避免模糊指令，尽量说明具体目标、技术栈和验收标准： 
❌ "优化代码"
✅ "重构 UserService，拆分成多个小函数，添加单元测试"

❌ "做个网站"
✅ "创建一个旅行博客，包含首页、文章列表、详情页，使用 Next.js"
同时，通过 @ 引用相关文件或代码片段，帮助 Quest 更好地理解项目上下文。

​
选对场景和环境

场景决定 Quest 的工作方式：复杂功能选 Spec 驱动确保方案清晰，快速验证想法选原型探索或创建工具跳过 Spec 直接执行，拿不准时不选场景让 Quest 自动判断。 环境决定执行位置：简单改动用 Local 快速反馈，功能开发用 Worktree 隔离安全，长程复杂任务用 Remote 稳定运行。

​
善用迭代

先让 Quest 完成基础版本，查看效果后继续对话调整。复杂任务建议选 Spec 驱动，生成 Spec 后通过对话修改而非手动编辑。Quest 支持无限次迭代，直到你满意。