@blueking/chat-helper 0.0.12-beta.1 → 0.0.12-beta.11

package/dist/event/ag-ui.ts.js

@@ -37,7 +37,7 @@
 }
 import { transferMessageApi2Message } from '../http/transform/index.ts.js';
 import { ActivityType, MessageRole, MessageStatus, MessageType } from '../message/index.ts.js';
-import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
+import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } from './type.ts.js';
 /**
  * AGUI 协议
  * @param message - 消息模块
@@ -49,7 +49,15 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
     /**
    * 处理活动快照事件
    * 记录活动的完整状态
-   */ handleActivitySnapshotEvent(_event) {}
+   */ handleActivitySnapshotEvent(event) {
+        const message = this.messageModule.getCurrentLoadingMessage();
+        if (event.activityType === ActivityType.Interrupt) {
+            if ((message === null || message === void 0 ? void 0 : message.role) === MessageRole.Interrupt) {
+                message.content = event.content;
+                message.status = MessageStatus.Complete;
+            }
+        }
+    }
     /**
    * 处理自定义事件
    */ handleCustomEvent(event) {
@@ -63,6 +71,9 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             case CustomEventName.FlowAgentEnd:
                 this.handleFlowAgentEndCustomEvent(event);
                 break;
+            case CustomEventName.FlowAgentRestart:
+                this.handleFlowAgentRestartCustomEvent(event);
+                break;
             case CustomEventName.ReferenceDocument:
                 this.handleReferenceDocumentCustomEvent(event);
                 break;
@@ -81,6 +92,12 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             case CustomEventName.TempMessage:
                 this.handleTempMessageCustomEvent(event);
                 break;
+            case CustomEventName.ApprovalResult:
+                this.handleApprovalResultCustomEvent(event);
+                break;
+            case CustomEventName.FlowAgentUpdate:
+                this.handleFlowAgentUpdateCustomEvent(event);
+                break;
             default:
                 break;
         }
