@zhin.js/adapter-icqq 6.0.0 → 6.0.2

package/src/icqq-side-events.ts

@@ -1,29 +1,12 @@
 /**
  * icqq IPC 非 message 入站：notice / request / meta（对齐 OneBot 与 @icqqjs/icqq EventMap）
- * @see https://icqq.pages.dev/interfaces/EventMap.html
  */
-import { Notice, Request, formatCompact } from "zhin.js";
-import type { NoticeType } from "zhin.js";
-import type { RequestType } from "zhin.js";
+import { mapNoticeParts, mapRequestParts, resolveSideEventDedupeKey, senderFromId, buildNotice, buildRequest, formatCompact, type OneBotLikeRawEvent } from 'zhin.js';
+
 import { Actions } from "./protocol.js";
 import type { IpcClient } from "./ipc-client.js";
 
-/** OneBot / icqq 守护进程推送的通用事件字段 */
-export interface IcqqIpcRawEvent {
-  post_type?: string;
-  time?: number;
-  self_id?: number;
-  notice_type?: string;
-  request_type?: string;
-  sub_type?: string;
-  meta_event_type?: string;
-  group_id?: number;
-  user_id?: number;
-  operator_id?: number;
-  flag?: string;
-  comment?: string;
-  [key: string]: unknown;
-}
+export type IcqqIpcRawEvent = OneBotLikeRawEvent;
 
 export function resolveIcqqEventPostType(
   data: Record<string, unknown>,
@@ -54,110 +37,39 @@ export function isIcqqMetaPayload(data: unknown): data is IcqqIpcRawEvent {
   return pt === "meta_event" || (typeof pt === "string" && pt.startsWith("system."));
 }
 
-/** 去重用：notice / request 无稳定 id 时组合键 */
-export function resolveSideEventDedupeKey(
-  data: IcqqIpcRawEvent,
-  kind: "notice" | "request" | "meta",
-): string {
-  if (data.flag != null && String(data.flag) !== "") {
-    return `${kind}:${data.flag}`;
-  }
-  const time = data.time ?? 0;
-  const type =
-    data.notice_type ?? data.request_type ?? data.meta_event_type ?? kind;
-  const scope = data.group_id ?? data.user_id ?? "";
-  const sub = data.sub_type ?? "";
-  return `${kind}:${time}_${type}_${scope}_${sub}`;
-}
-
-const NOTICE_TYPE_MAP: Record<string, NoticeType> = {
-  group_increase: "group_member_increase",
-  group_decrease: "group_member_decrease",
-  group_admin: "group_admin_change",
-  group_ban: "group_ban",
-  group_recall: "group_recall",
-  friend_recall: "friend_recall",
-  friend_add: "friend_add",
-  group_upload: "group_upload",
-  group_sign: "group_sign",
-  group_transfer: "group_transfer",
-  // icqq EventMap 命名 → Zhin NoticeType
-  "group.increase": "group_member_increase",
-  "group.decrease": "group_member_decrease",
-  "group.admin": "group_admin_change",
-  "group.ban": "group_ban",
-  "group.recall": "group_recall",
-  "friend.increase": "friend_add",
-  "friend.decrease": "friend_recall",
-  "friend.recall": "friend_recall",
-};
-
-function resolveNoticeZhinType(event: IcqqIpcRawEvent): NoticeType {
-  const raw = event.notice_type ?? "";
-  if (NOTICE_TYPE_MAP[raw]) return NOTICE_TYPE_MAP[raw];
-  if (raw === "notify") {
-    if (event.sub_type === "poke") {
-      return event.group_id != null ? "group_poke" : "friend_poke";
-    }
-    return `notify_${event.sub_type ?? "unknown"}` as NoticeType;
-  }
-  if (raw.startsWith("notice.")) {
-    const suffix = raw.slice("notice.".length).replace(/\./g, "_");
-    return (NOTICE_TYPE_MAP[suffix] ?? suffix) as NoticeType;
-  }
-  return raw as NoticeType;
-}
-
-function senderFromId(id: unknown, name?: string) {
-  if (id == null) return undefined;
-  const s = String(id);
-  return { id: s, name: name ?? s };
-}
-
 export function formatIcqqNotice(
   event: IcqqIpcRawEvent,
   endpointName: string,
-): ReturnType<typeof Notice.from<IcqqIpcRawEvent>> {
-  const $type = resolveNoticeZhinType(event);
+) {
+  const raw = event.notice_type ?? "";
   const isGroup = event.group_id != null;
-  const channelId = String(
+  const { scene_type, sub_type } = mapNoticeParts('icqq', raw, { sub_type: event.sub_type, is_group: isGroup });
+  const sceneId = String(
     event.group_id ?? event.user_id ?? event.operator_id ?? "",
   );
   const tsSec = event.time ?? Math.floor(Date.now() / 1000);
 
-  return Notice.from(event, {
+  return buildNotice(event, {
     $id: resolveSideEventDedupeKey(event, "notice"),
     $adapter: "icqq",
     $endpoint: endpointName,
-    $type,
-    $subType: event.sub_type,
-    $channel: {
-      id: channelId,
-      type: isGroup ? "group" : "private",
-    },
-    $operator: senderFromId(event.operator_id),
+    $type: "notice",
+    $scene_id: sceneId,
+    $scene_type: scene_type,
+    $sub_type: sub_type,
+    $actor: senderFromId(event.operator_id),
     $target: senderFromId(event.user_id),
     $timestamp: tsSec * 1000,
   });
 }
 
-function resolveRequestZhinType(event: IcqqIpcRawEvent): RequestType {
-  const rt = event.request_type ?? "";
-  if (rt === "friend" || rt.startsWith("friend")) return "friend_add";
-  if (rt === "group" || rt.startsWith("group")) {
-    return event.sub_type === "invite" ? "group_invite" : "group_add";
-  }
-  return rt as RequestType;
-}
-
 export function formatIcqqRequest(
   event: IcqqIpcRawEvent,
   endpointName: string,
   ipc: IpcClient,
-): ReturnType<typeof Request.from<IcqqIpcRawEvent>> {
-  const $type = resolveRequestZhinType(event);
-  const isGroup = event.group_id != null;
-  const channelId = String(event.group_id ?? event.user_id ?? "");
+) {
+  const { scene_type, sub_type } = mapRequestParts('icqq', event.request_type ?? '', event.sub_type);
+  const sceneId = String(event.group_id ?? event.user_id ?? "");
   const tsSec = event.time ?? Math.floor(Date.now() / 1000);
   const flag = event.flag ?? resolveSideEventDedupeKey(event, "request");
 
@@ -166,18 +78,16 @@ export function formatIcqqRequest(
     (typeof event.request_type === "string" &&
       event.request_type.startsWith("friend"));
 
-  return Request.from(event, {
+  return buildRequest(event, {
     $id: String(flag),
     $adapter: "icqq",
     $endpoint: endpointName,
-    $type,
-    $subType: event.sub_type,
-    $channel: {
-      id: channelId,
-      type: isGroup ? "group" : "private",
-    },
-    $sender: senderFromId(event.user_id) ?? { id: "", name: "" },
-    $comment: event.comment,
+    $type: "request",
+    $scene_id: sceneId,
+    $scene_type: scene_type,
+    $sub_type: sub_type,
+    $actor: senderFromId(event.user_id) ?? { id: "", name: "" },
+    $comment: typeof event.comment === "string" ? event.comment : undefined,
     $timestamp: tsSec * 1000,
     $approve: async (remark?: string) => {
       const action = isFriend
@@ -208,21 +118,26 @@ export function formatIcqqRequest(
   });
 }
 
-/** meta_event / system.*：返回是否建议在上线后刷新好友/群列表 */
 export function shouldRefreshListsOnMeta(event: IcqqIpcRawEvent): boolean {
   if (event.meta_event_type === "lifecycle") {
     const sub = event.sub_type;
     return sub === "connect" || sub === "enable";
   }
-  const pt = event.post_type ?? "";
+  const pt = String(event.post_type ?? "");
   if (pt === "system.online" || pt.endsWith(".online")) return true;
   return false;
 }
 
 export function formatIcqqMetaLog(event: IcqqIpcRawEvent): string {
+  const meta =
+    (typeof event.meta_event_type === "string" && event.meta_event_type) ||
+    (typeof event.post_type === "string" && event.post_type) ||
+    "meta";
+  const subType = typeof event.sub_type === "string" ? event.sub_type : undefined;
+  const time = typeof event.time === "number" ? event.time : undefined;
   return formatCompact({
-    meta: event.meta_event_type ?? event.post_type ?? "meta",
-    sub_type: event.sub_type,
-    time: event.time,
+    meta,
+    sub_type: subType,
+    time,
   });
 }

package/src/index.ts

@@ -31,14 +31,6 @@ declare module "zhin.js" {
 export * from "./types.js";
 export { IcqqEndpoint } from "./endpoint.js";
 export { IcqqAdapter } from "./adapter.js";
-export {
-  ICQQTypingIndicatorManager,
-  createICQQTypingIndicatorManager,
-  startICQQTypingIndicator,
-  enableTypingIndicator,
-  type ICQQTypingIndicatorConfig,
-} from "./typing-indicator.js";
-export type { TypingIndicatorConfig } from "./types.js";
 
 const plugin = usePlugin();
 const { provide, useContext, addCommand, root } = plugin;

package/src/segment-mapper.ts

@@ -0,0 +1 @@
+export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';

package/src/tools/index.ts

@@ -1,13 +1,12 @@
 /**
- * ICQQ 平台特有工具注册 — 通过 IPC 调用守护进程 Actions
+ * ICQQ 场景管理工具注册
  *
- * 通用群管理工具由 createGroupManagementTools() 自动生成;
- * 本模块注册 ICQQ 独有的扩展工具。
+ * 平台特有工具已迁移至 agent/tools/；本模块仅注册通用群管工具。
  */
-import type { ToolFeature } from "zhin.js";
-import { createGroupManagementTools } from "zhin.js";
+import { createSceneManagementTools, type ToolFeature } from 'zhin.js';
+
 import type { IcqqAdapter } from "../adapter.js";
-import { Actions } from "../protocol.js";
+import { setIcqqAgentDeps } from "../icqq-agent-deps.js";
 
 export function registerTools(
   toolService: ToolFeature,
@@ -16,397 +15,17 @@ export function registerTools(
 ): () => void {
   const disposers: (() => void)[] = [];
 
-  // ── 通用群管工具 ───────────────────────────────────────────────────
-  const groupTools = createGroupManagementTools(icqq, "icqq");
-  disposers.push(...groupTools.map((t) => toolService.addTool(t, pluginName)));
-
-  // ── 设置头衔 ───────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_set_title",
-        description: "设置 QQ 群成员的专属头衔",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-            user_id: { type: "number", description: "目标成员 QQ号" },
-            title: { type: "string", description: "头衔文字" },
-            duration: { type: "number", description: "持续时间(秒)，-1永久" },
-          },
-          required: ["endpoint_id", "group_id", "user_id", "title"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        permissions: ["platform(icqq,group_owner)"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.SET_GROUP_TITLE, {
-            group_id: args.group_id,
-            user_id: args.user_id,
-            title: args.title,
-            duration: args.duration ?? -1,
-          });
-          return { success: resp.ok, message: resp.ok ? `已将 ${args.user_id} 的头衔设为 "${args.title}"` : (resp.error ?? "设置失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 发送群公告 ─────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_announce",
-        description: "发送 QQ 群公告（需要管理员权限）",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-            content: { type: "string", description: "公告内容" },
-          },
-          required: ["endpoint_id", "group_id", "content"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        permissions: ["platform(icqq,group_admin)"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GROUP_ANNOUNCE, {
-            group_id: args.group_id,
-            content: args.content,
-          });
-          return { success: resp.ok, message: resp.ok ? "群公告已发送" : (resp.error ?? "发送失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 戳一戳 ─────────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_poke",
-        description: "在 QQ 群中对某个成员执行戳一戳互动操作",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-            user_id: { type: "number", description: "要戳的目标成员 QQ号" },
-          },
-          required: ["endpoint_id", "group_id", "user_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GROUP_POKE, {
-            group_id: args.group_id,
-            user_id: args.user_id,
-          });
-          return { success: resp.ok, message: resp.ok ? `已戳了戳 ${args.user_id}` : (resp.error ?? "戳一戳失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 获取被禁言列表 ─────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_list_muted",
-        description: "查询 QQ 群中当前被禁言的成员列表",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-          },
-          required: ["endpoint_id", "group_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        permissions: ["platform(icqq,group_admin)"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GROUP_MUTED_LIST, {
-            group_id: args.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 };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 给用户点赞 ─────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_send_user_like",
-        description: "给用户点赞（竖大拇指），每人每天最多 20 次",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            user_id: { type: "number", description: "要点赞的目标用户 QQ号" },
-            times: { type: "number", description: "点赞次数（1-20），默认 1" },
-          },
-          required: ["endpoint_id", "user_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.FRIEND_LIKE, {
-            user_id: args.user_id,
-            times: Math.min(args.times ?? 1, 20),
-          });
-          return { success: resp.ok, message: resp.ok ? `已给 ${args.user_id} 点赞` : (resp.error ?? "点赞失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 设置匿名聊天 ───────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_set_anonymous",
-        description: "开启或关闭 QQ 群的匿名聊天功能",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-            enable: { type: "boolean", description: "true=开启，false=关闭，默认 true" },
-          },
-          required: ["endpoint_id", "group_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        permissions: ["platform(icqq,group_owner)"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const enable = args.enable ?? true;
-          const resp = await endpoint.ipc.request(Actions.GROUP_ALLOW_ANONY, {
-            group_id: args.group_id,
-            enable,
-          });
-          return { success: resp.ok, message: resp.ok ? (enable ? "已开启匿名聊天" : "已关闭匿名聊天") : (resp.error ?? "操作失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 群文件列表 ─────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_group_files",
-        description: "获取 QQ 群的群文件列表",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint 名称", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "群号" },
-          },
-          required: ["endpoint_id", "group_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GFS_LIST, {
-            group_id: args.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: any) => ({
-              name: f.name,
-              size: f.size,
-              uploader: f.uploader_uin,
-              upload_time: f.upload_time,
-            })),
-            count: files.length,
-          };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 好友列表 ───────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_friend_list",
-        description: "获取 QQ 好友列表",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint 名称", contextKey: 'endpointId' },
-          },
-          required: ["endpoint_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const friends = Array.from(endpoint.friends.values()).map((f) => ({
-            user_id: f.user_id,
-            nickname: f.nickname,
-            remark: f.remark,
-          }));
-          return { friends: friends.slice(0, 50), count: endpoint.friends.size };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 群列表 ─────────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_group_list",
-        description: "获取 Endpoint 的 QQ 群列表",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint 名称", contextKey: 'endpointId' },
-          },
-          required: ["endpoint_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const groups = Array.from(endpoint.groups.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 };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 群签到 ─────────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_group_sign",
-        description: "QQ 群签到打卡",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-          },
-          required: ["endpoint_id", "group_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GROUP_SIGN, {
-            group_id: args.group_id,
-          });
-          return { success: resp.ok, message: resp.ok ? "群签到成功" : (resp.error ?? "签到失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 邀请入群 ───────────────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_group_invite",
-        description: "邀请好友加入 QQ 群",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            group_id: { type: "number", description: "目标群号" },
-            user_id: { type: "number", description: "要邀请的 QQ号" },
-          },
-          required: ["endpoint_id", "group_id", "user_id"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const resp = await endpoint.ipc.request(Actions.GROUP_INVITE, {
-            group_id: args.group_id,
-            user_id: args.user_id,
-          });
-          return { success: resp.ok, message: resp.ok ? `已邀请 ${args.user_id} 加入群` : (resp.error ?? "邀请失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
-
-  // ── 设为/移除精华消息 ──────────────────────────────────────────────
-  disposers.push(
-    toolService.addTool(
-      {
-        name: "icqq_essence",
-        description: "设置或移除 QQ 群精华消息",
-        parameters: {
-          type: "object",
-          properties: {
-            endpoint_id: { type: "string", description: "Endpoint QQ号", contextKey: 'endpointId' },
-            message_id: { type: "string", description: "消息 ID" },
-            action: { type: "string", description: "add=设为精华, remove=移除精华" },
-          },
-          required: ["endpoint_id", "message_id", "action"],
-        },
-        platforms: ["icqq"],
-        tags: ["icqq"],
-        permissions: ["platform(icqq,group_admin)"],
-        execute: async (args: Record<string, any>) => {
-          const endpoint = icqq.endpoints.get(args.endpoint_id);
-          if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-          const action = args.action === "add" ? Actions.GROUP_ESSENCE_ADD : Actions.GROUP_ESSENCE_REMOVE;
-          const resp = await endpoint.ipc.request(action, {
-            message_id: args.message_id,
-          });
-          return { success: resp.ok, message: resp.ok ? (args.action === "add" ? "已设为精华" : "已移除精华") : (resp.error ?? "操作失败") };
-        },
-      },
-      pluginName,
-    ),
-  );
+  setIcqqAgentDeps({
+    getEndpoint: (endpointId) => {
+      const endpoint = icqq.endpoints.get(endpointId);
+      if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+      return endpoint;
+    },
+    getAdapter: () => icqq,
+  });
+
+  const sceneTools = createSceneManagementTools(icqq, "icqq");
+  disposers.push(...sceneTools.map((t) => toolService.addTool(t, pluginName)));
 
   return () => disposers.forEach((d) => d());
 }