@zhin.js/adapter-icqq 1.0.71 → 1.1.0

package/tools/essence.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ message_id: string; action: 'add' | 'remove' }>({
+  description: '设置或移除 QQ 群精华消息',
+  inputSchema: z.object({
+    message_id: z.string().describe('消息 ID'),
+    action: z.enum(['add', 'remove']).describe('add=设为精华, remove=移除精华'),
+  }),
+  adapter: 'icqq',
+  approval: 'always',
+  async execute({ message_id, action }, context) {
+    const client = context.$client;
+    if (action === 'add') {
+      await client.setEssenceMessage(message_id);
+    } else {
+      await client.removeEssenceMessage(message_id);
+    }
+    return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
+  },
+});

package/tools/friend_list.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取 QQ 好友列表',
+    inputSchema: z.object({}),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute(_input, context) {
+        const client = context.$client;
+        const friends = Array.from(client.fl.values()).map((friend) => ({
+            user_id: friend.user_id,
+            nickname: friend.nickname,
+            remark: friend.remark,
+        }));
+        return { friends: friends.slice(0, 50), count: client.fl.size };
+    },
+});

package/tools/friend_list.ts

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<Record<string, never>>({
+  description: '获取 QQ 好友列表',
+  inputSchema: z.object({}),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute(_input, context) {
+    const client = context.$client;
+    const friends = Array.from(client.fl.values()).map((friend) => ({
+      user_id: friend.user_id,
+      nickname: friend.nickname,
+      remark: friend.remark,
+    }));
+    return { friends: friends.slice(0, 50), count: client.fl.size };
+  },
+});

package/tools/group_files.js

@@ -0,0 +1,22 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取 QQ 群的群文件列表',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ group_id }, context) {
+        const files = await context.$client.acquireGfs(group_id).ls('/');
+        if (!files.length)
+            return { files: [], message: '群文件为空' };
+        return {
+            files: files.slice(0, 30).map((f) => 'size' in f
+                ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }
+                : { name: f.name, is_dir: true, file_count: f.file_count }),
+            count: files.length,
+        };
+    },
+});

package/tools/group_files.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: '获取 QQ 群的群文件列表',
+  inputSchema: z.object({
+    group_id: z.number().describe('群号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ group_id }, context) {
+    const files = await context.$client.acquireGfs(group_id).ls('/');
+    if (!files.length) return { files: [], message: '群文件为空' };
+    return {
+      files: files.slice(0, 30).map((f) => 'size' in f
+        ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }
+        : { name: f.name, is_dir: true, file_count: f.file_count }),
+      count: files.length,
+    };
+  },
+});

package/tools/group_invite.js

@@ -0,0 +1,23 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '邀请好友加入 QQ 群',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要邀请的 QQ号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ group_id, user_id }, context) {
+        const client = context.$client;
+        const groupInfo = client.pickGroup(group_id);
+        if (!groupInfo)
+            return { success: false, message: '目标群不存在' };
+        const memberInfo = client.pickMember(group_id, user_id);
+        if (memberInfo)
+            return { success: false, message: '目标成员已加入群' };
+        await client.inviteFriend(group_id, user_id);
+        return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+    },
+});

package/tools/group_invite.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number }>({
+  description: '邀请好友加入 QQ 群',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要邀请的 QQ号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ group_id, user_id }, context) {
+    const client = context.$client;
+    const groupInfo= client.pickGroup(group_id);
+    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    const memberInfo= client.pickMember(group_id,user_id);
+    if(memberInfo) return { success: false, message: '目标成员已加入群' };
+    await client.inviteFriend(group_id, user_id);
+    return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+  },
+});

package/tools/group_kick.js

@@ -0,0 +1,26 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '踢出 QQ 群中的某个成员',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要踢出的成员 QQ号'),
+    }),
+    adapter: 'icqq',
+    permissions: ['role(master,admin,trusted,owner)'],
+    approval: 'never',
+    async execute({ group_id, user_id }, context) {
+        const client = context.$client;
+        const selfInfo = client.pickMember(group_id, client.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法踢出成员' };
+        if (selfInfo.user_id === user_id)
+            return { success: false, message: '我不能踢出自己' };
+        const memberInfo = client.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await client.setGroupKick(group_id, user_id);
+        return { success: true, message: `已踢出 ${user_id} 成员` };
+    },
+});

