TaskPool/docs/guide/usage.md

功能特性

白虎面板不仅提供基础的脚本执行功能，还集成了众多的实用工具和管理模块。

定时任务管理

• 标准 Cron 表达式：支持高度灵活的调度配置。
• 控制台快捷键：常用规则一键选择。
• 手动触发执行：支持临时执行任务。
• 任务超时控制：通过配置 timeout 参数，系统会自动隔离并中止长时间运行的任务。

脚本文件管理

• 在线代码编辑器：集成了现代代码编辑器，支持语法高亮和编辑。
• 文件树形结构：直观展示项目内所有文件。
• 文件上传与解压：支持单文件、多文件上传和对 ZIP 压缩包的在线解压。
• 文件管理：支持在线进行创建、重命名、移动和删除操作。

在线终端

• WebSocket 实时终端：支持常用的 Shell 命令。
• 命令输出实时推流：实时查看脚本运行的物理设备输出。

执行日志

• 任务执行历史：记录每次运行的状态（成功/失败/超时）。
• 执行耗时统计：自动统计任务耗时，辅助性能优化。
• 日志压缩存储：通过对旧日志进行自动清理和压缩，规避存储空间占用问题。

消息推送与系统通知

• 原生内置分发：集成了企业微信、钉钉、飞书、Telegram、Bark、邮件等十余种主流渠道。
• 多事件灵活通知：您可以配置「任务失败」、「服务下线」、「登录安全报警」等事件通知条件。
• API 示例：系统自动生成各种编程语言的一键集成代码片段，方便用户脚本集成。

环境变量管理

• 机密性管理：对敏感字段（如脚本 Key、DB 密码）进行脱敏显示和加密存储。
• 全局环境隔离：在不同脚本运行期间动态注入，确保持久化和隔离。

仓库任务同步

• 青龙指令兼容：支持直接粘贴 ql repo 指令快速创建同步任务。
• 脚本自动注册：自动扫描同步目录下的脚本文件，解析其中的 new Env() 名称和 cron 表达式。
• 灵活筛选规则：支持通过正则表达式配置白名单、黑名单，精确控制哪些脚本需要转化为面板任务。
• 版本控制集成：基于 Git 进行增量同步，支持分支切换和稀疏检出（Sparse Checkout）。

系统设置

• 数据备份与恢复：支持全量数据的本地导出和一键导入恢复。
• 页面设置：自定义站点标题、标语和分页显示逻辑。