Files
dacli/docs/cmd-review/schedule.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00

4.9 KiB

dacli schedule 命令审计报告 (2026-06-25)

1. 命令清单

当前 dacli schedule 父命令有 5 个子命令:

子命令 完整语法 用途 实现状态
list dacli schedule list [--json] 列定时任务 部分实现 (JNPF 6.2 端点 bug)
info dacli schedule info --id=<id> [--json] 查任务详情 (cron/executeContent/enabledMark) ✅ 完整
create dacli schedule create --fullName=X --enCode=Y --executeType=Z --executeContent=W [--cron=C] [--json] 新建 Quartz cron 任务 ✅ 完整
log dacli schedule log --id=<id> [--json] 查执行日志 (id/runTime/runResult) ✅ 完整
trigger dacli schedule trigger --id=<id> 手动触发 (白名单) ✅ 完整

缺失的关键子命令:

  • update (修改 cron/executeContent/enabledMark)
  • delete (删除任务)
  • pause/resume (暂停/恢复 - JNPF 后端有 enabledMark 但无专用端点)
  • start/stop (启动/停止)
  • selector (下拉选择器, 用于 AI 选择任务 ID)

2. web 端对应

真正的定时任务 API:

  • 文件: web/apps/jnpf-web-apps-main/src/api/system/task.ts
  • 基础路径: /api/scheduletask
  • 函数: getTaskList / create / update / getInfo / delTask / getTaskLogList / getTaskMethodsList

注意: web 端有 两个 Schedule 模块, 容易混淆:

  1. /api/system/Schedule (web apps views/teamwork/schedule/) — 日历日程 (startTime/endTime), 不是 cron
  2. /api/scheduletask (web apps api/system/task.ts) — Quartz cron 任务 ✅ (dacli 当前用的)

web 端可用的完整 API 列表:

GET    /api/scheduletask                    → getTaskList (分页)
POST   /api/scheduletask                    → create
PUT    /api/scheduletask/{id}               → update  ⭐ dacli 缺失
GET    /api/scheduletask/Info/{id}          → getInfo
DELETE /api/scheduletask/{id}               → delTask  ⭐ dacli 缺失
GET    /api/scheduletask/{id}/TaskLog       → getTaskLogList
GET    /api/scheduletask/TaskMethods        → getTaskMethodsList (Quartz class 列表)
POST   /api/scheduletask/white/trigger      → trigger (dacli 已有, web 端无对应函数)

3. 改/删/留 建议

[KEEP] 现有 5 个命令全部保留

  • list: 保留 (即使 JNPF 6.2 GET 端点 bug, 仍提供 web 端引导)
  • info: 保留 (单点查, 替代 list 的兜底方案)
  • create: 保留 (核心功能)
  • log: 保留 (调试关键)
  • trigger: 保留 (调试关键)

[REFACTOR-WEBAPI] P0 重点

新建 src/webapi/schedule.ts 镜像 web 端 7 个 API 函数:

  • 所有 5 个命令都是手工调用, 与 dacli v0.11+ 架构不符
  • 跟 web 端自动同步 + 代码减少 50%

[NEW-CMD] P0 (立即补)

  1. schedule update --id=X --cron=Y --executeContent=Z [--enabledMark=0|1]
    • 当前 AI 修改 cron 表达式只能 delete + create, 不安全 (会丢任务 ID 关联)
  2. schedule delete --id=X
    • 删除任务是基本 CRUD 闭环, AI 调试常需

[NEW-CMD] P1

  1. schedule selector
    • 类似 form selector, AI 交互式选择任务 ID

[NEW-CMD] P2 (不建议单独建)

  1. schedule pause/resume — 用 update --enabledMark=0/1 替代
  2. schedule start/stop — JNPF 无 start/stop API, 不建议建

4. AI 痛点评估

调试"定时任务不执行"路径: ⭐⭐⭐⭐ (4/5)

Step 1: dacli schedule info --id=X         → 确认 cron 表达式
Step 2: dacli schedule log --id=X          → 看最近执行结果 (runResult)
Step 3: dacli schedule trigger --id=X      → 手动触发一次
Step 4: dacli schedule log --id=X          → 看手动触发结果

痛点:

  • 缺 update, AI 修改 cron 必须重建 (有 enCode 冲突风险, BS-49)
  • list 端点 bug 需提示用户去 web 端拿 ID

与 monitor 命令关系

  • schedule log 提供任务级日志
  • monitor 应提供平台级监控, 但 JNPF 后端没有专门的"调度日志监控"端点
  • 建议: 在 schedule log 的 --ai-help 提示平台级监控的局限

架构一致性

  • ❌ 未走 webapi 架构: 5 个命令全是手工 JnpfClient 调用, 是 24 父命令中少数未镜像的
  • ✅ 三层防御兼容: 现有 5 个命令都有 --ai-help/--source/--example
  • ✅ 决策 9 注释完整: schedule 与 workflow 区别明确 (定时 vs 审批)

核心结论: dacli schedule 有 5 个子命令 (list/info/create/log/trigger), 覆盖核心 CRUD 但缺 update + delete 两个 P0 命令, 且未走 v0.11+ webapi 镜像架构.

3 个最关键建议:

  1. [P0] 新建 src/webapi/schedule.ts — 镜像 web/api/system/task.ts, 现有 5 命令重构走 webapi
  2. [P0] 新增 schedule update/delete — 补齐 CRUD 闭环
  3. [P1] 新增 schedule selector — AI 友好交互, 类似 form selector

不建议做的事:

  • ❌ 不建议补 pause/resume/start/stop — JNPF 无对应 API
  • ❌ 不建议把 schedule log 移到 monitor — 数据源不同