🎬 视频解析助手

🔮 B站抖音解析的最优方案

🧾 简介

一款为 AstrBot 设计的视频平台分享链接解析插件，支持自动识别并解析 B站、抖音分享链接，智能处理视频与图片发送。

---

✨ 功能

• 多平台支持：支持 BiliBili (B站) 和 Douyin (抖音) 短链接的自动解析。
• 高性能下载：调用 yutto 命令行工具，实现高并发下载和自动 FFmpeg 合并。
• 清晰度智能降级：可根据设置的最大视频大小来动态调整解析长视频时使用的清晰度。
• 解析限制保护：支持会话白名单、群等级要求、短时间限频冷却与通过屏蔽关键词跳过指定消息解析。
• 表情回应：通过贴表情实时反馈解析状态，支持自定义开启/关闭表情互动。
• 便捷登录：支持通过指令发送登录二维码，可直接扫码登录 B站账号。
• 资源管理：异步清理超过设定阈值的临时文件，防止占用磁盘空间。

---

🎮 指令列表

• /bili_login - 触发 B站账号登录流程，接收二维码图片进行扫码登录
• /bili_check - 检查当前 B站 Cookie 是否有效

---

🚀 安装

1. 由于插件依赖于外部命令行工具，请确保您的 Docker 容器内已安装它们：

# 1. 进入容器终端
docker exec -it [你的容器ID或名称] /bin/bash

# 2. 安装 FFmpeg
apt-get update && apt-get install ffmpeg -y

# 3. 安装 ppix
pip install pipx

# 4. 添加路径
pipx ensurepath

# 5. 安装 yutto
pipx install yutto

2. 下载本仓库。
3. 将整个 astrbot_plugin_video_analysis 文件夹放入 astrbot 的 plugins 目录中。
4. 重启 AstrBot。

---

⚙️ 配置

首次加载后，请在 AstrBot 后台 -> 插件 页面找到本插件进行设置。所有配置项都有详细的说明和提示。

---

📅 更新日志

详见 CHANGELOG

---

🙏 参考与致谢

本项目在开发过程中，参考并得益于以下项目，特此感谢：

• 原始代码参考&抖音本地解析：视频解析插件
• B站解析核心：yutto
• 抖音解析服务：抖音/TikTok API

---

❤️ 支持

• AstrBot 帮助文档
• 如果您在使用中遇到问题，欢迎在本仓库提交 Issue。

---

如果本插件对你有帮助，欢迎点个 ⭐ Star 支持一下！