README.md

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

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

核心能力

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

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

快速开始

1. 准备环境

• Karin >= 1.14.0
• Node.js >= 18
• FFmpeg 或 karin-plugin-ffmpeg

2. 安装插件

推荐在 Karin WebUI 插件市场搜索 karin-plugin-kkk 直接安装。手动管理依赖时可以执行：

pnpm add karin-plugin-kkk@latest -w

3. 配置并试跑

打开 Karin WebUI → 插件配置 → karin-plugin-kkk，优先配置抖音与 B站 Cookie。插件启动后发送受支持的分享链接即可自动解析，也可以引用消息后发送：

#解析
#kkk解析
#弹幕解析

常用命令

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

文档与社区

• 文档镜像 — KarinJS · QWQO · Vercel · Netlify
• 代码问答 — DeepWiki · Zread
• 交流反馈 — GitHub Issues · QQ 群 795874649

致谢

• KarinJS/Karin — 即时通讯应用机器人框架，本项目基于此开发
• ikenxuan/amagi — 本插件使用的平台接口 TypeScript 实现

License

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