refactor(desktop): split backend runtime helpers and cleanup logic

Author: zouyonghe

astrbot/core/star/star_manager.py

@@ -40,6 +40,13 @@
         logger.warning("未安装 watchfiles，无法实现插件的热重载。")
 
 
+class PluginDependencyInstallError(Exception):
+    def __init__(self, plugin_name: str, requirements_path: str, message: str) -> None:
+        super().__init__(message)
+        self.plugin_name = plugin_name
+        self.requirements_path = requirements_path
+
+
 class PluginManager:
     def __init__(self, context: Context, config: AstrBotConfig) -> None:
         self.updator = PluginUpdator()
@@ -195,9 +202,11 @@ async def _check_plugin_dept_update(
                 except Exception as e:
                     logger.error(f"更新插件 {p} 的依赖失败。Code: {e!s}")
                     if target_plugin:
-                        raise Exception(
-                            "插件依赖安装失败，请检查插件 requirements.txt "
-                            "中的依赖版本或构建环境。"
+                        raise PluginDependencyInstallError(
+                            plugin_name=p,
+                            requirements_path=pth,
+                            message="插件依赖安装失败，请检查插件 requirements.txt "
+                            "中的依赖版本或构建环境。",
                         ) from e
         return True
 

desktop/README.md

@@ -81,7 +81,7 @@ desktop/resources/backend/
   app/                   # AstrBot backend source snapshot used in packaged mode
   python/                # Bundled CPython runtime directory
   launch_backend.py      # Launcher executed by Electron
-  runtime-manifest.json  # Runtime metadata (python path, entrypoint, app path)
+  runtime-manifest.json  # Runtime metadata (Python path, entrypoint, app path)
 ```
 
 Electron reads `runtime-manifest.json` and starts backend with: