Files
short-drama-agent-front/src/lib/user-facing-text.ts
T

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)
}