> ## 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 中通过 `/schedule` 命令或自然语言描述，你可以将任务安排在指定时间自动执行。

## 适用场景

* **夜间代码治理**：白天专注业务开发，把重构、死代码清理、命名规范修正等耗时任务安排到夜间执行。
* **测试与文档补全**：下班前安排 Quest 为当天的改动补齐测试用例或生成模块文档，第二天上班直接 review 结果。
* **安全与依赖扫描**：定期安排安全漏洞扫描和依赖检查，确保项目健康状态持续更新。
* **结合 Goal 模式**：将 [Goal](./goal-driven) 任务安排在夜间执行，让 Quest 围绕目标自主迭代，充分利用错峰时段。

## 如何使用

**命令触发**：在输入框中输入 `/schedule` 加任务描述，例如：

```
/schedule 今晚 10 点，为我今天改动的代码补齐测试
```

**自然语言触发**：直接在消息中包含时间意图，例如「帮我今晚重构今天修改过的代码，提升可读性」。Quest 识别意图后会确认缺失信息并完成创建。

创建成功后，会话流中出现定时任务卡片，如果需要调整，点击卡片上的「编辑」按钮打开表单。到达计划时间后，Quest 自动开始执行任务，执行过程和结果会出现在对应会话中，你可以在下次打开时查看。

<Note>请确保 Qoder 在计划执行时间处于运行状态。如果开启了「保持系统唤醒」，Qoder 会在任务时间前阻止系统休眠。</Note>

### 从 Spec 转为定时任务

在 [Spec 驱动](./spec-driven) 模式下正常完成需求澄清和 Spec 生成后，在 Spec 卡片的 build on 区域点击「设置定时」按钮，设置执行时间后保存，即可让该 Spec 在计划时间自动执行。

### 编辑任务表单

点击任务卡片或右侧概要中的任务条目，打开编辑表单，包含以下字段：

* **任务名称**：简短描述任务内容。
* **计划时间**：选择日期和时间。
* **任务指令**：Quest 执行时使用的完整 prompt。
* **模型选择**：默认与当前会话一致，可切换。
* **Goal 开关**：选择是否以 Goal 模式执行任务。

### 查找与管理任务

* **左边栏时钟图标**：含待执行定时任务的会话，在会话历史列表中显示时钟标记。所有任务执行完毕或被删除后，图标自动消失。
* **右侧概要板块**：当会话中存在定时任务时，概要面板出现「定时任务」板块，列出所有任务，点击可跳转至对应编辑表单。
* **一个会话支持多个任务**：你可以在同一会话中创建多个定时任务，它们独立管理、互不影响。

## 最佳实践

* **任务指令写清楚**：定时执行时你不在场，Quest 完全依赖任务指令工作。像写给同事的交接说明一样，把范围、重点和约束写明确。
* **善用 Goal + 定时任务 组合**：对于「提升测试覆盖率到 80%」这类需要持续迭代的目标，开启 Goal 模式并设为夜间定时执行，效果最佳。