feat：支持vue原生插件页面

app/api/endpoints/plugin.py

@@ -1,6 +1,10 @@
-from typing import Annotated, Any, List, Optional
+import inspect
+import mimetypes
+from typing import Annotated, Any, List, Optional, Callable, Tuple
 
-from fastapi import APIRouter, Depends, Header
+from fastapi import APIRouter, Depends, Header, HTTPException
+from starlette import status
+from starlette.responses import FileResponse
 
 from app import schemas
 from app.command import Command
@@ -16,7 +20,6 @@ from app.scheduler import Scheduler
 from app.schemas.types import SystemConfigKey
 
 PROTECTED_ROUTES = {"/api/v1/openapi.json", "/docs", "/docs/oauth2-redirect", "/redoc"}
-
 PLUGIN_PREFIX = f"{settings.API_V1_STR}/plugin"
 
 router = APIRouter()
@@ -222,21 +225,71 @@ def install(plugin_id: str,
 def plugin_form(plugin_id: str,
                 _: schemas.TokenPayload = Depends(get_current_active_superuser)) -> dict:
     """
-    根据插件ID获取插件配置表单
+    根据插件ID获取插件配置表单或Vue组件URL
     """
-    conf, model = PluginManager().get_plugin_form(plugin_id)
-    return {
-        "conf": conf,
-        "model": model
-    }
+    plugin_instance = PluginManager().running_plugins.get(plugin_id)
+    if not plugin_instance:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"插件 {plugin_id} 不存在或未加载")
+
+    # 渲染模式
+    render_mode = plugin_instance.get_render_mode()
+    if render_mode == "vue":
+        # Vue模式
+        try:
+            vue_component_file, model = plugin_instance.get_form_file()
+            return {
+                "render_mode": "vue",
+                "component_url": f"/plugin/file/{plugin_id.lower()}/{vue_component_file}",
+                "model": PluginManager().get_plugin_config(plugin_id) or model
+            }
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_form_file 出错: {str(e)}")
+    else:
+        # Vuetify模式
+        try:
+            conf, model = plugin_instance.get_form()
+            return {
+                "render_mode": "vuetify",
+                "conf": conf,
+                "model": PluginManager().get_plugin_config(plugin_id) or model
+            }
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_form 出错: {str(e)}")
+    return {}
 
 
 @router.get("/page/{plugin_id}", summary="获取插件数据页面")
-def plugin_page(plugin_id: str, _: schemas.TokenPayload = Depends(get_current_active_superuser)) -> List[dict]:
+def plugin_page(plugin_id: str, _: schemas.TokenPayload = Depends(get_current_active_superuser)) -> dict:
     """
     根据插件ID获取插件数据页面
     """
-    return PluginManager().get_plugin_page(plugin_id)
+    plugin_instance = PluginManager().running_plugins.get(plugin_id)
+    if not plugin_instance:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"插件 {plugin_id} 不存在或未加载")
+
+    # 渲染模式
+    render_mode = plugin_instance.get_render_mode()
+    if render_mode == "vue":
+        # Vue模式
+        try:
+            vue_component_file = plugin_instance.get_page_file()
+            return {
+                "render_mode": "vue",
+                "component_url": f"/plugin/file/{plugin_id.lower()}/{vue_component_file}",
+            }
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_page_file 出错: {str(e)}")
+
+    else:
+        try:
+            page = plugin_instance.get_page()
+            return {
+                "render_mode": "vuetify",
+                "page": page or []
+            }
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_page 出错: {str(e)}")
+    return {}
 
 
 @router.get("/dashboard/meta", summary="获取所有插件仪表板元信息")
@@ -247,22 +300,73 @@ def plugin_dashboard_meta(_: schemas.TokenPayload = Depends(verify_token)) -> Li
     return PluginManager().get_plugin_dashboard_meta()
 
 
