koishi-plugin-chatluna-toolbox 0.0.18 → 0.0.20

package/README.md

@@ -15,6 +15,8 @@
 - 设置自身资料
 - 设置 QQ 头像
 - 设置群名片
+- 退出群聊
+- 踢出群成员
 - 设置群成员专属头衔
 - 给消息添加表情
 - 撤回消息

package/lib/index.js

@@ -418,11 +418,14 @@ __export(index_exports, {
   createDeleteMessageTool: () => createDeleteMessageTool,
   createGroupInfoProvider: () => createGroupInfoProvider,
   createGroupShutListProvider: () => createGroupShutListProvider,
+  createLeaveGroupTool: () => createLeaveGroupTool,
   createLogger: () => createLogger,
   createPokeTool: () => createPokeTool,
   createRandomProvider: () => createRandomProvider,
+  createSearchGroupMemberTool: () => createSearchGroupMemberTool,
   createSetGroupBanTool: () => createSetGroupBanTool,
   createSetGroupCardTool: () => createSetGroupCardTool,
+  createSetGroupKickTool: () => createSetGroupKickTool,
   createSetGroupSpecialTitleTool: () => createSetGroupSpecialTitleTool,
   createSetMsgEmojiTool: () => createSetMsgEmojiTool,
   createSetProfileTool: () => createSetProfileTool,
@@ -440,8 +443,11 @@ __export(index_exports, {
   registerVariables: () => registerVariables,
   registerXmlTools: () => registerXmlTools,
   resolveOneBotProtocol: () => resolveOneBotProtocol,
+  searchGroupMember: () => searchGroupMember,
   sendDeleteMessage: () => sendDeleteMessage,
   sendGroupBan: () => sendGroupBan,
+  sendGroupKick: () => sendGroupKick,
+  sendLeaveGroup: () => sendLeaveGroup,
   sendMsgEmoji: () => sendMsgEmoji,
   sendPoke: () => sendPoke,
   sendSetGroupCard: () => sendSetGroupCard,
@@ -472,7 +478,10 @@ var DEFAULT_POKE_TOOL_DESCRIPTION = "\u5BF9\u6307\u5B9A\u7528\u6237\u6267\u884C\
 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_SEARCH_GROUP_MEMBER_TOOL_DESCRIPTION = "\u6839\u636E qqid \u7CBE\u786E\u67E5\u8BE2\u7FA4\u6210\u5458\u7684\u7FA4\u6635\u79F0\u4E0E QQ \u6635\u79F0\uFF0C\u6216\u6839\u636E\u7FA4\u6635\u79F0/QQ \u6635\u79F0\u641C\u7D22 qqid\u3002\u9ED8\u8BA4\u67E5\u8BE2\u5F53\u524D\u7FA4\u804A\uFF0C\u53EF\u901A\u8FC7 groupId \u67E5\u8BE2\u6307\u5B9A\u7FA4\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_LEAVE_GROUP_TOOL_DESCRIPTION = "\u8BA9\u673A\u5668\u4EBA\u9000\u51FA\u5F53\u524D\u7FA4\u804A\u3002";
+var DEFAULT_SET_GROUP_KICK_TOOL_DESCRIPTION = "\u5C06\u6307\u5B9A\u6210\u5458\u8E22\u51FA\u7FA4\u804A\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";
@@ -484,7 +493,10 @@ var EnabledNativeToolsSchema = import_koishi2.Schema.array(
     import_koishi2.Schema.const("setSelfProfile").description("\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F"),
     import_koishi2.Schema.const("setQQAvatar").description("\u4FEE\u6539 QQ \u5934\u50CF"),
     import_koishi2.Schema.const("setGroupCard").description("\u4FEE\u6539\u7FA4\u6210\u5458\u6635\u79F0"),
+    import_koishi2.Schema.const("searchGroupMember").description("\u641C\u7D22\u7FA4\u6210\u5458"),
     import_koishi2.Schema.const("setGroupBan").description("\u7981\u8A00\u7FA4\u6210\u5458"),
+    import_koishi2.Schema.const("leaveGroup").description("\u9000\u7FA4"),
+    import_koishi2.Schema.const("setGroupKick").description("\u8E22\u51FA\u7FA4\u6210\u5458"),
     import_koishi2.Schema.const("setGroupSpecialTitle").description("\u4FEE\u6539\u7FA4\u6210\u5458\u4E13\u5C5E\u5934\u8854"),
     import_koishi2.Schema.const("setMsgEmoji").description("\u6D88\u606F\u8868\u60C5"),
     import_koishi2.Schema.const("deleteMessage").description("\u64A4\u56DE\u6D88\u606F")
@@ -513,11 +525,26 @@ var NativeToolAdvancedSettingsSchema = import_koishi2.Schema.object({
     toolName: import_koishi2.Schema.string().default("set_group_card").description("\u5DE5\u5177\u540D\u79F0"),
     description: import_koishi2.Schema.string().default(DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
   }).description("\u4FEE\u6539\u7FA4\u6210\u5458\u6635\u79F0\u5DE5\u5177").collapse(),
+  searchGroupMember: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).hidden(),
+    toolName: import_koishi2.Schema.string().default("search_group_member").description("\u5DE5\u5177\u540D\u79F0"),
+    description: import_koishi2.Schema.string().default(DEFAULT_SEARCH_GROUP_MEMBER_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
+  }).description("\u641C\u7D22\u7FA4\u6210\u5458\u5DE5\u5177").collapse(),
   setGroupBan: import_koishi2.Schema.object({
     enabled: import_koishi2.Schema.boolean().default(false).hidden(),
     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(),
+  leaveGroup: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).hidden(),
+    toolName: import_koishi2.Schema.string().default("set_group_leave").description("\u5DE5\u5177\u540D\u79F0"),
+    description: import_koishi2.Schema.string().default(DEFAULT_LEAVE_GROUP_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
+  }).description("\u9000\u7FA4\u5DE5\u5177").collapse(),
+  setGroupKick: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).hidden(),
+    toolName: import_koishi2.Schema.string().default("set_group_kick").description("\u5DE5\u5177\u540D\u79F0"),
+    description: import_koishi2.Schema.string().default(DEFAULT_SET_GROUP_KICK_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
+  }).description("\u8E22\u51FA\u7FA4\u6210\u5458\u5DE5\u5177").collapse(),
   setGroupSpecialTitle: import_koishi2.Schema.object({
     enabled: import_koishi2.Schema.boolean().default(false).hidden(),
     toolName: import_koishi2.Schema.string().default("set_group_special_title").description("\u5DE5\u5177\u540D\u79F0"),
@@ -835,9 +862,60 @@ function createDeleteMessageTool(deps) {
   }();
 }
 
-// src/features/native-tools/tools/poke.ts
+// src/features/native-tools/tools/leave-group.ts
 var import_zod2 = require("zod");
 var import_tools2 = require("@langchain/core/tools");
+function resolveGroupId(session, groupId) {
+  return groupId?.trim() || (session.guildId ? String(session.guildId).trim() : "") || (session.channelId ? String(session.channelId).trim() : "");
+}
+async function sendLeaveGroup(params) {
+  try {
+    const { session, groupId, log } = params;
+    const {
+      error,
+      internal,
+      session: validatedSession
+    } = ensureOneBotSession(session);
+    if (error) return error;
+    const resolvedGroupId = resolveGroupId(validatedSession, groupId);
+    if (!resolvedGroupId) {
+      return "Missing groupId. Provide groupId explicitly or run inside a group session.";
+    }
+    await callOneBotAPI(
+      internal,
+      "set_group_leave",
+      { group_id: resolvedGroupId },
+      ["setGroupLeave"]
+    );
+    const message = `\u5DF2\u9000\u51FA\u7FA4 ${resolvedGroupId}\u3002`;
+    log?.("info", message);
+    return message;
+  } catch (error) {
+    params.log?.("warn", "set_group_leave failed", error);
+    return `set_group_leave failed: ${error.message}`;
+  }
+}
+function createLeaveGroupTool(deps) {
+  const { toolName, description, log } = deps;
+  return new class extends import_tools2.StructuredTool {
+    name = toolName || "set_group_leave";
+    description = description || DEFAULT_LEAVE_GROUP_TOOL_DESCRIPTION;
+    schema = import_zod2.z.object({
+      groupId: import_zod2.z.string().optional().describe("Target group ID. Defaults to current session group.")
+    });
+    async _call(input, _manager, runnable) {
+      return sendLeaveGroup({
+        session: getSession(runnable),
+        groupId: input.groupId,
+        log
+      });
+    }
+  }();
+}
+
+// src/features/native-tools/tools/poke.ts
+var import_zod3 = require("zod");
+var import_tools3 = require("@langchain/core/tools");
 async function sendPoke(params) {
   try {
     const { session, userId, groupId, log, protocol } = params;
@@ -884,12 +962,12 @@ async function sendPoke(params) {
 }
 function createPokeTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools2.StructuredTool {
+  return new class extends import_tools3.StructuredTool {
     name = toolName || "poke_user";
     description = description || DEFAULT_POKE_TOOL_DESCRIPTION;
-    schema = import_zod2.z.object({
-      userId: import_zod2.z.string().min(1, "userId is required").describe("The user ID to poke."),
-      groupId: import_zod2.z.string().optional().describe("Optional: specify a different group ID.")
+    schema = import_zod3.z.object({
+      userId: import_zod3.z.string().min(1, "userId is required").describe("The user ID to poke."),
+      groupId: import_zod3.z.string().optional().describe("Optional: specify a different group ID.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -904,10 +982,135 @@ function createPokeTool(deps) {
   }();
 }
 
+// src/features/native-tools/tools/search-group-member.ts
+var import_zod4 = require("zod");
+var import_tools4 = require("@langchain/core/tools");
+var MAX_RESULTS = 10;
+function pickFirst(...values) {
+  for (const value of values) {
+    if (value === null || value === void 0) continue;
+    const text = String(value).trim();
+    if (text) return text;
+  }
+  return "";
+}
+function resolveGroupId2(session, groupId) {
+  return groupId?.trim() || session.guildId?.trim() || (session.event?.guild?.id || "");
+}
+function normalizeId(value) {
+  return /^\d+$/.test(value) ? Number(value) : value;
+}
+function getUserId(member) {
+  return pickFirst(
+    member.user_id,
+    member.userId,
+    member.id,
+    member.qq,
+    member.uid
+  );
+}
+function getGroupCard(member) {
+  return pickFirst(member.card, member.remark, member.displayName);
+}
+function getNickname(member) {
+  return pickFirst(
+    member.nick,
+    member.nickname,
+    member.name,
+    member.user?.nickname,
+    member.user?.name
+  );
+}
+function matchByName(member, query) {
+  const keyword = query.toLowerCase();
+  return [getGroupCard(member), getNickname(member)].filter(Boolean).some((value) => value.toLowerCase().includes(keyword));
+}
+async function fetchGroupMembers(session, groupId) {
+  const internal = session.bot.internal;
+  if (!internal) return [];
+  if (typeof internal.getGroupMemberList === "function") {
+    const result = await internal.getGroupMemberList(normalizeId(groupId));
+    return Array.isArray(result) ? result : [];
+  }
+  if (typeof internal._request === "function") {
+    const result = await internal._request("get_group_member_list", {
+      group_id: normalizeId(groupId)
+    });
+    if (Array.isArray(result)) return result;
+    const data = result?.data;
+    return Array.isArray(data) ? data : [];
+  }
+  throw new Error("\u5F53\u524D OneBot \u9002\u914D\u5668\u4E0D\u652F\u6301 get_group_member_list \u63A5\u53E3\u3002");
+}
+function formatMember(index, member) {
+  const userId = getUserId(member) || "\u672A\u77E5";
+  const groupCard = getGroupCard(member) || "\u65E0";
+  const nickname = getNickname(member) || "\u65E0";
+  return `${index}. qqid\uFF1A${userId}\uFF0C\u7FA4\u6635\u79F0\uFF1A${groupCard}\uFF0CQQ\u6635\u79F0\uFF1A${nickname}`;
+}
+async function searchGroupMember(params) {
+  try {
+    const { session, query, groupId, log } = params;
+    const mode = params.mode || "auto";
+    if (!["auto", "byName", "byQQ"].includes(mode)) {
+      return "mode must be auto, byName, or byQQ.";
+    }
+    const queryText = query.trim();
+    if (!queryText) return "query is required.";
+    const {
+      error,
+      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 members = await fetchGroupMembers(validatedSession, resolvedGroupId);
+    const shouldSearchQQ = mode === "byQQ" || mode === "auto" && /^\d+$/.test(queryText);
+    const matches = members.filter(
+      (member) => shouldSearchQQ ? getUserId(member) === queryText : matchByName(member, queryText)
+    );
+    if (matches.length === 0) return "\u672A\u627E\u5230\u5339\u914D\u7684\u7FA4\u6210\u5458\u3002";
+    const visibleMatches = matches.slice(0, MAX_RESULTS);
+    const header = matches.length > MAX_RESULTS ? `\u4EC5\u663E\u793A\u524D ${MAX_RESULTS} \u6761\uFF0C\u5171 ${matches.length} \u6761\u5339\u914D\uFF1A` : `\u627E\u5230 ${matches.length} \u4E2A\u5339\u914D\u6210\u5458\uFF1A`;
+    const message = [
+      header,
+      ...visibleMatches.map((member, index) => formatMember(index + 1, member))
+    ].join("\n");
+    log?.("info", `\u7FA4 ${resolvedGroupId} \u6210\u5458\u641C\u7D22\u5B8C\u6210\uFF1A${matches.length} \u6761\u5339\u914D`);
+    return message;
+  } catch (error) {
+    params.log?.("warn", "search_group_member failed", error);
+    return `search_group_member failed: ${error.message}`;
+  }
+}
+function createSearchGroupMemberTool(deps) {
+  const { toolName, description, log } = deps;
+  return new class extends import_tools4.StructuredTool {
+    name = toolName || "search_group_member";
+    description = description || DEFAULT_SEARCH_GROUP_MEMBER_TOOL_DESCRIPTION;
+    schema = import_zod4.z.object({
+      groupId: import_zod4.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      query: import_zod4.z.string().min(1, "query is required").describe("qqid, group card, or QQ nickname to search."),
+      mode: import_zod4.z.enum(["auto", "byName", "byQQ"]).optional().describe("Search mode. Defaults to auto.")
+    });
+    async _call(input, _manager, runnable) {
+      return searchGroupMember({
+        session: getSession(runnable),
+        groupId: input.groupId,
+        query: input.query,
+        mode: input.mode,
+        log
+      });
+    }
+  }();
+}
+
 // src/features/native-tools/tools/set-group-ban.ts
-var import_zod3 = require("zod");
-var import_tools3 = require("@langchain/core/tools");
-function resolveGroupId(session, groupId) {
+var import_zod5 = require("zod");
+var import_tools5 = require("@langchain/core/tools");
+function resolveGroupId3(session, groupId) {
   return groupId?.trim() || (session.guildId || "").trim() || (session.channelId || "").trim() || (session.roomId || "").trim();
 }
 function parseDuration(duration) {
@@ -926,7 +1129,7 @@ async function sendGroupBan(params) {
       session: validatedSession
     } = ensureOneBotSession(session);
     if (error) return error;
-    const resolvedGroupId = resolveGroupId(validatedSession, groupId);
+    const resolvedGroupId = resolveGroupId3(validatedSession, groupId);
     if (!resolvedGroupId) {
       return "Missing groupId. Provide groupId explicitly or run inside a group session.";
     }
@@ -956,13 +1159,13 @@ async function sendGroupBan(params) {
 }
 function createSetGroupBanTool(deps) {
   const { toolName, description, protocol, log } = deps;
-  return new class extends import_tools3.StructuredTool {
+  return new class extends import_tools5.StructuredTool {
     name = toolName || "set_group_ban";
     description = description || DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION;
-    schema = import_zod3.z.object({
-      groupId: import_zod3.z.string().optional().describe("Target group ID. Defaults to current session group."),
-      userId: import_zod3.z.string().min(1, "userId is required").describe("Target member user ID."),
-      duration: import_zod3.z.union([import_zod3.z.string(), import_zod3.z.number().int().min(0)]).describe("Mute duration in seconds. Use 0 to unmute.")
+    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."),
+      duration: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.number().int().min(0)]).describe("Mute duration in seconds. Use 0 to unmute.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -979,8 +1182,8 @@ function createSetGroupBanTool(deps) {
 }
 
 // src/features/native-tools/tools/set-group-card.ts
-var import_zod4 = require("zod");
-var import_tools4 = require("@langchain/core/tools");
+var import_zod6 = require("zod");
+var import_tools6 = require("@langchain/core/tools");
 async function sendSetGroupCard(params) {
   try {
     const { session, userId, card, groupId, log } = params;
@@ -1011,13 +1214,13 @@ async function sendSetGroupCard(params) {
 }
 function createSetGroupCardTool(deps) {
   const { toolName, description, log } = deps;
-  return new class extends import_tools4.StructuredTool {
+  return new class extends import_tools6.StructuredTool {
     name = toolName || "set_group_card";
     description = description || DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION;
-    schema = import_zod4.z.object({
-      groupId: import_zod4.z.string().optional().describe("Target group ID. Defaults to current session group."),
-      userId: import_zod4.z.string().min(1, "userId is required").describe("Target member user ID."),
-      card: import_zod4.z.string().min(1, "card is required").describe("New group card for the member.")
+    schema = import_zod6.z.object({
+      groupId: import_zod6.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      userId: import_zod6.z.string().min(1, "userId is required").describe("Target member user ID."),
+      card: import_zod6.z.string().min(1, "card is required").describe("New group card for the member.")
     });
     async _call(input, _manager, runnable) {
       return sendSetGroupCard({
@@ -1031,10 +1234,65 @@ function createSetGroupCardTool(deps) {
   }();
 }
 
+// src/features/native-tools/tools/set-group-kick.ts
+var import_zod7 = require("zod");
+var import_tools7 = require("@langchain/core/tools");
+function resolveGroupId4(session, groupId) {
+  return groupId?.trim() || (session.guildId ? String(session.guildId).trim() : "") || (session.channelId ? String(session.channelId).trim() : "");
+}
+async function sendGroupKick(params) {
+  try {
+    const { session, userId, groupId, log } = params;
+    const {
+      error,
+      internal,
+      session: validatedSession
+    } = ensureOneBotSession(session);
+    if (error) return error;
+    const resolvedGroupId = resolveGroupId4(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.";
+    await callOneBotAPI(
+      internal,
+      "set_group_kick",
+      { group_id: resolvedGroupId, user_id: userIdRaw },
+      ["setGroupKick"]
+    );
+    const message = `\u5DF2\u5C06\u7528\u6237 ${userIdRaw} \u79FB\u51FA\u7FA4 ${resolvedGroupId}\u3002`;
+    log?.("info", message);
+    return message;
+  } catch (error) {
+    params.log?.("warn", "set_group_kick failed", error);
+    return `set_group_kick failed: ${error.message}`;
+  }
+}
+function createSetGroupKickTool(deps) {
+  const { toolName, description, log } = deps;
+  return new class extends import_tools7.StructuredTool {
+    name = toolName || "set_group_kick";
+    description = description || DEFAULT_SET_GROUP_KICK_TOOL_DESCRIPTION;
+    schema = import_zod7.z.object({
+      groupId: import_zod7.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      userId: import_zod7.z.string().min(1, "userId is required").describe("Target member user ID.")
+    });
+    async _call(input, _manager, runnable) {
+      return sendGroupKick({
+        session: getSession(runnable),
+        groupId: input.groupId,
+        userId: input.userId,
+        log
+      });
+    }
+  }();
+}
+
 // src/features/native-tools/tools/set-group-special-title.ts
-var import_zod5 = require("zod");
-var import_tools5 = require("@langchain/core/tools");
-function resolveGroupId2(session, groupId) {
+var import_zod8 = require("zod");
+var import_tools8 = require("@langchain/core/tools");
+function resolveGroupId5(session, groupId) {
   return groupId?.trim() || (session.guildId || "").trim() || (session.channelId || "").trim() || (session.roomId || "").trim();
 }
 async function sendSetGroupSpecialTitle(params) {
@@ -1046,7 +1304,7 @@ async function sendSetGroupSpecialTitle(params) {
       session: validatedSession
     } = ensureOneBotSession(session);
     if (error) return error;
-    const resolvedGroupId = resolveGroupId2(validatedSession, groupId);
+    const resolvedGroupId = resolveGroupId5(validatedSession, groupId);
     if (!resolvedGroupId) {
       return "Missing groupId. Provide groupId explicitly or run inside a group session.";
     }
@@ -1073,13 +1331,13 @@ async function sendSetGroupSpecialTitle(params) {
 }
 function createSetGroupSpecialTitleTool(deps) {
   const { toolName, description, protocol, log } = deps;
-  return new class extends import_tools5.StructuredTool {
+  return new class extends import_tools8.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.")
+    schema = import_zod8.z.object({
+      groupId: import_zod8.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      userId: import_zod8.z.string().min(1, "userId is required").describe("Target member user ID."),
+      title: import_zod8.z.string().describe("New special title. Use an empty string to clear it.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -1096,8 +1354,8 @@ function createSetGroupSpecialTitleTool(deps) {
 }
 
 // src/features/native-tools/tools/set-msg-emoji.ts
-var import_zod6 = require("zod");
-var import_tools6 = require("@langchain/core/tools");
+var import_zod9 = require("zod");
+var import_tools9 = require("@langchain/core/tools");
 async function sendMsgEmoji(params) {
   try {
     const { session, messageId, emojiId, log, protocol } = params;
@@ -1128,12 +1386,12 @@ async function sendMsgEmoji(params) {
 }
 function createSetMsgEmojiTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools6.StructuredTool {
+  return new class extends import_tools9.StructuredTool {
     name = toolName || "set_msg_emoji";
     description = description || DEFAULT_SET_MSG_EMOJI_TOOL_DESCRIPTION;
-    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.")
+    schema = import_zod9.z.object({
+      messageId: import_zod9.z.string().min(1, "message_id is required").describe("Target message ID."),
+      emojiId: import_zod9.z.string().min(1, "emoji_id is required").describe("Emoji ID to send.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -1149,8 +1407,8 @@ function createSetMsgEmojiTool(deps) {
 }
 
 // src/features/native-tools/tools/profile.ts
-var import_zod7 = require("zod");
-var import_tools7 = require("@langchain/core/tools");
+var import_zod10 = require("zod");
+var import_tools10 = require("@langchain/core/tools");
 var genders = {
   unknown: "0",
   male: "1",
@@ -1177,13 +1435,13 @@ async function sendSetProfile(params) {
 }
 function createSetProfileTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools7.StructuredTool {
+  return new class extends import_tools10.StructuredTool {
     name = toolName || "set_self_profile";
     description = description || DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION;
-    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.")
+    schema = import_zod10.z.object({
+      nickname: import_zod10.z.string().min(1, "nickname is required").describe("The new nickname for the bot."),
+      signature: import_zod10.z.string().optional().describe("Optional: the new personal signature."),
+      gender: import_zod10.z.enum(["unknown", "male", "female"]).optional().describe("Optional: the new gender.")
     });
     async _call(input, _manager, runnable) {
       return sendSetProfile({
@@ -1199,8 +1457,8 @@ function createSetProfileTool(deps) {
 }
 
 // src/features/native-tools/tools/set-qq-avatar.ts
-var import_zod8 = require("zod");
-var import_tools8 = require("@langchain/core/tools");
+var import_zod11 = require("zod");
+var import_tools11 = require("@langchain/core/tools");
 function isHttpUrl(value) {
   return /^https?:\/\//i.test(value);
 }
@@ -1259,11 +1517,11 @@ async function sendSetQQAvatar(params) {
 }
 function createSetQQAvatarTool(deps) {
   const { ctx, toolName, description, log } = deps;
-  return new class extends import_tools8.StructuredTool {
+  return new class extends import_tools11.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.")
+    schema = import_zod11.z.object({
+      imageUrl: import_zod11.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({
@@ -1379,6 +1637,24 @@ function registerNativeTools(deps) {
     });
     log?.("info", `\u7FA4\u6635\u79F0\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
   }
+  if (isNativeToolEnabled(config, "searchGroupMember")) {
+    const toolName = resolveToolName(
+      config.searchGroupMember.toolName,
+      "search_group_member"
+    );
+    const description = resolveToolDescription(
+      config.searchGroupMember.description,
+      DEFAULT_SEARCH_GROUP_MEMBER_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      description,
+      createTool: () => createSearchGroupMemberTool({ toolName, description, log }),
+      meta: createNativeToolMeta("onebot", ["group"])
+    });
+    log?.("info", `\u7FA4\u6210\u5458\u641C\u7D22\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
   if (isNativeToolEnabled(config, "setGroupBan")) {
     const toolName = resolveToolName(
       config.setGroupBan.toolName,
@@ -1397,6 +1673,42 @@ function registerNativeTools(deps) {
     });
     log?.("info", `\u7FA4\u6210\u5458\u7981\u8A00\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
   }
+  if (isNativeToolEnabled(config, "leaveGroup")) {
+    const toolName = resolveToolName(
+      config.leaveGroup.toolName,
+      "set_group_leave"
+    );
+    const description = resolveToolDescription(
+      config.leaveGroup.description,
+      DEFAULT_LEAVE_GROUP_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      description,
+      createTool: () => createLeaveGroupTool({ toolName, description, log }),
+      meta: createNativeToolMeta("onebot", ["group"])
+    });
+    log?.("info", `\u9000\u7FA4\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+  if (isNativeToolEnabled(config, "setGroupKick")) {
+    const toolName = resolveToolName(
+      config.setGroupKick.toolName,
+      "set_group_kick"
+    );
+    const description = resolveToolDescription(
+      config.setGroupKick.description,
+      DEFAULT_SET_GROUP_KICK_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      description,
+      createTool: () => createSetGroupKickTool({ toolName, description, log }),
+      meta: createNativeToolMeta("onebot", ["group"])
+    });
+    log?.("info", `\u8E22\u51FA\u7FA4\u6210\u5458\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
   if (isNativeToolEnabled(config, "setGroupSpecialTitle")) {
     const toolName = resolveToolName(
       config.setGroupSpecialTitle.toolName,
@@ -1849,7 +2161,7 @@ function registerXmlTools(deps) {
 }
 
 // src/features/variables/providers/bot-info.ts
-function pickFirst(...values) {
+function pickFirst2(...values) {
   for (const value of values) {
     if (value === null || value === void 0) continue;
     const text = String(value).trim();
@@ -1936,7 +2248,7 @@ function renderBotInfo(session, member, items) {
     switch (item) {
       case "nickname": {
         const name2 = String(
-          pickFirst(
+          pickFirst2(
             member?.card,
             member?.remark,
             member?.displayName,
@@ -1954,7 +2266,7 @@ function renderBotInfo(session, member, items) {
         break;
       case "role": {
         const role = normalizeRole(
-          pickFirst(
+          pickFirst2(
             member?.role,
             member?.roleName,
             member?.permission,
@@ -1965,7 +2277,7 @@ function renderBotInfo(session, member, items) {
         break;
       }
       case "level": {
-        const level = pickFirst(
+        const level = pickFirst2(
           member?.level,
           member?.levelName,
           member?.level_name,
@@ -1975,7 +2287,7 @@ function renderBotInfo(session, member, items) {
         break;
       }
       case "title": {
-        const title = pickFirst(
+        const title = pickFirst2(
           member?.title,
           member?.specialTitle,
           member?.special_title
@@ -1994,14 +2306,14 @@ function renderBotInfo(session, member, items) {
         break;
       }
       case "area": {
-        const area = pickFirst(member?.area, member?.region, member?.location);
+        const area = pickFirst2(member?.area, member?.region, member?.location);
         if (area !== null) values.push(`\u5730\u533A:${area}`);
         break;
       }
       case "joinTime": {
         const joinTime = formatDateOnly(
           normalizeTimestamp(
-            pickFirst(
+            pickFirst2(
               member?.join_time,
               member?.joined_at,
               member?.joinTime,
@@ -2015,7 +2327,7 @@ function renderBotInfo(session, member, items) {
       case "lastSentTime": {
         const lastSentTime = formatDateTime(
           normalizeTimestamp(
-            pickFirst(
+            pickFirst2(
               member?.last_sent_time,
               member?.lastSentTime,
               member?.lastSpeakTimestamp
@@ -2212,7 +2524,7 @@ function formatDateTime2(value) {
   if (Number.isNaN(date.valueOf())) return "\u672A\u77E5";
   return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
 }
-function pickFirst2(...values) {
+function pickFirst3(...values) {
   for (const value of values) {
     if (value === null || value === void 0) continue;
     const text = String(value).trim();
@@ -2221,12 +2533,12 @@ function pickFirst2(...values) {
   return "";
 }
 function normalizeShutItem(item) {
-  const userId = pickFirst2(
+  const userId = pickFirst3(
     item.uin,
     item.user_id
   );
   if (!userId) return null;
-  const cardName = pickFirst2(
+  const cardName = pickFirst3(
     item.cardName,
     item.remark,
     item.nick,
@@ -2235,7 +2547,7 @@ function normalizeShutItem(item) {
   );
   const shutUpTimeText = formatDateTime2(
     normalizeTimestamp2(
-      pickFirst2(
+      pickFirst3(
         item.shutUpTime,
         item.shut_up_time
       )
@@ -2564,7 +2876,7 @@ function formatDateTime3(value) {
   if (Number.isNaN(date.valueOf())) return "";
   return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
 }
-function pickFirst3(...values) {
+function pickFirst4(...values) {
   for (const value of values) {
     if (value === null || value === void 0) continue;
     const text = String(value).trim();
@@ -2622,7 +2934,7 @@ function renderUserInfo(session, member, items) {
     switch (item) {
       case "nickname": {
         const name2 = String(
-          pickFirst3(
+          pickFirst4(
             member?.card,
             member?.remark,
             member?.displayName,
@@ -2641,7 +2953,7 @@ function renderUserInfo(session, member, items) {
         break;
       case "role": {
         const role = normalizeRole2(
-          pickFirst3(
+          pickFirst4(
             member?.role,
             member?.roleName,
             member?.permission,
@@ -2652,7 +2964,7 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "level": {
-        const level = pickFirst3(
+        const level = pickFirst4(
           member?.level,
           member?.levelName,
           member?.level_name,
@@ -2662,7 +2974,7 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "title": {
-        const title = pickFirst3(
+        const title = pickFirst4(
           member?.title,
           member?.specialTitle,
           member?.special_title
@@ -2681,14 +2993,14 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "area": {
-        const area = pickFirst3(member?.area, member?.region, member?.location);
+        const area = pickFirst4(member?.area, member?.region, member?.location);
         if (area !== null) values.push(`\u5730\u533A:${area}`);
         break;
       }
       case "joinTime": {
         const joinTime = formatDateOnly3(
           normalizeTimestamp3(
-            pickFirst3(
+            pickFirst4(
               member?.join_time,
               member?.joined_at,
               member?.joinTime,
@@ -2702,7 +3014,7 @@ function renderUserInfo(session, member, items) {
       case "lastSentTime": {
         const lastSentTime = formatDateTime3(
           normalizeTimestamp3(
-            pickFirst3(
+            pickFirst4(
               member?.last_sent_time,
               member?.lastSentTime,
               member?.lastSpeakTimestamp
@@ -2872,11 +3184,14 @@ Character XML \u5DE5\u5177\u4EC5\u4F9B [koishi-plugin-chatluna-character](https:
   createDeleteMessageTool,
   createGroupInfoProvider,
   createGroupShutListProvider,
+  createLeaveGroupTool,
   createLogger,
   createPokeTool,
   createRandomProvider,
+  createSearchGroupMemberTool,
   createSetGroupBanTool,
   createSetGroupCardTool,
+  createSetGroupKickTool,
   createSetGroupSpecialTitleTool,
   createSetMsgEmojiTool,
   createSetProfileTool,
@@ -2894,8 +3209,11 @@ Character XML \u5DE5\u5177\u4EC5\u4F9B [koishi-plugin-chatluna-character](https:
   registerVariables,
   registerXmlTools,
   resolveOneBotProtocol,
+  searchGroupMember,
   sendDeleteMessage,
   sendGroupBan,
+  sendGroupKick,
+  sendLeaveGroup,
   sendMsgEmoji,
   sendPoke,
   sendSetGroupCard,

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "koishi-plugin-chatluna-toolbox",
   "description": "为 ChatLuna 提供更多原生工具、Character XML 工具与变量，仅支持 onebot 平台。",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
     "lib",
-    "dist",
-    "client"
+    "dist"
   ],
   "license": "MIT",
   "homepage": "https://github.com/Sor85/AAAAACAT-chatluna-plugins",

package/client/ToolboxDetailsLoader.vue

@@ -1,20 +0,0 @@
-<!--
-  Toolbox 详情加载器
-  根据当前插件名称决定是否显示共享导航组件
--->
-<template>
-  <SharedNav v-if="isOwn" :sections="navSections" />
-</template>
-
-<script setup lang="ts">
-import { ComputedRef, computed, inject } from "vue";
-import { SharedNav } from "shared-nav";
-import { NAV_SECTIONS, PLUGIN_CANDIDATE_NAMES } from "./constants";
-
-const pluginName = inject<ComputedRef<string>>("plugin:name");
-const navSections = NAV_SECTIONS;
-const isOwn = computed(() => {
-  const name = pluginName?.value || "";
-  return PLUGIN_CANDIDATE_NAMES.includes(name);
-});
-</script>

package/client/constants.ts

@@ -1,19 +0,0 @@
-/**
- * 前端常量定义
- * 包含导航分组和插件候选名称
- */
-
-import type { SharedNavSection } from "shared-nav";
-
-export const NAV_SECTIONS: SharedNavSection[] = [
-  { title: "基础设置", key: "basic" },
-  { title: "原生工具", key: "nativeTools" },
-  { title: "Character XML 工具", key: "xmlTools" },
-  { title: "变量", key: "variables" },
-  { title: "其他设置", key: "other" },
-];
-
-export const PLUGIN_CANDIDATE_NAMES = [
-  "chatluna-toolbox",
-  "koishi-plugin-chatluna-toolbox",
-];

package/client/index.ts

@@ -1,15 +0,0 @@
-/**
- * 前端入口
- * 注册 Koishi 控制台插件详情扩展
- */
-
-import { Context } from "@koishijs/client";
-import ToolboxDetailsLoader from "./ToolboxDetailsLoader.vue";
-
-export default (ctx: Context) => {
-  ctx.slot({
-    type: "plugin-details",
-    component: ToolboxDetailsLoader,
-    order: -999,
-  });
-};