利用 MaaS 平台 API 构建本地智能 AI 助手

这里主要涉及两个变量的修改：一个是 api_key，另一个是 model 参数。你可以在模型的详情页查看具体的名称格式，例如 /maas/deepseek-ai/DeepSeek-R1。部分平台还会提供免费的额度或 Token 测试资源，建议先查阅文档了解计费规则。

构建本地对话界面

为了获得更好的交互体验，我们可以结合 PyQt6 编写一个桌面客户端。这不仅能展示文本流式输出，还能处理用户的输入历史。

核心逻辑说明

• 多线程处理：网络请求放在子线程运行，避免阻塞 UI 主线程。
• 流式响应：接收数据时实时渲染，提升用户体验。
• 错误处理：捕获异常并在界面上提示用户。

下面是完整的实现代码，你可以直接参考运行。

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QTextEdit, QPushButton, QHBoxLayout, QLabel, QFrame, QProgressBar
from PyQt6.QtCore import Qt, QThread, pyqtSignal, QSize, QTimer
from PyQt6.QtGui import QClipboard, QMovie
from openai import OpenAI

class ChatWorker(QThread):
    response_received = pyqtSignal(str)
    reasoning_received = pyqtSignal(str)
    error_occurred = pyqtSignal(str)

    def __init__(self, api_key, base_url, messages):
        super().__init__()
        self.api_key = api_key
        self.base_url = base_url
        self.messages = messages

    def run(self):
        try:
            client = OpenAI(
                api_key=self.api_key,
                base_url=self.base_url
            )
            chat_completion = client.chat.completions.create(
                model="/maas/deepseek-ai/DeepSeek-V3",
                messages=self.messages,
                stream=True
            )
            for chunk in chat_completion:
                if hasattr(chunk.choices[0].delta, 'reasoning_content'):
                    self.reasoning_received.emit(chunk.choices[0].delta.reasoning_content)
                if hasattr(chunk.choices[0].delta, 'content'):
                    if chunk.choices[0].delta.content:
                        self.response_received.emit(chunk.choices[0].delta.content)
        except Exception as e:
            self.error_occurred.emit(str(e))

class ChatWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.is_sending = False
        self.initUI()

    def initUI(self):
        self.setWindowTitle('AI 对话界面')
        self.setGeometry(100, 100, 800, 600)
        
        # 设置主窗口样式
        self.setStyleSheet("QMainWindow { background-color: #2b2b2b; }")
        
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        main_layout = QVBoxLayout(central_widget)
        main_layout.setSpacing(15)
        main_layout.setContentsMargins(20, 20, 20, 20)
        
        # 聊天历史区域
        self.chat_history = QTextEdit()
        self.chat_history.setReadOnly(True)
        self.chat_history.setStyleSheet("""
            QTextEdit {
                background-color: #363636;
                border: 1px solid #404040;
                border-radius: 10px;
                padding: 15px;
                color: #ffffff;
            }
        """)
        main_layout.addWidget(self.chat_history, stretch=2)
        
        # 思维链显示区域
        self.reasoning_display = QTextEdit()
        self.reasoning_display.setReadOnly(True)
        self.reasoning_display.setStyleSheet("""
            QTextEdit {
                background-color: #323232;
                border: 1px solid #404040;
                border-radius: 10px;
                padding: 15px;
                color: #b4b4b4;
                font-size: 13px;
            }
        """)
        main_layout.addWidget(self.reasoning_display, stretch=1)
        
        # 输入区域
        input_layout = QHBoxLayout()
        input_layout.setSpacing(10)
        self.input_field = QTextEdit()
        self.input_field.setMaximumHeight(100)
        self.input_field.setStyleSheet("""
            QTextEdit {
                background-color: #363636;
                border: 1px solid #404040;
                border-radius: 8px;
                padding: 8px;
                color: #ffffff;
            }
        """)
        input_layout.addWidget(self.input_field)
        
        send_status_layout = QHBoxLayout()
        send_status_layout.setSpacing(5)
        
        self.send_button = QPushButton('发送')
        self.send_button.setStyleSheet("""
            QPushButton {
                background-color: #4a9eff;
                border: none;
                border-radius: 8px;
                padding: 8px 20px;
                color: white;
                font-weight: bold;
            }
            QPushButton:hover { background-color: #3b8be6; }
            QPushButton:pressed { background-color: #3178cc; }
            QPushButton:disabled { background-color: #666666; }
        """)
        self.send_button.clicked.connect(self.send_message)
        send_status_layout.addWidget(self.send_button)
        
        self.loading_label = QLabel()
        self.loading_movie = QMovie("loading.gif")
        self.loading_movie.setScaledSize(QSize(20, 20))
        self.loading_label.setMovie(self.loading_movie)
        self.loading_label.hide()
        send_status_layout.addWidget(self.loading_label)
        
        input_layout.addLayout(send_status_layout)
        main_layout.addLayout(input_layout)
        
        # 配置信息（请替换为真实值）
        self.api_key = "YOUR_API_KEY"
        self.base_url = "https://your-provider.com/v1"

    def send_message(self):
        if self.is_sending:
            return
        user_message = self.input_field.toPlainText().strip()
        if not user_message:
            return
        
        self.is_sending = True
        self.send_button.setEnabled(False)
        self.loading_label.show()
        self.loading_movie.start()
        
        self.input_field.clear()
        self.reasoning_display.clear()
        
        message_html = self.create_message_bubble(user_message, is_user=True)
        cursor = self.chat_history.textCursor()
        cursor.movePosition(cursor.MoveOperation.End)
        cursor.insertHtml(message_html)
        
        messages = [{"role": "user", "content": user_message}]
        
        self.worker = ChatWorker(self.api_key, self.base_url, messages)
        self.worker.response_received.connect(self.handle_response)
        self.worker.reasoning_received.connect(self.handle_reasoning)
        self.worker.error_occurred.connect(self.handle_error)
        self.worker.start()

    def create_message_bubble(self, text, is_user=True):
        background_color = '#404040' if is_user else '#1a5fb4'
        alignment = 'right' if is_user else 'left'
        html = f'''<div><div style="background-color: {background_color}; padding: 10px; border-radius: 8px;">{text}</div></div>'''
        return html

    def handle_response(self, response):
        if not hasattr(self, 'accumulated_response'):
            self.accumulated_response = ''
            self.response_timer = QTimer()
            self.response_timer.setSingleShot(True)
            self.response_timer.timeout.connect(self.display_accumulated_response)
        
        self.accumulated_response += response
        self.response_timer.start(1000)

    def display_accumulated_response(self):
        if not self.accumulated_response.strip():
            return
        message_html = self.create_message_bubble(self.accumulated_response, is_user=False)
        cursor = self.chat_history.textCursor()
        cursor.movePosition(cursor.MoveOperation.End)
        cursor.insertHtml(message_html)
        self.chat_history.verticalScrollBar().setValue(self.chat_history.verticalScrollBar().maximum())
        self.accumulated_response = ''
        self.is_sending = False
        self.send_button.setEnabled(True)
        self.loading_label.hide()
        self.loading_movie.stop()

    def handle_reasoning(self, reasoning):
        self.reasoning_display.insertPlainText(reasoning)

    def handle_error(self, error_message):
        error_html = f'<div style="color: red;">错误：{error_message}</div>'
        self.chat_history.append(error_html)
        self.is_sending = False
        self.send_button.setEnabled(True)
        self.loading_label.hide()
        self.loading_movie.stop()

def main():
    app = QApplication(sys.argv)
    window = ChatWindow()
    window.show()
    sys.exit(app.exec())

if __name__ == '__main__':
    main()

总结

通过 MaaS 平台的 API 接口，开发者可以非常便捷地在本地构建具备对话能力的 AI 应用。相比于传统的模型部署方式，这种模式省去了复杂的底层算法钻研，只需按照文档进行简单的接口调用即可。

此外，这类 API 通常具有良好的跨平台兼容性，无论是 Windows、Linux 还是 macOS，甚至移动端系统，都能顺利集成。只要掌握了基本的 API 调用逻辑，就能快速开发出属于自己的智能助手。