node-karin 1.12.2 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 更新日志
 
+## [1.13.0](https://github.com/KarinJS/Karin/compare/core-v1.12.2...core-v1.13.0) (2025-11-22)
+
+
+### ✨ Features
+
+* 使用@karinjs/log4js 增强开发体验 ([#577](https://github.com/KarinJS/Karin/issues/577)) ([4e4f998](https://github.com/KarinJS/Karin/commit/4e4f9980cb70e7267a41d63630e9841c74bab161))
+
+
+### 🐛 Bug Fixes
+
+* Prevent loading plugins with incompatible engine versions and add ignoreEngines option ([#571](https://github.com/KarinJS/Karin/issues/571)) ([33e3279](https://github.com/KarinJS/Karin/commit/33e3279a30908a4aad10cc9d1cba5cd16d17c382))
+* 增强ffmpeg鲁棒性 ([#574](https://github.com/KarinJS/Karin/issues/574)) ([972c901](https://github.com/KarinJS/Karin/commit/972c9013b13fac197a2e1eb19a7341a3a48b380c))
+
 ## [1.12.2](https://github.com/KarinJS/Karin/compare/core-v1.12.1...core-v1.12.2) (2025-10-20)
 
 

package/dist/index.d.ts

@@ -6964,6 +6964,12 @@ interface PkgData {
     version: string;
     /** 插件入口 */
     main: string;
+    /** 官方的 engines 字段 */
+    engines?: {
+        karin?: string;
+        ['node-karin']?: string;
+        [key: string]: any;
+    };
     karin?: {
         /** ts入口 */
         main?: string;
@@ -6981,17 +6987,18 @@ interface PkgData {
         files?: string[];
         /** 环境变量配置 */
         env?: PkgEnv[];
-        /** 引擎兼容性 官方的翻译。。。奇奇怪怪的 */
-        engines?: {
-            /**
-             * @description karin版本
-             * @example ^0.0.1
-             * @example >=0.0.1
-             * @example 0.0.1
-             * @example 0.0.x
-             */
-            karin?: string;
-        };
+        /**
+         * 引擎兼容性 官方的翻译。。。奇奇怪怪的
+         * @description 插件的引擎兼容性配置，用于指定插件在哪些karin版本下运行。
+         * @description karin版本
+         * @example ^0.0.1
+         * @example >=0.0.1
+         * @example 0.0.1
+         * @example 0.0.x
+         */
+        engines?: string;
+        /** 忽略引擎版本检查，强制加载插件（仅适用于karin.engines，不影响package.engines） */
+        ignoreEngines?: boolean;
     };
     [key: string]: any;
 }
@@ -9032,7 +9039,7 @@ declare const formatTime$1: (time: number, time2?: number) => string;
  * 传入一个函数 判断是否是类
  * @param fnc 函数
  */
-declare const isClass: (fnc: Function) => boolean;
+declare const isClass: (fnc: unknown) => fnc is Function;
 
 /**
  * @description 拆解错误对象 用于`JSON`序列化

package/dist/index.mjs

@@ -11247,13 +11247,24 @@ var init_ffmpeg = __esm({
     setTimeout(async () => {
       const env3 = await exec("ffmpeg -version", { booleanResult: true });
       if (!env3) {
-        const cfg = await Promise.resolve().then(() => (init_config(), config_exports));
-        const ffmpeg2 = cfg.ffmpegPath();
-        const ffprobe2 = cfg.ffprobePath();
-        const ffplay2 = cfg.ffplayPath();
-        ffmpegPath2 = ffmpeg2 ? `"${ffmpeg2}"` : ffmpegPath2;
-        ffprobePath2 = ffprobe2 ? `"${ffprobe2}"` : ffprobePath2;
-        ffplayPath2 = ffplay2 ? `"${ffplay2}"` : ffplayPath2;
+        try {
+          const name = "@karinjs/plugin-ffmpeg";
+          const plugin = await import(name);
+          const ffmpeg2 = plugin.default.ffmpegPath;
+          const ffprobe2 = plugin.default.ffprobePath;
+          const ffplay2 = plugin.default.ffplayPath;
+          ffmpegPath2 = ffmpeg2 ? `"${ffmpeg2}"` : ffmpegPath2;
+          ffprobePath2 = ffprobe2 ? `"${ffprobe2}"` : ffprobePath2;
+          ffplayPath2 = ffplay2 ? `"${ffplay2}"` : ffplayPath2;
+        } catch {
+          const cfg = await Promise.resolve().then(() => (init_config(), config_exports));
+          const ffmpeg2 = cfg.ffmpegPath();
+          const ffprobe2 = cfg.ffprobePath();
+          const ffplay2 = cfg.ffplayPath();
+          ffmpegPath2 = ffmpeg2 ? `"${ffmpeg2}"` : ffmpegPath2;
+          ffprobePath2 = ffprobe2 ? `"${ffprobe2}"` : ffprobePath2;
+          ffplayPath2 = ffplay2 ? `"${ffplay2}"` : ffplayPath2;
+        }
       }
     }, 1e3);
     ffmpeg = async (cmd, options) => {
@@ -12713,6 +12724,101 @@ var init_system2 = __esm({
     init_range();
   }
 });
+
+// src/plugin/system/versionCheck.ts
+var cmpVer, normalizeCore, nextPatchIfGreater, calcLowerBoundSingle, calcLowerBoundBySatisfies, createPluginMismatchReporter;
+var init_versionCheck = __esm({
+  "src/plugin/system/versionCheck.ts"() {
+    init_system2();
+    cmpVer = (a, b) => {
+      const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+      const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+      if (pa[0] !== pb[0]) return pa[0] - pb[0];
+      if (pa[1] !== pb[1]) return pa[1] - pb[1];
+      return pa[2] - pb[2];
+    };
+    normalizeCore = (v) => {
+      const core = v.replace(/[xX*]/g, "0");
+      const m = core.match(/\d+\.\d+\.\d+/);
+      return m ? m[0] : null;
+    };
+    nextPatchIfGreater = (op, core) => {
+      if (op !== ">") return core;
+      const [maj, min, pat] = core.split(".").map((n) => parseInt(n, 10) || 0);
+      return `${maj}.${min}.${pat + 1}`;
+    };
+    calcLowerBoundSingle = (range3) => {
+      const tokens = range3.split(/\s+/).map((t) => t.trim()).filter((t) => t && t !== "&&");
+      const candidates = [];
+      for (const tk of tokens) {
+        const m = tk.match(/^(\^|>=|>|~)?(.+)$/);
+        const op = m?.[1] || "";
+        const ver = (m?.[2] || tk).trim();
+        const core = normalizeCore(ver);
+        if (!core) continue;
+        const candidate = op === ">" ? nextPatchIfGreater(op, core) : core;
+        candidates.push(candidate);
+      }
+      let lower = null;
+      for (const v of candidates) {
+        if (!satisfies(range3, v)) continue;
+        if (!lower || cmpVer(v, lower) < 0) {
+          lower = v;
+        }
+      }
+      return lower;
+    };
+    calcLowerBoundBySatisfies = (range3) => {
+      const parts = range3.split("||").map((s) => s.trim()).filter(Boolean);
+      if (parts.length <= 1) return calcLowerBoundSingle(range3);
+      let best = null;
+      for (const part of parts) {
+        const lb = calcLowerBoundSingle(part);
+        if (lb && (!best || cmpVer(lb, best) < 0)) {
+          best = lb;
+        }
+      }
+      return best;
+    };
+    createPluginMismatchReporter = () => {
+      const items = [];
+      let maxRequired = null;
+      const add = (name, engines) => {
+        items.push({ name, engines });
+        const lower = calcLowerBoundBySatisfies(engines);
+        if (lower) {
+          if (!maxRequired || cmpVer(lower, maxRequired) > 0) {
+            maxRequired = lower;
+          }
+        }
+      };
+      const flush = async (shouldPrint = true, currentVersion) => {
+        if (!items.length || !shouldPrint) return;
+        const lines = [];
+        lines.push(logger.yellow("\u26A0 \u4EE5\u4E0B\u63D2\u4EF6\u7248\u672C\u4E0D\u5339\u914D\u5F53\u524D Karin \u7248\u672C:"));
+        lines.push("");
+        for (const it of items) {
+          lines.push(logger.yellow(`  ${logger.blue(it.name)}: ${it.engines}`));
+        }
+        lines.push("");
+        lines.push(logger.yellow("dependencies:"));
+        if (maxRequired) {
+          if (currentVersion && cmpVer(currentVersion, maxRequired) < 0) {
+            lines.push(`  ${logger.green("node-karin:")} ${logger.gray(currentVersion)} -> ${logger.cyan(maxRequired)}`);
+            lines.push("");
+            lines.push(logger.white(`\u4E3A\u8FBE\u5230\u6B64\u90E8\u5206\u63D2\u4EF6\u7684\u6700\u4F4E\u8FD0\u884C\u8981\u6C42\uFF0C\u5EFA\u8BAE\u6267\u884C\uFF1A${logger.yellow(`pnpm up node-karin@${maxRequired}`)}`));
+          } else if (!currentVersion) {
+            lines.push(`  ${logger.green("node-karin:")} ${logger.cyan(maxRequired)}`);
+            lines.push("");
+            lines.push(logger.white(`\u4E3A\u8FBE\u5230\u6B64\u90E8\u5206\u63D2\u4EF6\u7684\u6700\u4F4E\u8FD0\u884C\u8981\u6C42\uFF0C\u5EFA\u8BAE\u6267\u884C\uFF1A${logger.yellow(`pnpm up node-karin@${maxRequired}`)}`));
+          }
+        }
+        console.log(lines.join("\n"));
+      };
+      return { add, flush };
+    };
+  }
+});
 var isInit, cache5, resetCache, initCache, setCachedList, setCachedInfo, getCachedData, createPkg, getAppInfo, getGitInfo, getNpmInfo, getPluginsInfo, collectAppPlugins, collectGitPlugins, NPM_EXCLUDE_LIST, collectNpmPlugins, collectAllPlugins, getPlugins;
 var init_list = __esm({
   "src/plugin/system/list.ts"() {
@@ -12723,6 +12829,7 @@ var init_list = __esm({
     init_path();
     init_env3();
     init_require();
+    init_versionCheck();
     isInit = true;
     cache5 = {
       list: void 0,
@@ -12886,21 +12993,33 @@ var init_list = __esm({
       );
     };
     collectGitPlugins = async (files, list2) => {
+      const reporter = createPluginMismatchReporter();
       await Promise.all(
         files.map(async (v) => {
           if (!v.isDirectory()) return;
           if (!v.name.startsWith("karin-plugin-")) return;
           if (!fs5.existsSync(path4.join(karinPathPlugins, v.name, "package.json"))) return;
           const pkg2 = await requireFile(path4.join(karinPathPlugins, v.name, "package.json"));
-          const engines = pkg2?.karin?.engines?.karin || pkg2?.engines?.karin;
-          if (engines && !satisfies(engines, process.env.KARIN_VERSION)) {
-            const msg = `[getPlugins][git] ${v.name} \u8981\u6C42 node-karin \u7248\u672C\u4E3A ${engines}\uFF0C\u5F53\u524D\u4E0D\u7B26\u5408\u8981\u6C42\uFF0C\u8DF3\u8FC7\u52A0\u8F7D\u63D2\u4EF6`;
-            isInit && setTimeout(() => logger.error(msg), 1e3);
-            return;
+          const ignore = pkg2?.karin?.ignoreEngines === true;
+          const preferred = typeof pkg2?.karin?.engines === "string" ? pkg2.karin.engines.trim() : "";
+          let fallback = "";
+          if (!preferred) {
+            if (typeof pkg2?.engines?.karin === "string") fallback = pkg2.engines.karin.trim();
+            else if (typeof pkg2?.engines?.["node-karin"] === "string") fallback = pkg2.engines["node-karin"].trim();
+          }
+          const range3 = preferred || fallback;
+          if (range3 && !satisfies(range3, process.env.KARIN_VERSION)) {
+            if (ignore) {
+              list2.push(`git:${v.name}`);
+            } else {
+              reporter.add(v.name, range3);
+            }
+          } else {
+            list2.push(`git:${v.name}`);
           }
-          list2.push(`git:${v.name}`);
         })
       );
+      await reporter.flush(isInit, process.env.KARIN_VERSION);
       const root = await requireFile("./package.json");
       if (root.name && root.karin) list2.push(`root:${root.name}`);
     };
@@ -12931,28 +13050,37 @@ var init_list = __esm({
     ];
     collectNpmPlugins = async (list2) => {
       logger.debug("[collectNpmPlugins] \u5F00\u59CB\u6536\u96C6NPM\u63D2\u4EF6");
-      const pkg2 = await requireFile("./package.json", { force: true });
+      const rootPkg = await requireFile("./package.json", { force: true });
+      const reporter = createPluginMismatchReporter();
       const dependencies = [
-        ...Object.keys(pkg2.dependencies || {}),
-        ...Object.keys(pkg2.devDependencies || {})
+        ...Object.keys(rootPkg.dependencies || {}),
+        ...Object.keys(rootPkg.devDependencies || {})
       ].filter((name) => !NPM_EXCLUDE_LIST.includes(name) && !name.startsWith("@types"));
       await Promise.allSettled(
         dependencies.map(async (name) => {
           const file2 = path4.join(process.cwd(), "node_modules", name, "package.json");
-          const pkg3 = await requireFile(file2);
-          if (!pkg3.karin) return;
-          const engines = pkg3.karin?.engines?.karin || pkg3.engines?.karin;
-          if (engines) {
-            if (!satisfies(engines, process.env.KARIN_VERSION)) {
-              isInit && logger.error(
-                `[getPlugins][npm] ${name} \u8981\u6C42 node-karin \u7248\u672C\u4E3A ${engines}\uFF0C\u5F53\u524D\u4E0D\u7B26\u5408\u8981\u6C42\uFF0C\u8DF3\u8FC7\u52A0\u8F7D\u63D2\u4EF6`
-              );
-              return;
+          const depPkg = await requireFile(file2);
+          if (!depPkg.karin) return;
+          const ignore = depPkg?.karin?.ignoreEngines === true;
+          const preferred = typeof depPkg?.karin?.engines === "string" ? depPkg.karin.engines.trim() : "";
+          let fallback = "";
+          if (!preferred) {
+            if (typeof depPkg?.engines?.karin === "string") fallback = depPkg.engines.karin.trim();
+            else if (typeof depPkg?.engines?.["node-karin"] === "string") fallback = depPkg.engines["node-karin"].trim();
+          }
+          const range3 = preferred || fallback;
+          if (range3 && !satisfies(range3, process.env.KARIN_VERSION)) {
+            if (ignore) {
+              list2.push(`npm:${name}`);
+            } else {
+              reporter.add(name, range3);
             }
+          } else {
+            list2.push(`npm:${name}`);
           }
-          list2.push(`npm:${name}`);
         })
       );
+      await reporter.flush(isInit, process.env.KARIN_VERSION);
     };
     collectAllPlugins = async (files, list2) => {
       await Promise.all([
@@ -22350,6 +22478,10 @@ var init_logger = __esm({
             return logger3.info(logger3.violet(`[Bot:${id}]`), ...args);
         }
       };
+      logger3.setContextLayouts("pattern", {
+        type: "pattern",
+        pattern: "[%d{hh:mm:ss.SSS}][%4.4p] %m"
+      });
       return logger3;
     };
     createLogger = () => {
@@ -22725,23 +22857,49 @@ var init_load = __esm({
     init_cache();
     init_utils();
     init_tools2();
+    init_system2();
     init_class();
     init_file();
     init_import();
     init_internal();
     init_list();
+    init_versionCheck();
     seq = 0;
     pkgLoads = async (pkg2, allPromises) => {
+      const reporter = createPluginMismatchReporter();
+      let isCompatible = true;
+      let shouldLoad = true;
+      if (pkg2.type !== "app") {
+        const ignoreEngines = pkg2.pkgData?.karin?.ignoreEngines === true;
+        const preferred = typeof pkg2.pkgData?.karin?.engines === "string" ? String(pkg2.pkgData.karin.engines).trim() : "";
+        let fallback = "";
+        if (!preferred) {
+          if (typeof pkg2.pkgData?.engines?.karin === "string") fallback = String(pkg2.pkgData.engines.karin).trim();
+          else if (typeof pkg2.pkgData?.engines?.["node-karin"] === "string") fallback = String(pkg2.pkgData.engines["node-karin"]).trim();
+        }
+        const range3 = preferred || fallback;
+        isCompatible = !range3 || satisfies(range3, process.env.KARIN_VERSION);
+        if (range3 && !isCompatible) {
+          if (!ignoreEngines) {
+            reporter.add(pkg2.name, range3);
+            await reporter.flush(true, process.env.KARIN_VERSION);
+            shouldLoad = false;
+          }
+        }
+      }
+      if (!shouldLoad) {
+        return;
+      }
       pkg2.id = ++seq;
       cache3.index[pkg2.id] = pkg2;
       const files = [];
       if (pkg2.type === "app") {
         files.push("config", "data", "resources");
-      } else if (Array.isArray(pkg2.pkgData.karin?.files)) {
+      } else if (pkg2.pkgData.karin?.files && Array.isArray(pkg2.pkgData.karin?.files)) {
         files.push(...pkg2.pkgData.karin.files);
       }
       await createPluginDir(pkg2.name, files);
-      if (pkg2.type !== "app") {
+      if (pkg2.type !== "app" && shouldLoad) {
         const main2 = pkg2.type === "npm" || !isTs() ? await loadMainFile(pkg2, pkg2.pkgData?.main) : await loadMainFile(pkg2, pkg2.pkgData?.karin?.main);
         if (main2 && main2.KARIN_PLUGIN_INIT) {
           try {
@@ -22752,7 +22910,7 @@ var init_load = __esm({
           }
         }
       }
-      pkg2.apps.forEach((app5) => {
+      shouldLoad && pkg2.apps.forEach((app5) => {
         const promise = async () => {
           const result = await pkgLoadModule(pkg2.name, app5);
           pkgCache(result, pkg2, app5);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Lightweight, efficient, concise, and stable robot framework.",
   "keywords": [
     "node",
@@ -166,7 +166,7 @@
     "chokidar": "4.0.3",
     "express": "npm:@karinjs/express@1.0.3",
     "lodash": "npm:@karinjs/lodash@1.1.1",
-    "log4js": "^6.9.1",
+    "log4js": "npm:@karinjs/log4js@1.5.4",
     "moment": "npm:@karinjs/moment@1.1.5",
     "node-schedule": "npm:@karinjs/node-schedule@1.0.0",
     "redis": "npm:@karinjs/redis@1.1.3",