@napuketto/adapter 0.0.20 → 0.0.22

package/dist/onebot11/index.mjs

@@ -1,7 +1,9 @@
 import { i as BaseAction, o as ActionRegistry, r as BaseProtocolAdapter, t as ensureSilk } from "../core-of7sLiQX.mjs";
-import { i as createWsServerSchema, n as collectGrayTipUids, r as createHttpServerSchema, t as forEachRawMessage } from "../raw-message-DfHdOVHi.mjs";
-import { ChatType, GrayTipSubType, GroupApi, GroupNotifyMsgType, NTGroupMemberRole, NTGroupRequestOperateTypes, TicketApi, TipGroupElementType, WebHonorType, kernelError, toCanonicalElements } from "@napuketto/kernel";
+import { i as createWsServerSchema, n as collectGrayTipUids, r as createHttpServerSchema, t as forEachRawMessage } from "../raw-message-Bx18pIQS.mjs";
+import { ChatType, GrayTipSubType, GroupApi, GroupNotifyMsgStatus, GroupNotifyMsgType, NTGroupMemberRole, NTGroupRequestOperateTypes, TicketApi, TipGroupElementType, WebHonorType, kernelError, toCanonicalElements } from "@napuketto/kernel";
+import { downloadUrl, inferExtension } from "@napuketto/media";
 import { z } from "zod";
+import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { HttpClient, HttpServer, WsClient, WsServer } from "@napuketto/network";
@@ -1534,6 +1536,10 @@ const CANONICAL_TO_SEGMENT = {
 		type: "video",
 		data: mediaData(el.path, el.url)
 	}),
