@ikenxuan/amagi 7.0.0-beta.1 → 7.0.0-beta.3

package/dist/{src-AA7Elfxn.mjs → src-B9Len1oc.mjs}

@@ -7,7 +7,7 @@ import protobuf from "protobufjs";
 import axios, { AxiosError, AxiosHeaders, mergeConfig } from "axios";
 import { EventEmitter } from "node:events";
 import crypto, { createCipheriv, createHash, randomBytes, randomUUID } from "node:crypto";
-import { CryptoConfig, FingerprintGenerator, Xhshow } from "@ikenxuan/xhshow-ts";
+import { CryptoConfig, FingerprintGenerator, Xhshow, xRapParam } from "@ikenxuan/xhshow-ts";
 //#region src/platforms/bilibili/api.ts
 /** B站 API URL 构建类（所有方法只拼 URL，不发起请求） */
 var BilibiliAPI$1 = class {
@@ -5088,7 +5088,7 @@ const xiaohongshuJudge = (raw, http) => {
 const createXiaohongshuCryptoConfig = () => new CryptoConfig().withOverrides({
 	DATA_WEB_BUILD: "6.12.3",
 	SIGNATURE_DATA_TEMPLATE: {
-		x0: "4.3.5",
+		x0: "4.4.3",
 		x1: "xhs-pc-web",
 		x2: "Windows",
 		x3: "",
@@ -5268,10 +5268,18 @@ const createXiaohongshuGuestCookie$1 = async (send, requestConfig) => {
 * 小红书签名算法。
 *
 * 包装 `@ikenxuan/xhshow-ts` 的 `Xhshow` 实例，提供 GET / POST / X-S-Common /
-* X-T / X-B3-Traceid / 搜索 ID 的生成函数。a1 从 cookie 取值的逻辑用
-* `contracts/cookie.ts` 的 `getCookieValue`。
+* X-T / X-B3-Traceid / X-Xray-Traceid / X-Rap-Param / 搜索 ID / 搜索 request_id
+* 的生成函数。a1 从 cookie 取值的逻辑用 `contracts/cookie.ts` 的 `getCookieValue`。
 *
 * `Xhshow` 实例是模块级单例，行为与性能无额外开销。
+*
+* 上游 2026-02 之后的新协议由这里落地：
+* - **XYW_ 格式**（`generateXSGetXyw` / `generateXSPostXyw`）：数据获取类接口
+*   （`user_posted`、`user/otherinfo` 等）自 2026-03 起以 HTTP 406 拒绝传统 XYS_
+*   格式，改用基于 AES-128-CBC 的 XYW_ 签名。x-s 值以 `XYW_` 开头。
+* - **x-rap-param**（`generateXRapParam`）：feed / 搜索 / 发布类接口的额外校验头。
+* - **x-xray-traceid**（`generateXrayTraceid`）：追踪头，随现代浏览器每次请求下发。
+* - **search request_id**（`getSearchRequestId`）：搜索接口所需的 `{random}-{ts_ms}`。
 */
 /** 模块级 Xhshow 单例 */
 const client = new Xhshow(createXiaohongshuCryptoConfig());
@@ -5294,6 +5302,34 @@ const generateXSGet = (path, a1Cookie, clientType = "xhs-pc-web", params = {}) =
 */
 const generateXSPost = (path, a1Cookie, clientType = "xhs-pc-web", body = {}) => client.signXsPost(path, a1Cookie, clientType, body);
 /**
+* 生成 GET 请求的 XYW_ 格式 X-S 签名（AES-128-CBC）。
+*
+* 数据获取类接口（`user_posted` 等）自 2026-03 起以 HTTP 406 拒绝 XYS_ 格式，
+* 需改用本函数。返回值以 `XYW_` 开头，走独立于 `signXsGet` 的加密路径。
+* @param path - API 路径，如 `/api/sns/web/v1/user_posted`
+* @param a1Cookie - a1 cookie 值
+* @param clientType - 客户端类型，默认 `'xhs-pc-web'`
+* @param params - 查询参数对象
+* @returns XYW_ 格式 X-S 签名
+*/
+const generateXSGetXyw = (path, a1Cookie, clientType = "xhs-pc-web", params = {}) => client.signXyw("GET", path, a1Cookie, clientType, params);
+/**
+* 生成 POST 请求的 XYW_ 格式 X-S 签名（AES-128-CBC）。
+* @param path - API 路径
+* @param a1Cookie - a1 cookie 值
+* @param clientType - 客户端类型，默认 `'xhs-pc-web'`
+* @param body - 请求体对象
+* @returns XYW_ 格式 X-S 签名
+*/
+const generateXSPostXyw = (path, a1Cookie, clientType = "xhs-pc-web", body = {}) => client.signXyw("POST", path, a1Cookie, clientType, body);
+/**
+* 生成 X-Rap-Param 请求头（feed / 搜索 / 发布类接口的额外校验）。
+* @param api - 请求 API，形如 `//edith.xiaohongshu.com/api/sns/web/v1/feed`（含 host、去协议）
+* @param body - 请求体对象（GET 传空对象）
+* @returns Base64 编码的 x-rap-param 字符串
+*/
+const generateXRapParam = (api, body = {}) => xRapParam(api, body);
+/**
 * 生成 X-S-Common 参数。
 * @param cookies - cookie 字符串
 * @returns Base64 编码的随机字符串
@@ -5310,26 +5346,40 @@ const generateXT = () => client.getXT();
 */
 const generateXB3Traceid = () => client.getB3TraceId();
 /**
+* 生成 X-Xray-Traceid。
+*
+* 32 位字符（16 位时间戳+序列 + 16 位随机），随现代浏览器每次请求下发。
+* @returns X-Xray-Traceid 字符串
+*/
+const generateXrayTraceid = () => client.getXrayTraceId();
+/**
 * 生成搜索 ID。
 *
-* 实现为 `(BigInt(Date.now()) << 64n) + BigInt(Math.floor(Math.random() * 2147483646)).toString(36)`。
-* 注意：BigInt 与 string 相加，结果是十进制拼 base36 后缀而非预期的位运算结果 ——
-* 这里保持该行为不变。
+* 交由上游 `client.getSearchId()`：base36 编码的 `(timestamp_ms << 64) + random`。
+* 旧的本地实现把 BigInt 与 string 相加，得到「十进制拼 base36 后缀」而非预期的
+* 位运算结果 —— 上游修正后此处直接复用，不再自行拼装。
 * @returns 搜索 ID 字符串
 */
-const getSearchId = () => (BigInt(Date.now()) << 64n) + BigInt(Math.floor(Math.random() * 2147483646)).toString(36);
+const getSearchId = () => client.getSearchId();
 //#endregion
 //#region src/platforms/xiaohongshu/sign/signers.ts
 /**
 * 小红书签名器表。
 *
-* 三个签名器：
+* XYS_（传统）路径：
 * - `'xhs-post'`：POST 请求，`x-s` 用 `signXsPost` 对 body 签名
 * - `'xhs-get'`：GET 请求，`x-s` 用 `signXsGet` 对 query 签名
 * - `'xhs-get-trace'`：GET + `x-b3-traceid`（userNoteList 专用）
+* - `'xhs-post-rap'`：POST + `x-rap-param`（feed / 搜索 / 发布类接口的额外校验）
+*
+* XYW_（2026-03 之后）路径 —— 数据获取类接口以 HTTP 406 拒绝 XYS_，`x-s` 改用
+* 以 `XYW_` 开头的 AES-128-CBC 签名：
+* - `'xhs-get-xyw'`：GET，`x-s` 用 `signXyw`
+* - `'xhs-post-xyw'`：POST，`x-s` 用 `signXyw`
+* - `'xhs-get-xyw-trace'`：GET XYW + `x-b3-traceid`（userNoteList 专用）
 *
 * 签名路径取自 `spec.signPath`（build 里填 `apiPath`），不是 `spec.url`：
-* 小红书签名只用接口路径，与完整 URL 无关。
+* 小红书签名只用接口路径，与完整 URL 无关。x-rap-param 例外，它要 host + path。
 *
 * 签名输入：a1 取自 cookie，POST 签名含 body，GET 签名含 query。
 */
@@ -5337,9 +5387,26 @@ const getSearchId = () => (BigInt(Date.now()) << 64n) + BigInt(Math.floor(Math.r
 const a1Of = (cookie) => getCookieValue(cookie, "a1") ?? "";
 /** 签名路径：优先 `spec.signPath`（build 填的 apiPath），缺省取 URL 的 pathname */
 const apiPathOf = (spec) => spec.signPath ?? new URL(spec.url).pathname;
-/** 注入 x-s / x-s-common / x-t 三个签名头 */
+/**
+* 取签名用的 query 参数：GET 端点在 `build` 里把原始 params 放进 `extra.signParams`。
+* 小红书 GET 的 x-s 必须覆盖 query（路径 + 参数），只签路径会被判非法请求返回 406。
+* 无参数端点（emojiList / userProfile）返回空对象，签名退化为只签路径，行为不变。
+*/
+const signParamsOf = (spec) => spec.extra?.signParams ?? {};
+/** x-rap-param 的 api 入参：去协议、保留 `//host/path`（不含 query） */
+const rapApiOf = (spec) => {
+	const url = new URL(spec.url);
+	return `//${url.host}${url.pathname}`;
+};
+/**
+* 注入 x-s / x-s-common / x-t / x-xray-traceid 四个签名头。
+*
+* `x-xray-traceid` 是真实浏览器每次请求都带的追踪头（见 noteComments 的抓包）；
+* 早期只发前三个，`comment/page` 这类接口会因此被判为非法请求，返回 HTTP 406。
+* 所有平台签名器共用本 helper，因此补上后对全部端点生效。
+*/
 const signHeaders = (spec, ctx, xs) => {
-	const headers = new AmagiHeaders(spec.headers).set("x-s", xs).set("x-s-common", generateXSCommon(ctx.cookie)).set("x-t", String(generateXT()));
+	const headers = new AmagiHeaders(spec.headers).set("x-s", xs).set("x-s-common", generateXSCommon(ctx.cookie)).set("x-t", String(generateXT())).set("x-xray-traceid", generateXrayTraceid());
 	return {
 		...spec,
 		headers: headers.toJSON()
@@ -5350,9 +5417,9 @@ const xhsPostSigner = (spec, ctx) => {
 	const xs = generateXSPost(apiPathOf(spec), a1Of(ctx.cookie), "xhs-pc-web", spec.body ?? {});
 	return signHeaders(spec, ctx, xs);
 };
-/** GET 签名器：x-s = signXsGet(apiPath, a1, 'xhs-pc-web') */
+/** GET 签名器：x-s = signXsGet(apiPath, a1, 'xhs-pc-web', signParams) */
 const xhsGetSigner = (spec, ctx) => {
-	const xs = generateXSGet(apiPathOf(spec), a1Of(ctx.cookie), "xhs-pc-web");
+	const xs = generateXSGet(apiPathOf(spec), a1Of(ctx.cookie), "xhs-pc-web", signParamsOf(spec));
 	return signHeaders(spec, ctx, xs);
 };
 /** GET + x-b3-traceid（userNoteList 专用） */
@@ -5364,11 +5431,44 @@ const xhsGetTraceSigner = async (spec, ctx) => {
 		headers: headers.toJSON()
 	};
 };
+/** POST + x-rap-param（feed / 搜索 / 发布类接口的额外校验） */
+const xhsPostRapSigner = async (spec, ctx) => {
+	const signed = await xhsPostSigner(spec, ctx);
+	const rap = generateXRapParam(rapApiOf(spec), spec.body ?? {});
+	const headers = new AmagiHeaders(signed.headers).set("x-rap-param", rap);
+	return {
+		...signed,
+		headers: headers.toJSON()
+	};
+};
+/** XYW GET 签名器：x-s = signXyw('GET', apiPath, a1, 'xhs-pc-web', signParams)，绕过数据接口 406 */
+const xhsGetXywSigner = (spec, ctx) => {
+	const xs = generateXSGetXyw(apiPathOf(spec), a1Of(ctx.cookie), "xhs-pc-web", signParamsOf(spec));
+	return signHeaders(spec, ctx, xs);
+};
+/** XYW POST 签名器：x-s = signXyw('POST', apiPath, a1, 'xhs-pc-web', body) */
+const xhsPostXywSigner = (spec, ctx) => {
+	const xs = generateXSPostXyw(apiPathOf(spec), a1Of(ctx.cookie), "xhs-pc-web", spec.body ?? {});
+	return signHeaders(spec, ctx, xs);
+};
+/** XYW GET + x-b3-traceid（userNoteList 专用，2026-03 之后） */
+const xhsGetXywTraceSigner = async (spec, ctx) => {
+	const signed = await xhsGetXywSigner(spec, ctx);
+	const headers = new AmagiHeaders(signed.headers).set("x-b3-traceid", generateXB3Traceid());
+	return {
+		...signed,
+		headers: headers.toJSON()
+	};
+};
 /** 平台签名器表，交给 runtime 的 `signers` 查名 */
 const createXiaohongshuSigners = () => ({
 	"xhs-post": xhsPostSigner,
 	"xhs-get": xhsGetSigner,
-	"xhs-get-trace": xhsGetTraceSigner
+	"xhs-get-trace": xhsGetTraceSigner,
+	"xhs-post-rap": xhsPostRapSigner,
+	"xhs-get-xyw": xhsGetXywSigner,
+	"xhs-post-xyw": xhsPostXywSigner,
+	"xhs-get-xyw-trace": xhsGetXywTraceSigner
 });
 //#endregion
 //#region src/runtime/events.ts
@@ -7377,7 +7477,7 @@ var DouyinAPI$1 = class {
 				keyword: data.query,
 				list_type: "single",
 				need_filter_settings: "1",
-				offset: "0",
+				offset: String(data.offset ?? 0),
 				pc_libra_divert: "Windows",
 				pc_search_top_1_params: "{\"enable_ai_search_top_1\":1}",
 				query_correct_type: "1",
@@ -7405,7 +7505,7 @@ var DouyinAPI$1 = class {
 				keyword: data.query,
 				list_type: "single",
 				need_filter_settings: "1",
-				offset: "0",
+				offset: String(data.offset ?? 0),
 				pc_libra_divert: "Windows",
 				pc_search_top_1_params: "{\"enable_ai_search_top_1\":1}",
 				query_correct_type: "1",
@@ -7432,7 +7532,7 @@ var DouyinAPI$1 = class {
 				keyword: data.query,
 				list_type: "",
 				need_filter_settings: "1",
-				offset: "0",
+				offset: String(data.offset ?? 0),
 				pc_libra_divert: "Windows",
 				pc_search_top_1_params: "{\"enable_ai_search_top_1\":1}",
 				query_correct_type: "1",
@@ -8275,7 +8375,8 @@ const search = defineEndpoint({
 			"video"
 		]).default("general").optional().describe("搜索类型，默认综合搜索"),
 		number: zod.coerce.number().int().min(1).optional().describe("目标条数，默认 15"),
-		search_id: zod.string().optional().describe("翻页游标，一般不用传")
+		search_id: zod.string().optional().describe("翻页游标，一般不用传"),
+		offset: zod.coerce.number().int().min(0).optional().describe("翻页偏移，一般不用传")
 	}),
 	build: (p, ctx) => {
 		const searchType = p.type ?? "general";
@@ -8286,7 +8387,8 @@ const search = defineEndpoint({
 				query: p.query,
 				type: searchType,
 				number: p.number,
-				search_id: p.search_id
+				search_id: p.search_id,
+				offset: p.offset
 			}),
 			headers: withDouyinReferer(ctx, {
 				kind: "search",
@@ -8324,9 +8426,13 @@ const search = defineEndpoint({
 		nextParams: (params, page) => {
 			const p = page;
 			const nextSearchId = (typeof p.rid === "string" && p.rid.length > 0 ? p.rid : void 0) ?? (typeof p.log_pb?.impr_id === "string" ? p.log_pb.impr_id : void 0) ?? params.search_id;
+			const currentOffset = params.offset ?? 0;
+			const items = Array.isArray(page && page.user_list) ? page.user_list : page.data ?? [];
+			const nextOffset = typeof p.cursor === "number" && p.cursor > currentOffset ? p.cursor : currentOffset + items.length;
 			return {
 				...params,
-				search_id: nextSearchId
+				search_id: nextSearchId,
+				offset: nextOffset
 			};
 		}
 	},
@@ -11951,8 +12057,15 @@ const SEARCH_NOTE_TYPE = {
 	VIDEO: 1,
 	IMAGE: 2
 };
-/** 构建查询字符串：跳过 null / undefined，其余 URL 编码 */
-const buildQueryString$2 = (params) => Object.entries(params).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
+/**
+* 构建查询字符串：跳过 null / undefined。
+*
+* **编码规则必须与 `@ikenxuan/xhshow-ts` 的签名内部编码完全一致**：只把值里的
+* `=` 转成 `%3D`，其余字符（含 `,`）原样保留。小红书对 GET 请求按「路径 + 这套
+* 编码的 query」计算 x-s，若这里用 `encodeURIComponent`（会把 `,` 转成 `%2C`），
+* 发出去的 query 与被签名的内容不一致，平台返回 HTTP 406。
+*/
+const buildQueryString$2 = (params) => Object.entries(params).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => `${key}=${String(value).replace(/=/g, "%3D")}`).join("&");
 /** 首页推荐（POST） */
 const homeFeed$1 = (data = {}) => ({
 	apiPath: "/api/sns/web/v1/homefeed",
@@ -11992,6 +12105,7 @@ const noteComments$1 = (data) => {
 	const params = {
 		note_id: data.note_id,
 		cursor: data.cursor ?? "",
+		top_comment_id: "",
 		image_formats: [
 			"jpg",
 			"webp",
@@ -12001,7 +12115,8 @@ const noteComments$1 = (data) => {
 	};
 	return {
 		apiPath: "/api/sns/web/v2/comment/page",
-		Url: `https://edith.xiaohongshu.com/api/sns/web/v2/comment/page?${buildQueryString$2(params)}`
+		Url: `https://edith.xiaohongshu.com/api/sns/web/v2/comment/page?${buildQueryString$2(params)}`,
+		signParams: params
 	};
 };
 /** 用户信息（GET，请求的是 HTML 页，由 judge / decode 层处理） */
@@ -12024,7 +12139,8 @@ const userNoteList$1 = (data) => {
 	};
 	return {
 		apiPath: "/api/sns/web/v1/user_posted",
-		Url: `https://edith.xiaohongshu.com/api/sns/web/v1/user_posted?${buildQueryString$2(params)}`
+		Url: `https://edith.xiaohongshu.com/api/sns/web/v1/user_posted?${buildQueryString$2(params)}`,
+		signParams: params
 	};
 };
 /** 表情列表（GET，无参数） */
@@ -12150,7 +12266,7 @@ const homeFeed = defineEndpoint({
 			signPath: apiPath
 		};
 	},
-	sign: "xhs-post",
+	sign: "xhs-post-rap",
 	response: type()
 });
 //#endregion
@@ -12178,14 +12294,15 @@ const noteComments = defineEndpoint({
 		number: zod.coerce.number().int().min(1).max(500).optional().describe("目标条数，默认一页")
 	}),
 	build: (p) => {
-		const { Url, apiPath } = noteComments$1(p);
+		const { Url, apiPath, signParams } = noteComments$1(p);
 		return {
 			method: "GET",
 			url: Url,
-			signPath: apiPath
+			signPath: apiPath,
+			extra: { signParams }
 		};
 	},
-	sign: "xhs-get",
+	sign: "xhs-get-trace",
 	paginate: {
 		maxPageSize: 50,
 		items: (page) => page.data?.comments ?? [],
@@ -12235,7 +12352,7 @@ const noteDetail = defineEndpoint({
 			signPath: apiPath
 		};
 	},
-	sign: "xhs-post",
+	sign: "xhs-post-rap",
 	response: type()
 });
 //#endregion
@@ -12267,16 +12384,17 @@ const searchNotes = defineEndpoint({
 			signPath: apiPath
 		};
 	},
-	sign: "xhs-post",
+	sign: "xhs-post-rap",
 	response: type()
 });
 //#endregion
 //#region src/platforms/xiaohongshu/endpoints/userNoteList.ts
 /**
-* 用户笔记列表（GET + x-b3-traceid）。
+* 用户笔记列表（GET + x-b3-traceid，XYW_ 签名）。
 *
-* 这个端点额外带 `x-b3-traceid` 头，因此单独用一个签名器
-* `'xhs-get-trace'`（GET 签名 + traceid），而不是给所有 GET 都加。
+* 这个端点额外带 `x-b3-traceid` 头，且属于数据获取类接口 —— 自 2026-03 起传统
+* XYS_ 签名会被平台以 HTTP 406 拒绝，因此用 `'xhs-get-xyw-trace'`
+* （XYW_ GET 签名 + traceid），而不是给所有 GET 都换。
 */
 const userNoteList = defineEndpoint({
 	name: "xiaohongshu.userNoteList",
@@ -12287,18 +12405,20 @@ const userNoteList = defineEndpoint({
 	},
 	params: zod.object({
 		user_id: zod.string().min(1, { error: "user_id 不能为空" }).describe("用户 ID"),
+		xsec_token: zod.string().min(1, { error: "xsec_token 不能为空" }).describe("反爬令牌，随笔记分享链接下发"),
 		cursor: zod.string().optional().describe("翻页游标；传上一页最后一条的 ID，首页不传"),
 		num: zod.coerce.number().int().min(1).max(100).optional().describe("单次请求的笔记条数，默认 30")
 	}),
 	build: (p) => {
-		const { Url, apiPath } = userNoteList$1(p);
+		const { Url, apiPath, signParams } = userNoteList$1(p);
 		return {
 			method: "GET",
 			url: Url,
-			signPath: apiPath
+			signPath: apiPath,
+			extra: { signParams }
 		};
 	},
-	sign: "xhs-get-trace",
+	sign: "xhs-get-xyw-trace",
 	response: type()
 });
 //#endregion
@@ -14149,6 +14269,21 @@ const RESPONSE_SCHEMAS = {
 				"success"
 			]
 		},
+		"xiaohongshu_noteComments": {
+			"type": "object",
+			"properties": {
+				"code": { "type": "number" },
+				"data": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.Data" },
+				"msg": { "type": "string" },
+				"success": { "type": "boolean" }
+			},
+			"required": [
+				"code",
+				"data",
+				"msg",
+				"success"
+			]
+		},
 		"xiaohongshu_noteDetail": {
 			"type": "object",
 			"properties": {
@@ -52878,6 +53013,212 @@ const RESPONSE_SCHEMAS = {
 			"properties": { "capa": { "$ref": "#/components/schemas/xiaohongshu_homeFeed.HomeFeed_V0.Capa" } },
 			"required": ["capa"]
 		},
+		"xiaohongshu_noteComments.NoteComments_V0.AtUser": {
+			"type": "object",
+			"properties": {
+				"ai_agent": { "type": "boolean" },
+				"nickname": { "type": "string" },
+				"user_id": { "type": "string" },
+				"xsec_token": { "type": "string" }
+			},
+			"required": [
+				"ai_agent",
+				"nickname",
+				"user_id",
+				"xsec_token"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.AudioInfo": {
+			"type": "object",
+			"properties": {
+				"asr_text": { "type": "string" },
+				"audio_id": { "type": "string" },
+				"duration": { "type": "number" },
+				"play_info": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.PlayInfo" },
+				"tag_text": { "type": "string" }
+			},
+			"required": [
+				"asr_text",
+				"audio_id",
+				"duration",
+				"play_info",
+				"tag_text"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.Comment": {
+			"type": "object",
+			"properties": {
+				"at_users": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.AtUser" }
+				},
+				"audio_info": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.AudioInfo" },
+				"content": { "type": "string" },
+				"create_time": { "type": "number" },
+				"id": { "type": "string" },
+				"invalid": { "type": "boolean" },
+				"ip_location": { "type": "string" },
+				"like_count": { "type": "string" },
+				"liked": { "type": "boolean" },
+				"note_id": { "type": "string" },
+				"pictures": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.Picture" }
+				},
+				"show_tags": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"status": { "type": "number" },
+				"sub_comment_count": { "type": "string" },
+				"sub_comment_cursor": { "type": "string" },
+				"sub_comment_has_more": { "type": "boolean" },
+				"sub_comments": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.SubComment" }
+				},
+				"user_info": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.UserInfo" }
+			},
+			"required": [
+				"at_users",
+				"content",
+				"create_time",
+				"id",
+				"invalid",
+				"like_count",
+				"liked",
+				"note_id",
+				"show_tags",
+				"status",
+				"sub_comment_count",
+				"sub_comment_cursor",
+				"sub_comment_has_more",
+				"sub_comments",
+				"user_info"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.Data": {
+			"type": "object",
+			"properties": {
+				"comments": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.Comment" }
+				},
+				"cursor": { "type": "string" },
+				"has_more": { "type": "boolean" },
+				"time": { "type": "number" },
+				"user_id": { "type": "string" },
+				"xsec_token": { "type": "string" }
+			},
+			"required": [
+				"comments",
+				"cursor",
+				"has_more",
+				"time",
+				"user_id",
+				"xsec_token"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.InfoList": {
+			"type": "object",
+			"properties": {
+				"image_scene": { "type": "string" },
+				"url": { "type": "string" }
+			},
+			"required": ["image_scene", "url"]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.Picture": {
+			"type": "object",
+			"properties": {
+				"height": { "type": "number" },
+				"info_list": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.InfoList" }
+				},
+				"url_default": { "type": "string" },
+				"url_pre": { "type": "string" },
+				"width": { "type": "number" }
+			},
+			"required": [
+				"height",
+				"info_list",
+				"url_default",
+				"url_pre",
+				"width"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.PlayInfo": {
+			"type": "object",
+			"properties": { "url": { "type": "string" } },
+			"required": ["url"]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.SubComment": {
+			"type": "object",
+			"properties": {
+				"at_users": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.AtUser" }
+				},
+				"content": { "type": "string" },
+				"create_time": { "type": "number" },
+				"id": { "type": "string" },
+				"invalid": { "type": "boolean" },
+				"ip_location": { "type": "string" },
+				"like_count": { "type": "string" },
+				"liked": { "type": "boolean" },
+				"note_id": { "type": "string" },
+				"pictures": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.Picture" }
+				},
+				"show_tags": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"status": { "type": "number" },
+				"target_comment": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.TargetComment" },
+				"user_info": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.UserInfo" }
+			},
+			"required": [
+				"at_users",
+				"content",
+				"create_time",
+				"id",
+				"invalid",
+				"like_count",
+				"liked",
+				"note_id",
+				"show_tags",
+				"status",
+				"target_comment",
+				"user_info"
+			]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.TargetComment": {
+			"type": "object",
+			"properties": {
+				"id": { "type": "string" },
+				"user_info": { "$ref": "#/components/schemas/xiaohongshu_noteComments.NoteComments_V0.UserInfo" }
+			},
+			"required": ["id", "user_info"]
+		},
+		"xiaohongshu_noteComments.NoteComments_V0.UserInfo": {
+			"type": "object",
+			"properties": {
+				"ai_agent": { "type": "boolean" },
+				"image": { "type": "string" },
+				"nickname": { "type": "string" },
+				"user_id": { "type": "string" },
+				"xsec_token": { "type": "string" }
+			},
+			"required": [
+				"ai_agent",
+				"image",
+				"nickname",
+				"user_id",
+				"xsec_token"
+			]
+		},
 		"xiaohongshu_noteDetail.NoteDetail_V0.Data": {
 			"type": "object",
 			"properties": {
@@ -53673,7 +54014,7 @@ const buildOpenApiSpec = (options = {}) => {
 		openapi: "3.1.0",
 		info: {
 			title: "amagi HTTP API",
-			version: options.version ?? "7.0.0-beta.1",
+			version: options.version ?? "7.0.0-beta.3",
 			description: [
 				"由端点注册表派生的规范 —— 手写的那份已经漂移，这份不会（`gen-openapi --check` 进 CI）。",
 				"",
@@ -56496,7 +56837,7 @@ let DynamicType = /* @__PURE__ */ function(DynamicType) {
 * 构建后使用 __VERSION__，开发环境从 package.json 读取
 */
 const getVersion = () => {
-	return "7.0.0-beta.1";
+	return "7.0.0-beta.3";
 };
 const VERSION = getVersion();
 /**