diff --git a/CLAUDE.md b/CLAUDE.md index 9ee5afe..2de4bdc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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` (反模式总览, 含派子代理段) diff --git a/commands/ssw-onlinedev.md b/commands/ssw-onlinedev.md index fdaad18..70c409c 100644 --- a/commands/ssw-onlinedev.md +++ b/commands/ssw-onlinedev.md @@ -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= --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= --ai-json='[{ + --dbLinkId= --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= --ai-json='[{ + --dbLinkId= --ai='[{ "tableTitle":"学生信息","tableName":"as_student_info","isMain":true, "fields":[{"field":"f_name","fieldTitle":"姓名","dataType":"varchar","dataLength":"100"}] }]' --autoRelease diff --git a/skills/dacli-ts/SKILL.md b/skills/dacli-ts/SKILL.md index ea9499d..6f435d4 100644 --- a/skills/dacli-ts/SKILL.md +++ b/skills/dacli-ts/SKILL.md @@ -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 → 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 ''` | **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 ` | 列表单 / 查表单详情 | -| `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 `~~ | **v0.11+ 已删**: 用 `dacli form info ` 替代 | | `dacli form codegen --company=ssw --module=tds` | 表单代码生成(v0.10+ 命名规则升级:`ssw-{appCode}`) | | `dacli dm list` / `dacli dm create` | 数据模型 | diff --git a/skills/dacli-ts/references/anti-patterns.md b/skills/dacli-ts/references/anti-patterns.md index 3220345..2dddb44 100644 --- a/skills/dacli-ts/references/anti-patterns.md +++ b/skills/dacli-ts/references/anti-patterns.md @@ -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='[{ diff --git a/skills/dacli-ts/references/commands.md b/skills/dacli-ts/references/commands.md index 194d8a4..db5c907 100644 --- a/skills/dacli-ts/references/commands.md +++ b/skills/dacli-ts/references/commands.md @@ -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 ` 拉 baseline schema 仿造. +> **v0.11+ cleanup (2026-06-26)**: `form lint` / `form validate` / `form fixcolumndata` / `form clone` 4 个旧命令已删除, webapi 镜像自动保证 schema 完整性, 走 `--ai` 路径设计新 form / `dacli form info ` 拉 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 ` 拉完整 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 ` @@ -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。 diff --git a/skills/dacli-ts/references/jnpf-design-rules.md b/skills/dacli-ts/references/jnpf-design-rules.md index 8d68c3d..c8b2cd0 100644 --- a/skills/dacli-ts/references/jnpf-design-rules.md +++ b/skills/dacli-ts/references/jnpf-design-rules.md @@ -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)** 是反向, 实战沉淀. diff --git a/skills/dacli-ts/references/patterns.md b/skills/dacli-ts/references/patterns.md index 8987bf4..0422b85 100644 --- a/skills/dacli-ts/references/patterns.md +++ b/skills/dacli-ts/references/patterns.md @@ -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= \ # 3. 一气呵成建 form (走 web 端 buildFormData, schema 自动完整) dacli form create --fullName="我的资产" --enCode=myAsset --type=2 --webType=2 \ - --dbLinkId= --ai-json="$AI_JSON" --autoRelease + --dbLinkId= --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= --ai-json="$AI_JSON" --autoRelease + --dbLinkId= --ai="$AI_JSON" --autoRelease # 3. (可选) 改主子表关系: 用 dacli form update 改 # 4. 挂菜单 (form 已自动 release) @@ -88,8 +88,8 @@ dacli menu create --type=3 --moduleId= --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= \ --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":"","required":true}] diff --git a/skills/dacli-ts/references/troubleshooting.md b/skills/dacli-ts/references/troubleshooting.md index e5c7e61..1aaeb83 100644 --- a/skills/dacli-ts/references/troubleshooting.md +++ b/skills/dacli-ts/references/troubleshooting.md @@ -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 # 期望: BS-23 消失 **v0.11+ 替代方案**: ```bash -# 1. 新 form 走 --ai-json path, webapi 镜像自动保证 schema 完整 -dacli form create --ai-json='[...完整 schema...]' --dbLinkId= --autoRelease +# 1. 新 form 走 --ai path (NCPF backend + web buildFormData), schema 自动完整 +dacli form create --ai='[...完整 schema...]' --dbLinkId= --autoRelease # 2. 老 form 修复用 form export+import 拉完整 schema dacli form export --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= --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= --autoRelease -``` - -**AI 防错**: -- 新 form 一律走 `--ai-json` 路径, 不要用 `--fields` 简化版 (已废弃) -- 复杂场景先用 `dacli form info ` 拉 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), 不再需要单独修复命令. diff --git a/skills/dacli-ts/references/web-source-map.md b/skills/dacli-ts/references/web-source-map.md index f5f91d4..c504a84 100644 --- a/skills/dacli-ts/references/web-source-map.md +++ b/skills/dacli-ts/references/web-source-map.md @@ -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 | diff --git a/skills/ssw-loop/references/lessons-from-apps.md b/skills/ssw-loop/references/lessons-from-apps.md index 369cb4a..7d282a5 100644 --- a/skills/ssw-loop/references/lessons-from-apps.md +++ b/skills/ssw-loop/references/lessons-from-apps.md @@ -192,7 +192,7 @@ dacli dict typeCreate --enCode=jxcj1statetype --fullName="状态类型" \ dacli dm create --table=jxcj1_tc_test --tableName="TC测试表" --dbLinkId= \ --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= \ --fullName="TC测试表" --enCode=tcTest --autoRelease diff --git a/skills/ssw-loop/references/stage-prompts.md b/skills/ssw-loop/references/stage-prompts.md index 832c1ef..f434b31 100644 --- a/skills/ssw-loop/references/stage-prompts.md +++ b/skills/ssw-loop/references/stage-prompts.md @@ -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 (强制) diff --git a/skills/ssw-loop/templates/docs/research.md.tmpl b/skills/ssw-loop/templates/docs/research.md.tmpl index 2cdd4a5..7a61337 100644 --- a/skills/ssw-loop/templates/docs/research.md.tmpl +++ b/skills/ssw-loop/templates/docs/research.md.tmpl @@ -70,7 +70,7 @@ ```bash # 阶段 4 一键 form → dm → menu → 后端代码 → 修复 -dacli form create --ai-json=... --autoRelease +dacli form create --ai=... --autoRelease dacli form codegen --module={app} --mainClassName={Pascal} dacli form fix-entity --type=all # P0 自动修复 (entity @TableId + Service NPE) dacli menu create --formId= --pcParents= diff --git a/skills/ssw-loop/templates/learnings.md.tmpl b/skills/ssw-loop/templates/learnings.md.tmpl index 8b31924..66fdca5 100644 --- a/skills/ssw-loop/templates/learnings.md.tmpl +++ b/skills/ssw-loop/templates/learnings.md.tmpl @@ -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, diff --git a/skills/ssw-loop/templates/subagent/form-create.md.tmpl b/skills/ssw-loop/templates/subagent/form-create.md.tmpl index 763dc03..1eb0690 100644 --- a/skills/ssw-loop/templates/subagent/form-create.md.tmpl +++ b/skills/ssw-loop/templates/subagent/form-create.md.tmpl @@ -64,7 +64,7 @@ dacli dm create --table={enCode} \ ```bash dacli form create \ - --ai-json='[{ + --ai='[{ "tableTitle": "{中文名}", "tableName": "{enCode}", "isMain": true,