@@ -102,6 +119,20 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         }
     }
     /**
+   * 自定义事件 处理流程编排任务重启
+   */ handleFlowAgentRestartCustomEvent(event) {
+        const value = event.value;
+        this.messageModule.list.value.forEach((item)=>{
+            if (item.role === MessageRole.Activity && item.activityType === ActivityType.FlowAgent) {
+                const isSameTask = item.content[0].task_id === value[0].task_id;
+                // 通过第一个 task_id 判断是否是同一个任务，是的话直接更新消息状态为 streaming
+                if (isSameTask) {
+                    item.status = MessageStatus.Streaming;
+                }
+            }
+        });
+    }
+    /**
    * 自定义事件 处理流程编排任务结果（增量更新节点状态）
    */ handleFlowAgentResultCustomEvent(event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -118,7 +149,7 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             activityType: ActivityType.FlowAgent,
             content: value.map((item)=>({
                     nodes: {},
-                    task_id: Number(item.task_id),
+                    task_id: item.task_id,
                     task_name: '',
                     task_outputs: [],
                     task_state: FlowTaskState.Created
@@ -127,6 +158,20 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         });
     }
     /**
+   * 自定义事件 处理流程编排任务更新
+   */ handleFlowAgentUpdateCustomEvent(event) {
+        const value = event.value;
+        this.messageModule.list.value.forEach((item)=>{
+            if (item.role === MessageRole.Activity && item.activityType === ActivityType.FlowAgent) {
+                const isSameTask = item.content[0].task_id === value[0].task_id;
+                // 通过第一个 task_id 判断是否是同一个任务，是的话直接更新消息内容
+                if (isSameTask) {
+                    item.content = value;
+                }
+            }
+        });
+    }
+    /**
    * 自定义事件 处理意图识别结束
    */ handleKnowledgeRagEndCustomEvent(_event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -206,11 +251,24 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
     }
     /**
    * 处理运行完成事件
-   */ handleRunFinishedEvent(_event) {
+   */ handleRunFinishedEvent(event) {
+        var _event_outcome, _event_outcome1;
         const message = this.messageModule.getCurrentLoadingMessage();
         if (message) {
             message.status = MessageStatus.Complete;
         }
+        // 如果是中断消息，则创建一个中断消息
+        if (((_event_outcome = event.outcome) === null || _event_outcome === void 0 ? void 0 : _event_outcome.type) === RunFinishedOutcomeType.Interrupt) {
+            this.messageModule.plusMessage({
+                role: MessageRole.Interrupt,
+                content: event,
+                status: MessageStatus.Pending
+            });
+        }
+        // 二次返回，直接更新消息内容
+        if (((_event_outcome1 = event.outcome) === null || _event_outcome1 === void 0 ? void 0 : _event_outcome1.type) === RunFinishedOutcomeType.Success && (message === null || message === void 0 ? void 0 : message.role) === MessageRole.Interrupt) {
+            message.content = event;
+        }
     }
     /**
    * 处理运行开始事件
@@ -249,6 +307,16 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         });
     }
     /**
+   * 自定义事件 处理审批结果
+   */ handleApprovalResultCustomEvent(event) {
+        const value = event.value;
+        const message = this.messageModule.getCurrentLoadingMessage();
+        if (message) {
+            message.content = value;
+            message.status = MessageStatus.Complete;
+        }
+    }
+    /**
    * 处理文本消息块事件
    */ handleTextMessageChunkEvent(event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -281,7 +349,14 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
     }
     /**
    * 处理文本消息开始事件
+   * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
    */ handleTextMessageStartEvent(event) {
+        const existing = this.messageModule.getMessageByMessageId(event.messageId);
+        if (existing) {
+            existing.content = '';
+            existing.status = MessageStatus.Streaming;
+            return;
+        }
         this.messageModule.plusMessage({
             role: event.role,
             content: '',
@@ -397,10 +472,10 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         (_this_onDoneCallback = (_this = this).onDoneCallback) === null || _this_onDoneCallback === void 0 ? void 0 : _this_onDoneCallback.call(_this);
     }
     onError(error) {
-        var // 回调给上层
+        var // 在聊天区域显示错误消息
+        _this_messageModule, // 回调给上层
         _this_onErrorCallback, _this;
-        // 创建一个错误消息
-        this.messageModule.plusMessage({
+        (_this_messageModule = this.messageModule) === null || _this_messageModule === void 0 ? void 0 : _this_messageModule.plusMessage({
             role: MessageRole.Assistant,
             content: error.message,
             status: MessageStatus.Error

package/dist/event/type.d.ts

@@ -1,14 +1,18 @@
 import { type IMessageApi, type MessageRole, type MessageStatus } from '../message/type';
+import type { JSONSchema4 } from 'json-schema';
 export declare enum CustomEventName {
     FlowAgentEnd = "flow_agent_end",
     FlowAgentResult = "flow_agent_result",
     FlowAgentStart = "flow_agent_start",
+    FlowAgentUpdate = "flow_agent_update",
+    FlowAgentRestart = "flow_agent_restart",
     KnowledgeRagEnd = "knowledge_rag_end",
     KnowledgeRagResult = "knowledge_rag_result",
     KnowledgeRagStart = "knowledge_rag_start",
     KnowledgeRagTextContent = "knowledge_rag_text_content",
     ReferenceDocument = "reference_document",
-    TempMessage = "temp_message"
+    TempMessage = "temp_message",
+    ApprovalResult = "approval_result"
 }
 export declare enum EventType {
     ActivityDelta = "ACTIVITY_DELTA",
@@ -40,42 +44,51 @@ export declare enum EventType {
 }
 /** BKFlow 收敛后的节点状态 - task.node 的状态枚举 */
 export declare enum FlowNodeState {
-    /** 失败 */
     Failed = "failed",
-    /** 执行中 */
     Running = "running",
-    /** 成功 */
     Success = "success",
-    /** 挂起 */
     Suspended = "suspended"
 }
 /** BKFLOW 原始状态 - task 的状态枚举 */
 export declare enum FlowTaskState {
-    /** 执行中 */
     Blocked = "BLOCKED",
-    /** 执行中 */
     Created = "CREATED",
-    /** 失败 */
     Failed = "FAILED",
-    /** 成功 */
     Finished = "FINISHED",
-    /** 执行中 */
     LoopReady = "LOOP_READY",
-    /** 执行中 */
     Ready = "READY",
-    /** 失败 */
     Revoked = "REVOKED",
-    /** 失败 */
     RollBackFailed = "ROLL_BACK_FAILED",
-    /** 执行中 */
     RollBackSuccess = "ROLL_BACK_SUCCESS",
-    /** 执行中 */
     RollingBack = "ROLLING_BACK",
-    /** 执行中 */
     Running = "RUNNING",
-    /** 挂起 */
     Suspended = "SUSPENDED"
 }
+/** 运行完成结果 */
+export declare enum RunFinishedOutcomeType {
+    Success = "success",
+    Interrupt = "interrupt"
+}
+/** 审批状态 */
+export declare enum ApprovalInterruptTicketStatus {
+    Abandoned = "abandoned",
+    Approved = "approved",
+    Cancelled = "cancelled",
+    Draft = "draft",
+    Expired = "expired",
+    Rejected = "rejected",
+    Pending = "pending"
+}
+/** 中断原因 */
+export declare enum InterruptReason {
+    AIDevToolApproval = "aidev:tool_approval",
+    UserQuestion = "aidev:user_question"
+}
+/** 恢复状态 */
+export declare enum ResumeStatus {
+    Resolved = "resolved",
+    Cancelled = "cancelled"
+}
 /**
  * Activity 代表 Agent 执行过程中的活动/动作/任务，可能包含结构化数据
  * 活动状态的增量更新
@@ -112,25 +125,25 @@ export interface IBaseEvent {
 export interface ICustomEvent extends IBaseEvent {
     name: CustomEventName;
     type: EventType.Custom;
-    value: IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IKnowledgeRagResultCustomValue | IKnowledgeRagTextContentCustomValue | IReferenceDocumentCustomValue | ITempMessageCustomValue;
+    value: IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IFlowAgentRestartCustomValue | IKnowledgeRagResultCustomValue | IKnowledgeRagTextContentCustomValue | IReferenceDocumentCustomValue | ITempMessageCustomValue | IApprovalResultCustomValue;
 }
 export type IEvent = IActivityDeltaEvent | IActivitySnapshotEvent | ICustomEvent | IMessagesSnapshotEvent | IRawEvent | IRunErrorEvent | IRunFinishedEvent | IRunStartedEvent | IStateDeltaEvent | IStateSnapshotEvent | IStepFinishedEvent | IStepStartedEvent | ITextMessageChunkEvent | ITextMessageContentEvent | ITextMessageEndEvent | ITextMessageStartEvent | IThinkingEndEvent | IThinkingStartEvent | IThinkingTextMessageContentEvent | IThinkingTextMessageEndEvent | IThinkingTextMessageStartEvent | IToolCallArgsEvent | IToolCallChunkEvent | IToolCallEndEvent | IToolCallResultEvent | IToolCallStartEvent;
 export type IFlowAgentEndCustomValue = {
     task_outputs: string[];
 }[];
 export interface IFlowAgentNode {
-    /** 耗时(s) */
     elapsed_time: number;
-    /** 节点id */
     id: string;
-    /** 节点名称 */
     name: string;
-    /** 节点状态 */
     state: FlowNodeState;
+    retry: number;
+    skip: boolean;
+    retryable: boolean;
+    skippable: boolean;
 }
 export type IFlowAgentResultCustomValue = {
     nodes: Record<string, IFlowAgentNode>;
-    task_id: number;
+    task_id: string;
     task_name: string;
     task_outputs: string[];
     task_state: FlowTaskState;
@@ -138,6 +151,7 @@ export type IFlowAgentResultCustomValue = {
 export type IFlowAgentStartCustomValue = {
     task_id: string;
 }[];
+export type IFlowAgentRestartCustomValue = IFlowAgentStartCustomValue;
 export type IKnowledgeRagResultCustomValue = IReferenceDocumentCustomValue;
 export interface IKnowledgeRagTextContentCustomValue {
     cover: boolean;
@@ -173,15 +187,66 @@ export interface IRunErrorEvent extends IBaseEvent {
     message: string;
     type: EventType.RunError;
 }
+export interface IInterrupt<T extends InterruptReason, P extends Record<string, unknown>> {
+    id: string;
+    reason: T;
+    message?: string;
+    toolCallId?: string;
+    responseSchema?: JSONSchema4;
+    expiresAt?: string;
+    metadata?: P;
+}
+export type IApprovalInterrupt = IInterrupt<InterruptReason.AIDevToolApproval, {
+    ticket: {
+        approvers: string[];
+        sn: string;
+        status: ApprovalInterruptTicketStatus;
+        submit_time: string;
+        title: string;
+        url: string;
+    };
+}>;
+export type IUserQuestionInterrupt = IInterrupt<InterruptReason.UserQuestion, {
+    questions: {
+        header: string;
+        multiSelect?: boolean;
+        options?: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+    }[];
+}>;
+export interface IResume {
+    interruptId: string;
+    status: ResumeStatus;
+    payload?: {
+        answers: {
+            answer: {
+                description: string;
+                label: string;
+            }[];
+            multiSelect?: boolean;
+            question: string;
+        }[];
+    };
+}
+export type IRunFinishedOutcome = {
+    type: RunFinishedOutcomeType.Success;
+} | {
+    type: RunFinishedOutcomeType.Interrupt;
+    interrupts: Array<IApprovalInterrupt | IUserQuestionInterrupt>;
+};
 /**
  * 标记 Agent 运行正常结束
  * 返回最终结果 result
  */
 export interface IRunFinishedEvent extends IBaseEvent {
-    result?: unknown;
+    result?: IResume;
     runId: number;
     threadId: string;
     type: EventType.RunFinished;
+    outcome?: IRunFinishedOutcome;
 }
 /**
  * 标记一次完整的 Agent 执行开始
@@ -234,6 +299,7 @@ export interface ITempMessageCustomValue {
     message: string;
     status: MessageStatus;
 }
+export type IApprovalResultCustomValue = IRunFinishedEvent;
 export interface ITextMessageChunkEvent extends IBaseEvent {
     delta?: string;
     messageId: string;

package/dist/event/type.ts.js

@@ -27,12 +27,15 @@
     CustomEventName["FlowAgentEnd"] = "flow_agent_end";
     CustomEventName["FlowAgentResult"] = "flow_agent_result";
     CustomEventName["FlowAgentStart"] = "flow_agent_start";
+    CustomEventName["FlowAgentUpdate"] = "flow_agent_update";
+    CustomEventName["FlowAgentRestart"] = "flow_agent_restart";
     CustomEventName["KnowledgeRagEnd"] = "knowledge_rag_end";
     CustomEventName["KnowledgeRagResult"] = "knowledge_rag_result";
     CustomEventName["KnowledgeRagStart"] = "knowledge_rag_start";
     CustomEventName["KnowledgeRagTextContent"] = "knowledge_rag_text_content";
     CustomEventName["ReferenceDocument"] = "reference_document";
     CustomEventName["TempMessage"] = "temp_message";
+    CustomEventName["ApprovalResult"] = "approval_result";
 })(CustomEventName || (CustomEventName = {}));
 export var EventType;
 (function(EventType) {
@@ -65,23 +68,48 @@ export var EventType;
 })(EventType || (EventType = {}));
 export var FlowNodeState;
 (function(FlowNodeState) {
-    /** 失败 */ FlowNodeState["Failed"] = "failed";
-    /** 执行中 */ FlowNodeState["Running"] = "running";
-    /** 成功 */ FlowNodeState["Success"] = "success";
-    /** 挂起 */ FlowNodeState["Suspended"] = "suspended";
+    FlowNodeState["Failed"] = "failed";
+    FlowNodeState["Running"] = "running";
+    FlowNodeState["Success"] = "success";
+    FlowNodeState["Suspended"] = "suspended";
 })(FlowNodeState || (FlowNodeState = {}));
 export var FlowTaskState;
 (function(FlowTaskState) {
-    /** 执行中 */ FlowTaskState["Blocked"] = "BLOCKED";
-    /** 执行中 */ FlowTaskState["Created"] = "CREATED";
-    /** 失败 */ FlowTaskState["Failed"] = "FAILED";
-    /** 成功 */ FlowTaskState["Finished"] = "FINISHED";
-    /** 执行中 */ FlowTaskState["LoopReady"] = "LOOP_READY";
-    /** 执行中 */ FlowTaskState["Ready"] = "READY";
-    /** 失败 */ FlowTaskState["Revoked"] = "REVOKED";
-    /** 失败 */ FlowTaskState["RollBackFailed"] = "ROLL_BACK_FAILED";
-    /** 执行中 */ FlowTaskState["RollBackSuccess"] = "ROLL_BACK_SUCCESS";
-    /** 执行中 */ FlowTaskState["RollingBack"] = "ROLLING_BACK";
-    /** 执行中 */ FlowTaskState["Running"] = "RUNNING";
-    /** 挂起 */ FlowTaskState["Suspended"] = "SUSPENDED";
+    FlowTaskState["Blocked"] = "BLOCKED";
+    FlowTaskState["Created"] = "CREATED";
+    FlowTaskState["Failed"] = "FAILED";
+    FlowTaskState["Finished"] = "FINISHED";
+    FlowTaskState["LoopReady"] = "LOOP_READY";
+    FlowTaskState["Ready"] = "READY";
+    FlowTaskState["Revoked"] = "REVOKED";
+    FlowTaskState["RollBackFailed"] = "ROLL_BACK_FAILED";
+    FlowTaskState["RollBackSuccess"] = "ROLL_BACK_SUCCESS";
+    FlowTaskState["RollingBack"] = "ROLLING_BACK";
+    FlowTaskState["Running"] = "RUNNING";
+    FlowTaskState["Suspended"] = "SUSPENDED";
 })(FlowTaskState || (FlowTaskState = {}));
+export var RunFinishedOutcomeType;
+(function(RunFinishedOutcomeType) {
+    RunFinishedOutcomeType["Success"] = "success";
+    RunFinishedOutcomeType["Interrupt"] = "interrupt";
+})(RunFinishedOutcomeType || (RunFinishedOutcomeType = {}));
+export var ApprovalInterruptTicketStatus;
+(function(ApprovalInterruptTicketStatus) {
+    ApprovalInterruptTicketStatus["Abandoned"] = "abandoned";
+    ApprovalInterruptTicketStatus["Approved"] = "approved";
+    ApprovalInterruptTicketStatus["Cancelled"] = "cancelled";
+    ApprovalInterruptTicketStatus["Draft"] = "draft";
+    ApprovalInterruptTicketStatus["Expired"] = "expired";
+    ApprovalInterruptTicketStatus["Rejected"] = "rejected";
+    ApprovalInterruptTicketStatus["Pending"] = "pending";
+})(ApprovalInterruptTicketStatus || (ApprovalInterruptTicketStatus = {}));
+export var InterruptReason;
+(function(InterruptReason) {
+    InterruptReason["AIDevToolApproval"] = "aidev:tool_approval";
+    InterruptReason["UserQuestion"] = "aidev:user_question";
+})(InterruptReason || (InterruptReason = {}));
+export var ResumeStatus;
+(function(ResumeStatus) {
+    ResumeStatus["Resolved"] = "resolved";
+    ResumeStatus["Cancelled"] = "cancelled";
+})(ResumeStatus || (ResumeStatus = {}));

package/dist/http/fetch/fetch.d.ts

@@ -45,6 +45,13 @@ export interface ISSEProtocol {
     onMessage?: (event: unknown) => void;
     onStart?: () => void;
 }
+/** 全局错误处理器类型 */
+export type GlobalErrorHandler = (error: IRequestError) => void;
+/** 错误处理器配置 */
+export interface ErrorHandlerOptions {
+    /** 忽略的 URL 模式（字符串包含匹配或正则） */
+    ignoreErrors?: Array<string | RegExp>;
+}
 interface IInterceptor<T> {
     fulfilled?: (value: T) => T;
     rejected?: (error: unknown) => unknown;
@@ -62,7 +69,20 @@ export declare class FetchClient {
         request: InterceptorManager<IRequestConfig>;
         response: InterceptorManager<IResponse>;
     };
+    /** 全局错误处理器 */
+    private globalErrorHandler?;
+    /** 忽略的错误 URL 模式 */
+    private ignoreErrorPatterns;
     constructor(config?: IRequestConfig);
+    /**
+     * 注册全局错误处理器
+     * 所有 HTTP 错误（request 和 streamRequest）都会经过此处理器
+     */
+    onError(handler: GlobalErrorHandler, options?: ErrorHandlerOptions): void;
+    /** 判断是否应忽略该错误 */
+    private shouldIgnoreError;
+    /** 统一错误分发 */
+    private dispatchError;
     applyResponseErrorInterceptors(error: unknown): unknown;
     create(config?: IRequestConfig): FetchClient;
     delete<T = unknown>(url: string, params?: Record<string, unknown>, config?: IRequestConfig): Promise<T>;

package/dist/http/fetch/fetch.ts.js

@@ -132,6 +132,35 @@ class InterceptorManager {
     }
 }
 export class FetchClient {
+    /**
+   * 注册全局错误处理器
+   * 所有 HTTP 错误（request 和 streamRequest）都会经过此处理器
+   */ onError(handler, options) {
+        this.globalErrorHandler = handler;
+        if (options === null || options === void 0 ? void 0 : options.ignoreErrors) {
+            this.ignoreErrorPatterns = options.ignoreErrors;
+        }
+    }
+    /** 判断是否应忽略该错误 */ shouldIgnoreError(error) {
+        var _error_config, _error_config1;
+        // 同时匹配相对路径和完整 URL
+        const url = ((_error_config = error.config) === null || _error_config === void 0 ? void 0 : _error_config.url) || '';
+        const baseURL = ((_error_config1 = error.config) === null || _error_config1 === void 0 ? void 0 : _error_config1.baseURL) || '';
+        const fullURL = baseURL && !url.startsWith('http') ? baseURL + url : url;
+        return this.ignoreErrorPatterns.some((pattern)=>{
+            if (typeof pattern === 'string') {
+                // 字符串模式：同时检查相对路径和完整 URL
+                return url.includes(pattern) || fullURL.includes(pattern);
+            }
+            // 正则模式：同时检查相对路径和完整 URL
+            return pattern.test(url) || pattern.test(fullURL);
+        });
+    }
+    /** 统一错误分发 */ dispatchError(error) {
+        if (this.globalErrorHandler && !this.shouldIgnoreError(error)) {
+            this.globalErrorHandler(error);
+        }
+    }
     applyResponseErrorInterceptors(error) {
         let rejectedError = error;
         this.interceptors.response.forEach((interceptor)=>{
@@ -323,11 +352,13 @@ export class FetchClient {
                 if (timeoutId) {
                     clearTimeout(timeoutId);
                 }
+                // 用户手动取消请求
                 if (error instanceof Error && error.name === 'AbortError') {
-                    const requestError = createError('Request timeout', requestConfig, 'ECONNABORTED', undefined);
-                    throw _this.applyResponseErrorInterceptors(requestError);
+                    console.warn('User canceled request', error.message);
+                    return;
                 }
                 const requestError = error.isAxiosError === true ? error : createError(error.message, requestConfig, error.code, undefined);
+                _this.dispatchError(requestError);
                 throw _this.applyResponseErrorInterceptors(requestError);
             }
         })();
@@ -340,13 +371,31 @@ export class FetchClient {
     streamRequest(config) {
         var _this = this;
         return _async_to_generator(function*() {
-            const { url, fetchConfig, requestConfig } = _this.prepareRequest(config, true);
+            // 错误去重：标记是否已调用过全局错误处理器
+            let errorDispatched = false;
+            // 包装 onError 回调，统一调用全局错误处理器
+            const originalOnError = config.onError;
+            const wrappedOnError = (error)=>{
+                if (!errorDispatched) {
+                    // 将 requestConfig 附加到错误对象，以便 shouldIgnoreError 能匹配 URL
+                    const errorWithConfig = error;
+                    if (!errorWithConfig.config) {
+                        errorWithConfig.config = requestConfig;
+                    }
+                    _this.dispatchError(errorWithConfig);
+                    errorDispatched = true;
+                }
+                originalOnError === null || originalOnError === void 0 ? void 0 : originalOnError(error);
+            };
+            const wrappedConfig = _object_spread_props(_object_spread({}, config), {
+                onError: wrappedOnError
+            });
+            const { url, fetchConfig, requestConfig } = _this.prepareRequest(wrappedConfig, true);
             try {
-                var _config_onStart, _fetchResponse_body;
+                var _wrappedConfig_onStart, _fetchResponse_body;
                 const fetchResponse = yield fetch(url, fetchConfig);
                 const validateStatus = requestConfig.validateStatus || _this.defaults.validateStatus;
                 if (!validateStatus(fetchResponse.status)) {
-                    var _config_onError;
                     let message = `Request failed with status code ${fetchResponse.status}`;
                     try {
                         var _errorData_error;
@@ -358,15 +407,14 @@ export class FetchClient {
                         message = `Request failed with status code ${fetchResponse.status}`;
                     }
                     const error = createError(message, requestConfig, `ERR_BAD_RESPONSE`, undefined);
-                    (_config_onError = config.onError) === null || _config_onError === void 0 ? void 0 : _config_onError.call(config, error);
+                    wrappedOnError(error);
                     return;
                 }
-                (_config_onStart = config.onStart) === null || _config_onStart === void 0 ? void 0 : _config_onStart.call(config);
+                (_wrappedConfig_onStart = wrappedConfig.onStart) === null || _wrappedConfig_onStart === void 0 ? void 0 : _wrappedConfig_onStart.call(wrappedConfig);
                 const reader = (_fetchResponse_body = fetchResponse.body) === null || _fetchResponse_body === void 0 ? void 0 : _fetchResponse_body.pipeThrough(new window.TextDecoderStream()).getReader();
                 if (!reader) {
-                    var _config_onError1;
                     const error = new Error('IResponse body is not readable');
-                    (_config_onError1 = config.onError) === null || _config_onError1 === void 0 ? void 0 : _config_onError1.call(config, error);
+                    wrappedOnError(error);
                     return;
                 }
                 // 缓存跨行分片数据
@@ -383,17 +431,17 @@ export class FetchClient {
                 while(true){
                     const { value, done } = yield reader.read();
                     if (done) {
-                        var _config_onDone;
-                        (_config_onDone = config.onDone) === null || _config_onDone === void 0 ? void 0 : _config_onDone.call(config);
+                        var _wrappedConfig_onDone;
+                        (_wrappedConfig_onDone = wrappedConfig.onDone) === null || _wrappedConfig_onDone === void 0 ? void 0 : _wrappedConfig_onDone.call(wrappedConfig);
                         break;
                     }
                     const values = (temp + value.toString()).split('\n');
                     values.forEach((value)=>{
                         const item = value.replace('data:', '').trim();
                         if (isJson(item)) {
-                            var _config_onMessage;
+                            var _wrappedConfig_onMessage;
                             const json = JSON.parse(item);
-                            (_config_onMessage = config.onMessage) === null || _config_onMessage === void 0 ? void 0 : _config_onMessage.call(config, json);
+                            (_wrappedConfig_onMessage = wrappedConfig.onMessage) === null || _wrappedConfig_onMessage === void 0 ? void 0 : _wrappedConfig_onMessage.call(wrappedConfig, json);
                             temp = '';
                         } else if (item) {
                             temp = item;
@@ -403,12 +451,11 @@ export class FetchClient {
             } catch (error) {
                 if (error instanceof Error) {
                     if (error.name === 'AbortError') {
-                        var _config_onDone1;
-                        (_config_onDone1 = config.onDone) === null || _config_onDone1 === void 0 ? void 0 : _config_onDone1.call(config);
-                    } else {
-                        var _config_onError2;
-                        (_config_onError2 = config.onError) === null || _config_onError2 === void 0 ? void 0 : _config_onError2.call(config, error);
+                        var _wrappedConfig_onDone1;
+                        (_wrappedConfig_onDone1 = wrappedConfig.onDone) === null || _wrappedConfig_onDone1 === void 0 ? void 0 : _wrappedConfig_onDone1.call(wrappedConfig);
+                        return;
                     }
+                    wrappedOnError(error);
                 }
                 throw error;
             }
@@ -417,6 +464,8 @@ export class FetchClient {
     constructor(config = {}){
         _define_property(this, "defaults", void 0);
         _define_property(this, "interceptors", void 0);
+        /** 全局错误处理器 */ _define_property(this, "globalErrorHandler", void 0);
+        /** 忽略的错误 URL 模式 */ _define_property(this, "ignoreErrorPatterns", []);
         this.defaults = mergeConfig({
             method: 'GET',
             headers: {