@bilibili-notify/dynamic 0.0.1-alpha.0

package/lib/index.d.cts

@@ -0,0 +1,316 @@
+import { CommentaryCallOverride, CommentaryGenerator } from "@bilibili-notify/ai";
+import { BilibiliAPI } from "@bilibili-notify/api";
+import { ImageRenderer } from "@bilibili-notify/image";
+import { Logger, MessageBus, ServiceContext } from "@bilibili-notify/internal";
+
+//#region src/types.d.ts
+type RichTextNode = {
+  orig_text: string;
+  text: string;
+  type: string;
+  emoji?: {
+    icon_url: string;
+    size: number;
+    text: string;
+    type: number;
+  };
+  jump_url?: string;
+  rid?: string;
+  goods?: any;
+  icon_name?: string;
+};
+type Dynamic = {
+  basic: Object;
+  id_str: string;
+  type: string;
+  orig?: Dynamic;
+  modules: {
+    module_author: {
+      face: string;
+      following: boolean;
+      jump_url: string;
+      label: string;
+      mid: number;
+      name: string;
+      pub_action: string;
+      pub_time: string;
+      pub_ts: number;
+      type: string;
+      [key: string]: any;
+    };
+    module_dynamic: {
+      additional?: any;
+      desc?: {
+        rich_text_nodes: RichTextNode[];
+        text: string;
+      };
+      major?: {
+        opus?: {
+          fold_action: string[];
+          jump_url: string;
+          pics: Array<{
+            height: number;
+            live_url: string;
+            size: number;
+            url: string;
+            width: number;
+          }>;
+          summary: {
+            rich_text_nodes: RichTextNode[];
+            text: string;
+          };
+          title: string;
+        };
+        archive?: {
+          title: string;
+          jump_url: string;
+          [key: string]: any;
+        };
+        [key: string]: any;
+      };
+    };
+  };
+};
+type AllDynamicInfo = {
+  code: number;
+  message: string;
+  data: {
+    has_more: boolean;
+    items: Dynamic[];
+    offset: string;
+    update_baseline: string;
+    update_num: number;
+  };
+};
+type DynamicTimelineManager = Map<string, number>;
+interface DynamicFilterConfig {
+  enable?: boolean;
+  notify?: boolean;
+  regex?: string;
+  keywords?: string[];
+  forward?: boolean;
+  article?: boolean;
+  whitelistEnable?: boolean;
+  whitelistRegex?: string;
+  whitelistKeywords?: string[];
+}
+declare enum DynamicFilterReason {
+  BlacklistKeyword = "blacklist-keyword",
+  BlacklistForward = "blacklist-forward",
+  BlacklistArticle = "blacklist-article",
+  WhitelistUnmatched = "whitelist-unmatched"
+}
+interface DynamicFilterResult {
+  blocked: boolean;
+  reason?: DynamicFilterReason;
+}
+//#endregion
+//#region src/push-like.d.ts
+/** dynamic-engine 渲染好的图片缓冲（无 mime/扩展信息时默认 image/jpeg）。 */
+interface PushImagePart {
+  type: "image";
+  buffer: Buffer;
+  mime: string;
+}
+/** 文本片段。 */
+interface PushTextPart {
+  type: "text";
+  text: string;
+}
+/** 用于「专题」转发图集等需要折叠成 forward message 的多段图片。 */
+interface PushImageGroup {
+  type: "image-group";
+  forward: boolean;
+  urls: string[];
+}
+type PushSegment = PushImagePart | PushTextPart | PushImageGroup;
+/**
+ * dynamic-engine 仅需以下三类语义化推送动作。
+ * 业务核心调用前已经决定好「此次推送的目标维度」（通过 uid + PushKind），
+ * adapter 负责把它翻译为具体平台的 channel 列表 / atAll / 图片折叠等行为。
+ */
+type PushKind = /** 主体动态卡片：可能携带图片 + 文本 */"dynamic" | /** 动态附图（DYNAMIC_TYPE_DRAW 的多张原图，转发消息形式） */"dynamic-images";
+interface PushLike {
+  /**
+   * 向某个 UP 主对应的全部订阅频道广播一段消息。
+   * - kind="dynamic"：主卡片消息，包含 image + text 段。
+   * - kind="dynamic-images"：DYNAMIC_TYPE_DRAW 的图集，adapter 通常以 forward message 投递。
+   */
+  broadcastDynamic(uid: string, segments: PushSegment[], kind: PushKind): Promise<void>;
+  /** 私信发送给配置的管理员账号（master）。adapter 端校验启用状态与 bot 在线性。 */
+  sendPrivateMsg(content: string): Promise<void>;
+  /** 与 sendPrivateMsg 等价，但 adapter 应当在内部把内容追加到 error 日志。 */
+  sendErrorMsg(reason: string): Promise<void>;
+}
+/**
+ * 平台中立的订阅条目最小视图。dynamic-engine 仅访问 `uid` 与 `customCardStyle`
+ * 相关字段；adapter 提供完整 SubItem 实例时会被结构性兼容（额外字段不影响）。
+ *
+ * `filter` / `aiOverride` 为 per-UP 覆盖（可选）：adapter 折叠 `Subscription.overrides`
+ * 后填入；缺失时 engine 回退到 `DynamicEngineConfig.filter` / 全局 CommentaryGenerator 配置。
+ */
+interface SubItemView {
+  uid: string;
+  uname: string;
+  dynamic?: boolean;
+  customCardStyle?: {
+    enable?: boolean;
+    cardColorStart?: string;
+    cardColorEnd?: string;
+  };
+  /** Per-UP 动态过滤覆盖；undefined 时使用 engine 的全局 filter。 */
+  filter?: DynamicFilterConfig & {
+    notify?: boolean;
+  };
+  /** Per-UP AI 覆盖；undefined 时使用 CommentaryGenerator 的全局 config。 */
+  aiOverride?: CommentaryCallOverride;
+}
+type SubscriptionsView = Record<string, SubItemView>;
+type SubManagerView = Map<string, SubItemView>;
+/**
+ * Adapter 提供给 engine 的「最新订阅快照」访问器与增量操作描述。
+ * Koishi adapter 在收到 `bilibili-notify/subscription-changed` 时调用 engine.applyOps；
+ * 独立端在 SubscriptionStore 写入后同样转译为 SubscriptionOpView 列表。
+ */
+type SubscriptionOpView = {
+  type: "add";
+  sub: SubItemView;
+} | {
+  type: "delete";
+  uid: string;
+} | {
+  type: "update";
+  uid: string;
+  changes: Array<{
+    scope: string;
+    dynamic?: boolean;
+  }>;
+};
+//#endregion
+//#region src/dynamic-engine.d.ts
+/**
+ * Runtime configuration for {@link DynamicEngine}. Mirrors the platform-neutral
+ * subset of `BilibiliNotifyDynamicConfig`; the koishi shell maps its schema
+ * fields onto this struct, the standalone runtime fills it from its own config
+ * store. The `logLevel` field is intentionally dropped — adapter sets logger
+ * level externally via {@link ServiceContext}.
+ */
+interface DynamicEngineConfig {
+  /** 推送动态时是否附带 URL（QQ 官方机器人需关闭）。 */
+  dynamicUrl: boolean;
+  /** 轮询动态的 cron 表达式。 */
+  dynamicCron: string;
+  /** 视频动态时是否将 URL 替换为 BV 号。 */
+  dynamicVideoUrlToBV: boolean;
+  /** 是否额外推送 DYNAMIC_TYPE_DRAW 中的图集（forward message）。 */
+  pushImgsInDynamic: boolean;
+  /** 内容过滤配置（含 notify：被屏蔽时是否通知）。 */
+  filter: DynamicFilterConfig & {
+    notify?: boolean;
+  };
+  /**
+   * 是否启用图片卡片渲染。`false` 时跳过 puppeteer 调用,推送降级为纯文字。缺省视为 true,
+   * 保留旧 adapter 不传该字段时的既有行为。Adapter 通常用 `globals.defaults.cardStyle.enabled` 填充。
+   */
+  imageEnabled?: boolean;
+  /**
+   * 是否启用 AI 动态点评。`false` 时跳过 `CommentaryGenerator.comment()` 调用,推送只用原始动态文本。
+   * 缺省视为 true。Adapter 通常用 `globals.defaults.ai.enabled` 填充。
+   */
+  aiEnabled?: boolean;
+}
+interface DynamicEngineOptions {
+  serviceCtx: ServiceContext;
+  bus: MessageBus;
+  api: BilibiliAPI;
+  push: PushLike;
+  /** 可选注入：图片渲染器；缺失时降级为纯文字推送。 */
+  image?: ImageRenderer;
+  /** 可选注入：AI 点评生成器；缺失时跳过 AI 文案生成。 */
+  ai?: CommentaryGenerator;
+  config: DynamicEngineConfig;
+  /**
+   * Adapter 提供的订阅快照访问器。返回 null 表示订阅尚未就绪
+   * （engine 会在收到 `subscription-changed` / `auth-restored` 后再次拉取）。
+   */
+  getSubs: () => SubscriptionsView | null;
+}
+/**
+ * 平台中立的动态轮询/过滤/渲染核心。
+ *
+ * - 不依赖 koishi runtime；adapter 提供 ServiceContext / MessageBus / PushLike。
+ * - image / ai 通过 **构造期注入**（不在 detect 循环内做服务查找），缺失时降级。
+ * - 时间线、过滤、API 错误处理逻辑与原 koishi 版 BilibiliNotifyDynamic 一致。
+ */
+declare class DynamicEngine {
+  private readonly serviceCtx;
+  private readonly bus;
+  private readonly api;
+  private readonly push;
+  private readonly image?;
+  private ai?;
+  private readonly logger;
+  private readonly getSubs;
+  private config;
+  private dynamicJob?;
+  /** 风控/瞬时错误后的一次性退避重启句柄;非 undefined 表示已排程,不叠加。 */
+  private detectorRestartTimer?;
+  /**
+   * -352 风控态边沿标记。进入风控只 error+DM+engine-error 一次;退避重探仍
+   * 风控 → debug(不重复告警);成功拉取(code 0)→ info 一次并清除。避免在
+   * 退避重试热路径反复刷 error(Q1)。
+   */
+  private riskControlled;
+  private dynamicSubManager;
+  private dynamicTimelineManager;
+  /** 连续图片渲染失败计数，达到阈值时仅通知一次但不停 cron */
+  private imageFailureStreak;
+  private imageFailureNotified;
+  private readonly busHandles;
+  constructor(opts: DynamicEngineOptions);
+  /** 启动钩子。Adapter 在 ServiceContext 就绪、订阅可访问后调用。 */
+  start(): void;
+  /** 停止钩子。停止 cron、释放事件订阅。 */
+  stop(): void;
+  /**
+   * 替换运行时配置(adapter 在 koishi config / dashboard 编辑后调用)。
+   * `dynamicCron` 变化时会自动停掉旧 CronJob 并按新表达式重新 schedule —— 否则
+   * 配置已经写进 this.config,但 node-cron 句柄还在跑旧节奏,纯粹的字段更新
+   * 是看不见的 bug。
+   */
+  updateConfig(config: DynamicEngineConfig): void;
+  /**
+   * 热替换 CommentaryGenerator 实例。adapter 在用户运行时打开 / 关闭 / 更换 AI
+   * 配置后调用,引擎随后的动态点评会立即用新实例 (或回退到纯文字) ,无需重启 server。
+   */
+  setAi(ai: CommentaryGenerator | undefined): void;
+  get isActive(): boolean;
+  /** 用最新订阅快照重启动态检测；保留已有 UID 的时间戳避免重推旧动态。 */
+  startDynamicDetector(subs: SubscriptionsView): void;
+  private startDynamicForUid;
+  private stopDynamicForUid;
+  /**
+   * UID 是否仍订阅。detectDynamics 在 image/AI/broadcast 等多个 await 处挂起,
+   * `applyOps`(由 adapter 在 subscription-changed 时调,**不**在 withLock 内)
+   * 可在挂起期 stopDynamicForUid 删表。每个 dispatch / 时间线回写前用它重校,
+   * 否则会给已退订 UID 推送、并把其时间线“复活”进而长期抑制再订阅后的动态。
+   */
+  private stillSubscribed;
+  /** Incrementally apply subscription ops without restarting the cron job. */
+  applyOps(ops: SubscriptionOpView[]): void;
+  private startJob;
+  private reconcileJob;
+  private detectDynamics;
+  private handleApiError;
+  /**
+   * 风控/瞬时错误后排一次性退避重启。已有待执行的不叠加(`detectorRestartTimer`
+   * 非空即跳过)。到点取最新订阅快照重启检测;`stop()` / 显式 `startDynamicDetector`
+   * 会作废本计时(避免 dispose 后 / 重启后仍触发陈旧重启)。
+   */
+  private scheduleDetectorRestart;
+}
+//#endregion
+//#region src/dynamic-filter.d.ts
+declare function filterDynamic(dynamic: Dynamic, config: DynamicFilterConfig, logger?: Logger): DynamicFilterResult;
+//#endregion
+export { type AllDynamicInfo, type Dynamic, DynamicEngine, type DynamicEngineConfig, type DynamicEngineOptions, type DynamicFilterConfig, DynamicFilterReason, type DynamicFilterResult, type DynamicTimelineManager, type PushImageGroup, type PushImagePart, type PushKind, type PushLike, type PushSegment, type PushTextPart, type RichTextNode, type SubItemView, type SubManagerView, type SubscriptionOpView, type SubscriptionsView, filterDynamic };