+@router.get("/dashboard/{plugin_id}/{key}", summary="获取插件仪表板配置")
+def plugin_dashboard_by_key(plugin_id: str, key: str, user_agent: Annotated[str | None, Header()] = None,
+                     _: schemas.TokenPayload = Depends(verify_token)) -> Optional[schemas.PluginDashboard]:
+    """
+    根据插件ID获取插件仪表板
+    """
+
+    def __get_params_count(func: Callable):
+        """
+        获取函数的参数信息
+        """
+        signature = inspect.signature(func)
+        return len(signature.parameters)
+
+    # 获取插件实例
+    plugin_instance = PluginManager().running_plugins.get(plugin_id)
+    if not plugin_instance:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"插件 {plugin_id} 不存在或未加载")
+        # 渲染模式
+    render_mode = plugin_instance.get_render_mode()
+    if render_mode == "vue":
+        # Vue模式
+        try:
+            cols, attrs, vue_component_file = plugin_instance.get_dashboard_file(key=key, user_agent=user_agent)
+            return schemas.PluginDashboard(
+                id=plugin_id,
+                name=plugin_instance.plugin_name,
+                key=key,
+                render_mode=render_mode,
+                cols=cols or {},
+                attrs=attrs or {},
+                component_url=f"/plugin/file/{plugin_id.lower()}/{vue_component_file}",
+            )
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_dashboard_file 出错: {str(e)}")
+    else:
+        try:
+            # 检查方法的参数个数
+            params_count = __get_params_count(plugin_instance.get_dashboard)
+            if params_count > 1:
+                dashboard: Tuple = plugin_instance.get_dashboard(key=key, user_agent=user_agent)
+            elif params_count > 0:
+                dashboard: Tuple = plugin_instance.get_dashboard(user_agent=user_agent)
+            else:
+                dashboard: Tuple = plugin_instance.get_dashboard()
+            if dashboard:
+                cols, attrs, elements = dashboard
+                return schemas.PluginDashboard(
+                    id=plugin_id,
+                    name=plugin_instance.plugin_name,
+                    key=key,
+                    render_mode="vuetify",
+                    cols=cols or {},
+                    elements=elements,
+                    attrs=attrs or {}
+                )
+        except Exception as e:
+            logger.error(f"插件 {plugin_id} 调用方法 get_dashboard 出错: {str(e)}")
+
+
 @router.get("/dashboard/{plugin_id}", summary="获取插件仪表板配置")
 def plugin_dashboard(plugin_id: str, user_agent: Annotated[str | None, Header()] = None,
                      _: schemas.TokenPayload = Depends(verify_token)) -> schemas.PluginDashboard:
     """
     根据插件ID获取插件仪表板
     """
-    return PluginManager().get_plugin_dashboard(plugin_id, user_agent=user_agent)
-
-
-@router.get("/dashboard/{plugin_id}/{key}", summary="获取插件仪表板配置")
-def plugin_dashboard(plugin_id: str, key: str, user_agent: Annotated[str | None, Header()] = None,
-                     _: schemas.TokenPayload = Depends(verify_token)) -> schemas.PluginDashboard:
-    """
-    根据插件ID获取插件仪表板
-    """
-    return PluginManager().get_plugin_dashboard(plugin_id, key=key, user_agent=user_agent)
+    return plugin_dashboard_by_key(plugin_id, "", user_agent)
 
 
 @router.get("/reset/{plugin_id}", summary="重置插件配置及数据", response_model=schemas.Response)
@@ -286,6 +390,41 @@ def reset_plugin(plugin_id: str,
     return schemas.Response(success=True)
 
 
+@app.get("/file/{filepath:path}",  summary="获取插件静态文件")
+async def plugin_static_file(plugin_id: str, filepath: str, _: schemas.TokenPayload = Depends(verify_token)):
+    """
+    获取插件静态文件
+    """
+    # 基础安全检查
+    if ".." in filepath or ".." in filepath:
+        logger.warning(f"Static File API: Path traversal attempt detected: {plugin_id}/{filepath}")
+        raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="Forbidden")
+
+    plugin_base_dir = settings.ROOT_PATH / "app" / "plugins" / plugin_id.lower()
+    plugin_file_path = plugin_base_dir / filepath
+    if not plugin_file_path.exists():
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"{plugin_file_path} 不存在")
+    if not plugin_file_path.is_file():
+        raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail=f"{plugin_file_path} 不是文件")
+
+    # 判断 MIME 类型
+    response_type, _ = mimetypes.guess_type(str(plugin_file_path))
+    suffix = plugin_file_path.suffix.lower()
+    # 强制修正 .mjs 和 .js 的 MIME 类型
+    if suffix in ['.js', '.mjs']:
+        response_type = 'application/javascript'
+    elif suffix == '.css' and not response_type: # 如果 guess_type 没猜对 css，也修正
+        response_type = 'text/css'
+    elif not response_type: # 对于其他猜不出的类型
+        response_type = 'application/octet-stream'
+
+    try:
+        return FileResponse(plugin_file_path, media_type=response_type)
+    except Exception as e:
+        logger.error(f"Error creating/sending FileResponse for {plugin_file_path}: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail="Internal Server Error")
+
+
 @router.get("/{plugin_id}", summary="获取插件配置")
 def plugin_config(plugin_id: str,
                   _: schemas.TokenPayload = Depends(get_current_active_superuser)) -> dict: