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:
sswandClaude committed 2026-07-02 00:57:01 +08:00
1 parent 29635025dd
commit ee6257d411
1 file changed
+55 -16
+55 -16
View File
@@ -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> {