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

217 lines
14 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */
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)
}