[可选] 自定义 B 站下载 CDN 域名,设置后优先于地区配置

September 7, 2026 · View on GitHub

logo

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

Code style: djlint

Important

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

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

如果你需要不依赖 nonebot2 的插件,请切换到 standalone 分支

📖 支持的平台

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

💡 标识说明

  • ✅ 表示完整支持解析与富文本渲染
  • ❌ 表示插件尚未适配该模块
  • 🚫 表示该平台暂无此类内容形态 (如有遗漏或平台更新,欢迎提交 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系统代理进行网络请求

下面的内容可以粘贴到 .env.env.dev / .env.prod 等文件

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

# [可选] 允许的 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

# [可选] B 站下载 CDN 地区;仅支持内置线路 zh、en、ja、proxy(网宿全网多线)
plite_bili_cdn_region="zh"

# [可选] 自定义 B 站下载 CDN 域名,设置后优先于地区配置
# 留空则使用地区配置;只接受 bilivideo.com 域名,不要包含协议、端口或路径
plite_bili_cdn_domain=""

# [可选] 音频解析,是否需要上传群文件
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

# [可选] 是否在解析结果中添加`在线播放`链接(如果有)
plite_embed_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", "下载"]

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

# [可选] 最大评论数量
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"]

# [可选] 知乎 cookie, 需要具有登录态的cookie才能完整获取回答内容
# 必须包含 z_c0 项,建议包含 d_c0, _xsrf 项
plite_zhihu_ck="z_c0=xxxx"

# [可选] linuxdo cookie, 部分帖子需要登录或有一定的阅读等级才可以查看
plite_linuxdo_ck="xxxx"

🎉 使用

指令参数权限需要@范围说明
开启解析-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

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

🎉 致谢