koishi-plugin-chatluna-toolbox 0.0.13 → 0.0.16

package/README.md

@@ -13,10 +13,14 @@
 ### 1) 原生工具
 - 戳一戳
 - 设置自身资料
+- 设置 QQ 头像
 - 设置群名片
+- 设置群成员专属头衔
 - 给消息添加表情
 - 撤回消息
 
+QQ 头像工具会把 HTTP/HTTPS 图片先转为 OneBot `base64://` 文件再提交，避免 OneBot 端无法访问 Koishi 临时图片地址。
+
 ### 2) XML 工具
 支持从模型输出中解析 XML 动作标签并执行：
 

package/lib/index.js

@@ -423,8 +423,10 @@ __export(index_exports, {
   createRandomProvider: () => createRandomProvider,
   createSetGroupBanTool: () => createSetGroupBanTool,
   createSetGroupCardTool: () => createSetGroupCardTool,
+  createSetGroupSpecialTitleTool: () => createSetGroupSpecialTitleTool,
   createSetMsgEmojiTool: () => createSetMsgEmojiTool,
   createSetProfileTool: () => createSetProfileTool,
+  createSetQQAvatarTool: () => createSetQQAvatarTool,
   createUserInfoProvider: () => createUserInfoProvider,
   createXmlProcessor: () => createXmlProcessor,
   ensureOneBotSession: () => ensureOneBotSession,
@@ -443,7 +445,9 @@ __export(index_exports, {
   sendMsgEmoji: () => sendMsgEmoji,
   sendPoke: () => sendPoke,
   sendSetGroupCard: () => sendSetGroupCard,
-  sendSetProfile: () => sendSetProfile
+  sendSetGroupSpecialTitle: () => sendSetGroupSpecialTitle,
+  sendSetProfile: () => sendSetProfile,
+  sendSetQQAvatar: () => sendSetQQAvatar
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -463,8 +467,10 @@ var import_koishi2 = require("koishi");
 // src/features/native-tools/defaults.ts
 var DEFAULT_POKE_TOOL_DESCRIPTION = "\u5BF9\u6307\u5B9A\u7528\u6237\u6267\u884C\u6233\u4E00\u6233\u3002";
 var DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION = "\u4FEE\u6539\u81EA\u5DF1\u7684 QQ \u8D44\u6599\uFF0C\u53EF\u8BBE\u7F6E\u6635\u79F0\u3001\u7B7E\u540D\u548C\u6027\u522B\u3002";
+var DEFAULT_SET_QQ_AVATAR_TOOL_DESCRIPTION = "\u4FEE\u6539\u673A\u5668\u4EBA QQ \u5934\u50CF\u3002\u63D0\u4F9B imageUrl\uFF1BHTTP/HTTPS \u56FE\u7247\u4F1A\u5148\u7531 Koishi \u8BFB\u53D6\u5E76\u8F6C\u4E3A OneBot base64 \u6587\u4EF6\uFF0C\u907F\u514D\u4E34\u65F6 URL \u8FC7\u671F\u6216 OneBot \u7AEF\u65E0\u6CD5\u8BBF\u95EE\u3002";
 var DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION = "\u4FEE\u6539\u7FA4\u6210\u5458\u7684\u7FA4\u6635\u79F0\u3002";
 var DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION = "\u7528\u4E8E\u7BA1\u7406\u7FA4\u6210\u5458\u7981\u8A00\u72B6\u6001\uFF0C\u53EF\u8BBE\u7F6E\u7981\u8A00\u65F6\u957F\u6216\u89E3\u9664\u7981\u8A00\u3002";
+var DEFAULT_SET_GROUP_SPECIAL_TITLE_TOOL_DESCRIPTION = "\u4FEE\u6539\u6216\u6E05\u9664\u7FA4\u6210\u5458\u7684 QQ \u7FA4\u4E13\u5C5E\u5934\u8854\u3002";
 var DEFAULT_SET_MSG_EMOJI_TOOL_DESCRIPTION = "\u5BF9\u6307\u5B9A\u6D88\u606F\u6DFB\u52A0\u8868\u60C5\u56DE\u5E94\u3002";
 var DEFAULT_DELETE_MESSAGE_TOOL_DESCRIPTION = "\u6839\u636E\u6D88\u606F ID \u64A4\u56DE\u6307\u5B9A\u6D88\u606F\u3002";
 
@@ -482,6 +488,11 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     toolName: import_koishi2.Schema.string().default("set_self_profile").description("\u5DE5\u5177\u540D\u79F0"),
     description: import_koishi2.Schema.string().default(DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
   }).description("\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F\u5DE5\u5177").collapse(),
+  setQQAvatar: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u673A\u5668\u4EBA QQ \u5934\u50CF"),
+    toolName: import_koishi2.Schema.string().default("set_qq_avatar").description("\u5DE5\u5177\u540D\u79F0"),
+    description: import_koishi2.Schema.string().default(DEFAULT_SET_QQ_AVATAR_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
+  }).description("\u4FEE\u6539 QQ \u5934\u50CF\u5DE5\u5177").collapse(),
   setGroupCard: import_koishi2.Schema.object({
     enabled: import_koishi2.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u7FA4\u6210\u5458\u6635\u79F0"),
     toolName: import_koishi2.Schema.string().default("set_group_card").description("\u5DE5\u5177\u540D\u79F0"),
@@ -492,6 +503,11 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     toolName: import_koishi2.Schema.string().default("set_group_ban").description("\u5DE5\u5177\u540D\u79F0"),
     description: import_koishi2.Schema.string().default(DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
   }).description("\u7981\u8A00\u5DE5\u5177").collapse(),
+  setGroupSpecialTitle: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u7FA4\u6210\u5458\u4E13\u5C5E\u5934\u8854"),
+    toolName: import_koishi2.Schema.string().default("set_group_special_title").description("\u5DE5\u5177\u540D\u79F0"),
+    description: import_koishi2.Schema.string().default(DEFAULT_SET_GROUP_SPECIAL_TITLE_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
+  }).description("\u4FEE\u6539\u7FA4\u6210\u5458\u4E13\u5C5E\u5934\u8854\u5DE5\u5177").collapse(),
   setMsgEmoji: import_koishi2.Schema.object({
     enabled: import_koishi2.Schema.boolean().default(false).description(
       "\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u7ED9\u6D88\u606F\u6DFB\u52A0\u8868\u60C5\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u4E0E XML\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF0C\u8868\u60C5\u5BF9\u7167\u8868\uFF1Ahttps://bot.q.qq.com/wiki/develop/pythonsdk/model/emoji.html \uFF09"
@@ -517,6 +533,11 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     toolName: "set_self_profile",
     description: DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION
   },
+  setQQAvatar: {
+    enabled: false,
+    toolName: "set_qq_avatar",
+    description: DEFAULT_SET_QQ_AVATAR_TOOL_DESCRIPTION
+  },
   setGroupCard: {
     enabled: false,
     toolName: "set_group_card",
@@ -527,6 +548,11 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     toolName: "set_group_ban",
     description: DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION
   },
+  setGroupSpecialTitle: {
+    enabled: false,
+    toolName: "set_group_special_title",
+    description: DEFAULT_SET_GROUP_SPECIAL_TITLE_TOOL_DESCRIPTION
+  },
   setMsgEmoji: {
     enabled: false,
     toolName: "set_msg_emoji",
@@ -563,13 +589,12 @@ var DEFAULT_XML_REFERENCE_PROMPT = `## \u52A8\u4F5C\u6307\u4EE4
   - id: user_id
   - duration: \u7981\u8A00\u65F6\u957F\uFF0C\u5355\u4F4D\u79D2\uFF0C\u4F20 0 \u8868\u793A\u89E3\u9664\u7981\u8A00
   - \u9002\u7528\u573A\u666F:
-    - \u4F60\u5728\u672C\u7FA4\u4E3A\u7BA1\u7406\u5458
-    - \u7528\u4E8E\u7981\u8A00\u6216\u89E3\u9664\u7981\u8A00\u6307\u5B9A\u7FA4\u6210\u5458
+    - \u4F60\u5728\u672C\u7FA4\u4E3A\u7BA1\u7406\u5458\u65F6\u7528\u4E8E\u7981\u8A00\u6216\u89E3\u9664\u7981\u8A00\u6307\u5B9A\u7FA4\u6210\u5458
 4. \u64A4\u56DE\u6D88\u606F: <delete message_id=""/>
   - message_id: \u6D88\u606F ID
   - \u9002\u7528\u573A\u666F:
-    - \u4F60\u5728\u672C\u7FA4\u4E3A\u7BA1\u7406\u5458
-    - \u7528\u4E8E\u64A4\u56DE\u6307\u5B9A\u6D88\u606F
+    - \u64A4\u56DE\u81EA\u5DF1\u53D1\u7684\u6D88\u606F
+    - \u4F60\u5728\u672C\u7FA4\u4E3A\u7BA1\u7406\u5458\u65F6\u64A4\u56DE\u5176\u4ED6\u7528\u6237\u53D1\u9001\u7684\u6D88\u606F
 
 \u683C\u5F0F\u793A\u4F8B:
 \`\`\`xml
@@ -734,6 +759,7 @@ function createLogger(ctx, config) {
 
 // src/features/native-tools/tools/delete-msg.ts
 var import_zod = require("zod");
+var import_tools = require("@langchain/core/tools");
 
 // src/features/native-tools/onebot-api.ts
 function ensureOneBotSession(session) {
@@ -763,19 +789,33 @@ function getSession(runnable) {
 }
 
 // src/features/native-tools/tools/delete-msg.ts
+function assertOneBotSuccess(result) {
+  const response = result;
+  if (!response || typeof response !== "object") return;
+  const status = String(response.status || "").toLowerCase();
+  const failed = status === "failed" || !!status && status !== "ok" || typeof response.retcode === "number" && response.retcode !== 0;
+  if (!failed) return;
+  const reason = response.wording || response.message || response.status;
+  const retcode = typeof response.retcode === "number" ? ` (retcode: ${response.retcode})` : "";
+  throw new Error(`${reason || "OneBot returned failed"}${retcode}`);
+}
 async function sendDeleteMessage(params) {
-  const { session, messageId, log } = params;
+  const { session, message_id, log } = params;
   try {
     if (!session) return "No session context available.";
-    const messageIdRaw = messageId.trim();
-    if (!messageIdRaw) return "messageId is required.";
+    const messageIdRaw = message_id.trim();
+    if (!messageIdRaw) return "message_id is required.";
     const numericId = /^\d+$/.test(messageIdRaw) ? Number(messageIdRaw) : messageIdRaw;
     if (session.platform === "onebot") {
       const { error, internal } = ensureOneBotSession(session);
       if (error) return error;
-      await callOneBotAPI(internal, "delete_msg", { message_id: numericId }, [
-        "deleteMsg"
-      ]);
+      const result = await callOneBotAPI(
+        internal,
+        "delete_msg",
+        { message_id: numericId },
+        ["deleteMsg"]
+      );
+      assertOneBotSuccess(result);
       const success = `Message deleted by ID ${messageIdRaw}.`;
       log?.("info", success);
       return success;
@@ -797,18 +837,18 @@ async function sendDeleteMessage(params) {
 }
 function createDeleteMessageTool(deps) {
   const { toolName, description, log } = deps;
-  const tool = {
-    name: toolName || "delete_msg",
-    description: description || DEFAULT_DELETE_MESSAGE_TOOL_DESCRIPTION,
-    schema: import_zod.z.object({
-      messageId: import_zod.z.string().min(1, "messageId is required").describe("Specific message ID to delete.")
-    }),
+  return new class extends import_tools.StructuredTool {
+    name = toolName || "delete_msg";
+    description = description || DEFAULT_DELETE_MESSAGE_TOOL_DESCRIPTION;
+    schema = import_zod.z.object({
+      message_id: import_zod.z.string().min(1, "message_id is required").describe("Specific message ID to delete.")
+    }).strict();
     async _call(input, _manager, runnable) {
       try {
         const session = getSession(runnable);
         return await sendDeleteMessage({
           session,
-          messageId: input.messageId,
+          message_id: input.message_id,
           log
         });
       } catch (error) {
@@ -816,13 +856,12 @@ function createDeleteMessageTool(deps) {
         return `delete_msg failed: ${error.message}`;
       }
     }
-  };
-  return tool;
+  }();
 }
 
 // src/features/native-tools/tools/poke.ts
 var import_zod2 = require("zod");
-var import_tools = require("@langchain/core/tools");
+var import_tools2 = require("@langchain/core/tools");
 async function sendPoke(params) {
   try {
     const { session, userId, groupId, log, protocol } = params;
@@ -832,11 +871,11 @@ async function sendPoke(params) {
       session: validatedSession
     } = ensureOneBotSession(session);
     if (error) return error;
-    const resolvedGroupId = groupId?.trim() || validatedSession?.guildId || validatedSession?.channelId || validatedSession?.roomId;
+    const resolvedGroupId = groupId?.trim() || validatedSession?.guildId || validatedSession?.roomId;
     const payload = { user_id: userId };
     if (resolvedGroupId) payload.group_id = resolvedGroupId;
+    const action = payload.group_id ? "group_poke" : "friend_poke";
     if (protocol === "llbot") {
-      const action = payload.group_id ? "group_poke" : "friend_poke";
       if (typeof internal._request === "function") {
         await internal._request(action, payload);
       } else if (typeof internal[action] === "function") {
@@ -845,7 +884,9 @@ async function sendPoke(params) {
         throw new Error(`\u5F53\u524D\u9002\u914D\u5668\u672A\u5B9E\u73B0 ${action} API\u3002`);
       }
     } else if (typeof internal._request === "function") {
-      await internal._request("send_poke", payload);
+      await internal._request(action, payload);
+    } else if (typeof internal[action] === "function") {
+      await internal[action](payload);
     } else if (typeof internal.sendPoke === "function") {
       await internal.sendPoke(
         payload.group_id,
@@ -867,7 +908,7 @@ async function sendPoke(params) {
 }
 function createPokeTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools.StructuredTool {
+  return new class extends import_tools2.StructuredTool {
     name = toolName || "poke_user";
     description = description || DEFAULT_POKE_TOOL_DESCRIPTION;
     schema = import_zod2.z.object({
@@ -889,7 +930,7 @@ function createPokeTool(deps) {
 
 // src/features/native-tools/tools/set-group-ban.ts
 var import_zod3 = require("zod");
-var import_tools2 = require("@langchain/core/tools");
+var import_tools3 = require("@langchain/core/tools");
 function resolveGroupId(session, groupId) {
   return groupId?.trim() || (session.guildId || "").trim() || (session.channelId || "").trim() || (session.roomId || "").trim();
 }
@@ -939,7 +980,7 @@ async function sendGroupBan(params) {
 }
 function createSetGroupBanTool(deps) {
   const { toolName, description, protocol, log } = deps;
-  return new class extends import_tools2.StructuredTool {
+  return new class extends import_tools3.StructuredTool {
     name = toolName || "set_group_ban";
     description = description || DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION;
     schema = import_zod3.z.object({
@@ -963,7 +1004,7 @@ function createSetGroupBanTool(deps) {
 
 // src/features/native-tools/tools/set-group-card.ts
 var import_zod4 = require("zod");
-var import_tools3 = require("@langchain/core/tools");
+var import_tools4 = require("@langchain/core/tools");
 async function sendSetGroupCard(params) {
   try {
     const { session, userId, card, groupId, log } = params;
@@ -994,7 +1035,7 @@ async function sendSetGroupCard(params) {
 }
 function createSetGroupCardTool(deps) {
   const { toolName, description, log } = deps;
-  return new class extends import_tools3.StructuredTool {
+  return new class extends import_tools4.StructuredTool {
     name = toolName || "set_group_card";
     description = description || DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION;
     schema = import_zod4.z.object({
@@ -1014,9 +1055,73 @@ function createSetGroupCardTool(deps) {
   }();
 }
 
-// src/features/native-tools/tools/set-msg-emoji.ts
+// src/features/native-tools/tools/set-group-special-title.ts
 var import_zod5 = require("zod");
-var import_tools4 = require("@langchain/core/tools");
+var import_tools5 = require("@langchain/core/tools");
+function resolveGroupId2(session, groupId) {
+  return groupId?.trim() || (session.guildId || "").trim() || (session.channelId || "").trim() || (session.roomId || "").trim();
+}
+async function sendSetGroupSpecialTitle(params) {
+  try {
+    const { session, userId, groupId, title, log } = params;
+    const {
+      error,
+      internal,
+      session: validatedSession
+    } = ensureOneBotSession(session);
+    if (error) return error;
+    const resolvedGroupId = resolveGroupId2(validatedSession, groupId);
+    if (!resolvedGroupId) {
+      return "Missing groupId. Provide groupId explicitly or run inside a group session.";
+    }
+    const userIdRaw = userId.trim();
+    if (!userIdRaw) return "userId is required.";
+    const titleRaw = title.trim();
+    await callOneBotAPI(
+      internal,
+      "set_group_special_title",
+      {
+        group_id: resolvedGroupId,
+        user_id: userIdRaw,
+        special_title: titleRaw
+      },
+      ["setGroupSpecialTitle"]
+    );
+    const message = titleRaw ? `\u7FA4\u4E13\u5C5E\u5934\u8854\u5DF2\u66F4\u65B0\uFF1A${userIdRaw} -> ${titleRaw}` : `\u7FA4\u4E13\u5C5E\u5934\u8854\u5DF2\u6E05\u9664\uFF1A${userIdRaw}`;
+    log?.("info", message);
+    return message;
+  } catch (error) {
+    params.log?.("warn", "set_group_special_title failed", error);
+    return `set_group_special_title failed: ${error.message}`;
+  }
+}
+function createSetGroupSpecialTitleTool(deps) {
+  const { toolName, description, protocol, log } = deps;
+  return new class extends import_tools5.StructuredTool {
+    name = toolName || "set_group_special_title";
+    description = description || DEFAULT_SET_GROUP_SPECIAL_TITLE_TOOL_DESCRIPTION;
+    schema = import_zod5.z.object({
+      groupId: import_zod5.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      userId: import_zod5.z.string().min(1, "userId is required").describe("Target member user ID."),
+      title: import_zod5.z.string().describe("New special title. Use an empty string to clear it.")
+    });
+    async _call(input, _manager, runnable) {
+      const session = getSession(runnable);
+      return sendSetGroupSpecialTitle({
+        session,
+        userId: input.userId,
+        title: input.title,
+        groupId: input.groupId,
+        protocol,
+        log
+      });
+    }
+  }();
+}
+
+// src/features/native-tools/tools/set-msg-emoji.ts
+var import_zod6 = require("zod");
+var import_tools6 = require("@langchain/core/tools");
 async function sendMsgEmoji(params) {
   try {
     const { session, messageId, emojiId, log, protocol } = params;
@@ -1047,12 +1152,12 @@ async function sendMsgEmoji(params) {
 }
 function createSetMsgEmojiTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools4.StructuredTool {
+  return new class extends import_tools6.StructuredTool {
     name = toolName || "set_msg_emoji";
     description = description || DEFAULT_SET_MSG_EMOJI_TOOL_DESCRIPTION;
-    schema = import_zod5.z.object({
-      messageId: import_zod5.z.string().min(1, "message_id is required").describe("Target message ID."),
-      emojiId: import_zod5.z.string().min(1, "emoji_id is required").describe("Emoji ID to send.")
+    schema = import_zod6.z.object({
+      messageId: import_zod6.z.string().min(1, "message_id is required").describe("Target message ID."),
+      emojiId: import_zod6.z.string().min(1, "emoji_id is required").describe("Emoji ID to send.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -1068,8 +1173,8 @@ function createSetMsgEmojiTool(deps) {
 }
 
 // src/features/native-tools/tools/profile.ts
-var import_zod6 = require("zod");
-var import_tools5 = require("@langchain/core/tools");
+var import_zod7 = require("zod");
+var import_tools7 = require("@langchain/core/tools");
 var genders = {
   unknown: "0",
   male: "1",
@@ -1096,13 +1201,13 @@ async function sendSetProfile(params) {
 }
 function createSetProfileTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools5.StructuredTool {
+  return new class extends import_tools7.StructuredTool {
     name = toolName || "set_self_profile";
     description = description || DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION;
-    schema = import_zod6.z.object({
-      nickname: import_zod6.z.string().min(1, "nickname is required").describe("The new nickname for the bot."),
-      signature: import_zod6.z.string().optional().describe("Optional: the new personal signature."),
-      gender: import_zod6.z.enum(["unknown", "male", "female"]).optional().describe("Optional: the new gender.")
+    schema = import_zod7.z.object({
+      nickname: import_zod7.z.string().min(1, "nickname is required").describe("The new nickname for the bot."),
+      signature: import_zod7.z.string().optional().describe("Optional: the new personal signature."),
+      gender: import_zod7.z.enum(["unknown", "male", "female"]).optional().describe("Optional: the new gender.")
     });
     async _call(input, _manager, runnable) {
       return sendSetProfile({
@@ -1117,6 +1222,84 @@ function createSetProfileTool(deps) {
   }();
 }
 
+// src/features/native-tools/tools/set-qq-avatar.ts
+var import_zod8 = require("zod");
+var import_tools8 = require("@langchain/core/tools");
+function isHttpUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+function toBuffer(data) {
+  if (Buffer.isBuffer(data)) return data;
+  if (data instanceof ArrayBuffer) return Buffer.from(data);
+  if (ArrayBuffer.isView(data)) {
+    return Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+  }
+  if (typeof data === "string") return Buffer.from(data);
+  throw new Error("unsupported image response body.");
+}
+async function fetchImageAsOneBotFile(ctx, imageUrl) {
+  if (!isHttpUrl(imageUrl)) return imageUrl;
+  try {
+    const http = ctx?.http;
+    const data = typeof http?.get === "function" ? await http.get(imageUrl, { responseType: "arraybuffer" }) : await fetch(imageUrl).then(async (response) => {
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      return response.arrayBuffer();
+    });
+    return `base64://${toBuffer(data).toString("base64")}`;
+  } catch (error) {
+    throw new Error(`\u65E0\u6CD5\u8BFB\u53D6\u5934\u50CF\u56FE\u7247\uFF1A${error.message}`);
+  }
+}
+function assertOneBotSuccess2(result) {
+  const response = result;
+  if (!response || typeof response !== "object") return;
+  const failed = response.status === "failed" || typeof response.retcode === "number" && response.retcode !== 0;
+  if (!failed) return;
+  const reason = response.wording || response.message || response.status;
+  const retcode = typeof response.retcode === "number" ? ` (retcode: ${response.retcode})` : "";
+  throw new Error(`${reason || "OneBot returned failed"}${retcode}`);
+}
+async function sendSetQQAvatar(params) {
+  const { ctx, session, log } = params;
+  try {
+    const imageUrl = params.imageUrl.trim();
+    if (!imageUrl) return "imageUrl is required.";
+    const { error, internal } = ensureOneBotSession(session);
+    if (error) return error;
+    const file = await fetchImageAsOneBotFile(ctx, imageUrl);
+    const result = await callOneBotAPI(internal, "set_qq_avatar", { file }, [
+      "setQQAvatar"
+    ]);
+    assertOneBotSuccess2(result);
+    const message = "QQ \u5934\u50CF\u5DF2\u66F4\u65B0\u3002";
+    log?.("info", message);
+    return message;
+  } catch (error) {
+    log?.("warn", "set_qq_avatar failed", error);
+    return `set_qq_avatar failed: ${error.message}`;
+  }
+}
+function createSetQQAvatarTool(deps) {
+  const { ctx, toolName, description, log } = deps;
+  return new class extends import_tools8.StructuredTool {
+    name = toolName || "set_qq_avatar";
+    description = description || DEFAULT_SET_QQ_AVATAR_TOOL_DESCRIPTION;
+    schema = import_zod8.z.object({
+      imageUrl: import_zod8.z.string().min(1, "imageUrl is required").describe("Image URL or local file path readable by the OneBot side.")
+    });
+    async _call(input, _manager, runnable) {
+      return sendSetQQAvatar({
+        session: getSession(runnable),
+        imageUrl: input.imageUrl,
+        ctx,
+        log
+      });
+    }
+  }();
+}
+
 // src/features/native-tools/register.ts
 var NATIVE_TOOL_DEFAULT_AVAILABILITY = {
   enabled: true,
@@ -1185,6 +1368,24 @@ function registerNativeTools(deps) {
     });
     log?.("info", `\u8BBE\u7F6E\u8D44\u6599\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
   }
+  if (config.setQQAvatar.enabled) {
+    const toolName = resolveToolName(
+      config.setQQAvatar.toolName,
+      "set_qq_avatar"
+    );
+    const description = resolveToolDescription(
+      config.setQQAvatar.description,
+      DEFAULT_SET_QQ_AVATAR_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      description,
+      createTool: () => createSetQQAvatarTool({ ctx, toolName, description, log }),
+      meta: createNativeToolMeta("onebot", ["profile"])
+    });
+    log?.("info", `QQ \u5934\u50CF\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
   if (config.setGroupCard.enabled) {
     const toolName = resolveToolName(
       config.setGroupCard.toolName,
@@ -1221,6 +1422,29 @@ function registerNativeTools(deps) {
     });
     log?.("info", `\u7FA4\u6210\u5458\u7981\u8A00\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
   }
+  if (config.setGroupSpecialTitle.enabled) {
+    const toolName = resolveToolName(
+      config.setGroupSpecialTitle.toolName,
+      "set_group_special_title"
+    );
+    const description = resolveToolDescription(
+      config.setGroupSpecialTitle.description,
+      DEFAULT_SET_GROUP_SPECIAL_TITLE_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      description,
+      createTool: () => createSetGroupSpecialTitleTool({
+        toolName,
+        description,
+        log,
+        protocol
+      }),
+      meta: createNativeToolMeta("onebot", ["group"])
+    });
+    log?.("info", `\u7FA4\u4E13\u5C5E\u5934\u8854\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
   if (config.setMsgEmoji.enabled) {
     const toolName = resolveToolName(
       config.setMsgEmoji.toolName,
@@ -1478,7 +1702,7 @@ function registerCharacterReplyTools(deps) {
             if (typeof action.message_id !== "string") continue;
             await sendDeleteMessage({
               session,
-              messageId: action.message_id,
+              message_id: action.message_id,
               log
             });
           }
@@ -1578,7 +1802,7 @@ function createXmlProcessor(deps) {
         if (messageIds.length > 0) handled = true;
         for (const messageId of messageIds) {
           try {
-            await runDelete({ session, messageId, log });
+            await runDelete({ session, message_id: messageId, log });
           } catch (error) {
             log?.("warn", "XML \u89E6\u53D1\u64A4\u56DE\u5931\u8D25", error);
           }
@@ -2669,8 +2893,10 @@ function apply(ctx, config) {
   createRandomProvider,
   createSetGroupBanTool,
   createSetGroupCardTool,
+  createSetGroupSpecialTitleTool,
   createSetMsgEmojiTool,
   createSetProfileTool,
+  createSetQQAvatarTool,
   createUserInfoProvider,
   createXmlProcessor,
   ensureOneBotSession,
@@ -2689,5 +2915,7 @@ function apply(ctx, config) {
   sendMsgEmoji,
   sendPoke,
   sendSetGroupCard,
-  sendSetProfile
+  sendSetGroupSpecialTitle,
+  sendSetProfile,
+  sendSetQQAvatar
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-chatluna-toolbox",
   "description": "为 ChatLuna 提供更多原生工具、XML 工具与变量，仅支持 onebot 平台。",
-  "version": "0.0.13",
+  "version": "0.0.16",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
@@ -10,10 +10,10 @@
     "client"
   ],
   "license": "MIT",
-  "homepage": "https://github.com/Sor85/koishi-plugins",
+  "homepage": "https://github.com/Sor85/AAAAACAT-chatluna-plugins",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Sor85/koishi-plugins.git"
+    "url": "https://github.com/Sor85/AAAAACAT-chatluna-plugins.git"
   },
   "keywords": [
     "chatbot",
@@ -54,7 +54,7 @@
   "scripts": {
     "build": "tsup && vite build",
     "watch": "tsup --watch",
-    "typecheck": "NODE_OPTIONS=--max-old-space-size=8192 tsc --noEmit",
+    "typecheck": "NODE_OPTIONS=--max-old-space-size=8192 tsc -p tsconfig.test.json",
     "test": "vitest run"
   }
 }