refactor(mcsmapi): 根据文档重新校对代码并更新注释格式

- 更新了多个 API 类的参数类型和返回类型
- 优化了部分函数的实现逻辑
- 统一了参数命名和类型注解
- 调整了部分模型的属性名称

Author: molanp

example/user.py

@@ -13,7 +13,7 @@
     print(user.userName)
 
 # 查找第一个管理员账号
-user = api.user().search(role="10").data[0]
+user = api.user().search(role=10).data[0]
 
 # 封禁管理员账号
 user.update({"permission": -1})
@@ -22,13 +22,9 @@
 user.delete()
 
 # 创建新用户
-uuid = userManager.create("test", "54ABCd9bf#")
+uuid = userManager.create("test", "54ABCd9bf#").uuid
 
 print("New user uuid:", uuid)
 
 # 删除新用户
-if isinstance(uuid, str):
-    userManager.delete([uuid])
-else:
-    # 在比较旧的版本中，创建用户时不会返回uuid，需要手动查找
-    userManager.search(username="test").data[0].delete()
+userManager.delete([uuid])

mcsmapi/apis/daemon.py

@@ -10,8 +10,7 @@ def show() -> list[DaemonConfig]:
         """
         获取全部节点配置信息
 
-        返回:
-        - List[DaemonConfig]: 节点的配置信息列表
+        :returns: 节点的配置信息列表
         """
         daemons = send(
             "GET",
@@ -24,8 +23,7 @@ def system() -> list[DaemonModel]:
         """
         获取全部节点的系统信息
 
-        返回:
-        - List[DaemonModel]: 节点系统信息列表
+        :returns: 节点系统信息列表
         """
         daemons = send(
             "GET",
@@ -36,64 +34,59 @@ def system() -> list[DaemonModel]:
     @staticmethod
     def add(config: dict[str, Any]) -> str:
         """
-        新增一个节点。
+        新增一个节点
 
-        参数:
-        - config (dict): 节点的配置信息，以字典形式提供，缺失内容由DaemonConfig模型补全。
+        :params config: 节点的配置信息，以字典形式提供，缺失内容由DaemonConfig模型补全
 
-        返回:
-        - str: 新增节点的ID
+        :returns: 新增节点的UUID
         """
         return send(
             "POST",
             f"{ApiPool.SERVICE}/remote_service",
-            data=DaemonConfig(**config).dict(),
+            data=DaemonConfig(**config).model_dump(),
         )
+
     @staticmethod
     def delete(daemonId: str) -> bool:
         """
-        删除一个节点。
+        删除一个节点
 
-        参数:
-        - daemonId (str): 节点的唯一标识符。
+        :params daemonId: 节点的UUID
 
-        返回:
-        - bool: 删除成功后返回True
+        :returns: 删除成功后返回True
         """
         return send(
             "DELETE", f"{ApiPool.SERVICE}/remote_service", params={"uuid": daemonId}
         )
+
     @staticmethod
     def link(daemonId: str) -> bool:
         """
-        连接一个节点。
+        连接一个节点
 
-        参数:
-        - daemonId (str): 节点的唯一标识符。
+        :params daemonId: 节点的UUID
 
-        返回:
-        - bool: 连接成功后返回True
+        :returns: 连接成功后返回True
         """
         return send(
             "GET", f"{ApiPool.SERVICE}/link_remote_service", params={"uuid": daemonId}
         )
+
     @staticmethod
     def update(daemonId: str, config: dict[str, Any]) -> bool:
         """
-        更新一个节点的配置。
+        更新一个节点的配置
 
-        **不建议直接使用此函数，建议调用overview()后在remote属性内使用updateConfig方法按需更新**
+        **不建议直接使用此函数，建议调用overview()后在remote属性内使用节点对象的updateConfig方法按需更新**
 
-        参数:
-        - daemonId (str): 节点的唯一标识符。
-        - config (dict): 节点的配置信息，以字典形式提供，缺失内容由DaemonConfig模型补全。
+        :params daemonId: 节点的UUID
+        :params config: 节点的配置信息，以字典形式提供，缺失内容由DaemonConfig模型补全
 
-        返回:
-        - bool: 更新成功后返回True
+        :returns: 更新成功后返回True
         """
         return send(
             "PUT",
             f"{ApiPool.SERVICE}/remote_service",
             params={"uuid": daemonId},
-            data=DaemonConfig(**config).dict(),
+            data=DaemonConfig(**config).model_dump(),
         )