feat(favorites): add favorites browsing functionality

- Add /jmfav command to view user favorites
- Add get_favorites() method to browser.py
- Add format_favorites() for display formatting
- Require login to access favorites feature

Author: GEMILUXVII

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 所有版本更新记录。
 
+## **v2.3.0** (2025-12-27)
+
+### 新增功能
+- **收藏夹功能** - 新增 `/jmfav` 命令，查看我的收藏
+  - `/jmfav [页码]` - 查看收藏夹（需登录）
+  - `/jmfav [页码] [收藏夹ID]` - 查看指定收藏夹
+  - 显示收藏夹列表，支持多收藏夹切换
+
+---
+
 ## **v2.2.0** (2025-12-27)
 
 ### 新增功能

README.md

@@ -10,7 +10,7 @@
 
 <br>
 <div align="center">
-  <a href="#更新日志"><img src="https://img.shields.io/badge/VERSION-v2.2.0-E91E63?style=for-the-badge" alt="Version"></a>
+  <a href="#更新日志"><img src="https://img.shields.io/badge/VERSION-v2.3.0-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>
@@ -98,6 +98,7 @@ pip install -r requirements.txt
 | `/jmlogin`      | 登录JM账号         | `/jmlogin u p`    |
 | `/jmlogout`     | 登出账号           | `/jmlogout`       |
 | `/jmstatus`     | 查看登录状态       | `/jmstatus`       |
+| `/jmfav`        | 查看我的收藏       | `/jmfav 1`        |
 | `/jmhelp`       | 查看帮助信息       | `/jmhelp`         |
 
 ## 配置说明
@@ -170,7 +171,7 @@ proxy_url: http://127.0.0.1:7890
 
 查看完整更新日志：[CHANGELOG.md](./CHANGELOG.md)
 
-**当前版本：v2.2.0** - 新增登录功能。
+**当前版本：v2.3.0** - 新增收藏夹功能。
 
 ## 注意事项
 

core/browser.py

@@ -219,3 +219,62 @@ def _get_month_ranking_sync(self, page: int, option) -> list[dict]:
         except Exception as e:
             logger.error(f"获取月排行榜失败: {e}")
             return []
+
+    # ==================== 收藏夹功能 ====================
+
+    async def get_favorites(
+        self, client, page: int = 1, folder_id: str = "0"
+    ) -> tuple[list[dict], list[dict]]:
+        """
+        获取收藏夹内容
+
+        Args:
+            client: 已登录的客户端
+            page: 页码
+            folder_id: 收藏夹ID，默认为 "0"（全部收藏）
+
+        Returns:
+            (收藏列表, 收藏夹列表)
+        """
+        if not self.is_available():
+            return [], []
+
+        try:
+            return await self._run_sync(
+                self._get_favorites_sync, client, page, folder_id
+            )
+        except Exception as e:
+            logger.error(f"获取收藏夹失败: {e}")
+            return [], []
+
+    def _get_favorites_sync(
+        self, client, page: int, folder_id: str
+    ) -> tuple[list[dict], list[dict]]:
+        """同步获取收藏夹内容"""
+        try:
+            fav_page = client.favorite_folder(page=page, folder_id=folder_id)
+
+            # 获取收藏的本子
+            albums = []
+            for album_id, title in fav_page.iter_id_title():
+                albums.append(
+                    {
+                        "id": album_id,
+                        "title": title,
+                    }
+                )
+
+            # 获取收藏夹列表
+            folders = []
+            for folder_id, folder_name in fav_page.iter_folder_id_name():
+                folders.append(
+                    {
+                        "id": folder_id,
+                        "name": folder_name,
+                    }
+                )
+
+            return albums, folders
+        except Exception as e:
+            logger.error(f"获取收藏夹失败: {e}")
+            return [], []

main.py

