koishi-plugin-video-parser-all
项目介绍 (Project Introduction)
中文
这是一个为 Koishi 机器人框架开发的全平台视频/图集解析插件，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙等20+主流平台的短视频/图集/实况链接。核心特性：
统一API解析，覆盖20+热门平台，无需繁琐配置
自动识别链接来源，即丢即用
完全自定义的解析结果格式，支持多项变量替换，变量无值自动隐藏行
内置Debug调试模式，可详细记录所有操作与API交互日志
支持OneBot平台消息合并转发，优化多图文展示体验
所有提示文案均可自定义，适配多语言场景
消息发送支持自动重试，与API重试配置联动，增强稳定性
English
This is a multi-platform video/image parsing plugin developed for the Koishi bot framework, using a unified API interface to automatically recognize and parse short video/image/live photo links from 20+ mainstream platforms such as Douyin, Kuaishou, Bilibili, Xiaohongshu, Weibo, YouTube, TikTok, Jianying, AcFun, Zhihu, Huya and more. Core features:
- Unified API parsing, covering 20+ popular platforms without complex configuration
- Auto-detection of link sources, just drop & go
- Fully customizable parsing result format with variable substitutions, empty variables hide the line automatically
- Built-in Debug mode, recording detailed operations and API interaction logs
- Support OneBot message forwarding for better image/video display
- All prompt texts are customizable for multilingual scenarios
- Message sending supports automatic retries, linked with API retry configuration for improved stability
项目仓库 (Repository)
- GitHub:
https://github.com/Minecraft-1314/koishi-plugin-video-parser-all
- Issues:
https://github.com/Minecraft-1314/koishi-plugin-video-parser-all/issues
核心指令 (Core Commands)
| 指令 (Command) |
说明 (Description) |
示例 (Example) |
parse <url> |
手动解析指定的视频/图集链接 |
parse v douyin com/xxxx/ |
配置项说明 (Configuration)
基础设置
| 配置项 |
类型 |
默认值 |
说明 |
enable |
boolean |
true |
是否启用视频解析插件 |
botName |
string |
视频解析机器人 |
合并转发消息中显示的机器人名称 |
showWaitingTip |
boolean |
true |
解析时是否显示等待提示 |
debug |
boolean |
false |
是否开启 Debug 模式，在控制台输出详细日志 |
统一消息格式
| 配置项 |
类型 |
默认值 |
说明 |
unifiedMessageFormat |
string |
标题：${标题}\n作者：${作者}\n简介：${简介}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量} |
自定义解析结果的输出格式，支持变量替换。某行所有变量为空（或为"0"）时自动隐藏该行 |
内容显示设置
| 配置项 |
类型 |
默认值 |
说明 |
showImageText |
boolean |
true |
是否发送解析后的文字内容 |
showVideoFile |
boolean |
true |
是否发送视频文件（关闭则只发送视频链接） |
maxDescLength |
number |
200 |
简介内容最大长度（字符），超出自动截断 |
网络与 API 设置
| 配置项 |
类型 |
默认值 |
说明 |
timeout |
number |
180000 |
API 请求超时时间（毫秒） |
videoSendTimeout |
number |
60000 |
视频消息发送超时时间（毫秒，0 为不限制） |
userAgent |
string |
Chrome 124 UA |
API 请求使用的 User-Agent |
错误与重试设置
| 配置项 |
类型 |
默认值 |
说明 |
ignoreSendError |
boolean |
true |
是否忽略消息发送失败，避免插件崩溃 |
retryTimes |
number |
3 |
API 请求及消息发送失败时的重试次数 |
retryInterval |
number |
1000 |
API 请求及消息发送重试的间隔时间（毫秒） |
发送方式设置
| 配置项 |
类型 |
默认值 |
说明 |
enableForward |
boolean |
false |
是否启用合并转发（仅 OneBot 平台） |
界面文字设置
| 配置项 |
类型 |
默认值 |
说明 |
waitingTipText |
string |
正在解析视频，请稍候… |
解析等待提示文字 |
unsupportedPlatformText |
string |
不支持该平台链接 |
不支持的平台提示 |
invalidLinkText |
string |
无效的视频链接 |
无效链接提示（parse 指令） |
parseErrorPrefix |
string |
 解析失败： |
