@yunzai-ng/core 0.1.0

package/dist/pipeline/router.js

@@ -0,0 +1,489 @@
+/** 缺省优先级 */
+const DEFAULT_PRIORITY = 100;
+/** 正则里不能当字面前缀的字符 */
+const REGEX_META = new Set([".", "*", "+", "?", "(", ")", "[", "]", "{", "}", "|", "$", "^"]);
+/** 会让前一个字符变成"可选"的量词，出现即无法据此分桶 */
+const OPTIONAL_QUANTIFIER = new Set(["?", "*"]);
+/**
+ * 取字符串模式的分桶键
+ * @param pattern 字符串模式
+ * @returns 首字符
+ */
+function keyOfString(pattern) {
+    return [...pattern][0] ?? "";
+}
+/**
+ * 尝试从正则里提取可分桶的字面首字符
+ *
+ * 只在**能证明**"命中必然以该字符开头"时才返回，宁可放弃优化也不能漏匹配。
+ * 放弃的情形：
+ * - 没有 `^` 锚定 —— 可以从任意位置命中
+ * - `m` 标志 —— `^` 也匹配行首，消息第二行开头也算命中，首字符判断不成立
+ * - `i` 标志且首字符是 ASCII 字母 —— 大小写两个桶，不值当
+ * - 首字符是元字符、字符类（`\d`）、或后面跟着 `?`/`*` 等可选量词
+ * @param re 正则
+ * @returns 分桶键；无法提取时 undefined
+ */
+function keyOfRegExp(re) {
+    if (re.flags.includes("m"))
+        return undefined;
+    const src = re.source;
+    if (!src.startsWith("^"))
+        return undefined;
+    let literal;
+    let after;
+    const first = src[1];
+    if (first === undefined)
+        return undefined;
+    if (first === "\\") {
+        const escaped = src[2];
+        if (escaped === undefined)
+            return undefined;
+        // `\d` / `\w` / `\s` / `\b` 这类是字符类或断言，不是字面量
+        if (/[a-zA-Z0-9]/.test(escaped))
+            return undefined;
+        literal = escaped;
+        after = 3;
+    }
+    else if (REGEX_META.has(first)) {
+        return undefined;
+    }
+    else {
+        literal = first;
+        after = 2;
+    }
+    const next = src[after];
+    if (next !== undefined && OPTIONAL_QUANTIFIER.has(next))
+        return undefined;
+    // `{0,3}` 也让首字符可选；`{2}` 不会，但区分成本高于收益，一律放弃
+    if (next === "{")
+        return undefined;
+    if (re.flags.includes("i") && /[a-zA-Z]/.test(literal))
+        return undefined;
+    return literal;
+}
+/**
+ * 去掉正则的有状态标志
+ *
+ * `g` 与 `y` 会让 `exec` 推进 `lastIndex`：同一个正则对象在第二条消息上
+ * 会从上次结束的位置开始找，表现为"命令只灵一次"。这类 bug 极难排查，
+ * 因此在注册时就消灭掉，并告知插件作者。
+ * @param re 原始正则
+ * @param label 日志用的命令标识
+ * @param logger 日志器
+ * @returns 无状态标志的正则
+ */
+function stripStatefulFlags(re, label, logger) {
+    if (!re.flags.includes("g") && !re.flags.includes("y"))
+        return re;
+    const flags = re.flags.replace(/[gy]/g, "");
+    logger.warn(`命令 ${label} 的正则带 g/y 标志，已自动去除：这两个标志会让匹配位置在消息之间残留`);
+    return new RegExp(re.source, flags);
+}
+/**
+ * 编译一个模式
+ * @param pattern 原始模式
+ * @param opts 命令选项（`anywhere` 影响字符串匹配方式）
+ * @param label 日志用的命令标识
+ * @param logger 日志器
+ * @returns 编译结果
+ * @throws 字符串模式为空时
+ */
+function compile(pattern, opts, label, logger) {
+    if (typeof pattern === "string") {
+        if (pattern === "")
+            throw new Error(`命令 ${label} 的字符串模式不能为空：空串会匹配所有消息`);
+        if (opts.anywhere === true) {
+            return {
+                label: pattern,
+                // anywhere 的触发词可以出现在任何位置，首字符判断不成立
+                key: undefined,
+                match: text => {
+                    const at = text.indexOf(pattern);
+                    if (at < 0)
+                        return undefined;
+                    return {
+                        pattern,
+                        trigger: pattern,
+                        rest: text.slice(at + pattern.length).trim(),
+                        groups: {},
+                        captures: [pattern]
+                    };
+                }
+            };
+        }
+        return {
+            label: pattern,
+            key: keyOfString(pattern),
+            match: text => {
+                if (!text.startsWith(pattern))
+                    return undefined;
+                return {
+                    pattern,
+                    trigger: pattern,
+                    rest: text.slice(pattern.length).trim(),
+                    groups: {},
+                    captures: [pattern]
+                };
+            }
+        };
+    }
+    const re = stripStatefulFlags(pattern, label, logger);
+    return {
+        label: re.source,
+        key: keyOfRegExp(re),
+        match: text => {
+            const m = re.exec(text);
+            if (m === null)
+                return undefined;
+            const whole = m[0];
+            return {
+                pattern: re.source,
+                trigger: whole,
+                rest: text.slice(m.index + whole.length).trim(),
+                groups: m.groups ?? {},
+                // 捕获组可能不参与匹配（`(a)|(b)`），undefined 统一成空串，
+                // 免得插件里到处写 `captures[1] ?? ""`
+                captures: Array.from(m, v => v ?? "")
+            };
+        }
+    };
+}
+/**
+ * 比较两个条目的匹配顺序
+ * @param a 条目 a
+ * @param b 条目 b
+ * @returns 排序结果
+ */
+function byPriority(a, b) {
+    const pa = a.reg.options.priority ?? DEFAULT_PRIORITY;
+    const pb = b.reg.options.priority ?? DEFAULT_PRIORITY;
+    return pa !== pb ? pa - pb : a.seq - b.seq;
+}
+/**
+ * 把一项按序插入已排序数组
+ *
+ * 注册是低频操作、匹配是高频操作，因此把排序成本挪到注册时，
+ * 让匹配路径上一次 sort 都不做。
+ * @param list 已排序数组（就地修改）
+ * @param entry 待插入条目
+ */
+function insertSorted(list, entry) {
+    let lo = 0;
+    let hi = list.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        // 断言安全：mid < hi <= length
+        if (byPriority(list[mid], entry) <= 0)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    list.splice(lo, 0, entry);
+}
+/**
+ * 判断事件场景是否落在命令声明的范围内
+ * @param opts 命令选项
+ * @param scene 事件场景
+ * @returns 是否允许
+ */
+function sceneAllowed(opts, scene) {
+    const want = opts.scene;
+    if (want === undefined)
+        return true;
+    return Array.isArray(want) ? want.includes(scene) : want === scene;
+}
+/**
+ * 命令路由器
+ *
+ * 既是 `ctx.command()` 的落点（`CommandSink`），也是消息管线的查询入口
+ * （`match()`），还是 WebUI 的数据来源（`list()`）。
+ */
+export class CommandRouter {
+    /** 日志器 */
+    #logger;
+    /** 命令禁用判定 */
+    #isDisabled;
+    /** 登记 → 条目 */
+    #entries = new Map();
+    /** 首字符 → 已排序的条目数组 */
+    #buckets = new Map();
+    /** 无法分桶、每条消息都要试的条目（已排序） */
+    #unbucketed = [];
+    /** 注册序号发号器 */
+    #seq = 0;
+    /**
+     * @param opts 构造参数
+     */
+    constructor(opts) {
+        this.#logger = opts.logger;
+        this.#isDisabled = opts.isDisabled ?? (() => false);
+    }
+    /** 已注册的命令条数 */
+    get size() {
+        return this.#entries.size;
+    }
+    /**
+     * 登记一条命令
+     *
+     * 不会抛错：单个模式编译失败（如空串）只落一条 error 日志并跳过该模式，
+     * 其余别名照旧可用 —— 一条命令的一个别名写错不该让插件装不上。
+     * @param reg 登记内容
+     * @returns 注销句柄
+     */
+    register(reg) {
+        if (this.#entries.has(reg))
+            return () => this.#remove(reg);
+        const entry = { reg, seq: this.#seq++, compiled: [] };
+        entry.compiled = this.#compileAll(reg);
+        this.#entries.set(reg, entry);
+        this.#index(entry);
+        return () => this.#remove(reg);
+    }
+    /**
+     * 模式变化后重建索引
+     *
+     * 链式构造器的 `.alias()` 会往 `reg.patterns` 里塞新模式。整条重建而不是
+     * 增量追加：别名极少，而增量逻辑要处理"旧键还在不在别的模式里用"这种
+     * 引用计数问题，不值得。
+     * @param reg 登记内容
+     */
+    reindex(reg) {
+        const entry = this.#entries.get(reg);
+        if (entry === undefined)
+            return;
+        this.#unindex(entry);
+        entry.compiled = this.#compileAll(reg);
+        this.#index(entry);
+    }
+    /**
+     * 找出该消息命中的全部命令，按匹配顺序排列
+     *
+     * 只做**模式匹配**与**零成本的静态过滤**（禁用、场景、@我、权限）。
+     * 冷却是异步的、要写 KV，且命中后才该计费，因此留给 dispatch。
+     * @param e 消息事件
+     * @returns 候选数组；无命中时为空数组
+     */
+    match(e) {
+        const candidates = this.#candidates(e.text);
+        if (candidates.length === 0)
+            return [];
+        const out = [];
+        for (const entry of candidates) {
+            const { reg } = entry;
+            if (reg.handler === undefined)
+                continue;
+            if (this.#isDisabled(reg))
+                continue;
+            if (!sceneAllowed(reg.options, e.scene))
+                continue;
+            // 机器人自己发的消息：全局 bot.ignoreSelf 为 false 时事件才会走到这里，
+            // 但单条命令仍然默认不响应自己 —— 否则一个"复读"类命令会自我触发成死循环
+            if (reg.options.ignoreSelf !== false && e.sender.uid === e.selfId)
+                continue;
+            // 群聊要求 @ 机器人；私聊天然算"对我说话"
+            if (reg.options.atMe === true && e.isGroup && !e.atMe)
+                continue;
+            if (reg.options.master === true && !e.isMaster)
+                continue;
+            // 主人不受群管限制：否则主人在自己不是管理员的群里连管理命令都用不了
+            if (reg.options.admin === true && !e.isGroupAdmin && !e.isMaster)
+                continue;
+            for (const pattern of entry.compiled) {
+                const hit = pattern.match(e.text);
+                if (hit === undefined)
+                    continue;
+                out.push({
+                    reg,
+                    match: {
+                        name: this.#nameOf(entry),
+                        pattern: hit.pattern,
+                        trigger: hit.trigger,
+                        rest: hit.rest,
+                        groups: hit.groups,
+                        captures: hit.captures,
+                        plugin: reg.plugin
+                    }
+                });
+                // 同一条命令的多个别名只算一次命中
+                break;
+            }
+        }
+        return out;
+    }
+    /**
+     * 导出全部命令描述
+     * @returns 命令描述数组，按匹配顺序
+     */
+    list() {
+        const all = [...this.#entries.values()].sort(byPriority);
+        return all.map(entry => {
+            const { options: o, plugin } = entry.reg;
+            const info = {
+                name: this.#nameOf(entry),
+                patterns: entry.compiled.map(p => p.label),
+                plugin,
+                master: o.master === true,
+                admin: o.admin === true,
+                hidden: o.hidden === true,
+                disabled: this.#isDisabled(entry.reg)
+            };
+            if (o.desc !== undefined)
+                info.desc = o.desc;
+            if (o.usage !== undefined)
+                info.usage = o.usage;
+            if (o.group !== undefined)
+                info.group = o.group;
+            return info;
+        });
+    }
+    /**
+     * 摘除某插件的全部命令
+     *
+     * 插件卸载时上下文会逐条调用 Disposer，此处为兜底：若存在未经 ctx 的登记
+     *（例如插件 setup 中途抛错），亦不会留下悬空命令。
+     * @param plugin 插件名
+     * @returns 摘除的条数
+     */
+    removePlugin(plugin) {
+        let n = 0;
+        for (const reg of [...this.#entries.keys()]) {
+            if (reg.plugin === plugin) {
+                this.#remove(reg);
+                n++;
+            }
+        }
+        return n;
+    }
+    /** 清空全部登记 */
+    clear() {
+        this.#entries.clear();
+        this.#buckets.clear();
+        this.#unbucketed = [];
+    }
+    /**
+     * 编译一条登记的全部模式
+     * @param reg 登记内容
+     * @returns 编译结果数组
+     */
+    #compileAll(reg) {
+        const label = `${reg.plugin}:${String(reg.patterns[0] ?? "?")}`;
+        const out = [];
+        for (const p of reg.patterns) {
+            try {
+                out.push(compile(p, reg.options, label, this.#logger));
+            }
+            catch (err) {
+                // 一个别名编译失败不该让整条命令消失，其余模式仍然可用
+                this.#logger.error(`命令 ${label} 的模式 ${String(p)} 无效：${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        if (out.length === 0)
+            this.#logger.error(`命令 ${label} 没有任何有效模式，将不会被触发`);
+        return out;
+    }
+    /**
+     * 取命令展示名
+     * @param entry 条目 t
+     * @returns 首个模式的可读形式
+     */
+    #nameOf(entry) {
+        return entry.compiled[0]?.label ?? String(entry.reg.patterns[0] ?? "?");
+    }
+    /**
+     * 把条目挂进索引
+     * @param entry 条目
+     */
+    #index(entry) {
+        // 同一条命令的多个模式可能落在同一个桶（`#体力`/`#树脂` 都在 `#`），
+        // 用 Set 去重，避免一条命令在桶里出现两次导致重复命中
+        const keys = new Set();
+        let needsUnbucketed = false;
+        for (const p of entry.compiled) {
+            if (p.key === undefined || p.key === "")
+                needsUnbucketed = true;
+            else
+                keys.add(p.key);
+        }
+        for (const key of keys) {
+            let bucket = this.#buckets.get(key);
+            if (bucket === undefined) {
+                bucket = [];
+                this.#buckets.set(key, bucket);
+            }
+            insertSorted(bucket, entry);
+        }
+        if (needsUnbucketed)
+            insertSorted(this.#unbucketed, entry);
+    }
+    /**
+     * 将条目从索引中摘除
+     * @param entry 条目
+     */
+    #unindex(entry) {
+        for (const [key, bucket] of this.#buckets) {
+            const at = bucket.indexOf(entry);
+            if (at >= 0)
+                bucket.splice(at, 1);
+            if (bucket.length === 0)
+                this.#buckets.delete(key);
+        }
+        const at = this.#unbucketed.indexOf(entry);
+        if (at >= 0)
+            this.#unbucketed.splice(at, 1);
+    }
+    /**
+     * 注销一条登记
+     * @param reg 登记内容
+     */
+    #remove(reg) {
+        const entry = this.#entries.get(reg);
+        if (entry === undefined)
+            return;
+        this.#unindex(entry);
+        this.#entries.delete(reg);
+    }
+    /**
+     * 取该文本需要试的候选条目（已按匹配顺序排好）
+     * @param text 消息纯文本
+     * @returns 候选条目数组
+     */
+    #candidates(text) {
+        const first = [...text][0];
+        const bucket = first === undefined ? undefined : this.#buckets.get(first);
+        const loose = this.#unbucketed;
+        // 绝大多数消息走这两条零分配的捷径
+        if (bucket === undefined)
+            return loose;
+        if (loose.length === 0)
+            return bucket;
+        // 两边都已排序，线性归并即可，不必 concat + sort
+        const out = [];
+        let i = 0;
+        let j = 0;
+        while (i < bucket.length && j < loose.length) {
+            const a = bucket[i];
+            const b = loose[j];
+            if (a === b) {
+                // 一条命令可能同时有可分桶与不可分桶的模式，只保留一次
+                out.push(a);
+                i++;
+                j++;
+            }
+            else if (byPriority(a, b) <= 0) {
+                out.push(a);
+                i++;
+            }
+            else {
+                out.push(b);
+                j++;
+            }
+        }
+        while (i < bucket.length)
+            out.push(bucket[i++]);
+        while (j < loose.length)
+            out.push(loose[j++]);
+        return out;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/pipeline/router.js.map

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

package/dist/platform/detect.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformInfo, ResourceUsage } from "@yunzai-ng/types";
+/**
+ * 探测运行环境
+ * @returns 环境信息（进程内缓存，多次调用返回同一对象）
+ */
+export declare function detectPlatform(): PlatformInfo;
+/**
+ * 采样进程资源占用
+ *
+ * `cpu` 是**两次调用之间**的平均占用率，因此第一次调用必然返回 0。
+ * WebUI 的资源曲线按固定间隔轮询即可。
+ * @returns 资源占用快照
+ */
+export declare function sampleUsage(): ResourceUsage;
+/**
+ * 按内存档位给出建议的并发上限
+ *
+ * 渲染器、图片下载这类"每个任务几十 MB"的操作用它定并发，
+ * 而不是各自拍一个魔数。
+ * @param kind 任务类型：`render` 每任务约 80MB，`io` 约 2MB
+ * @returns 建议并发数，至少 1
+ */
+export declare function suggestConcurrency(kind: "render" | "io"): number;
+//# sourceMappingURL=detect.d.ts.map

package/dist/platform/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/platform/detect.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAY,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAyF7E;;;GAGG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAmB7C;AAKD;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAwB3C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,CAOhE"}