> ## 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 支持 Local 和 Worktree 等执行环境。本文将介绍不同环境的适用场景及配置方法，帮助你安全、高效地隔离与执行任务。

| 环境           | 说明                                                                                 | 适用                   |
| :----------- | :--------------------------------------------------------------------------------- | :------------------- |
| **Local**    | 在当前打开的工作区直接改代码，变更落在当前项目目录                                                          | 小改动、快速验证             |
| **Worktree** | 使用独立的 [Git worktree](https://git-scm.com/docs/git-worktree) 检出，与主分支工作区隔离，确认后再合并或应用 | 中等复杂度、多次应用、同一仓库并行多任务 |

需要「先试一版又不打乱当前分支」，或同一仓库里并排跑多个任务时，优先选 [**Worktree**](#worktree)。

**默认**：有 Git 仓库时三种环境可用；无 Git 时仅 **Local**。

<Note>在套餐与配额允许范围内支持并行任务。</Note>

## Worktree

Worktree 模式基于 Git worktree 在后台创建独立工作区副本，让 Agent 在隔离环境中执行任务。主工作区保持干净，多个 Worktree 可并行运行，适合需要同时推进多条线工作的场景。

### 核心能力

* **多 Workspace 并行**：可在同一仓库上同时启动多个 Agent，每个 Agent 拥有独立的文件视图和修改空间，彼此互不干扰。后台跑复杂重构时，你仍可在主工作区继续写新功能。
* **基于本地分支创建**：创建时可选择任意本地分支作为起点，在独立分支上验证改动后再合并回主线。
* **自动环境初始化**：选择 Worktree 并发送消息后，Agent 可检测依赖并执行常见环境准备步骤；完成后进入任务执行。
* **修改隔离**：Agent 的 Files 面板展示当前 Worktree 目录下的结构，而非主工作区根目录。迭代产生的修改在确认前与主线隔离，可多次 Apply 而不污染本地主检出。

### 适用场景

| 场景          | 说明                                     |
| ----------- | -------------------------------------- |
| **并行多任务**   | 同时处理多个需求或重构，每条线独立推进                    |
| **分支级实验**   | 基于 feature 分支创建 Worktree，独立迭代与测试       |
| **保持主分支干净** | 中等复杂度任务需要多轮 Apply 与调整时，用 Worktree 收敛风险 |

### 如何使用

1. 在聊天面板顶部的运行环境区域，点击当前模式（如「本地模式」）
2. 在下拉中选择 Worktree 模式
3. 在模式选择器旁的分支下拉中，选择 Agent 基于哪条本地分支创建 Worktree

**配置启动脚本**
如需在创建 Worktree 时自动执行初始化操作，可在设置中找到"本地任务的 Worktree 配置"，编辑启动脚本。