@@ -477,3 +477,46 @@ async def status_command(self, event: AstrMessageEvent):
             yield event.plain_result(
                 "❌ 当前未登录\n💡 使用 /jmlogin <用户名> <密码> 登录"
             )
+
+    @filter.command("jmfav")
+    async def favorites_command(
+        self, event: AstrMessageEvent, page: int = 1, folder_id: str = "0"
+    ):
+        """
+        查看我的收藏
+
+        用法: /jmfav [页码] [收藏夹ID]
+        示例: /jmfav 1
+        """
+        # 权限检查
+        has_perm, error_msg = self._check_permission(event)
+        if not has_perm:
+            yield event.plain_result(error_msg)
+            return
+
+        # 检查登录状态
+        logged_in, login_msg = await self.auth_manager.ensure_logged_in()
+        if not logged_in:
+            yield event.plain_result(f"❌ {login_msg}\n💡 请先使用 /jmlogin 登录")
+            return
+
+        # 验证页码
+        try:
+            page = int(page)
+            if page < 1:
+                page = 1
+        except (ValueError, TypeError):
+            page = 1
+
+        try:
+            yield event.plain_result(f"⭐ 正在获取收藏夹第{page}页...")
+
+            client = self.auth_manager.get_client()
+            albums, folders = await self.browser.get_favorites(client, page, folder_id)
+
+            result_msg = MessageFormatter.format_favorites(albums, folders, page)
+            yield event.plain_result(result_msg)
+
+        except Exception as e:
+            logger.error(f"获取收藏夹失败: {e}")
+            yield event.plain_result(MessageFormatter.format_error("network", str(e)))

metadata.yaml

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

utils/formatter.py

@@ -138,6 +138,48 @@ def format_ranking_results(
 
         return "\n".join(lines)
 
+    @staticmethod
+    def format_favorites(albums: list[dict], folders: list[dict], page: int = 1) -> str:
+        """
+        格式化收藏夹结果
+
+        Args:
+            albums: 收藏的本子列表
+            folders: 收藏夹列表
+            page: 当前页码
+
+        Returns:
+            格式化后的字符串
+        """
+        lines = []
+        lines.append("⭐ 我的收藏")
+        lines.append(f"📄 第 {page} 页")
+        lines.append("━━━━━━━━━━━━━━━━━━━━━")
+
+        if not albums:
+            lines.append("📭 收藏夹为空")
+        else:
+            for i, album in enumerate(albums, 1):
+                album_id = album.get("id", "")
+                title = album.get("title", "未知")
+                lines.append(f"{i}. 【{album_id}】{title}")
+
+        # 显示收藏夹列表（如果有多个）
+        if folders and len(folders) > 1:
+            lines.append("")
+            lines.append("📁 收藏夹列表:")
+            for folder in folders:
+                folder_id = folder.get("id", "")
+                folder_name = folder.get("name", "未知")
+                lines.append(f"  • [{folder_id}] {folder_name}")
+
+        lines.append("")
+        lines.append("━━━━━━━━━━━━━━━━━━━━━")
+        lines.append("💡 使用 /jmfav <页码> 翻页")
+        lines.append("💡 使用 /jmfav <页码> <收藏夹ID> 查看特定收藏夹")
+
+        return "\n".join(lines)
+
     @staticmethod
     def format_download_result(result, pack_result=None) -> str:
         """
@@ -222,12 +264,13 @@ def format_help() -> str:
 /jmlogin <用户名> <密码> - 登录JM账号
 /jmlogout   - 登出账号
 /jmstatus   - 查看登录状态
+/jmfav      - 查看我的收藏（需登录）
 
 【使用示例】
 /jm 123456       - 下载ID为123456的本子
 /jms 标签名      - 搜索包含该标签的漫画
 /jmrank week     - 查看周排行榜
-/jmlogin user pw - 登录账号
+/jmfav 1         - 查看收藏夹第1页
 
 【说明】
 • 下载的文件将自动打包发送