PulseTask

轻量级、跨平台（Linux / Windows）的任务调度系统：Web 界面 + REST API + CLI 三种使用方式。

通过 Web 界面配置脚本任务的运行规则，支持按时间间隔、Crontab 触发或手动执行，提供任务管理、运行历史、日志查看等能力。

技术栈

功能特性

• 触发方式：固定间隔 / Crontab 表达式（UTC）/ 手动执行
• 执行控制：超时强制终止整个进程树、失败自动重试、按任务并发锁（同一任务不重复执行，不同任务并行运行）
• Web 界面：仪表盘统计、任务列表（搜索/筛选）、弹窗式新建/编辑任务、运行历史分页、终端风格日志查看（自动滚动到底部）
• REST API：完整任务生命周期管理，内置 Swagger 文档（/docs）
• CLI 启动：支持 --host / --port / --db / --reload 等参数
• 单 wheel 分发：pip install 后前端随包携带，开箱即用

快速开始

# 安装（任选其一；Python 包导入名为 pulsetask）
pip install pulse-task                      # pip
uv tool install pulse-task                  # uv，作为全局命令安装

# 从源码安装（开发模式）
uv venv .venv && uv pip install -e ".[dev]"

# 启动服务（默认 http://127.0.0.1:8000）
pulse-task

浏览器打开 http://127.0.0.1:8000 即可使用；API 文档在 http://127.0.0.1:8000/docs。

免安装直接运行：uvx pulse-task。

CLI 参数

pulse-task [--host HOST] [--port PORT] [--db PATH] [--ui DIR] [--reload] [--log-level LEVEL] [--version]

等价入口：python -m pulsetask。也可 uvicorn pulsetask.app:app 直接启动（此时 --db / --ui 需用环境变量）。

API 概览

项目结构

PulseTask/
├── README.md                # 本文档
├── DESIGN.md                # 设计文档（架构 / 数据库 / API / 页面）
├── pyproject.toml
├── docs/ui-design/          # UI 设计阶段产物存档（不参与运行）
├── src/pulsetask/
│   ├── app.py               # FastAPI 应用组装
│   ├── cli.py               # 命令行入口
│   ├── api.py               # /api 路由
│   ├── config.py            # 配置解析
│   ├── schemas.py           # 请求模型
│   ├── database.py          # SQLite 数据访问层
│   ├── scheduler.py         # 调度与命令执行
│   └── ui/pages/            # 前端静态页面 + 共享弹窗组件
└── pulsetask.db             # SQLite 数据库（首次运行自动创建）

开发

.venv/Scripts/ruff.exe check src        # 代码检查
.venv/Scripts/python.exe -m mypy        # 类型检查（strict）
uv build                                # 构建 wheel / sdist 到 dist/