@zhin.js/adapter-icqq 8.0.9 → 8.0.11

package/tools/group_sign.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+  description: 'QQ 群签到/打卡',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+  }),
+  platforms: ['icqq'],
+  approval: 'never',
+  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const groupInfo= endpoint.pickGroup(group_id);
+    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    await endpoint.sendGroupSign(group_id);
+    return { success: true, message: '群签到成功' };
+  },
+});

package/tools/list_muted.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '查询 QQ 群中当前被禁言的成员列表',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+    }),
+    platforms: ['icqq'],
+    permissions: ['role(master,admin)'],
+    async execute({ endpoint_id, group_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const members = await endpoint.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,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+  description: '查询 QQ 群中当前被禁言的成员列表',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+  }),
+  platforms: ['icqq'],
+  permissions: ['role(master,admin)'],
+  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const members = await endpoint.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,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要戳的目标成员 QQ号'),
+    }),
+    platforms: ['icqq'],
+    approval: 'never',
+    async execute({ endpoint_id, group_id, user_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        await endpoint.sendGroupPoke(group_id, user_id);
+        return { success: true, message: `已戳了戳 ${user_id}` };
+    },
+});

package/tools/poke.ts

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
+  description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要戳的目标成员 QQ号'),
+  }),
+  platforms: ['icqq'],
+  approval: 'never',
+  async execute({ endpoint_id, group_id, user_id }: { endpoint_id: string; group_id: number; user_id: number }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    await endpoint.sendGroupPoke(group_id, user_id);
+    return { success: true, message: `已戳了戳 ${user_id}` };
+  },
+});

package/tools/send_user_like.js

@@ -0,0 +1,28 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '尝试给用户点尽量多的赞',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        user_id: z.number().describe('要点赞的目标用户 QQ号'),
+    }),
+    platforms: ['icqq'],
+    approval: 'never',
+    async execute({ endpoint_id, user_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const successArray = [];
+        await Promise.all([20, 20, 10].map(async (times) => {
+            try {
+                await endpoint.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,25 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
+  description: '尝试给用户点尽量多的赞',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    user_id: z.number().describe('要点赞的目标用户 QQ号'),
+  }),
+  platforms: ['icqq'],
+  approval: 'never',
+  async execute({ endpoint_id, user_id }: { endpoint_id: string; user_id: number }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const successArray: number[] = [];
+    await Promise.all([20, 20, 10].map(async (times) => {
+      try {
+        await endpoint.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,23 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '开启或关闭 QQ 群的匿名聊天功能',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+        enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
+    }),
+    platforms: ['icqq'],
+    permissions: ['role(master,trusted,owner,admin)'],
+    async execute({ endpoint_id, group_id, enable }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const on = enable ?? true;
+        const selfInfo = endpoint.pickMember(group_id, endpoint.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法开启或关闭匿名聊天' };
+        await endpoint.setGroupAnonymous(group_id, on);
+        return { success: true, message: on ? '已开启匿名聊天' : '已关闭匿名聊天' };
+    },
+});

package/tools/set_anonymous.ts

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

package/tools/set_mute.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '禁言/解除禁言指定成员',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+        duration: z.number().describe('禁言时间(秒)，0=解除禁言').default(0),
+    }),
+    platforms: ['icqq'],
+    permissions: ['role(master,trusted,admin,owner)'],
+    async execute({ endpoint_id, group_id, user_id, duration }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const selfInfo = endpoint.pickMember(group_id, endpoint.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法禁言/解除禁言成员' };
+        const memberInfo = endpoint.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await endpoint.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,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; duration?: number }>({
+  description: '禁言/解除禁言指定成员',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('目标成员 QQ号'),
+    duration: z.number().describe('禁言时间(秒)，0=解除禁言').default(0),
+  }),
+  platforms: ['icqq'],
+  permissions: ['role(master,trusted,admin,owner)'],
+  async execute({ endpoint_id, group_id, user_id, duration }: { endpoint_id: string; group_id: number; user_id: number; duration?: number }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const selfInfo= endpoint.pickMember(group_id,endpoint.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法禁言/解除禁言成员' };
+    const memberInfo= endpoint.pickMember(group_id,user_id);
+    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    await endpoint.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,27 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '设置 QQ 群成员的专属头衔',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+        title: z.string().describe('头衔文字'),
+        duration: z.number().optional().describe('持续时间(秒)，-1永久').default(-1),
+    }),
+    platforms: ['icqq'],
+    permissions: ['role(master,trusted)'],
+    async execute({ endpoint_id, group_id, user_id, title, duration }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const selfInfo = endpoint.pickMember(group_id, endpoint.uin);
+        if (!selfInfo.is_admin && !selfInfo.is_owner)
+            return { success: false, message: '我不是群主或管理员，无法设置头衔' };
+        const memberInfo = endpoint.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await endpoint.setGroupSpecialTitle(group_id, user_id, title, duration ?? -1);
+        return { success: true, message: `已将 ${user_id} 的头衔设为 "${title}"` };
+    },
+});

package/tools/set_title.ts

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

package/tools/user_info.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '获取指定QQ号的用户信息/资料/详情',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        user_id: z.number().describe('目标成员 QQ号'),
+    }),
+    platforms: ['icqq'],
+    async execute({ endpoint_id, user_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const profile = await endpoint.getProfile(user_id);
+        return { success: true, message: `已获取 ${user_id} 的用户信息:${JSON.stringify(profile, null, 2)}` };
+    },
+});

