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

79 lines
3.1 KiB
Markdown

# 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 端已完整实现