feat: add filename_show_password option for v2.6.3

Author: GEMILUXVII

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 所有版本更新记录。
 
+## **v2.6.3** (2026-01-05)
+
+### 新增功能
+- **文件名显示密码** - 新增 `filename_show_password` 配置项
+  - 开启后，打包文件名中会包含密码信息，便于用户识别
+  - 默认关闭，保持原有命名方式
+
+### 文档
+- README 新增 webp 图片格式说明
+
+---
+
 ## **v2.6.2** (2026-01-04)
 
 ### Bug 修复

README.md

@@ -10,7 +10,7 @@
 
 <br>
 <div align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/VERSION-v2.6.2-E91E63?style=for-the-badge" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/VERSION-v2.6.3-E91E63?style=for-the-badge" alt="Version"></a>
   <a href="https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-009688?style=for-the-badge" alt="License"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/PYTHON-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"></a>
   <a href="https://github.com/AstrBotDevs/AstrBot"><img src="https://img.shields.io/badge/AstrBot-Compatible-00BFA5?style=for-the-badge&logo=robot&logoColor=white" alt="AstrBot Compatible"></a>
@@ -19,7 +19,7 @@
 <div align="center">
   <a href="https://pypi.org/project/jmcomic/"><img src="https://img.shields.io/badge/JMCOMIC-≥2.5.0-9C27B0?style=for-the-badge" alt="JMComic"></a>
   <a href="https://github.com/botuniverse/onebot-11"><img src="https://img.shields.io/badge/OneBotv11-AIOCQHTTP-FF5722?style=for-the-badge&logo=qq&logoColor=white" alt="OneBot v11 Support"></a>
-  <a href="https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos"><img src="https://img.shields.io/badge/UPDATED-2026.01.04-2196F3?style=for-the-badge" alt="Updated"></a>
+  <a href="https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos"><img src="https://img.shields.io/badge/UPDATED-2026.01.05-2196F3?style=for-the-badge" alt="Updated"></a>
 </div>
 
 ## 介绍
@@ -261,6 +261,11 @@ pip install -r requirements.txt
 | `jm_username`            | JM账号用户名               | 空（可选）     |
 | `jm_password`            | JM账号密码                 | 空（可选）     |
 
+> [!NOTE]
+> **关于 webp 图片格式**
+> 
+> 当 `image_suffix` 设置为 `.webp` 时，**仅支持 ZIP 打包**。由于 pymupdf 库不支持 webp 格式，使用 PDF 打包将无法正常输出文件。webp 格式的优势在于体积更小，适合追求轻量化的用户；如无特殊需求，建议使用默认的 `.jpg` 格式以获得最佳兼容性。
+
 > [!TIP]
 > **防风控建议**
 > 
@@ -375,7 +380,7 @@ proxy_url: http://127.0.0.1:7890
 
 查看完整更新日志：[CHANGELOG.md](./CHANGELOG.md)
 
-**当前版本：v2.6.2** - 修复 Docker 环境代理问题 (Issue #43)。
+**当前版本：v2.6.3** - 新增文件名显示密码配置项。
 
 ## 注意事项
 

_conf_schema.json

@@ -67,6 +67,12 @@
     "hint": "为ZIP或PDF设置密码，留空则不加密",
     "default": ""
   },
