在 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 在你专注于其他工作时持续处理可预测的检查。