feat(remote): 新增MCSM隐藏API

- 更新部分模型的注释
- 新增了查询节点列表的功能

Author: molanp

example/daemon.py

@@ -6,10 +6,14 @@
 
 # mcsm.login_with_apikey("apikey")
 
-daemonM = mcsm.daemon()
+daemon_object = mcsm.daemon()
+
+# show Daemon list
+
+print(daemon_object.show())
 
 # 创建节点
-daemonId = daemonM.add(
+daemonId = daemon_object.add(
     {
         "ip": "localhost",
         "port": 24444,
@@ -19,4 +23,4 @@
     }
 )
 # 删除节点
-daemonM.delete(daemonId)
+daemon_object.delete(daemonId)

mcsmapi/apis/daemon.py

@@ -1,10 +1,62 @@
 from typing import Any
 from mcsmapi.pool import ApiPool
 from mcsmapi.request import send
-from mcsmapi.models.daemon import DaemonConfig
+from mcsmapi.models.daemon import DaemonConfig, DaemonModel
+from mcsmapi.models.daemon.instance import InstanceDetail
 
 
 class Daemon:
+    def show(self) -> list[DaemonConfig]:
+        """
+        获取全部节点配置信息
+
+        返回:
+        - List[DaemonConfig]: 节点的配置信息列表
+        """
+        daemons = send(
+            "GET",
+            f"{ApiPool.SERVICE}/remote_services_list",
+        )
+        return [DaemonConfig(**daemon) for daemon in daemons]
+        
+    def system(self) -> list[DaemonModel]:
+        """
+        获取全部节点的系统信息
+        
+        返回:
+        - List[DaemonModel]: 节点系统信息列表
+        """
+        daemons = send(
+            "GET",
+            f"{ApiPool.SERVICE}/remote_services_system",
+        )
+        return [DaemonModel(**daemon) for daemon in daemons]
+    
+    def instances(self, daemonId: str, page: int = 0, page_size: int = 10, instance_name: str = "", status: int = 0, tag: list[str] | None = None) -> list[InstanceDetail]:
+        """
+        查询指定节点下的实例详细信息
+        
+        参数:
+        - `daemonId` (str): 要查询的守护进程（Daemon）的唯一标识符。
+        - `page` (int, 默认=0): 分页查询的页码（从 0 开始）。
+        - `page_size` (int, 默认=10): 每页返回的实例数量。
+        - `instance_name` (str, 默认=""): 过滤指定名称的实例。
+        - `status` (int, 默认=0): 过滤指定状态的实例，如运行中、已停止等。
+        - `tag` (List[str] | None, 默认=None): 根据标签筛选实例（可选参数）。
+      
+        返回:
+        - `List[InstanceDetail]`: 包含实例详细信息的列表。
+      
+        注意:
+        - 此方法尚未实现 (`raise RuntimeError`)，因为 MCSM 官方文档未提供足够的信息。
+        - 由于根据 MCSM 源代码的测试无法获取有效数据，目前无法完成该功能的开发。
+        - 如果你有具体的实现思路，请在 issue 中提出
+        - 可供参考 MCSM 源码: [daemon_router.ts 第 32 行](https://github.com/MCSManager/MCSManager/blob/master/panel%2Fsrc%2Fapp%2Frouters%2Fdaemon_router.ts#L32-L32)
+        - 测试地址示例:
+            `http://localhost:23333/api/service/remote_service_instances?apikey=xxx&daemonId=xxx&page=0&page_size=10&status=3&instance_name=`
+        """
+        raise RuntimeError("此方法尚未实现")
+
     def add(self, config: dict[str, Any]) -> str:
         """
         新增一个节点。

mcsmapi/apis/file.py

@@ -38,7 +38,7 @@ def show(
                 "target": target,
                 "page": page,
                 "page_size": page_size,
-                "file_name": file_name
+                "file_name": file_name,
             },
         )
         return FileList(**result, daemonId=daemonId, uuid=uuid)

mcsmapi/models/daemon.py

@@ -158,8 +158,13 @@ def deleteInstance(self, uuids: list[str], deleteFile=False) -> list[str]:
 
 
 class DaemonConfig(BaseModel):
+    """远程节点的ip"""
     ip: str = "localhost"
+    """远程节点的端口"""
     port: int = 24444
+    """远程节点的路径前缀"""
     prefix: str = ""
+    """远程节点的备注"""
     remarks: str = "New Daemon"
+    """远程节点的可用状态"""
     available: bool = True

mcsmapi/models/file.py

@@ -5,7 +5,7 @@
 
 class FileItem(BaseModel):
     """文件名称"""
-    name: str = "New File"
+    name: str = ""
     """文件大小(单位: byte)"""
     size: int = 0  # byte
     """文件修改时间"""

mcsmapi/models/image.py

@@ -3,9 +3,12 @@
 
 
 class DockerConfig(BaseModel):
+    """容器名称"""
     containerName: str = ""
-    image: str = "mcsm-ubuntu:22.04"
-    memory: int = 1024  # in MB
+    """镜像名称"""
+    image: str = ""
+    """容器分配内存(单位: MB)"""
+    memory: int = 0  # in MB
     ports: List[str] = ["25565:25565/tcp"]
     extraVolumes: List[str] = []
     maxSpace: Optional[int] = None