nonebot-plugin-parsehub 1.0.0__tar.gz → 1.0.1__tar.gz

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-parsehub
-Version: 1.0.0
+Version: 1.0.1
 Summary: 基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体
 Keywords: nonebot,nonebot2,plugin,parsehub,parser,media,onebot
 Author: ByteColtX
@@ -16,6 +16,8 @@ Requires-Dist: httpx>=0.28.0,<1.0.0
 Requires-Dist: nonebot-adapter-onebot>=2.4.6,<3.0.0
 Requires-Dist: nonebot-plugin-localstore>=0.7.4,<1.0.0
 Requires-Dist: nonebot2>=2.5.0,<3.0.0
+Requires-Dist: numpy>=2.0.0,<3.0.0
+Requires-Dist: opencv-python-headless>=4.13.0.92
 Requires-Dist: parsehub>=2.3.10,<3.0.0
 Requires-Dist: pillow>=12.1.0,<13.0.0
 Requires-Dist: pydantic>=2.0.0,<3.0.0
@@ -45,7 +47,9 @@ Description-Content-Type: text/markdown
 
 基于 [ParseHub](https://github.com/z-mio/ParseHub) 的社交媒体链接解析插件：群里出现受支持的分享链接时自动解析，发回视频 / 图集 / 图文，并配一张 App Store「Today」风格的信息卡片。
 
-- **自动解析**：发链接或分享文案即可，也可用 `解析` 命令手动触发
+> 仅支持 **OneBot v11** 适配器（NapCat / SnowLuma / LuckyLilliaBot 等）。
+
+- **自动解析**：发链接或分享文案即可，也可用 `/解析` 命令手动触发
 - **按会话开关**：`解析开关` 控制某个群 / 私聊，超管和群管理可操作
 - **24 个平台**：Bilibili、抖音、小红书、微博、快手、知乎、贴吧、豆瓣、今日头条、微信公众号、微信视频号、酷安、皮皮虾、最右、小黑盒、Bangumi、X/Twitter、Instagram、YouTube、TikTok、Threads、Facebook、Snapchat、Medium
 - **卡片 + 媒体**：先发信息卡片，再发视频 / 图集；2 个以上媒体合并转发，单个作品最多 20 个
@@ -56,13 +60,9 @@ Description-Content-Type: text/markdown
 
 ## 🎨 效果图
 
-B 站视频卡片：
-
-<img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-bilibili.jpg" width="420" alt="B 站卡片">
-
-抖音图集卡片：
-
-<img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-douyin.jpg" width="420" alt="抖音卡片">
+| B 站视频卡片 | 抖音图集卡片 |
+| :---: | :---: |
+| <img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-bilibili.jpg" width="420" alt="B 站卡片"> | <img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-douyin.jpg" width="420" alt="抖音卡片"> |
 
 ## 💿 安装
 
@@ -76,7 +76,7 @@ nb plugin install nonebot-plugin-parsehub --upgrade
 
 使用 uv 安装
 
-在 nonebot2 项目的插件目录下, 打开命令行, 输入以下指令即可安装
+在 nonebot2 项目的根目录下, 打开命令行, 输入以下指令即可安装
 
 ```bash
 uv add nonebot-plugin-parsehub
@@ -127,7 +127,7 @@ plugins = ["nonebot_plugin_parsehub"]
 
 > 列表类配置必须是合法 JSON（如 `PARSEHUB_PROXY_PLATFORMS=["twitter", "youtube"]`）；
 > 数值项有下界校验（如 `PARSEHUB_TIMEOUT >= 5`），写 0 或负数会在启动时直接报错。
-> 哪些群 / 私聊解析由命令 `解析开关` 控制，没有对应的配置项。
+> 哪些群 / 私聊解析由命令 `/解析开关` 控制，没有对应的配置项。
 
 需要登录态的平台（X、Instagram、TikTok、豆瓣、微信视频号 等），cookie 优先从 ParseHub 自己的配置读取
 （`ph set cookie <平台>`），也可以用 `PARSEHUB_COOKIE` 兜底。
@@ -138,16 +138,18 @@ plugins = ["nonebot_plugin_parsehub"]
 
 | 指令 | 权限 | 需要@ | 范围 | 说明 |
 | :---  | :---: | :---: | :---: | :--- |
-| `解析 <链接或分享文案>`（别名 `ph`、`解析链接`） | 群员 | 否 | 群聊/私聊 | 手动解析，不做去重拦截 |
-| `解析平台` | 群员 | 否 | 群聊/私聊 | 列出支持的平台 |
-| `解析开关 [开\|关]`、`解析开`、`解析关` | 主人/群管 | 否 | 群聊/私聊 | 按会话开关解析（私聊仅主人） |
-| `解析状态` | 群员 | 否 | 群聊/私聊 | 查看当前会话的开关状态 |
+| `/解析 <链接或分享文案>`（别名 `/ph`、`/解析链接`） | 群员 | 否 | 群聊/私聊 | 手动解析，不做去重拦截 |
+| `/解析平台` | 群员 | 否 | 群聊/私聊 | 列出支持的平台 |
+| `/解析开关 [开\|关]`、`/解析开`、`/解析关` | 主人/群管 | 否 | 群聊/私聊 | 按会话开关解析（私聊仅主人） |
+| `/解析状态` | 群员 | 否 | 群聊/私聊 | 查看当前会话的开关状态 |
+
+> 命令按 NoneBot 的 `COMMAND_START` 匹配（默认只有 `/`）。想让无前缀写法也算命令，把 `COMMAND_START` 加上 `""`。
 
 ### 触发规则
 
 - 群里发链接或分享文案即自动解析，一条消息最多处理 **3 个**链接
-- `解析关` 后该会话不再自动解析；手动 `解析` 只对超管 / 群管理有效
-- 命令前缀支持空前缀与 `/`（`COMMAND_START` 需包含 `""`）
+- `/解析关` 后该会话不再自动解析；手动 `/解析` 只对超管 / 群管理有效
+- 不带前缀的「解析 <链接>」**不是**命令，会当作普通消息自动解析（带去重、不额外提示）
 
 ### 解析开关
 
@@ -162,7 +164,7 @@ plugins = ["nonebot_plugin_parsehub"]
 - **保留 24 小时**（命中续期），总量上限 1GB，超了按最久没用过的删
 - **不同写法归一**：`b23.tv/xxx` 与 `bilibili.com/video/BVxxx` 是同一个作品
 - 时间线：120 秒内同会话重复 → 静默；120 秒 ~ 24 小时 → 直接发缓存；超过 24 小时 → 重新解析
-- 手动 `解析 <链接>` 同样吃缓存（只是不做去重拦截）
+- 手动 `/解析 <链接>` 同样吃缓存（只是不做去重拦截）
 
 ### 说明
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/README.md

@@ -18,7 +18,9 @@
 
 基于 [ParseHub](https://github.com/z-mio/ParseHub) 的社交媒体链接解析插件：群里出现受支持的分享链接时自动解析，发回视频 / 图集 / 图文，并配一张 App Store「Today」风格的信息卡片。
 
-- **自动解析**：发链接或分享文案即可，也可用 `解析` 命令手动触发
+> 仅支持 **OneBot v11** 适配器（NapCat / SnowLuma / LuckyLilliaBot 等）。
+
+- **自动解析**：发链接或分享文案即可，也可用 `/解析` 命令手动触发
 - **按会话开关**：`解析开关` 控制某个群 / 私聊，超管和群管理可操作
 - **24 个平台**：Bilibili、抖音、小红书、微博、快手、知乎、贴吧、豆瓣、今日头条、微信公众号、微信视频号、酷安、皮皮虾、最右、小黑盒、Bangumi、X/Twitter、Instagram、YouTube、TikTok、Threads、Facebook、Snapchat、Medium
 - **卡片 + 媒体**：先发信息卡片，再发视频 / 图集；2 个以上媒体合并转发，单个作品最多 20 个
@@ -29,13 +31,9 @@
 
 ## 🎨 效果图
 
-B 站视频卡片：
-
-<img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-bilibili.jpg" width="420" alt="B 站卡片">
-
-抖音图集卡片：
-
-<img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-douyin.jpg" width="420" alt="抖音卡片">
+| B 站视频卡片 | 抖音图集卡片 |
+| :---: | :---: |
+| <img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-bilibili.jpg" width="420" alt="B 站卡片"> | <img src="https://raw.githubusercontent.com/ByteColtX/nonebot-plugin-parsehub/main/docs/card-douyin.jpg" width="420" alt="抖音卡片"> |
 
 ## 💿 安装
 
@@ -49,7 +47,7 @@ nb plugin install nonebot-plugin-parsehub --upgrade
 
 使用 uv 安装
 
-在 nonebot2 项目的插件目录下, 打开命令行, 输入以下指令即可安装
+在 nonebot2 项目的根目录下, 打开命令行, 输入以下指令即可安装
 
 ```bash
 uv add nonebot-plugin-parsehub
@@ -100,7 +98,7 @@ plugins = ["nonebot_plugin_parsehub"]
 
 > 列表类配置必须是合法 JSON（如 `PARSEHUB_PROXY_PLATFORMS=["twitter", "youtube"]`）；
 > 数值项有下界校验（如 `PARSEHUB_TIMEOUT >= 5`），写 0 或负数会在启动时直接报错。
-> 哪些群 / 私聊解析由命令 `解析开关` 控制，没有对应的配置项。
+> 哪些群 / 私聊解析由命令 `/解析开关` 控制，没有对应的配置项。
 
 需要登录态的平台（X、Instagram、TikTok、豆瓣、微信视频号 等），cookie 优先从 ParseHub 自己的配置读取
 （`ph set cookie <平台>`），也可以用 `PARSEHUB_COOKIE` 兜底。
@@ -111,16 +109,18 @@ plugins = ["nonebot_plugin_parsehub"]
 
 | 指令 | 权限 | 需要@ | 范围 | 说明 |
 | :---  | :---: | :---: | :---: | :--- |
-| `解析 <链接或分享文案>`（别名 `ph`、`解析链接`） | 群员 | 否 | 群聊/私聊 | 手动解析，不做去重拦截 |
-| `解析平台` | 群员 | 否 | 群聊/私聊 | 列出支持的平台 |
-| `解析开关 [开\|关]`、`解析开`、`解析关` | 主人/群管 | 否 | 群聊/私聊 | 按会话开关解析（私聊仅主人） |
-| `解析状态` | 群员 | 否 | 群聊/私聊 | 查看当前会话的开关状态 |
+| `/解析 <链接或分享文案>`（别名 `/ph`、`/解析链接`） | 群员 | 否 | 群聊/私聊 | 手动解析，不做去重拦截 |
+| `/解析平台` | 群员 | 否 | 群聊/私聊 | 列出支持的平台 |
+| `/解析开关 [开\|关]`、`/解析开`、`/解析关` | 主人/群管 | 否 | 群聊/私聊 | 按会话开关解析（私聊仅主人） |
+| `/解析状态` | 群员 | 否 | 群聊/私聊 | 查看当前会话的开关状态 |
+
+> 命令按 NoneBot 的 `COMMAND_START` 匹配（默认只有 `/`）。想让无前缀写法也算命令，把 `COMMAND_START` 加上 `""`。
 
 ### 触发规则
 
 - 群里发链接或分享文案即自动解析，一条消息最多处理 **3 个**链接
-- `解析关` 后该会话不再自动解析；手动 `解析` 只对超管 / 群管理有效
-- 命令前缀支持空前缀与 `/`（`COMMAND_START` 需包含 `""`）
+- `/解析关` 后该会话不再自动解析；手动 `/解析` 只对超管 / 群管理有效
+- 不带前缀的「解析 <链接>」**不是**命令，会当作普通消息自动解析（带去重、不额外提示）
 
 ### 解析开关
 
@@ -135,7 +135,7 @@ plugins = ["nonebot_plugin_parsehub"]
 - **保留 24 小时**（命中续期），总量上限 1GB，超了按最久没用过的删
 - **不同写法归一**：`b23.tv/xxx` 与 `bilibili.com/video/BVxxx` 是同一个作品
 - 时间线：120 秒内同会话重复 → 静默；120 秒 ~ 24 小时 → 直接发缓存；超过 24 小时 → 重新解析
-- 手动 `解析 <链接>` 同样吃缓存（只是不做去重拦截）
+- 手动 `/解析 <链接>` 同样吃缓存（只是不做去重拦截）
 
 ### 说明
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parsehub"
-version = "1.0.0"
+version = "1.0.1"
 description = "基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -27,6 +27,8 @@ dependencies = [
     "nonebot-adapter-onebot>=2.4.6,<3.0.0",
     "nonebot-plugin-localstore>=0.7.4,<1.0.0",
     "nonebot2>=2.5.0,<3.0.0",
+    "numpy>=2.0.0,<3.0.0",
+    "opencv-python-headless>=4.13.0.92",
     "parsehub>=2.3.10,<3.0.0",
     "pillow>=12.1.0,<13.0.0",
     "pydantic>=2.0.0,<3.0.0",
@@ -57,7 +59,7 @@ test = [
 ]
 
 [build-system]
-requires = ["uv_build>=0.10.0"]
+requires = ["uv_build>=0.10.0,<0.14"]
 build-backend = "uv_build"
 
 [tool.nonebot]

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parsehub"
-version = "1.0.0"
+version = "1.0.1"
 description = "基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -20,6 +20,9 @@ dependencies = [
   "nonebot-adapter-onebot>=2.4.6,<3.0.0",
   "nonebot-plugin-localstore>=0.7.4,<1.0.0",
   "nonebot2>=2.5.0,<3.0.0",
+  # 卡片渐变遮罩与视频抽帧是代码里直接 import 的，必须显式声明
+  "numpy>=2.0.0,<3.0.0",
+  "opencv-python-headless>=4.13.0.92",
   "parsehub>=2.3.10,<3.0.0",
   "pillow>=12.1.0,<13.0.0",
   "pydantic>=2.0.0,<3.0.0",
@@ -46,7 +49,7 @@ test = [
 ]
 
 [build-system]
-requires = ["uv_build>=0.10.0"]
+requires = ["uv_build>=0.10.0,<0.14"]
 build-backend = "uv_build"
 
 [tool.nonebot]

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/SPEC.md

@@ -16,10 +16,13 @@ tags: [nonebot, parsehub, module]
 
 ## Boundary
 
-- **允许依赖**：nonebot2、onebot v11 适配器、parsehub、Pillow、httpx、localstore。
+- **允许依赖**：nonebot2、onebot v11 适配器、parsehub、Pillow、httpx、localstore、
+  numpy、opencv-python-headless（后两者只在 `card` 里用）。
 - **禁止**：`triggers` 之外的模块 import matcher / `on_command`；`delivery` 之外的模块
-  调用 `sender.send`；`service` import `Bot`；`card`、`cache`、`dedupe`、`relay`、
-  `keys`、`platforms`、`budget`、`media` import nonebot（`card` 只允许 Pillow/httpx）。
+  调用 `sender.send`；`service` import `Bot`。
+- **日志**：一律用 `nonebot.logger`（官方指导），领域模块也不例外；除 logger 之外，
+  `cache`、`dedupe`、`relay`、`keys`、`platforms`、`budget`、`media`、`card` 不碰
+  nonebot 的 matcher / `Bot` / 事件类型。
 - 包内一律相对 import：插件既可能作为已安装包加载，也可能作为本地插件加载。
 
 ## Module map
@@ -63,6 +66,15 @@ tags: [nonebot, parsehub, module]
 - 平台白名单在 `Settings` 里归一成 id 集合，运行期只做集合查找。
 - 配置键是唯一入口：`Config` 只负责读取与校验，运行期一律用 `Settings`，
   不再散读 `plugin_config`。
+- 命令严格按 `COMMAND_START` 匹配：`should_auto` 不排除命令文本，靠命令匹配器的
+  `priority=10` + `block=True` 先收口。裸写的「解析 <链接>」不是命令，按普通消息
+  自动解析——默认前缀只有 `/`，若自动规则也跳过它，消息会被静默丢弃。
+- `paths` 把 localstore 当硬依赖（`require` 后 import），不保留临时目录兜底。
+- 日志统一用 `nonebot.logger`：框架的 loguru 已经管住格式、插件标签与 `LOG_LEVEL`，
+  在包内再桥接一层 stdlib logging 只是多一个可能失效的中间层。
+- 第三方依赖全是**硬依赖**：parsehub / Pillow / numpy / opencv / localstore 缺了就是
+  装错了，代码里不写 `except ImportError` 兜底，也不往别的目录写；降级只发生在产品层
+  （卡片→文字、字体→系统字体、体积探测→未知）。
 
 ## Known limitations
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/__init__.py

@@ -24,7 +24,7 @@ from __future__ import annotations
 from nonebot import get_driver
 from nonebot.plugin import PluginMetadata
 
-from . import feedback, triggers
+from . import triggers
 from .app import App
 from .config import Config, Settings, plugin_config
 
@@ -35,8 +35,8 @@ __plugin_meta__ = PluginMetadata(
         "（视频 / 图集 / 正文）。"
     ),
     usage=(
-        "发链接即可自动解析；命令：解析 <链接或分享文案>、解析平台、"
-        "解析开关 [开|关]（超管 / 群管理）、解析状态"
+        "发链接即可自动解析；命令：/解析 <链接或分享文案>、/解析平台、"
+        "/解析开关 [开|关]（超管 / 群管理）、/解析状态"
     ),
     type="application",
     homepage="https://github.com/ByteColtX/nonebot-plugin-parsehub",
@@ -45,16 +45,11 @@ __plugin_meta__ = PluginMetadata(
     extra={"parsehub": "https://github.com/z-mio/ParseHub"},
 )
 
-# 表情 ID：收到 / 成功 / 失败。
-REACT_START = feedback.Reaction.START
-REACT_OK = feedback.Reaction.OK
-REACT_FAIL = feedback.Reaction.FAIL
-
 # 进程内唯一的插件实例；测试可以自己 App.build() 一个。
 APP = App.build(Settings.from_config(plugin_config))
 
-# matcher 注册（处理函数闭包捕获 APP）。
-MATCHERS = triggers.create_matchers(APP)
+# matcher 注册（处理函数闭包捕获 APP）；注册本身有副作用，不需要保留返回值。
+triggers.create_matchers(APP)
 
 driver = get_driver()
 driver.on_startup(APP.startup)

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/budget.py

@@ -52,17 +52,6 @@ class Budget:
         """
         return self.remaining <= 0
 
-    def slice(self, cap: float) -> float:
-        """取一段不超过剩余预算的超时时间。
-
-        Args:
-            cap: 这一段最多允许多久（秒）。
-
-        Returns:
-            实际可用的秒数，至少 :data:`_MIN_SLICE_SECONDS`。
-        """
-        return max(_MIN_SLICE_SECONDS, min(cap, self.remaining))
-
     def timeout(self) -> AbstractAsyncContextManager[None]:
         """套在某一段异步调用外面的超时上下文。
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/cache.py

@@ -20,14 +20,13 @@
 
 所有方法都是同步的（磁盘 IO），调用方负责放进线程池。
 
-模块不依赖 nonebot，方便单独测试。
+除 ``nonebot.logger`` 外不依赖 nonebot，方便单独测试。
 """
 
 from __future__ import annotations
 
 import hashlib
 import json
-import logging
 import os
 import shutil
 import time
@@ -36,7 +35,7 @@ from collections.abc import Iterable
 from dataclasses import dataclass
 from pathlib import Path
 
-logger = logging.getLogger("nonebot_plugin_parsehub.cache")
+from nonebot import logger
 
 # 目录与文件名。
 FILES_DIR_NAME = "files"
@@ -183,20 +182,6 @@ class MediaCache:
             keys=tuple(meta.get("keys") or ()),
         )
 
-    def entry_keys(self, entry: Path) -> list[str]:
-        """条目对应的所有作品 key。
-
-        Args:
-            entry: 条目目录。
-
-        Returns:
-            作品 key 列表；读不出来时为空列表。
-        """
-        meta = self._read_meta(entry)
-        if meta is None:
-            return []
-        return [str(key) for key in meta.get("keys") or () if key]
-
     def remember_key(self, entry: Path, key: str) -> None:
         """把 key 补记到条目里（老条目命中时顺手补上）。
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/card/SPEC.md

@@ -16,7 +16,8 @@ tags: [nonebot, parsehub, card]
 
 ## Boundary
 
-- 只依赖 Pillow、httpx 与包内的 `platforms`；**不 import nonebot**。
+- 只依赖 Pillow、httpx、numpy（渐变遮罩）、`nonebot.logger` 与包内的 `platforms`；
+  视频抽帧另用 opencv（缺了就跳过这一级兜底）。不碰 matcher / `Bot` / 事件类型。
 - 所有渲染是同步阻塞的 CPU 活，调用方必须放进线程池（`CardRenderer` 负责）。
 
 ## Layout

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/card/__init__.py

@@ -16,11 +16,12 @@
 from __future__ import annotations
 
 import asyncio
-import logging
 from collections.abc import Callable
 from pathlib import Path
 from typing import Any
 
+from nonebot import logger
+
 from ..platforms import PLATFORMS
 from . import cover, fonts, layout
 from .cover import fetch_cover
@@ -96,8 +97,6 @@ __all__ = [
     "wrap",
 ]
 
-logger = logging.getLogger("nonebot_plugin_parsehub.card")
-
 
 class CardRenderer:
     """把解析结果渲染成卡片图。

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/card/cover.py

@@ -9,16 +9,14 @@
 from __future__ import annotations
 
 import io
-import logging
 from pathlib import Path
 from typing import Any
 
 import httpx
+from nonebot import logger
 
 from .fonts import _pil
 
-logger = logging.getLogger("nonebot_plugin_parsehub.card.cover")
-
 
 def _is_placeholder(data: bytes, image: Any) -> bool:  # noqa: ANN401 - PIL Image
     """判断封面是不是纯色占位图。
@@ -39,19 +37,18 @@ def _is_placeholder(data: bytes, image: Any) -> bool:  # noqa: ANN401 - PIL Imag
 def _frame_from_video(path: Path) -> bytes | None:
     """从本地视频里抽第一帧当封面。
 
+    同步阻塞，调用方必须放进线程池。opencv 首次 import 要几百毫秒，所以延迟到
+    函数里加载。
+
     Args:
         path: 本地视频路径。
 
     Returns:
         JPEG 字节；抽不出来时为 ``None``。
     """
-    try:
-        import cv2
-
-        Image = _pil()  # noqa: N806 - 与 PIL 模块名保持一致
-    except ImportError:
-        return None
+    import cv2
 
+    Image = _pil()  # noqa: N806 - 与 PIL 模块名保持一致
     cap = cv2.VideoCapture(str(path))
     try:
         ok, frame = cap.read()

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/card/fonts.py

@@ -12,15 +12,13 @@
 from __future__ import annotations
 
 import hashlib
-import logging
 from dataclasses import dataclass
 from functools import lru_cache
 from pathlib import Path
 from typing import Any
 
 import httpx
-
-logger = logging.getLogger("nonebot_plugin_parsehub.card.fonts")
+from nonebot import logger
 
 _EMOJI_FONT: Path | None = None
 _GLYPH_CACHE: dict[tuple[int, str], bool] = {}
@@ -71,8 +69,6 @@ FONT_SOURCES: tuple[FontSource, ...] = (
         HARMONY_REGULAR_SHA256,
     ),
 )
