@bililive-tools/manager 1.6.0 → 1.6.1

package/lib/index.d.ts

@@ -18,7 +18,7 @@ export declare function defaultToJSON<E extends AnyObject>(provider: RecorderPro
 export declare function genRecorderUUID(): Recorder["id"];
 export declare function genRecordUUID(): RecordHandle["id"];
 export declare function setFFMPEGPath(newPath: string): void;
-export declare const createFFMPEGBuilder: (input?: string | import("stream").Readable | undefined, options?: ffmpeg.FfmpegCommandOptions | undefined) => ffmpeg.FfmpegCommand;
+export declare const createFFMPEGBuilder: (...args: Parameters<typeof ffmpeg>) => ffmpeg.FfmpegCommand;
 export declare function setMesioPath(newPath: string): void;
 export declare function getMesioPath(): string;
 export declare function getDataFolderPath<E extends AnyObject>(provider: RecorderProvider<E>): string;

package/lib/manager.d.ts

@@ -13,7 +13,7 @@ export interface RecorderProvider<E extends AnyObject> {
         id: ChannelId;
         title: string;
         owner: string;
-        uid?: number;
+        uid?: number | string;
         avatar?: string;
     } | null>;
     createRecorder: (this: RecorderProvider<E>, opts: Omit<RecorderCreateOpts<E>, "providerId">) => Recorder<E>;

package/lib/recorder/FFMPEGRecorder.d.ts

@@ -1,42 +1,28 @@
 import EventEmitter from "node:events";
-export declare class FFMPEGRecorder extends EventEmitter {
+import { IRecorder, FFMPEGRecorderOptions } from "./IRecorder.js";
+export declare class FFMPEGRecorder extends EventEmitter implements IRecorder {
     private onEnd;
     private onUpdateLiveInfo;
     private command;
     private streamManager;
     private timeoutChecker;
-    hasSegment: boolean;
-    getSavePath: (data: {
+    readonly hasSegment: boolean;
+    readonly getSavePath: (data: {
         startTime: number;
         title?: string;
     }) => string;
-    segment: number;
+    readonly segment: number;
     ffmpegOutputOptions: string[];
-    inputOptions: string[];
-    isHls: boolean;
-    disableDanma: boolean;
-    url: string;
+    readonly inputOptions: string[];
+    readonly isHls: boolean;
+    readonly disableDanma: boolean;
+    readonly url: string;
     formatName: "flv" | "ts" | "fmp4";
     videoFormat: "ts" | "mkv" | "mp4";
-    headers: {
+    readonly headers: {
         [key: string]: string | undefined;
     } | undefined;
-    constructor(opts: {
-        url: string;
-        getSavePath: (data: {
-            startTime: number;
-            title?: string;
-        }) => string;
-        segment: number;
-        outputOptions: string[];
-        inputOptions?: string[];
-        disableDanma?: boolean;
-        videoFormat?: "auto" | "ts" | "mkv" | "mp4";
-        formatName?: "flv" | "ts" | "fmp4";
-        headers?: {
-            [key: string]: string | undefined;
-        };
-    }, onEnd: (...args: unknown[]) => void, onUpdateLiveInfo: () => Promise<{
+    constructor(opts: FFMPEGRecorderOptions, onEnd: (...args: unknown[]) => void, onUpdateLiveInfo: () => Promise<{
         title?: string;
         cover?: string;
     }>);
@@ -47,5 +33,5 @@ export declare class FFMPEGRecorder extends EventEmitter {
     run(): void;
     getArguments(): string[];
     stop(): Promise<void>;
-    getExtraDataController(): import("../record_extra_data_controller.js").RecordExtraDataController | null;
+    getExtraDataController(): import("../xml_stream_controller.js").XmlStreamController | null;
 }

package/lib/recorder/IRecorder.d.ts

@@ -0,0 +1,81 @@
+import { EventEmitter } from "node:events";
+/**
+ * 录制器构造函数选项的基础接口
+ */
+export interface BaseRecorderOptions {
+    url: string;
+    getSavePath: (data: {
+        startTime: number;
+        title?: string;
+    }) => string;
+    segment: number;
+    inputOptions?: string[];
+    disableDanma?: boolean;
+    formatName?: "flv" | "ts" | "fmp4";
+    headers?: {
+        [key: string]: string | undefined;
+    };
+}
+/**
+ * 录制器接口定义
+ */
+export interface IRecorder extends EventEmitter {
+    readonly hasSegment: boolean;
+    readonly segment: number;
+    readonly inputOptions: string[];
+    readonly isHls: boolean;
+    readonly disableDanma: boolean;
+    readonly url: string;
+    readonly headers: {
+        [key: string]: string | undefined;
+    } | undefined;
+    readonly getSavePath: (data: {
+        startTime: number;
+        title?: string;
+    }) => string;
+    run(): void;
+    stop(): Promise<void>;
+    getArguments(): string[];
+    getExtraDataController(): any;
+    createCommand(): any;
+    on(event: "videoFileCreated", listener: (data: {
+        filename: string;
+        cover?: string;
+    }) => void): this;
+    on(event: "videoFileCompleted", listener: (data: {
+        filename: string;
+    }) => void): this;
+    on(event: "DebugLog", listener: (data: {
+        type: string;
+        text: string;
+    }) => 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;
+    }): boolean;
+    emit(event: "videoFileCompleted", data: {
+        filename: string;
+    }): boolean;
+    emit(event: "DebugLog", data: {
+        type: string;
+        text: string;
+    }): boolean;
+    emit(event: "progress", info: any): boolean;
+    emit(event: string, ...args: any[]): boolean;
+}
+/**
+ * FFMPEG录制器特定选项
+ */
+export interface FFMPEGRecorderOptions extends BaseRecorderOptions {
+    outputOptions: string[];
+    videoFormat?: "auto" | "ts" | "mkv" | "mp4";
+}
+/**
+ * Mesio录制器特定选项
+ */
+export interface MesioRecorderOptions extends BaseRecorderOptions {
+    outputOptions?: string[];
+    isHls?: boolean;
+}

package/lib/recorder/IRecorder.js

@@ -0,0 +1 @@
+export {};

package/lib/recorder/index.d.ts

@@ -2,39 +2,11 @@ import { FFMPEGRecorder } from "./FFMPEGRecorder.js";
 import { mesioRecorder } from "./mesioRecorder.js";
 export { FFMPEGRecorder } from "./FFMPEGRecorder.js";
 export { mesioRecorder } from "./mesioRecorder.js";
+import type { IRecorder, FFMPEGRecorderOptions, MesioRecorderOptions } from "./IRecorder.js";
 /**
  * 录制器类型
  */
 export type RecorderType = "ffmpeg" | "mesio";
-/**
- * 录制器基础配置选项
- */
-export interface BaseRecorderOptions {
-    url: string;
-    getSavePath: (data: {
-        startTime: number;
-        title?: string;
-    }) => string;
-    segment: number;
-    inputOptions?: string[];
-    disableDanma?: boolean;
-    videoFormat?: "auto" | "ts" | "mkv";
-    formatName?: "flv" | "ts" | "fmp4";
-    headers?: {
-        [key: string]: string | undefined;
-    };
-}
-/**
- * FFMPEG录制器配置选项
- */
-export interface FFMPEGRecorderOptions extends BaseRecorderOptions {
-    outputOptions: string[];
-}
-/**
- * Mesio录制器配置选项
- */
-export interface MesioRecorderOptions extends BaseRecorderOptions {
-}
 /**
  * 根据录制器类型获取对应的配置选项类型
  */
@@ -45,36 +17,10 @@ export type RecorderOptions<T extends RecorderType> = T extends "ffmpeg" ? FFMPE
 export type RecorderInstance<T extends RecorderType> = T extends "ffmpeg" ? FFMPEGRecorder : mesioRecorder;
 /**
  * 创建录制器的工厂函数
- *
- * @example
- * ```typescript
- * // 创建 FFMPEG 录制器
- * const ffmpegRecorder = createRecorder("ffmpeg", {
- *   url: "https://example.com/stream.m3u8",
- *   getSavePath: ({ startTime, title }) => `/recordings/${title}_${startTime}.ts`,
- *   segment: 30,
- *   outputOptions: ["-c", "copy"],
- *   inputOptions: ["-user_agent", "Custom-Agent"]
- * }, onEnd, onUpdateLiveInfo);
- *
- * // 创建 Mesio 录制器
- * const mesioRecorder = createRecorder("mesio", {
- *   url: "https://example.com/stream.m3u8",
- *   getSavePath: ({ startTime, title }) => `/recordings/${title}_${startTime}.ts`,
- *   segment: 30,
- *   inputOptions: ["--fix"]
- * }, onEnd, onUpdateLiveInfo);
- * ```
- *
- * @param type 录制器类型
- * @param opts 录制器配置选项
- * @param onEnd 录制结束回调
- * @param onUpdateLiveInfo 更新直播信息回调
- * @returns 对应类型的录制器实例
  */
 export declare function createBaseRecorder<T extends RecorderType>(type: T, opts: RecorderOptions<T> & {
     mesioOptions?: string[];
 }, onEnd: (...args: unknown[]) => void, onUpdateLiveInfo: () => Promise<{
     title?: string;
     cover?: string;
-}>): RecorderInstance<T>;
+}>): IRecorder;

package/lib/recorder/index.js

@@ -4,32 +4,6 @@ export { FFMPEGRecorder } from "./FFMPEGRecorder.js";
 export { mesioRecorder } from "./mesioRecorder.js";
 /**
  * 创建录制器的工厂函数
- *
- * @example
- * ```typescript
- * // 创建 FFMPEG 录制器
- * const ffmpegRecorder = createRecorder("ffmpeg", {
- *   url: "https://example.com/stream.m3u8",
- *   getSavePath: ({ startTime, title }) => `/recordings/${title}_${startTime}.ts`,
- *   segment: 30,
- *   outputOptions: ["-c", "copy"],
- *   inputOptions: ["-user_agent", "Custom-Agent"]
- * }, onEnd, onUpdateLiveInfo);
- *
- * // 创建 Mesio 录制器
- * const mesioRecorder = createRecorder("mesio", {
- *   url: "https://example.com/stream.m3u8",
- *   getSavePath: ({ startTime, title }) => `/recordings/${title}_${startTime}.ts`,
- *   segment: 30,
- *   inputOptions: ["--fix"]
- * }, onEnd, onUpdateLiveInfo);
- * ```
- *
- * @param type 录制器类型
- * @param opts 录制器配置选项
- * @param onEnd 录制结束回调
- * @param onUpdateLiveInfo 更新直播信息回调
- * @returns 对应类型的录制器实例
  */
 export function createBaseRecorder(type, opts, onEnd, onUpdateLiveInfo) {
     if (type === "ffmpeg") {

package/lib/recorder/mesioRecorder.d.ts

@@ -1,4 +1,5 @@
 import EventEmitter from "node:events";
+import { IRecorder, MesioRecorderOptions } from "./IRecorder.js";
 declare class MesioCommand extends EventEmitter {
     private _input;
     private _output;
@@ -14,40 +15,25 @@ declare class MesioCommand extends EventEmitter {
     kill(signal?: NodeJS.Signals): void;
 }
 export declare const createMesioBuilder: () => MesioCommand;
-export declare class mesioRecorder extends EventEmitter {
+export declare class mesioRecorder extends EventEmitter implements IRecorder {
     private onEnd;
     private onUpdateLiveInfo;
     private command;
     private streamManager;
-    hasSegment: boolean;
-    getSavePath: (data: {
+    readonly hasSegment: boolean;
+    readonly getSavePath: (data: {
         startTime: number;
         title?: string;
     }) => string;
-    segment: number;
-    inputOptions: string[];
-    isHls: boolean;
-    disableDanma: boolean;
-    url: string;
-    headers: {
+    readonly segment: number;
+    readonly inputOptions: string[];
+    readonly isHls: boolean;
+    readonly disableDanma: boolean;
+    readonly url: string;
+    readonly headers: {
         [key: string]: string | undefined;
     } | undefined;
-    constructor(opts: {
-        url: string;
-        getSavePath: (data: {
-            startTime: number;
-            title?: string;
-        }) => string;
-        segment: number;
-        outputOptions?: string[];
-        inputOptions?: string[];
-        isHls?: boolean;
-        disableDanma?: boolean;
-        formatName?: "flv" | "ts" | "fmp4";
-        headers?: {
-            [key: string]: string | undefined;
-        };
-    }, onEnd: (...args: unknown[]) => void, onUpdateLiveInfo: () => Promise<{
+    constructor(opts: MesioRecorderOptions, onEnd: (...args: unknown[]) => void, onUpdateLiveInfo: () => Promise<{
         title?: string;
         cover?: string;
     }>);
@@ -55,6 +41,6 @@ export declare class mesioRecorder extends EventEmitter {
     run(): void;
     getArguments(): string[];
     stop(): Promise<void>;
-    getExtraDataController(): import("../record_extra_data_controller.js").RecordExtraDataController | null;
+    getExtraDataController(): import("../xml_stream_controller.js").XmlStreamController | null;
 }
 export {};

package/lib/recorder/mesioRecorder.js

@@ -64,6 +64,7 @@ class MesioCommand extends EventEmitter {
         this.process.on("error", (error) => {
             this.emit("error", error);
         });
+        [];
         this.process.on("close", (code) => {
             if (code === 0) {
                 this.emit("end");

package/lib/recorder/streamManager.d.ts

@@ -1,5 +1,5 @@
 import EventEmitter from "node:events";
-import { createRecordExtraDataController } from "../record_extra_data_controller.js";
+import { createRecordExtraDataController } from "../xml_stream_controller.js";
 import type { RecorderCreateOpts } from "../recorder.js";
 export type GetSavePath = (data: {
     startTime: number;
@@ -44,7 +44,7 @@ export declare class StreamManager extends EventEmitter {
     });
     handleVideoStarted(stderrLine: string): Promise<void>;
     handleVideoCompleted(): Promise<void>;
-    getExtraDataController(): import("../record_extra_data_controller.js").RecordExtraDataController | null;
+    getExtraDataController(): import("../xml_stream_controller.js").XmlStreamController | null;
     get videoExt(): VideoFormat;
     get videoFilePath(): string;
 }

package/lib/recorder/streamManager.js

@@ -1,6 +1,6 @@
 import EventEmitter from "node:events";
 import fs from "fs/promises";
-import { createRecordExtraDataController } from "../record_extra_data_controller.js";
+import { createRecordExtraDataController } from "../xml_stream_controller.js";
 import { replaceExtName, ensureFolderExist, isFfmpegStartSegment, isMesioStartSegment, isFfmpegStart, retry, cleanTerminalText, } from "../utils.js";
 export class Segment extends EventEmitter {
     extraDataController = null;
@@ -64,13 +64,13 @@ export class Segment extends EventEmitter {
         });
         ensureFolderExist(this.outputVideoFilePath);
         if (!this.disableDanma) {
-            this.extraDataController = createRecordExtraDataController(`${this.outputVideoFilePath}.json`);
+            this.extraDataController = createRecordExtraDataController(`${this.outputVideoFilePath}.xml`);
         }
         // 支持两种格式的正则表达式
         // 1. FFmpeg格式: Opening 'filename' for writing
         // 2. Mesio格式: Opening FLV segment path=filename Processing
         const ffmpegRegex = /'([^']+)'/;
-        const mesioRegex = /segment path=([^\n]*)/i;
+        const mesioRegex = /segment path=(.+?\.(?:flv|ts|m4s))/is;
         let match = stderrLine.match(ffmpegRegex);
         if (!match) {
             match = cleanTerminalText(stderrLine).match(mesioRegex);
@@ -122,7 +122,7 @@ export class StreamManager extends EventEmitter {
             });
         }
         else {
-            const extraDataSavePath = replaceExtName(recordSavePath, ".json");
+            const extraDataSavePath = replaceExtName(recordSavePath, ".xml");
             if (!disableDanma) {
                 this.extraDataController = createRecordExtraDataController(extraDataSavePath);
             }

package/lib/recorder.d.ts

@@ -10,6 +10,7 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     channelId: ChannelId;
     id?: string;
     remarks?: string;
+    weight?: number;
     disableAutoCheck?: boolean;
     disableProvideCommentsWhenRecording?: boolean;
     quality: Quality;
@@ -25,7 +26,7 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     /** 身份验证 */
     auth?: string;
     /** cookie所有者uid,B站弹幕录制 */
-    uid?: number;
+    uid?: number | string;
     /** 画质匹配重试次数 */
     qualityRetry?: number;
     /** 抖音是否使用双屏直播流，开启后如果是双屏直播，那么就使用拼接的流，默认为true */
@@ -38,8 +39,8 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     formatName?: FormatName;
     /** 流编码 */
     codecName?: CodecName;
-    /** 选择使用的api，虎牙支持: auto,web,mp，抖音支持：web,webHTML */
-    api?: "auto" | "web" | "mp" | "webHTML";
+    /** 选择使用的api，虎牙支持: auto,web,mp，抖音支持：web,webHTML,mobile,userHTML */
+    api?: "auto" | "web" | "mp" | "webHTML" | "mobile" | "userHTML";
     /** 标题关键词，如果直播间标题包含这些关键词，则不会自动录制（仅对斗鱼有效），多个关键词用英文逗号分隔 */
     titleKeywords?: string;
     /** 用于指定录制文件格式，auto时，分段使用ts，不分段使用mp4 */
@@ -58,7 +59,7 @@ export interface RecorderCreateOpts<E extends AnyObject = UnknownObject> {
     cache: Cache;
 }
 export type SerializedRecorder<E extends AnyObject> = PickRequired<RecorderCreateOpts<E>, "id"> & Pick<Recorder<E>, "id" | "channelId" | "remarks" | "disableAutoCheck" | "quality" | "streamPriorities" | "sourcePriorities" | "extra" | "segment" | "saveSCDanma" | "saveCover" | "saveGiftDanma" | "disableProvideCommentsWhenRecording" | "liveInfo" | "uid" | "titleKeywords">;
-export type RecorderState = "idle" | "recording" | "stopping-record";
+export type RecorderState = "idle" | "recording" | "stopping-record" | "check-error";
 export type Progress = {
     time: string | null;
 };
@@ -110,7 +111,7 @@ export interface Recorder<E extends AnyObject = UnknownObject> extends Emitter<{
     state: RecorderState;
     qualityMaxRetry: number;
     qualityRetry: number;
-    uid?: number;
+    uid?: number | string;
     liveInfo?: {
         living: boolean;
         owner: string;

package/lib/xml_stream_controller.d.ts

@@ -0,0 +1,23 @@
+import { Message } from "./common.js";
+export interface XmlStreamData {
+    meta: {
+        title?: string;
+        recordStartTimestamp: number;
+        recordStopTimestamp?: number;
+        liveStartTimestamp?: number;
+        ffmpegArgs?: string[];
+        platform?: string;
+        user_name?: string;
+        room_id?: string;
+    };
+    /** 缓存的消息，待写入到文件 */
+    pendingMessages: Message[];
+}
+export interface XmlStreamController {
+    /** 设计上来说，外部程序不应该能直接修改 data 上的东西 */
+    readonly data: XmlStreamData;
+    addMessage: (message: Message) => void;
+    setMeta: (meta: Partial<XmlStreamData["meta"]>) => void;
+    flush: () => Promise<void>;
+}
+export declare function createRecordExtraDataController(savePath: string): XmlStreamController;

package/lib/xml_stream_controller.js

@@ -0,0 +1,240 @@
+/**
+ * XML流式写入控制器，用于实时写入弹幕、礼物等信息到XML文件
+ * 相比原有的json方案，这个实现每隔5秒就会写入数据，减少内存占用和数据丢失风险
+ */
+import fs from "node:fs";
+import { XMLBuilder } from "fast-xml-parser";
+import { pick } from "lodash-es";
+import { asyncThrottle } from "./utils.js";
+export function createRecordExtraDataController(savePath) {
+    const data = {
+        meta: {
+            recordStartTimestamp: Date.now(),
+        },
+        pendingMessages: [],
+    };
+    let hasCompleted = false;
+    let isWriting = false;
+    let isInitialized = false;
+    // 初始化文件
+    const initializeFile = async () => {
+        if (isInitialized)
+            return;
+        isInitialized = true;
+        try {
+            // 创建XML文件头，使用占位符预留metadata位置
+            const header = `<?xml version="1.0" encoding="utf-8"?>\n<i>\n<!--METADATA_PLACEHOLDER-->\n`;
+            await fs.promises.writeFile(savePath, header);
+        }
+        catch (error) {
+            console.error("初始化XML文件失败:", error);
+            isInitialized = false;
+            throw error;
+        }
+    };
+    // 每10秒写入一次数据
+    const scheduleWrite = asyncThrottle(() => writeToFile(), 10e3, {
+        immediateRunWhenEndOfDefer: true,
+    });
+    const writeToFile = async () => {
+        if (isWriting || hasCompleted || data.pendingMessages.length === 0) {
+            return;
+        }
+        // 确保文件已初始化
+        await initializeFile();
+        isWriting = true;
+        try {
+            // 获取待写入的消息
+            const messagesToWrite = [...data.pendingMessages];
+            data.pendingMessages = [];
+            // 生成XML内容
+            const xmlContent = generateXmlContent(data.meta, messagesToWrite);
+            // 追加写入文件
+            await appendToXmlFile(savePath, xmlContent);
+        }
+        catch (error) {
+            console.error("写入XML文件失败:", error);
+            // 如果写入失败，将消息重新加入队列
+            data.pendingMessages = [...data.pendingMessages];
+        }
+        finally {
+            isWriting = false;
+        }
+    };
+    const addMessage = (message) => {
+        if (hasCompleted)
+            return;
+        // if (!isInitialized) return;
+        data.pendingMessages.push(message);
+        // 确保文件已初始化
+        initializeFile().catch(console.error);
+        scheduleWrite();
+    };
+    const setMeta = (meta) => {
+        if (hasCompleted)
+            return;
+        data.meta = {
+            ...data.meta,
+            ...meta,
+        };
+    };
+    const flush = async () => {
+        if (hasCompleted)
+            return;
+        hasCompleted = true;
+        scheduleWrite.cancel();
+        await initializeFile().catch(console.error);
+        // 写入剩余的数据
+        if (data.pendingMessages.length > 0) {
+            await writeToFile();
+        }
+        // 完成XML文件（添加结束标签等）
+        await finalizeXmlFile(savePath, data.meta);
+        // 清理内存
+        data.pendingMessages = [];
+    };
+    return {
+        data,
+        addMessage,
+        setMeta,
+        flush,
+    };
+}
+/**
+ * 生成XML内容片段
+ */
+function generateXmlContent(metadata, messages) {
+    const builder = new XMLBuilder({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@@",
+        format: true,
+    });
+    const comments = messages
+        .filter((item) => item.type === "comment")
+        .map((ele) => {
+        const progress = Math.max((ele.timestamp - metadata.recordStartTimestamp) / 1000, 0);
+        const data = {
+            "@@p": "",
+            "@@progress": progress,
+            "@@mode": String(ele.mode ?? 1),
+            "@@fontsize": String(25),
+            "@@color": String(parseInt((ele.color || "#ffffff").replace("#", ""), 16)),
+            "@@midHash": String(ele?.sender?.uid),
+            "#text": String(ele?.text || ""),
+            "@@ctime": String(ele.timestamp),
+            "@@pool": String(0),
+            "@@weight": String(0),
+            "@@user": String(ele.sender?.name),
+            "@@uid": String(ele?.sender?.uid),
+            "@@timestamp": String(ele.timestamp),
+        };
+        data["@@p"] = [
+            data["@@progress"],
+            data["@@mode"],
+            data["@@fontsize"],
+            data["@@color"],
+            data["@@ctime"],
+            data["@@pool"],
+            data["@@midHash"],
+            data["@@uid"],
+            data["@@weight"],
+        ].join(",");
+        return pick(data, ["@@p", "#text", "@@user", "@@uid", "@@timestamp"]);
+    });
+    const gifts = messages
+        .filter((item) => item.type === "give_gift")
+        .map((ele) => {
+        const progress = Math.max((ele.timestamp - metadata.recordStartTimestamp) / 1000, 0);
+        return {
+            "@@ts": progress,
+            "@@giftname": String(ele.name),
+            "@@giftcount": String(ele.count),
+            "@@price": String(ele.price * 1000),
+            "@@user": String(ele.sender?.name),
+            "@@uid": String(ele?.sender?.uid),
+            "@@timestamp": String(ele.timestamp),
+        };
+    });
+    const superChats = messages
+        .filter((item) => item.type === "super_chat")
+        .map((ele) => {
+        const progress = Math.max((ele.timestamp - metadata.recordStartTimestamp) / 1000, 0);
+        return {
+            "@@ts": progress,
+            "@@price": String(ele.price * 1000),
+            "#text": String(ele.text),
+            "@@user": String(ele.sender?.name),
+            "@@uid": String(ele?.sender?.uid),
+            "@@timestamp": String(ele.timestamp),
+        };
+    });
+    const guardGift = messages
+        .filter((item) => item.type === "guard")
+        .map((ele) => {
+        const progress = Math.max((ele.timestamp - metadata.recordStartTimestamp) / 1000, 0);
+        return {
+            "@@ts": progress,
+            "@@price": String(ele.price * 1000),
+            "@@giftname": String(ele.name),
+            "@@giftcount": String(ele.count),
+            "@@level": String(ele.level),
+            "@@user": String(ele.sender?.name),
+            "@@uid": String(ele?.sender?.uid),
+            "@@timestamp": String(ele.timestamp),
+        };
+    });
+    // 构建这一批消息的XML片段
+    const fragment = {
+        d: comments,
+        gift: gifts,
+        sc: superChats,
+        guard: guardGift,
+    };
+    return builder.build(fragment);
+}
+/**
+ * 追加内容到XML文件
+ */
+async function appendToXmlFile(filePath, content) {
+    try {
+        // 直接追加内容
+        await fs.promises.appendFile(filePath, content);
+    }
+    catch (error) {
+        console.error(`写入XML文件失败: ${filePath}`, error);
+        throw error;
+    }
+}
+/**
+ * 完成XML文件写入
+ */
+async function finalizeXmlFile(filePath, metadata) {
+    try {
+        const builder = new XMLBuilder({
+            ignoreAttributes: false,
+            attributeNamePrefix: "@@",
+            format: true,
+        });
+        // 生成metadata XML
+        const metadataXml = builder.build({
+            metadata: {
+                platform: metadata.platform,
+                video_start_time: metadata.recordStartTimestamp,
+                live_start_time: metadata.liveStartTimestamp,
+                room_title: metadata.title,
+                user_name: metadata.user_name,
+                room_id: metadata.room_id,
+            },
+        });
+        // 读取文件内容
+        const content = await fs.promises.readFile(filePath, "utf-8");
+        // 替换占位符为实际的metadata，并添加结束标签
+        const finalContent = content.replace("<!--METADATA_PLACEHOLDER-->", metadataXml) + "</i>";
+        // 写回文件
+        await fs.promises.writeFile(filePath, finalContent);
+    }
+    catch (error) {
+        console.error(`完成XML文件写入失败: ${filePath}`, error);
+        throw error;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bililive-tools/manager",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Batch scheduling recorders",
   "main": "./lib/index.js",
   "type": "module",
@@ -34,7 +34,7 @@
   "dependencies": {
     "@renmu/fluent-ffmpeg": "2.3.3",
     "fast-xml-parser": "^4.5.0",
-    "filenamify": "^6.0.0",
+    "filenamify": "^7.0.0",
     "mitt": "^3.0.1",
     "string-argv": "^0.3.2",
     "lodash-es": "^4.17.21",