217 lines
14 KiB
TypeScript
217 lines
14 KiB
TypeScript
/** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */
|
||
const configurationErrorLabels: Record<string, string> = {
|
||
CONTINUITY_REVIEW_REQUIRED: '当前有序组的连续性审核尚未解决,请进入连续性审核核对。',
|
||
CONTINUITY_VISION_PLAN_STALE: '联合审核计划已变化,请重新免费预检并审阅。',
|
||
CONTINUITY_VISION_SOURCE_STALE: '组签收或正式来源已变化,请重新核对原组。',
|
||
CONTINUITY_VISION_PIXELS_CHANGED: '实际图片证据已变化,请重新核对。',
|
||
CONTINUITY_VISION_CAPABILITY_UNVERIFIED: '当前型号或输入尚未核验,暂不能执行联合审核。',
|
||
CONTINUITY_VISION_AUTHORIZATION_REQUIRED: '请先明确登记本次联合审核的费用批准。',
|
||
CONTINUITY_VISION_AUTHORIZATION_INVALID: '本次批准已失效或范围不符,请先核查原任务。',
|
||
CONTINUITY_VISION_AUTHORIZATION_CONSUMED: '本次批准已消费,请查看原任务,勿重复执行。',
|
||
CONTINUITY_VISION_RECOVERY_REQUIRED: '原任务或费用待核查,请只读刷新,不要重发。',
|
||
CONTINUITY_VISION_EXECUTION_CHANGED: '原执行已变化,请刷新核对。',
|
||
CONTINUITY_VISION_EVIDENCE_INVALID: '联合证据需要复核,不能作为通过结论。',
|
||
CONTINUITY_VISION_COVERAGE_INVALID: '联合审核覆盖不完整,请核对原任务。',
|
||
SUBJECT_STATE_REVISION_STALE: '正式视线或来源已变化,请重新读取原值并确认差异。',
|
||
SUBJECT_STATE_REVISION_SCOPE: '此次修改超出视线范围,请从当前正式状态重新填写。',
|
||
SUBJECT_STATE_REVISION_ACTIVE: '此镜头仍有任务进行中,请等待结束后再采用视线修订。',
|
||
SOURCE_REVIEW_STALE: '来源或动作依据已变化,请重新预检并核对观察。',
|
||
SOURCE_REVIEW_INCOMPLETE: '参考观察不完整,请核对每张参考。',
|
||
SOURCE_REVIEW_APPLICABILITY_INVALID: '证据范围不满足条件,请逐项核对动作、主体、机位和依赖。',
|
||
KEYFRAME_VALIDATION_EXECUTION_CONFLICT: '执行关联或历史证据需要核查,请刷新记录后核对。',
|
||
KEYFRAME_VALIDATION_ACTIVE: '已有审核正在进行,请查看当前执行进度。',
|
||
KEYFRAME_VALIDATION_RECOVERY_REQUIRED: '原审核结果或费用待核查,请刷新历史并核对,勿重复提交。',
|
||
KEYFRAME_VALIDATION_AUTHORIZATION_INVALID: '授权无效、已使用或不适用于当前候选,请核对授权编号。',
|
||
KEYFRAME_VALIDATION_LEGACY_TERMINATED: '原审核已人工终止,新审核需要独立授权。',
|
||
CONTINUITY_REVIEW_STALE: '诊断来源已变化,请重新读取证据、核对观察后再保存。',
|
||
CONTINUITY_REVIEW_INVALID: '审核记录证据不完整,不能作为有效结论。',
|
||
IMAGE_INPUT_STALE: '图片或正式来源已变化,请刷新候选并重新核对。',
|
||
CREATIVE_PROFILE_REQUIRED: '请先保存项目生成配置,再重新检查制作计划。',
|
||
CANVAS_CHANGE_REQUIRES_REVALIDATION:
|
||
'已有分镜,暂时不能直接修改作品画幅。需要先重新核对镜头设计和相关素材,当前配置未保存。',
|
||
KEYFRAME_CANVAS_MISMATCH: '所选尺寸与项目交付画幅不符。请在当前模型目录选择与项目画幅一致的尺寸。',
|
||
KEYFRAME_CANVAS_SIZE_UNAVAILABLE: '所选模型或尺寸不能用于当前项目画幅,请选择目录中与画幅一致的固定尺寸。',
|
||
KEYFRAME_SOURCE_STALE: '镜头、正式设计或参考已变化,请刷新候选并重新预览。',
|
||
SCENE_STATE_SOURCE_STALE: '前镜或当前场景状态已变化,请重新核对衔接后预览。',
|
||
CREATIVE_PROFILE_ACTIVE_WORKFLOW: '项目仍有任务进行中,请等待任务结束后再保存生成配置。',
|
||
GENERATION_CONFIG_CHANGE_REQUIRES_REVALIDATION:
|
||
'已有首帧或视频,暂时不能直接修改相关模型或参数。需要先处理现有素材的更新关系,当前配置未保存。'
|
||
}
|
||
|
||
/**
|
||
* 识别项目配置的公开业务码;未知状态仍保留原有错误处理。
|
||
* @param code 原始顶层错误码或详情中的业务码
|
||
* @returns 对应中文操作说明,非配置业务码时返回 null
|
||
*/
|
||
export function configurationErrorText(code: unknown): string | null {
|
||
return typeof code === 'string' ? (configurationErrorLabels[code] ?? null) : null
|
||
}
|
||
|
||
/** 系统说明中允许统一翻译的术语;不处理剧本、提示词正文、文件名或请求字段。 */
|
||
const terms: [RegExp, string][] = [
|
||
[/\bneeds_review\b/g, '需人工核对'],
|
||
[/\binsufficient_evidence\b/g, '证据尚不完整'],
|
||
[/\bblocked\b/g, '存在待处理问题'],
|
||
[
|
||
/由项目 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\s*Style/gi, '视觉风格'],
|
||
[/GenerationSpec/gi, '镜头生成方案'],
|
||
[/generationPrompt/gi, '正式生图提示词'],
|
||
[/VisualState/gi, '画面即时状态'],
|
||
[/\bSubjectRefs?\b/gi, '主体引用'],
|
||
[/\bSubjectForms?\b/gi, '主体形态'],
|
||
[/Identity Anchor/gi, '身份母版'],
|
||
[/Prop Structure Spec|Structure Spec/gi, '道具结构规格'],
|
||
[/Form Prompt/gi, '形态画面描述'],
|
||
[/\bIdentity\b/g, '主体身份'],
|
||
[/\bAnchor\b/g, '身份母版'],
|
||
[/\bProduction\b/g, '制作准备'],
|
||
[/\bProp\b/g, '道具'],
|
||
[/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() ?? ''
|
||
const codeLabels: Record<string, string> = {
|
||
...configurationErrorLabels,
|
||
PROP_STRUCTURE_SPEC_NOT_READY: '道具结构规格尚未就绪,请在形态图片的“图片准备检查”中准备资料后重新预览。',
|
||
SUBJECT_VISUAL_FACTS_STALE: '主体、形态或原文版本已变化,请重新核对。',
|
||
SUBJECT_VISUAL_FACTS_LOCKED: '主体已有图片、身份已锁定或项目任务正在进行,当前无法修订。',
|
||
SUBJECT_VISUAL_FACTS_SOURCE_INVALID: '逐字引文与当前正式原文不匹配。',
|
||
SUBJECT_VISUAL_FACTS_FORM_BINDING: '形态列表已变化,请核对全部正式形态。',
|
||
IMAGE_REQUIRED_REFERENCE_MISSING: '缺少必要参考图,请先准备并确认正式资产。',
|
||
IMAGE_REFERENCE_CAPACITY_EXCEEDED: '必要参考图超出当前模型容量。',
|
||
IMAGE_INPUT_STALE: '图片使用的正式来源已变化。',
|
||
IMAGE_INPUT_SNAPSHOT_INVALID: '图片的实际生成输入记录已失效。',
|
||
SCENE_FORM_VIEW_REFERENCE_INVALID: '当前形态的机位参考不匹配。',
|
||
SCENE_FORM_VIEW_REFERENCE_UNCONFIRMED: '当前形态机位尚未确认。',
|
||
SCENE_FORM_VIEW_REFERENCE_STALE: '机位参考采用的几何版本已过期。',
|
||
DURATION_BUDGET_SOURCE_STALE: '正式剧集预算已变化,请重新核对。',
|
||
DURATION_BUDGET_SOURCE: '缺少可核对的正式预算快照。',
|
||
DURATION_BUDGET: '动作需求与当前时长预算冲突。',
|
||
IMAGE_PREVIEW_STALE: '生成依据或配置已变化,请重新预览并确认后再生成。',
|
||
INVALID_IMAGE_PREVIEW_FINGERPRINT: '预览版本无效,请重新读取生成预览。',
|
||
QUALITY_POLICY_RECONFIRM_REQUIRED: '质量规则或正式分镜来源需要重新核对并确认。',
|
||
QUALITY_POLICY_NOT_CONFIRMED: '请先核对并确认项目质量规则。',
|
||
QUALITY_POLICY_VERSION_CONFLICT: '质量规则已更新,请重新核对后操作。',
|
||
QUALITY_POLICY_SNAPSHOT_UNKNOWN: '分镜缺少可信的质量规则记录,请重新生成拆解候选。',
|
||
QUALITY_POLICY_SNAPSHOT_INVALID: '分镜的质量规则记录不完整,请重新生成拆解候选。',
|
||
QUALITY_POLICY_SNAPSHOT_STALE: '分镜与质量规则版本不一致,请核对最新拆解结果。',
|
||
STORYBOARD_SHOT_SCOPE_INVALID: '所选镜头不属于当前项目或剧集,请刷新目录后重新选择。',
|
||
STORYBOARD_SOURCE_STALE: '正式分镜来源已变化,请重新读取后核对。',
|
||
STORYBOARD_DIRECTION_STALE: '摄影来源已过期,请先核对当前摄影设计。',
|
||
STORYBOARD_SUBJECT_SOURCE_STALE: '主体或形态来源已变化,请重新核对正式绑定。',
|
||
STORYBOARD_DERIVED_STALE: '摄影或画面来源已变化,请重新预检,不能覆盖旧版本。',
|
||
STORYBOARD_DERIVED_REQUEST_UNRESOLVED: '原请求结果尚未核清,请核对原任务和费用,不要重复生成。',
|
||
STORYBOARD_DIRECTION_SCOPE_MISMATCH: '本镜摄影的可见范围与正式绑定冲突,请核对对应段落和镜头。',
|
||
VISUAL_STATE_START_CONFLICT: '开拍状态与已确认的输入事实冲突,请核对对应镜头。',
|
||
VISUAL_STATE_TIME_NEEDS_REVIEW: '开拍与结束时点存在歧义,需要人工核对,尚未通过。',
|
||
VISUAL_STATE_VIDEO_END_UNSUPPORTED: '缺少真实视频末态证据,不能把规划结束状态当作已验证结果。',
|
||
JOINT_REVISION_DRAFT_STALE: '已保存联合草案或修订号已变化,请重新读取并免费预检。',
|
||
JOINT_REVISION_ENVIRONMENT_SOURCE_STALE: '本集原文依据缺失或版本已变化,请保留草案,重新读取原文并人工核对。',
|
||
JOINT_REVISION_NEIGHBOR_STALE: '相邻镜头版本已变化,请重新核对连续性依据。',
|
||
JOINT_REVISION_STALE: '本镜摄影或开拍状态已变化,请保留草案并重新核对。',
|
||
JOINT_REVISION_SCOPE: '联合草案超出允许字段或存在未声明差异,请核对完整修改。',
|
||
JOINT_REVISION_ACTIVE: '本次范围有活动任务,暂不能联合采用。',
|
||
JOINT_REVISION_DOWNSTREAM: '本镜已有下游生产结果或执行记录,请使用原受控修订流程。',
|
||
JOINT_REVISION_HISTORY_INVALID: '联合采用历史无法核对,请保留原稿并检查正式记录。',
|
||
STORYBOARD_SOURCE_MISMATCH: '镜头与已提交分镜不一致,请刷新后核对。'
|
||
}
|
||
const code = Object.keys(codeLabels).find(
|
||
key => text === key || text.startsWith(`${key}:`) || text.startsWith(`${key}:`)
|
||
)
|
||
if (code === 'PROP_STRUCTURE_SPEC_NOT_READY' || code === 'INVALID_IMAGE_PREVIEW_FINGERPRINT')
|
||
return codeLabels[code]!
|
||
if (code === 'DURATION_BUDGET' && /^[::]\s*\{/.test(text.slice(code.length))) return codeLabels[code]!
|
||
if (code)
|
||
text =
|
||
text
|
||
.slice(code.length)
|
||
.replace(/^[::]\s*/, '')
|
||
.trim() || codeLabels[code]!
|
||
|
||
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)
|
||
}
|