Files
dacli/docs/cmd-review/log.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

3.1 KiB

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

1. 命令清单

子命令 格式 用途
dacli log login [--keyword] [--json] 登录日志 (近 30 天, category='1')
dacli log operate [--keyword] [--json] 操作日志 (category='3')

注: 当前仅 2 个子命令,缺 3 个核心日志类型: 异常日志 (category='4')、请求日志 (category='5')、访问日志

2. web 端对应

4 个完整日志页面 (在 web/apps/jnpf-web-apps-main/src/views/sysLog/):

  • 登录日志 loginLog/ (category='1')
  • 操作日志 operateLog/ (category='3')
  • 异常日志 errorLog/ (category='4')
  • 请求日志 requestLog/ (category='5') + Detail.vue

API 端点 (web/.../api/system/log.ts 6 函数):

  • getLogList() GET /api/system/Log (分页查询)
  • delLog() DELETE /api/system/Log (批量删除)
  • batchDelLog() DELETE /api/system/Log/{type} (一键清空)
  • getInfo() GET /api/system/Log/{id} (单条详情)
  • batchDelLoginLog() DELETE /api/system/Log/deleteLoginLog

关键缺失: webapi/log.ts 不存在 (其他 6 个模块已镜像)

3. 改/删/留 建议

[KEEP] login + operate (基础能力)

[REFACTOR-WEBAPI] P0 必做

创建 src/webapi/log.ts 镜像 6 函数,消除硬编码 c.get('/system/Log', ...)

[NEW-CMD] P0 必补 — 3 个核心日志类型

  • dacli log exception (category='4') — Java 异常堆栈查询,AI 调试核心入口
  • dacli log request (category='5') — API 调用审计
  • dacli log visit — 访问日志 (需先调研后端)

[NEW-CMD] P1 — CRUD 闭环

  • dacli log info <id> (单条详情/完整堆栈)
  • dacli log delete <ids...> (批量删除)
  • dacli log clear <type> (一键清空)

[NEW-CMD] P2 — 增强过滤

  • --status=success|fail (loginMark)
  • --type=login|logout (loginType)
  • --method=GET|POST (requestMethod)
  • --module=X (moduleName)
  • --since/--until (时间范围)
  • dacli log tail --type=exception (实时跟踪)
  • dacli log export <type> (CSV/JSON 导出)

4. AI 痛点评估

后端异常排查效率 — 严重不足

  • 当前 AI 只能翻原始日志或搜操作日志关键词,但操作日志不记录异常堆栈
  • 缺失链路: form create 失败 → 想查异常原因 → log exception 命令不存在
  • 改进后: dacli log exception --keyword=test 直接拿到 SQL 堆栈

过滤引导 — 部分缺失

  • ✅ 有 --keyword
  • ❌ 缺状态/类型/模块/时间/IP 等结构化过滤

与 backend-dev 集成 — 完全未打通

  • L3 diagnose 不联动日志查询
  • 日志输出 slice(0, 200) 截断严重,会切断异常堆栈
  • 无原生 log→exception 跳转引导

核心结论: dacli log 当前仅 2 子命令,严重不足。

3 个最关键建议:

  1. 【P0】新增 dacli log exception — AI 排查后端异常的唯一杀手锏,当前完全缺失
  2. 【P0】创建 webapi/log.ts 镜像 — 同步 web 端 6 函数,消除硬编码
  3. 【P0】补全 log request 子命令 — 审计 API 调用,category='5' web 端已完整实现