@zhin.js/adapter-icqq 8.0.9 → 8.0.10

package/src/protocol.ts

@@ -1,61 +1,20 @@
-/**
- * IPC 协议类型定义与 Action 常量 (ported from @icqqjs/cli)
- *
- * CLI 与守护进程通过 Unix Domain Socket 通信，
- * 使用 JSON + 换行符（\n）分隔的文本协议。
- *
- * 通信流程（@icqqjs/cli `src/daemon/protocol.ts`）：
- * 1. CLI 连接 Socket → auth（token）
- * 2. 认证通过后发送 IpcRequest → 等待 IpcResponse
- * 3. 认证通过后自动接收 icqq 事件推送（IpcEvent），断开连接自动停止
- *
- * 登录相关：**推送**走 IpcEvent（`system.login.*`）。
- */
-
 import { pickCredential } from '@zhin.js/adapter';
 import type { ConversationRef } from '@zhin.js/im-contract';
 import type { MessageSegment } from "zhin.js";
 import { resolveCqMediaArg } from "./cq-message.js";
 
-/** CLI → Daemon 请求 */
-export type IpcRequest = {
-  id: string;
-  action: string;
-  params: Record<string, unknown>;
-};
-
-/** Daemon → CLI 响应 */
-export type IpcResponse = {
+export type ActionResult = {
   id: string;
   ok: boolean;
   data?: unknown;
   error?: string;
 };
 
-/**
- * Daemon → CLI 事件推送（icqq client.em 分发的全部事件）
- *
- * 登录/重连时推送 `system.login.*`（如 `system.login.auth` 含 url + device），
- * 语义在 `event` 字段，不在 OneBot 式 `post_type` 里。
- */
-export type IpcEvent = {
-  /** 固定为 `"*"`，客户端应忽略，由本地 handler 按 `event` 过滤 */
-  id: string;
-  /** icqq 事件名，如 `system.login.auth`、`message.group.normal` */
-  event: string;
-  /** icqq 事件 toJSON 后的 plain object */
-  data: unknown;
-};
-
-export type IpcMessage = IpcResponse | IpcEvent;
-
-export type { IcqqIpcMessageEvent } from "./icqq-inbound.js";
+export type { IcqqMessageEvent } from "./icqq-inbound.js";
 
-/** 从 IPC 入站 payload 解析可用于引用/撤回的消息 ID */
 export { resolveIcqqInboundMessageId } from "./icqq-inbound.js";
 
-/** Guild 消息事件数据 */
-export interface IpcGuildMessageEventData {
+export interface GuildMessageEventData {
   type: "guild";
   guild_id: string;
   guild_name: string;
@@ -69,7 +28,7 @@ export interface IpcGuildMessageEventData {
 }
 
 /**
- * 所有 IPC 操作常量 (from @icqqjs/cli)
+ * 所有操作常量（@icqqjs/icqq）
  */
 export const Actions = {
   PING: "ping",
@@ -276,22 +235,34 @@ export interface IcqqAdapterConfig {
   readonly id?: string;
   readonly autoReconnect?: boolean;
   readonly outboundMedia?: 'file' | 'base64';
-  readonly rpc?: {
-    readonly host?: string;
-    readonly port?: number;
-    readonly token?: string;
-  };
+  readonly password?: string;
+  readonly platform?: number;
+  readonly ver?: string;
+  readonly dataDir?: string;
+  readonly signApiAddr?: string;
+  readonly ignoreSelf?: boolean;
+  readonly resend?: boolean;
+  readonly cacheGroupMember?: boolean;
+  readonly autoServer?: boolean;
+  readonly qqnt?: boolean;
+  readonly ntLogin?: boolean;
   /** Transitional: legacy root `endpoints[]` with `context: icqq`. */
   readonly endpoints?: ReadonlyArray<{
     readonly context?: string;
     readonly id?: string;
     readonly autoReconnect?: boolean;
     readonly outboundMedia?: 'file' | 'base64';
-    readonly rpc?: {
-      readonly host?: string;
-      readonly port?: number;
-      readonly token?: string;
-    };
+    readonly password?: string;
+    readonly platform?: number;
+    readonly ver?: string;
+    readonly dataDir?: string;
+    readonly signApiAddr?: string;
+    readonly ignoreSelf?: boolean;
+    readonly resend?: boolean;
+    readonly cacheGroupMember?: boolean;
+    readonly autoServer?: boolean;
+    readonly qqnt?: boolean;
+    readonly ntLogin?: boolean;
   }>;
 }
 
@@ -300,11 +271,17 @@ export interface ResolvedIcqqConfig {
   readonly id: string;
   readonly autoReconnect: boolean;
   readonly outboundMedia?: 'file' | 'base64';
-  readonly rpc?: {
-    readonly host: string;
-    readonly port: number;
-    readonly token: string;
-  };
+  readonly password?: string;
+  readonly platform?: number;
+  readonly ver?: string;
+  readonly dataDir?: string;
+  readonly signApiAddr?: string;
+  readonly ignoreSelf?: boolean;
+  readonly resend?: boolean;
+  readonly cacheGroupMember?: boolean;
+  readonly autoServer?: boolean;
+  readonly qqnt?: boolean;
+  readonly ntLogin?: boolean;
 }
 
 export interface IcqqWireSegment {
@@ -342,16 +319,33 @@ export function resolveIcqqConfig(config: IcqqAdapterConfig = {}): ResolvedIcqqC
   }
   const autoReconnect = config.autoReconnect ?? entry?.autoReconnect ?? true;
   const outboundMedia = config.outboundMedia ?? entry?.outboundMedia;
-  const rpcRaw = config.rpc ?? entry?.rpc;
-  const rpc = rpcRaw?.host && rpcRaw.port != null && rpcRaw.token
-    ? { host: rpcRaw.host, port: Number(rpcRaw.port), token: rpcRaw.token }
-    : undefined;
+  const password = entry?.password;
+  const platform = config.platform ?? entry?.platform ?? 2;
+  const ver = config.ver ?? entry?.ver ?? '9.1.70';
+  const dataDir = config.dataDir ?? entry?.dataDir ?? `data/icqq/${id}`;
+  const signApiAddr = config.signApiAddr ?? entry?.signApiAddr;
+  const ignoreSelf = config.ignoreSelf ?? entry?.ignoreSelf ?? true;
+  const resend = config.resend ?? entry?.resend;
+  const cacheGroupMember = config.cacheGroupMember ?? entry?.cacheGroupMember ?? true;
+  const autoServer = config.autoServer ?? entry?.autoServer ?? true;
+  const qqnt = config.qqnt ?? entry?.qqnt;
+  const ntLogin = config.ntLogin ?? entry?.ntLogin;
   return {
     context: 'icqq',
     id,
     autoReconnect,
     ...(outboundMedia ? { outboundMedia } : {}),
-    ...(rpc ? { rpc } : {}),
+    ...(password ? { password } : {}),
+    ...(platform != null ? { platform: Number(platform) } : {}),
+    ...(ver ? { ver } : {}),
+    ...(dataDir ? { dataDir } : {}),
+    ...(signApiAddr ? { signApiAddr } : {}),
+    ...(ignoreSelf != null ? { ignoreSelf } : {}),
+    ...(resend != null ? { resend } : {}),
+    ...(cacheGroupMember != null ? { cacheGroupMember } : {}),
+    ...(autoServer != null ? { autoServer } : {}),
+    ...(qqnt != null ? { qqnt } : {}),
+    ...(ntLogin != null ? { ntLogin } : {}),
   };
 }
 
@@ -386,7 +380,7 @@ export function icqqInboundConversation(endpointKey: string, input: {
 }
 
 /**
- * 出站：从 ConversationRef 派生 IPC action 路由。
+ * 出站：从 ConversationRef 派生 action 路由。
  * 群容器（parent kind 'group'）内的 private 会话即 ICQQ 群临时会话（temp）。
  */
 export function icqqOutboundTarget(conversation: ConversationRef): ParsedIcqqSendTarget {

package/src/types.ts

@@ -1,9 +1,3 @@
-/**
- * ICQQ 适配器类型与配置
- *
- * 不再直接依赖 @icqqjs/icqq，通过 @icqqjs/cli 守护进程 IPC 通信。
- */
-
 export type GroupRole = "owner" | "admin" | "member";
 
 export interface IcqqSenderInfo {
@@ -17,47 +11,21 @@ export interface IcqqSenderInfo {
   title?: string;
 }
 
-/**
- * Endpoint 配置：支持本地 IPC 和远程 RPC 两种连接模式。
- *
- * - 本地模式（默认）：只需 name（QQ号），自动连接 ~/.icqq/<uin>/daemon.sock
- * - 远程模式：额外配置 rpc.host / rpc.port / rpc.token
- */
 export interface IcqqEndpointConfig {
   context: "icqq";
-  /** QQ 号码字符串 */
   name: `${number}`;
-  /** RPC 远程连接配置（不配置则使用本地 IPC） */
-  rpc?: {
-    /** 远程主机地址 */
-    host: string;
-    /** 远程端口 */
-    port: number;
-    /** 认证 token（用于 HMAC-SHA256 挑战-响应，不会明文传输） */
-    token: string;
-  };
-  /**
-   * IPC/RPC 与守护进程连接意外断开时是否自动重连（指数退避，上限约 30s）。
-   * 默认 true；设为 false 则断开后仅将 `$connected` 置为 false，需手动重连。
-   */
   autoReconnect?: boolean;
-  /**
-   * 出站图片/语音/视频：file=本机临时文件路径（需与 icqq 守护进程同机可读）；
-   * base64=经 CQ `base64://` 交给守护进程解码（Zhin 与 icqq 异进程/异机时用，配置 rpc 时默认 base64）。
-   */
   outboundMedia?: "file" | "base64";
 }
 
-/** IPC 返回的好友信息 */
-export interface IpcFriendInfo {
+export interface FriendInfo {
   user_id: number;
   nickname: string;
   remark?: string;
   class_id?: number;
 }
 
-/** IPC 返回的群信息 */
-export interface IpcGroupInfo {
+export interface GroupInfo {
   group_id: number;
   group_name: string;
   member_count: number;
@@ -65,8 +33,7 @@ export interface IpcGroupInfo {
   owner_id?: number;
 }
 
-/** IPC 返回的群成员信息 */
-export interface IpcMemberInfo {
+export interface MemberInfo {
   user_id: number;
   nickname: string;
   card: string;
@@ -77,11 +44,7 @@ export interface IpcMemberInfo {
   shutup_time?: number;
 }
 
-/**
- * GET_SYSTEM_MSG 归一后的待处理请求（@icqqjs/cli NormalizedSystemMessage）。
- * friendRequests 与 groupRequests 均为该形状，按 flag 处理。
- */
-export interface IpcSystemMessage {
+export interface SystemMessage {
   type: string;
   user_id?: number;
   nickname?: string;

package/tools/announce.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('目标群号'),
+        content: z.string().describe('公告内容'),
+    }),
+    platforms: ['icqq'],
+    permissions: ['platform(icqq,scene_admin)'],
+    async execute({ endpoint_id, group_id, content }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        await endpoint.sendGroupNotice(group_id, content);
+        return { success: true, message: '群公告已发送' };
+    },
+});

package/tools/announce.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; 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'],
+  permissions: ['platform(icqq,scene_admin)'],
+  async execute({ endpoint_id, group_id, content }: { endpoint_id: string; group_id: number; content: string }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    await endpoint.sendGroupNotice(group_id, content);
+    return { success: true, message: '群公告已发送' };
+  },
+});

package/tools/essence.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '设置或移除 QQ 群精华消息',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        message_id: z.string().describe('消息 ID'),
+        action: z.enum(['add', 'remove']).describe('add=设为精华, remove=移除精华'),
+    }),
+    platforms: ['icqq'],
+    permissions: ['platform(icqq,scene_admin)'],
+    async execute({ endpoint_id, message_id, action }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        if (action === 'add') {
+            await endpoint.setEssenceMessage(message_id);
+        }
+        else {
+            await endpoint.removeEssenceMessage(message_id);
+        }
+        return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
+    },
+});

package/{agent/tools → tools}/essence.ts

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
 export default defineAgentTool<{ endpoint_id: string; message_id: string; action: 'add' | 'remove' }>({
   description: '设置或移除 QQ 群精华消息',
   inputSchema: z.object({
@@ -9,14 +9,14 @@ export default defineAgentTool<{ endpoint_id: string; message_id: string; action
     action: z.enum(['add', 'remove']).describe('add=设为精华, remove=移除精华'),
   }),
   platforms: ['icqq'],
-  tags: ['icqq'],
   permissions: ['platform(icqq,scene_admin)'],
   async execute({ endpoint_id, message_id, action }: { endpoint_id: string; message_id: string; action: 'add' | 'remove' }) {
-    const { Actions } = await import('../../src/protocol.js');
     const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const act = action === 'add' ? Actions.GROUP_ESSENCE_ADD : Actions.GROUP_ESSENCE_REMOVE;
-    const resp = await endpoint.ipc.request(act, { message_id });
-    return { success: resp.ok, message: resp.ok ? (action === 'add' ? '已设为精华' : '已移除精华') : (resp.error ?? '操作失败') };
+    if (action === 'add') {
+      await endpoint.setEssenceMessage(message_id);
+    } else {
+      await endpoint.removeEssenceMessage(message_id);
+    }
+    return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
   },
 });
-

package/tools/friend_list.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 名称'),
+    }),
+    platforms: ['icqq'],
+    approval: 'never',
+    async execute({ endpoint_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const fl = endpoint.fl;
+        const friends = Array.from(fl.values()).map((f) => ({
+            user_id: f.user_id, nickname: f.nickname, remark: f.remark,
+        }));
+        return { friends: friends.slice(0, 50), count: fl.size };
+    },
+});

package/{agent/tools → tools}/friend_list.ts

@@ -1,19 +1,19 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
 export default defineAgentTool<{ endpoint_id: string }>({
   description: '获取 QQ 好友列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),
   }),
   platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id    }: { endpoint_id: string }) {
+  approval: 'never',
+  async execute({ endpoint_id }: { endpoint_id: string }) {
     const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const friends = Array.from(endpoint.friends.values()).map((f) => ({
+    const fl = endpoint.fl;
+    const friends = Array.from(fl.values()).map((f) => ({
       user_id: f.user_id, nickname: f.nickname, remark: f.remark,
     }));
-    return { friends: friends.slice(0, 50), count: endpoint.friends.size };
+    return { friends: friends.slice(0, 50), count: fl.size };
   },
 });
-

package/tools/group_files.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '获取 QQ 群的群文件列表',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint 名称'),
+        group_id: z.number().describe('群号'),
+    }),
+    platforms: ['icqq'],
+    approval: 'never',
+    async execute({ endpoint_id, group_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const files = await endpoint.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,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 }>({
+  description: '获取 QQ 群的群文件列表',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    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 files = await endpoint.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,25 @@
+// 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);
+        const groupInfo = endpoint.pickGroup(group_id);
+        if (!groupInfo)
+            return { success: false, message: '目标群不存在' };
+        const memberInfo = endpoint.pickMember(group_id, user_id);
+        if (memberInfo)
+            return { success: false, message: '目标成员已加入群' };
+        await endpoint.inviteFriend(group_id, user_id);
+        return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+    },
+});

