koishi-plugin-kkk 1.0.0

package/src/karin/platform/douyin/types.ts

@@ -0,0 +1,151 @@
+import type {
+  DouyinUserProfileResponse,
+  DouyinLiveRoomInfoResponse,
+  DouyinUserFavoriteListResponse,
+  DouyinUserRecommendListResponse,
+  DouyinUserVideoListResponse,
+  DouyinVideoWorkResponse
+} from '@ikenxuan/amagi'
+
+type AwemeDetail = NonNullable<DouyinVideoWorkResponse['aweme_detail']>
+
+/**
+ * 作品列表推送要遍历的条目。
+ *
+ * 作品 / 喜欢 / 推荐三个列表拿到的是同一套 aweme 对象，但生成树按各自样本分别派生了一份形状
+ * （字段可选性略有出入），这里取三者的并集 —— 推送链路只读 `aweme_id` / `create_time` /
+ * `author.nickname` / `author.sec_uid` / `is_top`，三个形状都带这些字段。
+ */
+export type DouyinListItem =
+  | DouyinUserVideoListResponse['aweme_list'][number]
+  | DouyinUserFavoriteListResponse['aweme_list'][number]
+  | DouyinUserRecommendListResponse['aweme_list'][number]
+
+/**
+ * 作品描述 text_extra 数组项。
+ * amagi 生成类型把它误标为 `string[]`，真实数据是对象数组：
+ * type 0 为 @用户（带 sec_uid），type 1 为话题（带 hashtag_name / hashtag_id）。
+ */
+export interface DouyinTextExtra {
+  start?: number
+  end?: number
+  hashtag_name?: string
+  hashtag_id?: string
+  sec_uid?: string
+  type?: number
+}
+
+/**
+ * 图文/合辑作品 images 数组项。
+ * amagi 生成类型里视频作品的 images 标为 null，图文作品实为该对象数组。
+ */
+export interface DouyinAwemeImage {
+  url_list: string[]
+  /** 2/缺省为静态图，4 为短片，5 为实况动图 */
+  clip_type?: number
+  width?: number
+  height?: number
+  /** clip_type 为 4/5 时携带的动图视频源 */
+  video?: {
+    play_addr_h264?: {
+      uri: string
+      url_list?: string[]
+    }
+    [key: string]: any
+  }
+  [key: string]: any
+}
+
+/** 作品合作信息（多创作者共创） */
+export interface DouyinCooperationInfo {
+  co_creator_nums?: number
+  co_creators?: Array<{
+    uid?: string
+    sec_uid?: string
+    nickname?: string
+    role_title?: string
+    avatar_thumb?: {
+      uri?: string
+      url_list?: (string | undefined)[]
+    }
+  }>
+}
+
+/**
+ * 抖音作品详情（aweme 对象）在渲染/推送链路上的消费侧视图。
+ * 以 amagi 的 AwemeDetail 字段类型为准，修正其与真实数据不符的字段
+ * （text_extra、images），并补充解析/推送流程注入的附加字段（user_info 等）。
+ * 保留索引签名以穿透未列举的上游字段，与 amagi 自身约定一致。
+ */
+export interface DouyinWorkDetailData {
+  aweme_id: string
+  desc?: string
+  create_time: number
+  aweme_type?: number
+  media_type?: number
+  is_slides?: boolean
+  share_url?: string
+  duration?: number
+  preview_title?: string
+  statistics: AwemeDetail['statistics']
+  author: AwemeDetail['author']
+  video?: AwemeDetail['video']
+  music?: AwemeDetail['music']
+  images?: DouyinAwemeImage[] | null
+  text_extra?: DouyinTextExtra[]
+  suggest_words?: {
+    suggest_words?: Array<{
+      hint_text?: string
+      words?: Array<{ word?: string }>
+    }>
+  }
+  ip_location?: string
+  article_info?: {
+    article_title: string
+    article_content: string
+    fe_data: string
+  }
+  cooperation_info?: DouyinCooperationInfo
+  /**
+   * 流程附加：作品作者/订阅者主页信息（解析与作品列表推送场景注入）。
+   *
+   * 存的是响应体本身，不是 amagi 的信封 —— fetcher 失败即抛，信封的 `success`/`message`/`meta`
+   * 在这条链路上没人读。
+   */
+  user_info?: DouyinUserProfileResponse
+  /** 流程附加：喜欢/推荐列表场景下作品作者的主页信息 */
+  author_user_info?: DouyinUserProfileResponse
+  [key: string]: any
+}
+
+/** 直播推送的详情数据（非 aweme 结构） */
+export interface DouyinLiveDetailData {
+  /** 主播主页信息（响应体，非信封） */
+  user_info: DouyinUserProfileResponse
+  /** 直播间信息，由 user_info.user.room_data JSON 解析而来 */
+  room_data?: {
+    owner: { web_rid: string }
+    [key: string]: any
+  }
+  /** 直播间详情接口返回 */
+  live_data?: DouyinLiveRoomInfoResponse
+  /** 本次推送的直播状态标记 */
+  liveStatus?: {
+    liveStatus: 'open' | 'close'
+    isChanged: boolean
+    isliving: boolean
+  }
+}
+
+/**
+ * 把 amagi 返回的 aweme 对象装配成渲染/推送使用的作品详情。
+ * amagi 的生成类型在 text_extra（实为对象数组）、images（图文作品实为数组）等字段上
+ * 与真实数据不符，统一在这一处边界断言，下游全部享受精确类型。
+ * 返回类型会带上 extra 的实际形状，例如传入 user_info 后下游可把它当作必填字段使用。
+ * @param aweme - amagi 返回的作品详情（aweme_detail 或作品列表项）
+ * @param extra - 流程附加字段（作者/订阅者主页信息）
+ */
+export const buildDouyinWorkDetail = <E extends { user_info?: DouyinUserProfileResponse; author_user_info?: DouyinUserProfileResponse }>(
+  aweme: unknown,
+  extra: E = {} as E
+): DouyinWorkDetailData & E => ({ ...(aweme as object), ...extra }) as DouyinWorkDetailData & E

