feat(parser): 重构懒下载模式替代原有的延迟发送功能 (#20)

* feat(parser): 重构懒下载模式替代原有的延迟发送功能

- 移除旧的延迟发送配置选项(parser_delay_send_media、parser_delay_send_emoji_ids、parser_delay_send_lazy_download)
- 新增懒下载配置选项(parser_lazy_download)和下载命令列表(parser_download_command)
- 实现LazyManager类管理用户下载会话，支持超时自动清理
- 添加懒下载命令匹配器，用户可发送指定命令下载媒体资源
- 修改渲染器逻辑，分离立即发送和可转发的内容处理
- 移除基于表情点赞的延迟发送机制，改用命令驱动的懒下载模式
- 更新README文档中的配置说明

* feat(config): 添加懒下载模式超时配置项

- 新增 parser_lazy_download_timeout 配置项，默认值为30秒
- 在配置模型中添加对应的属性和文档说明
- 通过 lazy_download_timeout 属性提供访问接口
- 将 README.md 中的配置说明同步更新

* fix(matchers): 修复LazyManager资源清理逻辑

确保在所有情况下都能正确清理用户会话资源，
将LazyManager.remove调用移到finally块中以保证执行。

* refactor(renderer): 优化媒体内容处理逻辑

- 添加sourcery代码优化跳过注释
- 简化视频和音频内容的条件判断逻辑
- 将嵌套的条件语句重构为更清晰的if-else结构
- 保持原有的功能不变，但提高代码可读性

* chore(build): 更新.gitignore并移除VSCode设置中的ruff组织导入配置

移除.gitignore中大部分内容，只保留__pycache__/条目

移除VSCode设置中ruff.organizeImports选项

* feat(config): 分离音频和视频上传配置选项

- 将原来的 parser_need_upload 配置项拆分为 parser_need_upload_audio
  和 parser_need_upload_video，分别控制音频和视频的上传行为
- 移除废弃的 need_upload 属性，保留 need_upload_audio 和
  need_upload_video 属性
- 更新 README.md 中的相关配置说明

* refactor(matchers): 优化懒下载管理器的异步操作

- 将 LazyManager 的 add、get、remove 方法从异步改为同步方法
- 改进超时处理器中的任务取消逻辑，避免 self-cancel 异常
- 添加 current_task 参数来防止超时回调中的自我取消
- 更新相关调用处的 await 关键字使用

Author: molanp

.gitignore

@@ -1,158 +1 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-.pybuilder/
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Pyre type checker
-.pyre/
-
-# pytype static type analyzer
-.pytype/
-
-# Cython debug symbols
-cython_debug/
-
-# ruff
-.ruff_cache/
-
-# LSP config files
-pyrightconfig.json
-
-.idea/
-
-
-# localstorage use cwd
-cache
-data
-config
-
-# macOS
-.DS_Store
-junit*.xml
-coverage*.xml
-
-# VSCode
-.vscode/
-
-
-# env
-!.env.test
-.env.*
-render_result.md
-render_result_html.md
-render_result_combined.md
+__pycache__/

.vscode/settings.json

@@ -19,7 +19,6 @@
   "ruff.format.preview": false,
   "isort.check": true,
   "ruff.importStrategy": "useBundled",
-  "ruff.organizeImports": false,
   "[javascript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },

README.md

@@ -79,7 +79,10 @@ parser_bili_video_quality=80
 parser_xhs_ck=""
 
 # [可选] 音频解析，是否需要上传群文件
-parser_need_upload=False
+parser_need_upload_audio=False
+
+# [可选] 视频解析，是否需要上传群文件
+parser_need_upload_video=False
 
 # [可选] 视频，图片，音频是否使用 base64 发送
 # 注意：编解码和传输 base64 会占用更多的内存,性能和带宽, 甚至可能会使 websocket 连接崩溃
@@ -103,14 +106,14 @@ parser_append_url=False
 # [可选] 是否需要转发媒体内容(超过 4 项时始终使用合并转发)
 parser_need_forward_contents=True
 
-# [可选] 是否延迟发送视频/音频，需要用户发送特定表情或点赞特定表情后才发送
-parser_delay_send_media=False
+# [可选] 是否开启懒下载模式，仅在用户请求时才下载视频
+parser_lazy_download=False
 
-# [可选] 触发延迟发送视频的表情ID列表，用于监听group_msg_emoji_like事件
-parser_delay_send_emoji_ids=[128077]
+# [可选] 懒下载模式等待命令超时时间
+parser_lazy_download_timeout=30
 
-# [可选] 是否开启懒下载模式，仅在用户请求时才下载视频
-parser_delay_send_lazy_download=False
+# [可选] 在懒下载模式中用户请求下载视频时的命令列表
+parser_download_command=["下载视频", "xz"]
 
 # [可选] 图片反代,用于解决可能的403和外网访问问题
 # (例如,https://image.baidu.com/search/down?url=)

src/nonebot_plugin_parser/config.py

@@ -1,14 +1,13 @@
 from pathlib import Path
 
+import nonebot_plugin_localstore as _store
+from bilibili_api.video import VideoCodecs, VideoQuality
 from nonebot import get_driver, get_plugin_config
+from nonebot.plugin import PluginMetadata, inherit_supported_adapters
 from pydantic import BaseModel
-from bilibili_api.video import VideoCodecs, VideoQuality
 
 from .constants import PlatformEnum
 
-import nonebot_plugin_localstore as _store
-from nonebot.plugin import PluginMetadata, inherit_supported_adapters
-
 
 class Config(BaseModel):
     parser_bili_ck: str | None = None
@@ -45,12 +44,12 @@ class Config(BaseModel):
     """B站视频清晰度"""
     parser_need_forward_contents: bool = True
     """是否需要合并转发内容(大于四项时始终转发)"""
-    parser_delay_send_media: bool = False
-    """是否延迟发送视频/音频，需要用户发送特定表情或点赞特定表情后才发送"""
-    parser_delay_send_emoji_ids: list[int] = [128077]
-    """触发延迟发送视频的表情ID列表，用于监听group_msg_emoji_like事件"""
-    parser_delay_send_lazy_download: bool = False
+    parser_lazy_download: bool = False
     """是否开启懒下载模式，仅在用户请求时才下载视频"""
+    parser_lazy_download_timeout: int = 30
+    """懒下载模式等待命令超时时间"""
+    parser_download_command: list[str] = ["下载视频", "xz"]
+    """在懒下载模式中用户请求下载视频时的命令列表"""
     parser_pic_proxy: str | None = None
     """图片反向代理地址，用于处理图片下载失败的问题"""
     parser_browser_path: str | None = None
@@ -111,11 +110,6 @@ def xhs_ck(self) -> str | None:
         """小红书 cookies"""
         return self.parser_xhs_ck
 
-    @property
-    def need_upload(self) -> bool:
-        """是否需要上传音视频文件（兼容旧配置）"""
-        return self.parser_need_upload
-
     @property
     def need_upload_audio(self) -> bool:
         """是否需要上传音频文件"""
@@ -152,19 +146,19 @@ def blacklist_users(self) -> list[str]:
         return self.parser_blacklist_users
 
     @property
-    def delay_send_media(self) -> bool:
-        """是否延迟发送视频/音频"""
-        return self.parser_delay_send_media
+    def download_command(self) -> list[str]:
+        """在懒下载模式中用户请求下载视频时的命令列表"""
+        return self.parser_download_command
 
     @property
-    def delay_send_emoji_ids(self) -> list[int]:
-        """触发延迟发送视频的表情ID列表"""
-        return self.parser_delay_send_emoji_ids
+    def lazy_download(self) -> bool:
+        """是否开启懒下载模式"""
+        return self.parser_lazy_download
 
     @property
-    def delay_send_lazy_download(self) -> bool:
-        """是否开启懒下载模式"""
-        return self.parser_delay_send_lazy_download
+    def lazy_download_timeout(self) -> int:
+        """懒下载模式等待命令超时时间"""
+        return self.parser_lazy_download_timeout
 
     @property
     def pic_proxy(self) -> str | None: