refactor(mcsmapi): 重构Daemon相关API及模型

- 修改Daemon类中的方法名称，以更准确地反映其功能
- 新增Daemon信息获取方法，包括配置、状态和系统信息
- 更新相关模型以适应新的API结构
- 优化模型定义，移除不必要的字段和方法

Author: molanp

example/daemon.py

@@ -10,7 +10,7 @@
 
 # show Daemon list
 
-print(daemon_object.show())
+print(daemon_object.config())
 
 # 创建节点
 daemonId = daemon_object.add(

mcsmapi/apis/daemon.py

@@ -1,12 +1,18 @@
 from typing import Any
 from mcsmapi.pool import ApiPool
 from mcsmapi.request import send
-from mcsmapi.models.daemon import DaemonConfig, DaemonModel
+from mcsmapi.models.daemon import (
+    DaemonConfig,
+    DaemonInfo,
+    DaemonSystemInfo,
+    DaemonStatus,
+    DaemonUpdateConfig,
+)
 
 
 class Daemon:
     @staticmethod
-    def show() -> list[DaemonConfig]:
+    def config() -> list[DaemonStatus]:
         """
         获取全部节点配置信息
 
@@ -16,10 +22,23 @@ def show() -> list[DaemonConfig]:
             "GET",
             f"{ApiPool.SERVICE}/remote_services_list",
         )
-        return [DaemonConfig(**daemon) for daemon in daemons]
+        return [DaemonStatus(**daemon) for daemon in daemons]
 
     @staticmethod
-    def system() -> list[DaemonModel]:
+    def info() -> list[DaemonInfo]:
+        """
+        获取全部节点信息
+
+        :returns: 节点信息列表
+        """
+        daemons = send(
+            "GET",
+            f"{ApiPool.SERVICE}/remote_services",
+        )
+        return [DaemonInfo(**daemon) for daemon in daemons]
+
+    @staticmethod
+    def system() -> list[DaemonSystemInfo]:
         """
         获取全部节点的系统信息
 
@@ -29,7 +48,7 @@ def system() -> list[DaemonModel]:
             "GET",
             f"{ApiPool.SERVICE}/remote_services_system",
         )
-        return [DaemonModel(**daemon) for daemon in daemons]
+        return [DaemonSystemInfo(**daemon) for daemon in daemons]
 
     @staticmethod
     def add(config: dict[str, Any]) -> str:
@@ -77,16 +96,14 @@ def update(daemonId: str, config: dict[str, Any]) -> bool:
         """
         更新一个节点的配置
 
-        **不建议直接使用此函数，建议调用overview()后在remote属性内使用节点对象的updateConfig方法按需更新**
-
         :params daemonId: 节点的UUID
-        :params config: 节点的配置信息，以字典形式提供，缺失内容由DaemonConfig模型补全
+        :params config: 节点的配置信息，以字典形式提供，缺失内容由DaemonUpdateConfig模型补全
 
         :returns: 操作成功后返回True
         """
         return send(
             "PUT",
             f"{ApiPool.SERVICE}/remote_service",
             params={"uuid": daemonId},
-            data=DaemonConfig(**config).model_dump(),
+            data=DaemonUpdateConfig(**config).model_dump(),
         )

mcsmapi/apis/instance.py

@@ -63,7 +63,7 @@ def detail(daemonId: str, uuid: str) -> InstanceDetail:
             ApiPool.INSTANCE,
             params={"uuid": uuid, "daemonId": daemonId},
         )
-        return InstanceDetail(**result)
+        return InstanceDetail(**result, daemonId=daemonId)
 
     @staticmethod
     def create(daemonId: str, config: dict[str, Any]) -> InstanceCreateResult:

mcsmapi/models/common.py

@@ -21,7 +21,7 @@ class ProcessInfo(BaseModel):
     """工作路径"""
 
 
-class InstanceInfo(BaseModel):
+class InstanceStat(BaseModel):
     """实例统计信息"""
 
     running: int

mcsmapi/models/daemon.py

@@ -1,10 +1,10 @@
 from typing import Any
 from pydantic import BaseModel
-from mcsmapi.models.instance import InstanceCreateResult
-from mcsmapi.models.common import ProcessInfo, InstanceInfo, CpuMemChart
+from mcsmapi.models.instance import InstanceCreateResult, InstanceDetail
+from mcsmapi.models.common import ProcessInfo, InstanceStat, CpuMemChart
 
 
-class DaemonSystemInfo(BaseModel):
+class SystemInfo(BaseModel):
     """节点系统信息"""
 
     type: str
@@ -35,31 +35,44 @@ class DaemonSystemInfo(BaseModel):
     """未知"""
 
 
-class DaemonModel(BaseModel):
-    """节点详细信息"""
+class DaemonSetting(BaseModel):
+    """节点系统配置信息"""
+
+    language: str
+    """节点语言"""
+    uploadSpeedRate: int
+    """上传速度限制(0为不限制, 限制为(n * 64)KB/s)"""
+    downloadSpeedRate: int
+    """下载速度限制(0为不限制, 限制为(n * 64)KB/s)"""
+    portRangeStart: int
+    """端口范围起始值"""
+    portRangeEnd: int
+    """端口范围结束值"""
+    portAssignInterval: int
+    """未知"""
+    port: int
+    """节点监听端口"""
+
+
+class DaemonSystemInfo(BaseModel):
+    """节点系统信息"""
 
-    version: str
+    version: str | None = None
     """远程节点版本"""
-    process: ProcessInfo
+    process: ProcessInfo | None = None
     """远程节点的基本信息"""
-    instance: InstanceInfo
+    instance: InstanceStat | None = None
     """远程节点实例基本信息"""