解析失败消息前缀 |
parseErrorItemFormat |
string |
【${url}】: ${msg} |
每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息） |
支持的变量 (Supported Variables)
在 unifiedMessageFormat 中可使用以下变量进行自定义格式化，某行所有变量均为空（或为"0"）时该行不显示：
| 变量名 |
说明 |
适用平台 |
${标题} |
视频/图集标题 |
所有平台 |
${作者} |
作者/发布者名称 |
所有平台 |
${简介} |
内容简介/描述 |
所有平台 |
${视频时长} |
视频时长（时:分:秒） |
视频 |
${点赞数} |
点赞数量 |
所有平台 |
${收藏数} |
收藏数量 |
所有平台 |
${转发数} |
转发/分享数量 |
所有平台 |
${播放数} |
播放量 |
部分平台 |
${评论数} |
评论数量 |
所有平台 |
${发布时间} |
发布时间（格式化） |
所有平台 |
${图片数量} |
图集/实况图片数量 |
图集/实况 |
${作者ID} |
作者唯一标识ID |
部分平台 |
${封面} |
封面图片地址 |
所有平台 |
注：部分变量可能因平台API返回数据不同而显示为空，某行所有变量为空（或为"0"）时该行会自动隐藏。
支持的平台 (Supported Platforms)
| 平台名称 |
关键词识别 |
解析能力 |
| 哔哩哔哩 (B站) |
bilibili, b23 tv, bilibili com |
视频（不含番剧/直播/图文） |
| 抖音 |
douyin, v douyin com |
短视频、图集、实况 |
| 快手 |
kuaishou, v kuaishou com |
短视频、图集 |
| 小红书 |
xiaohongshu, xhslink com |
图文、视频 |
| 微博 |
weibo, video weibo com |
视频、图集 |
| 剪映 / 即梦 |
jianying, jimeng jianying com |
视频模板 |
| 今日头条 / 西瓜视频 |
toutiao, ixigua com |
短视频 |
| AcFun (A站) |
acfun, acfun cn |
视频 |
| 知乎 |
zhihu, zhihu com |
视频、回答 |
| 微视 |
weishi, weishi qq com |
短视频 |
| 虎牙 |
huya, huya com |
直播、视频 |
| YouTube (油管) |
youtube, youtu be |
视频 |
| TikTok (国际版抖音) |
tiktok, tiktok com |
短视频 |
| 好看视频 |
haokan, haokan baidu com |
短视频 |
| 梨视频 |
video li |
短视频 |
| 美拍 |
meipai, meipai com |
短视频 |
| 全民直播 |
quanmin (quanmin tv) |
直播 |
| Twitter / X |
twitter, x com |
视频、图文 |
| Instagram |
instagram, instagram com |
图文、Reels |
| 豆包 |
doubao (doubao com) |
视频 |
| 皮皮搞笑 |
pipigx, h5 pipigx com |
短视频 |
| 皮皮虾 |
pipixia, h5 pipix com |
短视频 |
| 最右 |
zuiyou, xiaochuankeji cn |
短视频 |
注：部分平台解析能力可能因API限制有所差异，具体以实际解析结果为准。
项目贡献者 (Contributors)
| 贡献者 (Contributor) |
贡献内容 (Contribution) |
| Minecraft-1314 |
插件完整开发 (Complete plugin development) |
| JH-Ahua |
BugPk-Api 支持 |
| shangxue |
灵感来源 |
（欢迎通过 Issues 或 PR 加入贡献者列表）
许可协议 (License)
本项目采用 MIT 许可证，详情参见 LICENSE 文件。
This project is licensed under the MIT License, see the LICENSE file for details.
支持我们 (Support Us)
如果这个项目对您有帮助，欢迎点亮右上角的 Star 
支持我们，这将是对所有贡献者最大的鼓励！
If this project is helpful to you, please feel free to star it in the upper right corner to support us, which will be the greatest encouragement to all contributors!