tendQuant 0.1.0__tar.gz

tendquant-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tendQuant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tendquant-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include pyproject.toml
+include setup.py
+recursive-include tendquant *.py

tendquant-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.1
+Name: tendQuant
+Version: 0.1.0
+Summary: A MQTT client library for tendQuant
+Home-page: https://github.com/top2189/tendQuant
+Author: tendQuant
+Author-email: tendQuant <fengyuan2189@gmail.com>
+Project-URL: Homepage, https://github.com/top2189/tendQuant
+Project-URL: Bug Tracker, https://github.com/top2189/tendQuant/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: paho-mqtt>=2.0.0
+
+# tendQuant
+
+A MQTT client library for tendQuant, supporting MQTTv5 and WebSocket.
+
+## Features
+
+- **MQTTv5 Support**: Default use MQTTv5 protocol
+- **WebSocket Support**: Support WebSocket connection
+- **Auto Reconnect**: Automatic reconnection when disconnected
+- **Easy API**: Simple subscribe/unsubscribe interface
+- **Error Handling**: Detailed error messages and handling
+
+## Installation
+
+```bash
+pip install tendQuant
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from tendquant import MQTTClient
+
+# Create client instance
+client = MQTTClient(
+    broker="quant.top2189.cn",
+    port=80,
+    username="test",
+    password="test",
+    use_ws=True,
+    ws_path="/ws"
+)
+
+# Connect to broker
+client.connect()
+
+# Subscribe to topics
+client.subscribe("lv1/tradeList/600089")
+client.subscribe("lv1/tradeList/600111")
+
+# Publish message
+client.publish("test/topic", "Hello, MQTT!")
+
+# Unsubscribe
+client.unsubscribe("lv1/tradeList/600089")
+
+# Disconnect
+client.disconnect()
+```
+
+### Custom Message Handler
+
+```python
+from tendquant import MQTTClient
+import json
+
+def custom_on_message(client, userdata, msg):
+    topic = msg.topic
+    payload = msg.payload.decode('utf-8')
+    data = json.loads(payload)
+    print(f"Received message on {topic}: {data}")
+
+# Create client
+client = MQTTClient("quant.top2189.cn", 80, use_ws=True, ws_path="/ws")
+
+# Set custom message handler
+client.client.on_message = custom_on_message
+
+# Connect
+client.connect()
+```
+
+## API Reference
+
+### MQTTClient
+
+#### __init__(broker, port, username=None, password=None, keepalive=60, use_ws=False, ws_path="/mqtt")
+
+Create a new MQTT client instance.
+
+- `broker`: MQTT broker address
+- `port`: MQTT broker port
+- `username`: Username for authentication
+- `password`: Password for authentication
+- `keepalive`: Keepalive interval in seconds
+- `use_ws`: Use WebSocket protocol
+- `ws_path`: WebSocket path
+
+#### connect()
+
+Connect to MQTT broker.
+
+#### subscribe(topic, qos=1)
+
+Subscribe to a topic.
+
+- `topic`: Topic to subscribe
+- `qos`: Quality of Service level (0, 1, 2)
+
+#### unsubscribe(topic)
+
+Unsubscribe from a topic.
+
+- `topic`: Topic to unsubscribe
+
+#### publish(topic, payload, qos=0, retain=False)
+
+Publish a message to a topic.
+
+- `topic`: Topic to publish
+- `payload`: Message payload
+- `qos`: Quality of Service level
+- `retain`: Retain message
+
+#### disconnect()
+
+Disconnect from MQTT broker.
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

tendquant-0.1.0/README.md

