# dacli `menu` 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20) ## 1. 命令清单 (8 个公开子命令) | # | 命令 | 用途 | 状态 | |---|------|------|------| | 1 | `dacli menu list` | 列出菜单 (树形) | ✅ KEEP + webapi | | 2 | `dacli menu info ` | 菜单详情 | ✅ KEEP | | 3 | `dacli menu create` | 创建菜单 (支持 --formId 自动挂载) | ✅ KEEP | | 4 | `dacli menu delete ` | 删菜单 (--cascade) | ✅ KEEP | | 5 | `dacli menu releases` | 查已发布版本菜单 | ✅ KEEP | | 6 | `dacli menu unrelease ` | 撤销发布 | ✅ KEEP | | 7 | `dacli menu purge ` | 彻底清除 (含回收站) | ✅ KEEP | | 8 | `dacli menu _helpers` | 内部辅助 (URL 修正等) | 内部 | ## 2. web 端对应 - 菜单页: `web/apps/jnpf-web-apps-main/src/views/permission/menu/` (或 `system/`) - 菜单 API: `web/apps/jnpf-web-apps-main/src/api/permission/menu.ts` (15 函数) - **webapi/menu.ts 已存在** (v0.11 Phase 1 已镜像, 15 函数) ## 3. 改/删/留 建议 ### [KEEP] 全部 8 命令保留 覆盖全生命周期, 设计合理 ### [REFACTOR-WEBAPI] **P0 重点** (webapi 使用率仅 1/15 = 6.7%) 6 个子命令应切到 `loadMenu.*`: - **create.ts 低级模式**: `c.postJson('/system/Menu')` → `loadMenu.create(body)` - **create.ts SelectorFilter**: `c.get('/system/Menu/SelectorFilter/0')` → `loadMenu.getMenuSelectorFilter()` - **delete.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)` - **info.ts**: `c.get('/system/Menu/{id}')` → `loadMenu.getInfo(id)` - **purge.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)` - 注: Actions/Module + getReleaseMenu 在 web visualDev.ts 不在 menu.ts, 保留原 API 合理 ### [DEPRECATE] 无 ### [NEW-CMD] **P1 必补** - **`dacli menu update `** — 改菜单 (改名/移动/属性改), webapi 已有 `update` - **`dacli menu selector [--category] [--type]`** — 一步输出可挂载父菜单树, AI 友好 (webapi 有 getMenuSelector + getSelectorAll) ### [NEW-CMD] P2 - **`dacli menu export ` + `dacli menu import`** — 跨 app 迁移 (webapi 有 exportMenu) - **`dacli menu move --newParentId`** — 移动菜单 (可合并到 update) - **`dacli menu permission `** — 调试"菜单 403" ### [NEW-CMD] P3 - **`dacli menu fixDisplay --id`** — BS-43 一键补 7 必填字段 - **`dacli menu clone `** — 克隆菜单变体 ## 4. AI 痛点评估 ### 菜单创建流程: 友好 ✅ - `--formId` 自动走 web Actions/Module, 后端自动构造 propertyJson + 授权 - D-12/BS-50 多层防护, create.ts 自动兜底 webType=4 + propertyJson.moduleId + urlAddress 反查 ### D-12 防御: 较完善 ✅ - 三层防护 (create.ts D-9/D-12 反查 + guard BS-50 + D-4 fallback) - 但 urlAddress 非 model/ 前缀时仍可能留空 moduleId, 建议加 ERROR 提示 ### 菜单+form 联动: 基本闭环 ✅ - create/releases/purge 配合 form release 完整流程 - 缺 form 端选择器 ### 父菜单查找: 仍繁琐 ⚠️ - create.ts v0.7.1 已自动 SelectorFilter 找 type=1 父 - AI 需特定父时仍需 list 找 - **应加 `menu selector` 命令** ### M2 menu create CurrentUser 缓存阻塞 (2026-07-20 实战) ⚠️ - ❌ `menu create --formId=X` 成功后, form 端 `pcIsRelease=1` 已设, 但 `/api/oauth/CurrentUser` 的 menuList **不显示**新挂菜单 - 影响: `dacli test browser` 找 menu URL 失败 (`realUrl: ""`), TC-B 全阻塞; 用户访问 http://nginx/jnpf_app_jxcj 看不到新菜单 - jxcj M2 重启 (2026-07-20) 实战: 11 form-bound menu 全 create 成功, `dacli menu list` 显示 11 条, 但 CurrentUser.menuList 0 条. 二次 re-login 无效 - **修复路径**: 见 [ADR 0013](../decisions/0013-menu-create-currentuser-cache.md) - P1 [NEW-CMD]: `menu cache clear` 一键清 CurrentUser 缓存 - P1 [OPTIMIZE]: `menu create` 成功后自动 invalidate 缓存 - P1 [OPTIMIZE]: `test browser` 找 menu URL 失败时 fallback 到 `/jnpf_app_${appCode}/model/${formEnCode}` 直接 URL (jxcj M2 已验证) --- **核心结论**: webapi/menu.ts 使用率仅 1/15 (6.7%), 6 个子命令切 webapi 收益大. CRUD 闭环缺 update, AI 改名/移动需 delete+create 浪费. **Top 3 关键建议**: 1. **REFACTOR-WEBAPI** (P0): 6 命令切到 `loadMenu.*`, 消除 ~120 行硬编码 2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费 3. **NEW menu selector** (P1): 一步输出父菜单树, AI 体验大幅提升 **M2 新增建议** (2026-07-20): 4. **P1 [NEW-CMD]** `menu cache clear` — 清 CurrentUser 缓存, TC-B 不再阻塞 5. **P1 [OPTIMIZE]** `menu create` 后自动 invalidate 缓存 — 避免 TC-B 阻塞 6. **P1 [OPTIMIZE]** `test browser` fallback 到 form 直接 URL — 临时方案兜底