package/tools/group_invite.ts

@@ -0,0 +1,22 @@
+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);
+    const groupInfo= endpoint.pickGroup(group_id);
+    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    const memberInfo= endpoint.pickMember(group_id,user_id);
+    if(memberInfo) return { success: false, message: '目标成员已加入群' };
+    await endpoint.inviteFriend(group_id, user_id);
+    return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+  },
+});

package/tools/group_kick.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: '踢出 QQ 群中的某个成员',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint QQ号'),
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要踢出的成员 QQ号'),
+    }),
+    platforms: ['icqq'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    approval: 'never',
+    async execute({ endpoint_id, group_id, user_id }) {
+        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: '我不是群主或管理员，无法踢出成员' };
+        if (selfInfo.user_id === user_id)
+            return { success: false, message: '我不能踢出自己' };
+        const memberInfo = endpoint.pickMember(group_id, user_id);
+        if (!memberInfo)
+            return { success: false, message: '目标成员不存在' };
+        await endpoint.setGroupKick(group_id, user_id);
+        return { success: true, message: `已踢出 ${user_id} 成员` };
+    },
+});

package/tools/group_kick.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 }>({
+  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'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  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);
+    const selfInfo= endpoint.pickMember(group_id,endpoint.uin);
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '我不是群主或管理员，无法踢出成员' };
+    if(selfInfo.user_id === user_id) return { success: false, message: '我不能踢出自己' };
+    const memberInfo= endpoint.pickMember(group_id,user_id);
+    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    await endpoint.setGroupKick(group_id, user_id);
+    return { success: true, message: `已踢出 ${user_id} 成员` };
+  },
+});

