node-karin 1.12.1 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 更新日志
 
+## [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)
+
+
+### 🐛 Bug Fixes
+
+* **update:** 增强版本比较功能，支持严格语义化版本模式 ([#568](https://github.com/KarinJS/Karin/issues/568)) ([da3843a](https://github.com/KarinJS/Karin/commit/da3843ae3c770b308583d9b0671d4dbd36ce37ec))
+
 ## [1.12.1](https://github.com/KarinJS/Karin/compare/core-v1.12.0...core-v1.12.1) (2025-10-17)
 
 

package/dist/index.d.ts

@@ -10,7 +10,7 @@ import { Readable } from 'node:stream';
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
 import YAML from 'yaml';
 import { FSWatcher } from 'chokidar';
-import { exec as exec$2, ExecException as ExecException$1 } from 'node:child_process';
+import { ExecException as ExecException$1, exec as exec$2 } from 'node:child_process';
 import { Request as Request$1, Router, Response, RequestHandler, Express } from 'express';
 import { exec as exec$1, ExecException } from 'child_process';
 export { ExecException } from 'child_process';
@@ -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;
 }
@@ -8325,6 +8332,174 @@ declare const lock: {
     };
 };
 
+/** 版本号对比模式 */
+type CompareMode = {
+    /**
+     * 版本号对比模式，怎么对比才算是有更新
+     *
+     * **xyz 模式（默认）**
+     * - 只看前三段数字 `X.Y.Z`，忽略预发布/构建后缀。
+     * - 示例：
+     *   - 本地 `2.6.7`，远程 `2.6.8` → 有更新
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.7` → 无更新（都视为 `2.6.7`）
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.1` → 有更新（只看 `1.0.0` vs `1.0.1`）
+     *   - 本地 `3.2.0-rc.3`，远程 `3.2.0` → 无更新（都视为 `3.2.0`）
+     *
+     * **semver 模式（语义化版本）**
+     * - 严格遵循 [SemVer](https://semver.org/) 规则。
+     * - 示例：
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.6` → 本地更高，已最新，不提示升级
+     *   - 本地 `1.0.0-alpha`，远程 `1.0.0` → 远程更高，提示升级
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.0` → 仅比较版本核心，不比较构建元数据，视为相同
+     *   - 本地 `2.0.0-beta.2`，远程 `2.0.0-beta.10` → 远程更高，提示升级（按预发布号逐段比较）
+     *   - 本地 `3.1.0-rc.1`，远程 `3.1.0` → 远程更高，提示升级（稳定版 > 预发布）
+     *
+     * @default 'xyz'
+     */
+    compare?: 'xyz' | 'semver';
+};
+/**
+ * @description 传入npm包名 检查是否存在更新
+ * @param name 包名
+ * @param opts 额外参数
+ * @returns 是否存在更新 true: 存在更新 false: 无更新
+ */
+declare const checkPkgUpdate: (name: string, opts?: CompareMode) => Promise<{
+    /** 存在更新 */
+    status: "yes";
+    /** 本地版本号 */
+    local: string;
+    /** 远程版本号 */
+    remote: string;
+} | {
+    /** 无更新 */
+    status: "no";
+    /** 本地版本号 */
+    local: string;
+} | {
+    /** 检查发生错误 */
+    status: "error";
+    /** 错误信息 */
+    error: Error;
+}>;
+/**
+ * @description 获取指定包的本地版本号 如果获取失败则会获取package.json中的版本号
+ * @param name 包名
+ */
+declare const getPkgVersion: (name: string) => Promise<string>;
+/**
+ * @description 获取指定包的远程版本号
+ * @param name 包名
+ * @param tag 标签，默认为 `latest`
+ */
+declare const getRemotePkgVersion: (name: string, tag?: string) => Promise<string>;
+/**
+ * @description 更新指定的npm插件
+ * @param name 包名
+ * @param tag 标签 默认 `latest`
+ */
+declare const updatePkg: (name: string, tag?: string) => Promise<{
+    /** 更新失败 */
+    status: "failed";
+    /** 更新失败信息 */
+    data: string | ExecException$1;
+} | {
+    /** 更新成功 */
+    status: "ok";
+    /** 更新成功信息 */
+    data: string;
+    /** 本地版本号 */
+    local: string;
+    /** 远程版本号 */
+    remote: string;
+}>;
+/**
+ * @description 更新全部npm插件
+ */
+declare const updateAllPkg: () => Promise<string>;
+/**
+ * @description 检查git插件是否有更新
+ * @param filePath 插件路径
+ * @param time 任务执行超时时间 默认120s
+ */
+declare const checkGitPluginUpdate: (filePath: string, time?: number) => Promise<{
+    /** 存在更新 */
+    status: "yes";
+    /** 更新内容 */
+    data: string;
+    /** 落后次数 */
+    count: number;
+} | {
+    /** 无更新 */
+    status: "no";
+    /** 最后更新时间描述 */
+    data: string;
+} | {
+    /** 检查发生错误 */
+    status: "error";
+    data: Error;
+}>;
+/**
+ * @description 获取指定仓库的提交记录
+ * @param options 参数
+ * @returns 提交记录
+ */
+declare const getCommit: (options: {
+    /** 指令命令路径 */
+    path: string;
+    /** 获取几次提交 默认1次 */
+    count?: number;
+    /** 指定哈希 */
+    hash?: string;
+    /** 指定分支 */
+    branch?: string;
+}) => Promise<string>;
+/**
+ * @description 获取指定仓库最后一次提交哈希值
+ * @param filePath - 插件相对路径
+ * @param short - 是否获取短哈希 默认true
+ */
+declare const getHash: (filePath: string, short?: boolean) => Promise<string>;
+/**
+ * 获取指定仓库最后一次提交时间日期
+ * @param filePath - 插件相对路径
+ * @returns 最后一次提交时间
+ * @example
+ * ```ts
+ * console.log(await getTime('./plugins/karin-plugin-example'))
+ * // -> '2021-09-01 12:00:00'
+ * ```
+ */
+declare const getTime: (filePath: string) => Promise<string>;
+/**
+ * @description 更新指定git插件
+ * @param filePath 插件路径
+ * @param cmd 执行命令 默认`git pull`
+ * @param time 任务执行超时时间 默认120s
+ */
+declare const updateGitPlugin: (filePath: string, cmd?: string, time?: number) => Promise<{
+    /** 更新失败 */
+    status: "failed";
+    /** 更新失败信息 */
+    data: string | ExecException$1;
+} | {
+    /** 更新成功 */
+    status: "ok";
+    /** 更新成功信息 */
+    data: string;
+    /** 更新详情 */
+    commit: string;
+} | {
+    /** 检查发生错误 */
+    status: "error";
+    data: Error;
+}>;
+/**
+ * @description 更新所有git插件
+ * @param time 任务执行超时时间 默认120s
+ */
+declare const updateAllGitPlugin: (cmd?: string, time?: number) => Promise<string>;
+
 /**
  * 提取指定版本号的更新日志
  * @param version 版本号，可包含预发布/构建元数据（如 `-beta`）
@@ -8335,36 +8510,120 @@ declare const lock: {
  * - 不存在时按新 -> 旧顺序回退到不超过目标稳定版的最新版本。
  */
 declare const log: (version: string, data: string) => string | null;
+/**
+ * 从指定版本开始提取连续的更新日志
+ */
+declare function logs(options: LogsOptions): string;
 /**
  * 从指定版本开始提取连续的更新日志
  * @param version 起始版本号
  * @param data `CHANGELOG.md` 文件内容
  * @param length 提取条数，默认为 1
  * @param reverse 是否反向提取；`false` 向后，`true` 向前
+ * @param opts 版本号对比模式
  * @returns 拼接后的更新日志字符串；找不到起始版本返回空字符串
  * @description
  * - 起始版本会规范化并回退到不超过目标稳定版的最新版本；
  * - 切片范围将做边界裁剪以避免越界。
+ * @deprecated 此调用方式将在未来版本废弃，请改用对象参数重载 logs({ ... }) 进行调用
  */
-declare const logs: (version: string, data: string, length?: number, reverse?: boolean) => string;
+declare function logs(version: string, data: string, length?: number, reverse?: boolean, opts?: CompareMode): string;
+/**
+ * 提取指定版本区间的更新日志
+ */
+declare function range(options: RangeOptions): string;
 /**
  * 提取指定版本区间的更新日志
  * @param data `CHANGELOG.md` 文件内容
  * @param startVersion 起始版本号（较旧）
  * @param endVersion 结束版本号（较新）
+ * @param opts 版本号对比模式
  * @returns 拼接后的更新日志字符串；若任一版本无法定位返回空字符串
  * @description
  * - CHANGELOG 的版本排序约定为从新到旧；
  * - 若传入版本不存在，将回退到不超过目标稳定版的最新版本；
  * - 当 `start > end` 时会自动调整为有效区间。
+ * @deprecated 此调用方式将在未来版本废弃，请改用对象参数重载 range({ ... }) 进行调用
  */
-declare const range: (data: string, startVersion: string, endVersion: string) => string;
+declare function range(data: string, startVersion: string, endVersion: string, opts?: CompareMode): string;
 /**
  * 对更新日志进行解析并形成对象
  * @param data 更新日志内容
  * @returns 以版本号为键的更新日志对象
  */
 declare const parseChangelog: (data: string) => Record<string, string>;
+/** logs 方法的配置 */
+type LogsOptions = {
+    /** 起始版本号 */
+    version: string;
+    /** CHANGELOG.md 内容 */
+    data: string;
+    /**
+     * 提取条数
+     * @default 1
+     */
+    length?: number;
+    /**
+     * 是否反向提取
+     * @default false
+     */
+    reverse?: boolean;
+    /**
+     * 版本号对比模式，怎么对比才算是有更新
+     *
+     * **xyz 模式（默认）**
+     * - 只看前三段数字 `X.Y.Z`，忽略预发布/构建后缀。
+     * - 示例：
+     *   - 本地 `2.6.7`，远程 `2.6.8` → 有更新
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.7` → 无更新（都视为 `2.6.7`）
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.1` → 有更新（只看 `1.0.0` vs `1.0.1`）
+     *   - 本地 `3.2.0-rc.3`，远程 `3.2.0` → 无更新（都视为 `3.2.0`）
+     *
+     * **semver 模式（语义化版本）**
+     * - 严格遵循 [SemVer](https://semver.org/) 规则。
+     * - 示例：
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.6` → 本地更高，已最新，不提示升级
+     *   - 本地 `1.0.0-alpha`，远程 `1.0.0` → 远程更高，提示升级
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.0` → 仅比较版本核心，不比较构建元数据，视为相同
+     *   - 本地 `2.0.0-beta.2`，远程 `2.0.0-beta.10` → 远程更高，提示升级（按预发布号逐段比较）
+     *   - 本地 `3.1.0-rc.1`，远程 `3.1.0` → 远程更高，提示升级（稳定版 > 预发布）
+     *
+     * @default 'xyz'
+     */
+    compare?: CompareMode['compare'];
+};
+/** range 方法的配置 */
+type RangeOptions = {
+    /** CHANGELOG.md 内容 */
+    data: string;
+    /** 起始版本号（较旧） */
+    startVersion: string;
+    /** 结束版本号（较新） */
+    endVersion: string;
+    /**
+     * 版本号对比模式，怎么对比才算是有更新
+     *
+     * **xyz 模式（默认）**
+     * - 只看前三段数字 `X.Y.Z`，忽略预发布/构建后缀。
+     * - 示例：
+     *   - 本地 `2.6.7`，远程 `2.6.8` → 有更新
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.7` → 无更新（都视为 `2.6.7`）
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.1` → 有更新（只看 `1.0.0` vs `1.0.1`）
+     *   - 本地 `3.2.0-rc.3`，远程 `3.2.0` → 无更新（都视为 `3.2.0`）
+     *
+     * **semver 模式（语义化版本）**
+     * - 严格遵循 [SemVer](https://semver.org/) 规则。
+     * - 示例：
+     *   - 本地 `2.6.7-beta.1`，远程 `2.6.6` → 本地更高，已最新，不提示升级
+     *   - 本地 `1.0.0-alpha`，远程 `1.0.0` → 远程更高，提示升级
+     *   - 本地 `1.0.0+20230101`，远程 `1.0.0` → 仅比较版本核心，不比较构建元数据，视为相同
+     *   - 本地 `2.0.0-beta.2`，远程 `2.0.0-beta.10` → 远程更高，提示升级（按预发布号逐段比较）
+     *   - 本地 `3.1.0-rc.1`，远程 `3.1.0` → 远程更高，提示升级（稳定版 > 预发布）
+     *
+     * @default 'xyz'
+     */
+    compare?: CompareMode['compare'];
+};
 
 declare const changelog_log: typeof log;
 declare const changelog_logs: typeof logs;
@@ -8780,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`序列化
@@ -8869,147 +9128,6 @@ declare const isDocker: boolean;
 /** 是否为root用户 仅linux */
 declare const isRoot: boolean;
 
-/**
- * @description 传入npm包名 检查是否存在更新
- * @param name 包名
- * @returns 是否存在更新 true: 存在更新 false: 无更新
- */
-declare const checkPkgUpdate: (name: string) => Promise<{
-    /** 存在更新 */
-    status: "yes";
-    /** 本地版本号 */
-    local: string;
-    /** 远程版本号 */
-    remote: string;
-} | {
-    /** 无更新 */
-    status: "no";
-    /** 本地版本号 */
-    local: string;
-} | {
-    /** 检查发生错误 */
-    status: "error";
-    /** 错误信息 */
-    error: Error;
-}>;
-/**
- * @description 获取指定包的本地版本号 如果获取失败则会获取package.json中的版本号
- * @param name 包名
- */
-declare const getPkgVersion: (name: string) => Promise<string>;
-/**
- * @description 获取指定包的远程版本号
- * @param name 包名
- * @param tag 标签，默认为 `latest`
- */
-declare const getRemotePkgVersion: (name: string, tag?: string) => Promise<string>;
-/**
- * @description 更新指定的npm插件
- * @param name 包名
- * @param tag 标签 默认 `latest`
- */
-declare const updatePkg: (name: string, tag?: string) => Promise<{
-    /** 更新失败 */
-    status: "failed";
-    /** 更新失败信息 */
-    data: string | ExecException$1;
-} | {
-    /** 更新成功 */
-    status: "ok";
-    /** 更新成功信息 */
-    data: string;
-    /** 本地版本号 */
-    local: string;
-    /** 远程版本号 */
-    remote: string;
-}>;
-/**
- * @description 更新全部npm插件
- */
-declare const updateAllPkg: () => Promise<string>;
-/**
- * @description 检查git插件是否有更新
- * @param filePath 插件路径
- * @param time 任务执行超时时间 默认120s
- */
-declare const checkGitPluginUpdate: (filePath: string, time?: number) => Promise<{
-    /** 存在更新 */
-    status: "yes";
-    /** 更新内容 */
-    data: string;
-    /** 落后次数 */
-    count: number;
-} | {
-    /** 无更新 */
-    status: "no";
-    /** 最后更新时间描述 */
-    data: string;
-} | {
-    /** 检查发生错误 */
-    status: "error";
-    data: Error;
-}>;
-/**
- * @description 获取指定仓库的提交记录
- * @param options 参数
- * @returns 提交记录
- */
-declare const getCommit: (options: {
-    /** 指令命令路径 */
-    path: string;
-    /** 获取几次提交 默认1次 */
-    count?: number;
-    /** 指定哈希 */
-    hash?: string;
-    /** 指定分支 */
-    branch?: string;
-}) => Promise<string>;
-/**
- * @description 获取指定仓库最后一次提交哈希值
- * @param filePath - 插件相对路径
- * @param short - 是否获取短哈希 默认true
- */
-declare const getHash: (filePath: string, short?: boolean) => Promise<string>;
-/**
- * 获取指定仓库最后一次提交时间日期
- * @param filePath - 插件相对路径
- * @returns 最后一次提交时间
- * @example
- * ```ts
- * console.log(await getTime('./plugins/karin-plugin-example'))
- * // -> '2021-09-01 12:00:00'
- * ```
- */
-declare const getTime: (filePath: string) => Promise<string>;
-/**
- * @description 更新指定git插件
- * @param filePath 插件路径
- * @param cmd 执行命令 默认`git pull`
- * @param time 任务执行超时时间 默认120s
- */
-declare const updateGitPlugin: (filePath: string, cmd?: string, time?: number) => Promise<{
-    /** 更新失败 */
-    status: "failed";
-    /** 更新失败信息 */
-    data: string | ExecException$1;
-} | {
-    /** 更新成功 */
-    status: "ok";
-    /** 更新成功信息 */
-    data: string;
-    /** 更新详情 */
-    commit: string;
-} | {
-    /** 检查发生错误 */
-    status: "error";
-    data: Error;
-}>;
-/**
- * @description 更新所有git插件
- * @param time 任务执行超时时间 默认120s
- */
-declare const updateAllGitPlugin: (cmd?: string, time?: number) => Promise<string>;
-
 /**
  * 重启Bot
  * @param selfId - 机器人的id 传e.self_id
@@ -9073,6 +9191,7 @@ declare const fileToUrl: FileToUrlHandler;
  */
 declare const satisfies: (satisfies: string, version: string) => boolean;
 
+type index$2_CompareMode = CompareMode;
 declare const index$2_checkGitPluginUpdate: typeof checkGitPluginUpdate;
 declare const index$2_checkPkgUpdate: typeof checkPkgUpdate;
 declare const index$2_checkPort: typeof checkPort;
@@ -9116,7 +9235,7 @@ declare const index$2_updateGitPlugin: typeof updateGitPlugin;
 declare const index$2_updatePkg: typeof updatePkg;
 declare const index$2_waitPort: typeof waitPort;
 declare namespace index$2 {
-  export { index$2_checkGitPluginUpdate as checkGitPluginUpdate, index$2_checkPkgUpdate as checkPkgUpdate, index$2_checkPort as checkPort, index$2_errorToString as errorToString, index$2_exec as exec, index$2_ffmpeg as ffmpeg, index$2_ffplay as ffplay, index$2_ffprobe as ffprobe, index$2_fileToUrl as fileToUrl, index$2_fileToUrlHandlerKey as fileToUrlHandlerKey, formatTime$1 as formatTime, index$2_getCommit as getCommit, index$2_getHash as getHash, index$2_getPid as getPid, index$2_getPkgVersion as getPkgVersion, index$2_getRemotePkgVersion as getRemotePkgVersion, index$2_getRequestIp as getRequestIp, index$2_getTime as getTime, index$2_importModule as importModule, index$2_imports as imports, index$2_isClass as isClass, index$2_isDocker as isDocker, index$2_isIPv4Loop as isIPv4Loop, index$2_isIPv6Loop as isIPv6Loop, index$2_isLinux as isLinux, index$2_isLocalRequest as isLocalRequest, index$2_isLoopback as isLoopback, index$2_isMac as isMac, index$2_isRoot as isRoot, index$2_isWin as isWin, index$2_killApp as killApp, index$2_lock as lock, index$2_lockMethod as lockMethod, index$2_lockProp as lockProp, index$2_restart as restart, index$2_restartDirect as restartDirect, index$2_satisfies as satisfies, index$2_stringifyError as stringifyError, index$2_updateAllGitPlugin as updateAllGitPlugin, index$2_updateAllPkg as updateAllPkg, index$2_updateGitPlugin as updateGitPlugin, index$2_updatePkg as updatePkg, uptime$1 as uptime, index$2_waitPort as waitPort };
+  export { type index$2_CompareMode as CompareMode, index$2_checkGitPluginUpdate as checkGitPluginUpdate, index$2_checkPkgUpdate as checkPkgUpdate, index$2_checkPort as checkPort, index$2_errorToString as errorToString, index$2_exec as exec, index$2_ffmpeg as ffmpeg, index$2_ffplay as ffplay, index$2_ffprobe as ffprobe, index$2_fileToUrl as fileToUrl, index$2_fileToUrlHandlerKey as fileToUrlHandlerKey, formatTime$1 as formatTime, index$2_getCommit as getCommit, index$2_getHash as getHash, index$2_getPid as getPid, index$2_getPkgVersion as getPkgVersion, index$2_getRemotePkgVersion as getRemotePkgVersion, index$2_getRequestIp as getRequestIp, index$2_getTime as getTime, index$2_importModule as importModule, index$2_imports as imports, index$2_isClass as isClass, index$2_isDocker as isDocker, index$2_isIPv4Loop as isIPv4Loop, index$2_isIPv6Loop as isIPv6Loop, index$2_isLinux as isLinux, index$2_isLocalRequest as isLocalRequest, index$2_isLoopback as isLoopback, index$2_isMac as isMac, index$2_isRoot as isRoot, index$2_isWin as isWin, index$2_killApp as killApp, index$2_lock as lock, index$2_lockMethod as lockMethod, index$2_lockProp as lockProp, index$2_restart as restart, index$2_restartDirect as restartDirect, index$2_satisfies as satisfies, index$2_stringifyError as stringifyError, index$2_updateAllGitPlugin as updateAllGitPlugin, index$2_updateAllPkg as updateAllPkg, index$2_updateGitPlugin as updateGitPlugin, index$2_updatePkg as updatePkg, uptime$1 as uptime, index$2_waitPort as waitPort };
 }
 
 /**
@@ -17668,4 +17787,4 @@ type Client = RedisClientType & {
  */
 declare const start: () => Promise<void>;
 
-export { type Accept, type AccordionItemProps, type AccordionKV, type AccordionProProps, type AccordionProResult, type AccordionProps, type AccordionResult, type AccountInfo, type Adapter, AdapterBase, type AdapterCommunication, AdapterConvertKarin, type AdapterInfo, AdapterOneBot, type AdapterOptions, type AdapterPlatform, type AdapterProtocol, type AdapterStandard, type AdapterType, type Adapters, type AddDependenciesParams, type AddTaskResult, type AfterForwardMessageCallback, type AfterMessageCallback, type AllPluginMethods, type Apps, type ArrayField, type AtElement, type Author, BASE_ROUTER, BATCH_UPDATE_PLUGINS_ROUTER, type BaseContact, BaseEvent, type BaseEventOptions, type BaseEventType, type BaseForwardCallback, type BaseMessageCallback, type BasketballElement, Bot, type BoundingBox, type BubbleFaceElement, type Button, type ButtonElement, CHECK_PLUGIN_ROUTER, CLOSE_TERMINAL_ROUTER, CONSOLE_ROUTER, CREATE_TERMINAL_ROUTER, type Cache, type CacheEntry, type CheckboxField, type CheckboxGroupProps, type CheckboxProps, type CheckboxResult, type Children, type CmdFnc, type Command, type CommandClass, type ComponentConfig, type ComponentProps, type ComponentType, type Components, type ComponentsClass, type Config, type Contact, type ContactElement, type Count, type CreateGroupFolderResponse, type CreatePty, type CreateTask, type CreateTaskParams, type CreateTaskResult, type CronProps, type CustomMusicElement, type CustomNodeElement, type DbStreamStatus, type DbStreams, type DefineConfig, type DependenciesManage, type DependenciesManageBase, type Dependency, type DiceElement, type DirectContact, DirectMessage, type DirectMessageOptions, type DirectNodeElement, type DirectSender, type DividerField, type DividerProps, type DownloadFileErrorResult, type DownloadFileOptions, type DownloadFileResponse, type DownloadFileResult, type DownloadFileSuccessResult, type DownloadFilesOptions, EVENT_COUNT, EXIT_ROUTER, type ElementTypes, type Elements, type Env, type Event, type EventCallCallback, type EventCallHookItem, type EventParent, type EventToSubEvent, type ExecOptions$1 as ExecOptions, type ExecReturn, type ExecType, type ExtendedAxiosRequestConfig, FILE_CHANGE, type FaceElement, type FieldType, type FileElement, type FileList, type FileListMap, type FileToUrlHandler, type FileToUrlResult, type FormField, type ForwardMessageCallback, type ForwardOptions, type FriendContact, type FriendData, FriendDecreaseNotice, type FriendDecreaseOptions, FriendIncreaseNotice, type FriendIncreaseOptions, FriendMessage, type FriendMessageOptions, type FriendNoticeEventMap, type FriendRequestEventMap, type FriendRequestOptions, type FriendSender, type FrontendInstalledPluginListResponse, GET_BOTS_ROUTER, GET_CONFIG_ROUTER, GET_DEPENDENCIES_LIST_ROUTER, GET_LOADED_COMMAND_PLUGIN_CACHE_LIST_ROUTER, GET_LOCAL_PLUGIN_FRONTEND_LIST_ROUTER, GET_LOCAL_PLUGIN_LIST_ROUTER, GET_LOG_FILE_LIST_ROUTER, GET_LOG_FILE_ROUTER, GET_LOG_ROUTER, GET_NETWORK_STATUS_ROUTER, GET_NPMRC_LIST_ROUTER, GET_NPM_BASE_CONFIG_ROUTER, GET_NPM_CONFIG_ROUTER, GET_ONLINE_PLUGIN_LIST_ROUTER, GET_PLUGIN_APPS_ROUTER, GET_PLUGIN_CONFIG_ROUTER, GET_PLUGIN_FILE_ROUTER, GET_PLUGIN_LIST_PLUGIN_ADMIN_ROUTER, GET_PLUGIN_LIST_ROUTER, GET_PLUGIN_MARKET_LIST_ROUTER, GET_TASK_LIST_ROUTER, GET_TASK_STATUS_ROUTER, GET_TERMINAL_LIST_ROUTER, GET_UPDATABLE_PLUGINS_ROUTER, GET_WEBUI_PLUGIN_LIST_ROUTER, GET_WEBUI_PLUGIN_VERSIONS_ROUTER, type GeneralHookCallback, type GeneralHookItem, type GetAiCharactersResponse, type GetAtAllCountResponse, type GetBot, type GetCommitHashOptions, type GetConfigRequest, type GetConfigResponse, type GetGroupFileListResponse, type GetGroupFileSystemInfoResponse, type GetGroupHighlightsResponse, type GetGroupMuteListResponse, type GetPluginLocalOptions, type GetPluginLocalReturn, type GetPluginReturn, type GetPluginType, type GetRkeyResponse, type GiftElement, type GitLocalBranches, type GitPullOptions, type GitPullResult, type GitRemoteBranches, type GithubConfig, type GoToOptions, GroupAdminChangedNotice, type GroupAdminChangedOptions, GroupApplyRequest, type GroupApplyRequestOptions, GroupCardChangedNotice, type GroupCardChangedOptions, type GroupContact, type GroupData, GroupFileUploadedNotice, type GroupFileUploadedOptions, GroupHlightsChangedNotice, type GroupHlightsChangedOptions, GroupHonorChangedNotice, type GroupHonorChangedOptions, type GroupInfo, GroupInviteRequest, type GroupInviteRequestOptions, GroupLuckKingNotice, type GroupLuckKingOptions, GroupMemberBanNotice, type GroupMemberBanOptions, type GroupMemberData, GroupMemberDecreaseNotice, type GroupMemberDecreaseOptions, GroupMemberIncreaseNotice, type GroupMemberIncreaseOptions, type GroupMemberInfo, GroupMemberTitleUpdatedNotice, type GroupMemberUniqueTitleChangedOptions, GroupMessage, type GroupMessageOptions, GroupMessageReactionNotice, type GroupMessageReactionOptions, GroupNotice, type GroupNoticeEventMap, GroupPokeNotice, type GroupPokeOptions, GroupRecallNotice, type GroupRecallOptions, type GroupRequestEventMap, type GroupSender, GroupSignInNotice, type GroupSignInOptions, type GroupTempContact, GroupTempMessage, type GroupTempMessageOptions, type GroupTempSender, GroupWholeBanNotice, type GroupWholeBanOptions, type Groups, type GroupsObjectValue, type GuildContact, GuildMessage, type GuildMessageOptions, type GuildSender, HTTPStatusCode, type Handler, type HandlerType, type HookCache, type HookCallback, type HookEmitForward, type HookEmitMessage, type HookNext, type HookOptions, type HooksType, INSTALL_PLUGIN_ROUTER, INSTALL_WEBUI_PLUGIN_ROUTER, IS_PLUGIN_CONFIG_EXIST_ROUTER, type Icon, type ImageElement, type ImportModuleResult, type InputGroupProps, type InputProps, type InputResult, type JsonElement, type JwtVerifyBase, type JwtVerifyError, type JwtVerifyExpired, type JwtVerifyResult, type JwtVerifySuccess, type JwtVerifyUnauthorized, type KarinButton, KarinConvertAdapter, type KarinPluginAppsType, type KeyboardElement, LOGIN_ROUTER, type LoadPluginResult, type LoadedPluginCacheList, type LocalApiResponse, type LocationElement, type Log, LogMethodNames, Logger, LoggerLevel, type LongMsgElement, MANAGE_DEPENDENCIES_ROUTER, type MarkdownElement, type MarkdownTplElement, type MarketFaceElement, type Message, MessageBase$1 as MessageBase, type MessageEventMap, type MessageEventSub, type MessageHookItem, type MessageOptions, type MessageResponse, type MusicElement, type MusicPlatform, type NetworkStatus, type NodeElement, type NormalMessageCallback, type Notice, type NoticeAndRequest, NoticeBase, type NoticeEventMap, type NoticeEventSub, type NoticeOptions, type NpmBaseConfigResponse, type NpmRegistryResponse, type NpmrcFileResponse, type NumberField, type ObjectArrayField, type ObjectField, createMessage as OneBotCreateMessage, createNotice as OneBotCreateNotice, createRequest as OneBotCreateRequest, type Option, type Options, PING_ROUTER, PLUGIN_ADMIN_ROUTER, type PM2, type Package, type Parser, type PasmsgElement, type Permission, type PingRequestResult, type PkgData, type PkgEnv, type PkgInfo, Plugin$1 as Plugin, type PluginAdminCustomInstall, type PluginAdminCustomInstallApp, type PluginAdminInstall, type PluginAdminListResponse, type PluginAdminMarketInstall, type PluginAdminMarketInstallApp, type PluginAdminParams, type PluginAdminResult, type PluginAdminUninstall, type PluginAdminUpdate, type PluginFile, type PluginFncTypes, type PluginLists, type PluginMarketAuthor, type PluginMarketLocalBase, type PluginMarketLocalOptions, type PluginMarketOptions, type PluginMarketRequest, type PluginMarketResponse, type PluginOptions, type PluginRule, type PluginUpdateInfo, type PnpmDependencies, type PnpmDependency, type Point, PrivateApplyRequest, type PrivateApplyRequestOptions, PrivateFileUploadedNotice, type PrivateFileUploadedOptions, PrivatePokeNotice, type PrivatePokeOptions, PrivateRecallNotice, type PrivateRecallOptions, type Privates, type PrivatesObjectValue, type PuppeteerLifeCycleEvent, type QQBotButton, type QQButtonTextType, type QQGroupFileInfo, type QQGroupFolderInfo, type QQGroupHonorInfo, RECV_MSG, REFRESH_ROUTER, RESTART_ROUTER, type RaceResult, type Radio, type RadioField, type RadioGroupProps, type RadioResult, type RawElement, type ReadyMusicElement, ReceiveLikeNotice, type ReceiveLikeOptions, type RecordElement, type Redis, type RemoveDependenciesParams, type Render, type RenderResult, Renderer, type Renders$1 as Renders, type Reply, type ReplyElement, type Request, RequestBase, type RequestEventMap, type RequestEventSub, type RequestOptions, type RequireFunction, type RequireFunctionSync, type RequireOptions, type Role, type RpsElement, SAVE_CONFIG_ROUTER, SAVE_NPMRC_ROUTER, SAVE_PLUGIN_CONFIG_ROUTER, SEND_MSG, SET_LOG_LEVEL_ROUTER, SYSTEM_INFO_ROUTER, SYSTEM_STATUS_KARIN_ROUTER, SYSTEM_STATUS_ROUTER, SYSTEM_STATUS_WS_ROUTER, type SandBoxAccountInfo, type SandboxMsgRecord, type SandboxSendApi, type SandboxSendSendFriendMsg, type SandboxSendSendGroupMsg, type SandboxSendSendMsg, type SaveConfigResponse, type SaveResult, type Scene, type ScreenshotClip, type ScreenshotOptions, type SectionField, type SelectField, type SelectItem, type SelectProps, type SendElement, type SendForwardMessageResponse, type SendMessage, type SendMsgHookItem, type SendMsgResults, type Sender, type SenderBase, type SenderGroup$1 as SenderGroup, type Sex$1 as Sex, type ShareElement, type Snapka, type SnapkaResult, type SrcReply, type StandardResult, type SwitchField, type SwitchProps, type SwitchResult, TASK_DELETE_ROUTER, TASK_LIST_ROUTER, TASK_LOGS_ROUTER, TASK_RUN_ROUTER, type Task, type TaskCallbacks, type TaskEntity, type TaskExecutor, type TaskFilter, type TaskStatus, type TaskType, type TerminalInstance, type TerminalShell, type TestNetworkRequestDetail, type TextElement, type TextField, type TitleField, UNINSTALL_PLUGIN_ROUTER, UNINSTALL_WEBUI_PLUGIN_ROUTER, UPDATE_CORE_ROUTER, UPDATE_PLUGIN_ROUTER, UPDATE_TASK_STATUS_ROUTER, UPDATE_WEBUI_PLUGIN_VERSION_ROUTER, type UnionMessage, type UnregisterBot, type UpgradeDependenciesParams, type UserInfo, type ValidationRule, type ValueType, type VideoElement, WS_CLOSE, WS_CLOSE_ONEBOT, WS_CLOSE_PUPPETEER, WS_CLOSE_SANDBOX, WS_CONNECTION, WS_CONNECTION_ONEBOT, WS_CONNECTION_PUPPETEER, WS_CONNECTION_SANDBOX, WS_CONNECTION_TERMINAL, WS_SNAPKA, type WaitForOptions, Watch, Watcher, type WeatherElement, type XmlElement, type YamlComment, YamlEditor, type YamlValue, absPath, accordion, accordionItem, accordionPro, app, applyComments, authMiddleware, base64, buffer, buildError, buildGithub, buttonHandle, cacheMap, callRender, changelog, checkGitPluginUpdate, checkPkgUpdate, checkPort, clearRequire, clearRequireFile, comment, index$1 as common, components, index as config, contact$1 as contact, contactDirect, contactFriend, contactGroup, contactGroupTemp, contactGuild, convertOneBotMessageToKarin, copyConfig, copyConfigSync, copyFiles, copyFilesSync, createAccessTokenExpiredResponse, createBadRequestResponse, createDirectMessage, createForbiddenResponse, createFriendDecreaseNotice, createFriendIncreaseNotice, createFriendMessage, createGroupAdminChangedNotice, createGroupApplyRequest, createGroupCardChangedNotice, createGroupFileUploadedNotice, createGroupHlightsChangedNotice, createGroupHonorChangedNotice, createGroupInviteRequest, createGroupLuckKingNotice, createGroupMemberAddNotice, createGroupMemberBanNotice, createGroupMemberDelNotice, createGroupMemberTitleUpdatedNotice, createGroupMessage, createGroupMessageReactionNotice, createGroupPokeNotice, createGroupRecallNotice, createGroupSignInNotice, createGroupTempMessage, createGroupWholeBanNotice, createGuildMessage, createINIParser, createMethodNotAllowedResponse, createNotFoundResponse, createOneBotClient, createOneBotHttp, createOneBotWsServer, createPayloadTooLargeResponse, createPluginDir, createPrivateApplyRequest, createPrivateFileUploadedNotice, createPrivatePokeNotice, createPrivateRecallNotice, createRawMessage, createReceiveLikeNotice, createRefreshTokenExpiredResponse, createResponse, createServerErrorResponse, createSuccessResponse, createTaskDatabase, createUnauthorizedResponse, cron, db, debug, karin as default, defineConfig, disconnectAllOneBotServer, divider, downFile, downloadFile, errorToString, exec, executeTask, existToMkdir, existToMkdirSync, exists, existsSync, ffmpeg, ffplay, ffprobe, fs as file, fileToBase64, fileToUrl, fileToUrlHandlerKey, filesByExt, formatLogString, formatPath, formatTime$1 as formatTime, index$3 as fs, getAllBot, getAllBotID, getAllBotList, getAllFiles, getAllFilesSync, getBot, getBotCount, getCommit, getDefaultBranch, getFastGithub, getFastRegistry, getFileMessage, getFiles, getHash, getLocalBranches, getLocalCommitHash, getMimeType, getPackageJson, getPid, getPkgVersion, getPluginInfo, getPlugins, getRelPath, getRemoteBranches, getRemoteCommitHash, getRemotePkgVersion, getRender, getRenderCount, getRenderList, getRequestIp, getTaskCallback, getTaskDatabase, getTime, gitPull, handler$1 as handler, hooks, importModule, imports, ini, initOneBotAdapter, initTaskSystem, input, isClass, isDir, isDirSync, isDocker, isFile, isFileSync, isIPv4Loop, isIPv6Loop, isLinux, isLocalRequest, isLoopback, isMac, isPathEqual, isPlugin, isPublic, isRoot, isSubPath, isWin, json$1 as json, karin, karinToQQBot, key, killApp, lock, lockMethod, lockProp, log, logger, logs, makeForward, makeMessage, type messageType, mkdir, mkdirSync, parseChangelog, parseGithubUrl, pingRequest, pkgRoot, qqbotToKarin, raceRequest, randomStr, range, read, readFile, readJson, readJsonSync, redis, registerBot, registerRender, removeTaskCallback, render, renderHtml, renderMultiHtml, renderTpl, requireFile, requireFileSync, restart, restartDirect, rmSync, router, satisfies, save, type screenshot, segment, select, sendMsg$1 as sendMsg, sender, senderDirect, senderFriend, senderGroup, senderGroupTemp, senderGuild, sep, server, setTaskCallback, setTaskDatabase, splitPath, start, stream, stringifyError, switchComponent, index$2 as system, taskAdd, taskExists, taskGet, taskList, taskSystem, taskUpdateLogs, taskUpdateStatus, unregisterBot, unregisterRender, updateAllGitPlugin, updateAllPkg, updateGitPlugin, updatePkg, updateTaskLogs, updateTaskStatus, uptime$1 as uptime, urlToPath, waitPort, watch, watchAndMerge, write, writeJson, writeJsonSync, yaml };
+export { type Accept, type AccordionItemProps, type AccordionKV, type AccordionProProps, type AccordionProResult, type AccordionProps, type AccordionResult, type AccountInfo, type Adapter, AdapterBase, type AdapterCommunication, AdapterConvertKarin, type AdapterInfo, AdapterOneBot, type AdapterOptions, type AdapterPlatform, type AdapterProtocol, type AdapterStandard, type AdapterType, type Adapters, type AddDependenciesParams, type AddTaskResult, type AfterForwardMessageCallback, type AfterMessageCallback, type AllPluginMethods, type Apps, type ArrayField, type AtElement, type Author, BASE_ROUTER, BATCH_UPDATE_PLUGINS_ROUTER, type BaseContact, BaseEvent, type BaseEventOptions, type BaseEventType, type BaseForwardCallback, type BaseMessageCallback, type BasketballElement, Bot, type BoundingBox, type BubbleFaceElement, type Button, type ButtonElement, CHECK_PLUGIN_ROUTER, CLOSE_TERMINAL_ROUTER, CONSOLE_ROUTER, CREATE_TERMINAL_ROUTER, type Cache, type CacheEntry, type CheckboxField, type CheckboxGroupProps, type CheckboxProps, type CheckboxResult, type Children, type CmdFnc, type Command, type CommandClass, type CompareMode, type ComponentConfig, type ComponentProps, type ComponentType, type Components, type ComponentsClass, type Config, type Contact, type ContactElement, type Count, type CreateGroupFolderResponse, type CreatePty, type CreateTask, type CreateTaskParams, type CreateTaskResult, type CronProps, type CustomMusicElement, type CustomNodeElement, type DbStreamStatus, type DbStreams, type DefineConfig, type DependenciesManage, type DependenciesManageBase, type Dependency, type DiceElement, type DirectContact, DirectMessage, type DirectMessageOptions, type DirectNodeElement, type DirectSender, type DividerField, type DividerProps, type DownloadFileErrorResult, type DownloadFileOptions, type DownloadFileResponse, type DownloadFileResult, type DownloadFileSuccessResult, type DownloadFilesOptions, EVENT_COUNT, EXIT_ROUTER, type ElementTypes, type Elements, type Env, type Event, type EventCallCallback, type EventCallHookItem, type EventParent, type EventToSubEvent, type ExecOptions$1 as ExecOptions, type ExecReturn, type ExecType, type ExtendedAxiosRequestConfig, FILE_CHANGE, type FaceElement, type FieldType, type FileElement, type FileList, type FileListMap, type FileToUrlHandler, type FileToUrlResult, type FormField, type ForwardMessageCallback, type ForwardOptions, type FriendContact, type FriendData, FriendDecreaseNotice, type FriendDecreaseOptions, FriendIncreaseNotice, type FriendIncreaseOptions, FriendMessage, type FriendMessageOptions, type FriendNoticeEventMap, type FriendRequestEventMap, type FriendRequestOptions, type FriendSender, type FrontendInstalledPluginListResponse, GET_BOTS_ROUTER, GET_CONFIG_ROUTER, GET_DEPENDENCIES_LIST_ROUTER, GET_LOADED_COMMAND_PLUGIN_CACHE_LIST_ROUTER, GET_LOCAL_PLUGIN_FRONTEND_LIST_ROUTER, GET_LOCAL_PLUGIN_LIST_ROUTER, GET_LOG_FILE_LIST_ROUTER, GET_LOG_FILE_ROUTER, GET_LOG_ROUTER, GET_NETWORK_STATUS_ROUTER, GET_NPMRC_LIST_ROUTER, GET_NPM_BASE_CONFIG_ROUTER, GET_NPM_CONFIG_ROUTER, GET_ONLINE_PLUGIN_LIST_ROUTER, GET_PLUGIN_APPS_ROUTER, GET_PLUGIN_CONFIG_ROUTER, GET_PLUGIN_FILE_ROUTER, GET_PLUGIN_LIST_PLUGIN_ADMIN_ROUTER, GET_PLUGIN_LIST_ROUTER, GET_PLUGIN_MARKET_LIST_ROUTER, GET_TASK_LIST_ROUTER, GET_TASK_STATUS_ROUTER, GET_TERMINAL_LIST_ROUTER, GET_UPDATABLE_PLUGINS_ROUTER, GET_WEBUI_PLUGIN_LIST_ROUTER, GET_WEBUI_PLUGIN_VERSIONS_ROUTER, type GeneralHookCallback, type GeneralHookItem, type GetAiCharactersResponse, type GetAtAllCountResponse, type GetBot, type GetCommitHashOptions, type GetConfigRequest, type GetConfigResponse, type GetGroupFileListResponse, type GetGroupFileSystemInfoResponse, type GetGroupHighlightsResponse, type GetGroupMuteListResponse, type GetPluginLocalOptions, type GetPluginLocalReturn, type GetPluginReturn, type GetPluginType, type GetRkeyResponse, type GiftElement, type GitLocalBranches, type GitPullOptions, type GitPullResult, type GitRemoteBranches, type GithubConfig, type GoToOptions, GroupAdminChangedNotice, type GroupAdminChangedOptions, GroupApplyRequest, type GroupApplyRequestOptions, GroupCardChangedNotice, type GroupCardChangedOptions, type GroupContact, type GroupData, GroupFileUploadedNotice, type GroupFileUploadedOptions, GroupHlightsChangedNotice, type GroupHlightsChangedOptions, GroupHonorChangedNotice, type GroupHonorChangedOptions, type GroupInfo, GroupInviteRequest, type GroupInviteRequestOptions, GroupLuckKingNotice, type GroupLuckKingOptions, GroupMemberBanNotice, type GroupMemberBanOptions, type GroupMemberData, GroupMemberDecreaseNotice, type GroupMemberDecreaseOptions, GroupMemberIncreaseNotice, type GroupMemberIncreaseOptions, type GroupMemberInfo, GroupMemberTitleUpdatedNotice, type GroupMemberUniqueTitleChangedOptions, GroupMessage, type GroupMessageOptions, GroupMessageReactionNotice, type GroupMessageReactionOptions, GroupNotice, type GroupNoticeEventMap, GroupPokeNotice, type GroupPokeOptions, GroupRecallNotice, type GroupRecallOptions, type GroupRequestEventMap, type GroupSender, GroupSignInNotice, type GroupSignInOptions, type GroupTempContact, GroupTempMessage, type GroupTempMessageOptions, type GroupTempSender, GroupWholeBanNotice, type GroupWholeBanOptions, type Groups, type GroupsObjectValue, type GuildContact, GuildMessage, type GuildMessageOptions, type GuildSender, HTTPStatusCode, type Handler, type HandlerType, type HookCache, type HookCallback, type HookEmitForward, type HookEmitMessage, type HookNext, type HookOptions, type HooksType, INSTALL_PLUGIN_ROUTER, INSTALL_WEBUI_PLUGIN_ROUTER, IS_PLUGIN_CONFIG_EXIST_ROUTER, type Icon, type ImageElement, type ImportModuleResult, type InputGroupProps, type InputProps, type InputResult, type JsonElement, type JwtVerifyBase, type JwtVerifyError, type JwtVerifyExpired, type JwtVerifyResult, type JwtVerifySuccess, type JwtVerifyUnauthorized, type KarinButton, KarinConvertAdapter, type KarinPluginAppsType, type KeyboardElement, LOGIN_ROUTER, type LoadPluginResult, type LoadedPluginCacheList, type LocalApiResponse, type LocationElement, type Log, LogMethodNames, Logger, LoggerLevel, type LongMsgElement, MANAGE_DEPENDENCIES_ROUTER, type MarkdownElement, type MarkdownTplElement, type MarketFaceElement, type Message, MessageBase$1 as MessageBase, type MessageEventMap, type MessageEventSub, type MessageHookItem, type MessageOptions, type MessageResponse, type MusicElement, type MusicPlatform, type NetworkStatus, type NodeElement, type NormalMessageCallback, type Notice, type NoticeAndRequest, NoticeBase, type NoticeEventMap, type NoticeEventSub, type NoticeOptions, type NpmBaseConfigResponse, type NpmRegistryResponse, type NpmrcFileResponse, type NumberField, type ObjectArrayField, type ObjectField, createMessage as OneBotCreateMessage, createNotice as OneBotCreateNotice, createRequest as OneBotCreateRequest, type Option, type Options, PING_ROUTER, PLUGIN_ADMIN_ROUTER, type PM2, type Package, type Parser, type PasmsgElement, type Permission, type PingRequestResult, type PkgData, type PkgEnv, type PkgInfo, Plugin$1 as Plugin, type PluginAdminCustomInstall, type PluginAdminCustomInstallApp, type PluginAdminInstall, type PluginAdminListResponse, type PluginAdminMarketInstall, type PluginAdminMarketInstallApp, type PluginAdminParams, type PluginAdminResult, type PluginAdminUninstall, type PluginAdminUpdate, type PluginFile, type PluginFncTypes, type PluginLists, type PluginMarketAuthor, type PluginMarketLocalBase, type PluginMarketLocalOptions, type PluginMarketOptions, type PluginMarketRequest, type PluginMarketResponse, type PluginOptions, type PluginRule, type PluginUpdateInfo, type PnpmDependencies, type PnpmDependency, type Point, PrivateApplyRequest, type PrivateApplyRequestOptions, PrivateFileUploadedNotice, type PrivateFileUploadedOptions, PrivatePokeNotice, type PrivatePokeOptions, PrivateRecallNotice, type PrivateRecallOptions, type Privates, type PrivatesObjectValue, type PuppeteerLifeCycleEvent, type QQBotButton, type QQButtonTextType, type QQGroupFileInfo, type QQGroupFolderInfo, type QQGroupHonorInfo, RECV_MSG, REFRESH_ROUTER, RESTART_ROUTER, type RaceResult, type Radio, type RadioField, type RadioGroupProps, type RadioResult, type RawElement, type ReadyMusicElement, ReceiveLikeNotice, type ReceiveLikeOptions, type RecordElement, type Redis, type RemoveDependenciesParams, type Render, type RenderResult, Renderer, type Renders$1 as Renders, type Reply, type ReplyElement, type Request, RequestBase, type RequestEventMap, type RequestEventSub, type RequestOptions, type RequireFunction, type RequireFunctionSync, type RequireOptions, type Role, type RpsElement, SAVE_CONFIG_ROUTER, SAVE_NPMRC_ROUTER, SAVE_PLUGIN_CONFIG_ROUTER, SEND_MSG, SET_LOG_LEVEL_ROUTER, SYSTEM_INFO_ROUTER, SYSTEM_STATUS_KARIN_ROUTER, SYSTEM_STATUS_ROUTER, SYSTEM_STATUS_WS_ROUTER, type SandBoxAccountInfo, type SandboxMsgRecord, type SandboxSendApi, type SandboxSendSendFriendMsg, type SandboxSendSendGroupMsg, type SandboxSendSendMsg, type SaveConfigResponse, type SaveResult, type Scene, type ScreenshotClip, type ScreenshotOptions, type SectionField, type SelectField, type SelectItem, type SelectProps, type SendElement, type SendForwardMessageResponse, type SendMessage, type SendMsgHookItem, type SendMsgResults, type Sender, type SenderBase, type SenderGroup$1 as SenderGroup, type Sex$1 as Sex, type ShareElement, type Snapka, type SnapkaResult, type SrcReply, type StandardResult, type SwitchField, type SwitchProps, type SwitchResult, TASK_DELETE_ROUTER, TASK_LIST_ROUTER, TASK_LOGS_ROUTER, TASK_RUN_ROUTER, type Task, type TaskCallbacks, type TaskEntity, type TaskExecutor, type TaskFilter, type TaskStatus, type TaskType, type TerminalInstance, type TerminalShell, type TestNetworkRequestDetail, type TextElement, type TextField, type TitleField, UNINSTALL_PLUGIN_ROUTER, UNINSTALL_WEBUI_PLUGIN_ROUTER, UPDATE_CORE_ROUTER, UPDATE_PLUGIN_ROUTER, UPDATE_TASK_STATUS_ROUTER, UPDATE_WEBUI_PLUGIN_VERSION_ROUTER, type UnionMessage, type UnregisterBot, type UpgradeDependenciesParams, type UserInfo, type ValidationRule, type ValueType, type VideoElement, WS_CLOSE, WS_CLOSE_ONEBOT, WS_CLOSE_PUPPETEER, WS_CLOSE_SANDBOX, WS_CONNECTION, WS_CONNECTION_ONEBOT, WS_CONNECTION_PUPPETEER, WS_CONNECTION_SANDBOX, WS_CONNECTION_TERMINAL, WS_SNAPKA, type WaitForOptions, Watch, Watcher, type WeatherElement, type XmlElement, type YamlComment, YamlEditor, type YamlValue, absPath, accordion, accordionItem, accordionPro, app, applyComments, authMiddleware, base64, buffer, buildError, buildGithub, buttonHandle, cacheMap, callRender, changelog, checkGitPluginUpdate, checkPkgUpdate, checkPort, clearRequire, clearRequireFile, comment, index$1 as common, components, index as config, contact$1 as contact, contactDirect, contactFriend, contactGroup, contactGroupTemp, contactGuild, convertOneBotMessageToKarin, copyConfig, copyConfigSync, copyFiles, copyFilesSync, createAccessTokenExpiredResponse, createBadRequestResponse, createDirectMessage, createForbiddenResponse, createFriendDecreaseNotice, createFriendIncreaseNotice, createFriendMessage, createGroupAdminChangedNotice, createGroupApplyRequest, createGroupCardChangedNotice, createGroupFileUploadedNotice, createGroupHlightsChangedNotice, createGroupHonorChangedNotice, createGroupInviteRequest, createGroupLuckKingNotice, createGroupMemberAddNotice, createGroupMemberBanNotice, createGroupMemberDelNotice, createGroupMemberTitleUpdatedNotice, createGroupMessage, createGroupMessageReactionNotice, createGroupPokeNotice, createGroupRecallNotice, createGroupSignInNotice, createGroupTempMessage, createGroupWholeBanNotice, createGuildMessage, createINIParser, createMethodNotAllowedResponse, createNotFoundResponse, createOneBotClient, createOneBotHttp, createOneBotWsServer, createPayloadTooLargeResponse, createPluginDir, createPrivateApplyRequest, createPrivateFileUploadedNotice, createPrivatePokeNotice, createPrivateRecallNotice, createRawMessage, createReceiveLikeNotice, createRefreshTokenExpiredResponse, createResponse, createServerErrorResponse, createSuccessResponse, createTaskDatabase, createUnauthorizedResponse, cron, db, debug, karin as default, defineConfig, disconnectAllOneBotServer, divider, downFile, downloadFile, errorToString, exec, executeTask, existToMkdir, existToMkdirSync, exists, existsSync, ffmpeg, ffplay, ffprobe, fs as file, fileToBase64, fileToUrl, fileToUrlHandlerKey, filesByExt, formatLogString, formatPath, formatTime$1 as formatTime, index$3 as fs, getAllBot, getAllBotID, getAllBotList, getAllFiles, getAllFilesSync, getBot, getBotCount, getCommit, getDefaultBranch, getFastGithub, getFastRegistry, getFileMessage, getFiles, getHash, getLocalBranches, getLocalCommitHash, getMimeType, getPackageJson, getPid, getPkgVersion, getPluginInfo, getPlugins, getRelPath, getRemoteBranches, getRemoteCommitHash, getRemotePkgVersion, getRender, getRenderCount, getRenderList, getRequestIp, getTaskCallback, getTaskDatabase, getTime, gitPull, handler$1 as handler, hooks, importModule, imports, ini, initOneBotAdapter, initTaskSystem, input, isClass, isDir, isDirSync, isDocker, isFile, isFileSync, isIPv4Loop, isIPv6Loop, isLinux, isLocalRequest, isLoopback, isMac, isPathEqual, isPlugin, isPublic, isRoot, isSubPath, isWin, json$1 as json, karin, karinToQQBot, key, killApp, lock, lockMethod, lockProp, log, logger, logs, makeForward, makeMessage, type messageType, mkdir, mkdirSync, parseChangelog, parseGithubUrl, pingRequest, pkgRoot, qqbotToKarin, raceRequest, randomStr, range, read, readFile, readJson, readJsonSync, redis, registerBot, registerRender, removeTaskCallback, render, renderHtml, renderMultiHtml, renderTpl, requireFile, requireFileSync, restart, restartDirect, rmSync, router, satisfies, save, type screenshot, segment, select, sendMsg$1 as sendMsg, sender, senderDirect, senderFriend, senderGroup, senderGroupTemp, senderGuild, sep, server, setTaskCallback, setTaskDatabase, splitPath, start, stream, stringifyError, switchComponent, index$2 as system, taskAdd, taskExists, taskGet, taskList, taskSystem, taskUpdateLogs, taskUpdateStatus, unregisterBot, unregisterRender, updateAllGitPlugin, updateAllPkg, updateGitPlugin, updatePkg, updateTaskLogs, updateTaskStatus, uptime$1 as uptime, urlToPath, waitPort, watch, watchAndMerge, write, writeJson, writeJsonSync, yaml };

package/dist/index.mjs

@@ -1960,7 +1960,49 @@ __export(changelog_exports, {
   parseChangelog: () => parseChangelog,
   range: () => range
 });
-var escapeRegex, log, logs, range, parseChangelog, normalizeStableVersion, parseSemverParts, compareSemver, findFallbackVersionKey;
+function logs(arg1, arg2, lengthParam = 1, reverseParam = false, optsParam) {
+  if (typeof lengthParam !== "number") {
+    throw new TypeError("\u63D0\u53D6\u957F\u5EA6\u5FC5\u987B\u4E3A\u6570\u5B57");
+  }
+  const isObj = typeof arg1 === "object";
+  const version2 = isObj ? arg1.version : arg1;
+  const data = isObj ? arg1.data : arg2;
+  const length = isObj ? arg1.length ?? 1 : lengthParam ?? 1;
+  const reverse = isObj ? arg1.reverse ?? false : reverseParam ?? false;
+  const compareMode = isObj ? arg1.compare ?? "xyz" : optsParam?.compare ?? "xyz";
+  const list2 = parseChangelog(data);
+  const keys = Object.keys(list2);
+  const startKey = findFallbackVersionKey(keys, version2, { compare: compareMode });
+  if (!startKey) return "";
+  const index5 = keys.indexOf(startKey);
+  const start3 = reverse ? index5 - length : index5;
+  const end = reverse ? index5 : index5 + length;
+  const sliceStart = Math.max(0, start3);
+  const sliceEnd = Math.min(keys.length, end);
+  const versions = keys.slice(sliceStart, sliceEnd).map((key) => list2[key] ? list2[key] : "");
+  return versions.join("");
+}
+function range(arg1, startVersionArg, endVersionArg, optsParam) {
+  const isObj = typeof arg1 === "object";
+  const data = isObj ? arg1.data : arg1;
+  const startVersion = isObj ? arg1.startVersion : startVersionArg;
+  const endVersion = isObj ? arg1.endVersion : endVersionArg;
+  const compareMode = isObj ? arg1.compare ?? "xyz" : optsParam?.compare ?? "xyz";
+  const list2 = parseChangelog(data);
+  const keys = Object.keys(list2);
+  const startKey = findFallbackVersionKey(keys, startVersion, { compare: compareMode });
+  const endKey = findFallbackVersionKey(keys, endVersion, { compare: compareMode });
+  if (!startKey || !endKey) return "";
+  const start3 = keys.indexOf(startKey);
+  const end = keys.indexOf(endKey);
+  if (start3 > end) {
+    const versions2 = keys.slice(end, start3).map((key) => list2[key] ? list2[key] : "");
+    return versions2.join("");
+  }
+  const versions = keys.slice(start3, end).map((key) => list2[key] ? list2[key] : "");
+  return versions.join("");
+}
+var escapeRegex, log, parseChangelog, normalizeStableVersion, parseSemverParts, compareSemver, findFallbackVersionKey, parseSemverFull, compareSemverFull, compareByMode;
 var init_changelog = __esm({
   "src/utils/fs/changelog.ts"() {
     escapeRegex = (str) => {
@@ -1972,37 +2014,6 @@ var init_changelog = __esm({
       const match = data.match(regex);
       return match ? match[0] : null;
     };
-    logs = (version2, data, length = 1, reverse = false) => {
-      if (typeof length !== "number") {
-        throw new TypeError("\u63D0\u53D6\u957F\u5EA6\u5FC5\u987B\u4E3A\u6570\u5B57");
-      }
-      const list2 = parseChangelog(data);
-      const keys = Object.keys(list2);
-      const startKey = findFallbackVersionKey(keys, version2);
-      if (!startKey) return "";
-      const index5 = keys.indexOf(startKey);
-      const start3 = reverse ? index5 - length : index5;
-      const end = reverse ? index5 : index5 + length;
-      const sliceStart = Math.max(0, start3);
-      const sliceEnd = Math.min(keys.length, end);
-      const versions = keys.slice(sliceStart, sliceEnd).map((key) => list2[key] ? list2[key] : "");
-      return versions.join("");
-    };
-    range = (data, startVersion, endVersion) => {
-      const list2 = parseChangelog(data);
-      const keys = Object.keys(list2);
-      const startKey = findFallbackVersionKey(keys, startVersion);
-      const endKey = findFallbackVersionKey(keys, endVersion);
-      if (!startKey || !endKey) return "";
-      const start3 = keys.indexOf(startKey);
-      const end = keys.indexOf(endKey);
-      if (start3 > end) {
-        const versions2 = keys.slice(end, start3).map((key) => list2[key] ? list2[key] : "");
-        return versions2.join("");
-      }
-      const versions = keys.slice(start3, end).map((key) => list2[key] ? list2[key] : "");
-      return versions.join("");
-    };
     parseChangelog = (data) => {
       const regex = /## \[(.*?)\]([\s\S]*?)(?=## \[|$)/g;
       const changelog = {};
@@ -2033,18 +2044,89 @@ var init_changelog = __esm({
       if (pa[2] !== pb[2]) return pa[2] - pb[2];
       return 0;
     };
-    findFallbackVersionKey = (keys, input2) => {
+    findFallbackVersionKey = (keys, input2, opts) => {
+      const mode = opts?.compare ?? "xyz";
       if (keys.includes(input2)) return input2;
-      const target = normalizeStableVersion(input2);
-      if (keys.includes(target)) return target;
-      for (const key of keys) {
-        const kval = normalizeStableVersion(key);
-        if (compareSemver(kval, target) <= 0) {
-          return key;
+      if (mode === "xyz") {
+        const target = normalizeStableVersion(input2);
+        if (keys.includes(target)) return target;
+        for (const key of keys) {
+          const kval = normalizeStableVersion(key);
+          if (compareByMode(kval, target, "xyz") <= 0) {
+            return key;
+          }
+        }
+        return null;
+      }
+      const parsedInput = parseSemverFull(input2);
+      if (!parsedInput) {
+        const target = normalizeStableVersion(input2);
+        if (keys.includes(target)) return target;
+        for (const key of keys) {
+          const kval = normalizeStableVersion(key);
+          if (compareByMode(kval, target, "xyz") <= 0) {
+            return key;
+          }
         }
+        return null;
+      }
+      for (const key of keys) {
+        const parsedKey = parseSemverFull(key);
+        const cmp = parsedKey ? compareSemverFull(key, input2) : compareByMode(key, input2, "xyz");
+        if (cmp <= 0) return key;
       }
       return null;
     };
+    parseSemverFull = (input2) => {
+      const core = input2.split("+")[0];
+      const m = core.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-.]+))?$/);
+      if (!m) return null;
+      const prerelease = m[4] ? m[4].split(".").map((id) => /^\d+$/.test(id) ? Number(id) : id) : null;
+      return {
+        major: Number(m[1]),
+        minor: Number(m[2]),
+        patch: Number(m[3]),
+        prerelease
+      };
+    };
+    compareSemverFull = (a, b) => {
+      const pa = parseSemverFull(a);
+      const pb = parseSemverFull(b);
+      if (!pa || !pb) return 0;
+      if (pa.major !== pb.major) return pa.major > pb.major ? 1 : -1;
+      if (pa.minor !== pb.minor) return pa.minor > pb.minor ? 1 : -1;
+      if (pa.patch !== pb.patch) return pa.patch > pb.patch ? 1 : -1;
+      const ra = pa.prerelease;
+      const rb = pb.prerelease;
+      if (!ra && !rb) return 0;
+      if (!ra && rb) return 1;
+      if (ra && !rb) return -1;
+      const len = Math.max(ra.length, rb.length);
+      for (let i = 0; i < len; i++) {
+        const ai = ra[i];
+        const bi = rb[i];
+        if (ai === void 0) return -1;
+        if (bi === void 0) return 1;
+        const aNum = typeof ai === "number";
+        const bNum = typeof bi === "number";
+        if (aNum && bNum) {
+          if (ai !== bi) return ai > bi ? 1 : -1;
+        } else if (aNum !== bNum) {
+          return aNum ? -1 : 1;
+        } else {
+          if (ai !== bi) return String(ai) > String(bi) ? 1 : -1;
+        }
+      }
+      return 0;
+    };
+    compareByMode = (a, b, mode) => {
+      if (mode === "xyz") {
+        const an = normalizeStableVersion(a);
+        const bn = normalizeStableVersion(b);
+        return compareSemver(an, bn);
+      }
+      return compareSemverFull(a, b);
+    };
   }
 });
 
@@ -11165,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) => {
@@ -11423,21 +11516,95 @@ var init_import = __esm({
     };
   }
 });
-var getPkg, checkPkgUpdate, getPkgVersion, getRemotePkgVersion, updatePkg, updateAllPkg, checkGitPluginUpdate, getCommit, getHash, getTime, updateGitPlugin, updateAllGitPlugin;
+var extractSemver, escapeRegex2, normalizeStableVersion2, parseSemver, compareSemver2, getPkg, checkPkgUpdate, getPkgVersion, getRemotePkgVersion, updatePkg, updateAllPkg, checkGitPluginUpdate, getCommit, getHash, getTime, updateGitPlugin, updateAllGitPlugin;
 var init_update = __esm({
   "src/utils/system/update.ts"() {
     init_exec();
     init_require();
     init_list();
+    extractSemver = (spec) => {
+      const m = spec.match(/\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?/);
+      return m ? m[0] : null;
+    };
+    escapeRegex2 = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    normalizeStableVersion2 = (ver) => {
+      const m = ver.match(/^(\d+)\.(\d+)\.(\d+)/);
+      return m ? m[0] : ver;
+    };
+    parseSemver = (input2) => {
+      const core = input2.split("+")[0];
+      const m = core.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-.]+))?$/);
+      if (!m) return null;
+      const prerelease = m[4] ? m[4].split(".").map((id) => /^\d+$/.test(id) ? Number(id) : id) : null;
+      return {
+        major: Number(m[1]),
+        minor: Number(m[2]),
+        patch: Number(m[3]),
+        prerelease
+      };
+    };
+    compareSemver2 = (a, b) => {
+      const pa = parseSemver(a);
+      const pb = parseSemver(b);
+      if (!pa || !pb) return 0;
+      if (pa.major !== pb.major) return pa.major > pb.major ? 1 : -1;
+      if (pa.minor !== pb.minor) return pa.minor > pb.minor ? 1 : -1;
+      if (pa.patch !== pb.patch) return pa.patch > pb.patch ? 1 : -1;
+      const ra = pa.prerelease;
+      const rb = pb.prerelease;
+      if (!ra && !rb) return 0;
+      if (!ra && rb) return 1;
+      if (ra && !rb) return -1;
+      const len = Math.max(ra.length, rb.length);
+      for (let i = 0; i < len; i++) {
+        const ai = ra[i];
+        const bi = rb[i];
+        if (ai === void 0) return -1;
+        if (bi === void 0) return 1;
+        const aNum = typeof ai === "number";
+        const bNum = typeof bi === "number";
+        if (aNum && bNum) {
+          if (ai !== bi) return ai > bi ? 1 : -1;
+        } else if (aNum !== bNum) {
+          return aNum ? -1 : 1;
+        } else {
+          if (ai !== bi) return String(ai) > String(bi) ? 1 : -1;
+        }
+      }
+      return 0;
+    };
     getPkg = (isForcibly = false) => {
       return requireFile("package.json", { force: isForcibly });
     };
-    checkPkgUpdate = async (name) => {
+    checkPkgUpdate = async (name, opts) => {
       const logger3 = global?.logger || console;
       try {
         const local = await getPkgVersion(name);
         const remote = await getRemotePkgVersion(name);
-        if (local === remote) return { status: "no", local };
+        const mode = opts?.compare ?? "xyz";
+        let noUpdate = false;
+        if (mode === "xyz") {
+          const l = normalizeStableVersion2(local);
+          const r = normalizeStableVersion2(remote);
+          const lm = parseSemver(l);
+          const rm = parseSemver(r);
+          if (lm && rm) {
+            const cmp = compareSemver2(l, r);
+            noUpdate = cmp >= 0;
+          } else {
+            noUpdate = l === r;
+          }
+        } else {
+          const pl = parseSemver(local);
+          const pr = parseSemver(remote);
+          if (pl && pr) {
+            const cmp = compareSemver2(local, remote);
+            noUpdate = cmp >= 0;
+          } else {
+            noUpdate = local === remote;
+          }
+        }
+        if (noUpdate) return { status: "no", local };
         return { status: "yes", local, remote };
       } catch (error) {
         logger3.error(error);
@@ -11451,18 +11618,24 @@ var init_update = __esm({
         if (data.includes("empty") || data.includes("extraneous")) {
           throw new Error(`\u83B7\u53D6\u5931\u8D25\uFF0C${name} \u672A\u5B89\u88C5`);
         }
-        const reg = new RegExp(`${name}@(\\d+\\.\\d+\\.\\d+)`, "gm");
-        const result = reg.exec(data);
-        if (result?.[1]) return result[1];
+        const esc = escapeRegex2(name);
+        const reg = new RegExp(`${esc}@([0-9A-Za-z-.+]+)`, "gm");
+        const match = reg.exec(data);
+        if (match?.[1]) {
+          return match[1].trim();
+        }
       }
       if (error) {
-        if (error?.stack?.toString().includes("empty") || error?.stack?.toString().includes("extraneous")) {
+        const stack = error?.stack?.toString() || "";
+        if (stack.includes("empty") || stack.includes("extraneous")) {
           throw new Error(`\u83B7\u53D6\u5931\u8D25\uFF0C${name} \u672A\u5B89\u88C5`);
         }
         throw error;
       }
       const pkg2 = await getPkg();
-      return pkg2?.dependencies?.[name] || pkg2?.devDependencies?.[name] || pkg2?.peerDependencies?.[name];
+      const spec = pkg2?.dependencies?.[name] || pkg2?.devDependencies?.[name] || pkg2?.peerDependencies?.[name];
+      if (!spec) return "";
+      return extractSemver(spec) || spec;
     };
     getRemotePkgVersion = async (name, tag = "latest") => {
       const cmd = tag === "latest" ? `npm show ${name} version` : `npm show ${name} dist-tags.${tag}`;
@@ -12551,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"() {
@@ -12561,6 +12829,7 @@ var init_list = __esm({
     init_path();
     init_env3();
     init_require();
+    init_versionCheck();
     isInit = true;
     cache5 = {
       list: void 0,
@@ -12724,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}`);
     };
@@ -12769,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([
@@ -22188,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 = () => {
@@ -22563,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 {
@@ -22590,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.1",
+  "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",