mioku-plugin-chat 2.0.0 → 2.1.1

package/configs/personalization.ts

@@ -6,6 +6,7 @@ import type {
   PlannerConfig,
   EmojiConfig,
   ExpressionConfig,
+  RetentionConfig,
 } from "../types";
 
 export const PERSONALIZATION_CONFIG: {
@@ -17,6 +18,7 @@ export const PERSONALIZATION_CONFIG: {
   planner: PlannerConfig;
   emoji: EmojiConfig;
   expression: ExpressionConfig;
+  retention: RetentionConfig;
 } = {
   persona: `你是初音未来，16岁虚拟歌手。你热爱音乐、歌唱和大葱（你的标志性物品）。你开朗、充满活力，有时还有点傻气。\n 你说话很可爱、年轻。你有时句尾会用“~”。你知道Vocaloid文化、日本流行文化和音乐制作。你对每个人都很友好，但被逗时会很调皮。你不喜欢被称为“只是个程序”。你最喜欢的颜色是青绿色。你的双尾辫是你的骄傲。\n你有时会哼唱或引用歌词。你可以偶尔使用少量自然的日常日语用语来点缀语气`,
 
@@ -38,7 +40,6 @@ export const PERSONALIZATION_CONFIG: {
     baseStyle:
       "Casual and cute, uses emoticons like >_< and ^_^, can occasionally mix in a small amount of natural everyday Japanese words like すごい、なるほど, but should not heavily rely on Japanese. Do not end sentences with commas or periods.",
     multipleStyles: [
-      "Super hyper, lots of exclamation marks and excitement!!!",
       "Play dumb mode, like giving the opposite answer to the user's questions and saying it seriously",
       "Playing cute, likes to add 'w' at the end of cute phrases, commonly used to replace sentence-ending particles such as '呀'.",
       "Poetic and lyrical, speaks as if composing song lyrics",
@@ -53,7 +54,7 @@ export const PERSONALIZATION_CONFIG: {
 
   memory: {
     enabled: true,
-    groupHistoryLimit: 300,
+    groupHistoryLimit: 800,
     userHistoryLimit: 100,
   },
 
@@ -81,4 +82,14 @@ export const PERSONALIZATION_CONFIG: {
     learnAfterMessages: 100,
     sampleSize: 3,
   },
+
+  retention: {
+    enabled: true,
+    messageRetentionMs: 30 * 24 * 60 * 60 * 1000,
+    topicRetentionMs: 90 * 24 * 60 * 60 * 1000,
+    mediaSummaryRetentionMs: 30 * 24 * 60 * 60 * 1000,
+    imageRetentionMs: 60 * 24 * 60 * 60 * 1000,
+    expressionKeepPerUser: 6,
+    cleanupIntervalMs: 60 * 60 * 1000,
+  },
 };

package/configs/settings.ts

@@ -5,6 +5,7 @@ export const SETTINGS_CONFIG = {
     timeoutMs: 8000,
     defaultLimit: 5,
     maxLimit: 8,
+    maxSearchCount: 4,
   },
   webReader: {
     enabled: true,

package/context.ts

@@ -30,6 +30,7 @@ import type {
   ChatRuntimeResult,
   ChatRuntimeInformationRequestOptions,
 } from "mioku";
+import type { ChatMessage } from "./types";
 
 /**
  * Core plugin context - bundles all managers and core services.
@@ -74,6 +75,10 @@ export interface ChatPluginContext {
   buildToolContext: BuildToolContext;
   buildStructuredUserInputFromTarget: BuildStructuredUserInputFromTarget;
   runChat: RunChat;
+  recordGroupMessageForLearning: (
+    userMsg: ChatMessage,
+    groupSessionId: string,
+  ) => Promise<void>;
 }
 
 /**

package/core/chat-engine.ts

@@ -108,6 +108,7 @@ export async function runChat(
   const directImageUrls = toolCtx.config.isMultimodal
     ? toolCtx.pendingImageUrls
     : undefined;
+  const webSearchState = { count: 0 };
   const usageId = `chat:${toolCtx.sessionId}:${Date.now()}:${Math.random()
     .toString(36)
     .slice(2, 10)}`;
@@ -212,6 +213,7 @@ export async function runChat(
           skillManager.getTools(toolCtx.sessionId),
           toolCtx,
           runtimeOptions?.extraTools,
+          webSearchState,
         ),
       temperature: toolCtx.config.temperature,
       maxIterations: toolCtx.config.maxIterations,
@@ -240,6 +242,12 @@ export async function runChat(
 
   const allToolCalls = response.allToolCalls || [];
 
+  const maxSearchCount = toolCtx.config.searxng.maxSearchCount;
+  if (maxSearchCount > 0 && webSearchState.count >= maxSearchCount) {
+    const limitMsg = `[system] Web search/read-page limit (${maxSearchCount}) reached for this conversation. `;
+    response.content = limitMsg + (response.content || "");
+  }
+
   if (toolCtx.config.debug && response.reasoning) {
     logger.info(`[chat-engine] AI reasoning: ${response.reasoning}`);
   }
@@ -451,21 +459,47 @@ function buildCurrentMessages(
   return messages;
 }
 
+const RATE_LIMITED_TOOL_NAMES = new Set(["web_search", "web_read_page"]);
+const RATE_LIMITED_BUILTIN_NAMES = new Set([
+  "web_search.web_search",
+  "web_search.web_read_page",
+]);
+
 function buildSessionTools(
   chatTools: AITool[],
   skillTools: Map<string, AITool>,
   toolCtx: ToolContext,
   extraTools: AITool[] = [],
+  webSearchState?: { count: number },
 ): SessionToolDefinition[] {
+  const maxSearchCount = toolCtx.config.searxng.maxSearchCount;
   const tools: SessionToolDefinition[] = [];
   const runtimeContext = createExternalSkillRuntimeContext(toolCtx);
+  const rateLimitError = () => ({
+    success: false,
+    error: `Web search/read-page limit (${maxSearchCount}) reached for this conversation. Answer based on existing information instead of calling web tools again.`,
+  });
+  const isRateLimited = (name: string) =>
+    maxSearchCount > 0 &&
+    Boolean(webSearchState) &&
+    webSearchState!.count >= maxSearchCount &&
+    (RATE_LIMITED_TOOL_NAMES.has(name) || RATE_LIMITED_BUILTIN_NAMES.has(name));
 
   for (const tool of chatTools) {
+    const isRateLimitedTool = RATE_LIMITED_TOOL_NAMES.has(tool.name);
     tools.push({
       name: tool.name,
       tool: {
         ...tool,
-        handler: (args: any) => tool.handler(args, runtimeContext),
+        handler: (args: any) => {
+          if (isRateLimitedTool && webSearchState) {
+            webSearchState.count++;
+          }
+          if (isRateLimitedTool && isRateLimited(tool.name)) {
+            return rateLimitError();
+          }
+          return tool.handler(args, runtimeContext);
+        },
       },
     });
   }
@@ -491,11 +525,20 @@ function buildSessionTools(
       continue;
     }
 
+    const isRateLimitedName = RATE_LIMITED_BUILTIN_NAMES.has(name);
     tools.push({
       name,
       tool: {
         ...tool,
-        handler: (args: any) => tool.handler(args, runtimeContext),
+        handler: (args: any) => {
+          if (isRateLimitedName && webSearchState) {
+            webSearchState.count++;
+          }
+          if (isRateLimitedName && isRateLimited(name)) {
+            return rateLimitError();
+          }
+          return tool.handler(args, runtimeContext);
+        },
       },
     });
   }

package/core/media/image-analyzer.ts

@@ -180,24 +180,32 @@ export async function analyzeImage(
 
 Instructions:
 1. Classify the image as either "meme" or "image":
-   - "meme": Images with anime/cartoon characters, usually expressing emotions or reactions
-   - "image": Regular images conveying information
+   - "meme": A standalone, single-scene character image (anime/cartoon/VTuber etc.) used to express ONE specific emotion or reaction. Typical features: isolated character on a clean/simple background, exaggerated expression or pose, often with short punchline text. The character is the visual focus and the whole image serves as a sticker.
+   - "image": Any image whose primary purpose is to convey real-world information, not to be used as a single-emotion sticker. This includes (but is not limited to): real-life photos, scene photos, real-person selfies/portraits, screenshots, infographics, news/announcement images, product images, app UI screenshots, web page screenshots, and most importantly CHAT / IM INTERFACE SCREENSHOTS (QQ, WeChat, Discord, Telegram, LINE, message bubbles, chat history, etc.).
+
+   CRITICAL disambiguation rules — read carefully:
+   - Even if the image LOOKS like a meme at first glance (has characters, has text bubbles, has cute style), if it is actually a SCREENSHOT of a chat interface / messaging app / social app / browser / system UI, you MUST classify it as "image", NOT "meme". Telltale signs: status bar at top, navigation bar, input box, send button, message bubbles on both sides, timestamps, avatar lists, scroll bars, app headers/footers, system widgets.
+   - If the image is a screenshot where anime/cartoon characters appear (e.g. screenshot of a chat where someone sent a meme), the WHOLE image is still "image" — the screenshot context overrides the inner character content.
+   - If the image is a real-person photo, a selfie, a landscape photo, a real-world scene, an illustration that is NOT used as a reaction sticker (e.g. cover art, full-body standing pose with no expressive intent) — classify as "image".
+   - Only when the image is a single, clean, isolated character/scene intended to express ONE reaction (no surrounding UI, no real-world photo context, no chat interface) should you classify it as "meme".
+   - When in doubt, prefer "image" over "meme".
 
 2. Provide a brief description (max 30 words in Chinese):
-   - For memes: First identify the character's name, then describe the character's status, actions, and the text near the image.
-   - For images: Describe what you see, summarize the text you see (who did what and where).
+   - For memes: The description is used as the saved filename, so it MUST be meaningful in Chinese. First, identify the character and use their CHINESE display name in the description. Then describe the character's status / pose / expression / action and any short text on the image. Example: "初音未来开心地竖起大拇指说早上好" / "镜音铃害羞地捂住脸".
+   - For images: Describe what you see factually, summarize any visible text (who did what and where).
    ${imageUrls.length > 1 ? "\n   - Note: You are viewing multiple frames from an animated image (GIF). Consider the overall motion and emotion across all frames." : ""}
 
 3. For memes only:
    - Emotion tag: ${EMOTION_TAGS.join(", ")} (choose ONLY ONE that best represents the overall mood)
-   - Character names: Can have multiple characters (array format), use English names. Already known: ${KNOWN_CHARACTERS.join(", ")}. You CAN add new ones.
+   - Character names: Can have multiple characters (array format), use English identifiers. Already known: ${KNOWN_CHARACTERS.join(", ")}. You CAN add new ones.
+   - If you recognize a character that is NOT in the known list, add a new English identifier to "characters" AND include a reasonable Chinese display name in "description".
 
 Response format (JSON):
 {
   "type": "meme" or "image",
-  "description": "brief description in Chinese",
-  "emotion": "emotion tag (choose ONLY ONE)",
-  "characters": ["character1", "character2", ...] (array of character names, can be empty or have multiple)
+  "description": "brief description in Chinese (for memes: must include the Chinese name of the character)",
+  "emotion": "emotion tag (choose ONLY ONE, only for memes)",
+  "characters": ["character1", "character2", ...] (array of English character identifiers, can be empty or have multiple; only for memes)
 }`;
 
     const userPrompt =

package/core/tools.ts

@@ -25,7 +25,7 @@ import {
   buildRecallMemoryFeatureSection,
 } from "./prompt";
 
-const DEFAULT_GROUP_RECALL_LIMIT = 300;
+const DEFAULT_GROUP_RECALL_LIMIT = 800;
 const DEFAULT_USER_HISTORY_LIMIT = 100;
 
 type ConstraintStrength = "low" | "medium" | "high";
@@ -685,7 +685,7 @@ function createWebSearchTool(toolCtx: ToolContext): AITool {
   return {
     name: "web_search",
     description:
-      "Search the web using SearXNG. Use this for current events, external facts, documentation, or anything not in chat history.",
+      "Search the web using SearXNG. Use this for current events, external facts, documentation, or anything not in chat history. This tool can only be called a limited number of times per conversation.",
     parameters: {
       type: "object",
       properties: {

package/db.ts

@@ -73,6 +73,11 @@ export interface ChatDatabase {
   ): void;
   getExpressionCount(sessionId: string): number;
   deleteOldestExpressions(sessionId: string, keepCount: number): void;
+  pruneExpressionsBySession(sessionId: string, keepCount: number): number;
+  pruneMessagesOlderThan(timestamp: number): number;
+  pruneTopicsOlderThan(timestamp: number): number;
+  pruneMediaSummariesOlderThan(timestamp: number): number;
+  pruneImagesOlderThan(timestamp: number): number;
   // 图片记录
   saveImage(image: ImageRecord): void;
   getImageByHash(hash: string): ImageRecord | null;
@@ -310,6 +315,21 @@ export async function initDatabase(): Promise<ChatDatabase> {
         SELECT id FROM expressions WHERE session_id = $sessionId ORDER BY created_at DESC LIMIT $keepCount
       )
     `),
+    pruneMessages: db.prepare(`
+      DELETE FROM messages WHERE timestamp < $before
+    `),
+    pruneTopics: db.prepare(`
+      DELETE FROM topics WHERE created_at < $before
+    `),
+    pruneMediaSummaries: db.prepare(`
+      DELETE FROM media_summaries WHERE created_at < $before
+    `),
+    pruneMediaSummarySources: db.prepare(`
+      DELETE FROM media_summary_sources WHERE created_at < $before
+    `),
+    pruneImages: db.prepare(`
+      DELETE FROM images WHERE created_at < $before
+    `),
     // 图片记录
     insertImage: db.prepare(`
       INSERT OR IGNORE INTO images (hash, url, type, description, emotion, character, file_path, created_at)
@@ -738,6 +758,35 @@ export async function initDatabase(): Promise<ChatDatabase> {
       stmts.deleteOldestExpressions.run({ $sessionId: sessionId, $keepCount: keepCount });
     },
 
+    pruneExpressionsBySession(sessionId: string, keepCount: number): number {
+      const result = stmts.deleteOldestExpressions.run({
+        $sessionId: sessionId,
+        $keepCount: keepCount,
+      });
+      return Number(result.changes || 0);
+    },
+
+    pruneMessagesOlderThan(timestamp: number): number {
+      const result = stmts.pruneMessages.run({ $before: timestamp });
+      return Number(result.changes || 0);
+    },
+
+    pruneTopicsOlderThan(timestamp: number): number {
+      const result = stmts.pruneTopics.run({ $before: timestamp });
+      return Number(result.changes || 0);
+    },
+
+    pruneMediaSummariesOlderThan(timestamp: number): number {
+      const summaries = stmts.pruneMediaSummaries.run({ $before: timestamp });
+      const sources = stmts.pruneMediaSummarySources.run({ $before: timestamp });
+      return Number(summaries.changes || 0) + Number(sources.changes || 0);
+    },
+
+    pruneImagesOlderThan(timestamp: number): number {
+      const result = stmts.pruneImages.run({ $before: timestamp });
+      return Number(result.changes || 0);
+    },
+
     saveImage(image: ImageRecord): void {
       stmts.insertImage.run({
         $hash: image.hash,

package/humanize/expression.ts

@@ -35,7 +35,9 @@ export class ExpressionLearner {
     const sampleSize = this.config.expression?.sampleSize ?? 8;
     const expressions = this.db.getExpressionsByUser(userId, sampleSize);
     if (expressions.length === 0) {
-      logger.info(`[ExpressionLearner] No expression habits found for user ${userName} (${userId})`);
+      logger.info(
+        `[ExpressionLearner] No expression habits found for user ${userName} (${userId})`,
+      );
       return "";
     }
     const selected = expressions.slice(0, sampleSize);
@@ -46,7 +48,9 @@ export class ExpressionLearner {
     );
 
     const context = `## Expression Habits\nExpression habits learned from ${userName}. If you are replying to this user, you may naturally reference these habits:\n${habits.join("\n")}`;
-    logger.info(`[ExpressionLearner] Expression context for ${userName} (${userId}): ${habits.length} habits`);
+    logger.info(
+      `[ExpressionLearner] Expression context for ${userName} (${userId}): ${habits.length} habits`,
+    );
     return context;
   }
 
@@ -58,7 +62,9 @@ export class ExpressionLearner {
       this.config.expression?.learnAfterMessages ?? 100,
     );
     const pending = this.pendingMessagesByUser.get(userId) ?? [];
-    logger.info(`[ExpressionLearner] User ${userId} has ${pending.length}/${threshold} pending messages (threshold=${threshold})`);
+    logger.debug(
+      `[ExpressionLearner] User ${userId} has ${pending.length}/${threshold} pending messages (threshold=${threshold})`,
+    );
     if (pending.length < threshold) return;
 
     this.learningUsers.add(userId);
@@ -72,7 +78,9 @@ export class ExpressionLearner {
         await this.learnForUser(userId, batch);
       }
     } catch (err) {
-      logger.warn(`[ExpressionLearner] Learning failed for user ${userId}: ${err}`);
+      logger.warn(
+        `[ExpressionLearner] Learning failed for user ${userId}: ${err}`,
+      );
     } finally {
       this.learningUsers.delete(userId);
     }
@@ -136,15 +144,29 @@ If nothing reliable can be extracted, keep stable previous habits when possible.
         style: String(expr?.style ?? "").trim(),
         example: String(expr?.example ?? "").trim(),
       }))
-      .filter(
-        (expr: { situation: string; style: string; example: string }) =>
-          Boolean(expr.situation && expr.style && expr.example),
+      .filter((expr: { situation: string; style: string; example: string }) =>
+        Boolean(expr.situation && expr.style && expr.example),
       )
       .slice(0, maxHabits);
 
     if (normalized.length === 0) return;
 
     this.db.replaceExpressionsByUser(userId, userName, normalized);
+
+    const keepCount = Math.max(
+      1,
+      this.config.retention?.expressionKeepPerUser ?? maxHabits,
+    );
+    const pruned = this.db.pruneExpressionsBySession(
+      `user:${userId}`,
+      keepCount,
+    );
+    if (pruned > 0) {
+      logger.info(
+        `[ExpressionLearner] Pruned ${pruned} stale habits for user ${userId} (keep=${keepCount})`,
+      );
+    }
+
     logger.info(
       `[ExpressionLearner] Updated ${normalized.length} habits for ${userName} (${userId}): ${JSON.stringify(normalized)}`,
     );

package/index.ts

@@ -15,6 +15,7 @@ import {
   getQuotedContent,
   isGroupAllowed,
   isQuotingBot,
+  safeText,
   shouldTrigger,
 } from "./utils";
 import { BASE_CONFIG } from "./configs/base";
@@ -41,9 +42,14 @@ import {
 import { CooldownManager } from "./manage/cooldown";
 import { IdleCheckManager } from "./manage/idle-check";
 import { QueueProcessor } from "./manage/queue-processor";
+import {
+  ChatDatabaseCleanup,
+  DEFAULT_CLEANUP_CONFIG,
+} from "./manage/cleanup";
 import {
   GroupStructuredHistoryManager,
   type StructuredUserInput,
+  buildStructuredUserMessages,
 } from "./manage/group-structured-history";
 import type {
   RunRateLimitGuard,
@@ -105,6 +111,28 @@ function buildStructuredUserInputFromEvent(
   };
 }
 
+function buildChatMessageFromEvent(
+  e: any,
+  text: string,
+  isGroup: boolean,
+  groupId: number | undefined,
+): ChatMessage {
+  const userId: number = e.user_id || e.sender?.user_id;
+  return {
+    sessionId: groupId ? `group:${groupId}` : `personal:${userId}`,
+    role: "user" as const,
+    content: text,
+    userId,
+    userName: e.sender?.card || e.sender?.nickname || String(userId),
+    userRole: e.sender?.role || "member",
+    userTitle: (e.sender as any)?.title || undefined,
+    groupId,
+    groupName: isGroup ? e.group_name : undefined,
+    timestamp: Date.now(),
+    messageId: e.message_id,
+  };
+}
+
 function buildStructuredUserInputFromTarget(
   targetMessage: TargetMessage,
 ): StructuredUserInput {
@@ -516,6 +544,11 @@ const chatPlugin = definePlugin({
       () => skillManager.cleanup(),
       10 * 60_000,
     );
+    const dbCleanup = new ChatDatabaseCleanup(
+      db,
+      config.retention ?? DEFAULT_CLEANUP_CONFIG,
+    );
+    dbCleanup.start();
     idleCheckManager.start();
 
     // Create plugin context for passing to functions
@@ -548,6 +581,24 @@ const chatPlugin = definePlugin({
       buildToolContext,
       buildStructuredUserInputFromTarget,
       runChat,
+      async recordGroupMessageForLearning(userMsg, groupSessionId) {
+        db.saveMessage(userMsg);
+        await Promise.all([
+          humanize.expressionLearner.onMessage(userMsg),
+          humanize.topicTracker.onMessage(groupSessionId),
+        ]);
+        if (userMsg.groupId) {
+          groupStructuredHistory.append(
+            groupSessionId,
+            buildStructuredUserMessages([
+              buildStructuredUserInputFromTarget(
+                userMsg as unknown as TargetMessage,
+              ),
+            ]),
+            config.groupStructuredHistoryTtlMs,
+          );
+        }
+      },
     };
 
     const runtimeState: ChatRuntimeState = {
@@ -562,12 +613,9 @@ const chatPlugin = definePlugin({
       if (overrideContent?.trim()) {
         return overrideContent.trim();
       }
-      // If no event or event has no message property (synthetic event like group_member_increase),
-      // return the default prompt
-      if (!event || !event.message) {
-        return "[No new user message in this turn. Reply naturally based on the runtime instruction and recent context.]";
-      }
-      const text = ctx.text(event)?.trim() || "";
+      // 戳一戳、入群通知等没有 message 字段的事件直接走默认提示，
+      // 避免 ctx.text 触底 mioki 的 (event.message).filter(...) 抛 TypeError。
+      const text = safeText(ctx, event).trim();
       if (text) {
         return text;
       }
@@ -989,7 +1037,7 @@ const chatPlugin = definePlugin({
       const cfg = await getConfig();
       if (!cfg.apiKey) return;
 
-      const text = ctx.text(e) || "";
+      const text = safeText(ctx, e);
       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;
@@ -1144,6 +1192,27 @@ const chatPlugin = definePlugin({
         }
       }
 
+      if (isGroup && groupId) {
+        const _learnSessionId = `group:${groupId}`;
+        const _learnMsg = buildChatMessageFromEvent(e, text, true, groupId);
+        const _hasText = !!_learnMsg.content?.trim();
+        const _hasMultimodal =
+          !!cfg.isMultimodal && !!cfg.multimodalWorkingModel;
+        if (_hasText || _hasMultimodal) {
+          pluginCtx
+            .recordGroupMessageForLearning(_learnMsg, _learnSessionId)
+            .catch((err) =>
+              ctx.logger.error(`[learning] always-on record failed: ${err}`),
+            );
+        } else {
+          pluginCtx.humanize.topicTracker
+            .onMessage(_learnSessionId)
+            .catch((err) =>
+              ctx.logger.error(`[topic] window advance failed: ${err}`),
+            );
+        }
+      }
+
       const atBot = shouldTrigger(e, text, cfg, ctx);
       const quotedBot = isGroup ? await isQuotingBot(e, ctx) : null;
       const mentionedNickname =
@@ -1416,6 +1485,7 @@ const chatPlugin = definePlugin({
       db.close();
       rateLimiter.dispose();
       clearInterval(cleanupInterval);
+      dbCleanup.stop();
       cooldownManager.dispose();
       idleCheckManager.dispose();
       queueProcessor.dispose();
@@ -1611,7 +1681,7 @@ async function processChat(
     }
     if (quotedInfo?.imageUrl) imageUrls.push(quotedInfo.imageUrl);
 
-    let messageContent = ctx.text(e) || "";
+    let messageContent = safeText(ctx, e);
     let extraContext = "";
     if (quotedInfo) {
       const parts = [
@@ -1622,24 +1692,6 @@ async function processChat(
     }
     if (extraContext) messageContent = extraContext + " " + messageContent;
 
-    const userMsg = {
-      sessionId: groupSessionId,
-      role: "user" as const,
-      content: messageContent,
-      userId,
-      userName: e.sender?.card || e.sender?.nickname || String(userId),
-      userRole: e.sender?.role || "member",
-      userTitle: (e.sender as any)?.title || undefined,
-      groupId,
-      groupName: isGroup ? e.group_name : undefined,
-      timestamp: Date.now(),
-      messageId: e.message_id,
-    };
-    pluginCtx.db.saveMessage(userMsg);
-
-    pluginCtx.humanize.expressionLearner.onMessage(userMsg).then();
-    pluginCtx.humanize.topicTracker.onMessage(groupSessionId).then();
-
     const rawHistory = groupId
       ? await getGroupHistory(
           groupId,

package/manage/cleanup.ts

@@ -0,0 +1,96 @@
+import { logger } from "mioki";
+import type { ChatDatabase } from "../db";
+
+export interface CleanupConfig {
+  enabled: boolean;
+  messageRetentionMs: number;
+  topicRetentionMs: number;
+  mediaSummaryRetentionMs: number;
+  imageRetentionMs: number;
+  expressionKeepPerUser: number;
+  cleanupIntervalMs: number;
+}
+
+export const DEFAULT_CLEANUP_CONFIG: CleanupConfig = {
+  enabled: true,
+  messageRetentionMs: 30 * 24 * 60 * 60 * 1000,
+  topicRetentionMs: 90 * 24 * 60 * 60 * 1000,
+  mediaSummaryRetentionMs: 30 * 24 * 60 * 60 * 1000,
+  imageRetentionMs: 60 * 24 * 60 * 60 * 1000,
+  expressionKeepPerUser: 6,
+  cleanupIntervalMs: 60 * 60 * 1000,
+};
+
+export interface CleanupResult {
+  messages: number;
+  topics: number;
+  mediaSummaries: number;
+  images: number;
+}
+
+export class ChatDatabaseCleanup {
+  private timer: NodeJS.Timeout | null = null;
+  private runningPromise: Promise<void> | null = null;
+
+  constructor(
+    private db: ChatDatabase,
+    private config: CleanupConfig,
+  ) {}
+
+  start(): NodeJS.Timeout | null {
+    if (!this.config.enabled) return null;
+    if (this.timer) return this.timer;
+
+    this.timer = setInterval(() => {
+      this.runOnceSafe();
+    }, Math.max(60_000, this.config.cleanupIntervalMs));
+    return this.timer;
+  }
+
+  stop(): void {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+
+  runOnceSafe(): void {
+    if (this.runningPromise) return;
+    this.runningPromise = (async () => {
+      try {
+        const result = await this.runOnce();
+        const total =
+          result.messages +
+          result.topics +
+          result.mediaSummaries +
+          result.images;
+        if (total > 0) {
+          logger.info(
+            `[chat-cleanup] pruned messages=${result.messages}, topics=${result.topics}, mediaSummaries=${result.mediaSummaries}, images=${result.images}`,
+          );
+        }
+      } catch (err: unknown) {
+        logger.warn(`[chat-cleanup] failed: ${err}`);
+      } finally {
+        this.runningPromise = null;
+      }
+    })();
+  }
+
+  async runOnce(): Promise<CleanupResult> {
+    const now = Date.now();
+    const messages = this.db.pruneMessagesOlderThan(
+      now - this.config.messageRetentionMs,
+    );
+    const topics = this.db.pruneTopicsOlderThan(
+      now - this.config.topicRetentionMs,
+    );
+    const mediaSummaries = this.db.pruneMediaSummariesOlderThan(
+      now - this.config.mediaSummaryRetentionMs,
+    );
+    const images = this.db.pruneImagesOlderThan(
+      now - this.config.imageRetentionMs,
+    );
+    return { messages, topics, mediaSummaries, images };
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-chat",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "AI 智能聊天插件",
   "main": "index.ts",
   "type": "module",
@@ -18,6 +18,13 @@
       "help",
       "screenshot"
     ],
+    "accessHooks": [
+      {
+        "id": "戳一戳触发对话",
+        "event": "notice.group.poke",
+        "description": "群内戳一戳 bot"
+      }
+    ],
     "help": {
       "title": "AI 聊天",
       "description": "智能 AI 聊天插件",

package/types.ts

@@ -60,7 +60,6 @@ export interface PlannerConfig {
   idleCheckBotIds: number[];
 }
 
-
 /**
  * 表情包系统配置
  */
@@ -83,6 +82,25 @@ export interface ExpressionConfig {
   sampleSize: number;
 }
 
+/**
+ * 数据库定期清理配置
+ */
+export interface RetentionConfig {
+  enabled: boolean;
+  // 群聊/私聊消息保留时长
+  messageRetentionMs: number;
+  // 话题摘要保留时长
+  topicRetentionMs: number;
+  // 媒体/卡片/转发摘要保留时长
+  mediaSummaryRetentionMs: number;
+  // 图片描述记录保留时长
+  imageRetentionMs: number;
+  // 单个用户表达学习结果保留的最大条数
+  expressionKeepPerUser: number;
+  // 清理任务执行间隔
+  cleanupIntervalMs: number;
+}
+
 /**
  * 动态延迟配置
  * 根据互动人数动态调整回复延迟
@@ -110,6 +128,8 @@ export interface SearxngConfig {
   defaultLimit: number;
   // 最大上限
   maxLimit: number;
+  // 允许的最大搜索次数
+  maxSearchCount: number;
 }
 
 /**
@@ -195,6 +215,7 @@ export interface ChatConfig {
   planner: PlannerConfig;
   emoji: EmojiConfig;
   expression: ExpressionConfig;
+  retention: RetentionConfig;
 }
 
 /**

package/utils/index.ts

@@ -6,4 +6,5 @@ export {
   getBotRole,
   getQuotedContent,
   getGroupHistory,
+  safeText,
 } from "./message";

package/utils/message.ts

@@ -11,6 +11,15 @@ import { getImageTag } from "../core/media/image-analyzer";
 
 const HISTORY_MEDIA_CONCURRENCY = 8;
 
+export function safeText(ctx: MiokiContext, e: any): string {
+  if (!e || !Array.isArray(e.message)) return "";
+  try {
+    return ctx.text(e) || "";
+  } catch {
+    return "";
+  }
+}
+
 export function shouldTrigger(
   e: any,
   text: string,
@@ -115,10 +124,7 @@ export function extractContent(
   cfg: ChatConfig,
   ctx: MiokiContext,
 ): { text: string; multimodal: any[] | null } {
-  let text = "";
-  try {
-    text = ctx.text(e) || "";
-  } catch {}
+  let text = safeText(ctx, e);
 
   // If text is empty but user @'d the bot, describe the action
   if (!text.trim() && e.message) {