package/tools/user_info.ts

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

package/agent/tools/announce.ts

@@ -1,21 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number; content: string }>({
-  description: '发送 QQ 群公告（需要管理员权限）',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-    content: z.string().describe('公告内容'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  permissions: ['platform(icqq,scene_admin)'],
-  async execute({ endpoint_id, group_id, content    }: { endpoint_id: string; group_id: number; content: string }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GROUP_ANNOUNCE, { group_id, content });
-    return { success: resp.ok, message: resp.ok ? '群公告已发送' : (resp.error ?? '发送失败') };
-  },
-});
-

package/agent/tools/group_files.ts

@@ -1,27 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
-  description: '获取 QQ 群的群文件列表',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
-    group_id: z.number().describe('群号'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GFS_LIST, { group_id });
-    if (!resp.ok) throw new Error(resp.error ?? '获取群文件失败');
-    const files = Array.isArray(resp.data) ? resp.data : [];
-    if (!files.length) return { files: [], message: '群文件为空' };
-    return {
-      files: files.slice(0, 30).map((f: { name: string; size: number; uploader_uin: string; upload_time: number }) => ({
-        name: f.name, size: f.size, uploader: f.uploader_uin, upload_time: f.upload_time,
-      })),
-      count: files.length,
-    };
-  },
-});
-

package/agent/tools/group_invite.ts

@@ -1,20 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
-  description: '邀请好友加入 QQ 群',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-    user_id: z.number().describe('要邀请的 QQ号'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id, group_id, user_id    }: { endpoint_id: string; group_id: number; user_id: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GROUP_INVITE, { group_id, user_id });
-    return { success: resp.ok, message: resp.ok ? `已邀请 ${user_id} 加入群` : (resp.error ?? '邀请失败') };
-  },
-});
-

package/agent/tools/group_sign.ts

@@ -1,19 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
-  description: 'QQ 群签到打卡',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GROUP_SIGN, { group_id });
-    return { success: resp.ok, message: resp.ok ? '群签到成功' : (resp.error ?? '签到失败') };
-  },
-});
-

package/agent/tools/list_muted.ts

@@ -1,22 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
-  description: '查询 QQ 群中当前被禁言的成员列表',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  permissions: ['platform(icqq,scene_admin)'],
-  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GROUP_MUTED_LIST, { group_id });
-    if (!resp.ok) throw new Error(resp.error ?? '获取禁言列表失败');
-    const list = Array.isArray(resp.data) ? resp.data : [];
-    return { muted_members: list, count: list.length };
-  },
-});
-

package/agent/tools/poke.ts

@@ -1,20 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
-  description: '在 QQ 群中对某个成员执行戳一戳互动操作',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-    user_id: z.number().describe('要戳的目标成员 QQ号'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id, group_id, user_id    }: { endpoint_id: string; group_id: number; user_id: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.GROUP_POKE, { group_id, user_id });
-    return { success: resp.ok, message: resp.ok ? `已戳了戳 ${user_id}` : (resp.error ?? '戳一戳失败') };
-  },
-});
-

package/agent/tools/send_user_like.ts

@@ -1,22 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
-  description: '给用户点赞（竖大拇指），每人每天最多 20 次',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    user_id: z.number().describe('要点赞的目标用户 QQ号'),
-    times: z.number().optional().describe('点赞次数（1-20），默认 1'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id, user_id, times    }: { endpoint_id: string; user_id: number; times?: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.FRIEND_LIKE, {
-      user_id, times: Math.min(times ?? 1, 20),
-    });
-    return { success: resp.ok, message: resp.ok ? `已给 ${user_id} 点赞` : (resp.error ?? '点赞失败') };
-  },
-});
-

package/agent/tools/set_anonymous.ts