package/tools/group_kick.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number }>({
+  description: '踢出 QQ 群中的某个成员',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要踢出的成员 QQ号'),
+  }),
+  adapter: 'icqq',
+  permissions: ['role(master,admin,trusted,owner)'],
+  approval: 'never',
+  async execute({ group_id, user_id }, context) {
+    const client = context.$client;
+    const selfInfo= client.pickMember(group_id,client.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法踢出成员' };
+    if(selfInfo.user_id === user_id) return { success: false, message: '我不能踢出自己' };
+    const memberInfo= client.pickMember(group_id,user_id);
+    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    await client.setGroupKick(group_id, user_id);
+    return { success: true, message: `已踢出 ${user_id} 成员` };
+  },
+});

package/tools/group_list.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    adapter: 'icqq',
+    description: '获取当前 QQ 账号的群列表',
+    inputSchema: z.object({}),
+    approval: 'never',
+    async execute(_input, context) {
+        const client = context.$client;
+        const groups = Array.from(client.gl.values()).map((group) => ({
+            group_id: group.group_id,
+            group_name: group.group_name,
+            member_count: group.member_count,
+            max_member_count: group.max_member_count,
+        }));
+        return { groups: groups.slice(0, 50), count: client.gl.size };
+    },
+});

package/tools/group_list.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<Record<string, never>>({
+  adapter: 'icqq',
+  description: '获取当前 QQ 账号的群列表',
+  inputSchema: z.object({}),
+  approval: 'never',
+  async execute(_input, context) {
+    const client = context.$client;
+    const groups = Array.from(client.gl.values()).map((group) => ({
+      group_id: group.group_id,
+      group_name: group.group_name,
+      member_count: group.member_count,
+      max_member_count: group.max_member_count,
+    }));
+    return { groups: groups.slice(0, 50), count: client.gl.size };
+  },
+});

package/tools/group_member_info.js

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取 QQ 群成员信息',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ group_id, user_id }, context) {
+        const group = context.$client.pickGroup(group_id);
+        if (!group)
+            return { success: false, message: '目标群不存在' };
+        const memberInfo = group.pickMember(user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        return {
+            success: true,
+            member: memberInfo,
+        };
+    },
+});

package/tools/group_member_info.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+interface GroupMemberInfoInput {
+  group_id: number;
+  user_id: number;
+}
+
+export default defineAgentTool<GroupMemberInfoInput>({
+  description: '获取 QQ 群成员信息',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('目标成员 QQ号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ group_id, user_id }, context) {
+    const group = context.$client.pickGroup(group_id);
+    if (!group) return { success: false, message: '目标群不存在' };
+    const memberInfo = group.pickMember(user_id);
+    if (!memberInfo) return { success: false, message: '目标成员不存在' };
+    return {
+      success: true,
+      member: memberInfo,
+    };
+  },
+});

package/tools/group_sign.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: 'QQ 群签到/打卡',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ group_id }, context) {
+        const client = context.$client;
+        const groupInfo = client.pickGroup(group_id);
+        if (!groupInfo)
+            return { success: false, message: '目标群不存在' };
+        await client.sendGroupSign(group_id);
+        return { success: true, message: '群签到成功' };
+    },
+});

package/tools/group_sign.ts

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: 'QQ 群签到/打卡',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ group_id }, context) {
+    const client = context.$client;
+    const groupInfo= client.pickGroup(group_id);
+    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    await client.sendGroupSign(group_id);
+    return { success: true, message: '群签到成功' };
+  },
+});

