docs(v0.13+): form/workflow webapi 改造 + --ai-json 删除

- 删除 form/_ai_prompts.ts (自写 LLM prompt 漂移)
- form/_ai.ts: 608->118 行 (-490), 只剩 NCPF backend 透传
- form/create.ts: 删 --ai-json 块 (290 行) + dead code + aiJsonTables
- form/create.ts: --ai 默认 autoRelease=true, 走 web buildFormData
- workflow/create.ts: 6 步 webapi 路径
- workflow/_webapi_helpers.ts: defaultGlobalForm 模板 (镜像 web FlowProcess)
- autoDeriveCategoryFromBusinessType: 改用 loadDict webapi 镜像
- 删除 NCPF backend 直连 LLM 路径
- 更新所有 docs: SKILL.md / CLAUDE.md / references / ssw-loop templates
- 写 v0.13-webapi-form-workflow-refactor.md changelog
- 写 v0.14-webapi-rollout-plan.md 推进计划

净减 567 行自写逻辑 (-23%), 端到端验证 OK.
This commit is contained in:
ssw committed 2026-07-01 12:22:49 +08:00
1 parent 428933e41e
commit 927e481473
14 files changed
+77 -137

No files matched your search

+2 -2
View File
@@ -51,7 +51,7 @@ dacli app context --json # 必看 dbLinkId / existi
dacli help # 22 父命令 / 116 子命令索引
```
> **注**: v0.11+ 推荐 `dacli form create --ai-json --autoRelease` (走 web 端 buildFormData, schema 自动完整)。已废弃 `--fields` 简化版。
> **注**: v0.13+ 推荐 `dacli form create --ai "<描述>" --autoRelease` (NCPF backend AI + web buildFormData + 自动发布, 一条命令端到端)。`--ai-json` 已删 (v0.13+ BS-新28, 跟 `--ai` 后半段完全一样, 保留会漂移)。已废弃 `--fields` 简化版。
## 当前应用 (app_code)
@@ -73,7 +73,7 @@ DI SQL 有较多限制。扩展功能时触发 `backend-dev` 技能,在 `ssw-{
### 2.5/2.5.1. 创建功能表单 + 镜像架构
> 详见 `.claude/skills/dacli-ts/references/architecture-philosophy.md` (镜像架构 5 要素 / 复用全景图 / 反模式)
> 表单创建命令速查: `dacli-ts/references/commands.md` § 1.3 form create (含场景 A --ai-json / 场景 B dm→form)
> 表单创建命令速查: `dacli-ts/references/commands.md` § 1.3 form create (含场景 A --ai / 场景 B dm→form, v0.13+ --ai-json 已删)
### 2.6/2.7/2.7.1. dacli 哲学 (派子代理 / web 源码 / 4 步流程)
> § 2.6 派子代理修复 → `dacli-ts/references/anti-patterns.md` (反模式总览, 含派子代理段)
+4 -4
View File
@@ -35,9 +35,9 @@ python3 $ccWorkDir/.claude/docs/ai-platform/scripts/one_click_dev.py \
dacli form create --fullName=学生信息表 --enCode=studentInfo --type=1 --webType=2 \
--dbLinkId=<id> --tables='[{"table":"as_student_info","tableName":"学生信息","fields":[...]}]'
# 创建表单(v0.11+ 推荐 --ai-json 路径, schema 自动完整)
# 创建表单(v0.11+ 推荐 --ai 路径, schema 自动完整)
dacli form create --fullName=学生信息表 --enCode=studentInfo --type=2 --webType=2 \
--dbLinkId=<id> --ai-json='[{
--dbLinkId=<id> --ai='[{
"tableTitle":"学生信息","tableName":"as_student_info","isMain":true,
"fields":[
{"field":"f_name","fieldTitle":"姓名","dataType":"varchar","dataLength":"100"},
@@ -153,9 +153,9 @@ RELATION_FORM_PATTERNS = [
# 1. 登录
dacli app login --account=admin --password=<密码> --appCode=tds
# 2. 创建表单 (v0.11+ --ai-json 路径, schema 自动完整)
# 2. 创建表单 (v0.11+ --ai 路径, schema 自动完整)
dacli form create --fullName=学生信息表 --enCode=studentInfo --type=2 --webType=2 \
--dbLinkId=<id> --ai-json='[{
--dbLinkId=<id> --ai='[{
"tableTitle":"学生信息","tableName":"as_student_info","isMain":true,
"fields":[{"field":"f_name","fieldTitle":"姓名","dataType":"varchar","dataLength":"100"}]
}]' --autoRelease
+35 -19
View File
@@ -24,29 +24,43 @@
# dacli (TS 版) — AI 驱动 JNPF CLI
> v0.11+ | 项目位置: `$ccWorkDir/dacli/` | 调用: `npx tsx $ccWorkDir/dacli/src/cli.ts ...`
> v0.13+ | 项目位置: `$ccWorkDir/dacli/` | 调用: `npx tsx $ccWorkDir/dacli/src/cli.ts ...`
## 🚀 v0.11+ 架构重大变化(2026-06-25)
## 🚀 v0.13+ 架构重大变化 (2026-07-01)
**核心**:dacli form **直接 import web 端 buildFormData**,不再复刻 schema 逻辑。
**核心**: form/workflow **全走 webapi 透传**, 不再自写 LLM prompt / BPMN 解析 / 字段映射.
```
AI/JSON 描述 → List<AiFormModel> → web 端 buildFormData (权威)
↓
formData JSON (含 formId/renderKey/isSubTable/options)
↓
POST /api/visualdev/Base
↓
JNPF 数据库落库
dacli form create --ai "..."
↓
[1] callAiForm → POST /api/visualdev/ai/form (NCPF backend, 走 JNPF 配置的 LLM)
↓ 返回 VisualAiModel
[2] web buildFormData (webapi 镜像) → 构造 50+ formConf 字段
↓
[3] loadVisualDev.create → POST /api/visualdev/Base
[4] loadVisualDev.release (默认 ON, type=1 真正发布) → POST /api/visualdev/Base/{id}/Actions/Release
↓
✅ form state=1, 可用 (List API 端到端 OK)
```
| 输入方式 | 命令 | 何时用 |
|---------|------|--------|
| **AI 描述** | `dacli form create --ai "做一个客户表"` | 不知道字段细节,AI 帮你定 |
| **AI JSON 直入** | `dacli form create --ai-json '<json>'` | **v0.11+ 推荐**: 会话内已生成 JSON,跳过 AI 调用 (走 web 端 buildFormData, schema 自动完整) |
| ~~手动 --fields~~ | ~~`dacli form create --fields='[...]'`~~ | **v0.11+ 已废弃**: 改用 `--ai-json` 路径 (webapi 镜像自动保证字段完整性) |
| **AI 描述** | `dacli form create --ai "客户管理:姓名、电话"` | **v0.13+ 默认路径**: 一条命令端到端, NCPF backend AI + web buildFormData + 自动发布 |
| **AI 推荐字段 (不建)** | `dacli form create --ai-field "请假天数, 含字典"` | 人类操作用的字段建议查询, 不建表单 |
| ~~`--ai-json`~~ | ~~`dacli form create --ai-json '...'`~~ | **v0.13+ 已删 (BS-新28)**: 跟 `--ai` 后半段完全一样 (都走 web buildFormData), 保留会让代码漂移 |
**JSON 契约**(见 `data/buildformdata-contract.md`):`List<{tableTitle, tableName, isMain, fields:[{fieldTitle, fieldName, fieldComponent, fieldOptions?}]}>`
**v0.13+ 删除的自写逻辑** (drift 源):
- ❌ `callDirectAi*` / `parseAiFormText` / `parseAiFlowText` — 自写 LLM 客户端和响应解析器 (~340 行)
- ❌ `GEN_MODEL_QUESTION` / `GEN_FLOW_QUESTION` — 自写 LLM prompt (与 NCPF backend 漂移) (~76 行, 整个 `_ai_prompts.ts` 删)
- ❌ `--ai-json` 块 (含 `autoDetectAndInjectRelationForm` / `injectRelationForm` / `constructTable` 启发式) (~290 行)
- ❌ `--ai` 路径 dead code (强制 `jnpfKey='input'` 丢组件类型) (~10 行)
**v0.13+ 保留的 webapi 镜像** (dacli/src/webapi/):
- `visualDev.ts` — 30 函数 (form/work 端点) ★
- `workflow.ts` — 14 函数 (work 端点 + 全套 CRUD) ★
- `dict.ts` — 15 函数 (字典) ★
- `_buildformdata.ts` — 镜像 web 端 buildFormData (form/flow 字段构造)
- `dataModel.ts` / `dataSource.ts` / `menu.ts` / `permission.ts` / `di.ts` / `printDev.ts` / `report.ts` / `portal.ts` / `bigscreen.ts` (待建)
**为什么这样**:之前复刻 buildFormData 漏 22+ 隐式契约, 反复修 schema 完整性. 直接 import web 端 = 0 维护, web 端升一次自动跟上.
@@ -96,8 +110,10 @@ bash /home/ubuntu/ccWorkDir/.claude/skills/dacli-ts/scripts/self-check.sh [form_
- `scripts/extract-all.mjs`(Phase 2 删,350 行 snapshot 提取脚本,无人调用)
**@deprecated 已删除文件**(v0.11+ cleanup 2026-06-26 删除):
- ~~`src/commands/form/_simplify.ts`~~(已删,走 --ai-json)
- ~~`src/commands/form/_simplify.ts`~~(已删,走 --ai-json → v0.13+ --ai-json 也删了)
- ~~`src/commands/form/_blindspots.ts`~~(已删, webapi 镜像自动保证 schema 完整性)
- ~~`src/commands/form/_ai_prompts.ts`~~(v0.13+ BS-新29 整个删, 自写 LLM prompt 必与 NCPF backend 漂移)
- ~~`src/commands/form/parseAiFormText/parseAiFlowText/callDirectAi*`~~(v0.13+ BS-新29 删, 自写 LLM 响应解析器)
- ~~`src/commands/form/validate.ts`~~(已删,webapi 镜像保证 schema 完整性)
- ~~`src/commands/form/fixcolumndata.ts`~~(已删,webapi 镜像保证 schema 完整性)
- ~~`src/commands/form/lint.ts`~~(已删,buildFormData 镜像自动保证)
@@ -169,11 +185,11 @@ const data = await loadVisualDev.getVisualDevList({ keyword: 'foo' }) // 调 we
> **核心**: webapi 镜像架构 (上节) 只解决了"调 web 端代码", 但单方法提交会**绕过 web 端校验链** (Generator.getData / ColumnDesign.getData / handleSubmit). step machine 把这些校验链在 dacli 端完整镜像, 让单次提交触发完整规则.
**dacli form create 完整流程** (webapi 镜像 + step machine):
**dacli form create 完整流程** (v0.13+ webapi 透传 + step machine):
```
输入 --ai-json '[{...}]'
输入 --ai "<描述>" (NCPF backend AI 返 VisualAiModel)
↓
[step 0] ai-json 解析 + field→fieldName 兼容映射 (镜像 web formUtils.ts:28-29 读 child.fieldName)
[step 0] 基础信息 (fullName 必填 + enCode 正则 + category 必填 + icon 必填 + showType ∈ {0,1,2})
↓
[webapi] initBuildFormData() + webBuildFormData(aiModelList)
↓ 调用 web 端 FormGenerator/src/helper/formUtils.ts 的 buildFormData
@@ -265,7 +281,7 @@ dacli dict typeCreate --fullName="TestDup2" --enCode="tdd10duptestv1" --parentId
| `dacli app context --json` | **新会话必跑**,环境快照(dbLinkId/enCode/表/menu 列表) |
| `dacli app switch --appCode=X` | 切应用 |
| `dacli form list` / `dacli form info <id>` | 列表单 / 查表单详情 |
| `dacli form create --ai-json='[...]'` | **v0.11+ 推荐**: 建表单 (走 web 端 buildFormData, schema 自动完整) |
| `dacli form create --ai "<描述>"` | **v0.13+ 推荐**: 建表单 (NCPF backend AI + web buildFormData + 自动发布, schema 自动完整) |
| ~~`dacli form validate <id>`~~ | **v0.11+ 已删**: 用 `dacli form info <id>` 替代 |
| `dacli form codegen <id> --company=ssw --module=tds` | 表单代码生成(v0.10+ 命名规则升级:`ssw-{appCode}`) |
| `dacli dm list` / `dacli dm create` | 数据模型 |
+3 -3
View File
@@ -41,7 +41,7 @@ dacli form create --fields='[{"field":"f_name","jnpfKey":"input"}]'
# ↑ v0.11+ 已删除 wrapSimplifiedFields 自动补全函数, 此 path 直接报错
```
**正确** (v0.11+ 推荐 --ai-json 路径):
**正确** (v0.13+ 推荐 --ai 路径):
```bash
# 走 web 端 buildFormData, schema 自动完整 (50+ formConf keys)
dacli form create --ai-json='[{
@@ -148,7 +148,7 @@ dacli form create --fields='[
]'
```
**正确** (v0.11+ 推荐 --ai-json):
**正确** (v0.13+ 推荐 --ai):
```bash
dacli form create --ai-json='[{
"tableTitle":"用户表","tableName":"user","isMain":true,
@@ -339,7 +339,7 @@ dacli form create --enCode=my_form --type=1 --webType=2 \
# ↑ 实际跑 → "Database exception, please contact the administrator for handling"
```
**正确** (★ 场景 A 默认: v0.11+ 推荐 --ai-json 路径, 一条命令完整):
**正确** (★ 场景 A 默认: v0.13+ 推荐 --ai 路径, 一条命令完整):
```bash
# 走 web 端 buildFormData, schema 自动完整
dacli form create --ai-json='[{
+5 -5
View File
@@ -4,7 +4,7 @@
>
> **当前状态**: v0.11+ (2026-06-26): **22 父命令 / 116 子命令**, 100% webapi 镜像, 7 step machine + 错误码 union. 详见 `.claude/skills/dacli-ts/SKILL.md` v0.11+ 段.
>
> **v0.11+ cleanup (2026-06-26)**: `form lint` / `form validate` / `form fixcolumndata` / `form clone` 4 个旧命令已删除, webapi 镜像自动保证 schema 完整性, 走 `--ai-json` 路径设计新 form / `dacli form info <id>` 拉 baseline schema 仿造.
> **v0.11+ cleanup (2026-06-26)**: `form lint` / `form validate` / `form fixcolumndata` / `form clone` 4 个旧命令已删除, webapi 镜像自动保证 schema 完整性, 走 `--ai` 路径设计新 form / `dacli form info <id>` 拉 baseline schema 仿造.
---
@@ -99,7 +99,7 @@ dacli form info 831606573984911813 --summary
**返回**: 完整 `formData/columnData/appColumnData/tables/flowTemplateJson` 等 (注意都是 JSON 字符串, 不是对象)。
### 1.3 `dacli form create` (⚠️ v0.11e+ step machine 严格镜像, prefer --ai-json)
### 1.3 `dacli form create` (⚠️ v0.11e+ step machine 严格镜像, prefer --ai)
| 参数 | 必填 | 说明 |
|------|------|------|
@@ -152,7 +152,7 @@ dacli form create --fullName="测试" --enCode=test.view --type=4 --webType=1
```bash
# 场景: enCode 含下划线 + 缺 category + type=5 非法 + 含 relationForm 缺 modelId + 树形缺字典
$ dacli form create --ai-json='[...]' --fullName="bad!@#" --enCode="my_form" --type=5 ...
$ dacli form create --ai='[...]' --fullName="bad!@#" --enCode="my_form" --type=5 ...
✗ ✗ step machine 校验未通过 (step0,step1,step2):
✗ step0 基础信息: ✗ 4 个错误
✗ - [fullName] [VS032-FORMAT] 名称不能含有特殊符号
@@ -173,7 +173,7 @@ $ dacli form create --ai-json='[...]' --fullName="bad!@#" --enCode="my_form" --t
**已知限制 (v0.1)**: JNPF 后端校验严, type=4 之外的 create 经常 `Database exception`。
- **AI 工作时**: 先 `dacli form list` 找相近 form → `dacli form info <id>` 拉完整 schema 仿造
- **v0.11+**: `dacli form create --ai` / `--ai-json` 走 `webapi/_buildformdata.ts` 直接 import web 端 `buildFormData`,schema 完整性 100% 由 web 端保证(无需 field-schemas.json)
- **v0.11+**: `dacli form create --ai` / `--ai` 走 `webapi/_buildformdata.ts` 直接 import web 端 `buildFormData`,schema 完整性 100% 由 web 端保证(无需 field-schemas.json)
- ✅ **v0.11+ 已闭环**: 写操作无需走 Java 版, webapi 镜像 + step machine + 错误码 union 全部覆盖. Java 版 `docs/dacli/ssw-dacli/` 仅作历史归档备查, **不要用**(违反 §2.6 完善优先 + drift 风险)
### 1.4 `dacli form release <id>`
@@ -506,7 +506,7 @@ dacli dm create \
### 3.6 ⭐ form→dm 字段类型映射表 (R5 规则, 实战验证)
**核心流程 (2026-06-26 v0.11d update)**:
- **★ 默认场景 A**: AI 快速建表单走 `form create --ai-json --autoRelease` 一条命令完整, dacli 自动 fallback schema, 不建物理表, 走 formDesign Web 设计器构建和验证
- **★ 默认场景 A**: AI 快速建表单走 `form create --ai --autoRelease` 一条命令完整, dacli 自动 fallback schema, 不建物理表, 走 formDesign Web 设计器构建和验证
- **场景 B (高级)**: 物理表已存在, 需要挂表单时走 `dm create` + `form create --tables=...` 两步
**字段类型必须严格按此表映射**,错误类型会在 form save 时报 500。
@@ -462,7 +462,7 @@ dacli form create --fullName=<...> --enCode=<...> \
## 15. 字段类型映射实战版 (jxcj 2026-06-30, 跨 appCode 通用)
> **v0.13+ 新增**: 这是 §1 抽象控件映射的"反向"实战版 — SQL 类型 → JNPF jnpfKey 映射, 用于 `dacli dm create` 建表时确定控件选型. 跨 appCode 通用, 任何项目 `dacli form create --ai-json` 时直接引用.
> **v0.13+ 新增**: 这是 §1 抽象控件映射的"反向"实战版 — SQL 类型 → JNPF jnpfKey 映射, 用于 `dacli dm create` 建表时确定控件选型. 跨 appCode 通用, 任何项目 `dacli form create --ai` 时直接引用.
>
> **§1 (jnpfKey → 控件)** 是 dacli 已知映射, **§15 (SQL → jnpfKey)** 是反向, 实战沉淀.
+11 -11
View File
@@ -2,7 +2,7 @@
> **目标**: AI 接到业务需求时, 按本文件找到对应模式直接套用
>
> **v0.11+ 推荐**: `--fields` 简化版已废弃, 新 form 请用 `--ai-json` 走 web 端 `buildFormData` (schema 自动完整, 0 手写 50+ formConf keys).
> **v0.13+ 推荐: 新 form 请用 `--ai "<描述>"` 走 NCPF backend AI + web 端 `buildFormData` (schema 自动完整, 0 手写 50+ formConf keys)` (schema 自动完整, 0 手写 50+ formConf keys).
---
@@ -14,7 +14,7 @@
**dacli 流程**:
```bash
# 1. 切到目标 app + 准备 --ai-json JSON (AI 生成)
# 1. 切到目标 app + 准备 prompt 描述 (AI 生成)
dacli app switch --appCode=tds
AI_JSON='[{"tableTitle":"我的资产","tableName":"myAsset","isMain":true,"fields":[
{"fieldName":"f_name","fieldTitle":"资产名","dataType":"varchar","dataLength":"100","required":true},
@@ -27,7 +27,7 @@ dacli dm create --table=my_asset --tableName="我的资产" --dbLinkId=<id> \
# 3. 一气呵成建 form (走 web 端 buildFormData, schema 自动完整)
dacli form create --fullName="我的资产" --enCode=myAsset --type=2 --webType=2 \
--dbLinkId=<id> --ai-json="$AI_JSON" --autoRelease
--dbLinkId=<id> --ai="$AI_JSON" --autoRelease
# 4. (可选) 改字段名/enCode: 用 dacli form info 查 schema, 用 form update 改
@@ -51,7 +51,7 @@ dacli menu create --fullName="资产菜单" --enCode=myAssetMenu \
**dacli 流程**:
```bash
# 1. 准备主子表 --ai-json (含主表 isMain: true + 子表 isMain: false)
# 1. 准备主子表 --ai (含主表 isMain: true + 子表 isMain: false)
AI_JSON='[{
"tableTitle":"订单主表","tableName":"order_main","isMain":true,
"fields":[{"fieldName":"f_order_no","fieldTitle":"订单号","dataType":"varchar","dataLength":"50"}]
@@ -62,7 +62,7 @@ AI_JSON='[{
# 2. 建主子表 (走 web 端 buildFormData, 主子表关系自动保证)
dacli form create --fullName="我的订单" --enCode=myOrder --type=2 --webType=2 \
--dbLinkId=<id> --ai-json="$AI_JSON" --autoRelease
--dbLinkId=<id> --ai="$AI_JSON" --autoRelease
# 3. (可选) 改主子表关系: 用 dacli form update 改
# 4. 挂菜单 (form 已自动 release)
@@ -88,8 +88,8 @@ dacli menu create --type=3 --moduleId=<clone-id> --urlAddress="model/myOrder" ..
**dacli 流程**:
```bash
# 1. 建表单 (v0.11+ 推荐 --ai-json 路径, web 端 buildFormData schema 自动完整)
dacli form create --ai-json='[{
# 1. 建表单 (v0.13+ 推荐: 新 form 请用 `--ai "<描述>"` 走 NCPF backend AI + web 端 `buildFormData` (schema 自动完整, 0 手写 50+ formConf keys) schema 自动完整)
dacli form create --ai='[{
"tableTitle":"请假申请","tableName":"leave","isMain":true,
"fields":[{"fieldName":"f_name","fieldTitle":"姓名","dataType":"varchar","dataLength":"100"},
{"fieldName":"f_days","fieldTitle":"天数","dataType":"int","dataLength":"11"}]
@@ -129,8 +129,8 @@ dacli dict type-list --keyword=资产分类
dacli dict data-create --dictionaryTypeId=xxx \
--fullName="电子设备" --enCode=electronic
# 3. 建表单 (v0.11+ 推荐 --ai-json 路径)
dacli form create --ai-json='[{
# 3. 建表单 (v0.11+ 推荐 --ai 路径)
dacli form create --ai='[{
"tableTitle":"资产分类","tableName":"asset_cat","isMain":true,
"fields":[{"fieldName":"f_category","fieldTitle":"分类","dataType":"varchar","dataLength":"200",
"jnpfKey":"select","dictionaryType":"assetCategory","required":true}]
@@ -154,8 +154,8 @@ dacli di create --fullName="用户查询" --enCode=userQuery \
--type=1 --category=<id> \
--sql-query='SELECT id, user_name FROM sys_user WHERE user_name LIKE CONCAT("%", :keyword, "%")'
# 2. 表单字段引用 (v0.11+ 推荐 --ai-json 路径)
dacli form create --ai-json='[{
# 2. 表单字段引用 (v0.11+ 推荐 --ai 路径)
dacli form create --ai='[{
"tableTitle":"用户查询","tableName":"user_query","isMain":true,
"fields":[{"fieldName":"f_user_id","fieldTitle":"用户","dataType":"varchar","dataLength":"200",
"jnpfKey":"popupSelect","interfaceId":"<data-interface-id>","required":true}]
+5 -84
View File
@@ -14,7 +14,7 @@
>
> **v0.11+ cleanup (2026-06-26)**:
> - `form lint` / `form validate` / `form fixcolumndata` 3 命令已删除, webapi 镜像 + buildFormData 自动保证 schema 完整性
> - `--fields` 简化版已废弃, 改用 `--ai-json` (走 web 端 buildFormData)
> - `--fields` 简化版已废弃, 改用 `--ai "<描述>"` (走 NCPF backend + web buildFormData, v0.13+ 删 --ai-json)
> - `design-jnpf-execute` 技能 + `03_forms.py` 脚本已删除
> - `f_description` / `f_version` 系统列冲突 v0.11+ 由 webapi 镜像自动处理, `dm create` 自动改名为 `f_app_desc` / `f_version_no` + warn
> - 22 盲点 guard 精简为 5 高频 (BS-5 AppContext / BS-8 token / BS-48 dbLinkId / BS-49 enCode / BS-50 主表)
@@ -607,7 +607,7 @@ dacli menu create --fullName="员工请假申请" --enCode=tds_leave_menu \
### 错误 22: ★ 场景 B 高级 — 物理表已存在, 不传 --tables 时 form 新建空表不引用已有表 (2026-06-26 v0.11d update)
> **场景 A 默认不适用此错误**: ★ AI 快速建表单走 `form create --ai-json --autoRelease` 一条命令完整, **不传 --tables 是正确用法**, dacli 自动 fallback schema, 走 formDesign Web 设计器构建. 下面解法仅适用场景 B (物理表已存在, 需要挂表单).
> **场景 A 默认不适用此错误**: ★ AI 快速建表单走 `form create --ai --autoRelease` 一条命令完整, **不传 --tables 是正确用法**, dacli 自动 fallback schema, 走 formDesign Web 设计器构建. 下面解法仅适用场景 B (物理表已存在, 需要挂表单).
**症状 (场景 B)**: 已先 `dm create` 建好物理表 `tds_leave`, 然后 `dacli form create --type=1 --webType=2 --enCode=tds_leave` 不传 `--tables`, form 创建成功但**新建了一个空表 `tds_leave_clone` 之类**, 没引用已建好的 `tds_leave`.
@@ -946,8 +946,8 @@ dacli form validate <id> # 期望: BS-23 消失
**v0.11+ 替代方案**:
```bash
# 1. 新 form 走 --ai-json path, webapi 镜像自动保证 schema 完整
dacli form create --ai-json='[...完整 schema...]' --dbLinkId=<id> --autoRelease
# 1. 新 form 走 --ai path (NCPF backend + web buildFormData), schema 自动完整
dacli form create --ai='[...完整 schema...]' --dbLinkId=<id> --autoRelease
# 2. 老 form 修复用 form export+import 拉完整 schema
dacli form export <workSystem_form_id> --out=/tmp/v2.json
@@ -1101,91 +1101,12 @@ dacli form create --fullName="中文名" --enCode=tds2_xxx \
**实战 tds2 8D 验证**: 8 form 走 dm→form 流程, 8/8 成功 (3 min/张). --tables 路径 0/8 成功.
**AI 防错** (2026-06-26 v0.11d update):
- ★ 默认场景 A: `dacli form create --ai-json --autoRelease` 一条命令完整, 不传 --tables, dacli 自动 fallback schema. dm create 不是 form 前置
- ★ 默认场景 A: `dacli form create --ai --autoRelease` 一条命令完整, 不传 --tables, dacli 自动 fallback schema. dm create 不是 form 前置
- 场景 B (高级, 物理表已存在): 走 `dm create` + `form create --tables=...` 两步
- 字段映射表抄上面, 错类型 form save 时 500
---
## 错误 50: `--ai-json` JSON 解析错误 (v0.11+ 推荐路径)
**症状**:
```bash
dacli form create --ai-json='[{"fieldName":"f_name"}]'
# ✗ SyntaxError: Unexpected token ... in JSON at position ...
# 或: ✗ "缺 tableTitle / tableName / isMain"
# 或: ✗ "dataType not in whitelist: xxx"
```
**根因**: `--ai-json` 期望结构化 `AiFormModel[]` JSON, 顶层必须是数组, 每项含 `tableTitle`/`tableName`/`isMain`/`fields[]`.
**真值** (从 `web/helper/formUtils.ts` buildFormData 提取):
```ts
interface AiFormModel {
tableTitle: string; // 表中文名
tableName: string; // 表英文名 (snake_case)
isMain: boolean; // 是否主表 (主子表场景)
fields: AiFormField[];
}
interface AiFormField {
field: string; // 字段名 (snake_case, f_ 前缀可选)
fieldTitle: string; // 字段中文名
dataType: 'varchar' | 'text' | 'int' | 'decimal' | 'datetime' | 'date' | ...;
dataLength: string; // varchar: "200", decimal: "18,4", text/datetime: "0"
jnpfKey?: string; // 控件类型 (input/select/relationForm/...)
required?: boolean;
defaultValue?: string;
dictionaryType?: string; // jnpfKey=select 时绑定字典 enCode
interfaceId?: string; // jnpfKey=relationForm/popupSelect 时绑数据接口 id
modelId?: string; // jnpfKey=relationForm 时绑目标表单 enCode (v0.11+ 新)
}
```
**修法** (5+ 常见错误模式):
| 症状 | 错误示例 | 修复 |
|------|---------|------|
| JSON 不是数组 | `dacli form create --ai-json='{"fieldName":"f_name"}'` | 改成 `[{"fieldName":"f_name", ...}]` 顶层数组 |
| 字段名拼错 | `--ai-json='[{"__vModel__":"f_name",...}]'` | 改成 `{"fieldName":"f_name",...}` (2026-06-26 v0.11d 修正: AI prompt 规范字段名是 fieldName, 不是 field) |
| 缺表三件套 | `[{"fields":[...]}]` | 加 `tableTitle` / `tableName` / `isMain:true` |
| dataType 不在白名单 | `"dataType":"string"` | 改 `"varchar"` (看 R5 字段映射表) |
| dataLength 缺 | `"dataType":"varchar"` | 补 `"dataLength":"200"` (varchar) / `"18,4"` (decimal) / `"0"` (text/datetime) |
| jnpfKey 拼错 | `"jnpfKey":"relationform"` | 改 `"relationForm"` (camelCase) |
| relationForm 缺 modelId | `"jnpfKey":"relationForm"` | 补 `"modelId":"<目标form enCode>"` (v0.11+ 新增必填) |
| select 缺 dictionaryType | `"jnpfKey":"select"` | 补 `"dictionaryType":"<字典 enCode>"` 或 `interfaceId` |
**正确示例** (单表 + 主键):
```bash
dacli form create --ai-json='[{
"tableTitle":"资产分类",
"tableName":"asset_cat",
"isMain":true,
"fields":[
{"fieldName":"f_name","fieldTitle":"名称","dataType":"varchar","dataLength":"100","required":true,"jnpfKey":"input"},
{"fieldName":"f_amount","fieldTitle":"金额","dataType":"decimal","dataLength":"18,4","jnpfKey":"inputNumber"},
{"fieldName":"f_category","fieldTitle":"分类","dataType":"varchar","dataLength":"200","jnpfKey":"select","dictionaryType":"assetCategory"}
]
}]' --dbLinkId=<id> --autoRelease
```
**主子表示例** (isMain + relationField 关联):
```bash
dacli form create --ai-json='[
{"tableTitle":"订单主表","tableName":"order_main","isMain":true,
"fields":[{"fieldName":"f_order_no","fieldTitle":"订单号","dataType":"varchar","dataLength":"50","required":true}]},
{"tableTitle":"订单明细","tableName":"order_detail","isMain":false,
"tableField":"f_main_id","relationTable":"order_main","relationField":"f_id",
"fields":[{"fieldName":"f_product","fieldTitle":"产品名","dataType":"varchar","dataLength":"100","required":true}]}
]' --dbLinkId=<id> --autoRelease
```
**AI 防错**:
- 新 form 一律走 `--ai-json` 路径, 不要用 `--fields` 简化版 (已废弃)
- 复杂场景先用 `dacli form info <workSystem_form_id>` 拉 baseline 看完整 schema, 再改字段
- 看到错误先查 `web/apps/jnpf-web-apps-main/src/helper/formUtils.ts` `buildFormData()` 入口, 真实必填字段以源码为准
---
## v0.8.2+ dacli 改进建议 (基于 tdca/tdsa 实战 + 2026-06-21 tds2 8D 实战)
> **v0.11+ cleanup**: 大部分建议已由 webapi 镜像自动闭环 (盲点 30/31/32/35/36/38/39), 不再需要单独修复命令.
+5 -2
View File
@@ -6,6 +6,7 @@
>
> 创建:2026-06-22(v0.10 P0.3 — 解决 AI 舍近求远根因 G)
>
> **v0.13+ cleanup (2026-07-01)**: `--ai-json` 已删 (BS-新28, 跟 `--ai` 后半段完全一样, 保留会漂移). 改用 `--ai "<描述>"` 一条命令端到端.
> **v0.11+ cleanup (2026-06-26)**: 已删除 `form lint` / `form validate` / `form fixcolumndata` 3 个命令相关行; `--fields` 简化版已替换为 `--ai-json` (走 web 端 `buildFormData`).
## 快速索引
@@ -25,8 +26,10 @@
| `form export` | `api/onlineDev/visualDev.ts:L133-L135` | POST `/api/visualdev/OnlineDev/{modelId}/Actions/ExportData` | 导出数据 |
| `form template` | `api/onlineDev/visualDev.ts:L141-L143` | POST `/api/visualdev/OnlineDev/{modelId}/Actions/Export` | 导出模板 |
| `form import` | `api/onlineDev/visualDev.ts:L105-L106` | POST `/api/visualdev/OnlineDev/{modelId}` | 新建数据(导入流程) |
| `form create --ai-json` (v0.11+) | `helper/formUtils.ts:buildFormData` + `webapi/_buildformdata.ts` | — | web 端 buildFormData 自动保证 50+ formConf keys |
| `form create --fields` (❌ v0.11+ 已删除) | ~~(已废弃)~~ | — | 走 `--ai-json` 路径, wrapSimplifiedFields 已移除 |
| `form create --ai` (v0.13+ 默认) | `helper/formUtils.ts:buildFormData` + `webapi/_buildformdata.ts` + `/api/visualdev/ai/form` | NCPF backend AI + web buildFormData + 自动 release | 一条命令端到端, 走 web 完整路径 |
| `form create --ai-field` (人类操作) | `/api/visualdev/ai/form` (NCPF backend) | NCPF backend AI | 只输出字段建议, 不建表单 |
| ~~`form create --ai-json` (v0.13+ 已删)~~ | ~~(已删, 跟 `--ai` 后半段重复)~~ | — | 删 BS-新28: 保留会让代码漂移, 走 `--ai` web buildFormData 即可 |
| `form create --fields` (❌ v0.11+ 已删除) | ~~(已废弃)~~ | — | 走 `--ai` 路径, wrapSimplifiedFields 已移除 |
| `form validate` (❌ v0.11+ 已删除) | ~~(已废弃)~~ | — | webapi 镜像自动保证 schema 完整性, 无需 validate |
| `form fixcolumndata` (❌ v0.11+ 已删除) | ~~(已废弃)~~ | — | webapi 镜像自动保证 4 个 use*Permission 字段 |
| `dm create` | `api/systemData/dataModel.ts:L22-L24` | POST `/api/system/DataModel/{linkId}/Table` | tables 完整 schema |
@@ -192,7 +192,7 @@ dacli dict typeCreate --enCode=jxcj1statetype --fullName="状态类型" \
dacli dm create --table=jxcj1_tc_test --tableName="TC测试表" --dbLinkId=<app context 拿> \
--fields='[{"field":"f_test_name","fieldName":"测试名称","dataType":"varchar","dataLength":"100","allowNull":0},{"field":"f_state","fieldName":"状态","dataType":"int","dataLength":"10","allowNull":0}]'
dacli form create --ai-json='[{"tableTitle":"TC测试表","tableName":"tc_test","isMain":true,"fields":[{"field":"f_test_name","fieldTitle":"测试名称","dataType":"varchar","dataLength":"100","required":true},{"field":"f_state","fieldTitle":"状态","dataType":"int","fieldComponent":"select","dictType":"jxcj1statetype","required":true}]}]' \
dacli form create --ai='[{"tableTitle":"TC测试表","tableName":"tc_test","isMain":true,"fields":[{"field":"f_test_name","fieldTitle":"测试名称","dataType":"varchar","dataLength":"100","required":true},{"field":"f_state","fieldTitle":"状态","dataType":"int","fieldComponent":"select","dictType":"jxcj1statetype","required":true}]}]' \
--webType=2 --category=8f65bbe3bce341c8b3625d93544a044a --dbLinkId=<app context 拿> \
--fullName="TC测试表" --enCode=tcTest --autoRelease
+1 -1
View File
@@ -60,7 +60,7 @@ Agent(subagent_type=general-purpose, prompt="完整 prompt 在 /tmp/subagent-pro
**5 步任务**:
1. `dacli dm create --table={enCode} --dbLinkId=$(dacli app context | jq -r .dbLinkId) --fields='[...]'`
2. `dacli form create --ai-json='[...fields]' --webType=1 --dbLinkId=$(同上) --autoRelease`
2. `dacli form create --ai='[...fields]' --webType=1 --dbLinkId=$(同上) --autoRelease`
3. `dacli menu create --formId=$(dacli form info {enCode} | jq -r .id) --fullName={中文名} --enCode={enCode} --parentId=$(dacli menu list | jq '...')`
4. `dacli form info {enCode}` 验证 state=1
5. 写 1 段到 learnings.md (强制)
@@ -70,7 +70,7 @@
```bash
# 阶段 4 一键 form → dm → menu → 后端代码 → 修复
dacli form create --ai-json=... --autoRelease
dacli form create --ai=... --autoRelease
dacli form codegen <formId> --module={app} --mainClassName={Pascal}
dacli form fix-entity --type=all # P0 自动修复 (entity @TableId + Service NPE)
dacli menu create --formId=<id> --pcParents=<parentId>
+2 -2
View File
@@ -131,9 +131,9 @@ dacli dm create --table={enCode} --tableName={中文名} --dbLinkId=$(dacli app
...
]'
# form create (web 表单, 用 --ai-json)
# form create (web 表单, 用 --ai)
dacli form create \
--ai-json='[{
--ai='[{
"tableTitle": "{中文名}",
"tableName": "{enCode}",
"isMain": true,
@@ -64,7 +64,7 @@ dacli dm create --table={enCode} \
```bash
dacli form create \
--ai-json='[{
--ai='[{
"tableTitle": "{中文名}",
"tableName": "{enCode}",
"isMain": true,