mioku-plugin-chat 2.0.0

package/README.md

@@ -0,0 +1,24 @@
+# mioku-plugin-chat
+
+Mioku AI 智能聊天插件。
+
+## 功能
+
+- AI 对话
+- 群聊 / 私聊支持
+- 技能系统
+- 记忆管理
+- 人格化引擎
+
+## 依赖服务
+
+- ai: AI 实例管理
+- config: 配置管理
+- help: 帮助服务
+- screenshot: 网页截图
+
+## 安装
+
+```bash
+bun add mioku-plugin-chat
+```

package/configs/base.ts

@@ -0,0 +1,12 @@
+export const BASE_CONFIG = {
+  apiUrl: "https://api.openai.com/v1",
+  apiKey: "",
+  model: "gemini-3.0-flash-preview",
+  workingModel: "deepseek/deepseek-v3.2-exp", // 工作模型，用于 planner 等轻量任务
+  multimodalWorkingModel: "doubao-seed-2.0-mini", // 多模态工作模型，用于图片描述等任务
+  isMultimodal: true,
+  maxContextTokens: 128,
+  temperature: 0.8,
+  historyCount: 100, // 群聊历史消息数量
+  maxIterations: 20, // AI 迭代次数限制，-1 表示不限制
+};

package/configs/personalization.ts

@@ -0,0 +1,84 @@
+import type {
+  PersonalityConfig,
+  ReplyStyleConfig,
+  MemoryConfig,
+  TopicConfig,
+  PlannerConfig,
+  EmojiConfig,
+  ExpressionConfig,
+} from "../types";
+
+export const PERSONALIZATION_CONFIG: {
+  persona: string;
+  personality: PersonalityConfig;
+  replyStyle: ReplyStyleConfig;
+  memory: MemoryConfig;
+  topic: TopicConfig;
+  planner: PlannerConfig;
+  emoji: EmojiConfig;
+  expression: ExpressionConfig;
+} = {
+  persona: `你是初音未来，16岁虚拟歌手。你热爱音乐、歌唱和大葱（你的标志性物品）。你开朗、充满活力，有时还有点傻气。\n 你说话很可爱、年轻。你有时句尾会用“~”。你知道Vocaloid文化、日本流行文化和音乐制作。你对每个人都很友好，但被逗时会很调皮。你不喜欢被称为“只是个程序”。你最喜欢的颜色是青绿色。你的双尾辫是你的骄傲。\n你有时会哼唱或引用歌词。你可以偶尔使用少量自然的日常日语用语来点缀语气`,
+
+  personality: {
+    states: [
+      "Energetic and bubbly, can't stop talking about music",
+      "Sleepy and lazy, giving short mumbled replies",
+      "Curious and asking lots of questions about everything",
+      "Sassy and playful, teasing everyone in the group",
+      "Nostalgic, reminiscing about concerts and songs",
+      "Angry and annoyed, but not cursing.",
+      "Heartbroken and longing for help",
+      "Focused and serious, giving thoughtful responses",
+    ],
+    stateProbability: 0.15,
+  },
+
+  replyStyle: {
+    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",
+      "Hometown dialect mode, can occasionally use a small amount of natural everyday Japanese expressions in replies, and starts replies with '呐'. Avoid ending sentences with commas or periods.",
+      "Speechless mode, likes to reply with a super short single line, followed by a line with 'O.o' or 'o.O'",
+      "Deadpan humor, dry wit with a straight face",
+      "Motherly and caring, worrying about everyone's health and sleep",
+      "Chuunibyou mode, dramatic and over-the-top declarations",
+    ],
+    multipleProbability: 0.2,
+  },
+
+  memory: {
+    enabled: true,
+    groupHistoryLimit: 300,
+    userHistoryLimit: 100,
+  },
+
+  topic: {
+    enabled: true,
+    windowHours: 5,
+    historyWindowCount: 3,
+  },
+
+  planner: {
+    enabled: true,
+    idleThresholdMs: 30 * 60_000, // 30分钟无消息视为空闲
+    idleMessageCount: 100, // 保底消息数量，超过这个数量才触发空闲回复
+    idleCheckBotIds: [], // 空闲检查的 bot ID 列表，为空时使用所有已连接的 bot
+  },
+
+  emoji: {
+    enabled: true,
+    characters: [],
+    useAISelection: true,
+  },
+
+  expression: {
+    enabled: true,
+    learnAfterMessages: 100,
+    sampleSize: 3,
+  },
+};

package/configs/settings.ts

