@ikenxuan/amagi 5.12.1 → 5.13.0

package/dist/default/index.cjs

@@ -1,25 +1,39 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 const require_chunk = require('../chunk-CbDLau6x.cjs');
-let node_fs = require("node:fs");
-node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_url = require("node:url");
 node_url = require_chunk.__toESM(node_url);
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs);
 let chalk = require("chalk");
-let log4js = require("log4js");
-log4js = require_chunk.__toESM(log4js);
 let axios = require("axios");
 axios = require_chunk.__toESM(axios);
 let zod = require("zod");
 zod = require_chunk.__toESM(zod);
+let __ikenxuan_xhshow_ts = require("@ikenxuan/xhshow-ts");
+let protobufjs = require("protobufjs");
+protobufjs = require_chunk.__toESM(protobufjs);
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
-let __ikenxuan_xhshow_ts = require("@ikenxuan/xhshow-ts");
 let express = require("express");
 express = require_chunk.__toESM(express);
 
 //#region src/model/logger.ts
+/**
+* 动态获取 log4js 库
+* 优先使用 node-karin/log4js (Karin 环境)
+* 失败则回退到 log4js (独立环境，通过别名映射到 @karinjs/log4js)
+*/
+const getLog4js = async () => {
+	try {
+		return (await import("node-karin/log4js")).default;
+	} catch {
+		const lib = await import("log4js");
+		return lib.default || lib;
+	}
+};
+const log4jsPromise = getLog4js();
 /** 获取包的绝对路径 */
 const getPackageLogsPath = () => {
 	const currentFileUrl = require("url").pathToFileURL(__filename).href;
@@ -29,7 +43,11 @@ const getPackageLogsPath = () => {
 		if (node_fs.default.existsSync(node_path.default.join(packageRoot, "package.json"))) break;
 		packageRoot = node_path.default.dirname(packageRoot);
 	}
-	return node_path.default.join(packageRoot, "logs");
+	const logsDir = node_path.default.join(packageRoot, "logs");
+	try {
+		if (!node_fs.default.existsSync(logsDir)) node_fs.default.mkdirSync(logsDir, { recursive: true });
+	} catch (error) {}
+	return logsDir;
 };
 const logsPath = getPackageLogsPath();
 /** 获取日志级别，优先使用环境变量，默认为 info */
@@ -37,59 +55,65 @@ const getLogLevel = () => {
 	return process.env.LOG_LEVEL ?? "info";
 };
 const currentLogLevel = getLogLevel();
