基于 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` 直接安装。手动管理依赖时可以执行： ```bash pnpm add koishi-plugin-kkk ``` ### 3. 配置并试跑打开浏览器访问 `/kkk`（插件自带的配置面板），或 Koishi 控制台 → 插件配置 → `kkk`，优先配置抖音与 B站 Cookie。插件启动后发送受支持的分享链接即可自动解析，也可以引用消息后发送： ```text 解析 kkk解析弹幕解析 ``` Koishi 的指令前缀按你的配置来，默认直接写命令名即可（上面这种写法）。QQ 上点面板按钮走的也是这些指令。 > [!TIP] > 其他配置都有默认值兜底。Cookie 主要影响高画质、扫码登录、动态推送与接口稳定性，基础解析可以先直接试跑。 ## 常用命令 - `kkk帮助` — 查看当前命令菜单。 - `抖音登录` / `B站登录` — 扫码获取并写入平台 Cookie。 - `设置抖音推送抖音号` — 订阅或取消订阅抖音创作者。 - `设置B站推送 UID` — 订阅或取消订阅 B站创作者。 - `kkk解析统计` — 查看当前群解析统计。 - `kkk全局解析统计` — 查看全局解析趋势，仅主人可用。 - `kkk版本` / `kkk更新日志` — 查看运行环境诊断卡片与本地更新日志。 ## 文档与社区 - **使用文档** — [kkk.tangbot.xyz](https://kkk.tangbot.xyz) - **交流反馈** — [GitHub Issues](https://github.com/maimai993/koishi-plugin-kkk/issues/new/choose) · [官方 QQ 群 1050229473](https://qm.qq.com/q/viymkIPvvq) ## 致谢 - [Koishi](https://koishi.chat) — 本项目基于此开发 - [ikenxuan/karin-plugin-kkk](https://github.com/ikenxuan/karin-plugin-kkk) — 本插件是它的 **Koishi 移植版**，业务逻辑与上游保持一致 - [ikenxuan/amagi](https://github.com/ikenxuan/amagi) — 本插件使用的平台接口 TypeScript 实现

## License 本项目采用 [GPL-3.0](./LICENSE) 开源，禁止商用。二次分发请注明出处。使用风险自担。