派 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.1 KiB
4.1 KiB
dacli bigscreen 命令审计报告 (2026-06-25, 重新审计 v2)
v2 修正: 用户指出大屏 web 端源码不在主 webapp, 而在独立项目
jnpf/前端/jnpf-web-datascreen-vue3. 此版基于正确路径重新审计.
1. 命令清单
| 子命令 | 格式 | 用途 |
|---|---|---|
dacli bigscreen list |
[--keyword] [--category] [--json] |
列出所有大屏(按 category 过滤) |
dacli bigscreen info |
<id> [--json] |
查看大屏详情(含 design JSON) |
dacli bigscreen create |
--fullName --enCode --category --json |
创建大屏基础记录 |
dacli bigscreen release |
<id> [--json] |
发布大屏(state=1) |
2. web 端对应 (正确路径)
正确路径: /home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datascreen-vue3/
2.1 API 模块 (在 src/api/)
visual.js— 大屏 CRUD (list/copy/detail/save/update/remove)category.js— 分类管理components.js— 组件管理glob.js— 全局变量record.js— 访问记录
2.2 页面架构 (在 src/page/)
list/— 大屏列表+分类+CRUD 对话框build.vue— 大屏设计器(复杂 drag-drop 交互)view.vue— 预览
2.3 关键端点 (web 端)
/visual/listGET — 列表/visual/detail/{id}GET — 详情/visual/savePOST — 创建/visual/updatePOST — 修改 (含 status=1 发布)/visual/removeDELETE — 删除/visual/copyPOST — 复制/category/*— 分类管理
2.4 严重不一致
- dacli 走
/extend/BigData(主平台, 错误) - web 端走
/visual/*,/category/*,/glob/*,/record/*(独立项目, 正确) - 两套 API 返回数据结构不同 (
data.listvsdata.data.records)
3. 改/删/留 建议
[KEEP] 保留
- list — 保留但需加
--webapiflag + 改端点 - info — 保留但需重构 (走
/visual/detail/{id}而非复用 list) - create — 保留但需补 width/height/category 参数
- release — 保留但应改用
/visual/update status=1
[REFACTOR-WEBAPI] P0 重点
新建 src/webapi/visualdata.ts 镜像 web 端 API:
getVisualList(列表,/visual/list)getVisualDetail(详情,/visual/detail/{id})createVisual(创建,/visual/save)updateVisual(修改+发布,/visual/update)removeVisual(删除,/visual/remove)copyVisual(复制,/visual/copy)
[DEPRECATE] 无
[NEW-CMD] P0 必补
dacli bigscreen update— 走/visual/updatePOSTdacli bigscreen delete— 走/visual/removedacli bigscreen category— 子命令组: list/add/update/deletedacli bigscreen export/import— 跨 app 迁移dacli bigscreen copy— 复制大屏
[NEW-CMD] P2
dacli bigscreen preview-token— 生成分享 token
4. AI 痛点评估
分类管理缺失
- dacli 用硬编码
category=1 - web 用
categoryValue字符串键 (从category.js拉) - AI 不知道有效分类, 需补
bigscreen category list
设计器 drag-drop 无 webapi 化
- 大屏设计器是复杂可视化交互 (
build.vue) - 无法通过 API 完全复制设计器
- AI 只能建空壳大屏, 设计需 web UI 兜底
数据源绑定闭环不全
- 大屏依赖 DI 拉数据
- dacli 创建的大屏无数据绑定 (web 端
setup/database.vue管绑定) - 应增加
--dataInterfaceId参数 +bigscreen binding子命令
API 路径不一致
- 这是 最严重盲点: dacli/web 走不同 API 路径, 数据结构不同
- 修复: 切 webapi/visualdata.ts 走 web 端真实端点
核心结论 (v2): bigscreen 命令存在 API 路径严重不一致 (dacli 走主平台端点, web 走独立子项目端点). 当前 4 子命令可用但功能残缺, 缺 update/delete/copy + category 子命令组.
3 个最关键建议:
- [P0] 新建
webapi/visualdata.ts: 统一走 web 端/visual/*路径, 消除 API 不一致 - [P0] 实现
update/delete/copy命令: 走 webapi, 补全 CRUD 闭环 - [P0] 解决数据源绑定闭环: 增加
--dataInterfaceId+bigscreen binding子命令 (否则大屏无数据)