# 创建自动化任务

> 把已经人工跑通的任务交给本地调度器，按单次、每天或间隔计划执行并检查历史。

Canonical page: /product/automation



自动化适合稳定、可重复、无需每次重新解释的任务。调度由桌面客户端在本机完成：Astravia 完全退出、计算机睡眠或关机时不会按计划执行。

## 自动化之前先手动跑通 [#自动化之前先手动跑通]

不要把尚未验证的宽泛提示直接交给无人值守执行。先在普通会话中完成一次，并确认：

* 输入来源在每次执行时都存在且路径稳定。
* 输出位置明确，不会覆盖不相关文件。
* 成功和失败可以从实际结果判断。
* 需要的模型、MCP、技能和权限在无人值守时可用。
* 没有必须由人临场选择的高风险步骤。

## 示例：每日项目状态摘要 [#示例每日项目状态摘要]

```text
读取当前项目中今天发生变化的文档和任务记录，生成 reports/daily-status.md。

内容包括：已完成、进行中、阻塞和明日建议。
只读取项目文件，不修改其他内容；没有变化时仍生成文件并写明“今日无记录”。
完成后确认输出文件存在，并在回复中列出使用的数据来源。
```

先在目标项目会话中运行这段任务，检查 `reports/daily-status.md`，再创建自动化。

## 创建任务 [#创建任务]

入口：侧栏 **自动化**。页面也提供晨间简报、工作总结和每周复盘等模板，使用后仍应按自己的数据来源和输出要求修改。

| 字段   | 说明                |
| ---- | ----------------- |
| 任务名称 | 卡片和执行历史中的识别名称     |
| 提示词  | 无人值守时仍能独立理解的完整任务  |
| 工作目录 | 「对话」或已有项目目录       |
| 模型   | 每次执行使用的模型         |
| 计划   | 单次、每天或每隔 N 小时 / 天 |
| 沙盒   | 跟随默认、完全访问或使用沙盒    |
| 启用   | 保存后是否允许调度触发       |

<Steps>
  <Step>
    ### 固定输入和输出 [#固定输入和输出]

    在提示中写出输入来源、目标路径、允许修改的范围和失败条件，不依赖“上次我们讨论过”的会话记忆。
  </Step>

  <Step>
    ### 选择时间计划 [#选择时间计划]

    核对界面显示的下次执行时间。计划使用操作系统当前时区；跨时区或夏令时变化后重新检查。
  </Step>

  <Step>
    ### 保存后立即执行 [#保存后立即执行]

    第一次使用 **立即执行**，不要等到下一个计划点才发现模型、目录或权限不可用。
  </Step>

  <Step>
    ### 验收历史和实际产物 [#验收历史和实际产物]

    在执行历史中打开对应会话，同时检查目标目录中的实际文件或外部结果。
  </Step>
</Steps>

## 运行状态和恢复 [#运行状态和恢复]

任务详情提供执行历史，状态包括成功、失败、执行中和已中止。常用动作：

* **暂停**：保留配置，但阻止后续计划触发。
* **启用**：恢复之后的计划，不自动补跑错过的时间点。
* **立即执行**：不改变原计划，额外启动一次验证或补跑。
* **编辑**：调整任务、目录、模型或计划；修改后再次立即执行。
* **删除**：移除任务配置，历史与相关会话按界面确认语义处理。

项目维度的自动化概览也会出现在活动面板中，可查看今日执行、启用任务和最近记录。

## 常见失败 [#常见失败]

| 现象        | 检查                                 |
| --------- | ---------------------------------- |
| 到点没有执行    | Astravia 是否运行、设备是否睡眠、任务是否启用、时区是否变化 |
| 模型调用失败    | 模型和凭证是否仍可用、是否触发配额或速率限制             |
| 找不到文件     | 项目目录是否移动，提示中的相对路径是否仍成立             |
| 卡在权限确认    | 是否选择了不适合无人值守的动作或执行模式               |
| 显示成功但没有结果 | 提示是否要求实际产物和验证，不要只依赖最终回复            |

<Callout type="info" title="自动化不是云端常驻服务">
  当前调度依赖运行中的 Astravia 桌面客户端。需要跨设备常驻或服务端 SLA 时，不应把桌面自动化当作等价替代。
</Callout>

需要一份从试跑到启用计划的完整配方，参见[按计划生成项目报告](/examples/scheduled-project-report/)；需要对多个目录同时运行同一提示时使用[批量任务](/product/batch-tasks/)。