+	file: (el) => ({
+		type: "file",
+		data: { file: el.name ?? el.path }
+	}),
 	reply: (el) => ({
 		type: "reply",
 		data: { id: el.messageId }
@@ -1624,6 +1630,10 @@ const CQ_SEGMENT_BUILDERS = {
 		type: "video",
 		data: mediaData(params["file"] ?? "", params["url"])
 	}),
+	file: (params) => ({
+		type: "file",
+		data: { file: params["file"] ?? "" }
+	}),
 	reply: (params) => ({
 		type: "reply",
 		data: { id: params["id"] ?? "" }
@@ -1719,6 +1729,12 @@ const ob11ConfigSchema = z.object({
 	reportSelfMessage: z.boolean().default(false),
 	/** 消息内容格式：array = 消息段数组（标准），string = CQ 码字符串。 */
 	messagePostFormat: z.enum(MESSAGE_FORMATS).default("array"),
+	/**
+	* 群文件报形式（B4，2026-09-08）：false（缺省）= message 事件 + file 段
+	* （go-cqhttp 兼容;此前 file 元素被静默丢弃,本版本起透出）；true = 含
+	* fileElement 的群消息改报 group_upload notice 事件（替代 message 事件）。
+	*/
+	groupUploadAsNotice: z.boolean().default(false),
 	/** HTTP 反向服务器列表。 */
 	httpServers: z.array(httpServerSchema).default([]),
 	/** HTTP 正向上报列表。 */
@@ -1853,7 +1869,7 @@ function cqMessageToCanonical(text) {
 //#endregion
 //#region src/onebot11/helper/message-info.ts
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$3 = 1e3;
+const MS_TO_SEC$4 = 1e3;
 /** RawMessage → OB11 消息信息（message_id 经 MessageUnique 映射）。
 * ctx（可选）：接收方向 ID 转换上下文（at uid→uin、reply NT msgId→OB11 id，P2-19）。 */
 function toOb11MessageInfo(msg, unique, ctx = {}) {
@@ -1870,7 +1886,7 @@ function toOb11MessageInfo(msg, unique, ctx = {}) {
 			user_id: Number(msg.senderUin),
 			nickname: msg.sendNickName
 		},
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
 		message: canonicalToSegments(elements),
 		raw_message: canonicalToCqMessage(elements)
 	};
@@ -1884,58 +1900,81 @@ function toOb11MessageInfo(msg, unique, ctx = {}) {
 }
 //#endregion
 //#region src/onebot11/helper/notice.ts
-/**
-* OB11 notice 事件翻译（P2-7，2026-08-05）
-*
-* NT QQ 中群成员变动/撤回等系统事件通过**消息的灰色提示元素（grayTip）**广播。
-* 本模块把 RawMessage 里的 grayTip 翻译为 OB11 notice 事件（纯函数，ADR-008）。
-*
-* 支持：
-*  - group_recall（撤回，grayTip.subElementType=REVOKE）
-*  - group_increase / group_decrease（群成员变动，subElementType=GROUP + TipGroupElement.type）
-*  - group_admin（管理员变更，TipGroupElement.type=BLOCK/UNBLOCK 的 role 语义）
-*  - group_ban（禁言，TipGroupElement.type=SHUT_UP）
-*
-* user_id/operator_id 都是 uin：接收 uidToUin Map（调用方批量转换后传入，保持纯函数）。
-*/
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$2 = 1e3;
+const MS_TO_SEC$3 = 1e3;
+/** 群文件业务类型（group_upload 的 file.busid,与 kernel 群文件系列同源语义）。 */
+const GROUP_FILE_BUS_ID = 102;
+/** 检查消息是否含文件元素（group_upload 开关分支判定）。 */
+function hasFileElement(msg) {
+	return msg.elements.some((el) => el.fileElement !== void 0);
+}
 /** 检查消息是否含可翻译的 grayTip 元素。 */
 function hasGrayTip(msg) {
 	return msg.elements.some((el) => el.grayTipElement !== void 0);
 }
 /** uid → uin（上下文映射缺省退化为 uid）。 */
-function toUin(uid, ctx) {
+function toUin$1(uid, ctx) {
 	const uin = ctx.uidToUin.get(uid);
 	return Number(uin ?? uid);
 }
 /** 基础字段（time/self_id/post_type）。 */
 function base(msg, ctx) {
 	return {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$2),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
 		self_id: Number(ctx.selfUin),
 		post_type: "notice",
 		group_id: Number(msg.peerUid)
 	};
 }
-/** 撤回事件（group_recall）。 */
+/** 撤回事件（chatType 分流：GROUP→group_recall / C2C→friend_recall，2026-09-08）。 */
 function toRecall(msg, g, ctx) {
 	if (g?.revokeElement === void 0) return null;
 	const revoke = g.revokeElement;
+	if (msg.chatType === ChatType.C2C) return {
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		self_id: Number(ctx.selfUin),
+		post_type: "notice",
+		notice_type: "friend_recall",
+		user_id: toUin$1(revoke.operatorUid, ctx),
+		message_id: Number(msg.msgSeq)
+	};
 	return {
 		...base(msg, ctx),
 		notice_type: "group_recall",
-		user_id: toUin(revoke.operatorUid, ctx),
-		operator_id: toUin(revoke.operatorUid, ctx),
+		user_id: toUin$1(revoke.operatorUid, ctx),
+		operator_id: toUin$1(revoke.operatorUid, ctx),
 		message_id: Number(msg.msgSeq)
 	};
 }
+/**
+* 戳一戳（notify.poke，aioOpGrayTipElement，2026-09-08）。
+*
+* ⚠️ 待真实 poke 事件验证：aioOp 载荷的完整字段形状未经实测（实体类型仅有
+* operateType/peerUid 两个已证字段）。当前口径：user_id = 消息发送者，
+* target_id = aioOp.peerUid（C2C 即对端；群内为目标 uid 的假设待校准），
+* group_id = 群号（C2C 为 0）。poke 路径始终打 raw 日志积累校准数据。
+*/
+function toPoke(msg, g, ctx) {
+	const aioOp = g?.aioOpGrayTipElement;
+	ctx.logger?.warn({ raw: JSON.stringify(g)?.slice(0, 2e3) }, "ob11: poke grayTip raw（待真实事件校准）");
+	const isGroup = msg.chatType === ChatType.GROUP;
+	return {
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		self_id: Number(ctx.selfUin),
+		post_type: "notice",
+		notice_type: "notify",
+		sub_type: "poke",
+		group_id: isGroup ? Number(msg.peerUid) : 0,
+		user_id: toUin$1(msg.senderUid, ctx),
+		target_id: toUin$1(aioOp?.peerUid ?? "", ctx)
+	};
+}
 /** 群成员变动（group_increase / group_decrease / group_admin / group_ban）。 */
 function toGroupChange(msg, g, ctx) {
 	const grp = g?.groupElement;
 	if (grp === void 0 || grp.type === void 0) return null;
 	const common = {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$2),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
 		selfId: Number(ctx.selfUin),
 		groupId: Number(msg.peerUid),
 		memberUid: grp.memberUid ?? "",
@@ -1960,8 +1999,8 @@ function toMemberAdd(common, ctx) {
 		notice_type: "group_increase",
 		sub_type: adminUid === memberUid ? "approve" : "invite",
 		group_id: groupId,
-		operator_id: toUin(adminUid, ctx),
-		user_id: toUin(memberUid, ctx)
+		operator_id: toUin$1(adminUid, ctx),
+		user_id: toUin$1(memberUid, ctx)
 	};
 }
 /** 群成员退出（leave）。 */
@@ -1974,8 +2013,8 @@ function toQuit(common, ctx) {
 		notice_type: "group_decrease",
 		sub_type: "leave",
 		group_id: groupId,
-		operator_id: toUin(adminUid, ctx),
-		user_id: toUin(memberUid, ctx)
+		operator_id: toUin$1(adminUid, ctx),
+		user_id: toUin$1(memberUid, ctx)
 	};
 }
 /** 管理员变更（BLOCK=set / UNBLOCK=unset）。 */
@@ -1988,7 +2027,7 @@ function toAdminChange(common, grp, ctx) {
 		notice_type: "group_admin",
 		sub_type: grp.type === TipGroupElementType.BLOCK ? "set" : "unset",
 		group_id: groupId,
-		user_id: toUin(memberUid === "" ? adminUid : memberUid, ctx)
+		user_id: toUin$1(memberUid === "" ? adminUid : memberUid, ctx)
 	};
 }
 /** 禁言（duration>0=ban / 否则 lift_ban）。 */
@@ -2002,29 +2041,167 @@ function toBan(common, grp, ctx) {
 		notice_type: "group_ban",
 		sub_type: Number(shutUp?.duration ?? 0) > 0 ? "ban" : "lift_ban",
 		group_id: groupId,
-		operator_id: toUin(shutUp?.admin?.uid ?? adminUid, ctx),
-		user_id: toUin(shutUp?.member?.uid ?? memberUid, ctx),
+		operator_id: toUin$1(shutUp?.admin?.uid ?? adminUid, ctx),
+		user_id: toUin$1(shutUp?.member?.uid ?? memberUid, ctx),
 		duration: Number(shutUp?.duration ?? 0)
 	};
 }
-/** RawMessage → OB11 notice 事件（无 grayTip 返回 null）。 */
+/**
+* 好友添加（friend_add，B2，2026-09-08）。
+* 数据源 = kernel BuddyCache 快照 diff（Buddy/onBuddyListChange 全量快照对比，
+* 首帧 baseline 不发）——非 grayTip 路径。user_id 取 coreInfo.uin（顶层 uin 兜底）。
+*/
+function toFriendAdd(entry, selfUin) {
+	const uin = entry.coreInfo?.uin ?? entry.uin ?? "";
+	return {
+		time: Math.floor(Date.now() / MS_TO_SEC$3),
+		self_id: Number(selfUin),
+		post_type: "notice",
+		notice_type: "friend_add",
+		user_id: Number(uin)
+	};
+}
+/**
+* 群文件上传（group_upload，B4，2026-09-08）。
+* 数据源 = 含 fileElement 的群消息（开关 groupUploadAsNotice=true 时替代
+* message 事件报出）。file.id 取 fileUuid（缺省文件名）、size 取 fileSize、
+* busid 固定 102（群文件业务类型，与 kernel GROUP_FILE_BIZ_TYPE 同源语义）。
+*/
+function toGroupUpload(msg, selfUin) {
+	const file = msg.elements.find((e) => e.fileElement !== void 0)?.fileElement;
+	if (file === void 0) return null;
+	return {
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		self_id: Number(selfUin),
+		post_type: "notice",
+		notice_type: "group_upload",
+		group_id: Number(msg.peerUid),
+		user_id: Number(msg.senderUin),
+		file: {
+			id: file.fileUuid ?? file.fileName ?? "",
+			name: file.fileName ?? "",
+			size: Number(file.fileSize ?? 0),
+			busid: GROUP_FILE_BUS_ID
+		}
+	};
+}
+/** 单个 grayTip 元素 → notice 事件（null = 不可翻译；未知子类型打 raw 日志）。 */
+function translateGrayTip(msg, g, ctx) {
+	const subType = g.subElementType;
+	if (subType === GrayTipSubType.REVOKE) return toRecall(msg, g, ctx);
+	if (subType === GrayTipSubType.GROUP) return toGroupChange(msg, g, ctx);
+	if (g.aioOpGrayTipElement !== void 0) return toPoke(msg, g, ctx);
+	ctx.logger?.warn({
+		subType,
+		raw: JSON.stringify(g)?.slice(0, 2e3)
+	}, "ob11: 未翻译的 grayTip 子类型（raw 校准数据）");
+	return null;
+}
+/** RawMessage → OB11 notice 事件（无 grayTip 返回 null）。
+* 未知/未翻译子类型打 raw JSON 日志（校准数据积累，2026-09-08）。 */
 function toOb11NoticeEvent(msg, ctx) {
 	for (const el of msg.elements) {
 		const g = el.grayTipElement;
 		if (g === void 0) continue;
-		const subType = g.subElementType;
-		if (subType === GrayTipSubType.REVOKE) {
-			const recall = toRecall(msg, g, ctx);
-			if (recall !== null) return recall;
-		}
-		if (subType === GrayTipSubType.GROUP) {
-			const change = toGroupChange(msg, g, ctx);
-			if (change !== null) return change;
-		}
+		const event = translateGrayTip(msg, g, ctx);
+		if (event !== null) return event;
 	}
 	return null;
 }
 //#endregion
+//#region src/onebot11/helper/request.ts
+/**
+* OB11 request 事件翻译（2026-09-08）
+*
+* 事件源（kernel 事件通道，本次接线）：
+*  - `Group/onGroupNotifiesUpdated`（GroupBridge，群系统通知推送）→ group_add / group_invite
+*  - `Buddy/onBuddyReqChange`（FriendBridge，好友申请推送）→ friend
+*
+* flag 语义（与应答动作匹配路径一致）：
+*  - 群请求 flag = GroupNotify.seq（set_group_add_request 按 `item.seq === flag` 匹配）
+*  - 好友请求 flag = BuddyReq.reqTime（set_friend_add_request 按 `reqTime === flag` 匹配）
+*
+* 纯函数（ADR-008）：uid→uin 由调用方批量转换后传入。
+* ⚠️ onBuddyReqChange 回调参数形状未经真实事件校准（wrapper 字符串证据仅有方法名），
+* narrowBuddyReqs 防御性收窄，未知形状返回 null 由调用方打 raw 日志积累校准数据。
+*/
+/** 毫秒 → 秒（Unix 时间戳）。 */
+const MS_TO_SEC$2 = 1e3;
+/** uid → uin（上下文映射缺省时：数字 uid 直取数值，非数字 uid 返回 0 表示未知）。 */
+function toUin(uid, ctx) {
+	if (uid === void 0 || uid === "") return 0;
+	const uin = ctx.uidToUin.get(uid);
+	if (uin !== void 0) return Number(uin);
+	const n = Number(uid);
+	return Number.isFinite(n) ? n : 0;
+}
+/**
+* GroupNotify → OB11 群请求事件（group_add / group_invite）。
+*
+* type 语义与 get_group_system_msg 动作同一解释：1/5=邀请（invite）、7=申请（add）；
+* 仅未处理状态（KUNHANDLE）推送——已处理通知重复推送不再发事件。
+* 非请求类通知（踢人/转让等处理结果回执）返回 null。
+*/
+function toOb11GroupRequestEvent(notify, ctx) {
+	if (notify.status !== GroupNotifyMsgStatus.KUNHANDLE) return null;
+	let subType;
+	switch (notify.type) {
+		case GroupNotifyMsgType.INVITED_BY_MEMBER:
+		case GroupNotifyMsgType.INVITED_NEED_ADMINI_STRATOR_PASS:
+			subType = "invite";
+			break;
+		case GroupNotifyMsgType.REQUEST_JOIN_NEED_ADMINI_STRATOR_PASS:
+			subType = "add";
+			break;
+		default: return null;
+	}
+	return {
+		time: Math.floor(Date.now() / MS_TO_SEC$2),
+		self_id: Number(ctx.selfUin),
+		post_type: "request",
+		request_type: "group",
+		sub_type: subType,
+		group_id: Number(notify.group?.groupCode ?? 0),
+		user_id: toUin(notify.user1?.uid, ctx),
+		comment: notify.postscript ?? "",
+		flag: String(notify.seq)
+	};
+}
+/** BuddyReq 防御性收窄：仅接受字段形状可用的对象（onBuddyReqChange 参数待真实事件校准）。 */
+function isBuddyReqLike(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const v = value;
+	return typeof v["reqTime"] === "string" && typeof v["friendUid"] === "string";
+}
+/**
+* onBuddyReqChange 回调参数 → BuddyReq 列表（防御性收窄）。
+* 已知候选形状：BuddyReq[] / { buddyReqs: BuddyReq[] }；其余返回 null（调用方打 raw 日志）。
+*/
+function narrowBuddyReqs(arg) {
+	if (Array.isArray(arg)) return arg.every(isBuddyReqLike) ? arg : null;
+	if (typeof arg === "object" && arg !== null) {
+		const reqs = arg["buddyReqs"];
+		if (Array.isArray(reqs) && reqs.every(isBuddyReqLike)) return reqs;
+	}
+	return null;
+}
+/**
+* BuddyReq → OB11 好友请求事件（friend）。
+* comment 取 words 字段（验证留言，形状待校准，缺省空串）；flag = reqTime。
+*/
+function toOb11FriendRequestEvent(req, ctx) {
+	const words = req["words"];
+	return {
+		time: Math.floor(Date.now() / MS_TO_SEC$2),
+		self_id: Number(ctx.selfUin),
+		post_type: "request",
+		request_type: "friend",
+		user_id: toUin(req.friendUid, ctx),
+		comment: typeof words === "string" ? words : "",
+		flag: req.reqTime
+	};
+}
+//#endregion
 //#region src/onebot11/action/message/get-forward-msg.ts
 /**
 * get_forward_msg 动作：获取合并转发内容（P2-12 接 kernel MsgApi.fetchForwardMessage）
@@ -2156,10 +2333,17 @@ var GetGroupMsgHistoryAction = class extends BaseAction {
 //#endregion
 //#region src/onebot11/action/message/get-media.ts
 /**
-* get_image / get_record 动作：获取图片/语音文件信息（P2-14，简化版）
+* get_image / get_record 动作：获取图片/语音文件（P2-14；2026-09-08 T5 接主动下载；
+* 2026-09-08 B1 语音接原生 downloadRichMedia）
 *
-* message_id 反查 → fetchMsgsByMsgId → 找 PIC/PTT 元素 → 返回元素已有路径与 URL。
-* 不做主动下载/转码（NapCat 走 downloadRichMedia 事件驱动下载，待后续接入）。
+* message_id 反查 → fetchMsgsByMsgId → 找 PIC/PTT 元素：
+*  - 本地文件解析：NT 相对路径（sourcePath/filePath）按 mediaBaseDir（QQ NT
+*    global 目录）解析为绝对路径，命中磁盘即返回 file
+*  - 图片主动下载：本地未命中且有 picUrl → @napuketto/media downloadUrl 落
+*    cacheDir/media/，返回 file（绝对路径）+ url + file_size/file_name
+*  - 语音主动下载（B1）：本地未命中 → kernel MsgApi.downloadPtt（原生
+*    downloadRichMedia + 轮询元素回查）→ filePath 落盘后返回绝对路径；
+*    失败回退原始 filePath（NT 相对/绝对）+ 元数据，不抛错
 */
 const getMediaSchema = z.object({
 	/** CQ 码 file 字段或 message_id（简化：message_id 反查）。 */
@@ -2167,6 +2351,35 @@ const getMediaSchema = z.object({
 	message_id: z.union([z.number(), z.string()]).optional()
 });
 /**
+* NT 相对路径 → 本地绝对路径（存在才返回）。
+* 候选：原样绝对路径 / mediaBaseDir 下相对路径（反斜杠归一化）。
+*/
+function resolveLocalMediaFile(relPath, deps) {
+	if (relPath === "") return null;
+	if (existsSync(relPath)) return relPath;
+	const base = deps.mediaBaseDir;
+	if (base !== void 0 && base !== "") {
+		const joined = join(base, relPath.replaceAll("\\", "/"));
+		if (existsSync(joined)) return joined;
+	}
+	return null;
+}
+/** 图片主动下载（picUrl → cacheDir/media/<uuid>.<ext>；无 cacheDir/url 返回 null）。 */
+async function downloadImageToCache(url, deps) {
+	const cacheDir = deps.cacheDir;
+	if (cacheDir === void 0 || cacheDir === "") return null;
+	const mediaDir = join(cacheDir, "media");
+	const { mkdir } = await import("node:fs/promises");
+	await mkdir(mediaDir, { recursive: true });
+	const dest = join(mediaDir, `${randomUUID()}${inferExtension(null, url)}`);
+	try {
+		await downloadUrl(url, dest);
+		return dest;
+	} catch {
+		return null;
+	}
+}
+/**
 * 反查消息并提取媒体元素路径。
 * 返回 null = 消息不存在；extract 返回 undefined = 无匹配元素。
 */
@@ -2180,26 +2393,13 @@ async function resolveMedia(id, label, deps, extract) {
 	}
 	throw kernelError(`消息 ${id} 不包含${label}`, "NOT_FOUND");
 }
-/** 从消息元素提取媒体路径与 URL（PIC/PTT，纯函数）。 */
-function extractMediaPath(element) {
-	const pic = element.picElement;
-	if (pic !== void 0) {
-		const out = {};
-		const path = pic.sourcePath ?? pic.picPath;
-		if (path !== void 0) out.file = path;
-		if (pic.picUrl !== void 0) out.url = pic.picUrl;
-		if (Object.keys(out).length === 0) return;
-		return out;
-	}
-	const ptt = element.pttElement;
-	if (ptt !== void 0 && ptt.filePath !== void 0) return { file: ptt.filePath };
-}
-/** 提取语音元素（get_record 用）。 */
-function extractPttPath(element) {
-	const ptt = element.pttElement;
-	if (ptt !== void 0 && ptt.filePath !== void 0) return { file: ptt.filePath };
+/** 取 id 参数（message_id 优先，file 兜底）。 */
+function takeId(payload, actionName) {
+	const id = payload.message_id ?? payload.file;
+	if (id === void 0) throw kernelError(`${actionName} 需要 message_id 或 file`, "INVALID_PARAM");
+	return id;
 }
-/** 获取图片信息（P2-14）。 */
+/** 获取图片信息（本地优先，picUrl 主动下载兜底）。 */
 var GetImageAction = class extends BaseAction {
 	name = "get_image";
 	schema = getMediaSchema;
@@ -2209,16 +2409,29 @@ var GetImageAction = class extends BaseAction {
 		super();
 		this.deps = deps;
 	}
-	_handle(payload) {
-		return this.resolve(payload, "图片", "get_image");
-	}
-	resolve(payload, label, actionName) {
-		const id = payload.message_id ?? payload.file;
-		if (id === void 0) throw kernelError(`${actionName} 需要 message_id 或 file`, "INVALID_PARAM");
-		return resolveMedia(id, label, this.deps, extractMediaPath);
+	async _handle(payload) {
+		const base = await resolveMedia(takeId(payload, "get_image"), "图片", this.deps, (el) => {
+			const pic = el.picElement;
+			if (pic === void 0) return;
+			const out = {};
+			if (pic.fileSize !== void 0) out.file_size = pic.fileSize;
+			if (pic.fileName !== void 0) out.file_name = pic.fileName;
+			if (pic.picUrl !== void 0) out.url = pic.picUrl;
+			const rel = pic.sourcePath ?? pic.picPath;
+			if (rel !== void 0) {
+				const local = resolveLocalMediaFile(rel, this.deps);
+				if (local !== null) out.file = local;
+			}
+			return out;
+		});
+		if (base.file === void 0 && base.url !== void 0) {
+			const downloaded = await downloadImageToCache(base.url, this.deps);
+			if (downloaded !== null) base.file = downloaded;
+		}
+		return base;
 	}
 };
-/** 获取语音信息（P2-14）。 */
+/** 获取语音信息（本地优先；未命中走原生 downloadRichMedia，失败回退原始路径）。 */
 var GetRecordAction = class extends BaseAction {
 	name = "get_record";
 	schema = getMediaSchema;
@@ -2229,9 +2442,37 @@ var GetRecordAction = class extends BaseAction {
 		this.deps = deps;
 	}
 	async _handle(payload) {
-		const id = payload.message_id ?? payload.file;
-		if (id === void 0) throw kernelError("get_record 需要 message_id 或 file", "INVALID_PARAM");
-		return await resolveMedia(id, "语音", this.deps, extractPttPath);
+		const id = takeId(payload, "get_record");
+		const { msgId, peer } = resolveMsgIdAndPeer(id, this.deps.messageUnique);
+		const [first] = await this.deps.msgApi.fetchMsgsByMsgId(peer, [msgId]);
+		if (first === void 0) throw kernelError(`消息 ${id} 不存在或已被撤回`, "NOT_FOUND");
+		const ptt = first.elements.find((e) => e.pttElement !== void 0)?.pttElement;
+		if (ptt === void 0 || ptt.filePath === void 0) throw kernelError(`消息 ${id} 不包含语音`, "NOT_FOUND");
+		const meta = () => ({
+			...ptt.fileSize !== void 0 ? { file_size: ptt.fileSize } : {},
+			...ptt.fileName !== void 0 ? { file_name: ptt.fileName } : {}
+		});
+		const local = resolveLocalMediaFile(ptt.filePath, this.deps);
+		if (local !== null) return {
+			...meta(),
+			file: local
+		};
+		try {
+			const downloaded = await this.deps.msgApi.downloadPtt(msgId, peer);
+			const rel = downloaded.filePath;
+			if (rel !== void 0 && rel !== "") {
+				const localAfter = resolveLocalMediaFile(rel, this.deps);
+				if (localAfter !== null) return {
+					...downloaded.fileSize !== void 0 ? { file_size: downloaded.fileSize } : {},
+					...downloaded.fileName !== void 0 ? { file_name: downloaded.fileName } : {},
+					file: localAfter
+				};
+			}
+		} catch {}
+		return {
+			...meta(),
+			file: ptt.filePath
+		};
 	}
 };
 //#endregion
@@ -3287,6 +3528,8 @@ var OneBotApi = class {
 	cleanCache;
 	/** 缓存目录（download_file 用）。 */
 	cacheDir;
+	/** QQ NT global 目录（媒体 NT 相对路径解析用）。 */
+	mediaBaseDir;
 	/** 进程退出回调（bot_exit 用）。 */
 	exit;
 	/** 进程重启回调（set_restart 用）。 */
@@ -3308,6 +3551,7 @@ var OneBotApi = class {
 		this.appVersion = opts.system.appVersion;
 		this.cleanCache = opts.system.cleanCache;
 		this.cacheDir = opts.system.cacheDir;
+		this.mediaBaseDir = opts.system.mediaBaseDir;
 		this.exit = opts.system.exit;
 		this.restart = opts.system.restart;
 	}
@@ -3391,10 +3635,13 @@ function toOb11MessageEvent(msg, selfUin, unique, messageFormat = "array", ctx =
 */
 /** Authorization 头前缀。 */
 const BEARER_PREFIX = "Bearer ";
-/** 校验 URL 查询参数里的 access_token（WS client 连接 URL 可能带）。 */
+/** 校验 URL 查询参数里的 access_token（WS client 连接 URL 可能带）。
+* ⚠️ req.url 是纯路径（无 origin），new URL(相对路径) 必抛——2026-09-08
+* T10 E2E 实测抓到的 bug（查询参数鉴权从未生效，WS 全被 4401 关闭），
+* 用 dummy base 解析。 */
 function hasAccessTokenQuery(url, token) {
 	try {
-		return new URL(url).searchParams.get("access_token") === token;
+		return new URL(url, "http://localhost").searchParams.get("access_token") === token;
 	} catch {
 		return false;
 	}
@@ -3525,15 +3772,23 @@ const MS_TO_SEC = 1e3;
 var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 	protocol = "onebot11";
 	msgChannel;
+	groupChannel;
+	friendChannel;
+	buddyCacheEvents;
+	calibLogger;
 	selfUin;
 	oneBotApi;
 	/** 动作注册表（公共只读：IPC 桥等装配方枚举动作名直接挂载）。 */
 	registry;
-	unsubscribe = null;
+	unsubscribes = [];
 	transports = null;
 	heartbeatTimer = null;
 	reportSelfMessage = false;
 	messageFormat = "array";
+	/** 群文件报形式（B4）：true = fileElement 群消息报 group_upload notice 替代 message。 */
+	groupUploadAsNotice = false;
+	/** IPC 桥模式标记（subscribeOnly 启动；reload 时跳过传输重建）。 */
+	subscribedOnly = false;
 	constructor(opts) {
 		super({
 			config: opts.config,
@@ -3541,20 +3796,38 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 			hooks: {
 				onStart: (config) => this.startTransports(config),
 				onStop: () => this.stopAll(),
-				onReload: () => {
-					return Promise.resolve();
-				}
+				onReload: (config) => this.reloadTransports(config)
 			}
 		});
 		this.msgChannel = opts.msgChannel;
+		this.groupChannel = opts.groupChannel;
+		this.friendChannel = opts.friendChannel;
+		this.buddyCacheEvents = opts.buddyCacheEvents;
+		this.calibLogger = opts.logger;
 		this.selfUin = opts.self.uin;
 		this.oneBotApi = new OneBotApi(opts);
 		this.registry = createOb11ActionRegistry({ api: this.oneBotApi });
 	}
+	/**
+	* 配置热更新（P2-6，2026-09-08 实现）：stop 旧传输/心跳/退订 → 按新配置重建。
+	* IPC 桥模式（subscribeOnly，无传输）只刷新上报开关字段，不重建。
+	*/
+	async reloadTransports(config) {
+		if (this.subscribedOnly) {
+			this.reportSelfMessage = config.reportSelfMessage;
+			this.messageFormat = config.messagePostFormat;
+			this.groupUploadAsNotice = config.groupUploadAsNotice;
+			return;
+		}
+		await this.stopAll();
+		await this.startTransports(config);
+	}
 	/** 启动传输：装配（HTTP/WS）+ 打开 server/client + 广播 lifecycle enable + 起心跳。 */
 	async startTransports(config) {
+		this.subscribedOnly = false;
 		this.reportSelfMessage = config.reportSelfMessage;
 		this.messageFormat = config.messagePostFormat;
+		this.groupUploadAsNotice = config.groupUploadAsNotice;
 		const broadcaster = this.getBroadcaster();
 		if (broadcaster !== void 0) {
 			this.transports = assembleOb11Transports({
@@ -3616,19 +3889,46 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 			this.transports = null;
 		}
 	}
-	/** 订阅 kernel 消息事件（幂等）。 */
+	/** 订阅 kernel 事件（消息 + 群通知 + 好友请求，幂等）。 */
 	subscribe() {
-		if (this.unsubscribe !== null) return;
-		this.unsubscribe = this.msgChannel.on("Msg/onRecvMsg", (msgs) => {
+		if (this.unsubscribes.length > 0) return;
+		this.unsubscribes.push(this.msgChannel.on("Msg/onRecvMsg", (msgs) => {
 			forEachRawMessage(msgs, (msg) => {
 				if (hasGrayTip(msg)) {
 					this.broadcastNotice(msg).catch(() => {});
 					return;
 				}
 				if (!this.reportSelfMessage && String(msg.senderUin) === this.selfUin) return;
+				if (this.groupUploadAsNotice && msg.chatType === ChatType.GROUP && hasFileElement(msg)) {
+					const notice = toGroupUpload(msg, this.selfUin);
+					if (notice !== null) {
+						this.broadcastEvent(notice);
+						return;
+					}
+				}
 				this.broadcastMessageEvent(msg);
 			});
-		});
+		}));
+		if (this.groupChannel !== void 0) this.unsubscribes.push(this.groupChannel.on("Group/onGroupNotifiesUpdated", (doubt, notifies) => {
+			if (doubt || !Array.isArray(notifies)) return;
+			this.broadcastGroupRequests(notifies);
+		}));
+		if (this.friendChannel !== void 0) {
+			this.unsubscribes.push(this.friendChannel.on("Buddy/onBuddyReqChange", (arg) => {
+				const reqs = narrowBuddyReqs(arg);
+				if (reqs === null) {
+					this.calibLogger?.warn({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, "ob11: onBuddyReqChange 未知参数形状");
+					return;
+				}
+				this.broadcastFriendRequests(reqs);
+			}));
+			for (const evt of ["Buddy/onBuddyListChange", "Buddy/onBuddyListChangedV2"]) this.unsubscribes.push(this.friendChannel.on(evt, (arg) => {
+				this.calibLogger?.info({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, `ob11: ${evt} raw（friend_add 校准数据）`);
+			}));
+		}
+		if (this.buddyCacheEvents !== void 0) this.unsubscribes.push(this.buddyCacheEvents.on("BuddyCache/onBuddyAdded", (entry) => {
+			this.broadcastEvent(toFriendAdd(entry, this.selfUin));
+		}));
 	}
 	/**
 	* 仅启动接收链路（IPC 桥模式，2026-08-27）：订阅消息通道维护 messageUnique +
@@ -3639,10 +3939,13 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		const config = await this.config.load();
 		this.reportSelfMessage = config.reportSelfMessage;
 		this.messageFormat = config.messagePostFormat;
+		this.groupUploadAsNotice = config.groupUploadAsNotice;
+		this.subscribedOnly = true;
 		this.subscribe();
 	}
 	/** 仅退订（与 subscribeOnly 配对的进程级清理；传输关闭仍走 stop()）。 */
 	unsubscribeOnly() {
+		this.subscribedOnly = false;
 		this.unsubscribeAll();
 	}
 	/**
@@ -3669,21 +3972,57 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		if (uids.length > 0) uidToUin = await this.oneBotApi.uidToUin(uids);
 		const notice = toOb11NoticeEvent(msg, {
 			selfUin: this.selfUin,
-			uidToUin
+			uidToUin,
+			...this.calibLogger !== void 0 ? { logger: this.calibLogger } : {}
 		});
 		if (notice !== null) this.broadcastEvent(notice);
 	}
+	/** 广播群系统通知 → OB11 group request 事件（批量 uidToUin 后翻译，纯函数）。 */
+	async broadcastGroupRequests(notifies) {
+		const uids = [];
+		for (const n of notifies) {
+			const notify = n;
+			for (const u of [notify.user1, notify.user2]) if (typeof u?.uid === "string" && u.uid !== "") uids.push(u.uid);
+		}
+		let uidToUin = /* @__PURE__ */ new Map();
+		if (uids.length > 0) try {
+			uidToUin = await this.oneBotApi.uidToUin(uids);
+		} catch {}
+		const ctx = {
+			selfUin: this.selfUin,
+			uidToUin
+		};
+		for (const n of notifies) {
+			const event = toOb11GroupRequestEvent(n, ctx);
+			if (event !== null) this.broadcastEvent(event);
+		}
+	}
+	/** 广播好友申请 → OB11 friend request 事件（批量 uidToUin 后翻译，纯函数）。 */
+	async broadcastFriendRequests(reqs) {
+		const uids = reqs.map((r) => r.friendUid).filter((uid) => uid !== "");
+		let uidToUin = /* @__PURE__ */ new Map();
+		if (uids.length > 0) try {
+			uidToUin = await this.oneBotApi.uidToUin(uids);
+		} catch {}
+		const ctx = {
+			selfUin: this.selfUin,
+			uidToUin
+		};
+		for (const req of reqs) this.broadcastEvent(toOb11FriendRequestEvent(req, ctx));
+	}
 	/** 退订（幂等）。 */
 	unsubscribeAll() {
-		this.unsubscribe?.();
-		this.unsubscribe = null;
+		for (const off of this.unsubscribes) off();
+		this.unsubscribes = [];
 	}
 	/**
 	* 请求分发（挂到 network transport 的 onRequest）：
 	* OB11 标准请求 { action, params, echo } → 动作注册表 → handle（HTTP）/websocketHandle（WS）。
 	*/
 	async handleRequest(req, respond) {
-		const { action: rawAction, params, echo } = req ?? {};
+		const parsed = req ?? {};
+		const { action: rawAction, echo } = parsed;
+		const params = parsed.params ?? {};
 		let action = "";
 		if (typeof rawAction === "string") action = rawAction;
 		if (action === "") {