@aalis/plugin-tool-onebot 0.9.3 → 0.11.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 as platformService, } from '@aalis/api-platform';
+import { sessionHistory } from '@aalis/api-session-history';
+import { createStorageGateway, storage } from '@aalis/api-storage';
+import { tools, withToolGroups } from '@aalis/api-tools';
+import { config, definePlugin, events, 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: {
@@ -43,9 +40,9 @@ export const configSchema = {
         fields: {
             enabled: {
                 type: 'boolean',
-                label: '启用 OneBot 会话历史读取',
+                label: '启用 OneBot 专属历史工具',
                 default: true,
-                description: '允许按群号/QQ 号读取对应 OneBot 会话的近期历史',
+                description: '注册 onebot_resolve_session_id / onebot_get_session_history（按群号/QQ 号读取近期历史）。只管这两个工具：下面的访问规则始终生效，同样约束通用的 session_get_history。',
             },
             maxLimit: {
                 type: 'number',
@@ -86,6 +83,17 @@ export const configSchema = {
         },
     },
 };
+// ===== 能力声明 =====
+const uses = {
+    tools: optional(tools),
+    platform: optional(platformService),
+    storage: optional(storage),
+    media: optional(media),
+    sessionHistory: optional(sessionHistory),
+    events,
+    logger,
+    config,
+};
 // ===== 辅助函数 =====
 /** 从 sessionId 解析 OneBot 连接信息 */
 function parseOneBotSession(sessionId) {
@@ -98,16 +106,16 @@ 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?.() ?? [];
+        const conns = a.getConnections();
         const online = conns.find(c => c.status === 'online' && c.selfId);
         if (online?.selfId)
             return online.selfId;
@@ -122,14 +130,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 +146,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);
@@ -149,20 +157,6 @@ function resolveGroupTarget(ctx, callCtx, args) {
     }
     throw new Error('未提供 group_id，且当前不在 OneBot 群会话中。请在参数中显式传入 group_id。');
 }
-/**
- * 解析"目标用户"：args.user_id 优先；否则当前会话必须是 OneBot 私聊。
- */
-function _resolveUserTarget(ctx, callCtx, args) {
-    const argUserId = args.user_id != null && String(args.user_id).trim() ? String(args.user_id).trim() : '';
-    const selfId = resolveSelfId(ctx, callCtx, args);
-    if (argUserId)
-        return { selfId, userId: argUserId };
-    const parsed = parseOneBotSession(callCtx.sessionId);
-    if (parsed?.detailType === 'private' && parsed.targetId) {
-        return { selfId: parsed.selfId, userId: parsed.targetId };
-    }
-    throw new Error('未提供 user_id，且当前不在 OneBot 私聊会话中。请在参数中显式传入 user_id。');
-}
 function buildOneBotSessionId(selfId, detailType, targetId) {
     return `onebot:${selfId}:${detailType}:${targetId}`;
 }
@@ -171,8 +165,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);
@@ -234,7 +228,7 @@ function extractCqImageRefs(content) {
         }
         const source = imageSourceFromSegment(params);
         if (source)
-            refs.push({ source, label: '[图片]', segment: params });
+            refs.push({ source, segment: params });
         match = re.exec(content);
     }
     return refs;
@@ -254,7 +248,7 @@ function extractImageRefsFromContent(content) {
         const data = segment.data ?? {};
         const source = imageSourceFromSegment(data);
         if (source)
-            refs.push({ source, label: '[图片]', segment: data });
+            refs.push({ source, segment: data });
     }
     return refs;
 }
@@ -287,11 +281,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 +298,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) {
+        logger.debug(`合并转发包含 ${refs.length} 张图片，但 media 服务不可用`);
         return { imageDescriptions };
     }
     const seen = new Set();
@@ -325,20 +321,18 @@ 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 };
 }
 function formatMessageContent(content, context) {
-    if (typeof content === 'string')
-        return content;
     if (!Array.isArray(content))
         return content == null ? '' : JSON.stringify(content);
     return content
@@ -354,9 +348,7 @@ function formatMessageContent(content, context) {
                 return data.qq === 'all' ? '@全体成员' : `@${String(data.qq ?? '')}`;
             case 'image': {
                 const source = imageSourceFromSegment(data);
-                const desc = source
-                    ? context?.imageDescriptions.get(imageRefKey({ source, label: '[图片]', segment: data }))
-                    : undefined;
+                const desc = source ? context?.imageDescriptions.get(imageRefKey({ source, segment: data })) : undefined;
                 return desc ? `[图片: ${desc}]` : '[图片]';
             }
             case 'face':
@@ -423,9 +415,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 +428,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 +440,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,38 +452,20 @@ 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 平台可用时才注册工具
-    // 使用 app:ready 事件确保平台已加载
-    ctx.on('app: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 账号本身的人际关系：退群、删好友、处理好友申请、接受/拒绝入群邀请',
-        });
+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']),
+        };
         const cfg = {
             groupManagement: { enabled: true, ...(config.groupManagement ?? {}) },
             groupInfo: { enabled: true, ...(config.groupInfo ?? {}) },
@@ -508,33 +482,71 @@ export function apply(ctx, config) {
                 ...(config.sessionHistory ?? {}),
             },
         };
-        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,
-            };
-            registerSessionHistoryTools(ctx, bundle, historyCfg);
-            registerOneBotHistoryAccessChecker(ctx, historyCfg);
-        }
-        registerRequestTools(ctx, bundle);
-    });
-}
+        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,
+        };
+        // 访问规则始终注册：它同样约束通用的 session_get_history，不随专属工具开关撤掉（关掉工具不能反倒放宽读取）。
+        // 规则只对 onebot 会话 id 表态，与 OneBot 平台在不在场无关：不进下面的平台闸。
+        registerOneBotHistoryAccessChecker(caps, historyCfg);
+        // 仅当 OneBot 平台可用时才注册工具。platform 是可选的多提供者服务，OneBot 适配器可能晚于
+        // app:ready 上线（WebUI 启用、市场热装、启动失败后修好），且作为非胜者上线时 follow 不触发：
+        // 故在 app:ready 与每次 platform 提供者注册时各判一次，出现 onebot 即注册，之后不再重复。
+        // 平台离场不反注册：工具调用时找不到 OneBot 连接本就会报错。
+        let toolsRegistered = false;
+        const registerToolsOnce = () => {
+            if (toolsRegistered || !getPlatformNames(platform).includes('onebot'))
+                return;
+            toolsRegistered = true;
+            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 账号本身的人际关系：退群、删好友、处理好友申请、接受/拒绝入群邀请',
+            });
+            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)
+                registerSessionHistoryTools(caps, bundle, historyCfg);
+            registerRequestTools(caps, bundle);
+        };
+        events.on('app:ready', () => {
+            registerToolsOnce();
+            if (!toolsRegistered)
+                logger.info('未检测到 OneBot 平台，暂不注册 OneBot 工具（平台上线后自动补注册）');
+        });
+        events.on('service:registered', name => {
+            if (name === platformService.name)
+                registerToolsOnce();
+        });
+    },
+});
 // ===== 群管理工具 =====
