Quest 支持 Local 和 Worktree 等执行环境。本文将介绍不同环境的适用场景及配置方法，帮助你安全、高效地隔离与执行任务。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.
| 环境 | 说明 | 适用 |
|---|---|---|
| Local | 在当前打开的工作区直接改代码，变更落在当前项目目录 | 小改动、快速验证 |
| Worktree | 使用独立的 Git worktree 检出，与主分支工作区隔离，确认后再合并或应用 | 中等复杂度、多次应用、同一仓库并行多任务 |
在套餐与配额允许范围内支持并行任务。
Worktree
Worktree 模式基于 Git worktree 在后台创建独立工作区副本，让 Agent 在隔离环境中执行任务。主工作区保持干净，多个 Worktree 可并行运行，适合需要同时推进多条线工作的场景。核心能力
- 多 Workspace 并行：可在同一仓库上同时启动多个 Agent，每个 Agent 拥有独立的文件视图和修改空间，彼此互不干扰。后台跑复杂重构时，你仍可在主工作区继续写新功能。
- 基于本地分支创建：创建时可选择任意本地分支作为起点，在独立分支上验证改动后再合并回主线。
- 自动环境初始化：选择 Worktree 并发送消息后，Agent 可检测依赖并执行常见环境准备步骤；完成后进入任务执行。
- 修改隔离：Agent 的 Files 面板展示当前 Worktree 目录下的结构，而非主工作区根目录。迭代产生的修改在确认前与主线隔离，可多次 Apply 而不污染本地主检出。
适用场景
| 场景 | 说明 |
|---|---|
| 并行多任务 | 同时处理多个需求或重构，每条线独立推进 |
| 分支级实验 | 基于 feature 分支创建 Worktree，独立迭代与测试 |
| 保持主分支干净 | 中等复杂度任务需要多轮 Apply 与调整时，用 Worktree 收敛风险 |
如何使用
- 在聊天面板顶部的运行环境区域，点击当前模式（如「本地模式」）
- 在下拉中选择 Worktree 模式
- 在模式选择器旁的分支下拉中，选择 Agent 基于哪条本地分支创建 Worktree