nonebot-plugin-bili-helper 0.8.3

Nonebot2 plugin for bilibili sharing detail

nonebot-plugin-bili-helper

✨ NoneBot 插件简单描述 ✨

这是一个 nonebot2 插件项目，支持对群聊内分享 B 站视频进行相关信息的解析与提取。

评论模板来自: https://github.com/ikenxuan/kkkkkk-10086

折叠事项

1. 本插件并不提供视频下载能力（个人觉得群聊里出现大量下载的视频片段挺烦的，经常触发自动下载还占用手机和电脑的空间）。
2. 只适配和测试了 onebot v11 适配器的场景，其他环境未做处理，不确保可用性。

[!NOTE] 模板库中自带了一个发布工作流, 你可以使用此工作流自动发布你的插件到 pypi

配置发布工作流

1. 前往 https://pypi.org/manage/account/#api-tokens 并创建一个新的 API 令牌。创建成功后不要关闭页面，不然你将无法再次查看此令牌。
2. 在单独的浏览器选项卡或窗口中，打开 Actions secrets and variables 页面。你也可以在 Settings - Secrets and variables - Actions 中找到此页面。
3. 点击 New repository secret 按钮，创建一个名为 PYPI_API_TOKEN 的新令牌，并从第一步复制粘贴令牌。

[!IMPORTANT] 这个发布工作流需要 pyproject.toml 文件, 并且只支持 PEP 621 标准的 pyproject.toml 文件

触发发布工作流

从本地推送任意 tag 即可触发。

创建 tag:

git tag <tag_name>

推送本地所有 tag:

git push origin --tags

📖 介绍

这里是插件的详细介绍部分

💿 安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-bili-helper

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

pip install nonebot-plugin-bili-helper

pdm

pdm add nonebot-plugin-bili-helper

poetry

poetry add nonebot-plugin-bili-helper

conda

conda install nonebot-plugin-bili-helper

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

plugins = ["nonebot_plugin_template"]

⚙️ 配置

在 nonebot2 项目的.env文件中添加下表中的必填配置

配置项	必填	默认值	说明
analysis_whitelist	否	无	触发人白名单（留空时为所有人）
analysis_group_whitelist	否	无	目标群组白名单（留空时为所有群组）
analysis_blacklist	否	无	触发人黑名单
analysis_group_blacklist	否	无	目标群组黑名单
analysis_group_strategies	否	无	群组策略（格式为 dict[str, list]，其中 list 为 'detail', 'link', 'comments' 组成的数组。如配置 { "123": ["comments"] } 说明对群组 123 仅做评论解析）
bili_helper_tmp_dir	否	./tmp/bili_helper	临时文件保存位置
bili_helper_cookie_path	否	./data/bili_helper_cookie.json	Cookie保存位置

🎉 使用

指令表

指令	权限	需要@	范围	说明
设置B站Cookie	主人	否	私聊	设置请求时的Cookie（以便获得更详细的评论数据）