@yunzai-ng/core 0.1.0

package/dist/plugin/define.js

@@ -0,0 +1,82 @@
+/**
+ * 插件名合法形式
+ *
+ * 与配置名规则保持一致（见 config/store.ts）：插件名直接就是
+ * `config/<name>.yaml` 的文件名。额外排除了 `:`（KV 命名空间分隔符）
+ * 与路径分隔符，否则一个插件能读写别人的命名空间。
+ */
+const NAME_RE = /^[a-z][a-z0-9._-]*$/i;
+/** 标记"这是 definePlugin 的产物"，用于加载时校验默认导出 */
+const BRAND = Symbol.for("yunzai-ng.plugin");
+/**
+ * 声明一个插件
+ *
+ * @param input 插件定义
+ * @returns 供内核加载的插件定义（已冻结）
+ * @throws 插件名缺失/非法、`setup` 不是函数、依赖项写法错误时
+ * @example
+ * ```ts
+ * export default definePlugin({
+ *   name: "mhy-game",
+ *   configSchema: s.object({ cookie: s.string().default("") }),
+ *   setup(ctx) {
+ *     ctx.command("#体力").desc("查询实时便笺").action(async e => {
+ *       await e.reply(ctx.config.get().cookie ? "查询中" : "请先配置 cookie")
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export function definePlugin(input) {
+    if (typeof input?.name !== "string" || input.name.length === 0) {
+        throw new Error("definePlugin：缺少 name，插件必须有名字");
+    }
+    if (!NAME_RE.test(input.name)) {
+        throw new Error(`definePlugin：插件名 ${input.name} 不合法。需以字母开头，只含字母、数字与 . - _（它同时是配置文件名与存储命名空间）`);
+    }
+    if (typeof input.setup !== "function") {
+        throw new Error(`definePlugin：插件 ${input.name} 缺少 setup 函数`);
+    }
+    if (input.dependencies && !Array.isArray(input.dependencies)) {
+        throw new Error(`definePlugin：插件 ${input.name} 的 dependencies 必须是字符串数组`);
+    }
+    for (const dep of input.dependencies ?? []) {
+        if (typeof dep !== "string" || dep.length === 0) {
+            throw new Error(`definePlugin：插件 ${input.name} 的 dependencies 含空项`);
+        }
+        if (dep === input.name) {
+            throw new Error(`definePlugin：插件 ${input.name} 依赖了自己`);
+        }
+    }
+    if (input.priority !== undefined && !Number.isFinite(input.priority)) {
+        throw new Error(`definePlugin：插件 ${input.name} 的 priority 必须是数字`);
+    }
+    // 浅冻结：防止插件在运行期改自己的元信息（改了内核也不会重新读，只会造成困惑）
+    return Object.freeze({ ...input, [BRAND]: true });
+}
+/**
+ * 判断一个值是否 `definePlugin` 的产物
+ *
+ * 加载器用它区分"插件写错了默认导出"和"插件确实是插件"，
+ * 从而给出"请用 definePlugin 包一层"这种能直接照做的提示。
+ * @param value 待判定值
+ * @returns 是否为插件定义
+ */
+export function isPluginDefinition(value) {
+    return typeof value === "object" && value !== null && value[BRAND] === true;
+}
+/**
+ * 宽松判定：像插件定义但可能没走 `definePlugin`
+ *
+ * 允许手写对象（如测试里的假插件、compat 插件动态生成的定义），
+ * 只要有 name 与 setup 就接受，但加载器会记一条 debug 提示。
+ * @param value 待判定值
+ * @returns 是否可当作插件定义使用
+ */
+export function looksLikePlugin(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    return typeof obj.name === "string" && typeof obj.setup === "function";
+}
+//# sourceMappingURL=define.js.map

package/dist/plugin/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/plugin/define.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,sBAAsB,CAAA;AAEtC,0CAA0C;AAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;AAsC5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA2B;IAE3B,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,IAAI,8CAA8C,CAAC,CAAA;IAC/F,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,cAAc,CAAC,CAAA;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,0BAA0B,CAAC,CAAA;IAC1E,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,qBAAqB,CAAC,CAAA;QACrE,CAAC;QACD,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAA;IACnE,CAAC;IAED,yCAAyC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAA6C,CAAA;AAC/F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAiC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;AAC1G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,GAAG,GAAG,KAAkC,CAAA;IAC9C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,CAAA;AACxE,CAAC"}

