/** 用户可操作的图片授权及视频费用审计错误,保留原码用于业务判断。 */ const messages: Record = { IMAGE_BOUNDED_AUTHORIZATION_INVALID: '有限许可已失效、用尽,或镜头来源与原预算已变化,请刷新后重新核对。', IMAGE_AUTHORIZATION_PLAN_STALE: '当前来源或精确费用计划已变化,原批准草稿保留,请重新免费预检。', IMAGE_ADDITIONAL_AUTHORIZATION_INVALID: '人工追加许可无效、已撤销、用尽,或原精确计划与预算已变化,请重新核对。', IMAGE_BILLING_AUDIT_CONFLICT: '原图片请求或批准版本冲突,请重新读取审计。', IMAGE_BILLING_AUDIT_IDENTITY_MISMATCH: '材料与原图片请求身份不匹配,或供应方编号已归属其它请求。', IMAGE_BILLING_AUDIT_STALE: '原请求或完整证据集合已变化,请重新核对并确认。', IMAGE_BILLING_AUDIT_REVIEW_CONFLICT: '另一项图片费用复核已先完成,请刷新后重新核对。', IMAGE_BILLING_AUDIT_RELEASE_REJECTED: '尚不具备费用核清条件,请核对原执行、真实账单及唯一关联。', IMAGE_BILLING_AUDIT_EVIDENCE_INVALID: '图片审计历史或摘要无法核实,费用继续阻断。', IMAGE_AUTHORIZATION_REQUIRED: '当前模型或范围没有有效图片授权,授权可能已到期或撤销。请核对项目生成设置。', IMAGE_AUTHORIZATION_EXPIRED: '到期时间已过,请重新填写未来时间。', IMAGE_AUTHORIZATION_BUDGET_EXCEEDED: '图片授权剩余预算不足整次预留,或请求次数已用尽。', IMAGE_AUTHORIZATION_CONFLICT: '本次批准与原授权内容冲突。请核对原记录,保留原批准凭据。', IMAGE_AUTHORIZATION_SCOPE_MISMATCH: '授权目标与当前项目或范围不匹配,请核对所选目标。', IMAGE_AUTHORIZATION_MODEL_UNAVAILABLE: 'OpenAI 图片型号当前不可用或与授权不匹配,请核对型号配置。', IMAGE_REQUEST_UNRESOLVED: '原图片请求在途或费用未核清,已禁止新增收费与重试。请先查看原请求。', IMAGE_PROVIDER_AUTHORIZATION_REQUIRED: '此图片供应方需要单独确认,不能使用 OpenAI 授权。', IMAGE_PROVIDER_CONFIRMATION_REQUIRED: '备用图片供应方需要单独确认。请主动选择供应方,重新预览并确认本次费用。', VIDEO_AUDIT_NOT_ELIGIBLE: '此任务不支持费用审计,仅支持原受控视频质检任务。', VIDEO_AUDIT_CONFLICT: '原任务、执行记录或费用批准发生冲突,请刷新后核对原件。', VIDEO_AUDIT_STALE: '原任务或证据集合已变化。已刷新,请重新核对资料和版本后主动提交。', VIDEO_AUDIT_REVIEW_CONFLICT: '另一项人工复核已先完成。已刷新,请重新核对后主动提交。', VIDEO_AUDIT_BINDING_INCOMPLETE: '原请求记录不完整,暂时无法关联审计,请核对原始材料。', VIDEO_AUDIT_IDENTITY_MISMATCH: '证据与原请求身份不一致,或供应方请求已归属另一任务,请核对原件。', VIDEO_AUDIT_RELEASE_REJECTED: '尚未满足费用核清条件,请核对执行原件、账单和唯一关联。', VIDEO_AUDIT_EVIDENCE_INVALID: '原审计记录或摘要无法确认,费用继续阻断,请核对原件。' } /** OpenAI 失败类型分别展示,限流不表示余额耗尽。 */ const failureMessages: Record = { billing_quota_exceeded: 'OpenAI 返回计费配额不足,请核对原供应方错误及账户配额。', rate_limited: 'OpenAI 请求被限流,请先核对原请求结果和费用。', unsupported_request: 'OpenAI 不支持本次模型或参数,请核对原请求。', network_error: '图片请求连接中断,结果和费用待核对,禁止自动重发。', timeout_unknown: '图片请求超时,结果和费用未知,禁止重试。', receipt_unknown: '图片回执无法确认,费用未知,禁止重试。', provider_error: '图片供应方返回错误,请核对原请求和费用。' } /** * 将费用业务码和原失败类型转换成中文,不改写原始数据。 * @param code 原业务码 * @param details 原结构化原因 * @returns 可操作说明或空值 */ export function billingErrorText(code: string | undefined, details: unknown): string | undefined { const outer = details && typeof details === 'object' ? (details as Record) : {} const nested = outer.details && typeof outer.details === 'object' ? (outer.details as Record) : {} const record = { ...outer, ...nested } const actualCode = code ?? (typeof record.code === 'string' ? record.code : undefined) if (actualCode && messages[actualCode]) return messages[actualCode] if (actualCode?.startsWith('OPENAI_IMAGE_')) { const cause = record.causeCode === 'UND_ERR_CONNECT_TIMEOUT' ? '底层连接超时' : record.causeCode === 'ECONNREFUSED' ? '底层连接被拒绝' : record.causeCode === 'ETIMEDOUT' ? '底层请求超时' : '' const transport = record.transportMode === 'proxy' ? '应用通过代理连接' : record.transportMode === 'direct' ? '应用直接连接' : '' return [ failureMessages[String(record.failureType)] ?? '图片请求结果或费用尚未核实,请查看原请求,禁止自动重发。', ...(['network_error', 'timeout_unknown', 'receipt_unknown'].includes(String(record.failureType)) ? [transport, cause] : []) ] .filter(Boolean) .join(';') } return undefined }