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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-parsehub
-Version: 1.0.0
+Version: 1.0.2
 Summary: 基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体
 Keywords: nonebot,nonebot2,plugin,parsehub,parser,media,onebot
 Author: ByteColtX
@@ -16,7 +16,9 @@ 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: parsehub>=2.3.10,<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.13,<3.0.0
 Requires-Dist: pillow>=12.1.0,<13.0.0
 Requires-Dist: pydantic>=2.0.0,<3.0.0
 Requires-Python: >=3.12
@@ -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.2}/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.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parsehub"
-version = "1.0.0"
+version = "1.0.2"
 description = "基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -27,7 +27,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",
-    "parsehub>=2.3.10,<3.0.0",
+    "numpy>=2.0.0,<3.0.0",
+    "opencv-python-headless>=4.13.0.92",
+    "parsehub>=2.3.13,<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.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parsehub"
-version = "1.0.0"
+version = "1.0.2"
 description = "基于 ParseHub 的社交媒体链接解析插件：群里出现分享链接时自动解析并发送媒体"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -20,7 +20,10 @@ 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",
-  "parsehub>=2.3.10,<3.0.0",
+  # 卡片渐变遮罩与视频抽帧是代码里直接 import 的，必须显式声明
+  "numpy>=2.0.0,<3.0.0",
+  "opencv-python-headless>=4.13.0.92",
+  "parsehub>=2.3.13,<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.2}/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
@@ -33,6 +36,7 @@ tags: [nonebot, parsehub, module]
 | `delivery.py` | `Sender` 协议、三种上传模式、合并转发、`MediaReport` |
 | `feedback.py` | `Reaction` 与全部提示文案 |
 | `parsehub_client.py` | 懒加载客户端、cookie 读取 |
+| `bilibili.py` | B 站默认P归一与单P时长查询 |
 | `cache.py` | 作品级媒体缓存（原子写、TTL、容量） |
 | `dedupe.py` | 会话级去重 |
 | `relay.py` | 只读中转服务 |
