在 LightVela 中運行腳本任務

摘要

腳本任務可以讓雲端 Agent 按計劃運行 Bash 或 Python 腳本，不調用 AI 模型，也不消耗模型 Token。 本頁用磁盤使用率檢查和導出文件檢查説明如何配置腳本、執行時間、生效時間段和交付通道。

腳本任務非常適合雲端 Agent，因為它可以按計劃運行 Bash 或 Python 腳本，不需要調用 AI 模型。 當你需要按照清晰、可預測的規則進行重複性系統檢查時，就可以使用它。 有人用它設置磁盤使用率提醒；也有人創建檢查，用來發現缺失或過期的文件。

腳本可以解決的常見問題

許多小型系統問題都可以通過簡單檢查發現。 但是，這些檢查往往會被忘記，直到某些功能停止工作。

• 磁盤使用量增長，卻沒有被注意到。
• 每日導出停止生成新文件。
• 備份文件變得過期。
• 直到問題影響其他工作後才被發現。

在 LightVela 中，你可以為腳本任務配置 Bash 或 Python 代碼、執行時間、生效時間段和交付通道。 任務不會調用模型，因此不會消耗模型 Token。 定時任務文檔介紹了可用的調度和通知選項。

案例 1：磁盤使用率提醒

每天早上，Bash 腳本任務會檢查可用磁盤空間，並且只在使用率達到 80% 時報告。

腳本：

used=$(df -P / | awk 'NR==2 {gsub("%", "", $5); print $5}')

if [ "$used" -ge 80 ]; then
  echo "Disk usage alert: ${used}% used."
fi

如果磁盤使用率低於閾值，腳本不會輸出內容，也不會發送通知。 這樣可以讓例行檢查保持安靜，只有需要處理的問題才會引起注意。

案例 2：缺失或過期的導出文件

每個工作日晚上，Python 腳本任務會檢查最新導出文件是否存在，以及它是否在過去 24 小時內更新過。

腳本：

from pathlib import Path
from time import time

file = Path("/path/to/latest-export.csv")

if not file.exists() or time() - file.stat().st_mtime > 86400:
    print("Export alert: the latest file is missing or over 24 hours old.")

請將示例路徑替換為真實的導出位置。 如果文件存在且較新，腳本會安靜地完成，不會發送不必要的消息。

直接在即時通信應用中更新我

LightVela 支持通過通道配置將 Agent 接入 WhatsApp、Telegram、WeChat、Discord 等平台。 你可以同時接入一個或多個通道。 在定時任務中，你可以切換每個已配置的通道，決定腳本提醒應該發送到哪裏。

當腳本產生非空的標準輸出時，Hermes 會將這些輸出直接發送到你的即時通信應用。 如果腳本沒有輸出內容，任務會完成，但不會發送通知。

管理多個任務

當前控制台按 Bot 限制最多 20 個未結束的定時任務；暫停但未結束的任務也計入。達到上限時先刪除不再需要的任務，不要把任務數量理解為無限。 創建後，你可以編輯腳本和執行時間，暫停任務，並瀏覽歷史運行記錄。 在設置任務前，請測試每個腳本，尤其是它會訪問重要文件時。

使用 LightVela，讓你的個人 Hermes Agent 在你專注於其他工作時持續處理可預測的檢查。