[可选] 全局禁止的解析

July 24, 2026 · View on GitHub

logo

Nonebot2 链接分享自动解析插件 ✨

Code style: djlint

Important

严禁将本项目用于任何非法用途

由于使用不当造成的一切责任由使用者承担,本项目维护者无任何责任

📖 支持的平台

平台图文评论区渲染视频Live Photo
B 站
抖音(仅图文)
微博
小红书
快手🚫
AcFun🚫
X (Twitter)🚫
百度贴吧🚫
知乎🚫
堆糖🚫🚫
小黑盒🚫🚫
ILLU🚫🚫
LOFTER🚫🚫
网易 BUFF🚫🚫
酷安🚫🚫
虎扑🚫
米游社🚫
豆瓣🚫🚫
5EPlay🚫
豆包🚫🚫🚫
平台音频支持评论区渲染
网易云音乐
酷狗音乐
汽水音乐
酷我音乐

💡 标识说明

  • ✅ 表示完整支持解析与富文本渲染
  • ❌ 表示插件尚未适配该模块
  • 🚫 表示该平台暂无此类内容形态 (如有遗漏或平台更新,欢迎提交 Issue 告知)
  • 图文:指代一切以文本为主体、图片混排、多图相册、社区长文、问答、多媒体笔记等内容形态。

支持的链接,可参考 测试链接

💿 安装

src/nonebot_plugin_parser_lite文件夹复制到插件加载目录(比如plugins)

pip
pip install -r requirements.txt
uv
uv add --requirements requirements.txt

🎈 特性

  • 评论区渲染支持
  • 通用的基础模板,便于拓展自定义
  • 富文本内容渲染支持
渲染效果
哔哩哔哩小红书
142f794a8df94207bf742c75434c942b203b2500-2393-53c4-901c-77169489e4ee

⚙️ 配置

Note

插件会自动使用系统环境中的http系统代理进行网络请求

配置项
# [可选] nonebot2 内置配置,若服务器上传带宽太低或报错发送消息超时,建议调高,防止超时
API_TIMEOUT=100

# [可选] B 站 cookie, 必须含有 SESSDATA 项,可附加 B 站 AI 总结功能
# 获取方式(觉得麻烦可以看最下面的指令扫码登陆)
# B站网页打开开发者工具,切换到网络标签页,刷新后点击一个类型为`fetch`的网络请求复制请求头中 Cookie 的全部内容
# 若希望cookie会自动刷新,请进入控制台,输入 window.localStorage.ac_time_value 并执行即可获取其值。
# 然后按照如下格式填写,xxxx为你的 Cookie 内容, abc 为 ac_time_value 的值
plite_bili_ck="xxxxxxxxxx;ac_time_value=abc"

# [可选] 允许的 B 站视频编码,越靠前的编码优先级越高
# 可选 "avc"(H.264,体积较大), "hev"(HEVC), "av01"(AV1), "unknown"(未知)
# 后两项在不同设备可能有兼容性问题,如需完全避免,可只填一项,如 '["avc"]'
plite_bili_video_codes=["avc", "av01", "hev", "unknown"]

# [可选] B 站视频清晰度
# 360p(16), 480p(32), 720p(64), 1080p(80), 1080p+(112), 1080p_60(116), 4k(120)
plite_bili_video_quality=80

# [可选] 音频解析,是否需要上传群文件
plite_need_upload_audio=False

# [可选] 视频解析,是否需要上传群文件
plite_need_upload_video=False

# [可选] 视频,图片,音频是否使用 base64 发送
# 注意:编解码和传输 base64 会占用更多的内存,性能和带宽, 甚至可能会使 websocket 连接崩溃
# 因此该配置项仅推荐 nonebot 和 协议端不在同一机器的用户配置
plite_use_base64=False

# [可选] 视频最大解析时长,单位:秒
plite_duration_maximum=480

# [可选] 音视频下载最大文件大小,单位 MB,超过该配置将阻断下载
plite_max_size=90

# [可选] 全局禁止的解析
# 示例 plite_disabled_platforms=["bilibili", "douyin"] 表示禁止了哔哩哔哩和抖音
# 可选值: ["bilibili", "douyin", "kuaishou", "x", "acfun", "weibo", "rednote"]
plite_disabled_platforms=["x"]

# [可选] 黑名单用户列表
# 示例 plite_blacklist=["QQClient_123456"]
plite_blacklist_users=[]

# [可选] 是否在解析结果中附加原始URL
plite_append_url=False

# [可选] 是否在解析结果中添加原始URL二维码
plite_append_qrcode=False

# [可选] 是否需要转发媒体内容(超过 4 项时始终使用合并转发)
plite_need_forward_contents=True

# [可选] 是否开启懒下载模式,仅在用户请求时才下载视频
plite_lazy_download=False

# [可选] 懒下载是否发送命令提示
plite_lazy_download_tip=False

# [可选] 懒下载模式等待命令超时时间
plite_lazy_download_timeout=30

# [可选] 在懒下载模式中用户请求下载视频时的命令列表
plite_download_command=["xz", "下载"]

# [可选] 浏览器程序路径,如果无法识别浏览器请填写此配置
plite_browser_path=""

# [可选] 是否使用 ffmpeg 转码 Live Photo,若设备配置不佳,请禁用此功能
# 禁用后将分别发送 Live Photo 底图和动图部分
plite_live_photo=True

# [可选] 浏览器是否使用无头模式,无头模式有可能会被检测到
plite_headless=False

# [可选] 最大评论数量
plite_max_comments=5

# [可选] 纯文本文本长度阈值,超过此长度的文本将会强制转发
plite_forward_text_threshold=1000

# [可选] 最大下载重试次数
plite_max_retries=3

# [可选] 白天时间范围 [开始, 结束],格式 h:m;范围内为浅色主题,范围外为夜间模式
# 支持跨午夜范围,例如 ["22:30", "6:00"]
plite_day_range=["6:00", "19:00"]

🎉 使用

指令参数权限需要@范围说明
开启解析-SUPERUSER/OWNER/ADMIN群聊开启解析
关闭解析-SUPERUSER/OWNER/ADMIN群聊关闭解析
bmbv号或引用一个链接/卡片-群聊下载 B 站音频
blogin-SUPERUSER全部扫码获取 B 站凭证

🎨 构建模板样式

此处教程适用于已修改默认模板的用户

首次构建前安装 Tailwind CSS 开发依赖:

npm install

修改 src/nonebot_plugin_parser_lite/render/templates 下的 Jinja 模板后,重新生成静态样式表:

npm run build:css

脚本会自动输出样式文件到渲染目录

🎉 致谢