在 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 會將這些輸出直接發送到你的即時通信應用。 如果腳本沒有輸出內容，任務會完成，但不會發送通知。

管理多個任務

你可以根據需要設置任意數量的定時任務。 創建後，你可以編輯腳本和執行時間，暫停任務，並瀏覽歷史運行記錄。 在設置任務前，請測試每個腳本，尤其是它會訪問重要文件時。

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