界面优化

1.日志的中文字体改为微软雅黑
2.帮助文档按钮外边距调整到和日志窗左边距一致
3.扩大默认窗口大小，使得PyPI可以初始展示到一行
4.表单label改为垂直居中
5.设置tab页的“新”标签设置垂直居中，并且不能影响菜单栏的高度

README.md

@@ -2,18 +2,29 @@
 
 ## 开发环境
 
-目前只有 `pywebview` 一个依赖。
+安装 `pip-tools`
+
+```bash
+pip install pip-tools
+```
+
+安装依赖
+
+```bash
+pip-sync requirements.txt
+```
 
 ## 打包
 
 前端运行 `npm run build` 生成 `ui/dist`，之后安装 PyInstaller，运行
 
 ```bash
-pyinstaller -w --add-data "ui/dist:ui/dist" --add-data "launcher/sys_config/config_dist.yaml:launcher/sys_config" launcher.py
+pyinstaller -w --add-data "ui/dist:ui/dist" --add-data "launcher/sys_config/config_dist.json:launcher/sys_config" launcher.py
 ```
 
 在dist文件夹生成launcher文件夹
 
 ```bash
-tar -cf dist/launcher.tar dist/launcher
+cd dist
+py7zr c launcher.7z launcher
 ```

launcher.py

@@ -1,8 +1,8 @@
 import mimetypes
-import os
+import shutil
 from pathlib import Path
 
-from launcher.constants import upgrade_script_name
+from launcher.constants import update_tmp_folder
 from launcher.webview import start_webview
 
 mimetypes.add_type("text/html", ".html")
@@ -11,8 +11,8 @@ mimetypes.add_type("application/javascript", ".js")
 
 if __name__ == '__main__':
 
-    # 如果当前路径存在更新脚本，则删除
-    if Path(upgrade_script_name).exists():
-        os.remove(upgrade_script_name)
+    # 如果当前路径存在临时文件夹，则删除
+    if Path(update_tmp_folder).exists():
+        shutil.rmtree(update_tmp_folder)
 
     start_webview()

launcher/config/__init__.py

@@ -1,26 +1,15 @@
 import json
 import os
-
-import yaml
-from yamlcore import CoreDumper, CoreLoader
+from pathlib import Path
 
 from launcher.config.conf import Conf
-from pathlib import Path
 
 conf_path = Path(os.path.join(os.getcwd(), "conf.json"))
 
 
 def save_conf():
     with conf_path.open("w", encoding="utf8") as f:
-        json.dump(conf.model_dump(), f, ensure_ascii=False, indent=4)  # Use json.dump
-        # yaml.dump(
-        #     conf.model_dump(),
-        #     f,
-        #     Dumper=CoreDumper,
-        #     encoding="utf-8",
-        #     default_flow_style=False,
-        #     allow_unicode=True,
-        # )
+        json.dump(conf.model_dump(), f, ensure_ascii=False, indent=4)
 
 
 def load_conf():
@@ -30,8 +19,8 @@ def load_conf():
         conf = Conf()
         save_conf()
         return
-    with conf_path.open("r", encoding="utf-8") as f:
-        data = yaml.load(f, Loader=CoreLoader)
+    with conf_path.open("r", encoding="utf-8") as file:
+        data = json.load(file)
         if data is None:
             data = {}
         conf = Conf(**data)

launcher/config/conf.py

@@ -19,6 +19,8 @@ class Total(ConfModel):
     """整体"""
     # 所在页面
     page: str = "init"
+    # 是否已展示帮助文档
+    is_already_show_doc: bool = False
 
 
 class UpdatePart(ConfModel):

launcher/constants.py

