mioku-plugin-chat 2.10.1 → 3.0.0

package/humanize/emotion-agent.ts

@@ -1,5 +1,5 @@
 import type { AIInstance } from "mioku";
-import { logger } from "mioki";
+import { logger } from "mioku";
 import { extractJsonObject } from "../utils/json";
 import type { ChatConfig, ChatMessage, TargetMessage } from "../types";
 import { extractGroupIdFromSession } from "../utils/group-config";

package/humanize/expression.ts

@@ -1,5 +1,5 @@
 import type { AIInstance } from "mioku";
-import { logger } from "mioki";
+import { logger } from "mioku";
 import { extractJsonObject } from "../utils/json";
 import type { ChatDatabase } from "../db";
 import type { ChatMessage } from "../types";

package/humanize/memory.ts

@@ -1,5 +1,5 @@
 import type { AIInstance } from "mioku";
-import { logger } from "mioki";
+import { logger } from "mioku";
 import type { ChatDatabase } from "../db";
 import type { ChatMessage } from "../types";
 import { extractGroupIdFromSession } from "../utils/group-config";

package/humanize/planner.ts

@@ -1,5 +1,5 @@
 import type { AIInstance } from "mioku";
-import { logger } from "mioki";
+import { logger } from "mioku";
 import type {
   ChatMessage,
   PlannerAction,

package/humanize/topic.ts

@@ -1,5 +1,5 @@
 import type { AIInstance } from "mioku";
-import { logger } from "mioki";
+import { logger } from "mioku";
 import { extractJsonObject } from "../utils/json";
 import type { ChatDatabase } from "../db";
 import type { ChatMessage } from "../types";

package/index.ts

@@ -1,4 +1,4 @@
-import { definePlugin, type MiokiContext } from "mioki";
+import { definePlugin, type MiokuContext } from "mioku";
 import type { AIInstance, AIModelRole, AIService } from "mioku";
 import type { AudioServiceApi } from "mioku-service-audio";
 import { getPluginRuntimeState, getService, Services } from "mioku";
@@ -117,7 +117,7 @@ export default definePlugin({
   name: "chat",
   version: "1.1.0",
   description: "AI 智能聊天插件",
-  async setup(ctx: MiokiContext) {
+  async setup(ctx: MiokuContext) {
     ctx.logger.info("聊天插件正在初始化...");
 
     const aiService = getService(ctx, Services.AI);
@@ -497,7 +497,7 @@ roleModels = resolved.models;
         processingSet,
       },
       matchMessageCommands: (
-        getPluginRuntimeState("boot") as
+        getPluginRuntimeState("core") as
           | {
               matchMessageCommands?: (
                 text: string,

package/manage/cleanup.ts

@@ -1,4 +1,4 @@
-import { logger } from "mioki";
+import { logger } from "mioku";
 import type { ChatDatabase } from "../db";
 
 export interface CleanupConfig {

package/manage/cooldown.ts

@@ -1,4 +1,4 @@
-import type { MiokiContext } from "mioki";
+import type { MiokuContext } from "mioku";
 import type { AIInstance } from "mioku";
 import type { ChatConfig, TargetMessage } from "../types";
 import type { ChatDatabase } from "../db";
@@ -39,7 +39,7 @@ export class CooldownManager {
   private pluginCtx: ChatPluginContext;
   private sessionTurnScheduler: SessionTurnScheduler;
 
-  private ctx: MiokiContext;
+  private ctx: MiokuContext;
   private configProvider: ChatConfigProvider;
   private defaultConfig: ChatConfig;
   private db: ChatDatabase;
@@ -206,7 +206,7 @@ export class CooldownManager {
       this.buildHistoryMediaOptions(this.aiInstance, cfg),
     );
     const botNickname =
-      cfg.nicknames[0] || this.ctx.pickBot(selfId).nickname || "Bot";
+      cfg.nicknames[0] || this.ctx.pickBot(selfId)?.nickname || "Bot";
     const botRole = await getBotRole(groupId, this.ctx, selfId);
     const { groupName, memberCount } = await this.getGroupInfoData(
       this.ctx,
@@ -316,7 +316,7 @@ export class CooldownManager {
       this.buildHistoryMediaOptions(this.aiInstance, cfg),
     );
     const botNickname =
-      cfg.nicknames[0] || this.ctx.pickBot(selfId).nickname || "Bot";
+      cfg.nicknames[0] || this.ctx.pickBot(selfId)?.nickname || "Bot";
 
     const planResult = await this.humanize.actionPlanner.plan(
       groupSessionId,

package/manage/idle-check.ts

@@ -1,4 +1,4 @@
-import type { MiokiContext } from "mioki";
+import type { MiokuContext } from "mioku";
 import type { AIInstance } from "mioku";
 import type { ChatConfig, TargetMessage } from "../types";
 import type { ChatDatabase } from "../db";
@@ -28,7 +28,7 @@ export class IdleCheckManager {
   private groupBotsMapping = new Map<string, Set<number>>();
   private intervalHandle: NodeJS.Timeout | null = null;
 
-  private ctx: MiokiContext;
+  private ctx: MiokuContext;
   private configProvider: ChatConfigProvider;
   private defaultConfig: ChatConfig;
   private db: ChatDatabase;
@@ -106,7 +106,7 @@ export class IdleCheckManager {
 
       const now = Date.now();
       const checkInterval = 60_000;
-      const allBotIds = Array.from(this.ctx.bots).map((bot) => bot.uin);
+      const allBotIds = Array.from(this.ctx.bots).map((bot) => Number(bot.bot_id));
 
       for (const [groupSessionId, lastTime] of this.groupLastActivityTime) {
         const lastCheckTime =
@@ -216,7 +216,7 @@ export class IdleCheckManager {
       this.buildHistoryMediaOptions(this.aiInstance, cfg),
     );
     const botNickname =
-      cfg.nicknames[0] || this.ctx.pickBot(selfId).nickname || "Bot";
+      cfg.nicknames[0] || this.ctx.pickBot(selfId)?.nickname || "Bot";
     const planResult = await this.humanize.actionPlanner.plan(
       groupSessionId,
       botNickname,

package/manage/queue-processor.ts

@@ -1,4 +1,4 @@
-import type { MiokiContext } from "mioki";
+import type { MiokuContext } from "mioku";
 import type { AIInstance } from "mioku";
 import type { ChatConfig, TargetMessage } from "../types";
 import type { ChatDatabase } from "../db";
@@ -34,7 +34,7 @@ export class QueueProcessor {
   private dynamicDelayQueues = new Map<string, DynamicDelayQueueData>();
   private pluginCtx: ChatPluginContext;
 
-  private ctx: MiokiContext;
+  private ctx: MiokuContext;
   private configProvider: ChatConfigProvider;
   private defaultConfig: ChatConfig;
   private db: ChatDatabase;
@@ -177,7 +177,7 @@ export class QueueProcessor {
 
     const cfg = this.configProvider(groupId);
     const botRole = await getBotRole(groupId, this.ctx, selfId);
-    const botNickname = cfg.nicknames[0] || this.ctx.pickBot(selfId).nickname || "Bot";
+    const botNickname = cfg.nicknames[0] || this.ctx.pickBot(selfId)?.nickname || "Bot";
     const { groupName, memberCount } = await this.getGroupInfoData(this.ctx, groupId, selfId, String(groupId));
     const { history } = await this.getGroupHistoryMessages(groupId, groupSessionId, this.ctx, cfg.historyCount, this.db, selfId, this.buildHistoryMediaOptions(this.aiInstance, cfg));
 
@@ -261,7 +261,7 @@ export class QueueProcessor {
       };
 
       const botRole = await getBotRole(groupId, this.ctx, selfId);
-      const botNickname = cfg.nicknames[0] || this.ctx.pickBot(selfId).nickname || "Bot";
+      const botNickname = cfg.nicknames[0] || this.ctx.pickBot(selfId)?.nickname || "Bot";
       const toolCtx = this.buildToolContext({
         ctx: this.ctx, event: null, groupSessionId, groupId, userId: targetMessage.userId,
         config: cfg, aiService: this.aiService, db: this.db, botRole, humanize: this.humanize, targetMessage, selfId,

package/manage/types.ts

@@ -1,13 +1,22 @@
-import type { MiokiContext } from "mioki";
+import type { Bot, MiokuContext } from "mioku";
 import type { AIInstance, AIService } from "mioku";
 import type { SkillPermissionRole } from "mioku";
 import type { ChatRuntimePromptInjection } from "mioku";
-import type { ChatConfig, ChatMessage, TargetMessage, ToolContext, ChatResult } from "../types";
+import type {
+  ChatConfig,
+  ChatMessage,
+  TargetMessage,
+  ToolContext,
+  ChatResult,
+} from "../types";
 import type { ChatDatabase } from "../db";
 import type { HumanizeEngine } from "../humanize";
 import type { EmojiAgent } from "../humanize";
 import type { SkillSessionManager } from "./skill-session";
-import type { GroupStructuredHistoryManager, StructuredUserInput } from "./group-structured-history";
+import type {
+  GroupStructuredHistoryManager,
+  StructuredUserInput,
+} from "./group-structured-history";
 import type { SendAIResponseOptions } from "../core/base";
 import type { GroupInfoResult, HumanizeContextsResult } from "../core/base";
 
@@ -32,7 +41,7 @@ export type RunRateLimitGuard = <T>(
 export type GetGroupHistoryMessages = (
   groupId: number,
   groupSessionId: string,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   historyCount: number,
   db: ChatDatabase,
   selfId: number,
@@ -40,7 +49,7 @@ export type GetGroupHistoryMessages = (
 ) => Promise<{ history: ChatMessage[] }>;
 
 export type GetGroupInfoData = (
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   groupId: number,
   selfId: number,
   fallbackGroupName?: string,
@@ -54,7 +63,10 @@ export type GetHumanizeContexts = (
   triggerUserId?: number,
 ) => Promise<HumanizeContextsResult>;
 
-export type SendAIResponse = (options: SendAIResponseOptions, selfId: number) => Promise<void>;
+export type SendAIResponse = (
+  options: SendAIResponseOptions,
+  selfId: number,
+) => Promise<void>;
 
 export type SaveBotMessages = (
   groupId: number,
@@ -63,14 +75,19 @@ export type SaveBotMessages = (
   timestamp: number,
   config: ChatConfig,
   db: ChatDatabase,
-  ctx: MiokiContext,
-  selfId: number,
+  ctx: MiokuContext,
+  bot?: Bot,
 ) => void;
 
-export type SendEmoji = (ctx: MiokiContext, groupId: number, emojiPath: string | null | undefined, selfId: number) => Promise<void>;
+export type SendEmoji = (
+  ctx: MiokuContext,
+  groupId: number,
+  emojiPath: string | null | undefined,
+  bot?: import("mioku").Bot,
+) => Promise<void>;
 
 export type SendMessage = (
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   groupId: number | undefined,
   userId: number,
   text: string,
@@ -80,7 +97,7 @@ export type SendMessage = (
 ) => Promise<void>;
 
 export type BuildToolContext = (options: {
-  ctx: MiokiContext;
+  ctx: MiokuContext;
   event: any;
   selfId: number;
   groupSessionId: string;
@@ -96,9 +113,15 @@ export type BuildToolContext = (options: {
   audioService?: import("mioku-service-audio").AudioServiceApi;
 }) => ToolContext;
 
-export type BuildStructuredUserInput = (event: any, content: string, fallbackTimestamp?: number) => StructuredUserInput;
+export type BuildStructuredUserInput = (
+  event: any,
+  content: string,
+  fallbackTimestamp?: number,
+) => StructuredUserInput;
 
-export type BuildStructuredUserInputFromTarget = (targetMessage: TargetMessage) => StructuredUserInput;
+export type BuildStructuredUserInputFromTarget = (
+  targetMessage: TargetMessage,
+) => StructuredUserInput;
 
 export type PromptCtxForRunChat = {
   config: ChatConfig;
@@ -143,4 +166,4 @@ export type RunChat = (
     currentUserInputs: StructuredUserInput[];
   },
   runtimeOptions?: { extraTools?: any[] },
-) => Promise<ChatResult>;
+) => Promise<ChatResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-chat",
-  "version": "2.10.1",
+  "version": "3.0.0",
   "description": "AI 智能聊天插件",
   "main": "index.ts",
   "type": "module",
@@ -54,12 +54,10 @@
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
-    "mioki": "^0.16.0",
     "mioku": "workspace:*"
   },
   "peerDependencies": {
-    "mioku": "^0.9.0",
-    "mioku-service-audio": "workspace:*",
-    "mioki": "^0.16.0"
+    "mioku": "^1.0.0",
+    "mioku-service-audio": "workspace:*"
   }
 }

package/types.ts

@@ -1,5 +1,5 @@
 import type { ChatCompletionMessageParam } from "openai/resources/chat/completions";
-import type { MiokiContext } from "mioki";
+import type { MiokuContext } from "mioku";
 import type { AITool, AIService, SkillPermissionRole } from "mioku";
 import type { ChatDatabase } from "./db";
 
@@ -300,7 +300,7 @@ export interface SkillSession {
  * 工具上下文
  */
 export interface ToolContext {
-  ctx: MiokiContext;
+  ctx: MiokuContext;
   event: any;
   sessionId: string;
   groupId?: number;

package/utils/message.ts

@@ -1,5 +1,6 @@
-import { logger, MiokiContext } from "mioki";
-import type { AIInstance } from "mioku";
+import { HistoryMessage, logger, type MiokuContext } from "mioku";
+import type { AIInstance, Bot } from "mioku";
+
 import type {
   ChatConfig,
   ChatMessage,
@@ -22,13 +23,15 @@ export function shouldTrigger(
   e: any,
   text: string,
   cfg: ChatConfig,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
 ): boolean {
   if (e.message_type === "private") return false;
 
-  // Only check if message @s the bot (seg format: {type: "at", qq: "123456"})
   const atSeg = e.message?.find((seg: any) => seg.type === "at");
-  return !!(atSeg && String(atSeg.qq) === String(e.self_id));
+  if (!atSeg) return false;
+  const data = (atSeg.data ?? {}) as { qq?: unknown; target?: unknown };
+  const qq = data.qq ?? data.target;
+  return String(qq ?? "") === String(e.self_id ?? "");
 }
 
 /**
@@ -37,15 +40,15 @@ export function shouldTrigger(
  */
 export async function isQuotingBot(
   e: any,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
 ): Promise<{ quoted: true; messageId: string; content: string } | null> {
   if (e.quote_id) {
     try {
-      const quoteMsg = await ctx.getQuoteMsg(e);
-      if (quoteMsg && String(quoteMsg.sender.user_id) === String(e.self_id)) {
+      const quoteMsg = await fetchQuotedMessage(e, ctx);
+      if (quoteMsg && String(quoteMsg.sender?.user_id) === String(e.self_id)) {
         const quotedText = quoteMsg.message
           ?.filter((s: any) => s.type === "text")
-          .map((s: any) => s.text)
+          .map((s: any) => String(s.data?.text ?? s.text ?? ""))
           .join("");
         if (quotedText) {
           return { quoted: true, messageId: e.quote_id, content: quotedText };
@@ -65,7 +68,7 @@ export async function isQuotingBot(
  */
 export async function getQuotedContent(
   e: any,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
 ): Promise<
   | {
       messageId: string;
@@ -78,13 +81,13 @@ export async function getQuotedContent(
 > {
   if (e.quote_id) {
     try {
-      const quotedMsg = await ctx.getQuoteMsg(e);
+      const quotedMsg = await fetchQuotedMessage(e, ctx);
       if (quotedMsg && quotedMsg.message) {
-        const senderName = quotedMsg.sender.nickname;
+        const senderName = quotedMsg.sender?.nickname || "";
         // 提取文本内容
         const textContent = quotedMsg.message
           .filter((s: any) => s.type === "text")
-          .map((s: any) => s.text || "")
+          .map((s: any) => String(s.data?.text ?? s.text ?? ""))
           .join("");
 
         // 检测是否有图片
@@ -120,7 +123,7 @@ export function isGroupAllowed(groupId: number, cfg: ChatConfig): boolean {
 export function extractContent(
   e: any,
   cfg: ChatConfig,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
 ): { text: string; multimodal: any[] | null } {
   let text = "";
   try {
@@ -129,9 +132,12 @@ export function extractContent(
 
   // If text is empty but user @'d the bot, describe the action
   if (!text.trim() && e.message) {
-    const hasAt = e.message.some(
-      (seg: any) => seg.type === "at" && String(seg.qq) === String(e.self_id),
-    );
+    const hasAt = e.message.some((seg: any) => {
+      if (seg.type !== "at") return false;
+      const data = (seg.data ?? {}) as { qq?: unknown; target?: unknown };
+      const qq = data.qq ?? data.target;
+      return String(qq ?? "") === String(e.self_id ?? "");
+    });
     if (hasAt) {
       text = "[@you with no text]";
     }
@@ -190,14 +196,14 @@ async function mapWithConcurrency<T, R>(
 
 export async function getBotRole(
   groupId: number,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   selfId: number,
 ): Promise<"owner" | "admin" | "member"> {
   try {
-    const memberInfo = await ctx
-      .pickBot(selfId)
-      .getGroupMemberInfo(groupId, selfId);
-    return (memberInfo.role as "owner" | "admin" | "member") || "member";
+    const bot = ctx.pickBot(selfId);
+    if (!bot) return "member";
+    const memberInfo = await bot.getMemberInfo(groupId, selfId);
+    return (memberInfo?.role as "owner" | "admin" | "member") || "member";
   } catch {
     return "member";
   }
@@ -237,11 +243,11 @@ async function resolveMemberName(
   }
   ctx.memberNameCache.set(key, key);
   try {
-    const bot = ctx.historyMediaOptions.bot as any;
-    if (!bot || typeof bot.getGroupMemberInfo !== "function") return key;
-    const info = await bot.getGroupMemberInfo(
-      ctx.historyMediaOptions.groupId,
-      Number(userId),
+    const bot = ctx.historyMediaOptions.bot as Bot | undefined;
+    if (!bot) return key;
+    const info = await bot.getMemberInfo(
+      ctx.historyMediaOptions.groupId!,
+      userId,
     );
     const name = info?.card || info?.nickname || key;
     ctx.memberNameCache.set(key, name);
@@ -278,7 +284,10 @@ function extractQuotedText(messageSegs: any): string {
   return parts.join(" ").trim();
 }
 
-function buildReplyAnnotation(source: any, ctx: HistoryFormatContext): string | null {
+function buildReplyAnnotation(
+  source: any,
+  ctx: HistoryFormatContext,
+): string | null {
   if (!source || typeof source !== "object") return null;
   const sourceId = source.id ?? source.message_id ?? source.message_seq;
   const sourceUserId = source.user_id;
@@ -291,7 +300,8 @@ function buildReplyAnnotation(source: any, ctx: HistoryFormatContext): string |
   const idStr = sourceId != null ? String(sourceId) : "?";
   let displayName: string | undefined;
   if (sourceUserId != null) {
-    displayName = ctx.memberNameCache.get(String(sourceUserId)) || String(sourceUserId);
+    displayName =
+      ctx.memberNameCache.get(String(sourceUserId)) || String(sourceUserId);
   }
   if (!displayName) displayName = sourceNickname || "unknown";
 
@@ -334,7 +344,7 @@ async function getImageTagWithHashCache(
 }
 
 async function formatHistoryMessage(
-  msg: any,
+  msg: HistoryMessage,
   ctx: HistoryFormatContext,
 ): Promise<FormattedHistoryMessage | null> {
   if (String(msg.user_id) === String(ctx.botUin)) return null;
@@ -350,12 +360,12 @@ async function formatHistoryMessage(
   if (!content.trim()) return null;
 
   return {
-    userId: msg.user_id,
-    userName: msg.sender?.card || msg.sender?.nickname || String(msg.user_id),
-    userRole: msg.sender?.role || "member",
+    userId: Number(msg.user_id || 0),
+    userName: msg.nickname || String(msg.user_id || "unknown"),
+    userRole: "member",
     content,
-    messageId: msg.message_id,
-    timestamp: msg.time ? msg.time * 1000 : Date.now(),
+    messageId: Number(msg.message_id) || 0,
+    timestamp: msg.time ?? Date.now(),
     role: "user",
   };
 }
@@ -427,17 +437,24 @@ async function buildMessageContent(
   )) {
     const videoSources = getSegmentSourceCandidates(videoSeg);
     if (videoSources.length > 0) {
-      parts.push(await getCachedHistoryVideoTag(videoSources, historyMediaOptions));
+      parts.push(
+        await getCachedHistoryVideoTag(videoSources, historyMediaOptions),
+      );
     } else {
       parts.push("[video]");
     }
   }
 
-  for (const forwardSeg of msg.message.filter((seg: any) => seg.type === "forward")) {
+  for (const forwardSeg of msg.message.filter(
+    (seg: any) => seg.type === "forward",
+  )) {
     const forwardId = forwardSeg.id || forwardSeg.data?.id;
     if (forwardId) {
       parts.push(
-        await getCachedHistoryForwardTag(String(forwardId), historyMediaOptions),
+        await getCachedHistoryForwardTag(
+          String(forwardId),
+          historyMediaOptions,
+        ),
       );
     } else {
       parts.push("[forward]");
@@ -448,7 +465,11 @@ async function buildMessageContent(
     ["xml", "json", "lightapp", "ark"].includes(seg.type),
   )) {
     const cardData =
-      cardSeg.data?.data || cardSeg.data?.xml || cardSeg.data || cardSeg.xml || "";
+      cardSeg.data?.data ||
+      cardSeg.data?.xml ||
+      cardSeg.data ||
+      cardSeg.xml ||
+      "";
     if (cardData) {
       parts.push(
         getCachedHistoryCardTag(
@@ -464,7 +485,9 @@ async function buildMessageContent(
   if (parts.length > 0) return parts.join(" ");
 
   const segTypes = msg.message.map((seg: any) => seg.type);
-  const nonTextTypes = segTypes.filter((t: string) => t !== "text" && t !== "at");
+  const nonTextTypes = segTypes.filter(
+    (t: string) => t !== "text" && t !== "at",
+  );
   return nonTextTypes.length > 0 ? `[${nonTextTypes.join(", ")}]` : "";
 }
 
@@ -474,7 +497,7 @@ async function buildMessageContent(
  */
 export async function getGroupHistory(
   groupId: number,
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   count: number = 100,
   selfId: number,
   db?: {
@@ -547,8 +570,9 @@ export async function getGroupHistory(
   }
 
   try {
-    const bot = ctx.pickBot(selfId) as any;
+    const bot = ctx.pickBot(selfId);
     const historyMediaOptions: HistoryMediaProcessingOptions = {
+      bot,
       ai: mediaOptions?.ai,
       workingModel: mediaOptions?.workingModel,
       multimodalWorkingModel: mediaOptions?.multimodalWorkingModel,
@@ -561,32 +585,23 @@ export async function getGroupHistory(
               saveMediaSummarySource: db.saveMediaSummarySource?.bind(db),
             }
           : undefined,
-      bot,
       groupId,
     };
-    // 调用 OneBot API 获取群聊历史
-    const result = await bot.api("get_group_msg_history", {
-      group_id: String(groupId),
-      message_seq: "0",
-      count: Math.min(count, 200), // 最多获取200条
-      reverse_order: false,
-      disable_get_url: false,
-      parse_mult_msg: true,
-      quick_reply: false,
-    });
-    const messages = result?.messages || result?.data?.messages || [];
-    if (!Array.isArray(messages)) {
-      logger.warn("[getGroupHistory] API 返回格式异常:", result);
-      return botMessages;
-    }
+    const messages = bot
+      ? await bot.getHistory(
+          { type: "group", group_id: groupId },
+          undefined,
+          Math.min(count, 200),
+        )
+      : [];
 
     const botUin = selfId;
     const memberNameCache = new Map<string, string>();
     const hashLookupCache = new Map<string, string | null>();
 
     for (const m of messages) {
-      const uid = m?.user_id;
-      const senderName = m?.sender?.card || m?.sender?.nickname;
+      const uid = m.user_id;
+      const senderName = m.nickname;
       if (uid != null && senderName && !memberNameCache.has(String(uid))) {
         memberNameCache.set(String(uid), String(senderName));
       }
@@ -657,3 +672,20 @@ export function normalizeIdList(input: unknown): number[] {
     ),
   );
 }
+
+async function fetchQuotedMessage(
+  e: any,
+  ctx: MiokuContext,
+): Promise<{
+  message: any[];
+  sender?: { user_id?: string; nickname?: string };
+} | null> {
+  const bot = e?.bot ?? ctx.pickBot(e?.self_id ?? "");
+  if (!bot || !e?.quote_id) return null;
+  try {
+    const result = await bot.getMessage(e.quote_id);
+    return result ?? null;
+  } catch {
+    return null;
+  }
+}