nonebot-plugin-bililive 2.0.6__tar.gz → 2.0.7__tar.gz

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-bililive
-Version: 2.0.6
+Version: 2.0.7
 Summary: Push bilibili dynamics and live notifications to QQ with NoneBot2.
-Keywords: nonebot,nonebot2,nonebot-plugin,qqbot,bilibili
+Keywords: nonebot,nonebot2,nonebot-plugin,bilibili,onebot,onebot-v11
 Author-Email: SK-415 <2967923486@qq.com>
 License: AGPL-3.0-or-later
 Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: Robot Framework
-Classifier: Framework :: Robot Framework :: Library
+Classifier: Framework :: AsyncIO
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -22,6 +22,7 @@ Requires-Dist: click>=8.1.3
 Requires-Dist: httpx<1.0,>=0.28.1
 Requires-Dist: nonebot-adapter-onebot>=2.4.6
 Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
+Requires-Dist: nonebot-plugin-localstore>=0.7
 Requires-Dist: nonebot2[fastapi]>=2.5.0
 Requires-Dist: playwright>=1.58.0
 Requires-Dist: pydantic<3.0,>=2.12.5
@@ -58,6 +59,8 @@ _✨ 将 B 站 UP 主动态与直播推送到 QQ 的 NoneBot2 插件 ✨_
 
 BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直播与动态消息推送到 QQ 群或私聊场景。
 
+目前支持的适配器：OneBot V11。
+
 ### 特性
 
 - 支持按 UP 主维度分别开启或关闭动态、直播推送。
@@ -79,24 +82,28 @@ BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直
 
 <details>
 <summary>使用包管理器安装</summary>
-在 nonebot2 项目的插件目录下, 打开命令行, 进入虚拟环境, 输入相应的安装命令
+
+在 NoneBot2 项目虚拟环境中安装：
 
     pip install nonebot-plugin-bililive
 
 
-打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot.plugins]` 部分追加写入
+然后在 NoneBot2 项目根目录的 pyproject.toml 中加载插件：
 
-    nonebot-plugin-bililive = ["nonebot-plugin-bililive"]
+	[tool.nonebot]
+	plugins = ["nonebot_plugin_bililive"]
 
 </details>
 
+首次使用动态截图功能时，插件会自动检查并安装 Chromium；如果需要自定义数据目录，可通过 BILILIVE_DIR 覆盖默认存储位置。未配置时，插件会使用 nonebot-plugin-localstore 提供的插件数据目录。
+
 ## ⚙️ 配置
 
 在 NoneBot2 项目的 .env 文件中按需添加配置项：
 
 | 配置项 | 必填 | 默认值 | 说明 |
 |:-----:|:----:|:----:|:----|
-| BILILIVE_DIR | 否 | data | 数据目录 |
+| BILILIVE_DIR | 否 | 由 nonebot-plugin-localstore 自动分配 | 插件数据目录，包含数据库、浏览器数据与动态偏移缓存 |
 | BILILIVE_TO_ME | 否 | true | 是否需要 @机器人 或命令前缀触发 |
 | BILILIVE_PROXY | 否 | 无 | HTTP 代理地址，用于 B 站请求和 Playwright 下载 |
 | BILILIVE_INTERVAL | 否 | 10 | 默认轮询间隔，单位秒 |
@@ -136,7 +143,7 @@ BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直
 
 ### 效果图
 
-![demo](/docs/.vuepress/public/demo.png)
+![demo](./docs/.vuepress/public/demo.png)
 
 ## 开发
 

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/README.md

@@ -24,6 +24,8 @@ _✨ 将 B 站 UP 主动态与直播推送到 QQ 的 NoneBot2 插件 ✨_
 
 BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直播与动态消息推送到 QQ 群或私聊场景。
 
+目前支持的适配器：OneBot V11。
+
 ### 特性
 
 - 支持按 UP 主维度分别开启或关闭动态、直播推送。
@@ -45,24 +47,28 @@ BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直
 
 <details>
 <summary>使用包管理器安装</summary>
-在 nonebot2 项目的插件目录下, 打开命令行, 进入虚拟环境, 输入相应的安装命令
+
+在 NoneBot2 项目虚拟环境中安装：
 
     pip install nonebot-plugin-bililive
 
 
-打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot.plugins]` 部分追加写入
+然后在 NoneBot2 项目根目录的 pyproject.toml 中加载插件：
 
-    nonebot-plugin-bililive = ["nonebot-plugin-bililive"]
+	[tool.nonebot]
+	plugins = ["nonebot_plugin_bililive"]
 
 </details>
 
+首次使用动态截图功能时，插件会自动检查并安装 Chromium；如果需要自定义数据目录，可通过 BILILIVE_DIR 覆盖默认存储位置。未配置时，插件会使用 nonebot-plugin-localstore 提供的插件数据目录。
+
 ## ⚙️ 配置
 
 在 NoneBot2 项目的 .env 文件中按需添加配置项：
 
 | 配置项 | 必填 | 默认值 | 说明 |
 |:-----:|:----:|:----:|:----|
-| BILILIVE_DIR | 否 | data | 数据目录 |
+| BILILIVE_DIR | 否 | 由 nonebot-plugin-localstore 自动分配 | 插件数据目录，包含数据库、浏览器数据与动态偏移缓存 |
 | BILILIVE_TO_ME | 否 | true | 是否需要 @机器人 或命令前缀触发 |
 | BILILIVE_PROXY | 否 | 无 | HTTP 代理地址，用于 B 站请求和 Playwright 下载 |
 | BILILIVE_INTERVAL | 否 | 10 | 默认轮询间隔，单位秒 |
@@ -102,7 +108,7 @@ BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直
 
 ### 效果图
 
-![demo](/docs/.vuepress/public/demo.png)
+![demo](./docs/.vuepress/public/demo.png)
 
 ## 开发
 

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/bililive/__init__.py

