/** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */ const configurationErrorLabels: Record = { 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 = { ...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 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) }