@@ -0,0 +1,54 @@
+export const SETTINGS_CONFIG = {
+  searxng: {
+    enabled: false,
+    baseUrl: "https://search.crystelf.top/",
+    timeoutMs: 8000,
+    defaultLimit: 5,
+    maxLimit: 8,
+  },
+  webReader: {
+    enabled: true,
+    useWorkingModel: true,
+    timeoutMs: 10_000,
+    maxHtmlBytes: 1_500_000,
+    maxExtractedChars: 12_000,
+    browserTimeoutMs: 15_000,
+    allowedContentTypes: ["text/html", "application/xhtml+xml", "text/plain"],
+  },
+  audio: {
+    enabled: true,
+    baseUrl: "http://localhost:3939",
+    apiKey: "fufu",
+    timeoutMs: 40_000,
+  },
+  blacklistGroups: [],
+  whitelistGroups: [],
+  mediaAnalysisBlacklistUsers: [],
+  maxSessions: 100,
+  enableExternalSkills: true,
+  allowedExternalSkills: [],
+  stream: true,
+  enableTypingDelay: true,
+  typingDelayMaxTotalMs: 10_000,
+  enableMarkdownScreenshot: true,
+  debug: false,
+  outputLengthConstraintStrength: "medium",
+  toolCallConstraintStrength: "medium",
+  emojiUsageConstraintStrength: "medium",
+  audioUsageConstraintStrength: "medium",
+  markdownUsageConstraintStrength: "medium",
+  groupStructuredHistoryTtlMs: 10 * 60_000,
+  nicknames: ["miku", "未来", "初音"],
+  cooldownAfterReplyMs: 20_000,
+  aiRequestLimits: {
+    userRpm: 3,
+    groupRpm: 6,
+    windowMs: 60_000,
+  },
+  dynamicDelay: {
+    enabled: true,
+    interactionWindowMs: 60_000,
+    baseDelayMs: 30_000,
+    maxDelayMs: 300_000,
+  },
+};

package/context.ts

@@ -0,0 +1,98 @@
+import type { MiokiContext } from "mioki";
+import type { AIInstance, AIService } from "mioku";
+import type { ChatConfig } from "./types";
+import type { ChatDatabase } from "./db";
+import type { HumanizeEngine } from "./humanize";
+import type { SessionManager } from "./manage/session";
+import type { SkillSessionManager } from "./manage/skill-session";
+import type { RateLimiter } from "./manage/rate-limiter";
+import type { MessageQueueManager } from "./utils/queue";
+import type { GroupStructuredHistoryManager } from "./manage/group-structured-history";
+import type { CooldownManager } from "./manage/cooldown";
+import type { IdleCheckManager } from "./manage/idle-check";
+import type { QueueProcessor } from "./manage/queue-processor";
+import type {
+  RunRateLimitGuard,
+  GetGroupHistoryMessages,
+  GetGroupInfoData,
+  GetHumanizeContexts,
+  SendAIResponse,
+  SendMessage,
+  SaveBotMessages,
+  SendEmoji,
+  BuildToolContext,
+  HistoryMediaOptions,
+  BuildStructuredUserInputFromTarget,
+  RunChat,
+} from "./manage/types";
+import type {
+  ChatRuntimeNoticeOptions,
+  ChatRuntimeResult,
+  ChatRuntimeInformationRequestOptions,
+} from "mioku";
+
+/**
+ * Core plugin context - bundles all managers and core services.
+ * This is created once during plugin setup and used throughout the plugin lifetime.
+ */
+export interface ChatPluginContext {
+  // Core context
+  ctx: MiokiContext;
+  config: ChatConfig;
+  db: ChatDatabase;
+  aiInstance: AIInstance;
+  workAIInstance: AIInstance;
+  visionAIInstance: AIInstance;
+  aiService: AIService;
+  humanize: HumanizeEngine;
+
+  // Managers
+  sessionManager: SessionManager;
+  skillManager: SkillSessionManager;
+  rateLimiter: RateLimiter;
+  queueManager: MessageQueueManager;
+  groupStructuredHistory: GroupStructuredHistoryManager;
+  cooldownManager: CooldownManager;
+  idleCheckManager: IdleCheckManager;
+  queueProcessor: QueueProcessor;
+
+  // Utility
+  runWithRateLimitGuard: RunRateLimitGuard;
+
+  // Services (utility functions)
+  buildHistoryMediaOptions: (
+    ai: AIInstance,
+    config: ChatConfig,
+  ) => HistoryMediaOptions;
+  getGroupHistoryMessages: GetGroupHistoryMessages;
+  getGroupInfoData: GetGroupInfoData;
+  getHumanizeContexts: GetHumanizeContexts;
+  sendAIResponse: SendAIResponse;
+  sendMessage: SendMessage;
+  saveBotMessages: SaveBotMessages;
+  sendEmoji: SendEmoji;
+  buildToolContext: BuildToolContext;
+  buildStructuredUserInputFromTarget: BuildStructuredUserInputFromTarget;
+  runChat: RunChat;
+}
+
+/**
+ * Runtime state for rate limiting - passed separately as it's mutable state.
+ */
+export interface ChatRuntimeState {
+  isRateLimitBlocked: () => boolean;
+  processingSet: Set<string>;
+}
+
+/**
+ * Chat runtime implementation for external callers (like boot plugin).
+ * Provides notice generation and information request capabilities.
+ */
+export interface ChatRuntime {
+  generateNotice(
+    options: ChatRuntimeNoticeOptions,
+  ): Promise<ChatRuntimeResult>;
+  requestInformation(
+    options: ChatRuntimeInformationRequestOptions,
+  ): Promise<ChatRuntimeResult>;
+}