> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.
# 排程
> 以重複頻率自動執行提示詞，於新聊天或既有的釘選聊天中執行
排程會自動執行提示詞，以每小時到每週的重複頻率執行，無需您自行開始聊天。每次執行不是開啟一個新聊天（使用內建代理，並有其自己的模型與思考層級），就是將提示詞送往您已在側邊欄[釘選](#將聊天釘選為目標)的聊天——包括由 [CLI 代理](/zh-Hant/ctor/reference/cli-agents)提供支援的聊天。
排程任務只在 CTOR 開啟時才會觸發——沒有雲端或背景執行。若某次執行到期時 CTOR 是關閉的，請參閱[錯過的執行](#錯過的執行)。
## 開啟排程面板
點選側邊欄中的**排程**按鈕，就在**外掛**正下方。它會開啟一個含有兩個分頁的抽屜：
* **排程**——建立、編輯並管理您的排程任務。
* **活動**——彙整所有排程中每次執行的動態。
## 建立排程
在「排程」分頁點選**新增排程**。
* **名稱**——簡短的標籤，最多 200 個字元。
* **提示詞**——代理每次執行的指示，最多 20,000 個字元。執行是無人值守的，因此請撰寫完整自足的提示詞——代理無法像在即時聊天中那樣，於執行途中向您詢問澄清問題。
### 頻率
選擇**重複**：
* **每小時**——每小時觸發一次，於您選擇的第幾分（0–59）。
* **每 N 小時**——每 2、3、4、6、8 或 12 小時觸發一次，於您選擇的第幾分。
* **每天**——每天於您選擇的時間觸發一次。
* **每週**——於您挑選的一個或多個星期幾，在您選擇的時間觸發。
時間一律採用您電腦的本機時鐘時間——沒有時區選擇器。設定為上午 9:00 的排程，在日光節約時間轉換前後都會持續於本機時間上午 9:00 觸發，即使在轉換當天，兩次執行之間的實際間隔會有一小時的偏移。
## 選擇目標
選擇**目標**：**新聊天**或**釘選聊天**。
### 新聊天
每次執行都會以內建代理建立一個全新的聊天：
* **專案**——**Main Chat**，或您已開啟的其中一個專案。
* **模型**與**思考層級**——與聊天輸入區相同的選擇器。這些是按每個排程設定，並套用於每一次執行。
### 將聊天釘選為目標
若要改以現有聊天為目標，請先在側邊欄對它按右鍵並選擇**釘選對話**——**釘選聊天**下拉選單只會列出您已釘選的聊天。每次執行都會使用該聊天自己儲存的模型與思考層級，而非按排程設定的選擇，將提示詞送往該聊天。無論釘選的聊天是以內建代理還是 [CLI 代理](/zh-Hant/ctor/reference/cli-agents)執行，運作方式都相同——CLI 引擎驅動排程提示詞的方式，與您親自輸入訊息時完全一樣。
## 管理排程
在「排程」分頁或某個排程自身的詳細檢視中：
* **切換**——啟用或停用排程，而不將其刪除。重新啟用會重新計算其下次執行時間。
* **立即執行**——立即觸發該排程，且不影響其常規的下次執行時間。
* **刪除**——需在數秒內再次點選以確認，並會一併移除其執行紀錄。
**補跑錯過的排程**與**完成時通知**是詳細檢視中按每個排程設定的選項——請參閱[錯過的執行](#錯過的執行)與[通知](#通知)。
## 錯過的執行
若某次執行到期時 CTOR 是關閉的，接下來的情況取決於排程的**補跑錯過的排程**選項：
* **開啟**（每天與每週的預設值）——無論在關閉期間錯過了多少次，排程都會在 CTOR 下次啟動後不久觸發一次。
* **關閉**（每小時與每 N 小時的預設值，因為這些頻率無論如何很快就會再次趕上）——排程不會延遲觸發。取而代之的是，其執行紀錄中會出現一筆略過項目，記錄錯過了多少次。
## 重疊的執行
若下一次執行到期時，某次執行仍在進行中，新的執行會被略過並記錄下來，而不會排入佇列或平行執行——無論是仍在忙碌的釘選聊天，還是上一次執行尚未完成的新聊天排程，都是如此。
略過與錯過執行項目上的原因文字（以及執行完成通知中的文字）一律以英文顯示，即使 CTOR 的介面語言是繁體中文或日文也一樣。
## 自動停用
以釘選聊天為目標的排程，若該聊天之後被刪除或封存，會自動停用自己，並在排程上就地顯示原因。重新將它指向有效的聊天後再重新啟用，即可清除該提示。
## 通知
當**完成時通知**開啟時（預設值），CTOR 會在執行成功結束時發出系統通知。失敗的執行則無論此開關為何都一律通知。點選通知會將 CTOR 帶到前景；從「活動」分頁開啟該次執行，則會直接跳進它執行所在的聊天。排程執行不會額外觸發 CTOR 的[一般回合結束通知](/zh-Hant/ctor/reference/settings#代理)——您只會看到排程的那一則。
## 活動與執行紀錄
「活動」分頁會列出所有排程中的每次執行，最新的在最前；某個排程自身的詳細檢視也以同樣方式顯示其最近執行。每筆項目都會顯示其狀態（成功、錯誤、執行中或略過）、觸發時間、耗時，以及在該聊天仍存在時，用來開啟其執行所在聊天的連結。
封存某次執行所在的聊天，會將該次執行從這些歷史檢視中隱藏——包括每個排程旁顯示的成功／錯誤次數——直到您解除封存為止。沒有關聯聊天的執行（略過與錯過），以及聊天已被刪除的執行，則會維持可見，因為執行項目是它們曾發生過的唯一紀錄。
## 側邊欄指示器
* **排程**按鈕在至少有一個排程啟用時，會顯示一個小圓點。
* 由排程建立的聊天，會在側邊欄中其標題旁顯示一個小時鐘圖示。
## 從 Main Chat 管理排程
您也可以在對話中要求[主聊天](/zh-Hant/ctor/guide/main-chat)代理建立、列出、更新、刪除或立即執行某個排程——例如：*「排程一項任務，每天上午 9 點在新的 Main Chat 中彙整開放中的 PR 摘要」*。無論主聊天本身是以內建代理還是 CLI 代理執行，這都同樣可行；以這種方式建立的排程，與透過面板建立的完全相同——它們會一起顯示，兩種介面都能加以管理。
## 關閉排程功能
排程任務預設為開啟。若要完全關閉此功能，請在[設定 → 代理](/zh-Hant/ctor/reference/settings#代理)中停用**排程任務**——既有的排程會保留，但在您重新開啟前不會觸發。
## 後續步驟
以外部 CLI 代理為釘選聊天提供支援，讓排程可以指向它。
從主聊天以對話方式管理排程。