基于 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 直接安装
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 实现
License
本项目采用 GPL-3.0 开源，禁止商用。二次分发请注明出处。使用风险自担。
