feat(home page): place the version introduction in a static file

api/app/controllers/home_page_controller.py

@@ -32,7 +32,6 @@ def get_workspace_list(
 @router.get("/version", response_model=ApiResponse)
 def get_system_version():
     """获取系统版本号+说明"""
-    return success(data={
-        "version": settings.SYSTEM_VERSION,
-        "introduction": settings.SYSTEM_INTRODUCTION
-    }, msg="系统版本获取成功")
+    current_version = settings.SYSTEM_VERSION
+    version_introduction = HomePageService.load_version_introduction(current_version)
+    return success(data={"version": current_version, "introduction": version_introduction}, msg="系统版本获取成功")

api/app/core/config.py

@@ -167,7 +167,6 @@ class Settings:
 
     # official environment system version
     SYSTEM_VERSION: str = os.getenv("SYSTEM_VERSION", "v0.2.0")
-    SYSTEM_INTRODUCTION: str = os.getenv("SYSTEM_INTRODUCTION", "")
     
     def get_memory_output_path(self, filename: str = "") -> str:
         """

api/app/services/home_page_service.py

@@ -1,6 +1,11 @@
+import json
+from pathlib import Path
 from datetime import datetime, timedelta
+
+from fastapi import HTTPException
 from sqlalchemy.orm import Session
 from uuid import UUID
+from typing import Dict, Any
 
 from app.repositories.home_page_repository import HomePageRepository
 from app.schemas.home_page_schema import HomeStatistics, WorkspaceInfo
@@ -68,4 +73,69 @@ class HomePageService:
             )
             workspace_list.append(workspace_info)
         
-        return workspace_list
+        return workspace_list
+
+    @staticmethod
+    def load_version_introduction(version: str) -> Dict[str, Any]:
+        """
+        从 JSON 文件加载对应版本的介绍
+        :param version: 系统版本号（如 "0.2.0"）
+        :return: 对应版本的详细介绍
+        """
+        # 1. 定义 JSON 文件路径（使用 Path 处理跨平台路径问题）
+        json_file_path = Path(__file__).parent.parent.parent / "version_info.json"
+        # 转换为绝对路径，便于调试
+        json_abs_path = json_file_path.resolve()
+
+        try:
+            # 2. 读取 JSON 文件
+            if not json_abs_path.exists():
+                return {
+                    "message": f"版本介绍文件不存在：{json_abs_path}",
+                    "codeName": "",
+                    "releaseDate": "",
+                    "upgradePosition": "",
+                    "coreUpgrades": []
+                }
+
+            with open(json_abs_path, "r", encoding="utf-8") as f:
+                changelogs = json.load(f)
+
+            # 3. 匹配对应版本的介绍，若版本不存在返回默认提示
+            if version not in changelogs:
+                return {
+                    "message": f"暂未查询到 {version} 版本的详细介绍",
+                    "codeName": "",
+                    "releaseDate": "",
+                    "upgradePosition": "",
+                    "coreUpgrades": []
+                }
+            return changelogs[version]
+
+        except FileNotFoundError as e:
+            # 处理文件不存在异常
+            return {
+                    "message": f"系统内部错误：{str(e)}",
+                    "codeName": "",
+                    "releaseDate": "",
+                    "upgradePosition": "",
+                    "coreUpgrades": []
+                }
+        except json.JSONDecodeError:
+            # 处理 JSON 格式错误
+            return {
+                    "message": "版本介绍文件格式错误，无法解析 JSON",
+                    "codeName": "",
+                    "releaseDate": "",
+                    "upgradePosition": "",
+                    "coreUpgrades": []
+                }
+        except Exception as e:
+            # 处理其他未知异常
+            return {
+                "message": f"加载版本介绍失败：{str(e)}",
+                "codeName": "",
+                "releaseDate": "",
+                "upgradePosition": "",
+                "coreUpgrades": []
+            }