Merge pull request #136 from SuanmoSuanyangTechnology/feature/agent-tool_xjn

feat(home page)

api/app/controllers/home_page_controller.py

@@ -33,5 +33,12 @@ def get_workspace_list(
 def get_system_version():
     """获取系统版本号+说明"""
     current_version = settings.SYSTEM_VERSION
-    version_introduction = HomePageService.load_version_introduction(current_version)
+    version_info = HomePageService.load_version_introduction(current_version)
-    return success(data={"version": current_version, "introduction": version_introduction}, msg="系统版本获取成功")
+    return success(
+        data={
+            "version": current_version,
+            "introduction": version_info.get("introduction"),
+            "introduction_en": version_info.get("introduction_en")
+        },
+        msg="系统版本获取成功"
+    )

api/app/services/home_page_service.py

@@ -11,6 +11,22 @@ from app.repositories.home_page_repository import HomePageRepository
 from app.schemas.home_page_schema import HomeStatistics, WorkspaceInfo
 
 class HomePageService:
+
+    DEFAULT_RETURN_DATA: Dict[str, Any] = {
+        "message": "",
+        "introduction": {
+            "codeName": "",
+            "releaseDate": "",
+            "upgradePosition": "",
+            "coreUpgrades": []
+        },
+        "introduction_en": {
+            "codeName": "",
+            "releaseDate": "",
+            "upgradePosition": "",
+            "coreUpgrades": []
+        }
+    }
     
     @staticmethod
     def get_home_statistics(db: Session, tenant_id: UUID) -> HomeStatistics:
@@ -82,60 +98,36 @@ class HomePageService:
         :param version: 系统版本号（如 "0.2.0"）
         :return: 对应版本的详细介绍
         """
-        # 1. 定义 JSON 文件路径（使用 Path 处理跨平台路径问题）
+        # 2. 定义 JSON 文件路径（简化路径处理，保留绝对路径调试特性）
-        json_file_path = Path(__file__).parent.parent / "version_info.json"
+        json_abs_path = Path(__file__).parent.parent / "version_info.json"
-        # 转换为绝对路径，便于调试
+        json_abs_path = json_abs_path.resolve()
-        json_abs_path = json_file_path.resolve()
+
+        # 3. 初始化返回结果（深拷贝默认模板，避免修改原常量）
+        from copy import deepcopy
+        result = deepcopy(HomePageService.DEFAULT_RETURN_DATA)
 
         try:
-            # 2. 读取 JSON 文件
+            # 4. 简化文件存在性判断（合并逻辑，减少分支）
             if not json_abs_path.exists():
-                return {
+                result["message"] = f"版本介绍文件不存在：{json_abs_path}"
-                    "message": f"版本介绍文件不存在：{json_abs_path}",
+                return result
-                    "codeName": "",
-                    "releaseDate": "",
-                    "upgradePosition": "",
-                    "coreUpgrades": []
-                }
 
+            # 5. 读取并解析 JSON 文件（简化文件操作流程）
             with open(json_abs_path, "r", encoding="utf-8") as f:
                 changelogs = json.load(f)
 
-            # 3. 匹配对应版本的介绍，若版本不存在返回默认提示
+            # 6. 简化版本匹配逻辑，直接返回结果或更新提示信息
-            if version not in changelogs:
+            if version in changelogs:
-                return {
+                return changelogs[version]
-                    "message": f"暂未查询到 {version} 版本的详细介绍",
+            result["message"] = f"暂未查询到 {version} 版本的详细介绍"
-                    "codeName": "",
+            return result
-                    "releaseDate": "",
-                    "upgradePosition": "",
-                    "coreUpgrades": []
-                }
-            return changelogs[version]
 
         except FileNotFoundError as e:
-            # 处理文件不存在异常
+            result["message"] = f"系统内部错误：{str(e)}"
-            return {
+            return result
-                    "message": f"系统内部错误：{str(e)}",
-                    "codeName": "",
-                    "releaseDate": "",
-                    "upgradePosition": "",
-                    "coreUpgrades": []
-                }
         except json.JSONDecodeError:
-            # 处理 JSON 格式错误
+            result["message"] = "版本介绍文件格式错误，无法解析 JSON"
-            return {
+            return result
-                    "message": "版本介绍文件格式错误，无法解析 JSON",
-                    "codeName": "",
-                    "releaseDate": "",
-                    "upgradePosition": "",
-                    "coreUpgrades": []
-                }
         except Exception as e:
-            # 处理其他未知异常
+            result["message"] = f"加载版本介绍失败：{str(e)}"
-            return {
+            return result
-                "message": f"加载版本介绍失败：{str(e)}",
-                "codeName": "",
-                "releaseDate": "",
-                "upgradePosition": "",
-                "coreUpgrades": []
-            }

api/app/version_info.json

@@ -1,33 +1,68 @@
 {
   "v0.2.0": {
-    "codeName": "启知",
+    "introduction": {
-    "releaseDate": "2026-1-16",
+      "codeName": "启知",
-    "upgradePosition": "本次为架构升级，核心目标是把“被动存储”升级为“主动认知”，让系统具备情绪感知、情景理解与类人记忆机制，为后续多智能体协作与专业场景落地奠定底座。",
+      "releaseDate": "2026-1-16",
-    "coreUpgrades": [
+      "upgradePosition": "本次为架构升级，核心目标是把\"被动存储\"升级为\"主动认知\"，让系统具备情绪感知、情景理解与类人记忆机制，为后续多智能体协作与专业场景落地奠定底座。",
-      "记忆详情：拟人记忆——情绪引擎、情景记忆、短期记忆、工作记忆、感知记忆、显性记忆、隐性记忆，并配套类脑遗忘机制，实现从感知→情绪→情景→长期沉淀的完整人类记忆闭环",
+      "coreUpgrades": [
-      "可视化工作流：拖拽式节点编排（LLM、知识库、逻辑、工具），业务落地周期由天缩至小时。",
+        "记忆详情：拟人记忆——情绪引擎、情景记忆、短期记忆、工作记忆、感知记忆、显性记忆、隐性记忆，并配套类脑遗忘机制，实现从感知→情绪→情景→长期沉淀的完整人类记忆闭环",
-      "多模态知识处理：PDF、PPT、MP3、MP4 一键解析，时间感知检索准确率 94.3%，问答对数据即插即用。",
+        "可视化工作流：拖拽式节点编排（LLM、知识库、逻辑、工具），业务落地周期由天缩至小时。",
-      "Agent集群内置“记忆-知识-工具-审核”四类角色模板，用户一键生成；主控Agent把复杂任务拆为子任务并行分发，再靠情景记忆统一消解冲突、校验一致性，输出完整报告。"
+        "多模态知识处理：PDF、PPT、MP3、MP4 一键解析，时间感知检索准确率 94.3%，问答对数据即插即用。",
-    ]
+        "Agent集群内置\"记忆-知识-工具-审核\"四类角色模板，用户一键生成；主控Agent把复杂任务拆为子任务并行分发，再靠情景记忆统一消解冲突、校验一致性，输出完整报告。"
+      ]
+    },
+    "introduction_en": {
+      "codeName": "Qizhi",
+      "releaseDate": "2026-1-16",
+      "upgradePosition": "This release marks a foundational upgrade to the system’s cognitive architecture. The core objective is to evolve the platform from passive information storage into active cognitive intelligence—enabling emotional awareness, situational understanding, and human-like memory mechanisms. This upgrade lays the groundwork for future multi-agent collaboration and domain-specific, production-grade AI applications.",
+      "coreUpgrades": [
+        "Human-Like Memory Architecture: A comprehensive, human-inspired memory system is introduced, encompassing emotional processing, situational memory, short-term and working memory, perceptual memory, as well as explicit and implicit memory. Combined with brain-inspired forgetting mechanisms, the system now supports a complete cognitive loop—from perception → emotion → context → long-term consolidation, closely mirroring human memory formation.",
+        "Visual Workflow Orchestration: A fully visual, drag-and-drop workflow enables modular composition of LLMs, knowledge bases, logic, and tools. This dramatically reduces the time required to move from experimentation to production—from days to hours.",
+        "Multimodal Knowledge Processing: The system now supports one-click parsing and ingestion of PDF, PPT, MP3, and MP4 content. With time-aware retrieval accuracy reaching 94.3%, structured Q&A data becomes instantly usable for downstream reasoning and generation.",
+        "Built-in Agent Clusters: Predefined role templates across four categories—Memory, Knowledge, Tools, and Review—can be generated with a single click. A Coordinator Agent decomposes complex tasks into parallel subtasks, while situational memory is used to resolve conflicts, validate consistency, and synthesize outputs into a coherent, end-to-end report."
+      ]
+    }
   },
   "v0.1.0": {
-    "codeName": "初心",
+    "introduction": {
-    "releaseDate": "2025-12-01",
+      "codeName": "初心",
-    "upgradePosition": "这是一款专注于管理和利用AI记忆的工具，支持RAG和知识图谱两种主流存储方式，旨在为AI应用提供持久化、结构化的“记忆”能力。",
+      "releaseDate": "2025-12-01",
-    "coreUpgrades": [
+      "upgradePosition": "这是一款专注于管理和利用AI记忆的工具，支持RAG和知识图谱两种主流存储方式，旨在为AI应用提供持久化、结构化的\"记忆\"能力。",
-      "记忆空间：用户可以创建独立的空间来隔离不同记忆，并灵活选择存储方式。",
+      "coreUpgrades": [
-      "记忆配置：简化了配置流程，内置自动提取关键信息的“记忆萃取”和管理生命周期的\"遗忘\"引擎。",
+        "记忆空间：用户可以创建独立的空间来隔离不同记忆，并灵活选择存储方式。",
-      "知识检索：提供语义、分词和混合三种检索模式，并支持多种参数微调和结果重排序，以提升召回效果。",
+        "记忆配置：简化了配置流程，内置自动提取关键信息的\"记忆萃取\"和管理生命周期的\"遗忘\"引擎。",
-      "全局管理：支持统一设置默认检索参数，并可一键应用到所有知识库。",
+        "知识检索：提供语义、分词和混合三种检索模式，并支持多种参数微调和结果重排序，以提升召回效果。",
-      "测试与调试：内置\"召回测试\"功能，方便用户实时验证检索效果并调整参数，支持通过分享码与他人协作。",
+        "全局管理：支持统一设置默认检索参数，并可一键应用到所有知识库。",
-      "记忆洞察：可查看详细的对话记录、用户画像和分析报告，帮助理解AI的\"记忆\"内容。",
+        "测试与调试：内置\"召回测试\"功能，方便用户实时验证检索效果并调整参数，支持通过分享码与他人协作。",
-      "集成与管理：提供API Key用于系统集成，并包含基本的用户管理功能。",
+        "记忆洞察：可查看详细的对话记录、用户画像和分析报告，帮助理解AI的\"记忆\"内容。",
-      "界面与体验：采用现代化的卡片式布局和渐变色设计，注重交互的流畅性和视觉美感。",
+        "集成与管理：提供API Key用于系统集成，并包含基本的用户管理功能。",
-      "起步与使用：文档中提供了清晰的基础使用流程，引导用户从创建空间、配置记忆到测试检索快速上手。",
+        "界面与体验：采用现代化的卡片式布局和渐变色设计，注重交互的流畅性和视觉美感。",
-      "版本说明与限制: 记忆熊 v0.1.0 版本\"初心\"囊括智能记忆管理的核心思路和基础能力，为后续开发奠定了基础。",
+        "起步与使用：文档中提供了清晰的基础使用流程，引导用户从创建空间、配置记忆到测试检索快速上手。",
-      "文档资源：用户手册、API文档、FAQ",
+        "版本说明与限制: 记忆熊 v0.1.0 版本\"初心\"囊括智能记忆管理的核心思路和基础能力，为后续开发奠定了基础。",
-      "问题反馈：GitHub Issues、邮件支持",
+        "文档资源：用户手册、API文档、FAQ",
-      "致谢：感谢所有参与测试和提供反馈的用户！"
+        "问题反馈：GitHub Issues、邮件支持",
-    ]
+        "致谢：感谢所有参与测试和提供反馈的用户！"
+      ]
+    },
+    "introduction_en": {
+      "codeName": "Original Intent",
+      "releaseDate": "2025-12-01",
+      "upgradePosition": "A tool focused on managing and utilizing AI memory, supporting both RAG and knowledge graph storage methods, aiming to provide persistent and structured 'memory' capabilities for AI applications.",
+      "coreUpgrades": [
+        "Memory Space: Users can create independent spaces to isolate different memories and flexibly choose storage methods.",
+        "Memory Configuration: Simplified configuration process with built-in 'memory extraction' for automatic key information extraction and 'forgetting' engine for lifecycle management.",
+        "Knowledge Retrieval: Provides semantic, tokenization, and hybrid retrieval modes with various parameter tuning and result reranking to improve recall.",
+        "Global Management: Supports unified default retrieval parameter settings with one-click application to all knowledge bases.",
+        "Testing & Debugging: Built-in 'recall testing' for real-time verification of retrieval effects and parameter adjustment, with sharing code support for collaboration.",
+        "Memory Insights: View detailed conversation records, user profiles, and analysis reports to understand AI 'memory' content.",
+        "Integration & Management: Provides API Key for system integration with basic user management features.",
+        "Interface & Experience: Modern card-based layout with gradient design, focusing on interaction fluidity and visual aesthetics.",
+        "Getting Started: Documentation provides clear basic usage flow, guiding users from creating spaces, configuring memory to testing retrieval.",
+        "Version Notes: MemoryBear v0.1.0 'Original Intent' encompasses core concepts and basic capabilities of intelligent memory management, laying foundation for future development.",
+        "Documentation: User Manual, API Documentation, FAQ",
+        "Feedback: GitHub Issues, Email Support",
+        "Acknowledgments: Thanks to all users who participated in testing and provided feedback!"
+      ]
+    }
   }
-}
+}