package/dist/plugin/discover.d.ts

@@ -0,0 +1,106 @@
+import type { Logger } from "@yunzai-ng/types";
+/** package.json 里与本框架相关的字段 */
+interface PackageManifest {
+    /** npm 包名 */
+    name?: string;
+    /** 版本 */
+    version?: string;
+    /** 说明 */
+    description?: string;
+    /** 作者，可能是字符串或对象 */
+    author?: string | {
+        name?: string;
+    };
+    /** 主页 */
+    homepage?: string;
+    /** 入口 */
+    main?: string;
+    /** 模块入口 */
+    module?: string;
+    /** exports 映射（只认 `"."`） */
+    exports?: unknown;
+    /** 框架专属字段，用于不执行代码就能读到的信息 */
+    yunzai?: {
+        /** 覆盖插件名 */
+        name?: string;
+        /** 是否禁用 */
+        disabled?: boolean;
+        /** 入口文件 */
+        entry?: string;
+    };
+}
+/** 一个待加载的插件候选 */
+export interface PluginCandidate {
+    /**
+     * 名字线索（目录名或包名）
+     *
+     * 真正的插件名以 `definePlugin({ name })` 为准；这个只用于导入失败时的日志，
+     * 因为那时候还读不到定义。
+     */
+    id: string;
+    /** 插件根目录绝对路径 */
+    dir: string;
+    /** 入口文件绝对路径 */
+    entry: string;
+    /** 是否为随发行版预置的插件 */
+    builtin: boolean;
+    /** package.json 内容（若有） */
+    manifest?: PackageManifest;
+}
+/** 被跳过的插件及原因 */
+export interface SkippedPlugin {
+    /** 插件名 */
+    name: string;
+    /** 跳过原因（直接展示给用户，必须能照着解决） */
+    reason: string;
+}
+/** 发现插件的参数 */
+export interface DiscoverOptions {
+    /** 要扫描的目录（绝对路径），按顺序扫描，先出现者优先 */
+    dirs: string[];
+    /** 其中属于"内置"的目录，用于给候选打 builtin 标记 */
+    builtinDirs?: string[];
+    /** 用户在配置里禁用的插件名 */
+    disabled?: readonly string[];
+    /** 日志器 */
+    logger: Logger;
+}
+/**
+ * 发现全部插件
+ *
+ * 同名插件只保留先扫到的那份（目录顺序即优先级），并记一条警告 ——
+ * 用户插件目录排在预置目录之前，因此复制一份预置插件加以修改即可覆盖原插件。
+ * @param opts 参数
+ * @returns 候选数组
+ */
+export declare function discoverPlugins(opts: DiscoverOptions): Promise<PluginCandidate[]>;
+/** 参与排序所需的最小信息 */
+export interface OrderableUnit {
+    /** 插件名 */
+    name: string;
+    /** 依赖的插件名 */
+    dependencies?: string[];
+    /** 优先级，小者先加载 */
+    priority?: number;
+}
+/** 排序结果 */
+export interface LoadOrder<T extends OrderableUnit> {
+    /** 可加载的插件，已按依赖与优先级排好 */
+    order: T[];
+    /** 被跳过的插件 */
+    skipped: SkippedPlugin[];
+}
+/**
+ * 规划加载顺序
+ *
+ * 三步：去重 → 剔除依赖不可满足者（级联）→ 拓扑排序。
+ *
+ * 排序在同层节点之间以 `(priority, name)` 作**确定性**排序：
+ * 同一份插件集合在任何机器上都得到相同顺序，否则"甲机器正常、乙机器异常"
+ * 这类问题会耗费大量排障时间。
+ * @param units 待排序的插件定义
+ * @returns 顺序与跳过列表
+ */
+export declare function resolveLoadOrder<T extends OrderableUnit>(units: readonly T[]): LoadOrder<T>;
+export {};
+//# sourceMappingURL=discover.d.ts.map