@@ -0,0 +1,127 @@
+# tendQuant
+
+A MQTT client library for tendQuant, supporting MQTTv5 and WebSocket.
+
+## Features
+
+- **MQTTv5 Support**: Default use MQTTv5 protocol
+- **WebSocket Support**: Support WebSocket connection
+- **Auto Reconnect**: Automatic reconnection when disconnected
+- **Easy API**: Simple subscribe/unsubscribe interface
+- **Error Handling**: Detailed error messages and handling
+
+## Installation
+
+```bash
+pip install tendQuant
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from tendquant import MQTTClient
+
+# Create client instance
+client = MQTTClient(
+    broker="quant.top2189.cn",
+    port=80,
+    username="test",
+    password="test",
+    use_ws=True,
+    ws_path="/ws"
+)
+
+# Connect to broker
+client.connect()
+
+# Subscribe to topics
+client.subscribe("lv1/tradeList/600089")
+client.subscribe("lv1/tradeList/600111")
+
+# Publish message
+client.publish("test/topic", "Hello, MQTT!")
+
+# Unsubscribe
+client.unsubscribe("lv1/tradeList/600089")
+
+# Disconnect
+client.disconnect()
+```
+
+### Custom Message Handler
+
+```python
+from tendquant import MQTTClient
+import json
+
+def custom_on_message(client, userdata, msg):
+    topic = msg.topic
+    payload = msg.payload.decode('utf-8')
+    data = json.loads(payload)
+    print(f"Received message on {topic}: {data}")
+
+# Create client
+client = MQTTClient("quant.top2189.cn", 80, use_ws=True, ws_path="/ws")
+
+# Set custom message handler
+client.client.on_message = custom_on_message
+
+# Connect
+client.connect()
+```
+
+## API Reference
+
+### MQTTClient
+
+#### __init__(broker, port, username=None, password=None, keepalive=60, use_ws=False, ws_path="/mqtt")
+
+Create a new MQTT client instance.
+
+- `broker`: MQTT broker address
+- `port`: MQTT broker port
+- `username`: Username for authentication
+- `password`: Password for authentication
+- `keepalive`: Keepalive interval in seconds
+- `use_ws`: Use WebSocket protocol
+- `ws_path`: WebSocket path
+
+#### connect()
+
+Connect to MQTT broker.
+
+#### subscribe(topic, qos=1)
+
+Subscribe to a topic.
+
+- `topic`: Topic to subscribe
+- `qos`: Quality of Service level (0, 1, 2)
+
+#### unsubscribe(topic)
+
+Unsubscribe from a topic.
+
+- `topic`: Topic to unsubscribe
+
+#### publish(topic, payload, qos=0, retain=False)
+
+Publish a message to a topic.
+
+- `topic`: Topic to publish
+- `payload`: Message payload
+- `qos`: Quality of Service level
+- `retain`: Retain message
+
+#### disconnect()
+
+Disconnect from MQTT broker.
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

tendquant-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tendQuant"
+version = "0.1.0"
+authors = [
+  { name="tendQuant", email="fengyuan2189@gmail.com" }
+]
+description = "A MQTT client library for tendQuant"
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+  "paho-mqtt>=2.0.0",
+]
+
+[project.scripts]
+tendquant = "tendquant.cli:main"
+
+[project.urls]
+"Homepage" = "https://github.com/top2189/tendQuant"
+"Bug Tracker" = "https://github.com/top2189/tendQuant/issues"

tendquant-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tendquant-0.1.0/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="tendQuant",
+    version="0.1.0",
+    author="tendQuant",
+    author_email="fengyuan2189@gmail.com",
+    description="A MQTT client library for tendQuant",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/top2189/tendQuant",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "paho-mqtt>=2.0.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "tendquant = tendquant.cli:main",
+        ],
+    },
+    include_package_data=True,
+)

