指南

快速开始

安装并配置 koishi-plugin-kkk

安装流程

环境要求

  • Koishi >= 4.18.7
  • Node.js >= 18
  • FFmpeg(弹幕烧录、音轨合并;没有会自动降级)
  • Koishi 的 puppeteer 插件 —— 渲染卡片与长图,必需
  • assets 服务(如 @koishijs/plugin-assets-qqbot-file)—— QQ 面板里的图片要上传成 https 地址
  • QQ 平台需要官方机器人适配器

安装插件

推荐直接在 Koishi 控制台的「插件市场」里搜索 koishi-plugin-kkk 安装。

如果你是手动管理依赖,也可以执行:

pnpm add koishi-plugin-kkk

完成基础配置

装好启用后,浏览器打开 /kkk(插件自带的配置面板,默认免登录),或者从控制台左侧边栏点「kkk 配置」进入同一个页面。

先把 Cookie 配好就够了:

  • 抖音 Cookie
  • B站 Cookie
  • 如果你确实要用快手 / 小红书深度功能,也可以顺手补上对应 Cookie
其他配置都有默认值兜底,先不动也能直接用。真正影响首次使用体验的,主要就是 Cookie。

获取登录态

群聊或私聊中可直接使用:

抖音登录
B站登录

详细方法见 获取 Cookies。

第一次试跑

插件启动后会监听消息,命中以下内容时自动解析:

  • 抖音:支持 douyin.com 与 iesdouyin.com 及其子域名 (www, v, jx, m, jingxuan)
  • B站:支持 bilibili.com, b23.tv, t.bilibili.com, bili2233.cn,以及纯 BV号 (BV...) 和 av号 (av...)
  • 快手:支持 kuaishou.com, v.kuaishou.com,以及APP分享的文本格式(如 快手...快手)
  • 小红书:支持 xiaohongshu.com, xhslink.com, xhslink.cn

手动解析命令(Koishi 的指令前缀按你的配置来,默认直接写命令名):

解析
kkk解析
弹幕解析

其中 弹幕解析 需要引用一条抖音或 B 站消息使用,会强制走弹幕烧录流程。

抖音和 B站的高画质、扫码登录、推送等能力都依赖登录态。没配 Cookie 也能做基础解析,但完整体验会受限。

反馈渠道