package/dist/plugin/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/plugin/discover.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkB9C,8BAA8B;AAC9B,UAAU,eAAe;IACvB,aAAa;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS;IACT,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,SAAS;IACT,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4BAA4B;IAC5B,MAAM,CAAC,EAAE;QACP,YAAY;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW;QACX,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW;QACX,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,iBAAiB;AACjB,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAkHD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA0BvF;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,WAAW;AACX,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,aAAa;IAChD,wBAAwB;IACxB,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,aAAa;IACb,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CA2E3F"}

package/dist/plugin/discover.js

@@ -0,0 +1,254 @@
+/**
+ * 模块职责：发现磁盘上的插件、解析入口、规划加载顺序
+ * 依赖方向：依赖 util/fs、类型包；不 import 任何插件
+ * 生命周期：每次全量加载/热重载时调用
+ * 注意事项：**顺序规划与文件发现分离**是这里的关键：先把候选文件找出来 → 全部 import
+ *          拿到声明式元信息 → 用依赖图算出确定顺序 → 再按序 setup。加载顺序由声明的
+ *          依赖决定，而非文件名字典序。
+ *
+ *          依赖缺失**不连坐内核**：只把依赖它的插件标记为跳过，其余照常工作。
+ */
+import { basename, isAbsolute, join, resolve } from "node:path";
+import { isDirectory, isFile, listDirs, listFiles, readJson } from "../util/fs.js";
+/**
+ * 本进程是否运行在 TypeScript 源码模式
+ *
+ * 通过"本模块自身是否 .ts"判断：vitest / tsx 下为真，编译产物下为假。
+ * 为真时才把 `src/index.ts` 当作合法入口，否则一个没编译的插件会以
+ * "Unknown file extension .ts" 这种毫无指向性的错误失败。
+ */
+const TS_RUNTIME = import.meta.url.endsWith(".ts");
+/** 依次尝试的入口文件（相对插件目录） */
+const ENTRY_CANDIDATES = ["dist/index.js", "index.js", "index.mjs", "lib/index.js"];
+/** 单文件插件允许的扩展名 */
+const SINGLE_FILE_EXT = [".js", ".mjs"];
+/**
+ * 解析 package.json 的入口字段
+ *
+ * 只认 `exports["."]` 的字符串形式与 `import`/`default` 条件；再复杂的条件导出
+ * 交给 Node 自己解析（此时返回 undefined，由调用方回落到目录导入）。
+ * @param manifest package.json 内容
+ * @returns 相对路径；无法确定时 undefined
+ */
+function entryFromManifest(manifest) {
+    if (manifest.yunzai?.entry)
+        return manifest.yunzai.entry;
+    const exp = manifest.exports;
+    if (typeof exp === "string")
+        return exp;
+    if (exp && typeof exp === "object") {
+        const dot = exp["."];
+        if (typeof dot === "string")
+            return dot;
+        if (dot && typeof dot === "object") {
+            const cond = dot;
+            for (const key of ["import", "module", "default"]) {
+                const value = cond[key];
+                if (typeof value === "string")
+                    return value;
+            }
+        }
+    }
+    return manifest.module ?? manifest.main;
+}
+/**
+ * 在插件目录里找入口文件
+ * @param dir 插件目录
+ * @param manifest package.json 内容
+ * @returns 入口绝对路径；找不到时 undefined
+ */
+async function resolveEntry(dir, manifest) {
+    const declared = manifest ? entryFromManifest(manifest) : undefined;
+    if (declared) {
+        const full = resolve(dir, declared);
+        if (await isFile(full))
+            return full;
+    }
+    const candidates = TS_RUNTIME ? [...ENTRY_CANDIDATES, "src/index.ts", "index.ts"] : ENTRY_CANDIDATES;
+    for (const rel of candidates) {
+        const full = join(dir, rel);
+        if (await isFile(full))
+            return full;
+    }
+    return undefined;
+}
+/**
+ * 取插件名线索
+ *
+ * 优先 `yunzai.name`，其次去掉 scope 的包名，最后目录名。
+ * @param dir 插件目录
+ * @param manifest package.json 内容
+ * @returns 名字线索
+ */
+function idOf(dir, manifest) {
+    const explicit = manifest?.yunzai?.name;
+    if (explicit)
+        return explicit;
+    const pkg = manifest?.name;
+    if (pkg)
+        return pkg.startsWith("@") ? (pkg.split("/")[1] ?? pkg) : pkg;
+    return basename(dir);
+}
+/**
+ * 扫描一个目录下的全部插件
+ * @param root 要扫描的目录
+ * @param builtin 是否标记为内置
+ * @param logger 日志器
+ * @returns 候选数组
+ */
+async function scanDir(root, builtin, logger) {
+    if (!(await isDirectory(root)))
+        return [];
+    const out = [];
+    for (const name of await listDirs(root)) {
+        // `.` 开头是隐藏目录，`_` 开头约定为"作者临时禁用"，node_modules 不用说
+        if (name.startsWith(".") || name.startsWith("_") || name === "node_modules")
+            continue;
+        const dir = join(root, name);
+        const manifest = await readJson(join(dir, "package.json"));
+        if (manifest?.yunzai?.disabled) {
+            logger.debug(`插件目录 ${name} 在 package.json 里自我标记为 disabled，跳过`);
+            continue;
+        }
+        const entry = await resolveEntry(dir, manifest);
+        if (!entry) {
+            logger.warn(`插件目录 ${name} 里找不到入口文件：请提供 ${ENTRY_CANDIDATES.join(" / ")} 之一，` +
+                `或在 package.json 的 main / yunzai.entry 里指明。若是 TypeScript 插件，请先编译`);
+            continue;
+        }
+        out.push({ id: idOf(dir, manifest), dir, entry, builtin, manifest });
+    }
+    // 顶层单文件插件：plugins/我的小功能.js。给"就想加个几十行小功能"的用户留的口子，
+    // 不必为此建目录和 package.json
+    for (const ext of SINGLE_FILE_EXT) {
+        for (const file of await listFiles(root, ext)) {
+            const name = basename(file, ext);
+            if (name.startsWith(".") || name.startsWith("_"))
+                continue;
+            out.push({ id: name, dir: root, entry: join(root, file), builtin });
+        }
+    }
+    return out;
+}
+/**
+ * 发现全部插件
+ *
+ * 同名插件只保留先扫到的那份（目录顺序即优先级），并记一条警告 ——
+ * 用户插件目录排在预置目录之前，因此复制一份预置插件加以修改即可覆盖原插件。
+ * @param opts 参数
+ * @returns 候选数组
+ */
+export async function discoverPlugins(opts) {
+    const builtin = new Set((opts.builtinDirs ?? []).map(dir => resolve(dir)));
+    const disabled = new Set(opts.disabled ?? []);
+    const seen = new Map();
+    for (const raw of opts.dirs) {
+        if (!isAbsolute(raw)) {
+            opts.logger.warn(`插件目录 ${raw} 不是绝对路径，已忽略（相对路径会随启动方式变化）`);
+            continue;
+        }
+        const dir = resolve(raw);
+        for (const candidate of await scanDir(dir, builtin.has(dir), opts.logger)) {
+            if (disabled.has(candidate.id)) {
+                opts.logger.info(`插件 ${candidate.id} 已被用户禁用，跳过`);
+                continue;
+            }
+            const exists = seen.get(candidate.id);
+            if (exists) {
+                opts.logger.warn(`发现同名插件 ${candidate.id}：使用 ${exists.dir}，忽略 ${candidate.dir}`);
+                continue;
+            }
+            seen.set(candidate.id, candidate);
+        }
+    }
+    return [...seen.values()];
+}
+/** 默认加载优先级 */
+const DEFAULT_PRIORITY = 100;
+/**
+ * 规划加载顺序
+ *
+ * 三步：去重 → 剔除依赖不可满足者（级联）→ 拓扑排序。
+ *
+ * 排序在同层节点之间以 `(priority, name)` 作**确定性**排序：
+ * 同一份插件集合在任何机器上都得到相同顺序，否则"甲机器正常、乙机器异常"
+ * 这类问题会耗费大量排障时间。
+ * @param units 待排序的插件定义
+ * @returns 顺序与跳过列表
+ */
+export function resolveLoadOrder(units) {
+    const skipped = [];
+    const byName = new Map();
+    for (const unit of units) {
+        if (byName.has(unit.name)) {
+            skipped.push({ name: unit.name, reason: `插件名 ${unit.name} 重复，只加载第一个` });
+            continue;
+        }
+        byName.set(unit.name, unit);
+    }
+    // 级联剔除：A 依赖 B，B 因缺依赖被剔除，A 也留不住
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const [name, unit] of byName) {
+            const missing = (unit.dependencies ?? []).filter(dep => !byName.has(dep));
+            if (missing.length === 0)
+                continue;
+            byName.delete(name);
+            skipped.push({
+                name,
+                reason: `依赖的插件未安装或已被跳过：${missing.join("、")}。装上它们或删掉本插件的依赖声明`
+            });
+            changed = true;
+        }
+    }
+    /** 同层排序：优先级小者先，其次名字字典序 */
+    const compare = (a, b) => {
+        const pa = a.priority ?? DEFAULT_PRIORITY;
+        const pb = b.priority ?? DEFAULT_PRIORITY;
+        return pa !== pb ? pa - pb : a.name.localeCompare(b.name);
+    };
+    // Kahn：indegree 为"还有几个依赖没就绪"
+    const indegree = new Map();
+    const dependents = new Map();
+    for (const [name, unit] of byName) {
+        const deps = (unit.dependencies ?? []).filter(dep => byName.has(dep));
+        indegree.set(name, deps.length);
+        for (const dep of deps) {
+            const list = dependents.get(dep);
+            if (list)
+                list.push(name);
+            else
+                dependents.set(dep, [name]);
+        }
+    }
+    const ready = [...byName.values()].filter(unit => indegree.get(unit.name) === 0).sort(compare);
+    const order = [];
+    while (ready.length > 0) {
+        const unit = ready.shift();
+        order.push(unit);
+        for (const name of dependents.get(unit.name) ?? []) {
+            const left = (indegree.get(name) ?? 0) - 1;
+            indegree.set(name, left);
+            if (left !== 0)
+                continue;
+            const next = byName.get(name);
+            if (!next)
+                continue;
+            // 插进有序位置，保持"每次取出的都是当前可加载里最该先加载的那个"
+            const at = ready.findIndex(item => compare(item, next) > 0);
+            if (at < 0)
+                ready.push(next);
+            else
+                ready.splice(at, 0, next);
+        }
+    }
+    if (order.length !== byName.size) {
+        const loop = [...byName.keys()].filter(name => (indegree.get(name) ?? 0) > 0).sort();
+        for (const name of loop) {
+            skipped.push({ name, reason: `插件依赖成环，无法确定加载顺序：${loop.join(" → ")}` });
+        }
+    }
+    return { order, skipped };
+}
+//# sourceMappingURL=discover.js.map

