> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 定时任务与会话定时：按计划自动运行

> 定时任务让 Agent 按计划在云主机上自动运行指令；会话定时让 Agent 在某个会话里到点继续干活。本页说明新建、确认卡、会话定时、续期、失败与自动暂停。

AIHubMix Cloud 有两种定时：

* **定时任务**：属于某个项目的一条指令，到点后 Agent 在云主机上、这个项目里执行，每次运行生成一个会话（也可以接在同一个会话里）。在「定时任务」看板新建，或由 Agent 在会话里起草、你确认后生效。
* **会话定时**：绑定在某个会话上的定时，到点后在这个会话里发一条触发消息，Agent 接着干活。Agent 可以在会话里直接创建（不需要你确认），你也可以在会话顶栏的定时面板里新建。周期会话定时 7 天后到期，可以续期。

两种定时都显示在「定时任务」看板里。客户端或网页关闭时，定时照常在云主机上执行。运行定时任务需要 [Plus](https://docs.aihubmix.com/cn/cloud/plus/plus-plan.md)，桌面客户端、网页版和手机网页都支持。

## 入口

* 桌面客户端左侧图标栏「定时任务」；网页版侧栏底部「定时任务」。
* 命令菜单（`⇧⌘P`，Windows 为 `Ctrl+Shift+P`）搜索「前往 · 定时任务」。
* 站内通知（定时任务完成、失败、已暂停）点击后打开对应的定时任务。
* 会话定时另有入口：会话顶栏的定时图标，或顶栏「…」→「会话定时」。

## 看板

左侧列表按「即将运行」「已暂停」「已结束」分组，每行显示下次运行时间和计划；会话定时还会显示所在会话和到期时间。点一行在右侧打开详情。

详情里可以：

| 操作 | 说明 |
| - | - |
| 「立即运行」 | 马上运行一次。上一次还在运行时不可点 |
| 「续期」 | 只有周期会话定时有，延长 7 天 |
| 「暂停」/「恢复」 | 暂停后不再按计划运行 |
| 编辑（铅笔图标） | 打开「编辑定时任务」。会话定时没有编辑 |
| 删除（垃圾桶图标） | 确认后删除 |

详情里还显示计划、下次运行、项目、模型、通知、创建方式（从会话里创建的可点击回到该会话）、指令和运行记录。

**运行记录**每次运行一行，显示时间和结果（进行中、已完成、失败 · 原因、已跳过 · 原因、已停止）。点有会话的记录会打开那次运行的会话。

## 新建定时任务

1. 在看板点「新建任务」，打开「新建定时任务」。没有 Plus 时会先打开订阅弹窗，开通后自动回到这里。
2. 在文本框写下要定时做什么。
3. 选择「项目」：默认是你最近使用的项目。还没有项目时需要先创建并发布一个项目。
4. 选择「重复」，再按重复方式填写时间（见下表）。
5. （可选）展开「高级」调整其他设置。
6. 点「创建」，提示「已创建定时任务 · 下次运行 X」。

| 重复 | 需要填写 |
| - | - |
| 一次 | 「日期」（今天起 7 天内）+「时间」 |
| 每天 | 「时间」 |
| 工作日 | 「时间」（周一到周五） |
| 每周 | 「星期」+「时间」 |
| 固定间隔 | 「运行间隔」：15 分钟、20 分钟、30 分钟、1 小时 |

* 「时间」以半小时为单位，按你的本地时间。
* 指令不能超过 16 KiB。每次运行最长 1 小时，超时记为「运行超时」。
* 只运行一次的任务运行完后进入「已结束」。

### 高级设置

| 设置 | 选项 | 默认 |
| - | - | - |
| 通知 | 全部更新（完成和失败都提醒）/ 仅重要更新（只在失败时提醒）/ 关闭 | 仅重要更新 |
| 每次运行新建任务 | 关闭后每次运行都接在同一个会话里 | 开启 |
| Harness / 模型 / 智力 | 与新会话相同的选项 | 上次新会话的选择 |

定时任务没有「权限」设置：云端定时任务一律以完全访问运行。

### 编辑定时任务

在详情点铅笔图标打开「编辑定时任务」，字段同新建。可以把任务改到你的另一个项目；从会话里创建的任务不能改项目。

## 在会话里由 Agent 起草

在任意会话里用自然语言提出定时需求，例如「每个工作日早上 9 点检查依赖更新」。Agent 会起草一个定时任务，会话里出现一张确认卡。**确认卡里的定时任务在你点「创建」之前不会运行。**

* 「创建」：立即生效，卡片变为「已创建 · 下次运行 X」，带「在定时任务中查看」。
* 「编辑」：打开「编辑定时任务」修改，保存后再点「创建」。
* 「不用了」：不创建。

草稿过一段时间不处理会过期作废。

## 会话定时

**会话定时**绑定在一个会话上：到点后在这个会话里发一条触发消息，Agent 接着在这个会话里工作。适合「30 分钟后再检查一次部署」「每小时看一下队列」这类跟当前会话上下文相关的事。

* **Agent 创建**：Agent 可以直接创建、修改、删除本会话的定时，**不需要你确认**；每次变化都会在时间线里留一行记录。
* **定时面板**：会话有定时时，顶栏标题旁出现定时图标；没有时从顶栏「…」→「会话定时」打开。面板里可以对每条定时「立即触发」「停用」/「启用」「续期」「删除」。
* **新建**：在面板点「新建定时」，填「提示词」和「名称（可选）」，选「N 分钟后」（最长 7 天）或「周期（cron）」（5 段 cron 表达式，最小间隔 5 分钟），点「创建」。
* 停止会话只停当前这一轮，会话定时继续有效。

### 到点触发

* 到点后，会话里出现一条「定时触发 · 名称」消息，Agent 开始这一轮。
* 会话正忙时按定时的「会话忙时」设置处理：「跳过本次」或「排队等待」。
* 一次性定时触发后自动停用。

### 到期与续期

* 周期会话定时创建后有效期 7 天。到期前 24 小时内，面板标「即将到期」，时间线出现提醒和「续期」按钮，点了再延 7 天。
* 已到期的定时会停用，需要先「续期」再启用。
* 续期保持原来的启用状态：你自己停用的续期后仍是停用；因到期停用的续期后恢复启用。

## 运行规则

| 情况 | 结果 |
| - | - |
| 上一次还没结束 | 本次跳过，这期间「立即运行」不可点 |
| 单次失败 | 记录失败原因并按通知设置提醒，下次照常运行 |
| 连续失败 3 次 | 自动暂停，见下一节 |
| 客户端或网页关闭 | 照常运行；之后在会话和运行记录里查看结果 |
| 没有 Plus 或订阅失效 | 不能「立即运行」或「恢复」，界面会提示开通或续订 |
| 云主机没在运行 | 不能「立即运行」 |

## 连续失败自动暂停

定时任务连续 3 次运行失败后会自动暂停，看板显示「连续失败，已暂停」，你也会收到通知。查看运行记录里的失败原因，处理后点「恢复」。

## 删除

点详情里的删除图标并确认。定时不会再运行，运行记录会被删除；已经生成的会话和会话里的消息会保留。

## 注意与限制

* 定时任务的固定间隔最短 15 分钟；会话定时的周期最小间隔 5 分钟。
* 定时任务表单不支持自定义 cron 表达式；会话定时可以填 cron。
* 周期会话定时 7 天到期，需要续期。
* 每次运行都消耗模型用量（Plus 模型或你选的订阅 / BYOK）。
* 未开通 Plus 时可以浏览看板，新建会先引导开通，见[未开通 Plus 时](https://docs.aihubmix.com/cn/cloud/plus/without-plus.md)。

## 常见问题

### 关掉电脑后定时任务还会跑吗？

会。定时任务在云主机上运行，与你的设备是否开着无关。

### 定时任务为什么暂停了？

可能是你手动暂停了、连续失败 3 次被自动暂停，会话定时还可能是已到期。看运行记录找到原因，处理后点「恢复」（已到期的先「续期」）。

### Agent 能不经我同意就创建定时吗？

会话定时可以：Agent 能直接在当前会话里创建，时间线会留一行记录，你可以在顶栏面板里停用或删除。项目的定时任务不行：Agent 只能起草，必须由你在确认卡上点「创建」。

### 会话定时和定时任务怎么选？

需要接着当前会话的上下文做事，用会话定时；需要长期、独立地按计划在某个项目里执行，用定时任务。

## 相关

* [未开通 Plus 时](https://docs.aihubmix.com/cn/cloud/plus/without-plus.md)
* [云主机概览](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)
* [Harness 与模型](https://docs.aihubmix.com/cn/cloud/models/harness-and-models.md)
* [通知设置](https://docs.aihubmix.com/cn/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.