@napuketto/adapter 0.0.1

package/dist/onebot11/index.mjs

@@ -0,0 +1,3695 @@
+import { a as ActionRegistry, n as BaseProtocolAdapter, r as BaseAction } from "../core-Bj5L8WeZ.mjs";
+import { ChatType, GrayTipSubType, GroupApi, GroupNotifyMsgType, NTGroupMemberRole, NTGroupRequestOperateTypes, TicketApi, TipGroupElementType, WebHonorType, kernelError, toCanonicalElements } from "@napuketto/kernel";
+import { z } from "zod";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { HttpClient, HttpServer, WsClient, WsServer } from "@napuketto/network";
+//#region src/onebot11/action/error-map.ts
+/** OB11 错误码映射表（send_msg 等所有 OB11 动作共用）。 */
+const ob11ErrorCodeMap = {
+	SEND_FAILED: 100,
+	PERMISSION_DENIED: 101,
+	NOT_FOUND: 102,
+	TIMEOUT: 103,
+	NOT_LOGIN: 104,
+	INVALID_PARAM: 105,
+	INVALID_STATE: 106,
+	UNKNOWN: 999
+};
+//#endregion
+//#region src/onebot11/action/friend/delete-friend.ts
+/**
+* delete_friend 动作：删除好友（P2-11 接 kernel FriendApi.deleteFriend）
+*/
+const deleteFriendSchema = z.object({ user_id: z.number() });
+/** 删除好友（P2-11 接 kernel deleteFriend）。 */
+var DeleteFriendAction = class extends BaseAction {
+	name = "delete_friend";
+	schema = deleteFriendSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		await this.deps.friendApi.deleteFriend(uid);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/get-doubt-friends-add-request.ts
+const getDoubtFriendsAddRequestSchema = z.object({ count: z.number().optional() });
+/** 默认获取数量。 */
+const DEFAULT_COUNT$3 = 50;
+/** 获取可疑好友申请（P2-11 接 kernel getDoubtFriendRequest）。 */
+var GetDoubtFriendsAddRequestAction = class extends BaseAction {
+	name = "get_doubt_friends_add_request";
+	schema = getDoubtFriendsAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	friendApi;
+	constructor(friendApi) {
+		super();
+		this.friendApi = friendApi;
+	}
+	_handle(payload) {
+		return this.friendApi.getDoubtFriendRequest(payload.count ?? DEFAULT_COUNT$3);
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/get-friend-list.ts
+const getFriendListSchema = z.object({ 
+/** 是否忽略缓存（go-cqhttp 扩展）。 */
+no_cache: z.boolean().optional() });
+/** 获取好友列表（P2-4 接 kernel apis/friend）。 */
+var GetFriendListAction = class extends BaseAction {
+	name = "get_friend_list";
+	schema = getFriendListSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	friendApi;
+	constructor(friendApi) {
+		super();
+		this.friendApi = friendApi;
+	}
+	async _handle(_payload) {
+		return (await this.friendApi.getFriendList()).map((f) => {
+			const info = {
+				user_id: Number(f.uin),
+				nickname: f.nickname
+			};
+			if (f.remark !== "") info.remark = f.remark;
+			return info;
+		});
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/get-friends-with-category.ts
+const getFriendsWithCategorySchema = z.object({});
+/** 获取好友列表（含分类，P2-11 接 kernel getFriendCategories）。 */
+var GetFriendsWithCategoryAction = class extends BaseAction {
+	name = "get_friends_with_category";
+	schema = getFriendsWithCategorySchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	friendApi;
+	constructor(friendApi) {
+		super();
+		this.friendApi = friendApi;
+	}
+	_handle(_payload) {
+		return this.friendApi.getFriendCategories();
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/get-stranger-info.ts
+const getStrangerInfoSchema = z.object({
+	user_id: z.number(),
+	no_cache: z.boolean().optional()
+});
+/** 获取陌生人信息（P2-15 接 kernel ProfileApi）。 */
+var GetStrangerInfoAction = class extends BaseAction {
+	name = "get_stranger_info";
+	schema = getStrangerInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	profileApi;
+	constructor(profileApi) {
+		super();
+		this.profileApi = profileApi;
+	}
+	async _handle(payload) {
+		return {
+			...await this.profileApi.getStrangerInfo(String(payload.user_id)),
+			user_id: payload.user_id
+		};
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/send-like.ts
+/**
+* send_like 动作：点赞（P2-14 接 kernel ProfileLikeApi.sendLike）
+*/
+const sendLikeSchema = z.object({
+	user_id: z.number(),
+	times: z.number().optional()
+});
+/** 点赞（P2-14 接 kernel ProfileLikeApi）。 */
+var SendLikeAction = class extends BaseAction {
+	name = "send_like";
+	schema = sendLikeSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		await this.deps.profileLikeApi.sendLike(uid, payload.times ?? 1);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/set-doubt-friends-add-request.ts
+const setDoubtFriendsAddRequestSchema = z.object({
+	flag: z.string(),
+	approve: z.boolean().optional()
+});
+/** 处理可疑好友申请（P2-11 接 kernel handleDoubtFriendRequest）。 */
+var SetDoubtFriendsAddRequestAction = class extends BaseAction {
+	name = "set_doubt_friends_add_request";
+	schema = setDoubtFriendsAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	friendApi;
+	constructor(friendApi) {
+		super();
+		this.friendApi = friendApi;
+	}
+	_handle(payload) {
+		this.friendApi.handleDoubtFriendRequest(payload.flag);
+		return Promise.resolve(null);
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/set-friend-add-request.ts
+/**
+* set_friend_add_request 动作：处理加好友请求（P2-11）
+*
+* flag=reqTime（NapCat 约定，需从好友请求事件上报中获取）→ getBuddyReqList
+* 匹配 → handleFriendRequest(notify, approve) + optional remark。
+*/
+const setFriendAddRequestSchema = z.object({
+	flag: z.string(),
+	approve: z.boolean().optional(),
+	remark: z.string().optional()
+});
+/** 处理加好友请求（P2-11 接 kernel FriendApi）。 */
+var SetFriendAddRequestAction = class extends BaseAction {
+	name = "set_friend_add_request";
+	schema = setFriendAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	friendApi;
+	constructor(friendApi) {
+		super();
+		this.friendApi = friendApi;
+	}
+	async _handle(payload) {
+		const notify = (await this.friendApi.getBuddyReqList()).find((req) => req.reqTime === payload.flag);
+		if (notify === void 0) throw kernelError("未找到对应的好友请求（flag 无效或已过期）", "NOT_FOUND");
+		await this.friendApi.handleFriendRequest(notify, payload.approve !== false);
+		if (payload.remark !== void 0) this.friendApi.setFriendRemark(notify.friendUid, payload.remark);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/friend/set-friend-remark.ts
+/**
+* set_friend_remark 动作：设置好友备注（P2-11 接 kernel FriendApi.setFriendRemark）
+*/
+const setFriendRemarkSchema = z.object({
+	user_id: z.number(),
+	remark: z.string()
+});
+/** 设置好友备注（P2-11 接 kernel setFriendRemark）。 */
+var SetFriendRemarkAction = class extends BaseAction {
+	name = "set_friend_remark";
+	schema = setFriendRemarkSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = await this.resolveUid(payload.user_id);
+		this.deps.friendApi.setFriendRemark(uid, payload.remark);
+		return null;
+	}
+	/** user_id（uin）→ uid。 */
+	async resolveUid(userId) {
+		const uid = (await this.deps.uinToUid([String(userId)])).get(String(userId));
+		if (uid === void 0) throw kernelError(`用户 ${userId} 的 uid 解析失败`, "INVALID_PARAM");
+		return uid;
+	}
+};
+//#endregion
+//#region src/onebot11/helper/message-unique.ts
+/** OB11 message_id 上限（int32 max = 0x7FFF_FFFF）。 */
+const INT32_MAX = 2147483647;
+/** int32 下限。 */
+const INT32_MIN = 1;
+var MessageUnique = class {
+	/** NT msgId → OB11 message_id。 */
+	msgIdToInt = /* @__PURE__ */ new Map();
+	/** OB11 message_id → NT msgId。 */
+	intToMsgId = /* @__PURE__ */ new Map();
+	/** NT msgId → Peer（delete_msg / get_msg 等只有 message_id 时反查用）。 */
+	msgIdToPeer = /* @__PURE__ */ new Map();
+	/** 递增计数器。 */
+	cursor = 1;
+	/** 已释放的槽位（可复用）。 */
+	freed = /* @__PURE__ */ new Set();
+	/**
+	* 为新 NT 消息分配 OB11 message_id（幂等：同一 msgId 返回同一 id）。
+	* peer 可选：传入则记录，供 message_id → peer 反查。
+	*/
+	alloc(msgId, peer) {
+		const existing = this.msgIdToInt.get(msgId);
+		if (existing !== void 0) {
+			if (peer !== void 0) this.msgIdToPeer.set(msgId, peer);
+			return existing;
+		}
+		const id = this.nextFreeId();
+		this.msgIdToInt.set(msgId, id);
+		this.intToMsgId.set(id, msgId);
+		if (peer !== void 0) this.msgIdToPeer.set(msgId, peer);
+		this.freed.delete(id);
+		return id;
+	}
+	/** OB11 message_id → NT msgId。 */
+	getMsgId(messageId) {
+		return this.intToMsgId.get(messageId);
+	}
+	/** NT msgId → OB11 message_id（未分配返回 undefined）。 */
+	getMessageId(msgId) {
+		return this.msgIdToInt.get(msgId);
+	}
+	/** NT msgId → Peer（alloc 时未记录返回 undefined）。 */
+	getPeer(msgId) {
+		return this.msgIdToPeer.get(msgId);
+	}
+	/** 释放 NT msgId 占用的槽位（消息过期/删除时调用，可选）。 */
+	release(msgId) {
+		const id = this.msgIdToInt.get(msgId);
+		if (id === void 0) return;
+		this.msgIdToInt.delete(msgId);
+		this.intToMsgId.delete(id);
+		this.msgIdToPeer.delete(msgId);
+		this.freed.add(id);
+	}
+	/** 取下一个可用 id：优先释放池，否则递增（溢出后线性扫描空洞）。 */
+	nextFreeId() {
+		for (const id of this.freed) return id;
+		if (this.cursor > INT32_MAX) {
+			for (let i = INT32_MIN; i <= INT32_MAX; i += 1) if (!this.intToMsgId.has(i)) {
+				this.cursor = i + 1;
+				return i;
+			}
+			throw kernelError("MessageUnique 槽位耗尽（>2^31 条消息）", "INVALID_STATE");
+		}
+		const id = this.cursor;
+		this.cursor += 1;
+		return id;
+	}
+};
+/**
+* 从 OB11 message_id 反查 NT msgId + Peer。
+* delete_msg / get_msg / set_msg_emoji_like / fetch_ptt_text / 精华消息等
+* 只有 message_id 参数的动作共用（消息不存在抛 KernelError NOT_FOUND）。
+*/
+function resolveMsgIdAndPeer(messageId, unique) {
+	let shortId;
+	if (typeof messageId === "number") shortId = messageId;
+	else shortId = Number(messageId);
+	const msgId = unique.getMsgId(shortId);
+	if (msgId === void 0) throw kernelError(`消息 ${messageId} 不存在`, "NOT_FOUND");
+	const peer = unique.getPeer(msgId);
+	if (peer === void 0) throw kernelError(`消息 ${messageId} 无会话记录`, "NOT_FOUND");
+	return {
+		msgId,
+		peer
+	};
+}
+//#endregion
+//#region src/onebot11/action/group/delete-essence-msg.ts
+/**
+* delete_essence_msg 动作：取消精华消息（P2-10 接 kernel GroupApi.removeGroupEssence）
+*/
+const deleteEssenceMsgSchema = z.object({ message_id: z.union([z.number(), z.string()]) });
+/** 取消精华消息（P2-10 接 kernel removeGroupEssence）。 */
+var DeleteEssenceMsgAction = class extends BaseAction {
+	name = "delete_essence_msg";
+	schema = deleteEssenceMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		if (peer.chatType !== ChatType.GROUP) throw kernelError("精华消息仅支持群聊消息", "INVALID_PARAM");
+		await this.deps.groupApi.removeGroupEssence(peer.peerUid, msgId);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-essence-msg-list.ts
+const getEssenceMsgListSchema = z.object({ group_id: z.number() });
+/** 文本段类型（msg_content.msg_type）。 */
+const MSG_TYPE_TEXT = 1;
+/** 图片段类型（msg_content.msg_type）。 */
+const MSG_TYPE_IMAGE = 3;
+/** 获取群精华消息列表（P2-15 接 kernel WebApi）。 */
+var GetEssenceMsgListAction = class extends BaseAction {
+	name = "get_essence_msg_list";
+	schema = getEssenceMsgListSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	webApi;
+	constructor(webApi) {
+		super();
+		this.webApi = webApi;
+	}
+	async _handle(payload) {
+		const list = await this.webApi.getEssenceMsgList(String(payload.group_id));
+		const out = [];
+		for (const item of list) {
+			const content = [];
+			for (const part of item.msg_content ?? []) {
+				const seg = toSegment(part);
+				if (seg !== null) content.push(seg);
+			}
+			out.push({
+				msg_seq: item.msg_seq,
+				msg_random: item.msg_random,
+				sender_id: Number(item.sender_uin),
+				sender_nick: item.sender_nick,
+				operator_id: Number(item.add_digest_uin),
+				operator_nick: item.add_digest_nick,
+				operator_time: item.add_digest_time,
+				message_id: 0,
+				content
+			});
+		}
+		return out;
+	}
+};
+/** msg_content 项 → OB11 段（1=text 3=image，纯函数）。 */
+function toSegment(part) {
+	if (part.msg_type === MSG_TYPE_TEXT) return {
+		type: "text",
+		data: { text: part.text ?? "" }
+	};
+	if (part.msg_type === MSG_TYPE_IMAGE) return {
+		type: "image",
+		data: { file: part.image_url ?? "" }
+	};
+	return null;
+}
+//#endregion
+//#region src/onebot11/action/group/get-group-add-request.ts
+const getGroupAddRequestSchema = z.object({ count: z.number().optional() });
+/** 默认获取数量。 */
+const DEFAULT_COUNT$2 = 100;
+/** 获取未处理群申请（P2-15）。 */
+var GetGroupAddRequestAction = class extends BaseAction {
+	name = "get_group_add_request";
+	schema = getGroupAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupNotifyApi;
+	constructor(groupNotifyApi) {
+		super();
+		this.groupNotifyApi = groupNotifyApi;
+	}
+	async _handle(payload) {
+		return (await this.groupNotifyApi.getSingleScreenNotifies(false, payload.count ?? DEFAULT_COUNT$2)).map(toGroupAddRequestItem);
+	}
+};
+/** 获取被忽略群申请（P2-15）。 */
+var GetGroupIgnoredNotifiesAction = class extends BaseAction {
+	name = "get_group_ignored_notifies";
+	schema = getGroupAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupNotifyApi;
+	constructor(groupNotifyApi) {
+		super();
+		this.groupNotifyApi = groupNotifyApi;
+	}
+	async _handle(payload) {
+		return (await this.groupNotifyApi.getSingleScreenNotifies(true, payload.count ?? DEFAULT_COUNT$2)).map(toGroupAddRequestItem);
+	}
+};
+/** GroupNotify → OB11 群请求项（纯函数）。 */
+function toGroupAddRequestItem(notify) {
+	const { seq, type, status, postscript, user1, group } = notify;
+	let groupCode = 0;
+	let groupName = "";
+	if (group !== void 0) {
+		const { groupCode: code, groupName: name } = group;
+		groupCode = Number(code);
+		groupName = name;
+	}
+	let userId = 0;
+	let userNick = "";
+	if (user1 !== void 0) {
+		const { uid, nickName } = user1;
+		userId = Number(uid);
+		userNick = nickName;
+	}
+	return {
+		flag: seq,
+		group_id: groupCode,
+		group_name: groupName,
+		user_id: userId,
+		user_nick: userNick,
+		type,
+		checked: status !== 1,
+		postscript: postscript ?? ""
+	};
+}
+//#endregion
+//#region src/onebot11/action/group/get-group-at-all-remain.ts
+const getGroupAtAllRemainSchema = z.object({ group_id: z.number() });
+/** 获取群 @全体成员 剩余次数（P2-10 接 kernel getGroupRemainAtTimes）。 */
+var GetGroupAtAllRemainAction = class extends BaseAction {
+	name = "get_group_at_all_remain";
+	schema = getGroupAtAllRemainSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		const remain = await this.groupApi.getGroupRemainAtTimes(String(payload.group_id));
+		return {
+			can_at_all: remain.canAtAll,
+			remain_at_all_count_for_uin: remain.remainAtAllCountForUin,
+			remain_at_all_count_for_group: remain.remainAtAllCountForGroup
+		};
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-honor-info.ts
+const getGroupHonorInfoSchema = z.object({
+	group_id: z.number(),
+	type: z.string().optional()
+});
+/** 获取群荣誉信息（P2-15 接 kernel WebApi）。 */
+var GetGroupHonorInfoAction = class extends BaseAction {
+	name = "get_group_honor_info";
+	schema = getGroupHonorInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	webApi;
+	constructor(webApi) {
+		super();
+		this.webApi = webApi;
+	}
+	_handle(payload) {
+		const type = mapHonorType(payload.type);
+		return this.webApi.getGroupHonorInfo(String(payload.group_id), type);
+	}
+};
+/** type 字符串 → WebHonorType（talkative/performer/legend/emotion/all，纯函数）。 */
+function mapHonorType(raw) {
+	if (raw === "talkative") return WebHonorType.TALKATIVE;
+	if (raw === "performer") return WebHonorType.PERFORMER;
+	if (raw === "legend") return WebHonorType.LEGEND;
+	if (raw === "emotion") return WebHonorType.EMOTION;
+	return WebHonorType.ALL;
+}
+//#endregion
+//#region src/onebot11/helper/translate.ts
+/**
+* OB11 翻译辅助（NT 实体 → OB11 结构，P2-4）
+*
+* 纯函数（ADR-008）：只读入参，不调 API、不读缓存。
+* 群成员/群信息等 NT 实体 → OB11 返回结构的薄映射。
+*/
+/** NT Group → OB11 GroupInfo。 */
+function toOb11GroupInfo(group) {
+	const info = {
+		group_id: Number(group.groupCode),
+		group_name: group.groupName
+	};
+	if (typeof group.memberCount === "number") info.member_count = group.memberCount;
+	if (typeof group.maxMember === "number") info.max_member_count = group.maxMember;
+	return info;
+}
+/** NT GroupDetailInfo → OB11 GroupInfo（getGroupDetailInfo / GroupCache 用）。 */
+function toOb11GroupInfoDetail(detail) {
+	const info = {
+		group_id: Number(detail.groupCode),
+		group_name: detail.groupName
+	};
+	if (typeof detail.memberNum === "number") info.member_count = detail.memberNum;
+	if (typeof detail.maxMemberNum === "number") info.max_member_count = detail.maxMemberNum;
+	return info;
+}
+/** 禁言秒 → 毫秒（shut_up_timestamp 单位）。 */
+const SEC_TO_MS = 1e3;
+/** NT GroupMember → OB11 GroupMemberInfo（uin 由 uidToUin 映射补全）。 */
+function toOb11GroupMemberInfo(groupCode, member, uidToUin) {
+	let uinStr = member.uin;
+	if (uinStr === "") uinStr = uidToUin.get(member.uid) ?? member.uid;
+	const info = {
+		group_id: Number(groupCode),
+		user_id: Number(uinStr),
+		nickname: member.nick,
+		role: GroupApi.roleToString(member.role)
+	};
+	if (member.cardName !== "") info.card = member.cardName;
+	if (member.memberSpecialTitle !== void 0 && member.memberSpecialTitle !== "") {
+		info.title = member.memberSpecialTitle;
+		info.special_title = member.memberSpecialTitle;
+	}
+	if (member.shutUpTime > 0) info.shut_up_timestamp = member.shutUpTime * SEC_TO_MS;
+	if (member.joinTime !== "" && member.joinTime !== "0") info.join_time = Number(member.joinTime);
+	if (member.lastSpeakTime !== "" && member.lastSpeakTime !== "0") info.last_sent_time = Number(member.lastSpeakTime);
+	if (typeof member.age === "number") info.age = member.age;
+	return info;
+}
+//#endregion
+//#region src/onebot11/action/group/get-group-info.ts
+/**
+* get_group_info 动作：获取群信息（P2-4 接 kernel GroupApi；P2-17 读缓存）
+*/
+const getGroupInfoSchema = z.object({
+	group_id: z.number(),
+	/** 是否忽略缓存（go-cqhttp 扩展）。 */
+	no_cache: z.boolean().optional()
+});
+/** 获取群信息（P2-4 接 kernel apis/group；P2-17 优先读 GroupCache）。 */
+var GetGroupInfoAction = class extends BaseAction {
+	name = "get_group_info";
+	schema = getGroupInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		if (payload.no_cache !== true && this.deps.groupCache !== void 0) return toOb11GroupInfoDetail(await this.deps.groupCache.getGroupDetail(groupCode));
+		return toOb11GroupInfoDetail(await this.deps.groupApi.getGroupInfo(groupCode));
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-list.ts
+const getGroupListSchema = z.object({ 
+/** 是否忽略缓存（go-cqhttp 扩展）。 */
+no_cache: z.boolean().optional() });
+/** 获取群列表（P2-4 接 kernel apis/group）。 */
+var GetGroupListAction = class extends BaseAction {
+	name = "get_group_list";
+	schema = getGroupListSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		return (await this.groupApi.getGroupList(payload.no_cache === true)).map(toOb11GroupInfo);
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-member-info.ts
+/**
+* get_group_member_info 动作：获取群成员信息（P2-4 接 kernel GroupApi；P2-17 读缓存）
+*/
+const getGroupMemberInfoSchema = z.object({
+	group_id: z.number(),
+	user_id: z.number(),
+	/** 是否忽略缓存（go-cqhttp 扩展）。 */
+	no_cache: z.boolean().optional()
+});
+/** 获取群成员信息（P2-4 接 kernel apis/group；P2-17 优先读 GroupCache）。 */
+var GetGroupMemberInfoAction = class extends BaseAction {
+	name = "get_group_member_info";
+	schema = getGroupMemberInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		const uid = (await this.deps.groupApi.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`成员 ${payload.user_id} 不在群 ${payload.group_id}`, "NOT_FOUND");
+		const member = await this.resolveMember(groupCode, uid, payload.no_cache === true);
+		if (member === void 0) throw kernelError(`成员 ${payload.user_id} 不在群 ${payload.group_id}`, "NOT_FOUND");
+		return toOb11GroupMemberInfo(groupCode, member, await this.deps.groupApi.uidToUin([uid]));
+	}
+	/** 读缓存（缺省）或直查 api（no_cache=true / 未装配缓存）。 */
+	async resolveMember(groupCode, uid, noCache) {
+		if (noCache || this.deps.groupCache === void 0) {
+			const [member] = await this.deps.groupApi.getGroupMemberInfo(groupCode, [uid]);
+			return member;
+		}
+		return await this.deps.groupCache.getMember(groupCode, uid);
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-member-list.ts
+const getGroupMemberListSchema = z.object({
+	group_id: z.number(),
+	/** 是否忽略缓存（go-cqhttp 扩展）。 */
+	no_cache: z.boolean().optional()
+});
+/** 获取群成员列表（P2-4 接 kernel apis/group；P2-17 优先读 GroupCache）。 */
+var GetGroupMemberListAction = class extends BaseAction {
+	name = "get_group_member_list";
+	schema = getGroupMemberListSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		const noCache = payload.no_cache === true;
+		let members;
+		if (noCache || this.deps.groupCache === void 0) members = await this.deps.groupApi.getGroupMemberList(groupCode, noCache);
+		else members = await this.deps.groupCache.getMembers(groupCode);
+		const uinMap = await this.deps.groupApi.uidToUin(members.map((m) => m.uid));
+		return members.map((m) => toOb11GroupMemberInfo(groupCode, m, uinMap));
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-shut-list.ts
+/**
+* get_group_shut_list 动作：获取群禁言列表（P2-13 接 kernel GroupNotifyApi）
+*
+* getGroupShutUpMemberList → [{ user_id, nickname, shut_up_time }]（uin 经 uidToUin）。
+*/
+const getGroupShutListSchema = z.object({ group_id: z.number() });
+/** 获取群禁言列表（P2-13 接 kernel GroupNotifyApi）。 */
+var GetGroupShutListAction = class extends BaseAction {
+	name = "get_group_shut_list";
+	schema = getGroupShutListSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const members = await this.deps.groupNotifyApi.getGroupShutUpMemberList(String(payload.group_id));
+		const uids = members.map((m) => m.uid);
+		let uinMap = /* @__PURE__ */ new Map();
+		if (uids.length > 0) uinMap = await this.deps.uidToUin(uids);
+		const out = [];
+		for (const member of members) out.push({
+			user_id: Number(uinMap.get(member.uid) ?? member.uin ?? member.uid),
+			nickname: member.nick,
+			shut_up_time: member.shutUpTime
+		});
+		return out;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/get-group-system-msg.ts
+const getGroupSystemMsgSchema = z.object({ count: z.number().optional() });
+/** 默认获取数量。 */
+const DEFAULT_COUNT$1 = 50;
+/** 获取群系统消息（P2-13 接 kernel GroupNotifyApi）。 */
+var GetGroupSystemMsgAction = class extends BaseAction {
+	name = "get_group_system_msg";
+	schema = getGroupSystemMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const count = payload.count ?? DEFAULT_COUNT$1;
+		const notifies = await this.deps.groupNotifyApi.getSingleScreenNotifies(false, count);
+		const uinMap = await this.collectUinMap(notifies);
+		const invited = [];
+		const joined = [];
+		for (const notify of notifies) {
+			const info = toMessageInfo(notify, uinMap);
+			if (notify.type === GroupNotifyMsgType.INVITED_BY_MEMBER) invited.push(info);
+			else if (notify.type === GroupNotifyMsgType.REQUEST_JOIN_NEED_ADMINI_STRATOR_PASS) joined.push(info);
+		}
+		const result = {
+			invited_requests: invited,
+			join_requests: joined
+		};
+		result["InvitedRequest"] = invited;
+		return result;
+	}
+	/** 收集全部涉及的 uid 批量转 uin（循环外一次请求）。 */
+	async collectUinMap(notifies) {
+		const uids = [];
+		for (const notify of notifies) {
+			const { user1, user2 } = notify;
+			if (user1 !== void 0) {
+				const { uid } = user1;
+				if (uid !== "") uids.push(uid);
+			}
+			if (user2 !== void 0) {
+				const { uid } = user2;
+				if (uid !== "") uids.push(uid);
+			}
+		}
+		if (uids.length === 0) return /* @__PURE__ */ new Map();
+		return await this.deps.uidToUin(uids);
+	}
+};
+/** GroupNotify → OB11 群系统消息结构（纯函数，uin 已批量转换）。 */
+function toMessageInfo(notify, uinMap) {
+	const { seq, status, postscript, user1, user2, group } = notify;
+	let user1Uid = "";
+	if (user1 !== void 0) {
+		const { uid } = user1;
+		user1Uid = uid;
+	}
+	let user2Uid = "";
+	if (user2 !== void 0) {
+		const { uid } = user2;
+		user2Uid = uid;
+	}
+	let groupCode = 0;
+	let groupName = "";
+	if (group !== void 0) {
+		const { groupCode: code, groupName: name } = group;
+		groupCode = Number(code);
+		groupName = name;
+	}
+	let invitorUin = Number(user1Uid);
+	const mapped1 = uinMap.get(user1Uid);
+	if (mapped1 !== void 0) invitorUin = Number(mapped1);
+	let actor = Number(user2Uid);
+	const mapped2 = uinMap.get(user2Uid);
+	if (mapped2 !== void 0) actor = Number(mapped2);
+	let invitorNick = "";
+	if (user1 !== void 0) {
+		const { nickName } = user1;
+		invitorNick = nickName;
+	}
+	return {
+		request_id: Number(seq),
+		invitor_uin: invitorUin,
+		invitor_nick: invitorNick,
+		group_id: groupCode,
+		message: postscript ?? "",
+		group_name: groupName,
+		checked: status !== 1,
+		actor,
+		requester_nick: invitorNick
+	};
+}
+//#endregion
+//#region src/onebot11/action/group/group-files-op.ts
+const createGroupFileFolderSchema = z.object({
+	group_id: z.number(),
+	folder_name: z.string()
+});
+/** 创建群文件夹（P2-14）。 */
+var CreateGroupFileFolderAction = class extends BaseAction {
+	name = "create_group_file_folder";
+	schema = createGroupFileFolderSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		return { folder_id: await this.richMediaApi.createGroupFolder(String(payload.group_id), payload.folder_name) };
+	}
+};
+const deleteGroupFileSchema = z.object({
+	group_id: z.number(),
+	file_id: z.string(),
+	/** 兼容 go-cqhttp 的 file_ids 数组（取第一个）。 */
+	file_ids: z.array(z.string()).optional()
+});
+/** 删除群文件（P2-14）。 */
+var DeleteGroupFileAction = class extends BaseAction {
+	name = "delete_group_file";
+	schema = deleteGroupFileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		const ids = payload.file_ids ?? [payload.file_id];
+		await this.richMediaApi.deleteGroupFile(String(payload.group_id), ids);
+		return null;
+	}
+};
+const deleteGroupFolderSchema = z.object({
+	group_id: z.number(),
+	folder_id: z.string()
+});
+/** 删除群文件夹（P2-14）。 */
+var DeleteGroupFolderAction = class extends BaseAction {
+	name = "delete_group_folder";
+	schema = deleteGroupFolderSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		await this.richMediaApi.deleteGroupFolder(String(payload.group_id), payload.folder_id);
+		return null;
+	}
+};
+const renameGroupFileSchema = z.object({
+	group_id: z.number(),
+	file_id: z.string(),
+	new_name: z.string()
+});
+/** 重命名群文件（P2-14）。 */
+var RenameGroupFileAction = class extends BaseAction {
+	name = "rename_group_file";
+	schema = renameGroupFileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		await this.richMediaApi.renameGroupFile(String(payload.group_id), payload.file_id, payload.new_name);
+		return null;
+	}
+};
+const moveGroupFileSchema = z.object({
+	group_id: z.number(),
+	file_id: z.string(),
+	file_ids: z.array(z.string()).optional(),
+	/** 目标文件夹 ID（空为根目录）。 */
+	folder_id: z.string().optional()
+});
+/** 移动群文件（P2-14）。 */
+var MoveGroupFileAction = class extends BaseAction {
+	name = "move_group_file";
+	schema = moveGroupFileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		const ids = payload.file_ids ?? [payload.file_id];
+		await this.richMediaApi.moveGroupFile(String(payload.group_id), ids, payload.folder_id ?? "");
+		return null;
+	}
+};
+const transGroupFileSchema = z.object({
+	group_id: z.number(),
+	file_id: z.string()
+});
+/** 转存群文件（P2-14）。 */
+var TransGroupFileAction = class extends BaseAction {
+	name = "trans_group_file";
+	schema = transGroupFileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		await this.richMediaApi.transGroupFile(String(payload.group_id), payload.file_id);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/group-files-query.ts
+const getGroupRootFilesSchema = z.object({
+	group_id: z.number(),
+	file_count: z.number().optional()
+});
+/** 默认文件数量。 */
+const DEFAULT_FILE_COUNT = 50;
+/** 获取群根目录文件列表（P2-14 接 kernel RichMediaApi）。 */
+var GetGroupRootFilesAction = class extends BaseAction {
+	name = "get_group_root_files";
+	schema = getGroupRootFilesSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		return splitFilesAndFolders(await this.richMediaApi.getGroupFileList(String(payload.group_id), "", payload.file_count ?? DEFAULT_FILE_COUNT));
+	}
+};
+const getGroupFilesByFolderSchema = z.object({
+	group_id: z.number(),
+	folder_id: z.string(),
+	file_count: z.number().optional()
+});
+/** 获取群指定文件夹文件列表（P2-14）。 */
+var GetGroupFilesByFolderAction = class extends BaseAction {
+	name = "get_group_files_by_folder";
+	schema = getGroupFilesByFolderSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		return splitFilesAndFolders(await this.richMediaApi.getGroupFileList(String(payload.group_id), payload.folder_id, payload.file_count ?? DEFAULT_FILE_COUNT));
+	}
+};
+const getGroupFileSystemInfoSchema = z.object({ group_id: z.number() });
+/** 群文件系统信息（P2-14）。 */
+var GetGroupFileSystemInfoAction = class extends BaseAction {
+	name = "get_group_file_system_info";
+	schema = getGroupFileSystemInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		const info = await this.richMediaApi.getGroupFileSystemInfo(String(payload.group_id));
+		return {
+			file_count: info.fileCount,
+			limit_count: info.limitCount,
+			used_space: info.usedSpace,
+			total_space: info.totalSpace
+		};
+	}
+};
+/** 列表拆分 files/folders（fileInfo/folderInfo 取其一，纯函数）。 */
+function splitFilesAndFolders(list) {
+	const files = [];
+	const folders = [];
+	for (const item of list) {
+		const file = item.fileInfo;
+		if (file === void 0) {
+			const folder = item.folderInfo;
+			if (folder !== void 0) folders.push(toGroupFolderInfo(folder));
+		} else {
+			const out = toGroupFileInfo(file);
+			files.push(out);
+		}
+	}
+	return {
+		files,
+		folders
+	};
+}
+/** GroupFileItemInfo → OB11 文件结构（纯函数）。 */
+function toGroupFileInfo(file) {
+	const out = {
+		file_id: file.fileId,
+		file_name: file.fileName,
+		file_size: file.fileSize
+	};
+	if (file.uploaderUin !== void 0) out.uploader = Number(file.uploaderUin);
+	if (file.uploadTime !== void 0) out.upload_time = file.uploadTime;
+	if (file.modifyTime !== void 0) out.modify_time = file.modifyTime;
+	return out;
+}
+/** KernelFolderInfo → OB11 文件夹结构（纯函数）。 */
+function toGroupFolderInfo(folder) {
+	return {
+		folder_id: folder.folderId,
+		folder_name: folder.folderName
+	};
+}
+//#endregion
+//#region src/onebot11/action/group/set-essence-msg.ts
+/**
+* set_essence_msg 动作：设置精华消息（P2-10 接 kernel GroupApi.addGroupEssence）
+*
+* message_id → msgId + peer（MessageUnique 反查，需群消息）→ addGroupEssence。
+*/
+const setEssenceMsgSchema = z.object({ message_id: z.union([z.number(), z.string()]) });
+/** 设置精华消息（P2-10 接 kernel addGroupEssence）。 */
+var SetEssenceMsgAction = class extends BaseAction {
+	name = "set_essence_msg";
+	schema = setEssenceMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		if (peer.chatType !== ChatType.GROUP) throw kernelError("精华消息仅支持群聊消息", "INVALID_PARAM");
+		await this.deps.groupApi.addGroupEssence(peer.peerUid, msgId);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-add-request.ts
+/**
+* set_group_add_request 动作：处理加群请求（P2-13 接 kernel GroupNotifyApi）
+*
+* flag=seq（群请求事件上报的 flag）→ getSingleScreenNotifies(doubt, count)
+* 匹配 → handleGroupRequest（approve=true→同意 / false→拒绝，reason 默认空格）。
+*/
+const setGroupAddRequestSchema = z.object({
+	flag: z.string(),
+	approve: z.boolean().optional(),
+	reason: z.string().optional(),
+	count: z.number().optional()
+});
+/** 默认搜索通知数量。 */
+const DEFAULT_COUNT = 100;
+/** 处理加群请求（P2-13 接 kernel GroupNotifyApi）。 */
+var SetGroupAddRequestAction = class extends BaseAction {
+	name = "set_group_add_request";
+	schema = setGroupAddRequestSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupNotifyApi;
+	constructor(groupNotifyApi) {
+		super();
+		this.groupNotifyApi = groupNotifyApi;
+	}
+	async _handle(payload) {
+		const count = payload.count ?? DEFAULT_COUNT;
+		const notify = await this.findNotify(payload.flag, count);
+		if (notify === null) throw kernelError("未找到对应的群请求（flag 无效或已过期）", "NOT_FOUND");
+		let operateType = NTGroupRequestOperateTypes.KREFUSE;
+		if (payload.approve !== false) operateType = NTGroupRequestOperateTypes.KAGREE;
+		await this.groupNotifyApi.handleGroupRequest(false, notify, operateType, payload.reason ?? " ");
+		return null;
+	}
+	/** 按 seq 匹配通知（先非可疑，后可疑）。 */
+	async findNotify(flag, count) {
+		const hit = (await this.groupNotifyApi.getSingleScreenNotifies(false, count)).find((item) => item.seq === flag);
+		if (hit !== void 0) return hit;
+		return (await this.groupNotifyApi.getSingleScreenNotifies(true, count)).find((item) => item.seq === flag) ?? null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-admin.ts
+/**
+* set_group_admin 动作：设置群管理员（P2-10 接 kernel GroupApi.setMemberRole）
+*
+* enable=true 设为管理员，false 取消；user_id → uinToUid。
+*/
+const setGroupAdminSchema = z.object({
+	group_id: z.number(),
+	user_id: z.number(),
+	/** 是否设为管理员。 */
+	enable: z.boolean().default(true)
+});
+/** 设置群管理员（P2-10 接 kernel setMemberRole）。 */
+var SetGroupAdminAction = class extends BaseAction {
+	name = "set_group_admin";
+	schema = setGroupAdminSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		const uid = (await this.groupApi.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		let role = NTGroupMemberRole.MEMBER;
+		if (payload.enable) role = NTGroupMemberRole.ADMIN;
+		this.groupApi.setMemberRole(String(payload.group_id), uid, role);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-ban.ts
+/**
+* set_group_ban 动作：群组单人禁言（P2-10 接 kernel GroupApi.setMemberShutUp）
+*
+* duration 秒（0 解除禁言）；user_id → uinToUid。
+*/
+const setGroupBanSchema = z.object({
+	group_id: z.number(),
+	user_id: z.number(),
+	/** 禁言时长（秒），0 解除。 */
+	duration: z.number().default(30)
+});
+/** 群组单人禁言（P2-10 接 kernel setMemberShutUp）。 */
+var SetGroupBanAction = class extends BaseAction {
+	name = "set_group_ban";
+	schema = setGroupBanSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		const uid = (await this.groupApi.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		await this.groupApi.setMemberShutUp(String(payload.group_id), [{
+			uid,
+			duration: payload.duration
+		}]);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-card.ts
+/**
+* set_group_card 动作：设置群名片（P2-10 接 kernel GroupApi.setMemberCardName）
+*/
+const setGroupCardSchema = z.object({
+	group_id: z.number(),
+	user_id: z.number(),
+	/** 群名片（空串清除）。 */
+	card: z.string().optional().default("")
+});
+/** 设置群名片（P2-10 接 kernel setMemberCardName）。 */
+var SetGroupCardAction = class extends BaseAction {
+	name = "set_group_card";
+	schema = setGroupCardSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		const uid = (await this.groupApi.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		this.groupApi.setMemberCardName(String(payload.group_id), uid, payload.card);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-kick.ts
+/**
+* set_group_kick 动作：群组踢人（P2-10 接 kernel GroupApi.kickMember）
+*
+* user_id（uin）→ uinToUid → kickMember（kickMemberV2）。
+*/
+const setGroupKickSchema = z.object({
+	group_id: z.number(),
+	user_id: z.number(),
+	/** 是否拒绝加群请求（拉黑）。 */
+	reject_add_request: z.boolean().optional(),
+	/** 踢人理由。 */
+	kick_reason: z.string().optional()
+});
+/** 群组踢人（P2-10 接 kernel kickMember）。 */
+var SetGroupKickAction = class extends BaseAction {
+	name = "set_group_kick";
+	schema = setGroupKickSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		const uid = await this.resolveUid(payload.user_id);
+		await this.groupApi.kickMember(String(payload.group_id), [uid], payload.reject_add_request === true, payload.kick_reason ?? "");
+		return null;
+	}
+	/** user_id（uin）→ uid。 */
+	async resolveUid(userId) {
+		const uid = (await this.groupApi.uinToUid([String(userId)])).get(String(userId));
+		if (uid === void 0) throw kernelError(`用户 ${userId} 的 uid 解析失败`, "INVALID_PARAM");
+		return uid;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-leave.ts
+const setGroupLeaveSchema = z.object({
+	group_id: z.number(),
+	/** 是否解散群（仅群主可用）。 */
+	is_dismiss: z.boolean().optional().default(false)
+});
+/** 退出群聊（P2-10 接 kernel quitGroup）。 */
+var SetGroupLeaveAction = class extends BaseAction {
+	name = "set_group_leave";
+	schema = setGroupLeaveSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		await this.groupApi.quitGroup(String(payload.group_id), payload.is_dismiss);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-name.ts
+const setGroupNameSchema = z.object({
+	group_id: z.number(),
+	group_name: z.string()
+});
+/** 修改群名（P2-10 接 kernel modifyGroupName）。 */
+var SetGroupNameAction = class extends BaseAction {
+	name = "set_group_name";
+	schema = setGroupNameSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		await this.groupApi.modifyGroupName(String(payload.group_id), payload.group_name);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/group/set-group-whole-ban.ts
+const setGroupWholeBanSchema = z.object({
+	group_id: z.number(),
+	/** 是否开启全员禁言。 */
+	enable: z.boolean().default(true)
+});
+/** 群组全员禁言（P2-10 接 kernel setGroupShutUp）。 */
+var SetGroupWholeBanAction = class extends BaseAction {
+	name = "set_group_whole_ban";
+	schema = setGroupWholeBanSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	groupApi;
+	constructor(groupApi) {
+		super();
+		this.groupApi = groupApi;
+	}
+	async _handle(payload) {
+		await this.groupApi.setGroupShutUp(String(payload.group_id), payload.enable);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/delete-msg.ts
+/**
+* delete_msg 动作：撤回消息（P2-10 接 kernel MsgApi.recallMessage）
+*
+* OB11 标准 delete_msg 只有 message_id；peer 经 MessageUnique 反查。
+* 群聊管理员 / 私聊 2 分钟内可撤回。
+*/
+const deleteMsgSchema = z.object({ message_id: z.union([z.number(), z.string()]) });
+/** 撤回消息（P2-10 接 kernel recallMessage）。 */
+var DeleteMsgAction = class extends BaseAction {
+	name = "delete_msg";
+	schema = deleteMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		await this.deps.msgApi.recallMessage(peer, [msgId]);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/fetch-ptt-text.ts
+/**
+* fetch_ptt_text 动作：获取语音转文字结果（NapCat 扩展，P2-10）
+*
+* message_id → msgId + peer → MsgApi.fetchPttText（内部：拉消息 → 找 PTT 元素
+* → translatePtt2Text → 再拉取读 pttElement.text）。
+*/
+const fetchPttTextSchema = z.object({ message_id: z.union([z.number(), z.string()]) });
+/** 获取语音转文字结果（P2-10 接 kernel fetchPttText）。 */
+var FetchPttTextAction = class extends BaseAction {
+	name = "fetch_ptt_text";
+	schema = fetchPttTextSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		return { text: await this.deps.msgApi.fetchPttText(msgId, peer) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/forward-single-msg.ts
+/**
+* forward_group_single_msg / forward_friend_single_msg 动作：单条转发（P2-12）
+*
+* message_id 反查源 msgId + peer；group_id/user_id 为目标 →
+* MsgApi.forwardSingleMessage(srcPeer, [msgId], dstPeer)。
+*/
+const forwardSingleMsgSchema = z.object({
+	message_id: z.union([z.number(), z.string()]),
+	group_id: z.number().optional(),
+	user_id: z.number().optional()
+});
+/** 解析目标 Peer（group_id 直通；user_id 经 uin→uid）。 */
+async function resolveTargetPeer(payload, deps) {
+	if (payload.group_id !== void 0) return {
+		chatType: ChatType.GROUP,
+		peerUid: String(payload.group_id)
+	};
+	if (payload.user_id !== void 0) {
+		const uid = (await deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		return {
+			chatType: ChatType.C2C,
+			peerUid: uid
+		};
+	}
+	throw kernelError("单条转发需要 group_id 或 user_id", "INVALID_PARAM");
+}
+/** 单条转发基类（两个动作共用实现）。 */
+var ForwardSingleMsgBase = class extends BaseAction {
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer: sourcePeer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		const dstPeer = await resolveTargetPeer(payload, this.deps);
+		await this.deps.msgApi.forwardSingleMessage(sourcePeer, [msgId], dstPeer);
+		return null;
+	}
+};
+/** 转发单条消息到群（P2-12）。 */
+var ForwardGroupSingleMsgAction = class extends ForwardSingleMsgBase {
+	name = "forward_group_single_msg";
+	schema = forwardSingleMsgSchema;
+};
+/** 转发单条消息到好友（P2-12）。 */
+var ForwardFriendSingleMsgAction = class extends ForwardSingleMsgBase {
+	name = "forward_friend_single_msg";
+	schema = forwardSingleMsgSchema;
+};
+//#endregion
+//#region src/onebot11/helper/config.ts
+/**
+* OneBot 11 协议配置（zod schema，归属本包，ADR-012）
+* 协议配置 schema 在各自协议包，kernel 只提供 ConfigBase 基类。
+*
+* 2026-08-07 多实例化（P2-18）：对齐 NapCat——httpServers / httpPostUrls / wsServers /
+* wsReverseUrls 四个数组实例（每实例可覆盖全局 token）；旧单对象字段 http/httpPost/ws/
+* wsReverse 废弃（zod strip 静默忽略，不兼容迁移）。
+*/
+/** HTTP 反向服务器默认端口。 */
+const DEFAULT_HTTP_PORT = 3e3;
+/** 反向 WS server 默认端口。 */
+const DEFAULT_WS_PORT = 3001;
+/** 心跳 meta 事件默认间隔（毫秒）。 */
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 3e3;
+/** WS 传输 ping 默认间隔（毫秒）。 */
+const DEFAULT_WS_HEARTBEAT_MS = 3e4;
+/** WS 反向断线重连默认延迟（毫秒）。 */
+const DEFAULT_RECONNECT_DELAY_MS = 5e3;
+/** 消息内容格式（NapCat messagePostFormat）。 */
+const MESSAGE_FORMATS = ["array", "string"];
+/** HTTP 反向服务器实例（第三方 POST 指令入口）。 */
+const httpServerSchema = z.object({
+	enabled: z.boolean().default(false),
+	host: z.string().default("127.0.0.1"),
+	port: z.number().int().default(DEFAULT_HTTP_PORT),
+	/** 实例级 token，覆盖全局 token（缺省继承全局）。 */
+	token: z.string().optional()
+});
+/** HTTP 正向上报实例（Webhook 事件推送）。 */
+const httpPostSchema = z.object({
+	enabled: z.boolean().default(false),
+	url: z.string().optional(),
+	/** 实例级 token，覆盖全局 token（缺省继承全局）。 */
+	token: z.string().optional(),
+	/** 上报超时（毫秒），缺省不超时。 */
+	timeoutMs: z.number().int().optional()
+});
+/** 反向 WS server 实例（第三方 WS 连入）。 */
+const wsServerSchema = z.object({
+	enabled: z.boolean().default(false),
+	host: z.string().default("127.0.0.1"),
+	port: z.number().int().default(DEFAULT_WS_PORT),
+	/** 实例级 token，覆盖全局 token（缺省继承全局）。 */
+	token: z.string().optional(),
+	/** WS ping 间隔（毫秒）。 */
+	heartbeatInterval: z.number().int().default(DEFAULT_WS_HEARTBEAT_MS)
+});
+/** 正向 WS client 实例（主动连接第三方，双向）。 */
+const wsReverseSchema = z.object({
+	enabled: z.boolean().default(false),
+	url: z.string().optional(),
+	/** 实例级 token，覆盖全局 token（缺省继承全局）。 */
+	token: z.string().optional(),
+	/** 断线重连延迟（毫秒）。 */
+	reconnectDelayMs: z.number().int().default(DEFAULT_RECONNECT_DELAY_MS),
+	/** 最大重连次数（缺省无限）。 */
+	maxReconnectAttempts: z.number().int().optional(),
+	/** wss:// 是否校验证书（自签证书场景设 false，对齐 NapCat enableSelfSigned）。 */
+	rejectUnauthorized: z.boolean().default(true),
+	/** WS ping 间隔（毫秒）。 */
+	heartbeatInterval: z.number().int().default(DEFAULT_WS_HEARTBEAT_MS)
+});
+/** OB11 配置 schema。 */
+const ob11ConfigSchema = z.object({
+	/** 鉴权 token（全局默认，实例未指定时继承）。 */
+	token: z.string().optional(),
+	/** 心跳 meta 事件间隔（毫秒），0 关闭心跳。 */
+	heartbeatInterval: z.number().int().default(DEFAULT_HEARTBEAT_INTERVAL_MS),
+	/** 是否上报机器人自己发的消息（缺省 false = OB11 规范行为）。 */
+	reportSelfMessage: z.boolean().default(false),
+	/** 消息内容格式：array = 消息段数组（标准），string = CQ 码字符串。 */
+	messagePostFormat: z.enum(MESSAGE_FORMATS).default("array"),
+	/** HTTP 反向服务器列表。 */
+	httpServers: z.array(httpServerSchema).default([]),
+	/** HTTP 正向上报列表。 */
+	httpPostUrls: z.array(httpPostSchema).default([]),
+	/** 反向 WS server 列表。 */
+	wsServers: z.array(wsServerSchema).default([]),
+	/** 正向 WS client 列表。 */
+	wsReverseUrls: z.array(wsReverseSchema).default([])
+});
+//#endregion
+//#region src/onebot11/helper/cqcode.ts
+/**
+* CQ 码编解码（OneBot 11 消息段序列化格式）
+*
+* 纯函数、无 OB11 类型依赖：本文件只处理「文本 ↔ CQ 码片段」的通用编解码，
+* segment 级别的映射在 data.ts（OB11Constructor）。
+*
+* 转义规则（OneBot 11 规范）：
+* - 纯文本：& → &amp;，[ → &#91;，] → &#93;
+* - 参数值：额外 , → &#44;
+*/
+/** CQ 码片段正则（[CQ:xxx] 或 [CQ:xxx,k=v,...]）。 */
+const CQ_CODE_REGEX = /\[CQ:[^\]]*\]/g;
+/** 解析单个 CQ 码文本 → 结构化 CqCode。 */
+function parseCqCode(raw) {
+	const body = raw.slice(4, -1);
+	const firstComma = body.indexOf(",");
+	let type = body;
+	if (firstComma !== -1) type = body.slice(0, firstComma);
+	const params = {};
+	if (firstComma !== -1) for (const pair of body.slice(firstComma + 1).split(",")) {
+		const eq = pair.indexOf("=");
+		if (eq > 0) params[pair.slice(0, eq)] = unescapeCqText(pair.slice(eq + 1));
+	}
+	return {
+		type,
+		params
+	};
+}
+/** 转义纯文本（& [ ]；& 必须先转，避免二次转义）。 */
+function escapeCqText(text) {
+	return text.replaceAll("&", "&amp;").replaceAll("[", "&#91;").replaceAll("]", "&#93;");
+}
+/** 转义 CQ 码参数值（& [ ] ,）。 */
+function escapeCqParam(value) {
+	return escapeCqText(value).replaceAll(",", "&#44;");
+}
+/** 反转义（&#44; &#93; &#91; &amp;；&amp; 必须最后解，避免二次转义误伤）。 */
+function unescapeCqText(text) {
+	return text.replaceAll("&#44;", ",").replaceAll("&#93;", "]").replaceAll("&#91;", "[").replaceAll("&amp;", "&");
+}
+/** 编码单个 CQ 码（undefined 参数自动省略）。 */
+function encodeCqCode(type, params) {
+	const pairs = [];
+	for (const [key, value] of Object.entries(params)) if (value !== void 0) pairs.push(`${key}=${escapeCqParam(String(value))}`);
+	if (pairs.length === 0) return `[CQ:${type}]`;
+	return `[CQ:${type},${pairs.join(",")}]`;
+}
+/** 解析一条消息文本 → 文本片段与 CQ 码片段的混合数组（文本已反转义）。 */
+function parseCqMessage(text) {
+	const parts = [];
+	let lastIndex = 0;
+	for (const match of text.matchAll(CQ_CODE_REGEX)) {
+		const index = match.index ?? 0;
+		if (index > lastIndex) parts.push(unescapeCqText(text.slice(lastIndex, index)));
+		parts.push(parseCqCode(match[0] ?? ""));
+		lastIndex = index + match[0].length;
+	}
+	if (lastIndex < text.length) parts.push(unescapeCqText(text.slice(lastIndex)));
+	return parts;
+}
+/** 将混合片段数组序列化回消息文本（parseCqMessage 的逆操作）。 */
+function serializeCqParts(parts) {
+	let out = "";
+	for (const part of parts) if (typeof part === "string") out += escapeCqText(part);
+	else out += encodeCqCode(part.type, part.params);
+	return out;
+}
+//#endregion
+//#region src/onebot11/helper/data.ts
+/** OB11 媒体段 data（image/record/video 共用，url 可选）。 */
+function mediaData(file, url) {
+	const data = { file };
+	if (url !== void 0) data.url = url;
+	return data;
+}
+/** OB11 at 段 data（name 可选）。 */
+function atData(qq, name) {
+	const data = { qq };
+	if (name !== void 0) data.name = name;
+	return data;
+}
+/** canonical at 元素（display 可选）。 */
+function canonicalAt(target, display) {
+	const el = {
+		type: "at",
+		target
+	};
+	if (display !== void 0) el.display = display;
+	return el;
+}
+/** canonical 媒体元素（image/voice/video，url 可选；type 为联合需断言收窄）。 */
+function canonicalMedia(type, path, url) {
+	const el = {
+		type,
+		path
+	};
+	if (url !== void 0) el.url = url;
+	return el;
+}
+/** canonical json/xml 的 raw → OB11 data 字符串（字符串原样，对象序列化）。 */
+function rawToString(raw) {
+	if (typeof raw === "string") return raw;
+	return JSON.stringify(raw);
+}
+/** canonical 元素 → OB11 segment（null = OB11 无法表达，跳过）。 */
+function canonicalToSegment(el) {
+	if (el.type === "text") return {
+		type: "text",
+		data: { text: el.text }
+	};
+	if (el.type === "at") return {
+		type: "at",
+		data: atData(el.target, el.display)
+	};
+	if (el.type === "image") return {
+		type: "image",
+		data: mediaData(el.path, el.url)
+	};
+	if (el.type === "face") return {
+		type: "face",
+		data: { id: el.id }
+	};
+	if (el.type === "voice") return {
+		type: "record",
+		data: mediaData(el.path, el.url)
+	};
+	if (el.type === "video") return {
+		type: "video",
+		data: mediaData(el.path, el.url)
+	};
+	if (el.type === "reply") return {
+		type: "reply",
+		data: { id: el.messageId }
+	};
+	if (el.type === "forward") return {
+		type: "forward",
+		data: { id: el.messageIds[0] ?? "" }
+	};
+	if (el.type === "json") return {
+		type: "json",
+		data: { data: rawToString(el.raw) }
+	};
+	if (el.type === "xml") return {
+		type: "xml",
+		data: { data: rawToString(el.raw) }
+	};
+	return null;
+}
+/** OB11 segment → canonical 元素。 */
+function segmentToCanonical(seg) {
+	if (seg.type === "text" || seg.type === "string") return {
+		type: "text",
+		text: seg.data.text
+	};
+	if (seg.type === "at") return canonicalAt(seg.data.qq, seg.data.name);
+	if (seg.type === "face") return {
+		type: "face",
+		id: seg.data.id
+	};
+	if (seg.type === "image") return canonicalMedia("image", seg.data.file, seg.data.url);
+	if (seg.type === "record") return canonicalMedia("voice", seg.data.file, seg.data.url);
+	if (seg.type === "video") return canonicalMedia("video", seg.data.file, seg.data.url);
+	if (seg.type === "reply") return {
+		type: "reply",
+		messageId: seg.data.id
+	};
+	if (seg.type === "forward") return {
+		type: "forward",
+		messageIds: [seg.data.id]
+	};
+	if (seg.type === "json") return {
+		type: "json",
+		raw: seg.data.data
+	};
+	return {
+		type: "xml",
+		raw: seg.data.data
+	};
+}
+/** 已知 CQ 类型 → segment 构造器。 */
+const CQ_SEGMENT_BUILDERS = {
+	text: (params) => ({
+		type: "text",
+		data: { text: params["text"] ?? "" }
+	}),
+	at: (params) => ({
+		type: "at",
+		data: atData(params["qq"] ?? "", params["name"])
+	}),
+	face: (params) => ({
+		type: "face",
+		data: { id: params["id"] ?? "" }
+	}),
+	image: (params) => ({
+		type: "image",
+		data: mediaData(params["file"] ?? "", params["url"])
+	}),
+	record: (params) => ({
+		type: "record",
+		data: mediaData(params["file"] ?? "", params["url"])
+	}),
+	video: (params) => ({
+		type: "video",
+		data: mediaData(params["file"] ?? "", params["url"])
+	}),
+	reply: (params) => ({
+		type: "reply",
+		data: { id: params["id"] ?? "" }
+	}),
+	forward: (params) => ({
+		type: "forward",
+		data: { id: params["id"] ?? "" }
+	}),
+	json: (params) => ({
+		type: "json",
+		data: { data: params["data"] ?? "" }
+	}),
+	xml: (params) => ({
+		type: "xml",
+		data: { data: params["data"] ?? "" }
+	})
+};
+/** CQ 码片段 → OB11 segment（未知类型保留原文为 text 段，往返不丢数据）。 */
+function cqCodeToSegment(code) {
+	const builder = CQ_SEGMENT_BUILDERS[code.type];
+	if (builder === void 0) return {
+		type: "text",
+		data: { text: encodeCqCode(code.type, code.params) }
+	};
+	return builder(code.params);
+}
+/** canonical 元素数组 → OB11 segment 数组（无法表达的元素静默跳过）。 */
+function canonicalToSegments(elements) {
+	const segments = [];
+	for (const el of elements) {
+		const seg = canonicalToSegment(el);
+		if (seg !== null) segments.push(seg);
+	}
+	return segments;
+}
+/** OB11 segment 数组 → canonical 元素数组。 */
+function segmentsToCanonical(segments) {
+	const elements = [];
+	for (const seg of segments) {
+		const el = segmentToCanonical(seg);
+		if (el !== null) elements.push(el);
+	}
+	return elements;
+}
+/** OB11 segment 数组 → CQ 码字符串（text 段转义拼接，特殊段编码）。 */
+function segmentsToCqMessage(segments) {
+	let out = "";
+	for (const seg of segments) if (seg.type === "text" || seg.type === "string") out += escapeCqText(seg.data.text);
+	else out += encodeCqCode(seg.type, seg.data);
+	return out;
+}
+/**
+* 收集 canonical 元素里需要转换的 at uid / reply NT msgId（接收方向）。
+* 调用方据此批量 uidToUin（一次异步调用），避免逐元素查询。
+*/
+function collectReceiveNeeds(elements) {
+	const atUids = /* @__PURE__ */ new Set();
+	const replyMsgIds = /* @__PURE__ */ new Set();
+	for (const el of elements) if (el.type === "at" && el.target !== "all") atUids.add(el.target);
+	else if (el.type === "reply") replyMsgIds.add(el.messageId);
+	return {
+		atUids: [...atUids],
+		replyMsgIds: [...replyMsgIds]
+	};
+}
+/**
+* canonical 元素数组 → 应用接收方向 ID 转换（at uid→uin、reply NT msgId→OB11 id）。
+* 转换失败的元素原样保留（uid 未解析 / msgId 未映射——不阻塞上报）。
+*/
+function applyReceiveContext(elements, ctx) {
+	if (ctx.uidToUin === void 0 && ctx.msgIdToOb11Id === void 0) return elements;
+	const out = [];
+	for (const el of elements) {
+		if (el.type === "at" && el.target !== "all") {
+			const uin = ctx.uidToUin?.get(el.target);
+			out.push(uin !== void 0 ? {
+				...el,
+				target: uin
+			} : el);
+			continue;
+		}
+		if (el.type === "reply") {
+			const id = ctx.msgIdToOb11Id?.(el.messageId);
+			out.push(id !== void 0 ? {
+				...el,
+				messageId: String(id)
+			} : el);
+			continue;
+		}
+		out.push(el);
+	}
+	return out;
+}
+/**
+* canonical 元素数组 → 应用发送方向 ID 转换（at uin→uid、reply OB11 id→NT msgId）。
+* reply 反查不到时原样透传（兼容客户端直接给 NT msgId 的输入，不报错）。
+*/
+function applySendContext(elements, ctx) {
+	if (ctx.uinToUid === void 0 && ctx.ob11IdToMsgId === void 0) return elements;
+	const out = [];
+	for (const el of elements) {
+		if (el.type === "at" && el.target !== "all") {
+			const uid = ctx.uinToUid?.get(el.target);
+			out.push(uid !== void 0 ? {
+				...el,
+				target: uid
+			} : el);
+			continue;
+		}
+		if (el.type === "reply") {
+			const num = Number(el.messageId);
+			if (!Number.isNaN(num)) {
+				const msgId = ctx.ob11IdToMsgId?.(num);
+				if (msgId !== void 0) {
+					out.push({
+						...el,
+						messageId: msgId
+					});
+					continue;
+				}
+			}
+			out.push(el);
+			continue;
+		}
+		out.push(el);
+	}
+	return out;
+}
+/** CQ 码字符串 → OB11 segment 数组（未知 CQ 类型保留为 text 段原文）。 */
+function cqMessageToSegments(text) {
+	const segments = [];
+	for (const part of parseCqMessage(text)) if (typeof part === "string") {
+		if (part.length > 0) segments.push({
+			type: "text",
+			data: { text: part }
+		});
+	} else {
+		const seg = cqCodeToSegment(part);
+		if (seg !== null) segments.push(seg);
+	}
+	return segments;
+}
+/** canonical 元素数组 → CQ 码字符串。 */
+function canonicalToCqMessage(elements) {
+	return segmentsToCqMessage(canonicalToSegments(elements));
+}
+/** CQ 码字符串 → canonical 元素数组。 */
+function cqMessageToCanonical(text) {
+	return segmentsToCanonical(cqMessageToSegments(text));
+}
+//#endregion
+//#region src/onebot11/helper/message-info.ts
+/** 毫秒 → 秒（Unix 时间戳）。 */
+const MS_TO_SEC$3 = 1e3;
+/** RawMessage → OB11 消息信息（message_id 经 MessageUnique 映射）。
+* ctx（可选）：接收方向 ID 转换上下文（at uid→uin、reply NT msgId→OB11 id，P2-19）。 */
+function toOb11MessageInfo(msg, unique, ctx = {}) {
+	const elements = applyReceiveContext(toCanonicalElements(msg), ctx);
+	let messageType = "private";
+	if (msg.chatType === ChatType.GROUP) messageType = "group";
+	const info = {
+		message_id: unique.alloc(msg.msgId, {
+			chatType: msg.chatType,
+			peerUid: msg.peerUid
+		}),
+		message_type: messageType,
+		sender: {
+			user_id: Number(msg.senderUin),
+			nickname: msg.sendNickName
+		},
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		message: canonicalToSegments(elements),
+		raw_message: canonicalToCqMessage(elements)
+	};
+	if (msg.chatType === ChatType.GROUP) {
+		info.group_id = Number(msg.peerUid);
+		const { sender } = info;
+		sender.role = "member";
+		if (msg.sendMemberName !== void 0) sender.card = msg.sendMemberName;
+	} else info.user_id = Number(msg.senderUin);
+	return info;
+}
+//#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;
+/** 检查消息是否含可翻译的 grayTip 元素。 */
+function hasGrayTip(msg) {
+	return msg.elements.some((el) => el.grayTipElement !== void 0);
+}
+/** 收集 grayTip 涉及的 uid（批量 uidToUin 用）。 */
+function collectGrayTipUids(msg) {
+	const uids = /* @__PURE__ */ new Set();
+	for (const el of msg.elements) {
+		const g = el.grayTipElement;
+		if (g === void 0) continue;
+		const revoke = g.revokeElement;
+		if (revoke?.operatorUid !== void 0 && revoke.operatorUid !== "") uids.add(revoke.operatorUid);
+		const grp = g.groupElement;
+		if (grp === void 0) continue;
+		if (grp.memberUid !== void 0 && grp.memberUid !== "") uids.add(grp.memberUid);
+		if (grp.adminUid !== void 0 && grp.adminUid !== "") uids.add(grp.adminUid);
+		if (grp.shutUp?.admin?.uid !== void 0 && grp.shutUp.admin.uid !== "") uids.add(grp.shutUp.admin.uid);
+		if (grp.shutUp?.member?.uid !== void 0 && grp.shutUp.member.uid !== "") uids.add(grp.shutUp.member.uid);
+	}
+	return [...uids];
+}
+/** uid → uin（上下文映射缺省退化为 uid）。 */
+function toUin(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),
+		self_id: Number(ctx.selfUin),
+		post_type: "notice",
+		group_id: Number(msg.peerUid)
+	};
+}
+/** 撤回事件（group_recall）。 */
+function toRecall(msg, g, ctx) {
+	if (g?.revokeElement === void 0) return null;
+	const revoke = g.revokeElement;
+	return {
+		...base(msg, ctx),
+		notice_type: "group_recall",
+		user_id: toUin(revoke.operatorUid, ctx),
+		operator_id: toUin(revoke.operatorUid, ctx),
+		message_id: Number(msg.msgSeq)
+	};
+}
+/** 群成员变动（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 groupId = Number(msg.peerUid);
+	const time = Math.floor(Number(msg.msgTime) / MS_TO_SEC$2);
+	const selfId = Number(ctx.selfUin);
+	const memberUid = grp.memberUid ?? "";
+	const adminUid = grp.adminUid ?? "";
+	switch (grp.type) {
+		case TipGroupElementType.MEMBER_ADD: return {
+			time,
+			self_id: selfId,
+			post_type: "notice",
+			notice_type: "group_increase",
+			sub_type: adminUid === memberUid ? "approve" : "invite",
+			group_id: groupId,
+			operator_id: toUin(adminUid, ctx),
+			user_id: toUin(memberUid, ctx)
+		};
+		case TipGroupElementType.QUIT: return {
+			time,
+			self_id: selfId,
+			post_type: "notice",
+			notice_type: "group_decrease",
+			sub_type: "leave",
+			group_id: groupId,
+			operator_id: toUin(adminUid, ctx),
+			user_id: toUin(memberUid, ctx)
+		};
+		case TipGroupElementType.BLOCK:
+		case TipGroupElementType.UNBLOCK: return {
+			time,
+			self_id: selfId,
+			post_type: "notice",
+			notice_type: "group_admin",
+			sub_type: grp.type === TipGroupElementType.BLOCK ? "set" : "unset",
+			group_id: groupId,
+			user_id: toUin(memberUid === "" ? adminUid : memberUid, ctx)
+		};
+		case TipGroupElementType.SHUT_UP: {
+			const shutUp = grp.shutUp;
+			return {
+				time,
+				self_id: selfId,
+				post_type: "notice",
+				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),
+				duration: Number(shutUp?.duration ?? 0)
+			};
+		}
+		default: return null;
+	}
+}
+/** RawMessage → OB11 notice 事件（无 grayTip 返回 null）。 */
+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;
+		}
+	}
+	return null;
+}
+//#endregion
+//#region src/onebot11/action/message/get-forward-msg.ts
+/**
+* get_forward_msg 动作：获取合并转发内容（P2-12 接 kernel MsgApi.fetchForwardMessage）
+*
+* message_id / id → 反查 msgId + peer → fetchForwardMessage（getMultiMsg）→
+* 每条 toOb11MessageInfo → { messages }。
+*/
+const getForwardMsgSchema = z.object({
+	message_id: z.union([z.number(), z.string()]).optional(),
+	id: z.union([z.number(), z.string()]).optional()
+});
+/** 获取合并转发内容（P2-12 接 kernel fetchForwardMessage）。 */
+var GetForwardMsgAction = class extends BaseAction {
+	name = "get_forward_msg";
+	schema = getForwardMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const id = payload.message_id ?? payload.id;
+		if (id === void 0) throw kernelError("get_forward_msg 需要 message_id 或 id", "INVALID_PARAM");
+		const { msgId, peer } = resolveMsgIdAndPeer(id, this.deps.messageUnique);
+		return { messages: (await this.deps.msgApi.fetchForwardMessage(peer, msgId)).map((msg) => toOb11MessageInfo(msg, this.deps.messageUnique)) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/get-friend-msg-history.ts
+/**
+* get_friend_msg_history 动作：获取私聊历史消息（NapCat 扩展，P2-10）
+*
+* user_id → uin→uid → Peer{ C2C } → fetchMessages → 数组翻译。
+*/
+const getFriendMsgHistorySchema = z.object({
+	user_id: z.number(),
+	message_seq: z.union([z.number(), z.string()]).optional(),
+	count: z.number().default(20),
+	reverse_order: z.boolean().optional(),
+	reverseOrder: z.boolean().optional()
+});
+/** 获取私聊历史消息（P2-10 接 kernel fetchMessages）。 */
+var GetFriendMsgHistoryAction = class extends BaseAction {
+	name = "get_friend_msg_history";
+	schema = getFriendMsgHistorySchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		const peer = {
+			chatType: ChatType.C2C,
+			peerUid: uid
+		};
+		let startMsgId;
+		if (payload.message_seq !== void 0) {
+			const raw = String(payload.message_seq);
+			const shortId = Number(raw);
+			if (Number.isFinite(shortId)) startMsgId = this.deps.messageUnique.getMsgId(shortId);
+			startMsgId ??= raw;
+		}
+		const opts = { count: payload.count };
+		if (startMsgId !== void 0) opts.msgId = startMsgId;
+		const msgs = await this.deps.msgApi.fetchMessages(peer, opts);
+		if (msgs.length === 0) throw kernelError(`消息 ${payload.message_seq ?? "0"} 不存在`, "NOT_FOUND");
+		const atUids = /* @__PURE__ */ new Set();
+		for (const m of msgs) {
+			const { atUids: uids } = collectReceiveNeeds(toCanonicalElements(m));
+			for (const u of uids) atUids.add(u);
+		}
+		let uidToUin;
+		if (atUids.size > 0) try {
+			uidToUin = await this.deps.uidToUin([...atUids]);
+		} catch {}
+		const ctx = {
+			...uidToUin !== void 0 ? { uidToUin } : {},
+			msgIdToOb11Id: (m) => this.deps.messageUnique.getMessageId(m)
+		};
+		return { messages: msgs.map((msg) => toOb11MessageInfo(msg, this.deps.messageUnique, ctx)) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/get-group-msg-history.ts
+/**
+* get_group_msg_history 动作：获取群历史消息（go-cqhttp 扩展，P2-10）
+*
+* group_id → Peer{ GROUP } → MsgApi.fetchMessages（message_seq 起，count 条）
+* → 数组翻译为 OB11 消息信息。
+*/
+const getGroupMsgHistorySchema = z.object({
+	group_id: z.number(),
+	/** 起始消息序号（message_seq，缺省从最新拉）。 */
+	message_seq: z.union([z.number(), z.string()]).optional(),
+	count: z.number().default(20),
+	/** 是否反向排序（NapCat 扩展）。 */
+	reverse_order: z.boolean().optional(),
+	reverseOrder: z.boolean().optional()
+});
+/** 获取群历史消息（P2-10 接 kernel fetchMessages）。 */
+var GetGroupMsgHistoryAction = class extends BaseAction {
+	name = "get_group_msg_history";
+	schema = getGroupMsgHistorySchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const peer = {
+			chatType: ChatType.GROUP,
+			peerUid: String(payload.group_id)
+		};
+		let startMsgId;
+		if (payload.message_seq !== void 0) {
+			const raw = String(payload.message_seq);
+			const shortId = Number(raw);
+			if (Number.isFinite(shortId)) startMsgId = this.deps.messageUnique.getMsgId(shortId);
+			startMsgId ??= raw;
+		}
+		const opts = { count: payload.count };
+		if (startMsgId !== void 0) opts.msgId = startMsgId;
+		const msgs = await this.deps.msgApi.fetchMessages(peer, opts);
+		if (msgs.length === 0) throw kernelError(`消息 ${payload.message_seq ?? "0"} 不存在`, "NOT_FOUND");
+		const atUids = /* @__PURE__ */ new Set();
+		for (const m of msgs) {
+			const { atUids: uids } = collectReceiveNeeds(toCanonicalElements(m));
+			for (const u of uids) atUids.add(u);
+		}
+		let uidToUin;
+		if (atUids.size > 0) try {
+			uidToUin = await this.deps.uidToUin([...atUids]);
+		} catch {}
+		const ctx = {
+			...uidToUin !== void 0 ? { uidToUin } : {},
+			msgIdToOb11Id: (m) => this.deps.messageUnique.getMessageId(m)
+		};
+		return { messages: msgs.map((msg) => toOb11MessageInfo(msg, this.deps.messageUnique, ctx)) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/get-media.ts
+/**
+* get_image / get_record 动作：获取图片/语音文件信息（P2-14，简化版）
+*
+* message_id 反查 → fetchMsgsByMsgId → 找 PIC/PTT 元素 → 返回元素已有路径与 URL。
+* 不做主动下载/转码（NapCat 走 downloadRichMedia 事件驱动下载，待后续接入）。
+*/
+const getMediaSchema = z.object({
+	/** CQ 码 file 字段或 message_id（简化：message_id 反查）。 */
+	file: z.string().optional(),
+	message_id: z.union([z.number(), z.string()]).optional()
+});
+/** 从消息元素提取媒体路径与 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.path = path;
+		if (pic.picUrl !== void 0) out.url = pic.picUrl;
+		return out;
+	}
+	const ptt = element.pttElement;
+	if (ptt !== void 0 && ptt.filePath !== void 0) return { path: ptt.filePath };
+	return {};
+}
+/** 获取图片信息（P2-14）。 */
+var GetImageAction = class extends BaseAction {
+	name = "get_image";
+	schema = getMediaSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(payload) {
+		return this.resolveMedia(payload, "图片", "get_image");
+	}
+	/** 反查消息并提取媒体元素路径。 */
+	async resolveMedia(payload, label, actionName) {
+		const id = payload.message_id ?? payload.file;
+		if (id === void 0) throw kernelError(`${actionName} 需要 message_id 或 file`, "INVALID_PARAM");
+		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");
+		let found;
+		for (const el of first.elements) {
+			const media = extractMediaPath(el);
+			if (media.path !== void 0 || media.url !== void 0) {
+				found = media;
+				break;
+			}
+		}
+		if (found === void 0) throw kernelError(`消息 ${id} 不包含${label}`, "NOT_FOUND");
+		const result = {};
+		if (found.path !== void 0) result.file = found.path;
+		if (found.url !== void 0) result.url = found.url;
+		return result;
+	}
+};
+/** 获取语音信息（P2-14）。 */
+var GetRecordAction = class extends BaseAction {
+	name = "get_record";
+	schema = getMediaSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		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");
+		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");
+		for (const el of first.elements) {
+			const ptt = el.pttElement;
+			if (ptt !== void 0 && ptt.filePath !== void 0) return { file: ptt.filePath };
+		}
+		throw kernelError(`消息 ${id} 不包含语音`, "NOT_FOUND");
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/get-msg.ts
+/**
+* get_msg 动作：获取消息详情（P2-10 接 kernel MsgApi.fetchMsgsByMsgId）
+*
+* message_id → msgId + peer（MessageUnique 反查）→ 拉消息 → OB11 消息信息结构。
+*/
+const getMsgSchema = z.object({ message_id: z.union([z.number(), z.string()]) });
+/** 获取消息详情（P2-10 接 kernel fetchMsgsByMsgId）。 */
+var GetMsgAction = class extends BaseAction {
+	name = "get_msg";
+	schema = getMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		const [msg] = await this.deps.msgApi.fetchMsgsByMsgId(peer, [msgId]);
+		if (msg === void 0) throw kernelError(`消息 ${payload.message_id} 不存在或已被撤回`, "NOT_FOUND");
+		const { atUids } = collectReceiveNeeds(toCanonicalElements(msg));
+		let uidToUin;
+		if (atUids.length > 0) try {
+			uidToUin = await this.deps.uidToUin(atUids);
+		} catch {}
+		const ctx = {
+			...uidToUin !== void 0 ? { uidToUin } : {},
+			msgIdToOb11Id: (m) => this.deps.messageUnique.getMessageId(m)
+		};
+		return toOb11MessageInfo(msg, this.deps.messageUnique, ctx);
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/mark-msg-as-read.ts
+/**
+* mark_msg_as_read 动作：标记消息已读（P2-10 接 kernel MsgApi.markRead）
+*
+* OB11 标准 mark_msg_as_read 以 user_id 为参数；NapCat 扩展同时支持 group_id
+* （mark_private_msg_as_read / mark_group_msg_as_read 由 adapter 层同名动作或
+* 语义别名处理）。user_id → C2C peer；group_id → GROUP peer。
+*/
+const markMsgAsReadSchema = z.object({
+	user_id: z.number().optional(),
+	group_id: z.number().optional()
+}).refine((v) => v.user_id !== void 0 || v.group_id !== void 0, { message: "mark_msg_as_read 需要 user_id 或 group_id" });
+/** 标记消息已读（P2-10 接 kernel markRead）。 */
+var MarkMsgAsReadAction = class extends BaseAction {
+	name = "mark_msg_as_read";
+	schema = markMsgAsReadSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		if (payload.group_id !== void 0) {
+			await this.deps.msgApi.markRead({
+				chatType: ChatType.GROUP,
+				peerUid: String(payload.group_id)
+			});
+			return null;
+		}
+		if (payload.user_id !== void 0) {
+			const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+			if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+			await this.deps.msgApi.markRead({
+				chatType: ChatType.C2C,
+				peerUid: uid
+			});
+		}
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/mark-msg-as-read-aliases.ts
+/**
+* mark_private_msg_as_read / mark_group_msg_as_read 动作：标记会话已读（P2-13）
+*
+* mark_msg_as_read 的细分别名（NapCat 扩展）：
+* - mark_private_msg_as_read：user_id → C2C markRead
+* - mark_group_msg_as_read：group_id → GROUP markRead
+*/
+const markPrivateMsgAsReadSchema = z.object({ user_id: z.number() });
+const markGroupMsgAsReadSchema = z.object({ group_id: z.number() });
+/** 标记私聊已读（P2-13）。 */
+var MarkPrivateMsgAsReadAction = class extends BaseAction {
+	name = "mark_private_msg_as_read";
+	schema = markPrivateMsgAsReadSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		await this.deps.msgApi.markRead({
+			chatType: ChatType.C2C,
+			peerUid: uid
+		});
+		return null;
+	}
+};
+/** 标记群聊已读（P2-13）。 */
+var MarkGroupMsgAsReadAction = class extends BaseAction {
+	name = "mark_group_msg_as_read";
+	schema = markGroupMsgAsReadSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		await this.deps.msgApi.markRead({
+			chatType: ChatType.GROUP,
+			peerUid: String(payload.group_id)
+		});
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/send-forward-msg.ts
+/**
+* send_group_forward_msg / send_private_forward_msg 动作：发送合并转发（P2-12）
+*
+* messages 每项为 node 元素 `{ type: "node", data: { id } }`——id 是此前
+* send_msg 返回的 OB11 message_id。经 MessageUnique 反查源 msgId + peer，
+* 组装到目标 peer（群直通 / 私聊 uinToUid）→ MsgApi.sendForwardMessage。
+*/
+const forwardNodeSchema = z.object({
+	type: z.literal("node").optional(),
+	data: z.object({ id: z.union([z.number(), z.string()]) }).optional()
+});
+const sendGroupForwardMsgSchema = z.object({
+	group_id: z.number(),
+	messages: z.array(z.unknown()).default([])
+});
+const sendPrivateForwardMsgSchema = z.object({
+	user_id: z.number(),
+	messages: z.array(z.unknown()).default([])
+});
+/** 解析 node 元素列表 → 源消息 (msgId, peer) 列表（id 反查，跳过无法解析的项）。 */
+function resolveSourceMessages(messages, unique) {
+	const out = [];
+	for (const raw of messages) {
+		const parsed = forwardNodeSchema.safeParse(raw);
+		if (parsed.success) {
+			const id = parsed.data.data?.id;
+			if (id !== void 0) {
+				const msgId = unique.getMsgId(Number(id));
+				if (msgId !== void 0) {
+					const peer = unique.getPeer(msgId);
+					if (peer !== void 0) out.push({
+						msgId,
+						peer
+					});
+				}
+			}
+		}
+	}
+	return out;
+}
+/** 发送群合并转发（P2-12 接 kernel sendForwardMessage）。 */
+var SendGroupForwardMsgAction = class extends BaseAction {
+	name = "send_group_forward_msg";
+	schema = sendGroupForwardMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const sources = resolveSourceMessages(payload.messages, this.deps.messageUnique);
+		const [firstSource] = sources;
+		if (firstSource === void 0) throw kernelError("合并转发需要至少一条可解析的源消息（node.id）", "INVALID_PARAM");
+		const target = {
+			chatType: ChatType.GROUP,
+			peerUid: String(payload.group_id)
+		};
+		const { msgId } = await this.deps.msgApi.sendForwardMessage(target, firstSource.peer, sources.map((s) => s.msgId));
+		return { message_id: this.deps.messageUnique.alloc(msgId, target) };
+	}
+};
+/** 发送私聊合并转发（P2-12）。 */
+var SendPrivateForwardMsgAction = class extends BaseAction {
+	name = "send_private_forward_msg";
+	schema = sendPrivateForwardMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const sources = resolveSourceMessages(payload.messages, this.deps.messageUnique);
+		const [firstSource] = sources;
+		if (firstSource === void 0) throw kernelError("合并转发需要至少一条可解析的源消息（node.id）", "INVALID_PARAM");
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		const target = {
+			chatType: ChatType.C2C,
+			peerUid: uid
+		};
+		const { msgId } = await this.deps.msgApi.sendForwardMessage(target, firstSource.peer, sources.map((s) => s.msgId));
+		return { message_id: this.deps.messageUnique.alloc(msgId, target) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/send-msg.ts
+/**
+* send_msg 动作：发送消息（群聊/私聊）+ 共享发送核心 sendOb11Message
+*
+* P2-3 真实化：注入 kernel MsgApi，message 参数（CQ 码字符串或 segment 数组）
+* 翻译为 canonical 元素 → MsgApi.sendMessage → 返回真实 message_id。
+* send_private_msg / send_group_msg 复用 sendOb11Message（P2-10）。
+*
+* 群聊：group_id → Peer{ chatType: GROUP, peerUid: String(group_id) }（群消息 peerUid=群号）。
+* 私聊：user_id 经 uin→uid → Peer{ chatType: C2C, peerUid: uid }。
+*/
+const sendMsgSchema = z.object({
+	message_type: z.enum(["group", "private"]).optional(),
+	user_id: z.number().optional(),
+	group_id: z.number().optional(),
+	message: z.union([z.string(), z.array(z.unknown())]),
+	auto_escape: z.boolean().optional()
+});
+/** 解析目标 Peer（group_id 直通；user_id 经 uin→uid）。 */
+async function resolvePeer(payload, deps) {
+	if (payload.group_id !== void 0) return {
+		chatType: ChatType.GROUP,
+		peerUid: String(payload.group_id)
+	};
+	if (payload.user_id !== void 0) {
+		const uid = (await deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		return {
+			chatType: ChatType.C2C,
+			peerUid: uid
+		};
+	}
+	throw kernelError("send_msg 需要 group_id 或 user_id", "INVALID_PARAM");
+}
+/** 共享发送核心：解析 Peer → canonical 翻译（含 auto_escape）→ sendMessage → 映射 message_id。 */
+async function sendOb11Message(payload, deps) {
+	const peer = await resolvePeer(payload, deps);
+	let canonical;
+	if (Array.isArray(payload.message)) canonical = segmentsToCanonical(payload.message);
+	else canonical = cqMessageToCanonical(payload.message);
+	const atUins = [];
+	for (const el of canonical) if (el.type === "at" && el.target !== "all") atUins.push(el.target);
+	let uinToUid;
+	if (atUins.length > 0) try {
+		uinToUid = await deps.uinToUid(atUins);
+	} catch {}
+	canonical = applySendContext(canonical, {
+		...uinToUid !== void 0 ? { uinToUid } : {},
+		ob11IdToMsgId: (id) => deps.messageUnique.getMsgId(id)
+	});
+	if (payload.auto_escape === true) canonical = canonical.map((el) => {
+		if (el.type === "text") return {
+			...el,
+			text: escapeText(el.text)
+		};
+		return el;
+	});
+	const { msgId } = await deps.msgApi.sendMessage(peer, canonical);
+	return { message_id: deps.messageUnique.alloc(msgId, peer) };
+}
+/** 发送消息（P2-3 接 kernel apis/msg，返回真实 message_id）。 */
+var SendMsgAction = class extends BaseAction {
+	name = "send_msg";
+	schema = sendMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(payload) {
+		return sendOb11Message(payload, this.deps);
+	}
+};
+/** CQ 特殊字符转义（auto_escape，&、[、]、, 前置 &amp;）。 */
+function escapeText(text) {
+	return text.replaceAll("&", "&amp;").replaceAll("[", "&#91;").replaceAll("]", "&#93;").replaceAll(",", "&#44;");
+}
+//#endregion
+//#region src/onebot11/action/message/send-group-msg.ts
+/**
+* send_group_msg 动作：发送群聊消息（复用 sendOb11Message 核心）
+*/
+const sendGroupMsgSchema = z.object({
+	group_id: z.number(),
+	message: z.union([z.string(), z.array(z.unknown())]),
+	auto_escape: z.boolean().optional()
+});
+/** 发送群聊消息（P2-10 复用 sendOb11Message）。 */
+var SendGroupMsgAction = class extends BaseAction {
+	name = "send_group_msg";
+	schema = sendGroupMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(payload) {
+		return sendOb11Message(payload, this.deps);
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/send-private-msg.ts
+/**
+* send_private_msg 动作：发送私聊消息（复用 sendOb11Message 核心）
+*/
+const sendPrivateMsgSchema = z.object({
+	user_id: z.number(),
+	message: z.union([z.string(), z.array(z.unknown())]),
+	auto_escape: z.boolean().optional()
+});
+/** 发送私聊消息（P2-10 复用 sendOb11Message）。 */
+var SendPrivateMsgAction = class extends BaseAction {
+	name = "send_private_msg";
+	schema = sendPrivateMsgSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(payload) {
+		return sendOb11Message(payload, this.deps);
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/set-input-status.ts
+/**
+* set_input_status 动作：发送输入状态（NapCat 扩展，P2-11）
+*
+* user_id → uinToUid → MsgApi.setInputStatus(peer, eventType)。
+* eventType：1=输入中，0=停止输入。
+*/
+const setInputStatusSchema = z.object({
+	user_id: z.number(),
+	/** 输入事件类型：1=输入中，0=停止。 */
+	event_type: z.number().optional()
+});
+/** 输入中事件类型。 */
+const EVENT_TYPE_TYPING = 1;
+/** 发送输入状态（P2-11 接 kernel setInputStatus）。 */
+var SetInputStatusAction = class extends BaseAction {
+	name = "set_input_status";
+	schema = setInputStatusSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const uid = (await this.deps.uinToUid([String(payload.user_id)])).get(String(payload.user_id));
+		if (uid === void 0) throw kernelError(`用户 ${payload.user_id} 的 uid 解析失败`, "INVALID_PARAM");
+		await this.deps.msgApi.setInputStatus({
+			chatType: ChatType.C2C,
+			peerUid: uid
+		}, payload.event_type ?? EVENT_TYPE_TYPING);
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/message/set-msg-emoji-like.ts
+/**
+* set_msg_emoji_like 动作：消息表情表态（NapCat 扩展，P2-10）
+*
+* message_id → msgId + peer → 拉消息取 msgSeq → MsgApi.setMsgEmojiLike。
+*/
+const setMsgEmojiLikeSchema = z.object({
+	message_id: z.union([z.number(), z.string()]),
+	/** 表情 ID（如 105 点赞）。 */
+	emoji_id: z.number(),
+	/** 表情类型（默认 1）。 */
+	emoji_type: z.number().optional(),
+	/** 是否点赞（false 取消）。 */
+	like: z.boolean().optional()
+});
+/** 消息表情表态（P2-10 接 kernel setMsgEmojiLike）。 */
+var SetMsgEmojiLikeAction = class extends BaseAction {
+	name = "set_msg_emoji_like";
+	schema = setMsgEmojiLikeSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { msgId, peer } = resolveMsgIdAndPeer(payload.message_id, this.deps.messageUnique);
+		const [msg] = await this.deps.msgApi.fetchMsgsByMsgId(peer, [msgId]);
+		if (msg === void 0) throw kernelError(`消息 ${payload.message_id} 不存在或已被撤回`, "NOT_FOUND");
+		await this.deps.msgApi.setMsgEmojiLike(peer, {
+			msgSeq: msg.msgSeq,
+			emojiId: String(payload.emoji_id),
+			emojiType: String(payload.emoji_type ?? 1),
+			like: payload.like ?? true
+		});
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/can-send-image.ts
+/**
+* can_send_image 动作：是否可以发送图片（本地 true，P2-11）
+*/
+const canSendImageSchema = z.object({});
+/** 是否可以发送图片（本地 true，P2-11）。 */
+var CanSendImageAction = class extends BaseAction {
+	name = "can_send_image";
+	schema = canSendImageSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	_handle(_payload) {
+		return Promise.resolve({ yes: true });
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/can-send-record.ts
+/**
+* can_send_record 动作：是否可以发送语音（本地 true，P2-11）
+*/
+const canSendRecordSchema = z.object({});
+/** 是否可以发送语音（本地 true，P2-11）。 */
+var CanSendRecordAction = class extends BaseAction {
+	name = "can_send_record";
+	schema = canSendRecordSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	_handle(_payload) {
+		return Promise.resolve({ yes: true });
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/clean-cache.ts
+/**
+* clean_cache 动作：清理缓存（本地组装，P2-11）
+*
+* cleanCache 回调由装配方注入（boot.cjs 接 kernel PathWrapper.clearCache）。
+* 未配置时明确报错（不静默）。
+*/
+const cleanCacheSchema = z.object({});
+/** 清理缓存（P2-11）。 */
+var CleanCacheAction = class extends BaseAction {
+	name = "clean_cache";
+	schema = cleanCacheSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(_payload) {
+		if (this.deps.cleanCache === void 0) throw kernelError("clean_cache 未配置（装配方未注入清理回调）", "INVALID_STATE");
+		await this.deps.cleanCache();
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/download-file.ts
+/**
+* download_file 动作：下载文件到缓存目录（P2-12）
+*
+* url → fetch 下载 → 存 deps.system.cacheDir（缺省抛错）→ 返回 { file }。
+* 文件名：download-<timestamp>-<basename>（headers 等扩展字段忽略）。
+*/
+const downloadFileSchema = z.object({
+	url: z.string(),
+	thread_count: z.number().optional(),
+	headers: z.record(z.string(), z.string()).optional()
+});
+/** 下载文件到缓存目录（P2-12）。 */
+var DownloadFileAction = class extends BaseAction {
+	name = "download_file";
+	schema = downloadFileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const { cacheDir } = this.deps;
+		if (cacheDir === void 0 || cacheDir === "") throw kernelError("download_file 未配置缓存目录（装配方未注入）", "INVALID_STATE");
+		const safeName = basename(new URL(payload.url).pathname) || "download.bin";
+		const filePath = join(cacheDir, `download-${Date.now()}-${safeName}`);
+		mkdirSync(cacheDir, { recursive: true });
+		const init = {};
+		if (payload.headers !== void 0) init.headers = payload.headers;
+		const res = await fetch(payload.url, init);
+		if (!res.ok) throw new Error(`下载失败: ${res.status} ${res.statusText}`);
+		const buf = new Uint8Array(await res.arrayBuffer());
+		writeFileSync(filePath, buf);
+		return { file: filePath };
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-clientkey.ts
+const getClientkeySchema = z.object({});
+/** 获取 clientKey（P2-13 接 kernel TicketApi）。 */
+var GetClientkeyAction = class extends BaseAction {
+	name = "get_clientkey";
+	schema = getClientkeySchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	ticketApi;
+	constructor(ticketApi) {
+		super();
+		this.ticketApi = ticketApi;
+	}
+	async _handle(_payload) {
+		const raw = await this.ticketApi.getClientKey();
+		return {
+			clientKey: raw.clientKey,
+			keyIndex: raw.keyIndex,
+			expireTime: raw.expireTime,
+			url: raw.url
+		};
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-cookies.ts
+/**
+* get_cookies 动作：获取 cookies（P2-13 接 kernel TicketApi.getCookies）
+*
+* domain 缺省 v2.qq.com（NapCat 行为）；user_id 缺省用机器人自身 uin。
+*/
+const getCookiesSchema = z.object({
+	domain: z.string().optional(),
+	user_id: z.number().optional()
+});
+/** 默认域名。 */
+const DEFAULT_DOMAIN$1 = "v2.qq.com";
+/** 获取 cookies（P2-13 接 kernel TicketApi.getCookies）。 */
+var GetCookiesAction = class extends BaseAction {
+	name = "get_cookies";
+	schema = getCookiesSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(payload) {
+		const domain = payload.domain ?? DEFAULT_DOMAIN$1;
+		let uin = this.deps.selfUin;
+		if (payload.user_id !== void 0) uin = String(payload.user_id);
+		return this.deps.ticketApi.getCookies(domain, uin);
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-credentials.ts
+/**
+* get_csrf_token / get_credentials 动作（P2-15 接 kernel TicketApi）
+*
+* - get_csrf_token：qun.qq.com cookies 的 skey → bkn（csrf 等价物）
+* - get_credentials：指定域名 cookies + bkn → { cookies, csrf_token }
+*/
+const getCsrfTokenSchema = z.object({});
+/** 默认域名（bkn 计算用）。 */
+const DEFAULT_DOMAIN = "qun.qq.com";
+/** 获取 csrf_token（bkn，P2-15）。 */
+var GetCsrfTokenAction = class extends BaseAction {
+	name = "get_csrf_token";
+	schema = getCsrfTokenSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(_payload) {
+		const skey = (await this.deps.ticketApi.getCookies(DEFAULT_DOMAIN, this.deps.selfUin))["skey"] ?? "";
+		return { token: Number(TicketApi.getBkn(skey)) };
+	}
+};
+const getCredentialsSchema = z.object({ domain: z.string().optional() });
+/** 获取凭据（cookies + csrf_token，P2-15）。 */
+var GetCredentialsAction = class extends BaseAction {
+	name = "get_credentials";
+	schema = getCredentialsSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		const domain = payload.domain ?? DEFAULT_DOMAIN;
+		const cookies = await this.deps.ticketApi.getCookies(domain, this.deps.selfUin);
+		return {
+			cookies,
+			csrf_token: Number(TicketApi.getBkn(cookies["skey"] ?? ""))
+		};
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-login-info.ts
+/**
+* get_login_info 动作：获取登录信息（P2-4 注入 self）
+*/
+const getLoginInfoSchema = z.object({});
+/** 获取登录信息（self 由装配方注入，P2-5 接 kernel selfInfo 维护后取真实昵称）。 */
+var GetLoginInfoAction = class extends BaseAction {
+	name = "get_login_info";
+	schema = getLoginInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	self;
+	constructor(self) {
+		super();
+		this.self = self;
+	}
+	_handle(_payload) {
+		return Promise.resolve({
+			user_id: Number(this.self.uin),
+			nickname: this.self.nickname
+		});
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-robot-uin-range.ts
+/**
+* get_robot_uin_range 动作：获取机器人 QQ 号范围（本地组装，P2-11）
+*
+* NapCat 从配置返回；我们给通用范围（min/max）。
+*/
+const getRobotUinRangeSchema = z.object({});
+/** QQ 号下限。 */
+const UIN_MIN = 10001;
+/** QQ 号上限。 */
+const UIN_MAX = 4294967295;
+/** 获取机器人 QQ 号范围（P2-11 本地组装）。 */
+var GetRobotUinRangeAction = class extends BaseAction {
+	name = "get_robot_uin_range";
+	schema = getRobotUinRangeSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	_handle(_payload) {
+		return Promise.resolve({
+			min: UIN_MIN,
+			max: UIN_MAX
+		});
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-status.ts
+/**
+* get_status 动作：获取运行状态（本地组装，P2-11）
+*
+* 返回与心跳 status 同构的 OB11Status（online/good + 扩展字段）。
+*/
+const getStatusSchema = z.object({});
+/** 获取运行状态（本地组装，P2-11）。 */
+var GetStatusAction = class extends BaseAction {
+	name = "get_status";
+	schema = getStatusSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	_handle(_payload) {
+		return Promise.resolve({
+			online: true,
+			good: true
+		});
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/get-version-info.ts
+/**
+* get_version_info 动作：获取版本信息（本地组装，P2-11）
+*
+* appVersion 由装配方注入（kernel wrapper 版本或 NAPUTO_QQ_VERSION）。
+*/
+const getVersionInfoSchema = z.object({});
+/** 获取版本信息（本地组装，P2-11）。 */
+var GetVersionInfoAction = class extends BaseAction {
+	name = "get_version_info";
+	schema = getVersionInfoSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	_handle(_payload) {
+		return Promise.resolve({
+			app_name: "napuketto-qq",
+			app_version: this.deps.appVersion,
+			protocol_version: "v11"
+		});
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/process-control.ts
+/**
+* bot_exit / set_restart 动作：退出 / 重启（P2-12）
+*
+* exit/restart 回调由装配方注入（boot.cjs 接进程控制）。未配置时明确报错。
+*/
+const botExitSchema = z.object({});
+/** 退出机器人进程（P2-12）。 */
+var BotExitAction = class extends BaseAction {
+	name = "bot_exit";
+	schema = botExitSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(_payload) {
+		if (this.deps.exit === void 0) throw kernelError("bot_exit 未配置（装配方未注入退出回调）", "INVALID_STATE");
+		await this.deps.exit();
+		return null;
+	}
+};
+/** 重启机器人（P2-12；重启交给装配方，缺省退化为退出）。 */
+var SetRestartAction = class extends BaseAction {
+	name = "set_restart";
+	schema = botExitSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(_payload) {
+		const restart = this.deps.restart ?? this.deps.exit;
+		if (restart === void 0) throw kernelError("set_restart 未配置（装配方未注入重启回调）", "INVALID_STATE");
+		await restart();
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/profile-actions.ts
+/** 资料类动作（P2-14）：set_self_longnick / set_qq_profile / set_qq_avatar
+*/
+/** URL 前缀（头像在线文件识别）。 */
+const URL_PREFIX = /^https?:\/\//;
+const setSelfLongnickSchema = z.object({ longNick: z.string() });
+/** 设置个性签名（P2-14 接 kernel ProfileApi.setLongNick）。 */
+var SetSelfLongnickAction = class extends BaseAction {
+	name = "set_self_longnick";
+	schema = setSelfLongnickSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	profileApi;
+	constructor(profileApi) {
+		super();
+		this.profileApi = profileApi;
+	}
+	async _handle(payload) {
+		await this.profileApi.setLongNick(payload.longNick);
+		return null;
+	}
+};
+const setQQProfileSchema = z.object({
+	nickname: z.string(),
+	personal_note: z.string().optional(),
+	sex: z.union([z.number(), z.string()]).optional()
+});
+/** 设置 QQ 资料（P2-14；nickname → setNickName，personal_note → setLongNick，sex 忽略）。 */
+var SetQQProfileAction = class extends BaseAction {
+	name = "set_qq_profile";
+	schema = setQQProfileSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	profileApi;
+	constructor(profileApi) {
+		super();
+		this.profileApi = profileApi;
+	}
+	async _handle(payload) {
+		await this.profileApi.setNickName(payload.nickname);
+		if (payload.personal_note !== void 0) await this.profileApi.setLongNick(payload.personal_note);
+		return null;
+	}
+};
+const setQQAvatarSchema = z.object({ 
+/** 本地路径（URL 需先下载，由装配方 cacheDir 支持）。 */
+file: z.string() });
+/** 设置 QQ 头像（P2-14 接 kernel ProfileApi.setHeader）。 */
+var SetQQAvatarAction = class extends BaseAction {
+	name = "set_qq_avatar";
+	schema = setQQAvatarSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	deps;
+	constructor(deps) {
+		super();
+		this.deps = deps;
+	}
+	async _handle(payload) {
+		let filePath = payload.file;
+		if (URL_PREFIX.test(filePath)) filePath = await this.downloadToCache(filePath);
+		if (!existsSync(filePath)) throw kernelError(`头像文件不存在: ${filePath}`, "NOT_FOUND");
+		await this.deps.profileApi.setHeader(filePath);
+		return null;
+	}
+	/** URL 下载到缓存目录（cacheDir 缺省抛错）。 */
+	async downloadToCache(url) {
+		const { cacheDir } = this.deps;
+		if (cacheDir === void 0 || cacheDir === "") throw kernelError("set_qq_avatar 处理 URL 需要缓存目录（装配方未注入）", "INVALID_STATE");
+		const safeName = basename(new URL(url).pathname) || "avatar.bin";
+		const filePath = join(cacheDir, `avatar-${Date.now()}-${safeName}`);
+		const res = await fetch(url);
+		if (!res.ok) throw new Error(`头像下载失败: ${res.status} ${res.statusText}`);
+		const buf = new Uint8Array(await res.arrayBuffer());
+		writeFileSync(filePath, buf);
+		return filePath;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/set-diy-online-status.ts
+const setDiyOnlineStatusSchema = z.object({
+	status: z.number().optional(),
+	/** 自定义状态文案。 */
+	wording: z.string(),
+	/** 表情 ID。 */
+	face_id: z.string().optional(),
+	/** 表情类型。 */
+	face_type: z.string().optional()
+});
+/** 默认在线状态值。 */
+const STATUS_ONLINE$1 = 10;
+/** 设置自定义在线状态（P2-12 接 kernel setOnlineStatus customStatus）。 */
+var SetDiyOnlineStatusAction = class extends BaseAction {
+	name = "set_diy_online_status";
+	schema = setDiyOnlineStatusSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	msgApi;
+	constructor(msgApi) {
+		super();
+		this.msgApi = msgApi;
+	}
+	async _handle(payload) {
+		const customStatus = {
+			faceId: payload.face_id ?? "",
+			wording: payload.wording,
+			faceType: payload.face_type ?? "1"
+		};
+		await this.msgApi.setOnlineStatus({
+			status: payload.status ?? STATUS_ONLINE$1,
+			extStatus: 0,
+			batteryStatus: 0,
+			customStatus
+		});
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/set-online-status.ts
+const setOnlineStatusSchema = z.object({
+	status: z.number().optional(),
+	ext_status: z.number().optional(),
+	battery_status: z.number().optional()
+});
+/** 默认在线状态值。 */
+const STATUS_ONLINE = 10;
+/** 设置在线状态（P2-12 接 kernel setOnlineStatus）。 */
+var SetOnlineStatusAction = class extends BaseAction {
+	name = "set_online_status";
+	schema = setOnlineStatusSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	msgApi;
+	constructor(msgApi) {
+		super();
+		this.msgApi = msgApi;
+	}
+	async _handle(payload) {
+		await this.msgApi.setOnlineStatus({
+			status: payload.status ?? STATUS_ONLINE,
+			extStatus: payload.ext_status ?? 0,
+			batteryStatus: payload.battery_status ?? 0
+		});
+		return null;
+	}
+};
+//#endregion
+//#region src/onebot11/action/system/translate-en2zh.ts
+const translateEn2ZhSchema = z.object({ words: z.array(z.string()) });
+/** 英文单词翻译（P2-14）。 */
+var TranslateEn2ZhAction = class extends BaseAction {
+	name = "translate_en2zh";
+	schema = translateEn2ZhSchema;
+	errorCodeMap = ob11ErrorCodeMap;
+	richMediaApi;
+	constructor(richMediaApi) {
+		super();
+		this.richMediaApi = richMediaApi;
+	}
+	async _handle(payload) {
+		return { words: await this.richMediaApi.translateWords(payload.words) };
+	}
+};
+//#endregion
+//#region src/onebot11/action/index.ts
+/**
+* OneBot 11 动作注册表（ADR-013 延伸）
+* 各协议维护自己的 ActionRegistry，由协议 adapter 挂到请求分发。
+* P2-16：deps 收敛为 { api: OneBotApi } 单聚合对象（基础设施第一项）。
+*/
+/** 构建 OB11 动作注册表（所有 OB11 动作在此注册，按组拆分控制行数）。 */
+function createOb11ActionRegistry(deps) {
+	const registry = new ActionRegistry();
+	registerMsgActions(registry, deps);
+	registerForwardActions(registry, deps);
+	registerQueryActions(registry, deps);
+	registerGroupActions(registry, deps);
+	registerFriendActions(registry, deps);
+	registerSystemActions(registry, deps);
+	registerGroupNotifyActions(registry, deps);
+	registerTicketActions(registry, deps);
+	registerProfileActions(registry, deps);
+	registerGroupFileActions(registry, deps);
+	registerWebActions(registry, deps);
+	return registry;
+}
+/** 群空间 web / csrf / 陌生人 / 群请求动作（P2-15）。 */
+function registerWebActions(registry, deps) {
+	registry.register(new GetStrangerInfoAction(deps.api.profileApi));
+	registry.register(new GetCsrfTokenAction(deps.api));
+	registry.register(new GetCredentialsAction(deps.api));
+	registry.register(new GetGroupAddRequestAction(deps.api.groupNotifyApi));
+	registry.register(new GetGroupIgnoredNotifiesAction(deps.api.groupNotifyApi));
+	registry.register(new GetEssenceMsgListAction(deps.api.webApi));
+	registry.register(new GetGroupHonorInfoAction(deps.api.webApi));
+}
+/** 资料/点赞/翻译动作（P2-14）。 */
+function registerProfileActions(registry, deps) {
+	registry.register(new SetSelfLongnickAction(deps.api.profileApi));
+	registry.register(new SetQQProfileAction(deps.api.profileApi));
+	registry.register(new SetQQAvatarAction(deps.api));
+	registry.register(new TranslateEn2ZhAction(deps.api.richMediaApi));
+	registry.register(new SendLikeAction(deps.api));
+}
+/** 群文件动作（P2-14）。 */
+function registerGroupFileActions(registry, deps) {
+	registry.register(new GetGroupRootFilesAction(deps.api.richMediaApi));
+	registry.register(new GetGroupFilesByFolderAction(deps.api.richMediaApi));
+	registry.register(new GetGroupFileSystemInfoAction(deps.api.richMediaApi));
+	registry.register(new CreateGroupFileFolderAction(deps.api.richMediaApi));
+	registry.register(new DeleteGroupFileAction(deps.api.richMediaApi));
+	registry.register(new DeleteGroupFolderAction(deps.api.richMediaApi));
+	registry.register(new RenameGroupFileAction(deps.api.richMediaApi));
+	registry.register(new MoveGroupFileAction(deps.api.richMediaApi));
+	registry.register(new TransGroupFileAction(deps.api.richMediaApi));
+}
+/** 群通知/禁言列表动作（P2-13）。 */
+function registerGroupNotifyActions(registry, deps) {
+	registry.register(new SetGroupAddRequestAction(deps.api.groupNotifyApi));
+	registry.register(new GetGroupSystemMsgAction(deps.api));
+	registry.register(new GetGroupShutListAction(deps.api));
+}
+/** 票据动作（P2-13）。 */
+function registerTicketActions(registry, deps) {
+	registry.register(new GetClientkeyAction(deps.api.ticketApi));
+	registry.register(new GetCookiesAction(deps.api));
+}
+/** 合并转发 / 单条转发 / 在线状态（P2-12）。 */
+function registerForwardActions(registry, deps) {
+	registry.register(new SendGroupForwardMsgAction(deps.api));
+	registry.register(new SendPrivateForwardMsgAction(deps.api));
+	registry.register(new GetForwardMsgAction(deps.api));
+	registry.register(new ForwardGroupSingleMsgAction(deps.api));
+	registry.register(new ForwardFriendSingleMsgAction(deps.api));
+	registry.register(new SetOnlineStatusAction(deps.api.msgApi));
+	registry.register(new SetDiyOnlineStatusAction(deps.api.msgApi));
+}
+/** 消息类动作（P2-3 / P2-10 / P2-11）。 */
+function registerMsgActions(registry, deps) {
+	registry.register(new SendMsgAction(deps.api));
+	registry.register(new SendPrivateMsgAction(deps.api));
+	registry.register(new SendGroupMsgAction(deps.api));
+	registry.register(new DeleteMsgAction(deps.api));
+	registry.register(new GetMsgAction(deps.api));
+	registry.register(new GetGroupMsgHistoryAction(deps.api));
+	registry.register(new GetFriendMsgHistoryAction(deps.api));
+	registry.register(new MarkMsgAsReadAction(deps.api));
+	registry.register(new MarkPrivateMsgAsReadAction(deps.api));
+	registry.register(new MarkGroupMsgAsReadAction(deps.api));
+	registry.register(new SetMsgEmojiLikeAction(deps.api));
+	registry.register(new FetchPttTextAction(deps.api));
+	registry.register(new SetInputStatusAction(deps.api));
+	registry.register(new GetImageAction(deps.api));
+	registry.register(new GetRecordAction(deps.api));
+}
+/** 查询类动作（P2-4；P2-17 群信息/成员动作读 GroupCache）。 */
+function registerQueryActions(registry, deps) {
+	registry.register(new GetLoginInfoAction(deps.api.self));
+	registry.register(new GetGroupInfoAction(deps.api));
+	registry.register(new GetGroupListAction(deps.api.groupApi));
+	registry.register(new GetGroupMemberInfoAction(deps.api));
+	registry.register(new GetGroupMemberListAction(deps.api));
+	registry.register(new GetFriendListAction(deps.api.friendApi));
+}
+/** 群管类动作（P2-10）。 */
+function registerGroupActions(registry, deps) {
+	registry.register(new SetGroupKickAction(deps.api.groupApi));
+	registry.register(new SetGroupBanAction(deps.api.groupApi));
+	registry.register(new SetGroupWholeBanAction(deps.api.groupApi));
+	registry.register(new SetGroupAdminAction(deps.api.groupApi));
+	registry.register(new SetGroupCardAction(deps.api.groupApi));
+	registry.register(new SetGroupNameAction(deps.api.groupApi));
+	registry.register(new SetGroupLeaveAction(deps.api.groupApi));
+	registry.register(new SetEssenceMsgAction(deps.api));
+	registry.register(new DeleteEssenceMsgAction(deps.api));
+	registry.register(new GetGroupAtAllRemainAction(deps.api.groupApi));
+}
+/** 好友类动作（P2-11）。 */
+function registerFriendActions(registry, deps) {
+	registry.register(new SetFriendAddRequestAction(deps.api.friendApi));
+	registry.register(new SetFriendRemarkAction(deps.api));
+	registry.register(new DeleteFriendAction(deps.api));
+	registry.register(new GetFriendsWithCategoryAction(deps.api.friendApi));
+	registry.register(new GetDoubtFriendsAddRequestAction(deps.api.friendApi));
+	registry.register(new SetDoubtFriendsAddRequestAction(deps.api.friendApi));
+}
+/** 系统类动作（P2-11 / P2-12）。 */
+function registerSystemActions(registry, deps) {
+	registry.register(new GetStatusAction());
+	registry.register(new GetVersionInfoAction(deps.api));
+	registry.register(new CleanCacheAction(deps.api));
+	registry.register(new CanSendImageAction());
+	registry.register(new CanSendRecordAction());
+	registry.register(new GetRobotUinRangeAction());
+	registry.register(new DownloadFileAction(deps.api));
+	registry.register(new BotExitAction(deps.api));
+	registry.register(new SetRestartAction(deps.api));
+}
+//#endregion
+//#region src/onebot11/api/one-bot-api.ts
+/**
+* OneBot 11 动作统一依赖聚合（P2-16）。
+* 各动作经 `Pick<OneBotApi, ...>` 取所需成员；注册处只构造一次本对象。
+*/
+var OneBotApi = class {
+	/** kernel 消息 API（send_msg 等消息类动作用）。 */
+	msgApi;
+	/** kernel 群 API。 */
+	groupApi;
+	/** kernel 群通知 API（群请求/禁言列表用）。 */
+	groupNotifyApi;
+	/** kernel 好友 API。 */
+	friendApi;
+	/** kernel 票据 API（get_clientkey/get_cookies 用）。 */
+	ticketApi;
+	/** kernel 富媒体 API（群文件/翻译用）。 */
+	richMediaApi;
+	/** kernel 资料 API（签名/昵称/头像用）。 */
+	profileApi;
+	/** kernel 点赞 API（send_like 用）。 */
+	profileLikeApi;
+	/** kernel 群空间 web API（精华/荣誉用）。 */
+	webApi;
+	/** 群/成员缓存（ADR-008；翻译层只读消费，缺失惰性回填）。 */
+	groupCache;
+	/** OB11 message_id ↔ NT msgId 双向映射（收链路与动作共用同一映射空间）。 */
+	messageUnique;
+	/** 登录身份（get_login_info 用）。 */
+	self;
+	/** 机器人自身 uin（get_cookies / csrf 用）。 */
+	selfUin;
+	/** 运行版本（get_version_info 用）。 */
+	appVersion;
+	/** 缓存清理回调（clean_cache 用）。 */
+	cleanCache;
+	/** 缓存目录（download_file 用）。 */
+	cacheDir;
+	/** 进程退出回调（bot_exit 用）。 */
+	exit;
+	/** 进程重启回调（set_restart 用）。 */
+	restart;
+	constructor(opts) {
+		this.msgApi = opts.msgApi;
+		this.groupApi = opts.groupApi;
+		this.groupNotifyApi = opts.groupNotifyApi;
+		this.friendApi = opts.friendApi;
+		this.ticketApi = opts.ticketApi;
+		this.richMediaApi = opts.richMediaApi;
+		this.profileApi = opts.profileApi;
+		this.profileLikeApi = opts.profileLikeApi;
+		this.webApi = opts.webApi;
+		this.groupCache = opts.groupCache;
+		this.messageUnique = new MessageUnique();
+		this.self = opts.self;
+		this.selfUin = opts.self.uin;
+		this.appVersion = opts.system.appVersion;
+		this.cleanCache = opts.system.cleanCache;
+		this.cacheDir = opts.system.cacheDir;
+		this.exit = opts.system.exit;
+		this.restart = opts.system.restart;
+	}
+	/** uin→uid 转换（委托 groupApi；私聊目标/成员 user_id 用）。 */
+	uinToUid(uins) {
+		return this.groupApi.uinToUid(uins);
+	}
+	/** uid→uin 转换（委托 groupApi；notice/grayTip 用）。 */
+	uidToUin(uids) {
+		return this.groupApi.uidToUin(uids);
+	}
+};
+//#endregion
+//#region src/onebot11/helper/message-event.ts
+/** 毫秒 → 秒（Unix 时间戳）。 */
+const MS_TO_SEC$1 = 1e3;
+/** RawMessage → OB11 消息事件（message_id 经 MessageUnique 映射并记录 peer）。
+* messageFormat 决定 message 字段格式：array = 消息段数组（标准），string = CQ 码字符串。
+* ctx（可选）：接收方向 ID 转换上下文（at uid→uin、reply NT msgId→OB11 id，P2-19）。 */
+function toOb11MessageEvent(msg, selfUin, unique, messageFormat = "array", ctx = {}) {
+	const elements = applyReceiveContext(toCanonicalElements(msg), ctx);
+	const segments = canonicalToSegments(elements);
+	const time = Math.floor(Number(msg.msgTime) / MS_TO_SEC$1);
+	const selfId = Number(selfUin);
+	const userId = Number(msg.senderUin);
+	const base = {
+		time,
+		self_id: selfId,
+		post_type: "message",
+		message_id: unique.alloc(msg.msgId, {
+			chatType: msg.chatType,
+			peerUid: msg.peerUid
+		}),
+		message: messageFormat === "string" ? canonicalToCqMessage(elements) : segments,
+		raw_message: canonicalToCqMessage(elements),
+		font: 0
+	};
+	if (msg.chatType === ChatType.GROUP) {
+		const sender = {
+			user_id: userId,
+			nickname: msg.sendNickName,
+			role: "member"
+		};
+		if (msg.sendMemberName !== void 0) sender.card = msg.sendMemberName;
+		return {
+			...base,
+			message_type: "group",
+			sub_type: "normal",
+			group_id: Number(msg.peerUid),
+			user_id: userId,
+			sender
+		};
+	}
+	let subType = "friend";
+	if (msg.chatType === ChatType.C2C_TEMP) subType = "group";
+	const sender = {
+		user_id: userId,
+		nickname: msg.sendNickName
+	};
+	return {
+		...base,
+		message_type: "private",
+		sub_type: subType,
+		user_id: userId,
+		sender
+	};
+}
+//#endregion
+//#region src/onebot11/transport.ts
+/**
+* OB11 传输装配（P2-5，2026-08-05）
+*
+* 按 OB11Config 创建/装配 network 传输适配器：
+*  - HTTP 反向（http.enabled）：HttpServer 接收第三方调用 → handleRequest → 响应
+*  - WS 反向（ws.enabled）：WsServer 第三方连入 → handleRequest（echo 透传）+ 事件广播
+*  - HTTP 正向（httpPost.enabled）：HttpClient 事件上报（fire-and-forget）
+*  - WS 正向（wsReverse.enabled）：WsClient 主动连第三方（双向）
+*
+* 鉴权：token 存在时校验 Authorization: Bearer <token> / access_token 查询参数。
+* 返回 transports（事件上报用，注册到 broadcaster）与 close（停止时关闭全部）。
+*/
+/** Authorization 头前缀。 */
+const BEARER_PREFIX = "Bearer ";
+/** 校验 URL 查询参数里的 access_token（WS client 连接 URL 可能带）。 */
+function hasAccessTokenQuery(url, token) {
+	try {
+		return new URL(url).searchParams.get("access_token") === token;
+	} catch {
+		return false;
+	}
+}
+/** 校验 Authorization: Bearer <token> 头。 */
+function checkBearer(auth, token) {
+	if (auth === void 0 || !auth.startsWith(BEARER_PREFIX)) return false;
+	return auth.slice(7) === token;
+}
+/** 构造鉴权钩子（token 未配置则不鉴权）。 */
+function makeAuthorize(token) {
+	if (token === void 0 || token === "") return;
+	return (ctx) => {
+		if (checkBearer(ctx.headers["authorization"] ?? ctx.headers["Authorization"], token) || ctx.headers["authorization"] === token) return true;
+		return hasAccessTokenQuery(ctx.url, token);
+	};
+}
+/** 按配置装配 OB11 传输。 */
+function assembleOb11Transports(opts) {
+	const { config, broadcaster, handleRequest } = opts;
+	const servers = [];
+	const transports = [];
+	assembleHttpServers(config, handleRequest, servers);
+	assembleWsServers(config, handleRequest, servers);
+	assembleHttpPosts(config, transports);
+	assembleWsReverses(config, handleRequest, transports);
+	for (const t of transports) broadcaster.register(t);
+	for (const s of servers) broadcaster.register(s);
+	return {
+		servers,
+		transports,
+		close: async () => {
+			await Promise.all([...servers, ...transports].map((t) => t.close()));
+			for (const t of [...servers, ...transports]) broadcaster.unregister(t);
+		}
+	};
+}
+/** 装配 HTTP 反向 server 列表（每实例一个 HttpServer，共享 handleRequest）。 */
+function assembleHttpServers(config, handleRequest, servers) {
+	for (const item of config.httpServers) if (item.enabled) {
+		const options = {
+			host: item.host,
+			port: item.port
+		};
+		const authorize = makeAuthorize(item.token ?? config.token);
+		if (authorize !== void 0) options.authorize = authorize;
+		const server = new HttpServer(options);
+		server.onRequest = handleRequest;
+		servers.push(server);
+	}
+}
+/** 装配反向 WS server 列表（每实例一个 WsServer，心跳 ping + 鉴权）。 */
+function assembleWsServers(config, handleRequest, servers) {
+	for (const item of config.wsServers) if (item.enabled) {
+		const options = {
+			host: item.host,
+			port: item.port,
+			heartbeat: { intervalMs: item.heartbeatInterval }
+		};
+		const authorize = makeAuthorize(item.token ?? config.token);
+		if (authorize !== void 0) options.authorize = authorize;
+		const server = new WsServer(options);
+		server.onRequest = handleRequest;
+		servers.push(server);
+	}
+}
+/** 装配 HTTP 正向上报 client 列表（fire-and-forget）。 */
+function assembleHttpPosts(config, transports) {
+	for (const item of config.httpPostUrls) if (item.enabled && item.url !== void 0) {
+		const headers = authorizeHeader(item.token ?? config.token);
+		const options = { url: item.url };
+		if (headers !== void 0) options.headers = headers;
+		if (item.timeoutMs !== void 0) options.timeoutMs = item.timeoutMs;
+		transports.push(new HttpClient(options));
+	}
+}
+/** 装配正向 WS client 列表（双向，心跳 + 重连 + 证书选项）。 */
+function assembleWsReverses(config, handleRequest, transports) {
+	for (const item of config.wsReverseUrls) if (item.enabled && item.url !== void 0) {
+		const headers = authorizeHeader(item.token ?? config.token);
+		const reconnect = {
+			enabled: true,
+			delayMs: item.reconnectDelayMs
+		};
+		if (item.maxReconnectAttempts !== void 0) reconnect.maxAttempts = item.maxReconnectAttempts;
+		const options = {
+			url: item.url,
+			heartbeat: { intervalMs: item.heartbeatInterval },
+			reconnect,
+			rejectUnauthorized: item.rejectUnauthorized
+		};
+		if (headers !== void 0) options.headers = headers;
+		const client = new WsClient(options);
+		client.onRequest = handleRequest;
+		transports.push(client);
+	}
+}
+/** token → Authorization 头（client 上报/连接用）。 */
+function authorizeHeader(token) {
+	if (token === void 0 || token === "") return;
+	return { authorization: `${BEARER_PREFIX}${token}` };
+}
+//#endregion
+//#region src/onebot11/adapter.ts
+/** 毫秒 → 秒（Unix 时间戳）。 */
+const MS_TO_SEC = 1e3;
+/** OneBot 11 协议适配器。 */
+var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
+	protocol = "onebot11";
+	configSchema = ob11ConfigSchema;
+	msgChannel;
+	selfUin;
+	oneBotApi;
+	registry;
+	unsubscribe = null;
+	transports = null;
+	heartbeatTimer = null;
+	reportSelfMessage = false;
+	messageFormat = "array";
+	constructor(opts) {
+		super({
+			config: opts.config,
+			broadcaster: opts.broadcaster,
+			hooks: {
+				onStart: (config) => this.startTransports(config),
+				onStop: () => this.stopAll(),
+				onReload: () => {
+					return Promise.resolve();
+				}
+			}
+		});
+		this.msgChannel = opts.msgChannel;
+		this.selfUin = opts.self.uin;
+		this.oneBotApi = new OneBotApi(opts);
+		this.registry = createOb11ActionRegistry({ api: this.oneBotApi });
+	}
+	/** 启动传输：装配（HTTP/WS）+ 打开 server/client + 广播 lifecycle enable + 起心跳。 */
+	async startTransports(config) {
+		this.reportSelfMessage = config.reportSelfMessage;
+		this.messageFormat = config.messagePostFormat;
+		const broadcaster = this.getBroadcaster();
+		if (broadcaster !== void 0) {
+			this.transports = assembleOb11Transports({
+				config,
+				broadcaster,
+				handleRequest: (req, respond) => {
+					this.handleRequest(req, respond).catch((err) => {
+						let message = String(err);
+						if (err instanceof Error) message = err.message;
+						respond({
+							status: "failed",
+							retcode: 999,
+							data: null,
+							message
+						});
+					});
+				}
+			});
+			await Promise.all(this.transports.servers.map((s) => s.open()));
+			await Promise.all(this.transports.transports.map((t) => t.open()));
+		}
+		this.subscribe();
+		this.broadcastEvent({
+			time: Math.floor(Date.now() / MS_TO_SEC),
+			self_id: Number(this.selfUin),
+			post_type: "meta_event",
+			meta_event_type: "lifecycle",
+			sub_type: "enable"
+		});
+		this.startHeartbeat(config.heartbeatInterval);
+	}
+	/** 心跳 meta 事件（interval 毫秒，0 关闭）。 */
+	startHeartbeat(intervalMs) {
+		if (intervalMs <= 0) return;
+		this.heartbeatTimer = setInterval(() => {
+			this.broadcastEvent({
+				time: Math.floor(Date.now() / MS_TO_SEC),
+				self_id: Number(this.selfUin),
+				post_type: "meta_event",
+				meta_event_type: "heartbeat",
+				interval: intervalMs,
+				status: {
+					online: true,
+					good: true
+				}
+			});
+		}, intervalMs);
+	}
+	/** 停止：心跳 + 传输 + 退订。 */
+	async stopAll() {
+		if (this.heartbeatTimer !== null) {
+			clearInterval(this.heartbeatTimer);
+			this.heartbeatTimer = null;
+		}
+		this.unsubscribeAll();
+		if (this.transports !== null) {
+			await this.transports.close();
+			this.transports = null;
+		}
+	}
+	/** 订阅 kernel 消息事件（幂等）。 */
+	subscribe() {
+		if (this.unsubscribe !== null) return;
+		this.unsubscribe = this.msgChannel.on("Msg/onRecvMsg", (msgs) => {
+			const list = Array.isArray(msgs) ? msgs : [msgs];
+			for (const msg of list) {
+				if (!msg || typeof msg !== "object") continue;
+				if (hasGrayTip(msg)) {
+					this.broadcastNotice(msg).catch(() => {});
+					continue;
+				}
+				if (!this.reportSelfMessage && String(msg.senderUin) === this.selfUin) continue;
+				this.broadcastMessageEvent(msg);
+			}
+		});
+	}
+	/**
+	* 广播消息事件（P2-19：接收方向 ID 转换）。
+	* 收集 at uid → 一次批量 uidToUin → 构造上下文 → 翻译广播。
+	* 翻译失败退化为原样（不阻塞上报）。
+	*/
+	async broadcastMessageEvent(msg) {
+		const { atUids } = collectReceiveNeeds(toCanonicalElements(msg));
+		let uidToUin;
+		if (atUids.length > 0) try {
+			uidToUin = await this.oneBotApi.uidToUin(atUids);
+		} catch {}
+		const ctx = {
+			...uidToUin !== void 0 ? { uidToUin } : {},
+			msgIdToOb11Id: (msgId) => this.oneBotApi.messageUnique.getMessageId(msgId)
+		};
+		this.broadcastEvent(toOb11MessageEvent(msg, this.selfUin, this.oneBotApi.messageUnique, this.messageFormat, ctx));
+	}
+	/** 广播 grayTip → notice 事件（批量 uidToUin 后翻译，纯函数）。 */
+	async broadcastNotice(msg) {
+		const uids = collectGrayTipUids(msg);
+		let uidToUin = /* @__PURE__ */ new Map();
+		if (uids.length > 0) uidToUin = await this.oneBotApi.uidToUin(uids);
+		const notice = toOb11NoticeEvent(msg, {
+			selfUin: this.selfUin,
+			uidToUin
+		});
+		if (notice !== null) this.broadcastEvent(notice);
+	}
+	/** 退订（幂等）。 */
+	unsubscribeAll() {
+		this.unsubscribe?.();
+		this.unsubscribe = null;
+	}
+	/**
+	* 请求分发（挂到 network transport 的 onRequest）：
+	* OB11 标准请求 { action, params, echo } → 动作注册表 → handle（HTTP）/websocketHandle（WS）。
+	*/
+	async handleRequest(req, respond) {
+		const { action: rawAction, params, echo } = req ?? {};
+		let action = "";
+		if (typeof rawAction === "string") action = rawAction;
+		if (action === "") {
+			respond({
+				status: "failed",
+				retcode: 404,
+				data: null,
+				message: "请求缺少 action"
+			});
+			return;
+		}
+		const act = this.registry.get(action);
+		if (act === void 0) {
+			respond({
+				status: "failed",
+				retcode: 404,
+				data: null,
+				message: `未知动作: ${action}`
+			});
+			return;
+		}
+		let result;
+		if (echo === void 0) result = await act.handle(params);
+		else result = await act.websocketHandle(params, echo);
+		respond(result);
+	}
+};
+//#endregion
+export { MessageUnique, NapukettoOneBot11Adapter, OneBotApi, assembleOb11Transports, canonicalToCqMessage, canonicalToSegments, cqMessageToCanonical, cqMessageToSegments, createOb11ActionRegistry, encodeCqCode, escapeCqParam, escapeCqText, ob11ConfigSchema, ob11ErrorCodeMap, parseCqMessage, segmentsToCanonical, segmentsToCqMessage, serializeCqParts, unescapeCqText };
+
+//# sourceMappingURL=index.mjs.map