@@ -1,22 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
-  description: '开启或关闭 QQ 群的匿名聊天功能',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-    enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  permissions: ['platform(icqq,scene_owner)'],
-  async execute({ endpoint_id, group_id, enable    }: { endpoint_id: string; group_id: number; enable?: boolean }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const on = enable ?? true;
-    const resp = await endpoint.ipc.request(Actions.GROUP_ALLOW_ANONY, { group_id, enable: on });
-    return { success: resp.ok, message: resp.ok ? (on ? '已开启匿名聊天' : '已关闭匿名聊天') : (resp.error ?? '操作失败') };
-  },
-});
-

package/agent/tools/set_title.ts

@@ -1,25 +0,0 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
-import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }>({
-  description: '设置 QQ 群成员的专属头衔',
-  inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint QQ号'),
-    group_id: z.number().describe('目标群号'),
-    user_id: z.number().describe('目标成员 QQ号'),
-    title: z.string().describe('头衔文字'),
-    duration: z.number().optional().describe('持续时间(秒)，-1永久'),
-  }),
-  platforms: ['icqq'],
-  tags: ['icqq'],
-  permissions: ['platform(icqq,scene_owner)'],
-  async execute({ endpoint_id, group_id, user_id, title, duration    }: { endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }) {
-    const { Actions } = await import('../../src/protocol.js');
-    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const resp = await endpoint.ipc.request(Actions.SET_GROUP_TITLE, {
-      group_id, user_id, title, duration: duration ?? -1,
-    });
-    return { success: resp.ok, message: resp.ok ? `已将 ${user_id} 的头衔设为 "${title}"` : (resp.error ?? '设置失败') };
-  },
-});
-

package/lib/ipc-client.d.ts

@@ -1,73 +0,0 @@
-import type { IpcResponse, IpcEvent } from "./protocol.js";
-export declare class IpcClient {
-    private socket;
-    private buffer;
-    private pending;
-    private eventHandlers;
-    private _closed;
-    /** 是否为客户端主动 close()（与对端断线区分） */
-    private _userClosed;
-    private _remoteDisconnectEmitted;
-    private onRemoteDisconnect;
-    private constructor();
-    get closed(): boolean;
-    /**
-     * 注册「对端断开 / 连接异常关闭」回调（不含本端 close()）。
-     * 传入 null 可清除回调。
-     */
-    setOnRemoteDisconnect(handler: (() => void) | null): void;
-    /** 注册数据处理 handler（RPC 模式延迟到 challenge 完成后调用） */
-    private attachDataHandler;
-    /**
-     * 通过 IPC（Unix Socket）连接守护进程并完成认证。
-     * @param uin - 目标账号的 QQ 号
-     * @returns 已认证的 IpcClient 实例
-     * @throws 守护进程未运行或认证失败时抛出错误
-     */
-    static connect(uin: number): Promise<IpcClient>;
-    /**
-     * 通过 RPC（TCP）连接守护进程并完成 HMAC 挑战-响应认证。
-     *
-     * 流程：
-     *   1. 服务端连接后发送 { challenge: "<hex>" }
-     *   2. 客户端用 HMAC-SHA256(token, challenge) 生成 digest
-     *   3. 客户端发送 { action: "auth", params: { digest: "<hex>" } }
-     *   4. 服务端验证 digest，通过则认证成功
-     *
-     * token 不会明文传输，防止中间人嗅探。
-     *
-     * @param options.host - 远程主机地址
-     * @param options.port - 远程端口
-     * @param options.token - 认证 token（用于 HMAC 计算，不会明文传输）
-     */
-    static connectRpc(options: {
-        host: string;
-        port: number;
-        token: string;
-    }): Promise<IpcClient>;
-    /**
-     * 通过 RPC 连接守护进程（自动从 daemon.rpc 文件读取地址）。
-     * @param uin - 目标账号的 QQ 号
-     */
-    static connectRpcByUin(uin: number): Promise<IpcClient>;
-    private onData;
-    /**
-     * 注册 icqq 事件回调。
-     * 新版守护进程在认证后会自动广播事件（event.id = "*"）。
-     */
-    onEvent(onEvent: (event: IpcEvent) => void): () => void;
-    /**
-     * 发送 IPC 请求并等待响应。
-     */
-    request(action: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<IpcResponse>;
-    /**
-     * 订阅 daemon 推送事件：服务端自动推送全部事件，type/id 过滤在客户端完成。
-     * @returns 订阅句柄，包含 unsubscribe() 方法
-     */
-    subscribe(_action: string, params: Record<string, unknown>, onEvent: (event: IpcEvent) => void): {
-        id: string;
-        unsubscribe: () => Promise<void>;
-    };
-    /** 关闭连接 */
-    close(): void;
-}