P4-1 转换器线:扩 EDITFORM/主子表/树/选择窗/<report> 段 + 全量 1516 模板批量转换双闸分级

转换器扩展(platform-converter,PoC crud 三段种子上):
- 按 XML 根元素分派 crud/form/tree/report/group;ConversionResult+Grade 三级分级
- EDITFORM:form pageid 解析 view_page 取字段;主子表 EditGrid/FormEditGrid→input-table(子列取自 editgridtemplate)
- 树:type=3 声明式→input-tree、type=4 引用式→flex(tree+crud)
- 选择窗 SelectDialog/MultiSelectDialog→select+source(非 amis picker:picker 不在 6.13 schema 表单项 oneOf,闸一会拒)
- <report> A 类:crud+合计行(issummer→summaryFields)+金额列(ismoney→number);selectservice→/api/flow;JOR/图表降级标注
- UiTypeMapper 统一 uitype 映射;每决策登记映射台账(全量约 1.6 万条)
- 孤儿模板(entityid 非法/空 xml)旁路标记不崩(手册 §7.4)

批量+双闸(BatchConvertCli,可独立 CLI 跑批,只读连库+5435 ceshi 库硬守门):
- 闸一 SchemaGate(宽松语义预处理抽出,与 AmisSchemaController 共享):通过 98.2%(1489/1516)
- 闸二 playwright+本地 amis SDK 渲染冒烟,每类型抽≥5:25/25 全过
- 产物 转换产物/(schema/*.json + 分级清单.csv + 闸二结果.json)
- 失败 27 个全为空 xml 孤儿模板(库内数据问题,非转换器缺陷)

新坑进手册 §8.3(picker 不在表单项 oneOf,用 select+source) §8.4(闸二大 schema 经端点拉避 HTTP 431)
单测 24 个;全 reactor mvn test+ArchUnit 绿
报告 platform-converter/P4批量转换报告.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 16:27:49 +08:00
parent aefb0e2eb9
commit f563b472e6
20 changed files with 37747 additions and 167 deletions

View File

@@ -653,6 +653,24 @@ com.dsasp.* com.eip4.*
| **对策** | **双闸缺一不可**:第一闸(schema 校验)抓结构问题;第二闸(headless 渲染冒烟,如 Puppeteer/Playwright 执行 `amis.embed`)抓渲染问题;P4 批量转换流水线必须两闸串联,两闸都过才入库 |
| **影响范围** | P4 全量 1,516 模板转换流水线;AI 生成管线;MCP Server validate-schema(需升级为双闸);决策会已将「双闸」作为质量门禁第 2 条 |
### 8.3 amis `picker` 表单项不在 6.13 schema 的表单项 oneOf 中(弹窗选择器映射坑)[NEW 2026-06-11]
| 栏目 | 内容 |
|------|------|
| **现象** | P4 批量转换把旧引擎 `uitype=SelectDialog` 弹窗选择器映射为 amis `picker` 控件后,**闸一 schema 校验大批失败**,错误为 `$.body.body: array found, object expected`(form 含 ≥3 表单项时爆发);但 picker 在浏览器实际能渲染 |
| **根因** | amis 6.13 官方 schema 中 `PickerControlSchema`(type const "picker")虽存在,但**未被纳入表单项的 oneOf 分支**;form.body 数组里出现 picker 时,校验器走不到 picker 分支、回落到把整个 form.body 当单对象(SchemaNode)的分支并报「array found, object expected」。这是 schema 枚举不全,非 schema 严格性问题 |
| **对策** | 弹窗选择器(SelectDialog/MultiSelectDialog)**映射为 `select` + 远程 `source`**(multiple 对应多选),而非 picker——select+source 双闸皆过且语义保真(弹窗本质是远程数据选择)。picker 需内嵌 pickerSchema(CRUD)、跨模板引用,本就无法在单模板转换内自洽。**实测此一项把闸一通过率从 94.7% → 98.2%** |
| **影响范围** | P4 转换器 uitype 映射表(已落 `UiTypeMapper`);任何把"弹窗选择"类旧控件转 amis 表单项的地方;AI 生成管线若生成 picker 表单项同样会被闸一拒,应优先用 select+source |
### 8.4 闸二渲染冒烟宿主:大 schema 不可经 URL query 注入(HTTP 431 坑)[NEW 2026-06-11]
| 栏目 | 内容 |
|------|------|
| **现象** | P4 闸二 playwright 渲染冒烟,个别大模板(字段多、schema 大)被误判「根组件未渲染出 DOM」;实为宿主 HTML 自身加载失败 |
| **根因** | 冒烟宿主把 schema JSON 经 `?schema=<urlencoded>` 塞进 URL,大 schema 撑爆 HTTP 请求头,Node 静态服务器返回 **431 Request Header Fields Too Large**,host.html 根本没加载 |
| **对策** | schema 经**独立端点**(`/schema?id=<模板id>` 后端读文件返回)拉取,URL 只传短 id;宿主 `fetch('/schema?id=…')` 后再 `amis.embed`。改后该类模板渲染恢复正常(form 抽样 4/5 → 5/5) |
| **影响范围** | P4 闸二冒烟宿主(已修,见 `platform-converter/gate2-smoke/{host.html,smoke.mjs}`);任何用 query 串传 schema 给 headless 宿主的渲染验证脚本 |
---
## 九、待补章节占位