tendquant-0.1.0/tendQuant.egg-info/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.1
+Name: tendQuant
+Version: 0.1.0
+Summary: A MQTT client library for tendQuant
+Home-page: https://github.com/top2189/tendQuant
+Author: tendQuant
+Author-email: tendQuant <fengyuan2189@gmail.com>
+Project-URL: Homepage, https://github.com/top2189/tendQuant
+Project-URL: Bug Tracker, https://github.com/top2189/tendQuant/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: paho-mqtt>=2.0.0
+
+# tendQuant
+
+A MQTT client library for tendQuant, supporting MQTTv5 and WebSocket.
+
+## Features
+
+- **MQTTv5 Support**: Default use MQTTv5 protocol
+- **WebSocket Support**: Support WebSocket connection
+- **Auto Reconnect**: Automatic reconnection when disconnected
+- **Easy API**: Simple subscribe/unsubscribe interface
+- **Error Handling**: Detailed error messages and handling
+
+## Installation
+
+```bash
+pip install tendQuant
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from tendquant import MQTTClient
+
+# Create client instance
+client = MQTTClient(
+    broker="quant.top2189.cn",
+    port=80,
+    username="test",
+    password="test",
+    use_ws=True,
+    ws_path="/ws"
+)
+
+# Connect to broker
+client.connect()
+
+# Subscribe to topics
+client.subscribe("lv1/tradeList/600089")
+client.subscribe("lv1/tradeList/600111")
+
+# Publish message
+client.publish("test/topic", "Hello, MQTT!")
+
+# Unsubscribe
+client.unsubscribe("lv1/tradeList/600089")
+
+# Disconnect
+client.disconnect()
+```
+
+### Custom Message Handler
+
+```python
+from tendquant import MQTTClient
+import json
+
+def custom_on_message(client, userdata, msg):
+    topic = msg.topic
+    payload = msg.payload.decode('utf-8')
+    data = json.loads(payload)
+    print(f"Received message on {topic}: {data}")
+
+# Create client
+client = MQTTClient("quant.top2189.cn", 80, use_ws=True, ws_path="/ws")
+
+# Set custom message handler
+client.client.on_message = custom_on_message
+
+# Connect
+client.connect()
+```
+
+## API Reference
+
+### MQTTClient
+
+#### __init__(broker, port, username=None, password=None, keepalive=60, use_ws=False, ws_path="/mqtt")
+
+Create a new MQTT client instance.
+
+- `broker`: MQTT broker address
+- `port`: MQTT broker port
+- `username`: Username for authentication
+- `password`: Password for authentication
+- `keepalive`: Keepalive interval in seconds
+- `use_ws`: Use WebSocket protocol
+- `ws_path`: WebSocket path
+
+#### connect()
+
+Connect to MQTT broker.
+
+#### subscribe(topic, qos=1)
+
+Subscribe to a topic.
+
+- `topic`: Topic to subscribe
+- `qos`: Quality of Service level (0, 1, 2)
+
+#### unsubscribe(topic)
+
+Unsubscribe from a topic.
+
+- `topic`: Topic to unsubscribe
+
+#### publish(topic, payload, qos=0, retain=False)
+
+Publish a message to a topic.
+
+- `topic`: Topic to publish
+- `payload`: Message payload
+- `qos`: Quality of Service level
+- `retain`: Retain message
+
+#### disconnect()
+
+Disconnect from MQTT broker.
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

tendquant-0.1.0/tendQuant.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+tendQuant.egg-info/PKG-INFO
+tendQuant.egg-info/SOURCES.txt
+tendQuant.egg-info/dependency_links.txt
+tendQuant.egg-info/entry_points.txt
+tendQuant.egg-info/requires.txt
+tendQuant.egg-info/top_level.txt
+tendquant/__init__.py
+tendquant/cli.py
+tendquant/mqtt_client.py

tendquant-0.1.0/tendQuant.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tendquant-0.1.0/tendQuant.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tendquant = tendquant.cli:main

tendquant-0.1.0/tendQuant.egg-info/requires.txt

@@ -0,0 +1 @@
+paho-mqtt>=2.0.0

tendquant-0.1.0/tendQuant.egg-info/top_level.txt

@@ -0,0 +1 @@
+tendquant

tendquant-0.1.0/tendquant/__init__.py

@@ -0,0 +1,7 @@
+from .mqtt_client import MQTTClient
+
+__version__ = "0.1.0"
+__author__ = "tendQuant"
+__email__ = "fengyuan2189@gmail.com"
+
+__all__ = ["MQTTClient"]

