feat: implement login functionality with auth manager

- Add core/auth.py with JMAuthManager class
- Add /jmlogin, /jmlogout, /jmstatus commands
- Add jm_username and jm_password config options
- Update help message with login commands

Author: GEMILUXVII

_conf_schema.json

@@ -108,5 +108,17 @@
     "description": "调试模式",
     "hint": "开启后会输出详细的调试日志",
     "default": false
+  },
+  "jm_username": {
+    "type": "string",
+    "description": "JM账号用户名",
+    "hint": "填写后可自动登录，解锁收藏夹等功能（可选）",
+    "default": ""
+  },
+  "jm_password": {
+    "type": "string",
+    "description": "JM账号密码",
+    "hint": "配合用户名使用，支持自动登录（可选）",
+    "default": ""
   }
 }

core/__init__.py

@@ -1,15 +1,17 @@
 """
 JM Cosmos2 核心模块
 
-提供下载、浏览、配置、打包等核心功能。
+提供下载、浏览、认证、配置、打包等核心功能。
 """
 
+from .auth import JMAuthManager
 from .base import JMClientMixin, JMConfigManager
 from .browser import JMBrowser
 from .downloader import DownloadResult, JMDownloadManager
 from .packer import JMPacker
 
 __all__ = [
+    "JMAuthManager",
     "JMBrowser",
     "JMClientMixin",
     "JMConfigManager",

core/auth.py

@@ -0,0 +1,127 @@
+"""
+JMComic 认证管理模块
+
+提供登录、登出、会话管理等认证功能。
+"""
+
+from astrbot.api import logger
+
+from .base import JMClientMixin, JMConfigManager
+
+try:
+    JMCOMIC_AVAILABLE = True
+except ImportError:
+    JMCOMIC_AVAILABLE = False
+
+
+class JMAuthManager(JMClientMixin):
+    """JMComic 认证管理器"""
+
+    def __init__(self, config_manager: JMConfigManager):
+        """
+        初始化认证管理器
+
+        Args:
+            config_manager: 配置管理器实例
+        """
+        self.config = config_manager
+        self._logged_in = False
+        self._username: str | None = None
+        self._client = None
+
+    @property
+    def is_logged_in(self) -> bool:
+        """检查是否已登录"""
+        return self._logged_in
+
+    @property
+    def current_user(self) -> str | None:
+        """获取当前登录用户名"""
+        return self._username if self._logged_in else None
+
+    def get_client(self):
+        """获取已认证的客户端（如果已登录）"""
+        if self._logged_in and self._client is not None:
+            return self._client
+        return self._build_client()
+
+    async def login(self, username: str, password: str) -> tuple[bool, str]:
+        """
+        异步登录
+
+        Args:
+            username: 用户名
+            password: 密码
+
+        Returns:
+            (成功与否, 消息)
+        """
+        if not self.is_available():
+            return False, "jmcomic 库未安装"
+
+        try:
+            result = await self._run_sync(self._login_sync, username, password)
+            return result
+        except Exception as e:
+            logger.error(f"登录失败: {e}")
+            return False, f"登录失败: {str(e)}"
+
+    def _login_sync(self, username: str, password: str) -> tuple[bool, str]:
+        """同步登录"""
+        try:
+            option = self._get_option()
+            if option is None:
+                return False, "无法创建配置"
+
+            client = option.build_jm_client()
+            client.login(username, password)
+
+            # 保存登录状态
+            self._logged_in = True
+            self._username = username
+            self._client = client
+
+            logger.info(f"用户 {username} 登录成功")
+            return True, f"登录成功，欢迎 {username}！"
+
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"登录失败: {error_msg}")
+
+            # 解析常见错误
+            if "password" in error_msg.lower() or "用户名" in error_msg:
+                return False, "用户名或密码错误"
+            elif "network" in error_msg.lower() or "connect" in error_msg.lower():
+                return False, "网络连接失败，请稍后重试"
+
+            return False, f"登录失败: {error_msg}"
+
+    def logout(self) -> tuple[bool, str]:
+        """
+        登出
+
+        Returns:
+            (成功与否, 消息)
+        """
+        if not self._logged_in:
+            return False, "当前未登录"
+
+        username = self._username
+        self._logged_in = False
+        self._username = None
+        self._client = None
+
+        logger.info(f"用户 {username} 已登出")
+        return True, f"已登出账号 {username}"
+
+    def get_login_status(self) -> dict:
+        """
+        获取登录状态
+
+        Returns:
+            登录状态信息字典
+        """
+        return {
+            "logged_in": self._logged_in,
+            "username": self._username,
+        }