package/src/karin/platform/douyin/videoQuality.ts

@@ -0,0 +1,234 @@
+import type { DouyinVideoWorkResponse } from '@ikenxuan/amagi'
+import { logger } from 'node-karin'
+
+import { Config } from '@/module/utils/Config'
+
+/** 抖音视频源对象，对应 `aweme_detail.video.bit_rate` 数组项（直接复用 amagi 生成类型，避免手写漂移） */
+export type dyVideo = NonNullable<DouyinVideoWorkResponse['aweme_detail']>['video']['bit_rate'][number]
+
+/** 插件内部使用的清晰度档位，取值域与 `Config.douyin.videoQuality` 保持一致 */
+export type DouyinQualityLevel = '4k' | '2k' | '1080p' | '720p' | '540p'
+
+/** 档位优先级，从高到低 */
+const QUALITY_PRIORITY: DouyinQualityLevel[] = ['4k', '2k', '1080p', '720p', '540p']
+
+/**
+ * `video_extra.definition` → 内部档位名。
+ * 抖音上游把 2K 记作 `1440p`，而配置项 `videoQuality` 用的是 `2k`，
+ * 这张表是两套词表唯一的翻译点，配置域不需要跟着上游改。
+ */
+const DEFINITION_TO_LEVEL: Record<string, DouyinQualityLevel> = {
+  '4k': '4k',
+  '2k': '2k',
+  '1440p': '2k',
+  '1080p': '1080p',
+  '720p': '720p',
+  '540p': '540p'
+}
+
+/** 档位 → 展示标签，沿用抖音 Web 端播放器的说法 */
+const QUALITY_LABEL: Record<DouyinQualityLevel, string> = {
+  '4k': '超清4K',
+  '2k': '超清2K',
+  '1080p': '高清1080P',
+  '720p': '高清720P',
+  '540p': '标清540P'
+}
+
+/**
+ * 安全解析 `video_extra`
+ * @param extra - 原始 JSON 字符串
+ * @returns 解析结果，为空或非法 JSON 时返回 null
+ */
+const parseVideoExtra = (extra: string | undefined): { definition?: string } | null => {
+  if (!extra) return null
+  try {
+    return JSON.parse(extra)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 从 `gear_name` 猜测档位。
+ * 只作为 `video_extra.definition` 缺失时的兜底：抖音随时可能新增 gear_name，
+ * 认不出来就返回 undefined 交给调用方处理，不再默认落到 540p 污染分档。
+ * @param gearName - 视频源的 gear_name
+ * @returns 档位名，认不出时返回 undefined
+ */
+const guessLevelFromGearName = (gearName: string): DouyinQualityLevel | undefined => {
+  if (gearName.includes('lowest_4') || gearName.includes('2160')) return '4k'
+  if (gearName.includes('1440') || gearName.includes('2k')) return '2k'
+  if (gearName.includes('1080')) return '1080p'
+  if (gearName.includes('720')) return '720p'
+  if (gearName.includes('540')) return '540p'
+  return undefined
+}
+
+/**
+ * 判定单个视频源的清晰度档位。
+ * `video_extra.definition` 是唯一可信来源：抖音视频比例不固定（存在 21:9、1:1 等），
+ * 一个 3840x1608 的视频不满足 3840x2160 但官方仍定义为 4K，所以不能拿 play_addr 的宽高硬匹配。
+ * @param video - 视频源对象
+ * @returns 档位名，无法判定时返回 undefined
+ */
+export const getDouyinQualityLevel = (video: dyVideo): DouyinQualityLevel | undefined => {
+  const definition = parseVideoExtra(video.video_extra)?.definition
+  const level = definition ? DEFINITION_TO_LEVEL[definition] : undefined
+  return level ?? guessLevelFromGearName(video.gear_name ?? '')
+}
+
+/**
+ * 同档位内的取源顺序：先 H.264，再按体积从大到小。
+ * 1080p / 720p 的 H.265（ByteVC1）在部分协议端软解失败，同档位下 H.264 更稳；
+ * 4K / 2K 上游通常只提供 H.265，此时全组同权重，自然退化为按体积排序。
+ * @param a - 视频源 A
+ * @param b - 视频源 B
+ * @returns 排序比较值
+ */
+const compareVideoPreference = (a: dyVideo, b: dyVideo): number => {
+  if (a.is_bytevc1 !== b.is_bytevc1) return a.is_bytevc1 - b.is_bytevc1
+  return b.play_addr.data_size - a.play_addr.data_size
+}
+
+/**
+ * 按档位给 mp4 视频源分组，组内已按 {@link compareVideoPreference} 排好序
+ * @param videos - 视频源数组
+ * @returns 档位 → 该档位下的视频源
+ */
+const groupByQualityLevel = (videos: dyVideo[]): Map<DouyinQualityLevel, dyVideo[]> => {
+  const grouped = new Map<DouyinQualityLevel, dyVideo[]>()
+  for (const video of videos) {
+    const level = getDouyinQualityLevel(video)
+    if (!level) {
+      logger.debug(`无法判定清晰度档位，跳过该视频源：gear_name=${video.gear_name}`)
+      continue
+    }
+    const bucket = grouped.get(level)
+    if (bucket) {
+      bucket.push(video)
+    } else {
+      grouped.set(level, [video])
+    }
+  }
+  grouped.forEach((bucket) => bucket.sort(compareVideoPreference))
+  return grouped
+}
+
+/**
+ * 构建抖音视频播放地址（二维码分享链接与下载共用）。
+ * 上游 play 接口现在除 video_id 外还要求携带 file_id（从 play_addr.url_list[2] 的查询参数中提取），
+ * 旧的 ratio/line 参数不再需要；file_id 提取失败时回退为仅带 video_id。
+ * @param playAddr - 视频源的 play_addr 对象（bit_rate 项或 images 项的 play_addr_h264）
+ * @returns 完整的播放地址
+ */
+export const buildDouyinPlayUrl = (playAddr: { uri: string; url_list?: string[] }): string => {
+  const fileId = (() => {
+    try {
+      const wrappedUrl = playAddr.url_list?.[2]
+      return wrappedUrl ? new URL(wrappedUrl).searchParams.get('file_id') : null
+    } catch {
+      return null
+    }
+  })()
+  return fileId
+    ? `https://aweme.snssdk.com/aweme/v1/play/?video_id=${playAddr.uri}&file_id=${fileId}`
+    : `https://aweme.snssdk.com/aweme/v1/play/?video_id=${playAddr.uri}`
+}
+
+/**
+ * 把选中的视频源格式化成展示用的清晰度字符串。
+ * 传入的必须是 {@link douyinProcessVideos} 选中的那一路源 —— 卡片上展示的清晰度要和实际下载的一致，
+ * 否则会出现「卡片写 4K、实际下载 720p」的错位。
+ * @param video - 选中的视频源
+ * @returns 形如 `超清4K`；档位认不出时返回空字符串
+ */
+export const formatDouyinQualityLabel = (video: dyVideo | undefined | null) => {
+  if (!video) return ''
+  const level = getDouyinQualityLevel(video)
+  if (!level) return ''
+  return QUALITY_LABEL[level]
+}
+
+/**
+ * 按画质偏好从抖音视频源列表里挑出唯一一路可下载的源
+ * @param videos - `aweme_detail.video.bit_rate` 数组
+ * @param videoQuality - 画质偏好，`adapt` 为按体积上限自动选择，其余为固定档位
+ * @param maxAutoVideoSize - 自动模式下可接受的最大体积（MB），缺省回落到 `Config.app.filelimit`
+ * @returns 长度为 1 的数组，元素为选中的视频源
+ */
+export const douyinProcessVideos = (videos: dyVideo[], videoQuality: string, maxAutoVideoSize?: number): dyVideo[] => {
+  // Web 端与下载都只认 mp4 封装，dash 是 App 端流媒体专用
+  const mp4Videos = videos.filter((video) => video.format === 'mp4')
+
+  if (mp4Videos.length === 0) {
+    logger.warn('没有找到可用的 mp4 格式视频')
+    return videos.slice(0, 1) // 返回第一个视频作为备选
+  }
+
+  logger.debug(`过滤后剩余 ${mp4Videos.length} 个 mp4 格式视频`)
+
+  const videosByQuality = groupByQualityLevel(mp4Videos)
+
+  // 如果是自动模式
+  if (videoQuality === 'adapt') {
+    const sizeLimitBytes = (maxAutoVideoSize || Config.app.filelimit) * 1024 * 1024
+
+    for (const quality of QUALITY_PRIORITY) {
+      const qualityVideos = videosByQuality.get(quality)
+      if (qualityVideos && qualityVideos.length > 0) {
+        // 该档位下第一个不超过体积上限的源（组内已按 H.264 优先、体积从大到小排序）
+        const suitableVideo = qualityVideos.find((video) => video.play_addr.data_size <= sizeLimitBytes)
+        if (suitableVideo) {
+          logger.debug(`自动选择画质: ${quality}, 文件大小: ${(suitableVideo.play_addr.data_size / (1024 * 1024)).toFixed(2)}MB`)
+          return [suitableVideo]
+        }
+      }
+    }
+
+    // 如果没有找到符合大小限制的视频，选择最小的视频
+    let smallestVideo = mp4Videos[0]
+    mp4Videos.forEach((video) => {
+      if (video.play_addr.data_size < smallestVideo.play_addr.data_size) {
+        smallestVideo = video
+      }
+    })
+    logger.debug(`未找到符合大小限制的视频，选择最小视频: ${(smallestVideo.play_addr.data_size / (1024 * 1024)).toFixed(2)}MB`)
+    return [smallestVideo]
+  }
+
+  // 固定画质模式
+  const targetQuality = videoQuality as DouyinQualityLevel
+  const targetVideos = videosByQuality.get(targetQuality)
+
+  if (targetVideos && targetVideos.length > 0) {
+    // 选择该画质下最优的视频源
+    logger.debug(`选择固定画质: ${targetQuality}, 文件大小: ${(targetVideos[0].play_addr.data_size / (1024 * 1024)).toFixed(2)}MB`)
+    return [targetVideos[0]]
+  }
+
+  // 如果没有找到目标画质，选择最接近的画质
+  const targetIndex = QUALITY_PRIORITY.indexOf(targetQuality)
+
+  // 先尝试向下找（更低画质）
+  for (let i = targetIndex + 1; i < QUALITY_PRIORITY.length; i++) {
+    const fallbackVideos = videosByQuality.get(QUALITY_PRIORITY[i])
+    if (fallbackVideos && fallbackVideos.length > 0) {
+      logger.debug(`目标画质 ${targetQuality} 不可用，降级到: ${QUALITY_PRIORITY[i]}`)
+      return [fallbackVideos[0]]
+    }
+  }
+
+  // 再尝试向上找（更高画质）
+  for (let i = targetIndex - 1; i >= 0; i--) {
+    const fallbackVideos = videosByQuality.get(QUALITY_PRIORITY[i])
+    if (fallbackVideos && fallbackVideos.length > 0) {
+      logger.debug(`目标画质 ${targetQuality} 不可用，升级到: ${QUALITY_PRIORITY[i]}`)
+      return [fallbackVideos[0]]
+    }
+  }
+
+  // 如果都没找到，返回第一个可用视频
+  logger.warn('未找到任何匹配的画质，返回默认视频')
+  return [mp4Videos[0]]
+}

package/src/karin/platform/douyin/workType.ts

@@ -0,0 +1,238 @@
+import type { DouyinWorkDetailData } from './types'
+
+/**
+ * 抖音作品类型工具模块
+ * 提供统一的作品类型判断和处理逻辑
+ */
+
+/**
+ * 抖音作品主类型
+ */
+export enum DouyinWorkMainType {
+  /** 视频作品 */
+  VIDEO = 'video',
+  /** 图文作品（包含图集和合辑） */
+  IMAGE = 'image',
+  /** 文章作品 */
+  ARTICLE = 'article',
+  /** 直播 */
+  LIVE = 'live',
+  /** 音乐 */
+  MUSIC = 'music',
+  /** 未知类型 */
+  UNKNOWN = 'unknown'
+}
+
+/**
+ * 图文作品子类型
+ */
+export enum DouyinImageSubType {
+  /** 图集（纯静态图片或包含 live 图） */
+  GALLERY = 'gallery',
+  /** 合辑（图片+视频混合） */
+  COLLECTION = 'collection'
+}
+
+/**
+ * 作品类型详细信息
+ */
+export interface DouyinWorkTypeInfo {
+  /** 主类型 */
+  mainType: DouyinWorkMainType
+  /** 子类型（仅图文作品有） */
+  subType?: DouyinImageSubType
+  /** 是否为视频 */
+  isVideo: boolean
+  /** 是否为图文 */
+  isImage: boolean
+  /** 是否为文章 */
+  isArticle: boolean
+  /** 是否为直播 */
+  isLive: boolean
+  /** 是否为图集 */
+  isGallery: boolean
+  /** 是否为合辑 */
+  isCollection: boolean
+  /** 模板路径 */
+  templatePath: 'douyin/video-work' | 'douyin/image-work' | 'douyin/article-work' | 'douyin/live'
+}
+
+export type DouyinLivePhotoMode = 'video_and_livephoto' | 'video_only' | 'livephoto_only'
+
+export interface DouyinLiveImageSendPolicy {
+  shouldGenerateVideo: boolean
+  shouldGenerateLivePhoto: boolean
+}
+
+/**
+ * 从 URL 路径判断作品类型
+ */
+export function getWorkTypeFromUrl(url: string): DouyinWorkMainType {
+  if (/\/video\//.test(url)) return DouyinWorkMainType.VIDEO
+  if (/\/note\//.test(url)) return DouyinWorkMainType.IMAGE
+  if (/\/article\//.test(url)) return DouyinWorkMainType.ARTICLE
+  if (/live\.douyin\.com/.test(url) || /webcast\.amemv\.com/.test(url)) return DouyinWorkMainType.LIVE
+  if (/\/music\//.test(url)) return DouyinWorkMainType.MUSIC
+  return DouyinWorkMainType.UNKNOWN
+}
+
+/**
+ * 从作品数据判断详细类型信息
+ */
+export function getWorkTypeInfo(data: {
+  aweme_type?: number
+  media_type?: number
+  images?: DouyinWorkDetailData['images']
+  video?: DouyinWorkDetailData['video']
+  is_slides?: boolean
+  article_info?: DouyinWorkDetailData['article_info']
+  /** 直播推送的详情数据（只有无值判断，形状由上游合流后再读） */
+  live_data?: unknown
+}): DouyinWorkTypeInfo {
+  // 直播类型（有 live_data 对象）
+  if (data.live_data) {
+    return {
+      mainType: DouyinWorkMainType.LIVE,
+      isVideo: false,
+      isImage: false,
+      isArticle: false,
+      isLive: true,
+      isGallery: false,
+      isCollection: false,
+      templatePath: 'douyin/live'
+    }
+  }
+
+  // 文章类型（aweme_type === 163）
+  if (data.aweme_type === 163 || data.article_info) {
+    return {
+      mainType: DouyinWorkMainType.ARTICLE,
+      isVideo: false,
+      isImage: false,
+      isArticle: true,
+      isLive: false,
+      isGallery: false,
+      isCollection: false,
+      templatePath: 'douyin/article-work'
+    }
+  }
+
+  // 图文类型（有 images 数组）
+  if (data.images && data.images.length > 0) {
+    const subType = data.is_slides === true ? DouyinImageSubType.COLLECTION : DouyinImageSubType.GALLERY
+
+    return {
+      mainType: DouyinWorkMainType.IMAGE,
+      subType,
+      isVideo: false,
+      isImage: true,
+      isArticle: false,
+      isLive: false,
+      isGallery: subType === DouyinImageSubType.GALLERY,
+      isCollection: subType === DouyinImageSubType.COLLECTION,
+      templatePath: 'douyin/image-work'
+    }
+  }
+
+  // 视频类型（默认）
+  return {
+    mainType: DouyinWorkMainType.VIDEO,
+    isVideo: true,
+    isImage: false,
+    isArticle: false,
+    isLive: false,
+    isGallery: false,
+    isCollection: false,
+    templatePath: 'douyin/video-work'
+  }
+}
+
+/** 抖音图床低分辨率处理模板（如 ~tplv-dy-360p.jpeg），命中说明该封面 URL 被 CDN 降质 */
+const LOW_RES_COVER_PATTERN = /~tplv-[^/?]*(?:270p|360p|480p|540p)/i
+
+/**
+ * 获取作品封面 URL
+ */
+export function getWorkCoverUrl(
+  workTypeInfo: DouyinWorkTypeInfo,
+  data: {
+    video?: {
+      animated_cover?: { url_list: string[] }
+      cover_original_scale?: { url_list: string[] }
+      origin_cover?: { url_list: string[] }
+      cover?: { url_list: string[] }
+    }
+    images?: Array<{ url_list: string[] }> | null
+    article_info?: {
+      article_content?: string
+    }
+  }
+): string {
+  // 视频封面
+  if (workTypeInfo.isVideo && data.video) {
+    // 详情接口没有 animated_cover，会落到 cover_original_scale，
+    // 而它的 url_list[0] 常是 ~tplv-dy-360p 这类 CDN 降质模板（签名绑定路径，无法改 URL 还原）。
+    // 所以按优先级收集所有候选后，优先取未命中低清模板的；全部命中时维持原优先级兜底。
+    const candidates = [data.video.animated_cover, data.video.cover_original_scale, data.video.origin_cover, data.video.cover].flatMap(
+      (field) => field?.url_list ?? []
+    )
+    return candidates.find((url) => !LOW_RES_COVER_PATTERN.test(url)) ?? candidates[0] ?? ''
+  }
+
+  // 图文封面
+  if (workTypeInfo.isImage && data.images && data.images.length > 0) {
+    return data.images[0].url_list[0] ?? ''
+  }
+
+  // 文章封面
+  if (workTypeInfo.isArticle && data.article_info?.article_content) {
+    try {
+      const content = JSON.parse(data.article_info.article_content)
+      return content.head_poster_list?.url_list?.[0] ?? ''
+    } catch {
+      return ''
+    }
+  }
+
+  return ''
+}
+
+/**
+ * 获取作品类型的显示名称
+ */
+export function getWorkTypeDisplayName(workTypeInfo: DouyinWorkTypeInfo): string {
+  if (workTypeInfo.isVideo) return '视频'
+  if (workTypeInfo.isGallery) return '图集'
+  if (workTypeInfo.isCollection) return '合辑'
+  if (workTypeInfo.isArticle) return '文章'
+  if (workTypeInfo.isLive) return '直播'
+  return '未知'
+}
+
+/**
+ * 判断是否需要特殊处理（如 live 图）
+ */
+export function needsSpecialImageProcessing(workTypeInfo: DouyinWorkTypeInfo, images?: Array<{ clip_type?: number }>): boolean {
+  if (!workTypeInfo.isImage || !images) return false
+
+  // 检查是否包含 live 图（clip_type !== 2）
+  return images.some((item) => item.clip_type !== 2 && item.clip_type !== undefined)
+}
+
+/**
+ * 抖音图文里的 clip_type=5 才能生成系统实况图；clip_type=4 是短片。
+ * 用户选择仅发送实况图时，短片仍需兜底成视频节点，避免生成空合并转发。
+ */
+export function getDouyinLiveImageSendPolicy(
+  clipType: number | undefined,
+  livePhotoMode: DouyinLivePhotoMode = 'video_and_livephoto'
+): DouyinLiveImageSendPolicy {
+  const isStaticImage = clipType === 2 || clipType === undefined
+  const canGenerateLivePhoto = clipType === 5
+  const shouldFallbackToVideo = livePhotoMode === 'livephoto_only' && !isStaticImage && !canGenerateLivePhoto
+
+  return {
+    shouldGenerateVideo: livePhotoMode === 'video_and_livephoto' || livePhotoMode === 'video_only' || shouldFallbackToVideo,
+    shouldGenerateLivePhoto: canGenerateLivePhoto && (livePhotoMode === 'video_and_livephoto' || livePhotoMode === 'livephoto_only')
+  }
+}

package/src/karin/platform/index.ts

@@ -0,0 +1,4 @@
+export * from './bilibili'
+export * from './douyin'
+export * from './kuaishou'
+export * from './xiaohongshu'