package/tools/list_muted.js

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '查询 QQ 群中当前被禁言的成员列表',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+    }),
+    adapter: 'icqq',
+    permissions: ['role(master,admin)'],
+    async execute({ group_id }, context) {
+        const members = await context.$client.getGroupMemberList(group_id);
+        const now = Math.floor(Date.now() / 1000);
+        const muted = Array.from(members.values()).filter((m) => m.shutup_time > now);
+        return { muted_members: muted, count: muted.length };
+    },
+});

package/tools/list_muted.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: '查询 QQ 群中当前被禁言的成员列表',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+  }),
+  adapter: 'icqq',
+  permissions: ['role(master,admin)'],
+  async execute({ group_id }, context) {
+    const members = await context.$client.getGroupMemberList(group_id);
+    const now = Math.floor(Date.now() / 1000);
+    const muted = Array.from(members.values()).filter((m) => m.shutup_time > now);
+    return { muted_members: muted, count: muted.length };
+  },
+});

package/tools/poke.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要戳的目标成员 QQ号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ group_id, user_id }, context) {
+        await context.$client.sendGroupPoke(group_id, user_id);
+        return { success: true, message: `已戳了戳 ${user_id}` };
+    },
+});

package/tools/poke.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number }>({
+  description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要戳的目标成员 QQ号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ group_id, user_id }, context) {
+    await context.$client.sendGroupPoke(group_id, user_id);
+    return { success: true, message: `已戳了戳 ${user_id}` };
+  },
+});

package/tools/send_user_like.js

@@ -0,0 +1,25 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '尝试给用户点尽量多的赞',
+    inputSchema: z.object({
+        user_id: z.number().describe('要点赞的目标用户 QQ号'),
+    }),
+    adapter: 'icqq',
+    approval: 'never',
+    async execute({ user_id }, context) {
+        const successArray = [];
+        await Promise.all([20, 20, 10].map(async (times) => {
+            try {
+                await context.$client.sendLike(user_id, times);
+                successArray.push(times);
+            }
+            catch { /* ignore */ }
+        }));
+        const successTimes = successArray.reduce((a, b) => a + b, 0);
+        if (!successTimes)
+            return { success: false, message: '点赞失败' };
+        return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+    },
+});

package/tools/send_user_like.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ user_id: number }>({
+  description: '尝试给用户点尽量多的赞',
+  inputSchema: z.object({
+    user_id: z.number().describe('要点赞的目标用户 QQ号'),
+  }),
+  adapter: 'icqq',
+  approval: 'never',
+  async execute({ user_id }, context) {
+    const successArray: number[] = [];
+    await Promise.all([20, 20, 10].map(async (times) => {
+      try {
+        await context.$client.sendLike(user_id, times);
+        successArray.push(times);
+      } catch { /* ignore */ }
+    }));
+    const successTimes = successArray.reduce((a, b) => a + b, 0);
+    if (!successTimes) return { success: false, message: '点赞失败' };
+    return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+  },
+});

package/tools/set_anonymous.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '开启或关闭 QQ 群的匿名聊天功能',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
+    }),
+    adapter: 'icqq',
+    permissions: ['role(master,trusted,owner,admin)'],
+    async execute({ group_id, enable }, context) {
+        const client = context.$client;
+        const on = enable ?? true;
+        const selfInfo = client.pickMember(group_id, client.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法开启或关闭匿名聊天' };
+        await client.setGroupAnonymous(group_id, on);
+        return { success: true, message: on ? '已开启匿名聊天' : '已关闭匿名聊天' };
+    },
+});

package/tools/set_anonymous.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; enable?: boolean }>({
+  description: '开启或关闭 QQ 群的匿名聊天功能',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
+  }),
+  adapter: 'icqq',
+  permissions: ['role(master,trusted,owner,admin)'],
+  async execute({ group_id, enable }, context) {
+    const client = context.$client;
+    const on = enable ?? true;
+    const selfInfo= client.pickMember(group_id,client.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法开启或关闭匿名聊天' };
+    await client.setGroupAnonymous(group_id, on);
+    return { success: true, message: on ? '已开启匿名聊天' : '已关闭匿名聊天' };
+  },
+});

