plugin-jm-server 0.2.0__tar.gz → 0.2.2__tar.gz

{plugin_jm_server-0.2.0 → plugin_jm_server-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plugin_jm_server
-Version: 0.2.0
+Version: 0.2.2
 Summary: plugin_jm_server, a plugin for jmcomic that can be used to view comics in a web browser.
 Home-page: https://github.com/hect0x7/plugin-jm-server
 Author: hect0x7
@@ -44,20 +44,35 @@ Dynamic: summary
 
 * 双页阅读插件：https://sleazyfork.org/zh-CN/scripts/374903-comicread
 
-#  想法起源
+# 效果图（文件浏览、整章看图）
 
-想法起源：https://github.com/hect0x7/JMComic-Crawler-Python/issues/192
+## 1. 电脑浏览器访问
 
-基于原项目：https://github.com/AiCorein/Flask-Files-Server
+### 登录页
+![](images/3.png)
 
-为了方便修改，将原项目中的文件复制到本项目中，然后进行修改
+### 文件夹列表页
+![](images/4.png)
 
+### 看本模式
+![](images/5.png)
 
-# 可优化点
+### 文件夹&看本 二合一模式
+![](images/8.png)
 
-1. 前端优化。目前项目架构是`前后端不分离架构`，前端使用原始的html三件套。可以优化为前后端分离架构，基于Vue等开发框架，复用组件库，优化界面。
+## 2. 手机浏览器访问
 
-2. 后端优化。支持提供调用jmcomic功能的后端接口。
+### 登录页
+![](images/1.jpeg)
+
+### 文件夹列表页
+![](images/2.png)
+
+### 看本模式
+![](images/7.jpeg)
+
+### 局域网消息（方便手机和电脑互传消息）
+![](images/9.png)
 
 
 # 使用方式
@@ -70,7 +85,6 @@ pip install plugin_jm_server
 ```
 
 
-
 ## 2. 运行代码
 
 * **HTTP版**
@@ -135,31 +149,48 @@ op.wait_all_plugins_finish()
 ```
 
 
-# 效果图（文件浏览、整章看图）
-
-## 1. 电脑浏览器访问
-
-### 登录页
-![](images/3.png)
-
-### 文件夹列表页
-![](images/4.png)
-![](images/9.png)
-
-### 看本模式
-![](images/5.png)
+## 前端页面与功能介绍
+
+本项目提供了一套完整的 Web 前端界面，用于管理和浏览本地图片资源。主要包含以下三个核心页面及其功能：
+
+### 1. 登录页
+为了保护个人隐私，系统提供了简单的访问控制。
+*   **密码验证**：启动时可配置密码，访问时需校验通过。
+*   **设备自适应**：根据访问设备（手机/电脑）自动适配最佳的登录布局。
+
+### 2. 文件夹浏览页（主页）
+这是资源管理的核心入口，支持高效的文件查找与导航。目前最新版本采用了 SPA（单页应用）架构进行全面增强：
+*   **智能路径导航**：
+    *   **路径补全**：输入路径时自动联想下级文件夹，支持键盘上下键选择及回车跳转。
+    *   **层级跳转**：输入框支持“..”快速返回上一级，并提供“确认”按钮进行精准跳转。
+*   **可视化展示**：
+    *   **文件夹预览**：鼠标悬停在文件夹上时，会自动展示该文件夹内的首张图片作为封面预览。
+    *   **类型区分**：通过文件夹角标（图标）清晰区分普通文件夹与特殊资源文件夹。
+*   **辅助功能**：
+    *   **书签管理**：支持将常看目录加入左侧书签栏，方便下次快速访问。
+    *   **本地交互**：支持通过网页菜单直接打开服务器端对应的本地文件夹窗口（Explorer）。
+
+### 3. 图片阅读页（看本模式）
+专为漫画阅读优化的沉浸式浏览页面。
+*   **加载优化**：采用图片懒加载机制，流畅浏览含有数百张图片的大型章节，节省系统资源。
+*   **多端适配**：
+    *   **PC端**：适合大屏浏览，支持浮动工具栏进行页面跳转、全屏切换等。
+    *   **移动端**：适配触摸操作，提供更好的手机阅读体验。
+*   **阅读辅助**：
+    *   **浮动菜单**：提供“回到顶部”、“加载全部图片”及“在资源管理器打开”等便捷操作。
+    *   **键盘支持**：支持常用快捷键进行页面滚动和翻页。
+
+### 4. 局域网消息中心 (v0.2.2+ New)
+本项目最新版本引入了即时通讯与增强的局域网接入支持。
+*   **实时互动**：支持服务器与内网设备之间互发即时消息，采用暗色毛玻璃视觉风格。
+*   **全站通知**：后台实时轮询新消息，支持浏览器原生桌面通知及精美的网页侧边栏滑入提醒。
+*   **接入优化**：自动识别服务器在局域网内的真实物理 IP，主页提供一键复制功能。
+*   **非侵入式反馈**：全站移除 alert 阻塞弹窗，所有交互操作结果均通过通知条反馈。
 
-### 文件夹&看本 二合一模式
-![](images/8.png)
-
-## 2. 手机浏览器访问
-
-### 登录页
-![](images/1.jpeg)
+#  想法起源
 
-### 文件夹列表页
-![](images/2.png)
+想法起源：https://github.com/hect0x7/JMComic-Crawler-Python/issues/192
 
-### 看本模式
-![](images/7.jpeg)
+基于原项目：https://github.com/AiCorein/Flask-Files-Server
 
+为了方便修改，将原项目中的文件复制到本项目中，然后进行修改

plugin_jm_server-0.2.2/README.md

@@ -0,0 +1,160 @@
+# plugin-jm-server
+
+“离线版”禁漫天堂
+
+该项目会在本地起一个`文件服务器`，支持用浏览器查看文件夹内的图片，界面模仿禁漫的章节观看页面，并适配手机端。
+
+用浏览器的好处就是支持很多浏览器插件和脚本，例如：
+
+* 双页阅读插件：https://sleazyfork.org/zh-CN/scripts/374903-comicread
+
+# 效果图（文件浏览、整章看图）
+
+## 1. 电脑浏览器访问
+
+### 登录页
+![](images/3.png)
+
+### 文件夹列表页
+![](images/4.png)
+
+### 看本模式
+![](images/5.png)
+
+### 文件夹&看本 二合一模式
+![](images/8.png)
+
+## 2. 手机浏览器访问
+
+### 登录页
+![](images/1.jpeg)
+
+### 文件夹列表页
+![](images/2.png)
+
+### 看本模式
+![](images/7.jpeg)
+
+### 局域网消息（方便手机和电脑互传消息）
+![](images/9.png)
+
+
+# 使用方式
+
+
+## 1. pip安装
+
+```shell
+pip install plugin_jm_server
+```
+
+
+## 2. 运行代码
+
+* **HTTP版**
+
+```python
+from plugin_jm_server import *
+
+# http
+server = JmServer(
+    'D:/',
+    'password',
+)
+server.run(
+    host='0.0.0.0',
+    port=80,
+)
+```
+
+* **HTTPS版**
+
+```python
+from plugin_jm_server import *
+
+# https
+server = JmServer(
+    'D:/',
+    'password',
+)
+server.run(
+    host='0.0.0.0',
+    port=443,
+    ssl_context='adhoc',
+)
+```
+
+* 作为jmcomic的插件
+
+```yml
+# 配置文件
+plugins:
+  after_init: 
+#  after_album:
+    - plugin: jm_server
+      kwargs:
+        password: ''
+
+```
+
+```python
+# 代码
+from jmcomic import *
+
+op = create_option('op.yml')
+op.download_album(123)
+# 运行到这里，虽然主线程代码执行完毕，但程序不会退出，因为服务器线程还没有结束。
+# 控制台会输出提示信息如下（atexit时输出的）：
+# “主线程执行完毕，但插件jm_server的服务器线程仍运行中，可按下ctrl+c结束程序”
+# 此时需要你主动按下ctrl+c终止程序。
+
+# python 3.12 特别注意：需要插入下面这行代码，服务器才能继续处理请求
+op.wait_all_plugins_finish()
+```
+
+
+## 前端页面与功能介绍
+
+本项目提供了一套完整的 Web 前端界面，用于管理和浏览本地图片资源。主要包含以下三个核心页面及其功能：
+
+### 1. 登录页
+为了保护个人隐私，系统提供了简单的访问控制。
+*   **密码验证**：启动时可配置密码，访问时需校验通过。
+*   **设备自适应**：根据访问设备（手机/电脑）自动适配最佳的登录布局。
+
+### 2. 文件夹浏览页（主页）
+这是资源管理的核心入口，支持高效的文件查找与导航。目前最新版本采用了 SPA（单页应用）架构进行全面增强：
+*   **智能路径导航**：
+    *   **路径补全**：输入路径时自动联想下级文件夹，支持键盘上下键选择及回车跳转。
+    *   **层级跳转**：输入框支持“..”快速返回上一级，并提供“确认”按钮进行精准跳转。
+*   **可视化展示**：
+    *   **文件夹预览**：鼠标悬停在文件夹上时，会自动展示该文件夹内的首张图片作为封面预览。
+    *   **类型区分**：通过文件夹角标（图标）清晰区分普通文件夹与特殊资源文件夹。
+*   **辅助功能**：
+    *   **书签管理**：支持将常看目录加入左侧书签栏，方便下次快速访问。
+    *   **本地交互**：支持通过网页菜单直接打开服务器端对应的本地文件夹窗口（Explorer）。
+
+### 3. 图片阅读页（看本模式）
+专为漫画阅读优化的沉浸式浏览页面。
+*   **加载优化**：采用图片懒加载机制，流畅浏览含有数百张图片的大型章节，节省系统资源。
+*   **多端适配**：
+    *   **PC端**：适合大屏浏览，支持浮动工具栏进行页面跳转、全屏切换等。
+    *   **移动端**：适配触摸操作，提供更好的手机阅读体验。
+*   **阅读辅助**：
+    *   **浮动菜单**：提供“回到顶部”、“加载全部图片”及“在资源管理器打开”等便捷操作。
+    *   **键盘支持**：支持常用快捷键进行页面滚动和翻页。
+
+### 4. 局域网消息中心 (v0.2.2+ New)
+本项目最新版本引入了即时通讯与增强的局域网接入支持。
+*   **实时互动**：支持服务器与内网设备之间互发即时消息，采用暗色毛玻璃视觉风格。
+*   **全站通知**：后台实时轮询新消息，支持浏览器原生桌面通知及精美的网页侧边栏滑入提醒。
+*   **接入优化**：自动识别服务器在局域网内的真实物理 IP，主页提供一键复制功能。
+*   **非侵入式反馈**：全站移除 alert 阻塞弹窗，所有交互操作结果均通过通知条反馈。
+
+#  想法起源
+
+想法起源：https://github.com/hect0x7/JMComic-Crawler-Python/issues/192
+
+基于原项目：https://github.com/AiCorein/Flask-Files-Server
+
+为了方便修改，将原项目中的文件复制到本项目中，然后进行修改

plugin_jm_server-0.2.2/src/plugin_jm_server/__init__.py

@@ -0,0 +1,3 @@
+__version__ = '0.2.2'
+
+from .app import *

{plugin_jm_server-0.2.0 → plugin_jm_server-0.2.2}/src/plugin_jm_server/app.py

@@ -11,6 +11,8 @@ from flask import render_template, send_from_directory
 from flask import request, session, redirect, flash, jsonify
 
 from .files import FileManager
+from .message import MessageManager
+from .driver import get_lan_ip
 
 
 # noinspection PyMethodMayBeStatic
@@ -65,6 +67,9 @@ class JmServer:
             for k, v in env.items():
                 os.environ[k] = v
 
+        # 初始化消息管理器
+        self.message_manager = MessageManager()
+
     def __hook_jm_logging(self):
         import jmcomic
         def executor_log(topic: str, msg: str):
@@ -142,7 +147,9 @@ class JmServer:
                                data={
                                    'currentPath': path,
                                    'defaultPath': self.file_manager.default_path,
-                                   'drivers': self.file_manager.DRIVERS_LIST
+                                   'drivers': self.file_manager.DRIVERS_LIST,
+                                   'lan_ip': get_lan_ip(),
+                                   'port': self.extra.get('port', self.DEFAULT_PORT)
                                },
                                randomArg=self.url_random_arg())
 
