@ikenxuan/amagi 7.0.0-beta.6 → 7.0.0-beta.7

package/dist/{src-e3JbCbbg.cjs → src-CNU3-zoM.cjs}

@@ -15,6 +15,78 @@ axios = require_rolldown_runtime.__toESM(axios, 1);
 let node_events = require("node:events");
 let _ikenxuan_xhshow_ts = require("@ikenxuan/xhshow-ts");
 //#region src/platforms/bilibili/api.ts
+/**
+* B站评论区类型代码（`comments` / `commentReplies` 的 `type` 参数）。
+*
+* 完整对照表（部分 oid 含义官方未明确，转写自 bilibili-API-collect）：
+*
+* | 代码 | 评论区类型 | oid 的意义 |
+* | --- | --- | --- |
+* | 1 | 视频稿件 | 稿件 avid |
+* | 2 | 话题 | 话题 id |
+* | 4 | 活动 | 活动 id |
+* | 5 | 小视频 | 小视频 id |
+* | 6 | 小黑屋封禁信息 | 封禁公示 id |
+* | 7 | 公告信息 | 公告 id |
+* | 8 | 直播活动 | 直播间 id |
+* | 9 | 活动稿件 | (?) |
+* | 10 | 直播公告 | (?) |
+* | 11 | 相簿（图片动态） | 相簿 id |
+* | 12 | 专栏 | 专栏 cvid |
+* | 13 | 票务 | (?) |
+* | 14 | 音频 | 音频 auid |
+* | 15 | 风纪委员会 | 众裁项目 id |
+* | 16 | 点评 | (?) |
+* | 17 | 动态（纯文字动态&分享） | 动态 id |
+* | 18 | 播单 | (?) |
+* | 19 | 音乐播单 | (?) |
+* | 20 | 漫画 | (?) |
+* | 21 | 漫画 | (?) |
+* | 22 | 漫画 | 漫画 mcid |
+* | 33 | 课程 | 课程 epid |
+*
+* @see https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/comment/readme.md#%E8%AF%84%E8%AE%BA%E5%8C%BA%E7%B1%BB%E5%9E%8B%E4%BB%A3%E7%A0%81
+*/
+const commentTypeUnion = zod.default.union([
+	zod.default.literal(1),
+	zod.default.literal(2),
+	zod.default.literal(4),
+	zod.default.literal(5),
+	zod.default.literal(6),
+	zod.default.literal(7),
+	zod.default.literal(8),
+	zod.default.literal(9),
+	zod.default.literal(10),
+	zod.default.literal(11),
+	zod.default.literal(12),
+	zod.default.literal(13),
+	zod.default.literal(14),
+	zod.default.literal(15),
+	zod.default.literal(16),
+	zod.default.literal(17),
+	zod.default.literal(18),
+	zod.default.literal(19),
+	zod.default.literal(20),
+	zod.default.literal(21),
+	zod.default.literal(22),
+	zod.default.literal(33)
+], { error: "无效的评论区类型" });
+/**
+* `type` 参数的完整 schema：HTTP query 的字符串先 coerce 成数字，再 pipe 进合法代码
+* 联合收窄 —— SDK 签名拿到的是 `CommentType` 而不是裸 `number`，非法代码报
+* 「无效的评论区类型」。`zod.enum` 在 zod 4.6.5 不接受数字数组（values 恒空、恒报错），
+* 所以用 literal 联合。
+*/
+const commentTypeSchema = zod.default.coerce.number().pipe(commentTypeUnion);
+/** `mode` 的合法值联合：0/1/2/3 之外（含 coerce 出的 NaN）统一报错 */
+const commentModeUnion = zod.default.union([
+	zod.default.literal(0),
+	zod.default.literal(1),
+	zod.default.literal(2),
+	zod.default.literal(3)
+], { error: "排序方式只能是 0、1、2、3" });
+/** `mode` 参数的完整 schema：coerce + 收窄到 `0 | 1 | 2 | 3` */
+const commentModeSchema = zod.default.coerce.number().pipe(commentModeUnion);
 /** B站 API URL 构建类（所有方法只拼 URL，不发起请求） */
 var BilibiliAPI$1 = class {
 	/** 获取登录基本信息 */
@@ -210,6 +282,36 @@ const stepsToSigner = (steps) => {
 * @param def - 端点声明
 */
 const defineEndpoint = (def) => def;
+/**
+* 标记一个端点参数为「内部参数」。
+*
+* 内部参数照常参与 zod 校验、`paginate.nextParams` 的写入与 URL 构造，但三个消费点
+* 都看不见它：
+* - **调用方签名**（fetcher / 静态 fetcher 的 options，见 `PublicParamsOf`）——对象
+*   字面量里传入会被 excess property check 拒掉；
+* - **openapi 的 query parameters**（`parametersOf` 经 `internalParamKeysOf` 过滤）；
+* - **文档参数表**（生成器读 openapi 产物，随上一条自动跟随）。
+*
+* 标记与字段声明焊在同一个表达式里（`pagination_str: internalParam(...)`），不存在
+* 「写了字段忘了登记到某张清单」的漂移面 —— 这也是它不做成 EndpointDef 字段的理由：
+* def 上已经够多键了，而且分离的清单必然漂移。运行时经 `.meta()` 挂进 zod 全局
+* registry（文档生成器已在用 meta 传 examples，同一机制）。
+*/
+const internalParam = (schema) => schema.meta({ amagiInternal: true });
+/**
+* 运行时判断一个 params 字段是否内部参数（openapi 生成器的过滤依据）。
+*
+* 读 `.meta()` 而不是别的运行时痕迹：meta 是 zod 官方的元数据通道，克隆与管道都保留。
+*/
+const isInternalParam = (schema) => {
+	return (schema?.meta?.())?.amagiInternal === true;
+};
+/** 端点 params 里全部内部参数的键名（运行时）。非 object schema 返回空集 */
+const internalParamKeysOf = (params) => {
+	const shape = params.shape;
+	if (shape === void 0) return /* @__PURE__ */ new Set();
+	return new Set(Object.keys(shape).filter((key) => isInternalParam(shape[key])));
+};
 //#endregion
 //#region src/platforms/bilibili/endpoints/define.ts
 /**
@@ -514,45 +616,17 @@ const commentReplies$1 = defineBilibiliEndpoint({
 	},
 	params: zod.default.object({
 		oid: zod.default.string().min(1, { error: "OID不能为空" }).describe("目标对象 ID，视频稿件填 avid"),
-		type: zod.default.coerce.number().int().min(1).refine((val) => COMMENT_TYPES$1.includes(val), { error: "无效的评论区类型" }).describe("评论区类型，视频稿件填 1"),
+		type: commentTypeSchema.describe("评论区类型代码：1 视频稿件（oid=avid）、11 相簿/图片动态、12 专栏（cvid）、17 动态等；完整对照表见 bilibili-API-collect「评论区类型代码」"),
 		root: zod.default.string().min(1, { error: "根评论ID不能为空" }).describe("根评论 ID，即要展开的一级评论"),
 		number: zod.default.coerce.number().int().positive().default(20).optional().describe("该根评论下的回复条数，不翻页，默认 20")
 	}),
 	build: (p) => ({
 		method: "GET",
-		url: bilibiliApiUrls$1.getCommentReplies({
-			...p,
-			type: p.type
-		})
+		url: bilibiliApiUrls$1.getCommentReplies(p)
 	}),
 	retryOn: ["RISK_CONTROL"],
 	response: type()
 });
-/** 评论区类型枚举 */
-const COMMENT_TYPES$1 = [
-	1,
-	2,
-	4,
-	5,
-	6,
-	7,
-	8,
-	9,
-	10,
-	11,
-	12,
-	13,
-	14,
-	15,
-	16,
-	17,
-	18,
-	19,
-	20,
-	21,
-	22,
-	33
-];
 //#endregion
 //#region src/platforms/bilibili/endpoints/comments.ts
 /**
@@ -577,21 +651,17 @@ const comments$2 = defineBilibiliEndpoint({
 	},
 	params: zod.default.object({
 		oid: zod.default.string().min(1, { error: "OID不能为空" }).describe("目标对象 ID，视频稿件填 avid"),
-		type: zod.default.coerce.number().int().min(1).refine((val) => COMMENT_TYPES.includes(val), { error: "无效的评论区类型" }).describe("评论区类型，视频稿件填 1"),
+		type: commentTypeSchema.describe("评论区类型代码：1 视频稿件（oid=avid）、2 话题、11 相簿/图片动态、12 专栏（cvid）、14 音频（auid）、17 动态、33 课程（epid）等；完整对照表见 bilibili-API-collect「评论区类型代码」"),
 		number: zod.default.coerce.number().int().positive().default(20).optional().describe("目标条数，自动翻页合并后去重，默认 20"),
-		mode: zod.default.coerce.number().int().min(0).max(3).optional().describe("排序方式，默认 3"),
-		pagination_str: zod.default.string().optional().describe("翻页游标，由端点接管，不用传"),
+		mode: commentModeSchema.optional().describe("排序方式：0 和 3 仅热度，1 按热度+按时间，2 仅时间；默认 3"),
+		pagination_str: internalParam(zod.default.string().optional().describe("翻页游标，由端点接管，不用传")),
 		plat: zod.default.coerce.number().int().optional().describe("平台类型，默认 1"),
 		seek_rpid: zod.default.string().optional().describe("定位到某条评论，默认空"),
 		web_location: zod.default.string().optional().describe("web 位置参数，默认 1315875")
 	}),
 	build: (p) => ({
 		method: "GET",
-		url: bilibiliApiUrls$1.getComments({
-			...p,
-			type: p.type,
-			mode: p.mode
-		})
+		url: bilibiliApiUrls$1.getComments(p)
 	}),
 	sign: [require_steps.wbi()],
 	paginate: {
@@ -622,31 +692,6 @@ const comments$2 = defineBilibiliEndpoint({
 	retryOn: ["RISK_CONTROL"],
 	response: type()
 });
-/** 评论区类型枚举 */
-const COMMENT_TYPES = [
-	1,
-	2,
-	4,
-	5,
-	6,
-	7,
-	8,
-	9,
-	10,
-	11,
-	12,
-	13,
-	14,
-	15,
-	16,
-	17,
-	18,
-	19,
-	20,
-	21,
-	22,
-	33
-];
 //#endregion
 //#region src/platforms/bilibili/endpoints/dynamicDetail.ts
 /**
@@ -1388,7 +1433,7 @@ var TypedEventEmitter = class extends node_events.EventEmitter {
 * @description 单例模式，所有模块共享同一个事件总线
 * @example
 * ```typescript
-* import { amagiEvents } from '../model/events'
+* import { amagiEvents } from '@ikenxuan/amagi'
 *
 * // 监听 API 成功事件
 * amagiEvents.on('api:success', (data) => {
@@ -3786,7 +3831,15 @@ const SUCCESS_MESSAGE = "获取成功";
 * `T | undefined`）。数组回调里没有 `if` 可用，`filter` 又只认类型谓词
 * —— 这就是必须有守卫的场景：
 *
-* ```ts
+* ```ts twoslash
+* import { isSuccess, type AmagiResult } from '@ikenxuan/amagi'
+*
+* declare const ids: string[]
+* declare const fetchOne: (id: string) => Promise<AmagiResult<Work>>
+* interface Work {
+*   id: string
+* }
+*
 * const list: AmagiResult<Work>[] = await Promise.all(ids.map(fetchOne))
 * const works = list.filter(isSuccess).map((r) => r.data)   // Work[]
 * ```
@@ -4112,6 +4165,37 @@ const resolveSigner = (decl, signers) => {
 	return signer;
 };
 /**
+* 限额并发地跑异步任务，结果按 `items` 下标顺序收齐（单任务结局语义同
+* `Promise.allSettled`）。
+*
+* 派发顺序仍按 `items` 顺序（FIFO），只是同时在途的不超过 `limit`。单个任务的
+* 抛错经 `then` 的第二参落进对应下标、不惊动其它任务 —— 不写 `try/catch` 是因为
+* execute 的「唯一一处 catch」是源码级契约（execute.test.ts 有断言），这里与
+* `Promise.allSettled` 同构即可。
+*/
+const settledWithConcurrency = async (items, limit, task) => {
+	const queue = items.map((item, index) => ({
+		item,
+		index
+	})).reverse();
+	const settled = new Array(items.length);
+	const worker = async () => {
+		while (true) {
+			const job = queue.pop();
+			if (job === void 0) return;
+			settled[job.index] = await task(job.item, job.index).then((value) => ({
+				status: "fulfilled",
+				value
+			}), (reason) => ({
+				status: "rejected",
+				reason
+			}));
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+	return settled;
+};
+/**
 * 执行一条端点声明，产出信封。
 *
 * **永不 reject。** 唯一的例外是调用方自己传入的回调抛出（如会话的
@@ -4297,15 +4381,18 @@ const execute = async (def, input, options) => {
 		const isMulti = signed.length > 1 || Array.isArray(built);
 		const reason = isMulti ? "segment" : "initial";
 		const tolerate = def.partial === "tolerate";
+		const settled = await settledWithConcurrency(signed, 10, (spec, index) => runSpec(spec, reason, refreshFor(params, index)));
 		let outcomes;
 		if (tolerate) {
-			outcomes = (await Promise.allSettled(signed.map((spec, index) => runSpec(spec, reason, refreshFor(params, index))))).map((r) => r.status === "fulfilled" ? r.value : {
+			outcomes = settled.map((r) => r.status === "fulfilled" ? r.value : {
 				ok: false,
 				error: classifyThrown(r.reason, "send")
 			});
 			if (outcomes.every((o) => !o.ok)) return failWith(outcomes[0].error);
 		} else {
-			outcomes = await Promise.all(signed.map((spec, index) => runSpec(spec, reason, refreshFor(params, index))));
+			const rejected = settled.find((r) => r.status === "rejected");
+			if (rejected) throw rejected.reason;
+			outcomes = settled.map((r) => r.value);
 			const firstFailure = outcomes.find((o) => !o.ok);
 			if (firstFailure) return failWith(firstFailure.error);
 		}
@@ -5254,7 +5341,7 @@ const commentReplies = defineDouyinEndpoint({
 		aweme_id: zod.default.string().min(1, { error: "作品ID不能为空" }).describe("作品 ID"),
 		comment_id: zod.default.string().min(1, { error: "评论ID不能为空" }).describe("要取回复的评论 ID"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 3"),
-		cursor: zod.default.coerce.number().int().min(0).optional().describe("翻页游标，一般不用传")
+		cursor: internalParam(zod.default.coerce.number().int().min(0).optional().describe("翻页游标，一般不用传"))
 	}),
 	build: (p) => ({
 		method: "GET",
@@ -5298,7 +5385,7 @@ const comments$1 = defineDouyinEndpoint({
 	params: zod.default.object({
 		aweme_id: zod.default.string().min(1, { error: "作品ID不能为空" }).describe("作品 ID"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 50"),
-		cursor: zod.default.coerce.number().int().min(0).optional().describe("翻页游标，一般不用传")
+		cursor: internalParam(zod.default.coerce.number().int().min(0).optional().describe("翻页游标，一般不用传"))
 	}),
 	build: (p) => ({
 		method: "GET",
@@ -5326,9 +5413,21 @@ const comments$1 = defineDouyinEndpoint({
 //#endregion
 //#region src/platforms/douyin/endpoints/danmakuList.ts
 /**
+* duration 的硬上限（毫秒，7 天）。
+*
+* 纯保险丝：分段并发已由执行器的限额池兜住，真实的超长作品（实测有 27 小时级、
+* 弹幕正常的直播回放）不受影响。挡的是天文数字的 `duration`（如 `9e15`，能通过
+* `.int()` 校验）—— `build` 的切段是同步 while 循环，那种值会在任何请求发出之前
+* 把事件循环卡死、把分段数组撑爆。真实作品离 7 天很远，这个值给足余量。
+*
+* 导出是因为校验层的平行 schema（validation/douyin.ts，v6 门面入口）要用同一个数。
+*/
+const DANMAKU_MAX_DURATION_MS = 6048e5;
+/**
 * 弹幕列表（分段并发 + 合并排序 + `partial: 'tolerate'`）。
 *
-* 总时长 ≤ 32000ms 单段直取；超过则按 32000ms 切成多段并发请求，
+* 总时长 ≤ 32000ms 单段直取；超过则按 32000ms 切成多段，经执行器的限额并发池
+* 发出（`SEGMENT_CONCURRENCY`，完成一个补一个），
 * **单段失败容忍**（失败段返回 null，其余段照常合并），最后按 `offset_time`
 * 升序合并，元信息（`extra` / `log_pb` / `status_code`）取第一段。
 *
@@ -5347,7 +5446,7 @@ const danmakuList$1 = defineDouyinEndpoint({
 		aweme_id: zod.default.string().min(1, { error: "作品ID不能为空" }).describe("作品 ID"),
 		start_time: zod.default.coerce.number().int().min(0).optional().describe("区间起点（毫秒），默认 0"),
 		end_time: zod.default.coerce.number().int().min(0).optional().describe("区间终点（毫秒），默认取总时长"),
-		duration: zod.default.coerce.number().int().min(0).describe("作品总时长（毫秒），也是默认终点")
+		duration: zod.default.coerce.number().int().min(0).max(DANMAKU_MAX_DURATION_MS, { error: "作品总时长不能超过 7 天" }).describe("作品总时长（毫秒），也是默认终点")
 	}).refine((data) => data.end_time === void 0 || data.end_time <= data.duration, {
 		error: "获取弹幕区间的结束时间不能超过视频总时长",
 		path: ["end_time"]
@@ -5652,7 +5751,7 @@ const liveRoomInfo$1 = defineDouyinEndpoint({
 	},
 	params: zod.default.object({
 		web_rid: zod.default.string().min(1, { error: "直播间ID不能为空" }).describe("直播间短号（链接里那段）"),
-		room_id: zod.default.string().optional().describe("内部透传，一般不用传")
+		room_id: internalParam(zod.default.string().optional().describe("内部透传，一般不用传"))
 	}),
 	build: (p, ctx) => ({
 		method: "GET",
@@ -5887,15 +5986,14 @@ const search = defineDouyinEndpoint({
 			"video"
 		]).default("general").optional().describe("搜索类型，默认综合搜索"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 15"),
-		search_id: zod.default.string().optional().describe("翻页游标，一般不用传"),
-		offset: zod.default.coerce.number().int().min(0).optional().describe("翻页偏移，一般不用传")
+		search_id: internalParam(zod.default.string().optional().describe("翻页游标，一般不用传")),
+		offset: internalParam(zod.default.coerce.number().int().min(0).optional().describe("翻页偏移，一般不用传"))
 	}),
 	build: (p, ctx) => {
 		const searchType = p.type ?? "general";
 		return {
 			method: "GET",
 			url: douyinApiUrls$1.search({
-				keyword: p.query,
 				query: p.query,
 				type: searchType,
 				number: p.number,
@@ -6067,7 +6165,7 @@ const userFavoriteList = defineDouyinEndpoint({
 	params: zod.default.object({
 		sec_uid: zod.default.string().min(1, { error: "用户ID不能为空" }).describe("用户 sec_uid，主页链接里那段"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 18"),
-		max_cursor: zod.default.string().optional().describe("翻页游标，一般不用传")
+		max_cursor: internalParam(zod.default.string().optional().describe("翻页游标，一般不用传"))
 	}),
 	build: (p, ctx) => ({
 		method: "GET",
@@ -6143,7 +6241,7 @@ const userRecommendList = defineDouyinEndpoint({
 	params: zod.default.object({
 		sec_uid: zod.default.string().min(1, { error: "用户ID不能为空" }).describe("用户 sec_uid，主页链接里那段"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 18"),
-		max_cursor: zod.default.string().optional().describe("翻页游标，一般不用传")
+		max_cursor: internalParam(zod.default.string().optional().describe("翻页游标，一般不用传"))
 	}),
 	build: (p, ctx) => ({
 		method: "GET",
@@ -6190,7 +6288,7 @@ const userVideoList = defineDouyinEndpoint({
 	params: zod.default.object({
 		sec_uid: zod.default.string().min(1, { error: "用户ID不能为空" }).describe("用户 sec_uid，主页链接里那段"),
 		number: zod.default.coerce.number().int().min(1).optional().describe("目标条数，默认 18"),
-		max_cursor: zod.default.string().optional().describe("翻页游标，一般不用传")
+		max_cursor: internalParam(zod.default.string().optional().describe("翻页游标，一般不用传"))
 	}),
 	build: (p, ctx) => ({
 		method: "GET",
@@ -8574,9 +8672,10 @@ const DANMAKU_SCAN_STEP_MS = 6e4;
 /**
 * 扫描范围上限（毫秒，1 小时）。
 *
-* 多窗口是 `Promise.all` 并发发出的，范围直接决定并发请求数
-* （`ceil(范围 / 60000)`）。不设上限时一个手输的 `duration` 就能让一次调用打出上千个
-* 请求，所以在参数层挡住：1 小时 → 最多 60 个窗口，与 `userProfile` 的 12 个同量级。
+* 多窗口经执行器的限额并发池发出（见 execute 的 `SEGMENT_CONCURRENCY`），范围决定
+* 的是**总**请求数（`ceil(范围 / 60000)`）。不设上限时一个手输的 `duration` 就能让
+* 一次调用打出上千个请求，所以在参数层挡住：1 小时 → 最多 60 个窗口，与
+* `userProfile` 的 12 个同量级。
 */
 const DANMAKU_MAX_RANGE_MS = 36e5;
 /**
@@ -9807,6 +9906,7 @@ const noteComments = defineXiaohongshuEndpoint({
 		description: "取笔记评论列表。`number` 指定目标条数，翻页由端点自动完成。"
 	},
 	params: zod.default.object({
+		cursor: internalParam(zod.default.string().optional().describe("分页游标，由端点接管，不用传")),
 		note_id: zod.default.string().min(1, { error: "note_id 不能为空" }).describe("笔记 ID；从笔记分享链接里取"),
 		xsec_token: zod.default.string().min(1, { error: "xsec_token 不能为空" }).describe("反爬令牌，随笔记分享链接下发"),
 		number: zod.default.coerce.number().int().min(1).max(500).optional().describe("目标条数，默认一页")
@@ -51219,7 +51319,8 @@ const parametersOf = (def) => {
 		unrepresentable: "any"
 	});
 	const required = new Set(json.required ?? []);
-	return Object.entries(json.properties ?? {}).map(([name, schema]) => {
+	const internalKeys = internalParamKeysOf(def.params);
+	return Object.entries(json.properties ?? {}).filter(([name]) => !internalKeys.has(name)).map(([name, schema]) => {
 		const { description, ...rest } = schema;
 		return {
 			name,
@@ -51528,7 +51629,7 @@ const buildOpenApiSpec = (options = {}) => {
 		openapi: "3.1.0",
 		info: {
 			title: "amagi HTTP API",
-			version: options.version ?? "7.0.0-beta.6",
+			version: options.version ?? "7.0.0-beta.7",
 			description: [
 				"由端点注册表派生的规范 —— 手写的那份已经漂移，这份不会（`gen-openapi --check` 进 CI）。",
 				"",
@@ -52081,6 +52182,7 @@ const createStaticFetcher = (platform, registry) => {
 * ```typescript
 * import { bilibiliFetcher } from '@ikenxuan/amagi'
 *
+* const cookie = 'SESSDATA=xxx; bili_jct=yyy'
 * const result = await bilibiliFetcher.fetchVideoInfo({ bvid: 'BV1xx411c7mD' }, cookie)
 * ```
 */
@@ -52290,6 +52392,7 @@ async function validatePassportVerifyCode(options, cookie, requestConfig) {
 * ```typescript
 * import { douyinFetcher } from '@ikenxuan/amagi'
 *
+* const cookie = 'ttwid=xxx'
 * const result = await douyinFetcher.fetchVideoWork({ aweme_id: '7123456789' }, cookie)
 * ```
 */
@@ -52307,6 +52410,8 @@ const douyinFetcher = {
 * @returns 绑定了 Cookie 的 Fetcher 对象，调用时无需传递 cookie
 * @example
 * ```typescript
+* import { createBoundDouyinFetcher } from '@ikenxuan/amagi'
+*
 * const fetcher = createBoundDouyinFetcher('your_cookie')
 * const result = await fetcher.fetchVideoWork({ aweme_id: '7123456789' })
 * ```
@@ -52328,6 +52433,7 @@ const createBoundDouyinFetcher = (cookie, requestConfig) => createFetcherFromReg
 * ```typescript
 * import { kuaishouFetcher } from '@ikenxuan/amagi'
 *
+* const cookie = 'did=xxx'
 * const result = await kuaishouFetcher.fetchVideoWork({ photoId: '3x123456789' }, cookie)
 * ```
 */
@@ -52350,6 +52456,7 @@ const createBoundKuaishouFetcher = (cookie, requestConfig) => createFetcherFromR
 * ```typescript
 * import { xiaohongshuFetcher } from '@ikenxuan/amagi'
 *
+* const cookie = 'a1=xxx; web_session=xxx'
 * const result = await xiaohongshuFetcher.fetchNoteDetail({ note_id: 'n1', xsec_token: 'tk' }, cookie)
 * ```
 */
@@ -52744,7 +52851,7 @@ const DouyinValidationSchemas = {
 		aweme_id: zod.default.string({ error: "视频ID必须是字符串" }).min(1, { error: "视频ID不能为空" }),
 		start_time: zod.default.coerce.number({ error: "开始时间必须是数字" }).int({ error: "开始时间必须是整数" }).min(0, { error: "开始时间不能小于0" }).optional(),
 		end_time: zod.default.coerce.number({ error: "结束时间必须是数字" }).int({ error: "结束时间必须是整数" }).min(0, { error: "结束时间不能小于0" }).optional(),
-		duration: zod.default.coerce.number({ error: "视频时长必须是数字" }).int({ error: "视频时长必须是整数" }).min(0, { error: "视频时长不能小于0" })
+		duration: zod.default.coerce.number({ error: "视频时长必须是数字" }).int({ error: "视频时长必须是整数" }).min(0, { error: "视频时长不能小于0" }).max(DANMAKU_MAX_DURATION_MS, { error: "作品总时长不能超过 7 天" })
 	}).refine((data) => {
 		if (data.end_time !== void 0) return data.end_time <= data.duration;
 		return true;
@@ -54292,7 +54399,7 @@ let DynamicType = /* @__PURE__ */ function(DynamicType) {
 * 构建后使用 __VERSION__，开发环境从 package.json 读取
 */
 const getVersion = () => {
-	return "7.0.0-beta.6";
+	return "7.0.0-beta.7";
 };
 const VERSION = getVersion();
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikenxuan/amagi",
-  "version": "7.0.0-beta.6",
+  "version": "7.0.0-beta.7",
   "description": "抖音、B站的 web 端相关数据接口基于 Node.js 的实现",
   "keywords": [
     "api",
@@ -74,14 +74,14 @@
     "zod": "4.6.5"
   },
   "devDependencies": {
-    "@ikenxuan/amagi-response-types": "0.1.0",
-    "@ikenxuan/amagi-typegen": "0.1.0",
     "@types/express": "5.0.6",
     "sort-package-json": "4.0.0",
     "ts-json-schema-generator": "2.9.0",
-    "tsdown": "^0.23.0"
+    "tsdown": "^0.23.0",
+    "@ikenxuan/amagi-response-types": "0.1.0",
+    "@ikenxuan/amagi-typegen": "0.1.0"
   },
-  "timestamp": "2026-09-29T22:13:19.509Z",
+  "timestamp": "2026-10-02T19:47:49.892Z",
   "scripts": {
     "build": "tsdown",
     "dev": "cross-env LOG_LEVEL=debug tsx watch src/dev.ts",