package/tools/group_list.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';
+import { getIcqqAgentDeps } from "../lib/icqq-agent-deps.js";
+export default defineAgentTool({
+    description: '获取 Endpoint 的 QQ 群列表',
+    inputSchema: z.object({
+        endpoint_id: z.string().describe('Endpoint 名称'),
+    }),
+    platforms: ['icqq'],
+    approval: 'never',
+    async execute({ endpoint_id }) {
+        const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+        const gl = endpoint.gl;
+        const groups = Array.from(gl.values()).map((g) => ({
+            group_id: g.group_id, group_name: g.group_name,
+            member_count: g.member_count, max_member_count: g.max_member_count,
+        }));
+        return { groups: groups.slice(0, 50), count: gl.size };
+    },
+});

package/{agent/tools → tools}/group_list.ts

@@ -1,20 +1,20 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+import { getIcqqAgentDeps } from '../src/icqq-agent-deps.js';
 export default defineAgentTool<{ endpoint_id: string }>({
   description: '获取 Endpoint 的 QQ 群列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),
   }),
   platforms: ['icqq'],
-  tags: ['icqq'],
-  async execute({ endpoint_id    }: { endpoint_id: string }) {
+  approval: 'never',
+  async execute({ endpoint_id }: { endpoint_id: string }) {
     const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
-    const groups = Array.from(endpoint.groups.values()).map((g) => ({
+    const gl = endpoint.gl;
+    const groups = Array.from(gl.values()).map((g) => ({
       group_id: g.group_id, group_name: g.group_name,
       member_count: g.member_count, max_member_count: g.max_member_count,
     }));
-    return { groups: groups.slice(0, 50), count: endpoint.groups.size };
+    return { groups: groups.slice(0, 50), count: gl.size };
   },
 });
-

package/tools/group_sign.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';
+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'],
+    approval: 'never',
+    async execute({ endpoint_id, group_id }) {
+        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: '群签到成功' };
+    },
+});