在 LightVela 中运行脚本任务

摘要

脚本任务可以让云端 Agent 按计划运行 Bash 或 Python 脚本，不调用 AI 模型，也不消耗模型 Token。 本页用磁盘使用率检查和导出文件检查说明如何配置脚本、执行时间、生效时间段和国内交付通道。

脚本任务适合那些规则明确、结果可以通过脚本判断的重复性系统检查。 它可以按计划运行 Bash 或 Python 脚本，并在脚本产生输出时发送结果。

脚本可以解决的常见问题

许多小型系统问题都可以通过简单检查发现。 但是，这些检查往往会被忘记，直到某些功能停止工作。

• 磁盘使用量增长，却没有被注意到。
• 每日导出停止生成新文件。
• 备份文件变得过期。
• 直到问题影响其他工作后才被发现。

在 LightVela 中，你可以为脚本任务配置 Bash 或 Python 代码、执行时间、生效时间段和交付通道。 任务不会调用模型，因此不会消耗模型 Token。 定时任务配置文档介绍了可用的调度和通知选项。

脚本会在云端 Agent 环境中运行，不等同于安全沙箱。 请只运行你信任的脚本，并在保存前确认脚本访问的路径和输出内容。

案例 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 接入微信、飞书和 QQ。 你可以同时接入一个或多个通道。 在定时任务中，你可以切换每个已配置的通道，决定脚本提醒应该发送到哪里。

当脚本产生非空的标准输出时，Agent 会将这些输出直接发送到你的即时通信应用。 如果脚本没有输出内容，任务会完成，但不会发送通知。

建议先通过测试运行确认脚本的退出行为和输出内容，再启用定时执行。 如果脚本访问重要文件，应同时检查路径是否正确，以及脚本是否可能修改或删除文件。

管理多个任务

你可以根据需要设置任意数量的定时任务。 创建后，你可以编辑脚本和执行时间，暂停任务，并浏览历史运行记录。

在设置任务前，请测试每个脚本，尤其是它会访问重要文件时。 当脚本逻辑或检查路径发生变化时，应重新测试任务，并确认输出仍然只在需要时触发。

使用 LightVela，让你的个人 Hermes Agent 在你专注于其他工作时持续处理可预测的检查。