maimai993/koishi-plugin-kkk

基于 koishi 的多平台短视频、图文内容解析与动态推送插件。
自动识别分享链接，提取视频、图集、热评与动态内容，并渲染成适合群聊直接浏览的图片。

使用文档 ·
快速开始 ·
配置说明 ·
问题反馈

核心能力

分享链接、短链、BV / av 号与 App 分享文本 → 自动识别 → 媒体解析 → 卡片渲染或动态推送

- 多平台自动解析 — 识别抖音、B站、快手、小红书分享内容，无需手动复制资源地址。
- 视频与图文处理 — 提取视频、图集、作者与互动数据，并根据场景发送媒体或渲染卡片。
- 评论区渲染 — 展示热评、楼中楼、图片评论和评论二维码。
- 动态订阅推送 — 为抖音和 B站提供订阅、筛选、强制推送与统计能力。
- 增强媒体能力 — 支持弹幕烧录、Live Photo 兼容导出、视频压缩和临时预览。
- 30+ 卡片组件 — 覆盖视频详情、动态、评论、帮助、登录、统计与错误诊断，并适配深浅主题。

快速开始

1. 准备环境

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

2. 安装插件

推荐在 Koishi 控制台的插件市场搜索 koishi-plugin-kkk 直接安装。手动管理依赖时可以执行：

pnpm add koishi-plugin-kkk

3. 配置并试跑

打开浏览器访问 /kkk（插件自带的配置面板），或 Koishi 控制台 → 插件配置 → kkk，优先配置抖音与 B站 Cookie。插件启动后发送受支持的分享链接即可自动解析，也可以引用消息后发送：

解析
kkk解析
弹幕解析

Koishi 的指令前缀按你的配置来，默认直接写命令名即可（上面这种写法）。QQ 上点面板按钮走的也是这些指令。

[!TIP]
其他配置都有默认值兜底。Cookie 主要影响高画质、扫码登录、动态推送与接口稳定性，基础解析可以先直接试跑。

常用命令

- kkk帮助 — 查看当前命令菜单。
- 抖音登录 / B站登录 — 扫码获取并写入平台 Cookie。
- 设置抖音推送 抖音号 — 订阅或取消订阅抖音创作者。
- 设置B站推送 UID — 订阅或取消订阅B站创作者。
- kkk解析统计 — 查看当前群解析统计。
- kkk全局解析统计 — 查看全局解析趋势，仅主人可用。
- kkk版本 / kkk更新日志 — 查看运行环境诊断卡片与本地更新日志。

文档与社区

- 使用文档 — kkk.tangbot.xyz
- 交流反馈 — GitHub Issues · 官方 QQ 群 1050229473

致谢

- Koishi — 本项目基于此开发
- ikenxuan/karin-plugin-kkk — 本插件是它的 Koishi 移植版，业务逻辑与上游保持一致
- ikenxuan/amagi — 本插件使用的平台接口 TypeScript 实现

许可证

本项目采用 GPL-3.0 开源，禁止商用。二次分发请注明出处。使用风险自担。