koishi-plugin-chatluna-toolbox 0.0.7 → 0.0.8

package/lib/index.js

@@ -35,9 +35,11 @@ __export(index_exports, {
   createCharacterTempXmlRuntime: () => createCharacterTempXmlRuntime,
   createDeleteMessageTool: () => createDeleteMessageTool,
   createGroupInfoProvider: () => createGroupInfoProvider,
+  createGroupShutListProvider: () => createGroupShutListProvider,
   createLogger: () => createLogger,
   createPokeTool: () => createPokeTool,
   createRandomProvider: () => createRandomProvider,
+  createSetGroupBanTool: () => createSetGroupBanTool,
   createSetGroupCardTool: () => createSetGroupCardTool,
   createSetMsgEmojiTool: () => createSetMsgEmojiTool,
   createSetProfileTool: () => createSetProfileTool,
@@ -53,6 +55,7 @@ __export(index_exports, {
   registerXmlTools: () => registerXmlTools,
   resolveOneBotProtocol: () => resolveOneBotProtocol,
   sendDeleteMessage: () => sendDeleteMessage,
+  sendGroupBan: () => sendGroupBan,
   sendMsgEmoji: () => sendMsgEmoji,
   sendPoke: () => sendPoke
 });
@@ -75,6 +78,7 @@ var import_koishi2 = require("koishi");
 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_GROUP_CARD_TOOL_DESCRIPTION = "\u4FEE\u6539\u7FA4\u6210\u5458\u7684\u7FA4\u6635\u79F0\u3002";
+var DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION = "\u7981\u8A00\u6307\u5B9A\u7FA4\u6210\u5458\uFF0Cduration=0 \u8868\u793A\u89E3\u9664\u7981\u8A00\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";
 
@@ -86,7 +90,9 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     description: import_koishi2.Schema.string().default(DEFAULT_POKE_TOOL_DESCRIPTION).description("\u5DE5\u5177\u63CF\u8FF0")
   }).description("\u6233\u4E00\u6233\u5DE5\u5177").collapse(),
   setSelfProfile: import_koishi2.Schema.object({
-    enabled: import_koishi2.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F\uFF08\u652F\u6301\u6635\u79F0/\u7B7E\u540D/\u6027\u522B\uFF09"),
+    enabled: import_koishi2.Schema.boolean().default(false).description(
+      "\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F\uFF08\u652F\u6301\u6635\u79F0/\u7B7E\u540D/\u6027\u522B\uFF09"
+    ),
     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(),
@@ -95,6 +101,11 @@ var NativeToolsSchema = 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(),
+  setGroupBan: import_koishi2.Schema.object({
+    enabled: import_koishi2.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u7981\u8A00\u7FA4\u6210\u5458"),
+    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(),
   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"
@@ -125,6 +136,11 @@ var NativeToolsSchema = import_koishi2.Schema.object({
     toolName: "set_group_card",
     description: DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION
   },
+  setGroupBan: {
+    enabled: false,
+    toolName: "set_group_ban",
+    description: DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION
+  },
   setMsgEmoji: {
     enabled: false,
     toolName: "set_msg_emoji",
@@ -157,7 +173,13 @@ var DEFAULT_XML_REFERENCE_PROMPT = `## \u52A8\u4F5C\u6307\u4EE4
     - 66: \u7231\u5FC3
   - \u9002\u7528\u573A\u666F:
     - \u7528\u4E8E\u5BF9\u4E0A\u4E0B\u6587\u4E2D\u7684\u7279\u5B9A\u6D88\u606F\u8FDB\u884C\u8868\u60C5\u56DE\u5E94\u3002
-3. \u64A4\u56DE\u6D88\u606F: <delete message_id=""/>
+3. \u7981\u8A00\u7FA4\u6210\u5458: <ban id="" duration=""/>
+  - 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
+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
@@ -168,6 +190,7 @@ var DEFAULT_XML_REFERENCE_PROMPT = `## \u52A8\u4F5C\u6307\u4EE4
   <actions>
     <poke id="123456"/>
     <emoji message_id="346234" emoji_id="66"/>
+    <ban id="123456" duration="600"/>
     <delete message_id="435663"/>
   </actions>
 \`\`\``;
@@ -176,7 +199,12 @@ var XmlToolsSchema = import_koishi3.Schema.object({
   enableEmojiXmlTool: import_koishi3.Schema.boolean().default(false).description(
     "\u542F\u7528 XML \u5F62\u5F0F\u7684\u6D88\u606F\u8868\u60C5\u8C03\u7528\uFF0C\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u4E0E \u539F\u751F\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF0Cemoji_id \u5BF9\u7167\u8868\uFF1Ahttps://bot.q.qq.com/wiki/develop/pythonsdk/model/emoji.html \uFF09"
   ),
-  enableDeleteXmlTool: import_koishi3.Schema.boolean().default(false).description("\u542F\u7528 XML \u5F62\u5F0F\u7684\u6D88\u606F\u64A4\u56DE\u8C03\u7528\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u4E0E \u539F\u751F\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"),
+  enableDeleteXmlTool: import_koishi3.Schema.boolean().default(false).description(
+    "\u542F\u7528 XML \u5F62\u5F0F\u7684\u6D88\u606F\u64A4\u56DE\u8C03\u7528\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u4E0E \u539F\u751F\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"
+  ),
+  enableBanXmlTool: import_koishi3.Schema.boolean().default(false).description(
+    "\u542F\u7528 XML \u5F62\u5F0F\u7684\u7FA4\u6210\u5458\u7981\u8A00\u8C03\u7528\uFF08\u4E0E \u539F\u751F\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"
+  ),
   referencePrompt: import_koishi3.Schema.string().role("textarea").default(DEFAULT_XML_REFERENCE_PROMPT).description("\u6A21\u578B\u56DE\u590D XML \u53C2\u8003\u63D0\u793A\u8BCD\uFF0C\u81EA\u884C\u5199\u5165\u63D0\u793A\u8BCD\u4E2D\uFF0C\u4E0D\u4F1A\u81EA\u52A8\u6CE8\u5165")
 }).description("XML \u5DE5\u5177");
 
@@ -254,6 +282,9 @@ var VariablesSchema = import_koishi4.Schema.object({
       ])
     ).role("checkbox").default([...DEFAULT_GROUP_INFO_ITEMS]).description("\u663E\u793A\u7684\u7FA4\u4FE1\u606F\u9879")
   }).description("\u7FA4\u4FE1\u606F\u53D8\u91CF").collapse(),
+  groupShutList: import_koishi4.Schema.object({
+    variableName: import_koishi4.Schema.string().default("groupShutList").description("\u53D8\u91CF\u540D\u79F0")
+  }).description("\u7FA4\u7981\u8A00\u5217\u8868\u53D8\u91CF").collapse(),
   random: import_koishi4.Schema.object({
     variableName: import_koishi4.Schema.string().default("random").description("\u53D8\u91CF\u540D\u79F0"),
     min: import_koishi4.Schema.number().default(0).description("\u9ED8\u8BA4\u968F\u673A\u6570\u4E0B\u9650"),
@@ -269,6 +300,7 @@ var VariablesSchema = import_koishi4.Schema.object({
     variableName: "groupInfo",
     items: [...DEFAULT_GROUP_INFO_ITEMS]
   },
+  groupShutList: { variableName: "groupShutList" },
   random: { variableName: "random", min: 0, max: 100 }
 }).description("\u5176\u4ED6\u53D8\u91CF");
 
@@ -457,18 +489,92 @@ function createPokeTool(deps) {
   }();
 }
 
-// src/features/native-tools/tools/set-group-card.ts
+// src/features/native-tools/tools/set-group-ban.ts
 var import_zod3 = require("zod");
 var import_tools2 = require("@langchain/core/tools");
-function createSetGroupCardTool(deps) {
-  const { toolName, description, log } = deps;
+function resolveGroupId(session, groupId) {
+  return groupId?.trim() || (session.guildId || "").trim() || (session.channelId || "").trim() || (session.roomId || "").trim();
+}
+function parseDuration(duration) {
+  const raw = String(duration).trim();
+  if (!raw) return null;
+  if (!/^\d+$/.test(raw)) return null;
+  const parsed = Number(raw);
+  return Number.isSafeInteger(parsed) ? parsed : null;
+}
+async function sendGroupBan(params) {
+  try {
+    const { session, userId, groupId, duration, 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.";
+    }
+    const userIdRaw = userId.trim();
+    if (!userIdRaw) return "userId is required.";
+    const parsedDuration = parseDuration(duration);
+    if (parsedDuration === null) {
+      return "duration must be a non-negative integer in seconds.";
+    }
+    await callOneBotAPI(
+      internal,
+      "set_group_ban",
+      {
+        group_id: resolvedGroupId,
+        user_id: userIdRaw,
+        duration: parsedDuration
+      },
+      ["setGroupBan"]
+    );
+    const success = parsedDuration === 0 ? `\u5DF2\u89E3\u9664\u7FA4 ${resolvedGroupId} \u4E2D\u7528\u6237 ${userIdRaw} \u7684\u7981\u8A00\u3002` : `\u5DF2\u5728\u7FA4 ${resolvedGroupId} \u4E2D\u7981\u8A00\u7528\u6237 ${userIdRaw} ${parsedDuration} \u79D2\u3002`;
+    log?.("info", success);
+    return success;
+  } catch (error) {
+    params.log?.("warn", "set_group_ban failed", error);
+    return `set_group_ban failed: ${error.message}`;
+  }
+}
+function createSetGroupBanTool(deps) {
+  const { toolName, description, protocol, log } = deps;
   return new class extends import_tools2.StructuredTool {
-    name = toolName || "set_group_card";
-    description = description || DEFAULT_SET_GROUP_CARD_TOOL_DESCRIPTION;
+    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."),
-      card: import_zod3.z.string().min(1, "card is required").describe("New group card for the member.")
+      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.")
+    });
+    async _call(input, _manager, runnable) {
+      const session = getSession(runnable);
+      return sendGroupBan({
+        session,
+        userId: input.userId,
+        duration: input.duration,
+        groupId: input.groupId,
+        protocol,
+        log
+      });
+    }
+  }();
+}
+
+// src/features/native-tools/tools/set-group-card.ts
+var import_zod4 = require("zod");
+var import_tools3 = require("@langchain/core/tools");
+function createSetGroupCardTool(deps) {
+  const { toolName, description, log } = deps;
+  return new class extends import_tools3.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.")
     });
     async _call(input, _manager, runnable) {
       try {
@@ -501,8 +607,8 @@ function createSetGroupCardTool(deps) {
 }
 
 // src/features/native-tools/tools/set-msg-emoji.ts
-var import_zod4 = require("zod");
-var import_tools3 = require("@langchain/core/tools");
+var import_zod5 = require("zod");
+var import_tools4 = require("@langchain/core/tools");
 async function sendMsgEmoji(params) {
   try {
     const { session, messageId, emojiId, log, protocol } = params;
@@ -535,12 +641,12 @@ async function sendMsgEmoji(params) {
 }
 function createSetMsgEmojiTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools3.StructuredTool {
+  return new class extends import_tools4.StructuredTool {
     name = toolName || "set_msg_emoji";
     description = description || DEFAULT_SET_MSG_EMOJI_TOOL_DESCRIPTION;
-    schema = import_zod4.z.object({
-      messageId: import_zod4.z.string().min(1, "message_id is required").describe("Target message ID."),
-      emojiId: import_zod4.z.string().min(1, "emoji_id is required").describe("Emoji ID to send.")
+    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.")
     });
     async _call(input, _manager, runnable) {
       const session = getSession(runnable);
@@ -556,8 +662,8 @@ function createSetMsgEmojiTool(deps) {
 }
 
 // src/features/native-tools/tools/profile.ts
-var import_zod5 = require("zod");
-var import_tools4 = require("@langchain/core/tools");
+var import_zod6 = require("zod");
+var import_tools5 = require("@langchain/core/tools");
 var genders = {
   unknown: "0",
   male: "1",
@@ -565,13 +671,13 @@ var genders = {
 };
 function createSetProfileTool(deps) {
   const { toolName, description, log, protocol } = deps;
-  return new class extends import_tools4.StructuredTool {
+  return new class extends import_tools5.StructuredTool {
     name = toolName || "set_self_profile";
     description = description || DEFAULT_SET_SELF_PROFILE_TOOL_DESCRIPTION;
-    schema = import_zod5.z.object({
-      nickname: import_zod5.z.string().min(1, "nickname is required").describe("The new nickname for the bot."),
-      signature: import_zod5.z.string().optional().describe("Optional: the new personal signature."),
-      gender: import_zod5.z.enum(["unknown", "male", "female"]).optional().describe("Optional: the new gender.")
+    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.")
     });
     async _call(input, _manager, runnable) {
       try {
@@ -662,6 +768,22 @@ function registerNativeTools(deps) {
     });
     log?.("info", `\u7FA4\u6635\u79F0\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
   }
+  if (config.setGroupBan.enabled) {
+    const toolName = resolveToolName(
+      config.setGroupBan.toolName,
+      "set_group_ban"
+    );
+    const description = resolveToolDescription(
+      config.setGroupBan.description,
+      DEFAULT_SET_GROUP_BAN_TOOL_DESCRIPTION
+    );
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createSetGroupBanTool({ toolName, description, log, protocol })
+    });
+    log?.("info", `\u7FA4\u6210\u5458\u7981\u8A00\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
   if (config.setMsgEmoji.enabled) {
     const toolName = resolveToolName(
       config.setMsgEmoji.toolName,
@@ -720,14 +842,19 @@ function createXmlProcessor(deps) {
     log,
     sendPoke: runPoke = sendPoke,
     sendMsgEmoji: runEmoji = sendMsgEmoji,
-    sendDeleteMessage: runDelete = sendDeleteMessage
+    sendDeleteMessage: runDelete = sendDeleteMessage,
+    sendGroupBan: runBan = sendGroupBan
   } = deps;
-  return async ({ response, session }) => {
+  return async ({
+    response,
+    session
+  }) => {
     const content = String(response || "").trim();
     if (!content) return false;
     const pokeTags = parseSelfClosingXmlTags(content, "poke");
     const emojiTags = parseSelfClosingXmlTags(content, "emoji");
     const deleteTags = parseSelfClosingXmlTags(content, "delete");
+    const banTags = parseSelfClosingXmlTags(content, "ban");
     let handled = false;
     if (config.enablePokeXmlTool && pokeTags.length > 0) {
       if (!session) {
@@ -783,6 +910,30 @@ function createXmlProcessor(deps) {
         }
       }
     }
+    if (config.enableBanXmlTool && banTags.length > 0) {
+      if (!session) {
+        log?.("warn", "\u68C0\u6D4B\u5230\u7981\u8A00\u6807\u8BB0\u4F46\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587");
+      } else {
+        const items = banTags.map((attrs) => ({
+          userId: String(attrs.id || "").trim(),
+          duration: String(attrs.duration || "").trim()
+        })).filter((item) => item.userId && item.duration);
+        if (items.length > 0) handled = true;
+        for (const item of items) {
+          try {
+            await runBan({
+              session,
+              userId: item.userId,
+              duration: item.duration,
+              protocol,
+              log
+            });
+          } catch (error) {
+            log?.("warn", "XML \u89E6\u53D1\u7981\u8A00\u5931\u8D25", error);
+          }
+        }
+      }
+    }
     return handled;
   };
 }
@@ -1355,6 +1506,113 @@ function createGroupInfoProvider(deps) {
   };
 }
 
+// src/features/variables/providers/group-shut-list.ts
+function normalizeTimestamp2(raw) {
+  if (raw === null || raw === void 0 || raw === "" || Number(raw) === 0)
+    return null;
+  const numeric = Number(raw);
+  if (!Number.isFinite(numeric)) return null;
+  return numeric < 1e11 ? numeric * 1e3 : numeric;
+}
+function formatDateTime2(value) {
+  if (!value) return "\u672A\u77E5";
+  const date = new Date(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) {
+  for (const value of values) {
+    if (value === null || value === void 0) continue;
+    const text = String(value).trim();
+    if (text) return text;
+  }
+  return "";
+}
+function extractList(result) {
+  if (Array.isArray(result)) return result;
+  if (result && typeof result === "object" && Array.isArray(result.data)) {
+    return result.data;
+  }
+  return [];
+}
+function normalizeShutItem(item) {
+  const userId = pickFirst2(
+    item.uin,
+    item.user_id
+  );
+  if (!userId) return null;
+  const cardName = pickFirst2(
+    item.cardName,
+    item.remark,
+    item.nick,
+    item.nickname,
+    userId
+  );
+  const shutUpTimeText = formatDateTime2(
+    normalizeTimestamp2(
+      pickFirst2(
+        item.shutUpTime,
+        item.shut_up_time
+      )
+    )
+  );
+  return {
+    userId,
+    cardName,
+    shutUpTimeText
+  };
+}
+async function fetchGroupShutList(session, config) {
+  const { error, internal } = ensureOneBotSession(session);
+  if (error || !internal)
+    throw new Error(error || "\u7F3A\u5C11 OneBot internal \u63A5\u53E3\u3002");
+  const preferredProtocol = resolveOneBotProtocol(config);
+  const preferredGroupId = preferredProtocol === "llbot" ? String(session.guildId) : Number(session.guildId);
+  const fallbackGroupId = preferredProtocol === "llbot" ? Number(session.guildId) : String(session.guildId);
+  try {
+    const result = await callOneBotAPI(
+      internal,
+      "get_group_shut_list",
+      { group_id: preferredGroupId },
+      ["getGroupShutList"]
+    );
+    return extractList(result);
+  } catch (error2) {
+    if (preferredGroupId === fallbackGroupId) throw error2;
+    const result = await callOneBotAPI(
+      internal,
+      "get_group_shut_list",
+      { group_id: fallbackGroupId },
+      ["getGroupShutList"]
+    );
+    return extractList(result);
+  }
+}
+function renderShutList(items) {
+  if (items.length === 0) return "\u5F53\u524D\u7FA4\u6682\u65E0\u7981\u8A00\u6210\u5458\u3002";
+  return items.map(
+    (item) => `id\uFF1A${item.userId}\uFF0Cname\uFF1A${item.cardName}\uFF0C\u7981\u8A00\u622A\u81F3\uFF1A${item.shutUpTimeText}`
+  ).join("\n");
+}
+function createGroupShutListProvider(deps) {
+  const { config, log } = deps;
+  return async (_args, _variables, configurable) => {
+    const session = configurable?.session;
+    if (!session) return "\u6682\u65E0\u7FA4\u7981\u8A00\u5217\u8868\u3002";
+    if (!session.guildId) return "";
+    if (session.platform !== "onebot")
+      return "\u5F53\u524D\u5E73\u53F0\u6682\u4E0D\u652F\u6301\u67E5\u8BE2\u7FA4\u7981\u8A00\u5217\u8868\u3002";
+    try {
+      const list = await fetchGroupShutList(session, config);
+      const normalized = list.map(normalizeShutItem).filter(Boolean);
+      return renderShutList(normalized);
+    } catch (error) {
+      log?.("debug", "\u7FA4\u7981\u8A00\u5217\u8868\u53D8\u91CF\u89E3\u6790\u5931\u8D25", error);
+      return "\u83B7\u53D6\u7FA4\u7981\u8A00\u5217\u8868\u5931\u8D25\u3002";
+    }
+  };
+}
+
 // src/features/variables/providers/random.ts
 function createRandomProvider(deps) {
   const { config } = deps;
@@ -1379,7 +1637,7 @@ function translateGender2(value) {
   if (["\u672A\u77E5", "unknown", "0", "secret"].includes(text)) return "";
   return String(value);
 }
-function normalizeTimestamp2(raw) {
+function normalizeTimestamp3(raw) {
   if (raw === null || raw === void 0 || raw === "") return null;
   const numeric = Number(raw);
   if (!Number.isFinite(numeric)) return null;
@@ -1391,13 +1649,13 @@ function formatDateOnly3(value) {
   if (Number.isNaN(date.valueOf())) return "";
   return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
 }
-function formatDateTime2(value) {
+function formatDateTime3(value) {
   if (!value) return "";
   const date = new Date(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 pickFirst2(...values) {
+function pickFirst3(...values) {
   for (const value of values) {
     if (value === null || value === void 0) continue;
     const text = String(value).trim();
@@ -1455,7 +1713,7 @@ function renderUserInfo(session, member, items) {
     switch (item) {
       case "nickname": {
         const name2 = String(
-          pickFirst2(
+          pickFirst3(
             member?.card,
             member?.remark,
             member?.displayName,
@@ -1474,7 +1732,7 @@ function renderUserInfo(session, member, items) {
         break;
       case "role": {
         const role = normalizeRole2(
-          pickFirst2(
+          pickFirst3(
             member?.role,
             member?.roleName,
             member?.permission,
@@ -1485,7 +1743,7 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "level": {
-        const level = pickFirst2(
+        const level = pickFirst3(
           member?.level,
           member?.levelName,
           member?.level_name,
@@ -1495,7 +1753,7 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "title": {
-        const title = pickFirst2(
+        const title = pickFirst3(
           member?.title,
           member?.specialTitle,
           member?.special_title
@@ -1514,14 +1772,14 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "area": {
-        const area = pickFirst2(member?.area, member?.region, member?.location);
+        const area = pickFirst3(member?.area, member?.region, member?.location);
         if (area !== null) values.push(`\u5730\u533A:${area}`);
         break;
       }
       case "joinTime": {
         const joinTime = formatDateOnly3(
-          normalizeTimestamp2(
-            pickFirst2(
+          normalizeTimestamp3(
+            pickFirst3(
               member?.join_time,
               member?.joined_at,
               member?.joinTime,
@@ -1533,9 +1791,9 @@ function renderUserInfo(session, member, items) {
         break;
       }
       case "lastSentTime": {
-        const lastSentTime = formatDateTime2(
-          normalizeTimestamp2(
-            pickFirst2(
+        const lastSentTime = formatDateTime3(
+          normalizeTimestamp3(
+            pickFirst3(
               member?.last_sent_time,
               member?.lastSentTime,
               member?.lastSpeakTimestamp
@@ -1591,6 +1849,17 @@ function registerVariables(deps) {
     promptRenderer.registerFunctionProvider(groupInfoName, groupInfoProvider);
     log?.("info", `\u7FA4\u7EC4\u4FE1\u606F\u53D8\u91CF\u5DF2\u6CE8\u518C: ${groupInfoName}`);
   }
+  const groupShutListProvider = createGroupShutListProvider({ config, log });
+  const groupShutListName = String(
+    config.groupShutList?.variableName || "groupShutList"
+  ).trim();
+  if (groupShutListName) {
+    promptRenderer.registerFunctionProvider(
+      groupShutListName,
+      groupShutListProvider
+    );
+    log?.("info", `\u7FA4\u7981\u8A00\u5217\u8868\u53D8\u91CF\u5DF2\u6CE8\u518C: ${groupShutListName}`);
+  }
   const randomProvider = createRandomProvider({ config });
   const randomName = String(config.random?.variableName || "random").trim();
   if (randomName) {
@@ -1626,7 +1895,7 @@ function apply(ctx, config) {
     xmlRuntime?.stop();
     xmlRuntime = null;
   };
-  if (config.enablePokeXmlTool || config.enableEmojiXmlTool || config.enableDeleteXmlTool) {
+  if (config.enablePokeXmlTool || config.enableEmojiXmlTool || config.enableDeleteXmlTool || config.enableBanXmlTool) {
     ctx.inject(["chatluna_character"], (innerCtx) => {
       characterCtx = innerCtx;
       if (!xmlRuntime) return;
@@ -1664,9 +1933,11 @@ function apply(ctx, config) {
   createCharacterTempXmlRuntime,
   createDeleteMessageTool,
   createGroupInfoProvider,
+  createGroupShutListProvider,
   createLogger,
   createPokeTool,
   createRandomProvider,
+  createSetGroupBanTool,
   createSetGroupCardTool,
   createSetMsgEmojiTool,
   createSetProfileTool,
@@ -1682,6 +1953,7 @@ function apply(ctx, config) {
   registerXmlTools,
   resolveOneBotProtocol,
   sendDeleteMessage,
+  sendGroupBan,
   sendMsgEmoji,
   sendPoke
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-chatluna-toolbox",
   "description": "为 ChatLuna 提供更多原生工具、XML 工具与变量。",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [