koishi-plugin-kkk 1.0.0

package/src/karin/root.ts

@@ -0,0 +1,78 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { Package } from 'node-karin'
+
+const resolvePluginRoot = (startUrl: string) => {
+  let dir = path.dirname(startUrl)
+  for (let i = 0; i < 8; i++) {
+    const pkgPath = path.join(dir, 'package.json')
+    if (fs.existsSync(pkgPath)) {
+      return dir
+    }
+    const parent = path.dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  return path.resolve(startUrl, '../..')
+}
+
+// Koishi 移植：编译为 CJS 后没有 import.meta，改用 __filename
+const pluginPath = resolvePluginRoot(__filename)
+const pkg = JSON.parse(fs.readFileSync(path.join(pluginPath, 'package.json'), 'utf-8')) as Package
+
+/**
+ * 框架版本号。
+ *
+ * 上游 karin 用 `process.env.KARIN_VERSION`；Koishi 移植版里这个环境变量通常不存在，
+ * 于是各处（错误卡片、运行环境诊断海报）都会显示成字面量 `koishi-compat`，
+ * 卡片页脚看上去就是「vkoishi-compat」这种没意义的版本号。
+ * 这里改成报**真实运行框架的版本**：优先环境变量，其次 Koishi 自己的版本号。
+ */
+const resolveFrameworkVersion = (): string => {
+  if (process.env.KARIN_VERSION) return process.env.KARIN_VERSION
+  const candidates = ['koishi/package.json', '@koishijs/core/package.json']
+  for (const id of candidates) {
+    try {
+      // 编译产物是 CJS，这里的 require 能直接从插件的 node_modules 解析到宿主 koishi
+      const loaded = require(id)
+      const version = String(loaded?.version ?? '')
+      if (version) return version
+    } catch { /* 换下一个候选 */ }
+  }
+  // 兜底：从插件目录往上找宿主的 node_modules/koishi/package.json
+  try {
+    let dir = pluginPath
+    for (let i = 0; i < 8; i++) {
+      const candidate = path.join(dir, 'node_modules', 'koishi', 'package.json')
+      if (fs.existsSync(candidate)) {
+        const version = String(JSON.parse(fs.readFileSync(candidate, 'utf-8'))?.version ?? '')
+        if (version) return version
+      }
+      const parent = path.dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+  } catch { /* 忽略 */ }
+  return 'koishi-compat'
+}
+
+export const Root: {
+  /** 插件名字 */
+  pluginName: string
+  /** 插件版本号 */
+  pluginVersion: string
+  /** 插件路径 */
+  pluginPath: string
+  /** Karin版本 */
+  karinVersion: string
+  /** 插件package.json */
+  pkg: Package
+} = {
+  pluginName: pkg.name,
+  pluginVersion: pkg.version,
+  pluginPath,
+  karinVersion: resolveFrameworkVersion(),
+  pkg
+}

package/src/karin/setup.ts

@@ -0,0 +1,77 @@
+import '@/module/server'
+import '@/platform/bilibili/riskControl'
+import karin, { AdapterType, BOT_CONNECT, config, ImageElement, logger, Message, mkdirSync, SendMessage } from 'node-karin'
+import { karinPathBase } from 'node-karin/root'
+
+import { Common, Render, Root } from '@/module'
+import { initAllDatabases } from '@/module/db'
+
+import { isSemverGreater } from './module/utils/semver'
+
+declare const __REQUIRE_KARIN_VERSION__: string
+
+// ----------------- VERSION CHECK -----------------
+const requireVersion = typeof __REQUIRE_KARIN_VERSION__ !== 'undefined' ? __REQUIRE_KARIN_VERSION__ : '1.1145.14'
+// const requireVersion = '1.14514.1'
+if (process.env.NODE_ENV !== 'development' && isSemverGreater(requireVersion, Root.karinVersion)) {
+  const msg = `[koishi-plugin-kkk] 插件构建时的 karin 版本 (${requireVersion}) 高于当前运行版本 (${Root.karinVersion})，可能会出现兼容性问题！`
+  logger.warn(msg)
+
+  /** 已发送通知的 Bot ID 和主人 ID 组合，格式：`${botId}:${master}` */
+  const notifiedSet = new Set<string>()
+
+  karin.on(BOT_CONNECT, async (bot: AdapterType) => {
+    const botId = bot.selfId
+
+    // 跳过 console Bot
+    if (botId === 'console') return
+
+    // 增加延迟，确保 bot 完全初始化
+    await new Promise((resolve) => setTimeout(resolve, 2000))
+    const masters = config.master()
+
+    logger.info(`[koishi-plugin-kkk] 监测到 Bot 连接: ${botId}, 准备发送版本警告`)
+
+    // 生成警告图片
+    let warningImage: ImageElement[] | null = null
+
+    for (const master of masters) {
+      if (master === 'console') continue
+
+      try {
+        warningImage = await Render({ bot: karin.getBot(botId) } as Message, 'other/version_warning', {
+          requireVersion,
+          currentVersion: Root.karinVersion
+        })
+      } catch (error) {
+        logger.error(`[koishi-plugin-kkk] 生成版本警告图片失败: ${error}`)
+      }
+
+      const key = `${botId}:${master}`
+      if (notifiedSet.has(key)) continue
+
+      try {
+        const elements: SendMessage = []
+        if (warningImage) {
+          elements.push(...warningImage)
+        }
+
+        await karin.sendMaster(botId, master, elements)
+        notifiedSet.add(key)
+        logger.info(`[koishi-plugin-kkk] 已发送版本警告给主人: ${master} (via ${botId})`)
+      } catch (error) {
+        logger.error(`[koishi-plugin-kkk] 发送版本警告给主人 (${master}) 失败: ${error}`)
+      }
+    }
+  })
+}
+
+// ----------------- DATABASE INIT -----------------
+await initAllDatabases().catch((err) => {
+  logger.error(`[koishi-plugin-kkk] 数据库初始化失败: ${err.message}`)
+})
+
+// ------------------- MAIN INIT -------------------
+mkdirSync(`${karinPathBase}/${Root.pluginName}/data`)
+mkdirSync(Common.tempDri.images)
+mkdirSync(Common.tempDri.video)

package/src/karin/types/config/amagi.ts

@@ -0,0 +1,46 @@
+/** amagi 解析库配置（合并了 cookies 和 request） */
+export interface amagiConfig {
+  /** 请求超时时间，单位：毫秒 */
+  timeout: number
+
+  /** 浏览器用户代理 */
+  'User-Agent': string
+
+  /** 代理配置 */
+  proxy?: {
+    /** 代理开关 */
+    switch: boolean
+    /** 代理主机 */
+    host: string
+    /** 代理端口 */
+    port: number
+    /** 代理协议 */
+    protocol: 'http' | 'https'
+    /** 代理认证 */
+    auth?: {
+      /** 用户名 */
+      username: string
+      /** 密码 */
+      password: string
+    }
+  }
+
+  /** 各平台 Cookies */
+  cookies: {
+    /** B站ck */
+    bilibili: string
+    /** 抖音ck */
+    douyin: string
+    /** 快手ck */
+    kuaishou: string
+    /** 小红书ck */
+    xiaohongshu: string
+  }
+
+  /** API 服务开关 */
+  APIServer: boolean
+  /** API 服务是否挂载到 Karin */
+  APIServerMount: boolean
+  /** API 服务端口（未挂载时生效） */
+  APIServerPort: number
+}

package/src/karin/types/config/app.ts

@@ -0,0 +1,129 @@
+/** 定义视频解析工具的配置接口 */
+export interface appConfig {
+  /** 默认解析，即识别最高优先级，修改后重启生效 */
+  videoTool: boolean
+
+  /** 自定义优先级，「默认解析」关闭后才会生效。修改后重启生效 */
+  priority: number
+
+  /** 缓存自动删除，非必要不修改！ */
+  removeCache: boolean
+
+  /** 渲染精度，可选值50~200，建议100。设置高精度会提高图片的精细度，过高可能会影响渲染与发送速度 */
+  renderScale: number
+
+  /** 渲染图片的主题色，0为自动，1为浅色，2为深色，3为智能场景（实验性，支持封面的模板会根据封面判断深浅色） */
+  Theme: number
+
+  /** 封面氛围背景参数：控制封面图对模板背景氛围的贡献度，取值均为 0~1 */
+  ambientCover: {
+    /** 模糊封面层不透明度：封面色强度总闸，越大整体越浓 */
+    coverOpacity: number
+    /** 主题色压色罩两端（顶/底）不透明度 */
+    overlayEdgeOpacity: number
+    /** 主题色压色罩中间带不透明度，越小封面色越透 */
+    overlayMiddleOpacity: number
+  }
+
+  /** 渲染图片的等待时间，单位：秒；传递0可禁用 */
+  RenderWaitTime: number
+
+  /** 表情回应，若适配器不支持需要关闭 */
+  EmojiReply: boolean
+
+  /** 解析提示，发送提示信息："检测到xxx链接，开始解析" */
+  parseTip: boolean
+
+  /** 是否伪造合并转发消息，开启后使用触发者身份展示转发 */
+  fakeForward: boolean
+
+  // /**
+  //  * 表情 ID
+  //  * @see https://github.com/NapNeko/NapCatQQ/blob/main/packages/napcat-core/external/face_config.json
+  //  */
+  // EmojiReplyID: number
+
+  // /** 忽略表情回应失败，开启后表情回应失败时不会抛出错误 */
+  // EmojiReplyIgnoreError: boolean
+
+  /** 遇到错误时谁会收到错误日志：触发者 / 管理员（权限等级 > 4） */
+  errorLogSendTo: Array<'trigger' | 'admin' | 'master' | 'allMasters'>
+
+  /** 分页渲染，将模板渲染成多页的图片，以降低渲染器压力，默认开启，非必要不修改 */
+  multiPageRender: boolean
+
+  /** 分页渲染时，每页的高度，经测试最佳每页高度为12000px，默认12000px */
+  multiPageHeight: number
+
+  /** 解析包含 Live Photo 作品时，发送的静态图兼容系统
+   * - 'google': Google Motion Photo 格式
+   * - 'xiaomi': 小米实况照片格式，兼容小米（支持实况照片的任何版本）和 Google，但无法被 OPPO 识别
+   * - 'oppo': OPPO 实况照片格式（推荐），兼容 OPPO、小米（较新版本）和 Google，兼容性最广
+   * - 'huawei_honor': 华为/荣耀实况照片格式（理论可行但未实测，作者无对应设备）
+   * 注：vivo（Origin OS）和 iPhone（iOS）需要独立的图片和同名视频文件，暂不支持
+   */
+  livePhotoSystem: 'google' | 'xiaomi' | 'oppo' | 'huawei_honor'
+
+  /** 解析遇到实况图时的处理和发送方式
+   * - 'video_and_livephoto': 生成并发送仿 iPhone Live Photo 播放效果的视频（播放三次，性能开销大，2C2G 服务器约 20s/张）+ 对应系统的实况图
+   * - 'video_only': 仅生成并发送仿 iPhone Live Photo 播放效果的视频（播放三次，性能开销大，2C2G 服务器约 20s/张）
+   * - 'livephoto_only': 仅生成并发送对应系统的实况图
+   */
+  livePhotoMode: 'video_and_livephoto' | 'video_only' | 'livephoto_only'
+
+  /** 扫码登录时使用的地址类型，可选值：'lan'（局域网IP）、'external'（外部地址） */
+  qrLoginAddrType: 'lan' | 'external'
+
+  /** 外部访问地址（当 qrLoginAddrType 为 'external' 时使用，可以是公网IP或域名） */
+  qrLoginExternalAddr: string
+
+  // ============ 以下字段从 uploadConfig 合并 ============
+
+  /**
+   * 本地视频发送方式
+   * - 'file': 使用 file 协议发送本地视频（需 Karin 与协议端在同一系统）
+   * - 'base64': 转换为 base64 后发送（传输数据量增大约 30%，不在同一网络环境可能导致额外带宽成本）
+   */
+  videoSendMode: 'file' | 'base64'
+
+  /** 视频上传拦截，开启后会根据视频文件大小判断是否需要上传，需配置「视频拦截阈值」。 */
+  usefilelimit: boolean
+
+  /** 视频拦截阈值，视频文件大于该数值则直接结束任务，不会上传，单位: MB，「视频上传拦截」开启后才会生效。 */
+  filelimit: number
+
+  /** 压缩视频，开启后会将视频文件压缩后再上传，适合上传大文件，任务过程中会吃满CPU，对低配服务器不友好。需配置「压缩触发阈值」与「压缩后的值」 */
+  compress: boolean
+
+  /** 压缩触发阈值，触发视频压缩的阈值，单位：MB。当文件大小超过该值时，才会压缩视频，「压缩视频」开启后才会生效 */
+  compresstrigger: number
+
+  /** 压缩后的值，单位：MB。若视频文件大小大于「压缩触发阈值」的值，则会进行压缩至该值（±5%），「压缩视频」开启后才会生效 */
+  compressvalue: number
+
+  /** 群文件上传，使用群文件上传，开启后会将视频文件上传到群文件中，需配置「群文件上传阈值」 */
+  usegroupfile: boolean
+
+  /** 群文件上传阈值，当文件大小超过该值时将使用群文件上传，单位：MB，「使用群文件上传」开启后才会生效 */
+  groupfilevalue: number
+
+  /**
+   * 网络图片发送方式
+   * - 'url': 直接传递 HTTP 链接给上游下载（可能因上游网络问题导致下载超时）
+   * - 'file': 下载到本地使用 file 协议发送（需 Karin 与协议端在同一系统）
+   * - 'base64': 下载后转换为 base64 发送（传输数据量增大约 30%，不在同一网络环境可能导致额外带宽成本）
+   */
+  imageSendMode: 'url' | 'file' | 'base64'
+
+  /** 下载限速开关，开启后会限制下载速度，避免触发服务器风控导致连接被重置 */
+  downloadThrottle: boolean
+
+  /** 下载速度限制，单位：MB/s，0 表示不限速。建议设置为 5-20 之间，过高可能触发风控 */
+  downloadMaxSpeed: number
+
+  /** 断流自动降速，当检测到连接被重置时自动降低下载速度 */
+  downloadAutoReduce: boolean
+
+  /** 最低下载速度，单位：MB/s，自动降速时不会低于此值 */
+  downloadMinSpeed: number
+}

package/src/karin/types/config/bilibili.ts

@@ -0,0 +1,121 @@
+/** 定义B站解析工具的配置接口 */
+export interface bilibiliConfig {
+  /** B站解析开关，单独开关，受「总开关」影响 */
+  switch: boolean
+
+  /** 解析时发送的内容，可选值：'info'(视频信息)、'comment'(评论图片)、'video'(视频文件) */
+  sendContent: ['info' | 'comment' | 'video']
+
+  /** B站评论数量，设置接口返回的评论数量，范围1 ~ x 条 */
+  numcomment: number
+
+  /** 评论图是否显示真实评论数量，关闭则显示解析到的评论数量 */
+  realCommentCount: boolean
+
+  /** 是否收集评论区的图片 */
+  commentImageCollection: boolean
+
+  /** 视频画质偏好设置，0 为自动根据大小选择，其他为固定画质
+   * - 0: 自动根据大小选择
+   * - 6: 240P 极速 (仅MP4格式支持)
+   * - 16: 360P 流畅
+   * - 32: 480P 清晰
+   * - 64: 720P 高清 (WEB默认值)
+   * - 74: 720P60 高帧率 (需登录)
+   * - 80: 1080P 高清 (TV/APP默认值，需登录)
+   * - 112: 1080P+ 高码率 (需大会员)
+   * - 116: 1080P60 高帧率 (需大会员)
+   * - 120: 4K 超清 (需大会员且支持4K)
+   * - 127: 8K 超高清 (需大会员且支持8K)
+   */
+  videoQuality: 0 | 6 | 16 | 32 | 64 | 74 | 80 | 112 | 116 | 120 | 127
+
+  /** 视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 0 时生效 */
+  maxAutoVideoSize: number
+
+  /** 谁可以触发扫码登录，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启 */
+  loginPerm: 'all' | 'admin' | 'master' | 'group.owner' | 'group.admin'
+
+  /** 解析图文动态时，遇到多张图片时的页面布局方式（动态推送图片也生效）：
+   * - 'vertical'(逐张上下排列)
+   * - 'waterfall'(瀑布流排列)
+   * - 'grid'(九宫格排列)
+   * - 'auto'（自动布局：少于4张时逐张上下排列；4~8张时瀑布流；9张及以上九宫格） */
+  imageLayout: 'vertical' | 'waterfall' | 'grid' | 'auto'
+
+  /** 视频信息返回形式：
+   * - 'text'(文本模式)
+   * - 'image'(图片模式) */
+  videoInfoMode: 'text' | 'image'
+
+  /** 视频信息的内容，可选值：'cover'(封面)、'title'(标题)、'author'(作者)、'stats'(视频统计信息)、'desc'(简介)，数组为空则不显示任何内容 */
+  displayContent: ('cover' | 'title' | 'author' | 'stats' | 'desc')[]
+
+  /** 视频信息图片中显示弹幕（仅「视频信息返回形式」为图片模式时生效，关闭后不会请求弹幕数据） */
+  showDanmakuInVideoInfo: boolean
+
+  /** 弹幕烧录（将弹幕硬编码到视频画面中，需要重新编码视频） */
+  burnDanmaku: boolean
+
+  /** 弹幕显示区域（限制弹幕范围，避免遮挡视频主体）
+   * - 0.25: 1/4 屏，仅顶部区域
+   * - 0.5: 半屏，上半部分（推荐）
+   * - 0.75: 3/4 屏，大部分区域
+   * - 1: 全屏，铺满整个画面
+   */
+  danmakuArea: 0.25 | 0.5 | 0.75 | 1
+
+  /** 弹幕字号
+   * - 'small': 小号
+   * - 'medium': 中号（推荐）
+   * - 'large': 大号
+   */
+  danmakuFontSize: 'small' | 'medium' | 'large'
+
+  /** 弹幕透明度（0-100，0为完全透明，100为完全不透明） */
+  danmakuOpacity: number
+
+  /** 竖屏适配模式（模拟手机端竖屏观看体验）
+   * - 'off': 关闭，保持原始视频比例
+   * - 'standard': 智能模式，仅对 16:9、21:9 等常见宽屏比例生效
+   * - 'force': 强制 9:16，所有视频统一转为竖屏，弹幕大小一致
+   */
+  verticalMode: 'off' | 'standard' | 'force'
+
+  /** 视频编码格式
+   * - 'h264': 兼容性最好，支持几乎所有设备
+   * - 'h265': 压缩率更高，近几年设备支持良好（默认）
+   * - 'av1': 最新编码格式，压缩率最高，但编码较慢
+   */
+  videoCodec: 'h264' | 'h265' | 'av1'
+
+  /** B站推送相关配置 */
+  push: {
+    /** 推送开关，开启后需重启；使用「#设置B站推送 + 用户UID」配置推送列表 */
+    switch: boolean
+    /** 谁可以设置推送，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启 */
+    permission: 'all' | 'admin' | 'master' | 'group.owner' | 'group.admin'
+    /** 推送表达式 */
+    cron: string
+    /** 推送时是否一同解析该动态 */
+    parsedynamic: boolean
+    /** 开启推送解析后，需要进一步解析的动态类型 */
+    parseDynamicTypes: ('DYNAMIC_TYPE_AV' | 'DYNAMIC_TYPE_DRAW' | 'DYNAMIC_TYPE_ARTICLE')[]
+    /** 推送时遇到视频动态时解析的画质偏好设置，0 为自动根据「pushMaxAutoVideoSize」大小选择，其他为固定画质，仅「parsedynamic」为 true 时生效
+     * - 0: 自动根据大小选择
+     * - 6: 240P 极速 (仅MP4格式支持)
+     * - 16: 360P 流畅
+     * - 32: 480P 清晰
+     * - 64: 720P 高清 (WEB默认值)
+     * - 74: 720P60 高帧率 (需登录)
+     * - 80: 1080P 高清 (TV/APP默认值，需登录)
+     * - 112: 1080P+ 高码率 (需大会员)
+     * - 116: 1080P60 高帧率 (需大会员)
+     * - 120: 4K 超清 (需大会员且支持4K)
+     */
+    pushVideoQuality: 0 | 6 | 16 | 32 | 64 | 74 | 80 | 112 | 116 | 120
+
+    /** 推送时遇到视频动态时解析的视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「pushVideoQuality」 为 0 且「parsedynamic」为 true时生效 */
+    pushMaxAutoVideoSize: number
+  }
+}

package/src/karin/types/config/cookies.ts

@@ -0,0 +1,11 @@
+/** 定义不同平台用户ck的配置接口 */
+export interface cookiesConfig {
+  /** B站ck */
+  bilibili: string
+  /** 抖音ck */
+  douyin: string
+  /** 快手ck */
+  kuaishou: string
+  /** 小红书ck */
+  xiaohongshu: string
+}

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

@@ -0,0 +1,93 @@
+/** 定义抖音解析工具的配置接口 */
+export interface douyinConfig {
+  /** 抖音解析开关，单独开关，受「总开关」影响 */
+  switch: boolean
+
+  /** 解析时发送的内容，可选值：'info'(视频信息)、'comment'(评论图片)、'video'(视频文件) */
+  sendContent: ['info' | 'comment' | 'video']
+
+  /** 抖音评论数量，范围1 ~ x 条 */
+  numcomment: number
+
+  /** 次级评论请求数量，范围1 ~ x 条，最高尽量 8 条左右，当前逻辑无法判断请求的来的评论的嵌套深度，超过深度的评论会被截断 */
+  subCommentLimit: number
+
+  /** 是否收集评论区的图片 */
+  commentImageCollection: boolean
+
+  /** 合辑 Live 图 BGM 合并模式
+   * - 'continuous': 连续模式，BGM 接续播放
+   * - 'independent': 独立模式，每张图 BGM 从头开始
+   */
+  liveImageMergeMode: 'continuous' | 'independent'
+
+  /** 视频画质偏好设置，'adapt' 为自动根据「maxAutoVideoSize」大小选择，其他为固定画质 */
+  videoQuality: 'adapt' | '540p' | '720p' | '1080p' | '2k' | '4k'
+
+  /** 视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 'adapt' 时生效 */
+  maxAutoVideoSize: number
+
+  /** 谁可以触发扫码登录，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启 */
+  loginPerm: 'all' | 'admin' | 'master' | 'group.owner' | 'group.admin'
+
+  /** 视频信息返回形式：
+   * - 'text'(文本模式)
+   * - 'image'(图片模式) */
+  videoInfoMode: 'text' | 'image'
+
+  /** 视频信息的内容，可选值：'cover'(封面)、'title'(标题)、'author'(作者)、'stats'(视频统计信息)，数组为空则不显示任何内容 */
+  displayContent: ('cover' | 'title' | 'author' | 'stats')[]
+
+  /** 弹幕烧录（将弹幕硬编码到视频画面中，需要重新编码视频） */
+  burnDanmaku: boolean
+
+  /** 弹幕显示区域（限制弹幕范围，避免遮挡视频主体）
+   * - 0.25: 1/4 屏，仅顶部区域
+   * - 0.5: 半屏，上半部分（推荐）
+   * - 0.75: 3/4 屏，大部分区域
+   * - 1: 全屏，铺满整个画面
+   */
+  danmakuArea: 0.25 | 0.5 | 0.75 | 1
+
+  /** 弹幕字号
+   * - 'small': 小号
+   * - 'medium': 中号（推荐）
+   * - 'large': 大号
+   */
+  danmakuFontSize: 'small' | 'medium' | 'large'
+
+  /** 弹幕透明度（0-100，0为完全透明，100为完全不透明） */
+  danmakuOpacity: number
+
+  /** 横屏转竖屏模式（针对横屏视频）
+   * - 'off': 关闭，保持原始比例
+   * - 'standard': 智能模式，仅对宽高比 ≥1.7 的横屏视频转竖屏
+   * - 'force': 强制 9:16，所有视频统一转为竖屏
+   */
+  verticalMode: 'off' | 'standard' | 'force'
+
+  /** 视频编码格式
+   * - 'h264': 兼容性最好，支持几乎所有设备
+   * - 'h265': 压缩率更高，近几年设备支持良好（默认）
+   * - 'av1': 最新编码格式，压缩率最高，但编码较慢
+   */
+  videoCodec: 'h264' | 'h265' | 'av1'
+
+  /** 抖音推送相关配置 */
+  push: {
+    /** 推送开关，开启后需重启；使用「#设置抖音推送 + 抖音号」配置推送列表 */
+    switch: boolean
+    /** 谁可以设置推送，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启 */
+    permission: 'all' | 'admin' | 'master' | 'group.owner' | 'group.admin'
+    /** 推送表达式 */
+    cron: string
+    /** 推送时是否一同解析该作品 */
+    parsedynamic: boolean
+    /** 分享链接二维码的类型，web为跳转到抖音网页，download为视频下载直链 */
+    shareType: 'web' | 'download'
+    /** 推送解析时视频画质偏好设置，'adapt' 为自动根据「maxAutoVideoSize」大小选择，其他为固定画质 */
+    pushVideoQuality: 'adapt' | '540p' | '720p' | '1080p' | '2k' | '4k'
+    /** 推送解析时视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 'adapt' 时生效 */
+    pushMaxAutoVideoSize: number
+  }
+}

package/src/karin/types/config/index.ts

@@ -0,0 +1,41 @@
+import { amagiConfig } from './amagi'
+import { appConfig } from './app'
+import { bilibiliConfig } from './bilibili'
+import { cookiesConfig } from './cookies'
+import { douyinConfig } from './douyin'
+import { kuaishouConfig } from './kuaishou'
+import { pushlistConfig } from './pushlist'
+import { requestConfig } from './request'
+import { uploadConfig } from './upload'
+import { xiaohongshuConfig } from './xiaohongshu'
+
+/** 插件配置类型 */
+export interface ConfigType {
+  /** amagi 解析库配置 */
+  amagi: amagiConfig
+  /** 插件应用设置 */
+  app: appConfig
+  /** bilibili 相关设置 */
+  bilibili: bilibiliConfig
+  /** 抖音相关设置 */
+  douyin: douyinConfig
+  /** 快手相关设置 */
+  kuaishou: kuaishouConfig
+  /** 小红书相关设置 */
+  xiaohongshu: xiaohongshuConfig
+  /** 推送列表 */
+  pushlist: pushlistConfig
+}
+
+export type {
+  amagiConfig,
+  appConfig,
+  bilibiliConfig,
+  cookiesConfig,
+  douyinConfig,
+  kuaishouConfig,
+  pushlistConfig,
+  requestConfig,
+  uploadConfig,
+  xiaohongshuConfig
+}

package/src/karin/types/config/kuaishou.ts

@@ -0,0 +1,10 @@
+export interface kuaishouConfig {
+  /** 快手解析开关，单独开关，受「总开关」影响 */
+  switch: boolean
+
+  /** 快手评论解析，发送快手作品评论图 */
+  comment: boolean
+
+  /** 快手评论数量，范围1~30条 */
+  numcomment: number
+}

package/src/karin/types/config/pushlist.ts

@@ -0,0 +1,55 @@
+/** 推送内容类型 */
+export type DouyinPushType = 'post' | 'favorite' | 'recommend' | 'live'
+
+/** B站推送动态类型 */
+export type BilibiliPushType = 'video' | 'draw' | 'word' | 'live' | 'forward' | 'article'
+
+/** 定义推送列表项的接口 */
+export type douyinPushItem = {
+  /** 是否启用 */
+  switch: boolean
+  /** sec_uid，与short_id二选一 */
+  sec_uid: string
+  /** 抖音号，与sec_uid二选一 */
+  short_id: string
+  /** 推送群号和机器人账号，多个则使用逗号隔开，必填。如：群号1:机器人账号1 */
+  group_id: string[]
+  /** 博主或UP主的名字信息，可不填 */
+  remark: string
+  /** 推送类型：作品列表、喜欢列表、推荐列表、直播，默认为作品列表 */
+  pushTypes?: DouyinPushType[]
+  /** 黑名单：命中不推送；白名单：命中才推送 */
+  filterMode?: 'blacklist' | 'whitelist'
+  /** 指定关键词 */
+  Keywords?: string[]
+  /** 指定标签 */
+  Tags?: string[]
+}
+
+/** 定义推送列表项的接口 */
+export type bilibiliPushItem = {
+  /** 是否启用 */
+  switch: boolean
+  /** B站用户的UID，必填 */
+  host_mid: number
+  /** 推送群号和机器人账号，多个则使用逗号隔开，必填。如：群号1:机器人账号1 */
+  group_id: string[]
+  /** 博主或UP主的名字信息，可不填 */
+  remark: string
+  /** 推送类型：投稿视频、图文动态、纯文动态、直播动态、转发动态、投稿专栏，默认全部 */
+  pushTypes?: BilibiliPushType[]
+  /** 黑名单：命中不推送；白名单：命中才推送 */
+  filterMode?: 'blacklist' | 'whitelist'
+  /** 指定关键词 */
+  Keywords?: string[]
+  /** 指定标签 */
+  Tags?: string[]
+}
+
+/** 定义抖音和B站推送列表的接口 */
+export type pushlistConfig = {
+  /** 抖音推送列表的接口 */
+  douyin: douyinPushItem[]
+  /** B站推送列表的接口 */
+  bilibili: bilibiliPushItem[]
+}