package/tools/set_mute.js

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '禁言/解除禁言指定成员',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+        duration: z.number().describe('禁言时间(秒)，0=解除禁言').default(0),
+    }),
+    adapter: 'icqq',
+    approval: 'always',
+    async execute({ group_id, user_id, duration }, context) {
+        const client = context.$client;
+        const selfInfo = client.pickMember(group_id, client.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法禁言/解除禁言成员' };
+        const memberInfo = client.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await client.setGroupBan(group_id, user_id, duration === 0 ? 0 : duration);
+        return { success: true, message: `已${duration === 0 ? '解除' : ''}禁言 ${user_id} 成员${duration === 0 ? '' : `(${duration}秒)`}` };
+    },
+});

package/tools/set_mute.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number; duration?: number }>({
+  description: '禁言/解除禁言指定成员',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('目标成员 QQ号'),
+    duration: z.number().describe('禁言时间(秒)，0=解除禁言').default(0),
+  }),
+  adapter: 'icqq',
+  approval: 'always',
+  async execute({ group_id, user_id, duration }, context) {
+    const client = context.$client;
+    const selfInfo= client.pickMember(group_id,client.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法禁言/解除禁言成员' };
+    const memberInfo= client.pickMember(group_id,user_id);
+    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    await client.setGroupBan(group_id, user_id, duration === 0 ? 0 : duration);
+    return { success: true, message: `已${duration === 0 ? '解除' : ''}禁言 ${user_id} 成员${duration === 0 ? '' : `(${duration}秒)`}` };
+  },
+});

package/tools/set_title.js

@@ -0,0 +1,25 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '设置 QQ 群成员的专属头衔',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+        title: z.string().describe('头衔文字'),
+        duration: z.number().optional().describe('持续时间(秒)，-1永久').default(-1),
+    }),
+    adapter: 'icqq',
+    approval: 'always',
+    async execute({ group_id, user_id, title, duration }, context) {
+        const client = context.$client;
+        const selfInfo = client.pickMember(group_id, client.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法设置头衔' };
+        const memberInfo = client.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await client.setGroupSpecialTitle(group_id, user_id, title, duration ?? -1);
+        return { success: true, message: `已将 ${user_id} 的头衔设为 "${title}"` };
+    },
+});

package/tools/set_title.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number; title: string; duration?: number }>({
+  description: '设置 QQ 群成员的专属头衔',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('目标成员 QQ号'),
+    title: z.string().describe('头衔文字'),
+    duration: z.number().optional().describe('持续时间(秒)，-1永久').default(-1),
+  }),
+  adapter: 'icqq',
+  approval: 'always',
+  async execute({ group_id, user_id, title, duration }, context) {
+    const client = context.$client;
+    const selfInfo= client.pickMember(group_id,client.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法设置头衔' };
+    const memberInfo= client.pickMember(group_id,user_id);
+    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    await client.setGroupSpecialTitle(group_id, user_id, title, duration ?? -1);
+    return { success: true, message: `已将 ${user_id} 的头衔设为 "${title}"` };
+  },
+});

package/tools/user_info.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取指定QQ号的用户信息/资料/详情',
+    inputSchema: z.object({
+        user_id: z.number().describe('目标成员 QQ号'),
+    }),
+    adapter: 'icqq',
+    async execute({ user_id }, context) {
+        const profile = await context.$client.getProfile(user_id);
+        return { success: true, message: `已获取 ${user_id} 的用户信息:${JSON.stringify(profile, null, 2)}` };
+    },
+});

package/tools/user_info.ts

@@ -0,0 +1,13 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ user_id: number }>({
+  description: '获取指定QQ号的用户信息/资料/详情',
+  inputSchema: z.object({
+    user_id: z.number().describe('目标成员 QQ号'),
+  }),
+  adapter: 'icqq',
+  async execute({ user_id }, context) {
+    const profile = await context.$client.getProfile(user_id);
+    return { success: true, message: `已获取 ${user_id} 的用户信息:${JSON.stringify(profile,null,2)}` };
+  },
+});

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 凉菜
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.