-    system: DaemonSystemInfo
+    system: SystemInfo | None = None
     """远程节点系统信息"""
-    cpuMemChart: list[CpuMemChart]
+    cpuMemChart: list[CpuMemChart] | None = None
     """cpu和内存使用趋势"""
+    config: DaemonSetting
+
+
+class DaemonOperation(BaseModel):
     uuid: str
-    """远程节点的uuid"""
-    ip: str
-    """远程节点的ip"""
-    port: int
-    """远程节点的端口"""
-    prefix: str
-    """远程节点的路径前缀"""
-    available: bool
-    """远程节点的可用状态"""
-    remarks: str
-    """远程节点的名称"""
+    """节点UUID"""
 
     def delete(self):
         """
@@ -93,14 +106,8 @@ def updateConfig(self, config: dict[str, Any]) -> bool:
 
         updated_config = self.model_dump()
         updated_config.update(config)
-        # 过滤节点配置中不需要的字段
-        daemon_config_dict = {
-            key: updated_config[key]
-            for key in DaemonConfig.model_fields.keys()
-            if key in updated_config
-        }
 
-        daemon_config = DaemonConfig(**daemon_config_dict).model_dump()
+        daemon_config = DaemonUpdateConfig(**updated_config).model_dump()
 
         return Daemon.update(self.uuid, daemon_config)
 
@@ -142,5 +149,29 @@ class DaemonConfig(BaseModel):
     """远程节点的路径前缀"""
     remarks: str = "Unnamed Node"
     """远程节点的备注"""
-    available: bool = True
-    """远程节点的可用状态"""
+    apiKey: str = ""
+    """远程节点的apiKey"""
+
+
+class DaemonStatus(DaemonOperation):
+    """节点状态信息"""
+    ip: str = "localhost"
+    """远程节点的ip"""
+    port: int = 24444
+    """远程节点的端口"""
+    prefix: str = ""
+    """远程节点的路径前缀"""
+    remarks: str = "Unnamed Node"
+    """远程节点的备注"""
+    available: bool
+    """节点可用状态"""
+
+
+class DaemonInfo(DaemonStatus):
+    """节点信息"""
+    instances: list[InstanceDetail]
+
+
+class DaemonUpdateConfig(DaemonConfig):
+    """节点更新配置信息"""
+    setting: DaemonSetting

mcsmapi/models/instance.py

@@ -121,55 +121,15 @@ class InstanceConfig(BaseModel):
     """运行该实例的系统用户，为空则使用启动面板的系统用户"""
 
 
-class InstanceProcessInfo(BaseModel):
-    """进程信息"""
-
-    cpu: int
-    """CPU 使用率 (单位: %)"""
-    memory: int
-    """进程占用内存 (单位: KB)"""
-    ppid: int
-    """父进程 ID"""
-    pid: int
-    """进程 ID"""
-    ctime: int
-    """进程创建时间 (Unix 时间戳)"""
-    elapsed: int
-    """进程运行时长 (单位: 秒)"""
-    timestamp: int
-    """时间戳"""
-
-
-class InstanceInfo(BaseModel):
-    """实例运行状态信息(这些选项在新版中已不再支持设置，但仍在API中返回)"""
-
-    currentPlayers: int
-    """当前玩家数量"""
-    fileLock: int = 0
-    """文件锁状态 (0: 无锁)"""
-    maxPlayers: int = -1
-    """最大允许玩家数 (-1 表示未知)"""
-    openFrpStatus: bool = False
-    """是否启用 FRP 远程服务"""
-    playersChart: list[dict] = []
-    """玩家数量变化图表数据"""
-    version: str = ""
-    """服务器版本"""
-
-
 class InstanceDetail(BaseModel):
     """实例详细信息"""
 
     config: InstanceConfig
     """实例的配置信息"""
-    info: InstanceInfo
-    """实例的运行状态信息"""
     daemonId: str
     """所属的节点UUID"""
     instanceUuid: str
     """实例UUID"""
-    processInfo: InstanceProcessInfo
-    """实例的进程信息"""
     started: int
     """实例的启动次数"""
     status: Status

mcsmapi/models/overview.py

@@ -2,7 +2,7 @@
 from typing import Literal
 from pydantic import BaseModel
 from mcsmapi.models.common import CpuMemChart, ProcessInfo
-from mcsmapi.models.daemon import DaemonModel
+from mcsmapi.models.daemon import DaemonSystemInfo
 
 
 class SystemUser(BaseModel):
@@ -110,7 +110,7 @@ class OverviewModel(BaseModel):
     """系统与请求统计图表数据"""
     remoteCount: RemoteCountInfo
     """远程节点统计信息"""
-    remote: list[DaemonModel]
+    remote: list[DaemonSystemInfo]
     """远程节点详细信息"""
 
 

mcsmapi/models/user.py

@@ -75,14 +75,7 @@ def update(self, config: dict[str, Any]):
 
         updated_config = self.model_dump()
         updated_config.update(config)
-        # 过滤用户信息中不需要的字段
-        user_config_dict = {
-            key: updated_config[key]
-            for key in UserConfig.model_fields.keys()
-            if key in updated_config
-        }
-
-        user_config = UserConfig(**user_config_dict).model_dump()
+        user_config = UserConfig(**updated_config).model_dump()
 
         return User().update(self.uuid, user_config)
 

pyproject.toml

@@ -4,7 +4,7 @@ requires = ["setuptools", "wheel"]
 
 [project]
 name = "mcsmapi"
-version = "0.1.8.b1"
+version = "0.1.8.b2"
 description = "Shortcut the pypi package of MCSM./快捷操作MCSM的pypi包"
 readme = "README.md"
 authors = [