feat:增加重试

Author: Smoke Tester

requirements/done/错误重试.md

@@ -0,0 +1,6 @@
+整体要求是如果出错了,不应该轻易打断工作循环,而是应该积极重试.
+<!-- 1. 新的打破循环的报错
+Error: Empty or insufficient response detected: "" -->
+2.
+Error: OpenAI Responses API error: 403 Forbidden
+也要重试

requirements/pending/错误重试.md

@@ -637,9 +637,53 @@ export async function* createStreamingResponse(
 
 			if (!response.ok) {
 				const errorText = await response.text();
-				throw new Error(
-					`OpenAI Responses API error: ${response.status} ${response.statusText} - ${errorText}`,
-				);
+				const baseErrorMsg = `OpenAI Responses API error: ${response.status} ${response.statusText} - ${errorText}`;
+
+				const error = new Error(baseErrorMsg) as Error & {
+					code?: string;
+					isRetryable?: boolean;
+				};
+
+				if (response.status === 403) {
+					const lower = errorText.toLowerCase();
+					const likelyPersistent =
+						lower.includes('insufficient_quota') ||
+						lower.includes('quota') ||
+						lower.includes('billing') ||
+						lower.includes('invalid api key') ||
+						lower.includes('api key') ||
+						lower.includes('permission') ||
+						lower.includes('organization') ||
+						lower.includes('not allowed');
+
+					error.isRetryable = true;
+					error.code = likelyPersistent
+						? 'HTTP_403_FORBIDDEN_PERSISTENT'
+						: 'HTTP_403_FORBIDDEN_TRANSIENT';
+
+					const hint = likelyPersistent
+						? 'Hint: This 403 likely indicates auth/quota/permission. Retrying may not help, but Snow CLI will retry up to the configured limit.'
+						: 'Hint: This 403 may be transient when using a third-party relay/WAF. Snow CLI will retry with backoff.';
+					error.message = `${baseErrorMsg}\n${hint}`;
+
+					try {
+						const {logger} = await import('../utils/core/logger.js');
+						logger.warn(
+							`[API_ERROR] OpenAI Responses API HTTP 403 (${error.code}), will retry with backoff`,
+							{
+								url,
+								model: requestPayload.model,
+								code: error.code,
+								status: response.status,
+								statusText: response.statusText,
+							},
+						);
+					} catch {
+						// ignore logging errors
+					}
+				}
+
+				throw error;
 			}
 
 			if (!response.body) {

source/api/responses.ts

@@ -177,6 +177,8 @@ export async function handleConversationWithTools(
 			message.includes('502') ||
 			message.includes('503') ||
 			message.includes('504') ||
+			message.includes('403') ||
+			message.includes('forbidden') ||
 			message.includes('fetch failed') ||
 			message.includes('fetcherror') ||
 			getIsEmptyResponseError(error)

source/hooks/conversation/useConversation.ts

@@ -53,6 +53,11 @@ function isRetriableError(error: Error): boolean {
 		return true;
 	}
 
+	// 优先支持统一错误分类字段,避免上层只能依赖 message 关键字
+	if ((error as any)?.isRetryable === true) {
+		return true;
+	}
+
 	const errorMessage = error.message.toLowerCase();
 
 	// 网络错误
@@ -75,8 +80,13 @@ function isRetriableError(error: Error): boolean {
 		return true;
 	}
 
+	// Forbidden errors (403). 通过第三方中转时可能是瞬时风控/权限抖动,允许在上限内重试
+	if (errorMessage.includes('403') && errorMessage.includes('forbidden')) {
+		return true;
+	}
+
 	// Server errors (5xx - temporary server issues, retryable)
-	// Note: 400, 403, 405 are client errors - typically not retryable
+	// Note: 400, 405 are client errors - typically not retryable
 	// as they indicate request format issues that won't change on retry
 	if (
 		errorMessage.includes('500') ||