mioku 1.0.11 → 1.1.0

package/dist/cli/index.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_exec = require('../exec-nby5LOiI.cjs');
+const require_exec = require('../exec-DcNz1txh.cjs');
 const node_fs = require_exec.__toESM(require("node:fs"));
 const node_path = require_exec.__toESM(require("node:path"));
 const mri = require_exec.__toESM(require("mri"));

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { clearCommandCache, commandExists, resolveCommand, runCommandInherit, version } from "../exec-CqUKSOV5.js";
+import { clearCommandCache, commandExists, resolveCommand, runCommandInherit, version } from "../exec-B5iAOUft.js";
 import fs, { readFileSync } from "node:fs";
 import path from "node:path";
 import mri from "mri";

package/dist/{exec-CqUKSOV5.js → exec-B5iAOUft.js}

@@ -4,7 +4,7 @@ import * as os$1 from "node:os";
 import { spawn, spawnSync } from "node:child_process";
 
 //#region package.json
-var version = "1.0.11";
+var version = "1.1.0";
 
 //#endregion
 //#region src/internal/exec.ts
@@ -180,4 +180,4 @@ function commandExists(command) {
 
 //#endregion
 export { buildSpawnPlan, clearCommandCache, commandExists, resolveCommand, runCommand, runCommandInherit, version };
-//# sourceMappingURL=exec-CqUKSOV5.js.map
+//# sourceMappingURL=exec-B5iAOUft.js.map

package/dist/exec-B5iAOUft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-B5iAOUft.js","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.1.0\",\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/{exec-nby5LOiI.cjs → exec-DcNz1txh.cjs}

@@ -27,7 +27,7 @@ const node_os = __toESM(require("node:os"));
 const node_child_process = __toESM(require("node:child_process"));
 
 //#region package.json
-var version = "1.0.11";
+var version = "1.1.0";
 
 //#endregion
 //#region src/internal/exec.ts
@@ -250,4 +250,4 @@ Object.defineProperty(exports, 'version', {
     return version;
   }
 });
-//# sourceMappingURL=exec-nby5LOiI.cjs.map
+//# sourceMappingURL=exec-DcNz1txh.cjs.map

package/dist/{exec-CqUKSOV5.js.map → exec-DcNz1txh.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"exec-CqUKSOV5.js","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.11\",\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-DcNz1txh.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.1.0\",\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-nby5LOiI.cjs');
+const require_exec = require('./exec-DcNz1txh.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"));
@@ -2685,6 +2685,16 @@ var CommandManager = class {
 	setAccessControl(config) {
 		this.#access = config;
 	}
+	canUsePlugin(plugin, event) {
+		return this.#pluginAllowed(plugin, event);
+	}
+	canUseCommand(plugin, command, event) {
+		const registered = this.#resolveRegistered(plugin, command);
+		if (registered) return this.#canUse(registered, event);
+		const key = commandKey$1(command);
+		const action = this.#resolveAction(plugin, key, event) ?? this.#resolveAction(plugin, command, event);
+		return action !== "block";
+	}
 	syncMetadata(metadata) {
 		this.#legacy.set(metadata.name, { metadata });
 	}
@@ -2718,6 +2728,7 @@ var CommandManager = class {
 				seen.add(key);
 				commands.push({
 					cmd,
+					id: runtimeCommand.id,
 					desc: runtimeCommand.description || command.desc || cmd,
 					usage: runtimeCommand.usage ?? command.usage,
 					role: runtimeCommand.permission
@@ -2733,6 +2744,7 @@ var CommandManager = class {
 			seen.add(commandKey$1(cmd));
 			commands.push({
 				cmd,
+				id: command.id,
 				desc: command.description || cmd,
 				usage: command.usage,
 				role: command.permission
@@ -2871,6 +2883,13 @@ var CommandManager = class {
 		}
 		return void 0;
 	}
+	#resolveRegistered(plugin, ref) {
+		const raw = String(ref ?? "").trim();
+		if (!raw) return void 0;
+		const key = commandKey$1(raw);
+		const candidates = this.#commands.filter((item) => item.plugin === plugin);
+		return candidates.find((item) => item.id === raw) ?? candidates.find((item) => item.name === raw) ?? candidates.find((item) => item.aliases.includes(raw)) ?? candidates.find((item) => commandKey$1(item.id) === key) ?? candidates.find((item) => commandKey$1(item.name) === key) ?? candidates.find((item) => item.aliases.some((alias) => commandKey$1(alias) === key));
+	}
 	#canUse(command, event) {
 		const userId = userIdOf(event);
 		const master = Boolean(userId && this.#isMaster(userId));
@@ -2962,6 +2981,45 @@ const resetPluginMetadata = () => {
 	getActiveCommandManager()?.clear();
 };
 
+//#endregion
+//#region src/runtime/plugin-artifacts.ts
+const commandKey = (value) => String(value).trim().replace(/^[#/.]+\s*/, "").split(/\s+/)[0].toLowerCase();
+async function registerPluginArtifacts(ctx) {
+	const helpService = ctx ? getService(ctx, Services.Help) : servicesRegistry["help"];
+	const plugins = getPluginMetadataList();
+	const commandManager = getActiveCommandManager();
+	const metadataByName = new Map(plugins.map((meta) => [meta.name, meta]));
+	const pluginNames = new Set([...metadataByName.keys(), ...(commandManager?.catalog() ?? []).filter((item) => item.kind === "plugin").map((item) => item.plugin)]);
+	if (helpService) {
+		for (const name of [...helpService.getAllHelp().keys()]) if (!pluginNames.has(name)) helpService.unregisterHelp(name);
+	}
+	let helpCount = 0;
+	for (const pluginName of pluginNames) {
+		const meta = metadataByName.get(pluginName);
+		const generated = commandManager?.getPluginHelp(pluginName) ?? meta?.config?.help;
+		const existing = helpService?.getHelp(pluginName);
+		const help = generated ? {
+			...generated,
+			title: existing?.title || generated.title,
+			description: existing?.description || generated.description,
+			commands: [...existing?.commands ?? [], ...generated.commands.filter((command) => {
+				const key = commandKey(command.cmd);
+				return !(existing?.commands ?? []).some((item) => commandKey(item.cmd) === key);
+			})]
+		} : existing;
+		if (help) if (helpService) {
+			helpService.registerHelp(pluginName, help);
+			helpCount++;
+		} else rootLogger.warn(`[plugin-artifacts] 帮助服务未加载，跳过插件 "${pluginName}" 的帮助注册`);
+		const required = meta?.config?.services;
+		if (required && required.length > 0) {
+			const missing = required.filter((name) => !servicesRegistry[name]);
+			if (missing.length > 0) rootLogger.warn(`插件 "${pluginName}" 声明依赖服务 [${missing.join(", ")}]，但它们未加载`);
+		}
+	}
+	rootLogger.info(`[plugin-artifacts] 已处理 ${pluginNames.size} 个插件，注册帮助 ${helpCount} 个`);
+}
+
 //#endregion
 //#region src/runtime/plugin-state.ts
 const store = getOrCreate("plugin-runtime-state", () => ({}));
@@ -5229,6 +5287,7 @@ const HELP_KEYS = new Set([
 ]);
 const HELP_COMMAND_KEYS = new Set([
 	"cmd",
+	"id",
 	"desc",
 	"usage",
 	"role"
@@ -5274,6 +5333,7 @@ function validateHelp(value, pluginName) {
 		}
 		commands.push({
 			cmd: cmdName,
+			id: typeof cmd.id === "string" && cmd.id.trim() ? cmd.id.trim() : void 0,
 			desc,
 			usage: typeof cmd.usage === "string" ? cmd.usage : void 0,
 			role: typeof cmd.role === "string" ? cmd.role : void 0
@@ -5685,6 +5745,7 @@ var MiokuRuntime = class {
 			const plugin = await loadLocalPlugin(jiti$1, name, local.absPath);
 			await this.#loadPlugin(plugin, "external");
 			setPluginMetadata(buildPluginMetadata(name, local.absPath, pkg));
+			await this.#refreshPluginArtifacts();
 			return;
 		}
 		const candidates = discoverPluginCandidates(this.#cwd, appPkg);
@@ -5693,6 +5754,7 @@ var MiokuRuntime = class {
 			const plugin = await loadNpmPlugin(jiti$1, candidate);
 			await this.#loadPlugin(plugin, "external");
 			setPluginMetadata(buildPluginMetadata(candidate.name, candidate.resolvedPath, candidate.packageJson));
+			await this.#refreshPluginArtifacts();
 			return;
 		}
 		throw new Error(`插件 ${name} 不存在`);
@@ -5710,6 +5772,7 @@ var MiokuRuntime = class {
 			this.#enabledPlugins.delete(key);
 			removePluginMetadata(name);
 		}
+		await this.#refreshPluginArtifacts();
 		this.#logger.info(`禁用插件 => ${name}`);
 	}
 	async reloadPlugin(name) {
@@ -5725,11 +5788,20 @@ var MiokuRuntime = class {
 			await this.#enabledPlugins.get(`builtin:${name}`)?.cleanup?.();
 			this.#enabledPlugins.delete(`builtin:${name}`);
 			await this.#loadPlugin(plugin, "builtin");
+			await this.#refreshPluginArtifacts();
 			return;
 		}
 		await this.disablePlugin(name);
 		await this.enablePlugin(name);
 	}
+	/** 插件增删后同步帮助注册表；失败只告警，不能影响插件本身 */
+	async #refreshPluginArtifacts() {
+		try {
+			await registerPluginArtifacts();
+		} catch (error) {
+			this.#logger.warn(`刷新插件帮助注册表失败: ${error}`);
+		}
+	}
 	async #emitLifecycle(event) {
 		const lifecycleEvent = {
 			kind: "adapter",
@@ -6080,42 +6152,6 @@ const createRuntime = (options) => {
 	return new MiokuRuntime(options);
 };
 
-//#endregion
-//#region src/runtime/plugin-artifacts.ts
-const commandKey = (value) => String(value).trim().replace(/^[#/.]+\s*/, "").split(/\s+/)[0].toLowerCase();
-async function registerPluginArtifacts(ctx) {
-	const helpService = ctx ? getService(ctx, Services.Help) : servicesRegistry["help"];
-	const plugins = getPluginMetadataList();
-	const commandManager = getActiveCommandManager();
-	const metadataByName = new Map(plugins.map((meta) => [meta.name, meta]));
-	const pluginNames = new Set([...metadataByName.keys(), ...(commandManager?.catalog() ?? []).filter((item) => item.kind === "plugin").map((item) => item.plugin)]);
-	let helpCount = 0;
-	for (const pluginName of pluginNames) {
-		const meta = metadataByName.get(pluginName);
-		const generated = commandManager?.getPluginHelp(pluginName) ?? meta?.config?.help;
-		const existing = helpService?.getHelp(pluginName);
-		const help = generated ? {
-			...generated,
-			title: existing?.title || generated.title,
-			description: existing?.description || generated.description,
-			commands: [...existing?.commands ?? [], ...generated.commands.filter((command) => {
-				const key = commandKey(command.cmd);
-				return !(existing?.commands ?? []).some((item) => commandKey(item.cmd) === key);
-			})]
-		} : existing;
-		if (help) if (helpService) {
-			helpService.registerHelp(pluginName, help);
-			helpCount++;
-		} else rootLogger.warn(`[plugin-artifacts] 帮助服务未加载，跳过插件 "${pluginName}" 的帮助注册`);
-		const required = meta?.config?.services;
-		if (required && required.length > 0) {
-			const missing = required.filter((name) => !servicesRegistry[name]);
-			if (missing.length > 0) rootLogger.warn(`插件 "${pluginName}" 声明依赖服务 [${missing.join(", ")}]，但它们未加载`);
-		}
-	}
-	rootLogger.info(`[plugin-artifacts] 已处理 ${pluginNames.size} 个插件，注册帮助 ${helpCount} 个`);
-}
-
 //#endregion
 //#region src/start.ts
 /** 启动 mioku 运行时：加载服务、拉起适配器与插件，返回用于优雅停机的 stop */