派 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]>
6.0 KiB
6.0 KiB
dacli dict 命令审计报告 (2026-06-25)
1. 命令清单
| 子命令 | 格式 | 用途 |
|---|---|---|
dacli dict typeList |
[--keyword] [--json] |
字典类型列表 (按编码/名搜索) |
dacli dict typeCreate |
--enCode --fullName [--items] [--category] [--isTree] [--json] |
创建字典类型 (含可选字典项) |
dacli dict dataList |
[--typeId|--all] [--json] |
字典数据列表 (按类型或全部) |
dacli dict dataCreate |
--typeId [--enCode|--items] [--fullName] [--json] |
往已存在字典类型追加字典项 |
2. web 端对应
- 字典类型页:
web/apps/jnpf-web-apps-main/src/views/sysData/dictionary/index.vue— 字典类型列表 (树形)Form.vue— 字典类型编辑表单components/Form.vue— 字典项编辑表单
- 字典 API:
web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts(15 函数)- 字典类型 (6): getDictionaryType/getDictionaryTypeSelector/createDictionaryType/updateDictionaryType/getDictionaryTypeInfo/delDictionaryType
- 字典数据 (9): getDictionaryDataList/getDictionaryAll/getDictionaryDataTypeSelector/getDictionaryDataSelector/createDictionaryData/updateDictionaryData/getDictionaryDataInfo/delDictionaryData/exportData
- webapi/dict.ts 已存在 (v0.11 Phase 1 已镜像, 15 函数)
- BS-47 关键约束: 字典的 enCode 和 fullName 全平台唯一 (跨 app), web 端 POST 重复时返回 "The name cannot be repeated"
3. 改/删/留 建议
[KEEP] 保留
- typeList — AI 防 BS-47 必需, 枚举已有字典来避免重复
- typeCreate — 杀手锏, 端到端 1 条命令建类型 + 字典项 (web 需 2 个页面)
- dataList — 字典项查询基础能力
- dataCreate — 补充 typeCreate, 追加字典项
[REFACTOR-WEBAPI] P0 重点
4 个子命令全部切到 loadDict.* 调用:
- typeList: 当前用
c.get('/system/DictionaryType')→ 应改loadDict.getDictionaryType({ keyword }) - dataList: 当前用
c.get('/system/DictionaryData/{typeId}/Data')→ 应改loadDict.getDictionaryDataList({ typeId })或loadDict.getDictionaryAll() - typeCreate: 当前用
c.postJson('/system/DictionaryType', ...)+c.postJson('/system/DictionaryData', ...)→ 应改loadDict.createDictionaryType()+loadDict.createDictionaryData() - dataCreate: 当前用
c.postJson('/system/DictionaryData', ...)→ 应改loadDict.createDictionaryData()
理由:
- v0.11+ 强制 webapi 镜像架构, 避免与 web 端 API 签名不同步
- webapi/dict.ts 已镜像 15 函数, 使用率为 0%
- 消除 ~80 行硬编码 API 调用, 同步 web 端字段变更 (如 enabledMark 默认值)
[DEPRECATE] 无
- 4 个现有命令都是基础 CRUD 子集, 无功能重复或设计错误
- 唯一改进: 内部实现切到 webapi 镜像, 命令名/参数/输出格式不变
[NEW-CMD] P1 高优先级 — 补全 CRUD 闭环
dacli dict typeUpdate <id>— webapi 已有updateDictionaryType(data), AI 建错字典需修改场景dacli dict dataUpdate <id>— webapi 已有updateDictionaryData(data), 字典项改名/改排序/禁用dacli dict typeDelete <id>— webapi 已有delDictionaryType(id), 删类型 + 递归删字典项
[NEW-CMD] P2 中优先级
dacli dict dataDelete <id>— webapi 已有delDictionaryData(id), 与 typeDelete 配对闭环
[NEW-CMD] P3 调试辅助
dacli dict typeInfo <id>— webapi 已有getDictionaryTypeInfo(id), 单条详情 (区别于 list)dacli dict dataInfo <id>— webapi 已有getDictionaryDataInfo(id), AI 调试 BS-47 时拿冲突字典完整信息
[NEW-CMD] P2 集成命令
dacli dict typeSelector— 输出树形选择器格式, 方便 form schema 直接引用 (form select 字段需 dict enCode)
4. AI 痛点评估
BS-47 (dict 全平台唯一) — 防护是否充分?
当前防护 (L2 guard BS-47):
- ✅ 命令执行前检查
ctx.existingEnCodes.includes(name/enc) - ✅ 失败时提示: "dacli dict dataList 看已有字典, 复用或加
<app>_前缀" - ✅ L1 pre-check 也支持
待优化:
- ⚠️ 提示用 "dacli dict dataList" 应改为 "dacli dict typeList" (命令名是 typeList, 不是 dataList)
- ⚠️ "加
<app>_前缀" 建议改为 "_" (从 app context 自动取)
结论: 防护已较完善, 提示文字有小 bug, Phase 2 修正
form 字段引字典时的引导 — 缺失
痛点:
- form create 时 select 字段需要
dict.enCode作 datasource - AI 不知道现在有哪些 dict 可选
- 需先
dacli dict typeList查 enCode, 再填到 form schema
建议:
- 新增
dacli dict typeSelector输出树形选择器格式 - 或在
dacli form create --help中加入"如何找 dict enCode"章节
dict 关联 form select 字段闭环 — 不完整
场景 (BS-54 关联):
- AI 想建带 select 字段的 form
- 需先建 dict (typeCreate)
- 拿到 dictId 或 enCode
- 填到 form schema 的 select 字段配置
当前闭环问题:
- 步骤 1-2: ✅ 有 typeCreate
- 步骤 3: ⚠️ 只能从 typeList 拿 enCode, 但要带 typeId (select 字段实际引用 typeId)
- 步骤 4: ✅ form create 支持 select + dict 配置, 但 schema 拼装靠 AI 手工
建议:
- form create 的 precheck 中加入: "select 字段需 dict enCode, 建议先
dacli dict typeList" - 或提供
dacli form create --dictCode=xxx简写 (自动展开为 select 字段)
核心结论: dacli dict 4 个子命令结构合理, 但 100% 绕过 v0.11+ webapi 镜像。webapi/dict.ts 已镜像 15 函数但使用率为 0%, 导致 API 不一致风险和 ~80 行重复代码。同时缺少 Update/Delete CRUD 闭环。
3 个最关键建议:
- P0 [REFACTOR-WEBAPI]: 4 个子命令全部切到
loadDict.*调用 - P1 [NEW-CMD]: 新增
typeUpdate+dataUpdate+typeDelete补全 CRUD 闭环 - P1 [OPTIMIZE]: 修正 L2 guard BS-47 提示文字 (dataList → typeList,
<app>_→<appCode>_)