tendquant-0.1.0/tendquant/cli.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+tendQuant CLI tool
+"""
+import argparse
+from .mqtt_client import MQTTClient
+
+def main():
+    parser = argparse.ArgumentParser(description="tendQuant MQTT Client CLI")
+    parser.add_argument("--broker", help="MQTT broker address")
+    parser.add_argument("--port", type=int, help="MQTT broker port")
+    parser.add_argument("--username", help="MQTT username")
+    parser.add_argument("--password", help="MQTT password")
+    parser.add_argument("--use-ws", action="store_true", help="Use WebSocket protocol")
+    parser.add_argument("--ws-path", default="/mqtt", help="WebSocket path")
+    parser.add_argument("--subscribe", help="Topic to subscribe")
+    parser.add_argument("--publish", help="Message to publish")
+    parser.add_argument("--topic", help="Topic for publishing")
+    
+    args = parser.parse_args()
+    
+    # Create client
+    client = MQTTClient(
+        broker=args.broker,
+        port=args.port,
+        username=args.username,
+        password=args.password,
+        use_ws=args.use_ws,
+        ws_path=args.ws_path
+    )
+    
+    # Connect
+    client.connect()
+    
+    # Subscribe
+    if args.subscribe:
+        client.subscribe(args.subscribe)
+        print(f"Subscribed to {args.subscribe}")
+    
+    # Publish
+    if args.publish and args.topic:
+        client.publish(args.topic, args.publish)
+        print(f"Published to {args.topic}: {args.publish}")
+    
+    # Keep running
+    try:
+        while True:
+            pass
+    except KeyboardInterrupt:
+        client.disconnect()
+        print("\nDisconnected")
+
+if __name__ == "__main__":
+    main()

tendquant-0.1.0/tendquant/mqtt_client.py

@@ -0,0 +1,181 @@
+import paho.mqtt.client as mqtt
+import random
+import string
+import time
+
+class MQTTClient:
+    def __init__(self, broker, port, username=None, password=None, keepalive=60, use_ws=True, ws_path="/mqtt"):
+        self.broker = broker
+        self.port = port
+        self.username = username
+        self.password = password
+        self.keepalive = keepalive
+        self.use_ws = use_ws
+        self.ws_path = ws_path
+        self.client = None
+        self.connected = False
+        
+        # 生成随机CLIENT_ID
+        self.client_id = self._generate_client_id()
+        
+        # 初始化客户端
+        self._init_client()
+        
+    def _generate_client_id(self):
+        # 生成随机字符串作为CLIENT_ID
+        return 'mqtt-client-' + ''.join(random.choices(string.ascii_letters + string.digits, k=10))
+    
+    def _init_client(self):
+        # 使用MqttV5版本和VERSION2回调API
+        self.client = mqtt.Client(
+            callback_api_version=mqtt.CallbackAPIVersion.VERSION2,
+            transport="websockets" if self.use_ws else "tcp",
+            client_id=self.client_id,
+            protocol=mqtt.MQTTv5
+        )
+        
+        # 设置用户名和密码
+        if self.username and self.password:
+            self.client.username_pw_set(self.username, self.password)
+        
+        # 如果使用WebSocket协议
+        if self.use_ws:
+            self.client.ws_set_options(path=self.ws_path)
+        
+        # 设置回调函数
+        self.client.on_connect = self._on_connect
+        self.client.on_disconnect = self._on_disconnect
+        self.client.on_message = self._on_message
+        
+    def _on_connect(self, client, userdata, flags, rc, properties=None):
+        if rc == 0:
+            print(f">>> 成功连接到行情服务器")
+            self.connected = True
+            
+            # 计算连接延迟
+            if hasattr(self, 'connect_start_time'):
+                connect_delay = time.time() - self.connect_start_time
+                print(f">>> 连接延迟: {connect_delay:.2f} 秒")
+            
+            # 重新订阅之前的主题
+            if hasattr(self, 'subscribed_topics'):
+                for topic, qos in self.subscribed_topics:
+                    client.subscribe(topic, qos)
+                    print(f">>> 已订阅主题: {topic}")
+        else:
+            print(f"!!! 连接失败，错误码: {rc}")
+    
+    def _on_disconnect(self, client, *args, **kwargs):
+        """断开连接回调"""
+        # args 通常包含 (userdata, rc, properties)
+        # 我们尝试获取 rc，它是第二个参数 (索引为1)
+        rc = 0
+        if len(args) >= 2:
+            rc = args[1]
+        
+        if rc != 0:
+            print(f"### 意外断开连接，错误码: {rc}")
+        else:
+            print("### 连接已正常关闭")
+            
+        self.connected = False
+        # 尝试重连
+        self._reconnect()
+    
+    def _on_message(self, client, userdata, msg):
+        # 默认消息处理，可以在子类中重写
+        print(f"Received message on topic {msg.topic}: {msg.payload.decode()}")
+    
+    def _reconnect(self):
+        while not self.connected:
+            try:
+                print(f"### 已断线，尝试重连中")
+                self.client.reconnect()
+                self.connected = True
+            except Exception as e:
+                print(f"Reconnection failed: {e}")
+                time.sleep(5)
+    
+    def connect(self, on_message=None):
+        try:
+            # 设置消息回调
+            if on_message:
+                self.client.on_message = on_message
+            
+            # 配置 MQTT 5 连接属性
+            connect_props = mqtt.Properties(mqtt.PacketTypes.CONNECT)
+            connect_props.SessionExpiryInterval = 0
+            
+            # 记录连接开始时间
+            self.connect_start_time = time.time()
+            
+            # print(f"正在连接到 {self.broker}:{self.port} (Path: {self.ws_path if self.use_ws else 'TCP'}) ...")
+            self.client.connect(self.broker, self.port, self.keepalive, properties=connect_props)
+            self.client.loop_start()
+
+            time.sleep(2)
+            
+            return None
+        except Exception as e:
+            print(f"发生错误: {e}")
+            self._reconnect()
+            return None
+    
+    def subscribe(self, topic, qos=1):
+        if self.connected:
+            try:
+                result, mid = self.client.subscribe(topic, qos)
+                if result == mqtt.MQTT_ERR_SUCCESS:
+                    # 保存订阅的主题以便重连后重新订阅
+                    if not hasattr(self, 'subscribed_topics'):
+                        self.subscribed_topics = set()
+                    self.subscribed_topics.add((topic, qos))
+                    print(f">>> 已订阅主题: {topic}")
+                else:
+                    error_messages = {
+                        mqtt.MQTT_ERR_NO_CONN: "未连接到MQTT broker",
+                        mqtt.MQTT_ERR_QUEUE_SIZE: "队列已满",
+                        mqtt.MQTT_ERR_INVAL: "无效参数",
+                        mqtt.MQTT_ERR_NOMEM: "内存不足",
+                        mqtt.MQTT_ERR_PROTOCOL: "协议错误",
+                        mqtt.MQTT_ERR_NOT_SUPPORTED: "不支持的操作",
+                        mqtt.MQTT_ERR_TLS: "TLS错误",
+                        mqtt.MQTT_ERR_PAYLOAD_SIZE: "负载大小超出限制",
+                        mqtt.MQTT_ERR_NOT_AUTHORIZED: "未授权访问",
+                        mqtt.MQTT_ERR_UNKNOWN: "未知错误"
+                    }
+                    error_msg = error_messages.get(result, f"错误码: {result}")
+                    print(f"!!! 订阅失败: {error_msg}")
+            except Exception as e:
+                print(f"!!! 订阅时出错: {e}")
+        else:
+            print("!!! 未连接到MQTT broker")
+    
+    def unsubscribe(self, topic):
+        if self.connected:
+            try:
+                result, mid = self.client.unsubscribe(topic)
+                if result == mqtt.MQTT_ERR_SUCCESS:
+                    # 从保存的主题中移除
+                    if hasattr(self, 'subscribed_topics'):
+                        # 移除所有匹配该主题的订阅
+                        self.subscribed_topics = {(t, q) for t, q in self.subscribed_topics if t != topic}
+                    print(f">>> 已取消订阅主题: {topic}")
+                else:
+                    print(f"!!! 取消订阅失败，错误码: {result}")
+            except Exception as e:
+                print(f"!!! 取消订阅时出错: {e}")
+        else:
+            print("!!! 未连接到MQTT broker")
+    
+    def publish(self, topic, payload, qos=0, retain=False):
+        if self.connected:
+            self.client.publish(topic, payload, qos, retain)
+        else:
+            print("!!! 未连接到MQTT broker")
+    
+    def disconnect(self):
+        self.client.loop_stop()
+        self.client.disconnect()
+        self.connected = False
+        print("### 已断开与行情服务器的连接")