选择 Qoder CN 读取文件、运行命令和记录变更的位置。
发送任务前选择工作区和执行环境。该选择决定 Qoder CN 在哪里读取文件、运行命令和读取 Git 状态。
选择已有工作区或 新建工作区。一个工作区可以包含多个可读写的项目文件夹，并指定一个用于打开项目的主文件夹。
Worktree 任务在单独的 Git 检出目录中隔离变更。可以在 设置 → Worktrees 中配置保留和备份行为。Git 备份不会包含被忽略的文件，因此不要依赖它保存密钥或仅存在于本地的数据。
选择 连接 SSH，或在 设置 → 连接 中添加主机。Qoder CN 从
| 环境 | 变更位置 | 适用场景 |
|---|---|---|
| 本地工作区 | 当前设备上已打开的项目目录 | 小改动、快速验证，以及需要立即在本地查看结果的任务。 |
| Worktree | 独立的 Git 工作树 | 并行任务、较大改动，或不希望影响当前检出目录的工作。 |
| SSH 工作区 | 已登记远程主机上的目录 | 代码、依赖或运行环境只存在于远程主机的任务。 |
| 不指定工作区 | 不绑定项目目录 | 不需要项目文件或项目命令的问答与通用任务。 |
本地工作区
选择已有工作区或 新建工作区。一个工作区可以包含多个可读写的项目文件夹，并指定一个用于打开项目的主文件夹。
Worktree
Worktree 任务在单独的 Git 检出目录中隔离变更。可以在 设置 → Worktrees 中配置保留和备份行为。Git 备份不会包含被忽略的文件，因此不要依赖它保存密钥或仅存在于本地的数据。
创建 Worktree 任务
- 在任务输入框底部打开当前执行模式。
- 选择 Worktree，并选择作为起点的 Git 分支。
- 如果界面提供同步未提交变更的选项，请先审查这些变更，再决定是否包含。
- 发送任务。Qoder CN 会在独立工作树中读取、修改和验证代码。
SSH 工作区
选择 连接 SSH，或在 设置 → 连接 中添加主机。Qoder CN 从 ~/.ssh/config 读取主机，所选远程目录必须允许当前 SSH 账号写入。
选择建议
- 项目必须是 Git 仓库，才能使用 Worktree。
- 多个 Worktree 会分别占用磁盘空间；在 设置 → Worktrees 中定期清理不用的工作树。
- SSH 任务的命令和文件操作发生在远程主机；发送前确认主机、目录和分支。
- 切换环境不能替代权限控制。仍应根据任务风险选择合适的访问权限。
已有任务不能在本地和 Worktree 模式之间切换。需要改变执行边界时，请创建新任务。