@aalis/plugin-tool-onebot 0.9.2 → 0.10.0

package/dist/index.js

@@ -1,14 +1,11 @@
-import { getPlatformAdapters, getPlatformNames } from '@aalis/api-platform';
-import { createStorageGateway } from '@aalis/api-storage';
-import { toolsWithGroups, useToolService } from '@aalis/api-tools';
+import { media } from '@aalis/api-media';
+import { getPlatformAdapters, getPlatformNames, platform } from '@aalis/api-platform';
+import { createStorageGateway, storage } from '@aalis/api-storage';
+import { sessionHistory } from '@aalis/api-tool-session';
+import { tools, withToolGroups } from '@aalis/api-tools';
+import { config, definePlugin, events, lifecycle, logger, optional } from '@aalis/core';
 // ===== 插件元数据 =====
-export const name = '@aalis/plugin-tool-onebot';
-export const displayName = 'OneBot 工具';
-export const subsystem = 'tools';
-export const inject = {
-    optional: ['platform', 'session-history'],
-};
-export const configSchema = {
+const configSchema = {
     groupManagement: {
         label: '群管理工具',
         fields: {
@@ -86,6 +83,18 @@ export const configSchema = {
         },
     },
 };
+// ===== 能力声明 =====
+const uses = {
+    tools: optional(tools),
+    platform: optional(platform),
+    storage: optional(storage),
+    media: optional(media),
+    sessionHistory: optional(sessionHistory),
+    events,
+    logger,
+    lifecycle,
+    config,
+};
 // ===== 辅助函数 =====
 /** 从 sessionId 解析 OneBot 连接信息 */
 function parseOneBotSession(sessionId) {
@@ -98,13 +107,13 @@ function parseOneBotSession(sessionId) {
         targetId: parts.slice(3).join(':'),
     };
 }
-/** 从上下文中找到支持 callAction 的 OneBot 平台适配器 */
-function findOneBotAdapter(ctx) {
-    return getPlatformAdapters(ctx).find(a => a.platform === 'onebot' && typeof a.callAction === 'function');
+/** 在已注册的平台适配器里找出支持 callAction 的 OneBot 适配器 */
+function findOneBotAdapter(platform) {
+    return getPlatformAdapters(platform).find(a => a.platform === 'onebot' && typeof a.callAction === 'function');
 }
 /** 从已连接的 OneBot 适配器中找出任意一个 selfId（优先 online） */
-function getAnyOneBotSelfId(ctx) {
-    for (const a of getPlatformAdapters(ctx)) {
+function getAnyOneBotSelfId(platform) {
+    for (const a of getPlatformAdapters(platform)) {
         if (a.platform !== 'onebot')
             continue;
         const conns = a.getConnections?.() ?? [];
@@ -122,14 +131,14 @@ function getAnyOneBotSelfId(ctx) {
  * 优先级：args.self_id → 当前 callCtx 是 OneBot 会话时取它的 selfId → 任意可用 adapter 的第一个 selfId。
  * 找不到则抛错（无可用 OneBot 连接）。
  */
-function resolveSelfId(ctx, callCtx, args) {
+function resolveSelfId(platform, callCtx, args) {
     const fromArgs = args.self_id != null && String(args.self_id).trim() ? String(args.self_id).trim() : '';
     if (fromArgs)
         return fromArgs;
     const parsed = parseOneBotSession(callCtx.sessionId);
     if (parsed?.selfId)
         return parsed.selfId;
-    const fallback = getAnyOneBotSelfId(ctx);
+    const fallback = getAnyOneBotSelfId(platform);
     if (fallback)
         return fallback;
     throw new Error('未找到可用的 OneBot 连接');
@@ -138,9 +147,9 @@ function resolveSelfId(ctx, callCtx, args) {
  * 解析"目标群"：args.group_id 优先；否则当前会话必须在 OneBot 群里。
  * 不再限制工具必须在群会话上下文中调用。
  */
-function resolveGroupTarget(ctx, callCtx, args) {
+function resolveGroupTarget(platform, callCtx, args) {
     const argGroupId = args.group_id != null && String(args.group_id).trim() ? String(args.group_id).trim() : '';
-    const selfId = resolveSelfId(ctx, callCtx, args);
+    const selfId = resolveSelfId(platform, callCtx, args);
     if (argGroupId)
         return { selfId, groupId: argGroupId };
     const parsed = parseOneBotSession(callCtx.sessionId);
@@ -152,9 +161,9 @@ function resolveGroupTarget(ctx, callCtx, args) {
 /**
  * 解析"目标用户"：args.user_id 优先；否则当前会话必须是 OneBot 私聊。
  */
-function _resolveUserTarget(ctx, callCtx, args) {
+function _resolveUserTarget(platform, callCtx, args) {
     const argUserId = args.user_id != null && String(args.user_id).trim() ? String(args.user_id).trim() : '';
-    const selfId = resolveSelfId(ctx, callCtx, args);
+    const selfId = resolveSelfId(platform, callCtx, args);
     if (argUserId)
         return { selfId, userId: argUserId };
     const parsed = parseOneBotSession(callCtx.sessionId);
@@ -171,8 +180,8 @@ function buildOneBotSessionId(selfId, detailType, targetId) {
  * adapter 内部只用 sessionId 解析 selfId 来定位 WebSocket 连接，
  * 因此这里用合成 sessionId（"onebot:<selfId>:internal:0"）即可，与目标会话类型无关。
  */
-async function callAction(ctx, selfId, action, params) {
-    const adapter = findOneBotAdapter(ctx);
+async function callAction(platform, selfId, action, params) {
+    const adapter = findOneBotAdapter(platform);
     if (!adapter?.callAction)
         throw new Error('OneBot 适配器不可用或不支持 callAction');
     return adapter.callAction(buildOneBotSessionId(selfId, 'internal', '0'), action, params);
@@ -287,11 +296,12 @@ function collectForwardImageRefs(data, limit) {
         .slice(0, limit)
         .flatMap(item => extractImageRefsFromContent(getForwardNodeContent(item)));
 }
-async function resolveForwardImageSource(ctx, storage, selfId, ref) {
+async function resolveForwardImageSource(caps, storage, selfId, ref) {
     if (/^(https?:|data:)/i.test(ref.source))
         return ref.source;
+    const { platform, logger } = caps;
     try {
-        const imageData = (await callAction(ctx, selfId, 'get_image', { file: ref.source }));
+        const imageData = (await callAction(platform, selfId, 'get_image', { file: ref.source }));
         const resolvedSource = imageData.url ?? imageData.file ?? ref.source;
         if (typeof resolvedSource === 'string') {
             if (/^(https?:|data:)/i.test(resolvedSource))
@@ -303,19 +313,20 @@ async function resolveForwardImageSource(ctx, storage, selfId, ref) {
         }
     }
     catch (err) {
-        ctx.logger.debug(`get_image 解析转发图片失败 (${ref.source}): ${err}`);
+        logger.debug(`get_image 解析转发图片失败 (${ref.source}): ${err}`);
     }
     const dataUri = await localImageToDataUri(storage, ref.source);
     return dataUri ?? ref.source;
 }
-async function recognizeForwardImages(ctx, storage, selfId, data, limit) {
+async function recognizeForwardImages(caps, storage, selfId, data, limit) {
     const refs = collectForwardImageRefs(data, limit);
     const imageDescriptions = new Map();
     if (refs.length === 0)
         return { imageDescriptions };
-    const mediaSvc = ctx.getService('media');
-    if (!mediaSvc?.describeImage) {
-        ctx.logger.debug(`合并转发包含 ${refs.length} 张图片，但 media 服务不可用`);
+    const { logger, media } = caps;
+    const mediaService = media.current;
+    if (!mediaService?.describeImage) {
+        logger.debug(`合并转发包含 ${refs.length} 张图片，但 media 服务不可用`);
         return { imageDescriptions };
     }
     const seen = new Set();
@@ -325,13 +336,13 @@ async function recognizeForwardImages(ctx, storage, selfId, data, limit) {
             continue;
         seen.add(key);
         try {
-            const imageSource = await resolveForwardImageSource(ctx, storage, selfId, ref);
-            const description = await mediaSvc.describeImage(imageSource);
+            const imageSource = await resolveForwardImageSource(caps, storage, selfId, ref);
+            const description = await mediaService.describeImage(imageSource);
             if (description)
                 imageDescriptions.set(key, description);
         }
         catch (err) {
-            ctx.logger.debug(`合并转发图片识别失败 (${ref.source}): ${err}`);
+            logger.debug(`合并转发图片识别失败 (${ref.source}): ${err}`);
         }
     }
     return { imageDescriptions };
@@ -423,9 +434,9 @@ function roleLevel(role) {
     return ROLE_LEVEL[role] ?? 0;
 }
 /** 查询群成员信息（失败返回 null） */
-async function getGroupMemberInfo(ctx, selfId, groupId, userId) {
+async function getGroupMemberInfo(platform, selfId, groupId, userId) {
     try {
-        return (await callAction(ctx, selfId, 'get_group_member_info', {
+        return (await callAction(platform, selfId, 'get_group_member_info', {
             group_id: Number(groupId),
             user_id: Number(userId),
             no_cache: true,
@@ -436,8 +447,8 @@ async function getGroupMemberInfo(ctx, selfId, groupId, userId) {
     }
 }
 /** 检查管理操作权限，返回错误消息（null 表示通过或无法验证） */
-async function checkAdminPermission(ctx, selfId, groupId, targetUserId, requireOwner) {
-    const selfInfo = await getGroupMemberInfo(ctx, selfId, groupId, selfId);
+async function checkAdminPermission(platform, selfId, groupId, targetUserId, requireOwner) {
+    const selfInfo = await getGroupMemberInfo(platform, selfId, groupId, selfId);
     if (!selfInfo)
         return null; // 无法获取自身信息，跳过权限检查
     const selfRole = String(selfInfo.role ?? 'member');
@@ -448,7 +459,7 @@ async function checkAdminPermission(ctx, selfId, groupId, targetUserId, requireO
         return `操作失败：机器人不是管理员（当前角色：${selfRole}），无法执行管理操作`;
     }
     if (targetUserId) {
-        const targetInfo = await getGroupMemberInfo(ctx, selfId, groupId, targetUserId);
+        const targetInfo = await getGroupMemberInfo(platform, selfId, groupId, targetUserId);
         if (!targetInfo) {
             return `操作失败：无法获取用户 ${targetUserId} 的信息，该用户可能不在群中`;
         }
@@ -460,81 +471,89 @@ async function checkAdminPermission(ctx, selfId, groupId, targetUserId, requireO
     }
     return null;
 }
-export function apply(ctx, config) {
-    const tools = useToolService(ctx);
-    const storage = createStorageGateway(ctx);
-    const bundle = {
-        daily: toolsWithGroups(tools, ['onebot-daily']),
-        group: toolsWithGroups(tools, ['onebot-group']),
-        personal: toolsWithGroups(tools, ['onebot-personal']),
-    };
-    // 仅当 OneBot 平台可用时才注册工具
-    // 使用 ready 事件确保平台已加载
-    ctx.on('ready', () => {
-        if (!getPlatformNames(ctx).includes('onebot')) {
-            ctx.logger.info('未检测到 OneBot 平台，跳过 OneBot 工具注册');
-            return;
-        }
-        ctx.logger.info('检测到 OneBot 平台，开始注册 OneBot 工具');
-        // 注册工具分组：按职责语义切分，彼此不重叠
-        tools.registerGroup({
-            name: 'onebot-daily',
-            label: 'OneBot 只读与日常',
-            description: '只读查询（群信息/成员/好友列表/历史/登录信息）+ 日常低风险互动（戳一戳、好友赞）',
-        });
-        tools.registerGroup({
-            name: 'onebot-group',
-            label: 'OneBot 群务',
-            description: '群务管理：禁言/全员禁言/踢人/撤回消息/设置群名片/改群名/设管理员/群打卡/审批加群申请 等',
-        });
-        tools.registerGroup({
-            name: 'onebot-personal',
-            label: 'OneBot 个人/私聊',
-            description: '影响 bot 账号本身的人际关系：退群、删好友、处理好友申请、接受/拒绝入群邀请',
-        });
-        const cfg = {
-            groupManagement: { enabled: true, ...(config.groupManagement ?? {}) },
-            groupInfo: { enabled: true, ...(config.groupInfo ?? {}) },
-            account: { enabled: true, ...(config.account ?? {}) },
-            interaction: { enabled: true, ...(config.interaction ?? {}) },
-            sessionHistory: {
-                enabled: true,
-                maxLimit: 100,
-                defaultLimit: 20,
-                allowGroupReadPrivate: false,
-                allowCrossSelf: false,
-                allowCrossGroup: true,
-                allowCrossPrivate: false,
-                ...(config.sessionHistory ?? {}),
-            },
+export default definePlugin({
+    name: '@aalis/plugin-tool-onebot',
+    displayName: 'OneBot 工具',
+    subsystem: 'tools',
+    configSchema,
+    uses,
+    apply(caps) {
+        const { tools, events, logger, platform, config } = caps;
+        const storage = createStorageGateway(caps.storage);
+        const bundle = {
+            daily: withToolGroups(tools, ['onebot-daily']),
+            group: withToolGroups(tools, ['onebot-group']),
+            personal: withToolGroups(tools, ['onebot-personal']),
         };
-        if (cfg.groupManagement.enabled)
-            registerGroupManagementTools(ctx, bundle);
-        if (cfg.groupInfo.enabled)
-            registerGroupInfoTools(ctx, storage, bundle);
-        if (cfg.account.enabled)
-            registerAccountTools(ctx, bundle);
-        if (cfg.interaction.enabled)
-            registerInteractionTools(ctx, bundle);
-        if (cfg.sessionHistory.enabled) {
-            const maxLimit = Math.max(1, Math.min(1000, Number(cfg.sessionHistory.maxLimit) || 100));
-            const defaultLimitRaw = Math.max(1, Math.floor(Number(cfg.sessionHistory.defaultLimit) || 20));
-            const historyCfg = {
-                maxLimit,
-                defaultLimit: Math.min(defaultLimitRaw, maxLimit),
-                allowGroupReadPrivate: cfg.sessionHistory.allowGroupReadPrivate === true,
-                allowCrossSelf: cfg.sessionHistory.allowCrossSelf === true,
-                allowCrossGroup: cfg.sessionHistory.allowCrossGroup !== false,
-                allowCrossPrivate: cfg.sessionHistory.allowCrossPrivate === true,
+        // 仅当 OneBot 平台可用时才注册工具
+        // 使用 app:ready 事件确保平台已加载
+        events.on('app:ready', () => {
+            if (!getPlatformNames(platform).includes('onebot')) {
+                logger.info('未检测到 OneBot 平台，跳过 OneBot 工具注册');
+                return;
+            }
+            logger.info('检测到 OneBot 平台，开始注册 OneBot 工具');
+            // 注册工具分组：按职责语义切分，彼此不重叠
+            tools.registerGroup({
+                name: 'onebot-daily',
+                label: 'OneBot 只读与日常',
+                description: '只读查询（群信息/成员/好友列表/历史/登录信息）+ 日常低风险互动（戳一戳、好友赞）',
+            });
+            tools.registerGroup({
+                name: 'onebot-group',
+                label: 'OneBot 群务',
+                description: '群务管理：禁言/全员禁言/踢人/撤回消息/设置群名片/改群名/设管理员/群打卡/审批加群申请 等',
+            });
+            tools.registerGroup({
+                name: 'onebot-personal',
+                label: 'OneBot 个人/私聊',
+                description: '影响 bot 账号本身的人际关系：退群、删好友、处理好友申请、接受/拒绝入群邀请',
+            });
+            const cfg = {
+                groupManagement: { enabled: true, ...(config.groupManagement ?? {}) },
+                groupInfo: { enabled: true, ...(config.groupInfo ?? {}) },
+                account: { enabled: true, ...(config.account ?? {}) },
+                interaction: { enabled: true, ...(config.interaction ?? {}) },
+                sessionHistory: {
+                    enabled: true,
+                    maxLimit: 100,
+                    defaultLimit: 20,
+                    allowGroupReadPrivate: false,
+                    allowCrossSelf: false,
+                    allowCrossGroup: true,
+                    allowCrossPrivate: false,
+                    ...(config.sessionHistory ?? {}),
+                },
             };
-            registerSessionHistoryTools(ctx, bundle, historyCfg);
-            registerOneBotHistoryAccessChecker(ctx, historyCfg);
-        }
-        registerRequestTools(ctx, bundle);
-    });
-}
+            if (cfg.groupManagement.enabled)
+                registerGroupManagementTools(caps, bundle);
+            if (cfg.groupInfo.enabled)
+                registerGroupInfoTools(caps, storage, bundle);
+            if (cfg.account.enabled)
+                registerAccountTools(caps, bundle);
+            if (cfg.interaction.enabled)
+                registerInteractionTools(caps, bundle);
+            if (cfg.sessionHistory.enabled) {
+                const maxLimit = Math.max(1, Math.min(1000, Number(cfg.sessionHistory.maxLimit) || 100));
+                const defaultLimitRaw = Math.max(1, Math.floor(Number(cfg.sessionHistory.defaultLimit) || 20));
+                const historyCfg = {
+                    maxLimit,
+                    defaultLimit: Math.min(defaultLimitRaw, maxLimit),
+                    allowGroupReadPrivate: cfg.sessionHistory.allowGroupReadPrivate === true,
+                    allowCrossSelf: cfg.sessionHistory.allowCrossSelf === true,
+                    allowCrossGroup: cfg.sessionHistory.allowCrossGroup !== false,
+                    allowCrossPrivate: cfg.sessionHistory.allowCrossPrivate === true,
+                };
+                registerSessionHistoryTools(caps, bundle, historyCfg);
+                registerOneBotHistoryAccessChecker(caps, historyCfg);
+            }
+            registerRequestTools(caps, bundle);
+        });
+    },
+});
 // ===== 群管理工具 =====
-function registerGroupManagementTools(ctx, bundle) {
+function registerGroupManagementTools(caps, bundle) {
+    const { platform, logger } = caps;
     const { group, personal } = bundle;
     // ---- 群禁言（单人）----
     group.register({
@@ -555,18 +574,18 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
             const duration = typeof args.duration === 'number' ? args.duration : 60;
-            const permError = await checkAdminPermission(ctx, selfId, groupId, String(args.user_id));
+            const permError = await checkAdminPermission(platform, selfId, groupId, String(args.user_id));
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_ban', {
+            await callAction(platform, selfId, 'set_group_ban', {
                 group_id: Number(groupId),
                 user_id: Number(args.user_id),
                 duration,
             });
             // 验证禁言是否生效
-            const info = await getGroupMemberInfo(ctx, selfId, groupId, String(args.user_id));
+            const info = await getGroupMemberInfo(platform, selfId, groupId, String(args.user_id));
             if (info && 'shut_up_timestamp' in info) {
                 const shutUp = Number(info.shut_up_timestamp);
                 const now = Math.floor(Date.now() / 1000);
@@ -602,11 +621,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId);
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_whole_ban', {
+            await callAction(platform, selfId, 'set_group_whole_ban', {
                 group_id: Number(groupId),
                 enable: !!args.enable,
             });
@@ -632,11 +651,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId, String(args.user_id));
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId, String(args.user_id));
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_kick', {
+            await callAction(platform, selfId, 'set_group_kick', {
                 group_id: Number(groupId),
                 user_id: Number(args.user_id),
                 reject_add_request: !!args.reject_add_request,
@@ -662,12 +681,12 @@ function registerGroupManagementTools(ctx, bundle) {
         },
         handler: async (args, callCtx) => {
             const argGroupId = args.group_id != null && String(args.group_id).trim() ? String(args.group_id).trim() : '';
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const parsed = parseOneBotSession(callCtx.sessionId);
             const groupId = argGroupId || (parsed?.detailType === 'group' ? parsed.targetId : '');
             if (!groupId)
                 return '请提供 group_id，或在要退出的群聊中调用此工具';
-            await callAction(ctx, selfId, 'set_group_leave', {
+            await callAction(platform, selfId, 'set_group_leave', {
                 group_id: Number(groupId),
                 is_dismiss: false,
             });
@@ -693,11 +712,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId);
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_card', {
+            await callAction(platform, selfId, 'set_group_card', {
                 group_id: Number(groupId),
                 user_id: Number(args.user_id),
                 card: String(args.card ?? ''),
@@ -723,11 +742,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId);
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_name', {
+            await callAction(platform, selfId, 'set_group_name', {
                 group_id: Number(groupId),
                 group_name: String(args.group_name),
             });
@@ -753,11 +772,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId, undefined, true);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId, undefined, true);
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_special_title', {
+            await callAction(platform, selfId, 'set_group_special_title', {
                 group_id: Number(groupId),
                 user_id: Number(args.user_id),
                 special_title: String(args.special_title ?? ''),
@@ -785,11 +804,11 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const permError = await checkAdminPermission(ctx, selfId, groupId, undefined, true);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const permError = await checkAdminPermission(platform, selfId, groupId, undefined, true);
             if (permError)
                 return permError;
-            await callAction(ctx, selfId, 'set_group_admin', {
+            await callAction(platform, selfId, 'set_group_admin', {
                 group_id: Number(groupId),
                 user_id: Number(args.user_id),
                 enable: !!args.enable,
@@ -815,8 +834,8 @@ function registerGroupManagementTools(ctx, bundle) {
         },
         handler: async (args, callCtx) => {
             // 不限制必须是群聊；只要能找到可用的 OneBot 账号即可
-            const selfId = resolveSelfId(ctx, callCtx, args);
-            await callAction(ctx, selfId, 'delete_msg', {
+            const selfId = resolveSelfId(platform, callCtx, args);
+            await callAction(platform, selfId, 'delete_msg', {
                 message_id: Number(args.message_id),
             });
             return `已撤回消息 ${args.message_id}`;
@@ -844,7 +863,7 @@ function registerGroupManagementTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const argGroupId = args.group_id != null && String(args.group_id).trim() ? String(args.group_id).trim() : '';
             const argUserId = args.user_id != null && String(args.user_id).trim() ? String(args.user_id).trim() : '';
             let targetSessionId;
@@ -858,7 +877,7 @@ function registerGroupManagementTools(ctx, bundle) {
                     return '当前不在 OneBot 会话中，请用 group_id 或 user_id 指定要撤回的目标会话。';
                 targetSessionId = callCtx.sessionId;
             }
-            const adapter = findOneBotAdapter(ctx);
+            const adapter = findOneBotAdapter(platform);
             if (!adapter?.getSentMessages) {
                 return '当前 OneBot 适配器版本未记录机器人发出的消息（不支持 getSentMessages）。如已知 message_id 可改用 onebot_delete_msg。';
             }
@@ -872,7 +891,7 @@ function registerGroupManagementTools(ctx, bundle) {
             const failed = [];
             for (const t of targets) {
                 try {
-                    await callAction(ctx, selfId, 'delete_msg', { message_id: Number(t.messageId) || t.messageId });
+                    await callAction(platform, selfId, 'delete_msg', { message_id: Number(t.messageId) || t.messageId });
                     adapter.forgetSentMessage?.(targetSessionId, t.messageId);
                     recalled.push(t.preview ? `「${t.preview}」` : `msg=${t.messageId}`);
                 }
@@ -889,10 +908,11 @@ function registerGroupManagementTools(ctx, bundle) {
             return msg;
         },
     });
-    ctx.logger.info('OneBot 群管理工具已注册');
+    logger.info('OneBot 群管理工具已注册');
 }
 // ===== 群信息查询工具 =====
-function registerGroupInfoTools(ctx, storage, bundle) {
+function registerGroupInfoTools(caps, storage, bundle) {
+    const { platform, logger } = caps;
     const { daily } = bundle;
     // ---- 查看合并转发 ----
     daily.register({
@@ -915,7 +935,7 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             if (!args.id)
                 return '参数错误：缺少 id（合并转发 ID）。请使用 <forward id="..."> 中的 id 字符串，不要使用 message_id。';
             const forwardId = String(args.id);
@@ -924,7 +944,7 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             // 并维护了一份接收时即抓取并展开（含摘要与图像识别）的缓存。
             let data;
             try {
-                data = await callAction(ctx, selfId, 'get_forward_msg', { id: forwardId });
+                data = await callAction(platform, selfId, 'get_forward_msg', { id: forwardId });
             }
             catch (err) {
                 return `合并转发读取失败：${err instanceof Error ? err.message : String(err)}。该转发可能已在协议端过期，或当前 OneBot 实现不支持跨会话读取。`;
@@ -937,7 +957,7 @@ function registerGroupInfoTools(ctx, storage, bundle) {
                 const summaryLine = entry.summary ? `\n摘要：${entry.summary}\n` : '\n';
                 return `${header}${summaryLine}\n原文：\n${entry.fullText}`;
             }
-            const formatContext = await recognizeForwardImages(ctx, storage, selfId, data, limit);
+            const formatContext = await recognizeForwardImages(caps, storage, selfId, data, limit);
             return formatForwardMessage(data, limit, formatContext);
         },
     });
@@ -958,8 +978,8 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const data = await callAction(ctx, selfId, 'get_group_info', {
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const data = await callAction(platform, selfId, 'get_group_info', {
                 group_id: Number(groupId),
             });
             return JSON.stringify(data);
@@ -983,9 +1003,9 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
             const userId = args.user_id ? String(args.user_id) : selfId;
-            const data = await callAction(ctx, selfId, 'get_group_member_info', {
+            const data = await callAction(platform, selfId, 'get_group_member_info', {
                 group_id: Number(groupId),
                 user_id: Number(userId),
                 no_cache: true,
@@ -1014,8 +1034,8 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            const data = await callAction(ctx, selfId, 'get_group_member_list', {
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            const data = await callAction(platform, selfId, 'get_group_member_list', {
                 group_id: Number(groupId),
             });
             const list = Array.isArray(data) ? data : [];
@@ -1078,7 +1098,7 @@ function registerGroupInfoTools(ctx, storage, bundle) {
         },
         handler: async (args, callCtx) => {
             const argGroupId = args.group_id != null && String(args.group_id).trim() ? String(args.group_id).trim() : '';
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const parsed = parseOneBotSession(callCtx.sessionId);
             let groupId = argGroupId;
             if (!groupId) {
@@ -1087,12 +1107,12 @@ function registerGroupInfoTools(ctx, storage, bundle) {
                 }
                 groupId = parsed.targetId;
             }
-            const adapter = findOneBotAdapter(ctx);
+            const adapter = findOneBotAdapter(platform);
             if (!adapter?.callAction)
                 return JSON.stringify({ available: false, reason: 'OneBot 适配器不可用' });
             let info = null;
             try {
-                info = (await callAction(ctx, selfId, 'get_group_member_info', {
+                info = (await callAction(platform, selfId, 'get_group_member_info', {
                     group_id: Number(groupId),
                     user_id: Number(selfId),
                     no_cache: true,
@@ -1141,7 +1161,7 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args) => {
-            const adapter = findOneBotAdapter(ctx);
+            const adapter = findOneBotAdapter(platform);
             if (!adapter?.getSelfMutes) {
                 return JSON.stringify({ supported: false, reason: '当前 OneBot 适配器版本不支持 getSelfMutes' });
             }
@@ -1186,11 +1206,11 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             if (!args.message_id)
                 return '参数错误：缺少 message_id';
             try {
-                const data = await callAction(ctx, selfId, 'get_msg', {
+                const data = await callAction(platform, selfId, 'get_msg', {
                     message_id: Number(args.message_id),
                 });
                 return JSON.stringify(data);
@@ -1222,19 +1242,20 @@ function registerGroupInfoTools(ctx, storage, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
             const honorType = typeof args.type === 'string' ? args.type : 'all';
-            const data = await callAction(ctx, selfId, 'get_group_honor_info', {
+            const data = await callAction(platform, selfId, 'get_group_honor_info', {
                 group_id: Number(groupId),
                 type: honorType,
             });
             return JSON.stringify(data);
         },
     });
-    ctx.logger.info('OneBot 群信息查询工具已注册');
+    logger.info('OneBot 群信息查询工具已注册');
 }
 // ===== 账号 / 好友 / 群列表查询工具 =====
-function registerAccountTools(ctx, bundle) {
+function registerAccountTools(caps, bundle) {
+    const { platform, logger } = caps;
     const { daily, personal } = bundle;
     // ---- 群列表 ----
     daily.register({
@@ -1258,8 +1279,8 @@ function registerAccountTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
-            const data = await callAction(ctx, selfId, 'get_group_list', {});
+            const selfId = resolveSelfId(platform, callCtx, args);
+            const data = await callAction(platform, selfId, 'get_group_list', {});
             const list = Array.isArray(data) ? data : [];
             const keyword = typeof args.keyword === 'string' ? args.keyword.trim().toLowerCase() : '';
             // 上限封顶，避免超大 limit 把整张列表灌进 LLM 上下文（token 浪费）。
@@ -1307,8 +1328,8 @@ function registerAccountTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
-            const data = await callAction(ctx, selfId, 'get_friend_list', {});
+            const selfId = resolveSelfId(platform, callCtx, args);
+            const data = await callAction(platform, selfId, 'get_friend_list', {});
             const list = Array.isArray(data) ? data : [];
             const keyword = typeof args.keyword === 'string' ? args.keyword.trim().toLowerCase() : '';
             // 上限封顶，避免超大 limit 把整张列表灌进 LLM 上下文（token 浪费）。
@@ -1355,8 +1376,8 @@ function registerAccountTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
-            const data = await callAction(ctx, selfId, 'get_stranger_info', {
+            const selfId = resolveSelfId(platform, callCtx, args);
+            const data = await callAction(platform, selfId, 'get_stranger_info', {
                 user_id: Number(args.user_id),
                 no_cache: !!args.no_cache,
             });
@@ -1374,8 +1395,8 @@ function registerAccountTools(ctx, bundle) {
             },
         },
         handler: async (_args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, _args);
-            const data = await callAction(ctx, selfId, 'get_login_info', {});
+            const selfId = resolveSelfId(platform, callCtx, _args);
+            const data = await callAction(platform, selfId, 'get_login_info', {});
             return JSON.stringify(data);
         },
     });
@@ -1397,21 +1418,22 @@ function registerAccountTools(ctx, bundle) {
         },
         handler: async (args, callCtx) => {
             const argUserId = args.user_id != null && String(args.user_id).trim() ? String(args.user_id).trim() : '';
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const parsed = parseOneBotSession(callCtx.sessionId);
             const userId = argUserId || (parsed?.detailType === 'private' ? parsed.targetId : '');
             if (!userId)
                 return '请提供 user_id，或在要删除的好友私聊中调用此工具';
-            await callAction(ctx, selfId, 'delete_friend', {
+            await callAction(platform, selfId, 'delete_friend', {
                 user_id: Number(userId),
             });
             return `已删除好友 ${userId}`;
         },
     });
-    ctx.logger.info('OneBot 账号 / 好友 / 群列表查询工具已注册');
+    logger.info('OneBot 账号 / 好友 / 群列表查询工具已注册');
 }
 // ===== 特殊交互工具 =====
-function registerInteractionTools(ctx, bundle) {
+function registerInteractionTools(caps, bundle) {
+    const { platform, logger } = caps;
     const { daily, group } = bundle;
     // ---- 戳一戳 ----
     daily.register({
@@ -1436,7 +1458,7 @@ function registerInteractionTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const parsed = parseOneBotSession(callCtx.sessionId);
             const argGroupId = args.group_id != null && String(args.group_id).trim() ? String(args.group_id).trim() : '';
             const argUserId = args.user_id != null && String(args.user_id).trim() ? String(args.user_id).trim() : '';
@@ -1447,13 +1469,13 @@ function registerInteractionTools(ctx, bundle) {
                     throw new Error('群聊戳一戳必须显式提供 user_id（要戳的对象）。');
                 }
                 try {
-                    await callAction(ctx, selfId, 'group_poke', {
+                    await callAction(platform, selfId, 'group_poke', {
                         group_id: Number(groupId),
                         user_id: Number(argUserId),
                     });
                 }
                 catch {
-                    await callAction(ctx, selfId, 'send_group_poke', {
+                    await callAction(platform, selfId, 'send_group_poke', {
                         group_id: Number(groupId),
                         user_id: Number(argUserId),
                     });
@@ -1467,10 +1489,10 @@ function registerInteractionTools(ctx, bundle) {
             }
             // NapCat: friend_poke { user_id }；其他实现可能用 send_poke
             try {
-                await callAction(ctx, selfId, 'friend_poke', { user_id: Number(userId) });
+                await callAction(platform, selfId, 'friend_poke', { user_id: Number(userId) });
             }
             catch {
-                await callAction(ctx, selfId, 'send_poke', { user_id: Number(userId) });
+                await callAction(platform, selfId, 'send_poke', { user_id: Number(userId) });
             }
             return `已戳了 ${userId} 一下`;
         },
@@ -1493,9 +1515,9 @@ function registerInteractionTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const selfId = resolveSelfId(ctx, callCtx, args);
+            const selfId = resolveSelfId(platform, callCtx, args);
             const times = Math.min(10, Math.max(1, typeof args.times === 'number' ? Math.floor(args.times) : 1));
-            await callAction(ctx, selfId, 'send_like', {
+            await callAction(platform, selfId, 'send_like', {
                 user_id: Number(args.user_id),
                 times,
             });
@@ -1519,25 +1541,26 @@ function registerInteractionTools(ctx, bundle) {
             },
         },
         handler: async (args, callCtx) => {
-            const { selfId, groupId } = resolveGroupTarget(ctx, callCtx, args);
-            await callAction(ctx, selfId, 'send_group_sign', {
+            const { selfId, groupId } = resolveGroupTarget(platform, callCtx, args);
+            await callAction(platform, selfId, 'send_group_sign', {
                 group_id: Number(groupId),
             });
             return '打卡成功';
         },
     });
-    ctx.logger.info('OneBot 特殊交互工具已注册');
+    logger.info('OneBot 特殊交互工具已注册');
 }
 /**
  * 把 OneBot 的细粒度访问规则注册到 session-history 服务。
  * 通用工具 session_get_history 和平台专属工具 onebot_get_session_history
  * 调用 service 时都会走这条规则链 —— 不存在绕过路径。
  */
-function registerOneBotHistoryAccessChecker(ctx, cfg) {
-    ctx.on('ready', () => {
-        const historyService = ctx.getService('session-history');
+function registerOneBotHistoryAccessChecker(caps, cfg) {
+    const { events, logger, lifecycle, sessionHistory } = caps;
+    events.on('app:ready', () => {
+        const historyService = sessionHistory.current;
         if (!historyService?.registerAccessChecker) {
-            ctx.logger.debug('session-history 服务未提供 registerAccessChecker, 跳过 OneBot 访问规则注册');
+            logger.debug('session-history 服务未提供 registerAccessChecker, 跳过 OneBot 访问规则注册');
             return;
         }
         const checker = {
@@ -1572,13 +1595,14 @@ function registerOneBotHistoryAccessChecker(ctx, cfg) {
             },
         };
         const dispose = historyService.registerAccessChecker(checker);
-        // 注意：总线上并不存在 'dispose' 事件——此前 ctx.on('dispose', ...) 永远不会
-        // 触发，access checker 在插件 bounce 后泄漏。正确挂法是 onDispose 清理链。
-        ctx.onDispose(dispose);
-        ctx.logger.info('OneBot 会话历史访问规则已注册到 session-history');
+        // 规则挂在 session-history 提供者身上，不随本插件的登记账本自动撤回：
+        // 必须进清理链，否则插件 bounce / 卸载后规则会留在下层泄漏。
+        lifecycle.onDispose(dispose);
+        logger.info('OneBot 会话历史访问规则已注册到 session-history');
     });
 }
-function registerSessionHistoryTools(ctx, bundle, cfg) {
+function registerSessionHistoryTools(caps, bundle, cfg) {
+    const { platform, logger, sessionHistory } = caps;
     const { daily } = bundle;
     daily.register({
         definition: {
@@ -1612,7 +1636,7 @@ function registerSessionHistoryTools(ctx, bundle, cfg) {
             if (!targetId)
                 return JSON.stringify({ error: 'target_id 不能为空' });
             const argSelfId = args.self_id ? String(args.self_id).trim() : '';
-            const selfId = argSelfId || current?.selfId || getAnyOneBotSelfId(ctx) || '';
+            const selfId = argSelfId || current?.selfId || getAnyOneBotSelfId(platform) || '';
             if (!selfId)
                 return JSON.stringify({ error: '无法确定 self_id，且未找到可用的 OneBot 连接' });
             // 跨账号限制：仅在当前也是 OneBot 会话时才作为参考点检查
@@ -1672,10 +1696,10 @@ function registerSessionHistoryTools(ctx, bundle, cfg) {
             if (!targetId)
                 return JSON.stringify({ error: 'target_id 不能为空' });
             const argSelfId = args.self_id ? String(args.self_id).trim() : '';
-            const selfId = argSelfId || current?.selfId || getAnyOneBotSelfId(ctx) || '';
+            const selfId = argSelfId || current?.selfId || getAnyOneBotSelfId(platform) || '';
             if (!selfId)
                 return JSON.stringify({ error: '无法确定 self_id，且未找到可用的 OneBot 连接' });
-            const history = ctx.getService('session-history');
+            const history = sessionHistory.current;
             if (!history)
                 return JSON.stringify({
                     error: 'session-history 服务不可用，请启用 @aalis/plugin-tool-session',
@@ -1698,19 +1722,20 @@ function registerSessionHistoryTools(ctx, bundle, cfg) {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                ctx.logger.warn(`onebot_get_session_history 失败 (${sessionId}): ${message}`);
+                logger.warn(`onebot_get_session_history 失败 (${sessionId}): ${message}`);
                 return JSON.stringify({ error: `读取 OneBot 会话历史失败: ${message}` });
             }
         },
     });
-    ctx.logger.info('OneBot 会话历史工具已注册');
+    logger.info('OneBot 会话历史工具已注册');
 }
 // ===== 请求处理工具（好友申请 / 群请求）=====
-function registerRequestTools(ctx, bundle) {
+function registerRequestTools(caps, bundle) {
+    const { platform, logger } = caps;
     const { group, personal } = bundle;
     /** 找到支持 handleFriendRequest 的 OneBot 适配器 */
-    function findRequestAdapter(ctx) {
-        const adapter = getPlatformAdapters(ctx).find(a => a.platform === 'onebot' && typeof a.handleFriendRequest === 'function');
+    function findRequestAdapter(platform) {
+        const adapter = getPlatformAdapters(platform).find(a => a.platform === 'onebot' && typeof a.handleFriendRequest === 'function');
         return adapter;
     }
     personal.register({
@@ -1731,7 +1756,7 @@ function registerRequestTools(ctx, bundle) {
             },
         },
         handler: async (args) => {
-            const adapter = findRequestAdapter(ctx);
+            const adapter = findRequestAdapter(platform);
             if (!adapter)
                 return '未找到支持请求处理的 OneBot 适配器';
             return adapter.handleFriendRequest(String(args.user_id), !!args.approve, args.remark ? String(args.remark) : undefined);
@@ -1760,7 +1785,7 @@ function registerRequestTools(ctx, bundle) {
             },
         },
         handler: async (args) => {
-            const adapter = findRequestAdapter(ctx);
+            const adapter = findRequestAdapter(platform);
             if (!adapter)
                 return '未找到支持请求处理的 OneBot 适配器';
             return adapter.handleGroupRequest(String(args.user_id), String(args.group_id), !!args.approve, args.reason ? String(args.reason) : undefined);
@@ -1785,12 +1810,12 @@ function registerRequestTools(ctx, bundle) {
             },
         },
         handler: async (args) => {
-            const adapter = findRequestAdapter(ctx);
+            const adapter = findRequestAdapter(platform);
             if (!adapter)
                 return '未找到支持请求处理的 OneBot 适配器';
             return adapter.handleGroupRequest(String(args.user_id), String(args.group_id), !!args.approve, args.reason ? String(args.reason) : undefined);
         },
     });
-    ctx.logger.info('OneBot 请求处理工具已注册');
+    logger.info('OneBot 请求处理工具已注册');
 }
 //# sourceMappingURL=index.js.map