diff --git a/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/AIRepairService.java b/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/AIRepairService.java index cd8e8b1..f722c00 100644 --- a/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/AIRepairService.java +++ b/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/AIRepairService.java @@ -130,4 +130,25 @@ public interface AIRepairService { * 失败时返回空 Map */ Map buildForm(String formDesc, String appCode, String formsJson, String dictsJson); + + /** + * v0.22+ (2026-07-25 BS-新43 闭环, workflow 旁路 NCPF): 从描述构造完整 workflow schema. + * + * 解决 tdd2/tdd3/workflow --ai 实战痛点 (NCPF 4+3 限制 workflow 版): + * - NCPF 5/5 workflow --ai 都返 trivial 3-node (StartEvent → Task_1 → EndEvent), baseline 4-10 节点全丢 + * - NCPF GEN_FLOW_QUETION 反射读的 prompt 不可控 (jnpf 拼写是 QUETION 不是 QUESTION, 不可改) + * - NCPF 返 URL-encoded flowXml (%3C%3Fxml), dacli 需手动 decode + * - NCPF 输出长度限制 + 静默截断 (code=200 但 flowXml 空) + * + * 此接口直接调 SswLLMClient, prompt 完全可控, 无 NCPF 不可控行为: + * - 强制 ≥4 节点 (基线业务流 4-10 nodes, 解决 trivial 3-node 问题) + * - 强制 BPMN XML 规范 (startEvent → userTask(s) → endEvent, 真实 XML, 不可截断) + * - 跨 app 通用, 跨 tdd2/tdd3/jxcj/workSystem 全部受益 + * + * @param workflowDesc 业务描述 (e.g. "请假流程: 员工提交 → 直属领导审批 → HR 备案") + * @param appCode 应用 code (用于 enCode 前缀, e.g. "tdd3") + * @return WorkFlowAiModel 兼容结构: {enCode, fullName, flowXml, sortCode} + * 失败时返回空 Map + */ + Map buildWorkflow(String workflowDesc, String appCode); } \ No newline at end of file diff --git a/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/impl/AIRepairServiceImpl.java b/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/impl/AIRepairServiceImpl.java index 142e9c9..b654b42 100644 --- a/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/impl/AIRepairServiceImpl.java +++ b/ssw-common/ssw-common-biz/src/main/java/ssw/common/service/impl/AIRepairServiceImpl.java @@ -777,4 +777,176 @@ public class AIRepairServiceImpl implements AIRepairService { } return s; } + + // ============================================================================ + // v0.22+ (2026-07-25 BS-新43 闭环): buildWorkflow 旁路 NCPF + // ============================================================================ + + /** + * BUILD_WORKFLOW_PROMPT: 强制 ≥4 节点 + 真实 BPMN XML + 禁 NCPF 已知问题. + * + * 解决 NCPF /api/workflow/ai 的 4 大不可控问题: + * 1. trivial 3-node: 5/5 workflow --ai 都返 Start→Task_1→End, baseline 4-10 节点全丢 + * 2. URL-encoded flowXml: NCPF 返 %3C%3Fxml, dacli 需手动 decode + * 3. 静默截断: code=200 但 flowXml 空 + * 4. 输出长度限制: NCPF prompt 不可见, 业务流 8+ 节点时常截断 + */ + private static final String BUILD_WORKFLOW_PROMPT = + "你是 JNPF 流程设计助手. 从用户描述生成完整 workflow schema JSON.\n" + + "\n" + + "【输出 JSON 格式】(WorkFlowAiModel 兼容):\n" + + "{\n" + + " \"enCode\": \"camelCase 流程名, 不超过 50 字符, 不含下划线 (BS-56 JNPF 全平台强制)\",\n" + + " \"fullName\": \"流程中文名, 不超过 50 字符\",\n" + + " \"sortCode\": \"数字, 排序, 0-999999\",\n" + + " \"flowXml\": \"完整 BPMN 2.0 XML 字符串 (含 + + 节点 + 流向), 不 URL-encode\"\n" + + "}\n" + + "\n" + + "【禁用规则 (NCPF 已知问题, 必须遵守)】:\n" + + "1. 禁用 trivial 3 节点: 必须 ≥4 节点 (startEvent + ≥1 userTask + ≥1 exclusiveGateway(可选) + endEvent)\n" + + " - 业务流模板: startEvent → userTask(申请) → userTask(审批) → userTask(备案) → endEvent (5 节点, 满足 ≥4 强制)\n" + + " - 简单审批流: startEvent → userTask(申请) → userTask(审批) → endEvent (4 节点, 满足)\n" + + "2. 禁用 URL-encoded flowXml: 必须是真实 XML 字符串, 不 %3C%3Fxml\n" + + "3. 禁用空 flowXml: 必须包含至少 1 个 bpmn:userTask 元素\n" + + "4. 禁用 process id 与流程 enCode 不一致: process id='' (避免 NCPF 后端 ID 不一致)\n" + + "5. 禁用缺 flowable:candidateGroups: 审批节点需要 assignee 或 candidateGroups, 否则流程引擎拒收\n" + + "6. 禁用单线流程 (无分支): 至少 1 个 exclusiveGateway 处理审批结果 (通过/拒绝)\n" + + "\n" + + "【flowXml 最小骨架示例】(4 节点, startEvent + 2 userTask + endEvent):\n" + + "\n" + + "\n" + + " \\\" name=\\\"<流程 fullName>\\\" isExecutable=\\\"true\\\">\n" + + " \n" + + " \n" + + " \n" + + " \n" + + " \n" + + " \n" + + " \n" + + " \n" + + "\n" + + "\n" + + "【节点命名规范】:\n" + + "- 节点 id: <类型>_<动作>, 例 userTask_apply / userTask_approve / exclusiveGateway_pass\n" + + "- 节点 name: 中文, 例 \"员工申请\" / \"经理审批\" / \"HR 备案\"\n" + + "- 流程节点 ≥4 强制 (startEvent + ≥1 userTask + ≥1 决策/审批节点 + endEvent)\n" + + "\n" + + "【输出规则】:\n" + + "- 只返回 JSON, 不带 markdown 包裹, 不带解释\n" + + "- flowXml 必须是合法 BPMN 2.0 XML, 可被 flowable 引擎直接 load\n" + + "- 用户描述若只提 1 个审批环节, 至少加 exclusiveGateway 分支 (通过/拒绝) 凑足 ≥4 节点\n" + + "- 用户描述若完全无业务内容, 仍返回模板骨架 (≥4 节点)"; + + @Override + public Map buildWorkflow(String workflowDesc, String appCode) { + log.info("[AIRepair-buildWorkflow] appCode={}, desc={}", appCode, + workflowDesc == null ? "" : + (workflowDesc.length() > 80 ? workflowDesc.substring(0, 80) + "..." : workflowDesc)); + + if (workflowDesc == null || workflowDesc.trim().isEmpty()) { + log.warn("[AIRepair-buildWorkflow] workflowDesc 为空"); + return new HashMap<>(); + } + + // 1. 调 LLM (maxTokens=3000, SswLLMClient 默认, 防止复杂 BPMN XML 截断) + String userPrompt = String.format("应用: %s\n业务需求: %s", appCode == null ? "(未知)" : appCode, workflowDesc.trim()); + String raw = llmClient.chat(BUILD_WORKFLOW_PROMPT, userPrompt); + if (raw == null || raw.isEmpty()) { + log.warn("[AIRepair-buildWorkflow] LLM 返回空"); + return new HashMap<>(); + } + log.info("[AIRepair-buildWorkflow] LLM raw ({} 字符)", raw.length()); + + // 2. 修复 JSON (LLM 输出常带 markdown fence / 编码字符) + String cleaned = raw.trim() + .replaceAll("```json\\s*", "").replaceAll("```\\s*", "") + .trim(); + // 防 URL-encoded: NCPF 已知问题, 显式 decode + if (cleaned.startsWith("%7B") || cleaned.startsWith("%7b")) { + try { + cleaned = java.net.URLDecoder.decode(cleaned, "UTF-8"); + log.info("[AIRepair-buildWorkflow] 响应 URL-encoded, 已 decode"); + } catch (Exception e) { + log.warn("[AIRepair-buildWorkflow] URL-decode 失败: {}", e.getMessage()); + } + } + + // 3. 解析 JSON + try { + Map parsed = JSON.parseObject(cleaned, new TypeReference>() {}); + if (parsed == null) { + log.warn("[AIRepair-buildWorkflow] 解析后为空"); + return new HashMap<>(); + } + // 必含 flowXml + Object flowXmlRaw = parsed.get("flowXml"); + if (!(flowXmlRaw instanceof String) || ((String) flowXmlRaw).isEmpty()) { + log.warn("[AIRepair-buildWorkflow] flowXml 缺失或空"); + return new HashMap<>(); + } + String flowXml = (String) flowXmlRaw; + // 防 URL-encoded flowXml + if (flowXml.startsWith("%3C") || flowXml.startsWith("%3c")) { + try { + flowXml = java.net.URLDecoder.decode(flowXml, "UTF-8"); + log.info("[AIRepair-buildWorkflow] flowXml URL-encoded, 已 decode"); + } catch (Exception e) { + log.warn("[AIRepair-buildWorkflow] flowXml URL-decode 失败: {}", e.getMessage()); + } + parsed.put("flowXml", flowXml); + } + // 强制 process id 与 enCode 一致 (NCPF 已知问题) + String enCode = (String) parsed.getOrDefault("enCode", "aiWorkflow"); + enCode = normalizeEnCodeWorkflow(enCode); + if (isKeyword(enCode)) enCode = enCode + "X"; + parsed.put("enCode", enCode); + parsed.put("fullName", (String) parsed.getOrDefault("fullName", "AI 流程")); + // sortCode 默认 0 + if (!parsed.containsKey("sortCode")) { + parsed.put("sortCode", 0); + } + // 简易节点数检查 + int userTaskCount = (flowXml.split("userTask", -1).length - 1); + int nodeCount = (flowXml.split(" parsed = JSON.parseObject(repaired, new TypeReference>() {}); + if (parsed != null && parsed.get("flowXml") instanceof String) { + log.info("[AIRepair-buildWorkflow] JsonRepairUtil 兜底成功"); + return parsed; + } + } + } catch (Exception e2) { + log.warn("[AIRepair-buildWorkflow] JsonRepairUtil 兜底也失败: {}", e2.getMessage()); + } + return new HashMap<>(); + } + } + + /** + * 标准化 workflow enCode (跟 buildForm 同 pattern, 单独函数避免 enCode 默认值冲突) + */ + private String normalizeEnCodeWorkflow(String enCode) { + if (enCode == null || enCode.isEmpty()) return "aiWorkflow"; + String s = enCode.replaceAll("[_\\-\\s]", ""); + if (s.length() > 50) s = s.substring(0, 50); + if (!s.isEmpty() && Character.isUpperCase(s.charAt(0))) { + s = Character.toLowerCase(s.charAt(0)) + s.substring(1); + } + return s; + } } diff --git a/ssw-common/ssw-common-controller/src/main/java/ssw/common/controller/SswAIRepairController.java b/ssw-common/ssw-common-controller/src/main/java/ssw/common/controller/SswAIRepairController.java index 7acf5da..bbc59a7 100644 --- a/ssw-common/ssw-common-controller/src/main/java/ssw/common/controller/SswAIRepairController.java +++ b/ssw-common/ssw-common-controller/src/main/java/ssw/common/controller/SswAIRepairController.java @@ -229,4 +229,40 @@ public class SswAIRepairController { return ActionResult.fail("buildForm 异常: " + e.getMessage()); } } + + /** + * v0.22+ (2026-07-25 BS-新43 闭环): 旁路 NCPF /api/workflow/ai 直接构造 workflow schema. + * + * 替代 dacli 调 jnpf /api/workflow/ai (NCPF 不可控: 5/5 trivial 3-node + URL-encoded flowXml + 静默截断 + 输出长度限制). + * 直调 ssw-common SswLLMClient (同一 base_ai LLM, prompt 我们写, 强制 ≥4 节点). + * + * 入参: + * - workflowDesc: 业务描述 (中文自然语言, e.g. "请假流程: 员工提交 → 经理审批 → HR 备案") + * - appCode: 应用 code (用于字段命名规范, e.g. "tdd3") + * + * 响应: WorkFlowAiModel 兼容结构 {enCode, fullName, flowXml, sortCode} + * - 与 jnpf /api/workflow/ai 输出格式一致, dacli 端无感切换 + * - flowXml 是真实 BPMN 2.0 XML (不可 URL-encoded) + * - 内部 prompt 强制 ≥4 节点 (startEvent + ≥1 userTask + ≥1 决策/审批 + endEvent) + */ + @PostMapping("/build-workflow") + @Operation(summary = "从描述构造完整 workflow schema (旁路 NCPF, BS-新43 闭环)", + description = "直调 SSW SswLLMClient, prompt 禁用 NCPF 已知问题 (trivial 3-node / URL-encoded flowXml / 静默截断 / 输出长度限制). 强制 ≥4 节点 BPMN XML. 输出 WorkFlowAiModel 兼容结构, dacli 端无感切换.") + public ActionResult> buildWorkflow(@RequestBody Map body) { + String workflowDesc = (String) body.get("workflowDesc"); + String appCode = (String) body.get("appCode"); + if (workflowDesc == null || workflowDesc.trim().isEmpty()) { + return ActionResult.fail("workflowDesc 必填"); + } + try { + Map result = aiRepairService.buildWorkflow(workflowDesc, appCode); + if (result.isEmpty() || !result.containsKey("flowXml")) { + return ActionResult.fail("buildWorkflow 返回空 (LLM 不可用或 prompt 解析失败)"); + } + return ActionResult.success(result); + } catch (Exception e) { + log.error("SswAIRepairController.buildWorkflow 异常", e); + return ActionResult.fail("buildWorkflow 异常: " + e.getMessage()); + } + } } \ No newline at end of file