@yunzai-ng/core 0.1.0

package/dist/logger/index.js

@@ -0,0 +1,363 @@
+/**
+ * 模块职责：日志枢纽（pino 实例、控制台/文件双路输出、运行时改级别、尾部缓冲）
+ * 依赖方向：依赖 logger/format、logger/rotate、util
+ * 生命周期：应用级单例，`close()` 时刷盘
+ * 注意事项：三个不显然的设计决定 ——
+ *
+ *          1) **pino 实例常驻 trace，级别过滤放在包装层做**。pino 的 child
+ *             logger 在创建时固化 level，改父级不会传播给已有子级；而 WebUI
+ *             上"把日志级别调成 debug"必须立刻对所有插件生效。所以过滤前移到
+ *             `#emit`，顺带连 `joinArgs` 的字符串拼接都省掉了，比 pino 自带
+ *             的级别检查更省。
+ *
+ *          2) **参数按 console.log 语义拼接**（见 format.ts 的 `joinArgs`）。
+ *             pino 原生仅识别第一个参数，`logger.info("查询", uid)` 将丢弃 uid。
+ *
+ *          3) **不采用 pino.multistream**。控制台与文件的级别过滤在自有的
+ *             dispatcher 中完成，同时将日志写入 WebUI 的环形缓冲，一次解析三处使用。
+ */
+import pino from "pino";
+import { LEVEL_VALUES, formatRecord, joinArgs, parseRecord, supportsColor } from "./format.js";
+import { RotatingFileWriter } from "./rotate.js";
+/** 默认尾部缓冲条数 */
+const DEFAULT_TAIL = 500;
+/**
+ * 级别名转数字，`silent` 视为最高
+ * @param level 级别名
+ * @returns 数字级别
+ */
+function levelValue(level) {
+    return level === "silent" ? Number.POSITIVE_INFINITY : LEVEL_VALUES[level];
+}
+/**
+ * 日志枢纽
+ *
+ * 内核只创建一个；插件通过 `ctx.logger`（即 `hub.root.child({ scope })`）取用。
+ */
+export class LoggerHub {
+    /** pino 实例（级别恒为 trace，过滤在包装层做） */
+    #pino;
+    /** 文件写入器 */
+    #writer;
+    /** 环形缓冲 */
+    #ring;
+    /** 环形缓冲写指针 */
+    #ringPos = 0;
+    /** 环形缓冲是否已绕回（用于判断有效长度） */
+    #ringFull = false;
+    /** 实时订阅者 */
+    #subscribers = new Set();
+    /** 防止订阅者内部再打日志导致无限递归 */
+    #notifying = false;
+    /** 全局级别 */
+    #level;
+    /** 控制台级别数字 */
+    #consoleValue;
+    /** 文件级别数字 */
+    #fileValue;
+    /** 生效阈值：两路里更低的那个，低于它的日志直接不生成 */
+    #threshold;
+    /** 是否输出控制台 */
+    #console;
+    /** 是否着色 */
+    #color;
+    /** 作用域列宽 */
+    #scopeWidth;
+    /** 根日志器 */
+    root;
+    /**
+     * @param config 日志配置
+     */
+    constructor(config = {}) {
+        this.#level = config.level ?? "info";
+        this.#console = config.console !== false;
+        this.#color = config.color ?? supportsColor();
+        this.#scopeWidth = config.scopeWidth ?? 14;
+        this.#ring = new Array(Math.max(50, config.tailSize ?? DEFAULT_TAIL));
+        this.#consoleValue = this.#console ? levelValue(config.consoleLevel ?? this.#level) : Number.POSITIVE_INFINITY;
+        this.#fileValue = config.dir ? levelValue(config.fileLevel ?? this.#level) : Number.POSITIVE_INFINITY;
+        this.#threshold = Math.min(this.#consoleValue, this.#fileValue);
+        this.#writer = config.dir
+            ? new RotatingFileWriter({
+                dir: config.dir,
+                basename: config.basename,
+                maxSize: config.maxSize,
+                keepDays: config.keepDays,
+                maxFiles: config.maxFiles
+            })
+            : undefined;
+        this.#pino = pino({
+            level: "trace",
+            // 去掉 pid/hostname：单机机器人用不上，白占日志体积
+            base: undefined,
+            serializers: { err: pino.stdSerializers.err }
+        }, { write: (line) => this.#dispatch(line) });
+        this.root = new HubLogger(this, this.#pino);
+    }
+    /** 当前全局级别 */
+    get level() {
+        return this.#level;
+    }
+    /** 当前日志文件路径；未启用文件输出时 undefined */
+    get file() {
+        return this.#writer?.file;
+    }
+    /**
+     * 判断某级别当前是否会被输出
+     *
+     * 由 `HubLogger` 在每次打日志前调用；命中 false 时连消息都不拼。
+     * @param level 目标级别
+     * @returns 是否启用
+     */
+    enabled(level) {
+        return levelValue(level) >= this.#threshold;
+    }
+    /**
+     * 运行时修改级别
+     *
+     * 立刻对所有已创建的子日志器生效 —— 这正是把过滤放在包装层的原因。
+     * @param level 新级别
+     * @param target 只改某一路：`"console"` / `"file"`；缺省两路都改
+     */
+    setLevel(level, target) {
+        const value = levelValue(level);
+        if (target === "console") {
+            if (this.#console)
+                this.#consoleValue = value;
+        }
+        else if (target === "file") {
+            if (this.#writer)
+                this.#fileValue = value;
+        }
+        else {
+            this.#level = level;
+            if (this.#console)
+                this.#consoleValue = value;
+            if (this.#writer)
+                this.#fileValue = value;
+        }
+        this.#threshold = Math.min(this.#consoleValue, this.#fileValue);
+    }
+    /**
+     * 取尾部日志
+     * @param query 查询条件
+     * @returns 按时间正序的日志记录
+     */
+    tail(query = {}) {
+        const size = this.#ring.length;
+        const count = this.#ringFull ? size : this.#ringPos;
+        const minLevel = query.level ? levelValue(query.level) : 0;
+        const keyword = query.keyword?.toLowerCase();
+        const out = [];
+        for (let i = 0; i < count; i++) {
+            // 从最旧的一条开始按环形顺序读
+            const index = this.#ringFull ? (this.#ringPos + i) % size : i;
+            const rec = this.#ring[index];
+            if (!rec)
+                continue;
+            if (levelValue(rec.level) < minLevel)
+                continue;
+            if (query.scope && rec.scope !== query.scope)
+                continue;
+            if (keyword && !rec.msg.toLowerCase().includes(keyword))
+                continue;
+            out.push(rec);
+        }
+        const limit = query.limit ?? out.length;
+        return limit >= out.length ? out : out.slice(out.length - limit);
+    }
+    /**
+     * 订阅实时日志（WebUI 的 SSE / WebSocket 推送用）
+     * @param fn 回调；**不要在里面打日志**，会被静默丢弃以防递归
+     * @returns 取消订阅
+     */
+    subscribe(fn) {
+        this.#subscribers.add(fn);
+        return () => void this.#subscribers.delete(fn);
+    }
+    /** 同步刷盘 */
+    flush() {
+        this.#writer?.flushSync();
+    }
+    /** 刷盘并关闭文件 */
+    close() {
+        this.#subscribers.clear();
+        this.#writer?.close();
+    }
+    /**
+     * 分发一行 pino 输出
+     *
+     * 一次解析，三处使用：控制台、文件、环形缓冲/订阅者。
+     * @param line pino 生成的 JSON 行
+     */
+    #dispatch(line) {
+        const rec = parseRecord(line);
+        if (!rec) {
+            // 无法解析时原样输出至控制台，优于直接丢弃
+            if (this.#console)
+                process.stdout.write(line);
+            return;
+        }
+        const value = levelValue(rec.level);
+        if (value >= this.#consoleValue) {
+            const text = formatRecord(rec, { color: this.#color, scopeWidth: this.#scopeWidth });
+            // warn 及以上走 stderr，便于 `yzng start 2> error.log` 单独收集
+            if (value >= LEVEL_VALUES.warn)
+                process.stderr.write(text);
+            else
+                process.stdout.write(text);
+        }
+        if (this.#writer && value >= this.#fileValue) {
+            this.#writer.write(line);
+            // fatal 立即落盘：这行之后进程很可能就没了
+            if (value >= LEVEL_VALUES.fatal)
+                this.#writer.flushSync();
+        }
+        this.#ring[this.#ringPos] = rec;
+        this.#ringPos = (this.#ringPos + 1) % this.#ring.length;
+        if (this.#ringPos === 0)
+            this.#ringFull = true;
+        this.#notify(rec);
+    }
+    /**
+     * 通知订阅者
+     * @param rec 日志记录
+     */
+    #notify(rec) {
+        if (this.#subscribers.size === 0 || this.#notifying)
+            return;
+        this.#notifying = true;
+        try {
+            for (const fn of this.#subscribers) {
+                try {
+                    fn(rec);
+                }
+                catch {
+                    // 订阅者出错不能影响日志本身
+                }
+            }
+        }
+        finally {
+            this.#notifying = false;
+        }
+    }
+}
+/**
+ * 面向插件的日志器实现
+ *
+ * 只是 pino 的薄包装：加上级别前置过滤、console.log 风格参数拼接、`mark`。
+ */
+class HubLogger {
+    /** 所属枢纽 */
+    #hub;
+    /** 底层 pino 实例（已绑定 scope 等字段） */
+    #pino;
+    /**
+     * @param hub 日志枢纽
+     * @param instance pino 实例
+     */
+    constructor(hub, instance) {
+        this.#hub = hub;
+        this.#pino = instance;
+    }
+    /** 当前生效级别 */
+    get level() {
+        return this.#hub.level;
+    }
+    /**
+     * 最细粒度的追踪日志
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    trace(msg, ...args) {
+        this.#emit("trace", msg, args);
+    }
+    /**
+     * 调试信息
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    debug(msg, ...args) {
+        this.#emit("debug", msg, args);
+    }
+    /**
+     * 常规信息
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    info(msg, ...args) {
+        this.#emit("info", msg, args);
+    }
+    /**
+     * 需要留意但不影响运行
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    warn(msg, ...args) {
+        this.#emit("warn", msg, args);
+    }
+    /**
+     * 出错但可继续
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    error(msg, ...args) {
+        this.#emit("error", msg, args);
+    }
+    /**
+     * 致命错误
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    fatal(msg, ...args) {
+        this.#emit("fatal", msg, args);
+    }
+    /**
+     * 重要信息，等价于 `info`
+     * @param msg 消息
+     * @param args 附加参数
+     */
+    mark(msg, ...args) {
+        this.#emit("info", msg, args);
+    }
+    /**
+     * 派生子日志器
+     * @param bindings 固定字段
+     * @returns 新日志器
+     */
+    child(bindings) {
+        return new HubLogger(this.#hub, this.#pino.child(bindings));
+    }
+    /**
+     * 判断级别是否启用
+     * @param level 目标级别
+     * @returns 是否启用
+     */
+    isLevelEnabled(level) {
+        return this.#hub.enabled(level);
+    }
+    /**
+     * 实际写日志
+     * @param level 级别
+     * @param msg 首个参数
+     * @param args 其余参数
+     */
+    #emit(level, msg, args) {
+        if (!this.#hub.enabled(level))
+            return;
+        const joined = joinArgs(args.length === 0 ? [msg] : [msg, ...args]);
+        if (joined.err)
+            this.#pino[level]({ err: joined.err }, joined.msg);
+        else
+            this.#pino[level](joined.msg);
+    }
+}
+/**
+ * 创建日志枢纽
+ * @param config 日志配置
+ * @returns 日志枢纽
+ */
+export function createLoggerHub(config = {}) {
+    return new LoggerHub(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

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

package/dist/logger/rotate.d.ts

@@ -0,0 +1,47 @@
+/** 滚动写入参数 */
+export interface RotateOptions {
+    /** 日志目录 */
+    dir: string;
+    /** 文件名前缀，缺省 `"app"` */
+    basename?: string;
+    /** 单文件字节上限，缺省 8MB */
+    maxSize?: number;
+    /** 保留天数，缺省 14 */
+    keepDays?: number;
+    /** 文件数上限，缺省 100（防止同一天大量写入日志将磁盘写满） */
+    maxFiles?: number;
+    /** 批量刷盘间隔毫秒，缺省 200 */
+    flushInterval?: number;
+    /** 缓冲字节数上限，超过立即刷盘，缺省 32KB */
+    bufferLimit?: number;
+}
+/**
+ * 滚动日志写入器
+ *
+ * 触发滚动的两个条件：跨自然日、当前文件超过 `maxSize`。
+ * 同一天内超限则追加序号：`app-2026-08-21.1.log`。
+ */
+export declare class RotatingFileWriter {
+    #private;
+    /**
+     * @param opts 滚动参数
+     */
+    constructor(opts: RotateOptions);
+    /** 当前正在写入的文件路径 */
+    get file(): string;
+    /**
+     * 写入一行（调用方需自带换行符，pino 已带）
+     * @param line 日志行
+     */
+    write(line: string): void;
+    /**
+     * 同步刷盘
+     *
+     * 进程退出、`uncaughtException`、`fatal` 级日志之后都应调用，
+     * 否则最关键的几行日志会随进程一起消失。
+     */
+    flushSync(): void;
+    /** 刷盘并关闭文件 */
+    close(): void;
+}
+//# sourceMappingURL=rotate.d.ts.map

package/dist/logger/rotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate.d.ts","sourceRoot":"","sources":["../../src/logger/rotate.ts"],"names":[],"mappings":"AAiBA,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,GAAG,EAAE,MAAM,CAAA;IACX,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAiBD;;;;;GAKG;AACH,qBAAa,kBAAkB;;IAiC7B;;OAEG;gBACS,IAAI,EAAE,aAAa;IAU/B,kBAAkB;IAClB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBzB;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAsBjB,cAAc;IACd,KAAK,IAAI,IAAI;CAyGd"}

package/dist/logger/rotate.js

@@ -0,0 +1,242 @@
+/**
+ * 模块职责：日志文件的滚动写入与保留策略
+ * 依赖方向：仅依赖 node:fs / node:path
+ * 生命周期：由 LoggerHub 创建与关闭；`close()` 前必须 `flushSync()`
+ * 注意事项：刻意**不用** `pino-roll` / `pino/file` 这类 worker 线程 transport。
+ *          worker transport 在两个场景下存在缺陷：
+ *          1) 单文件打包（Windows 安装包）里 worker 入口路径解析不到；
+ *          2) 进程被强杀时 worker 尚未落盘的日志直接丢失 —— 而崩溃前最后
+ *             几行日志恰恰是排障最需要的。
+ *
+ *          因此此处自行维护一个 fd 与内存缓冲：常态下批量异步刷盘，退出与致命
+ *          错误时 `flushSync()` 同步落盘。写入用 `writeSync` 循环，处理
+ *          部分写入（管道/网络盘上会发生）。
+ */
+import { closeSync, existsSync, mkdirSync, openSync, readdirSync, statSync, unlinkSync, writeSync } from "node:fs";
+import { join } from "node:path";
+/** 默认单文件上限：8MB */
+const DEFAULT_MAX_SIZE = 8 * 1024 * 1024;
+/**
+ * 取本地日期字符串
+ * @param date 时间
+ * @returns 形如 `"2026-08-21"`
+ */
+function localDay(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+}
+/**
+ * 滚动日志写入器
+ *
+ * 触发滚动的两个条件：跨自然日、当前文件超过 `maxSize`。
+ * 同一天内超限则追加序号：`app-2026-08-21.1.log`。
+ */
+export class RotatingFileWriter {
+    /** 日志目录 */
+    #dir;
+    /** 文件名前缀 */
+    #basename;
+    /** 单文件上限 */
+    #maxSize;
+    /** 保留天数 */
+    #keepDays;
+    /** 文件数上限 */
+    #maxFiles;
+    /** 刷盘间隔 */
+    #flushInterval;
+    /** 缓冲上限 */
+    #bufferLimit;
+    /** 当前文件描述符 */
+    #fd = -1;
+    /** 当前文件路径 */
+    #file = "";
+    /** 当前文件已写字节数 */
+    #size = 0;
+    /** 当前文件对应的日期 */
+    #day = "";
+    /** 待刷盘缓冲 */
+    #buffer = [];
+    /** 缓冲字节数（按 UTF-8 估算） */
+    #bufferBytes = 0;
+    /** 刷盘定时器 */
+    #timer;
+    /** 是否已关闭 */
+    #closed = false;
+    /**
+     * @param opts 滚动参数
+     */
+    constructor(opts) {
+        this.#dir = opts.dir;
+        this.#basename = opts.basename ?? "app";
+        this.#maxSize = Math.max(64 * 1024, opts.maxSize ?? DEFAULT_MAX_SIZE);
+        this.#keepDays = Math.max(1, opts.keepDays ?? 14);
+        this.#maxFiles = Math.max(2, opts.maxFiles ?? 100);
+        this.#flushInterval = Math.max(50, opts.flushInterval ?? 200);
+        this.#bufferLimit = Math.max(4096, opts.bufferLimit ?? 32 * 1024);
+    }
+    /** 当前正在写入的文件路径 */
+    get file() {
+        return this.#file;
+    }
+    /**
+     * 写入一行（调用方需自带换行符，pino 已带）
+     * @param line 日志行
+     */
+    write(line) {
+        if (this.#closed)
+            return;
+        this.#buffer.push(line);
+        this.#bufferBytes += Buffer.byteLength(line);
+        if (this.#bufferBytes >= this.#bufferLimit) {
+            this.flushSync();
+            return;
+        }
+        if (!this.#timer) {
+            this.#timer = setTimeout(() => {
+                this.#timer = undefined;
+                this.flushSync();
+            }, this.#flushInterval);
+            // unref：日志缓冲不该拖着进程不让退出
+            if (typeof this.#timer.unref === "function")
+                this.#timer.unref();
+        }
+    }
+    /**
+     * 同步刷盘
+     *
+     * 进程退出、`uncaughtException`、`fatal` 级日志之后都应调用，
+     * 否则最关键的几行日志会随进程一起消失。
+     */
+    flushSync() {
+        if (this.#buffer.length === 0)
+            return;
+        const payload = this.#buffer.join("");
+        this.#buffer = [];
+        this.#bufferBytes = 0;
+        try {
+            this.#ensureTarget(Buffer.byteLength(payload));
+            if (this.#fd < 0)
+                return;
+            const data = Buffer.from(payload, "utf8");
+            let offset = 0;
+            // writeSync 可能只写了一部分，必须循环
+            while (offset < data.length) {
+                offset += writeSync(this.#fd, data, offset, data.length - offset);
+            }
+            this.#size += data.length;
+        }
+        catch {
+            // 日志系统本身不能抛错，否则会把"记录错误"变成"制造错误"。
+            // 磁盘满或权限问题只能静默丢弃，控制台流仍然可用。
+        }
+    }
+    /** 刷盘并关闭文件 */
+    close() {
+        if (this.#closed)
+            return;
+        this.flushSync();
+        this.#closed = true;
+        if (this.#timer) {
+            clearTimeout(this.#timer);
+            this.#timer = undefined;
+        }
+        if (this.#fd >= 0) {
+            try {
+                closeSync(this.#fd);
+            }
+            catch {
+                // 关闭失败无从处理
+            }
+            this.#fd = -1;
+        }
+    }
+    /**
+     * 确保当前文件可写且容量足够
+     * @param incoming 即将写入的字节数
+     */
+    #ensureTarget(incoming) {
+        const day = localDay(new Date());
+        const needRotate = this.#fd < 0 || day !== this.#day || this.#size + incoming > this.#maxSize;
+        if (!needRotate)
+            return;
+        if (this.#fd >= 0) {
+            try {
+                closeSync(this.#fd);
+            }
+            catch {
+                // 忽略
+            }
+            this.#fd = -1;
+        }
+        mkdirSync(this.#dir, { recursive: true });
+        this.#day = day;
+        // 找当天第一个未超限的序号
+        let index = 0;
+        let file = join(this.#dir, `${this.#basename}-${day}.log`);
+        let size = this.#sizeOf(file);
+        while (size + incoming > this.#maxSize && index < 1000) {
+            index++;
+            file = join(this.#dir, `${this.#basename}-${day}.${index}.log`);
+            size = this.#sizeOf(file);
+        }
+        this.#file = file;
+        this.#size = size;
+        this.#fd = openSync(file, "a");
+        this.#cleanup();
+    }
+    /**
+     * 取文件大小
+     * @param file 文件路径
+     * @returns 字节数；不存在时 0
+     */
+    #sizeOf(file) {
+        try {
+            return existsSync(file) ? statSync(file).size : 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * 按保留策略删除旧日志
+     *
+     * 只在滚动时调用（低频），因此用同步 API 无妨。
+     */
+    #cleanup() {
+        try {
+            const pattern = new RegExp(`^${this.#basename}-(\\d{4}-\\d{2}-\\d{2})(?:\\.(\\d+))?\\.log$`);
+            const files = [];
+            for (const name of readdirSync(this.#dir)) {
+                const m = pattern.exec(name);
+                if (m)
+                    files.push({ name, day: m[1], index: Number(m[2] ?? 0) });
+            }
+            // 按日期倒序、同日按序号倒序 → 数组头部是最新的
+            files.sort((a, b) => (a.day === b.day ? b.index - a.index : a.day < b.day ? 1 : -1));
+            const cutoff = new Date();
+            cutoff.setDate(cutoff.getDate() - this.#keepDays);
+            const cutoffDay = localDay(cutoff);
+            for (let i = 0; i < files.length; i++) {
+                const entry = files[i];
+                const tooOld = entry.day < cutoffDay;
+                const tooMany = i >= this.#maxFiles;
+                if (!tooOld && !tooMany)
+                    continue;
+                if (join(this.#dir, entry.name) === this.#file)
+                    continue;
+                try {
+                    unlinkSync(join(this.#dir, entry.name));
+                }
+                catch {
+                    // 文件被占用（Windows 常见）时留到下次滚动再试
+                }
+            }
+        }
+        catch {
+            // 清理失败不影响写入
+        }
+    }
+}
+//# sourceMappingURL=rotate.js.map

package/dist/logger/rotate.js.map

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