🔗 万能链接解析器
插件名称： 万能解析器
当前版本： v1.5.3
在聊天中自动识别并解析主流平台的链接、短链、卡片和部分内容编号。
普通用户通常不需要发送固定命令。把支持的平台链接或卡片发到群聊或私聊中，插件会自动识别并返回解析结果。
🚀 快速开始
发送普通链接
https://www.bilibili.com/video/BVxxxxxxxx
发送短链接
https://b23.tv/xxxxxx
发送内容编号
B 站支持直接发送：
BVxxxxxxxx
或：
av123456
插件识别成功后，可能返回：
- 视频；
- 图集；
- 音频；
- 媒体信息卡片；
- 多条内容合并后的转发消息。
实际发送形式由平台内容和管理员配置决定。
🌐 支持的平台
| 平台 | 可触发的消息形态 | 视频 | 图集 | 音频 |
|---|---|---|---|---|
| B 站 | av 号、BV 号、链接、短链、卡片、小程序 | ✅ | ✅ | ✅ |
| 抖音 | 分享链接、电脑端链接 | ✅ | ✅ | ❌ |
| 微博 | 博文、视频、show、文章链接 | ✅ | ✅ | ❌ |
| 小红书 | 普通链接、短链、卡片 | ✅ | ✅ | ❌ |
| 小黑盒 | 链接、卡片 | ✅ | ✅ | ❌ |
| 知乎 | 链接、卡片 | ✅ | ✅ | ❌ |
| 快手 | 标准链接、短链 | ✅ | ✅ | ❌ |
| AcFun | 链接 | ✅ | ❌ | ❌ |
| YouTube | 普通链接、短链 | ✅ | ❌ | ✅ |
| TikTok | 链接 | ✅ | ❌ | ❌ |
| 链接 | ✅ | ✅ | ❌ | |
| X / Twitter | 链接 | ✅ | ✅ | ❌ |
平台接口随时可能变化。表格表示仓库 README 当前列出的支持范围，实际可用性还取决于平台访问状态和管理员配置。
👤 普通用户如何使用？
直接发送链接
无需艾特 bot，也不需要额外添加“解析”二字。把链接直接发到聊天中即可。
分享平台卡片
部分平台支持从消息卡片或 JSON 小程序中提取链接，例如：
- B 站；
- 小红书；
- 小黑盒；
- 知乎。
发送给指定 bot
当群里存在多个机器人时，可以艾特当前 bot 后附带链接：
@bot https://www.bilibili.com/video/BVxxxxxxxx
但如果消息开头艾特的是其他机器人，当前 bot 会跳过解析。
🛠️ 管理员命令
| 命令 | 说明 |
|---|---|
@bot 开启解析 | 开启当前会话的链接解析功能 |
@bot 关闭解析 | 关闭当前会话的链接解析功能 |
@bot blogin | 扫码获取 B 站凭证 |
上述命令仅 AstrBot 管理员可用。
B 站扫码登录涉及账号凭证，应由管理员在安全环境中操作。
📦 解析结果可能包含什么？
插件会根据平台和内容类型获取媒体信息，然后构建消息：
| 类型 | 可能的返回内容 |
|---|---|
| 视频 | 视频文件或视频相关信息 |
| 图集 | 一张或多张图片 |
| 音频 | 音频文件或音频内容 |
| 媒体卡片 | 标题、作者、封面等统一样式的信息卡片 |
| 合并转发 | 内容过多时，自动合并为转发消息 |
插件默认支持通过 PIL 生成通用媒体卡片。是否使用简洁模式、是否下载媒体等，由管理员配置决定。
🔄 插件如何处理链接？
- 接收文字、链接或卡片消息。
- 跳过已经关闭解析的会话和空消息。
- 从文字或卡片中提取链接。
- 通过关键词和正则规则确定对应平台。
- 在多 bot 环境中进行解析仲裁。
- 对相同链接进行防重复判定。
- 获取内容信息并下载可用媒体。
- 按配置生成媒体卡片。
- 内容较多时合并为转发消息并发送。
🧯 防止重复解析
插件会对同一会话中的相同链接设置时间窗口限制。
短时间内重复发送同一个链接时，插件可能不会再次响应。这是为了避免：
- 同一个链接被反复下载；
- 群聊刷屏；
- 多次返回完全相同的内容。
🤖 多机器人群聊
在使用 aiocqhttp 的环境中，插件支持通过固定表情进行 bot 间仲裁。
当群里有多个安装了解析插件的 bot 时，系统会尝试只让其中一个 bot 执行解析，其他 bot 自动放弃，避免同一链接收到多份重复结果。
⚠️ 使用注意
- 链接必须是插件当前支持的平台格式。
- 第三方平台接口、地区限制、登录状态和反爬措施都可能导致解析失败。
- 视频或图片数量较多时，结果可能被合并为转发消息。
- 同一链接短时间重复发送，可能因防抖机制而不再次解析。
- 当前会话被管理员关闭解析后，普通用户发送链接不会触发。
- 如果消息开头艾特的是其他 bot，当前 bot 不会处理该消息。
- B 站部分内容可能需要管理员先通过
@bot blogin获取凭证。 - 解析得到的内容仍受原平台版权和访问权限限制。
❓ 常见问题
Q：为什么发送链接后 bot 没反应？
可能原因包括：
- 当前平台暂不支持；
- 当前会话已关闭解析；
- 短时间内重复发送了相同链接；
- 消息开头艾特的是其他 bot；
- 平台接口暂时异常；
- 内容需要登录或存在访问限制。
Q：为什么同一个链接刚才可以解析，现在没有反应？
插件有防重复机制。同一会话内的相同链接在时间窗口内可能会被跳过。
Q：为什么返回的是信息卡片，没有直接发视频？
管理员可能启用了媒体卡片或简洁模式，也可能是媒体下载失败或平台只返回了部分信息。
Q：为什么多台 bot 只有一台回复？
插件带有多 bot 仲裁机制，目的是避免多个机器人同时解析同一链接。
Q：B 站内容为什么提示需要登录？
部分内容需要有效的 B 站凭证。管理员可以使用：
@bot blogin
扫码获取凭证。
📎 项目信息
- 显示名称：万能解析器
- 当前版本：v1.5.3
- 作者：Zhalslar
- 开源协议：MIT
- 项目地址：https://github.com/Zhalslar/astrbot_plugin_parser
