form/_ai.ts: BS-新30 v0.14+ --ai 失败时 fallback SSW AI 修复
callAiForm 加 SSW 修复层 fallback: - 场景 A: jnpf 后端错误 (SYS181 / JSON 解析失败) → SSW 修复 - 场景 B: jnpf 后端静默截断 (code=200 但 data 空) → SSW 修复 SSW 端点 (boot/ssw-common-controller/SswAIRepairController): - POST /api/ssw/ai/repair - 绕开 jnpf SendAiMessage, SswLLMClient 用 maxTokens=3000 直调 MiniMax API - JsonRepairUtil 修复 fieldOptions 字符串数组 / 注释行 / JSON 截断 / 文字说明混合 - 不动 jnpf 源码 (CLAUDE.md §14 兼容) 警告语也更新: 把"为什么不直接改 maxTokens"改成"SSW 修复层说明" + fallback 流程。 测试: 26 字段用户管理表 --ai prompt, jnpf 后端返回空 → SSW fallback 修复 → 26 字段全部生成 + fieldOptions 自动转换。 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
29635025dd
commit
ee6257d411
1 file changed
+55
-16
+55
-16
@@ -117,47 +117,86 @@ function buildAiTruncationHint(keyword: string): string {
|
||||
• 11-15 字段 → 警告 (输出 1200-1500 token, 可能截断)
|
||||
• > 15 字段 → 必拆 (输出 > 1500 token 必截断)
|
||||
|
||||
为什么不直接改 maxTokens?
|
||||
为什么不直接改 jnpf?
|
||||
• jnpf-common-ai/SendAiMessage.java:148 new AiSendModel() 硬编码 maxTokens=1500
|
||||
• SendAiMessage 是 static 方法, 不读 yml 的 spring.cloud.ai.openai.chat.maxTokens
|
||||
• base_ai 表也没 maxTokens 字段 (JNPF 平台限制)
|
||||
• 改 jnpf 源码违反 CLAUDE.md (jnpf/ 是只读备份)`
|
||||
• 改 jnpf 源码违反 CLAUDE.md (jnpf/ 是只读备份)
|
||||
|
||||
SSW 修复层 (boot/ssw-common/) 已自动 fallback:
|
||||
• 调用 POST /api/ssw/ai/repair (SswAIRepairController)
|
||||
• SswLLMClient 用 maxTokens=3000 直调 MiniMax API
|
||||
• JsonRepairUtil 修复 fieldOptions 字符串数组 / 注释行 / JSON 截断 / 文字说明混合
|
||||
• 如果 SSW 也失败, 才需要手动拆 prompt`
|
||||
}
|
||||
|
||||
/** 5.10.1 — AI 快速建表 (v0.13+: 只走 NCPF backend, 不再"直连 LLM")
|
||||
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form */
|
||||
/** 5.10.1 — AI 快速建表 (v0.14+: NCPF backend + SSW 修复 fallback)
|
||||
*
|
||||
* 流程:
|
||||
* 1. 先 POST /api/visualdev/ai/form (jnpf 后端, 原始路径)
|
||||
* 2. 如果后端返回 code!=200 或 data 空 → fallback 到 SSW AI 修复
|
||||
* 3. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
|
||||
*
|
||||
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
|
||||
* + ssw-common SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
|
||||
*/
|
||||
export async function callAiForm(keyword: string): Promise<AiFormResponse> {
|
||||
const c = await JnpfClient.fromToken()
|
||||
log.info(`[NCPF backend] POST /visualdev/ai/form keyword="${keyword.slice(0, 50)}${keyword.length > 50 ? '...' : ''}"`)
|
||||
const r = await c.postJson<AiFormResponse>('/visualdev/ai/form', { keyword })
|
||||
|
||||
// v0.14+ BS-新30: 后端错误 (SYS181 / JSON 解析失败) → 警告 + 拆分建议
|
||||
// 场景 A: 后端错误 (SYS181 / JSON 解析失败) → fallback SSW
|
||||
if (r.code !== 200) {
|
||||
const m = (r.msg || '').toLowerCase()
|
||||
const isTruncationErr = ['sys181', 'json', '转换失败', '响应缺', 'parse'].some(s => m.includes(s))
|
||||
if (isTruncationErr) {
|
||||
log.warn(`! AI 建表失败 (code=${r.code}): ${r.msg}`)
|
||||
log.warn(buildAiTruncationHint(keyword))
|
||||
} else {
|
||||
throw new Error(`AI 建表失败 (code=${r.code}): ${r.msg}`)
|
||||
log.warn(`! jnpf 后端 AI 建表失败 (code=${r.code}): ${r.msg} → fallback SSW 修复`)
|
||||
return await callSswAiRepair(keyword, 'jnpf 后端错误')
|
||||
}
|
||||
return r.data || {}
|
||||
throw new Error(`AI 建表失败 (code=${r.code}): ${r.msg}`)
|
||||
}
|
||||
|
||||
// v0.14+ BS-新30: 静默截断 (code=200 但 data 空) → 警告 + 拆分建议
|
||||
// 触发条件: 描述字段数 > 10 + 返回空 enCode/fullName/aiModelList
|
||||
// 场景 B: 静默截断 (code=200 但 data 空) → fallback SSW
|
||||
const data = r.data || {}
|
||||
const isEmpty = !data.enCode && !data.fullName && (!data.aiModelList || data.aiModelList.length === 0)
|
||||
const fieldCount = estimateFieldCount(keyword)
|
||||
if (isEmpty && fieldCount > 10) {
|
||||
log.warn(`! AI 响应为空(后端 code=200 但 data.enCode/fullName/aiModelList 都为空)`)
|
||||
log.warn(`! 检测到 --ai 描述约 ${fieldCount} 个字段,几乎肯定是 LLM 输出 JSON 被 max_tokens=1500 强制截断`)
|
||||
log.warn(buildAiTruncationHint(keyword))
|
||||
if (isEmpty) {
|
||||
log.warn(`! jnpf 后端 AI 响应为空 → fallback SSW 修复 (字段数: ${fieldCount})`)
|
||||
return await callSswAiRepair(keyword, 'jnpf 后端静默截断')
|
||||
}
|
||||
|
||||
return data
|
||||
}
|
||||
|
||||
/**
|
||||
* SSW AI 修复 fallback
|
||||
*
|
||||
* 端点: POST /api/ssw/ai/repair
|
||||
* 来源: ssw-common-controller/SswAIRepairController
|
||||
* 逻辑: SSW 端点直接调 LLM (maxTokens=3000) + 修复 fieldOptions / 注释 / 截断 / 文字说明混合
|
||||
*
|
||||
* @param keyword --ai 描述
|
||||
* @param reason fallback 原因 (用于日志)
|
||||
* @returns VisualAiModel 兼容结构; 失败时返回空对象
|
||||
*/
|
||||
async function callSswAiRepair(keyword: string, reason: string): Promise<AiFormResponse> {
|
||||
const c = await JnpfClient.fromToken()
|
||||
log.info(`[SSW fallback] POST /ssw/ai/repair reason="${reason}"`)
|
||||
try {
|
||||
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}`)
|
||||
return r.data
|
||||
}
|
||||
log.warn(`! SSW 修复失败 (code=${r.code}): ${r.msg}`)
|
||||
} catch (e) {
|
||||
log.warn(`! SSW 修复异常: ${(e as Error).message}`)
|
||||
}
|
||||
// SSW 也失败, 给用户警告
|
||||
log.warn(buildAiTruncationHint(keyword))
|
||||
return {}
|
||||
}
|
||||
|
||||
/** 5.10.3 — AI 创建流程 (v0.13+: 只走 NCPF backend)
|
||||
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai */
|
||||
export async function callAiWorkflow(keyword: string): Promise<AiWorkflowResponse> {
|
||||
|
||||
Reference in new issue
Block a user