main.py

@@ -11,7 +11,7 @@
 from astrbot.api.event import AstrMessageEvent, filter
 from astrbot.api.star import Context, Star, StarTools, register
 
-from .core import JMBrowser, JMConfigManager, JMDownloadManager, JMPacker
+from .core import JMAuthManager, JMBrowser, JMConfigManager, JMDownloadManager, JMPacker
 from .utils import MessageFormatter
 
 # 插件名称常量
@@ -53,6 +53,9 @@ def __init__(self, context: Context, config: AstrBotConfig = None):
         # 初始化浏览查询器
         self.browser = JMBrowser(self.config_manager)
 
+        # 初始化认证管理器
+        self.auth_manager = JMAuthManager(self.config_manager)
+
         # 调试模式
         self.debug_mode = self.config_manager.debug_mode
         if self.debug_mode:
@@ -395,3 +398,82 @@ async def ranking_command(
         except Exception as e:
             logger.error(f"获取排行榜失败: {e}")
             yield event.plain_result(MessageFormatter.format_error("network", str(e)))
+
+    @filter.command("jmlogin")
+    async def login_command(
+        self, event: AstrMessageEvent, username: str = None, password: str = None
+    ):
+        """
+        登录JM账号
+
+        用法: /jmlogin <用户名> <密码>
+        示例: /jmlogin myuser mypass
+        """
+        # 权限检查
+        has_perm, error_msg = self._check_permission(event)
+        if not has_perm:
+            yield event.plain_result(error_msg)
+            return
+
+        # 参数检查
+        if username is None or password is None:
+            yield event.plain_result(
+                "❌ 请提供用户名和密码\n用法: /jmlogin <用户名> <密码>\n示例: /jmlogin myuser mypass"
+            )
+            return
+
+        try:
+            yield event.plain_result("🔐 正在登录...")
+
+            success, message = await self.auth_manager.login(username, password)
+
+            if success:
+                yield event.plain_result(f"✅ {message}")
+            else:
+                yield event.plain_result(f"❌ {message}")
+
+        except Exception as e:
+            logger.error(f"登录失败: {e}")
+            yield event.plain_result(MessageFormatter.format_error("network", str(e)))
+
+    @filter.command("jmlogout")
+    async def logout_command(self, event: AstrMessageEvent):
+        """
+        登出JM账号
+
+        用法: /jmlogout
+        """
+        # 权限检查
+        has_perm, error_msg = self._check_permission(event)
+        if not has_perm:
+            yield event.plain_result(error_msg)
+            return
+
+        success, message = self.auth_manager.logout()
+
+        if success:
+            yield event.plain_result(f"✅ {message}")
+        else:
+            yield event.plain_result(f"❌ {message}")
+
+    @filter.command("jmstatus")
+    async def status_command(self, event: AstrMessageEvent):
+        """
+        查看登录状态
+
+        用法: /jmstatus
+        """
+        # 权限检查
+        has_perm, error_msg = self._check_permission(event)
+        if not has_perm:
+            yield event.plain_result(error_msg)
+            return
+
+        status = self.auth_manager.get_login_status()
+
+        if status["logged_in"]:
+            yield event.plain_result(f"✅ 已登录\n👤 用户名: {status['username']}")
+        else:
+            yield event.plain_result(
+                "❌ 当前未登录\n💡 使用 /jmlogin <用户名> <密码> 登录"
+            )

utils/formatter.py

@@ -218,16 +218,20 @@ def format_help() -> str:
 /jmrank      - 查看排行榜
 /jmhelp      - 显示此帮助信息
 
+【账号命令】
+/jmlogin <用户名> <密码> - 登录JM账号
+/jmlogout   - 登出账号
+/jmstatus   - 查看登录状态
+
 【使用示例】
 /jm 123456       - 下载ID为123456的本子
 /jms 标签名      - 搜索包含该标签的漫画
-/jmi 123456      - 查看本子详细信息
 /jmrank week     - 查看周排行榜
-/jmrank month 2  - 查看月排行榜第2页
+/jmlogin user pw - 登录账号
 
 【说明】
 • 下载的文件将自动打包发送
-• 支持群聊和私聊使用"""
+• 登录后可访问收藏夹等功能"""
 
     @staticmethod
     def format_error(error_type: str, detail: str = "") -> str: