mioku-plugin-chat 3.0.6 → 3.1.1

package/manage/group-structured-history.ts

@@ -4,7 +4,7 @@ import type { TargetMessage } from "../types";
 
 export interface StructuredUserInput {
   userName: string;
-  userId: number;
+  userId: string;
   userRole?: string;
   userTitle?: string;
   content: string;
@@ -192,7 +192,7 @@ function formatStructuredUserContent(input: StructuredUserInput): string {
   const lines = [
     "[Group Member Message]",
     `Name: ${input.userName || "unknown"}`,
-    `QQ: ${input.userId || 0}`,
+    `user_id: ${input.userId || "unknown"}`,
     `Time: ${formatTimestamp(input.timestamp)}`,
   ];
 

package/manage/idle-check.ts

@@ -25,7 +25,7 @@ export class IdleCheckManager {
   private groupLastBotMessageTime = new Map<string, number>();
   private groupMessageCountAfterBot = new Map<string, number>();
   private groupLastIdleCheckTime = new Map<string, number>();
-  private groupBotsMapping = new Map<string, Set<number>>();
+  private groupBotsMapping = new Map<string, Set<string>>();
   private intervalHandle: NodeJS.Timeout | null = null;
 
   private ctx: MiokuContext;
@@ -71,11 +71,11 @@ export class IdleCheckManager {
     this.groupMessageCount.set(groupSessionId, count + 1);
   }
 
-  recordBotMessages(groupSessionId: string, count: number, selfId: number): void {
+  recordBotMessages(groupSessionId: string, count: number, selfId: string): void {
     const current = this.groupMessageCountAfterBot.get(groupSessionId) ?? 0;
     this.groupMessageCountAfterBot.set(groupSessionId, current + count);
     let bots = this.groupBotsMapping.get(groupSessionId);
-    if (!bots) { bots = new Set<number>(); this.groupBotsMapping.set(groupSessionId, bots); }
+    if (!bots) { bots = new Set<string>(); this.groupBotsMapping.set(groupSessionId, bots); }
     bots.add(selfId);
     this.groupLastBotMessageTime.set(groupSessionId, Date.now());
   }
@@ -106,14 +106,15 @@ export class IdleCheckManager {
 
       const now = Date.now();
       const checkInterval = 60_000;
-      const allBotIds = Array.from(this.ctx.bots).map((bot) => Number(bot.bot_id));
+      const allBotIds = Array.from(this.ctx.bots).map((bot) => String(bot.bot_id));
 
       for (const [groupSessionId, lastTime] of this.groupLastActivityTime) {
         const lastCheckTime =
           this.groupLastIdleCheckTime.get(groupSessionId) ?? 0;
         if (now - lastCheckTime < checkInterval) continue;
 
-        const groupId = parseInt(groupSessionId.split(":")[1], 10);
+        const groupId = String(groupSessionId.split(":")[1] ?? "").trim();
+        if (!groupId) continue;
         const cfg = this.configProvider(groupId);
         if (!cfg.planner?.enabled) continue;
         if (!isGroupAllowed(groupId, cfg)) continue;
@@ -130,7 +131,7 @@ export class IdleCheckManager {
           cfg.planner.idleCheckBotIds ??
           baseCfg.planner?.idleCheckBotIds ??
           allBotIds;
-        const enabledBotIds = idleCheckBotIds.filter((id: number) =>
+        const enabledBotIds = idleCheckBotIds.filter((id: string) =>
           allBotIds.includes(id),
         );
 
@@ -193,8 +194,8 @@ export class IdleCheckManager {
 
   private async processIdleCheckTurn(
     groupSessionId: string,
-    groupId: number,
-    selfId: number,
+    groupId: string,
+    selfId: string,
     cfg: ChatConfig,
     scheduledLastActivity: number,
     scheduledAt: number,
@@ -234,7 +235,7 @@ export class IdleCheckManager {
 
     const targetMessage: TargetMessage = {
       userName: "system",
-      userId: 0,
+      userId: "",
       userRole: "member",
       content: "[No one in the group is talking? I'll answer!]",
       messageId: "",
@@ -246,7 +247,7 @@ export class IdleCheckManager {
       event: null,
       groupSessionId,
       groupId,
-      userId: 0,
+      userId: "",
       config: cfg,
       aiService: this.aiService,
       db: this.db,
@@ -292,7 +293,7 @@ export class IdleCheckManager {
       result,
       groupId,
       groupSessionId,
-      userId: 0,
+      userId: "",
       selfId,
       toolCtx,
       send: true,

package/manage/queue-processor.ts

@@ -25,7 +25,7 @@ import { finalizeChatTurn } from "../core/chat-turn";
 import { extractContent, getBotRole } from "../utils";
 
 interface DynamicDelayQueueData {
-  messages: Array<{ event: any; content: string; userName: string; userId: number; messageId: string; timestamp: number }>;
+  messages: Array<{ event: any; content: string; userName: string; userId: string; messageId: string; timestamp: number }>;
   timer: NodeJS.Timeout | null;
   delayUntil: number;
 }
@@ -91,7 +91,7 @@ export class QueueProcessor {
     queueData.messages.push({ event, content, userName, userId: event.user_id, messageId: event.message_id, timestamp: Date.now() });
   }
 
-  startDynamicDelayTimer(groupSessionId: string, groupId: number, delayMs: number, selfId: number): void {
+  startDynamicDelayTimer(groupSessionId: string, groupId: string, delayMs: number, selfId: string): void {
     let queueData = this.dynamicDelayQueues.get(groupSessionId);
     if (!queueData) {
       queueData = { messages: [], timer: null, delayUntil: Date.now() + delayMs };
@@ -132,7 +132,7 @@ export class QueueProcessor {
     return queue != null && Date.now() < queue.delayUntil;
   }
 
-  scheduleQueuedMessages(groupSessionId: string, selfId: number): void {
+  scheduleQueuedMessages(groupSessionId: string, selfId: string): void {
     void this.sessionTurnScheduler
       .run(
         groupSessionId,
@@ -156,8 +156,8 @@ export class QueueProcessor {
 
   private async processDynamicDelayMessages(
     groupSessionId: string,
-    groupId: number,
-    selfId: number,
+    groupId: string,
+    selfId: string,
     messages: DynamicDelayQueueData["messages"],
   ): Promise<void> {
     this.ctx.logger.info(`[DynamicDelay] group ${groupId} processes ${messages.length} delayed messages`);
@@ -217,7 +217,7 @@ export class QueueProcessor {
     });
   }
 
-  async processQueuedMessages(groupSessionId: string, selfId: number): Promise<void> {
+  async processQueuedMessages(groupSessionId: string, selfId: string): Promise<void> {
     try {
       const queue = this.queueManager.getQueue(groupSessionId);
       if (!queue || queue.length === 0) {
@@ -225,7 +225,8 @@ export class QueueProcessor {
         return;
       }
 
-      const groupId = parseInt(groupSessionId.split(":")[1], 10);
+      const groupId = String(groupSessionId.split(":")[1] ?? "").trim();
+      if (!groupId) return;
       this.ctx.logger.info(`[Queue] group ${groupSessionId} batch ${queue.length} messages`);
 
       const queuedContents: string[] = [];
@@ -255,7 +256,7 @@ export class QueueProcessor {
       const mergedContent = queuedContents.join("\n");
 
       const targetMessage: TargetMessage = {
-        userName, userId: firstItem.event.user_id || firstItem.event.sender?.user_id,
+        userName, userId: String(firstItem.event.user_id ?? firstItem.event.sender?.user_id ?? "").trim(),
         userRole: firstItem.event.sender?.role || "member", content: mergedContent,
         messageId: firstItem.event.message_id, timestamp: Date.now(),
       };

package/manage/rate-limit-guard.ts

@@ -52,8 +52,8 @@ export class RateLimitGuard {
   async run<T>(
     request: () => Promise<T>,
     opts?: {
-      userId?: number;
-      groupId?: number;
+      userId?: string;
+      groupId?: string;
       label?: string;
       skipRetryOnRateLimit?: boolean;
     },

package/manage/rate-limiter.ts

@@ -13,16 +13,16 @@ const DEFAULT_AI_REQUEST_LIMITS: AIRequestLimitConfig = {
   windowMs: 60_000,
 };
 
-export type ChatConfigProvider = (groupId?: number) => ChatConfig;
+export type ChatConfigProvider = (groupId?: string) => ChatConfig;
 
 export class RateLimiter {
-  private userTriggers: Map<number, number[]> = new Map();
-  private userMessages: Map<number, { content: string; timestamp: number }[]> =
+  private userTriggers: Map<string, number[]> = new Map();
+  private userMessages: Map<string, { content: string; timestamp: number }[]> =
     new Map();
-  private groupLastResponse: Map<number, number> = new Map();
-  private groupInteractions: Map<number, Map<number, number[]>> = new Map();
-  private userAiRequests: Map<number, number[]> = new Map();
-  private groupAiRequests: Map<number, number[]> = new Map();
+  private groupLastResponse: Map<string, number> = new Map();
+  private groupInteractions: Map<string, Map<string, number[]>> = new Map();
+  private userAiRequests: Map<string, number[]> = new Map();
+  private groupAiRequests: Map<string, number[]> = new Map();
 
   private readonly maxTriggersPerWindow: number;
   private readonly windowMs: number;
@@ -30,13 +30,13 @@ export class RateLimiter {
   private readonly groupCooldownMs: number;
   private readonly cleanupTimer: ReturnType<typeof setInterval>;
   private getConfig: ChatConfigProvider;
-  private getQueueLengthFn: ((groupId: number) => number) | null = null;
+  private getQueueLengthFn: ((groupId: string) => number) | null = null;
 
   setConfigProvider(provider: ChatConfigProvider): void {
     this.getConfig = provider;
   }
 
-  setQueueLengthGetter(fn: (groupId: number) => number): void {
+  setQueueLengthGetter(fn: (groupId: string) => number): void {
     this.getQueueLengthFn = fn;
   }
 
@@ -58,17 +58,17 @@ export class RateLimiter {
     this.cleanupTimer = setInterval(() => this.cleanup(), 300_000);
   }
 
-  private getDynamicDelay(groupId?: number): DynamicDelayConfig {
+  private getDynamicDelay(groupId?: string): DynamicDelayConfig {
     return this.getConfig(groupId)?.dynamicDelay ?? DEFAULT_DYNAMIC_DELAY;
   }
 
-  private getAiRequestLimits(groupId?: number): AIRequestLimitConfig {
+  private getAiRequestLimits(groupId?: string): AIRequestLimitConfig {
     return this.getConfig(groupId)?.aiRequestLimits ?? DEFAULT_AI_REQUEST_LIMITS;
   }
 
   canProcess(
-    userId: number,
-    groupId: number | undefined,
+    userId: string,
+    groupId: string | undefined,
     content: string,
   ): boolean {
     const now = Date.now();
@@ -93,7 +93,7 @@ export class RateLimiter {
     return !recentSame;
   }
 
-  record(userId: number, groupId: number | undefined, content: string): void {
+  record(userId: string, groupId: string | undefined, content: string): void {
     const now = Date.now();
 
     const triggers = this.userTriggers.get(userId) ?? [];
@@ -110,7 +110,7 @@ export class RateLimiter {
     }
   }
 
-  recordInteraction(groupId: number, userId: number): void {
+  recordInteraction(groupId: string, userId: string): void {
     const dynamicDelay = this.getDynamicDelay(groupId);
     if (!dynamicDelay.enabled) return;
 
@@ -129,7 +129,7 @@ export class RateLimiter {
     groupUsers.set(userId, timestamps);
   }
 
-  canRunAIRequest(userId?: number, groupId?: number): boolean {
+  canRunAIRequest(userId?: string, groupId?: string): boolean {
     const now = Date.now();
     const { userRpm, groupRpm, windowMs } = this.getAiRequestLimits(groupId);
 
@@ -154,7 +154,7 @@ export class RateLimiter {
     return true;
   }
 
-  recordAIRequest(userId?: number, groupId?: number): void {
+  recordAIRequest(userId?: string, groupId?: string): void {
     const now = Date.now();
     const { windowMs } = this.getAiRequestLimits(groupId);
 
@@ -175,7 +175,7 @@ export class RateLimiter {
     }
   }
 
-  getInteractionCount(groupId: number): number {
+  getInteractionCount(groupId: string): number {
     const now = Date.now();
     const { interactionWindowMs: windowMs } = this.getDynamicDelay(groupId);
 
@@ -199,7 +199,7 @@ export class RateLimiter {
     return count;
   }
 
-  calculateDelay(groupId: number): number {
+  calculateDelay(groupId: string): number {
     const dynamicDelay = this.getDynamicDelay(groupId);
     if (!dynamicDelay.enabled) return 0;
 
@@ -211,7 +211,7 @@ export class RateLimiter {
     return Math.min(delay, maxDelayMs);
   }
 
-  getDelayInfo(groupId: number): {
+  getDelayInfo(groupId: string): {
     delayMs: number;
     interactionCount: number;
     shouldDelay: boolean;
@@ -225,7 +225,7 @@ export class RateLimiter {
     };
   }
 
-  clearGroupInteractions(groupId: number): void {
+  clearGroupInteractions(groupId: string): void {
     this.groupInteractions.delete(groupId);
   }
 

package/manage/session.ts

@@ -17,7 +17,7 @@ export class SessionManager {
   /**
    * 获取或创建会话
    */
-  getOrCreate(id: string, type: SessionType, targetId: number): SessionMeta {
+  getOrCreate(id: string, type: SessionType, targetId: string): SessionMeta {
     // 先查缓存
     if (this.cache.has(id)) {
       return this.touch(id);

package/manage/types.ts

@@ -31,27 +31,27 @@ export type HistoryMediaOptions = {
 export type RunRateLimitGuard = <T>(
   request: () => Promise<T>,
   opts?: {
-    userId?: number;
-    groupId?: number;
+    userId?: string;
+    groupId?: string;
     label?: string;
     skipRetryOnRateLimit?: boolean;
   },
 ) => Promise<T | null>;
 
 export type GetGroupHistoryMessages = (
-  groupId: number,
+  groupId: string,
   groupSessionId: string,
   ctx: MiokuContext,
   historyCount: number,
   db: ChatDatabase,
-  selfId: number,
+  selfId: string,
   mediaOptions?: HistoryMediaOptions,
 ) => Promise<{ history: ChatMessage[] }>;
 
 export type GetGroupInfoData = (
   ctx: MiokuContext,
-  groupId: number,
-  selfId: number,
+  groupId: string,
+  selfId: string,
   fallbackGroupName?: string,
 ) => Promise<GroupInfoResult>;
 
@@ -60,16 +60,16 @@ export type GetHumanizeContexts = (
   groupSessionId: string,
   userName: string,
   history: ChatMessage[],
-  triggerUserId?: number,
+  triggerUserId?: string,
 ) => Promise<HumanizeContextsResult>;
 
 export type SendAIResponse = (
   options: SendAIResponseOptions,
-  selfId: number,
+  selfId: string,
 ) => Promise<Array<string | undefined>>;
 
 export type SaveBotMessages = (
-  groupId: number,
+  groupId: string,
   groupSessionId: string,
   messages: string[],
   timestamp: number,
@@ -82,28 +82,28 @@ export type SaveBotMessages = (
 
 export type SendEmoji = (
   ctx: MiokuContext,
-  groupId: number,
+  groupId: string,
   emojiPath: string | null | undefined,
   bot?: import("mioku").Bot,
 ) => Promise<void>;
 
 export type SendMessage = (
   ctx: MiokuContext,
-  groupId: number | undefined,
-  userId: number,
+  groupId: string | undefined,
+  userId: string,
   text: string,
   config: ChatConfig,
-  selfId: number,
+  selfId: string,
   audioService?: import("mioku-service-audio").AudioServiceApi,
 ) => Promise<void>;
 
 export type BuildToolContext = (options: {
   ctx: MiokuContext;
   event: any;
-  selfId: number;
+  selfId: string;
   groupSessionId: string;
-  groupId?: number;
-  userId: number;
+  groupId?: string;
+  userId: string;
   config: ChatConfig;
   aiService: AIService;
   db: ChatDatabase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-chat",
-  "version": "3.0.6",
+  "version": "3.1.1",
   "description": "AI 智能聊天插件",
   "main": "index.ts",
   "type": "module",

package/runtime/chat-runtime.ts

@@ -12,21 +12,21 @@ import { executeChatRuntimeRequest } from "../core/chat-turn";
 
 function resolveRuntimeGroupId(
   options: ChatRuntimeNoticeOptions | ChatRuntimeInformationRequestOptions,
-): number | undefined {
+): string | undefined {
   if ("event" in options) {
     const event = options.event;
     if (event?.kind !== "message" || event.message_type !== "group") {
       return undefined;
     }
-    const groupId: unknown = event.group_id;
-    return typeof groupId === "number" ? groupId : undefined;
+    const groupId = String(event.group_id ?? "").trim();
+    return groupId || undefined;
   }
   return "groupId" in options ? options.groupId : undefined;
 }
 
 export function createChatRuntime(
   pluginCtx: ChatPluginContext,
-  getConfig: (groupId?: number) => Promise<ChatConfig>,
+  getConfig: (groupId?: string) => Promise<ChatConfig>,
 ): ChatRuntime {
   return {
     async requestInformation(

package/types.ts

@@ -56,7 +56,7 @@ export interface PlannerConfig {
   // 群聊记录保底消息数量
   idleMessageCount: number;
   // 空闲检查的 bot ID 列表
-  idleCheckBotIds: number[];
+  idleCheckBotIds: string[];
 }
 
 /**
@@ -183,9 +183,9 @@ export interface ChatConfig {
   webReader: WebReaderConfig;
   audio: AudioConfig;
   historyCount: number;
-  blacklistGroups: number[];
-  whitelistGroups: number[];
-  mediaAnalysisBlacklistUsers: number[];
+  blacklistGroups: string[];
+  whitelistGroups: string[];
+  mediaAnalysisBlacklistUsers: string[];
   maxSessions: number;
   maxIterations: number;
   enableExternalSkills: boolean;
@@ -249,7 +249,7 @@ export type SessionType = "group" | "personal";
 export interface SessionMeta {
   id: string; // "group:{group_id}" 或 "personal:{user_id}"
   type: SessionType;
-  targetId: number; // group_id 或 user_id
+  targetId: string; // group_id 或 user_id
   createdAt: number;
   updatedAt: number;
   compressedContext: string | null;
@@ -263,11 +263,11 @@ export interface ChatMessage {
   sessionId: string;
   role: "user" | "assistant" | "system";
   content: string; // 存储时统一为字符串
-  userId?: number;
+  userId?: string;
   userName?: string;
   userRole?: string; // "owner" | "admin" | "member"
   userTitle?: string;
-  groupId?: number;
+  groupId?: string;
   groupName?: string;
   timestamp: number;
   messageId?: string; // 消息 id
@@ -278,7 +278,7 @@ export interface ChatMessage {
  */
 export interface TargetMessage {
   userName: string;
-  userId: number;
+  userId: string;
   userRole: string;
   userTitle?: string;
   content: string;
@@ -303,8 +303,8 @@ export interface ToolContext {
   ctx: MiokuContext;
   event: any;
   sessionId: string;
-  groupId?: number;
-  userId: number;
+  groupId?: string;
+  userId: string;
   triggerSkillRole: SkillPermissionRole;
   config: ChatConfig;
   aiService: AIService;
@@ -364,7 +364,7 @@ export interface TopicRecord {
 export interface ExpressionRecord {
   id?: number;
   sessionId: string;
-  userId: number;
+  userId: string;
   userName: string;
   situation: string; // 使用场景
   style: string; // 表达风格

package/utils/config.ts

@@ -33,20 +33,20 @@ export function mergeChatConfig<T extends Record<string, any>>(
   return result as T;
 }
 
-export function normalizeIdList(input: unknown): number[] {
+export function normalizeIdList(input: unknown): string[] {
   if (!Array.isArray(input)) return [];
   return Array.from(
     new Set(
       input
-        .map((item) => Math.floor(Number(item)))
-        .filter((id) => Number.isFinite(id) && id > 0),
+        .map((item) => String(item ?? "").trim())
+        .filter((id) => id.length > 0),
     ),
   );
 }
 
 export function normalizeMediaAnalysisBlacklist(
   config: Record<string, any>,
-): number[] {
+): string[] {
   const current = config.mediaAnalysisBlacklistUsers;
   const legacy = config.imageAnalysisBlacklistUsers;
   const source =

package/utils/group-config.ts

@@ -70,10 +70,9 @@ export function mergeGroupOverrides(
 /**
  * 从 sessionId（如 "group:123"）提取群号，个人会话返回 undefined
  */
-export function extractGroupIdFromSession(sessionId: string): number | undefined {
+export function extractGroupIdFromSession(sessionId: string): string | undefined {
   if (!sessionId || typeof sessionId !== "string") return undefined;
   if (!sessionId.startsWith("group:")) return undefined;
-  const raw = sessionId.slice("group:".length);
-  const parsed = parseInt(raw, 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+  const raw = sessionId.slice("group:".length).trim();
+  return raw.length > 0 ? raw : undefined;
 }

package/utils/index.ts

@@ -9,3 +9,5 @@ export {
   buildChatMessageFromEvent,
   normalizeIdList,
 } from "./message";
+
+export { mainModelSupportsVision } from "./model";