# Phase 1 总结报告: 23 个 dacli 父命令审计 (2026-06-25) > **背景**: 用户在 v0.11+ plan 中要求"逐个过 23 个 dacli 父命令", 看 web 端页面逻辑, 决定命令改/删/留. > **方法**: 5 批 × 5/批 派 Explore 子代理并行审计, 主代理汇总. > **产出**: `dacli/docs/cmd-review/` 23 个 markdown 报告 + 本总结. ## 1. 审计覆盖 (23/23 完成) | 批次 | 命令 | web 路径修正 | |------|------|--------------| | A | apis, app, bigscreen, datasource, di | **bigscreen** → `jnpf/前端/jnpf-web-datascreen-vue3` | | B | dict, dm, doc, form, integration | — | | C | log, menu, monitor, msg, org | — | | D | portal, print, report, role, schedule | **report** → `jnpf/前端/jnpf-web-datareport` | | E | storage, user, workflow | — | **用户关键修正** (2026-06-25): 1. **bigscreen** web 在独立子项目 `jnpf-web-datascreen-vue3`, 不是主 webapp 2. **report** web 在独立子项目 `jnpf-web-datareport`, 不是主 webapp 3. 这两类命令审计 v2 已重新执行 ## 2. 总体数据 | 维度 | 数据 | |------|------| | 总子命令数 | 116 (24 父命令) | | webapi 镜像模块 | 6 (dataModel/dataSource/dict/menu/visualDev/workflow) | | webapi 镜像函数 | 95 | | webapi 实际使用率 | **< 30%** (大量 c.postJson/c.get 仍手写) | | 缺 [REFACTOR-WEBAPI] 的命令 | **12+ 父命令** | | 缺 [NEW-CMD] P0 必补 | **30+ 个新命令** | | 端点错误 (P0 假 PASS) | **3 处** (integration emailTest/smsTest, msg templateCreate) | ## 3. P0 优先级 Top 10 (按执行价值) 1. **`dacli form update` (高需求, 增量改 schema)** — 改 schema 需 export → 改 → import, 无原子性 2. **`dacli log exception` (P0 必补)** — AI 排查后端异常的唯一杀手锏, 当前完全缺失 3. **`dacli di info/test/create/update/delete` (5 个)** — 当前 1 个 list, AI 完全无法闭环 4. **`dacli role update/info/selector/authorize` (4 个)** — 权限管理闭环断裂 5. **`dacli org update/delete/info + org position (5 子) + org selector`** — 闭环 + 岗位空白 6. **`dacli msg noticeUpdate/Delete + templateUpdate/Delete` (4 个)** + 修端点错误 7. **`dacli storage create/update/delete + upload/download/ls` (6 个)** — 阻塞附件调试 8. **`dacli apis search --field=` (P0)** — 解决 AI 字段盲猜 9. **`dacli bigscreen update/delete/category` (3+ 个)** — 补全 CRUD 闭环 10. **`dacli report create/update/delete + preview + category` (5+ 个)** — 报表管理 3/8 = 12.5% 覆盖率 ## 4. P0 [REFACTOR-WEBAPI] Top 5 (架构对齐) 1. **datasource** 4 子命令 (100% 绕 webapi) — webapi/dataSource.ts 已镜像 11 函数, 使用率 0% 2. **dict** 4 子命令 (100% 绕 webapi) — webapi/dict.ts 已镜像 15 函数, 使用率 0% 3. **menu** 6/8 子命令 (1/15 = 6.7% 使用率) — 消除 ~120 行硬编码 4. **form** import.ts (8 调用) + codegen.ts (4) + create.ts (4) + fixcolumndata.ts (3) — 22 调用待切 5. **dm** create + drop — 切到 webapi/dataModel.ts ## 5. 端点错误 (P0 假 PASS, 立即修) | 命令 | 当前错误端点 | 正确端点 | 影响 | |------|--------------|----------|------| | `integration emailTest` | `/message/SendMessageConfig/testSendConfig` | `/message/AccountConfig/testSendMail` | 假 PASS | | `integration smsTest` | `/system/SmsTemplate/testSent` | `/message/AccountConfig/testSendSms` | 假 PASS | | `msg templateCreate` | `/api/system/MessageTemplate` | `/api/message/MessageTemplateConfig` | 调用失败 | ## 6. AI 痛点 Top 5 跨命令 1. **webapi 一致性差** — 12+ 父命令 100% 绕 webapi, 大量 c.postJson/c.get 手写 2. **CRUD 闭环断裂** — 大量命令缺 update/info/delete, 改名/修改/清理需 delete+create 3. **selector 缺失** — 多个命令缺选择器 (role/org/dict type/storage/menu), AI 引用 ID 需 list 拉全表 4. **P0 端点错误 (假 PASS)** — 3 处端点错, AI 调用成功但实际不生效 5. **子项目 web 路径未知** — bigscreen/report 是独立子项目, 需特殊处理 ## 7. Phase 2 执行建议 ### 立即执行 (P0 端点错误) - 修 integration emailTest/smsTest 端点 - 修 msg templateCreate 端点 - 加 @deprecated 标记 - **执行时间**: 半天 ### 短期 (P0 必补 [NEW-CMD]) - form update (2 周) - log exception (1 周) - di info/test/create/update/delete (1 周) - role update/info/selector/authorize (1 周) - org position + selector (1 周) - msg noticeUpdate/Delete + templateUpdate/Delete (3 天) - **总时间**: ~6 周 ### 短期 (P0 必补 [REFACTOR-WEBAPI]) - datasource 4 子命令 (2 天) - dict 4 子命令 (2 天) - menu 6 子命令 (3 天) - form import/codegen/create/fixcolumndata (1 周) - **总时间**: ~2 周 ### 中期 (P1 增强) - apis search (3 天) - storage CRUD (1 周) - bigscreen update/delete/category (1 周) - report CRUD (2 周) ## 8. 不建议做的事 (基于审计) 1. ❌ 不建议补 `schedule pause/resume/start/stop` — JNPF 无对应 API, 用 `update --enabledMark` 替代 2. ❌ 不建议把 `schedule log` 移到 `monitor` — 数据源不同 3. ❌ 不建议命令化 bigscreen/report 设计器 drag-drop — UI 复杂操作, 命令化收益低 4. ❌ 不建议补 `app init --restart` 实际功能 — 现有 dry-run 已说明, 改用 `app use ` 替代 5. ❌ 不建议 `dict dataList` 改名 — 现有 4 子命令命名清晰 ## 9. 下一步 **Phase 2 开始**: 按 P0 优先级执行 1. **Day 1-2**: 修 3 处端点错误 + 加 @deprecated 2. **Week 1**: form update + log exception 3. **Week 2-3**: di/role/org/msg P0 必补 4. **Week 4-5**: webapi 镜像化 (datasource/dict/menu/form) 5. **Week 6+**: P1 增强 (apis search / storage / bigscreen / report) --- **作者**: 2026-06-25 派 25 个 Explore 子代理审计 (5 批 × 5) **审计者**: 23 个 dacli 父命令 (apis/app/bigscreen/datasource/di/dict/dm/doc/form/integration/log/menu/monitor/msg/org/portal/print/report/role/schedule/storage/user/workflow) **关键修正**: bigscreen/report 是独立子项目, web 路径已修正 **下一步**: Phase 2 按 P0 优先级执行