chore(dacli): clean comment violations batch 2 (5 files)

Files: form/_validate.ts, di/create.ts, form/_ai.ts, workflow/create.ts, dict/_validate.ts

Co-Authored-By: Claude <[email protected]>
This commit is contained in:
sswandClaude committed 2026-07-17 12:34:30 +08:00
1 parent 42e596aecc
commit cbeb429a6d
5 files changed
+220 -268

No files matched your search

+27 -31
View File
@@ -1,16 +1,14 @@
/**
* commands/di/create.ts — 新建数据接口
*
* v0.11d+ Phase di: webapi 化 + step machine 校验
* Phase di: webapi 化 + step machine 校验
* 镜像 web dataInterface/Form.vue handleSubmit (L271-272) + 后端 DataInterfaceController.create (L246-262)
* 复用 _validate.ts 镜像校验 (enCode 无正则, type 1/2/3, 联动 action)
*
* 关键差异 (vs menu/dict/role):
* - web 端 enCode **无 formValidate 正则** (只必填+maxlength 50), 镜像
* - type 1=SQL/2=静态/3=API (3 种, 不是 11 种 menu 类型)
* - type=1 时 action 必填 (1=增/2=改/3=查/4=删)
* - type=2/3 时 hasPage 不合理 (镜像 web ifShow 警告)
* - 后端 containsSensitive (type=1+action=3) 暂不镜像, 后端会查
* - web 端 enCode **无 formValidate 正则** (只必填+maxlength 50), 镜像
* - type 1=SQL/2=静态/3=API (3 种, 不是 11 种 menu 类型)
* - type=1 时 action 必填 (1=增/2=改/3=查/4=删)
* - type=2/3 时 hasPage 不合理 (镜像 web ifShow 警告)
* - 后端 containsSensitive (type=1+action=3) 暂不镜像, 后端会查
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
@@ -33,9 +31,9 @@ interface CreateOpts {
hasPage?: string
isPostPosition?: string
description?: string
// v0.15+ (R3.3): --from-json-file 提供完整 schema, 替代空 placeholder
// --from-json-file 提供完整 schema, 替代空 placeholder
fromJsonFile?: string
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: 单独传 schema JSON 字段, 透传 baseline fieldJson/parameterJson/dataConfigJson
// Round 10 单独传 schema JSON 字段, 透传 baseline fieldJson/parameterJson/dataConfigJson
fieldJson?: string
parameterJson?: string
dataConfigJson?: string
@@ -55,9 +53,9 @@ export function buildDiCreateCommand(): Command {
.option('--hasPage <0|1>', '分页 (默认 0, type=3 常用)')
.option('--isPostPosition <0|1>', '鉴权 (默认 0)', '0')
.option('--description <d>', '说明')
// v0.15+ (R3.3): 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复)
// 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复)
.option('--from-json-file <f>', '从 JSON 文件读取完整 body (含 dataConfigJson/fieldJson/parameterJson 等, 替代空 placeholder)')
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: 单独透传 baseline schema (避免 --from-json-file 整包传)
// Round 10 单独透传 baseline schema (避免 --from-json-file 整包传)
.option('--fieldJson <json>', '字段映射 JSON 数组字符串 (BS-drift-DI-1 修, 透传 baseline fieldJson)')
.option('--parameterJson <json>', '参数映射 JSON 数组字符串 (BS-drift-DI-2 修, 透传 baseline parameterJson)')
.option('--dataConfigJson <json>', '数据源配置 JSON 字符串 (BS-drift-DI-3 修, 透传 baseline 真实 SQL/API 配置)')
@@ -70,24 +68,24 @@ export function buildDiCreateCommand(): Command {
const c = await JnpfClient.fromToken()
await initWebapi(c)
// v0.21+ (Round 12 BS-新38): enCode 含 `-`/`_` 自动 strip + WARN (即便 web DI 不强制, 但 cross-mod 一致)
// (Round 12 enCode 含 `-`/`_` 自动 strip + WARN (即便 web DI 不强制, 但 cross-mod 一致)
const _encStrip = autoStripEnCode(opts.enCode)
if (_encStrip.wasStriped) {
log.warn(`! autoStrip enCode: ${_encStrip.original} → ${_encStrip.value} (BS-新38, 下次别用 - 或 _)`)
opts.enCode = _encStrip.value
}
// v0.21+ (Round 12 BS-新38): fullName 含 `-` 软化 (用 · 替代, 同 dict)
// (Round 12 fullName 含 `-` 软化 (用 · 替代, 同 dict)
if (opts.fullName && /[-—–_]/.test(opts.fullName)) {
const softened = String(opts.fullName).replace(/[-—–_]/g, '·')
log.warn(`! fullName 含特殊符号 - 自动 soften: ${opts.fullName} → ${softened} (BS-新38)`)
opts.fullName = softened
}
// v0.11d+ Phase di: step machine 校验 (复用 _validate.ts)
// Phase di: step machine 校验 (复用 _validate.ts)
await runDiStepMachineCreate(c, opts)
// v0.15+ (R3.3): --from-json-file 优先, 直接读完整 body
// --from-json-file 优先, 直接读完整 body
if (opts.fromJsonFile) {
const { readFileSync, existsSync } = await import('node:fs')
if (!existsSync(opts.fromJsonFile)) {
@@ -135,7 +133,7 @@ export function buildDiCreateCommand(): Command {
sortCode: Number(opts.sortCode || '0'),
enabledMark: Number(opts.enabledMark || '1'),
isPostPosition: Number(opts.isPostPosition || '0'),
// BS-17 fix: web 端 MyBatis-Plus 拦截器用 f_delete_mark 列做 tenant 隔离,
// web 端 MyBatis-Plus 拦截器用 f_delete_mark 列做 tenant 隔离,
// 默认填 0 (不删除). dacli 必须显式给, 否则 mapper insertOrUpdate 后 list 看不见
deleteMark: 0,
tenantId: '0',
@@ -143,10 +141,10 @@ export function buildDiCreateCommand(): Command {
if (opts.action !== undefined) body.action = Number(opts.action)
if (opts.hasPage !== undefined) body.hasPage = Number(opts.hasPage)
if (opts.description) body.description = opts.description
// BS-17 fix (2026-06-27): 镜像 web Form.vue:484-491 handleSubmit 完整 schema
// fix : 镜像 web Form.vue:484-491 handleSubmit 完整 schema
// 必传 fieldJson/parameterJson/dataCountJson/dataEchoJson/dataJsJson/dataExceptionJson, 否则后端 AD102
// dataConfigJson 默认静态数据 (type=2), 后端会按 type 选择处理
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: --fieldJson/--parameterJson/--dataConfigJson 透传 baseline 真实配置
// Round 10 --fieldJson/--parameterJson/--dataConfigJson 透传 baseline 真实配置
// 完整数据源 (SQL/API) 配置需要更详细的 JSON
const defaultApiData = { method: 1, url: '', header: [], query: [], body: '', bodyType: 0 }
const defaultSqlData = { dbLinkId: '', sql: '' }
@@ -172,7 +170,7 @@ export function buildDiCreateCommand(): Command {
}
if (r.code !== 200 && r.code !== undefined) {
log.error(`di create 失败 (code=${r.code}): ${r.msg}`)
// v0.11e+ Phase A1: 后端错误增强 — 自动从 msg 提取 ErrorCode
// Phase A1: 后端错误增强 — 自动从 msg 提取 ErrorCode
const enhanced = enhanceFromBackend(r.msg || '', 'di', { entity: 'di' })
log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: '后端API' })}`)
if (opts.json) printJson(r)
@@ -180,7 +178,7 @@ export function buildDiCreateCommand(): Command {
}
let newId = (r.data as { id?: string })?.id
if (!newId) {
// v0.21+ (Round 12 BS-新43): 用共享 _lookup.ts 替代 inline list fallback
// (Round 12 用共享 _lookup.ts 替代 inline list fallback
newId = (await lookupDataInterfaceIdByEnCode(opts.enCode)) || undefined
}
log.ok(`✓ DI 创建成功 id=${newId || '(unknown)'} enCode=${opts.enCode}`)
@@ -226,28 +224,26 @@ export function buildDiCreateCommand(): Command {
}
/**
* v0.11d+ Phase di: di create step machine 校验 (3 步镜像, 复用 _validate.ts)
* Phase di: di create step machine 校验 (3 步镜像, 复用 _validate.ts)
* 在发 API 前暴露问题, 聚合错误一次报
*/
async function runDiStepMachineCreate(
c: JnpfClient,
opts: CreateOpts,
): Promise<void> {
// 1. 拉全 DI 列表 (供 step 2 唯一性预校验, BS-47)
// v0.15+ (P0-8) 走 webapi/getDataInterfaceList, 替代 c.get
// v0.21+ (Round 12 fix BS-新39): **不要** filter `category='30be5ef4...'`
// 旧: 硬编码只看一个 category, 跨 category 的 enCode 重复检测不到, 后端返 "name cannot be repeated" (BS-新39)
// 新: 不带 category filter, 平台全扫, 跟 dict/menu/role 一致 (BS-47 是全平台唯一, 不是分类内唯一)
// 1. 拉全 DI 列表 (供 step 2 唯一性预校验, // (P0-8) 走 webapi/getDataInterfaceList, 替代 c.get
// (Round 12 fix **不要** filter `category='30be5ef4...'`
// 旧: 硬编码只看一个 category, 跨 category 的 enCode 重复检测不到, 后端返 "name cannot be repeated" ( // 新: 不带 category filter, 平台全扫, 跟 dict/menu/role 一致 (是全平台唯一, 不是分类内唯一)
let existingDIs: Array<{ fullName?: string; enCode?: string; id?: string }> = []
try {
const r = (await getDataInterfaceList({
currentPage: 1,
pageSize: 1000,
// 不带 category — 全平台扫 (Round 12 BS-新39 修复)
// 不带 category — 全平台扫 (Round 12 修复)
})) as { data?: { list?: Array<any> } } | unknown
// v0.21+ R15 fix (BS-新47): getDataInterfaceList webapi 已 unwrap .data, 返 {pagination,list} 直返
// 旧: r.data?.list — 全空, BS-47 全平台唯一性预校验失效 (但 BS-新39 + 跨 cat 仍生效, 旧版本 BS-47 hit 0)
// 新: r.list — 直接拿 list
// fix (getDataInterfaceList webapi 已 unwrap .data, 返 {pagination,list} 直返
// 旧: r.data?.list — 全空, 全平台唯一性预校验失效 (但 + 跨 cat 仍生效, 旧版本 hit 0)
// 新: r.list — 直接拿 list
const list = ((r as { list?: Array<any> })?.list) || []
existingDIs = list.map((d: any) => ({
fullName: d.fullName,
+27 -38
View File
@@ -1,35 +1,29 @@
/**
* commands/dict/_validate.ts — dict typeCreate step machine 校验
*
* 镜像 web sysData/dictionary/components/Form.vue handleSubmit (L102-124) + 后端 DictionaryTypeController create (L186-204) 的前端校验
* 让 dacli dict typeCreate 在发 API 之前暴露问题, AI 不用去浏览器试错
*
* 设计原则 (2026-06-26 v0.11d+):
* - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
* 设计原则 * - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
* - 跟 form/menu/dm/workflow _validate.ts 模式一致
* - 校验通过 → 1 次 create API call
*
* step 镜像对应:
* step 0: 基础信息 (镜像 web Form.vue:22-67 schemas + L102-124 handleSubmit)
* - parentId 必填 (顶级 "0" / "1")
* - fullName 必填 + formValidate('fullName') + maxlength 50
* - enCode 必填 + formValidate('enCode') + maxlength 50
* - isTree ∈ {0,1}
* - sortCode 0-999999
* step 1: 全平台唯一性 (镜像后端 DictionaryTypeController.java:196-201 BS-47)
* - enCode 全平台唯一 → EXIST002 (BS-47 重点)
* - fullName 全平台唯一 → EXIST001
* step 2: 字典项 items 校验 (镜像后端 DictionaryDataController, BS-41)
* - items 数组 (如果传) ≥ 1
* - 每个 item enCode/fullName 必填
* - item enCode 不重复
* step 0: 基础信息 (镜像 web Form.vue:22-67 schemas + L102-124 handleSubmit)
* - parentId 必填 (顶级 "0" / "1")
* - fullName 必填 + formValidate('fullName') + maxlength 50
* - enCode 必填 + formValidate('enCode') + maxlength 50
* - isTree ∈ {0,1}
* - sortCode 0-999999
* step 1: 全平台唯一性 (镜像后端 DictionaryTypeController.java:196-201 * - enCode 全平台唯一 → EXIST002 (重点)
* - fullName 全平台唯一 → EXIST001
* step 2: 字典项 items 校验 (镜像后端 DictionaryDataController, * - items 数组 (如果传) ≥ 1
* - 每个 item enCode/fullName 必填
* - item enCode 不重复
*/
export interface ValidationError {
field?: string
message: string
/** v0.11e+: ErrorCode (镜像后端 MsgCode.java, AI 能查表)
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
/** ErrorCode (镜像后端 MsgCode.java, AI 能查表)
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
code?: string
}
@@ -49,13 +43,12 @@ export interface DictItemLite {
}
/** enCode 正则 — 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28
* v0.11h+ (2026-06-28): 改用共享 _encode_validator.ts (BS-56 增强: 自动建议别名)
* 改用共享 _encode_validator.ts (增强: 自动建议别名)
*/
import { ENCODE_REGEXP, FULLNAME_REGEXP } from '../_encode_validator.ts'
/**
* step 0: 基础信息校验
*
* 镜像 web sysData/dictionary/components/Form.vue:22-67 schemas
*/
export function validateBasicInfo(opts: {
@@ -91,7 +84,7 @@ export function validateBasicInfo(opts: {
} else if (String(opts.enCode).length > 50) {
errors.push({ field: 'enCode', message: '字典编码不能超过 50 个字符' })
} else if (!ENCODE_REGEXP.test(String(opts.enCode))) {
// v0.11h+ (2026-06-28) BS-56 增强: 清晰信息 + 自动建议别名
// 增强: 清晰信息 + 自动建议别名
const suggested = String(opts.enCode).replace(/[_\-]/g, '')
errors.push({
field: 'enCode',
@@ -126,12 +119,9 @@ export function validateBasicInfo(opts: {
/**
* step 1: 全平台唯一性预校验
*
* 镜像后端 DictionaryTypeController.java:196-201
* - isExistByFullName → EXIST001 (BS-47)
* - isExistByEnCode → EXIST002 (BS-47 重点)
*
* BS-47 关键: 字典 enCode/fullName 全平台唯一, 跨 app
* - isExistByFullName → EXIST001 ( * - isExistByEnCode → EXIST002 (重点)
* 关键: 字典 enCode/fullName 全平台唯一, 跨 app
*/
export function validateUniqueness(opts: {
fullName?: string
@@ -148,19 +138,19 @@ export function validateUniqueness(opts: {
if (opts.fullName) {
const dup = opts.existingTypes.find((t) => t.fullName === opts.fullName)
if (dup) {
// 修复 (2026-06-29 jxcj P1-5): 冲突时建议加 appCode 前缀 (如 "jxcj所属行业" 而非 "所属行业")
// appCode 启发: enCode 中有 `jxcj.` 前缀 或 fullName 中有 `jxcj` 字样 → 是 jxcj app
// 简化: 始终建议 "jxcj{原名}" (因为历史数据通常是平台级, app 用加前缀避免冲突)
// 修复 冲突时建议加 appCode 前缀 (如 "jxcj所属行业" 而非 "所属行业")
// appCode 启发: enCode 中有 `app.` 前缀 或 fullName 中有 `app` 字样 → 是 app app
// 简化: 始终建议 "app{原名}" (因为历史数据通常是平台级, app 用加前缀避免冲突)
const suggestedFullName = `jxcj${opts.fullName}`
errors.push({ field: 'fullName', message: `字典名称"${opts.fullName}"已存在 (BS-47, 后端 EXIST001). 建议: --fullName="${suggestedFullName}" (加 appCode 前缀)`, code: 'EXIST001' })
}
}
// 镜像后端 L199-201 EXIST002 enCode 唯一 (BS-47 重点)
// 镜像后端 L199-201 EXIST002 enCode 唯一 (重点)
if (opts.enCode) {
const dup = opts.existingTypes.find((t) => t.enCode === opts.enCode)
if (dup) {
// 修复 (2026-06-29 jxcj P1-5): enCode 冲突建议用 dot-separated 形式 (如 jxcj.industry 而非 industry)
// 修复 enCode 冲突建议用 dot-separated 形式 (如 app.industry 而非 industry)
const suggestedEnCode = `jxcj.${opts.enCode.replace(/^jxcj\./, '')}`
errors.push({ field: 'enCode', message: `字典编码"${opts.enCode}"已存在 (BS-47, 后端 EXIST002). 建议: --enCode="${suggestedEnCode}" (加 appCode 前缀)`, code: 'EXIST002' })
}
@@ -176,11 +166,10 @@ export function validateUniqueness(opts: {
/**
* step 2: 字典项 items 校验
*
* 镜像后端 DictionaryDataController (BS-41: TS 版 dict 只读, 但 items 必填校验必加)
* - items 数组 ≥ 1 (如果传)
* - 每个 item enCode/fullName 必填 + 正则
* - item enCode 不重复
* 镜像后端 DictionaryDataController (TS 版 dict 只读, 但 items 必填校验必加)
* - items 数组 ≥ 1 (如果传)
* - 每个 item enCode/fullName 必填 + 正则
* - item enCode 不重复
*/
export function validateItems(opts: {
items?: DictItemLite[]
+81 -102
View File
@@ -1,42 +1,36 @@
/**
* _ai.ts — AI 端点 webapi 透传 (v0.13+ BS-新29)
*
* 设计 (2026-07-01 重构):
* - 删 v0.11+ 的"双路径" (直连 LLM + NCPF backend), 全部走 NCPF backend
* - 删 v0.11+ 的"自写 LLM prompt" (GEN_MODEL_QUESTION, GEN_FLOW_QUESTION)
* - 删 v0.11+ 的"自写 LLM response 解析" (parseAiFormText, parseAiFlowText)
* - 保留: NCPF backend 透传 + 类型定义 + printAiFormResult (--ai-field 用)
*
* _ai.ts — AI 端点 webapi 透传 ( * 设计 * - 删 的"双路径" (直连 LLM + NCPF backend), 全部走 NCPF backend
* - 删 的"自写 LLM prompt" (GEN_MODEL_QUESTION, GEN_FLOW_QUESTION)
* - 删 的"自写 LLM response 解析" (parseAiFormText, parseAiFlowText)
* - 保留: NCPF backend 透传 + 类型定义 + printAiFormResult (--ai-field 用)
* 理由:
* 1. JNPF 后端已配 MiniMax AI (2026-07-01), NCPF backend 透传即可, 跟 web 端 AiCreateModal 行为一致
* 2. 自写 LLM prompt 必与 NCPF backend 漂移 (两个 prompt 源, 升级时一方动一方不动)
* 3. 自写 LLM response 解析 (parseAiFormText/parseAiFlowText) 已被 web 端 buildFormData 替代
* web buildFormData 才是 web 端权威的 formData/flowNodes 构造逻辑
*
* 1. JNPF 后端已配 MiniMax AI , NCPF backend 透传即可, 跟 web 端 AiCreateModal 行为一致
* 2. 自写 LLM prompt 必与 NCPF backend 漂移 (两个 prompt 源, 升级时一方动一方不动)
* 3. 自写 LLM response 解析 (parseAiFormText/parseAiFlowText) 已被 web 端 buildFormData 替代
* web buildFormData 才是 web 端权威的 formData/flowNodes 构造逻辑
* 镜像原型:
* - web/.../api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
* - web/.../api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
* - JNPF 后端: jnpf/.../VisualAiController.java (form) + WorkFlowAiController.java (flow)
*
* - web/.../api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
* - web/.../api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
* - JNPF 后端: jnpf/.../VisualAiController.java (form) + WorkFlowAiController.java (flow)
* 消费方:
* - form/create.ts: --ai → callAiForm
* - form/create.ts: --ai-field → callAiForm + printAiFormResult
* - workflow/create.ts: --ai → callAiWorkflow
* - form/create.ts: --ai → callAiForm
* - form/create.ts: --ai-field → callAiForm + printAiFormResult
* - workflow/create.ts: --ai → callAiWorkflow
*/
import { JnpfClient } from '../../core/client.ts'
import { log } from '../../core/log.ts'
/** AI 返回的 form 模型 (5.10.1, 镜像 web 端 VisualAiModel)
* 来自 NCPF backend /api/visualdev/ai/form 响应 data 字段 */
* 来自 NCPF backend /api/visualdev/ai/form 响应 data 字段 */
export interface AiFormResponse {
enCode?: string
fullName?: string
/** v0.19+ (BS-新72): NCPF/SSW fallback 调用链 (失败时填, 让用户知道为啥失败)
* e.g. ["NCPF: 400 System abnormality", "SSW: 500 invalid token"] */
/** (NCPF/SSW fallback 调用链 (失败时填, 让用户知道为啥失败)
* e.g. ["NCPF: 400 System abnormality", "SSW: 500 invalid token"] */
_aiChain?: string[]
/** P1-7 (2026-07-16 jxcj M1 复盘): NCPF / SSW 双双 Login expired, AI 完全不可用.
* 此时 create.ts 检测到此 flag → 跳过 AI exit, 走 web buildFormData 默认空 schema
* (要求 user 已传 --enCode/--fullName, 否则仍 exit 2) */
/** P1-7 NCPF / SSW 双双 Login expired, AI 完全不可用.
* 此时 create.ts 检测到此 flag → 跳过 AI exit, 走 web buildFormData 默认空 schema
* (要求 user 已传 --enCode/--fullName, 否则仍 exit 2) */
loginExpired?: boolean
aiModelList?: Array<{
tableTitle?: string
@@ -50,7 +44,7 @@ export interface AiFormResponse {
fieldOptions?: Array<{ id?: string; fullName?: string; enCode?: string }>
/**
* 关系字段配置 (web RRelationForm 必填 3 项)
* v0.11+ AI 不会自动生成, 由 dacli form/_relationForm_auto.ts 启发式注入
* AI 不会自动生成, 由 dacli form/_relationForm_auto.ts 启发式注入
*/
fieldRelationConfig?: {
modelId?: string
@@ -80,8 +74,8 @@ export interface AiWorkflowResponse {
}
/** 检测 --ai 描述是否暗示太多字段(粗略估算)
* 数连接词 (顿号/逗号/"和"/"以及"/"含"/"加") → 估算候选字段数
* 返回估算的字段数;空描述或无连接词时返回 0
* 数连接词 (顿号/逗号/"和"/"以及"/"含"/"加") → 估算候选字段数
* 返回估算的字段数;空描述或无连接词时返回 0
*/
function estimateFieldCount(keyword: string): number {
if (!keyword) return 0
@@ -91,17 +85,14 @@ function estimateFieldCount(keyword: string): number {
return parts.length
}
/** 检测 AI 输出是否被 max_tokens 截断 (v0.14+ BS-新30)
*
* 触发场景 1 (后端错误): 后端返回 code!=200, msg 含 SYS181 / "AI表单生成转换失败" / JSON 解析错
* 触发场景 2 (静默截断): 后端 code=200, 但 data.enCode/fullName/aiModelList 为空
* 且 --ai 描述字段数 > 10 (几乎肯定是 LLM 输出 JSON 超 1500 token 被截断)
*
* 根因: SendAiMessage.java:148 new AiSendModel() 硬编码 maxTokens=1500
* LLM 输出 JSON 超 1500 token 被强制截断 → SYS181 (场景1) 或 返回空 (场景2)
* yml 的 chat.maxTokens 不生效 (SendAiMessage 是 static 方法, 不读 AiProperties)
* base_ai 表也没 maxTokens 字段 (JNPF 平台限制)
* 修复方向: 拆分 --ai 描述 (≤10 字段/次), 让 LLM 输出 JSON < 1200 token
/** 检测 AI 输出是否被 max_tokens 截断 ( * 触发场景 1 (后端错误): 后端返回 code!=200, msg 含 SYS181 / "AI表单生成转换失败" / JSON 解析错
* 触发场景 2 (静默截断): 后端 code=200, 但 data.enCode/fullName/aiModelList 为空
* 且 --ai 描述字段数 > 10 (几乎肯定是 LLM 输出 JSON 超 1500 token 被截断)
* 根因: SendAiMessage.java:148 new AiSendModel() 硬编码 maxTokens=1500
* LLM 输出 JSON 超 1500 token 被强制截断 → SYS181 (场景1) 或 返回空 (场景2)
* yml 的 chat.maxTokens 不生效 (SendAiMessage 是 static 方法, 不读 AiProperties)
* base_ai 表也没 maxTokens 字段 (JNPF 平台限制)
* 修复方向: 拆分 --ai 描述 (≤10 字段/次), 让 LLM 输出 JSON < 1200 token
*/
function buildAiTruncationHint(keyword: string): string {
const fieldCount = estimateFieldCount(keyword)
@@ -137,32 +128,29 @@ function buildAiTruncationHint(keyword: string): string {
• 如果 SSW 也失败, 才需要手动拆 prompt`
}
/** 5.10.1 — AI 快速建表 (v0.14+: NCPF backend + SSW 修复 fallback)
*
* 流程 (BS-新113 jyzs 2026-07-02):
* 1. 先 POST /api/visualdev/ai/form (jnpf 后端, 原始路径)
* 2. **新增**: 429 "token plan 用尽" 时 retry 3 次, 退避 5s/10s/20s (指数退避)
* 3. 后端错误 (SYS181 / JSON 解析失败) → fallback 到 SSW AI 修复
* 4. 静默截断 (code=200 但 data 空) → fallback 到 SSW AI 修复
* 5. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
* 6. SSW 也 429 时 retry 2 次 (退避 5s/10s), 然后才失败
*
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
* + ssw-common SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
/** 5.10.1 — AI 快速建表 (NCPF backend + SSW 修复 fallback)
* 流程 (jyzs 2026-07-02):
* 1. 先 POST /api/visualdev/ai/form (jnpf 后端, 原始路径)
* 2. **新增**: 429 "token plan 用尽" 时 retry 3 次, 退避 5s/10s/20s (指数退避)
* 3. 后端错误 (SYS181 / JSON 解析失败) → fallback 到 SSW AI 修复
* 4. 静默截断 (code=200 但 data 空) → fallback 到 SSW AI 修复
* 5. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
* 6. SSW 也 429 时 retry 2 次 (退避 5s/10s), 然后才失败
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
* + shared module SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
*/
/**
* v0.15+ (v0.15-3): SSW retry 工具已抽到 ../_ssw_retry.ts 统一维护
* - isTokenPlanExhausted / backoffSleep / withSswRetry
* - form + workflow 共用, BS-新113 5s/10s/20s 策略集中
* - 后续加 sswTable/sswReport 不用复制
* (v0.15-3): SSW retry 工具已抽到 ../_ssw_retry.ts 统一维护
* - isTokenPlanExhausted / backoffSleep / withSswRetry
* - form + workflow 共用, 5s/10s/20s 策略集中
* - 后续加 sswTable/sswReport 不用复制
*/
/** @deprecated 改用 ../_ssw_retry.ts (v0.15+ 抽象) */
/** @deprecated 改用 ../_ssw_retry.ts (抽象) */
import { isTokenPlanExhausted, isLoginExpired, backoffSleep, withSswRetry } from '../_ssw_retry.ts'
/**
* 带 retry 的 NCPF backend 调用 (BS-新113)
* @param keyword 描述
* 带 retry 的 NCPF backend 调用 ( * @param keyword 描述
* @param maxRetries 最大重试次数 (默认 3)
* @returns AiFormResponse (重试耗尽仍 429 时 throw Error)
*/
@@ -178,7 +166,7 @@ async function callNcpfBackendWithRetry(
const r = await c.postJson<AiFormResponse>('/visualdev/ai/form', { keyword })
// 成功
if (r.code === 200) {
// v0.20+ P2 修复: code=200 但 data 为空 (静默截断) 也 retry, 不立刻 fallback SSW
// P2 修复: code=200 但 data 为空 (静默截断) 也 retry, 不立刻 fallback SSW
// 背景: 实测 5 次里 1 次 (20%) NCPF 返回空 data, 单次 fallback SSW 太激进
// 阈值: empty = enCode/fullName/aiModelList 都空, 这种 LLM 不稳定概率高
const data = r.data || {}
@@ -230,13 +218,13 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
}
// 场景 A: NCPF 错误 → fallback SSW
// v0.15+ (2026-07-03): 所有非 200 都走 SSW, 不再区分截断类型
// NCPF 配了 AI 会用, 没配就 fail — SSW 自己有 DeepSeek, 不需要 NCPF
// 所有非 200 都走 SSW, 不再区分截断类型
// NCPF 配了 AI 会用, 没配就 fail — SSW 自己有 DeepSeek, 不需要 NCPF
if (r.code !== 200) {
// P1-7 (2026-07-16 jxcj M1 复盘): Login expired 全局阻塞场景
// 根因: NCPF 后端 AI 服务 token 失效, SSW /ssw/ai/repair 也走同 token 必 fail
// 修复: 检测 Login expired 后跳过 SSW fallback (浪费 2 次重试), 直接返回
// loginExpired=true 让 create.ts 走 web buildFormData 默认空 schema
// P1-7 Login expired 全局阻塞场景
// 根因: NCPF 后端 AI 服务 token 失效, SSW /ssw/ai/repair 也走同 token 必 fail
// 检测 Login expired 后跳过 SSW fallback (浪费 2 次重试), 直接返回
// loginExpired=true 让 create.ts 走 web buildFormData 默认空 schema
if (isLoginExpired(r as unknown as { code?: number; msg?: string })) {
aiChain.push(`NCPF: Login expired (code=${(r as any).code}, msg=${((r as any).msg || '').slice(0, 80)})`)
log.warn(`! NCPF Login expired → AI 后端 token 失效, 跳过 SSW fallback (BS-新113 P1-7)`)
@@ -249,7 +237,7 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
}
// 场景 B: 静默截断 (code=200 但 data 空) → fallback SSW
// v0.15+ 修复 (2026-07-02 audit FINDING-F2): 加 fieldCount 检测, 避免中间截断 (enCode 有但 fields=[]) 漏判
// 修复 加 fieldCount 检测, 避免中间截断 (enCode 有但 fields=[]) 漏判
const data = r.data || {}
const isEmpty = !data.enCode && !data.fullName && (!data.aiModelList || data.aiModelList.length === 0)
// 估算 keyword 实际要求字段数 (每个"/"或"字段"/"列"分隔符 +1)
@@ -270,12 +258,10 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
}
/**
* SSW AI 修复 fallback (BS-新113 增强: 429 retry 2 次)
*
* SSW AI 修复 fallback (增强: 429 retry 2 次)
* 端点: POST /api/ssw/ai/repair
* 来源: ssw-common-controller/SswAIRepairController
* 来源: shared module-controller/SswAIRepairController
* 逻辑: SSW 端点直接调 LLM (maxTokens=3000) + 修复 fieldOptions / 注释 / 截断 / 文字说明混合
*
* @param keyword --ai 描述
* @param reason fallback 原因 (用于日志)
* @returns VisualAiModel 兼容结构; 失败时返回空对象
@@ -289,12 +275,12 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
const r = await c.postJson<AiFormResponse>('/ssw/ai/repair', { keyword })
if (r.code === 200 && r.data && r.data.enCode) {
log.ok(`✓ SSW 修复成功: enCode=${r.data.enCode}, fullName=${r.data.fullName}, fields=${r.data.aiModelList?.[0]?.fields?.length || 0}`)
// v0.19+ BS-新72: 透传 chain
// 透传 chain
r.data._aiChain = [...aiChain, `SSW: 200 OK`]
return r.data
}
// P1-7 (2026-07-16): SSW 也可能 Login expired (与 NCPF 同 token 失效), 检测到立即返回
// 不浪费 5s/10s 重试, 让 create.ts 走 web buildFormData 默认空 schema
// SSW 也可能 Login expired (与 NCPF 同 token 失效), 检测到立即返回
// 不浪费 5s/10s 重试, 让 create.ts 走 web buildFormData 默认空 schema
if (isLoginExpired(r as unknown as { code?: number; msg?: string })) {
aiChain.push(`SSW: Login expired (code=${(r as any).code}, msg=${((r as any).msg || '').slice(0, 80)})`)
log.warn(`! SSW Login expired → AI 后端 token 失效 (BS-新113 P1-7), 跳过剩余重试`)
@@ -309,14 +295,14 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
continue
}
}
// v0.20+ P1 修复: SSW 错误链完整显示 (不截断), 让用户看到 fastjson NPE stack trace
// P1 修复: SSW 错误链完整显示 (不截断), 让用户看到 fastjson NPE stack trace
// 背景: 之前 SSW 异常截断 60 字符, NPE 类错误看不到根因, 误以为是 AI 描述问题
const sswMsgFull = r.msg || '(no msg)'
aiChain.push(`SSW: code=${r.code} ${sswMsgFull.slice(0, 200)}`)
log.warn(`! SSW 修复失败 (code=${r.code}): ${sswMsgFull}`)
break
} catch (e) {
// v0.20+ P1 修复: 完整异常信息, 包括 NPE stack trace 头部
// P1 修复: 完整异常信息, 包括 NPE stack trace 头部
const sswExcFull = (e as Error)?.message || String(e)
const sswStack = (e as Error)?.stack?.split('\n').slice(0, 3).join(' | ') || ''
aiChain.push(`SSW: 异常 ${sswExcFull.slice(0, 200)}`)
@@ -334,15 +320,13 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
return { _aiChain: aiChain }
}
/** 5.10.3 — AI 创建流程 (v0.15+: NCPF backend + SSW 修复 fallback)
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
*
* v0.15+ (BS-新30 workflow, 2026-07-02): 加 SSW 修复层, 跟 form --ai 模式一致
* - NCPF /api/workflow/ai 失败 (BS-新30: SYS181 截断, 429 token plan 用尽, 静默截断)
* - Fallback: POST /api/ssw/ai/repair-workflow (ssw-common-controller)
* - SSW 复用 SswLLMClient maxTokens=3000 + JsonRepairUtil 修复层 (跨 BPMN XML 特殊字符)
* - 5s/10s/20s retry (跟 form 一致)
*
/** 5.10.3 — AI 创建流程 (NCPF backend + SSW 修复 fallback)
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
* (workflow, 2026-07-02): 加 SSW 修复层, 跟 form --ai 模式一致
* - NCPF /api/workflow/ai 失败 (SYS181 截断, 429 token plan 用尽, 静默截断)
* - Fallback: POST /api/ssw/ai/repair-workflow (shared module-controller)
* - SSW 复用 SswLLMClient maxTokens=3000 + JsonRepairUtil 修复层 (跨 BPMN XML 特殊字符)
* - 5s/10s/20s retry (跟 form 一致)
* 失败处理: NCPF + SSW 都失败 → 抛错, 调用方走原错误流 (dacli workflow create 退出 1)
*/
export async function callAiWorkflow(keyword: string): Promise<AiWorkflowResponse> {
@@ -350,16 +334,16 @@ export async function callAiWorkflow(keyword: string): Promise<AiWorkflowRespons
log.info(`[NCPF backend] POST /workflow/ai keyword="${keyword.slice(0, 50)}${keyword.length > 50 ? '...' : ''}"`)
const r = await c.postJson<AiWorkflowResponse>('/workflow/ai', { keyword })
if (r.code === 200) {
// 静默截断检测 (BS-新30): NCPF 返 200 但 flowXml 为空
// 静默截断检测 (NCPF 返 200 但 flowXml 为空
if (!r.data?.flowXml) {
log.warn(`! NCPF 后端静默截断 (返 200 但 flowXml 空) → fallback SSW 修复`)
return await callSswAiWorkflowRepair(keyword, 'NCPF 静默截断')
}
// v0.15+ (实测 2026-07-02): NCPF backend 返 URL-encoded flowXml (%3C%3Fxml)
// - 直接 SSW 返真实 XML (testspace 验证)
// - 跟 SSW 不一致, 老的 dacli 没处理, step machine 校验失败
// - 修复: URL-decode 后用真实 XML, 校验才能通过
// - 旁路: decode 失败时保留原值 (用 isUrlEncoded 启发式判断)
// (实测 2026-07-02): NCPF backend 返 URL-encoded flowXml (%3C%3Fxml)
// - 直接 SSW 返真实 XML (testspace 验证)
// - 跟 SSW 不一致, 老的 dacli 没处理, step machine 校验失败
// - 修复: URL-decode 后用真实 XML, 校验才能通过
// - 旁路: decode 失败时保留原值 (用 isUrlEncoded 启发式判断)
if (r.data.flowXml.startsWith('%3C') || r.data.flowXml.startsWith('%3c')) {
try {
const decoded = decodeURIComponent(r.data.flowXml)
@@ -377,15 +361,12 @@ export async function callAiWorkflow(keyword: string): Promise<AiWorkflowRespons
}
/**
* v0.21+ (Round 12 BS-新43): 检测 AI 返回的 flowXml 是否 trivial (≤1 userTask).
*
* (Round 12 检测 AI 返回的 flowXml 是否 trivial (≤1 userTask).
* Round 12 现象: 5/5 workflow --ai 都生成 "StartEvent → Task_1 → EndEvent" 3-node trivial,
* baseline 业务流 4-10 nodes 全丢 (missing_nodes=31 总数).
* NCPF backend 的 LLM prompt 没有强制要求节点数, 永远返最简 3-node.
* dacli 端无法修 NCPF prompt, 只能在客户端侦测 + 强 WARN 推荐用 --flowXml.
*
* baseline 业务流 4-10 nodes 全丢 (missing_nodes=31 总数).
* NCPF backend 的 LLM prompt 没有强制要求节点数, 永远返最简 3-node.
* dacli 端无法修 NCPF prompt, 只能在客户端侦测 + 强 WARN 推荐用 --flowXml.
* 判定规则: XML 中 userTask / task 元素数 (≥1 才正常, ≥4 才像真业务).
*
* @returns { isTrivial, taskCount } — isTrivial=true 表示建议用户改用 --flowXml 路径.
*/
export function detectTrivialFlowXml(flowXml: string): { isTrivial: boolean; taskCount: number; warning: string } {
@@ -400,12 +381,10 @@ export function detectTrivialFlowXml(flowXml: string): { isTrivial: boolean; tas
}
/**
* v0.15+ (BS-新30 workflow): SSW AI 修复 fallback
*
* (workflow): SSW AI 修复 fallback
* 端点: POST /api/ssw/ai/repair-workflow
* 来源: ssw-common-controller/SswAIRepairController.repairWorkflow
* 来源: shared module-controller/SswAIRepairController.repairWorkflow
* 逻辑: SSW 端点直接调 LLM (maxTokens=3000) + 修复 BPMN XML 截断/格式
*
* 跟 callSswAiRepair (form) 平行, 复用同样的 retry 模式 (5s/10s/20s)
*/
async function callSswAiWorkflowRepair(keyword: string, reason: string): Promise<AiWorkflowResponse> {
+46 -54
View File
@@ -1,20 +1,16 @@
/**
* commands/form/_validate.ts — form create step machine 校验
*
* 镜像 web Form.vue handleNext + handleSubmit 的前端校验逻辑 (Generator.getData + ColumnDesign.getData)
* 让 dacli form create 在发 API 之前暴露问题, AI 不用去浏览器试错
*
* 设计原则 (2026-06-26 v0.11d+ → 2026-06-28 v0.11e+):
* - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
* - 跟 BS-50/BS-44/BS-42 等盲点守卫一致: 在发 API 前校验
* 设计原则 * - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
* - 跟 等盲点守卫一致: 在发 API 前校验
* - 校验失败 → 返回 step N + 错误列表, 不发 API
* - 校验通过 → 1 次 create API call (不拆步骤)
* - v0.11e+ 严格镜像 web 端 formValidate('enCode') (禁下划线) + Form.vue schemas 6 字段必填
*
* - 严格镜像 web 端 formValidate('enCode') (禁下划线) + Form.vue schemas 6 字段必填
* step 镜像对应:
* step 0: 基础信息 (fullName, enCode 格式禁下划线, category 必填, type 合法性, tables.length, 子表外键)
* step 1: formData 字段 (formFields ≥ 1, vmodel 格式, billRule/popupSelect/relationForm/autoComplete/upload 控件级)
* step 2: columnData (columnList ≥ 1 当 webType≠1, 树形 treeDataSource/props/relation/sync 必填, 卡片/分组/父级字段)
* step 0: 基础信息 (fullName, enCode 格式禁下划线, category 必填, type 合法性, tables.length, 子表外键)
* step 1: formData 字段 (formFields ≥ 1, vmodel 格式, billRule/popupSelect/relationForm/autoComplete/upload 控件级)
* step 2: columnData (columnList ≥ 1 当 webType≠1, 树形 treeDataSource/props/relation/sync 必填, 卡片/分组/父级字段)
*/
export interface ValidationError {
@@ -22,8 +18,8 @@ export interface ValidationError {
field?: string
/** 错误消息 (镜像 web 文案, AI 能对照) */
message: string
/** v0.11e+: ErrorCode (镜像后端 MsgCode.java, AI 能查表)
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
/** ErrorCode (镜像后端 MsgCode.java, AI 能查表)
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
code?: string
}
@@ -39,41 +35,37 @@ export interface StepValidation {
// eslint-disable-next-line regexp/no-unused-capturing-group
const VMODEL_REGEXP = /(^_([a-z0-9]_?)*$)|(^[a-z](_?[a-z0-9])*_?$)/i
// v0.11h+ (2026-06-28): 共享 _encode_validator.ts (BS-56 增强)
// 镜像 web 端 formValidate('enCode') (formValidate.ts:24-28) 禁下划线/连字符
// 增强: 校验失败时输出清晰原因 + 自动建议别名 (去下划线/连字符)
// 共享 _encode_validator.ts (增强)
// 镜像 web 端 formValidate('enCode') (formValidate.ts:24-28) 禁下划线/连字符
// 增强: 校验失败时输出清晰原因 + 自动建议别名 (去下划线/连字符)
// eslint-disable-next-line @typescript-eslint/no-unused-vars
import { ENCODE_REGEXP, FULLNAME_REGEXP, validateEnCode, validateFullName } from '../_encode_validator.ts'
/** v0.11e+ upload folder name 正则 — 镜像 Generator.getData() line 295 */
/** upload folder name 正则 — 镜像 Generator.getData() line 295 */
// eslint-disable-next-line regexp/no-unused-capturing-group
const FOLDER_REGEXP = /^[a-z0-9][\w-]{0,99}$/i
/** v0.11e+ billRule startNumber 正则 — 镜像 Generator.getData() line 263
* 数字, 不能为 0 */
/** billRule startNumber 正则 — 镜像 Generator.getData() line 263
* 数字, 不能为 0 */
// eslint-disable-next-line regexp/no-unused-capturing-group
const STARTNUMBER_REGEXP = /^\d*[1-9]$/
/** v0.11e+ 合法 type 集合 — 镜像 Form.vue:107 type 默认 1, 合法 {1,2,3,4} */
/** 合法 type 集合 — 镜像 Form.vue:107 type 默认 1, 合法 {1,2,3,4} */
const VALID_TYPES = [1, 2, 3, 4] as const
/** v0.13+ BS-新3 (2026-06-30 testspace): fullName 关键字前置校验
*
/** fullName 关键字前置校验
* 后端 VisualdevController.java:509 create() 调 GenerateConstant.containKeyword(entity.getFullName())
* → 检查 ALL_KEYWORD = SYS_KEYWORD (26 个) + JAVA_KEYWORD (50 个) + SQL_KEYWORD (2030 个)
* → 命中即返 "表单名称xxx不能使用系统、开发语言及数据库关键字命名" (SYS128)
* → VisualdevController.java:437 update() 同样检查
* → VisualdevController.java:598 publish() 同样检查 (即使 create 通过了, publish 也再查)
*
* → 检查 ALL_KEYWORD = SYS_KEYWORD (26 个) + JAVA_KEYWORD (50 个) + SQL_KEYWORD (2030 个)
* → 命中即返 "表单名称xxx不能使用系统、开发语言及数据库关键字命名" (SYS128)
* → VisualdevController.java:437 update() 同样检查
* → VisualdevController.java:598 publish() 同样检查 (即使 create 通过了, publish 也再查)
* 之前 dacli form create step machine 只检查 FULLNAME_REGEXP (`/^([一-龥a-z0-9])+$/i`)
* → 字符格式 (. / _ / 特殊符号) 被拦截
* → 但关键字 (fullName='admin' 或 fullName='user') 漏检, runtime 后端 400
*
* 修复: 抽 SYS_KEYWORD + JAVA_KEYWORD + SQL_KEYWORD 共享集合 (复用 dm/_validate.ts 模式),
* form create validateBasicInfo step 0 加 fullName 关键字校验, 镜像后端 GenerateConstant.containKeyword()
*
* → 字符格式 (. / _ / 特殊符号) 被拦截
* → 但关键字 (fullName='admin' 或 fullName='user') 漏检, runtime 后端 400
* 抽 SYS_KEYWORD + JAVA_KEYWORD + SQL_KEYWORD 共享集合 (复用 dm/_validate.ts 模式),
* form create validateBasicInfo step 0 加 fullName 关键字校验, 镜像后端 GenerateConstant.containKeyword()
* 注意: SQL_KEYWORD 全集 2030 个太大, 这里用 dm create 之前验证的"高频子集 + 高频业务词"组合,
* 未收录的仍由后端运行时再校验 (dacli 这里主要解决前置拦截, 不替代后端). */
* 未收录的仍由后端运行时再校验 (dacli 这里主要解决前置拦截, 不替代后端). */
const FULLNAME_SYS_KEYWORDS = new Set([
// GenerateConstant.SYS_KEYWORD (镜像后端)
'tenantid', 'id', 'foreignid', 'flowid', 'flowtaskid', 'deleteuserid', 'deletetime',
@@ -279,9 +271,9 @@ const FULLNAME_SQL_KEYWORDS = new Set([
'zero', 'zone', 'zoned',
])
/** v0.11e+ noVModelList — 镜像 web FormGenerator helper/config.ts:4-8
* 这些控件无 vmodel, 跳过 vmodel 必填校验 (但 isStorage=true 例外)
* vModelIgnoreList + dyStorageList
/** noVModelList — 镜像 web FormGenerator helper/config.ts:4-8
* 这些控件无 vmodel, 跳过 vmodel 必填校验 (但 isStorage=true 例外)
* vModelIgnoreList + dyStorageList
*/
const NO_VMODEL_LIST = [
'divider', 'text', 'link', 'alert', 'groupTitle', 'button', 'barcode', 'qrcode', 'iframe',
@@ -293,7 +285,7 @@ const NO_VMODEL_LIST = [
export function validateBasicInfo(opts: {
fullName?: string
enCode?: string
/** v0.11e+ 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
/** 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
category?: string
type: number
webType: number
@@ -311,12 +303,12 @@ export function validateBasicInfo(opts: {
errors.push({ field: 'fullName', message: '名称不能含有特殊符号', code: 'VS032-FORMAT' })
}
// v0.13+ BS-新3 (2026-06-30 testspace): fullName 关键字前置校验
// fullName 关键字前置校验
// 后端 VisualdevController.create():509 调 GenerateConstant.containKeyword(entity.getFullName())
// → 检查 ALL_KEYWORD (SYS + JAVA + SQL 共 ~2106 关键字), 命中即报 SYS128.
// → 检查 ALL_KEYWORD (SYS + JAVA + SQL 共 ~2106 关键字), 命中即报 SYS128.
// 之前 dacli step machine 漏检 → 用户 fullName='admin' 等过 step machine,
// runtime 后端 400 "表单名称admin不能使用系统、开发语言及数据库关键字命名".
// 修复: 镜像后端 GenerateConstant.containKeyword (case-insensitive), 前置 step 0 拦截.
// runtime 后端 400 "表单名称admin不能使用系统、开发语言及数据库关键字命名".
// 镜像后端 GenerateConstant.containKeyword (case-insensitive), 前置 step 0 拦截.
// 注: 后端 ALL_KEYWORD 命中即拒, 这里强制用 lower-case 比较 (与后端 containKeyword 一致).
if (opts.fullName && opts.fullName.trim()) {
const fn = String(opts.fullName).trim().toLowerCase()
@@ -333,7 +325,7 @@ export function validateBasicInfo(opts: {
}
// enCode: 必填 + 长度 ≤ 50 + formValidate('enCode') 禁下划线 (formValidate.ts:24-28)
// v0.11h+ (2026-06-28): 共享 _encode_validator.ts (BS-56 增强: 清晰信息 + 自动建议别名)
// 共享 _encode_validator.ts (增强: 清晰信息 + 自动建议别名)
const encErr = validateEnCode(opts.enCode, 'enCode')
if (encErr) {
errors.push({
@@ -343,8 +335,8 @@ export function validateBasicInfo(opts: {
})
}
// v0.11e+ 新增 category 必填校验 (镜像 Form.vue:60-66 schemas required: true)
// v0.12+ jxcj-2026-06-29 fix: 加可执行建议 (按 appCode 派生 + 复用 crmOrder 通用)
// 新增 category 必填校验 (镜像 Form.vue:60-66 schemas required: true)
// app-fix: 加可执行建议 (按 appCode 派生 + 复用 crmOrder 通用)
if (!opts.category || !opts.category.trim()) {
errors.push({
field: 'category',
@@ -358,7 +350,7 @@ export function validateBasicInfo(opts: {
})
}
// v0.11e+ 新增 type 合法性校验 (合法集合 {1,2,3,4})
// 新增 type 合法性校验 (合法集合 {1,2,3,4})
if (!VALID_TYPES.includes(opts.type as any)) {
errors.push({
field: 'type',
@@ -370,7 +362,7 @@ export function validateBasicInfo(opts: {
// state.tables 检查 (Form.vue:329-345 handleNext step 0)
if (!opts.tables || opts.tables.length === 0) {
const type = opts.type
// 默认表兜底: type=3 (树) 或 type=4 (视图) 必须有物理表 (BS-55 规则)
// 默认表兜底: type=3 (树) 或 type=4 (视图) 必须有物理表 (规则)
// type=1/2 不强制 (场景 A 默认 fallback)
if (type === 3 || type === 4) {
errors.push({ field: 'tables', message: '请至少选择一个数据表', code: 'VS408' })
@@ -388,7 +380,7 @@ export function validateBasicInfo(opts: {
}
}
}
// B-8 (2026-06-27 tds): 主表 primaryKey 字段禁止是业务字段 (PK 必须留给 JNPF f_id)
// B-8 主表 primaryKey 字段禁止是业务字段 (PK 必须留给 JNPF f_id)
// 后端 FlowFormDataUtil.getKey() (L170-187) 选 primaryKey=1 字段作为 INSERT 列名 (排除 f_tenant_id).
// 用户在 tables[].fields 标业务字段 primaryKey=1 → getKey() 返该字段 → INSERT 重复拼列.
// 这是 dm create step machine 的镜像 (dm/_validate.ts PRIMARY_KEY_FIELDS), 在 form create 兜底拦截.
@@ -440,7 +432,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
const label = config.label || parentLabel || '(未命名)'
// colFormItem 控件: vmodel 必填 + 格式 (line 256-259)
// v0.11e+ 镜像 web: noVModelList 跳过 (但 isStorage=true 例外)
// 镜像 web: noVModelList 跳过 (但 isStorage=true 例外)
if (config.layout === 'colFormItem') {
const skipVModel = NO_VMODEL_LIST.includes(config.jnpfKey) && !e.isStorage
if (!skipVModel) {
@@ -472,7 +464,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
if (!e.relationField) errors.push({ field: formId, message: `回显字段不能为空 (label: ${label})`, code: 'VS-AUTO-FIELD' })
}
// relationQuery (v0.11e+ 新镜像 line 317-320): modelId + columnOptions 二必填
// relationQuery (新镜像 line 317-320): modelId + columnOptions 二必填
if (config.jnpfKey === 'relationQuery') {
if (!e.modelId) errors.push({ field: formId, message: `关联功能不能为空 (label: ${label})`, code: 'VS-RELQUERY-MODEL' })
if (!e.columnOptions || e.columnOptions.length === 0) {
@@ -558,7 +550,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
}
/** step 2: columnData 校验 (镜像 ColumnDesign.getData() 核心规则: columnList ≥ 1 当 webType≠1)
* v0.11e+ 严格镜像 Main.vue:283-340 树形/分组/父级/卡片/导入模板/打印模板 7 类校验
* 严格镜像 Main.vue:283-340 树形/分组/父级/卡片/导入模板/打印模板 7 类校验
*/
export function validateColumnData(columnData: any | null, webType: number): StepValidation {
const errors: ValidationError[] = []
@@ -578,7 +570,7 @@ export function validateColumnData(columnData: any | null, webType: number): Ste
return { ok: false, step: 2, stepName: '列表设计', errors }
}
// v0.11e+ 严格镜像 ColumnDesign.getData() line 283-310 树形校验
// 严格镜像 ColumnDesign.getData() line 283-310 树形校验
// type=2 是树形列表 (Main.vue columnConfig column.type=2)
if (columnData.type == 2) {
if (columnData.treeDataSource === 'dictionary' && !columnData.treeDictionary) {
@@ -651,7 +643,7 @@ export function validateColumnData(columnData: any | null, webType: number): Ste
export function validateFormCreate(opts: {
fullName?: string
enCode?: string
/** v0.11e+ 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
/** 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
category?: string
type: number
webType: number
@@ -671,8 +663,8 @@ export function validateFormCreate(opts: {
}
}
/** v0.11e+ URL 校验 — 镜像 web Generator.getData() line 313 的 isUrl 简化版
* web 端 isUrl 走 utils 包, 这里给一份最简实现覆盖 95% 场景
/** URL 校验 — 镜像 web Generator.getData() line 313 的 isUrl 简化版
* web 端 isUrl 走 utils 包, 这里给一份最简实现覆盖 95% 场景
*/
function isUrl(url: string): boolean {
if (!url || typeof url !== 'string') return false
+39 -43
View File
@@ -1,27 +1,23 @@
/**
* commands/workflow/create.ts — 新建流程模板 (v0.12+ BS-新27 6 步 webapi 路径)
*
* commands/workflow/create.ts — 新建流程模板 (6 步 webapi 路径)
* 修复 Bug 3 (流程编辑页无节点 + 提交报"系统异常")
*
* 6 步 webapi 路径 (镜像 web 浏览器 AiCreateModal.vue 完整流程, 端到端可用):
* 1. loadWorkflow.getAiInfo(keyword) → 走 web 端, prompt/parse/format 跟 web 一致
* 2. loadWorkflow.create(template) → 创建空模板 (走 /api/workflow/template)
* 3. getVersionList(templateId) → 拿 versionId (走 /api/workflow/template/Version/{id})
* 4. buildFlowNodes(flowXml, formId) → 构造完整 flowNodes (含 global + 解析节点)
* 5. loadWorkflow.save({type:1, ...}) → 真正发布 + 部署 (走 /api/workflow/template/Save)
* 6. (caller 后续) /workflow/task 发起
*
* 1. loadWorkflow.getAiInfo(keyword) → 走 web 端, prompt/parse/format 跟 web 一致
* 2. loadWorkflow.create(template) → 创建空模板 (走 /api/workflow/template)
* 3. getVersionList(templateId) → 拿 versionId (走 /api/workflow/template/Version/{id})
* 4. buildFlowNodes(flowXml, formId) → 构造完整 flowNodes (含 global + 解析节点)
* 5. loadWorkflow.save({type:1, ...}) → 真正发布 + 部署 (走 /api/workflow/template/Save)
* 6. (caller 后续) /workflow/task 发起
* 镜像原型:
* - web/.../onlineDev/flowEngine/components/AiCreateModal.vue (AI 弹窗 + form 配置 + create)
* - web/.../onlineDev/flowEngine/DesignForm.vue:130-150 (handleRequest + saveFlow)
* - web/.../api/workFlow/template.ts: getAiInfo + create + saveFlow
* - web/.../FlowProcess/src/helper/config.ts:13-58 (defaultGlobalForm 模板)
* - jnpf/.../flowable/util/FlowUtil.java:2134 (后端 launch 必查 global.getTitleType)
*
* v0.12+ 简化 (BS-新27 jxcj 2026-07-01):
* - 移除老路径 (--no-ai-path / --auto-enable / 单独 PUT enabledMark) - 都是没用的中间步骤
* - --ai 默认走 6 步 webapi, --flowXml 用户直传也走 webapi 路径
* - 必填: --fullName + --category, --enCode 可选 (缺时从 fullName 自动生成 snake_case)
* - web/.../onlineDev/flowEngine/components/AiCreateModal.vue (AI 弹窗 + form 配置 + create)
* - web/.../onlineDev/flowEngine/DesignForm.vue:130-150 (handleRequest + saveFlow)
* - web/.../api/workFlow/template.ts: getAiInfo + create + saveFlow
* - web/.../FlowProcess/src/helper/config.ts:13-58 (defaultGlobalForm 模板)
* - jnpf/.../flowable/util/FlowUtil.java:2134 (后端 launch 必查 global.getTitleType)
* 简化 (app 2026-07-01):
* - 移除老路径 (--no-ai-path / --auto-enable / 单独 PUT enabledMark) - 都是没用的中间步骤
* - --ai 默认走 6 步 webapi, --flowXml 用户直传也走 webapi 路径
* - 必填: --fullName + --category, --enCode 可选 (缺时从 fullName 自动生成 snake_case)
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
@@ -49,9 +45,9 @@ interface CreateOpts {
iconBackground?: string
showType?: string
icon?: string
/** v0.21+ BS-drift-W-4 fix: 手动设 sortCode (默认 0, baseline 拖拽排序丢失) */
/** 手动设 sortCode (默认 0, baseline 拖拽排序丢失) */
sortCode?: string
/** BS-E14 (Round 8 P2): isLayoutNeeded 阈值 (默认 0.8 = 80% 重叠触发) */
/** (Round 8 P2): isLayoutNeeded 阈值 (默认 0.8 = 80% 重叠触发) */
layoutThreshold?: string
json?: boolean
/** 5.10.3 AI 创建流程 (--ai "<描述>") - 调 web 端 getAiInfo 拿 flowXml */
@@ -81,7 +77,7 @@ export function buildWorkflowCreateCommand(): Command {
.option('--flowConfig <json>', 'flowConfig JSON 字符串')
.option('--iconBackground <color>', '图标背景色 (默认 #108ee9)', '#108ee9')
.option('--icon <i>', '流程图标 (默认 icon-ym icon-ym-flow)', 'icon-ym icon-ym-flow')
// v0.21+ BS-drift-W-4 fix: 手动设 sortCode (默认 0)
// 手动设 sortCode (默认 0)
.option('--sortCode <n>', 'sortCode 排序 (默认 0)', '0')
.option('--showType <n>', '显示位置 (0=全局 1=流程 2=菜单, 默认 0)', '0')
.option('--startFormId <id>', '绑定的 formId (绑到 start 节点 formId, 镜像 web 选表单步骤)')
@@ -92,7 +88,7 @@ export function buildWorkflowCreateCommand(): Command {
.action(async (opts: CreateOpts) => {
const c = await JnpfClient.fromToken()
// v0.21+ (Round 12 BS-新38): enCode 含 `-`/`_` 自动 strip + WARN
// (Round 12 enCode 含 `-`/`_` 自动 strip + WARN
if (opts.enCode) {
const _encStrip = autoStripEnCode(opts.enCode)
if (_encStrip.wasStriped) {
@@ -101,7 +97,7 @@ export function buildWorkflowCreateCommand(): Command {
}
}
// v0.21+ R14 fix (BS-新52): fullName 含 space/parens 自动 strip + WARN
// fix (fullName 含 space/parens 自动 strip + WARN
if (opts.fullName) {
const _fnStrip = autoStripFullName(opts.fullName)
if (_fnStrip.wasStriped) {
@@ -110,21 +106,21 @@ export function buildWorkflowCreateCommand(): Command {
}
}
// BS-E3 (Round 8 P0): workflow 没绑 startFormId → 浏览器报 "workFlowForm/undefined.vue"
// step 1 拦截: 提示用户传 --startFormId (web NodeFormParser.vue:59-64)
// (Round 8 P0): workflow 没绑 startFormId → 浏览器报 "workFlowForm/undefined.vue"
// step 1 拦截: 提示用户传 --startFormId (web NodeFormParser.vue:59-64)
if (!opts.startFormId) {
log.warn(`BS-E3: workflow 未传 --startFormId, 浏览器流程设计器点击节点时会报 'workFlowForm/undefined.vue'`)
log.warn(` 建议: dacli workflow create --startFormId=<formId> ... (参考 web NodeFormParser.vue:59-64 动态 import)`)
}
// BS-E4 (Round 8 P0): --ai 描述过短 → AI 返回乱流程
// (Round 8 P0): --ai 描述过短 → AI 返回乱流程
if (opts.ai && opts.ai.trim().length < 10) {
log.warn(`BS-E4: --ai 描述过短 (${opts.ai.trim().length} 字符), AI 可能返回不完整流程`)
log.warn(` 建议: 描述至少 10 字符, 含完整审批环节 (例: "员工提交 → 主管审批 → 财务付款")`)
}
// BS-E5 (Round 8 P0): workflow --category=<id> 不存在 → 后端 400 模糊
// step 0 拦截: 跑 selector 查表, 不存在直接 exit 2
// (Round 8 P0): workflow --category=<id> 不存在 → 后端 400 模糊
// step 0 拦截: 跑 selector 查表, 不存在直接 exit 2
if (opts.category) {
try {
await initWebapi(c)
@@ -160,10 +156,10 @@ export function buildWorkflowCreateCommand(): Command {
flowXml = data.flowXml
log.info(` ↳ AI 返回 flowXml 长度 ${flowXml.length} 字符`)
// v0.21+ (Round 12 BS-新43): 检测 AI 返回是否 trivial (≤1 userTask).
// Round 12: 5/5 workflow --ai 都生 "Start → 审批 → End" 3-node trivial, baseline 节点全丢.
// NCPF backend LLM prompt 缺节点规格, dacli 端不可修.
// 客户端侦测 + WARN 推荐用 --flowXml 直传 baseline
// (Round 12 检测 AI 返回是否 trivial (≤1 userTask).
// Round 12: 5/5 workflow --ai 都生 "Start → 审批 → End" 3-node trivial, baseline 节点全丢.
// NCPF backend LLM prompt 缺节点规格, dacli 端不可修.
// 客户端侦测 + WARN 推荐用 --flowXml 直传 baseline
const trivial = detectTrivialFlowXml(flowXml)
if (trivial.isTrivial) {
log.warn(trivial.warning)
@@ -171,9 +167,9 @@ export function buildWorkflowCreateCommand(): Command {
}
// C方案: 自动布局 (镜像 web handleAutoLayoutByHorizontal 思路)
// AI 返回的 XML 所有节点 bounds=(400,300) 完全重叠, 不自动布局浏览器打开会全挤在一起
// bpmn-moddle 纯 XML 解析 (无 DOM 依赖), Node 端跑 BFS 水平布局
// BS-E14 (Round 8 P2): --layout-threshold 参数, 默认 0.8 (80% 重叠触发)
// AI 返回的 XML 所有节点 bounds=(400,300) 完全重叠, 不自动布局浏览器打开会全挤在一起
// bpmn-moddle 纯 XML 解析 (无 DOM 依赖), Node 端跑 BFS 水平布局
// (Round 8 P2): --layout-threshold 参数, 默认 0.8 (80% 重叠触发)
const layoutThreshold = parseFloat(opts.layoutThreshold || '0.8')
if (await isLayoutNeeded(flowXml, layoutThreshold)) {
log.info(` ↳ 检测到 AI XML 节点/waypoint 坐标重叠 (阈值 ${layoutThreshold * 100}%), 触发自动布局 (B方案: 镜像 web bpmn-js handleAutoLayoutByHorizontal)`)
@@ -208,7 +204,7 @@ export function buildWorkflowCreateCommand(): Command {
flowXml,
flowNodes: {},
flowConfig: opts.flowConfig || '{}',
// v0.21+ BS-drift-W-4 fix: --sortCode 透传 (默认 0)
// --sortCode 透传 (默认 0)
sortCode: parseInt(opts.sortCode || '0', 10),
showType: Number(opts.showType ?? '0'),
iconBackground: opts.iconBackground ?? '#108ee9',
@@ -220,9 +216,9 @@ export function buildWorkflowCreateCommand(): Command {
const enhanced = enhanceFromBackend(createResp.msg || '', 'workflow', { entity: 'workflow' })
log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: 'create template' })}`)
// v0.21+ R14 fix (BS-新43b): stale pre-validate "已存在 SU001" cleanup + retry ONCE
// R13 现象: 前次失败留的 partial workflow (templateId 已知 or enCode 已注册) 阻塞 retry.
// 修法: 检测 "已存在/SU001/预校验" → 找 stale id → 删除 → 重试一次.
// fix (stale pre-validate "已存在 SU001" cleanup + retry ONCE
// 现象: 前次失败留的 partial workflow (templateId 已知 or enCode 已注册) 阻塞 retry.
// 修法: 检测 "已存在/SU001/预校验" → 找 stale id → 删除 → 重试一次.
const isStalePreValidate = /已存在|SU001|预校验|already exists/i.test(String(createResp.msg || ''))
if (isStalePreValidate) {
log.warn(`BS-新43b: stale pre-validate detected, 尝试清理 + retry`)
@@ -290,7 +286,7 @@ export function buildWorkflowCreateCommand(): Command {
const hasGlobal = 'global' in flowNodes
log.ok(` ↳ ${nodeCount} 个节点 (含 global=${hasGlobal}, start.formId=${opts.startFormId || '(none)'})`)
// v0.21+ BS-drift-W-3 fix: 镜像 web bpmnLintUtil.ts 结构校验 (不创角色/节点数校验)
// 镜像 web bpmnLintUtil.ts 结构校验 (不创角色/节点数校验)
const structCheck = validateFlowNodeStructure(flowNodes)
if (structCheck.errorList.length > 0) {
// 镜像 web 端 DesignForm.vue:130-134 (setErrorList + validatePopoverRef 弹窗)
@@ -418,7 +414,7 @@ export function buildWorkflowCreateCommand(): Command {
}
/**
* v0.11d+ step machine 校验 (3 步镜像 web flowEngine/Form.vue + 后端 TemplateController.create)
* step machine 校验 (3 步镜像 web flowEngine/Form.vue + 后端 TemplateController.create)
*/
async function runWorkflowStepMachine(
c: JnpfClient,