> ## 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/zh-Hant/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/zh-Hant/cloud/plus/without-plus.md)。

## 常見問題

### 關掉電腦後定時任務還會跑嗎？

會。定時任務在雲主機上執行，與你的裝置是否開著無關。

### 定時任務為什麼暫停了？

可能是你手動暫停了、連續失敗 3 次被自動暫停，會話定時還可能是已到期。看執行記錄找到原因，處理後點「恢复」（已到期的先「续期」）。

### Agent 能不經我同意就建立定時嗎？

會話定時可以：Agent 能直接在當前會話裡建立，時間線會留一行記錄，你可以在頂欄面板裡停用或刪除。專案的定時任務不行：Agent 只能起草，必須由你在確認卡上點「创建」。

### 會話定時和定時任務怎麼選？

需要接著當前會話的上下文做事，用會話定時；需要長期、獨立地按計劃在某個專案裡執行，用定時任務。

## 相關

* [未開通 Plus 時](https://docs.aihubmix.com/zh-Hant/cloud/plus/without-plus.md)
* [雲主機概覽](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/overview.md)
* [Harness 與模型](https://docs.aihubmix.com/zh-Hant/cloud/models/harness-and-models.md)
* [通知設定](https://docs.aihubmix.com/zh-Hant/cloud/settings/notifications.md)


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