diff --git a/docs/drift/2026-07-15-round17-plan.md b/docs/drift/2026-07-15-round17-plan.md new file mode 100644 index 0000000..d7fad73 --- /dev/null +++ b/docs/drift/2026-07-15-round17-plan.md @@ -0,0 +1,116 @@ +# Round 17 Drift Loop — Plan (jxcj M1 复盘驱动) + +**Date**: 2026-07-15 +**Driver**: jxcj M1 实战复盘 (docs/jxcj/{debug,learnings,summary}.md + ssw-loop M1 实战) +**App**: ts2 (漂移测试场2) + jxcj (真实业务) +**Predecessor**: [`2026-07-15-round16-summary.md`](2026-07-15-round16-summary.md) + +--- + +## 核心问题 + +R16 闭环 8/8 模块修复, 但**只覆盖了 baseline 镜像漂移** (JNPF baseline developSystem/workSystem 重建). jxcj M1 实战暴露 4 类 R16 修不了的问题: + +1. **P0 wire up relationForm auto-injection (BS-新117)**: 函数定义但 0 import/call. jxcj M1 topicDirection.f_competition_id 应是 relationForm 但生成 input. +2. **P1 AI 控件类型选错**: depSelect/timePicker/select 等 AI 即使 prompt 显式说明也选错. R16 FormRepair 18 条 label 启发式修不了 (label 模糊). +3. **P1 AI 幻觉字段**: input_num001 / inputNumber_num001 等业务外字段. R12/R15 P2 待修. +4. **P1 AI required 误标**: 启发式兜底只标 1 字段 (BS-新41), 可能漏标真必填, 错标上传控件 (jxcj f_wechat_qrcode). + +## R17 行动建议 + +### P0 R17 (本周) + +1. **wire up `autoDetectAndInjectRelationForm`**: + - 在 `dacli/src/commands/form/create.ts:295` 已有 (R17 wire-up 2026-07-15 完成) + - 加 vitest: `dacli/tests/integration/drift/round17-fix-batch5.spec.ts` 含 5 fixture + - `--ai` 路径自动检测 `f_competition_id` (snake) → topicDirection (camelCase) + - `--ai` 路径自动检测 `f_customer_id` → tds_customer (snake_case 直配) + - `--no-relation-form-auto` 关闭验证 + - 显式 `fieldRelationConfig` 不被覆盖 + - 命名 fuzzy 匹配 (snake_case ↔ camelCase ↔ PascalCase) + +### P1 R17 (下周) + +2. **vm-to-jnpfKey 启发式** (FormRepair 扩展): + - 不依赖 label, 看 `fieldDbType` (varchar/datetime/int/text) + vmodel 关键词推断 + - datetime → datePicker (强制, 即使 AI 选 timePicker) + - text → editor (强制, 即使 AI 选 textarea) + - 加 5 条 vm-to-jnpfKey 规则到 `_form_repair.ts` LABEL_PATTERNS (或新建 VM_PATTERNS) + +3. **upload 控件不标 required 启发式**: + - 在 `applyHeuristicRequired` 加 jnpfKey 白名单: uploadImg/uploadFile/editor 不标 required + - 即使 AI 启发式误标, 也被 dedup + +4. **category 自动派生优化**: + - 当前 fallback 用"车辆管理" id (跨 appCode 不正确) + - 改成: 优先从当前 app context 拿业务分类, 找不到再用默认 + +### P2 R18+ (长期) + +5. **NCPF backend LLM 修复**: 客户端层无法根治 fields_extra, 需 NCPF backend maxTokens 限制 + prompt 优化 (跨团队) +6. **prompt 模板加 "不要加额外字段" explicit 约束**: 配合 NCPF 修复 +7. **vitest round17-fix-batch5**: 加 5+ fixture (上面 P0/P1) + +## 验证 (P0 完成, 后续 round 跑) + +### TS 编译 +``` +src/commands/form/create.ts:299 → TS strict mode cast (Parameters[0]) +49 errors (baseline) == 49 errors after wire-up (0 新错) ✅ +``` + +### vitest 待加 (R17 fix-batch5) + +``` +✓ tests/integration/drift/round17-fix-batch5.spec.ts (5 tests) [TBD] + ✓ BS-新117 wire-up 验证: --ai 自动检测 f_competition_id → topicDirection + ✓ BS-新117 --no-relation-form-auto 关闭验证 + ✓ BS-新117 snake ↔ camelCase ↔ PascalCase fuzzy 匹配 + ✓ BS-新117 显式 fieldRelationConfig 不被覆盖 + ✓ BS-新117 aiModelList type cast (Parameters<...>[0]) +``` + +### 累计修复追踪 + +| Batch | 修 | vitest | 漂移闭环 | +|-------|----|-------|---------| +| Round 11 | BS-47 enCode strip | - | 5/8 | +| Round 12 batch 1 | F1+F2+F6 | 14 | 5/8 | +| Round 12 batch 2 | F3+F4+F5 | 10 | 5/8 | +| Round 13 | 漂移循环 + 4 新盲点 | - | 4 新识别 | +| Round 14 | F7+F8+F9+F10+F11 | 25 | 8/8 修复就位 | +| Round 15 | F7+BS-新47+F9 验证 | - | 3/4 闭环 | +| Round 16 | TS 镜像 ssw FormRepair | 18 + 3 | F11 闭环 | +| **Round 17 (计划)** | **BS-新117 wire-up + P1 启发式扩展** | **5 (待)** | **AI 4 限制闭环** | +| **累计** | **18 项修复** | **70 + 5 (待)** | **8/8 + AI 4** | + +## 镜像架构: ssw ↔ dacli 同步矩阵 (扩展) + +| 概念 | ssw-common (Java) | dacli (TS) | 同步点 | +|------|-------------------|------------|--------| +| 18 关键词启发式 (label) | `FormRepairServiceImpl.LABEL_TO_JNPFKEY` | `_form_repair.ts.LABEL_PATTERNS` | v0.21+ BS-新45 | +| F_ 前缀还原 | `FormRepairServiceImpl.repairFields` | `repairFormDataFields` | 同上 | +| **vm-to-jnpfKey** (R17+) | (待加) | `repairFormDataFields` (扩展) | R17 P1 | +| **upload 控件不标 required** (R17+) | (待加) | `applyHeuristicRequired` (扩展) | R17 P1 | +| relationForm auto-inject | (无 ssw 镜像, N/A) | `autoDetectAndInjectRelationForm` | R17 P0 | +| 接口 | `POST /api/ssw/form/repair-fields` | `repairFormDataFromString` (in-process) | BS-新45 | +| 部署 | 需 mvn package + JNPF restart | dacli CLI 调用即生效 | 独立 | + +## 输出物 (R17 计划) + +``` +dacli/src/commands/form/create.ts # R17 P0 wire-up 完成 (2026-07-15) +dacli/tests/integration/drift/round17-fix-batch5.spec.ts # R17 P0 vitest (待加) +dacli/src/commands/form/_form_repair.ts # R17 P1 vm-to-jnpfKey 扩展 (待) +dacli/src/commands/form/_smart_props.ts # R17 P1 upload 不标 required (待) +dacli/docs/drift/2026-07-15-round17-plan.md # 本文件 +``` + +## 总结 + +R17 解决 R16 修不了的 4 类 AI 限制问题: +- **P0 wire up relationForm** (已完成 2026-07-15, jxcj M1 复盘直接驱动) +- **P1 vm-to-jnpfKey + upload 不标 required** (下周) +- **P2 NCPF backend 修复** (跨团队长期) + +**累计**: 18 项修复, 70 vitest 全部 PASS, R17 完成后预期 AI 4 限制闭环. \ No newline at end of file diff --git a/src/commands/form/create.ts b/src/commands/form/create.ts index 2bdc29f..eed8e5d 100644 --- a/src/commands/form/create.ts +++ b/src/commands/form/create.ts @@ -288,6 +288,27 @@ export function buildFormCreateCommand(): Command { // buildFormData 100% 注入 formId/renderKey/isSubTable/options await initBuildFormData() const aiModelListForBfd = data.aiModelList || [] + // v0.21+ (2026-07-15 R17 P0) wire up BS-新117: relationForm 自动注入 + // 历史 (2026-07-15 jxcj M1 复盘): 函数 _relationForm_auto.ts:144 定义但 0 import/call + // 现在: --ai 路径自动检测 f_*_id 字段 + 注入 modelId/propsValue/relationField + // 修复: AI 不会自动给关联字段生成 relationForm, 用 dacli 启发式补救 + // 关闭: --no-relation-form-auto (commander 默认 true, --no-* 传时设 false) + if ((opts as any).relationFormAuto !== false) { + try { + const { autoDetectAndInjectRelationForm } = await import('./_relationForm_auto.ts') + // cast: aiModelListForBfd 含 billRule/unique 等 extra fields, 函数签名只关心 4 项 + const injected = await autoDetectAndInjectRelationForm( + aiModelListForBfd as unknown as Parameters[0], + ) + if (injected > 0) { + log.info(` ↳ relationForm 自动注入 (BS-新117 R17): ${injected} 个字段`) + } + } catch (e) { + log.warn(`relationForm 自动注入跳过 (${(e as Error).message?.slice(0, 80)})`) + } + } else { + log.info(` ↳ --no-relation-form-auto, 跳过 relationForm 自动注入`) + } const bfdResult = webBuildFormData(aiModelListForBfd) // bfdResult.formData 是 JSON 字符串, 里面有完整的 50+ formConf keys + fields // 后面 213 行的 _simplify formData 会被这个覆盖 (见 useBuildFormData 标志)