@bilibili-notify/live 0.0.1-alpha.2 → 0.0.1-alpha.3

package/lib/index.cjs

@@ -168,11 +168,16 @@ var RoomContextBase = class {
 	liveSummaryRequester;
 	danmakuCollector;
 	/**
-	* 真实注入的渲染器引用,private 是因为外部应通过 `imageRenderer` getter 访问 ——
+	* 渲染器 provider —— private 是因为外部应通过 `imageRenderer` getter 访问 ——
 	* 后者会在 `config.imageEnabled === false` 时返回 null,让所有
 	* `if (this.imageRenderer?.generateXxx)` 自然落入文字回退分支。
+	* provider 形式让 LiveEngine 的 setImageRenderer 无需逐 RoomContext 推。
+	*
+	* **不要直接调 `this._getImageRenderer()` 绕过 imageEnabled 门控**,业务路径
+	* 必须通过 `this.imageRenderer` getter,否则用户在 dashboard 关掉卡片渲染时
+	* 这条路径仍会渲图。
 	*/
-	_imageRenderer;
+	_getImageRenderer;
 	emitEngineError;
 	_emitLiveState;
 	_emitViewers;
@@ -199,7 +204,7 @@ var RoomContextBase = class {
 		this.wordcloudGenerator = opts.wordcloudGenerator;
 		this.liveSummaryRequester = opts.liveSummaryRequester;
 		this.danmakuCollector = opts.danmakuCollector;
-		this._imageRenderer = opts.imageRenderer;
+		this._getImageRenderer = opts.getImageRenderer;
 		this.config = opts.config;
 		this.emitEngineError = opts.emitEngineError;
 		this._emitLiveState = opts.emitLiveState;
@@ -219,7 +224,7 @@ var RoomContextBase = class {
 	}
 	/** 受 `config.imageEnabled` 门控的渲染器视图;关闭时返回 null。 */
 	get imageRenderer() {
-		return this.config.imageEnabled === false ? null : this._imageRenderer;
+		return this.config.imageEnabled === false ? null : this._getImageRenderer();
 	}
 	updateConfig(config) {
 		this.config = config;
@@ -1576,11 +1581,11 @@ const WORDCLOUD_TOP_WORDS = 90;
 * platform (e.g. via `LiveContentBuilder.image`).
 */
 var WordcloudGenerator = class {
-	imageRenderer;
+	getImageRenderer;
 	isImageEnabled;
 	logger;
 	constructor(opts) {
-		this.imageRenderer = opts.imageRenderer;
+		this.getImageRenderer = opts.getImageRenderer;
 		this.isImageEnabled = opts.isImageEnabled ?? (() => true);
 		this.logger = opts.logger;
 	}
@@ -1602,9 +1607,10 @@ var WordcloudGenerator = class {
 			this.logger.debug("[wordcloud] cardStyle.enabled=false,跳过词云图片生成");
 			return;
 		}
-		if (!this.imageRenderer?.generateWordCloudImg) return void 0;
+		const renderer = this.getImageRenderer();
+		if (!renderer?.generateWordCloudImg) return void 0;
 		try {
-			return await this.imageRenderer.generateWordCloudImg(sortedWords.slice(0, 90), masterName, masterAvatarUrl);
+			return await renderer.generateWordCloudImg(sortedWords.slice(0, 90), masterName, masterAvatarUrl);
 		} catch (e) {
 			this.logger.error(`[wordcloud] 生成词云失败：${e.message}`);
 			return;
@@ -1634,14 +1640,22 @@ var LiveEngine = class {
 	danmakuCollector;
 	liveSummaryRequester;
 	config;
+	/**
+	* Image 渲染器的当前引用 —— 单一可变 state,setImageRenderer 在此更新;
+	* 所有子组件(wordcloud / listener / room-context)通过 provider 函数现取,
+	* 无需逐组件 setter 推送。
+	*/
+	currentImageRenderer;
 	constructor(opts) {
 		this.logger = opts.serviceCtx.logger;
 		this.config = opts.config;
+		this.currentImageRenderer = opts.imageRenderer ?? null;
+		const getImageRenderer = () => this.currentImageRenderer;
 		const stopwords = mergeStopWords(opts.config.wordcloudStopWords);
 		this.danmakuCollector = new DanmakuCollector(stopwords);
 		const templateRenderer = new LiveTemplateRenderer();
 		const wordcloudGenerator = new WordcloudGenerator({
-			imageRenderer: opts.imageRenderer ?? null,
+			getImageRenderer,
 			isImageEnabled: () => this.config.imageEnabled !== false,
 			logger: this.logger
 		});
@@ -1661,7 +1675,7 @@ var LiveEngine = class {
 			wordcloudGenerator,
 			liveSummaryRequester,
 			danmakuCollector: this.danmakuCollector,
-			imageRenderer: opts.imageRenderer ?? null,
+			getImageRenderer,
 			config: toListenerConfig(opts.config),
 			emitEngineError: opts.emitEngineError,
 			emitLiveState: opts.emitLiveState,
@@ -1744,6 +1758,17 @@ var LiveEngine = class {
 	setCommentary(commentary) {
 		this.liveSummaryRequester.setCommentary(commentary);
 	}
+	/**
+	* 热替换 ImageRenderer 实例。adapter 在 image 服务上下线时调用。子组件 (词云 /
+	* room-context / 卡片渲染) 都通过共享 provider 现取,这里只需更新单一 state。
+	*
+	* 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+	* 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+	* 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+	*/
+	setImageRenderer(imageRenderer) {
+		this.currentImageRenderer = imageRenderer;
+	}
 	/** Final dispose; the engine instance must not be reused after this. */
 	stop() {
 		this.listener.disposeAll();

package/lib/index.d.cts

@@ -433,11 +433,16 @@ declare const WORDCLOUD_TOP_WORDS = 90;
  * platform (e.g. via `LiveContentBuilder.image`).
  */
 declare class WordcloudGenerator {
-  private readonly imageRenderer;
+  private readonly getImageRenderer;
   private readonly isImageEnabled;
   private readonly logger;
   constructor(opts: {
-    imageRenderer: ImageRenderer | null;
+    /**
+     * 渲染器 provider —— 每次 generate() 现取最新引用,使 LiveEngine 在 image
+     * 服务上下线时通过 setImageRenderer 替换内部状态,词云生成自动同步,无需子组件
+     * 接 setter。
+     */
+    getImageRenderer: () => ImageRenderer | null;
     /**
      * 卡片渲染总开关查询。返回 false 时直接跳过 puppeteer 调用,与缺失 imageRenderer
      * 等价。Adapter 通常用 `() => globals.defaults.cardStyle.enabled` 填充;缺省 () => true。
@@ -502,7 +507,11 @@ interface RoomContextOptions {
   wordcloudGenerator: WordcloudGenerator;
   liveSummaryRequester: LiveSummaryRequester;
   danmakuCollector: DanmakuCollector;
-  imageRenderer: ImageRenderer | null;
+  /**
+   * 渲染器 provider —— LiveEngine 在 image 服务上下线时通过 setImageRenderer
+   * 替换内部状态;getter `imageRenderer` 每次现取,所有 RoomContext 自动同步。
+   */
+  getImageRenderer: () => ImageRenderer | null;
   config: ListenerManagerConfig;
   emitEngineError: (message: string) => void;
   /**
@@ -546,11 +555,16 @@ declare class RoomContextBase {
   readonly liveSummaryRequester: LiveSummaryRequester;
   readonly danmakuCollector: DanmakuCollector;
   /**
-   * 真实注入的渲染器引用,private 是因为外部应通过 `imageRenderer` getter 访问 ——
+   * 渲染器 provider —— private 是因为外部应通过 `imageRenderer` getter 访问 ——
    * 后者会在 `config.imageEnabled === false` 时返回 null,让所有
    * `if (this.imageRenderer?.generateXxx)` 自然落入文字回退分支。
+   * provider 形式让 LiveEngine 的 setImageRenderer 无需逐 RoomContext 推。
+   *
+   * **不要直接调 `this._getImageRenderer()` 绕过 imageEnabled 门控**,业务路径
+   * 必须通过 `this.imageRenderer` getter,否则用户在 dashboard 关掉卡片渲染时
+   * 这条路径仍会渲图。
    */
-  private readonly _imageRenderer;
+  private readonly _getImageRenderer;
   readonly emitEngineError: (message: string) => void;
   private readonly _emitLiveState;
   private readonly _emitViewers;
@@ -950,6 +964,12 @@ declare class LiveEngine {
   private readonly danmakuCollector;
   private readonly liveSummaryRequester;
   private config;
+  /**
+   * Image 渲染器的当前引用 —— 单一可变 state,setImageRenderer 在此更新;
+   * 所有子组件(wordcloud / listener / room-context)通过 provider 函数现取,
+   * 无需逐组件 setter 推送。
+   */
+  private currentImageRenderer;
   constructor(opts: LiveEngineOptions);
   /**
    * Bootstrap the engine with the initial subscription set. Idempotent —
@@ -973,6 +993,15 @@ declare class LiveEngine {
    * 配置后调用,引擎随后的直播总结会立即用新实例 (或回退到模板) ,无需重启 server。
    */
   setCommentary(commentary: CommentaryGenerator | null): void;
+  /**
+   * 热替换 ImageRenderer 实例。adapter 在 image 服务上下线时调用。子组件 (词云 /
+   * room-context / 卡片渲染) 都通过共享 provider 现取,这里只需更新单一 state。
+   *
+   * 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+   * 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+   * 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+   */
+  setImageRenderer(imageRenderer: ImageRenderer | null): void;
   /** Final dispose; the engine instance must not be reused after this. */
   stop(): void;
   /** Diagnostic accessor, used by the koishi shell for `[conn] state` logging. */

package/lib/index.d.mts

@@ -433,11 +433,16 @@ declare const WORDCLOUD_TOP_WORDS = 90;
  * platform (e.g. via `LiveContentBuilder.image`).
  */
 declare class WordcloudGenerator {
-  private readonly imageRenderer;
+  private readonly getImageRenderer;
   private readonly isImageEnabled;
   private readonly logger;
   constructor(opts: {
-    imageRenderer: ImageRenderer | null;
+    /**
+     * 渲染器 provider —— 每次 generate() 现取最新引用,使 LiveEngine 在 image
+     * 服务上下线时通过 setImageRenderer 替换内部状态,词云生成自动同步,无需子组件
+     * 接 setter。
+     */
+    getImageRenderer: () => ImageRenderer | null;
     /**
      * 卡片渲染总开关查询。返回 false 时直接跳过 puppeteer 调用,与缺失 imageRenderer
      * 等价。Adapter 通常用 `() => globals.defaults.cardStyle.enabled` 填充;缺省 () => true。
@@ -502,7 +507,11 @@ interface RoomContextOptions {
   wordcloudGenerator: WordcloudGenerator;
   liveSummaryRequester: LiveSummaryRequester;
   danmakuCollector: DanmakuCollector;
-  imageRenderer: ImageRenderer | null;
+  /**
+   * 渲染器 provider —— LiveEngine 在 image 服务上下线时通过 setImageRenderer
+   * 替换内部状态;getter `imageRenderer` 每次现取,所有 RoomContext 自动同步。
+   */
+  getImageRenderer: () => ImageRenderer | null;
   config: ListenerManagerConfig;
   emitEngineError: (message: string) => void;
   /**
@@ -546,11 +555,16 @@ declare class RoomContextBase {
   readonly liveSummaryRequester: LiveSummaryRequester;
   readonly danmakuCollector: DanmakuCollector;
   /**
-   * 真实注入的渲染器引用,private 是因为外部应通过 `imageRenderer` getter 访问 ——
+   * 渲染器 provider —— private 是因为外部应通过 `imageRenderer` getter 访问 ——
    * 后者会在 `config.imageEnabled === false` 时返回 null,让所有
    * `if (this.imageRenderer?.generateXxx)` 自然落入文字回退分支。
+   * provider 形式让 LiveEngine 的 setImageRenderer 无需逐 RoomContext 推。
+   *
+   * **不要直接调 `this._getImageRenderer()` 绕过 imageEnabled 门控**,业务路径
+   * 必须通过 `this.imageRenderer` getter,否则用户在 dashboard 关掉卡片渲染时
+   * 这条路径仍会渲图。
    */
-  private readonly _imageRenderer;
+  private readonly _getImageRenderer;
   readonly emitEngineError: (message: string) => void;
   private readonly _emitLiveState;
   private readonly _emitViewers;
@@ -950,6 +964,12 @@ declare class LiveEngine {
   private readonly danmakuCollector;
   private readonly liveSummaryRequester;
   private config;
+  /**
+   * Image 渲染器的当前引用 —— 单一可变 state,setImageRenderer 在此更新;
+   * 所有子组件(wordcloud / listener / room-context)通过 provider 函数现取,
+   * 无需逐组件 setter 推送。
+   */
+  private currentImageRenderer;
   constructor(opts: LiveEngineOptions);
   /**
    * Bootstrap the engine with the initial subscription set. Idempotent —
@@ -973,6 +993,15 @@ declare class LiveEngine {
    * 配置后调用,引擎随后的直播总结会立即用新实例 (或回退到模板) ,无需重启 server。
    */
   setCommentary(commentary: CommentaryGenerator | null): void;
+  /**
+   * 热替换 ImageRenderer 实例。adapter 在 image 服务上下线时调用。子组件 (词云 /
+   * room-context / 卡片渲染) 都通过共享 provider 现取,这里只需更新单一 state。
+   *
+   * 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+   * 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+   * 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+   */
+  setImageRenderer(imageRenderer: ImageRenderer | null): void;
   /** Final dispose; the engine instance must not be reused after this. */
   stop(): void;
   /** Diagnostic accessor, used by the koishi shell for `[conn] state` logging. */

package/lib/index.mjs

@@ -144,11 +144,16 @@ var RoomContextBase = class {
 	liveSummaryRequester;
 	danmakuCollector;
 	/**
-	* 真实注入的渲染器引用,private 是因为外部应通过 `imageRenderer` getter 访问 ——
+	* 渲染器 provider —— private 是因为外部应通过 `imageRenderer` getter 访问 ——
 	* 后者会在 `config.imageEnabled === false` 时返回 null,让所有
 	* `if (this.imageRenderer?.generateXxx)` 自然落入文字回退分支。
+	* provider 形式让 LiveEngine 的 setImageRenderer 无需逐 RoomContext 推。
+	*
+	* **不要直接调 `this._getImageRenderer()` 绕过 imageEnabled 门控**,业务路径
+	* 必须通过 `this.imageRenderer` getter,否则用户在 dashboard 关掉卡片渲染时
+	* 这条路径仍会渲图。
 	*/
-	_imageRenderer;
+	_getImageRenderer;
 	emitEngineError;
 	_emitLiveState;
 	_emitViewers;
@@ -175,7 +180,7 @@ var RoomContextBase = class {
 		this.wordcloudGenerator = opts.wordcloudGenerator;
 		this.liveSummaryRequester = opts.liveSummaryRequester;
 		this.danmakuCollector = opts.danmakuCollector;
-		this._imageRenderer = opts.imageRenderer;
+		this._getImageRenderer = opts.getImageRenderer;
 		this.config = opts.config;
 		this.emitEngineError = opts.emitEngineError;
 		this._emitLiveState = opts.emitLiveState;
@@ -195,7 +200,7 @@ var RoomContextBase = class {
 	}
 	/** 受 `config.imageEnabled` 门控的渲染器视图;关闭时返回 null。 */
 	get imageRenderer() {
-		return this.config.imageEnabled === false ? null : this._imageRenderer;
+		return this.config.imageEnabled === false ? null : this._getImageRenderer();
 	}
 	updateConfig(config) {
 		this.config = config;
@@ -1552,11 +1557,11 @@ const WORDCLOUD_TOP_WORDS = 90;
 * platform (e.g. via `LiveContentBuilder.image`).
 */
 var WordcloudGenerator = class {
-	imageRenderer;
+	getImageRenderer;
 	isImageEnabled;
 	logger;
 	constructor(opts) {
-		this.imageRenderer = opts.imageRenderer;
+		this.getImageRenderer = opts.getImageRenderer;
 		this.isImageEnabled = opts.isImageEnabled ?? (() => true);
 		this.logger = opts.logger;
 	}
@@ -1578,9 +1583,10 @@ var WordcloudGenerator = class {
 			this.logger.debug("[wordcloud] cardStyle.enabled=false,跳过词云图片生成");
 			return;
 		}
-		if (!this.imageRenderer?.generateWordCloudImg) return void 0;
+		const renderer = this.getImageRenderer();
+		if (!renderer?.generateWordCloudImg) return void 0;
 		try {
-			return await this.imageRenderer.generateWordCloudImg(sortedWords.slice(0, 90), masterName, masterAvatarUrl);
+			return await renderer.generateWordCloudImg(sortedWords.slice(0, 90), masterName, masterAvatarUrl);
 		} catch (e) {
 			this.logger.error(`[wordcloud] 生成词云失败：${e.message}`);
 			return;
@@ -1610,14 +1616,22 @@ var LiveEngine = class {
 	danmakuCollector;
 	liveSummaryRequester;
 	config;
+	/**
+	* Image 渲染器的当前引用 —— 单一可变 state,setImageRenderer 在此更新;
+	* 所有子组件(wordcloud / listener / room-context)通过 provider 函数现取,
+	* 无需逐组件 setter 推送。
+	*/
+	currentImageRenderer;
 	constructor(opts) {
 		this.logger = opts.serviceCtx.logger;
 		this.config = opts.config;
+		this.currentImageRenderer = opts.imageRenderer ?? null;
+		const getImageRenderer = () => this.currentImageRenderer;
 		const stopwords = mergeStopWords(opts.config.wordcloudStopWords);
 		this.danmakuCollector = new DanmakuCollector(stopwords);
 		const templateRenderer = new LiveTemplateRenderer();
 		const wordcloudGenerator = new WordcloudGenerator({
-			imageRenderer: opts.imageRenderer ?? null,
+			getImageRenderer,
 			isImageEnabled: () => this.config.imageEnabled !== false,
 			logger: this.logger
 		});
@@ -1637,7 +1651,7 @@ var LiveEngine = class {
 			wordcloudGenerator,
 			liveSummaryRequester,
 			danmakuCollector: this.danmakuCollector,
-			imageRenderer: opts.imageRenderer ?? null,
+			getImageRenderer,
 			config: toListenerConfig(opts.config),
 			emitEngineError: opts.emitEngineError,
 			emitLiveState: opts.emitLiveState,
@@ -1720,6 +1734,17 @@ var LiveEngine = class {
 	setCommentary(commentary) {
 		this.liveSummaryRequester.setCommentary(commentary);
 	}
+	/**
+	* 热替换 ImageRenderer 实例。adapter 在 image 服务上下线时调用。子组件 (词云 /
+	* room-context / 卡片渲染) 都通过共享 provider 现取,这里只需更新单一 state。
+	*
+	* 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+	* 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+	* 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+	*/
+	setImageRenderer(imageRenderer) {
+		this.currentImageRenderer = imageRenderer;
+	}
 	/** Final dispose; the engine instance must not be reused after this. */
 	stop() {
 		this.listener.disposeAll();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilibili-notify/live",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/Akokk0/bilibili-notify"
@@ -32,8 +32,8 @@
     "protobufjs": "^7.4.0",
     "@bilibili-notify/api": "^0.2.0-alpha.2",
     "@bilibili-notify/ai": "^0.0.1-alpha.1",
-    "@bilibili-notify/image": "^0.0.1-alpha.2",
-    "@bilibili-notify/internal": "^0.1.0-alpha.2"
+    "@bilibili-notify/internal": "^0.1.0-alpha.2",
+    "@bilibili-notify/image": "^0.0.1-alpha.2"
   },
   "devDependencies": {
     "@types/luxon": "^3.4.2",