-log4js.default.configure({
-	appenders: {
-		console: {
-			type: "stdout",
-			layout: {
-				type: "pattern",
-				pattern: "%[[amagi][%d{hh:mm:ss.SSS}][%4.4p]%] %m"
-			}
-		},
-		command: {
-			type: "dateFile",
-			filename: node_path.default.join(logsPath, "application", "command"),
-			pattern: "yyyy-MM-dd.log",
-			numBackups: 15,
-			alwaysIncludePattern: true,
-			layout: {
-				type: "pattern",
-				pattern: "[%d{hh:mm:ss.SSS}][%4.4p] %m"
-			}
-		},
-		httpConsole: {
-			type: "stdout",
-			layout: {
-				type: "pattern",
-				pattern: "%[[amagi][%d{hh:mm:ss.SSS}][HTTP]%] %m"
-			}
-		},
-		httpRequest: {
-			type: "dateFile",
-			filename: node_path.default.join(logsPath, "http", "requests"),
-			pattern: "yyyy-MM-dd.log",
-			numBackups: 30,
-			alwaysIncludePattern: true,
-			layout: {
-				type: "pattern",
-				pattern: "[%d{hh:mm:ss.SSS}][%4.4p] %m"
-			}
-		}
-	},
-	categories: {
-		default: {
-			appenders: ["console", "command"],
-			level: currentLogLevel
-		},
-		http: {
-			appenders: ["httpConsole", "httpRequest"],
-			level: "debug"
-		}
-	},
-	pm2: true
-});
+/** 初始化 logger 配置 */
+const initLogger = () => {
+	log4jsPromise.then((log4js) => {
+		log4js.configure({
+			appenders: {
+				console: {
+					type: "stdout",
+					layout: {
+						type: "pattern",
+						pattern: "%[[amagi][%d{hh:mm:ss.SSS}][%4.4p]%] %m"
+					}
+				},
+				command: {
+					type: "dateFile",
+					filename: node_path.default.join(logsPath, "application", "command"),
+					pattern: "yyyy-MM-dd.log",
+					numBackups: 15,
+					alwaysIncludePattern: true,
+					layout: {
+						type: "pattern",
+						pattern: "[%d{hh:mm:ss.SSS}][%4.4p] %m"
+					}
+				},
+				httpConsole: {
+					type: "stdout",
+					layout: {
+						type: "pattern",
+						pattern: "%[[amagi][%d{hh:mm:ss.SSS}][HTTP]%] %m"
+					}
+				},
+				httpRequest: {
+					type: "dateFile",
+					filename: node_path.default.join(logsPath, "http", "requests"),
+					pattern: "yyyy-MM-dd.log",
+					numBackups: 30,
+					alwaysIncludePattern: true,
+					layout: {
+						type: "pattern",
+						pattern: "[%d{hh:mm:ss.SSS}][%4.4p] %m"
+					}
+				}
+			},
+			categories: {
+				default: {
+					appenders: ["console", "command"],
+					level: currentLogLevel
+				},
+				http: {
+					appenders: ["httpConsole", "httpRequest"],
+					level: "debug"
+				}
+			},
+			pm2: true
+		});
+	});
+};
 var CustomLogger = class {
 	logger;
+	queue = [];
 	chalk;
 	red;
 	green;
@@ -100,7 +124,10 @@ var CustomLogger = class {
 	white;
 	gray;
 	constructor(name) {
-		this.logger = log4js.default.getLogger(name);
+		log4jsPromise.then((log4js) => {
+			this.logger = log4js.getLogger(name);
+			this.flush();
+		});
 		this.chalk = new chalk.Chalk();
 		this.red = this.chalk.red;
 		this.green = this.chalk.green;
@@ -111,20 +138,31 @@ var CustomLogger = class {
 		this.white = this.chalk.white;
 		this.gray = this.chalk.gray;
 	}
+	flush() {
+		if (!this.logger) return;
+		while (this.queue.length) {
+			const [method, args] = this.queue.shift();
+			this.logger[method](...args);
+		}
+	}
+	proxy(method, args) {
+		if (this.logger) this.logger[method](...args);
+		else this.queue.push([method, args]);
+	}
 	info(message, ...args) {
-		this.logger.info(message, ...args);
+		this.proxy("info", [message, ...args]);
 	}
 	warn(message, ...args) {
-		this.logger.warn(message, ...args);
+		this.proxy("warn", [message, ...args]);
 	}
 	error(message, ...args) {
-		this.logger.error(message, ...args);
+		this.proxy("error", [message, ...args]);
 	}
 	mark(message, ...args) {
-		this.logger.mark(message, ...args);
+		this.proxy("mark", [message, ...args]);
 	}
 	debug(message, ...args) {
-		this.logger.debug(message, ...args);
+		this.proxy("debug", [message, ...args]);
 	}
 };
 const logger = new CustomLogger("default");
@@ -499,6 +537,11 @@ const BilibiliValidateCaptchaParamsSchema = zod.default.object({
 	validate: zod.default.string({ error: "验证码validate必须是字符串" }).min(1, { error: "验证码validate不能为空" }),
 	seccode: zod.default.string({ error: "验证码seccode必须是字符串" }).min(1, { error: "验证码seccode不能为空" })
 });
+const BilibiliDanmakuParamsSchema = zod.default.object({
+	methodType: zod.default.literal("实时弹幕", { error: "方法类型必须是\"实时弹幕\"" }),
+	cid: smartNumber("CID不能为空", 1, true),
+	segment_index: zod.default.coerce.number({ error: "分段序号必须是数字" }).int({ error: "分段序号必须是整数" }).positive({ error: "分段序号必须是正数" }).default(1).optional()
+});
 const BilibiliValidationSchemas = {
 	单个视频作品数据: BilibiliVideoParamsSchema,
 	单个视频下载信息数据: BilibiliVideoDownloadParamsSchema,
@@ -525,7 +568,8 @@ const BilibiliValidationSchemas = {
 	专栏文章基本信息: BilibiliArticleInfoParamsSchema,
 	文集基本信息: BilibiliColumnInfoParamsSchema,
 	从_v_voucher_申请_captcha: BilibiliApplyCaptchaParamsSchema,
-	验证验证码结果: BilibiliValidateCaptchaParamsSchema
+	验证验证码结果: BilibiliValidateCaptchaParamsSchema,
+	实时弹幕: BilibiliDanmakuParamsSchema
 };
 const BilibiliMethodRoutes = {
 	单个视频作品数据: "/fetch_one_video",
@@ -553,7 +597,8 @@ const BilibiliMethodRoutes = {
 	专栏文章基本信息: "/fetch_article_info",
 	文集基本信息: "/fetch_column_info",
 	从_v_voucher_申请_captcha: "/apply_captcha",
-	验证验证码结果: "/validate_captcha"
+	验证验证码结果: "/validate_captcha",
+	实时弹幕: "/fetch_danmaku"
 };
 
 //#endregion
@@ -723,51 +768,26 @@ var xiaohongshuSign = class {
 		return this.client.signXsPost(path$1, a1Cookie, clientType, body);
 	}
 	/**
-	* 生成X-S签名（兼容旧接口）
-	* @param url - 请求URL
-	* @param body - 请求体
-	* @param userAgent - User-Agent（暂未使用）
-	* @param method - 请求方法，默认为 'POST'
-	* @param a1Cookie - a1 cookie值
-	* @returns X-S签名
-	*/
-	static generateXS(url$1, body, userAgent, method = "POST", a1Cookie = "") {
-		try {
-			const urlObj = new URL(url$1);
-			const path$1 = urlObj.pathname + urlObj.search;
-			if (method.toUpperCase() === "GET") {
-				const params = typeof body === "object" ? body : {};
-				return this.generateXSGet(path$1, a1Cookie, "xhs-pc-web", params);
-			} else {
-				const requestBody = typeof body === "object" ? body : {};
-				return this.generateXSPost(path$1, a1Cookie, "xhs-pc-web", requestBody);
-			}
-		} catch (error) {
-			console.error("生成X-S签名失败:", error);
-			throw new Error(`签名生成失败: ${error}`);
-		}
-	}
-	/**
 	* 生成X-S-Common参数
-	* @param length - 长度
+	* @param cookies - cookie字符串
 	* @returns Base64编码的随机字符串
 	*/
-	static generateXSCommon(length = 945) {
-		return node_crypto.default.randomBytes(length).toString("base64").replace(/=+$/, "");
+	static generateXSCommon(cookies) {
+		return this.client.signXsCommon(cookies);
 	}
 	/**
 	* 生成X-T时间戳
 	* @returns 当前时间戳字符串
 	*/
 	static generateXT() {
-		return Date.now().toString();
+		return this.client.getXT();
 	}
 	/**
 	* 生成X-B3-Traceid
 	* @returns 16位随机字符串
 	*/
 	static generateXB3Traceid() {
-		return Array.from({ length: 16 }, () => "abcdef0123456789"[Math.floor(Math.random() * 16)]).join("");
+		return this.client.getB3TraceId();
 	}
 	/**
 	* 从cookie字符串中提取a1值
@@ -1153,7 +1173,7 @@ const isRecoverableError = (error) => {
 * 延迟函数
 * @param ms - 延迟毫秒数
 */
-const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const delay = (ms) => new Promise((resolve$1) => setTimeout(resolve$1, ms));
 /**
 * 创建网络错误响应
 * @param error - 错误对象
@@ -1253,7 +1273,8 @@ const fetchResponse = async (config, maxRetries = DEFAULT_MAX_RETRIES) => {
 * 判断结果是否为网络错误响应
 * @param result - 请求结果
 * @returns 是否为ErrorResult
-* @description 通过检查 error 字段中的 amagiError 来区分网络错误和业务错误
+* 
+* 通过检查 error 字段中的 amagiError 来区分网络错误和业务错误
 */
 const isNetworkErrorResult = (result) => {
 	if (result === null || typeof result !== "object") return false;
@@ -1522,6 +1543,17 @@ var BiLiBiLiAPI = class {
 			}
 		};
 	}
+	/**
+	* 获取实时弹幕（web端 protobuf 接口）
+	* @see https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/danmaku/danmaku_proto.md
+	*/
+	实时弹幕(data$1) {
+		return `https://api.bilibili.com/x/v2/dm/web/seg.so?${new URLSearchParams({
+			type: "1",
+			oid: data$1.cid.toString(),
+			segment_index: (data$1.segment_index ?? 1).toString()
+		}).toString()}`;
+	}
 };
 /** 该类下的所有方法只会返回拼接好参数后的 Url 地址，需要手动请求该地址以获取数据 */
 const bilibiliApiUrls = new BiLiBiLiAPI();
@@ -1586,7 +1618,8 @@ const bilibili = {
 	getColumnInfo: createBilibiliApiMethod("文集基本信息"),
 	getUserProfileDetail: createBilibiliApiMethod("用户空间详细信息"),
 	applyVoucherCaptcha: createBilibiliApiMethod("从_v_voucher_申请_captcha"),
-	validateCaptcha: createBilibiliApiMethod("验证验证码结果")
+	validateCaptcha: createBilibiliApiMethod("验证验证码结果"),
+	getDanmaku: createBilibiliApiMethod("实时弹幕")
 };
 /**
 * 创建绑定了cookie的B站API对象
@@ -1620,7 +1653,8 @@ const createBoundBilibiliApi = (cookie, requestConfig) => {
 		getColumnInfo: createBoundBilibiliApiMethod("文集基本信息", cookie),
 		getUserProfileDetail: createBoundBilibiliApiMethod("用户空间详细信息", cookie),
 		applyVoucherCaptcha: createBoundBilibiliApiMethod("从_v_voucher_申请_captcha", cookie),
-		validateCaptcha: createBoundBilibiliApiMethod("验证验证码结果", cookie)
+		validateCaptcha: createBoundBilibiliApiMethod("验证验证码结果", cookie),
+		getDanmaku: createBoundBilibiliApiMethod("实时弹幕", cookie)
 	};
 };
 
@@ -1676,6 +1710,101 @@ const bv2av = (bvid) => {
 	return Number(tmp & MASK_CODE ^ XOR_CODE);
 };
 
+//#endregion
+//#region src/platform/bilibili/sign/danmaku_proto.ts
+/**
+* B站弹幕 Protobuf 定义（内联）
+* @see https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/danmaku/danmaku_proto.md
+*/
+const DANMAKU_PROTO_JSON = { nested: { bilibili: { nested: { community: { nested: { service: { nested: { dm: { nested: { v1: { nested: {
+	DmSegMobileReply: { fields: { elems: {
+		rule: "repeated",
+		type: "DanmakuElem",
+		id: 1
+	} } },
+	DanmakuElem: { fields: {
+		id: {
+			type: "int64",
+			id: 1
+		},
+		progress: {
+			type: "int32",
+			id: 2
+		},
+		mode: {
+			type: "int32",
+			id: 3
+		},
+		fontsize: {
+			type: "int32",
+			id: 4
+		},
+		color: {
+			type: "uint32",
+			id: 5
+		},
+		midHash: {
+			type: "string",
+			id: 6
+		},
+		content: {
+			type: "string",
+			id: 7
+		},
+		ctime: {
+			type: "int64",
+			id: 8
+		},
+		weight: {
+			type: "int32",
+			id: 9
+		},
+		action: {
+			type: "string",
+			id: 10
+		},
+		pool: {
+			type: "int32",
+			id: 11
+		},
+		idStr: {
+			type: "string",
+			id: 12
+		},
+		attr: {
+			type: "int32",
+			id: 13
+		},
+		animation: {
+			type: "string",
+			id: 22
+		}
+	} }
+} } } } } } } } } } } };
+let DmSegMobileReplyType = null;
+/**
+* 获取 protobuf 类型定义
+*/
+function getProtoType() {
+	if (DmSegMobileReplyType) return DmSegMobileReplyType;
+	DmSegMobileReplyType = protobufjs.default.Root.fromJSON(DANMAKU_PROTO_JSON).lookupType("bilibili.community.service.dm.v1.DmSegMobileReply");
+	return DmSegMobileReplyType;
+}
+/**
+* 解析弹幕分段响应
+* @param data - 二进制 protobuf 数据
+* @returns 解析后的弹幕数据
+*/
+function parseDmSegMobileReply(data$1) {
+	const messageType = getProtoType();
+	const buffer = data$1 instanceof Uint8Array ? data$1 : new Uint8Array(data$1);
+	const message = messageType.decode(buffer);
+	return messageType.toObject(message, {
+		longs: String,
+		defaults: true
+	});
+}
+
 //#endregion
 //#region src/platform/bilibili/sign/wbi.ts
 /**
@@ -1975,6 +2104,7 @@ const bilibiliUtils = {
 		av2bv,
 		bv2av
 	},
+	danmaku: { parseDmSegMobileReply },
 	bilibiliApiUrls,
 	api: bilibili
 };
@@ -2314,6 +2444,48 @@ const fetchBilibili = async (data$1, cookie, requestConfig) => {
 			url: bilibiliApiUrls.验证验证码结果(data$1).Url,
 			data: bilibiliApiUrls.验证验证码结果(data$1).Body
 		});
+		case "实时弹幕": {
+			const url$1 = bilibiliApiUrls.实时弹幕({
+				cid: data$1.cid,
+				segment_index: data$1.segment_index
+			});
+			try {
+				const response = await fetchData({
+					...baseRequestConfig,
+					url: url$1,
+					responseType: "arraybuffer"
+				});
+				if (isNetworkErrorResult(response)) {
+					const networkError = new Error(response.error.amagiError.errorDescription);
+					Object.assign(networkError, {
+						code: response.error.code,
+						data: null,
+						amagiError: {
+							...response.error.amagiError,
+							requestType: data$1.methodType
+						}
+					});
+					throw networkError;
+				}
+				return {
+					code: 0,
+					message: "success",
+					data: { elems: parseDmSegMobileReply(response).elems }
+				};
+			} catch (error) {
+				if (error && typeof error === "object" && "code" in error) return error;
+				const Err = {
+					errorDescription: `获取弹幕数据失败：${error instanceof Error ? error.message : "未知错误"}`,
+					requestType: data$1.methodType,
+					requestUrl: url$1
+				};
+				return {
+					code: amagiAPIErrorCode.UNKNOWN,
+					data: null,
+					amagiError: Err
+				};
+			}
+		}
 		default:
 			logger.warn(`未知的B站数据接口：「${logger.red(data$1.methodType)}」`);
 			return null;
@@ -3659,11 +3831,53 @@ const DouyinData = async (data$1, cookie, requestConfig) => {
 		}
 		case "评论数据": {
 			const urlGenerator = (params) => douyinApiUrls$1.评论(params);
-			return await fetchPaginatedData(data$1.methodType, urlGenerator, data$1, 50, baseRequestConfig, signType);
+			return await fetchPaginatedData({
+				type: data$1.methodType,
+				apiUrlGenerator: urlGenerator,
+				params: {
+					...data$1,
+					cursor: data$1.cursor ?? 0
+				},
+				maxPageSize: 50,
+				requestConfig: baseRequestConfig,
+				signType,
+				extractList: (resp) => resp.comments ?? [],
+				updateParams: (params, resp) => ({
+					...params,
+					cursor: resp.cursor
+				}),
+				hasMore: (resp) => resp.has_more === 1,
+				formatFinalResponse: (resp, list) => ({
+					...resp,
+					comments: list,
+					cursor: resp.cursor ?? list.length
+				})
+			});
 		}
 		case "指定评论回复数据": {
 			const urlGenerator = (params) => douyinApiUrls$1.二级评论(params);
-			return await fetchPaginatedData(data$1.methodType, urlGenerator, data$1, 3, baseRequestConfig, "x_bogus");
+			return await fetchPaginatedData({
+				type: data$1.methodType,
+				apiUrlGenerator: urlGenerator,
+				params: {
+					...data$1,
+					cursor: data$1.cursor ?? 0
+				},
+				maxPageSize: 3,
+				requestConfig: baseRequestConfig,
+				signType: "x_bogus",
+				extractList: (resp) => resp.comments ?? [],
+				updateParams: (params, resp) => ({
+					...params,
+					cursor: resp.cursor
+				}),
+				hasMore: (resp) => resp.has_more === 1,
+				formatFinalResponse: (resp, list) => ({
+					...resp,
+					comments: list,
+					cursor: resp.cursor ?? list.length
+				})
+			});
 		}
 		case "用户主页数据": {
 			const url$1 = douyinApiUrls$1.用户主页信息({ sec_uid: data$1.sec_uid });
@@ -3715,10 +3929,6 @@ const DouyinData = async (data$1, cookie, requestConfig) => {
 			});
 		}
 		case "搜索数据": {
-			let search_id = "";
-			const maxPageSize = 15;
-			let fetchedSearchList = [];
-			let tmpresp = null;
 			const searchType = data$1.type ?? "综合";
 			const refererUrl = searchType === "用户" ? `https://www.douyin.com/search/${encodeURIComponent(String(data$1.query))}?type=user` : searchType === "视频" ? `https://www.douyin.com/search/${encodeURIComponent(String(data$1.query))}?type=video` : `https://www.douyin.com/root/search/${encodeURIComponent(String(data$1.query))}`;
 			const customConfig = {
@@ -3730,146 +3940,82 @@ const DouyinData = async (data$1, cookie, requestConfig) => {
 			};
 			const isUserSearch = searchType === "用户";
 			const isVideoSearch = searchType === "视频";
-			let isFirstRequest = true;
-			while (fetchedSearchList.length < Number(data$1.number ?? 10)) {
-				const requestCount = Math.min(Number(data$1.number ?? 50) - fetchedSearchList.length, maxPageSize);
-				const url$1 = douyinApiUrls$1.搜索({
+			return await fetchPaginatedData({
+				type: data$1.methodType,
+				apiUrlGenerator: (params) => douyinApiUrls$1.搜索(params),
+				params: {
 					query: data$1.query,
 					type: data$1.type,
-					number: requestCount,
-					search_id: search_id === "" ? void 0 : search_id
-				});
-				const raw = await GlobalGetData$2(data$1.methodType, {
-					...customConfig,
-					url: url$1
-				});
-				if (isUserSearch) {
-					if (!raw || typeof raw !== "object") {
-						const Err = {
-							errorDescription: "抖音用户搜索返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
-						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("用户搜索返回无有效数据，疑似触发反爬机制")}
-            请求类型：「${data$1.methodType}」
-            搜索关键词：「${data$1.query}」
-            请求URL：${url$1}
-            `;
-						!isFirstRequest && logger.warn(warningMessage);
-						return {
-							code: douoyinAPIErrorCode.COOKIE,
-							data: raw,
-							amagiError: Err,
-							amagiMessage: warningMessage
-						};
-					}
-					const userList = raw.user_list;
-					if (isFirstRequest && (!userList || userList.length === 0)) {
-						const Err = {
-							errorDescription: "抖音用户搜索接口第一次请求就返回空数组，可能该关键词无搜索结果或触发风控限制，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
-						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("用户搜索接口第一次请求就返回空数组，你的抖音Cookie可能已经失效！")}
-            请求类型：「${data$1.methodType}」
-            搜索关键词：「${data$1.query}」
-            请求URL：${url$1}
-            `;
-						logger.warn(warningMessage);
-						return {
-							data: raw,
-							amagiError: Err,
-							amagiMessage: warningMessage
-						};
-					}
-					if (Array.isArray(userList) && userList.length > 0) fetchedSearchList.push(...userList);
-					tmpresp = raw;
-					search_id = raw.rid ?? search_id;
-					if (typeof raw.has_more === "number" && raw.has_more === 0) break;
-					if (!userList || userList.length === 0) break;
-				} else if (isVideoSearch) {
-					if (!raw || typeof raw !== "object") {
-						const Err = {
-							errorDescription: "抖音视频搜索接口返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
-						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("视频搜索接口返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效！")}
-            请求类型：「${data$1.methodType}」
-            搜索关键词：「${data$1.query}」
-            请求URL：${url$1}
-            `;
-						!isFirstRequest && logger.warn(warningMessage);
-						return {
-							code: douoyinAPIErrorCode.COOKIE,
-							data: raw,
-							amagiError: Err,
-							amagiMessage: warningMessage
-						};
-					}
-					const videoList = raw.data;
-					if (isFirstRequest && (!videoList || videoList.length === 0)) {
-						const Err = {
-							errorDescription: "抖音视频搜索接口第一次请求就返回空数组，可能该关键词无搜索结果或触发风控限制，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
-						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("视频搜索接口第一次请求就返回空数组，你的抖音Cookie可能已经失效！")}
-            请求类型：「${data$1.methodType}」
-            搜索关键词：「${data$1.query}」
-            请求URL：${url$1}
-            `;
-						logger.warn(warningMessage);
+					number: data$1.number ?? 10,
+					search_id: ""
+				},
+				maxPageSize: 15,
+				requestConfig: customConfig,
+				signType: null,
+				processRawResponse: (raw) => {
+					if (!isUserSearch && !isVideoSearch) {
+						const responses = filterSearchResponses(typeof raw === "string" ? parseDouyinMultiJson(raw) : [raw]);
+						if (responses.length === 0) return raw;
+						const mergedData = [];
+						let lastValid = {};
+						for (const resp of responses) {
+							if (Array.isArray(resp.data) && resp.data.length > 0) mergedData.push(...resp.data);
+							lastValid = resp;
+						}
 						return {
-							data: raw,
-							amagiError: Err,
-							amagiMessage: warningMessage
+							...lastValid,
+							data: mergedData
 						};
 					}
-					if (Array.isArray(videoList) && videoList.length > 0) fetchedSearchList.push(...videoList);
-					tmpresp = raw;
-					search_id = raw.log_pb?.impr_id ?? search_id;
-					if (typeof raw.has_more === "number" && raw.has_more === 0) break;
-					if (!videoList || videoList.length === 0) break;
-				} else {
-					const responses = filterSearchResponses(typeof raw === "string" ? parseDouyinMultiJson(raw) : [raw]);
-					if (responses.length === 0) {
-						const Err = {
-							errorDescription: "抖音综合搜索接口返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
+					return raw;
+				},
+				extractList: (resp) => {
+					if (isUserSearch) return resp.user_list ?? [];
+					return resp.data ?? [];
+				},
+				updateParams: (params, resp) => {
+					let nextSearchId = params.search_id;
+					if (isUserSearch) nextSearchId = resp.rid ?? nextSearchId;
+					else nextSearchId = resp.log_pb?.impr_id ?? nextSearchId;
+					return {
+						...params,
+						search_id: nextSearchId
+					};
+				},
+				hasMore: (resp) => {
+					return resp.has_more !== 0;
+				},
+				validateFirstPage: (list, raw, url$1) => {
+					const typeStr = isUserSearch ? "用户" : isVideoSearch ? "视频" : "综合";
+					let isInvalidResponse = false;
+					const rawAny = raw;
+					if (!rawAny || typeof rawAny !== "object") isInvalidResponse = true;
+					else if (isUserSearch && !rawAny.user_list) isInvalidResponse = true;
+					else if (isVideoSearch && !rawAny.data) isInvalidResponse = true;
+					else if (!isUserSearch && !isVideoSearch && !rawAny.data) isInvalidResponse = true;
+					if (isInvalidResponse) {
+						const desc = `抖音${typeStr}搜索返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效！`;
 						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("综合搜索接口返回无有效数据，疑似触发反爬机制，你的抖音Cookie可能已经失效！")}
+            获取响应数据失败！原因：${logger.yellow(`${typeStr}搜索返回无有效数据，疑似触发反爬机制`)}
             请求类型：「${data$1.methodType}」
             搜索关键词：「${data$1.query}」
             请求URL：${url$1}
             `;
-						!isFirstRequest && logger.warn(warningMessage);
 						return {
 							code: douoyinAPIErrorCode.COOKIE,
 							data: raw,
-							amagiError: Err,
+							amagiError: {
+								errorDescription: desc,
+								requestType: data$1.methodType ?? "未知请求类型",
+								requestUrl: url$1
+							},
 							amagiMessage: warningMessage
 						};
 					}
-					for (const resp of responses) {
-						if (Array.isArray(resp.data) && resp.data.length > 0) fetchedSearchList.push(...resp.data);
-						tmpresp = resp;
-						search_id = resp.log_pb?.impr_id ?? search_id;
-					}
-					if (isFirstRequest && fetchedSearchList.length === 0) {
-						const Err = {
-							errorDescription: "抖音综合搜索接口第一次请求就返回空数组，可能该关键词无搜索结果或触发风控限制，你的抖音Cookie可能已经失效！",
-							requestType: data$1.methodType ?? "未知请求类型",
-							requestUrl: url$1
-						};
+					if (!list || list.length === 0) {
+						const desc = `抖音${typeStr}搜索接口第一次请求就返回空数组，可能该关键词无搜索结果或触发风控限制，你的抖音Cookie可能已经失效！`;
 						const warningMessage = `
-            获取响应数据失败！原因：${logger.yellow("综合搜索索接第一次请求就返回空数组，你的抖音Cookie可能已经失效！")}
+            获取响应数据失败！原因：${logger.yellow(`${typeStr}搜索接口第一次请求就返回空数组，你的抖音Cookie可能已经失效！`)}
             请求类型：「${data$1.methodType}」
             搜索关键词：「${data$1.query}」
             请求URL：${url$1}
@@ -3877,25 +4023,27 @@ const DouyinData = async (data$1, cookie, requestConfig) => {
 						logger.warn(warningMessage);
 						return {
 							data: raw,
-							amagiError: Err,
+							amagiError: {
+								errorDescription: desc,
+								requestType: data$1.methodType ?? "未知请求类型",
+								requestUrl: url$1
+							},
 							amagiMessage: warningMessage
 						};
 					}
-					if (tmpresp && typeof tmpresp.has_more === "number" && tmpresp.has_more === 0) break;
+					return null;
+				},
+				formatFinalResponse: (resp, list) => {
+					if (isUserSearch) return {
+						...resp,
+						user_list: list
+					};
+					return {
+						...resp,
+						data: list
+					};
 				}
-				isFirstRequest = false;
-			}
-			const slicedList = Number(data$1.number ?? 10) === 0 ? [] : fetchedSearchList.slice(0, Number(data$1.number ?? 10));
-			return isUserSearch ? {
-				...tmpresp ?? {},
-				user_list: slicedList
-			} : isVideoSearch ? {
-				...tmpresp ?? {},
-				data: slicedList
-			} : {
-				...tmpresp ?? {},
-				data: slicedList
-			};
+			});
 		}
 		case "动态表情数据": {
 			const url$1 = douyinApiUrls$1.互动表情();
@@ -4031,40 +4179,48 @@ const DouyinData = async (data$1, cookie, requestConfig) => {
 };
 /**
 * 通用的分页请求函数
-* @param type - 请求类型
-* @param apiUrlGenerator - 接口URL生成器
-* @param params - 请求参数
-* @param maxPageSize - 单次请求的最大数据量
-* @param requestConfig - axios请求配置（外部配置优先）
-* @param signType - 签名算法类型
-* @returns 返回分页数据
+* 封装了循环分页请求、数据合并、错误处理和反爬检测逻辑
+*
+* @template T - 列表项类型
+* @template P - 参数类型
+* @template R - 返回值类型
+* @template RawResp - 原始响应类型
+* @param config - 分页请求配置对象
+* @returns Promise<R> 返回最终构造的数据对象
 */
-const fetchPaginatedData = async (type, apiUrlGenerator, params, maxPageSize, requestConfig, signType = "a_bogus") => {
-	let cursor = params.cursor ?? 0;
-	let fetchedData = [];
-	let tmpresp = {};
+const fetchPaginatedData = async (config) => {
+	const { type, apiUrlGenerator, params, maxPageSize, requestConfig, signType = "a_bogus", extractList, updateParams, hasMore, formatFinalResponse, processRawResponse, validateFirstPage } = config;
+	let currentParams = { ...params };
+	const fetchedData = [];
+	let lastResponse = {};
+	let isFirstRequest = true;
 	const userAgent = requestConfig.headers?.["User-Agent"];
-	while (fetchedData.length < Number(params.number ?? maxPageSize)) {
-		const requestCount = Math.min(Number(params.number ?? maxPageSize) - fetchedData.length, maxPageSize);
-		const url$1 = apiUrlGenerator({
-			...params,
-			number: requestCount,
-			cursor
-		});
-		const response = await GlobalGetData$2(type, {
+	const targetNumber = Number(params.number ?? maxPageSize);
+	while (fetchedData.length < targetNumber) {
+		const remaining = targetNumber - fetchedData.length;
+		currentParams.number = Math.min(remaining, maxPageSize);
+		const url$1 = apiUrlGenerator(currentParams);
+		const finalUrl = signType ? buildSignedUrl(url$1, signType, userAgent) : url$1;
+		const raw = await GlobalGetData$2(type, {
 			...requestConfig,
-			url: buildSignedUrl(url$1, signType, userAgent)
+			url: finalUrl
 		});
-		fetchedData.push(...response.comments ?? response.data ?? []);
-		tmpresp = response;
-		if ((response.comments ?? response.data ?? []).length < requestCount) break;
-		cursor = response.cursor;
+		const response = processRawResponse ? processRawResponse(raw) : raw;
+		if (response && response.amagiError) return response;
+		const list = extractList(response);
+		if (isFirstRequest && validateFirstPage) {
+			const error = validateFirstPage(list, response, finalUrl);
+			if (error) return error;
+		}
+		if (Array.isArray(list) && list.length > 0) fetchedData.push(...list);
+		lastResponse = response;
+		if (!hasMore(response)) break;
+		if (!list || list.length === 0) break;
+		currentParams = updateParams(currentParams, response);
+		isFirstRequest = false;
 	}
-	return {
-		...tmpresp,
-		comments: params.number === 0 ? [] : fetchedData.slice(0, Number(params.number ?? maxPageSize)),
-		cursor: params.number === 0 ? 0 : fetchedData.length
-	};
+	const slicedData = targetNumber === 0 ? [] : fetchedData.slice(0, targetNumber);
+	return formatFinalResponse(lastResponse, slicedData);
 };
 /**
 * 全局数据获取函数
@@ -4373,7 +4529,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 			headers: {
 				...baseRequestConfig.headers,
 				"x-s": xiaohongshuSign.generateXSPost(xiaohongshuApiUrls$1.首页推荐数据(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web", xiaohongshuApiUrls$1.首页推荐数据(data$1).Body),
-				"x-s-common": xiaohongshuSign.generateXSCommon(),
+				"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 				"x-t": xiaohongshuSign.generateXT()
 			}
 		});
@@ -4384,7 +4540,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 			headers: {
 				...baseRequestConfig.headers,
 				"x-s": xiaohongshuSign.generateXSPost(xiaohongshuApiUrls$1.单个笔记数据(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web", xiaohongshuApiUrls$1.单个笔记数据(data$1).Body),
-				"x-s-common": xiaohongshuSign.generateXSCommon(),
+				"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 				"x-t": xiaohongshuSign.generateXT()
 			}
 		});
@@ -4404,7 +4560,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 				headers: {
 					...baseRequestConfig$1.headers,
 					"x-s": xiaohongshuSign.generateXSGet(xiaohongshuApiUrls$1.评论数据(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web"),
-					"x-s-common": xiaohongshuSign.generateXSCommon(),
+					"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 					"x-t": xiaohongshuSign.generateXT()
 				}
 			});
@@ -4427,7 +4583,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 					headers: {
 						...baseRequestConfig$1.headers,
 						"x-s": xiaohongshuSign.generateXSGet(xiaohongshuApiUrls$1.用户数据(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web"),
-						"x-s-common": xiaohongshuSign.generateXSCommon(),
+						"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 						"x-t": xiaohongshuSign.generateXT()
 					}
 				})),
@@ -4442,7 +4598,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 				...baseRequestConfig.headers,
 				"x-b3-traceid": xiaohongshuSign.generateXB3Traceid(),
 				"x-s": xiaohongshuSign.generateXSGet(xiaohongshuApiUrls$1.用户笔记数据(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web"),
-				"x-s-common": xiaohongshuSign.generateXSCommon(),
+				"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 				"x-t": xiaohongshuSign.generateXT()
 			}
 		});
@@ -4462,7 +4618,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 				headers: {
 					...baseRequestConfig$1.headers,
 					"x-s": xiaohongshuSign.generateXSGet(xiaohongshuApiUrls$1.表情列表(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web"),
-					"x-s-common": xiaohongshuSign.generateXSCommon(),
+					"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 					"x-t": xiaohongshuSign.generateXT()
 				}
 			});
@@ -4474,7 +4630,7 @@ const XiaohongshuData = async (data$1, cookie, requestConfig) => {
 			headers: {
 				...baseRequestConfig.headers,
 				"x-s": xiaohongshuSign.generateXSPost(xiaohongshuApiUrls$1.搜索笔记(data$1).apiPath, xiaohongshuSign.extractA1FromCookie(cookie ?? ""), "xhs-pc-web"),
-				"x-s-common": xiaohongshuSign.generateXSCommon(),
+				"x-s-common": xiaohongshuSign.generateXSCommon(cookie ?? ""),
 				"x-t": xiaohongshuSign.generateXT()
 			}
 		});
@@ -4966,6 +5122,7 @@ const createAmagiClient = (options) => {
 	* @returns Express应用实例
 	*/
 	const startServer = (port = 4567) => {
+		initLogger();
 		const app = (0, express.default)();
 		app.use(express.default.json());
 		app.use(express.default.urlencoded({ extended: true }));
@@ -5183,7 +5340,14 @@ let DynamicType = /* @__PURE__ */ function(DynamicType$1) {
 
 //#endregion
 //#region src/index.ts
-const VERSION = "5.12.1";
+/**
+* 获取版本号
+* 构建后使用 __VERSION__，开发环境从 package.json 读取
+*/
+const getVersion = () => {
+	return "5.13.0";
+};
+const VERSION = getVersion();
 /**
 * @deprecated 请使用 createAmagiClient 替代
 */
@@ -5232,6 +5396,7 @@ exports.BilibiliBv2AvParamsSchema = BilibiliBv2AvParamsSchema;
 exports.BilibiliColumnInfoParamsSchema = BilibiliColumnInfoParamsSchema;
 exports.BilibiliCommentParamsSchema = BilibiliCommentParamsSchema;
 exports.BilibiliCommentReplyParamsSchema = BilibiliCommentReplyParamsSchema;
+exports.BilibiliDanmakuParamsSchema = BilibiliDanmakuParamsSchema;
 exports.BilibiliDynamicParamsSchema = BilibiliDynamicParamsSchema;
 exports.BilibiliEmojiParamsSchema = BilibiliEmojiParamsSchema;
 exports.BilibiliLiveParamsSchema = BilibiliLiveParamsSchema;
@@ -5302,12 +5467,14 @@ exports.getHeadersAndData = getHeadersAndData;
 exports.getKuaishouData = getKuaishouData;
 exports.handleError = handleError;
 exports.httpLogger = httpLogger;
+exports.initLogger = initLogger;
 exports.isNetworkErrorResult = isNetworkErrorResult;
 exports.kuaishou = kuaishou;
 exports.kuaishouApiUrls = kuaishouApiUrls;
 exports.kuaishouUtils = kuaishouUtils;
 exports.logMiddleware = logMiddleware;
 exports.logger = logger;
+exports.parseDmSegMobileReply = parseDmSegMobileReply;
 exports.qtparam = qtparam;
 exports.registerBilibiliRoutes = createBilibiliRoutes;
 exports.registerDouyinRoutes = createDouyinRoutes;