使用说明书

软件名称：设备任务管理系统

版本：1.0

功能概述

本系统提供了一个用于管理设备及其相关任务的界面，支持以下功能：

  1. 查看所有设备及其任务。
  2. 添加新任务到指定设备。
  3. 删除任务或设备。
  4. 执行任务。
  5. 定时任务设置支持 Cron 表达式。

系统需求

  • 操作系统：Windows / Linux / macOS
  • 浏览器：建议使用最新版的 Google Chrome、Mozilla Firefox 或 Microsoft Edge
  • 后台依赖：
    • Go 语言环境
    • MySQL 数据库
    • Cron 定时任务服务

界面说明

设备任务管理页面

  • 设备信息：
    • 每行表示一个设备，显示设备的名称、位置、IP 地址及其状态。
  • 任务信息：
    • 显示当前设备的任务描述、任务表达式、命令及任务状态。
  • 操作列：
    • 提供 执行、删除 和 添加任务 按钮。
      • 执行：立即执行该任务。
      • 删除：删除该设备或任务。
      • 添加任务：弹出窗口输入任务信息。

添加任务窗口

  • 设备名选择：通过下拉菜单选择需要添加任务的设备。
  • 任务描述：填写任务内容的描述。
  • 定时任务表达式：支持 Cron 表达式，用于设置任务的执行时间。
  • 命令：任务执行的具体命令。
  • 帮助链接：点击 时间表达式帮助，跳转到 Cron 表达式帮助页面。

操作指南

查看设备和任务

  1. 打开系统后，页面中央展示设备和任务列表。
  2. 每个设备一行显示，未分配任务的设备会显示“无任务”。

添加任务

  1. 点击设备所在行的 添加 按钮，弹出任务添加窗口。
  2. 在弹出窗口中：
    • 选择设备。
    • 输入任务描述。
    • 输入 Cron 表达式。
    • 输入执行命令。
    • 点击 提交任务。
  3. 提交后，任务会显示在任务列表中。

删除任务或设备

  1. 点击任务对应行的 删除 按钮：
    • 如果删除任务：仅移除该任务。
    • 如果删除设备：设备及其关联任务会被一起移除。
  2. 系统会提示操作结果。

执行任务

  1. 点击任务对应行的 执行 按钮。
  2. 系统会立即执行任务命令，并反馈执行结果。

特别说明

定时任务表达式

  • 定时任务使用标准 Cron 表达式。
  • 点击 时间表达式帮助 按钮跳转到相关教程页面，了解 Cron 表达式的详细用法。

日志与通知

  • 所有任务的执行日志会保存在系统日志文件中，路径为：task_execution.log。
  • 如任务失败，可自动触发报警，报警信息可定制为发送到指定的 Webhook。

常见问题

  1. 设备列表未加载：

    • 检查后台数据库连接是否正常。
    • 检查浏览器是否开启了网络拦截。

  2. 任务添加失败：

    • 检查 Cron 表达式格式是否正确。
    • 检查设备是否已存在。

  3. 任务无法执行：

    • 检查命令是否正确。
    • 检查设备网络是否连接。

技术支持

更新时间：2025-01-04