@bilibili-notify/dynamic 0.0.1-alpha.2 → 0.1.0-alpha.4

package/lib/index.cjs

@@ -105,6 +105,27 @@ const LOG_TAG = "bilibili-notify-dynamic";
 * 后即自愈,无需人工重启进程。
 */
 const DETECTOR_RESTART_BACKOFF_MS = 5 * 6e4;
+/**
+* 动态推送文本模板的内建兜底,仅在 adapter 未填 config.dynamicTemplate /
+* videoTemplate 时使用(真实 adapter 都会从 globals.defaults.templates 填充)。
+* 与 `@bilibili-notify/internal` 的 `DEFAULT_TEMPLATES.dynamic/.dynamicVideo`
+* 保持一致。变量 `{name}`(UP 名) / `{url}`(链接,未启用 URL 时为空)。
+*/
+const DEFAULT_DYNAMIC_TEXT = {
+	dynamic: "{name}发布了一条动态：{url}",
+	video: "{name}发布了新视频：{url}"
+};
+/**
+* 渲染动态推送文本:`{name}` / `{url}` 插值 + `\n` 展开。`url` 为空(未启用 URL)
+* 时连同 `{url}` 的前导分隔符一起去掉,避免行尾残留孤立的「：」。两个推送分支
+* (有图 / 无图)都走此函数 → 文字内容一致。
+*/
+function renderDynamicText(template, name, url) {
+	return (0, _bilibili_notify_internal.interpolate)(url ? template : template.replace(/\s*[：:]?\s*\{url\}/g, ""), {
+		name,
+		url
+	}).replaceAll("\\n", "\n");
+}
 /** 从动态数据中提取图片 URL，用于多模态 AI 点评（最多 4 张） */
 function extractDynamicImages(item) {
 	const mod = item.modules.module_dynamic;
@@ -233,6 +254,17 @@ var DynamicEngine = class {
 	setAi(ai) {
 		this.ai = ai;
 	}
+	/**
+	* 热替换 ImageRenderer 实例。与 setAi 对称:adapter 在 image 服务上下线时
+	* 调用,引擎随后的卡片渲染会立即用新实例 (或回退到纯文字) ,无需重启 server。
+	*
+	* 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+	* 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+	* 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+	*/
+	setImage(image) {
+		this.image = image;
+	}
 	get isActive() {
 		return this.dynamicJob?.running ?? false;
 	}
@@ -445,14 +477,15 @@ var DynamicEngine = class {
 					this.imageFailureStreak = 0;
 					this.imageFailureNotified = false;
 				}
-				let dUrl = "";
-				if (this.config.dynamicUrl) if (item.type === "DYNAMIC_TYPE_AV") {
+				const isVideo = item.type === "DYNAMIC_TYPE_AV";
+				let url = "";
+				if (this.config.dynamicUrl) if (isVideo) {
 					const jumpUrl = item.modules.module_dynamic.major?.archive?.jump_url ?? "";
 					if (this.config.dynamicVideoUrlToBV) {
 						const bvMatch = jumpUrl.match(/BV[0-9A-Za-z]+/);
-						dUrl = bvMatch ? bvMatch[0] : "";
-					} else dUrl = `${name}发布了新视频：https:${jumpUrl}`;
-				} else dUrl = `${name}发布了一条动态：https://t.bilibili.com/${item.id_str}`;
+						url = bvMatch ? bvMatch[0] : "";
+					} else url = `https:${jumpUrl}`;
+				} else url = `https://t.bilibili.com/${item.id_str}`;
 				let aiComment;
 				if (this.ai && this.config.aiEnabled !== false) {
 					const dynamicText = extractDynamicText(item);
@@ -472,17 +505,18 @@ var DynamicEngine = class {
 					this.logger.debug(`[detector] UID=${uid} 在本轮处理中已退订/被替换，跳过推送`);
 					continue;
 				}
-				const textPart = aiComment ?? (dUrl || void 0);
+				const tmpl = isVideo ? sub?.customVideoTemplate ?? this.config.videoTemplate ?? DEFAULT_DYNAMIC_TEXT.video : sub?.customDynamicTemplate ?? this.config.dynamicTemplate ?? DEFAULT_DYNAMIC_TEXT.dynamic;
+				const text = aiComment ?? renderDynamicText(tmpl, name, url);
 				const segments = buffer ? [{
 					type: "image",
 					buffer,
 					mime: "image/jpeg"
-				}, ...textPart ? [{
+				}, ...text ? [{
 					type: "text",
-					text: textPart
+					text
 				}] : []] : [{
 					type: "text",
-					text: aiComment ?? `${name}发布了一条动态${dUrl ? `：${dUrl}` : ""}`
+					text
 				}];
 				await this.push.broadcastDynamic(uid, segments, "dynamic");
 				const subForImgs = this.dynamicSubManager.get(uid);

package/lib/index.d.cts

@@ -180,6 +180,16 @@ interface SubItemView {
    * 单图永远不走合并转发(在 engine 内已守卫)。
    */
   imageGroupForward?: boolean;
+  /**
+   * Per-UP 非视频动态文本模板;undefined 继承 engine config `dynamicTemplate`。
+   * Adapter 折叠 `Subscription.overrides.templates.dynamic` 后填入。
+   */
+  customDynamicTemplate?: string;
+  /**
+   * Per-UP 视频投稿文本模板;undefined 继承 engine config `videoTemplate`。
+   * Adapter 折叠 `Subscription.overrides.templates.dynamicVideo` 后填入。
+   */
+  customVideoTemplate?: string;
 }
 type SubscriptionsView = Record<string, SubItemView>;
 type SubManagerView = Map<string, SubItemView>;
@@ -218,6 +228,17 @@ interface DynamicEngineConfig {
   dynamicCron: string;
   /** 视频动态时是否将 URL 替换为 BV 号。 */
   dynamicVideoUrlToBV: boolean;
+  /**
+   * 非视频动态的推送文本模板。变量 `{name}`(UP 名) / `{url}`(动态链接)。
+   * `{url}` 在 `dynamicUrl=false` 时为空,引擎会顺带去掉相邻分隔符。
+   * 缺省时回退到内建文案。Adapter 通常用 `globals.defaults.templates.dynamic` 填充。
+   */
+  dynamicTemplate?: string;
+  /**
+   * 视频投稿的推送文本模板。变量 `{name}` / `{url}`(视频链接或 BV)。
+   * 缺省时回退到内建文案。Adapter 通常用 `globals.defaults.templates.dynamicVideo` 填充。
+   */
+  videoTemplate?: string;
   /**
    * DYNAMIC_TYPE_DRAW 图集图片推送行为。enable=false 时跳过图集广播,
    * 只发文本/卡片。forward=true 时走合并转发(聊天记录卡片,走 OneBot
@@ -271,7 +292,7 @@ declare class DynamicEngine {
   private readonly bus;
   private readonly api;
   private readonly push;
-  private readonly image?;
+  private image?;
   private ai?;
   private readonly logger;
   private readonly getSubs;
@@ -308,6 +329,15 @@ declare class DynamicEngine {
    * 配置后调用,引擎随后的动态点评会立即用新实例 (或回退到纯文字) ,无需重启 server。
    */
   setAi(ai: CommentaryGenerator | undefined): void;
+  /**
+   * 热替换 ImageRenderer 实例。与 setAi 对称:adapter 在 image 服务上下线时
+   * 调用,引擎随后的卡片渲染会立即用新实例 (或回退到纯文字) ,无需重启 server。
+   *
+   * 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+   * 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+   * 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+   */
+  setImage(image: ImageRenderer | undefined): void;
   get isActive(): boolean;
   /** 用最新订阅快照重启动态检测；保留已有 UID 的时间戳避免重推旧动态。 */
   startDynamicDetector(subs: SubscriptionsView): void;

package/lib/index.d.mts

@@ -180,6 +180,16 @@ interface SubItemView {
    * 单图永远不走合并转发(在 engine 内已守卫)。
    */
   imageGroupForward?: boolean;
+  /**
+   * Per-UP 非视频动态文本模板;undefined 继承 engine config `dynamicTemplate`。
+   * Adapter 折叠 `Subscription.overrides.templates.dynamic` 后填入。
+   */
+  customDynamicTemplate?: string;
+  /**
+   * Per-UP 视频投稿文本模板;undefined 继承 engine config `videoTemplate`。
+   * Adapter 折叠 `Subscription.overrides.templates.dynamicVideo` 后填入。
+   */
+  customVideoTemplate?: string;
 }
 type SubscriptionsView = Record<string, SubItemView>;
 type SubManagerView = Map<string, SubItemView>;
@@ -218,6 +228,17 @@ interface DynamicEngineConfig {
   dynamicCron: string;
   /** 视频动态时是否将 URL 替换为 BV 号。 */
   dynamicVideoUrlToBV: boolean;
+  /**
+   * 非视频动态的推送文本模板。变量 `{name}`(UP 名) / `{url}`(动态链接)。
+   * `{url}` 在 `dynamicUrl=false` 时为空,引擎会顺带去掉相邻分隔符。
+   * 缺省时回退到内建文案。Adapter 通常用 `globals.defaults.templates.dynamic` 填充。
+   */
+  dynamicTemplate?: string;
+  /**
+   * 视频投稿的推送文本模板。变量 `{name}` / `{url}`(视频链接或 BV)。
+   * 缺省时回退到内建文案。Adapter 通常用 `globals.defaults.templates.dynamicVideo` 填充。
+   */
+  videoTemplate?: string;
   /**
    * DYNAMIC_TYPE_DRAW 图集图片推送行为。enable=false 时跳过图集广播,
    * 只发文本/卡片。forward=true 时走合并转发(聊天记录卡片,走 OneBot
@@ -271,7 +292,7 @@ declare class DynamicEngine {
   private readonly bus;
   private readonly api;
   private readonly push;
-  private readonly image?;
+  private image?;
   private ai?;
   private readonly logger;
   private readonly getSubs;
@@ -308,6 +329,15 @@ declare class DynamicEngine {
    * 配置后调用,引擎随后的动态点评会立即用新实例 (或回退到纯文字) ,无需重启 server。
    */
   setAi(ai: CommentaryGenerator | undefined): void;
+  /**
+   * 热替换 ImageRenderer 实例。与 setAi 对称:adapter 在 image 服务上下线时
+   * 调用,引擎随后的卡片渲染会立即用新实例 (或回退到纯文字) ,无需重启 server。
+   *
+   * 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+   * 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+   * 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+   */
+  setImage(image: ImageRenderer | undefined): void;
   get isActive(): boolean;
   /** 用最新订阅快照重启动态检测；保留已有 UID 的时间戳避免重推旧动态。 */
   startDynamicDetector(subs: SubscriptionsView): void;

package/lib/index.mjs

@@ -1,4 +1,4 @@
-import { checkUserRegex, withLock } from "@bilibili-notify/internal";
+import { checkUserRegex, interpolate, withLock } from "@bilibili-notify/internal";
 import { CronJob } from "cron";
 import { DateTime } from "luxon";
 //#region src/types.ts
@@ -104,6 +104,27 @@ const LOG_TAG = "bilibili-notify-dynamic";
 * 后即自愈,无需人工重启进程。
 */
 const DETECTOR_RESTART_BACKOFF_MS = 5 * 6e4;
+/**
+* 动态推送文本模板的内建兜底,仅在 adapter 未填 config.dynamicTemplate /
+* videoTemplate 时使用(真实 adapter 都会从 globals.defaults.templates 填充)。
+* 与 `@bilibili-notify/internal` 的 `DEFAULT_TEMPLATES.dynamic/.dynamicVideo`
+* 保持一致。变量 `{name}`(UP 名) / `{url}`(链接,未启用 URL 时为空)。
+*/
+const DEFAULT_DYNAMIC_TEXT = {
+	dynamic: "{name}发布了一条动态：{url}",
+	video: "{name}发布了新视频：{url}"
+};
+/**
+* 渲染动态推送文本:`{name}` / `{url}` 插值 + `\n` 展开。`url` 为空(未启用 URL)
+* 时连同 `{url}` 的前导分隔符一起去掉,避免行尾残留孤立的「：」。两个推送分支
+* (有图 / 无图)都走此函数 → 文字内容一致。
+*/
+function renderDynamicText(template, name, url) {
+	return interpolate(url ? template : template.replace(/\s*[：:]?\s*\{url\}/g, ""), {
+		name,
+		url
+	}).replaceAll("\\n", "\n");
+}
 /** 从动态数据中提取图片 URL，用于多模态 AI 点评（最多 4 张） */
 function extractDynamicImages(item) {
 	const mod = item.modules.module_dynamic;
@@ -232,6 +253,17 @@ var DynamicEngine = class {
 	setAi(ai) {
 		this.ai = ai;
 	}
+	/**
+	* 热替换 ImageRenderer 实例。与 setAi 对称:adapter 在 image 服务上下线时
+	* 调用,引擎随后的卡片渲染会立即用新实例 (或回退到纯文字) ,无需重启 server。
+	*
+	* 主要给 koishi adapter 用 —— sibling service (-image) 启停时通过 ctx.inject
+	* 后置注入。独立端 imageRenderer 是 engine 同进程一次性 wire,不会动态消失,
+	* 不需要调用本方法 (cardStyle 热更走 imageRenderer.updateConfig)。
+	*/
+	setImage(image) {
+		this.image = image;
+	}
 	get isActive() {
 		return this.dynamicJob?.running ?? false;
 	}
@@ -444,14 +476,15 @@ var DynamicEngine = class {
 					this.imageFailureStreak = 0;
 					this.imageFailureNotified = false;
 				}
-				let dUrl = "";
-				if (this.config.dynamicUrl) if (item.type === "DYNAMIC_TYPE_AV") {
+				const isVideo = item.type === "DYNAMIC_TYPE_AV";
+				let url = "";
+				if (this.config.dynamicUrl) if (isVideo) {
 					const jumpUrl = item.modules.module_dynamic.major?.archive?.jump_url ?? "";
 					if (this.config.dynamicVideoUrlToBV) {
 						const bvMatch = jumpUrl.match(/BV[0-9A-Za-z]+/);
-						dUrl = bvMatch ? bvMatch[0] : "";
-					} else dUrl = `${name}发布了新视频：https:${jumpUrl}`;
-				} else dUrl = `${name}发布了一条动态：https://t.bilibili.com/${item.id_str}`;
+						url = bvMatch ? bvMatch[0] : "";
+					} else url = `https:${jumpUrl}`;
+				} else url = `https://t.bilibili.com/${item.id_str}`;
 				let aiComment;
 				if (this.ai && this.config.aiEnabled !== false) {
 					const dynamicText = extractDynamicText(item);
@@ -471,17 +504,18 @@ var DynamicEngine = class {
 					this.logger.debug(`[detector] UID=${uid} 在本轮处理中已退订/被替换，跳过推送`);
 					continue;
 				}
-				const textPart = aiComment ?? (dUrl || void 0);
+				const tmpl = isVideo ? sub?.customVideoTemplate ?? this.config.videoTemplate ?? DEFAULT_DYNAMIC_TEXT.video : sub?.customDynamicTemplate ?? this.config.dynamicTemplate ?? DEFAULT_DYNAMIC_TEXT.dynamic;
+				const text = aiComment ?? renderDynamicText(tmpl, name, url);
 				const segments = buffer ? [{
 					type: "image",
 					buffer,
 					mime: "image/jpeg"
-				}, ...textPart ? [{
+				}, ...text ? [{
 					type: "text",
-					text: textPart
+					text
 				}] : []] : [{
 					type: "text",
-					text: aiComment ?? `${name}发布了一条动态${dUrl ? `：${dUrl}` : ""}`
+					text
 				}];
 				await this.push.broadcastDynamic(uid, segments, "dynamic");
 				const subForImgs = this.dynamicSubManager.get(uid);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilibili-notify/dynamic",
-  "version": "0.0.1-alpha.2",
+  "version": "0.1.0-alpha.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/Akokk0/bilibili-notify"
@@ -28,10 +28,10 @@
   "dependencies": {
     "cron": "^3.1.7",
     "luxon": "^3.5.0",
-    "@bilibili-notify/api": "^0.2.0-alpha.2",
     "@bilibili-notify/ai": "^0.0.1-alpha.1",
+    "@bilibili-notify/api": "^0.2.0-alpha.2",
     "@bilibili-notify/image": "^0.0.1-alpha.2",
-    "@bilibili-notify/internal": "^0.1.0-alpha.2"
+    "@bilibili-notify/internal": "^0.1.0-alpha.3"
   },
   "devDependencies": {
     "@types/luxon": "^3.4.2"