@zhin.js/adapter-icqq 1.0.71 → 1.1.2

package/adapters/icqq/index.ts

@@ -0,0 +1,42 @@
+/**
+ * Convention entry: discover `adapters/icqq/index.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { loginAssistToken } from '@zhin.js/core/runtime';
+import { IcqqEndpoint } from '../../src/endpoint.js';
+import { icqqRuntimeStateToken } from '../../src/icqq-runtime-state.js';
+import {
+  resolveIcqqConfig,
+  type IcqqEndpointConfig,
+} from '../../src/protocol.js';
+
+export { IcqqEndpoint } from '../../src/endpoint.js';
+export type { IcqqEndpointOptions } from '../../src/endpoint.js';
+
+declare module '@zhin.js/core' {
+  interface AdapterEndpoints {
+    icqq: import('../../src/endpoint.js').IcqqEndpoint;
+  }
+}
+
+export default defineAdapter<IcqqEndpointConfig>({
+  capabilities: ['inbound', 'outbound'],
+  operations: ['recall', 'reaction'],
+  segments: {
+    outboundMedia: ['base64', 'url', 'path'],
+    interactive: 'text',
+  },
+  create(context) {
+    const config = resolveIcqqConfig(context.config);
+    // 注册到插件运行时状态（icqq endpoint list 的"运行中"数据源）
+    context.use(icqqRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: 'direct',
+    });
+    return new IcqqEndpoint({
+      id: context.id,
+      loginAssist: context.use(loginAssistToken),
+      config,
+    });
+  },
+});

package/agents/icqq/agent.json

@@ -0,0 +1,20 @@
+{
+  "name": "ICQQ Platform Agent",
+  "version": "1.0.0",
+  "description": "Handles icqq platform-specific operations and progressively loads only the required platform Skill.",
+  "trigger_rules": {
+    "file_patterns": [],
+    "keywords": [
+      "icqq",
+      "adapter:icqq"
+    ]
+  },
+  "entry_points": [
+    "system.md",
+    "boundaries.md",
+    "conventions.md"
+  ],
+  "platforms": [
+    "icqq"
+  ]
+}

package/agents/icqq/boundaries.md

@@ -0,0 +1,3 @@
+# Boundaries
+
+Operate only on the active icqq endpoint and authenticated conversation context. Respect every Tool permission and approval policy. Do not infer identifiers, roles, or authorization from display names.

package/agents/icqq/conventions.md

@@ -0,0 +1,3 @@
+# Conventions
+
+Use stable platform identifiers from the current turn or directory queries. Load one task-specific Skill at a time, and use the unified reply and outbound message path.

package/agents/icqq/skills/icqq-directory/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: icqq-directory
+platforms:
+  - icqq
+description: ICQQ 好友、群和成员目录查询能力。
+keywords:
+  - "icqq"
+  - "好友列表"
+  - "群列表"
+  - "成员信息"
+tools:
+  - "friend_list"
+  - "group_list"
+  - "user_info"
+  - "group_member_info"
+---
+
+# icqq-directory
+
+查询用户或群成员前先获取稳定 QQ 号或群号。目录信息只向群主、管理员、master 或 trusted 披露；不要根据昵称猜测身份。

package/agents/icqq/skills/icqq-directory/tools/friend_list/index.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({}),
+    adapter: 'icqq',
+    requiresApproval: 'on-risk',
+    permissions: ['role(master,admin,trusted,owner)'],
+    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/agents/icqq/skills/icqq-directory/tools/friend_list/index.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<Record<string, never>>({
+  description: '获取 QQ 好友列表',
+  inputSchema: z.object({}),
+  adapter: 'icqq',
+  requiresApproval: 'on-risk',
+  permissions: ['role(master,admin,trusted,owner)'],
+  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/agents/icqq/skills/icqq-directory/tools/group_list/index.js

@@ -0,0 +1,20 @@
+// 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({}),
+    requiresApproval: 'on-risk',
+    permissions: ['role(master,admin,trusted,owner)'],
+    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/agents/icqq/skills/icqq-directory/tools/group_list/index.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<Record<string, never>>({
+  adapter: 'icqq',
+  description: '获取当前 QQ 账号的群列表',
+  inputSchema: z.object({}),
+  requiresApproval: 'on-risk',
+  permissions: ['role(master,admin,trusted,owner)'],
+  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/agents/icqq/skills/icqq-directory/tools/group_member_info/index.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',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    requiresApproval: '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/agents/icqq/skills/icqq-directory/tools/group_member_info/index.ts

@@ -0,0 +1,28 @@
+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',
+  scopes:['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  requiresApproval: '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/agents/icqq/skills/icqq-directory/tools/user_info/index.js

@@ -0,0 +1,15 @@
+// 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',
+    requiresApproval: 'never',
+    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/agents/icqq/skills/icqq-directory/tools/user_info/index.ts

@@ -0,0 +1,14 @@
+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',
+  requiresApproval: 'never',
+  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/agents/icqq/skills/icqq-group-admin/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: icqq-group-admin
+platforms:
+  - icqq
+description: ICQQ 邀请、踢人、禁言、头衔、匿名、公告和精华管理能力。
+keywords:
+  - "icqq"
+  - "群管理"
+  - "禁言"
+  - "踢人"
+  - "公告"
+  - "精华"
+tools:
+  - "group_invite"
+  - "group_kick"
+  - "set_mute"
+  - "set_title"
+  - "set_anonymous"
+  - "announce"
+  - "essence"
+---
+
+# icqq-group-admin
+
+仅在目标群和目标成员明确时加载。所有写操作遵守 Tool 审批与角色权限；不可逆或影响成员关系的操作先复核参数。

package/agents/icqq/skills/icqq-group-admin/tools/announce/index.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({
+        group_id: z.number().describe('目标群号'),
+        content: z.string().describe('公告内容'),
+    }),
+    adapter: 'icqq',
+    requiresApproval: 'once',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    async execute({ group_id, content }, context) {
+        await context.$client.sendGroupNotice(group_id, content);
+        return { success: true, message: '群公告已发送' };
+    },
+});

package/agents/icqq/skills/icqq-group-admin/tools/announce/index.ts

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; content: string }>({
+  description: '发送 QQ 群公告（需要管理员权限）',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    content: z.string().describe('公告内容'),
+  }),
+  adapter: 'icqq',
+  requiresApproval: 'once',
+  scopes:['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  async execute({ group_id, content }, context) {
+    await context.$client.sendGroupNotice(group_id, content);
+    return { success: true, message: '群公告已发送' };
+  },
+});

package/agents/icqq/skills/icqq-group-admin/tools/essence/index.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({
+        message_id: z.string().describe('消息 ID'),
+        action: z.enum(['add', 'remove']).describe('add=设为精华, remove=移除精华'),
+    }),
+    adapter: 'icqq',
+    requiresApproval: 'once',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    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/agents/icqq/skills/icqq-group-admin/tools/essence/index.ts

@@ -0,0 +1,22 @@
+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',
+  requiresApproval: 'once',
+  scopes:['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  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/agents/icqq/skills/icqq-group-admin/tools/group_invite/index.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',
+    requiresApproval: 'always',
+    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/agents/icqq/skills/icqq-group-admin/tools/group_invite/index.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',
+  requiresApproval: 'always',
+  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/agents/icqq/skills/icqq-group-admin/tools/group_kick/index.js

@@ -0,0 +1,27 @@
+// 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',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    requiresApproval: 'once',
+    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/agents/icqq/skills/icqq-group-admin/tools/group_kick/index.ts

@@ -0,0 +1,23 @@
+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',
+  scopes:['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  requiresApproval: 'once',
+  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/agents/icqq/skills/icqq-group-admin/tools/set_anonymous/index.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('目标群号'),
+        enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
+    }),
+    adapter: 'icqq',
+    requiresApproval: 'once',
+    scopes: ['group'],
+    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/agents/icqq/skills/icqq-group-admin/tools/set_anonymous/index.ts

@@ -0,0 +1,21 @@
+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',
+  requiresApproval: 'once',
+  scopes:['group'],
+  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/agents/icqq/skills/icqq-group-admin/tools/set_mute/index.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({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+        duration: z.number().describe('禁言时间(秒)，0=解除禁言').default(0),
+    }),
+    adapter: 'icqq',
+    scopes: ['group'],
+    requiresApproval: '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/agents/icqq/skills/icqq-group-admin/tools/set_mute/index.ts

@@ -0,0 +1,22 @@
+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',
+  scopes:['group'],
+  requiresApproval: '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/agents/icqq/skills/icqq-group-admin/tools/set_title/index.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号'),
+        title: z.string().describe('头衔文字'),
+        duration: z.number().optional().describe('持续时间(秒)，-1永久').default(-1),
+    }),
+    adapter: 'icqq',
+    scopes: ['group'],
+    requiresApproval: '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/agents/icqq/skills/icqq-group-admin/tools/set_title/index.ts

@@ -0,0 +1,23 @@
+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',
+  scopes:['group'],
+  requiresApproval: '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/agents/icqq/skills/icqq-group-state/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: icqq-group-state
+platforms:
+  - icqq
+description: ICQQ 群文件与禁言状态查询能力。
+keywords:
+  - "icqq"
+  - "群文件"
+  - "禁言列表"
+tools:
+  - "group_files"
+  - "list_muted"
+---
+
+# icqq-group-state
+
+用于读取群文件和禁言状态。确认群号后调用，不把列表之外的信息当作已验证事实。