feat(short-drama-agent-front): 完善质量规则确认与中文交互
This commit is contained in:
1 parent
190333d4f9
commit
c4b43b9725
85 files changed
+2059
-480
No files matched your search
+1
-1
@@ -1,4 +1,4 @@
|
||||
/** 只允许 HTTP(S) 与后端 /storage 路径;生产环境绝对 API 地址使用其源站。 */
|
||||
/** 只允许 HTTP(S) 与后端 /storage 路径;生产环境绝对 服务地址使用其源站。 */
|
||||
export function mediaAssetUrl(value: string): string | null {
|
||||
const raw = value.trim()
|
||||
try {
|
||||
|
||||
@@ -38,7 +38,7 @@ export function sizeRules(values: () => { width: unknown; height: unknown }) {
|
||||
|
||||
export const imageUrlRule = fieldRule(
|
||||
value => typeof value === 'string' && !!referenceImageUrl(value),
|
||||
'请填写有效的 HTTP(S) 或 /storage/ 图片地址',
|
||||
'请填写可访问的图片链接或已上传图片的地址',
|
||||
true
|
||||
)
|
||||
|
||||
@@ -49,4 +49,4 @@ export const stringArrayJsonRule = fieldRule(value => {
|
||||
} catch {
|
||||
return false
|
||||
}
|
||||
}, '请输入 JSON 字符串数组,例如 ["真人写实", "禁止二次元"]')
|
||||
}, '请按示例填写文字列表,例如 ["真人写实", "禁止二次元"]')
|
||||
+22
-2
@@ -1,4 +1,5 @@
|
||||
import type { ProjectStatus } from '../features/projects/types'
|
||||
import { userFacingText } from './user-facing-text'
|
||||
|
||||
/** 原始项目状态的中文名称。 */
|
||||
export const statusLabels: Record<ProjectStatus, string> = {
|
||||
@@ -24,7 +25,11 @@ export function formatDate(value?: string): string {
|
||||
}).format(date)
|
||||
}
|
||||
|
||||
/** 节点中文名称;未知新节点仍显示原名,方便后端扩展。 */
|
||||
/**
|
||||
* 展示制作步骤的中文名称,未知步骤不直接显示内部标识。
|
||||
* @param name 原始步骤标识
|
||||
* @returns 页面可读的制作步骤名称
|
||||
*/
|
||||
export function nodeLabel(name?: string): string {
|
||||
const labels: Record<string, string> = {
|
||||
createProject: '创建项目',
|
||||
@@ -58,7 +63,22 @@ export function nodeLabel(name?: string): string {
|
||||
partial_failed: '部分抽取失败',
|
||||
finalize: '结果入库'
|
||||
}
|
||||
return name ? (labels[name] ?? name) : '状态记录'
|
||||
return name ? (labels[name] ?? userFacingText(name, '其他制作步骤')) : '状态记录'
|
||||
}
|
||||
|
||||
/**
|
||||
* 制作任务名称用于筛选与历史记录,不改变接口中的流程标识。
|
||||
* @param name 原始流程标识
|
||||
* @returns 中文流程名称
|
||||
*/
|
||||
export function workflowLabel(name?: string): string {
|
||||
const labels: Record<string, string> = {
|
||||
'create-drama': '剧本创作', breakdown: '剧本拆解', 'visual-style': '视觉风格',
|
||||
'subject-identity': '主体身份', 'subject-images': '形态图片', storyboard: '分镜设计', production: '镜头制作',
|
||||
'storyboard-direction': '镜头设计', 'storyboard-visual-state': '画面状态', 'video-prompt': '视频描述',
|
||||
'keyframe-generation': '首帧生成', 'keyframe-quality': '首帧检查', 'video-quality': '视频检查'
|
||||
}
|
||||
return name ? labels[name] ?? userFacingText(name, '其他制作任务') : '未标注制作任务'
|
||||
}
|
||||
|
||||
/** 下载纯文本或 JSON,不将模型内容作为 HTML 渲染。 */
|
||||
|
||||
+13
-8
@@ -1,3 +1,5 @@
|
||||
import { businessErrorMessages, userFacingText } from './user-facing-text'
|
||||
|
||||
/** HTTP 错误携带状态码与后端细节,供页面区别空数据、校验错误与网络故障。 */
|
||||
export class ApiError extends Error {
|
||||
constructor(
|
||||
@@ -57,7 +59,7 @@ export async function request<T>(path: string, options: RequestOptions = {}): Pr
|
||||
try {
|
||||
data = text ? JSON.parse(text) : undefined
|
||||
} catch {
|
||||
throw new ApiError('接口未返回 JSON,请检查 API 地址与代理配置。', response.status)
|
||||
throw new ApiError('服务暂时无法返回有效结果,请稍后重试。', response.status)
|
||||
}
|
||||
if (!response.ok) {
|
||||
const message =
|
||||
@@ -75,7 +77,7 @@ export async function request<T>(path: string, options: RequestOptions = {}): Pr
|
||||
if (options.signal?.aborted) throw error
|
||||
if (controller.signal.aborted)
|
||||
throw new ApiError('请求等待超时。后台任务可能仍在运行,请先刷新状态,不要重复提交。', 0)
|
||||
throw new ApiError('无法连接后端。请检查服务与代理;已提交的任务可能仍在运行。', 0)
|
||||
throw new ApiError('暂时无法连接服务,请检查网络后重试;已提交的任务可能仍在运行。', 0)
|
||||
} finally {
|
||||
clearTimeout(timer)
|
||||
options.signal?.removeEventListener('abort', abort)
|
||||
@@ -92,11 +94,14 @@ export async function optionalResource<T>(promise: Promise<T>): Promise<T | null
|
||||
}
|
||||
}
|
||||
|
||||
/** 页面统一显示可操作的错误信息。 */
|
||||
/**
|
||||
* 页面统一显示业务原因,原始错误与详情仍保留供程序判断和导出。
|
||||
* @param error 原始请求或操作错误
|
||||
* @returns 普通用户可理解的原因和处理建议
|
||||
*/
|
||||
export function errorMessage(error: unknown): string {
|
||||
if (error instanceof ApiError && error.details) {
|
||||
const details = typeof error.details === 'string' ? error.details : JSON.stringify(error.details)
|
||||
return `${error.message} ${details}`
|
||||
}
|
||||
return error instanceof Error ? error.message : '操作失败,请刷新后重试。'
|
||||
const fallback = '操作失败,请刷新后重试。'
|
||||
if (error instanceof ApiError)
|
||||
return [...new Set([userFacingText(error.message, fallback), ...businessErrorMessages(error.details)].filter(Boolean))].join(';') || fallback
|
||||
return error instanceof Error ? userFacingText(error.message, fallback) || fallback : fallback
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
/** 系统说明中允许统一翻译的术语;不处理剧本、提示词正文、文件名或请求字段。 */
|
||||
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)
|
||||
}
|
||||
Reference in new issue
Block a user