Update plugin toml and parse

Author: wu-clan

backend/plugin/casbin/plugin.toml

@@ -1,8 +1,10 @@
-# 属于哪个 app，如果为独立 app，应设置为 ''
-app = 'admin'
+[app]
+include = 'admin'
 
-# 路由配置，仅对于非独立 app 可用
-[api]
-# prefix 必须带前导 ‘/’，例如：’/api‘
+[api.api]
+prefix = '/api'
+tags = '系统API'
+
+[api.casbin]
 prefix = '/casbin'
 tags = '系统Casbin权限'

backend/plugin/notice/plugin.toml

@@ -1,8 +1,6 @@
-# 属于哪个 app，如果为独立 app，应设置为 ''
-app = 'admin'
+[app]
+include = 'admin'
 
-# api 路由配置，仅对于非独立 app 可用
-[api]
-# prefix 必须带前导 /
+[api.notice]
 prefix = '/notices'
 tags = '系统通知公告'

backend/plugin/tools.py

@@ -56,68 +56,80 @@ def plugin_router_inject() -> None:
         if not os.path.exists(toml_path):
             raise FileNotFoundError(f'插件 {plugin} 缺少 plugin.toml 配置文件，请检查插件是否合法')
 
-        # 解析 plugin.toml
+        # 获取 plugin.toml 配置
         with open(toml_path, 'r', encoding='utf-8') as f:
             data = rtoml.load(f)
-        app_name = data.get('app', '')
-        prefix = data.get('api', {}).get('prefix', '')
-        tags = data.get('api', {}).get('tags', [])
-
-        # 插件中 API 路由文件的路径
-        plugin_api_path = os.path.join(PLUGIN_DIR, plugin, 'api')
-        if not os.path.exists(plugin_api_path):
-            raise FileNotFoundError(f'插件 {plugin} 缺少 api 目录，请检查插件文件是否完整')
-
-        # 路由注入
-        if app_name:
-            # 非独立应用：将插件路由注入到对应模块的路由中
+        api = data.get('api', {})
+
+        # 非独立 app
+        if api:
+            app_include = data.get('app', {}).get('include', '')
+            if not app_include:
+                raise ValueError(f'插件 {plugin} 配置文件存在错误，请检查')
+
+            # 插件中 API 路由文件的路径
+            plugin_api_path = os.path.join(PLUGIN_DIR, plugin, 'api')
+            if not os.path.exists(plugin_api_path):
+                raise FileNotFoundError(f'插件 {plugin} 缺少 api 目录，请检查插件文件是否完整')
+
+            # 将插件路由注入到对应模块的路由中
             for root, _, api_files in os.walk(plugin_api_path):
                 for file in api_files:
                     if file.endswith('.py') and file != '__init__.py':
-                        file_path = os.path.join(root, file)
+                        # 解析插件路由配置
+                        prefix = data.get('api', {}).get(f'{file[:-3]}', {}).get('prefix', '')
+                        tags = data.get('api', {}).get(f'{file[:-3]}', {}).get('tags', [])
 
                         # 获取插件路由模块
+                        file_path = os.path.join(root, file)
                         path_to_module_str = os.path.relpath(file_path, PLUGIN_DIR).replace(os.sep, '.')[:-3]
                         module_path = f'backend.plugin.{path_to_module_str}'
                         try:
                             module = import_module_cached(module_path)
                         except ImportError as e:
-                            raise ImportError(f'导入模块 {module_path} 失败：{e}') from e
+                            raise ImportError(f'导入非独立 app 插件 {plugin} 模块 {module_path} 失败：{e}') from e
                         plugin_router = getattr(module, 'router', None)
                         if not plugin_router:
                             warnings.warn(
-                                f'目标模块 {module_path} 中没有有效的 router，请检查插件文件是否完整',
+                                f'非独立 app 插件 {plugin} 模块 {module_path} 中没有有效的 router，'
+                                '请检查插件文件是否完整',
                                 FutureWarning,
                             )
                             continue
 
                         # 获取源程序路由模块
                         relative_path = os.path.relpath(root, plugin_api_path)
-                        target_module_path = f'backend.app.{app_name}.api.{relative_path.replace(os.sep, ".")}'
+                        target_module_path = f'backend.app.{app_include}.api.{relative_path.replace(os.sep, ".")}'
                         try:
                             target_module = import_module_cached(target_module_path)
                         except ImportError as e:
-                            raise ImportError(f'导入目标模块 {target_module_path} 失败：{e}') from e
+                            raise ImportError(f'导入源程序模块 {target_module_path} 失败：{e}') from e
                         target_router = getattr(target_module, 'router', None)
                         if not target_router or not isinstance(target_router, APIRouter):
-                            raise AttributeError(f'目标模块 {module_path} 中没有有效的 router，请检查插件文件是否完整')
+                            raise AttributeError(
+                                f'非独立 app 插件 {plugin} 模块 {module_path} 中没有有效的 router，'
+                                '请检查插件文件是否完整'
+                            )
 
                         # 将插件路由注入到目标 router 中
                         target_router.include_router(
                             router=plugin_router,
                             prefix=prefix,
-                            tags=tags if tags == [] else [tags],
+                            tags=[tags] if tags else [],
                         )
+        # 独立 app
         else:
-            # 独立应用：将插件中的路由直接注入到总路由中
+            # 将插件中的路由直接注入到总路由中
             module_path = f'backend.plugin.{plugin}.api.router'
             try:
                 module = import_module_cached(module_path)
             except ImportError as e:
-                raise ImportError(f'导入目标模块 {module_path} 失败：{e}') from e
+                raise ImportError(f'导入独立 app 插件 {plugin} 模块 {module_path} 失败：{e}') from e
             plugin_router = getattr(module, 'router', None)
             if not plugin_router or not isinstance(plugin_router, APIRouter):
-                raise AttributeError(f'目标模块 {module_path} 中没有有效的 router，请检查插件文件是否完整')
+                raise AttributeError(
+                    f'独立 app 插件 {plugin} 模块 {module_path} 中没有有效的 router，请检查插件文件是否完整'
+                )
             target_module_path = 'backend.app.router'
             target_module = import_module_cached(target_module_path)
             target_router = getattr(target_module, 'router')