@@ -22,7 +22,7 @@ from .version import VERSION, __version__  # noqa: F401
 __plugin_meta__ = PluginMetadata(
     name="BiliLive",
     description="将B站UP主的动态和直播信息推送至QQ",
-    usage="https://github.com/Akiyy-dev/nonebot-plugin-bililive#readme",
+    usage="发送“帮助”查看命令列表，发送“关注 UID”订阅 UP 主",
     homepage="https://github.com/Akiyy-dev/nonebot-plugin-bililive",
     type="application",
     config=Config,

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/bililive/cli/utils.py

@@ -10,7 +10,6 @@ env = {
     "ACCESS_TOKEN": "",
     "SUPERUSERS": [],
     "COMMAND_START": [""],
-    "BILILIVE_DIR": "./data/",
 }
 
 

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/bililive/utils/__init__.py

@@ -30,15 +30,22 @@ from nonebot.rule import Rule
 
 from ..config import plugin_config
 
+require("nonebot_plugin_localstore")
+import nonebot_plugin_localstore as store
 
-def get_path(*other):
-    """获取数据文件绝对路径"""
+PLUGIN_ENTRY_NAME = "nonebot_plugin_bililive"
+
+
+def get_data_dir() -> Path:
+    """获取插件数据目录。"""
     if plugin_config.bililive_dir:
-        dir_path = Path(plugin_config.bililive_dir).resolve()
-    else:
-        dir_path = Path.cwd().joinpath("data")
-        # dir_path = Path.cwd().joinpath('data', 'bililive')
-    return str(dir_path.joinpath(*other))
+        return Path(plugin_config.bililive_dir).resolve()
+    return store.get_data_dir(PLUGIN_ENTRY_NAME)
+
+
+def get_path(*other):
+    """获取插件数据文件绝对路径。"""
+    return str(get_data_dir().joinpath(*other))
 
 
 async def handle_uid(
@@ -290,9 +297,7 @@ def on_startup():
         check_proxy()
         install()
         asyncio.get_event_loop().run_until_complete(check_playwright_env())
-        # 创建数据存储目录
-        if not Path(get_path()).is_dir():
-            Path(get_path()).mkdir(parents=True)
+        get_data_dir().mkdir(parents=True, exist_ok=True)
 
 
 def on_command(cmd, *args, **kwargs):

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/bililive/version.py

@@ -1,4 +1,4 @@
 from packaging.version import Version
 
-__version__ = "2.0.6"
+__version__ = "2.0.7"
 VERSION = Version(__version__)

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/nonebot_plugin_bililive/__init__.py

@@ -10,7 +10,7 @@ if isinstance(globals()["__loader__"], PluginLoader):
 __plugin_meta__ = PluginMetadata(
     name="BiliLive",
     description="将 B 站 UP 主的动态和直播信息推送至 QQ",
-    usage="发送 帮助 查看命令列表",
+    usage="发送“帮助”查看命令列表，发送“关注 UID”订阅 UP 主",
     homepage="https://github.com/Akiyy-dev/nonebot-plugin-bililive",
     type="application",
     config=Config,

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/pyproject.toml

@@ -10,13 +10,14 @@ keywords = [
     "nonebot",
     "nonebot2",
     "nonebot-plugin",
-    "qqbot",
     "bilibili",
+    "onebot",
+    "onebot-v11",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
-    "Framework :: Robot Framework",
-    "Framework :: Robot Framework :: Library",
+    "Framework :: AsyncIO",
+    "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -28,6 +29,7 @@ dependencies = [
     "httpx>=0.28.1,<1.0",
     "nonebot-adapter-onebot>=2.4.6",
     "nonebot-plugin-apscheduler>=0.5.0",
+    "nonebot-plugin-localstore>=0.7",
     "nonebot2[fastapi]>=2.5.0",
     "playwright>=1.58.0",
     "pydantic>=2.12.5,<3.0",
@@ -38,7 +40,7 @@ dependencies = [
     "msvc-runtime>=14.34.31931; sys_platform == \"win32\"",
 ]
 dynamic = []
-version = "2.0.6"
+version = "2.0.7"
 
 [project.license]
 text = "AGPL-3.0-or-later"
@@ -50,7 +52,6 @@ Documentation = "https://github.com/Akiyy-dev/nonebot-plugin-bililive#readme"
 Issues = "https://github.com/Akiyy-dev/nonebot-plugin-bililive/issues"
 
 [project.entry-points."nonebot.plugin"]
-nonebot-plugin-bililive = "nonebot_plugin_bililive"
 nonebot_plugin_bililive = "nonebot_plugin_bililive"
 
 [project.scripts]

{nonebot_plugin_bililive-2.0.6 → nonebot_plugin_bililive-2.0.7}/tests/test_maintenance.py

@@ -20,6 +20,7 @@ class DummyDriver:
 
 
 fake_apscheduler = ModuleType("nonebot_plugin_apscheduler")
+fake_localstore = ModuleType("nonebot_plugin_localstore")
 
 
 class DummyScheduler:
@@ -36,9 +37,22 @@ class DummyScheduler:
 fake_apscheduler.scheduler = DummyScheduler()
 
 
+def _get_data_dir(plugin_name: str | None) -> Path:
+    return Path(tempfile.gettempdir()) / (plugin_name or "nonebot2")
+
+
+fake_localstore.get_data_dir = _get_data_dir
+
+
 with patch("nonebot.get_driver", return_value=DummyDriver()), patch(
     "nonebot.require", return_value=None
-), patch.dict(sys.modules, {"nonebot_plugin_apscheduler": fake_apscheduler}):
+), patch.dict(
+    sys.modules,
+    {
+        "nonebot_plugin_apscheduler": fake_apscheduler,
+        "nonebot_plugin_localstore": fake_localstore,
+    },
+):
     compat = import_module("bililive.compat")
     Config = import_module("bililive.config").Config
     core_version = import_module("bililive.version")
@@ -48,6 +62,7 @@ with patch("nonebot.get_driver", return_value=DummyDriver()), patch(
     DB = db_module.DB
     models = import_module("bililive.database.models")
     Group = models.Group
+    get_path = import_module("bililive.utils").get_path
 
 
 class ConfigTests(unittest.TestCase):
@@ -104,6 +119,11 @@ class PluginEntryTests(unittest.TestCase):
         self.assertEqual(plugin_entry.__plugin_meta__.config, Config)
         self.assertEqual(plugin_entry.__version__, core_version.__version__)
 
+    def test_default_data_dir_uses_localstore(self):
+        expected = _get_data_dir("nonebot_plugin_bililive") / "data.sqlite3"
+
+        self.assertEqual(Path(get_path("data.sqlite3")), expected)
+
 
 class WebDynamicTests(unittest.TestCase):
     def test_parse_web_dynamic_items_extracts_required_fields(self):