# 6.16 定时任务管理

:::tip 概述
任务管理页（gin_job + gin_job_log）管理 cron 任务的定义与执行：新建、启停、手动执行、执行日志。调度机制详见 [5.19 定时任务调度机制](/zh/core/job-scheduler.html)。
:::

## 功能清单

### 任务（job）

| 接口 | 说明 |
|---|---|
| Page / List / Detail | 标准查询 |
| Add / Update / Delete / BatchDelete | 任务定义维护（url 字段 = 处理器注册名） |
| RunOnce | GET /api/job/runOnce/:id 立即执行一次（经执行锁防并发，权限码 sys:job:execute） |
| Pause / Resume | GET /api/job/pause/:id、resume/:id 暂停/恢复（cron 摘除/挂载） |
| Status | POST /api/job/status 设置任务状态 |
| DaemonStatus | GET /api/job/daemonStatus 调度器守护状态（登录即可，无需权限码） |

### 执行日志（job_log）

| 接口 | 说明 |
|---|---|
| Page / List / Detail | 执行记录查询 |

## 任务记录关键字段

| 字段 | 语义 |
|---|---|
| url | 处理器注册名（与 internal/task 的 RegisterJobHandler 名一致，**数据驱动查找**） |
| cron_expression | cron 表达式（或 @every 描述符） |
| execute_policy | 执行策略：1-立即执行 2-执行一次 3-放弃执行（字典 job_execute_policy 回填显示名） |
| is_sync | 是否同步执行：0-否 1-是（字典 job_is_sync） |
| params | 任务参数（JSON 字符串，传给处理器） |
| status | 启停状态（字典 job_status） |

url 与处理器注册名不匹配时任务无法执行——新建任务前确认处理器已注册（内置：LogClean / SendSms / HelloWorld）。

## 执行可靠性

执行锁（`job.lockTTLSeconds`，执行期自动续期）+ 任务日志（开始/结束/耗时/结果摘要）。

## 管理界面

`monitor/job`：任务列表 + 执行日志页签 + 手动执行/启停按钮。

## 相关

- [5.19 定时任务调度机制](/zh/core/job-scheduler.html)