@@ -4,6 +4,8 @@ constants.py
 该模块定义了应用程序中使用的各种常量。这些常量包括API URL和其他配置参数。
 """
 
+# 更新临时文件夹名
+update_tmp_folder = "download_tmp"
 # 更新脚本名
 upgrade_script_name = "upgrade.bat"
 
@@ -21,4 +23,3 @@ mirror_list = {
     "tuna": "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple",
     "sjtu": "https://mirror.sjtu.edu.cn/pypi/web/simple",
 }
-

launcher/file/download.py

@@ -5,7 +5,7 @@ import requests
 
 from launcher.file.extract import extract_7z_file
 from launcher.file.utils import format_size
-from launcher.webview.events import custom_event
+from launcher.webview.events import custom_event, LogType
 
 
 def download_file(download_name, download_url, destination_folder):
@@ -21,7 +21,7 @@ def download_file(download_name, download_url, destination_folder):
 
     filename = os.path.basename(download_url)
     download_path = os.path.join(destination_folder, filename)
-    custom_event(f"开始下载: {download_name}")
+    custom_event(LogType.info, f"开始下载: {download_name}")
 
     response = requests.get(download_url, stream=True)
     if response.status_code == 200:
@@ -52,8 +52,8 @@ def download_file(download_name, download_url, destination_folder):
                     formatted_total_size = format_size(total_size)
                     formatted_speed = format_size(download_speed) + "/s"
 
-                    custom_event(
-                        f"下载进度: {progress_percent:.2f}% ({formatted_downloaded_size}/{formatted_total_size}), 下载速度: {formatted_speed}")
+                    custom_event(LogType.info,
+                                 f"下载进度: {progress_percent:.2f}% ({formatted_downloaded_size}/{formatted_total_size}), 下载速度: {formatted_speed}")
                     last_update_time = current_time  # 更新上次更新时间
 
         end_time = time.time()
@@ -63,10 +63,10 @@ def download_file(download_name, download_url, destination_folder):
         formatted_total_elapsed_time = f"{total_elapsed_time:.2f} 秒"
         formatted_average_download_speed = format_size(average_download_speed) + "/s"
 
-        custom_event(
-            f"下载完成: {filename}, 耗时: {formatted_total_elapsed_time}, 下载速度: {formatted_average_download_speed}")
+        custom_event(LogType.info,
+                     f"下载完成: {filename}, 耗时: {formatted_total_elapsed_time}, 下载速度: {formatted_average_download_speed}")
     else:
-        custom_event(f"下载失败: {response.status_code}")
+        custom_event(LogType.error, f"下载失败: {response.status_code}")
         return False
 
     return True
@@ -84,7 +84,7 @@ def init_download(download_name, download_url, destination_folder):
     def download():
         target_folder = os.path.join(download_name)
         if os.path.exists(target_folder):
-            custom_event(f"{download_name} 文件夹已存在，跳过下载")
+            custom_event(LogType.info, f"{download_name} 文件夹已存在，跳过下载")
             return True
 
         filename = os.path.basename(download_url)

launcher/file/extract.py

@@ -5,7 +5,7 @@ from py7zr import py7zr
 from py7zr.callbacks import ExtractCallback
 
 from launcher.file.utils import format_size
-from launcher.webview.events import custom_event
+from launcher.webview.events import custom_event, LogType
 
 
 class MyExtractCallback(ExtractCallback):
@@ -24,7 +24,7 @@ class MyExtractCallback(ExtractCallback):
         self.total_size += int(wrote_bytes)
         current_time = time.time()
         if current_time - self.last_print_time >= 1.0:  # 至少每隔1秒输出一次
-            custom_event(f"已解压: {format_size(self.total_size)}")
+            custom_event(LogType.info, f"已解压: {format_size(self.total_size)}")
             self.last_print_time = current_time
 
     def report_postprocess(self):
@@ -49,7 +49,7 @@ def extract_7z_file(file_name, file_path, destination_folder, delete_after_extra
     if not os.path.exists(destination_folder):
         os.makedirs(destination_folder)
 
-    custom_event(f"开始解压文件: {file_name}")
+    custom_event(LogType.info, f"开始解压文件: {file_name}")
     try:
         start_time = time.time()
         with py7zr.SevenZipFile(file_path, mode='r') as z:
@@ -58,18 +58,17 @@ def extract_7z_file(file_name, file_path, destination_folder, delete_after_extra
         end_time = time.time()
         total_elapsed_time = end_time - start_time
         formatted_total_elapsed_time = f"{total_elapsed_time:.2f} 秒"
-        custom_event(
-            f"解压完成: {file_name}, 总大小: {format_size(callback.total_size)}, 耗时: {formatted_total_elapsed_time}")
+        custom_event(LogType.info,
+                     f"解压完成: {file_name}, 总大小: {format_size(callback.total_size)}, 耗时: {formatted_total_elapsed_time}")
     except Exception as e:
-        e.print_exc()
-        custom_event(f"解压失败: {str(e)}")
+        custom_event(LogType.error, f"解压失败: {repr(e)}")
         return False
 
     if delete_after_extract:
         try:
             os.remove(file_path)
-            custom_event(f"删除{file_path}成功")
+            custom_event(LogType.info, f"删除{file_path}成功")
         except OSError as e:
-            custom_event(f"删除{file_path}失败: {str(e)}")
+            custom_event(LogType.error, f"删除{file_path}失败: {repr(e)}")
 
     return True

launcher/file/utils.py

@@ -1,3 +1,6 @@
+import os
+
+
 def format_size(size_bytes):
     """格式化文件大小为人类可读的形式"""
     for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
@@ -5,3 +8,23 @@ def format_size(size_bytes):
             return f"{size_bytes:.2f} {unit}"
         size_bytes /= 1024
     return f"{size_bytes:.2f} PB"
+
+
+def ensure_directory_exists(directory):
+    """确保目录存在，如果不存在则创建"""
+    if not os.path.exists(directory):
+        os.makedirs(directory)
+
+
+def check_command_path(command, cwd=None):
+    """检查命令路径是否存在exe文件
+    :return 是否存在,命令exe文件全路径
+    """
+    command_path = command.split(" ")[0]
+    if command_path == "start":
+        return True, None
+    exec_command_path = os.getcwd()
+    if cwd:
+        exec_command_path = os.path.join(exec_command_path, cwd)
+    full_command_path = os.path.abspath(os.path.join(exec_command_path, command_path)) + ".exe"
+    return os.path.exists(full_command_path), full_command_path

launcher/log.py

@@ -1,5 +1,6 @@
 import io
 import logging
+import os
 import sys
 from logging.handlers import RotatingFileHandler
 
@@ -21,8 +22,9 @@ def setup_logger():
     console_handler.setLevel(log_level)
 
     # 文件输出
+    file_path = os.path.join(os.getcwd(), "launcher.log")
     file_handler = RotatingFileHandler(
-        "../launcher.log", maxBytes=5 * 1024 * 1024, backupCount=3, encoding='utf-8'
+        file_path, maxBytes=5 * 1024 * 1024, backupCount=3, encoding='utf-8'
     )
     file_handler.setLevel(logging.INFO)
 

launcher/sys_config/__init__.py

@@ -1,7 +1,6 @@
-import sys
+import json
 import os
-
-import yaml
+import sys
 
 
 class SysConfig:
@@ -14,6 +13,8 @@ class SysConfig:
     url: str
     # 日志输出级别
     log_level: str
+    # 是否开启ui调试
+    debug: bool
 
     def __init__(self):
         self.config = {}
@@ -26,13 +27,13 @@ class SysConfig:
             # 如果是打包后的可执行文件
             base_path = sys._MEIPASS
             config_subdir = 'launcher/sys_config'  # 添加子目录
-            config_filename = 'config_dist.yaml'
+            config_filename = 'config_dist.json'
         else:
             # logger.error("本地配置")
             # 如果是本地开发环境
             base_path = os.path.dirname(__file__)
             config_subdir = ''  # 本地开发环境不需要子目录
-            config_filename = 'config_local.yaml'
+            config_filename = 'config_local.json'
 
         config_path = os.path.join(base_path, config_subdir, config_filename)
         return config_path
@@ -40,13 +41,13 @@ class SysConfig:
     def load_config(self):
         try:
             with open(self.config_path, 'r', encoding='utf-8') as file:
-                self.config = yaml.safe_load(file)
+                self.config = json.load(file)
         except FileNotFoundError:
             pass
             # logger.error(f"配置文件未找到: {self.config_path}")
-        except Exception as e:
+        except Exception:
             pass
-            # logger.error(f"加载配置文件时出错: {str(e)}")
+            # logger.error(f"加载配置文件时出错: {repr(e)}")
 
     def get(self, key):
         return self.config.get(key)

launcher/sys_config/config_dist.json

@@ -0,0 +1,6 @@
+{
+  "version": "v0.5",
+  "url": "ui/dist/index.html",
+  "log_level": "ERROR",
+  "debug": false
+}

launcher/sys_config/config_dist.yaml

@@ -1,3 +0,0 @@
-version: "v0.3"
-url: "ui/dist/index.html"
-log_level: "ERROR"

launcher/sys_config/config_local.json

@@ -0,0 +1,6 @@
+{
+  "version": "dev",
+  "url": "http://localhost:5173/",
+  "log_level": "INFO",
+  "debug": true
+}

launcher/sys_config/config_local.yaml

@@ -1,3 +0,0 @@
-version: "dev"
-url: "http://localhost:5173/"
-log_level: "INFO"

launcher/webview/__init__.py

@@ -1,12 +1,13 @@
 import webview
 
-from launcher.webview.api import Api
 from launcher.sys_config import sys_config
+from launcher.webview.api import Api
 
 window = None
 
 
 def start_webview():
     global window
-    window = webview.create_window(f"mower-ng launcher {sys_config.get('version')}", sys_config.get('url'), js_api=Api())
-    webview.start()
+    window = webview.create_window(f"mower-ng launcher {sys_config.get('version')}", sys_config.get('url'),
+                                   js_api=Api(), width=850, height=600)
+    webview.start(debug=sys_config.get('debug'))

launcher/webview/api.py

@@ -7,16 +7,17 @@ from pathlib import Path
 from shutil import rmtree
 from subprocess import Popen
 
-import chardet
 import requests
 
 from launcher import config
 from launcher.constants import download_git_url, download_python_url, get_new_version_url, upgrade_script_name, \
     mirror_list
 from launcher.file.download import init_download, download_file
+from launcher.file.extract import extract_7z_file
+from launcher.file.utils import ensure_directory_exists, check_command_path
 from launcher.log import logger
 from launcher.sys_config import sys_config
-from launcher.webview.events import custom_event
+from launcher.webview.events import custom_event, LogType
 
 command_list = {
     "download_git": lambda: init_download("git", download_git_url, os.getcwd()),
@@ -27,27 +28,43 @@ command_list = {
     "fetch": lambda: f"..\\git\\bin\\git fetch origin {config.conf.branch} --progress",
     "switch": lambda: f"..\\git\\bin\\git -c lfs.concurrenttransfers=100 switch -f {config.conf.branch} --progress",
     "reset": lambda: f"..\\git\\bin\\git -c lfs.concurrenttransfers=200 reset --hard origin/{config.conf.branch}",
-    "pip_install": lambda: f"..\\python\\Scripts\\pip install --no-cache-dir -i {mirror_list[config.conf.mirror]} -r requirements.txt --no-warn-script-location",
+    "pip_tools_install": lambda: f"..\\python\\Scripts\\pip install --no-cache-dir -i {mirror_list[config.conf.mirror]} pip-tools --no-warn-script-location",
+    "pip_sync": lambda: f"..\\python\\Scripts\\pip-sync -i {mirror_list[config.conf.mirror]} requirements.txt",
     "webview": "start ..\\python\\pythonw webview_ui.py",
     "manager": "start ..\\python\\pythonw manager.py",
 }
 
 
-def detect_encoding(stream):
-    # 读取一部分数据来检测编码
-    raw_data = stream.read(4096)
-    result = chardet.detect(raw_data)
-    stream.seek(0)  # 将流指针重置到开头
-    return result['encoding']
+def parse_stderr(stderr_output):
+    error_keywords = {
+        "fatal: destination path 'mower-ng' already exists and is not an empty directory.": "mower-ng文件夹已存在并且非空。",
+        "index.lock': File exists": "上一个git命令正在执行，请等待执行结束或在任务管理器中杀掉git进程，并确保上方提示的index.lock文件删除后再次运行。",
+        "Could not resolve host": "网络出现错误，请检查网络是否通畅。",
+        "ReadTimeoutError": "网络连接超时，请检查网络连接或尝试更换镜像源。",
+        "No space left on device": "磁盘空间不足。",
+    }
+    for keyword, message in error_keywords.items():
+        if keyword in stderr_output:
+            return message
+    return "未定义的错误"
 
 
-def read_stream(stream, log_func):
-    detected_encoding = detect_encoding(stream)
+def read_stream(stream, log_type, output_list=None):
+    def process_lines(text_io):
+        for line in iter(text_io.readline, ''):
+            text = line.rstrip('\n').strip()
+            custom_event(log_type, text)
+            if output_list is not None:
+                output_list.append(text)
+
+    detected_encoding = 'utf-8'
     text_io = io.TextIOWrapper(stream, encoding=detected_encoding, errors='replace')
     try:
-        for line in iter(text_io.readline, ''):
-            text = line.rstrip('\n')
-            custom_event(text.strip() + "\n")
+        process_lines(text_io)
+    except UnicodeDecodeError:
+        stream.seek(0)  # 重新将流指针重置到开头
+        text_io = io.TextIOWrapper(stream, encoding='gbk', errors='replace')
+        process_lines(text_io)
     finally:
         text_io.close()
 
@@ -74,25 +91,33 @@ class Api:
     # 更新启动器本身
     def update_self(self, download_url):
         logger.info(f"开始更新启动器 {download_url}")
-        # 下载压缩包的全路径
         file_name = os.path.basename(download_url)
+        file_name = "launcher.7z"
         current_path = os.getcwd()
-        if not download_file("launcher", download_url, current_path):
+        download_tmp_folder = os.path.join(current_path, "download_tmp")
+        # 确保 download_tmp 文件夹存在
+        ensure_directory_exists(download_tmp_folder)
+        if not download_file("launcher", download_url, download_tmp_folder):
             return "下载新版本失败"
 
-        download_path = os.path.join(current_path, file_name)
-        script_path = os.path.join(os.getcwd(), upgrade_script_name)
-        folder_path = os.path.join(os.getcwd(), "_internal")
-        exe_path = os.path.join(os.getcwd(), "launcher.exe")
+        download_path = os.path.join(download_tmp_folder, file_name)
+        if not extract_7z_file("launcher", download_path, download_tmp_folder, True):
+            return "解压新版本失败"
+
+        exe_path = os.path.join(current_path, "launcher.exe")
+        folder_path = os.path.join(current_path, "_internal")
+        new_exe_path = os.path.join(download_tmp_folder, "launcher", "launcher.exe")
+        new_folder_path = os.path.join(download_tmp_folder, "launcher", "_internal")
+        script_path = os.path.join(download_tmp_folder, upgrade_script_name)
         with open(script_path, "w") as b:
             temp_list = "@echo off\n"
             temp_list += "timeout /t 3 /nobreak\n"  # 等待进程退出
             temp_list += f"rmdir {folder_path}\n"  # 删除_internal
             temp_list += f"del {exe_path}\n"  # 删除exe
-            temp_list += f"tar -xf {download_path} -C ..\n"  # 解压压缩包
-            temp_list += "timeout /t 1 /nobreak\n"  # 等待解压
+            temp_list += f"xcopy /e /i /y {new_folder_path} {folder_path}\n"
+            temp_list += f"move {new_exe_path} {exe_path}\n"
+            temp_list += "timeout /t 1 /nobreak\n"  # 等待操作完成
             temp_list += f"start {exe_path}\n"  # 启动新程序
-            temp_list += f"del {download_path}\n"  # 删除压缩包
             temp_list += "exit"
             b.write(temp_list)
         # 不显示cmd窗口
@@ -100,18 +125,24 @@ class Api:
         os._exit(0)
 
     def rm_site_packages(self):
-        site_packages_path = Path("./python/Lib/site-packages")
-        if site_packages_path.exists():
-            rmtree(site_packages_path)
-            return "site-packages目录移除成功"
-        return "python\\Lib\\site-packages目录不存在"
+        try:
+            site_packages_path = Path("./python/Lib/site-packages")
+            if site_packages_path.exists():
+                rmtree(site_packages_path)
+                return "site-packages目录移除成功"
+            return "python\\Lib\\site-packages目录不存在"
+        except Exception as e:
+            return repr(e)
 
     def rm_python_scripts(self):
-        python_scripts_path = Path("./python/Scripts")
-        if python_scripts_path.exists():
-            rmtree(python_scripts_path)
-            return "Scripts目录移除成功"
-        return "python\\Scripts目录不存在"
+        try:
+            python_scripts_path = Path("./python/Scripts")
+            if python_scripts_path.exists():
+                rmtree(python_scripts_path)
+                return "Scripts目录移除成功"
+            return "python\\Scripts目录不存在"
+        except Exception as e:
+            return repr(e)
 
     def run(self, command, cwd=None):
         command = command_list[command]
@@ -119,23 +150,37 @@ class Api:
             command = command()
             if callable(command):
                 return "success" if command() else "failed"
-        custom_event(command + "\n")
+        if cwd is not None:
+            custom_event(LogType.info, f"命令执行目录：{cwd}")
+        custom_event(LogType.execute_command, command)
+        # 执行命令前先判断命令路径是否存在
+        exist, command_path = check_command_path(command, cwd)
+        if not exist:
+            custom_event(LogType.error, f"命令路径不存在：{command_path} 请尝试依赖修复并重新初始化。")
+            return "failed"
         try:
+            stdout_stderr = []
             with subprocess.Popen(
                     command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True, cwd=cwd, bufsize=0,
                     universal_newlines=False
             ) as p:
-                stdout_thread = threading.Thread(target=read_stream, args=(p.stdout, logger.info))
-                stderr_thread = threading.Thread(target=read_stream, args=(p.stderr, logger.info))
+                stdout_thread = threading.Thread(target=read_stream, args=(p.stdout, LogType.command_out))
+                stderr_thread = threading.Thread(target=read_stream,
+                                                 args=(p.stderr, LogType.command_out, stdout_stderr))
 
                 stdout_thread.start()
                 stderr_thread.start()
 
                 stdout_thread.join()
                 stderr_thread.join()
+
             if p.returncode == 0:
                 return "success"
+            else:
+                error_message = parse_stderr("\n".join(stdout_stderr))
+                custom_event(LogType.error, f"命令执行失败，{error_message}")
+                return "failed"
         except Exception as e:
             logger.exception(e)
-            custom_event(str(e))
-        return "failed"
+            custom_event(LogType.error, str(e))
+            return "failed"

launcher/webview/events.py

@@ -1,11 +1,32 @@
 import json
+from enum import Enum
 
 import launcher
 from launcher.log import logger
 
 
-def custom_event(data):
-    logger.info(data)
+class LogType(Enum):
+    info = "信息"
+    error = "错误"
+    execute_command = "执行命令"
+    command_out = "命令输出"
+
+
+def custom_event(log_type, data):
+    data = f"[{log_type.value}] {data}"
+
+    match log_type:
+        case LogType.info:
+            logger.info(data)
+        case LogType.error:
+            logger.error(data)
+        case LogType.execute_command:
+            logger.info(data)
+        case LogType.command_out:
+            logger.info(data)
+        case _:
+            logger.info(data)
+
     data = json.dumps({"log": data + "\n"})
     js = f"var event = new CustomEvent('log', {{detail: {data}}}); window.dispatchEvent(event);"
     launcher.webview.window.evaluate_js(js)

requirements.in

@@ -0,0 +1,5 @@
+pywebview==5.1
+requests==2.32.3
+py7zr==0.22.0
+pydantic==2.10.3
+pyinstaller==6.11.1

requirements.txt

@@ -0,0 +1,80 @@
+#
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
+#
+#    pip-compile requirements.in
+#
+--index-url https://pypi.tuna.tsinghua.edu.cn/simple
+
+altgraph==0.17.4
+    # via pyinstaller
+annotated-types==0.7.0
+    # via pydantic
+bottle==0.13.2
+    # via pywebview
+brotli==1.1.0
+    # via py7zr
+certifi==2024.12.14
+    # via requests
+cffi==1.17.1
+    # via clr-loader
+charset-normalizer==3.4.0
+    # via requests
+clr-loader==0.2.7.post0
+    # via pythonnet
+idna==3.10
+    # via requests
+inflate64==1.0.0
+    # via py7zr
+multivolumefile==0.2.3
+    # via py7zr
+packaging==24.2
+    # via
+    #   pyinstaller
+    #   pyinstaller-hooks-contrib
+pefile==2023.2.7
+    # via pyinstaller
+proxy-tools==0.1.0
+    # via pywebview
+psutil==6.1.0
+    # via py7zr
+py7zr==0.22.0
+    # via -r requirements.in
+pybcj==1.0.2
+    # via py7zr
+pycparser==2.22
+    # via cffi
+pycryptodomex==3.21.0
+    # via py7zr
+pydantic==2.10.3
+    # via -r requirements.in
+pydantic-core==2.27.1
+    # via pydantic
+pyinstaller==6.11.1
+    # via -r requirements.in
+pyinstaller-hooks-contrib==2024.11
+    # via pyinstaller
+pyppmd==1.1.0
+    # via py7zr
+pythonnet==3.0.5
+    # via pywebview
+pywebview==5.1
+    # via -r requirements.in
+pywin32-ctypes==0.2.3
+    # via pyinstaller
+pyzstd==0.16.2
+    # via py7zr
+requests==2.32.3
+    # via -r requirements.in
+texttable==1.7.0
+    # via py7zr
+typing-extensions==4.12.2
+    # via
+    #   pydantic
+    #   pydantic-core
+    #   pywebview
+urllib3==2.2.3
+    # via requests
+
+# The following packages are considered to be unsafe in a requirements file:
+# setuptools

ui/package-lock.json

@@ -8,6 +8,7 @@
       "name": "ui",
       "version": "0.0.0",
       "dependencies": {
+        "highlight.js": "^11.11.1",
         "pinia": "^2.2.8",
         "vue": "^3.5.11"
       },
@@ -2075,11 +2076,9 @@
       }
     },
     "node_modules/highlight.js": {
-      "version": "11.10.0",
-      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-11.10.0.tgz",
-      "integrity": "sha512-SYVnVFswQER+zu1laSya563s+F8VDGt7o35d4utbamowvUNLLMovFqwCLSocpZTz3MgaSRA1IbqRWZv97dtErQ==",
-      "dev": true,
-      "license": "BSD-3-Clause",
+      "version": "11.11.1",
+      "resolved": "https://registry.npmmirror.com/highlight.js/-/highlight.js-11.11.1.tgz",
+      "integrity": "sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w==",
       "engines": {
         "node": ">=12.0.0"
       }

ui/package.json

@@ -11,6 +11,7 @@
     "format": "prettier --write src/"
   },
   "dependencies": {
+    "highlight.js": "^11.11.1",
     "pinia": "^2.2.8",
     "vue": "^3.5.11"
   },

ui/src/App.vue

@@ -12,6 +12,10 @@ const loading = ref(true)
 const page = ref(null)
 let conf
 
+function show_doc() {
+  window.open('https://hedgedoc.zhaozuohong.vip/s/LfSzK2n0K', '_blank')
+}
+
 async function init_version() {
   version.value = await pywebview.api.get_version()
   new_version.value = await pywebview.api.get_new_version()
@@ -22,8 +26,12 @@ async function init_version() {
 async function initialize_config() {
   await configStore.load_config()
   conf = configStore.config
-  await init_version()
   loading.value = false
+  if (!conf.is_already_show_doc) {
+    show_doc()
+    conf.is_already_show_doc = true
+  }
+  await init_version()
 }
 
 const log = ref('')
@@ -81,6 +89,7 @@ provide('new_version', new_version)
         class="container"
         v-model:value="conf.page"
         @update:value="set_page"
+        justify-content="center"
       >
         <n-tab-pane :disabled="running" name="init" tab="初始化"><init /></n-tab-pane>
         <n-tab-pane :disabled="running" name="update" tab="更新代码"><update /></n-tab-pane>
@@ -88,13 +97,18 @@ provide('new_version', new_version)
         <n-tab-pane :disabled="running" name="fix" tab="依赖修复"><fix /></n-tab-pane>
         <n-tab-pane :disabled="running" name="settings">
           <template #tab>
-            <n-space :wrap="false">
-              设置
-              <n-tag v-if="update_able" round type="success">新</n-tag>
-            </n-space>
+            <div class="tab-content">
+              <span>设置</span>
+              <n-tag v-if="update_able" class="tag" round type="success">新</n-tag>
+            </div>
           </template>
           <settings />
         </n-tab-pane>
+        <template #suffix>
+          <div class="suffix-container">
+            <n-button type="primary" secondary size="small" @click="show_doc">帮助文档</n-button>
+          </div>
+        </template>
       </n-tabs>
     </n-notification-provider>
     <n-global-style />
@@ -106,4 +120,17 @@ provide('new_version', new_version)
   width: 100vw;
   height: 100vh;
 }
+.suffix-container {
+  margin: 0 4px 6px 4px;
+}
+.tab-content {
+  position: relative;
+}
+.tag {
+  margin-left: 4px;
+  position: absolute;
+  top: 50%;
+  left: 100%;
+  transform: translateY(-50%);
+}
 </style>

ui/src/components/LogComponent.vue

@@ -1,14 +1,57 @@
 <script setup>
 import { darkTheme } from 'naive-ui'
+import hljs from 'highlight.js/lib/core'
 
 const log = inject('log')
 const log_ele = inject('log_ele')
+
+const chinesePattern = {
+  className: 'chinese',
+  begin: /[\u4e00-\u9fa5]+/
+}
+
+hljs.registerLanguage('naive-log', () => ({
+  contains: [
+    {
+      className: 'info',
+      begin: /^\[信息\]/,
+      end: /$/,
+      returnBegin: true,
+      returnEnd: true,
+      contains: [chinesePattern]
+    },
+    {
+      className: 'error',
+      begin: /^\[错误\]/,
+      end: /$/,
+      returnBegin: true,
+      returnEnd: true,
+      contains: [chinesePattern]
+    },
+    {
+      className: 'execute_command',
+      begin: /^\[执行命令\]/,
+      end: /$/,
+      returnBegin: true,
+      returnEnd: true,
+      contains: [chinesePattern]
+    },
+    {
+      className: 'command_out',
+      begin: /^\[命令输出\]/,
+      end: /$/,
+      returnBegin: true,
+      returnEnd: true,
+      contains: [chinesePattern]
+    }
+  ]
+}))
 </script>
 
 <template>
-  <n-config-provider :theme="darkTheme" class="provider">
+  <n-config-provider :theme="darkTheme" class="provider" :hljs="hljs">
     <n-card class="full" content-style="height: 100%">
-      <n-log :log="log" class="full" ref="log_ele" />
+      <n-log :log="log" class="full selectable-log" ref="log_ele" language="naive-log" />
     </n-card>
   </n-config-provider>
 </template>
@@ -23,10 +66,8 @@ const log_ele = inject('log_ele')
   height: 100% !important;
   box-sizing: border-box;
 }
-</style>
 
-<style>
-pre {
-  word-break: break-all !important;
+.selectable-log {
+  user-select: text;
 }
 </style>

ui/src/main.js

@@ -1,5 +1,6 @@
 import 'vfonts/Lato.css'
 import 'vfonts/FiraCode.css'
+import './styles/global.css'
 
 import { createApp } from 'vue'
 import { createPinia } from 'pinia'

ui/src/pages/Settings.vue

@@ -1,5 +1,6 @@
 <script setup>
 import { SyncCircle } from '@vicons/ionicons5'
+import { form_item_label_style } from '@/styles/styles.js'
 
 const notification = useNotification()
 
@@ -57,7 +58,7 @@ async function check_update() {
 <template>
   <n-flex vertical style="gap: 16px; height: 100%; padding: 16px; box-sizing: border-box">
     <n-form label-placement="left" :show-feedback="false" label-width="auto" label-align="left">
-      <n-form-item label="版本">
+      <n-form-item label="版本" :label-style="form_item_label_style">
         <n-space align="center">
           {{ version }}
           <n-button

ui/src/pages/Update.vue

@@ -1,5 +1,6 @@
 <script setup>
 import { useConfigStore } from '@/stores/config.js'
+import { form_item_label_style } from '@/styles/styles.js'
 
 const conf = useConfigStore().config
 const branch = ref(null)
@@ -13,7 +14,7 @@ const steps = computed(() => [
   },
   {
     title: '安装依赖',
-    command: ['pip_install'],
+    command: ['pip_tools_install', 'pip_sync'],
     cwd: 'mower-ng'
   }
 ])
@@ -27,7 +28,7 @@ provide('current_state', current_state)
 <template>
   <n-flex vertical style="gap: 16px; height: 100%; padding: 16px; box-sizing: border-box">
     <n-form label-placement="left" :show-feedback="false" label-width="auto" label-align="left">
-      <n-form-item label="mower-ng 代码分支">
+      <n-form-item label="mower-ng 代码分支" :label-style="form_item_label_style">
         <n-radio-group v-model:value="conf.branch">
           <n-flex>
             <n-radio value="fast">测试版</n-radio>
@@ -35,7 +36,7 @@ provide('current_state', current_state)
           </n-flex>
         </n-radio-group>
       </n-form-item>
-      <n-form-item label="PyPI 仓库镜像">
+      <n-form-item label="PyPI 仓库镜像" :label-style="form_item_label_style">
         <n-radio-group v-model:value="conf.mirror">
           <n-flex>
             <n-radio value="pypi">PyPI</n-radio>

ui/src/stores/config.js

@@ -6,6 +6,7 @@ export const useConfigStore = defineStore('config', () => {
       this.page = conf.page
       this.branch = conf.branch
       this.mirror = conf.mirror
+      this.is_already_show_doc = conf.is_already_show_doc
     }
   }
 

ui/src/styles/global.css

@@ -0,0 +1,43 @@
+/* src/assets/styles/global.css */
+
+/* 日志样式 */
+.n-code pre {
+  word-break: break-all !important;
+}
+
+.n-code pre .hljs-info {
+  color: #33ff33;
+}
+
+.n-code pre .hljs-error {
+  color: #ff0000;
+}
+
+.n-code pre .hljs-execute_command {
+  color: #edaf1f;
+}
+
+.n-code pre .hljs-command_out {
+  color: #ffffff;
+}
+
+.n-code pre .hljs-chinese {
+  font-family: '微软雅黑', sans-serif;
+}
+
+/* 确保 chinese 类在所有父级类下生效 */
+.n-code pre .hljs-info .hljs-chinese {
+  color: #33ff33;
+}
+
+.n-code pre .hljs-error .hljs-chinese {
+  color: #ff0000;
+}
+
+.n-code pre .hljs-execute_command .hljs-chinese {
+  color: #edaf1f;
+}
+
+.n-code pre .hljs-command_out .hljs-chinese {
+  color: #ffffff;
+}

ui/src/styles/styles.js

@@ -0,0 +1,3 @@
+export const form_item_label_style = {
+  alignSelf: 'center'
+}