mioku 1.0.6 → 1.0.8

package/dist/{exec-O8rCedzr.cjs.map → exec-BzdYBQLQ.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"exec-O8rCedzr.cjs","names":["path","candidate: string","command: string","resolved: string | null","resolved: string","args: string[]","options: { cwd?: string; env?: NodeJS.ProcessEnv }","options: { cwd?: string }"],"sources":["../package.json","../src/internal/exec.ts"],"sourcesContent":["{\n  \"name\": \"mioku\",\n  \"type\": \"module\",\n  \"version\": \"1.0.6\",\n  \"packageManager\": \"bun@1.2.0\",\n  \"description\": \"Mioku - A plugin-based QQ bot framework\",\n  \"keywords\": [\n    \"onebot\",\n    \"framework\",\n    \"bot\",\n    \"mioku\"\n  ],\n  \"bin\": {\n    \"mioku\": \"./dist/cli/index.js\"\n  },\n  \"engines\": {\n    \"node\": \">= 22.18.0\"\n  },\n  \"homepage\": \"https://github.com/mioku-lab/mioku#readme\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"bugs\": {\n    \"url\": \"https://github.com/mioku-lab/mioku/issues\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/mioku-lab/mioku.git\",\n    \"directory\": \"packages/mioku\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsdown -w\",\n    \"build\": \"tsdown\",\n    \"typecheck\": \"tsc --noEmit\"\n  },\n  \"exports\": {\n    \".\": {\n      \"require\": \"./dist/index.cjs\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"author\": \"Jerryplusy <jerryplusy@outlook.com>\",\n  \"license\": \"MIT\",\n  \"dependencies\": {\n    \"napcat-sdk\": \"^0.16.0\",\n    \"consola\": \"^3.4.2\",\n    \"dayjs\": \"^1.11.19\",\n    \"dedent\": \"^1.7.1\",\n    \"filesize\": \"^11.0.13\",\n    \"inquirer\": \"^10.0.0\",\n    \"jiti\": \"^2.6.1\",\n    \"lowdb\": \"^7.0.1\",\n    \"mri\": \"^1.2.0\",\n    \"node-cron\": \"^4.2.1\",\n    \"pretty-ms\": \"^9.3.0\",\n    \"string2argv\": \"^1.0.2\",\n    \"lodash\": \"^4.17.21\"\n  },\n  \"devDependencies\": {\n    \"@types/lodash\": \"^4.17.0\",\n    \"@types/node\": \"^22.0.0\",\n    \"tsdown\": \"^0.11.0\",\n    \"typescript\": \"^5.8.0\"\n  }\n}\n","import { spawn, spawnSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\n\nconst isWindows = process.platform === \"win32\";\n\nconst resolveCache = new Map<string, string | null>();\n\nfunction windowsExtensions(): string[] {\n  const raw = process.env.PATHEXT || \".COM;.EXE;.BAT;.CMD\";\n  return raw\n    .split(\";\")\n    .map((ext) => ext.trim())\n    .filter(Boolean);\n}\n\n// PATH is a snapshot taken at process start, so a package manager installed\n// mid-run won't be on it. We enumerate every plausible install prefix for\n// bun / npm / scoop / chocolatey so the CLI can find bun in one shot.\nfunction searchDirs(): string[] {\n  const raw = process.env.PATH || process.env.Path || \"\";\n  const dirs = raw\n    .split(path.delimiter)\n    .map((d) => d.trim())\n    .filter(Boolean);\n  const home = os.homedir();\n  const appData = process.env.APPDATA || path.join(home, \"AppData\", \"Roaming\");\n  const localAppData =\n    process.env.LOCALAPPDATA || path.join(home, \"AppData\", \"Local\");\n  const programFiles = process.env.ProgramFiles || \"C:\\\\Program Files\";\n  const programFilesX86 =\n    process.env[\"ProgramFiles(x86)\"] || \"C:\\\\Program Files (x86)\";\n\n  const extra = isWindows\n    ? [\n        // 官方安装器\n        path.join(home, \".bun\", \"bin\"),\n        // npm 全局（带 .cmd shim）\n        path.join(appData, \"npm\"),\n        path.join(appData, \"npm\", \"node_modules\", \".bin\"),\n        // 备用 bun 位置\n        path.join(localAppData, \"bun\", \"bin\"),\n        path.join(programFiles, \"bun\", \"bin\"),\n        path.join(programFilesX86, \"bun\", \"bin\"),\n        // scoop\n        path.join(home, \"scoop\", \"shims\"),\n        // chocolatey\n        \"C:\\\\ProgramData\\\\chocolatey\\\\bin\",\n        // node 自带（很多用户 npm i -g 装到 node 目录）\n        path.join(programFiles, \"nodejs\"),\n        path.join(programFilesX86, \"nodejs\"),\n      ]\n    : [\n        path.join(home, \".bun\", \"bin\"),\n        \"/usr/local/bin\",\n        \"/opt/homebrew/bin\",\n        path.join(home, \".npm-global\", \"bin\"),\n      ];\n\n  return [...dirs, ...extra.filter((dir) => dir && !dir.endsWith(path.sep))];\n}\n\nfunction isExecutableFile(candidate: string): boolean {\n  try {\n    return fs.statSync(candidate).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction searchCommandViaShell(command: string): string | null {\n  if (command.includes(\"/\") || command.includes(path.sep)) return null;\n  const shellCmd = isWindows ? \"where\" : \"which\";\n  try {\n    const result = spawnSync(shellCmd, [command], {\n      encoding: \"utf-8\",\n      windowsHide: true,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      timeout: 5000,\n    });\n    if (result.status === 0 && result.stdout) {\n      const first = result.stdout\n        .split(/\\r?\\n/)\n        .map((s) => s.trim())\n        .find(Boolean);\n      if (first && isExecutableFile(first)) return first;\n    }\n  } catch {}\n  return null;\n}\n\n/** 在 PATH 及常见安装目录中解析命令的完整路径，结果带缓存 */\nexport function resolveCommand(command: string): string | null {\n  if (resolveCache.has(command)) return resolveCache.get(command) ?? null;\n\n  let resolved: string | null = null;\n\n  if (command.includes(\"/\") || command.includes(path.sep)) {\n    resolved = isExecutableFile(command) ? path.resolve(command) : null;\n  } else {\n    const exts = isWindows ? windowsExtensions() : [\"\"];\n    const hasKnownExt =\n      isWindows &&\n      exts.some((ext) => command.toLowerCase().endsWith(ext.toLowerCase()));\n\n    outer: for (const dir of searchDirs()) {\n      if (hasKnownExt) {\n        const direct = path.join(dir, command);\n        if (isExecutableFile(direct)) {\n          resolved = direct;\n          break;\n        }\n        continue;\n      }\n      for (const ext of exts) {\n        const candidate = path.join(dir, command + ext);\n        if (isExecutableFile(candidate)) {\n          resolved = candidate;\n          break outer;\n        }\n      }\n    }\n\n    if (!resolved) resolved = searchCommandViaShell(command);\n  }\n\n  resolveCache.set(command, resolved);\n  return resolved;\n}\n\nexport function clearCommandCache(): void {\n  resolveCache.clear();\n}\n\nfunction needsCmdShell(resolved: string): boolean {\n  if (!isWindows) return false;\n  const ext = path.extname(resolved).toLowerCase();\n  return ext === \".cmd\" || ext === \".bat\";\n}\n\nexport interface SpawnPlan {\n  file: string;\n  args: string[];\n  windowsVerbatimArguments?: boolean;\n  shell?: boolean | string;\n}\n\n// Windows can't CreateProcess a .cmd/.bat shim directly (npm installs bun as\n// bun.cmd), so those get routed through cmd.exe via shell: true. Previously\n// we hand-rolled a cmd.exe invocation with windowsVerbatimArguments: true,\n// but that combination misbehaves with spawnSync + stdio:\"inherit\" on\n// Node.js >= 20 (manifests as the spawned process printing \"undefined\" or\n// a spurious EINVAL), so we let Node's shell wrapper do the quoting.\n/** 生成跨平台的 spawn 参数，Windows 下 .cmd/.bat 会改经 cmd.exe 执行 */\nexport function buildSpawnPlan(command: string, args: string[]): SpawnPlan {\n  const resolved = resolveCommand(command);\n\n  if (!resolved) {\n    return { file: command, args };\n  }\n\n  if (!needsCmdShell(resolved)) {\n    return { file: resolved, args };\n  }\n\n  return {\n    file: resolved,\n    args,\n    shell: true,\n  };\n}\n\nexport interface RunCommandResult {\n  stdout: string;\n  stderr: string;\n  code: number;\n}\n\n/** 执行命令并收集 stdout/stderr 与退出码，失败不抛异常 */\nexport function runCommand(\n  command: string,\n  args: string[],\n  options: { cwd?: string; env?: NodeJS.ProcessEnv } = {},\n): Promise<RunCommandResult> {\n  const plan = buildSpawnPlan(command, args);\n\n  return new Promise((resolve) => {\n    const child = spawn(plan.file, plan.args, {\n      cwd: options.cwd,\n      env: options.env,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      shell: plan.shell,\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout?.on(\"data\", (chunk) => {\n      stdout += String(chunk);\n    });\n    child.stderr?.on(\"data\", (chunk) => {\n      stderr += String(chunk);\n    });\n\n    child.on(\"close\", (code) => {\n      resolve({ stdout, stderr, code: code ?? 1 });\n    });\n    child.on(\"error\", (error) => {\n      resolve({\n        stdout,\n        stderr: `${stderr}\\n${error.message}`.trim(),\n        code: 1,\n      });\n    });\n  });\n}\n\n/** 同步执行命令并继承当前终端的输入输出，非零退出码时抛错 */\nexport function runCommandInherit(\n  command: string,\n  args: string[],\n  options: { cwd?: string } = {},\n): void {\n  const plan = buildSpawnPlan(command, args);\n  const result = spawnSync(plan.file, plan.args, {\n    cwd: options.cwd,\n    stdio: \"inherit\",\n    shell: plan.shell,\n  });\n\n  if (result.error) throw result.error;\n  if (result.status !== 0) {\n    throw new Error(`${command} 退出码 ${result.status}`);\n  }\n}\n\n/** 判断命令是否可用 */\nexport function commandExists(command: string): boolean {\n  return resolveCommand(command) !== null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"exec-BzdYBQLQ.cjs","names":["path","candidate: string","command: string","resolved: string | null","resolved: string","args: string[]","options: { cwd?: string; env?: NodeJS.ProcessEnv }","options: { cwd?: string }"],"sources":["../package.json","../src/internal/exec.ts"],"sourcesContent":["{\n  \"name\": \"mioku\",\n  \"type\": \"module\",\n  \"version\": \"1.0.8\",\n  \"packageManager\": \"bun@1.2.0\",\n  \"description\": \"Mioku - A plugin-based QQ bot framework\",\n  \"keywords\": [\n    \"onebot\",\n    \"framework\",\n    \"bot\",\n    \"mioku\"\n  ],\n  \"bin\": {\n    \"mioku\": \"./dist/cli/index.js\"\n  },\n  \"engines\": {\n    \"node\": \">= 22.18.0\"\n  },\n  \"homepage\": \"https://github.com/mioku-lab/mioku#readme\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"bugs\": {\n    \"url\": \"https://github.com/mioku-lab/mioku/issues\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/mioku-lab/mioku.git\",\n    \"directory\": \"packages/mioku\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsdown -w\",\n    \"build\": \"tsdown\",\n    \"typecheck\": \"tsc --noEmit\"\n  },\n  \"exports\": {\n    \".\": {\n      \"require\": \"./dist/index.cjs\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"author\": \"Jerryplusy <jerryplusy@outlook.com>\",\n  \"license\": \"MIT\",\n  \"dependencies\": {\n    \"napcat-sdk\": \"^0.16.0\",\n    \"consola\": \"^3.4.2\",\n    \"dayjs\": \"^1.11.19\",\n    \"dedent\": \"^1.7.1\",\n    \"filesize\": \"^11.0.13\",\n    \"inquirer\": \"^10.0.0\",\n    \"jiti\": \"^2.6.1\",\n    \"lowdb\": \"^7.0.1\",\n    \"mri\": \"^1.2.0\",\n    \"node-cron\": \"^4.2.1\",\n    \"pretty-ms\": \"^9.3.0\",\n    \"string2argv\": \"^1.0.2\",\n    \"lodash\": \"^4.17.21\"\n  },\n  \"devDependencies\": {\n    \"@types/lodash\": \"^4.17.0\",\n    \"@types/node\": \"^22.0.0\",\n    \"tsdown\": \"^0.11.0\",\n    \"typescript\": \"^5.8.0\"\n  }\n}\n","import { spawn, spawnSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\n\nconst isWindows = process.platform === \"win32\";\n\nconst resolveCache = new Map<string, string | null>();\n\nfunction windowsExtensions(): string[] {\n  const raw = process.env.PATHEXT || \".COM;.EXE;.BAT;.CMD\";\n  return raw\n    .split(\";\")\n    .map((ext) => ext.trim())\n    .filter(Boolean);\n}\n\n// PATH is a snapshot taken at process start, so a package manager installed\n// mid-run won't be on it. We enumerate every plausible install prefix for\n// bun / npm / scoop / chocolatey so the CLI can find bun in one shot.\nfunction searchDirs(): string[] {\n  const raw = process.env.PATH || process.env.Path || \"\";\n  const dirs = raw\n    .split(path.delimiter)\n    .map((d) => d.trim())\n    .filter(Boolean);\n  const home = os.homedir();\n  const appData = process.env.APPDATA || path.join(home, \"AppData\", \"Roaming\");\n  const localAppData =\n    process.env.LOCALAPPDATA || path.join(home, \"AppData\", \"Local\");\n  const programFiles = process.env.ProgramFiles || \"C:\\\\Program Files\";\n  const programFilesX86 =\n    process.env[\"ProgramFiles(x86)\"] || \"C:\\\\Program Files (x86)\";\n\n  const extra = isWindows\n    ? [\n        // 官方安装器\n        path.join(home, \".bun\", \"bin\"),\n        // npm 全局（带 .cmd shim）\n        path.join(appData, \"npm\"),\n        path.join(appData, \"npm\", \"node_modules\", \".bin\"),\n        // 备用 bun 位置\n        path.join(localAppData, \"bun\", \"bin\"),\n        path.join(programFiles, \"bun\", \"bin\"),\n        path.join(programFilesX86, \"bun\", \"bin\"),\n        // scoop\n        path.join(home, \"scoop\", \"shims\"),\n        // chocolatey\n        \"C:\\\\ProgramData\\\\chocolatey\\\\bin\",\n        // node 自带（很多用户 npm i -g 装到 node 目录）\n        path.join(programFiles, \"nodejs\"),\n        path.join(programFilesX86, \"nodejs\"),\n      ]\n    : [\n        path.join(home, \".bun\", \"bin\"),\n        \"/usr/local/bin\",\n        \"/opt/homebrew/bin\",\n        path.join(home, \".npm-global\", \"bin\"),\n      ];\n\n  return [...dirs, ...extra.filter((dir) => dir && !dir.endsWith(path.sep))];\n}\n\nfunction isExecutableFile(candidate: string): boolean {\n  try {\n    return fs.statSync(candidate).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction searchCommandViaShell(command: string): string | null {\n  if (command.includes(\"/\") || command.includes(path.sep)) return null;\n  const shellCmd = isWindows ? \"where\" : \"which\";\n  try {\n    const result = spawnSync(shellCmd, [command], {\n      encoding: \"utf-8\",\n      windowsHide: true,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      timeout: 5000,\n    });\n    if (result.status === 0 && result.stdout) {\n      const first = result.stdout\n        .split(/\\r?\\n/)\n        .map((s) => s.trim())\n        .find(Boolean);\n      if (first && isExecutableFile(first)) return first;\n    }\n  } catch {}\n  return null;\n}\n\n/** 在 PATH 及常见安装目录中解析命令的完整路径，结果带缓存 */\nexport function resolveCommand(command: string): string | null {\n  if (resolveCache.has(command)) return resolveCache.get(command) ?? null;\n\n  let resolved: string | null = null;\n\n  if (command.includes(\"/\") || command.includes(path.sep)) {\n    resolved = isExecutableFile(command) ? path.resolve(command) : null;\n  } else {\n    const exts = isWindows ? windowsExtensions() : [\"\"];\n    const hasKnownExt =\n      isWindows &&\n      exts.some((ext) => command.toLowerCase().endsWith(ext.toLowerCase()));\n\n    outer: for (const dir of searchDirs()) {\n      if (hasKnownExt) {\n        const direct = path.join(dir, command);\n        if (isExecutableFile(direct)) {\n          resolved = direct;\n          break;\n        }\n        continue;\n      }\n      for (const ext of exts) {\n        const candidate = path.join(dir, command + ext);\n        if (isExecutableFile(candidate)) {\n          resolved = candidate;\n          break outer;\n        }\n      }\n    }\n\n    if (!resolved) resolved = searchCommandViaShell(command);\n  }\n\n  resolveCache.set(command, resolved);\n  return resolved;\n}\n\nexport function clearCommandCache(): void {\n  resolveCache.clear();\n}\n\nfunction needsCmdShell(resolved: string): boolean {\n  if (!isWindows) return false;\n  const ext = path.extname(resolved).toLowerCase();\n  return ext === \".cmd\" || ext === \".bat\";\n}\n\nexport interface SpawnPlan {\n  file: string;\n  args: string[];\n  windowsVerbatimArguments?: boolean;\n  shell?: boolean | string;\n}\n\n// Windows can't CreateProcess a .cmd/.bat shim directly (npm installs bun as\n// bun.cmd), so those get routed through cmd.exe via shell: true. Previously\n// we hand-rolled a cmd.exe invocation with windowsVerbatimArguments: true,\n// but that combination misbehaves with spawnSync + stdio:\"inherit\" on\n// Node.js >= 20 (manifests as the spawned process printing \"undefined\" or\n// a spurious EINVAL), so we let Node's shell wrapper do the quoting.\n/** 生成跨平台的 spawn 参数，Windows 下 .cmd/.bat 会改经 cmd.exe 执行 */\nexport function buildSpawnPlan(command: string, args: string[]): SpawnPlan {\n  const resolved = resolveCommand(command);\n\n  if (!resolved) {\n    return { file: command, args };\n  }\n\n  if (!needsCmdShell(resolved)) {\n    return { file: resolved, args };\n  }\n\n  return {\n    file: resolved,\n    args,\n    shell: true,\n  };\n}\n\nexport interface RunCommandResult {\n  stdout: string;\n  stderr: string;\n  code: number;\n}\n\n/** 执行命令并收集 stdout/stderr 与退出码，失败不抛异常 */\nexport function runCommand(\n  command: string,\n  args: string[],\n  options: { cwd?: string; env?: NodeJS.ProcessEnv } = {},\n): Promise<RunCommandResult> {\n  const plan = buildSpawnPlan(command, args);\n\n  return new Promise((resolve) => {\n    const child = spawn(plan.file, plan.args, {\n      cwd: options.cwd,\n      env: options.env,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      shell: plan.shell,\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout?.on(\"data\", (chunk) => {\n      stdout += String(chunk);\n    });\n    child.stderr?.on(\"data\", (chunk) => {\n      stderr += String(chunk);\n    });\n\n    child.on(\"close\", (code) => {\n      resolve({ stdout, stderr, code: code ?? 1 });\n    });\n    child.on(\"error\", (error) => {\n      resolve({\n        stdout,\n        stderr: `${stderr}\\n${error.message}`.trim(),\n        code: 1,\n      });\n    });\n  });\n}\n\n/** 同步执行命令并继承当前终端的输入输出，非零退出码时抛错 */\nexport function runCommandInherit(\n  command: string,\n  args: string[],\n  options: { cwd?: string } = {},\n): void {\n  const plan = buildSpawnPlan(command, args);\n  const result = spawnSync(plan.file, plan.args, {\n    cwd: options.cwd,\n    stdio: \"inherit\",\n    shell: plan.shell,\n  });\n\n  if (result.error) throw result.error;\n  if (result.status !== 0) {\n    throw new Error(`${command} 退出码 ${result.status}`);\n  }\n}\n\n/** 判断命令是否可用 */\nexport function commandExists(command: string): boolean {\n  return resolveCommand(command) !== null;\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_exec = require('./exec-O8rCedzr.cjs');
+const require_exec = require('./exec-BzdYBQLQ.cjs');
 const node_fs = require_exec.__toESM(require("node:fs"));
 const node_path = require_exec.__toESM(require("node:path"));
 const node_url = require_exec.__toESM(require("node:url"));
@@ -855,6 +855,7 @@ var AdapterContextImpl = class {
 	#capabilities;
 	#logger;
 	#emit;
+	#correlator;
 	#pendingStarts = new Set();
 	constructor(options) {
 		this.#state = options.state;
@@ -864,6 +865,7 @@ var AdapterContextImpl = class {
 		this.#capabilities = options.capabilities;
 		this.#logger = options.logger;
 		this.#emit = options.emit;
+		this.#correlator = options.correlator;
 	}
 	registerBot(bot) {
 		return this.#bots.register(bot);
@@ -927,6 +929,7 @@ var AdapterContextImpl = class {
 		};
 	}
 	async dispatch(event) {
+		this.#correlator?.observe(event);
 		if (event.kind === "message") {
 			const senderId = event.user_id;
 			if (senderId != null) {
@@ -1015,6 +1018,9 @@ var BotRegistry = class {
 		for (const entry of this.#bots.values()) if (entry.bot_id === key) return entry.bot;
 		return void 0;
 	}
+	find(adapter, bot_id) {
+		return this.#bots.get(connectedBotKey(adapter, bot_id))?.bot;
+	}
 	all() {
 		return Array.from(this.#bots.values()).map((entry) => entry.bot);
 	}
@@ -1888,104 +1894,6 @@ const Services = {
 	Help: defineService("help")
 };
 
-//#endregion
-//#region src/runtime/cross-adapter-dedup.ts
-const PRUNE_INTERVAL = 128;
-const MESSAGE_TTL_MS = 15e3;
-const EVENT_TTL_MS = 6e4;
-const MAX_SIZE = 4096;
-const MAX_SEGMENTS = 16;
-const MAX_TEXT = 256;
-const contentFingerprintOf = (event) => {
-	const parts = [];
-	for (const seg of event.message) {
-		if (parts.length >= MAX_SEGMENTS) break;
-		if (seg.type === "reply") continue;
-		const data = seg.data ?? {};
-		if (seg.type === "text") {
-			const text$1 = typeof data.text === "string" ? data.text : "";
-			parts.push(`t:${text$1.slice(0, MAX_TEXT)}`);
-		} else if (seg.type === "at") {
-			const target = data.qq ?? data.target;
-			parts.push(`a:${target == null ? "" : String(target)}`);
-		} else if (seg.type === "face") parts.push("f");
-		else parts.push(seg.type);
-	}
-	return parts.join("|");
-};
-const scopeKeyOf = (event, content) => [
-	event.message_type ?? "",
-	event.sender?.nickname?.trim() || event.user_id || "",
-	content
-].join("|");
-const noticeKeyOf = (event) => [
-	event.kind,
-	event.identity.event_type,
-	event.notice_type ?? "",
-	event.sub_type ?? "",
-	event.group_id ?? "",
-	event.user_id ?? "",
-	event.operator_id ?? "",
-	event.identity.fingerprint ?? "",
-	event.identity.timestamp == null ? "" : Math.floor(event.identity.timestamp / 1e3)
-].join("|");
-const requestKeyOf = (event) => [
-	event.kind,
-	event.identity.event_type,
-	event.request_type ?? "",
-	event.sub_type ?? "",
-	event.group_id ?? "",
-	event.user_id ?? "",
-	event.comment ?? "",
-	event.identity.fingerprint ?? "",
-	event.identity.timestamp == null ? "" : Math.floor(event.identity.timestamp / 1e3)
-].join("|");
-/**
-* 跨适配器消息去重（L2）
-*/
-var CrossAdapterEventDeduplicator = class {
-	#entries = new Map();
-	#inserts = 0;
-	#dropped = 0;
-	/** 本次运行以来被丢弃的跨适配器重复消息数 */
-	get dropped() {
-		return this.#dropped;
-	}
-	isDuplicate(event) {
-		let key;
-		let ttl;
-		if (event.kind === "message") {
-			key = scopeKeyOf(event, contentFingerprintOf(event));
-			ttl = MESSAGE_TTL_MS;
-		} else if (event.kind === "notice") {
-			key = noticeKeyOf(event);
-			ttl = EVENT_TTL_MS;
-		} else if (event.kind === "request") {
-			key = requestKeyOf(event);
-			ttl = EVENT_TTL_MS;
-		} else return false;
-		const now = Date.now();
-		const existing = this.#entries.get(key);
-		if (existing?.expiresAt != null && existing.expiresAt >= now) {
-			this.#dropped++;
-			return true;
-		}
-		this.#entries.set(key, { expiresAt: now + ttl });
-		this.#inserts++;
-		if (this.#inserts >= PRUNE_INTERVAL || this.#entries.size > MAX_SIZE) {
-			this.#inserts = 0;
-			this.#prune(now);
-		}
-		return false;
-	}
-	#prune(now) {
-		for (const [key, entry] of this.#entries) if (entry.expiresAt < now) this.#entries.delete(key);
-	}
-	clear() {
-		this.#entries.clear();
-	}
-};
-
 //#endregion
 //#region src/runtime/mioku-context.ts
 const isObject$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
@@ -2083,6 +1991,59 @@ var MiokuContext = class {
 		return this.#options.bots.pick(bot_id);
 	}
 	/**
+	* 取事件所属的跨适配器关联记录。
+	* 同一条逻辑消息被多个适配器/bot 投递时，可从这里读到全部参与方。
+	*/
+	correlation(event) {
+		return this.#options.correlator?.observationOf(event)?.record;
+	}
+	/**
+	* 观察到该事件的全部已连接 bot（首个即 primary）。
+	* 跨适配器去重后，被标记为重复的投递不会进入普通 handler，
+	* 但这里依然能看到全部参与方。
+	*/
+	botsForEvent(event) {
+		const record = this.correlation(event);
+		if (!record) {
+			const bot = event.bot;
+			return bot ? [bot] : [];
+		}
+		const resolved = [];
+		for (const participant of record.participants) {
+			const bot = participant.botId ? this.#options.bots.find(participant.adapter, participant.botId) ?? this.#options.bots.pick(participant.botId) : void 0;
+			if (bot && !resolved.includes(bot)) resolved.push(bot);
+		}
+		return resolved;
+	}
+	/** 事件里被 @ 到的、且本运行时已连接的 bot */
+	mentionedBots(event) {
+		if (event.kind !== "message") return [];
+		const targets = new Set();
+		for (const segment$1 of event.message) {
+			if (segment$1.type !== "at") continue;
+			const data = segment$1.data ?? {};
+			const target = data.qq ?? data.target;
+			if (target != null && String(target) !== "") targets.add(String(target));
+		}
+		if (targets.size === 0) return [];
+		return this.#options.bots.all().filter((bot) => targets.has(String(bot.bot_id)));
+	}
+	/**
+	* 这条消息应当由哪个 bot 回应：优先「被 @ 的 bot」，其次是关联组里首个到达的 bot。
+	* 插件可用它替代隐式的 `event.bot`，从而不受适配器到达顺序影响。
+	*/
+	pickReplyBot(event) {
+		const mentioned = this.mentionedBots(event);
+		if (mentioned.length > 0) return mentioned[0];
+		const participants = this.botsForEvent(event);
+		if (participants.length > 0) return participants[0];
+		return event.bot;
+	}
+	/** 事件关联/去重的运行统计 */
+	correlationStats() {
+		return this.#options.correlator?.stats();
+	}
+	/**
 	* 获取事件引用回复的消息内容。
 	* 返回 null 表示没有引用、拿不到对应 bot 或消息已失效。
 	*/
@@ -2115,10 +2076,10 @@ var MiokuContext = class {
 		const routes = inputRoutes.map((item) => item.startsWith("!") ? item.slice(1) : item);
 		const source = `plugin:${this.#options.pluginName}`;
 		const handledEvents = new WeakSet();
-		const dedup = bypassDedup || this.#options.dedup === false ? null : new CrossAdapterEventDeduplicator();
+		const correlator = bypassDedup ? void 0 : this.#options.correlator;
 		const wrappedHandler = async (event) => {
 			if (handledEvents.has(event)) return;
-			if (dedup?.isDuplicate(event)) return;
+			if (correlator?.isDuplicate(event)) return;
 			handledEvents.add(event);
 			await handler(event);
 		};
@@ -2259,6 +2220,286 @@ var MiokuContext = class {
 	}
 };
 
+//#endregion
+//#region src/runtime/event-correlator.ts
+const MESSAGE_TTL_MS = 15e3;
+const EVENT_TTL_MS = 6e4;
+const PRUNE_INTERVAL = 128;
+const MAX_SIZE = 4096;
+const MAX_SEGMENTS = 16;
+const MAX_TEXT = 256;
+const HEX32 = /[0-9a-f]{32}/i;
+const HEX40 = /[0-9a-f]{40}/i;
+const MEDIA_URL_QUERY_KEYS = [
+	"fileid",
+	"file_id",
+	"md5",
+	"fid"
+];
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const hashString = (input) => (0, node_crypto.createHash)("sha1").update(input).digest("hex").slice(0, 20);
+/** 稳定序列化：对象键排序、无多余空白，忽略跨适配器的排版差异 */
+const canonicalJson = (value) => {
+	if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
+	if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+	const obj = value;
+	return `{${Object.keys(obj).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(obj[key])}`).join(",")}}`;
+};
+/** 结构化载荷（json/xml/ark）的稳定摘要 */
+const structuredDigest = (raw) => {
+	let value = raw;
+	if (typeof raw === "string") {
+		const trimmed = raw.trim();
+		if (!trimmed) return "";
+		try {
+			value = JSON.parse(trimmed);
+		} catch {
+			return `s:${hashString(trimmed.slice(0, MAX_TEXT * 4))}`;
+		}
+	}
+	return `j:${hashString(canonicalJson(value))}`;
+};
+/** 去掉会过期/随会话变化的查询参数，保留跨适配器稳定的媒体定位 */
+const normalizeMediaUrl = (raw) => {
+	try {
+		const url = new URL(raw);
+		const kept = new URLSearchParams();
+		for (const key of MEDIA_URL_QUERY_KEYS) {
+			const value = url.searchParams.get(key);
+			if (value) kept.set(key, value);
+		}
+		const query = kept.toString();
+		return `${url.host}${url.pathname}${query ? `?${query}` : ""}`;
+	} catch {
+		return raw;
+	}
+};
+const firstHex = (value, pattern) => {
+	if (typeof value !== "string" || !value) return void 0;
+	const match$1 = value.match(pattern);
+	return match$1 ? match$1[0].toLowerCase() : void 0;
+};
+/**
+* 媒体段的内容摘要：优先内容哈希（md5/sha1），其次是文件名里嵌的 md5，
+* 再次是规范化 URL。都拿不到时返回空串，由调用方退化为「只看段类型」。
+*/
+const mediaDigest = (data) => {
+	const md5$1 = firstHex(data.md5, HEX32);
+	if (md5$1) return `h:${md5$1}`;
+	const sha1 = firstHex(data.sha1, HEX40);
+	if (sha1) return `h:${sha1}`;
+	for (const key of [
+		"file_unique",
+		"file_id",
+		"fid",
+		"id",
+		"file",
+		"name"
+	]) {
+		const hex = firstHex(data[key], HEX32);
+		if (hex) return `h:${hex}`;
+	}
+	const url = data.url;
+	if (typeof url === "string" && url) return `u:${normalizeMediaUrl(url)}`;
+	for (const key of [
+		"file",
+		"file_id",
+		"fid",
+		"id",
+		"name"
+	]) {
+		const value = data[key];
+		if (typeof value === "string" && value) return `r:${value.toLowerCase()}`;
+	}
+	return "";
+};
+/** 只在载荷跨协议一致时才使用摘要的段类型 */
+const DIGEST_MEDIA_TYPES = new Set(["image", "flash"]);
+const segmentSignature = (segment$1) => {
+	const data = isRecord(segment$1.data) ? segment$1.data : {};
+	switch (segment$1.type) {
+		case "text": {
+			const text$1 = typeof data.text === "string" ? data.text : "";
+			return `t:${text$1.slice(0, MAX_TEXT)}`;
+		}
+		case "at": {
+			const target = data.qq ?? data.target;
+			return `a:${target == null ? "" : String(target)}`;
+		}
+		case "face": {
+			const id = data.id ?? data.face;
+			return `f:${id == null ? "" : String(id)}`;
+		}
+		case "json":
+		case "xml":
+		case "ark": {
+			const digest = structuredDigest(data.data ?? data.content ?? data);
+			return digest ? `${segment$1.type}:${digest}` : segment$1.type;
+		}
+		default: {
+			if (DIGEST_MEDIA_TYPES.has(segment$1.type)) {
+				const digest = mediaDigest(data);
+				return digest ? `${segment$1.type}:${digest}` : segment$1.type;
+			}
+			return segment$1.type;
+		}
+	}
+};
+const contentSignatureOf = (event) => {
+	const parts = [];
+	for (const segment$1 of event.message) {
+		if (parts.length >= MAX_SEGMENTS) break;
+		if (segment$1.type === "reply") continue;
+		parts.push(segmentSignature(segment$1));
+	}
+	return parts.join("|");
+};
+const messageKeyOf = (event) => {
+	const type = event.message_type ?? "";
+	const scope = event.group_id ?? event.user_id ?? "";
+	const sender = event.user_id ?? event.sender?.user_id ?? "";
+	return [
+		"m",
+		type,
+		scope,
+		sender,
+		contentSignatureOf(event)
+	].join("|");
+};
+const noticeKeyOf = (event) => [
+	"n",
+	event.identity.event_type,
+	event.notice_type ?? "",
+	event.sub_type ?? "",
+	event.group_id ?? "",
+	event.user_id ?? "",
+	event.operator_id ?? "",
+	event.identity.timestamp == null ? "" : Math.floor(event.identity.timestamp / 1e3)
+].join("|");
+const requestKeyOf = (event) => [
+	"r",
+	event.identity.event_type,
+	event.request_type ?? "",
+	event.sub_type ?? "",
+	event.group_id ?? "",
+	event.user_id ?? "",
+	event.comment ?? "",
+	event.identity.timestamp == null ? "" : Math.floor(event.identity.timestamp / 1e3)
+].join("|");
+const participantOf = (event) => ({
+	adapter: event.identity.adapter,
+	botId: event.identity.bot_id,
+	eventType: event.identity.event_type,
+	messageId: event.identity.message_id ?? event.identity.native_event_id
+});
+const sameParticipant = (a, b) => a.adapter === b.adapter && (a.botId ?? "") === (b.botId ?? "") && (a.messageId ?? "") === (b.messageId ?? "");
+/**
+* 跨适配器事件关联器
+*/
+var EventCorrelator = class {
+	#groups = new Map();
+	#byEvent = new WeakMap();
+	#logger;
+	#maxSize;
+	#inserts = 0;
+	#observed = 0;
+	#duplicates = 0;
+	#evicted = 0;
+	constructor(options = {}) {
+		this.#logger = options.logger;
+		this.#maxSize = options.maxSize ?? MAX_SIZE;
+	}
+	/** 观察一个事件，登记它所属的关联组并返回其定位（同一事件只登记一次） */
+	observe(event) {
+		const cached = this.#byEvent.get(event);
+		if (cached) return cached;
+		const located = this.#locate(event);
+		if (!located) return null;
+		const { key, ttl } = located;
+		const now = Date.now();
+		this.#observed++;
+		let group = this.#groups.get(key);
+		let duplicate = false;
+		if (group && group.expiresAt >= now) {
+			duplicate = true;
+			this.#duplicates++;
+			const participant = participantOf(event);
+			if (!group.participants.some((item) => sameParticipant(item, participant))) group.participants.push(participant);
+			this.#logger?.debug(`去重命中: key=${key} adapter=${participant.adapter} bot=${participant.botId ?? ""} primary=${group.primary.adapter}:${group.primary.botId ?? ""}`);
+		} else {
+			const participant = participantOf(event);
+			group = {
+				key,
+				expiresAt: now + ttl,
+				firstSeenAt: now,
+				primary: participant,
+				participants: [participant]
+			};
+			this.#groups.set(key, group);
+			this.#inserts++;
+			if (this.#inserts >= PRUNE_INTERVAL || this.#groups.size > this.#maxSize) {
+				this.#inserts = 0;
+				this.#prune(now);
+			}
+		}
+		const observation = {
+			record: group,
+			primary: !duplicate,
+			duplicate
+		};
+		this.#byEvent.set(event, observation);
+		return observation;
+	}
+	/** 读取某事件此前登记的关联定位（未登记或已过期时返回 undefined） */
+	observationOf(event) {
+		const observation = this.#byEvent.get(event);
+		if (!observation) return void 0;
+		if (observation.record.expiresAt < Date.now()) return void 0;
+		return observation;
+	}
+	/** 该事件是否属于关联组里后续到达的重复投递（未登记时会先登记） */
+	isDuplicate(event) {
+		return this.observe(event)?.duplicate === true;
+	}
+	stats() {
+		return {
+			groups: this.#groups.size,
+			observed: this.#observed,
+			duplicates: this.#duplicates,
+			evicted: this.#evicted
+		};
+	}
+	clear() {
+		this.#groups.clear();
+	}
+	#locate(event) {
+		if (event.kind === "message") return {
+			key: messageKeyOf(event),
+			ttl: MESSAGE_TTL_MS
+		};
+		if (event.kind === "notice") return {
+			key: noticeKeyOf(event),
+			ttl: EVENT_TTL_MS
+		};
+		if (event.kind === "request") return {
+			key: requestKeyOf(event),
+			ttl: EVENT_TTL_MS
+		};
+		return null;
+	}
+	#prune(now) {
+		for (const [key, group] of this.#groups) if (group.expiresAt < now) this.#groups.delete(key);
+		if (this.#groups.size <= this.#maxSize) return;
+		const drop = this.#groups.size - this.#maxSize;
+		let dropped = 0;
+		for (const key of this.#groups.keys()) {
+			this.#groups.delete(key);
+			this.#evicted++;
+			if (++dropped >= drop) break;
+		}
+	}
+};
+
 //#endregion
 //#region src/runtime/plugin-metadata.ts
 const store$1 = getOrCreate("plugin-metadata", () => new Map());
@@ -4843,7 +5084,7 @@ var MiokuRuntime = class {
 	#enabledPlugins = new Map();
 	#driverFactory;
 	#builtinPlugins;
-	#dedupEnabled;
+	#correlator;
 	#started = false;
 	#stopped = false;
 	constructor(options) {
@@ -4851,7 +5092,7 @@ var MiokuRuntime = class {
 		this.#logger = options.logger;
 		this.#driverFactory = options.driverFactory ?? (() => createDefaultDriver());
 		this.#builtinPlugins = options.builtinPlugins ?? BUILTIN_PLUGINS$1;
-		this.#dedupEnabled = options.dedup?.crossAdapter !== false;
+		this.#correlator = options.dedup?.crossAdapter === false ? void 0 : new EventCorrelator({ logger: this.#logger.child({ scope: "dedup" }) });
 		this.#driver = this.#driverFactory();
 		this.#bus = new EventBus();
 		this.#bus.setLogger((level, message, detail) => {
@@ -4874,6 +5115,10 @@ var MiokuRuntime = class {
 	get bus() {
 		return this.#bus;
 	}
+	/** 事件关联器（跨适配器去重）；为 undefined 时表示已禁用 */
+	get correlator() {
+		return this.#correlator;
+	}
 	get bots() {
 		return this.#bots.all();
 	}
@@ -4981,7 +5226,8 @@ var MiokuRuntime = class {
 			driver: this.#driver,
 			capabilities: this.#capabilities,
 			logger: this.#logger.child({ adapter: state.definition.name }),
-			emit: (event) => this.#emitLifecycle(event)
+			emit: (event) => this.#emitLifecycle(event),
+			correlator: this.#correlator
 		});
 	}
 	async #loadPlugin(plugin, type) {
@@ -4995,7 +5241,7 @@ var MiokuRuntime = class {
 			config: botConfig,
 			logger: this.#logger.child({ plugin: plugin.name }),
 			priority: plugin.priority ?? 100,
-			dedup: this.#dedupEnabled,
+			correlator: this.#correlator,
 			getAdapter: (name) => this.getAdapter(name),
 			listAdapters: () => this.adapters,
 			onUpdateConfig: async (updater) => {
@@ -5284,6 +5530,7 @@ var MiokuRuntime = class {
 		this.#enabledPlugins.clear();
 		this.#capabilities.clear();
 		this.#bots.clear();
+		this.#correlator?.clear();
 		resetPluginMetadata();
 		try {
 			await this.#driver.shutdown();
@@ -5446,6 +5693,7 @@ async function start(options = {}) {
 	};
 	process.on("SIGINT", () => void shutdown("SIGINT"));
 	process.on("SIGTERM", () => void shutdown("SIGTERM"));
+	installProcessErrorGuards();
 	return { stop: (reason) => stopRuntime(reason) };
 }
 function readVersion() {
@@ -5458,6 +5706,15 @@ function readVersion() {
 	}
 }
 const version$1 = readVersion();
+function installProcessErrorGuards() {
+	if (process.listenerCount("unhandledRejection") === 0) process.on("unhandledRejection", (reason) => {
+		const detail = reason instanceof Error ? reason.stack ?? reason.message : reason;
+		rootLogger.error(`[unhandledRejection] ${String(detail)}`);
+	});
+	if (process.listenerCount("uncaughtException") === 0) process.on("uncaughtException", (err) => {
+		rootLogger.error(`[uncaughtException] ${err.stack ?? err.message ?? String(err)}`);
+	});
+}
 
 //#endregion
 exports.AI_GEMINI_THINKING_LEVELS = AI_GEMINI_THINKING_LEVELS;
@@ -5473,6 +5730,7 @@ exports.CapabilityRegistry = CapabilityRegistry;
 exports.ChromeUA = ChromeUA;
 exports.DriverShutdownError = DriverShutdownError;
 exports.EventBus = EventBus;
+exports.EventCorrelator = EventCorrelator;
 exports.HttpRequestError = HttpRequestError;
 exports.MessageSegmentImpl = MessageSegmentImpl;
 exports.MiokuContext = MiokuContext;