# dacli `form` 命令审计报告 (v0.11+, 2026-06-25, M2 实战补丁 2026-07-20) **审计对象**: `/home/ubuntu/ccWorkDir/dacli/src/commands/form/` (24 个文件: 14 命令 + 10 私有) **重点**: webapi 架构对齐 + AI 友好性 + 盲点覆盖 ## 1. 命令清单 (14 个公开子命令) | # | 命令 | 用途 | 状态 | |---|------|------|------| | 1 | `dacli form list` | 列出当前应用所有表单 (state=0/1/2) | ✅ KEEP + webapi | | 2 | `dacli form info ` | 拉表单完整 schema (formData/columnData/tables) | ✅ KEEP + webapi | | 3 | `dacli form create` | 创建表单 (--ai/--ai-json/--autoTable/--autoRelease) | ✅ KEEP | | 4 | `dacli form release ` | 发布/重新发布表单 (state 0\|2 → 1) | ✅ KEEP + webapi | | 5 | `dacli form delete ` | 删除表单 (--cascade 级联删菜单) | ✅ KEEP | | 6 | `dacli form export ` | 导出表单 JSON (跨库迁移) | ✅ KEEP | | 7 | `dacli form import ` | 从 JSON 导入表单 (--autoTable 重建物理表) | ✅ KEEP | | 8 | `dacli form clone ` | 克隆表单 (AI 黄金法则: 99% 应 clone 再改) | ✅ KEEP + webapi | | 9 | `dacli form validate ` | 运行时校验 (BS-23/31/32/15/V2/52) | ✅ KEEP | | 10 | `dacli form fixcolumndata ` | 修复 columnData 缺 use*Permission (BS-23 NPE) | ✅ KEEP | | 11 | `dacli form codegen` | 生成代码 (PascalCase + auto-alias) | ✅ KEEP | | 12 | `dacli form lint` | 设计期 lint (BS-31/32) | ✅ KEEP | | 13 | `dacli form bindFlow` | 表单绑工作流 (BS-44) | ✅ KEEP | | 14 | `dacli form selector` | 功能下拉框 (AI 工作流核心) | ✅ KEEP + webapi | ## 2. web 端对应 - 表单设计器: `web/apps/jnpf-web-apps-main/src/views/onlineDev/visualDev/` - 表单 API: `web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts` (30+ 函数) - **webapi/visualDev.ts 已存在** (v0.11+ Phase 1 已镜像, 30 函数) - **dacli/_buildformdata.ts 已直接 import web 端 buildFormData** (v0.11+ 关键修复, BS-51/52/54) ## 3. 改/删/留 建议 ### 3.1 [KEEP] - 全部 14 命令保留 - 所有命令都有真实使用场景 (AI 工作流 / 跨库迁移 / 调试验证) - 7 个核心命令 (list/info/create/release/clone/selector) 已切换 webapi ### 3.2 [REFACTOR-WEBAPI] - 优先级排序 **P0: import.ts (8 调用)** - 7 处 `/visualdev/Base` (create/list/release) 应全部走 webapi - 第 209 行 (数据建模 `Table`) 保留 `c.postJson` (属于 system 命名空间) **P1: codegen.ts (4 调用)** - saveAlias / getInfo / getAliasInfo / codePreview 全应走 webapi **P1: create.ts (4 调用)** - create / getVisualDevList / release / Module(createMenu) 应走 webapi **P1: fixcolumndata.ts (3 调用)** - getInfo / update / release 应走 webapi **P2: export/clone/validate/bindflow (各 1-2 调用)** - 局部迁移 (form/clone release 走 webapi, form/bindflow release 走 webapi) ### 3.3 [DEPRECATE] - 保留但标 @deprecated - **`_simplify.ts`**: 保留 (用户已习惯简化格式), 文件头已标 LEGACY ### 3.4 [NEW-CMD] 缺新命令 **`dacli form update ` (高需求)** - 改 schema 需 export → 手动改 → import, 无原子性 - 后端: PUT /api/visualdev/Base/{id} (已存在, 对应 `loadVisualDev.update`) - 自动 BS-49/50/52 防御 **`dacli form addFields --fields` (中需求)** - 增量加字段, 同时支持 `--tables` (自动 ALTER TABLE) **`dacli form rmFields --vmodel`** (中需求) - 删字段, `--drop-column` 同步删除物理表列 **`dacli form stats`** (低需求) - 表单总数 + 按 type/category/flow 维度分桶统计 **`dacli form diff `** (辅助) - 对比 formData + columnData + tables 字段级差异 ## 4. AI 痛点评估 ### 4.1 ✅ 已解决 - 表单创建流程: `--ai` / `--ai-json` / `--autoTable` / `--autoRelease` / `--autoCreateMenu` 一应俱全 - 盲点自动防御: L1 precheck (5 类) + L2 guard (22 条高频) + L3 diagnose (3 类错误诊断) - AI 帮助完整性: 所有命令都带 `--ai-help` / `--example` / `--source` - 3 层防御: precheck → guard → diagnose ### 4.2 ⚠️ 部分覆盖 - 字段级 BS-54 (select/relationForm): `_buildformdata.ts` 通过 web 端 buildFormData 100% 注入, 已修复 - `--autoTable` / `--autoRelease`: 已实现, 默认 type=4 视图不走物理表 ### 4.3 ❌ 仍有缺口 - 缺 form update: 增量改 schema 需 export → import - 缺 addFields / rmFields: 字段级 CRUD 缺失 - 缺 stats: 应用规模洞察不足 - 缺 diff: clone 后变更追踪缺失 - 菜单挂载 hard-coded: `create.ts` 第 665 行直接拼 body, 应走 `loadVisualDev.createMenu` ### 4.5 M2 form create relationForm 兜底 (2026-07-20 实战) ⚠️ - ❌ `form create --ai` AI 生成 relationForm 时 modelId/propsValue/relationField 三元组**覆盖率 ~60%**, 剩余 40% 触发 step machine 硬 FAIL (`关联功能不能为空 / 存储字段不能为空 / 回显字段不能为空`) - 根因: NCPF backend LLM 看不到父 form 的 formId 与字段, 仅从 description 推断 - jxcj M2 重启 (2026-07-20) 实战: 11 form 创建时 9 form 含 FK, 即便 description 显式写 `form_id=848939189058667461`, AI 仍生空 modelId - **当前绕路 (2-step 模式)**: `--ai` 不提 FK 字段 → PG ALTER TABLE 加 FK 列 → `form update --fields` 加 relationForm 三元组 - **修复路径**: 见 [ADR 0012](../decisions/0012-form-create-ai-relationform-fallback.md) - P0 [OPTIMIZE]: `_validate.ts` 软降级 - relationForm 缺三元组 → 自动改 `jnpfKey: "input"` + 警告 - P1 [OPTIMIZE]: `_relationForm_auto.ts` 启发式注入失败 fallback 到 input - P1 [OPTIMIZE]: `form update --fields` 检测 FK 命名模式 + 表无此列 → 自动 ALTER ADD COLUMN ### 4.4 selector 现状 | 接口 | selector | 状态 | |------|----------|------| | form (菜单挂载/工作流起始/select 字段) | `dacli form selector` | ✅ 已实现 | | workflow | `dacli workflow selector` | 待审 Batch E | | form-data (运行时数据) | 无 | 缺 | --- **核心结论**: dacli form 命令已建立完整 CRUD 体系 (14 子命令), v0.11+ Phase 1 已将 7 核心命令迁 webapi. `_buildformdata.ts` 通过直接 import web 端 buildFormData 修复 BS-51/52/54/55. **最关键 5 个建议**: 1. **[REFACTOR-WEBAPI]** 优先级: import.ts (8) > codegen.ts (4) > create.ts (4) > fixcolumndata.ts (3) > 其他 (1-2) 2. **[NEW-CMD]** form update (高需求, 增量改 schema), 写 spec 放入 W2+ 3. **[NEW-CMD]** form addFields / rmFields (中需求), 写 spec 放入 W3+ 4. **[KEEP]** `_simplify.ts` 保留, `_blindspots.ts` / `_buildformdata.ts` 是核心 5. **[AI 痛点]** 字段级 BS-54 已修复, 菜单挂载走 `loadVisualDev.createMenu` **M2 新增建议** (2026-07-20): 6. **P0 [OPTIMIZE]**: `_validate.ts` 软降级 relationForm → input — 见 [ADR 0012](../decisions/0012-form-create-ai-relationform-fallback.md) 7. **P1 [OPTIMIZE]**: `_relationForm_auto.ts` 启发式注入失败 fallback input (避免硬 FAIL) 8. **P1 [OPTIMIZE]**: `form update --fields` 自动 ALTER TABLE 加 FK 列 (修 ADR 0003 限制)