feat(short-drama-agent-front): 完善分镜审核与制作准备流程

This commit is contained in:
GJ committed 2026-10-19 21:59:22 +08:00
1 parent c4b43b9725
commit 1da56e0d46
72 files changed
+2801 -528

No files matched your search

+5 -2
View File
@@ -1,4 +1,4 @@
import { businessErrorMessages, userFacingText } from './user-facing-text'
import { businessErrorMessages, configurationErrorText, userFacingText } from './user-facing-text'
/** HTTP 错误携带状态码与后端细节,供页面区别空数据、校验错误与网络故障。 */
export class ApiError extends Error {
@@ -101,7 +101,10 @@ export async function optionalResource<T>(promise: Promise<T>): Promise<T | null
*/
export function errorMessage(error: unknown): string {
const fallback = '操作失败,请刷新后重试。'
if (error instanceof ApiError)
if (error instanceof ApiError) {
const configurationMessage = configurationErrorText(error.code) ?? configurationErrorText(isRecord(error.details) ? error.details.code : undefined)
if (configurationMessage) return configurationMessage
return [...new Set([userFacingText(error.message, fallback), ...businessErrorMessages(error.details)].filter(Boolean))].join(';') || fallback
}
return error instanceof Error ? userFacingText(error.message, fallback) || fallback : fallback
}
+31
View File
@@ -1,5 +1,23 @@
/** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */
const configurationErrorLabels: Record<string, string> = {
CREATIVE_PROFILE_REQUIRED: '请先保存项目生成配置,再重新检查制作计划。',
CANVAS_CHANGE_REQUIRES_REVALIDATION: '已有分镜,暂时不能直接修改作品画幅。需要先重新核对镜头设计和相关素材,当前配置未保存。',
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, '参考图'],
@@ -33,6 +51,19 @@ const terms: [RegExp, string][] = [
*/
export function userFacingText(value: string | null | undefined, fallback = '暂无可读说明,请查看相关状态。'): string {
let text = value?.trim() ?? ''
const codeLabels: Record<string, string> = {
...configurationErrorLabels,
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_SOURCE_MISMATCH: '镜头与已提交分镜不一致,请刷新后核对。'
}
const code = Object.keys(codeLabels).find(key => text === key || text.startsWith(`${key}:`) || text.startsWith(`${key}:`))
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 '暂时无法连接服务,请检查网络后重试;已提交的任务可能仍在运行。'