自動化

排程建立終端

• 開啟設定 > 自動化並建立規則。
• 選擇工作區或未綁定的 HOME，設定啟動指令，以及內嵌提示或即時 Prompt Library 參照。
• 選擇使用電腦本地時區的五欄 cron，或一次性日期與時間。
• 可加入事前檢查指令，確認下次執行時間，啟用排程後儲存。可用 Run now 試跑，並查看執行歷史。

自動化會開啟新前景終端，通過就緒檢查後傳送提示。事前檢查失敗時略過該次執行並記錄原因。即時 prompt 參照在執行時從選定工作區解析，不支援 prompt 變數。登入、專案信任與權限提示仍須由你在終端回答。

停止追蹤會保留終端，並停止後續自動化輸入。排程需要桌機 app 持續執行，不是託管排程服務。

既有 session 的 keep-alive

Keep-alive 將訊息注入既有 session。HTTP API 提供 interval、idle、daily、once；idle 等待本機 agent 閒置達設定時間，一次性輸入送達後移除規則。

CLI 提供 list、set、rm，可設定 interval、idle、daily 規則。要在每次觸發時解析 Prompt Library 參照，請用 HTTP API。每次觸發結果會記錄於執行歷史，包含略過的時段。

termdock session keepalive set <id> --message "continue the review" --idle 15m --json
termdock session keepalive list <id> --json
termdock session keepalive rm <id> <rule-id> --json

Workflow

在 Workflows 面板建立依序執行的具名提示步驟，並選擇符合條件的既有 agent 終端。每個步驟傳送提示，等 agent 回合完成才進入下一步。可使用內嵌提示或 Prompt Library 參照。

權限提示會暫停 Workflow，等待你回答。每個步驟可設定逾時，請先檢查暫停或逾時的執行，再決定如何繼續。Workflow 可綁定既有目標，以 interval 或 daily 排程，與 cron 自動建立新終端的規則不同。

Webhook

• 在設定 > 自動化 > Webhooks 選擇本機工作區與既有分頁名稱。
• 建立後立即複製網址，密鑰網址只顯示一次。
• POST JSON body，恰好包含 message、submit。目標須為等待輸入的 agent。
• 不再需要時於設定撤銷網址。

curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"message":"Review the new build result","submit":true}'

submit: false 只輸入文字，submit: true 同時送出 Enter。忙碌、找不到、名稱不明確或無法讀取畫面的目標會拒絕，不建立 session，也不排入輸入佇列。網址只允許傳送到指定工作區與分頁名稱，不提供一般 Terminal API 存取。

外部傳送者須自行使用 HTTPS tunnel 或反向代理，只公開 /api/webhooks/...。網址請視為密碼，不要公開其他本機 Terminal API。