@@ -187,6 +194,19 @@ class JmServer:
             'images': images
         })
 
+    def api_open_file(self):
+        """
+        [New] API: Open file/folder in Explorer
+        """
+        if not self.verify():
+            return abort(403)
+            
+        path = request.args.get('path', None)
+        if not path:
+           return jsonify({'error': 'Path required'}), 400
+           
+        return self.open_directory(path) or jsonify({'status': 'ok'})
+
     def jm_view(self):
         """
         以禁漫章节的模式观看指定文件夹下的图片
@@ -260,7 +280,9 @@ class JmServer:
                                    "files": self.file_manager.get_files_data(path),
                                    "drivers": self.file_manager.DRIVERS_LIST,
                                    "currentPath": path,
-                                   "defaultPath": self.file_manager.default_path
+                                   "defaultPath": self.file_manager.default_path,
+                                   "lan_ip": get_lan_ip(),
+                                   "port": self.extra.get('port', self.DEFAULT_PORT)
                                },
                                randomArg=self.url_random_arg())
 
@@ -393,6 +415,60 @@ class JmServer:
         subprocess.Popen(f'explorer /select,"{path}"')
         return ''
 
+    # ===== 消息功能 =====
+
+    def message_page(self):
+        """
+        消息页面（支持 PC/移动端自适应）
+        """
+        if not self.verify():
+            return redirect('/login')
+
+        return render_template(
+            self.url_format(self.mobile_check(), 'message.html'),
+            randomArg=self.url_random_arg()
+        )
+
+    def api_get_messages(self):
+        """
+        API: 获取消息列表（支持增量拉取）
+        """
+        if not self.verify():
+            return abort(403)
+
+        since_id = request.args.get('since_id', 0, type=int)
+        limit = request.args.get('limit', 50, type=int)
+
+        messages = self.message_manager.get_messages(since_id=since_id, limit=limit)
+        return jsonify({'messages': messages})
+
+    def api_send_message(self):
+        """
+        API: 发送消息
+        """
+        if not self.verify():
+            return abort(403)
+
+        data = request.get_json(silent=True)
+        if not data or not data.get('content'):
+            return jsonify({'error': '消息内容不能为空'}), 400
+
+        sender = data.get('sender', '').strip() or '匿名'
+        content = data.get('content', '').strip()
+        sender_ip = request.remote_addr or ''
+
+        # 判断是否为服务器本机发送
+        is_local = sender_ip in ('127.0.0.1', '::1', 'localhost')
+        if is_local and sender == '服务器':
+            msg = self.message_manager.send_server_message(content)
+        else:
+            msg = self.message_manager.send_message(sender, content, sender_ip)
+
+        if msg:
+            return jsonify({'status': 'ok', 'message': msg})
+        else:
+            return jsonify({'error': '发送失败'}), 400
+
     def register_routes(self):
         # 添加路由
         self.app.add_url_rule('/jm_view', 'jm_view', self.jm_view, methods=['GET'])
@@ -409,6 +485,12 @@ class JmServer:
         self.app.add_url_rule("/spa", 'spa_view', self.spa_view, methods=['GET'])
         self.app.add_url_rule("/api/list_files", 'api_list_files', self.api_list_files, methods=['GET'])
         self.app.add_url_rule("/api/album_images", 'api_album_images', self.api_album_images, methods=['GET'])
+        self.app.add_url_rule("/api/open_file", 'api_open_file', self.api_open_file, methods=['GET'])
+
+        # 消息功能路由
+        self.app.add_url_rule("/message", 'message_page', self.message_page, methods=['GET'])
+        self.app.add_url_rule("/api/messages", 'api_get_messages', self.api_get_messages, methods=['GET'])
+        self.app.add_url_rule("/api/messages", 'api_send_message', self.api_send_message, methods=['POST'])
 
     def run(self, **kwargs):
         kwargs.setdefault('port', self.DEFAULT_PORT)

plugin_jm_server-0.2.2/src/plugin_jm_server/driver.py

@@ -0,0 +1,88 @@
+import os
+import re
+
+
+def get_winDriver():
+    """
+    Windows操作系统下,返回全部驱动器卷标['C:\','D:\']
+    """
+    import psutil
+    # 返回驱动器卷标列表
+    driver_list = sorted([driver.device for driver in psutil.disk_partitions(True)])
+
+    i = 0
+    num = len(driver_list)
+    while num != 0:
+        # 重新格式化分隔符
+        driver_name = driver_list[i]
+        driver_name = driver_name.strip('\\')
+        driver_name += '/'
+
+        # 测试各驱动器是否可访问，目的是筛除未就绪驱动器，如空光驱
+        try:
+            os.listdir(driver_name)
+            driver_list[i] = driver_name
+            i += 1
+        except PermissionError as e:
+            del driver_list[i]
+            mobj = re.match(r'\[WinError (\d+)\]', str(e))
+            # ERROR_NOT_READY, ERROR_ACCESS_DENIED
+            if mobj is not None and mobj.group(1) not in {'21', '5'}:
+                print(f'Drive {driver_name} unexpectedly unavailable: {e}')
+        finally:
+            num -= 1
+
+    # 返回列表
+    return driver_list
+
+
+def get_lan_ip():
+    """
+    通过本地接口获取局域网 IP 地址（无需外部连接）
+    优先使用 psutil 扫描活动网卡
+    """
+    import socket
+    try:
+        import psutil
+        
+        # 获取所有网卡信息
+        addrs = psutil.net_if_addrs()
+        stats = psutil.net_if_stats()
+        
+        # 定义私有地址段前缀
+        private_prefixes = ('192.168.', '10.', '172.16.', '172.17.', '172.18.', '172.19.',
+                            '172.20.', '172.21.', '172.22.', '172.23.', '172.24.', '172.25.',
+                            '172.26.', '172.27.', '172.28.', '172.29.', '172.30.', '172.31.')
+
+        # 1. 优先寻找处于 up 状态且有私有 IP 的物理网卡
+        for interface, snics in addrs.items():
+            # 跳过禁用的网卡
+            if interface in stats and not stats[interface].isup:
+                continue
+            
+            for snic in snics:
+                # 必须是 IPv4
+                if snic.family == socket.AF_INET:
+                    ip = snic.address
+                    # 排除回环地址，且必须符合私有地址段
+                    if not ip.startswith('127.') and any(ip.startswith(prefix) for prefix in private_prefixes):
+                        return ip
+
+        # 2. 如果没找到私有地址，尝试获取主机名的 IP
+        host_ip = socket.gethostbyname(socket.gethostname())
+        if not host_ip.startswith('127.'):
+            return host_ip
+            
+    except Exception:
+        # 最后的保底兜底逻辑
+        try:
+            return socket.gethostbyname(socket.gethostname())
+        except:
+            pass
+            
+    return '127.0.0.1'
+
+
+if __name__ == "__main__":
+    paths = get_winDriver()
+    print(paths)

{plugin_jm_server-0.2.0 → plugin_jm_server-0.2.2}/src/plugin_jm_server/files.py

@@ -21,9 +21,8 @@ class FileManager:
             return ['/']
 
     def get_jm_view_images(self, path):
-        images_data = []
-
-        give_up_sort = False
+        sortable_images = []
+        unsortable_images = []
 
         for f in self.files_of_dir_safe(path):
             if not self.is_image_file(f):
@@ -32,20 +31,22 @@ class FileManager:
             name = common.of_file_name(f)
             try:
                 index = int(name[:name.index('.')])
+                sortable_images.append({
+                    'filename': name,
+                    'data_original': f'/view_file?path={f}',
+                    'index': index,
+                })
             except ValueError:
-                give_up_sort = True
-                index = None
-
-            images_data.append({
-                'filename': name,
-                'data_original': f'/view_file?path={f}',
-                'index': index,
-            })
+                unsortable_images.append({
+                    'filename': name,
+                    'data_original': f'/view_file?path={f}',
+                    'index': None,
+                })
 
-        if give_up_sort is False:
-            images_data.sort(key=lambda item: item['index'])
+        sortable_images.sort(key=lambda item: item['index'])
+        unsortable_images.sort(key=lambda item: item['filename'])
 
-        return images_data
+        return sortable_images + unsortable_images
 
     @staticmethod
     def is_image_file(filename):
@@ -92,10 +93,14 @@ class FileManager:
             target_path = self.get_target_path(file_path)
             return self.build_one_path_info(target_path, 'Link')
 
+        quoted_path = quote(file_path)
+        quoted_name = quote(name)
+
         return {
             "name": name,
             'path': file_path,
-            'href': f'/?path={file_path}' if the_type == 'dir' else f'./download_file/{name}',
+            'quoted_path': quoted_path,
+            'href': f'/?path={quoted_path}' if the_type == 'dir' else f'./download_file/{quoted_name}',
             "size": size,
             "ctime": time_str,
             "type": the_type,