mioku-plugin-chat 3.0.6 → 3.1.1

package/core/tools/info.ts

@@ -2,6 +2,7 @@ import {logger} from "mioku";
 import type { AITool } from "mioku";
 import { TOOL_RESULT_FOLLOWUP_KEY } from "mioku";
 import type { ToolContext } from "../../types";
+import { mainModelSupportsVision } from "../../utils/model";
 
 async function createImageFollowupResult(
   imageUrl: string,
@@ -67,7 +68,11 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
       parameters: {
         type: "object",
         properties: {
-          user_id: { type: "number", description: "QQ number of the member" },
+          user_id: {
+            type: "string",
+            description:
+              "Platform user id of the member (QQ number, or openid on QQ official)",
+          },
         },
         required: ["user_id"],
       },
@@ -137,7 +142,7 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
       type: "object",
       properties: {
         message_id: {
-          type: "number",
+          type: "string",
           description:
             "The message ID (message_id) of the image or video. You can get this from the original message that contains the media.",
         },
@@ -154,7 +159,7 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
         }
 
         if (media.kind === "image") {
-          if (toolCtx.config.isMultimodal) {
+          if (mainModelSupportsVision(toolCtx.aiService, toolCtx.config.model)) {
             return await createImageFollowupResult(
               media.url,
               `The image from message #${args.message_id} is attached. Inspect it directly and answer the user's question from the visual content.`,
@@ -201,7 +206,8 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
 
         try {
           const attachFullVideo =
-            toolCtx.config.isMultimodal && videoFile.byteSize <= VIDEO_FULL_UPLOAD_MAX_BYTES;
+            mainModelSupportsVision(toolCtx.aiService, toolCtx.config.model) &&
+            videoFile.byteSize <= VIDEO_FULL_UPLOAD_MAX_BYTES;
 
           if (attachFullVideo) {
             const fs = await import("fs/promises");
@@ -250,8 +256,9 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
       type: "object",
       properties: {
         user_id: {
-          type: "number",
-          description: "QQ number of the member whose avatar you want to view",
+          type: "string",
+          description:
+            "Platform user id of the member whose avatar you want to view",
         },
       },
       required: ["user_id"],
@@ -261,7 +268,7 @@ export function createInfoTools(toolCtx: ToolContext): AITool[] {
         const avatarUrl = `https://q1.qlogo.cn/g?b=qq&nk=${args.user_id}&s=640`;
         logger.info(`[view_member_avatar] Analyzing avatar: ${avatarUrl}`);
 
-        if (toolCtx.config.isMultimodal) {
+        if (mainModelSupportsVision(toolCtx.aiService, toolCtx.config.model)) {
           return await createImageFollowupResult(
             avatarUrl,
             `User ${args.user_id}'s QQ avatar is attached. Inspect it directly and answer the user's question from the visual content.`,

package/core/tools/web.ts

@@ -23,14 +23,11 @@ function resolveUserHistoryLimit(value: unknown): number {
 
 function extractTargetUserIdsFromQuestion(
   question: string,
-  requesterUserId: number,
-): number[] {
+  requesterUserId: string,
+): string[] {
   const matches = question.match(/\b\d{5,12}\b/g) || [];
-  const parsed = matches
-    .map((item) => Number(item))
-    .filter((item) => Number.isFinite(item) && item > 0);
-  const ids = [requesterUserId, ...parsed].filter(
-    (item) => Number.isFinite(item) && item > 0,
+  const ids = [String(requesterUserId ?? "").trim(), ...matches].filter(
+    (item) => item.length > 0,
   );
   return [...new Set(ids)].slice(0, 3);
 }
@@ -138,8 +135,8 @@ async function fetchGroupHistoryByMessageIdPaging(
         sessionId: toolCtx.sessionId,
         role: String(raw.user_id) === String(bot.bot_id) ? "assistant" : "user",
         content,
-        userId: Number(raw.user_id || 0),
-        userName: raw.nickname || String(raw.user_id || "unknown"),
+        userId: String(raw.user_id ?? "").trim(),
+        userName: raw.nickname || String(raw.user_id ?? "unknown"),
         userRole: "member",
         groupId: toolCtx.groupId,
         timestamp: ts,

package/db.ts

@@ -69,14 +69,14 @@ export interface ChatDatabase {
     before?: number,
   ): ChatMessage[];
   // 获取 bot 发送的消息
-  getBotMessages(groupId: number, limit?: number): ChatMessage[];
-  getStoredGroupNoticeMessages(groupId: number, limit?: number): ChatMessage[];
+  getBotMessages(groupId: string, limit?: number): ChatMessage[];
+  getStoredGroupNoticeMessages(groupId: string, limit?: number): ChatMessage[];
   getMessagesByUser(
-    userId: number,
+    userId: string,
     sessionId?: string,
     limit?: number,
   ): ChatMessage[];
-  getAllMessagesByUser(userId: number, sessionId?: string): ChatMessage[];
+  getAllMessagesByUser(userId: string, sessionId?: string): ChatMessage[];
   getMessagesByTimeRange(
     sessionId: string,
     startTimestamp: number,
@@ -108,9 +108,9 @@ export interface ChatDatabase {
   // 表达学习
   saveExpression(expr: ExpressionRecord): void;
   getExpressions(sessionId: string, limit?: number): ExpressionRecord[];
-  getExpressionsByUser(userId: number, limit?: number): ExpressionRecord[];
+  getExpressionsByUser(userId: string, limit?: number): ExpressionRecord[];
   replaceExpressionsByUser(
-    userId: number,
+    userId: string,
     userName: string,
     expressions: Array<
       Pick<ExpressionRecord, "situation" | "style" | "example">
@@ -473,7 +473,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
         .reverse(); // 按时间正序
     },
 
-    getBotMessages(groupId: number, limit: number = 50): ChatMessage[] {
+    getBotMessages(groupId: string, limit: number = 50): ChatMessage[] {
       const rows = stmts.getBotMessages.all({ $groupId: groupId, $limit: limit }) as any[];
       return rows
         .map(toChatMessage)
@@ -481,7 +481,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
     },
 
     getStoredGroupNoticeMessages(
-      groupId: number,
+      groupId: string,
       limit: number = 20,
     ): ChatMessage[] {
       const rows = stmts.getStoredGroupNoticeMessages.all(
@@ -493,7 +493,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
     },
 
     getMessagesByUser(
-      userId: number,
+      userId: string,
       sessionId?: string,
       limit: number = 20,
     ): ChatMessage[] {
@@ -510,7 +510,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
         .reverse();
     },
 
-    getAllMessagesByUser(userId: number, sessionId?: string): ChatMessage[] {
+    getAllMessagesByUser(userId: string, sessionId?: string): ChatMessage[] {
       const rows = sessionId
         ? (stmts.getAllMessagesByUserInSession.all({ $userId: userId, $sessionId: sessionId }) as any[])
         : (stmts.getAllMessagesByUser.all({ $userId: userId }) as any[]);
@@ -633,7 +633,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
     },
 
     getExpressionsByUser(
-      userId: number,
+      userId: string,
       limit: number = 50,
     ): ExpressionRecord[] {
       const rows = stmts.getExpressionsByUser.all({ $userId: userId, $limit: limit }) as any[];
@@ -641,7 +641,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
     },
 
     replaceExpressionsByUser(
-      userId: number,
+      userId: string,
       userName: string,
       expressions: Array<
         Pick<ExpressionRecord, "situation" | "style" | "example">
@@ -650,7 +650,7 @@ export async function initDatabase(): Promise<ChatDatabase> {
       const now = Date.now();
       const tx = db.transaction(
         (
-          targetUserId: number,
+          targetUserId: string,
           targetUserName: string,
           rows: Array<
             Pick<ExpressionRecord, "situation" | "style" | "example">

package/handlers/idle-debug.ts

@@ -17,10 +17,10 @@ export async function handleIdleCheckDebug(
     return;
   }
   const groupIdStr =
-    e.message[0]?.text?.replace("/空闲检查", "")?.trim() || "";
-  const targetGroupId = parseInt(groupIdStr, 10);
+    e.message[0]?.text?.replace(/^[./]空闲检查/, "")?.trim() || "";
+  const targetGroupId = String(groupIdStr).trim();
   if (!targetGroupId) {
-    await e.reply("请指定群号，如：/空闲检查 123456");
+    await e.reply("请指定群 ID，如：.空闲检查 123456");
     return;
   }
 
@@ -61,7 +61,7 @@ export async function handleIdleCheckDebug(
 
         const targetMessage: TargetMessage = {
           userName: "系统",
-          userId: 0,
+          userId: "",
           userRole: "member",
           content: "[No one in the group is talking? I'll answer!]",
           messageId: "",
@@ -73,7 +73,7 @@ export async function handleIdleCheckDebug(
           event: null,
           groupSessionId,
           groupId: targetGroupId,
-          userId: 0,
+          userId: "",
           config: cfg,
           aiService: ctx.services!.ai as AIService,
           db: pluginCtx.db,
@@ -117,8 +117,8 @@ export async function handleIdleCheckDebug(
           result,
           groupId: targetGroupId,
           groupSessionId,
-          userId: 0,
-          selfId: e.self_id,
+          userId: "",
+          selfId: String(e.self_id ?? "").trim(),
           toolCtx,
           send: true,
           isLive: true,

package/handlers/message.ts

@@ -35,8 +35,8 @@ export function createMessageHandler(
 
   return async (e: MessageEvent) => {
     const isGroup = e.message_type === "group";
-    const groupId: number | undefined = isGroup
-      ? Number(e.group_id)
+    const groupId: string | undefined = isGroup
+      ? String(e.group_id ?? "").trim() || undefined
       : undefined;
     const cfg = await getConfig(groupId);
     if (!isGroup && cfg.ignorePrivateChat) return;
@@ -44,13 +44,13 @@ export function createMessageHandler(
     if (!e?.message || !Array.isArray(e.message)) return;
 
     const text = ctx.text(e) || "";
-    const userId: number = Number(e.user_id || e.sender?.user_id || 0);
+    const userId: string = String(e.user_id ?? e.sender?.user_id ?? "").trim();
 
-    if (userId === Number(e.self_id || 0)) return;
+    if (!userId || userId === String(e.self_id ?? "").trim()) return;
 
     if (matchMessageCommands && matchMessageCommands(text).length > 0) return;
 
-    if (text.startsWith("/空闲检查 ")) {
+    if (/^[./]空闲检查\s/.test(text)) {
       await handleIdleCheckDebug(pluginCtx, e, cfg);
       return;
     }
@@ -204,9 +204,7 @@ export function createMessageHandler(
 
     const atBot = shouldTrigger(e, text, cfg, ctx);
     const replyBot = ctx.pickReplyBot(e);
-    const actorSelfId = replyBot
-      ? Number(replyBot.bot_id)
-      : Number(e.self_id || 0);
+    const actorSelfId = String(replyBot?.bot_id ?? e.self_id ?? "").trim();
     const quotedBot = isGroup ? await isQuotingBot(e, ctx) : null;
     const mentionedNickname =
       cfg.nicknames.length > 0 &&

package/handlers/poke.ts

@@ -15,12 +15,13 @@ export function createPokeHandler(
   const { getConfig, runtimeState, pokeCooldowns } = state;
 
   return async (e: NoticeEvent) => {
-    const selfId = Number(e.self_id || 0);
-    const targetId = Number(
-      (e.raw as { target_id?: string } | undefined)?.target_id ?? 0,
-    );
-    if (targetId !== selfId) return;
-    const groupId = Number(e.group_id || 0);
+    const selfId = String(e.self_id ?? "").trim();
+    const raw = e.raw as { target_id?: unknown; user_id?: unknown } | undefined;
+    const targetId = String(
+      raw?.target_id ?? raw?.user_id ?? e.user_id ?? "",
+    ).trim();
+    if (!targetId || targetId !== selfId) return;
+    const groupId = String(e.group_id ?? "").trim();
     const cfg = groupId ? await getConfig(groupId) : await getConfig();
     if (!cfg.model && !cfg.apiKey) return;
     if (!groupId || !isGroupAllowed(groupId, cfg)) return;
@@ -42,10 +43,9 @@ export function createPokeHandler(
             "group",
             groupId,
           );
-          const userId = Number(e.user_id || 0);
+          const userId = String(e.user_id ?? "").trim();
           const botRole = await getBotRole(groupId, ctx, selfId);
-          const botNickname =
-            cfg.nicknames[0] || e.bot?.nickname || "Bot";
+          const botNickname = cfg.nicknames[0] || e.bot?.nickname || "Bot";
 
           let senderName = String(userId);
           try {
@@ -54,9 +54,7 @@ export function createPokeHandler(
               ? await bot.getMemberInfo(groupId, userId)
               : undefined;
             senderName =
-              memberInfo?.card ||
-              memberInfo?.nickname ||
-              String(userId);
+              memberInfo?.card || memberInfo?.nickname || String(userId);
           } catch {}
 
           const targetMessage: TargetMessage = {
@@ -76,8 +74,11 @@ export function createPokeHandler(
             selfId,
             pluginCtx.buildHistoryMediaOptions(pluginCtx.aiInstance, cfg),
           );
-          const { groupName, memberCount } =
-            await pluginCtx.getGroupInfoData(ctx, groupId, selfId);
+          const { groupName, memberCount } = await pluginCtx.getGroupInfoData(
+            ctx,
+            groupId,
+            selfId,
+          );
 
           const toolCtx = pluginCtx.buildToolContext({
             ctx,

package/humanize/emotion-agent.ts

@@ -38,7 +38,7 @@ export class EmotionAgent {
     return state;
   }
 
-  getAvailableEmotions(groupId?: number): string[] {
+  getAvailableEmotions(groupId?: string): string[] {
     const cfg = this.getConfig(groupId);
     const emotions = Object.keys(cfg.emotion?.emotions || {})
       .map((name) => name.trim().toLowerCase())
@@ -46,7 +46,7 @@ export class EmotionAgent {
     return Array.from(new Set(["default", ...emotions]));
   }
 
-  getReferenceExamples(emotion: string, groupId?: number): string[] {
+  getReferenceExamples(emotion: string, groupId?: string): string[] {
     const cfg = this.getConfig(groupId);
     const normalized = this.normalizeEmotionName(emotion);
     const emotions = cfg.emotion?.emotions || {};
@@ -55,7 +55,7 @@ export class EmotionAgent {
     return this.normalizeExamples(emotions[this.getDefaultEmotion(groupId)]?.examples);
   }
 
-  setEmotion(sessionId: string, emotion: string, groupId?: number): EmotionState {
+  setEmotion(sessionId: string, emotion: string, groupId?: string): EmotionState {
     const current = this.resolveEmotion(emotion, groupId);
     const state = { current, updatedAt: Date.now() };
     this.states.set(sessionId, state);
@@ -144,14 +144,14 @@ ${input.targetMessage.userName}: ${input.targetMessage.content}`;
     return this.resolveEmotion(parsed?.emotion, extractGroupIdFromSession(input.sessionId));
   }
 
-  private resolveEmotion(emotion: unknown, groupId?: number): string {
+  private resolveEmotion(emotion: unknown, groupId?: string): string {
     const normalized = this.normalizeEmotionName(emotion);
     const available = this.getAvailableEmotions(groupId);
     if (available.includes(normalized)) return normalized;
     return this.getDefaultEmotion(groupId);
   }
 
-  private getDefaultEmotion(groupId?: number): string {
+  private getDefaultEmotion(groupId?: string): string {
     const cfg = this.getConfig(groupId);
     const configured = this.normalizeEmotionName(cfg.emotion?.defaultEmotion);
     const available = this.getAvailableEmotions(groupId);

package/humanize/expression.ts

@@ -9,8 +9,8 @@ export class ExpressionLearner {
   private ai: AIInstance;
   private getConfig: ChatConfigProvider;
   private db: ChatDatabase;
-  private pendingMessagesByUser: Map<number, ChatMessage[]> = new Map();
-  private learningUsers: Set<number> = new Set();
+  private pendingMessagesByUser: Map<string, ChatMessage[]> = new Map();
+  private learningUsers: Set<string> = new Set();
 
   constructor(ai: AIInstance, configProvider: ChatConfigProvider, db: ChatDatabase) {
     this.ai = ai;
@@ -33,9 +33,9 @@ export class ExpressionLearner {
   }
 
   getExpressionContextForUser(
-    userId: number,
+    userId: string,
     userName: string,
-    groupId?: number,
+    groupId?: string,
   ): string {
     const cfg = this.getConfig(groupId);
     if (!cfg.expression?.enabled) return "";
@@ -62,7 +62,7 @@ export class ExpressionLearner {
     return context;
   }
 
-  private async tryLearn(userId: number, cfg = this.getConfig()): Promise<void> {
+  private async tryLearn(userId: string, cfg = this.getConfig()): Promise<void> {
     if (this.learningUsers.has(userId)) return;
 
     const threshold = Math.max(
@@ -95,7 +95,7 @@ export class ExpressionLearner {
   }
 
   private async learnForUser(
-    userId: number,
+    userId: string,
     messages: ChatMessage[],
     cfg = this.getConfig(),
   ): Promise<void> {

package/humanize/index.ts

@@ -16,7 +16,7 @@ import { TopicTracker } from "./topic";
 import { ActionPlanner } from "./planner";
 import { ExpressionLearner } from "./expression";
 
-export type ChatConfigProvider = (groupId?: number) => ChatConfig;
+export type ChatConfigProvider = (groupId?: string) => ChatConfig;
 
 export class HumanizeEngine {
   readonly memoryRetrieval: MemoryRetrieval;

package/humanize/memory.ts

@@ -6,7 +6,7 @@ import { extractGroupIdFromSession } from "../utils/group-config";
 import type { ChatConfigProvider } from "./index";
 
 export interface MemoryUserHistoryChunk {
-  userId: number;
+  userId: string;
   messages: ChatMessage[];
 }
 

package/index.ts

@@ -48,6 +48,7 @@ import { buildHistoryMediaOptions } from "./core/media/segment";
 import type { ChatConfigProvider } from "./humanize";
 import type { ChatPluginContext, ChatHandlerState } from "./context";
 import { mergeGroupOverrides } from "./utils/group-config";
+import { mainModelSupportsVision } from "./utils/model";
 import {
   mergeChatConfig,
   normalizeIdList,
@@ -95,9 +96,20 @@ function resolveRoleInstances(aiService: AIService): {
   const visionModel = findModel("vision", vision) || workingModel;
 
   const models = aiService.listModels?.() ?? [];
-  const visionDesc =
-    models.find((item) => item.id === bindings.vision) ||
-    models.find((item) => item.modelId === visionModel);
+  const findModelDesc = (role: AIModelRole, modelId: string) => {
+    const exact = models.find((item) => item.id === bindings[role]);
+    if (exact) return exact;
+    const providerId = instances.find(
+      (info) => info.role === role || info.name === role,
+    )?.providerId;
+    return (
+      models.find(
+        (item) => item.modelId === modelId && item.providerId === providerId,
+      ) || models.find((item) => item.modelId === modelId)
+    );
+  };
+
+  const visionDesc = findModelDesc("vision", visionModel);
   const isMultimodal =
     visionDesc?.capabilities?.includes("vision") ?? Boolean(visionModel);
 
@@ -261,7 +273,7 @@ export default definePlugin({
       });
     }
 
-    const configProvider: ChatConfigProvider = (groupId?: number) => {
+    const configProvider: ChatConfigProvider = (groupId?: string) => {
       const base = cachedBaseConfig;
       if (!base) return PERSONALIZATION_CONFIG as unknown as ChatConfig;
       if (groupId === undefined) return base;
@@ -269,7 +281,7 @@ export default definePlugin({
       return mergeGroupOverrides(base, overrides);
     };
 
-    const getConfig = async (groupId?: number): Promise<ChatConfig> => {
+    const getConfig = async (groupId?: string): Promise<ChatConfig> => {
       if (!cachedBaseConfig) await refreshBaseCache();
       return configProvider(groupId);
     };
@@ -341,7 +353,7 @@ export default definePlugin({
       return;
     }
 
-roleModels = resolved.models;
+    roleModels = resolved.models;
     roleIsMultimodal = resolved.isMultimodal;
     await refreshBaseCache();
 
@@ -380,14 +392,14 @@ roleModels = resolved.models;
     rateLimiter.setConfigProvider(configProvider);
     const skillManager = new SkillSessionManager();
 
-    rateLimiter.setQueueLengthGetter((groupId: number) =>
+    rateLimiter.setQueueLengthGetter((groupId: string) =>
       queueManager.getQueueLength(`group:${groupId}`),
     );
 
     const humanize = new HumanizeEngine(workAIInstance, db, configProvider);
     await humanize.init();
 
-    const pokeCooldowns = new Map<number, number>();
+    const pokeCooldowns = new Map<string, number>();
     const processingSet = new Set<string>();
     const sessionTurnScheduler = new SessionTurnScheduler();
     const groupStructuredHistory = new GroupStructuredHistoryManager();
@@ -442,8 +454,8 @@ roleModels = resolved.models;
       audioService,
       startCooldownTimer: (
         groupSessionId: string,
-        groupId: number,
-        selfId: number,
+        groupId: string,
+        selfId: string,
       ) => cooldownManager.startCooldownTimer(groupSessionId, groupId, selfId),
       async recordGroupMessageForLearning(
         userMsg: ChatMessage,
@@ -511,20 +523,25 @@ roleModels = resolved.models;
     aiService.registerChatRuntime(runtime);
 
     ctx.command({
-      name: "/重置会话",
-      match: /^\/重置会话$/,
-      prefixes: false,
+      name: "重置会话",
+      prefixes: ["/", "."],
+      match: /^重置会话$/,
       description: "重置自己的AI聊天记录",
+      usage: ".重置会话",
       handler: async ({ event }) => {
-        if (event.user_id === event.self_id) return;
+        if (String(event.user_id ?? "") === String(event.self_id ?? "")) return;
         const groupId =
-          event.message_type === "group" ? Number(event.group_id) : undefined;
+          event.message_type === "group"
+            ? String(event.group_id ?? "").trim() || undefined
+            : undefined;
         if (groupId) {
           pluginCtx.sessionManager.resetBotMessages(`group:${groupId}`);
           pluginCtx.groupStructuredHistory.clear(`group:${groupId}`);
           await event.reply("已清除本群会话中 AI 发送的消息~");
         } else {
-          const userId = Number(event.user_id || event.sender?.user_id || 0);
+          const userId = String(
+            event.user_id ?? event.sender?.user_id ?? "",
+          ).trim();
           pluginCtx.sessionManager.resetBotMessages(`personal:${userId}`);
           pluginCtx.groupStructuredHistory.clear(`personal:${userId}`);
           await event.reply("已清除你的个人会话中 AI 发送的消息~");
@@ -532,15 +549,18 @@ roleModels = resolved.models;
       },
     });
     ctx.command({
-      name: "/重置群会话",
-      match: /^\/重置群会话$/,
-      prefixes: false,
+      name: "重置群会话",
+      prefixes: ["/", "."],
+      match: /^重置群会话$/,
       permission: "admin",
       description: "重置当前群的AI聊天记录",
+      usage: ".重置群会话",
       handler: async ({ event }) => {
-        if (event.user_id === event.self_id) return;
+        if (String(event.user_id ?? "") === String(event.self_id ?? "")) return;
         const groupId =
-          event.message_type === "group" ? Number(event.group_id) : undefined;
+          event.message_type === "group"
+            ? String(event.group_id ?? "").trim() || undefined
+            : undefined;
         if (!groupId) {
           await event.reply("在群里使用试试看吧~", true);
           return;
@@ -551,15 +571,19 @@ roleModels = resolved.models;
       },
     });
     ctx.command({
-      name: "/tts",
-      match: /^\/tts\s*(.*)$/,
-      prefixes: false,
+      name: "tts",
+      prefixes: ["/", "."],
+      match: /^tts\s*(.*)$/,
       permission: "owner",
       description: "TTS 推理",
-      usage: "/tts <文本>",
+      usage: ".tts <文本>",
       handler: async ({ event, match }) => {
-        if (event.user_id === event.self_id) return;
-        await handleTtsCommand(pluginCtx, event, String(match?.[1] ?? "").trim());
+        if (String(event.user_id ?? "") === String(event.self_id ?? "")) return;
+        await handleTtsCommand(
+          pluginCtx,
+          event,
+          String(match?.[1] ?? "").trim(),
+        );
       },
     });
 
@@ -567,7 +591,7 @@ roleModels = resolved.models;
     ctx.handle("notice.group.poke", createPokeHandler(pluginCtx, handlerState));
 
     ctx.logger.info(
-      `聊天插件加载成功 (main=${roleModels.main || "?"}, work=${roleModels.working || "?"}, vision=${roleModels.vision || "?"})`,
+      `聊天插件加载成功 (main=${roleModels.main || "?"}${mainModelSupportsVision(aiService, roleModels.main) ? "" : " 无视觉，图片交给视觉模型描述"}, work=${roleModels.working || "?"}, vision=${roleModels.vision || "?"})`,
     );
 
     return () => {

package/manage/cooldown.ts

@@ -26,7 +26,7 @@ interface CooldownMessage {
   event: any;
   content: string;
   userName: string;
-  userId: number;
+  userId: string;
   messageId: string;
   timestamp: number;
   isDirectAt: boolean;
@@ -86,8 +86,8 @@ export class CooldownManager {
 
   startCooldownTimer(
     groupSessionId: string,
-    groupId: number,
-    selfId: number,
+    groupId: string,
+    selfId: string,
   ): void {
     const existingTimer = this.cooldownTimeoutIds.get(groupSessionId);
     if (existingTimer) clearTimeout(existingTimer);
@@ -142,7 +142,7 @@ export class CooldownManager {
 
   collectMessage(
     groupSessionId: string,
-    groupId: number,
+    groupId: string,
     event: any,
     content: string,
     isDirectAt: boolean,
@@ -175,9 +175,9 @@ export class CooldownManager {
 
   private async processReviewMessages(
     groupSessionId: string,
-    groupId: number,
+    groupId: string,
     collected: CooldownMessage[],
-    selfId: number,
+    selfId: string,
   ): Promise<void> {
     const mergedContents = collected.map((m) => m.content);
     const userNames = collected.map((m) => m.userName);
@@ -297,9 +297,9 @@ export class CooldownManager {
 
   private async processCooldownWithPlanner(
     groupSessionId: string,
-    groupId: number,
+    groupId: string,
     collected: CooldownMessage[],
-    selfId: number,
+    selfId: string,
   ): Promise<void> {
     const mergedContent = collected.map((m) => m.content).join("\n");
     const firstMsg = collected[0];