执行环境

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

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

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

​

Worktree

Worktree 模式基于 Git worktree 在后台创建独立工作区副本，让 Agent 在隔离环境中执行任务。主工作区保持干净，多个 Worktree 可并行运行。

​

适用场景

场景	说明
并行多任务	同时处理多个需求或重构，每条线独立推进，互不干扰
高风险重构	让 Agent 大胆尝试架构调整或大规模重命名，不满意直接丢弃，主工作区毫发无损

​

如何使用

​

创建工作树

1. 在聊天面板顶部的运行环境区域，点击当前模式（如「本地模式」）
2. 在下拉中选择 Worktree
3. 在模式选择器旁的分支下拉中，选择 Agent 基于哪条本地分支创建工作树
4. 输入任务描述并发送，Agent 会在独立的工作树中执行工作

如果主工作区存在未提交的改动，面板会显示「包含未提交变更」开关。开启后，创建时会将这些改动同步到工作树中，确保 Agent 看到你最新的代码状态。

​

移交到本地

当 Agent 在工作树中完成工作后，你可以将结果带回主工作区继续开发：

在左侧任务列表中找到对应的工作树会话，点击会话的「移交到本地」操作，将 worktree 中的分支状态和未提交改动移交到本地主工作区，后续任务直接在本地继续执行。

执行移交前，本地工作区需要处于干净状态（没有未提交的变更），建议先 commit 或 stash 当前改动。

​

审查与提交

如果你不需要将变更带回本地，可以直接在工作树中完成提交：在会话右侧打开「审查与提交」面板，查看 Agent 所做的所有文件变更。确认无误后，在面板中创建新分支并提交代码。

​

初始化脚本

如需在创建 Worktree 时自动执行初始化操作（如安装依赖、复制环境变量文件），可在设置中找到「本地任务的 Worktree 配置」，编辑启动脚本。

​

清理

​

自动清理

系统会自动清理较早的工作树以释放磁盘空间。你可以在管理面板底部配置清理策略：

• 最大保留数：每个工作区默认保留 15 个工作树。

​

手动清理

• 在左侧会话列表中，对工作树会话进行「删除」，会一并删除相应工作树。
• 也可以在设置中统一管理和删除不再需要的工作树。

​

注意事项

• 需要 Git 仓库：项目必须是一个 Git 仓库，Worktree 选项才会出现。
• 移交前请保持工作区干净：执行移交时，本地工作区不能有未提交的变更。
• 磁盘占用：每个工作树是一份独立的文件检出，项目较大时多个工作树会占用相应的磁盘空间。合理配置最大保留数，避免空间不足。