派 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]>
2.9 KiB
2.9 KiB
dacli storage 命令审计报告 (2026-06-25)
1. 命令清单 (7 个子命令)
| # | 命令 | 用途 |
|---|---|---|
| 1 | dacli storage list [--profile] [--yml] [--json] |
列出 application-{profile}.yml 中 file-storage 配置的所有后端 |
| 2 | dacli storage info <platform> [--profile] [--yml] [--json] |
显示某 platform 的详细配置 (敏感字段脱敏) |
| 3 | dacli storage test [platform] [--profile] [--yml] [--type] |
测试存储后端连通性 (走 /api/file/Uploader/{type}) |
| 4 | dacli storage use <platform> [--profile] [--yml] [--no-backup] |
切换 default-platform (备份 + 写 yml + 提示重启) |
| 5 | dacli storage backup [--profile] [--yml] |
显式备份 application-{profile}.yml |
| 6 | dacli storage diff [--profile] [--yml] |
跟 git HEAD 对比 yml 变化 |
| 7 | dacli storage _helpers |
内部辅助 (yml 解析等) |
2. web 端对应
- JNPF 后端:
/api/extend/Storage(POST/GET/PUT/DELETE) +/api/extend/Storage/{id}/Actions/Upload|Download - dacli 状态: 无 webapi 镜像 — storage 未在 v0.11+ webapi/ 模块列表
- Web UI: jnpf 6.x 不开放存储配置 UI (走 yml)
- 文件操作层:
web/.../api/core/common.ts已实现/api/file/Uploader/{type}(upload/preview/download/merge/packDownload)
3. 改/删/留 建议
[KEEP] 保留 (6 个全部)
- list, info, use, backup, diff — AI 调试核心
- test — 连通性验证必需
[REFACTOR-WEBAPI] P1 必做
新增 src/webapi/storage.ts, 镜像 web 端 /api/extend/Storage CRUD (优先级 P1)
- 当前走纯 yml 方案, AI 调试需了解 spring yml 结构
[NEW-CMD] P0 严重缺失 (5 个命令)
storage create/update/delete(P0 严重) — 当前 AI 无法添加/修改/删除 platform, 必须手动改 ymlstorage upload/download/ls(P0 严重) — 文件上传/下载无 CLI 入口, 阻塞附件调试和迁移场景storage types(P2) — 列出所有 backend-type (7+ 种), 当前需看源码才能知道支持哪些后端
[DEPRECATE] 无
4. AI 痛点评估
痛点 1 (最严重): 创建新 platform 完全缺失
- AI 初始化新存储后端场景被阻塞, 无法独立完成
痛点 2 (严重): 文件上传/下载无 CLI 入口
- 附件调试场景完全阻塞
痛点 3 (中等): 7 子命令完整度 50%
- CRUD 0/4 + 文件操作 0/3
- 对比 menu/user 缺乏完整性
webapi 镜像缺失影响
- AI 调试需深入 spring yml, 启动 JNPF 才能验证
- 不如其他 webapi 镜像命令即时
核心结论: storage 命令族当前可用率 50%, 缺 CRUD 和文件操作; AI 在初始化新存储和文件调试场景完全阻塞.
3 个最关键建议:
- P0 必做 (5-6 天): storage create/update/delete + storage upload/download/ls
- P1 推荐 (1-2 天): 新增 webapi/storage.ts 镜像
- P2 可选: storage types + list/info 默认 JSON 输出