-FONT_URLS: tuple[str, ...] = tuple(source.url for source in FONT_SOURCES)
-
 # 系统里可能已经有这些中文字体，有就直接用，不必下载。
 SYSTEM_FONTS: tuple[str, ...] = (
     "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
@@ -249,9 +245,6 @@ EMOJI_FONT_SOURCES: tuple[FontSource, ...] = (
     # release 资产只有这一个正式地址（jsdelivr 只镜像仓库文件，镜像不了
     # release），所以只有一条源；下不到时按既有逻辑退回「没有 emoji 字体」
 )
-EMOJI_FONT_URLS: tuple[str, ...] = tuple(
-    source.url for source in EMOJI_FONT_SOURCES
-)
 EMOJI_FONT_NAME = "Twemoji-15.0.2.ttf"
 
 
@@ -301,7 +294,7 @@ def ensure_emoji_font(cache_dir: Path, url: str = "") -> Path | None:
 
     Args:
         cache_dir: 插件缓存目录，下载的字体放在这里。
-        url: 自定义字体地址，留空则依次尝试 :data:`EMOJI_FONT_URLS`。
+        url: 自定义字体地址，留空则依次尝试 :data:`EMOJI_FONT_SOURCES`。
 
     Returns:
         字体文件路径；不可用时为 ``None``。
@@ -494,7 +487,7 @@ def ensure_font(cache_dir: Path, url: str = "") -> Path | None:
 
     Args:
         cache_dir: 插件缓存目录，下载的字体放在这里。
-        url: 自定义字体地址，留空则依次尝试 :data:`FONT_URLS`。
+        url: 自定义字体地址，留空则依次尝试 :data:`FONT_SOURCES`。
 
     Returns:
         字体文件路径；不可用时为 ``None``。

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/card/layout.py

@@ -157,21 +157,6 @@ def _advance(text: str, font: Any, emoji_size: int = 0) -> float:  # noqa: ANN40
     return total
 
 
-def _can_draw_emoji(font: Any, text: str) -> bool:  # noqa: ANN401 - PIL FreeTypeFont
-    """查 emoji 字体里有没有这段文字的字形。
-
-    等价于 :func:`_has_glyph`，保留这个名字是因为 emoji 那条路径一直在用它。
-
-    Args:
-        font: emoji 字体对象。
-        text: 待画片段。
-
-    Returns:
-        有字形为 ``True``。
-    """
-    return _has_glyph(font, text)
-
-
 def _strip_variation(text: str) -> str:
     """去掉变体选择符（U+FE0E / U+FE0F）。
 

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/dedupe.py

@@ -58,32 +58,6 @@ class Dedupe:
         last_seen = self._seen.get((session, key))
         return last_seen is not None and time.time() - last_seen < window
 
-    # ---- 旧式「看到即记」（手动路径之外的兼容入口）----
-
-    def mark(self, session: str, key: str) -> None:
-        """记下这个会话里该 key 刚被处理过。
-
-        Args:
-            session: 会话标识。
-            key: 作品 key。
-        """
-        self._seen[(session, key)] = time.time()
-
-    def should_skip(self, session: str, key: str, window: int) -> bool:
-        """查一下并顺手记上（「处理过了」的语义）。
-
-        Args:
-            session: 会话标识。
-            key: 作品 key。
-            window: 去重窗口（秒）。
-
-        Returns:
-            窗口内重复出现返回 True。
-        """
-        repeated = self.seen(session, key, window)
-        self.mark(session, key)
-        return repeated
-
     # ---- claim / commit / release ----
 
     def claim(self, session: str, keys: Iterable[str], window: int) -> bool:

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/delivery.py

@@ -334,18 +334,7 @@ class Delivery:
             本次投递的结果。
         """
         report = MediaReport()
-        limit = self.settings.max_file_bytes
-        items: list[MediaFile] = []
-        for file in files:
-            try:
-                size = file.path.stat().st_size
-            except OSError:
-                report.skipped.append(file)
-                continue
-            if limit and size > limit:
-                report.skipped.append(file)
-                continue
-            items.append(file)
+        items = await asyncio.to_thread(self._filter_by_size, files, report)
 
         if report.skipped:
             # 聚合成一条：多图集里每个超限文件各发一条会把群刷屏。
@@ -373,6 +362,36 @@ class Delivery:
                     await self.send_text(sender, event, self._fail_text(file))
         return report
 
+    def _filter_by_size(
+        self,
+        files: list[MediaFile],
+        report: MediaReport,
+    ) -> list[MediaFile]:
+        """按体积上限过滤，顺手把跳过的记进 ``report``。
+
+        ``stat`` 是磁盘 IO，调用方必须放进线程池。
+
+        Args:
+            files: 待发送的本地媒体。
+            report: 本次投递的结果，``skipped`` 会被就地追加。
+
+        Returns:
+            体积允许发送的媒体。
+        """
+        limit = self.settings.max_file_bytes
+        items: list[MediaFile] = []
+        for file in files:
+            try:
+                size = file.path.stat().st_size
+            except OSError:
+                report.skipped.append(file)
+                continue
+            if limit and size > limit:
+                report.skipped.append(file)
+                continue
+            items.append(file)
+        return items
+
     async def _send_one(
         self,
         sender: Sender,
@@ -462,6 +481,8 @@ class Delivery:
             合并转发成功返回 True；媒体类型不适合转发时返回 False，由调用方改走
             逐条发送。
         """
+        # 昵称要从 .env 里读，是同步磁盘 IO：只算一次，放线程里，别卡事件循环
+        name = await asyncio.to_thread(forward_node_name)
         nodes: list[dict] = []
         for file in files:
             if file.kind is MediaKind.FILE:
@@ -472,7 +493,7 @@ class Delivery:
                     "type": "node",
                     "data": {
                         "uin": str(sender.self_id),
-                        "name": forward_node_name(),
+                        "name": name,
                         "content": [
                             {
                                 "type": str(file.kind),

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/errors.py

@@ -7,14 +7,16 @@ ParseHub 的异常类型很多，而且 import 代价高（会拉起 numpy / ope
 **边界**把异常翻译成 :class:`ParseFailure` + :class:`ErrorKind`，上层只按 kind
 分支，不再靠字符串猜「是不是作品被删了」。
 
-``translate`` 首次调用时才 import ``parsehub.errors``，之后复用类对象；拿不到
-时退回按类名判断。
+``translate`` 首次调用时才 import ``parsehub.errors``，之后复用类对象；异常被
+包装过时再退回类名 / 文案判断。
 """
 
 from __future__ import annotations
 
 from enum import StrEnum
 
+import httpx
+
 # 错误提示最长留多少个字（QQ 气泡里一行放不下更长的）。
 MAX_ERROR_CHARS = 80
 
@@ -109,29 +111,28 @@ def truncate_error(text: str) -> str:
     return text[: MAX_ERROR_CHARS - 1] + "…"
 
 
-# parsehub 的异常类，首次 translate 时加载；空元组表示拿不到。
+# parsehub 的异常类，首次用到时加载并缓存。
 _PARSEHUB_ERRORS: dict[str, type[BaseException]] | None = None
 
 
 def _parsehub_errors() -> dict[str, type[BaseException]]:
     """加载并缓存 parsehub 的异常类。
 
+    parsehub 的 import 很贵（会拉起 numpy / opencv），所以第一次用到才 import。
+
     Returns:
-        类名到类对象的映射；parsehub 不可用时为空字典。
+        类名到类对象的映射。
     """
     global _PARSEHUB_ERRORS  # noqa: PLW0603 - 单例式缓存
     if _PARSEHUB_ERRORS is None:
-        try:
-            from parsehub import errors as module
-        except ImportError:
-            _PARSEHUB_ERRORS = {}
-        else:
-            _PARSEHUB_ERRORS = {
-                name: value
-                for name in dir(module)
-                if isinstance(value := getattr(module, name), type)
-                and issubclass(value, BaseException)
-            }
+        from parsehub import errors as module
+
+        _PARSEHUB_ERRORS = {
+            name: value
+            for name in dir(module)
+            if isinstance(value := getattr(module, name), type)
+            and issubclass(value, BaseException)
+        }
     return _PARSEHUB_ERRORS
 
 
@@ -145,16 +146,15 @@ def _classify(exc: BaseException) -> ErrorKind:
         失败性质。
     """
     classes = _parsehub_errors()
-    if classes:
-        if isinstance(exc, classes.get("UnknownPlatform", ())):
-            return ErrorKind.UNSUPPORTED
-        if isinstance(exc, classes.get("ContentUnavailableError", ())):
-            return ErrorKind.UNAVAILABLE
-        if isinstance(exc, classes.get("DownloadError", ())):
-            return ErrorKind.NETWORK
-        if isinstance(exc, classes.get("ParseError", ())):
-            return ErrorKind.PARSE
-    # parsehub 不可用时（或异常被包装过）退回类名 / 文案判断。
+    if isinstance(exc, classes.get("UnknownPlatform", ())):
+        return ErrorKind.UNSUPPORTED
+    if isinstance(exc, classes.get("ContentUnavailableError", ())):
+        return ErrorKind.UNAVAILABLE
+    if isinstance(exc, classes.get("DownloadError", ())):
+        return ErrorKind.NETWORK
+    if isinstance(exc, classes.get("ParseError", ())):
+        return ErrorKind.PARSE
+    # 异常被包装过时退回类名 / 文案判断。
     name = type(exc).__name__
     if "UnknownPlatform" in name:
         return ErrorKind.UNSUPPORTED
@@ -182,24 +182,6 @@ def translate(exc: BaseException) -> ParseFailure:
     kind = _classify(exc)
     if isinstance(exc, TimeoutError):
         kind = ErrorKind.TIMEOUT
-    elif kind is ErrorKind.UNKNOWN:
-        try:
-            import httpx
-        except ImportError:  # pragma: no cover - httpx 是硬依赖
-            pass
-        else:
-            if isinstance(exc, httpx.HTTPError):
-                kind = ErrorKind.NETWORK
+    elif kind is ErrorKind.UNKNOWN and isinstance(exc, httpx.HTTPError):
+        kind = ErrorKind.NETWORK
     return ParseFailure(kind, short_error(exc), exc)
-
-
-def is_unavailable(exc: BaseException) -> bool:
-    """这个失败是不是「作品已不可用（被删 / 下架）」。
-
-    Args:
-        exc: 捕获到的异常。
-
-    Returns:
-        作品不可用时返回 True。
-    """
-    return translate(exc).kind is ErrorKind.UNAVAILABLE

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/parsehub_client.py

@@ -58,7 +58,7 @@ def _read_cookie_file(platform: str) -> str:
             return ""
         with path.open("rb") as file:
             data = tomllib.load(file)
-    except (ImportError, OSError, ValueError):
+    except (OSError, ValueError):
         return ""
     value = (data.get("cookie") or {}).get(platform)
     return str(value) if value else ""

nonebot_plugin_parsehub-1.0.1/src/nonebot_plugin_parsehub/paths.py

@@ -0,0 +1,56 @@
+# Copyright 2026 ByteColtX
+# SPDX-License-Identifier: MIT
+
+"""插件目录约定。
+
+三类文件各有各的家，互不重叠：
+
+- ``cache/media``：作品级媒体缓存（可重建、有 TTL）；
+- ``cache/relay``：待投递的任务目录，中转服务**只**服务这一层；
+- ``data``：需要长期保留的东西（会话开关）。
+
+媒体与数据目录按 NoneBot 官方要求交给 ``nonebot-plugin-localstore`` 管理：它负责
+Windows / macOS / Linux 上的正确路径，插件不自己拼目录、也不往系统临时目录里写。
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from nonebot import require
+
+# 官方写法：先 require 再 import，否则插件可能还没被加载。
+require("nonebot_plugin_localstore")
+
+import nonebot_plugin_localstore as store  # noqa: E402
+
+# 缓存根目录下的子目录名。
+MEDIA_DIR_NAME = "media"
+RELAY_DIR_NAME = "relay"
+
+
+def cache_root() -> Path:
+    """插件缓存根目录（媒体缓存与字体都放这儿）。
+
+    Returns:
+        缓存根目录。
+    """
+    return store.get_plugin_cache_dir()
+
+
+def data_root() -> Path:
+    """插件数据目录（需要长期保留的东西放这儿）。
+
+    Returns:
+        数据目录。
+    """
+    return store.get_plugin_data_dir()
+
+
+def relay_root() -> Path:
+    """中转服务根目录（只放待投递的任务目录）。
+
+    Returns:
+        缓存根目录下的 ``relay``。
+    """
+    return cache_root() / RELAY_DIR_NAME

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/service.py

@@ -272,7 +272,8 @@ async def _deliver(  # noqa: C901 - 顺序编排本身就是一条长流水线
 
     budget = Budget(settings.timeout)
     proxy = settings.proxy_for(platform)
-    cookie = platform_cookie(platform, settings.cookie)
+    # cookies.toml 是同步磁盘读，放线程里，别卡住事件循环
+    cookie = await asyncio.to_thread(platform_cookie, platform, settings.cookie)
     logger.debug(f"[parsehub] {platform} 代理={proxy or '直连'}")
 
     started = time.monotonic()

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/switches.py

@@ -7,7 +7,7 @@
 新群、新私聊也不需要任何初始化。
 
 状态存成 JSON，写的时候先写临时文件再 ``os.replace``，避免进程被杀的瞬间留下半
-个文件。模块本身不依赖 nonebot，方便单独测试。
+个文件。除 ``nonebot.logger`` 外不依赖 nonebot，方便单独测试。
 
 用法::
 
@@ -21,12 +21,11 @@
 from __future__ import annotations
 
 import json
-import logging
 import os
+import threading
 from pathlib import Path
 
-logger = logging.getLogger("nonebot_plugin_parsehub.switches")
-
+from nonebot import logger
 
 # 没有记录时的默认值：群和私聊一样，都是允许解析。
 DEFAULT_ON = True
@@ -77,6 +76,9 @@ class SwitchStore:
         self.path = path
         self.default = default
         self._state: dict[str, bool] = {}
+        # ``set`` 现在跑在线程池里：两个群同时改开关时既会抢同一个 ``*.tmp``，
+        # 也会在 ``json.dumps`` 遍历 ``_state`` 时撞上另一个线程的写入。
+        self._lock = threading.RLock()
         self.load()
 
     def load(self) -> None:
@@ -106,18 +108,23 @@ class SwitchStore:
         self._state = {str(key): bool(value) for key, value in sessions.items()}
 
     def save(self) -> None:
-        """原子写盘（先写 ``*.tmp`` 再 rename）。"""
-        try:
-            self.path.parent.mkdir(parents=True, exist_ok=True)
-            tmp = self.path.with_name(self.path.name + ".tmp")
-            payload = {"schema": SCHEMA, "sessions": self._state}
-            tmp.write_text(
-                json.dumps(payload, ensure_ascii=False, sort_keys=True),
-                "utf-8",
-            )
-            os.replace(tmp, self.path)
-        except OSError as exc:
-            logger.warning(f"[parsehub] 解析开关写盘失败: {exc}")
+        """原子写盘（先写 ``*.tmp`` 再 rename）。
+
+        调用方可能来自线程池，所以整个「拼 JSON → 写 tmp → rename」都在锁里，
+        否则两路写入会抢同一个 tmp 文件、或者撞上遍历中的字典。
+        """
+        with self._lock:
+            try:
+                self.path.parent.mkdir(parents=True, exist_ok=True)
+                tmp = self.path.with_name(self.path.name + ".tmp")
+                payload = {"schema": SCHEMA, "sessions": self._state}
+                tmp.write_text(
+                    json.dumps(payload, ensure_ascii=False, sort_keys=True),
+                    "utf-8",
+                )
+                os.replace(tmp, self.path)
+            except OSError as exc:
+                logger.warning(f"[parsehub] 解析开关写盘失败: {exc}")
 
     def is_on(self, key: str) -> bool:
         """这个会话允不允许解析。
@@ -140,28 +147,10 @@ class SwitchStore:
         Returns:
             设置之后的值。
         """
-        if on == self.default:
-            self._state.pop(key, None)  # 和默认值一样就不留记录
-        else:
-            self._state[key] = on
-        self.save()
+        with self._lock:
+            if on == self.default:
+                self._state.pop(key, None)  # 和默认值一样就不留记录
+            else:
+                self._state[key] = on
+            self.save()
         return on
-
-    def toggle(self, key: str) -> bool:
-        """翻转开关。
-
-        Args:
-            key: 会话键。
-
-        Returns:
-            翻转之后的值。
-        """
-        return self.set(key, not self.is_on(key))
-
-    def off_keys(self) -> list[str]:
-        """所有被关掉的会话键（按字母序）。
-
-        Returns:
-            会话键列表。
-        """
-        return sorted(key for key, on in self._state.items() if not on)

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.1}/src/nonebot_plugin_parsehub/triggers.py

@@ -12,6 +12,7 @@ matcher 由 :func:`create_matchers` 按传入的 ``App`` 创建，测试可以
 
 from __future__ import annotations
 
+import asyncio
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
@@ -35,9 +36,6 @@ if TYPE_CHECKING:
 # 单条消息最多处理几个链接。
 MAX_LINKS_PER_MESSAGE = 3
 
-# 命令触发时用来跳过自动解析的前缀。
-COMMAND_PREFIXES = ("解析", "ph", "/解析", "/ph")
-
 # 「解析开关」命令能接受的参数写法。
 ON_WORDS = frozenset({"开", "开启", "打开", "on", "true", "1"})
 OFF_WORDS = frozenset({"关", "关闭", "关上", "off", "false", "0"})
@@ -127,6 +125,11 @@ def can_control(event: MessageEvent) -> bool:
 async def should_auto(app: App, event: MessageEvent) -> bool:
     """判断是否应该自动解析这条消息。
 
+    命令不需要在这里排除：``解析`` / ``ph`` 等命令匹配器 ``priority=10`` 且
+    ``block=True``，命中后事件不会流到 ``priority=20`` 的自动匹配器。反过来，
+    ``COMMAND_START`` 没配空前缀时裸写的「解析 <链接>」本来就不是命令，必须按
+    普通消息自动解析，否则两个匹配器都不管、消息被静默丢弃。
+
     Args:
         app: 插件实例（需要 ``settings`` 与 ``switches``）。
         event: 收到的消息事件。
@@ -140,9 +143,6 @@ async def should_auto(app: App, event: MessageEvent) -> bool:
         return False
     if not switches.is_on(session_key(event)):
         return False  # 这个会话被关掉了
-    text = event.get_plaintext()
-    if text.lstrip().startswith(COMMAND_PREFIXES):
-        return False  # 命令触发交给命令匹配器
     return bool(keys.extract_urls(link_sources(event)))
 
 
@@ -267,7 +267,8 @@ def create_matchers(app: App) -> Matchers:
         else:
             want = not switches.is_on(key)
 
-        switches.set(key, want)
+        # 落盘是同步磁盘 IO，交给线程池，别卡住事件循环
+        want = await asyncio.to_thread(switches.set, key, want)
         name = session_name(event)
         logger.info(
             f"[parsehub] {name}解析开关 -> {'开' if want else '关'}"

nonebot_plugin_parsehub-1.0.0/src/nonebot_plugin_parsehub/paths.py

@@ -1,93 +0,0 @@
-# Copyright 2026 ByteColtX
-# SPDX-License-Identifier: MIT
-
-"""插件目录约定。
-
-三类文件各有各的家，互不重叠：
-
-- ``cache/media``：作品级媒体缓存（可重建、有 TTL）；
-- ``cache/relay``：待投递的任务目录，中转服务**只**服务这一层；
-- ``data``：需要长期保留的东西（会话开关）。
-
-媒体目录按 NoneBot 官方要求交给 ``nonebot-plugin-localstore`` 管理；没装时退回
-系统临时目录，保证插件仍能加载。
-"""
-
-from __future__ import annotations
-
-import tempfile
-from pathlib import Path
-
-from nonebot import logger, require
-
-# 缓存根目录下的子目录名。
-MEDIA_DIR_NAME = "media"
-RELAY_DIR_NAME = "relay"
-
-# 没装 localstore 时的兜底目录名。
-_FALLBACK_DIR_NAME = "nonebot-plugin-parsehub"
-
-
-def _store() -> object | None:
-    """尽量拿到 localstore 模块。
-
-    Returns:
-        ``nonebot_plugin_localstore`` 模块；没装时为 None。
-    """
-    try:
-        require("nonebot_plugin_localstore")
-
-        import nonebot_plugin_localstore as store
-    except Exception:  # noqa: BLE001 - 缺少依赖时降级，不能让插件整体挂掉
-        return None
-    return store
-
-
-def cache_root() -> Path:
-    """插件缓存根目录（媒体缓存与字体都放这儿）。
-
-    Returns:
-        缓存根目录。
-    """
-    store = _store()
-    if store is None:
-        logger.warning(
-            "[parsehub] 未安装 nonebot-plugin-localstore，"
-            "媒体临时文件改用系统临时目录"
-        )
-        return Path(tempfile.gettempdir()) / _FALLBACK_DIR_NAME
-    return store.get_plugin_cache_dir()
-
-
-def data_root() -> Path:
-    """插件数据目录（需要长期保留的东西放这儿）。
-
-    Returns:
-        数据目录。
-    """
-    store = _store()
-    if store is None:
-        logger.warning(
-            "[parsehub] 未安装 nonebot-plugin-localstore，"
-            "插件数据改用系统临时目录（重启会丢）"
-        )
-        return Path(tempfile.gettempdir()) / f"{_FALLBACK_DIR_NAME}-data"
-    return store.get_plugin_data_dir()
-
-
-def media_root() -> Path:
-    """作品级媒体缓存目录。
-
-    Returns:
-        缓存根目录下的 ``media``。
-    """
-    return cache_root() / MEDIA_DIR_NAME
-
-
-def relay_root() -> Path:
-    """中转服务根目录（只放待投递的任务目录）。
-
-    Returns:
-        缓存根目录下的 ``relay``。
-    """
-    return cache_root() / RELAY_DIR_NAME