From cbeb429a6db2cdf8cb46f183a7e1729d936340bd Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 17 Jul 2026 12:34:30 +0800 Subject: [PATCH] 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 --- src/commands/di/create.ts | 58 +++++----- src/commands/dict/_validate.ts | 65 +++++------- src/commands/form/_ai.ts | 183 ++++++++++++++------------------ src/commands/form/_validate.ts | 100 ++++++++--------- src/commands/workflow/create.ts | 82 +++++++------- 5 files changed, 220 insertions(+), 268 deletions(-) diff --git a/src/commands/di/create.ts b/src/commands/di/create.ts index a0b6806..c0364e3 100644 --- a/src/commands/di/create.ts +++ b/src/commands/di/create.ts @@ -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 ', '说明') - // v0.15+ (R3.3): 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复) + // 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复) .option('--from-json-file ', '从 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 数组字符串 (BS-drift-DI-1 修, 透传 baseline fieldJson)') .option('--parameterJson ', '参数映射 JSON 数组字符串 (BS-drift-DI-2 修, 透传 baseline parameterJson)') .option('--dataConfigJson ', '数据源配置 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 { - // 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 } } | 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 })?.list) || [] existingDIs = list.map((d: any) => ({ fullName: d.fullName, diff --git a/src/commands/dict/_validate.ts b/src/commands/dict/_validate.ts index 8cd8d32..09cc7ba 100644 --- a/src/commands/dict/_validate.ts +++ b/src/commands/dict/_validate.ts @@ -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[] diff --git a/src/commands/form/_ai.ts b/src/commands/form/_ai.ts index edc3387..e6bdc35 100644 --- a/src/commands/form/_ai.ts +++ b/src/commands/form/_ai.ts @@ -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('/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 { } // 场景 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 { } // 场景 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 { } /** - * 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('/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 { @@ -350,16 +334,16 @@ export async function callAiWorkflow(keyword: string): Promise('/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 { diff --git a/src/commands/form/_validate.ts b/src/commands/form/_validate.ts index aa4b495..1b28973 100644 --- a/src/commands/form/_validate.ts +++ b/src/commands/form/_validate.ts @@ -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 diff --git a/src/commands/workflow/create.ts b/src/commands/workflow/create.ts index 4c9efbe..1e0f21d 100644 --- a/src/commands/workflow/create.ts +++ b/src/commands/workflow/create.ts @@ -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 ', 'flowConfig JSON 字符串') .option('--iconBackground ', '图标背景色 (默认 #108ee9)', '#108ee9') .option('--icon ', '流程图标 (默认 icon-ym icon-ym-flow)', 'icon-ym icon-ym-flow') - // v0.21+ BS-drift-W-4 fix: 手动设 sortCode (默认 0) + // 手动设 sortCode (默认 0) .option('--sortCode ', 'sortCode 排序 (默认 0)', '0') .option('--showType ', '显示位置 (0=全局 1=流程 2=菜单, 默认 0)', '0') .option('--startFormId ', '绑定的 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= ... (参考 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= 不存在 → 后端 400 模糊 - // step 0 拦截: 跑 selector 查表, 不存在直接 exit 2 + // (Round 8 P0): workflow --category= 不存在 → 后端 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,