package/lib/index.d.mts

@@ -0,0 +1,316 @@
+import { Logger, MessageBus, ServiceContext } from "@bilibili-notify/internal";
+import { CommentaryCallOverride, CommentaryGenerator } from "@bilibili-notify/ai";
+import { BilibiliAPI } from "@bilibili-notify/api";
+import { ImageRenderer } from "@bilibili-notify/image";
+
+//#region src/types.d.ts
+type RichTextNode = {
+  orig_text: string;
+  text: string;
+  type: string;
+  emoji?: {
+    icon_url: string;
+    size: number;
+    text: string;
+    type: number;
+  };
+  jump_url?: string;
+  rid?: string;
+  goods?: any;
+  icon_name?: string;
+};
+type Dynamic = {
+  basic: Object;
+  id_str: string;
+  type: string;
+  orig?: Dynamic;
+  modules: {
+    module_author: {
+      face: string;
+      following: boolean;
+      jump_url: string;
+      label: string;
+      mid: number;
+      name: string;
+      pub_action: string;
+      pub_time: string;
+      pub_ts: number;
+      type: string;
+      [key: string]: any;
+    };
+    module_dynamic: {
+      additional?: any;
+      desc?: {
+        rich_text_nodes: RichTextNode[];
+        text: string;
+      };
+      major?: {
+        opus?: {
+          fold_action: string[];
+          jump_url: string;
+          pics: Array<{
+            height: number;
+            live_url: string;
+            size: number;
+            url: string;
+            width: number;
+          }>;
+          summary: {
+            rich_text_nodes: RichTextNode[];
+            text: string;
+          };
+          title: string;
+        };
+        archive?: {
+          title: string;
+          jump_url: string;
+          [key: string]: any;
+        };
+        [key: string]: any;
+      };
+    };
+  };
+};
+type AllDynamicInfo = {
+  code: number;
+  message: string;
+  data: {
+    has_more: boolean;
+    items: Dynamic[];
+    offset: string;
+    update_baseline: string;
+    update_num: number;
+  };
+};
+type DynamicTimelineManager = Map<string, number>;
+interface DynamicFilterConfig {
+  enable?: boolean;
+  notify?: boolean;
+  regex?: string;
+  keywords?: string[];
+  forward?: boolean;
+  article?: boolean;
+  whitelistEnable?: boolean;
+  whitelistRegex?: string;
+  whitelistKeywords?: string[];
+}
+declare enum DynamicFilterReason {
+  BlacklistKeyword = "blacklist-keyword",
+  BlacklistForward = "blacklist-forward",
+  BlacklistArticle = "blacklist-article",
+  WhitelistUnmatched = "whitelist-unmatched"
+}
+interface DynamicFilterResult {
+  blocked: boolean;
+  reason?: DynamicFilterReason;
+}
+//#endregion
+//#region src/push-like.d.ts
+/** dynamic-engine 渲染好的图片缓冲（无 mime/扩展信息时默认 image/jpeg）。 */
+interface PushImagePart {
+  type: "image";
+  buffer: Buffer;
+  mime: string;
+}
+/** 文本片段。 */
+interface PushTextPart {
+  type: "text";
+  text: string;
+}
+/** 用于「专题」转发图集等需要折叠成 forward message 的多段图片。 */
+interface PushImageGroup {
+  type: "image-group";
+  forward: boolean;
+  urls: string[];
+}
+type PushSegment = PushImagePart | PushTextPart | PushImageGroup;
+/**
+ * dynamic-engine 仅需以下三类语义化推送动作。
+ * 业务核心调用前已经决定好「此次推送的目标维度」（通过 uid + PushKind），
+ * adapter 负责把它翻译为具体平台的 channel 列表 / atAll / 图片折叠等行为。
+ */
+type PushKind = /** 主体动态卡片：可能携带图片 + 文本 */"dynamic" | /** 动态附图（DYNAMIC_TYPE_DRAW 的多张原图，转发消息形式） */"dynamic-images";
+interface PushLike {
+  /**
+   * 向某个 UP 主对应的全部订阅频道广播一段消息。
+   * - kind="dynamic"：主卡片消息，包含 image + text 段。
+   * - kind="dynamic-images"：DYNAMIC_TYPE_DRAW 的图集，adapter 通常以 forward message 投递。
+   */
+  broadcastDynamic(uid: string, segments: PushSegment[], kind: PushKind): Promise<void>;
+  /** 私信发送给配置的管理员账号（master）。adapter 端校验启用状态与 bot 在线性。 */
+  sendPrivateMsg(content: string): Promise<void>;
+  /** 与 sendPrivateMsg 等价，但 adapter 应当在内部把内容追加到 error 日志。 */
+  sendErrorMsg(reason: string): Promise<void>;
+}
+/**
+ * 平台中立的订阅条目最小视图。dynamic-engine 仅访问 `uid` 与 `customCardStyle`
+ * 相关字段；adapter 提供完整 SubItem 实例时会被结构性兼容（额外字段不影响）。
+ *
+ * `filter` / `aiOverride` 为 per-UP 覆盖（可选）：adapter 折叠 `Subscription.overrides`
+ * 后填入；缺失时 engine 回退到 `DynamicEngineConfig.filter` / 全局 CommentaryGenerator 配置。
+ */
+interface SubItemView {
+  uid: string;
+  uname: string;
+  dynamic?: boolean;
+  customCardStyle?: {
+    enable?: boolean;
+    cardColorStart?: string;
+    cardColorEnd?: string;
+  };
+  /** Per-UP 动态过滤覆盖；undefined 时使用 engine 的全局 filter。 */
+  filter?: DynamicFilterConfig & {
+    notify?: boolean;
+  };
+  /** Per-UP AI 覆盖；undefined 时使用 CommentaryGenerator 的全局 config。 */
+  aiOverride?: CommentaryCallOverride;
+}
+type SubscriptionsView = Record<string, SubItemView>;
+type SubManagerView = Map<string, SubItemView>;
+/**
+ * Adapter 提供给 engine 的「最新订阅快照」访问器与增量操作描述。
+ * Koishi adapter 在收到 `bilibili-notify/subscription-changed` 时调用 engine.applyOps；
+ * 独立端在 SubscriptionStore 写入后同样转译为 SubscriptionOpView 列表。
+ */
+type SubscriptionOpView = {
+  type: "add";
+  sub: SubItemView;
+} | {
+  type: "delete";
+  uid: string;
+} | {
+  type: "update";
+  uid: string;
+  changes: Array<{
+    scope: string;
+    dynamic?: boolean;
+  }>;
+};
+//#endregion
+//#region src/dynamic-engine.d.ts
+/**
+ * Runtime configuration for {@link DynamicEngine}. Mirrors the platform-neutral
+ * subset of `BilibiliNotifyDynamicConfig`; the koishi shell maps its schema
+ * fields onto this struct, the standalone runtime fills it from its own config
+ * store. The `logLevel` field is intentionally dropped — adapter sets logger
+ * level externally via {@link ServiceContext}.
+ */
+interface DynamicEngineConfig {
+  /** 推送动态时是否附带 URL（QQ 官方机器人需关闭）。 */
+  dynamicUrl: boolean;
+  /** 轮询动态的 cron 表达式。 */
+  dynamicCron: string;
+  /** 视频动态时是否将 URL 替换为 BV 号。 */
+  dynamicVideoUrlToBV: boolean;
+  /** 是否额外推送 DYNAMIC_TYPE_DRAW 中的图集（forward message）。 */
+  pushImgsInDynamic: boolean;
+  /** 内容过滤配置（含 notify：被屏蔽时是否通知）。 */
+  filter: DynamicFilterConfig & {
+    notify?: boolean;
+  };
+  /**
+   * 是否启用图片卡片渲染。`false` 时跳过 puppeteer 调用,推送降级为纯文字。缺省视为 true,
+   * 保留旧 adapter 不传该字段时的既有行为。Adapter 通常用 `globals.defaults.cardStyle.enabled` 填充。
+   */
+  imageEnabled?: boolean;
+  /**
+   * 是否启用 AI 动态点评。`false` 时跳过 `CommentaryGenerator.comment()` 调用,推送只用原始动态文本。
+   * 缺省视为 true。Adapter 通常用 `globals.defaults.ai.enabled` 填充。
+   */
+  aiEnabled?: boolean;
+}
+interface DynamicEngineOptions {
+  serviceCtx: ServiceContext;
+  bus: MessageBus;
+  api: BilibiliAPI;
+  push: PushLike;
+  /** 可选注入：图片渲染器；缺失时降级为纯文字推送。 */
+  image?: ImageRenderer;
+  /** 可选注入：AI 点评生成器；缺失时跳过 AI 文案生成。 */
+  ai?: CommentaryGenerator;
+  config: DynamicEngineConfig;
+  /**
+   * Adapter 提供的订阅快照访问器。返回 null 表示订阅尚未就绪
+   * （engine 会在收到 `subscription-changed` / `auth-restored` 后再次拉取）。
+   */
+  getSubs: () => SubscriptionsView | null;
+}
+/**
+ * 平台中立的动态轮询/过滤/渲染核心。
+ *
+ * - 不依赖 koishi runtime；adapter 提供 ServiceContext / MessageBus / PushLike。
+ * - image / ai 通过 **构造期注入**（不在 detect 循环内做服务查找），缺失时降级。
+ * - 时间线、过滤、API 错误处理逻辑与原 koishi 版 BilibiliNotifyDynamic 一致。
+ */
+declare class DynamicEngine {
+  private readonly serviceCtx;
+  private readonly bus;
+  private readonly api;
+  private readonly push;
+  private readonly image?;
+  private ai?;
+  private readonly logger;
+  private readonly getSubs;
+  private config;
+  private dynamicJob?;
+  /** 风控/瞬时错误后的一次性退避重启句柄;非 undefined 表示已排程,不叠加。 */
+  private detectorRestartTimer?;
+  /**
+   * -352 风控态边沿标记。进入风控只 error+DM+engine-error 一次;退避重探仍
+   * 风控 → debug(不重复告警);成功拉取(code 0)→ info 一次并清除。避免在
+   * 退避重试热路径反复刷 error(Q1)。
+   */
+  private riskControlled;
+  private dynamicSubManager;
+  private dynamicTimelineManager;
+  /** 连续图片渲染失败计数，达到阈值时仅通知一次但不停 cron */
+  private imageFailureStreak;
+  private imageFailureNotified;
+  private readonly busHandles;
+  constructor(opts: DynamicEngineOptions);
+  /** 启动钩子。Adapter 在 ServiceContext 就绪、订阅可访问后调用。 */
+  start(): void;
+  /** 停止钩子。停止 cron、释放事件订阅。 */
+  stop(): void;
+  /**
+   * 替换运行时配置(adapter 在 koishi config / dashboard 编辑后调用)。
+   * `dynamicCron` 变化时会自动停掉旧 CronJob 并按新表达式重新 schedule —— 否则
+   * 配置已经写进 this.config,但 node-cron 句柄还在跑旧节奏,纯粹的字段更新
+   * 是看不见的 bug。
+   */
+  updateConfig(config: DynamicEngineConfig): void;
+  /**
+   * 热替换 CommentaryGenerator 实例。adapter 在用户运行时打开 / 关闭 / 更换 AI
+   * 配置后调用,引擎随后的动态点评会立即用新实例 (或回退到纯文字) ,无需重启 server。
+   */
+  setAi(ai: CommentaryGenerator | undefined): void;
+  get isActive(): boolean;
+  /** 用最新订阅快照重启动态检测；保留已有 UID 的时间戳避免重推旧动态。 */
+  startDynamicDetector(subs: SubscriptionsView): void;
+  private startDynamicForUid;
+  private stopDynamicForUid;
+  /**
+   * UID 是否仍订阅。detectDynamics 在 image/AI/broadcast 等多个 await 处挂起,
+   * `applyOps`(由 adapter 在 subscription-changed 时调,**不**在 withLock 内)
+   * 可在挂起期 stopDynamicForUid 删表。每个 dispatch / 时间线回写前用它重校,
+   * 否则会给已退订 UID 推送、并把其时间线“复活”进而长期抑制再订阅后的动态。
+   */
+  private stillSubscribed;
+  /** Incrementally apply subscription ops without restarting the cron job. */
+  applyOps(ops: SubscriptionOpView[]): void;
+  private startJob;
+  private reconcileJob;
+  private detectDynamics;
+  private handleApiError;
+  /**
+   * 风控/瞬时错误后排一次性退避重启。已有待执行的不叠加(`detectorRestartTimer`
+   * 非空即跳过)。到点取最新订阅快照重启检测;`stop()` / 显式 `startDynamicDetector`
+   * 会作废本计时(避免 dispose 后 / 重启后仍触发陈旧重启)。
+   */
+  private scheduleDetectorRestart;
+}
+//#endregion
+//#region src/dynamic-filter.d.ts
+declare function filterDynamic(dynamic: Dynamic, config: DynamicFilterConfig, logger?: Logger): DynamicFilterResult;
+//#endregion
+export { type AllDynamicInfo, type Dynamic, DynamicEngine, type DynamicEngineConfig, type DynamicEngineOptions, type DynamicFilterConfig, DynamicFilterReason, type DynamicFilterResult, type DynamicTimelineManager, type PushImageGroup, type PushImagePart, type PushKind, type PushLike, type PushSegment, type PushTextPart, type RichTextNode, type SubItemView, type SubManagerView, type SubscriptionOpView, type SubscriptionsView, filterDynamic };