@@ -63,6 +67,17 @@ 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` 兜底，也不往别的目录写；降级只发生在产品层
+  （卡片→文字、字体→系统字体、体积探测→未知）。
+- B 站分P由 `bilibili` 收口：解析前去掉 `p`（只解析默认P），解析后用
+  `pages[0].duration` 覆盖 ParseHub 给的分P总时长；查不到就保持原值。
 
 ## Known limitations
 

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

@@ -24,19 +24,19 @@ 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
 
 __plugin_meta__ = PluginMetadata(
-    name="ParseHub 链接解析",
+    name="轻量、异步、开箱即用的社交媒体聚合解析插件",
     description=(
         "群里出现受支持的分享链接时，用 ParseHub 自动解析并发送媒体"
         "（视频 / 图集 / 正文）。"
     ),
     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.2/src/nonebot_plugin_parsehub/bilibili.py

@@ -0,0 +1,252 @@
+# Copyright 2026 ByteColtX
+# SPDX-License-Identifier: MIT
+
+"""B 站分P兼容：只解析默认P，并按默认P的时长判断。
+
+ParseHub 的 B 站解析器在 ``p=1`` 时直接取 ``View.duration``，而 B 站这个字段
+是**所有分P的时长总和**；分P越多，插件越容易误判成超长视频。这里在解析前后各
+补一刀：
+
+1. 解析前去掉 ``p`` 参数，让 ParseHub 始终解析默认P；
+2. 解析后向 B 站查一次 ``pages[0].duration``，覆盖结果里的总时长。
+
+第 2 步失败时保持原样（退化成旧行为），不影响解析和下载。
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Any
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
+
+import httpx
+from nonebot import logger
+
+# B 站视频 ID。BV 号大小写敏感，av 号只在路径或参数里认。
+_BV_PATTERN = re.compile(r"(BV[0-9A-Za-z]{10})")
+_AV_PATTERN = re.compile(r"(?:/|=)av(\d+)", re.IGNORECASE)
+_AID_PATTERN = re.compile(r"[?&]aid=(\d+)")
+
+# 需要做默认P归一的主机。短链没有 ID，但同样可能带 p 参数。
+_VIDEO_HOSTS = ("bilibili.com", "b23.tv", "bili2233.cn")
+_SHORT_HOSTS = ("b23.tv", "bili2233.cn")
+
+_VIEW_API = "https://api.bilibili.com/x/web-interface/view"
+_USER_AGENT = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36"
+)
+_TIMEOUT_SECONDS = 5.0
+
+
+def _video_params(url: str) -> dict[str, str] | None:
+    """从链接里取出 B 站视频 ID。
+
+    Args:
+        url: 可能是完整链或短链展开后的链接。
+
+    Returns:
+        ``{"bvid": ...}`` 或 ``{"aid": ...}``；认不出来时返回 None。
+    """
+    match = _BV_PATTERN.search(url)
+    if match:
+        return {"bvid": match.group(1)}
+    match = _AV_PATTERN.search(url)
+    if match:
+        return {"aid": match.group(1)}
+    match = _AID_PATTERN.search(url)
+    if match:
+        return {"aid": match.group(1)}
+    return None
+
+
+def _is_video_host(host: str) -> bool:
+    """判断主机是不是 B 站视频站（含短链站）。
+
+    Args:
+        host: 已小写的主机名。
+
+    Returns:
+        命中返回 True。
+    """
+    return any(
+        host == item or host.endswith("." + item) for item in _VIDEO_HOSTS
+    )
+
+
+def _is_short_host(host: str) -> bool:
+    """判断主机是不是 B 站短链站。
+
+    Args:
+        host: 已小写的主机名。
+
+    Returns:
+        命中返回 True。
+    """
+    return any(
+        host == item or host.endswith("." + item) for item in _SHORT_HOSTS
+    )
+
+
+def default_part_url(url: str) -> str:
+    """去掉 B 站视频链接里的 ``p`` 参数。
+
+    去掉后 ParseHub 会解析默认P（P1）；对短链也先去掉，展开后即使带 ``p``
+    也不会被保留。
+
+    Args:
+        url: 待解析的链接。
+
+    Returns:
+        去掉 ``p`` 后的链接；非 B 站视频链接原样返回。
+    """
+    parsed = urlsplit(url)
+    host = (parsed.hostname or "").lower()
+    if not _is_video_host(host):
+        return url
+    if not _is_short_host(host) and _video_params(url) is None:
+        return url
+    query = [
+        (key, value)
+        for key, value in parse_qsl(parsed.query, keep_blank_values=True)
+        if key.lower() != "p"
+    ]
+    return urlunsplit(parsed._replace(query=urlencode(query)))
+
+
+async def resolve_default_part_url(url: str, proxy: str = "") -> str:
+    """展开短链后再去掉 ``p``，确保短链也只解析默认P。
+
+    短链本身没有 ID，ParseHub 展开时会把重定向目标里的 ``p`` 保留下来；这里先
+    自己展开一次，拿到完整链后统一去掉 ``p``。展开失败就退回原链接。
+
+    Args:
+        url: 用户发的链接。
+        proxy: 展开短链用的代理。
+
+    Returns:
+        指向默认P的完整链；非 B 站短链原样返回。
+    """
+    parsed = urlsplit(url)
+    host = (parsed.hostname or "").lower()
+    if not _is_short_host(host):
+        return default_part_url(url)
+    try:
+        async with _client(proxy) as client:
+            response = await client.get(
+                url,
+                headers={"User-Agent": _USER_AGENT},
+                follow_redirects=True,
+            )
+            response.raise_for_status()
+            resolved = str(response.url)
+    except Exception as exc:  # noqa: BLE001 - 展开失败交给 ParseHub 自己处理
+        logger.debug(
+            f"[parsehub] 展开 B 站短链失败: {type(exc).__name__}: {exc}"
+        )
+        return default_part_url(url)
+    # 重定向到非视频页时把短链还给 ParseHub，让它按原链接选解析器。
+    if _video_params(resolved) is None:
+        return default_part_url(url)
+    return default_part_url(resolved)
+
+
+def default_page_seconds(data: Any) -> int:  # noqa: ANN401 - B 站接口 JSON
+    """从 B 站 ``view`` 接口的 ``data`` 里取默认P时长。
+
+    Args:
+        data: 接口返回的 ``data`` 字段。
+
+    Returns:
+        默认P（``pages[0]``）的秒数；拿不到时退回总时长，再拿不到返回 0。
+    """
+    if not isinstance(data, dict):
+        return 0
+    pages = data.get("pages")
+    if isinstance(pages, list) and pages and isinstance(pages[0], dict):
+        try:
+            return max(int(pages[0].get("duration") or 0), 0)
+        except (TypeError, ValueError):
+            pass
+    try:
+        return max(int(data.get("duration") or 0), 0)
+    except (TypeError, ValueError):
+        return 0
+
+
+def _client(proxy: str) -> httpx.AsyncClient:
+    """构造查接口用的 HTTP 客户端（测试里替换成不联网的假实现）。
+
+    Args:
+        proxy: 代理地址，空字符串表示直连。
+
+    Returns:
+        异步 HTTP 客户端。
+    """
+    return httpx.AsyncClient(
+        proxy=proxy or None,
+        timeout=_TIMEOUT_SECONDS,
+        follow_redirects=True,
+    )
+
+
+async def default_part_seconds(
+    url: str,
+    proxy: str = "",
+    cookie: str = "",
+) -> int:
+    """查询 B 站视频默认P的时长。
+
+    Args:
+        url: 视频链接（完整链或已展开的短链）。
+        proxy: 解析代理，空字符串表示直连。
+        cookie: 登录态 cookie，空字符串表示不带。
+
+    Returns:
+        默认P的秒数；不是 B 站视频或请求失败时返回 0。
+    """
+    params = _video_params(url)
+    if params is None:
+        return 0
+    headers = {
+        "User-Agent": _USER_AGENT,
+        "Referer": "https://www.bilibili.com/",
+    }
+    if cookie:
+        headers["Cookie"] = cookie
+    try:
+        async with _client(proxy) as client:
+            response = await client.get(
+                _VIEW_API, params=params, headers=headers
+            )
+            response.raise_for_status()
+            payload = response.json()
+    except Exception as exc:  # noqa: BLE001 - 查时长失败不能影响解析
+        logger.debug(
+            f"[parsehub] 查询 B 站默认P时长失败: {type(exc).__name__}: {exc}"
+        )
+        return 0
+    data = payload.get("data") if isinstance(payload, dict) else None
+    return default_page_seconds(data)
+
+
+def apply_duration(result: Any, seconds: int) -> None:  # noqa: ANN401 - parsehub 结果
+    """把默认P时长写回解析结果里的第一个媒体。
+
+    卡片和时长上限都从 ``result.media[].duration`` 读，改这里两边一起生效。
+
+    Args:
+        result: ParseHub 的解析结果。
+        seconds: 默认P的秒数。
+    """
+    if seconds <= 0:
+        return
+    media = getattr(result, "media", None)
+    items = list(media) if isinstance(media, (list, tuple)) else [media]
+    for item in items:
+        if item is not None and hasattr(item, "duration"):
+            try:
+                item.duration = seconds
+            except (AttributeError, TypeError):
+                pass
+            return

{nonebot_plugin_parsehub-1.0.0 → nonebot_plugin_parsehub-1.0.2}/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.2}/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.2}/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.2}/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:
     """把解析结果渲染成卡片图。