-function registerGroupManagementTools(ctx, bundle) {
+function registerGroupManagementTools(caps, bundle) {
+    const { platform, logger } = caps;
     const { group, personal } = bundle;
     // ---- 群禁言（单人）----
     group.register({
@@ -555,18 +567,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 +614,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 +644,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 +674,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 +705,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 +735,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 +765,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 +797,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 +827,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 +856,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,9 +870,9 @@ 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。';
+                return '未找到支持记录自身发出消息的 OneBot 适配器（getSentMessages 不在平台契约内，第三方适配器可不提供）。如已知 message_id 可改用 onebot_delete_msg。';
             }
             const count = Math.max(1, Math.min(10, Math.floor(Number(args.count) || 1)));
             const recent = adapter.getSentMessages(targetSessionId, 10); // 新→旧
@@ -872,7 +884,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 +901,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 +928,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 +937,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 +950,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 +971,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 +996,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 +1027,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 +1091,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 +1100,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,9 +1154,12 @@ 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' });
+                return JSON.stringify({
+                    supported: false,
+                    reason: '未找到支持记录自身禁言状态的 OneBot 适配器（getSelfMutes 不在平台契约内，第三方适配器可不提供）',
+                });
             }
             const limit = Math.max(1, Math.min(200, Math.floor(Number(args.limit) || 30)));
             const offset = Math.max(0, Math.floor(Number(args.offset) || 0));
@@ -1186,11 +1202,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 +1238,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 +1275,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 +1324,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 +1372,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 +1391,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 +1414,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 +1454,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 +1465,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 +1485,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 +1511,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,66 +1537,63 @@ 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('app:ready', () => {
-        const historyService = ctx.getService('session-history');
-        if (!historyService?.registerAccessChecker) {
-            ctx.logger.debug('session-history 服务未提供 registerAccessChecker, 跳过 OneBot 访问规则注册');
-            return;
-        }
-        const checker = {
-            platform: 'onebot',
-            check({ currentSessionId, targetSessionId }) {
-                const target = parseOneBotSession(targetSessionId);
-                if (!target)
-                    return undefined; // 不是合法 onebot 目标, 不表态
-                const current = parseOneBotSession(currentSessionId);
-                // 跨平台调用（current 不是 onebot）走默认放行: session-history scope 已粗筛
-                if (!current)
-                    return undefined;
-                if (current.selfId !== target.selfId && !cfg.allowCrossSelf) {
-                    return { decision: 'deny', reason: '当前 OneBot 配置不允许跨机器人账号读取会话历史' };
-                }
-                if (current.detailType === 'group' && target.detailType === 'private' && !cfg.allowGroupReadPrivate) {
-                    return { decision: 'deny', reason: '当前 OneBot 配置不允许从群聊读取私聊历史' };
-                }
-                if (current.detailType === 'group' &&
-                    target.detailType === 'group' &&
-                    current.targetId !== target.targetId &&
-                    !cfg.allowCrossGroup) {
-                    return { decision: 'deny', reason: '当前 OneBot 配置不允许跨群读取其他群历史' };
-                }
-                if (current.detailType === 'private' &&
-                    target.detailType === 'private' &&
-                    current.targetId !== target.targetId &&
-                    !cfg.allowCrossPrivate) {
-                    return { decision: 'deny', reason: '当前 OneBot 配置不允许跨私聊读取其他私聊历史' };
-                }
+function registerOneBotHistoryAccessChecker(caps, cfg) {
+    const { logger, sessionHistory } = caps;
+    const checker = {
+        platform: 'onebot',
+        check({ currentSessionId, targetSessionId }) {
+            const target = parseOneBotSession(targetSessionId);
+            if (!target)
+                return undefined; // 不是合法 onebot 目标, 不表态
+            const current = parseOneBotSession(currentSessionId);
+            // 跨平台调用（current 不是 onebot）走默认放行: session-history scope 已粗筛
+            if (!current)
                 return undefined;
-            },
-        };
-        const dispose = historyService.registerAccessChecker(checker);
-        // 注意：总线上并不存在 'dispose' 事件——此前 ctx.on('dispose', ...) 永远不会
-        // 触发，access checker 在插件 bounce 后泄漏。正确挂法是 onDispose 清理链。
-        ctx.onDispose(dispose);
-        ctx.logger.info('OneBot 会话历史访问规则已注册到 session-history');
+            if (current.selfId !== target.selfId && !cfg.allowCrossSelf) {
+                return { decision: 'deny', reason: '当前 OneBot 配置不允许跨机器人账号读取会话历史' };
+            }
+            if (current.detailType === 'group' && target.detailType === 'private' && !cfg.allowGroupReadPrivate) {
+                return { decision: 'deny', reason: '当前 OneBot 配置不允许从群聊读取私聊历史' };
+            }
+            if (current.detailType === 'group' &&
+                target.detailType === 'group' &&
+                current.targetId !== target.targetId &&
+                !cfg.allowCrossGroup) {
+                return { decision: 'deny', reason: '当前 OneBot 配置不允许跨群读取其他群历史' };
+            }
+            if (current.detailType === 'private' &&
+                target.detailType === 'private' &&
+                current.targetId !== target.targetId &&
+                !cfg.allowCrossPrivate) {
+                return { decision: 'deny', reason: '当前 OneBot 配置不允许跨私聊读取其他私聊历史' };
+            }
+            return undefined;
+        },
+    };
+    // 规则登记在 session-history 提供者实例的局部状态里：提供者重启或换人后，新实例身上没有这条规则，
+    // 须跟随提供者重挂；返回的注销作为跟随清理，本插件 bounce / 卸载时一并撤回，不在下层泄漏。
+    sessionHistory.follow(svc => {
+        const dispose = svc.registerAccessChecker(checker);
+        logger.info('OneBot 会话历史访问规则已注册到 session-history');
+        return dispose;
     });
 }
-function registerSessionHistoryTools(ctx, bundle, cfg) {
+function registerSessionHistoryTools(caps, bundle, cfg) {
+    const { platform, logger, sessionHistory } = caps;
     const { daily } = bundle;
     daily.register({
         definition: {
@@ -1612,7 +1627,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 +1687,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 +1713,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 +1747,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 +1776,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 +1801,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