refactor(mcsmapi): 优化代码结构和文档

- 移除函数返回类型注解
- 统一代码格式
- 修改部分函数描述，使其更加准确
- 在 InstanceDetail 类中添加 command 和 get_output 方法

Author: molanp

mcsmapi/__init__.py

@@ -11,14 +11,14 @@
 
 class MCSMAPI:
 
-    def __init__(self, url: str, timeout: int = 5) -> None:
+    def __init__(self, url: str, timeout: int = 5):
         split_url = urllib.parse.urlsplit(url)
         Request.set_mcsm_url(
             urllib.parse.urljoin(f"{split_url.scheme}://{split_url.netloc}", "")
         )
         Request.set_timeout(timeout)
 
-    def login(self, username: str, password: str) -> "MCSMAPI":
+    def login(self, username: str, password: str):
         Request.set_token(
             Request.send(
                 "POST",
@@ -34,20 +34,20 @@ def login_with_apikey(self, apikey: str):
         self.authentication = "apikey"
         return self
 
-    def overview(self) -> Overview:
+    def overview(self):
         return Overview()
 
-    def instance(self) -> Instance:
+    def instance(self):
         return Instance()
 
-    def user(self) -> User:
+    def user(self) :
         return User()
 
-    def daemon(self) -> Daemon:
+    def daemon(self):
         return Daemon()
 
-    def file(self) -> File:
+    def file(self):
         return File()
 
-    def image(self) -> Image:
+    def image(self):
         return Image()

mcsmapi/apis/instance.py

@@ -94,7 +94,7 @@ def updateConfig(daemonId: str, uuid: str, config: dict[str, Any]) -> str:
         :params uuid: 实例的UUID
         :params config: 新的实例配置，以字典形式提供，缺失内容由InstanceConfig模型补全
 
-        :returns: 更新成功后返回更新的实例UUID
+        :returns: 被更新配置的实例UUID
         """
         result = send(
             "PUT",
@@ -109,7 +109,7 @@ def delete(daemonId: str, uuids: list[str], deleteFile: bool = False) -> list[st
         """
         删除实例
 
-        :params daemonId: 节点的标识符
+        :params daemonId: 节点的UUID
         :params uuids: 要删除的实例UUID列表
         :params deleteFile: 是否删除关联的文件
 
@@ -130,7 +130,7 @@ def start(daemonId: str, uuid: str) -> str:
         :params daemonId: 节点的UUID
         :params uuid: 实例的UUID
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被启动的实例的UUID
         """
         result = send(
             "GET",
@@ -147,7 +147,7 @@ def stop(daemonId: str, uuid: str) -> str:
         :params daemonId: 节点的UUID
         :params uuid: 实例的UUID
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被关闭的实例的UUID
         """
         result = send(
             "GET",
@@ -164,7 +164,7 @@ def restart(daemonId: str, uuid: str) -> str:
         :params daemonId: 节点的UUID
         :params uuid: 实例的UUID
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被重启的实例的UUID
         """
         result = send(
             "GET",
@@ -181,7 +181,7 @@ def kill(daemonId: str, uuid: str) -> str:
         :params daemonId: 节点的UUID
         :params uuid: 实例的UUID
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被强制关闭的实例的UUID
         """
         result = send(
             "GET",
@@ -230,7 +230,7 @@ def command(daemonId: str, uuid: str, command: str) -> str:
         :params uuid: 实例的UUID
         :params command: 要发送的命令
 
-        :params: 返回被操作的实例的UUID
+        :returns: 被操作的实例的UUID
         """
         result = send(
             "GET",

mcsmapi/models/instance.py

@@ -179,7 +179,7 @@ def start(self):
         """
         启动该实例
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被启动的实例的UUID
         """
         from mcsmapi.apis.instance import Instance
 
@@ -189,7 +189,7 @@ def stop(self):
         """
         停止该实例
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被停止的实例的UUID
         """
         from mcsmapi.apis.instance import Instance
 
@@ -199,7 +199,7 @@ def restart(self):
         """
         重启该实例
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被重启的实例的UUID
         """
         from mcsmapi.apis.instance import Instance
 
@@ -209,7 +209,7 @@ def kill(self):
         """
         强制关闭该实例
 
-        :returns: 返回被操作的实例的UUID
+        :returns: 被强制关闭的实例的UUID
         """
         from mcsmapi.apis.instance import Instance
 
@@ -268,6 +268,30 @@ def reinstall(self, targetUrl: str, title: str = "", description: str = ""):
             self.daemonId, self.instanceUuid, targetUrl, title, description
         )
 
+    def command(self, command: str) -> str:
+        """
+        发送命令给实例。
+
+        :params command: 要发送的命令
+
+        :returns: 被操作的实例的UUID
+        """
+        from mcsmapi.apis.instance import Instance
+
+        return Instance.command(self.daemonId, self.instanceUuid, command)
+
+    def get_output(self, size: int | None = None) -> str:
+        """
+        获取实例的输出。
+
+        :params size: 要获取的输出大小
+
+        :returns: 输出结果
+        """
+        from mcsmapi.apis.instance import Instance
+
+        return Instance.get_output(self.daemonId, self.instanceUuid, size)
+
     def files(
         self, target: str = "", page: int = 0, page_size: int = 100, file_name: str = ""
     ):