anl 26.806.0 → 26.928.0

package/config.d.ts

@@ -3,6 +3,9 @@ export type TDatalevel = 'data' | 'serve' | 'axios';
 /** 终端日志输出级别 */
 export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'verbose';
 
+/** 请求模板类型 —— 决定生成到项目 `<saveApiListFolderPath>/config/` 下的底层请求实现 */
+export type RequestTemplate = 'axios' | 'fetch' | 'wx' | 'uniapp' | 'taro';
+
 /** 响应模型转换配置 */
 export interface IResponseModelTransform {
 	/** 转换类型：unwrap-剔除响应模型，wrap-添加响应模型，replace-替换响应模型 */
@@ -79,6 +82,14 @@ export interface ConfigType {
 	apiListFileName?: string;
 	/** 请求方法导入路径 */
 	requestMethodsImportPath: string;
+	/** 请求模板类型（决定生成到 `<saveApiListFolderPath>/config/` 下的底层 `dio.ts` 实现），默认 `'axios'`。
+	 *  - `axios` 基于 axios（浏览器/Node，需 `npm i axios`）
+	 *  - `fetch` 基于原生 fetch（浏览器/现代 Node，无额外依赖）
+	 *  - `wx`    基于 `wx.request`（微信小程序原生）
+	 *  - `uniapp` 基于 `uni.request`（uni-app 跨端）
+	 *  - `taro`   基于 `Taro.request`（Taro 3+ 跨端）
+	 *  注意：切换模板时需手动删除 `<saveApiListFolderPath>/config/` 目录，CLI 才会重新写入对应模板文件。 */
+	requestTemplate?: RequestTemplate;
 	/** 追加请求头 */
 	headers?: Record<string, string>;
 	/** 公共前缀（仅为兼容旧配置，最终以服务级配置为准） */

package/lib/index.cjs

@@ -1 +1 @@
-const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./package.cjs`),n=require(`./git-local-config/index.cjs`),r=require(`./skill-init/index.cjs`),i=require(`./standard/lint-init.cjs`),a=require(`./swagger-codegen/index.cjs`);let o=require(`commander`),s=require(`inquirer`);s=e.__toESM(s),o.program.version(`${t.version}`,`-v --version`).usage(`<command> [options]`),o.program.command(`type`).description(`auto interface`).option(`-s, --show <what>`,`show interface list after generation: miss | gen`).option(`-f, --format [config]`,`enable prettier formatting after generation; optionally specify a prettier config file path (e.g. --format .prettierrc.mjs)`).option(`-l, --log-level <level>`,`set log output level: silent | error | warn | info | verbose`).option(`-S, --service <names>`,"only regenerate the specified swagger service(s); comma-separated. Match by `name` (preferred) or `apiListFileName` without extension. Other services are kept untouched.").action(e=>{let t=(e.show??``).toLowerCase().trim(),n=t===`miss`||t===`missing`||t===`m`||t===`exclude`||t===`x`?`miss`:t===`gen`||t===`generated`||t===`g`||t===`include`||t===`i`?`gen`:void 0,r=e.service?e.service.split(`,`).map(e=>e.trim()).filter(Boolean):void 0;new a.Main().initialize(n,e.format,e.logLevel,r).catch(e=>{console.error(e)})}),o.program.command(`lint`).description(`install linting tools (eslint, stylelint, prettier, commitlint, vscode)`).action(()=>i.lintHandle()),o.program.command(`git`).description(`config git Local custom command`).action(async()=>{let{features:e}=await s.default.prompt([{type:`checkbox`,name:`features`,message:`Select the required Git features (multi-select):`,choices:[{name:`gitflow standard branch creation`,value:`gitflow`},{name:`automatically set commit subject`,value:`commitSubject`},{name:`custom git command`,value:`customGitCommand`}],pageSize:10}]);n.gitHandle(e).catch(e=>{console.error(e)})}),o.program.command(`skill`).description(`initialize an agent skill into the current project`).action(()=>{r.skillHandle().catch(e=>{console.error(e)})}),o.program.parse(process.argv);
+const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./package.cjs`),n=require(`./git-local-config/index.cjs`),r=require(`./skill-init/index.cjs`),i=require(`./standard/lint-init.cjs`),a=require(`./swagger-codegen/index.cjs`);let o=require(`commander`),s=require(`inquirer`);s=e.__toESM(s),o.program.version(`${t.version}`,`-v --version`).usage(`<command> [options]`),o.program.command(`type`).description(`auto interface`).option(`-s, --show <what>`,`show interface list after generation: miss | gen`).option(`-f, --format [config]`,`enable prettier formatting after generation; optionally specify a prettier config file path (e.g. --format .prettierrc.mjs)`).option(`-l, --log-level <level>`,`set log output level: silent | error | warn | info | verbose`).option(`-S, --service <names>`,"only regenerate the specified swagger service(s); comma-separated. Match by `name` (preferred) or `apiListFileName` without extension. Other services are kept untouched.").option(`-t, --template <name>`,`request template written to <saveApiListFolderPath>/config: axios | fetch | wx | uniapp | taro. Overrides an.config.ts. Only takes effect when the config folder does not exist yet.`).action(e=>{let t=(e.show??``).toLowerCase().trim(),n=t===`miss`||t===`missing`||t===`m`||t===`exclude`||t===`x`?`miss`:t===`gen`||t===`generated`||t===`g`||t===`include`||t===`i`?`gen`:void 0,r=e.service?e.service.split(`,`).map(e=>e.trim()).filter(Boolean):void 0;new a.Main().initialize(n,e.format,e.logLevel,r,e.template).catch(e=>{console.error(e)})}),o.program.command(`lint`).description(`install linting tools (eslint, stylelint, prettier, commitlint, vscode)`).action(()=>i.lintHandle()),o.program.command(`git`).description(`config git Local custom command`).action(async()=>{let{features:e}=await s.default.prompt([{type:`checkbox`,name:`features`,message:`Select the required Git features (multi-select):`,choices:[{name:`gitflow standard branch creation`,value:`gitflow`},{name:`automatically set commit subject`,value:`commitSubject`},{name:`custom git command`,value:`customGitCommand`}],pageSize:10}]);n.gitHandle(e).catch(e=>{console.error(e)})}),o.program.command(`skill`).description(`initialize an agent skill into the current project`).action(()=>{r.skillHandle().catch(e=>{console.error(e)})}),o.program.parse(process.argv);

package/lib/package.cjs

@@ -1 +1 @@
-var e=`26.806.0`;Object.defineProperty(exports,`version`,{enumerable:!0,get:function(){return e}});
+var e=`26.928.0`;Object.defineProperty(exports,`version`,{enumerable:!0,get:function(){return e}});

package/lib/request-templates/_shared/api-type.d.ts

@@ -0,0 +1,52 @@
+/**
+ * datalevel 说明：
+ * - 'data'  返回业务数据本体（ResponseModel.data）
+ * - 'serve' 返回完整业务响应体 ResponseModel<T>
+ * - 'axios' 返回底层适配器的原始响应对象 DioResponse<ResponseModel<T>>
+ *   （命名沿用历史值以保持代码生成器一致，语义为"最底层原始响应"）
+ */
+type TDatalevel = 'data' | 'serve' | 'axios';
+
+type RServe<T> = Promise<ResponseModel<T>>;
+type RAxios<T> = Promise<DioResponse<ResponseModel<T>>>;
+
+interface ResponseModel<T> {
+	code: number;
+	message: string;
+	data: T;
+	success: boolean;
+}
+
+/** 底层适配器统一响应结构（axios/fetch/wx/uni/taro 的共同抽象） */
+interface DioResponse<T = unknown> {
+	data: T;
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+}
+
+/** 底层适配器统一请求配置（axios/fetch/wx/uni/taro 的共同抽象） */
+interface DioRequestConfig {
+	url?: string;
+	method?: 'GET' | 'DELETE' | 'PUT' | 'POST' | 'PATCH' | 'OPTIONS' | 'HEAD' | 'SEARCH' | Lowercase<'GET' | 'DELETE' | 'PUT' | 'POST' | 'PATCH' | 'OPTIONS' | 'HEAD' | 'SEARCH'>;
+	headers?: Record<string, string>;
+	timeout?: number;
+	signal?: AbortSignal;
+	responseType?: 'json' | 'text' | 'blob' | 'arrayBuffer';
+	[key: string]: unknown;
+}
+
+type IRequestFnParams = DioRequestConfig & {
+	query?: unknown;
+	body?: unknown;
+};
+
+interface IRequestFnRestParams {
+	config?: DioRequestConfig;
+	[key: string]: unknown;
+}
+
+interface ErrorPayload {
+	errors?: { message?: string }[];
+	[key: string]: unknown;
+}

package/lib/request-templates/_shared/error-message.ts

@@ -0,0 +1,55 @@
+/**
+ * 提示组件请按项目实际替换：
+ * - Web：可换成 antd / element-plus / naive-ui 的 message
+ * - 小程序/uni-app/Taro：可换成 wx.showToast / uni.showToast / Taro.showToast
+ * 这里保留一个最小实现（console.warn），避免默认强依赖任何提示库。
+ */
+const message = {
+	info: (msg: string) => console.info('[tip]', msg),
+	warning: (msg: string) => console.warn('[warn]', msg),
+	error: (msg: string) => console.error('[error]', msg),
+};
+
+/** 跳过提示的 code 码 */
+const skipTipCode: number[] = [];
+
+/** 需要重写提示的 code 码 */
+const rewriteCodeMessage = ({ code = 10000, message = '网络错误，稍后重试！' }: ResponseModel<unknown>) => {
+	switch (code) {
+		case 10000:
+			return { code, message: '系统错误，稍后重试！' };
+		default:
+			return { code, message };
+	}
+};
+
+export const messageTip = ({ data }: DioResponse<ResponseModel<unknown>>) => {
+	if (Object.prototype.toString.call(data) !== '[object Object]') return;
+	if (!('message' in data && 'code' in data)) return;
+
+	const { code, message: msg } = rewriteCodeMessage(data);
+
+	if (skipTipCode.includes(code)) return;
+
+	// 以下的代码是根据 code 码范围来显示不同的提示信息，请根据实际需求修改
+
+	/** 信息提示范围 */
+	if (code >= 2000 && code <= 3999) {
+		message.info(msg);
+	}
+
+	/** 警告提示范围 */
+	if (code > 3999 && code <= 4999) {
+		message.warning(msg);
+	}
+
+	/** 错误提示范围 */
+	if (code > 4999 && code <= 5999) {
+		message.error(msg);
+	}
+
+	/** 系统提示范围 */
+	if (code >= 9000) {
+		message.info(msg);
+	}
+};

package/lib/request-templates/_shared/fetch.ts

@@ -0,0 +1,208 @@
+/**
+ * 只需要导出 GET DELETE PUT POST PATCH OPTIONS HEAD SEARCH 这些请求方法即可，
+ * 至于方法内使用 axios / fetch / wx / uni / taro 由 dio.ts 中的 dio 实例决定。
+ * 请注意方法的参数和返回值类型，请参考 dio.ts 中 dio 的类型定义；实现函数重载。
+ */
+
+import { dio } from './dio';
+import { messageTip } from './error-message';
+
+function GET<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function GET<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function GET<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function GET<R = unknown>(url: string, params: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...params,
+			url,
+			query: params.query,
+			method: 'GET',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function DELETE<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function DELETE<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function DELETE<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function DELETE<R = unknown>(url: string, params: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...params,
+			url,
+			query: params.query,
+			method: 'DELETE',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function PUT<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function PUT<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function PUT<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function PUT<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'PUT',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function POST<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function POST<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function POST<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function POST<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'POST',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function PATCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function PATCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function PATCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function PATCH<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'PATCH',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function OPTIONS<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function OPTIONS<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function OPTIONS<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function OPTIONS<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'OPTIONS',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function HEAD<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function HEAD<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function HEAD<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function HEAD<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'HEAD',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+function SEARCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'serve'): RServe<R>;
+function SEARCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'data'): Promise<R>;
+function SEARCH<R = unknown>(url: string, params: IRequestFnParams, datalevel?: 'axios'): RAxios<R>;
+function SEARCH<R = unknown>(url: string, { query, body, ...rest }: IRequestFnParams, datalevel: TDatalevel = 'serve') {
+	return dio
+		.request<ResponseModel<R>>({
+			...rest,
+			url,
+			query,
+			body,
+			method: 'SEARCH',
+		})
+		.then((res) => {
+			messageTip(res);
+			switch (datalevel) {
+				case 'data':
+					return res.data.data;
+				case 'serve':
+					return res.data;
+				case 'axios':
+					return res;
+			}
+		});
+}
+
+export { DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT, SEARCH };

package/lib/request-templates/fetch/dio.ts

@@ -0,0 +1,233 @@
+/**
+ * fetch 版 dio 实例：基于 Web 原生 fetch，无外部依赖。
+ * 与 axios 版保持相同的对外形态：`dio.request(config)` 与 `dio.interceptors.request|response`。
+ */
+
+// 环境变量参考（Vite）：
+// const { VITE_API_URL, VITE_API_PROXY, PROD } = import.meta.env;
+// export const BASE_URL = PROD ? VITE_API_URL : VITE_API_PROXY;
+export const BASE_URL = '';
+
+type Interceptor<V> = {
+	onFulfilled?: (value: V) => V | Promise<V>;
+	onRejected?: (error: unknown) => unknown;
+};
+
+class InterceptorManager<V> {
+	private handlers: Interceptor<V>[] = [];
+	use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: (error: unknown) => unknown): number {
+		this.handlers.push({ onFulfilled, onRejected });
+		return this.handlers.length - 1;
+	}
+	eject(id: number): void {
+		if (this.handlers[id]) this.handlers[id] = {};
+	}
+	forEach(cb: (h: Interceptor<V>) => void): void {
+		this.handlers.forEach((h) => h && cb(h));
+	}
+}
+
+const DEFAULT_TIMEOUT = 600000; // 10 分钟
+
+function buildURL(base: string, url: string, query?: unknown): string {
+	const full = /^https?:\/\//i.test(url) ? url : `${base}${url}`;
+	if (!query || typeof query !== 'object') return full;
+	const usp = new URLSearchParams();
+	Object.entries(query as Record<string, unknown>).forEach(([k, v]) => {
+		if (v === undefined || v === null) return;
+		if (Array.isArray(v)) v.forEach((item) => usp.append(k, String(item)));
+		else usp.append(k, String(v));
+	});
+	const qs = usp.toString();
+	if (!qs) return full;
+	return full.includes('?') ? `${full}&${qs}` : `${full}?${qs}`;
+}
+
+function normalizeHeaders(h?: Record<string, string>): Record<string, string> {
+	return { 'Content-Type': 'application/json', ...(h ?? {}) };
+}
+
+async function coreRequest<T = unknown>(config: DioRequestConfig & { query?: unknown; body?: unknown }): Promise<DioResponse<T>> {
+	const { url = '', method = 'GET', query, body, headers, timeout = DEFAULT_TIMEOUT, signal, responseType = 'json' } = config;
+	const finalHeaders = normalizeHeaders(headers);
+
+	const controller = new AbortController();
+	const timerId = setTimeout(() => controller.abort(), timeout);
+	// 外部传入的 signal 优先，被 abort 时也要中断 fetch
+	if (signal) signal.addEventListener('abort', () => controller.abort(), { once: true });
+
+	const init: RequestInit = {
+		method: String(method).toUpperCase(),
+		headers: finalHeaders,
+		signal: controller.signal,
+	};
+
+	const upperMethod = init.method as string;
+	if (body !== undefined && upperMethod !== 'GET' && upperMethod !== 'HEAD') {
+		init.body = typeof body === 'string' || body instanceof FormData || body instanceof Blob ? (body as BodyInit) : JSON.stringify(body);
+	}
+
+	let response: Response;
+	try {
+		response = await fetch(buildURL(BASE_URL, url, query), init);
+	} finally {
+		clearTimeout(timerId);
+	}
+
+	let data: unknown;
+	if (responseType === 'text') data = await response.text();
+	else if (responseType === 'blob') data = await response.blob();
+	else if (responseType === 'arrayBuffer') data = await response.arrayBuffer();
+	else {
+		const text = await response.text();
+		try {
+			data = text ? JSON.parse(text) : null;
+		} catch {
+			data = text;
+		}
+	}
+
+	const respHeaders: Record<string, string> = {};
+	response.headers.forEach((v, k) => (respHeaders[k] = v));
+
+	const dioResponse: DioResponse<T> = {
+		data: data as T,
+		status: response.status,
+		statusText: response.statusText,
+		headers: respHeaders,
+	};
+
+	if (!response.ok) {
+		const err: Error & { response?: DioResponse<T>; config?: DioRequestConfig } = new Error(`Request failed with status ${response.status}`);
+		err.response = dioResponse;
+		err.config = config;
+		throw err;
+	}
+	return dioResponse;
+}
+
+const requestInterceptor = new InterceptorManager<DioRequestConfig & { query?: unknown; body?: unknown }>();
+const responseInterceptor = new InterceptorManager<DioResponse<unknown>>();
+
+async function runRequest<T>(config: DioRequestConfig & { query?: unknown; body?: unknown }): Promise<DioResponse<T>> {
+	let current: DioRequestConfig & { query?: unknown; body?: unknown } = config;
+	const reqHandlers: Interceptor<typeof current>[] = [];
+	requestInterceptor.forEach((h) => reqHandlers.push(h));
+	for (const h of reqHandlers) {
+		try {
+			if (h.onFulfilled) current = await h.onFulfilled(current);
+		} catch (e) {
+			if (h.onRejected) return Promise.reject(h.onRejected(e)) as never;
+			throw e;
+		}
+	}
+
+	let value: DioResponse<T>;
+	try {
+		value = await coreRequest<T>(current);
+	} catch (e) {
+		let error: unknown = e;
+		const handlers: Interceptor<DioResponse<unknown>>[] = [];
+		responseInterceptor.forEach((h) => handlers.push(h));
+		for (const h of handlers) {
+			if (h.onRejected) {
+				try {
+					const recovered = await h.onRejected(error);
+					return recovered as DioResponse<T>;
+				} catch (next) {
+					error = next;
+				}
+			}
+		}
+		throw error;
+	}
+
+	let currentRes: DioResponse<unknown> = value;
+	const resHandlers: Interceptor<DioResponse<unknown>>[] = [];
+	responseInterceptor.forEach((h) => resHandlers.push(h));
+	for (const h of resHandlers) {
+		try {
+			if (h.onFulfilled) currentRes = await h.onFulfilled(currentRes);
+		} catch (e) {
+			if (h.onRejected) return Promise.reject(h.onRejected(e)) as never;
+			throw e;
+		}
+	}
+	return currentRes as DioResponse<T>;
+}
+
+export const dio = {
+	interceptors: {
+		request: requestInterceptor,
+		response: responseInterceptor,
+	},
+	request: <T = unknown>(config: DioRequestConfig & { query?: unknown; body?: unknown }) => runRequest<T>(config),
+};
+
+/**
+ * 请求拦截
+ */
+dio.interceptors.request.use(
+	(config) => {
+		config.headers = { ...(config.headers ?? {}), Authorization: `Bearer 【auth -> replace】` };
+		return config;
+	},
+	(error) => {
+		console.error('request interceptors', error);
+		return error;
+	},
+);
+
+/**
+ * 响应拦截 —— 成功（2xx）
+ */
+dio.interceptors.response.use(
+	(response) => response,
+	(rawError) => {
+		const error = rawError as Error & { response?: DioResponse<{ message?: string; data?: unknown }> };
+		if (!error.response) {
+			console.error('网络异常，请检查网络连接');
+			return Promise.reject(error);
+		}
+		const { status, data } = error.response;
+		const respData = (data ?? {}) as { message?: string; data?: unknown };
+		let errorMsg = respData.message ?? '请求失败，请稍后重试';
+		const payload = respData.data;
+		if (typeof payload === 'string') errorMsg = payload;
+		else if (payload && typeof payload === 'object' && 'errors' in payload) {
+			const errors = (payload as ErrorPayload).errors;
+			if (Array.isArray(errors)) {
+				const collected = errors.map((it) => it?.message).filter((m): m is string => Boolean(m));
+				if (collected.length) errorMsg = collected.join('；');
+			}
+		}
+
+		switch (status) {
+			case 400:
+				console.error(errorMsg);
+				break;
+			case 401:
+				console.error('登录过期，请重新登录');
+				if (typeof window !== 'undefined' && window.location.pathname !== '/login') window.location.href = '/login';
+				break;
+			case 403:
+				console.error('服务器拒绝请求');
+				break;
+			case 404:
+				console.error('资源未找到');
+				break;
+			case 500:
+				console.error('服务器内部错误');
+				break;
+			case 502:
+				console.error('网关或代理服务器收到无效响应');
+				break;
+			case 503:
+				console.error('服务器暂时无法处理请求');
+				break;
+			default:
+				console.error(errorMsg);
+		}
+		return Promise.reject(error);
+	},
+);