@napuketto/loader 0.0.20 → 0.0.21

package/dist/host/self-host.cjs

@@ -271,6 +271,81 @@ async function toPeer(params, uinToUid) {
 	}
 	throw new Error("缺 peerUid（或 peerUin 且未注入 uinToUid）");
 }
+/** at 元素判断（宽松结构；排除 @全体——target="all" 走 atType=1，无需转换）。 */
+function isLooseAtElement(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const el = value;
+	return el["type"] === "at" && typeof el["target"] === "string" && el["target"] !== "all";
+}
+/** 收集元素中的 at（非 @全体）及其索引。 */
+function collectAtItems(elements) {
+	const items = [];
+	for (let i = 0; i < elements.length; i++) {
+		const el = elements[i];
+		if (isLooseAtElement(el)) items.push({
+			index: i,
+			uin: el.target
+		});
+	}
+	return items;
+}
+/** 群成员昵称 → display（可选依赖 groupCache.getMember；无昵称返回 undefined）。 */
+async function memberDisplay(ctx, groupCode, uid) {
+	if (ctx.groupCache.getMember === void 0) return;
+	const member = await ctx.groupCache.getMember(groupCode, uid);
+	if (member === void 0 || member.nick === void 0 || member.nick === "") return;
+	return member.nick;
+}
+/**
+* 单个 at 元素归一化：target uin → uid（u_ 前缀直通）+ display 补全。
+* 返回 null 表示目标未解析（调用方保留原元素，保底发送）。
+*/
+async function normalizeAtElement(ctx, groupCode, prev, uidMap) {
+	const uid = prev.target.startsWith("u_") ? prev.target : uidMap.get(prev.target) ?? "";
+	if (uid === "") return null;
+	const next = {
+		type: "at",
+		target: uid
+	};
+	if (prev.display !== void 0 && prev.display !== "") {
+		next.display = prev.display;
+		return next;
+	}
+	const nick = await memberDisplay(ctx, groupCode, uid);
+	if (nick !== void 0) next.display = nick;
+	return next;
+}
+/**
+* 发送前 at 目标归一化（P2-19 同构：OB11 协议层 at.qq uin → uid 后才进 kernel）。
+*
+* 背景（koishi-plugin-adapter-napuketto issue #1「无法 @ 指定群成员」）：
+* koishi 调用方给的 at.target 是 QQ 号（uin——session.userId 即 senderUin），
+* 而 NT 的 atUid 契约是 u_ 开头的 uid。不转则 QQ 解析 at 失败，只能回退显示
+* content 兜底 "@" → 表现为「@号后面为空」。群聊才有 at 语义，私聊/临时会话跳过。
+*
+* 归一化：uin 批量 uinToUid → uid（u_ 前缀直通不转）；有 groupCache.getMember
+* 时补 display（群成员昵称，kernel toSendElements 用它作 TEXT content，
+* 避免 @ 后无显示名）。转换失败/缺注入：保留原元素（不阻塞发送，保底）。
+*/
+async function resolveAtElements(chatType, peerUid, elements, ctx) {
+	if (chatType !== 2 || ctx.uinToUid === void 0) return elements;
+	const atItems = collectAtItems(elements);
+	if (atItems.length === 0) return elements;
+	const uins = atItems.filter((item) => !item.uin.startsWith("u_"));
+	let uidMap = /* @__PURE__ */ new Map();
+	if (uins.length > 0) try {
+		uidMap = await ctx.uinToUid(uins.map((item) => item.uin));
+	} catch {
+		uidMap = /* @__PURE__ */ new Map();
+	}
+	const out = [...elements];
+	for (const item of atItems) {
+		const prev = out[item.index];
+		const next = await normalizeAtElement(ctx, peerUid, prev, uidMap);
+		if (next !== null) out[item.index] = next;
+	}
+	return out;
+}
 /** 构造动作表（map 顺序即注册顺序，重复动作名后注册覆盖）。 */
 function createIpcActions(ctx) {
 	const actions = /* @__PURE__ */ new Map();
@@ -278,7 +353,8 @@ function createIpcActions(ctx) {
 	actions.set("msg.sendMessage", async (params) => {
 		const peer = await toPeer(params, ctx.uinToUid);
 		const elements = Array.isArray(params["elements"]) ? params["elements"] : [];
-		return ctx.msgApi.sendMessage(peer, elements);
+		const resolved = await resolveAtElements(peer.chatType, peer.peerUid, elements, ctx);
+		return ctx.msgApi.sendMessage(peer, resolved);
 	});
 	actions.set("msg.recallMessage", async (params) => {
 		const peer = await toPeer(params, ctx.uinToUid);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@napuketto/loader",
-    "version": "0.0.20",
+    "version": "0.0.21",
     "description": "NapukettoQQ 引导组件：自建宿主（标准 Node + stub QQNT.dll）dlopen wrapper.node 并启动 kernel，不拉起 QQ / 不注入",
     "type": "module",
     "files": [