@blueking/chat-helper 0.0.11 → 0.0.12-beta.2

package/dist/agent/use-agent.ts.js

@@ -123,8 +123,7 @@ import { SessionStatus } from '../session/type.ts.js';
     };
     const streamRequest = function() {
         var _ref = _async_to_generator(function*(sessionCode, url, config) {
-            var // 发起聊天
-            _mediator_http;
+            var _mediator_http;
             // ag-ui 协议需要注入消息模块
             if (usedProtocol instanceof AGUIProtocol) {
                 usedProtocol.injectMessageModule(mediator.message);
@@ -151,7 +150,8 @@ import { SessionStatus } from '../session/type.ts.js';
             };
             // 创建 AbortController
             abortController = new AbortController();
-            (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.fetchClient.streamRequest(_object_spread({
+            // 发起聊天
+            void ((_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.fetchClient.streamRequest(_object_spread({
                 url: url || 'chat_completion/',
                 method: 'POST',
                 data: {
@@ -165,7 +165,9 @@ import { SessionStatus } from '../session/type.ts.js';
                 onError,
                 onMessage,
                 onStart
-            }, config));
+            }, config)).catch(()=>{
+            // 非 abort 错误已通过 onError 回调处理；abort 为正常结束
+            }));
         });
         return function streamRequest(sessionCode, url, config) {
             return _ref.apply(this, arguments);

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

@@ -397,10 +397,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/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)=>{
@@ -325,9 +354,11 @@ export class FetchClient {
                 }
                 if (error instanceof Error && error.name === 'AbortError') {
                     const requestError = createError('Request timeout', requestConfig, 'ECONNABORTED', undefined);
+                    _this.dispatchError(requestError);
                     throw _this.applyResponseErrorInterceptors(requestError);
                 }
                 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: {

package/dist/http/index.d.ts

@@ -8,6 +8,8 @@ export * from './transform';
  */
 export declare const useHttp: (options: IUseChatHelperOptions) => {
     reset: (newOptions: IUseChatHelperOptions) => void;
+    /** 注册全局错误处理器 */
+    onError: (handler: import("./fetch").GlobalErrorHandler, options?: import("./fetch").ErrorHandlerOptions) => void;
     agent: {
         getAgentInfo: (config?: import("./fetch").IRequestConfig) => Promise<import("..").IAgentInfo>;
     };

package/dist/http/index.ts.js

@@ -88,6 +88,7 @@ export * from './transform/index.ts.js';
     // 创建 http 模块
     const http = useModule(fetchClient);
     return _object_spread_props(_object_spread({}, http), {
-        reset
+        reset,
+        /** 注册全局错误处理器 */ onError: fetchClient.onError.bind(fetchClient)
     });
 };

package/dist/http/module/session.ts.js

@@ -75,6 +75,27 @@ function _object_spread_props(target, source) {
     return target;
 }
 import { transferSession2SessionApi, transferSessionApi2Session, transferSessionFeedback2SessionFeedbackApi, transferSessionFeedbackApi2SessionFeedback } from '../transform/session.ts.js';
+import { resolveRequestValue } from '../fetch/index.ts.js';
+/** 上传接口传输用文件名前缀，与原始展示名解耦 */ const UPLOAD_FILE_NAME_PREFIX = 'upload_file';
+/** 从原始文件名提取 ASCII 安全扩展名，用于保留文件类型 */ const getSafeFileExtension = (fileName)=>{
+    const extension = fileName.split('.').pop();
+    if (!extension || extension === fileName) {
+        return '';
+    }
+    const safeExtension = extension.replace(/[^A-Za-z0-9]/g, '').slice(0, 20).toLowerCase();
+    return safeExtension ? `.${safeExtension}` : '';
+};
+/**
+ * 生成上传接口使用的 ASCII 安全文件名。
+ * 中文等非 ASCII 原名不能用于 URL path / Content-Disposition（浏览器与后端均可能编码失败），
+ * 原始 file.name 仍保留在 File 对象上，由 chat-x 发送消息时作为展示名使用。
+ */ const buildSafeUploadFileName = (file)=>{
+    const suffix = `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    return `${UPLOAD_FILE_NAME_PREFIX}_${suffix}${getSafeFileExtension(file.name)}`;
+};
+/** Content-Disposition 仅允许 ASCII，须与 upload path 中的 file_name 一致 */ const buildUploadContentDisposition = (fileName)=>{
+    return `attachment; filename="${fileName}"`;
+};
 /**
  * session 相关 http 接口
  * @param fetchClient - 请求客户端
@@ -104,13 +125,16 @@ import { transferSession2SessionApi, transferSessionApi2Session, transferSession
         }, config);
     // 会话重命名
     const renameSession = (sessionCode, config)=>fetchClient.post(`session/${sessionCode}/ai_rename/`, undefined, config).then((res)=>transferSessionApi2Session(res));
-    // 上传文件到会话
+    // 上传文件到会话（传输名与展示名分离，见 buildSafeUploadFileName）
     const uploadFile = (sessionCode, file, config)=>{
-        const fileName = encodeURIComponent(file.name);
+        const safeFileName = buildSafeUploadFileName(file);
+        const fileName = encodeURIComponent(safeFileName);
+        var _resolveRequestValue;
+        const headers = (_resolveRequestValue = resolveRequestValue(config === null || config === void 0 ? void 0 : config.headers)) !== null && _resolveRequestValue !== void 0 ? _resolveRequestValue : {};
         return file.arrayBuffer().then((content)=>fetchClient.post(`session/${sessionCode}/upload/${fileName}/`, content, _object_spread_props(_object_spread({}, config), {
-                headers: {
-                    'Content-Disposition': `attachment; filename="${file.name}"`
-                }
+                headers: _object_spread_props(_object_spread({}, headers), {
+                    'Content-Disposition': buildUploadContentDisposition(safeFileName)
+                })
             })));
     };
     return {

package/dist/index.d.ts

@@ -3725,6 +3725,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
     };
     http: {
         reset: (newOptions: IUseChatHelperOptions) => void;
+        onError: (handler: import("./http").GlobalErrorHandler, options?: import("./http").ErrorHandlerOptions) => void;
         agent: {
             getAgentInfo: (config?: import("./http").IRequestConfig) => Promise<import("./agent").IAgentInfo>;
         };
@@ -3763,4 +3764,6 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
         fetchClient: import("./http").FetchClient;
     };
     reset: (options: IUseChatHelperOptions) => void;
+    /** 注册全局错误处理器，简化调用链 */
+    onError: (handler: import("./http").GlobalErrorHandler, options?: import("./http").ErrorHandlerOptions) => void;
 };

package/dist/index.ts.js

@@ -62,6 +62,7 @@ export * from './type.ts.js';
         session,
         message,
         http,
-        reset
+        reset,
+        /** 注册全局错误处理器，简化调用链 */ onError: http.onError
     };
 };

package/dist/session/use-session.ts.js

@@ -126,10 +126,17 @@ import { ref } from 'vue';
             var // 中止当前聊天
             _mediator_agent;
             (_mediator_agent = mediator.agent) === null || _mediator_agent === void 0 ? void 0 : _mediator_agent.abortChat();
-            // 从接口更新当前会话信息
-            yield getSession(sessionCode);
+            const shouldLoadMessages = (options === null || options === void 0 ? void 0 : options.loadMessages) !== false;
+            const localSession = list.value.find((item)=>item.sessionCode === sessionCode);
+            // 新会话或明确空会话已在本地列表中，无需额外 GET 会话详情。
+            if (!shouldLoadMessages && localSession) {
+                current.value = localSession;
+            } else {
+                // 从接口更新当前会话信息
+                yield getSession(sessionCode);
+            }
             // 默认加载消息，但允许跳过（新会话消息必定为空，无需加载）
-            if ((options === null || options === void 0 ? void 0 : options.loadMessages) !== false) {
+            if (shouldLoadMessages) {
                 var _mediator_message, // 继续聊天
                 _mediator_agent1;
                 // 获取会话内容

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-helper",
-  "version": "0.0.11",
+  "version": "0.0.12-beta.2",
   "description": "",
   "main": "./dist/index.ts.js",
   "types": "./dist/index.d.ts",