@bililive-tools/manager 1.16.2 → 1.17.1

package/lib/downloader/BililiveDownloader.d.ts

@@ -34,6 +34,7 @@ export declare class BililiveDownloader extends EventEmitter implements IDownloa
     readonly disableDanma: boolean;
     readonly url: string;
     readonly debugLevel: "none" | "basic" | "verbose";
+    readonly proxy?: string;
     readonly headers: {
         [key: string]: string | undefined;
     } | undefined;

package/lib/downloader/BililiveDownloader.js

@@ -109,6 +109,7 @@ export class BililiveDownloader extends EventEmitter {
     disableDanma = false;
     url;
     debugLevel = "none";
+    proxy;
     headers;
     constructor(opts, onEnd, onUpdateLiveInfo) {
         super();
@@ -119,6 +120,7 @@ export class BililiveDownloader extends EventEmitter {
         this.hasSegment = hasSegment;
         this.disableDanma = opts.disableDanma ?? false;
         this.debugLevel = opts.debugLevel ?? "none";
+        this.proxy = opts.proxy;
         let videoFormat = "flv";
         this.streamManager = new StreamManager(opts.getSavePath, hasSegment, this.disableDanma, "bililive", videoFormat, {
             onUpdateLiveInfo: this.onUpdateLiveInfo,
@@ -153,6 +155,9 @@ export class BililiveDownloader extends EventEmitter {
         if (this.debugLevel === "verbose") {
             inputOptions.push("-l", "Debug");
         }
+        if (this.proxy) {
+            inputOptions.push(...["--proxy", this.proxy]);
+        }
         if (this.headers) {
             Object.entries(this.headers).forEach(([key, value]) => {
                 if (!value)

package/lib/downloader/FFmpegDownloader.d.ts

@@ -23,6 +23,7 @@ export declare class FFmpegDownloader extends EventEmitter implements IDownloade
     formatName: FormatName;
     videoFormat: VideoFormat;
     readonly debugLevel: "none" | "basic" | "verbose";
+    readonly proxy?: string;
     readonly headers: {
         [key: string]: string | undefined;
     } | undefined;

package/lib/downloader/FFmpegDownloader.js

@@ -20,6 +20,7 @@ export class FFmpegDownloader extends EventEmitter {
     formatName;
     videoFormat;
     debugLevel = "none";
+    proxy;
     headers;
     constructor(opts, onEnd, onUpdateLiveInfo) {
         super();
@@ -63,6 +64,7 @@ export class FFmpegDownloader extends EventEmitter {
         this.url = opts.url;
         this.segment = opts.segment;
         this.headers = opts.headers;
+        this.proxy = opts.proxy;
         this.command = this.createCommand();
         this.streamManager.on("videoFileCreated", ({ filename, cover, rawFilename, title }) => {
             this.emit("videoFileCreated", { filename, cover, rawFilename, title });
@@ -86,6 +88,9 @@ export class FFmpegDownloader extends EventEmitter {
         if (this.isHls) {
             inputOptions.push(...["-reconnect", "1", "-reconnect_streamed", "1", "-reconnect_delay_max", "3"]);
         }
+        if (this.proxy) {
+            inputOptions.push(...["-http_proxy", this.proxy]);
+        }
         if (this.debugLevel === "verbose") {
             inputOptions.push("-loglevel", "debug");
         }

package/lib/downloader/IDownloader.d.ts

@@ -4,6 +4,12 @@ import type { FormatName } from "./index.js";
 import type { XmlStreamController } from "../xml_stream_controller.js";
 import type { VideoFileCompletedPayload } from "./streamManager.js";
 export type Segment = number | string | undefined;
+export interface VideoFileCreatedPayload {
+    filename: string;
+    cover?: string;
+    rawFilename?: string;
+    title?: string;
+}
 /**
  * 录制器构造函数选项的基础接口
  */
@@ -23,6 +29,7 @@ export interface BaseRecorderOptions {
         [key: string]: string | undefined;
     };
     videoFormat?: VideoFormat;
+    proxy?: string;
 }
 /**
  * 录制器接口定义
@@ -37,6 +44,7 @@ export interface IDownloader extends EventEmitter {
     readonly headers: {
         [key: string]: string | undefined;
     } | undefined;
+    readonly proxy?: string;
     readonly getSavePath: (data: {
         startTime: number;
         title?: string;
@@ -49,12 +57,7 @@ export interface IDownloader extends EventEmitter {
     getExtraDataController(): XmlStreamController | null;
     createCommand(): any;
     get videoFilePath(): string;
-    on(event: "videoFileCreated", listener: (data: {
-        filename: string;
-        cover?: string;
-        rawFilename?: string;
-        title?: string;
-    }) => void): this;
+    on(event: "videoFileCreated", listener: (data: VideoFileCreatedPayload) => void): this;
     on(event: "videoFileCompleted", listener: (data: VideoFileCompletedPayload) => void): this;
     on(event: "DebugLog", listener: (data: {
         type: string;
@@ -62,12 +65,7 @@ export interface IDownloader extends EventEmitter {
     }) => void): this;
     on(event: "progress", listener: (info: any) => void): this;
     on(event: string, listener: (...args: any[]) => void): this;
-    emit(event: "videoFileCreated", data: {
-        filename: string;
-        cover?: string;
-        rawFilename?: string;
-        title?: string;
-    }): boolean;
+    emit(event: "videoFileCreated", data: VideoFileCreatedPayload): boolean;
     emit(event: "videoFileCompleted", data: VideoFileCompletedPayload): boolean;
     emit(event: "DebugLog", data: {
         type: string;

package/lib/downloader/mesioDownloader.d.ts

@@ -31,6 +31,7 @@ export declare class mesioDownloader extends EventEmitter implements IDownloader
     readonly disableDanma: boolean;
     readonly url: string;
     readonly debugLevel: "none" | "basic" | "verbose";
+    readonly proxy?: string;
     readonly headers: {
         [key: string]: string | undefined;
     } | undefined;

package/lib/downloader/mesioDownloader.js

@@ -99,6 +99,7 @@ export class mesioDownloader extends EventEmitter {
     disableDanma = false;
     url;
     debugLevel = "none";
+    proxy;
     headers;
     constructor(opts, onEnd, onUpdateLiveInfo) {
         super();
@@ -109,6 +110,7 @@ export class mesioDownloader extends EventEmitter {
         this.hasSegment = hasSegment;
         this.disableDanma = opts.disableDanma ?? false;
         this.debugLevel = opts.debugLevel ?? "none";
+        this.proxy = opts.proxy;
         let videoFormat = "flv";
         if (opts.url.includes(".m3u8")) {
             videoFormat = "ts";
@@ -145,7 +147,29 @@ export class mesioDownloader extends EventEmitter {
         });
     }
     createCommand() {
-        const inputOptions = [...this.inputOptions, "--fix", "--no-proxy", "--disable-log-file"];
+        const inputOptions = [...this.inputOptions, "--fix", "--disable-log-file"];
+        if (this.proxy) {
+            try {
+                const { protocol, username, password, origin, search, pathname } = new URL(this.proxy);
+                if (protocol.startsWith("https")) {
+                    inputOptions.push("--proxy-type", "https");
+                }
+                else if (protocol.startsWith("socks5")) {
+                    inputOptions.push("--proxy-type", "socks5");
+                }
+                if (username && password) {
+                    inputOptions.push("--proxy-user", `${username}`);
+                    inputOptions.push("--proxy-pass", `${password}`);
+                }
+                inputOptions.push("--proxy", origin + pathname + search);
+            }
+            catch (err) {
+                this.emit("DebugLog", { type: "error", text: `Invalid proxy URL: ${this.proxy}` });
+            }
+        }
+        else {
+            inputOptions.push("--no-proxy");
+        }
         if (this.debugLevel === "verbose") {
             inputOptions.push("-v");
         }

package/lib/downloader/streamManager.js

@@ -146,6 +146,7 @@ export class StreamManager extends EventEmitter {
             recordSavePath = getSavePath({ startTime, extraMs: true });
         }
         this.recordSavePath = recordSavePath;
+        ensureFolderExist(recordSavePath);
         if (hasSegment) {
             this.segment = new Segment(getSavePath, disableDanma, this.videoExt, {
                 firstStartTime: startTime,
@@ -161,7 +162,6 @@ export class StreamManager extends EventEmitter {
             });
         }
         else {
-            ensureFolderExist(recordSavePath);
             const extraDataSavePath = `${recordSavePath}.xml`;
             if (!disableDanma) {
                 this.extraDataController = createRecordExtraDataController(extraDataSavePath);

package/lib/index.d.ts

@@ -9,6 +9,7 @@ export * from "./manager.js";
 export * from "./cache.js";
 export * from "./downloader/FFmpegDownloader.js";
 export { createDownloader } from "./downloader/index.js";
+export type { VideoFileCreatedPayload } from "./downloader/IDownloader.js";
 export { checkTitleKeywordsWhileRecording, checkTitleKeywordsBeforeRecord } from "./utils.js";
 export { utils };
 /**

package/lib/manager.d.ts

@@ -13,12 +13,16 @@ export interface ProviderCheckConfig {
     /** 每次检查之间的等待时间（毫秒） */
     waitTime?: number;
 }
+export interface ResolveChannelOptions {
+    /** 解析频道信息时使用的网络代理 */
+    proxy?: string;
+}
 export interface RecorderProvider<E extends AnyObject> {
     id: string;
     name: string;
     siteURL: string;
     matchURL: (this: RecorderProvider<E>, channelURL: string) => boolean;
-    resolveChannelInfoFromURL: (this: RecorderProvider<E>, channelURL: string) => Promise<{
+    resolveChannelInfoFromURL: (this: RecorderProvider<E>, channelURL: string, options?: ResolveChannelOptions) => Promise<{
         id: ChannelId;
         title: string;
         owner: string;
@@ -62,6 +66,9 @@ export interface RecorderManager<ME extends UnknownObject, P extends RecorderPro
     RecoderLiveStart: {
         recorder: Recorder<E>;
     };
+    RecoderChargeLive: {
+        recorder: Recorder<E>;
+    };
     RecordStop: {
         recorder: SerializedRecorder<E>;
         recordHandle: RecordHandle;

package/lib/manager.js

@@ -5,8 +5,48 @@ import { omit, range } from "lodash-es";
 import { parseArgsStringToArgv } from "string-argv";
 import { RecorderCacheImpl, MemoryCacheStore } from "./cache.js";
 import { getBiliStatusInfoByRoomIds } from "./api.js";
-import { formatDate, removeSystemReservedChars, formatTemplate, replaceExtName, downloadImage, isBetweenTimeRange, sleep, } from "./utils.js";
+import { formatDate, removeSystemReservedChars, formatTemplate, replaceExtName, downloadImage, isBetweenTimeRange, sleep, replaceFourByteUnicode, } from "./utils.js";
 import { StreamManager } from "./downloader/streamManager.js";
+const RECORDER_TIMELINE_LIMIT = 40;
+function normalizeTimelineText(text) {
+    return text.trim();
+}
+function appendRecorderTimeline(recorder, args) {
+    const text = normalizeTimelineText(args.text);
+    if (!text) {
+        return recorder.timeline ?? [];
+    }
+    const startTime = args.startTime ?? Date.now();
+    const timeline = recorder.timeline ?? [];
+    const lastItem = timeline[timeline.length - 1];
+    if (lastItem && lastItem.text === text) {
+        lastItem.endTime = Math.max(lastItem.endTime ?? lastItem.startTime, startTime);
+        recorder.timeline = [...timeline];
+        return recorder.timeline;
+    }
+    const nextTimeline = [...timeline, { startTime, text }].slice(-RECORDER_TIMELINE_LIMIT);
+    recorder.timeline = nextTimeline;
+    return nextTimeline;
+}
+function ensureRecorderTimeline(recorder) {
+    recorder.timeline = Array.isArray(recorder.timeline) ? recorder.timeline : [];
+    recorder.appendTimeline = (args) => appendRecorderTimeline(recorder, args);
+}
+function getStateTimelineText(state, msg) {
+    const text = normalizeTimelineText(msg ?? "");
+    if (text) {
+        return text;
+    }
+    const stateTextMap = {
+        idle: "空闲中",
+        recording: "录制中",
+        "stopping-record": "停止录制中",
+        "check-error": "检查失败",
+        "title-blocked": "标题命中过滤规则",
+        "charge-skipped": "特殊直播(付费/权限/加密)，无法录制，已跳过",
+    };
+    return stateTextMap[state];
+}
 const configurableProps = [
     "savePathRule",
     "autoRemoveSystemReservedChars",
@@ -25,7 +65,7 @@ export function createRecorderManager(opts) {
     const recorders = [];
     // 存储每个 provider 的 timer，key 为 providerId
     const checkLoopTimers = new Map();
-    const multiThreadCheck = async (manager, providerId) => {
+    const multiThreadCheck = async (manager, providerId, providerConfig) => {
         const handleBatchQuery = async (obj) => {
             for (const recorder of recorders
                 .filter((r) => !r.disableAutoCheck)
@@ -48,7 +88,6 @@ export function createRecorderManager(opts) {
             .filter((r) => !r.disableAutoCheck)
             .filter((r) => isBetweenTimeRange(r.handleTime))
             .filter((r) => r.providerId === providerId);
-        const providerConfig = manager.getProviderCheckConfig(providerId);
         const threads = [];
         // Bilibili 批量查询特殊处理
         if (providerId === "Bilibili" && manager.biliBatchQuery) {
@@ -87,13 +126,15 @@ export function createRecorderManager(opts) {
             while (needCheckRecorders.length > 0) {
                 try {
                     await checkOnce();
-                    if (providerConfig.waitTime > 0) {
-                        await sleep(providerConfig.waitTime);
-                    }
                 }
                 catch (err) {
                     manager.emit("error", { source: "checkOnceInThread", err });
                 }
+                finally {
+                    if (providerConfig.waitTime > 0) {
+                        await sleep(providerConfig.waitTime);
+                    }
+                }
             }
         }));
         await Promise.all(threads);
@@ -102,6 +143,8 @@ export function createRecorderManager(opts) {
     const tempBanObj = {};
     // 用于是否触发LiveStart事件，不要重复触发
     const liveStartObj = {};
+    // 用于是否触发ChargeLive(充电直播)事件，按场次去重，不要每个检查周期重复触发
+    const chargeLiveObj = {};
     // 用于记录触发重试直播场次的次数
     const retryCountObj = {};
     const manager = {
@@ -124,21 +167,42 @@ export function createRecorderManager(opts) {
             });
             // 为录制器注入独立的缓存命名空间
             recorder.cache = this.cache.createNamespace(recorder.id);
+            ensureRecorderTimeline(recorder);
             this.recorders.push(recorder);
-            recorder.on("RecordStart", (recordHandle) => this.emit("RecordStart", { recorder: recorder.toJSON(), recordHandle }));
+            recorder.on("RecordStart", (recordHandle) => {
+                recorder.appendTimeline?.({
+                    startTime: recorder.liveInfo?.recordStartTime?.getTime() ?? Date.now(),
+                    text: `开始录制：${recordHandle.stream}/${recordHandle.source}/${recordHandle.recorderType}/${recordHandle.url}`,
+                });
+                this.emit("RecordStart", { recorder: recorder.toJSON(), recordHandle });
+            });
             recorder.on("RecordSegment", (recordHandle) => this.emit("RecordSegment", { recorder: recorder.toJSON(), recordHandle }));
             recorder.on("videoFileCreated", ({ filename, cover, rawFilename }) => {
                 if (recorder.saveCover && recorder?.liveInfo?.cover) {
                     const coverPath = replaceExtName(filename, ".jpg");
                     downloadImage(cover ?? recorder?.liveInfo?.cover, coverPath);
                 }
+                recorder.appendTimeline?.({
+                    startTime: Date.now(),
+                    text: `视频文件创建：${filename}`,
+                });
                 this.emit("videoFileCreated", { recorder: recorder.toJSON(), filename, rawFilename });
             });
-            recorder.on("videoFileCompleted", ({ filename, stats }) => this.emit("videoFileCompleted", { recorder: recorder.toJSON(), filename, stats }));
+            recorder.on("videoFileCompleted", ({ filename, stats }) => {
+                recorder.appendTimeline?.({
+                    startTime: Date.now(),
+                    text: `视频文件创建完成：${filename}`,
+                });
+                this.emit("videoFileCompleted", { recorder: recorder.toJSON(), filename, stats });
+            });
             recorder.on("Message", (message) => this.emit("Message", { recorder: recorder.toJSON(), message }));
             recorder.on("Updated", (keys) => this.emit("RecorderUpdated", { recorder: recorder.toJSON(), keys }));
             recorder.on("DebugLog", (log) => this.emit("RecorderDebugLog", { recorder: recorder, ...log }));
             recorder.on("RecordStop", ({ recordHandle, reason }) => {
+                recorder.appendTimeline?.({
+                    startTime: Date.now(),
+                    text: reason ? `停止录制：${reason}` : "停止录制",
+                });
                 this.emit("RecordStop", { recorder: recorder.toJSON(), recordHandle, reason });
                 const maxRetryCount = 10;
                 // 默认策略下，如果录制被中断，那么会在下一个检查周期时重新检查直播状态并重新开始录制，这种策略的问题就是一部分时间会被漏掉。
@@ -167,6 +231,10 @@ export function createRecorderManager(opts) {
                         type: "common",
                         text: `录制${recorder.channelId}中断，立即触发重试（${retryCountObj[key]}/${maxRetryCount}）`,
                     });
+                    recorder.appendTimeline?.({
+                        startTime: Date.now(),
+                        text: `录制中断，立即触发重试（${retryCountObj[key]}/${maxRetryCount}）`,
+                    });
                     // 触发一次检查，等待一秒使状态清理完毕
                     setTimeout(() => {
                         recorder.checkLiveStatusAndRecord({
@@ -189,6 +257,24 @@ export function createRecorderManager(opts) {
                 liveStartObj[key] = true;
                 this.emit("RecoderLiveStart", { recorder: recorder });
             });
+            recorder.on("ChargeLive", () => {
+                // 充电直播按场次去重，避免每个检查周期重复推送
+                const liveId = recorder.liveInfo?.liveId;
+                const key = `${recorder.channelId}-${liveId ?? ""}`;
+                if (chargeLiveObj[key])
+                    return;
+                chargeLiveObj[key] = true;
+                this.emit("RecoderChargeLive", { recorder: recorder });
+            });
+            recorder.on("stateChange", ({ state, msg }) => {
+                recorder.state = state;
+                if (state !== "idle") {
+                    recorder.appendTimeline?.({
+                        startTime: Date.now(),
+                        text: `状态变更：${getStateTimelineText(state, msg)}`,
+                    });
+                }
+            });
             this.emit("RecorderAdded", recorder.toJSON());
             // startCheckLoop 会为所有注册的 provider 启动检查循环，无需在此处额外处理
             return recorder;
@@ -200,6 +286,16 @@ export function createRecorderManager(opts) {
             recorder.recordHandle?.stop("remove recorder");
             this.recorders.splice(idx, 1);
             delete tempBanObj[recorder.channelId];
+            // 清理该房间的 liveStart/chargeLive 去重标记，否则删除后重新添加同一场直播不会再次推送通知
+            const keyPrefix = `${recorder.channelId}-`;
+            Object.keys(liveStartObj).forEach((k) => {
+                if (k.startsWith(keyPrefix))
+                    delete liveStartObj[k];
+            });
+            Object.keys(chargeLiveObj).forEach((k) => {
+                if (k.startsWith(keyPrefix))
+                    delete chargeLiveObj[k];
+            });
             this.emit("RecorderRemoved", recorder.toJSON());
         },
         getRecorder(id) {
@@ -260,11 +356,11 @@ export function createRecorderManager(opts) {
             // TODO: emit updated event
             // 为每个 provider 创建独立的检查循环
             const startProviderCheckLoop = (providerId) => {
-                const providerConfig = this.getProviderCheckConfig(providerId);
                 const checkLoop = async () => {
+                    const providerConfig = this.getProviderCheckConfig(providerId);
                     try {
                         // 只检查当前 provider 的 recorders
-                        await multiThreadCheck(this, providerId);
+                        await multiThreadCheck(this, providerId, providerConfig);
                     }
                     catch (err) {
                         this.emit("error", { source: "multiThreadCheck", err });
@@ -370,6 +466,7 @@ export function genSavePathFromRule(manager, recorder, extData) {
         title: title,
         remarks: remarks,
         channelId,
+        replaceFourByteUnicode,
     };
     let savePathRule = manager.savePathRule;
     if (extData?.extraMs) {

package/lib/recorder.d.ts

@@ -5,8 +5,8 @@ import { AnyObject, PickRequired, UnknownObject } from "./utils.js";
 import type { NamespacedCache } from "./cache.js";
 import type { DownloaderType } from "./downloader/index.js";
 import type { XmlStreamStats } from "./xml_stream_controller.js";
-type FormatName = "auto" | "flv" | "hls" | "fmp4" | "flv_only" | "hls_only" | "fmp4_only";
-type CodecName = "auto" | "avc" | "hevc" | "avc_only" | "hevc_only";
+export type FormatName = "auto" | "flv" | "hls" | "fmp4" | "flv_only" | "hls_only" | "fmp4_only";
+export type CodecName = "auto" | "avc" | "hevc" | "av1" | "avc_only" | "hevc_only" | "av1_only";
 export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     providerId: RecorderProvider<E>["id"];
     channelId: ChannelId;
@@ -46,7 +46,7 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     /** 流编码 */
     codecName?: CodecName;
     /** 选择使用的api，虎牙支持: auto,web,mp,wup，抖音支持：web,webHTML,mobile,userHTML */
-    api?: "auto" | "web" | "mp" | "wup" | "webHTML" | "mobile" | "userHTML" | "balance" | "random" | string;
+    api?: "auto" | "web" | "mp" | "wup" | "webHTML" | "mobile" | "userHTML" | "balance" | "random" | "newAPI" | "oldAPI" | string;
     /** 标题关键词，如果直播间标题包含这些关键词，则不会自动录制，支持两种格式：
      * 1. 逗号分隔的关键词：'回放,录播,重播'
      * 2. 正则表达式：'/pattern/flags'（如：'/回放|录播/i'）
@@ -65,15 +65,26 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     /** 控制弹幕是否使用服务端时间戳 */
     useServerTimestamp?: boolean;
     extra?: Partial<E>;
+    /** 代理 如http://127.0.0.1:7890 */
+    proxy?: string;
     /** 调试等级 */
     debugLevel?: "none" | "basic" | "verbose";
 }
 export type SerializedRecorder<E extends AnyObject> = PickRequired<RecorderCreateOpts<E>, "id"> & Pick<Recorder<E>, "id" | "channelId" | "remarks" | "disableAutoCheck" | "quality" | "streamPriorities" | "sourcePriorities" | "extra" | "segment" | "saveSCDanma" | "saveCover" | "convert2Mp4" | "saveGiftDanma" | "disableProvideCommentsWhenRecording" | "liveInfo" | "uid" | "titleKeywords">;
-/** 录制状态，idle: 空闲中，recording: 录制中，stopping-record: 停止录制中，check-error: 检查错误，title-blocked: 标题黑名单 */
-export type RecorderState = "idle" | "recording" | "stopping-record" | "check-error" | "title-blocked";
+/** 录制状态，idle: 空闲中，recording: 录制中，stopping-record: 停止录制中，check-error: 检查错误，title-blocked: 标题黑名单，charge-skipped: 充电直播(DRM加密)已跳过 */
+export type RecorderState = "idle" | "recording" | "stopping-record" | "check-error" | "title-blocked" | "charge-skipped";
 export type Progress = {
     time: string | null;
 };
+export interface RecorderTimelineItem {
+    startTime: number;
+    text: string;
+    endTime?: number;
+}
+export interface AppendRecorderTimelineArgs {
+    startTime?: number;
+    text: string;
+}
 export interface RecordHandle {
     id: string;
     stream: string;
@@ -106,6 +117,10 @@ export interface Recorder<E extends AnyObject = UnknownObject> extends Emitter<{
         cover?: string;
         rawFilename?: string;
     };
+    stateChange: {
+        state: RecorderState;
+        msg?: string;
+    };
     videoFileCompleted: {
         filename: string;
         stats?: XmlStreamStats;
@@ -118,6 +133,9 @@ export interface Recorder<E extends AnyObject = UnknownObject> extends Emitter<{
     Updated: (string | keyof Recorder)[];
     Message: Message;
     DebugLog: DebugLog;
+    ChargeLive: {
+        channelId: string;
+    };
 }>, RecorderCreateOpts<E> {
     id: string;
     extra: Partial<E>;
@@ -138,8 +156,13 @@ export interface Recorder<E extends AnyObject = UnknownObject> extends Emitter<{
         liveId?: string;
         recordStartTime: Date;
         area?: string;
+        liveType?: string;
+        liveTypeDesc?: string;
+        canRecord?: boolean;
     };
     tempStopIntervalCheck?: boolean;
+    timeline?: RecorderTimelineItem[];
+    appendTimeline: (args: AppendRecorderTimelineArgs) => RecorderTimelineItem[];
     /** 缓存实例（命名空间） */
     cache: NamespacedCache;
     getChannelURL: (this: Recorder<E>) => string;
@@ -160,10 +183,12 @@ export interface Recorder<E extends AnyObject = UnknownObject> extends Emitter<{
         liveStartTime: Date;
         area: string;
     }>;
-    getStream: (this: Recorder<E>) => Promise<{
+    getStream: (this: Recorder<E>, opts?: {
+        formatName?: FormatName;
+        formatPriorities?: Array<"flv" | "hls">;
+    }) => Promise<{
         source: string;
         name: string;
         url: string;
     }>;
 }
-export {};

package/lib/utils.d.ts

@@ -36,6 +36,10 @@ export declare function assertNumberType(data: unknown, msg?: string): asserts d
 export declare function assertObjectType(data: unknown, msg?: string): asserts data is object;
 export declare function formatDate(date: Date, format: string): string;
 export declare function removeSystemReservedChars(str: string): string;
+/**
+ * 替换四字节 Unicode 字符（如部分 emoji 表情）为指定字符。
+ */
+export declare function replaceFourByteUnicode(value: unknown, replacement?: string): string;
 export declare function isFfmpegStartSegment(line: string): boolean;
 export declare function isMesioStartSegment(line: string): boolean;
 export declare function isBililiveStartSegment(line: string): boolean;
@@ -125,6 +129,7 @@ declare const _default: {
     assertObjectType: typeof assertObjectType;
     asyncThrottle: typeof asyncThrottle;
     isFfmpegStartSegment: typeof isFfmpegStartSegment;
+    replaceFourByteUnicode: typeof replaceFourByteUnicode;
     createFFmpegInvalidStreamChecker: typeof createFFmpegInvalidStreamChecker;
     createTimeoutChecker: typeof createTimeoutChecker;
     downloadImage: typeof downloadImage;

package/lib/utils.js

@@ -124,6 +124,12 @@ export function formatDate(date, format) {
 export function removeSystemReservedChars(str) {
     return filenamify(str, { replacement: "_" });
 }
+/**
+ * 替换四字节 Unicode 字符（如部分 emoji 表情）为指定字符。
+ */
+export function replaceFourByteUnicode(value, replacement = "_") {
+    return String(value ?? "").replace(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, replacement);
+}
 export function isFfmpegStartSegment(line) {
     return line.includes("Opening ") && line.includes("for writing");
 }
@@ -460,10 +466,13 @@ export async function checkTitleKeywordsWhileRecording(recorder, isManualStart,
     const { title } = liveInfo;
     // 检查标题是否包含关键词
     if (hasBlockedTitleKeywords(title, recorder.titleKeywords)) {
-        recorder.state = "title-blocked";
+        recorder.emit("stateChange", {
+            state: "title-blocked",
+            msg: `停止录制，直播间标题 "${title}" 包含关键词 "${recorder.titleKeywords}"`,
+        });
         recorder.emit("DebugLog", {
             type: "common",
-            text: `检测到标题包含关键词，停止录制：直播间标题 "${title}" 包含关键词 "${recorder.titleKeywords}"`,
+            text: `停止录制，直播间标题 "${title}" 包含关键词 "${recorder.titleKeywords}"`,
         });
         // 停止录制
         await recorder?.recordHandle?.stop("直播间标题包含关键词");
@@ -485,10 +494,9 @@ export function checkTitleKeywordsBeforeRecord(title, recorder, isManualStart) {
         return false;
     }
     if (hasBlockedTitleKeywords(title, recorder.titleKeywords)) {
-        recorder.state = "title-blocked";
-        recorder.emit("DebugLog", {
-            type: "common",
-            text: `跳过录制：直播间标题 "${title}" 包含关键词 "${recorder.titleKeywords}"`,
+        recorder.emit("stateChange", {
+            state: "title-blocked",
+            msg: `跳过录制，直播间标题 "${title}" 包含关键词 "${recorder.titleKeywords}"`,
         });
         return true;
     }
@@ -505,6 +513,7 @@ export default {
     assertObjectType,
     asyncThrottle,
     isFfmpegStartSegment,
+    replaceFourByteUnicode,
     createFFmpegInvalidStreamChecker,
     createTimeoutChecker,
     downloadImage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bililive-tools/manager",
-  "version": "1.16.2",
+  "version": "1.17.1",
   "description": "Batch scheduling recorders",
   "main": "./lib/index.js",
   "type": "module",
@@ -33,14 +33,17 @@
   "license": "LGPL",
   "dependencies": {
     "@renmu/fluent-ffmpeg": "2.3.3",
-    "fast-xml-parser": "^4.5.0",
-    "filenamify": "^7.0.0",
-    "mitt": "^3.0.1",
-    "string-argv": "^0.3.2",
-    "lodash-es": "^4.17.21",
     "axios": "^1.15.0",
+    "ejs": "^3.1.10",
+    "fast-xml-parser": "^5.9.3",
+    "filenamify": "^7.0.0",
     "fs-extra": "^11.2.0",
-    "ejs": "^3.1.10"
+    "lodash-es": "^4.17.21",
+    "mitt": "^3.0.1",
+    "string-argv": "^0.3.2"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5"
   },
   "scripts": {
     "build": "pnpm run test && tsc",