export type ImageErrorCode = | "missing_config" | "invalid_base_url" | "auth_failed" | "forbidden" | "not_found" | "rate_limited" | "server_error" | "timeout" | "network_error" | "invalid_request" | "invalid_json" | "invalid_image" | "unsupported_format" | "model_unavailable" | "capability_unknown" | "response_too_large" | "request_too_large" | "download_too_large" | "unsupported_provider"; export class ImageGenError extends Error { constructor( public readonly code: ImageErrorCode, message: string, public readonly suggestion: string, public readonly status?: number, ) { super(message); this.name = "ImageGenError"; } toUserMessage(): string { const status = this.status ? `HTTP ${this.status}。` : ""; return `${this.message}\n原因:${status}${reasonForCode(this.code)}\n解决办法:${this.suggestion}`; } } export function sanitizeSecret(text: string, apiKey?: string): string { let out = text; if (apiKey) out = out.split(apiKey).join(maskApiKey(apiKey)); out = out.replace(/Bearer\s+[A-Za-z0-9._\-]+/g, "Bearer ****"); out = out.replace(/sk-[A-Za-z0-9._\-]{8,}/g, (m) => maskApiKey(m)); return out; } export function maskApiKey(key: string): string { if (!key) return "未配置"; if (key.length <= 8) return "****"; return `${key.slice(0, 3)}-****${key.slice(-4)}`; } export function errorFromStatus(status: number, action: string, detail?: string): ImageGenError { switch (status) { case 401: return new ImageGenError("auth_failed", `${action}失败:认证失败。`, "检查 IMAGE_API_KEY 是否正确、是否过期。", status); case 403: return new ImageGenError("forbidden", `${action}失败:权限不足。`, "确认 API Key 有访问模型和图片接口的权限。", status); case 404: return new ImageGenError("not_found", `${action}失败:接口不存在。`, "确认 IMAGE_BASE_URL 是否包含正确版本路径,例如 https://host/v1。", status); case 408: return new ImageGenError("timeout", `${action}失败:请求超时。`, "稍后重试,或增大 IMAGE_TIMEOUT_SECONDS。", status); case 409: return new ImageGenError("model_unavailable", `${action}失败:请求冲突或模型不可用。`, "尝试换模型,或检查服务商状态。", status); case 413: return new ImageGenError("request_too_large", `${action}失败:请求体过大。`, "降低图片尺寸、减少 n,或使用更小的输入图片。", status); case 429: return new ImageGenError("rate_limited", `${action}失败:触发限流。`, "稍后重试,或检查额度/并发限制。", status); case 500: case 502: case 503: return new ImageGenError("server_error", `${action}失败:服务端错误。`, "稍后重试;若持续失败请联系 API 服务商。", status); default: return new ImageGenError(status >= 500 ? "server_error" : status >= 400 ? "invalid_request" : "network_error", `${action}失败:HTTP ${status}${detail ? `:${detail}` : "。"}`, status >= 400 && status < 500 ? "检查模型名称、图片尺寸、响应格式和服务商文档。" : "检查网络连接和服务商状态。", status); } } function reasonForCode(code: ImageErrorCode): string { const map: Record = { missing_config: "缺少必要配置。", invalid_base_url: "Base URL 格式不正确或不是 http/https。", auth_failed: "API Key 无效或未授权。", forbidden: "当前凭证没有访问权限。", not_found: "目标 API 路径不存在。", rate_limited: "请求过快或额度不足。", server_error: "API 服务端返回错误。", timeout: "网络请求超过超时时间。", network_error: "网络连接失败或响应异常。", invalid_request: "请求已到达 API,但参数或模型不符合服务商要求。", invalid_json: "API 返回的 JSON 无法解析。", invalid_image: "图片内容为空或不是有效图片。", unsupported_format: "仅支持 png、jpg、jpeg、webp。", model_unavailable: "模型不存在、不可用或不支持该操作。", capability_unknown: "无法自动确认模型能力。", response_too_large: "响应超过安全大小限制。", request_too_large: "请求体超过服务商限制。", download_too_large: "下载图片超过大小限制。", unsupported_provider: "暂不支持该 Provider 类型。", }; return map[code]; }