plugin.py 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212
  1. from typing import Optional, List, Dict, Any
  2. from fastapi import APIRouter, Depends, Query, Body, File, Form, UploadFile, Request
  3. from sqlalchemy.ext.asyncio import AsyncSession
  4. from app.core.database import get_db
  5. from app.utils.response import success
  6. from app.schemas.common import ApiResponse
  7. from app.schemas.plugin import (
  8. PluginPublishOut,
  9. PluginOut,
  10. PluginListResponse,
  11. PluginDetailOut,
  12. PluginUpdate,
  13. PluginSwitchVersion,
  14. PluginUpgradeDispatch,
  15. PluginLatestItemOut,
  16. )
  17. from app.services.plugin_service import PluginService
  18. public_router = APIRouter()
  19. protected_router = APIRouter()
  20. admin_required_router = APIRouter()
  21. @admin_required_router.post(
  22. "/plugins/publish",
  23. summary="发布插件 / 上传新版本",
  24. tags=["插件管理"],
  25. response_model=ApiResponse[PluginPublishOut],
  26. )
  27. async def publish_plugin(
  28. request: Request,
  29. name: Optional[str] = Form(None),
  30. version: Optional[str] = Form(None),
  31. display_name: Optional[str] = Form(""),
  32. filename: Optional[str] = Form(""),
  33. class_name: Optional[str] = Form(""),
  34. protocol: Optional[str] = Form("IPlugin"),
  35. description: Optional[str] = Form(""),
  36. download_url: Optional[str] = Form(None),
  37. sha256: Optional[str] = Form(""),
  38. changelog: Optional[str] = Form(None),
  39. set_as_latest: bool = Form(True),
  40. developer_id: Optional[str] = Form(None),
  41. file: Optional[UploadFile] = File(None),
  42. db: AsyncSession = Depends(get_db),
  43. ):
  44. """
  45. 发布插件或上传新版本:
  46. - 支持 multipart/form-data(包含文件上传或表单字段)
  47. - 支持 application/json(直接提供 download_url)
  48. """
  49. content_type = request.headers.get("content-type", "")
  50. if "application/json" in content_type:
  51. try:
  52. body = await request.json()
  53. name = body.get("name")
  54. version = body.get("version")
  55. display_name = body.get("display_name", "")
  56. filename = body.get("filename", "")
  57. class_name = body.get("class_name", "")
  58. protocol = body.get("protocol", "IPlugin")
  59. description = body.get("description", "")
  60. download_url = body.get("download_url")
  61. sha256 = body.get("sha256", "")
  62. changelog = body.get("changelog")
  63. set_as_latest = body.get("set_as_latest", True)
  64. if "developer_id" in body:
  65. developer_id = body.get("developer_id")
  66. except Exception:
  67. pass
  68. res = await PluginService.publish_plugin(
  69. db=db,
  70. name=name,
  71. version=version,
  72. display_name=display_name,
  73. filename=filename,
  74. class_name=class_name,
  75. protocol=protocol,
  76. description=description,
  77. file=file,
  78. download_url=download_url,
  79. sha256=sha256,
  80. changelog=changelog,
  81. set_as_latest=set_as_latest,
  82. developer_id=developer_id,
  83. )
  84. return success(data=res, message="Plugin published successfully")
  85. @admin_required_router.get(
  86. "/plugins/list_all",
  87. summary="获取插件列表 (网页管理)",
  88. tags=["插件管理"],
  89. response_model=ApiResponse[PluginListResponse],
  90. )
  91. async def list_all_plugins(
  92. page: int = Query(1, ge=1, description="页码"),
  93. page_size: int = Query(20, ge=1, le=100, description="每页数量"),
  94. status: Optional[int] = Query(None, description="状态过滤 (1-启用, 0-停用)"),
  95. db: AsyncSession = Depends(get_db),
  96. ):
  97. res = await PluginService.get_plugin_list(
  98. db=db, page=page, page_size=page_size, status=status
  99. )
  100. return success(data=res)
  101. @admin_required_router.get(
  102. "/plugins/detail",
  103. summary="获取插件详情 (含历史所有版本)",
  104. tags=["插件管理"],
  105. response_model=ApiResponse[PluginDetailOut],
  106. )
  107. async def get_plugin_detail(
  108. plugin_id: int = Query(..., description="插件ID"),
  109. db: AsyncSession = Depends(get_db),
  110. ):
  111. res = await PluginService.get_plugin_detail(db=db, plugin_id=plugin_id)
  112. return success(data=res)
  113. @admin_required_router.put(
  114. "/plugins/update",
  115. summary="编辑插件基础信息",
  116. tags=["插件管理"],
  117. response_model=ApiResponse[PluginOut],
  118. )
  119. async def update_plugin(
  120. plugin_id: int = Query(..., description="插件ID"),
  121. plugin_in: PluginUpdate = Body(...),
  122. db: AsyncSession = Depends(get_db),
  123. ):
  124. res = await PluginService.update_plugin(
  125. db=db, plugin_id=plugin_id, plugin_in=plugin_in
  126. )
  127. return success(data=res)
  128. @admin_required_router.post(
  129. "/plugins/switch-version",
  130. summary="切换生效版本 / 一键回滚",
  131. tags=["插件管理"],
  132. response_model=ApiResponse[PluginOut],
  133. )
  134. async def switch_plugin_version(
  135. payload: PluginSwitchVersion = Body(...),
  136. db: AsyncSession = Depends(get_db),
  137. ):
  138. res = await PluginService.switch_version(
  139. db=db, plugin_id=payload.plugin_id, version=payload.version
  140. )
  141. return success(data=res)
  142. @admin_required_router.delete(
  143. "/plugins/delete",
  144. summary="删除整套插件",
  145. tags=["插件管理"],
  146. response_model=ApiResponse[bool],
  147. )
  148. async def delete_plugin(
  149. plugin_id: int = Query(..., description="插件ID"),
  150. db: AsyncSession = Depends(get_db),
  151. ):
  152. await PluginService.delete_plugin(db=db, plugin_id=plugin_id)
  153. return success(data=True, message="Plugin deleted successfully")
  154. @admin_required_router.delete(
  155. "/plugins/delete_version",
  156. summary="删除指定历史版本",
  157. tags=["插件管理"],
  158. response_model=ApiResponse[bool],
  159. )
  160. async def delete_plugin_version(
  161. plugin_id: int = Query(..., description="插件ID"),
  162. version: str = Query(..., description="版本号"),
  163. db: AsyncSession = Depends(get_db),
  164. ):
  165. await PluginService.delete_version(db=db, plugin_id=plugin_id, version=version)
  166. return success(data=True, message="Plugin version deleted successfully")
  167. @admin_required_router.post(
  168. "/plugins/upgrade/dispatch",
  169. summary="下发插件升级命令 (控制面与节点联动)",
  170. tags=["插件管理"],
  171. response_model=ApiResponse[List[Dict[str, Any]]],
  172. )
  173. async def dispatch_upgrade(
  174. payload: PluginUpgradeDispatch = Body(...),
  175. db: AsyncSession = Depends(get_db),
  176. ):
  177. res = await PluginService.dispatch_upgrade(
  178. db=db, target_node=payload.target_node, plugins=payload.plugins
  179. )
  180. return success(data=res)
  181. @admin_required_router.get(
  182. "/plugins/latest",
  183. summary="获取当前全量最新可用插件清单 (节点主动拉取)",
  184. tags=["插件管理"],
  185. response_model=ApiResponse[List[PluginLatestItemOut]],
  186. )
  187. async def get_latest_plugins(
  188. db: AsyncSession = Depends(get_db),
  189. ):
  190. res = await PluginService.get_latest_plugins(db=db)
  191. return success(data=res)