package/dist/plugin/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/plugin/discover.ts"],"names":[],"mappings":"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"}

package/dist/plugin/events.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 模块职责：内核事件总线（`ctx.on` 的实现）
+ * 依赖方向：依赖 util/defer、类型包
+ * 生命周期：应用级单例
+ * 注意事项：刻意不使用 Node 的 EventEmitter，原因有三 ——
+ *
+ *          1) **错误隔离**。EventEmitter 中一个监听器抛错即中断整条 emit 链，
+ *             其后的监听器收不到事件；异步监听器抛错更会转为
+ *             unhandledRejection 直接终止进程 —— 一个插件的缺陷便影响全部插件。
+ *          2) **可等待异步监听器**。`app/stopping` 必须等待插件保存完状态方可继续
+ *             停机，而 EventEmitter 不 await 返回的 Promise。
+ *          3) **可按插件归属批量摘除**，且每次订阅均返回 Disposer，
+ *             热重载不残留悬空监听器。
+ *
+ *          单个监听器超时（缺省 10s）会被**放弃等待**并记录警告：无法真正终止它，
+ *          但绝不使一个阻塞的插件永久阻止停机流程完成。
+ */
+import type { Awaitable, Disposer, Logger } from "@yunzai-ng/types";
+import type { CoreEventMap } from "@yunzai-ng/types";
+/** 事件总线参数 */
+export interface EventBusOptions {
+    /** 日志器 */
+    logger: Logger;
+    /** 单个监听器等待上限毫秒，缺省 10000；<=0 表示不限时 */
+    handlerTimeout?: number;
+}
+/** 监听器的对外描述 */
+export interface ListenerInfo {
+    /** 事件名 */
+    event: string;
+    /** 归属插件 */
+    owner: string;
+    /** 触发次数 */
+    calls: number;
+}
+/**
+ * 内核事件总线
+ *
+ * 键类型来自 `CoreEventMap`，因此 `ctx.on("bot/online", bot => ...)` 里
+ * `bot` 的类型是自动推出来的，写错事件名编译期就报错。
+ */
+export declare class CoreEventBus {
+    #private;
+    /**
+     * @param opts 参数
+     */
+    constructor(opts: EventBusOptions);
+    /**
+     * 订阅事件
+     * @param event 事件名
+     * @param fn 处理函数
+     * @param owner 归属插件名
+     * @returns 取消订阅句柄；重复调用无副作用
+     */
+    on<K extends keyof CoreEventMap>(event: K, fn: (...args: CoreEventMap[K]) => Awaitable<void>, owner?: string): Disposer;
+    /**
+     * 订阅一次
+     * @param event 事件名
+     * @param fn 处理函数
+     * @param owner 归属插件名
+     * @returns 取消订阅句柄
+     */
+    once<K extends keyof CoreEventMap>(event: K, fn: (...args: CoreEventMap[K]) => Awaitable<void>, owner?: string): Disposer;
+    /**
+     * 触发事件并等待全部监听器结束
+     *
+     * 监听器按注册顺序**同时启动**（而非串行），因为它们之间不应有依赖关系；
+     * 谁想要顺序保证就该用服务依赖或中间件优先级表达，而不是偷偷依赖注册顺序。
+     * @param event 事件名
+     * @param args 事件参数
+     * @returns 全部监听器结束（或超时被放弃）后兑现；本身永不拒绝
+     */
+    emit<K extends keyof CoreEventMap>(event: K, ...args: CoreEventMap[K]): Promise<void>;
+    /**
+     * 触发事件但不等待
+     *
+     * 用于消息统计一类"通知即可"的场景：绝不能让某个插件的统计逻辑拖慢
+     * 消息处理主链路。错误照样被记录。
+     * @param event 事件名
+     * @param args 事件参数
+     */
+    emitDetached<K extends keyof CoreEventMap>(event: K, ...args: CoreEventMap[K]): void;
+    /**
+     * 某事件当前的监听器数量
+     * @param event 事件名
+     * @returns 数量
+     */
+    count<K extends keyof CoreEventMap>(event: K): number;
+    /**
+     * 摘除某插件的全部监听器
+     * @param owner 插件名
+     * @returns 摘除的数量
+     */
+    removeByOwner(owner: string): number;
+    /**
+     * 列出全部监听器
+     * @returns 描述数组
+     */
+    list(): ListenerInfo[];
+    /** 清空全部监听器并停止接受事件 */
+    close(): void;
+}
+/**
+ * 创建事件总线
+ * @param opts 参数
+ * @returns 总线实例
+ */
+export declare function createEventBus(opts: EventBusOptions): CoreEventBus;
+//# sourceMappingURL=events.d.ts.map

package/dist/plugin/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/plugin/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAkBpD,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,qBAAa,YAAY;;IAUvB;;OAEG;gBACS,IAAI,EAAE,eAAe;IAKjC;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAC7B,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,EACjD,KAAK,SAAS,GACb,QAAQ;IAIX;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAC/B,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,EACjD,KAAK,SAAS,GACb,QAAQ;IAIX;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3F;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAUpF;;;;OAIG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAIrD;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAWpC;;;OAGG;IACH,IAAI,IAAI,YAAY,EAAE;IAQtB,qBAAqB;IACrB,KAAK,IAAI,IAAI;CA4Ed;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,YAAY,CAElE"}