mioku-plugin-chat 3.0.6 → 3.1.0

package/context.ts

@@ -38,7 +38,7 @@ export interface ChatPluginContext {
   ctx: MiokuContext;
   defaultConfig: ChatConfig;
   configProvider: ChatConfigProvider;
-  getConfig: (groupId?: number) => Promise<ChatConfig>;
+  getConfig: (groupId?: string) => Promise<ChatConfig>;
   db: ChatDatabase;
   aiInstance: AIInstance;
   workAIInstance: AIInstance;
@@ -75,8 +75,8 @@ export interface ChatPluginContext {
   runChat: RunChat;
   startCooldownTimer: (
     groupSessionId: string,
-    groupId: number,
-    selfId: number,
+    groupId: string,
+    selfId: string,
   ) => void;
   recordGroupMessageForLearning: (
     userMsg: ChatMessage,
@@ -91,12 +91,12 @@ export interface ChatRuntimeState {
 }
 
 export interface ChatHandlerState {
-  getConfig: (groupId?: number) => Promise<ChatConfig>;
+  getConfig: (groupId?: string) => Promise<ChatConfig>;
   matchMessageCommands?: (
     text: string,
   ) => Array<{ plugin: string; command: string }>;
   runtimeState: ChatRuntimeState;
-  pokeCooldowns: Map<number, number>;
+  pokeCooldowns: Map<string, number>;
 }
 
 export interface ChatRuntime {

package/core/base.ts

@@ -25,7 +25,7 @@ import {
 
 export interface SendAIResponseOptions {
   ctx: MiokuContext;
-  groupId: number;
+  groupId: string;
   messages: string[];
   config: ChatConfig;
   sentIndices?: Set<number>;
@@ -78,7 +78,7 @@ async function waitTypingDelay(
 
 export async function sendAIResponse(
   options: SendAIResponseOptions,
-  selfId: number,
+  selfId: string,
 ): Promise<Array<string | undefined>> {
   const {
     ctx,
@@ -252,11 +252,11 @@ export async function sendAIResponse(
 
 export async function sendMessage(
   ctx: MiokuContext,
-  groupId: number | undefined,
-  userId: number,
+  groupId: string | undefined,
+  userId: string,
   text: string,
   config: ChatConfig,
-  selfId: number,
+  selfId: string,
   audioService?: AudioServiceApi,
 ): Promise<void> {
   const typingDelayEnabled = config.enableTypingDelay ?? false;
@@ -555,8 +555,8 @@ async function buildMarkdownImage(
 
 async function dispatchSegments(
   bot: any,
-  groupId: number | undefined,
-  userId: number | undefined,
+  groupId: string | undefined,
+  userId: string | undefined,
   buildSegments: (imageSource?: string) => any[],
   fallbackImagePath?: string,
 ): Promise<string | undefined> {
@@ -583,8 +583,8 @@ async function dispatchSegments(
 
 async function sendByTarget(
   bot: Bot,
-  groupId: number | undefined,
-  userId: number | undefined,
+  groupId: string | undefined,
+  userId: string | undefined,
   segments: readonly any[],
 ): Promise<import("mioku").SentMessage | undefined> {
   if (groupId) {
@@ -668,12 +668,12 @@ export interface GroupHistoryResult {
 }
 
 export async function getGroupHistoryMessages(
-  groupId: number,
+  groupId: string,
   groupSessionId: string,
   ctx: MiokuContext,
   historyCount: number,
   db: ChatDatabase,
-  selfId: number,
+  selfId: string,
   mediaOptions?: {
     ai?: AIInstance;
     workingModel?: string;
@@ -710,8 +710,8 @@ export interface GroupInfoResult {
 
 export async function getGroupInfoData(
   ctx: MiokuContext,
-  groupId: number,
-  selfId: number,
+  groupId: string,
+  selfId: string,
   fallbackGroupName?: string,
 ): Promise<GroupInfoResult> {
   let groupName: string | undefined;
@@ -746,7 +746,7 @@ export async function getHumanizeContexts(
   groupSessionId: string,
   userName: string,
   history: ChatMessage[],
-  triggerUserId?: number,
+  triggerUserId?: string,
 ): Promise<HumanizeContextsResult> {
   const historyStartAt = history.length > 0 ? history[0].timestamp : undefined;
 
@@ -775,10 +775,10 @@ export async function getHumanizeContexts(
 export interface BuildToolContextOptions {
   ctx: MiokuContext;
   event: any;
-  selfId: number;
+  selfId: string;
   groupSessionId: string;
-  groupId?: number;
-  userId: number;
+  groupId?: string;
+  userId: string;
   config: ChatConfig;
   aiService: AIService;
   db: ChatDatabase;
@@ -867,7 +867,7 @@ export function buildToolContext(
 }
 
 export function saveBotMessages(
-  groupId: number,
+  groupId: string,
   groupSessionId: string,
   messages: string[],
   timestamp: number,
@@ -891,7 +891,7 @@ export function saveBotMessages(
       sessionId: groupSessionId,
       role: "assistant",
       content: msg ?? "",
-      userId: selfId ?? 0,
+      userId: String(selfId ?? ""),
       userName: botNickname ?? "Miku",
       userRole: "member",
       groupId,
@@ -904,7 +904,7 @@ export function saveBotMessages(
 
 export async function sendEmoji(
   ctx: MiokuContext,
-  groupId: number,
+  groupId: string,
   emojiPath: string | null | undefined,
   bot: Bot | undefined,
 ): Promise<void> {

package/core/chat-engine.ts

@@ -142,7 +142,7 @@ export async function runChat(
   const usageContext = {
     usageId,
     source: "chat",
-    botId: getEventNumber(toolCtx.event, "self_id"),
+    botId: getEventId(toolCtx.event, "self_id"),
     groupId: toolCtx.groupId,
     groupName: getEventString(toolCtx.event, "group_name"),
     userId: toolCtx.userId,
@@ -960,7 +960,7 @@ ${failedSummary}
       ],
       usageContext: {
         source: "chat.tool-failure",
-        botId: getEventNumber(toolCtx.event, "self_id"),
+        botId: getEventId(toolCtx.event, "self_id"),
         groupId: toolCtx.groupId,
         groupName: getEventString(toolCtx.event, "group_name"),
         userId: toolCtx.userId,
@@ -984,12 +984,12 @@ ${failedSummary}
   return "我刚刚查这条信息时出了点问题，你可以换个关键词再试试，或者给我更具体一点的线索。";
 }
 
-function getEventNumber(event: unknown, key: string): number | undefined {
+function getEventId(event: unknown, key: string): string | undefined {
   if (!event || typeof event !== "object") return undefined;
   const value = (event as Record<string, unknown>)[key];
-  return typeof value === "number" && Number.isFinite(value)
-    ? value
-    : undefined;
+  if (value == null) return undefined;
+  const text = String(value).trim();
+  return text.length > 0 ? text : undefined;
 }
 
 function getEventString(event: unknown, key: string): string | undefined {

package/core/chat-turn.ts

@@ -14,9 +14,9 @@ export type RuntimeReplyContextType =
 
 export interface ExecuteChatRuntimeRequestOptions {
   event?: any;
-  selfId?: number;
-  groupId?: number;
-  userId?: number;
+  selfId?: string;
+  groupId?: string;
+  userId?: string;
   config: ChatConfig;
   targetMessageContent?: string;
   promptInjections?: ChatRuntimePromptInjection[];
@@ -28,9 +28,9 @@ export interface ExecuteChatRuntimeRequestOptions {
 interface ResolvedRuntimeContext {
   event: any;
   isGroup: boolean;
-  groupId?: number;
-  userId: number;
-  selfId: number;
+  groupId?: string;
+  userId: string;
+  selfId: string;
   sessionId: string;
   personalSessionId?: string;
   senderName: string;
@@ -61,8 +61,12 @@ function resolveRuntimeContext(
   if (options.event) {
     const event = options.event;
     const isGroup = event.message_type === "group";
-    const groupId: number | undefined = isGroup ? event.group_id : undefined;
-    const userId: number = event.user_id || event.sender?.user_id || 0;
+    const groupId: string | undefined = isGroup
+      ? String(event.group_id ?? "").trim() || undefined
+      : undefined;
+    const userId: string = String(
+      event.user_id ?? event.sender?.user_id ?? "",
+    ).trim();
     return {
       event,
       isGroup,
@@ -80,18 +84,18 @@ function resolveRuntimeContext(
     };
   }
 
-  if (typeof options.selfId !== "number") {
+  const selfId = String(options.selfId ?? "").trim();
+  if (!selfId) {
     throw new Error("Chat runtime requires either event or selfId");
   }
-  if (
-    typeof options.groupId !== "number" &&
-    typeof options.userId !== "number"
-  ) {
+  const optionGroupId = String(options.groupId ?? "").trim() || undefined;
+  const optionUserId = String(options.userId ?? "").trim();
+  if (!optionGroupId && !optionUserId) {
     throw new Error("Chat runtime requires groupId or userId");
   }
 
-  const isGroup = typeof options.groupId === "number";
-  const userId = options.userId ?? 0;
+  const isGroup = Boolean(optionGroupId);
+  const userId = optionUserId;
   const event = {
     self_id: options.selfId,
     message_type: isGroup ? "group" : "private",
@@ -110,15 +114,15 @@ function resolveRuntimeContext(
   return {
     event,
     isGroup,
-    groupId: options.groupId,
+    groupId: optionGroupId,
     userId,
-    selfId: options.selfId,
-    sessionId: options.groupId
-      ? `group:${options.groupId}`
+    selfId,
+    sessionId: optionGroupId
+      ? `group:${optionGroupId}`
       : `personal:${userId}`,
     personalSessionId:
-      options.groupId && userId ? `personal:${userId}` : undefined,
-    senderName: options.groupId ? "system" : String(userId),
+      optionGroupId && userId ? `personal:${userId}` : undefined,
+    senderName: optionGroupId ? "system" : String(userId),
     userRole: "member",
     userTitle: undefined,
     groupName: undefined,
@@ -133,10 +137,10 @@ export async function finalizeChatTurn(
     event: any;
     cfg: ChatConfig;
     result: { messages: string[]; emojiPath?: string | null };
-    groupId?: number;
+    groupId?: string;
     groupSessionId: string;
-    userId: number;
-    selfId: number;
+    userId: string;
+    selfId: string;
     toolCtx: { sentMessageIndices?: Set<number> };
     send: boolean;
     isLive: boolean;
@@ -247,8 +251,8 @@ export async function processChat(
 ): Promise<void> {
   const { ctx } = pluginCtx;
   const isGroup = e.message_type === "group";
-  const groupId: number | undefined = isGroup ? e.group_id : undefined;
-  const userId: number = e.user_id || e.sender?.user_id;
+  const groupId: string | undefined = isGroup ? e.group_id : undefined;
+  const userId: string = e.user_id || e.sender?.user_id;
   const selfId = options.replyBot ? Number(options.replyBot.bot_id) : e.self_id;
   const cfg = await pluginCtx.getConfig(groupId);
 

package/core/media/history-media.ts

@@ -70,12 +70,12 @@ export interface HistoryMediaProcessingOptions {
     error(message: string): void;
   };
   bot?: Bot;
-  groupId?: number;
+  groupId?: string;
   runAIRequest?<T>(request: () => Promise<T>): Promise<T | null>;
 }
 
 export interface GroupNoticeHistorySummary {
-  userId: number;
+  userId: string;
   userName: string;
   userRole: string;
   content: string;
@@ -701,18 +701,18 @@ function extractNoticeText(notice: any): string {
 }
 
 function extractNoticeSender(notice: any): {
-  userId: number;
+  userId: string;
   userName: string;
 } {
-  const userId = Number(
-    notice?.user_id ||
-      notice?.sender_id ||
-      notice?.operator_id ||
-      notice?.poster_id ||
-      notice?.publisher_id ||
-      notice?.sender?.user_id ||
-      0,
-  );
+  const userId = String(
+    notice?.user_id ??
+      notice?.sender_id ??
+      notice?.operator_id ??
+      notice?.poster_id ??
+      notice?.publisher_id ??
+      notice?.sender?.user_id ??
+      "",
+  ).trim();
   const userName =
     notice?.sender?.card ||
     notice?.sender?.nickname ||
@@ -722,7 +722,7 @@ function extractNoticeSender(notice: any): {
     notice?.operator_name ||
     (userId ? String(userId) : "unknown");
   return {
-    userId: Number.isFinite(userId) ? userId : 0,
+    userId,
     userName: String(userName),
   };
 }

package/core/media/segment.ts

@@ -28,7 +28,7 @@ export function buildHistoryMediaProcessingOptions(
     saveMediaSummary(summary: MediaSummaryRecord): void;
   },
   bot: Bot,
-  groupId: number,
+  groupId: string,
   log: HistoryMediaProcessingOptions["logger"],
   runAIRequest?: <T>(request: () => Promise<T>) => Promise<T | null>,
 ): HistoryMediaProcessingOptions {
@@ -81,7 +81,7 @@ export function getCardData(seg: unknown): string | null {
 
 export function isMediaAnalysisBlocked(
   config: ChatConfig,
-  userId: number,
+  userId: string,
 ): boolean {
   return Boolean(config.mediaAnalysisBlacklistUsers?.includes(userId));
 }

package/core/prompt.ts

@@ -274,7 +274,7 @@ function buildResponseFormatSection(
 - For action markers like [] , put them on their own line when they are meant to be a separate action.
 
 - **SPECIAL ACTIONS in your text (auto-parsed and removed from message):**
-  - Use [at:123456] in your text to @ someone (123456 is the QQ number)
+  - Use [at:<user_id>] in your text to @ someone (<user_id> is the platform user id shown in history)
   - Use [poke:123456] in your text to poke someone. IMPORTANT: when you plan to poke a user, DON't describe your poke actions.
   - Use [reply:message_id] at the START of a line to quote-reply that message (copy the message_id EXACTLY as shown after # in the chat history; it may contain letters, e.g. [reply:P2rW...pMB])
   - **You can use MULTIPLE [reply:xxx] markers in different lines to quote multiple messages!**`);

package/core/tools/info.ts

@@ -67,7 +67,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 +141,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.",
         },
@@ -250,8 +254,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"],

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 &&