@napuketto/adapter 0.7.3 → 0.8.0

package/dist/milky/index.mjs

@@ -22,6 +22,7 @@ var MilkyApi = class {
 	webApi;
 	groupNotifyApi;
 	richMediaApi;
+	recentContactApi;
 	self;
 	groupCache;
 	qqVersion;
@@ -41,6 +42,7 @@ var MilkyApi = class {
 		this.webApi = opts.webApi;
 		this.groupNotifyApi = opts.groupNotifyApi;
 		this.richMediaApi = opts.richMediaApi;
+		this.recentContactApi = opts.recentContactApi;
 		this.self = opts.self;
 		this.groupCache = opts.groupCache;
 		this.qqVersion = opts.qqVersion;
@@ -193,6 +195,62 @@ function toFriendEntity(friend, uin, nick) {
 	};
 }
 //#endregion
+//#region src/milky/helper/media-uri.ts
+/**
+* 发送媒体 URI 解析（Milky OutgoingSegment uri → 本地路径）
+*
+* 规范支持 file:// / http(s):// / base64:// 三种（image/record/video 共用）：
+*  - file:// → 平台路径（segments.ts 的同步面已处理）
+*  - base64:// → 解码落盘 cacheDir/milky/，file-type 探测扩展名后改名
+*  - http(s):// → @napuketto/media downloadUrl 落盘 cacheDir/milky/
+* 未配置 mediaDir 时远程 URI 报错（不发静默空消息）。
+*/
+/** file:// 前缀（fileURLToPath 失败时的裸剥离兜底）。 */
+const FILE_URI_PREFIX_RE$1 = /^file:\/\//;
+/** 解析远程媒体 URI 为本地绝对路径（base64:// / http(s)://；file:// 走同步面）。 */
+async function resolveMediaUri(uri, mediaDir) {
+	if (mediaDir === void 0 || mediaDir === "") throw kernelError("远程媒体发送需要配置 [accounts.milky] cacheDir（下载缓存目录）", "INVALID_PARAM");
+	if (uri.startsWith("base64://")) return await writeBase64(uri.slice(9), mediaDir);
+	const dest = join(mediaDir, `${randomUUID()}${inferExtension(null, uri)}`);
+	await downloadUrl(uri, dest);
+	return dest;
+}
+/**
+* 动作参数 URI（image_uri / file_uri）→ 本地路径：file:// 同步展开（fileURLToPath
+* 失败裸剥离兜底，与 segments.ts 同步面同规则）；http(s):// / base64:// 复用
+* resolveMediaUri 落盘；裸路径（go-cqhttp 惯例）原样。
+*/
+async function resolveUriToPath(uri, mediaDir) {
+	if (uri.startsWith("file://")) try {
+		return fileURLToPath(uri);
+	} catch {
+		return uri.replace(FILE_URI_PREFIX_RE$1, "");
+	}
+	if (uri.startsWith("http://") || uri.startsWith("https://") || uri.startsWith("base64://")) return await resolveMediaUri(uri, mediaDir);
+	return uri;
+}
+/** base64 载荷 → 落盘（先写 .bin，探测到扩展名再改名）。 */
+async function writeBase64(payload, mediaDir) {
+	let bytes;
+	try {
+		bytes = Buffer.from(payload, "base64");
+	} catch {
+		throw kernelError("base64:// 载荷解码失败", "INVALID_PARAM");
+	}
+	if (bytes.length === 0) throw kernelError("base64:// 载荷为空", "INVALID_PARAM");
+	await mkdir(mediaDir, { recursive: true });
+	const raw = join(mediaDir, `${randomUUID()}.bin`);
+	await writeFile(raw, bytes);
+	try {
+		const { ext } = await detectFileType(raw);
+		const final = join(mediaDir, `${randomUUID()}${ext}`);
+		await rename(raw, final);
+		return final;
+	} catch {
+		return raw;
+	}
+}
+//#endregion
 //#region src/milky/helper/request.ts
 /** uid → uin（core 共享解析；ctx 携带映射）。 */
 function toUin$1(uid, ctx) {
@@ -634,6 +692,88 @@ var RejectGroupInvitationAction = class extends HandleGroupNotifyBase {
 		return await this.respond(payload.invitation_seq, false);
 	}
 };
+/** send_group_nudge：发送群戳一戳（self.uid 缺失报 INVALID_PARAM）。 */
+var SendGroupNudgeAction = class extends MilkyApiAction {
+	name = "send_group_nudge";
+	schema = z.object({
+		...groupIdField$1,
+		...userIdField
+	});
+	async _handle(payload) {
+		const receiverUid = await this.api.resolveUidFromUin(payload.user_id);
+		const peer = await this.api.resolvePeer("group", payload.group_id);
+		await this.api.msgApi.sendNudge(peer, {
+			receiverUid,
+			callerUid: requireSelfUid$1(this.api)
+		});
+		return {};
+	}
+};
+/** get_group_announcements：获取群公告列表（bulletin 形状待校准，宽松映射）。 */
+var GetGroupAnnouncementsAction = class extends MilkyApiAction {
+	name = "get_group_announcements";
+	schema = z.object({ ...groupIdField$1 });
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		const bulletins = await this.api.groupApi.getGroupAnnouncements(groupCode);
+		return { announcements: await Promise.all(bulletins.map((b) => bulletinToEntity(b, payload.group_id, this.api))) };
+	}
+};
+/** send_group_announcement：发群公告（image_uri 落盘后经上传+发布两步）。 */
+var SendGroupAnnouncementAction = class extends MilkyApiAction {
+	name = "send_group_announcement";
+	schema = z.object({
+		...groupIdField$1,
+		content: z.string().min(1),
+		image_uri: optStr$1
+	});
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		let imagePath;
+		if (payload.image_uri !== void 0 && payload.image_uri !== null && payload.image_uri !== "") imagePath = await resolveUriToPath(payload.image_uri, this.api.mediaDir);
+		await this.api.groupApi.publishGroupAnnouncement(groupCode, payload.content, imagePath);
+		return {};
+	}
+};
+/** delete_group_announcement：删除群公告。 */
+var DeleteGroupAnnouncementAction = class extends MilkyApiAction {
+	name = "delete_group_announcement";
+	schema = z.object({
+		...groupIdField$1,
+		announcement_id: z.string().min(1)
+	});
+	async _handle(payload) {
+		await this.api.groupApi.deleteGroupAnnouncement(String(payload.group_id), payload.announcement_id);
+		return {};
+	}
+};
+/** set_group_avatar：设置群头像（image_uri → 本地路径）。 */
+var SetGroupAvatarAction = class extends MilkyApiAction {
+	name = "set_group_avatar";
+	schema = z.object({
+		...groupIdField$1,
+		image_uri: z.string().min(1)
+	});
+	async _handle(payload) {
+		const imagePath = await resolveUriToPath(payload.image_uri, this.api.mediaDir);
+		await this.api.groupApi.setGroupAvatar(String(payload.group_id), imagePath);
+		return {};
+	}
+};
+/** set_group_member_special_title：设置专属头衔（uin → uid）。 */
+var SetGroupMemberSpecialTitleAction = class extends MilkyApiAction {
+	name = "set_group_member_special_title";
+	schema = z.object({
+		...groupIdField$1,
+		...userIdField,
+		special_title: z.string()
+	});
+	async _handle(payload) {
+		const uid = await this.api.resolveUidFromUin(payload.user_id);
+		await this.api.groupApi.setMemberSpecialTitle(String(payload.group_id), uid, payload.special_title);
+		return {};
+	}
+};
 /** ---------- 内部辅助 ---------- */
 /** 通知查找数量（单屏全量，OB11 DEFAULT_COUNT 同值）。 */
 const NOTIFY_SEARCH_COUNT = 100;