+  "filename_show_password": {
+    "type": "bool",
+    "description": "文件名显示密码",
+    "hint": "开启后在文件名末尾添加 #PWxxx 提示（仅当设置了密码时生效）",
+    "default": false
+  },
   "auto_delete_after_send": {
     "type": "bool",
     "description": "发送后自动删除",

core/base/config.py

@@ -81,6 +81,11 @@ def pack_password(self) -> str:
         """打包密码"""
         return self.plugin_config.get("pack_password", "")
 
+    @property
+    def filename_show_password(self) -> bool:
+        """是否在文件名中显示密码提示"""
+        return self.plugin_config.get("filename_show_password", False)
+
     @property
     def auto_delete_after_send(self) -> bool:
         """发送后是否自动删除"""

main.py

@@ -4,7 +4,6 @@
 支持搜索、下载禁漫天堂的漫画本子，基于jmcomic库
 """
 
-import time
 from pathlib import Path
 
 import astrbot.api.message_components as Comp
@@ -13,7 +12,7 @@
 from astrbot.api.star import Context, Star, StarTools, register
 
 from .core import JMAuthManager, JMBrowser, JMConfigManager, JMDownloadManager, JMPacker
-from .utils import MessageFormatter, send_with_recall
+from .utils import MessageFormatter, generate_album_filename, send_with_recall
 
 # 插件名称常量
 PLUGIN_NAME = "jm_cosmos2"
@@ -23,7 +22,7 @@
     "jm_cosmos2",
     "GEMILUXVII",
     "JM漫画下载插件 - 支持搜索、下载禁漫天堂的漫画本子，支持加密PDF/ZIP打包",
-    "2.6.2",
+    "2.6.3",
     "https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos",
 )
 class JMCosmosPlugin(Star):
@@ -122,7 +121,7 @@ async def download_album_command(
             # 发送开始下载提示
             yield event.plain_result(f"⏳ 开始下载本子 {album_id}，请稍候...")
 
-            # 如果配置了发送封面预览，先获取详情和封面
+            # 如果配置了发送封面预览，获取详情和封面
             if self.config_manager.send_cover_preview:
                 detail = await self.browser.get_album_detail(album_id)
                 if detail:
@@ -153,6 +152,13 @@ async def download_album_command(
                 )
                 return
 
+            # 生成文件名
+            output_name = generate_album_filename(
+                album_id=album_id,
+                password=self.config_manager.pack_password,
+                show_password=self.config_manager.filename_show_password,
+            )
+
             # 打包文件
             packer = JMPacker(
                 pack_format=self.config_manager.pack_format,
@@ -161,7 +167,7 @@ async def download_album_command(
 
             pack_result = packer.pack(
                 source_dir=result.save_path,
-                output_name=f"dl_{album_id}_{int(time.time())}",
+                output_name=output_name,
             )
 
             # 发送结果消息
@@ -259,6 +265,7 @@ async def download_photo_command(
                 f"⏳ 正在获取本子 {album_id} 的第 {chapter_idx} 章节信息..."
             )
 
+
             # 获取章节的真正 photo_id
             chapter_info = await self.browser.get_photo_id_by_index(
                 album_id, chapter_idx
@@ -291,6 +298,14 @@ async def download_photo_command(
                 )
                 return
 
+            # 生成文件名（带章节号）
+            output_name = generate_album_filename(
+                album_id=album_id,
+                password=self.config_manager.pack_password,
+                chapter_idx=chapter_idx,
+                show_password=self.config_manager.filename_show_password,
+            )
+
             # 打包
             packer = JMPacker(
                 pack_format=self.config_manager.pack_format,
@@ -299,7 +314,7 @@ async def download_photo_command(
 
             pack_result = packer.pack(
                 source_dir=result.save_path,
-                output_name=f"dl_{album_id}_ch{chapter_idx}_{int(time.time())}",
+                output_name=output_name,
             )
 
             result_msg = MessageFormatter.format_download_result(result, pack_result)

metadata.yaml

@@ -1,5 +1,5 @@
 name: JM-Cosmos II
 desc: JM漫画下载插件 - 支持搜索、下载禁漫天堂的漫画本子，基于jmcomic库，支持加密PDF/ZIP打包
-version: v2.6.2
+version: v2.6.3
 author: GEMILUXVII
 repo: https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
-name = "JM-Cosmos II"
-version = "2.5.5"
+name = "jm-cosmos-ii"
+version = "2.6.3"
 description = "JM漫画下载插件 - 支持搜索、下载禁漫天堂的漫画本子，基于jmcomic库"
 readme = "README.md"
 requires-python = ">=3.10"

tests/integration/test_browse.py

@@ -100,7 +100,7 @@ async def test_get_album_detail(self, browser, test_album_id):
     @pytest.mark.asyncio
     async def test_get_album_detail_invalid_id(self, browser):
         """测试无效 ID"""
-        detail = await browser.get_album_detail("999999999")
+        _detail = await browser.get_album_detail("999999999")
 
         # 无效 ID 应该返回 None 或抛出异常
         # 这里只验证不会崩溃

tests/integration/test_packer.py

@@ -15,19 +15,11 @@
 
 # 直接检测库是否可用，不依赖 packer 模块的常量
 def is_pyzipper_available():
-    try:
-        import pyzipper
-        return True
-    except ImportError:
-        return False
+    return importlib.util.find_spec("pyzipper") is not None
 
 
 def is_pymupdf_available():
-    try:
-        import fitz
-        return True
-    except ImportError:
-        return False
+    return importlib.util.find_spec("fitz") is not None
 
 
 class TestZipPackingIntegration:

tests/unit/conftest.py

@@ -4,7 +4,9 @@
 提供测试所需的公共配置、临时目录和 mock 对象。
 """
 
+import importlib.util
 import sys
+import types
 from pathlib import Path
 from typing import Any
 from unittest.mock import MagicMock, patch
@@ -23,7 +25,6 @@
 mock_jmcomic.JmcomicText = MagicMock()
 
 # 设置 __spec__ 以通过 importlib.util.find_spec 检查
-import importlib.util
 
 mock_spec = importlib.util.spec_from_loader("jmcomic", loader=None)
 mock_jmcomic.__spec__ = mock_spec
@@ -45,7 +46,6 @@
 
 # 设置包层级结构以支持相对导入
 # 创建一个虚拟的顶级包来容纳 core 和 utils
-import types
 
 # 创建顶级虚拟包
 plugin_pkg = types.ModuleType("astrbot_plugin_jm_cosmos")
@@ -54,8 +54,8 @@
 sys.modules["astrbot_plugin_jm_cosmos"] = plugin_pkg
 
 # 预先导入核心模块并注册
-from core import base as core_base
-from core import constants as core_constants
+from core import base as core_base  # noqa: E402
+from core import constants as core_constants  # noqa: E402
 
 # 设置 core 子包
 core_pkg = types.ModuleType("astrbot_plugin_jm_cosmos.core")