派 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]>
4.9 KiB
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 模块, 容易混淆:
/api/system/Schedule(web appsviews/teamwork/schedule/) — 日历日程 (startTime/endTime), 不是 cron/api/scheduletask(web appsapi/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 (立即补)
schedule update --id=X --cron=Y --executeContent=Z [--enabledMark=0|1]- 当前 AI 修改 cron 表达式只能 delete + create, 不安全 (会丢任务 ID 关联)
schedule delete --id=X- 删除任务是基本 CRUD 闭环, AI 调试常需
[NEW-CMD] P1
schedule selector- 类似 form selector, AI 交互式选择任务 ID
[NEW-CMD] P2 (不建议单独建)
schedule pause/resume— 用update --enabledMark=0/1替代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 个最关键建议:
- [P0] 新建
src/webapi/schedule.ts— 镜像web/api/system/task.ts, 现有 5 命令重构走 webapi - [P0] 新增
schedule update/delete— 补齐 CRUD 闭环 - [P1] 新增
schedule selector— AI 友好交互, 类似 form selector
不建议做的事:
- ❌ 不建议补
pause/resume/start/stop— JNPF 无对应 API - ❌ 不建议把
schedule log移到monitor— 数据源不同