# 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 ` (单条详情/完整堆栈) - `dacli log delete ` (批量删除) - `dacli log clear ` (一键清空) ### [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 ` (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 端已完整实现