67 lines
4.3 KiB
TypeScript
67 lines
4.3 KiB
TypeScript
/** 系统说明中允许统一翻译的术语;不处理剧本、提示词正文、文件名或请求字段。 */
|
|
const terms: [RegExp, string][] = [
|
|
[/由项目 Creative Profile Canvas 决定;单次图片或视频生成不可覆盖。/g, '使用项目配置中的画面比例,单次生成时不能单独更改。'],
|
|
[/业务层必须显式选择,不能依赖 Provider 默认值。/g, '请明确选择是否开启。'],
|
|
[/业务默认关闭/g, '默认关闭'], [/业务参考图/g, '参考图'],
|
|
[/Creative Profile Canvas/gi, '项目画幅设置'],
|
|
[/Prompt\s*扩写模式/gi, '画面描述补充方式'], [/Prompt\s*扩写/gi, '自动补充画面描述'],
|
|
[/Storyboard Shot/gi, '分镜镜头'], [/Primary Keyframe/gi, '首帧'],
|
|
[/\bBreakdown\b/gi, '剧本拆解'], [/\bKeyframe\b/gi, '首帧'],
|
|
[/Creative Profile/gi, '项目生成配置'], [/Visual Style/gi, '视觉风格'],
|
|
[/GenerationSpec/gi, '镜头生成方案'], [/generationPrompt/gi, '正式生图提示词'],
|
|
[/VisualState/gi, '画面即时状态'], [/\bSubjectRefs?\b/gi, '主体引用'],
|
|
[/\bSubjectForms?\b/gi, '主体形态'], [/Identity Anchor/gi, '身份母版'],
|
|
[/Motion Plan/gi, '动作设计'], [/Video Prompt/gi, '视频提示词'],
|
|
[/Negative\s*prompt/gi, '避免出现的内容'], [/Episode Shots?/gi, '单集镜头'],
|
|
[/checkpoints?/gi, '保存记录'], [/Storyboard/gi, '分镜'],
|
|
[/\bDirection\b/gi, '镜头设计'], [/\bVisual Form\b/gi, '视觉形态'],
|
|
[/\bForm\b/g, '形态'], [/\bBeat\b/gi, '剧情段落'], [/\bShot\b/gi, '镜头'],
|
|
[/\bProvider\b/gi, '模型服务'], [/\bPrompt\b/gi, '提示词'],
|
|
[/\bThinking\b/gi, '深度思考'], [/\bLLM\b/g, '文字生成模型'], [/\bVision\b/g, '画面检查'], [/\bJSON\b/gi, '数据格式'],
|
|
[/\bexecutionId\b/g, '任务编号'], [/\bID\b/g, '编号'], [/\bAPI\b/g, '服务'],
|
|
[/\bbackend\b|后端/gi, '系统'], [/\bfrontend\b|前端/gi, '页面'],
|
|
[/\bcompleted\b/g, '已完成'], [/下游资产/g, '后续制作成果'],
|
|
[/后台状态/g, '任务状态'], [/入库/g, '保存'], [/指纹/g, '内容版本'],
|
|
[/^auto$/i, '自动'], [/^direct$/i, '直接增强'], [/^agent$/i, '智能补充']
|
|
]
|
|
|
|
/**
|
|
* 将系统生成的状态、错误与字段说明转为普通用户可读的中文,原始响应不受影响。
|
|
* @param value 系统说明,不能传入用户创作正文或模型品牌名称
|
|
* @param fallback 缺少可读信息时使用的中文说明
|
|
* @returns 页面可展示的说明
|
|
*/
|
|
export function userFacingText(value: string | null | undefined, fallback = '暂无可读说明,请查看相关状态。'): string {
|
|
let text = value?.trim() ?? ''
|
|
if (!text) return ''
|
|
if (/fetch failed|failed to fetch|network error|ECONNREFUSED|ETIMEDOUT/i.test(text))
|
|
return '暂时无法连接服务,请检查网络后重试;已提交的任务可能仍在运行。'
|
|
if (/PrismaClient|TypeError:|ReferenceError:|SyntaxError:|\bat \S+ \([^)]*:\d+:\d+\)|SELECT\s+.+\s+FROM/i.test(text)) return fallback
|
|
for (const [pattern, label] of terms) text = text.replace(pattern, label)
|
|
return /[\u4e00-\u9fff]/.test(text) ? text : fallback
|
|
}
|
|
|
|
/**
|
|
* 只提取错误中的业务说明,不把调试对象、堆栈或内部字段整体展示给用户。
|
|
* @param details 接口保留的原始错误详情
|
|
* @returns 去重后的可读业务原因
|
|
*/
|
|
export function businessErrorMessages(details: unknown): string[] {
|
|
/** 按有限层级遍历,忽略调试信息与原始请求数据。 */
|
|
function collect(value: unknown, depth: number): string[] {
|
|
if (depth > 4) return []
|
|
if (typeof value === 'string') {
|
|
const text = userFacingText(value, '')
|
|
return text ? [text] : []
|
|
}
|
|
if (Array.isArray(value)) return value.slice(0, 8).flatMap(item => collect(item, depth + 1))
|
|
if (!value || typeof value !== 'object') return []
|
|
const record = value as Record<string, unknown>
|
|
const result = ['message', 'reason', 'issues', 'errors', 'formErrors'].flatMap(key => collect(record[key], depth + 1))
|
|
if (record.fieldErrors && typeof record.fieldErrors === 'object')
|
|
result.push(...Object.values(record.fieldErrors).flatMap(item => collect(item, depth + 1)))
|
|
return result
|
|
}
|
|
return [...new Set(collect(details, 0))].slice(0, 6)
|
|
}
|