@@ -758,179 +898,34 @@ function notifyToEntity(notify, isFiltered, uidToUin) {
 	if (entity.type === "join_request") entity.is_filtered = isFiltered;
 	return entity;
 }
-//#endregion
-//#region src/milky/action/group-file.ts
-const groupIdField = { group_id: z.number().int().min(10001) };
-const fileIdField = { file_id: z.string().min(1) };
-const optStr = z.string().nullable().optional();
-/** get_group_files：获取群文件列表（根目录或指定文件夹；过滤 parent 匹配项）。 */
-var GetGroupFilesAction = class extends MilkyApiAction {
-	name = "get_group_files";
-	schema = z.object({
-		...groupIdField,
-		parent_folder_id: optStr
-	});
-	async _handle(payload) {
-		const groupCode = String(payload.group_id);
-		const parent = payload.parent_folder_id ?? "";
-		const items = await this.api.richMediaApi.getGroupFileList(groupCode, parent);
-		const files = [];
-		const folders = [];
-		for (const item of items) if (item.fileInfo !== void 0) files.push(fileToEntity(item.fileInfo, payload.group_id));
-		else if (item.folderInfo !== void 0) folders.push(folderToEntity(item.folderInfo, payload.group_id));
-		return {
-			files,
-			folders
-		};
-	}
-};
-/** move_group_file：移动文件（target_folder_id 空 = 移到根目录；parent 入参仅 schema 兼容）。 */
-var MoveGroupFileAction = class extends MilkyApiAction {
-	name = "move_group_file";
-	schema = z.object({
-		...groupIdField,
-		...fileIdField,
-		parent_folder_id: optStr,
-		target_folder_id: optStr
-	});
-	async _handle(payload) {
-		await this.api.richMediaApi.moveGroupFile(String(payload.group_id), [payload.file_id], payload.target_folder_id ?? "");
-		return {};
-	}
-};
-/** rename_group_file：重命名文件。 */
-var RenameGroupFileAction = class extends MilkyApiAction {
-	name = "rename_group_file";
-	schema = z.object({
-		...groupIdField,
-		...fileIdField,
-		parent_folder_id: optStr,
-		new_file_name: z.string().min(1)
-	});
-	async _handle(payload) {
-		await this.api.richMediaApi.renameGroupFile(String(payload.group_id), payload.file_id, payload.new_file_name);
-		return {};
-	}
-};
-/** delete_group_file：删除文件。 */
-var DeleteGroupFileAction = class extends MilkyApiAction {
-	name = "delete_group_file";
-	schema = z.object({
-		...groupIdField,
-		...fileIdField
-	});
-	async _handle(payload) {
-		await this.api.richMediaApi.deleteGroupFile(String(payload.group_id), [payload.file_id]);
-		return {};
-	}
-};
-/**
-* persist_group_file：转存文件（RichMediaApi.transGroupFile，转存语义待对齐）。
-*/
-var PersistGroupFileAction = class extends MilkyApiAction {
-	name = "persist_group_file";
-	schema = z.object({
-		...groupIdField,
-		...fileIdField
-	});
-	async _handle(payload) {
-		await this.api.richMediaApi.transGroupFile(String(payload.group_id), payload.file_id);
-		return {};
-	}
-};
-/** create_group_folder：创建文件夹（返回 folder_id）。 */
-var CreateGroupFolderAction = class extends MilkyApiAction {
-	name = "create_group_folder";
-	schema = z.object({
-		...groupIdField,
-		folder_name: z.string().min(1)
-	});
-	async _handle(payload) {
-		return { folder_id: await this.api.richMediaApi.createGroupFolder(String(payload.group_id), payload.folder_name) };
-	}
-};
-/** delete_group_folder：删除文件夹。 */
-var DeleteGroupFolderAction = class extends MilkyApiAction {
-	name = "delete_group_folder";
-	schema = z.object({
-		...groupIdField,
-		folder_id: z.string().min(1)
-	});
-	async _handle(payload) {
-		await this.api.richMediaApi.deleteGroupFolder(String(payload.group_id), payload.folder_id);
-		return {};
-	}
-};
-/** GroupFileItemInfo → GroupFileEntity（fileSize 原生为字符串；无源字段兜底）。 */
-function fileToEntity(info, groupId) {
-	return {
-		group_id: groupId,
-		file_id: info.fileId,
-		file_name: info.fileName,
-		parent_folder_id: info.parent ?? "",
-		file_size: Number(info.fileSize) || 0,
-		uploaded_time: Number(info.uploadTime) || 0,
-		expire_time: null,
-		uploader_id: Number(info.uploaderUin) || 0,
-		downloaded_times: 0
-	};
+/** self.uid 必备（nudge 发送的 callerUid；缺配置报 INVALID_PARAM）。 */
+function requireSelfUid$1(api) {
+	const uid = api.self.uid;
+	if (uid === void 0 || uid === "") throw kernelError("登录身份缺 uid（无法发起戳一戳）", "INVALID_PARAM");
+	return uid;
 }
-/** GroupFolderInfo → GroupFolderEntity（元数据无类型字段防御读取，缺省 0）。 */
-function folderToEntity(info, groupId) {
-	const num = (key) => {
-		const v = info[key];
-		return typeof v === "number" ? v : Number(v) || 0;
-	};
+/** GroupBulletin → 群公告实体（senderUid → uin 反查；无源字段兜底，待校准）。 */
+async function bulletinToEntity(b, groupId, api) {
 	return {
 		group_id: groupId,
-		folder_id: info.folderId,
-		parent_folder_id: info.folderUid ?? "",
-		folder_name: info.folderName,
-		created_time: num("createTime"),
-		last_modified_time: num("modifyTime"),
-		creator_id: 0,
-		file_count: num("totalFileCount")
+		announcement_id: b.announcementId ?? "",
+		user_id: await senderUinOf(b, api),
+		time: Number(b.publishTime) || 0,
+		content: b.content ?? "",
+		image_url: picUrlOf(b)
 	};
 }
-//#endregion
-//#region src/milky/helper/media-uri.ts
-/**
-* 发送媒体 URI 解析（Milky OutgoingSegment uri → 本地路径）
-*
-* 规范支持 file:// / http(s):// / base64:// 三种（image/record/video 共用）：
-*  - file:// → 平台路径（segments.ts 的同步面已处理）
-*  - base64:// → 解码落盘 cacheDir/milky/，file-type 探测扩展名后改名
-*  - http(s):// → @napuketto/media downloadUrl 落盘 cacheDir/milky/
-* 未配置 mediaDir 时远程 URI 报错（不发静默空消息）。
-*/
-/** 解析远程媒体 URI 为本地绝对路径（base64:// / http(s)://；file:// 走同步面）。 */
-async function resolveMediaUri(uri, mediaDir) {
-	if (mediaDir === void 0 || mediaDir === "") throw kernelError("远程媒体发送需要配置 [accounts.milky] cacheDir（下载缓存目录）", "INVALID_PARAM");
-	if (uri.startsWith("base64://")) return await writeBase64(uri.slice(9), mediaDir);
-	const dest = join(mediaDir, `${randomUUID()}${inferExtension(null, uri)}`);
-	await downloadUrl(uri, dest);
-	return dest;
+/** 公告发送者 uid → uin（缺省/转换失败 0 兜底）。 */
+async function senderUinOf(b, api) {
+	const uid = b.senderUid;
+	if (typeof uid !== "string" || uid === "") return 0;
+	const uins = await api.uidToUin([uid]).catch(() => void 0);
+	return Number(uins?.get(uid)) || 0;
 }
-/** base64 载荷 → 落盘（先写 .bin，探测到扩展名再改名）。 */
-async function writeBase64(payload, mediaDir) {
-	let bytes;
-	try {
-		bytes = Buffer.from(payload, "base64");
-	} catch {
-		throw kernelError("base64:// 载荷解码失败", "INVALID_PARAM");
-	}
-	if (bytes.length === 0) throw kernelError("base64:// 载荷为空", "INVALID_PARAM");
-	await mkdir(mediaDir, { recursive: true });
-	const raw = join(mediaDir, `${randomUUID()}.bin`);
-	await writeFile(raw, bytes);
-	try {
-		const { ext } = await detectFileType(raw);
-		const final = join(mediaDir, `${randomUUID()}${ext}`);
-		await rename(raw, final);
-		return final;
-	} catch {
-		return raw;
-	}
+/** 公告图片 url（缺省 null）。 */
+function picUrlOf(b) {
+	const url = b.pic?.url;
+	return typeof url === "string" && url !== "" ? url : null;
 }
 //#endregion
 //#region src/milky/helper/segments.ts
@@ -1641,6 +1636,233 @@ function receiveSegmentsOf(msg, uidToUin) {
 function avatarUrlOf(uin) {
 	return uin === "" ? "" : `https://q1.qlogo.cn/g?b=qq&nk=${uin}&s=640`;
 }
+/** get_custom_face_url_list：收藏表情链接（queryFavEmojiByDesc 形状待校准）。 */
+var GetCustomFaceUrlListAction = class extends MilkyApiAction {
+	name = "get_custom_face_url_list";
+	schema = z.object({});
+	async _handle() {
+		return { urls: await this.api.msgApi.queryFavEmojis() };
+	}
+};
+/**
+* get_resource_temp_url：资源临时链接。
+* 已知差异（P0 模型）：接收段 resource_id 即临时链接（本地路径优先 url 兜底），
+* 无独立资源索引——http(s)/base64 形态原样返回，其余 NOT_FOUND。
+*/
+var GetResourceTempUrlAction = class extends MilkyApiAction {
+	name = "get_resource_temp_url";
+	schema = z.object({ resource_id: z.string().min(1) });
+	async _handle(payload) {
+		const id = payload.resource_id;
+		if (id.startsWith("http://") || id.startsWith("https://") || id.startsWith("base64://")) return { url: id };
+		throw kernelError(`资源 ${id} 无临时链接（resource_id 非链接形态）`, "NOT_FOUND");
+	}
+};
+/** upload_private_file：上传私聊文件（file 元素消息链，file_id 取 fileUuid）。 */
+var UploadPrivateFileAction = class extends MilkyApiAction {
+	name = "upload_private_file";
+	schema = z.object({
+		user_id: z.number().int().min(10001),
+		file_uri: z.string().min(1),
+		file_name: z.string().min(1)
+	});
+	async _handle(payload) {
+		const path = await resolveUriToPath(payload.file_uri, this.api.mediaDir);
+		const peer = await this.api.resolvePeer("friend", payload.user_id);
+		return { file_id: await sendFileMessage(this.api, peer, path, payload.file_name) };
+	}
+};
+/**
+* 发送文件消息并回查 file_id：sendMessage（canonical file 元素，kernel 走
+* prepareFileElement 链）→ fetchMsgsByMsgId 取 fileElement.fileUuid（缺省 msgId）。
+* upload_private/group_file 共用。
+*/
+async function sendFileMessage(api, peer, path, fileName) {
+	const { msgId } = await api.msgApi.sendMessage(peer, [{
+		type: "file",
+		path,
+		name: fileName
+	}]);
+	const [sent] = await api.msgApi.fetchMsgsByMsgId(peer, [msgId]);
+	const uuid = (sent?.elements.find((e) => e.fileElement !== void 0))?.fileElement?.fileUuid;
+	return uuid !== void 0 && uuid !== "" ? uuid : msgId;
+}
+//#endregion
+//#region src/milky/action/group-file.ts
+const groupIdField = { group_id: z.number().int().min(10001) };
+const fileIdField = { file_id: z.string().min(1) };
+const optStr = z.string().nullable().optional();
+/** get_group_files：获取群文件列表（根目录或指定文件夹；过滤 parent 匹配项）。 */
+var GetGroupFilesAction = class extends MilkyApiAction {
+	name = "get_group_files";
+	schema = z.object({
+		...groupIdField,
+		parent_folder_id: optStr
+	});
+	async _handle(payload) {
+		const groupCode = String(payload.group_id);
+		const parent = payload.parent_folder_id ?? "";
+		const items = await this.api.richMediaApi.getGroupFileList(groupCode, parent);
+		const files = [];
+		const folders = [];
+		for (const item of items) if (item.fileInfo !== void 0) files.push(fileToEntity(item.fileInfo, payload.group_id));
+		else if (item.folderInfo !== void 0) folders.push(folderToEntity(item.folderInfo, payload.group_id));
+		return {
+			files,
+			folders
+		};
+	}
+};
+/** move_group_file：移动文件（target_folder_id 空 = 移到根目录；parent 入参仅 schema 兼容）。 */
+var MoveGroupFileAction = class extends MilkyApiAction {
+	name = "move_group_file";
+	schema = z.object({
+		...groupIdField,
+		...fileIdField,
+		parent_folder_id: optStr,
+		target_folder_id: optStr
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.moveGroupFile(String(payload.group_id), [payload.file_id], payload.target_folder_id ?? "");
+		return {};
+	}
+};
+/** rename_group_file：重命名文件。 */
+var RenameGroupFileAction = class extends MilkyApiAction {
+	name = "rename_group_file";
+	schema = z.object({
+		...groupIdField,
+		...fileIdField,
+		parent_folder_id: optStr,
+		new_file_name: z.string().min(1)
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.renameGroupFile(String(payload.group_id), payload.file_id, payload.new_file_name);
+		return {};
+	}
+};
+/** delete_group_file：删除文件。 */
+var DeleteGroupFileAction = class extends MilkyApiAction {
+	name = "delete_group_file";
+	schema = z.object({
+		...groupIdField,
+		...fileIdField
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.deleteGroupFile(String(payload.group_id), [payload.file_id]);
+		return {};
+	}
+};
+/**
+* persist_group_file：转存文件（RichMediaApi.transGroupFile，转存语义待对齐）。
+*/
+var PersistGroupFileAction = class extends MilkyApiAction {
+	name = "persist_group_file";
+	schema = z.object({
+		...groupIdField,
+		...fileIdField
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.transGroupFile(String(payload.group_id), payload.file_id);
+		return {};
+	}
+};
+/** create_group_folder：创建文件夹（返回 folder_id）。 */
+var CreateGroupFolderAction = class extends MilkyApiAction {
+	name = "create_group_folder";
+	schema = z.object({
+		...groupIdField,
+		folder_name: z.string().min(1)
+	});
+	async _handle(payload) {
+		return { folder_id: await this.api.richMediaApi.createGroupFolder(String(payload.group_id), payload.folder_name) };
+	}
+};
+/** delete_group_folder：删除文件夹。 */
+var DeleteGroupFolderAction = class extends MilkyApiAction {
+	name = "delete_group_folder";
+	schema = z.object({
+		...groupIdField,
+		folder_id: z.string().min(1)
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.deleteGroupFolder(String(payload.group_id), payload.folder_id);
+		return {};
+	}
+};
+/** GroupFileItemInfo → GroupFileEntity（fileSize 原生为字符串；无源字段兜底）。 */
+function fileToEntity(info, groupId) {
+	return {
+		group_id: groupId,
+		file_id: info.fileId,
+		file_name: info.fileName,
+		parent_folder_id: info.parent ?? "",
+		file_size: Number(info.fileSize) || 0,
+		uploaded_time: Number(info.uploadTime) || 0,
+		expire_time: null,
+		uploader_id: Number(info.uploaderUin) || 0,
+		downloaded_times: 0
+	};
+}
+/** GroupFolderInfo → GroupFolderEntity（元数据无类型字段防御读取，缺省 0）。 */
+function folderToEntity(info, groupId) {
+	const num = (key) => {
+		const v = info[key];
+		return typeof v === "number" ? v : Number(v) || 0;
+	};
+	return {
+		group_id: groupId,
+		folder_id: info.folderId,
+		parent_folder_id: info.folderUid ?? "",
+		folder_name: info.folderName,
+		created_time: num("createTime"),
+		last_modified_time: num("modifyTime"),
+		creator_id: 0,
+		file_count: num("totalFileCount")
+	};
+}
+/** upload_group_file：上传群文件（消息发送链；parent_folder_id 暂不参与定位）。 */
+var UploadGroupFileAction = class extends MilkyApiAction {
+	name = "upload_group_file";
+	schema = z.object({
+		...groupIdField,
+		parent_folder_id: optStr,
+		file_uri: z.string().min(1),
+		file_name: z.string().min(1)
+	});
+	async _handle(payload) {
+		const path = await resolveUriToPath(payload.file_uri, this.api.mediaDir);
+		const peer = {
+			chatType: ChatType.GROUP,
+			peerUid: String(payload.group_id)
+		};
+		return { file_id: await sendFileMessage(this.api, peer, path, payload.file_name) };
+	}
+};
+/** get_group_file_download_url：群文件下载链接（url 字段待实机确认，仅根目录）。 */
+var GetGroupFileDownloadUrlAction = class extends MilkyApiAction {
+	name = "get_group_file_download_url";
+	schema = z.object({
+		...groupIdField,
+		...fileIdField
+	});
+	async _handle(payload) {
+		return { download_url: await this.api.richMediaApi.getGroupFileDownloadUrl(String(payload.group_id), payload.file_id) };
+	}
+};
+/** rename_group_folder：重命名群文件夹（renameGroupFile 同款形态，待校准）。 */
+var RenameGroupFolderAction = class extends MilkyApiAction {
+	name = "rename_group_folder";
+	schema = z.object({
+		...groupIdField,
+		folder_id: z.string().min(1),
+		new_folder_name: z.string().min(1)
+	});
+	async _handle(payload) {
+		await this.api.richMediaApi.renameGroupFolder(String(payload.group_id), payload.folder_id, payload.new_folder_name);
+		return {};
+	}
+};
 //#endregion
 //#region src/milky/action/profile.ts
 /**
@@ -1735,11 +1957,6 @@ var GetCSRFTokenAction = class extends MilkyApiAction {
 };
 //#endregion
 //#region src/milky/action/social.ts
-/**
-* Milky 社交类动作（P0：get_friend_list / get_group_list；
-* P1 +5：send_profile_like / delete_friend / get_friend_requests /
-* accept_friend_request / reject_friend_request）
-*/
 const emptySchema$1 = z.object({}).strict();
 /** get_friend_list：获取好友列表。 */
 var GetFriendListAction = class extends MilkyApiAction {
@@ -1839,6 +2056,84 @@ var RejectFriendRequestAction = class extends HandleFriendRequestBase {
 	name = "reject_friend_request";
 	accept = false;
 };
+/** send_friend_nudge：发送好友戳一戳（is_self=true 戳自己）。 */
+var SendFriendNudgeAction = class extends MilkyApiAction {
+	name = "send_friend_nudge";
+	schema = z.object({
+		user_id: z.number().int().min(10001),
+		is_self: optBoolNudge
+	});
+	async _handle(payload) {
+		const callerUid = requireSelfUid(this.api);
+		const receiverUid = payload.is_self === true ? callerUid : await this.api.resolveUidFromUin(payload.user_id);
+		const peer = await this.api.resolvePeer("friend", payload.user_id);
+		await this.api.msgApi.sendNudge(peer, {
+			receiverUid,
+			callerUid
+		});
+		return {};
+	}
+};
+/** get_peer_pins：获取置顶会话（RecentContactApi isTop 过滤，实体经现有翻译）。 */
+var GetPeerPinsAction = class extends MilkyApiAction {
+	name = "get_peer_pins";
+	schema = z.object({});
+	async _handle() {
+		const pinned = await this.api.recentContactApi.getPinnedContacts();
+		const friendUids = pinned.filter((p) => p.scene === "friend").map((p) => p.peerUid);
+		const groupCodes = pinned.filter((p) => p.scene === "group").map((p) => p.peerUid);
+		return {
+			friends: await pinnedFriendEntities(this.api, friendUids),
+			groups: await pinnedGroupEntities(this.api, groupCodes)
+		};
+	}
+};
+/** set_peer_pin：设置/取消会话置顶（is_pinned 缺省 true）。 */
+var SetPeerPinAction = class extends MilkyApiAction {
+	name = "set_peer_pin";
+	schema = z.object({
+		message_scene: z.enum([
+			"friend",
+			"group",
+			"temp"
+		]),
+		peer_id: z.number().int().min(10001),
+		is_pinned: optBoolNudge
+	});
+	async _handle(payload) {
+		const peer = await this.api.resolvePeer(payload.message_scene, payload.peer_id);
+		await this.api.msgApi.setContactTop(peer, payload.is_pinned ?? true);
+		return {};
+	}
+};
+/** 置顶好友实体（uid 匹配全量好友列表；未命中跳过）。 */
+async function pinnedFriendEntities(api, uids) {
+	if (uids.length === 0) return [];
+	const all = await api.friendApi.getFriendList();
+	const byUid = new Map(all.map((f) => [f.uid, f]));
+	return uids.flatMap((uid) => {
+		const f = byUid.get(uid);
+		return f !== void 0 ? [toFriendEntity(f, f.uin, f.nickname)] : [];
+	});
+}
+/** 置顶群实体（groupCode 匹配群列表，缓存优先；未命中跳过）。 */
+async function pinnedGroupEntities(api, groupCodes) {
+	if (groupCodes.length === 0) return [];
+	const groups = api.groupCache !== void 0 ? await api.groupCache.listGroupsRefreshed() : await api.groupApi.getGroupList(true);
+	const byCode = new Map(groups.map((g) => [g.groupCode, g]));
+	return groupCodes.flatMap((code) => {
+		const g = byCode.get(code);
+		return g !== void 0 ? [groupListToEntity(g)] : [];
+	});
+}
+/** self.uid 必备（nudge 发送的 callerUid）。 */
+function requireSelfUid(api) {
+	const uid = api.self.uid;
+	if (uid === void 0 || uid === "") throw kernelError("登录身份缺 uid（无法发起戳一戳）", "INVALID_PARAM");
+	return uid;
+}
+/** 可选布尔（social.ts 本文件原无 optBool，本地定义避免全局重名）。 */
+const optBoolNudge = z.boolean().nullable().optional();
 //#endregion
 //#region src/milky/action/system.ts
 /**
@@ -1878,11 +2173,11 @@ var GetImplInfoAction = class extends MilkyApiAction {
 //#endregion
 //#region src/milky/action/index.ts
 /**
-* Milky 动作注册表（P0 9 个 + P1 40 个 = 49 个）
+* Milky 动作注册表（P0 9 + P1 40 + P2 批次二 15 = 64 个）
 *
-* P0 面 = docs/protocols/milky.md §9 P0 清单；P1 面 = §9 P1 清单（群管/精华/
-* 群文件/好友操作/票据/历史与转发）。延后项（nudge 发送 / rename_folder /
-* download_url / resource 反查 / 置顶 / 公告 / 上传）见 milky.md §6。
+* P0/P1 面 = docs/protocols/milky.md §9 清单；批次二 = §0.7（nudge / 公告 /
+* 头衔 / 群头像 / peer_pins / 上传 / download_url / rename_folder / 收藏表情 /
+* resource 反查）。
 */
 /** Milky 动作注册表（P0+P1 49 动作）。 */
 function createMilkyActionRegistry(opts) {
@@ -1937,6 +2232,21 @@ function createMilkyActionRegistry(opts) {
 	registry.register(new PersistGroupFileAction(api));
 	registry.register(new CreateGroupFolderAction(api));
 	registry.register(new DeleteGroupFolderAction(api));
+	registry.register(new SendFriendNudgeAction(api));
+	registry.register(new GetPeerPinsAction(api));
+	registry.register(new SetPeerPinAction(api));
+	registry.register(new SendGroupNudgeAction(api));
+	registry.register(new GetGroupAnnouncementsAction(api));
+	registry.register(new SendGroupAnnouncementAction(api));
+	registry.register(new DeleteGroupAnnouncementAction(api));
+	registry.register(new SetGroupAvatarAction(api));
+	registry.register(new SetGroupMemberSpecialTitleAction(api));
+	registry.register(new GetCustomFaceUrlListAction(api));
+	registry.register(new GetResourceTempUrlAction(api));
+	registry.register(new UploadPrivateFileAction(api));
+	registry.register(new UploadGroupFileAction(api));
+	registry.register(new GetGroupFileDownloadUrlAction(api));
+	registry.register(new RenameGroupFolderAction(api));
 	return registry;
 }
 //#endregion