docs: add README.md

- Introduced `scale` property across components for responsive design.
- Adjusted dimensions and positions dynamically based on scale.
- Enhanced flexibility for varying display resolutions.

CMakeLists.txt

@@ -2,51 +2,81 @@ cmake_minimum_required(VERSION 4.0)
 project(uno-game)
 
 set(CMAKE_CXX_STANDARD 26)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 
 find_package(nlohmann_json REQUIRED)
 find_package(asio REQUIRED)
 find_package(argparse REQUIRED)
 find_package(Slint REQUIRED)
+find_package(spdlog REQUIRED)
 
+# Uno Game Library
 add_library(uno-game-lib
         src/game/Card.cpp
         src/game/CardTile.cpp
         src/game/Player.cpp
         src/game/GameState.cpp
+        src/common/Logger.cpp
         src/common/Utils.cpp
         src/network/Message.cpp
         src/network/MessageSerializer.cpp
         src/network/NetworkServer.cpp
         src/network/NetworkClient.cpp
-        src/client/UnoClient.cpp
-        src/server/UnoServer.cpp
         src/network/Session.cpp
-        src/client/PlayerAction.cpp
-        src/ui/GameUI.cpp
-)
-target_link_libraries(uno-game-lib
-        PUBLIC nlohmann_json::nlohmann_json
-)
-target_link_libraries(uno-game-lib
-        PUBLIC asio::asio
 )
+target_link_libraries(uno-game-lib PUBLIC nlohmann_json::nlohmann_json)
+target_link_libraries(uno-game-lib PUBLIC asio::asio)
 target_link_libraries(uno-game-lib PUBLIC Slint::Slint)
+target_link_libraries(uno-game-lib PUBLIC argparse::argparse)
+target_link_libraries(uno-game-lib PUBLIC spdlog::spdlog)
+
+# Enable fine-grained spdlog levels: in Debug build, compile-in trace/debug; in others, keep info+
+target_compile_definitions(uno-game-lib PUBLIC
+        $<$<CONFIG:Debug>:SPDLOG_ACTIVE_LEVEL=SPDLOG_LEVEL_TRACE>
+        $<$<NOT:$<CONFIG:Debug>>:SPDLOG_ACTIVE_LEVEL=SPDLOG_LEVEL_INFO>
+)
 
 slint_target_sources(uno-game-lib ui/MainWindow.slint)
 
-add_executable(uno-client src/client/main.cpp)
+# Uno Client
-target_link_libraries(uno-client
+add_executable(uno-client
-        PRIVATE uno-game-lib)
+        src/client/main.cpp
+        src/client/PlayerAction.cpp
+        src/client/UnoClient.cpp
+        src/ui/GameUI.cpp
+        assets/uno.rc
+)
+target_link_libraries(uno-client PRIVATE uno-game-lib)
 
-if (WIN32 AND CMAKE_BUILD_TYPE STREQUAL "DEBUG")
+if (WIN32 AND NOT CMAKE_BUILD_TYPE STREQUAL "Debug")
     set_target_properties(uno-client PROPERTIES WIN32_EXECUTABLE ON)
 endif ()
 
-add_executable(uno-server src/server/main.cpp)
-target_link_libraries(uno-server
-        PRIVATE uno-game-lib)
-target_link_libraries(uno-server
-        PRIVATE argparse::argparse
-)
 
+# Uno Server
+add_executable(uno-server
+        src/server/main.cpp
+        src/server/UnoServer.cpp
+        assets/uno.rc
+)
+target_link_libraries(uno-server PRIVATE uno-game-lib)
+
+# Google Test
 add_subdirectory(test)
+
+
+foreach (target uno-client uno-server)
+    # 复制动态库
+    add_custom_command(TARGET ${target} POST_BUILD
+            COMMAND ${CMAKE_COMMAND} -E copy_if_different
+            $<TARGET_RUNTIME_DLLS:${target}>
+            $<TARGET_FILE_DIR:${target}>
+            COMMAND_EXPAND_LISTS
+    )
+    # 复制资源文件
+    add_custom_command(TARGET ${target} POST_BUILD
+            COMMAND ${CMAKE_COMMAND} -E copy_directory
+            ${CMAKE_SOURCE_DIR}/assets
+            $<TARGET_FILE_DIR:${target}>/assets
+    )
+endforeach ()

README.md

@@ -0,0 +1,32 @@
+# UNO
+
+这是一个使用 C++ 编写的现代化 GUI 的 UNO 游戏。
+
+## 快速开始
+
+### 预构建二进制
+
+从 Release 中下载可执行文件，运行服务端后，使用客户端连接上即可游玩。
+
+### 从源码构建
+
+1. 确保你已经安装有 CMake + Visual Studio
+2. 使用 vcpkg 或其他工具安装以下依赖：argparse, asio, nlohmann-json, spdlog, slint
+3. 激活 Visual Studio 环境变量
+4. 执行以下代码构建：
+
+```shell
+mkdir build
+cd build
+cmake ..
+cmake --build .
+```
+
+## TODO
+
+- [ ] 添加喊 UNO 相关功能
+- [ ] 完善客户端和服务端对异常的处理，加强鲁棒性
+
+## 许可证
+
+[MIT](./LICENSE)

assets/uno.rc

@@ -0,0 +1 @@
+IDI_ICON1 ICON "uno.ico"

src/client/UnoClient.cpp

@@ -10,11 +10,13 @@
 #include "../network/MessageSerializer.h"
 
 #include <memory>
+#include <spdlog/spdlog.h>
 #include <utility>
 
 namespace UNO::CLIENT {
     void UnoClient::handleNetworkConnected()
     {
+        SPDLOG_INFO("Connected to server, sending JOIN_GAME message");
         NETWORK::JoinGamePayload messagePayload = {this->clientGameState_->getPlayerName()};
         NETWORK::Message message                = {NETWORK::MessageStatus::OK, NETWORK::MessagePayloadType::JOIN_GAME, messagePayload};
         networkClient_->send(NETWORK::MessageSerializer::serialize(message));
@@ -25,11 +27,14 @@ namespace UNO::CLIENT {
 
     void UnoClient::handleNetworkInitGame(const NETWORK::InitGamePayload &payload)
     {
+        SPDLOG_INFO("Initializing game: player ID={}, {} players total", payload.playerId, payload.players.size());
         this->clientGameState_->init(payload.players, payload.discardPile, payload.handCard, payload.currentPlayerIndex, payload.playerId);
     }
 
     void UnoClient::handleNetworkPlayCard(const NETWORK::PlayCardPayload &payload)
     {
+        SPDLOG_DEBUG(
+            "Received PLAY_CARD: color={}, type={}", static_cast<int>(payload.card.getColor()), static_cast<int>(payload.card.getType()));
         if (clientGameState_->getClientGameStage() == GAME::ClientGameStage::ACTIVE) {
             clientGameState_->play(payload.card);
         }
@@ -38,6 +43,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::handleNetworkDrawCard(const NETWORK::DrawCardPayload &payload)
     {
+        SPDLOG_DEBUG("Received DRAW_CARD: {} card(s)", payload.drawCount);
         if (clientGameState_->getClientGameStage() == GAME::ClientGameStage::ACTIVE) {
             clientGameState_->draw(payload.cards);
         }
@@ -46,12 +52,15 @@ namespace UNO::CLIENT {
 
     void UnoClient::handleNetworkEndGame(const NETWORK::EndGamePayload &payload)
     {
+        SPDLOG_INFO("Game ended");
         this->clientGameState_->endGame();
     }
 
     void UnoClient::handleNetworkMessage(const std::string &message)
     {
         auto networkMessage = NETWORK::MessageSerializer::deserialize(message);
+        SPDLOG_DEBUG("Received network message, type: {}", static_cast<int>(networkMessage.getMessagePayloadType()));
+
         if (networkMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::INIT_GAME) {
             this->handleNetworkInitGame(std::get<NETWORK::InitGamePayload>(networkMessage.getMessagePayload()));
         }
@@ -68,6 +77,7 @@ namespace UNO::CLIENT {
         if (networkMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::EMPTY
             || networkMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::JOIN_GAME
             || networkMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::START_GAME) {
+            SPDLOG_ERROR("Invalid message type from server: {}", static_cast<int>(networkMessage.getMessagePayloadType()));
             throw std::invalid_argument("Invalid message type from server");
         }
 
@@ -76,6 +86,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::handlePlayerAction(PlayerAction action)
     {
+        SPDLOG_DEBUG("Handling player action, type: {}", static_cast<int>(action.playerActionType));
         if (action.playerActionType == PlayerActionType::CONNECT) {
             this->handlePlayerConnect(std::get<PlayerConnectPayload>(action.payload));
         }
@@ -93,6 +104,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::handlePlayerConnect(const PlayerConnectPayload &payload)
     {
+        SPDLOG_INFO("Player '{}' connecting to {}:{}", payload.playerName, payload.host, payload.port);
         clientGameState_->setPlayerName(payload.playerName);
         networkClient_->connect(payload.host, payload.port);
     }
@@ -100,6 +112,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::handlePlayerStartGame(PlayerStartGamePayload payload)
     {
+        SPDLOG_INFO("Player requests to start game");
         NETWORK::StartGamePayload messagePayload = {};
         NETWORK::Message message                 = {NETWORK::MessageStatus::OK, NETWORK::MessagePayloadType::START_GAME, messagePayload};
         networkClient_->send(NETWORK::MessageSerializer::serialize(message));
@@ -115,9 +128,12 @@ namespace UNO::CLIENT {
 
         if ((card->getType() == GAME::CardType::WILD || card->getType() == GAME::CardType::WILDDRAWFOUR)
             && card->getColor() != GAME::CardColor::RED) {
+            SPDLOG_ERROR("Invalid wild card played by player: card doesn't have color set");
             throw std::invalid_argument("Invalid card played by player");
         }
 
+        SPDLOG_INFO("Player plays card: color={}, type={}", card->colorToString(), card->typeToString());
+
         NETWORK::PlayCardPayload messagePayload = {
             {(card->getType() != GAME::CardType::WILD && card->getType() != GAME::CardType::WILDDRAWFOUR) ? card->getColor()
                                                                                                           : payload.color,
@@ -128,6 +144,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::handlePlayerDrawCard(PlayerDrawCardPayload payload)
     {
+        SPDLOG_INFO("Player requests to draw card");
         NETWORK::DrawCardPayload messagePayload = {};
         NETWORK::Message message                = {NETWORK::MessageStatus::OK, NETWORK::MessagePayloadType::DRAW_CARD, messagePayload};
         networkClient_->send(NETWORK::MessageSerializer::serialize(message));
@@ -135,6 +152,7 @@ namespace UNO::CLIENT {
 
     UnoClient::UnoClient()
     {
+        SPDLOG_DEBUG("UnoClient initialized");
         clientGameState_ = std::make_shared<GAME::ClientGameState>();
         networkClient_   = std::make_shared<NETWORK::NetworkClient>(
             [this]() { this->handleNetworkConnected(); }, [this](const std::string &message) { this->handleNetworkMessage(message); });
@@ -143,6 +161,7 @@ namespace UNO::CLIENT {
 
     UnoClient::~UnoClient()
     {
+        SPDLOG_DEBUG("UnoClient shutting down");
         networkClient_->stop();
         if (networkThread_.joinable()) {
             networkThread_.join();
@@ -151,6 +170,7 @@ namespace UNO::CLIENT {
 
     void UnoClient::run()
     {
+        SPDLOG_INFO("UnoClient starting");
         networkThread_ = std::thread([this]() { this->networkClient_->run(); });
         gameUI_->run();
     }

src/client/main.cpp

@@ -1,11 +1,18 @@
 #include "UnoClient.h"
 
+#include "../common/Logger.h"
+#include <spdlog/spdlog.h>
 #include <windows.h>
 
 int main()
 {
+    UNO::COMMON::Logger::init("uno-client");
+    SPDLOG_INFO("Starting uno-client application");
+
     UNO::CLIENT::UnoClient client;
     client.run();
+
+    SPDLOG_INFO("uno-client exited");
     return 0;
 }
 

src/common/Logger.cpp

@@ -0,0 +1,42 @@
+/**
+ * @file Logger.cpp
+ */
+#include "Logger.h"
+
+#include <filesystem>
+#include <memory>
+
+#include <spdlog/sinks/rotating_file_sink.h>
+#include <spdlog/sinks/stdout_color_sinks.h>
+#include <spdlog/spdlog.h>
+
+namespace fs = std::filesystem;
+
+namespace UNO::COMMON {
+    void Logger::init(const std::string &app_name, const std::string &log_dir)
+    {
+        fs::path dir{log_dir};
+        if (!fs::exists(dir)) {
+            fs::create_directories(dir);
+        }
+
+        auto logfile = (dir / (app_name + ".log")).string();
+
+        constexpr std::size_t max_file_size = 5 * 1024 * 1024;
+        constexpr std::size_t max_files     = 3;
+
+        auto rotating_sink = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(logfile, max_file_size, max_files);
+        auto console_sink  = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
+
+        rotating_sink->set_level(spdlog::level::debug);
+        console_sink->set_level(spdlog::level::info);
+
+        std::vector<spdlog::sink_ptr> sinks{rotating_sink, console_sink};
+        auto logger = std::make_shared<spdlog::logger>(app_name, sinks.begin(), sinks.end());
+
+        logger->set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] [%s:%#] [%!] %v");
+
+        spdlog::register_logger(logger);
+        spdlog::set_default_logger(logger);
+    }
+}   // namespace UNO::COMMON

src/common/Logger.h

@@ -0,0 +1,14 @@
+/**
+ * @file Logger.h
+ */
+#pragma once
+
+#include <string>
+
+namespace UNO::COMMON {
+    struct Logger {
+        // Initialize global logging. Safe to call multiple times.
+        // Default log directory aligns with CMake runtime output: <build>/bin/log
+        static void init(const std::string &app_name, const std::string &log_dir = "log");
+    };
+}   // namespace UNO::COMMON

src/game/GameState.cpp

@@ -7,6 +7,7 @@
 #include "GameState.h"
 
 #include <ranges>
+#include <spdlog/spdlog.h>
 #include <stdexcept>
 #include <utility>
 
@@ -136,14 +137,17 @@ namespace UNO::GAME {
     {
         this->players_     = players;
         this->discardPile_ = discardPile;
+        this->drawCount_   = 0;
         player_.draw(std::vector<Card>(handCard.begin(), handCard.end()));
         this->currentPlayer_ = this->players_.begin() + static_cast<int>(currentPlayerIndex);
         this->self_          = this->players_.begin() + static_cast<int>(selfIndex);
         if (this->self_ == this->currentPlayer_) {
             this->clientGameStage_ = ClientGameStage::ACTIVE;
+            SPDLOG_INFO("Client game initialized: {} players, self index: {}, it's our turn", players.size(), selfIndex);
         }
         else {
             this->clientGameStage_ = ClientGameStage::IDLE;
+            SPDLOG_INFO("Client game initialized: {} players, self index: {}, waiting for turn", players.size(), selfIndex);
         }
     }
 
@@ -179,6 +183,7 @@ namespace UNO::GAME {
 
     void ClientGameState::endGame()
     {
+        SPDLOG_INFO("Client game ended");
         this->clientGameStage_ = ClientGameStage::AFTER_GAME;
         this->player_.clear();
     }
@@ -190,19 +195,25 @@ namespace UNO::GAME {
         long long currentPlayerIndex = this->currentPlayer_ - this->players_.begin();
         this->players_.push_back(std::move(playerState));
         this->currentPlayer_ = this->players_.begin() + currentPlayerIndex;
+        SPDLOG_DEBUG("Player '{}' added to game state, total players: {}", playerState.getName(), this->players_.size());
     }
 
     void ServerGameState::init()
     {
+        SPDLOG_INFO("Initializing server game state");
         while (discardPile_.isEmpty() || discardPile_.getFront().getType() > CardType::NUM9) {
             discardPile_.add(deck_.draw());
         }
+        SPDLOG_DEBUG("Initial discard pile card: color={}, type={}",
+                     discardPile_.getFront().colorToString(),
+                     discardPile_.getFront().typeToString());
 
         for (size_t i = 0; i < 7; i++) {
             for (auto &player : this->players_) {
                 player.draw(1, this->deck_.draw(1));
             }
         }
+        SPDLOG_INFO("Dealt 7 cards to each of {} players", this->players_.size());
 
         this->serverGameStage_ = ServerGameStage::IN_GAME;
     }
@@ -212,6 +223,7 @@ namespace UNO::GAME {
         if (this->drawCount_ == 0) {
             this->drawCount_ = 1;
         }
+        SPDLOG_DEBUG("Player '{}' drawing {} card(s)", this->currentPlayer_->getName(), this->drawCount_);
         auto cards = deck_.draw(this->drawCount_);
         this->currentPlayer_->draw(this->drawCount_, cards);
         this->drawCount_ = 0;
@@ -226,6 +238,7 @@ namespace UNO::GAME {
 
     void ServerGameState::endGame()
     {
+        SPDLOG_INFO("Ending server game, returning to pre-game state");
         this->serverGameStage_ = ServerGameStage::PRE_GAME;
         deck_.clear();
 

src/game/GameState.h

@@ -297,6 +297,7 @@ namespace UNO::GAME {
     template<PlayerStateTypeConcept PlayerStateType>
     void GameState<PlayerStateType>::endGame()
     {
+        drawCount_ = 0;
         discardPile_.clear();
         for (auto &player : this->players_) {
             player.clear();

src/network/NetworkClient.cpp

@@ -9,47 +9,63 @@
 #include <asio/connect.hpp>
 #include <iostream>
 #include <memory>
+#include <spdlog/spdlog.h>
 #include <utility>
 
 namespace UNO::NETWORK {
     NetworkClient::NetworkClient(std::function<void()> onConnect, std::function<void(std::string)> callback) :
         onConnected_(std::move(onConnect)), callback_(std::move(callback)), workGuard_(asio::make_work_guard(io_context_))
     {
+        SPDLOG_DEBUG("NetworkClient initialized");
     }
 
     void NetworkClient::connect(const std::string &host, uint16_t port)
     {
+        SPDLOG_INFO("Connecting to {}:{}", host, port);
         auto socket   = std::make_shared<asio::ip::tcp::socket>(io_context_);
         auto resolver = std::make_shared<asio::ip::tcp::resolver>(io_context_);
-        resolver->async_resolve(host,
+        resolver->async_resolve(
-                                std::to_string(port),
+            host,
-                                [this, resolver, socket](const asio::error_code &ec, const asio::ip::tcp::resolver::results_type &results) {
+            std::to_string(port),
-                                    if (!ec) {
+            [this, resolver, socket, host, port](const asio::error_code &ec, const asio::ip::tcp::resolver::results_type &results) {
-                                        asio::async_connect(
+                if (!ec) {
-                                            *socket, results, [this, socket](const asio::error_code &ec, const asio::ip::tcp::endpoint &) {
+                    SPDLOG_DEBUG("Resolved host {}:{}", host, port);
-                                                if (!ec) {
+                    asio::async_connect(
-                                                    this->session_ = std::make_shared<Session>(std::move(*socket));
+                        *socket, results, [this, socket, host, port](const asio::error_code &ec, const asio::ip::tcp::endpoint &) {
-                                                    this->session_->start(callback_);
+                            if (!ec) {
-                                                    this->onConnected_();
+                                SPDLOG_INFO("Successfully connected to {}:{}", host, port);
-                                                }
+                                this->session_ = std::make_shared<Session>(std::move(*socket));
-                                            });
+                                this->session_->start(callback_);
-                                    }
+                                this->onConnected_();
-                                });
+                            }
+                            else {
+                                SPDLOG_ERROR("Failed to connect to {}:{}: {}", host, port, ec.message());
+                            }
+                        });
+                }
+                else {
+                    SPDLOG_ERROR("Failed to resolve host {}:{}: {}", host, port, ec.message());
+                }
+            });
     }
 
 
     void NetworkClient::send(const std::string &message)
     {
+        SPDLOG_DEBUG("Queueing message to send, size: {} bytes", message.size());
         asio::post(io_context_, [session = this->session_, message]() { session->send(message); });
     }
 
     void NetworkClient::run()
     {
+        SPDLOG_INFO("NetworkClient starting io_context loop");
         this->io_context_.run();
+        SPDLOG_INFO("NetworkClient io_context loop stopped");
     }
 
     void NetworkClient::stop()
     {
+        SPDLOG_INFO("NetworkClient stopping");
         this->workGuard_.reset();
         this->io_context_.stop();
     }

src/network/NetworkServer.cpp

@@ -6,6 +6,7 @@
  */
 #include "NetworkServer.h"
 
+#include <spdlog/spdlog.h>
 #include <utility>
 
 namespace UNO::NETWORK {
@@ -13,15 +14,20 @@ namespace UNO::NETWORK {
     {
         this->acceptor_.async_accept([this](const asio::error_code &ec, asio::ip::tcp::socket socket) {
             if (!ec) {
+                SPDLOG_INFO("Accepted new connection from {}", socket.remote_endpoint().address().to_string());
                 this->addPlayer(std::move(socket));
                 accept();
             }
+            else {
+                SPDLOG_ERROR("Accept error: {}", ec.message());
+            }
         });
     }
 
     NetworkServer::NetworkServer(uint16_t port, std::function<void(size_t, std::string)> callback) :
         acceptor_(io_context_, asio::ip::tcp::endpoint(asio::ip::tcp::v4(), port)), playerCount(0), callback_(std::move(callback))
     {
+        SPDLOG_INFO("NetworkServer initialized on port {}", port);
         accept();
     }
 
@@ -32,24 +38,30 @@ namespace UNO::NETWORK {
         this->sessions_[playerId] = std::make_shared<Session>(std::move(socket));
         this->sessions_[playerId]->start([this, playerId](std::string message) { this->callback_(playerId, std::move(message)); });
         this->playerCount++;
+        SPDLOG_INFO("Player {} added, total players: {}", playerId, this->playerCount);
     }
 
     void NetworkServer::send(size_t id, const std::string &message)
     {
         std::lock_guard<std::mutex> lock(this->mutex_);
         if (this->sessions_.contains(id) == false) {
+            SPDLOG_ERROR("Failed to send message: Player session {} not found", id);
             throw std::invalid_argument("Player session not found");
         }
+        SPDLOG_DEBUG("Sending message to player {}, size: {} bytes", id, message.size());
         this->sessions_[id]->send(message);
     }
 
     void NetworkServer::run()
     {
+        SPDLOG_INFO("NetworkServer starting io_context loop");
         this->io_context_.run();
+        SPDLOG_INFO("NetworkServer io_context loop stopped");
     }
 
     void NetworkServer::stop()
     {
+        SPDLOG_INFO("NetworkServer stopping");
         this->acceptor_.close();
         this->io_context_.stop();
     }

src/network/Session.cpp

@@ -6,11 +6,17 @@
  */
 #include "Session.h"
 
+#include <spdlog/spdlog.h>
+
 namespace UNO::NETWORK {
-    Session::Session(asio::ip::tcp::socket socket) : socket_(std::move(socket)) {}
+    Session::Session(asio::ip::tcp::socket socket) : socket_(std::move(socket))
+    {
+        SPDLOG_DEBUG("Session created");
+    }
 
     void Session::start(std::function<void(std::string)> callback)
     {
+        SPDLOG_DEBUG("Session started");
         this->callback_ = std::move(callback);
         this->doRead();
     }
@@ -19,6 +25,7 @@ namespace UNO::NETWORK {
     {
         bool writeInProgress = !this->messages_.empty();
         messages_.push(message);
+        SPDLOG_DEBUG("Message queued for sending, size: {} bytes, queue size: {}", message.size(), messages_.size());
         if (writeInProgress == false) {
             this->doWrite();
         }
@@ -31,13 +38,18 @@ namespace UNO::NETWORK {
                          asio::buffer(messageLength.get(), sizeof(size_t)),
                          [this, self = shared_from_this(), messageLength](const asio::error_code &ec, size_t length) {
                              if (!ec) {
+                                 SPDLOG_TRACE("Read message header, length: {} bytes", *messageLength);
                                  if (*messageLength <= 10 * 1024 * 1024) {
                                      this->doReadBody(*messageLength);
                                  }
                                  else {
+                                     SPDLOG_WARN("Message length {} exceeds limit, skipping", *messageLength);
                                      doRead();
                                  }
                              }
+                             else {
+                                 SPDLOG_DEBUG("Session read error: {}", ec.message());
+                             }
                          });
     }
 
@@ -45,12 +57,16 @@ namespace UNO::NETWORK {
     {
         auto buffer = std::make_shared<std::vector<char>>(length);
         asio::async_read(
-            socket_, asio::buffer(*buffer), [this, self = shared_from_this(), buffer](const asio::error_code &ec, size_t length) {
+            socket_, asio::buffer(*buffer), [this, self = shared_from_this(), buffer, length](const asio::error_code &ec, size_t) {
                 if (!ec) {
                     std::string message = {buffer->begin(), buffer->end()};
+                    SPDLOG_TRACE("Received message body, size: {} bytes", length);
                     this->callback_(message);
                     doRead();
                 }
+                else {
+                    SPDLOG_DEBUG("Session read body error: {}", ec.message());
+                }
             });
     }
 
@@ -62,10 +78,17 @@ namespace UNO::NETWORK {
         auto length = std::make_shared<size_t>(message.size());
         auto msg    = std::make_shared<std::string>(message);
 
+        SPDLOG_TRACE("Sending message, size: {} bytes", *length);
         std::array<asio::const_buffer, 2> buffers = {asio::buffer(length.get(), sizeof(size_t)), asio::buffer(*msg)};
         asio::async_write(socket_, buffers, [this, self = shared_from_this(), length, msg](const asio::error_code &ec, size_t) {
-            if (!ec && this->messages_.empty() == false) {
+            if (!ec) {
-                this->doWrite();
+                SPDLOG_TRACE("Message sent successfully, size: {} bytes", *length);
+                if (this->messages_.empty() == false) {
+                    this->doWrite();
+                }
+            }
+            else {
+                SPDLOG_ERROR("Session write error: {}", ec.message());
             }
         });
     }

src/server/UnoServer.cpp

@@ -7,12 +7,14 @@
 #include "UnoServer.h"
 
 #include "../network/MessageSerializer.h"
+#include <spdlog/spdlog.h>
 
 namespace UNO::SERVER {
     UnoServer::UnoServer(uint16_t port) :
         networkServer_(port, [this](size_t playerId, const std::string &message) { this->handlePlayerMessage(playerId, message); }),
         playerCount(0)
     {
+        SPDLOG_INFO("UnoServer initialized on port {}", port);
     }
 
     void UnoServer::handlePlayerMessage(size_t playerId, const std::string &message)
@@ -20,6 +22,8 @@ namespace UNO::SERVER {
         auto playerMessage = NETWORK::MessageSerializer::deserialize(message);
 
         if (playerMessage.getMessageStatus() == NETWORK::MessageStatus::OK) {
+            SPDLOG_DEBUG("Processing message from player {}, type: {}", playerId, static_cast<int>(playerMessage.getMessagePayloadType()));
+
             if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::JOIN_GAME) {
                 auto playerName = std::get<NETWORK::JoinGamePayload>(playerMessage.getMessagePayload()).playerName;
 
@@ -27,12 +31,15 @@ namespace UNO::SERVER {
                 this->gameIdToNetworkId[this->playerCount] = playerId;
                 this->playerCount++;
                 this->serverGameState_.addPlayer(GAME::ServerPlayerState{playerName, 0, false});
+                SPDLOG_INFO("Player {} joined with name '{}', game ID: {}", playerId, playerName, this->playerCount - 1);
             }
-            if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::START_GAME) {
+            else if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::START_GAME) {
                 this->isReadyToStart[networkIdToGameId[playerId]] = true;
+                SPDLOG_INFO("Player {} (game ID: {}) is ready to start", playerId, networkIdToGameId[playerId]);
 
                 for (size_t i = 0; i <= this->playerCount; i++) {
                     if (i == this->playerCount) {
+                        SPDLOG_INFO("All {} players ready, starting game", this->playerCount);
                         this->handleStartGame();
                         break;
                     }
@@ -41,25 +48,41 @@ namespace UNO::SERVER {
                     }
                 }
             }
-            if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::INIT_GAME
+            else if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::INIT_GAME
-                || playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::END_GAME) {
+                     || playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::END_GAME) {
+                SPDLOG_ERROR(
+                    "Invalid message payload type from client {}: {}", playerId, static_cast<int>(playerMessage.getMessagePayloadType()));
                 throw std::invalid_argument("Invalid message payload type from client");
             }
-            if (this->serverGameState_.getServerGameStage() == GAME::ServerGameStage::IN_GAME
+            else if (this->serverGameState_.getServerGameStage() == GAME::ServerGameStage::IN_GAME
-                && this->networkIdToGameId.at(playerId) != this->serverGameState_.getCurrentPlayerId()) {
+                     && this->networkIdToGameId.at(playerId) != this->serverGameState_.getCurrentPlayerId()) {
+                SPDLOG_WARN("Player {} sent message but it's not their turn (current: {})",
+                            this->networkIdToGameId.at(playerId),
+                            this->serverGameState_.getCurrentPlayerId());
                 throw std::invalid_argument("Invalid player message: not this player's turn");
             }
-            if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::DRAW_CARD) {
+            else if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::DRAW_CARD) {
+                SPDLOG_INFO("Player {} (game ID: {}) draws card", playerId, this->networkIdToGameId.at(playerId));
                 this->handleDrawCard(playerId);
             }
-            if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::PLAY_CARD) {
+            else if (playerMessage.getMessagePayloadType() == NETWORK::MessagePayloadType::PLAY_CARD) {
-                this->handlePlayCard(playerId, std::get<NETWORK::PlayCardPayload>(playerMessage.getMessagePayload()).card);
+                auto card = std::get<NETWORK::PlayCardPayload>(playerMessage.getMessagePayload()).card;
+                SPDLOG_INFO("Player {} (game ID: {}) plays card: color={}, type={}",
+                            playerId,
+                            this->networkIdToGameId.at(playerId),
+                            card.colorToString(),
+                            card.typeToString());
+                this->handlePlayCard(playerId, card);
             }
         }
+        else {
+            SPDLOG_ERROR("Received message with error status from player {}", playerId);
+        }
     }
 
     void UnoServer::handleStartGame()
     {
+        SPDLOG_INFO("Initializing game state");
         serverGameState_.init();
         std::vector<GAME::ClientPlayerState> players;
         players.reserve(serverGameState_.getPlayers().size());
@@ -67,18 +90,23 @@ namespace UNO::SERVER {
             players.emplace_back(player.getName(), player.getRemainingCardCount(), player.getIsUno());
         }
         size_t currentPlayerIndex = serverGameState_.getCurrentPlayerId();
+        SPDLOG_INFO("Game started, current player index: {}", currentPlayerIndex);
+
         for (size_t i = 0; i < playerCount; i++) {
             NETWORK::InitGamePayload payload = {
                 i, players, serverGameState_.getDiscardPile(), serverGameState_.getPlayers()[i].getCards(), currentPlayerIndex};
             this->networkServer_.send(
                 gameIdToNetworkId.at(i),
                 NETWORK::MessageSerializer::serialize({NETWORK::MessageStatus::OK, NETWORK::MessagePayloadType::INIT_GAME, payload}));
+            SPDLOG_DEBUG("Sent INIT_GAME to player {}", i);
         }
     }
 
     void UnoServer::handleDrawCard(size_t playerId)
     {
         auto cards = this->serverGameState_.updateStateByDraw();
+        SPDLOG_INFO("Player {} drew {} card(s)", this->networkIdToGameId.at(playerId), cards.size());
+
         for (size_t i = 0; i < playerCount; i++) {
             auto networkId = gameIdToNetworkId.at(i);
             NETWORK::DrawCardPayload payload;
@@ -103,6 +131,7 @@ namespace UNO::SERVER {
         for (const auto &player : this->serverGameState_.getPlayers()) {
             if (player.isEmpty()) {
                 gameEnded = true;
+                SPDLOG_INFO("Player '{}' wins the game!", player.getName());
                 break;
             }
         }
@@ -120,6 +149,7 @@ namespace UNO::SERVER {
 
     void UnoServer::handleEndGame()
     {
+        SPDLOG_INFO("Game ended, resetting to pre-game state");
         this->serverGameState_.endGame();
 
         NETWORK::EndGamePayload payload{};
@@ -136,6 +166,7 @@ namespace UNO::SERVER {
 
     void UnoServer::run()
     {
+        SPDLOG_INFO("UnoServer starting");
         this->networkServer_.run();
     }
 

src/server/main.cpp

@@ -4,11 +4,16 @@
  * @author Yuzhe Guo
  * @date 2025.12.01
  */
+#include "../common/Logger.h"
 #include <argparse/argparse.hpp>
+#include <spdlog/spdlog.h>
 
 #include "UnoServer.h"
 int main(int argc, char *argv[])
 {
+    UNO::COMMON::Logger::init("uno-server");
+    SPDLOG_INFO("Starting uno-server");
+
     argparse::ArgumentParser parser("Uno Server", "0.1.0");
 
     parser.add_argument("-p", "--port").help("server port").default_value(static_cast<uint16_t>(10001)).scan<'i', uint16_t>();
@@ -17,17 +22,18 @@ int main(int argc, char *argv[])
         parser.parse_args(argc, argv);
     }
     catch (const std::exception &e) {
-        std::cerr << e.what() << std::endl;
+        SPDLOG_ERROR("Argument parsing failed: {}", e.what());
-        std::cerr << parser;
         return 1;
     }
 
     try {
-        UNO::SERVER::UnoServer uno_server(parser.get<uint16_t>("--port"));
+        auto port = parser.get<uint16_t>("--port");
+        SPDLOG_INFO("Launching server on port {}", port);
+        UNO::SERVER::UnoServer uno_server(port);
         uno_server.run();
     }
     catch (const std::exception &e) {
-        std::cerr << e.what() << std::endl;
+        SPDLOG_ERROR("Server crashed with exception: {}", e.what());
         return 1;
     }
 

src/ui/GameUI.cpp

@@ -49,7 +49,7 @@ namespace UNO::UI {
         for (auto color : GAME::AllColors) {
             for (auto type : GAME::AllTypes) {
                 this->images_[{color, type}] =
-                    slint::Image::load_from_path(std::format("../assets/cards/{}.svg", GAME::Card{color, type}.toString()).data());
+                    slint::Image::load_from_path(std::format("assets/cards/{}.svg", GAME::Card{color, type}.toString()).data());
             }
         }
     }

ui/Components.slint

@@ -1,17 +1,19 @@
 import { LineEdit } from "std-widgets.slint";
 
 export component Button inherits Rectangle {
+    in property <float> scale;
+
     in property <string> text;
     in property <bool> enabled: true;
 
     callback clicked;
 
-    width: 100px;
+    width: 100px * scale;
-    height: 36px;
+    height: 36px * scale;
     background: !root.enabled ? #555555               // 禁用状态
                          : touch.pressed ? #444444    // 按下
                              : #2C2C2C;               // 默认
-    border-radius: 6px;
+    border-radius: 6px * scale;
 
     touch := TouchArea {
         enabled: root.enabled;
@@ -23,41 +25,43 @@ export component Button inherits Rectangle {
     Text {
         text: root.text;
         color: #FFFFFF;
-        font-size: 14px;
+        font-size: 14px * scale;
         vertical-alignment: center;
         horizontal-alignment: center;
     }
 }
 
 export component LabeledInput inherits VerticalLayout {
+    in property <float> scale;
+
     in property <InputType> input-type: InputType.text;
 
     in property <string> label-text;
     in-out property <string> value <=> input.text;
     in property <string> placeholder;
 
-    spacing: 6px;
+    spacing: 6px * scale;
 
     // 标签文本
     Text {
         text: root.label-text;
-        font-size: 12px;
+        font-size: 12px * scale;
         font-weight: 500;
         color: #555555;
     }
 
     // 输入框背景和实体
     Rectangle {
-        height: 36px;
+        height: 36px * scale;
         background: #FFFFFF;
-        border-radius: 6px;
+        border-radius: 6px * scale;
-        border-width: 1px;
+        border-width: 1px * scale;
         border-color: input.has-focus ? #888888 : #E0E0E0; // 聚焦时边框变深
 
         input := LineEdit {
             width: 100%;
             height: 100%;
-            font-size: 14px;
+            font-size: 14px * scale;
             placeholder-text: root.placeholder;
             input-type: root.input-type;
         }

ui/ConnectPage.slint

@@ -4,13 +4,15 @@ import {
 } from "std-widgets.slint";
 import { Button, LabeledInput } from "Components.slint";
 
-export component ConnectPage inherits Window {
+export component ConnectPage inherits Rectangle {
+    in property <float> scale;
+    
     in property <bool> is-connecting;
 
     callback request-connect(string, string, string);
 
-    width: 1920px;
+    width: 100%;
-    height: 1080px;
+    height: 100%;
 
     // 背景渐变 (从左上角的米色到右下角的淡粉色)
     Rectangle {
@@ -19,29 +21,29 @@ export component ConnectPage inherits Window {
 
     // 中心卡片
     Rectangle {
-        width: 600px;
+        width: 600px * scale;
-        height: 600px; // 根据内容高度调整
+        height: 600px * scale; // 根据内容高度调整
         background: #FDFBF8; // 略微区别于背景的米白色
-        border-radius: 20px;
+        border-radius: 20px * scale;
 
         // 简单的阴影模拟
-        drop-shadow-blur: 20px;
+        drop-shadow-blur: 20px * scale;
         drop-shadow-color: #00000015;
-        drop-shadow-offset-y: 4px;
+        drop-shadow-offset-y: 4px * scale;
 
         VerticalLayout {
-            padding: 40px;
+            padding: 40px * scale;
-            spacing: 20px;
+            spacing: 20px * scale;
             alignment: center;
 
             // 标题区域
             VerticalLayout {
-                spacing: 8px;
+                spacing: 8px * scale;
                 alignment: center;
 
                 Text {
                     text: "UNO";
-                    font-size: 96px;
+                    font-size: 96px * scale;
                     font-weight: 700;
                     color: #222222;
                     horizontal-alignment: center;
@@ -49,7 +51,7 @@ export component ConnectPage inherits Window {
 
                 Text {
                     text: "连接至服务器以开始游戏";
-                    font-size: 14px;
+                    font-size: 14px * scale;
                     color: #666666;
                     horizontal-alignment: center;
                 }
@@ -57,32 +59,36 @@ export component ConnectPage inherits Window {
 
             // 占位间隔
             Rectangle {
-                height: 10px;
+                height: 10px * scale;
             }
 
             // 表单区域
             address-input := LabeledInput {
+                scale: root.scale;
                 label-text: "服务器地址";
                 value: "localhost";
             }
 
             port-input := LabeledInput {
+                scale: root.scale;
                 label-text: "服务器端口";
                 value: "10001";
                 input-type: InputType.number;
             }
 
             name-input := LabeledInput {
+                scale: root.scale;
                 label-text: "玩家昵称";
                 value: "Player";
             }
 
             // 底部按钮区域 (增加一点顶部间距)
             HorizontalLayout {
-                padding-top: 10px;
+                padding-top: 10px * scale;
                 alignment: center;
 
                 Button {
+                    scale: root.scale;
                     text: is-connecting ? "正在连接..." : "连接";
                     enabled: !is-connecting;
                     clicked => {

ui/GamePage.slint

@@ -34,28 +34,30 @@ export struct HandCard {
 
 // 玩家头像组件
 component PlayerAvatar inherits Rectangle {
+    in property <float> scale;
+
     in property <string> player-name;
     in property <int> card-count;
     in property <bool> has-uno;
     in property <bool> is-current-turn;
-    width: 100px;
+    width: 100px * scale;
-    height: 130px;
+    height: 130px * scale;
     background: transparent;
     VerticalLayout {
-        spacing: 4px;
+        spacing: 4px * scale;
         alignment: center;
 
         // UNO 标志占位区域 (固定高度)
         HorizontalLayout {
             alignment: center;
             Rectangle {
-                width: 50px;
+                width: 50px * scale;
-                height: 20px;
+                height: 20px * scale;
                 background: has-uno ? #FF5722 : transparent;
-                border-radius: 4px;
+                border-radius: 4px * scale;
                 Text {
                     text: "UNO!";
-                    font-size: 11px;
+                    font-size: 11px * scale;
                     font-weight: 700;
                     color: has-uno ? #FFFFFF : transparent;
                     horizontal-alignment: center;
@@ -68,15 +70,15 @@ component PlayerAvatar inherits Rectangle {
         HorizontalLayout {
             alignment: center;
             Rectangle {
-                width: 60px;
+                width: 60px * scale;
-                height: 60px;
+                height: 60px * scale;
                 background: is-current-turn ? #FFD54F : #E0E0E0;
-                border-radius: 30px;
+                border-radius: 30px * scale;
-                border-width: is-current-turn ? 3px : 0px;
+                border-width: is-current-turn ? 3px * scale : 0px;
                 border-color: #FF9800;
                 Text {
                     text: "👤";
-                    font-size: 28px;
+                    font-size: 28px * scale;
                     horizontal-alignment: center;
                     vertical-alignment: center;
                 }
@@ -86,7 +88,7 @@ component PlayerAvatar inherits Rectangle {
         // 玩家名称
         Text {
             text: player-name;
-            font-size: 12px;
+            font-size: 12px * scale;
             font-weight: 500;
             color: #333333;
             horizontal-alignment: center;
@@ -95,7 +97,7 @@ component PlayerAvatar inherits Rectangle {
         // 剩余手牌数
         Text {
             text: "剩余: " + card-count + " 张";
-            font-size: 10px;
+            font-size: 10px * scale;
             color: #666666;
             horizontal-alignment: center;
         }
@@ -104,22 +106,24 @@ component PlayerAvatar inherits Rectangle {
 
 // 卡牌背面组件 (起牌堆)
 component CardBack inherits Rectangle {
+    in property <float> scale;
+
     in property <int> card-width: 100;
     in property <int> card-height: 150;
-    width: card-width * 1px;
+    width: card-width * 1px * scale;
-    height: card-height * 1px;
+    height: card-height * 1px * scale;
     background: #2C2C2C;
-    border-radius: 10px;
+    border-radius: 10px * scale;
-    border-width: 2px;
+    border-width: 2px * scale;
     border-color: #444444;
     Rectangle {
         width: parent.width * 0.75;
         height: parent.height * 0.83;
         background: #1a1a1a;
-        border-radius: 8px;
+        border-radius: 8px * scale;
         Text {
             text: "UNO";
-            font-size: 20px;
+            font-size: 20px * scale;
             font-weight: 700;
             color: #888888;
             horizontal-alignment: center;
@@ -130,16 +134,18 @@ component CardBack inherits Rectangle {
 
 // 弃牌堆卡牌组件
 component DiscardCard inherits Rectangle {
+    in property <float> scale;
+
     in property <image> card-image;
     in property <int> card-width: 100;
     in property <int> card-height: 150;
-    width: card-width * 1px;
+    width: card-width * 1px * scale;
-    height: card-height * 1px;
+    height: card-height * 1px * scale;
     background: transparent;
-    border-radius: 10px;
+    border-radius: 10px * scale;
-    drop-shadow-blur: 12px;
+    drop-shadow-blur: 12px * scale;
     drop-shadow-color: #00000040;
-    drop-shadow-offset-y: 4px;
+    drop-shadow-offset-y: 4px * scale;
     Image {
         width: 100%;
         height: 100%;
@@ -150,6 +156,8 @@ component DiscardCard inherits Rectangle {
 
 // 方向环背景组件 - 只绘制环线
 component DirectionRingBackground inherits Rectangle {
+    in property <float> scale;
+
     in property <CardColor> current-color: CardColor.Red;
     in property <int> ring-width: 500;
     in property <int> ring-height: 280;
@@ -157,8 +165,8 @@ component DirectionRingBackground inherits Rectangle {
     property <color> ring-color-dim: current-color == CardColor.Red ? #E57373 : current-color == CardColor.Blue ? #64B5F6 : current-color == CardColor.Green ? #81C784 : current-color == CardColor.Yellow ? #FFF176 : #BDBDBD;
     property <float> a: ring-width / 2;
     property <float> b: ring-height / 2;
-    width: ring-width * 1px;
+    width: ring-width * 1px * scale;
-    height: ring-height * 1px;
+    height: ring-height * 1px * scale;
     background: transparent;
 
     // 底层光晕环
@@ -166,28 +174,28 @@ component DirectionRingBackground inherits Rectangle {
         width: 100%;
         height: 100%;
         stroke: ring-color-dim;
-        stroke-width: 8px;
+        stroke-width: 8px * scale;
         fill: transparent;
         opacity: 0.3;
         MoveTo {
-            x: ring-width / 2 + a;
+            x: (ring-width / 2 + a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
         }
 
         ArcTo {
-            x: ring-width / 2 - a;
+            x: (ring-width / 2 - a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
-            radius-x: a;
+            radius-x: a * scale;
-            radius-y: b;
+            radius-y: b * scale;
             sweep: true;
             large-arc: true;
         }
 
         ArcTo {
-            x: ring-width / 2 + a;
+            x: (ring-width / 2 + a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
-            radius-x: a;
+            radius-x: a * scale;
-            radius-y: b;
+            radius-y: b * scale;
             sweep: true;
             large-arc: true;
         }
@@ -198,28 +206,28 @@ component DirectionRingBackground inherits Rectangle {
         width: 100%;
         height: 100%;
         stroke: ring-color;
-        stroke-width: 3px;
+        stroke-width: 3px * scale;
         fill: transparent;
         opacity: 0.9;
         MoveTo {
-            x: ring-width / 2 + a;
+            x: (ring-width / 2 + a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
         }
 
         ArcTo {
-            x: ring-width / 2 - a;
+            x: (ring-width / 2 - a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
-            radius-x: a;
+            radius-x: a * scale;
-            radius-y: b;
+            radius-y: b * scale;
             sweep: true;
             large-arc: true;
         }
 
         ArcTo {
-            x: ring-width / 2 + a;
+            x: (ring-width / 2 + a) * scale;
-            y: ring-height / 2;
+            y: (ring-height / 2) * scale;
-            radius-x: a;
+            radius-x: a * scale;
-            radius-y: b;
+            radius-y: b * scale;
             sweep: true;
             large-arc: true;
         }
@@ -228,22 +236,21 @@ component DirectionRingBackground inherits Rectangle {
 
 // 方向环光点组件 - 使用内置动画实现平滑移动
 component DirectionRingOrbs inherits Rectangle {
+    in property <float> scale;
+
     in property <GameDirection> direction: GameDirection.Clockwise;
     in property <CardColor> current-color: CardColor.Red;
     in property <int> ring-width: 500;
     in property <int> ring-height: 280;
-
-    // 单一的动画计数器，持续递增
-    in-out property <int> cycle: 0;
     property <color> ring-color: current-color == CardColor.Red ? #F44336 : current-color == CardColor.Blue ? #2196F3 : current-color == CardColor.Green ? #4CAF50 : current-color == CardColor.Yellow ? #FFEB3B : #9E9E9E;
     property <float> a: ring-width / 2;
     property <float> b: ring-height / 2;
 
-    // 基础角度（持续增加）
+    property <float> base-angle: 0;
-    property <float> base-angle: cycle * 360;
     animate base-angle {
         duration: 8s;
         easing: linear;
+        iteration-count: -1;
     }
 
     // 方向系数：顺时针为1，逆时针为-1
@@ -251,86 +258,79 @@ component DirectionRingOrbs inherits Rectangle {
 
     // 实际角度 = 基础角度 * 方向系数
     property <float> actual-angle: base-angle * dir-sign;
-    width: ring-width * 1px;
+    width: ring-width * 1px * scale;
-    height: ring-height * 1px;
+    height: ring-height * 1px * scale;
     background: transparent;
 
     // 光点1
     Rectangle {
-        x: parent.width / 2 - 9px + cos(actual-angle * 1deg) * a * 1px;
+        x: (parent.width / 2 - 9px * scale) + cos(actual-angle * 1deg) * a * 1px * scale;
-        y: parent.height / 2 - 9px + sin(actual-angle * 1deg) * b * 1px;
+        y: (parent.height / 2 - 9px * scale) + sin(actual-angle * 1deg) * b * 1px * scale;
-        width: 18px;
+        width: 18px * scale;
-        height: 18px;
+        height: 18px * scale;
         background: ring-color;
-        border-radius: 9px;
+        border-radius: 9px * scale;
-        drop-shadow-blur: 8px;
+        drop-shadow-blur: 8px * scale;
         drop-shadow-color: ring-color;
     }
 
     // 光点2
     Rectangle {
-        x: parent.width / 2 - 9px + cos((actual-angle + 90) * 1deg) * a * 1px;
+        x: (parent.width / 2 - 9px * scale) + cos((actual-angle + 90) * 1deg) * a * 1px * scale;
-        y: parent.height / 2 - 9px + sin((actual-angle + 90) * 1deg) * b * 1px;
+        y: (parent.height / 2 - 9px * scale) + sin((actual-angle + 90) * 1deg) * b * 1px * scale;
-        width: 18px;
+        width: 18px * scale;
-        height: 18px;
+        height: 18px * scale;
         background: ring-color;
-        border-radius: 9px;
+        border-radius: 9px * scale;
-        drop-shadow-blur: 8px;
+        drop-shadow-blur: 8px * scale;
         drop-shadow-color: ring-color;
     }
 
     // 光点3
     Rectangle {
-        x: parent.width / 2 - 9px + cos((actual-angle + 180) * 1deg) * a * 1px;
+        x: (parent.width / 2 - 9px * scale) + cos((actual-angle + 180) * 1deg) * a * 1px * scale;
-        y: parent.height / 2 - 9px + sin((actual-angle + 180) * 1deg) * b * 1px;
+        y: (parent.height / 2 - 9px * scale) + sin((actual-angle + 180) * 1deg) * b * 1px * scale;
-        width: 18px;
+        width: 18px * scale;
-        height: 18px;
+        height: 18px * scale;
         background: ring-color;
-        border-radius: 9px;
+        border-radius: 9px * scale;
-        drop-shadow-blur: 8px;
+        drop-shadow-blur: 8px * scale;
         drop-shadow-color: ring-color;
     }
 
     // 光点4
     Rectangle {
-        x: parent.width / 2 - 9px + cos((actual-angle + 270) * 1deg) * a * 1px;
+        x: (parent.width / 2 - 9px * scale) + cos((actual-angle + 270) * 1deg) * a * 1px * scale;
-        y: parent.height / 2 - 9px + sin((actual-angle + 270) * 1deg) * b * 1px;
+        y: (parent.height / 2 - 9px * scale) + sin((actual-angle + 270) * 1deg) * b * 1px * scale;
-        width: 18px;
+        width: 18px * scale;
-        height: 18px;
+        height: 18px * scale;
         background: ring-color;
-        border-radius: 9px;
+        border-radius: 9px * scale;
-        drop-shadow-blur: 8px;
+        drop-shadow-blur: 8px * scale;
         drop-shadow-color: ring-color;
     }
 
-    // 递增计数器
-    Timer {
-        interval: 8s;
-        running: true;
-        triggered => {
-            cycle = cycle + 1;
-        }
-    }
-
     // 初始化时启动动画
     init => {
-        cycle = 1;
+        base-angle = 360;
     }
 }
 
 // 手牌卡牌组件
 component HandCardItem inherits Rectangle {
+    in property <float> scale;
+    
     in property <image> card-image;
     in property <bool> is-selected: false;
     callback clicked;
-    width: 120px;
+    width: 120px * scale;
-    height: 180px;
+    height: 180px * scale;
-    y: is-selected ? -25px : 0px;
+    y: is-selected ? -25px * scale : 0px;
     background: transparent;
-    border-radius: 10px;
+    border-radius: 10px * scale;
-    drop-shadow-blur: is-selected ? 16px : 6px;
+    drop-shadow-blur: is-selected ? 16px * scale : 6px * scale;
     drop-shadow-color: is-selected ? #00000040 : #00000025;
-    drop-shadow-offset-y: is-selected ? 6px : 3px;
+    drop-shadow-offset-y: is-selected ? 6px * scale : 3px * scale;
     animate y {
         duration: 150ms;
         easing: ease-out;
@@ -352,14 +352,15 @@ component HandCardItem inherits Rectangle {
 
 // UNO 圆形按钮组件
 component UnoButton inherits Rectangle {
+    in property <float> scale;
     callback clicked;
-    width: 90px;
+    width: 90px * scale;
-    height: 90px;
+    height: 90px * scale;
     background: touch.pressed ? #D32F2F : #F44336;
-    border-radius: 45px;
+    border-radius: 45px * scale;
-    drop-shadow-blur: 12px;
+    drop-shadow-blur: 12px * scale;
     drop-shadow-color: #F4433660;
-    drop-shadow-offset-y: 4px;
+    drop-shadow-offset-y: 4px * scale;
     touch := TouchArea {
         clicked => {
             root.clicked();
@@ -368,7 +369,7 @@ component UnoButton inherits Rectangle {
 
     Text {
         text: "UNO!";
-        font-size: 20px;
+        font-size: 20px * scale;
         font-weight: 700;
         color: #FFFFFF;
         horizontal-alignment: center;
@@ -378,18 +379,19 @@ component UnoButton inherits Rectangle {
 
 // 颜色选择按钮组件
 component ColorButton inherits Rectangle {
+    in property <float> scale;
     in property <color> btn-color;
     in property <string> color-name;
     callback clicked;
-    width: 80px;
+    width: 80px * scale;
-    height: 80px;
+    height: 80px * scale;
     background: touch.pressed ? btn-color.darker(20%) : btn-color;
-    border-radius: 12px;
+    border-radius: 12px * scale;
-    border-width: 3px;
+    border-width: 3px * scale;
     border-color: btn-color.darker(30%);
-    drop-shadow-blur: 8px;
+    drop-shadow-blur: 8px * scale;
     drop-shadow-color: btn-color.with-alpha(0.4);
-    drop-shadow-offset-y: 3px;
+    drop-shadow-offset-y: 3px * scale;
     touch := TouchArea {
         clicked => {
             root.clicked();
@@ -398,7 +400,7 @@ component ColorButton inherits Rectangle {
 
     Text {
         text: color-name;
-        font-size: 14px;
+        font-size: 14px * scale;
         font-weight: 600;
         color: #FFFFFF;
         horizontal-alignment: center;
@@ -408,6 +410,7 @@ component ColorButton inherits Rectangle {
 
 // 颜色选择弹窗组件
 component ColorPickerDialog inherits Rectangle {
+    in property <float> scale;
     in property <bool> show: false;
     callback color-selected(CardColor);
     callback cancel;
@@ -433,13 +436,13 @@ component ColorPickerDialog inherits Rectangle {
     Rectangle {
         x: (parent.width - self.width) / 2;
         y: (parent.height - self.height) / 2;
-        width: 600px;
+        width: 600px * scale;
-        height: 280px;
+        height: 280px * scale;
         background: #FFFFFF;
-        border-radius: 20px;
+        border-radius: 20px * scale;
-        drop-shadow-blur: 30px;
+        drop-shadow-blur: 30px * scale;
         drop-shadow-color: #00000040;
-        drop-shadow-offset-y: 10px;
+        drop-shadow-offset-y: 10px * scale;
         
         // 阻止点击弹窗内容时关闭
         TouchArea {
@@ -447,14 +450,14 @@ component ColorPickerDialog inherits Rectangle {
         }
 
         VerticalLayout {
-            padding: 30px;
+            padding: 30px * scale;
-            spacing: 25px;
+            spacing: 25px * scale;
             alignment: center;
             
             // 标题
             Text {
                 text: "选择颜色";
-                font-size: 24px;
+                font-size: 24px * scale;
                 font-weight: 700;
                 color: #333333;
                 horizontal-alignment: center;
@@ -462,9 +465,10 @@ component ColorPickerDialog inherits Rectangle {
             
             // 颜色按钮网格
             HorizontalLayout {
-                spacing: 20px;
+                spacing: 20px * scale;
                 alignment: center;
                 ColorButton {
+                    scale: root.scale;
                     btn-color: #F44336;
                     color-name: "红色";
                     clicked => {
@@ -473,6 +477,7 @@ component ColorPickerDialog inherits Rectangle {
                 }
 
                 ColorButton {
+                    scale: root.scale;
                     btn-color: #2196F3;
                     color-name: "蓝色";
                     clicked => {
@@ -481,6 +486,7 @@ component ColorPickerDialog inherits Rectangle {
                 }
 
                 ColorButton {
+                    scale: root.scale;
                     btn-color: #4CAF50;
                     color-name: "绿色";
                     clicked => {
@@ -489,6 +495,7 @@ component ColorPickerDialog inherits Rectangle {
                 }
 
                 ColorButton {
+                    scale: root.scale;
                     btn-color: #FFEB3B;
                     color-name: "黄色";
                     clicked => {
@@ -501,6 +508,7 @@ component ColorPickerDialog inherits Rectangle {
             HorizontalLayout {
                 alignment: center;
                 Button {
+                    scale: root.scale;
                     text: "取消";
                     clicked => {
                         root.cancel();
@@ -512,7 +520,8 @@ component ColorPickerDialog inherits Rectangle {
 }
 
 // 主游戏页面
-export component GamePage inherits Window {
+export component GamePage inherits Rectangle {
+    in property <float> scale;
     // 其他玩家列表
     in property <[OtherPlayer]> other-players;
 
@@ -542,8 +551,8 @@ export component GamePage inherits Window {
     callback request-play-card(int, CardColor);
     callback request-draw-card;
     callback request-uno;
-    width: 1920px;
+    width: 100%;
-    height: 1080px;
+    height: 100%;
 
     // 背景渐变
     Rectangle {
@@ -552,25 +561,26 @@ export component GamePage inherits Window {
 
     // 主布局
     VerticalLayout {
-        padding: 30px;
+        padding: 30px * scale;
-        spacing: 20px;
+        spacing: 20px * scale;
 
         // ===== 顶部：其他玩家区域 =====
         Rectangle {
-            height: 150px;
+            height: 150px * scale;
             background: #FDFBF8;
-            border-radius: 16px;
+            border-radius: 16px * scale;
-            drop-shadow-blur: 10px;
+            drop-shadow-blur: 10px * scale;
             drop-shadow-color: #00000010;
-            drop-shadow-offset-y: 2px;
+            drop-shadow-offset-y: 2px * scale;
             HorizontalLayout {
-                padding-top: 10px;
+                padding-top: 10px * scale;
-                padding-bottom: 15px;
+                padding-bottom: 15px * scale;
-                padding-left: 15px;
+                padding-left: 15px * scale;
-                padding-right: 15px;
+                padding-right: 15px * scale;
-                spacing: 40px;
+                spacing: 40px * scale;
                 alignment: center;
                 for player[index] in other-players: PlayerAvatar {
+                    scale: root.scale;
                     player-name: player.name;
                     card-count: player.card-count;
                     has-uno: player.has-uno;
@@ -586,14 +596,15 @@ export component GamePage inherits Window {
 
             // 中心容器：包含环和两个牌堆
             Rectangle {
-                width: 560px;
+                width: 560px * scale;
-                height: 320px;
+                height: 320px * scale;
                 x: (parent.width - self.width) / 2;
                 y: (parent.height - self.height) / 2;
                 background: transparent;
 
                 // 方向环背景 - 在牌堆下面
                 DirectionRingBackground {
+                    scale: root.scale;
                     x: (parent.width - self.width) / 2;
                     y: (parent.height - self.height) / 2;
                     ring-width: 560;
@@ -603,11 +614,12 @@ export component GamePage inherits Window {
 
                 // 起牌堆 - 左侧
                 Rectangle {
-                    x: 80px;
+                    x: 80px * scale;
-                    y: (parent.height - 200px) / 2;
+                    y: (parent.height - 200px * scale) / 2;
-                    width: 130px;
+                    width: 130px * scale;
-                    height: 200px;
+                    height: 200px * scale;
                     CardBack {
+                        scale: root.scale;
                         card-width: 130;
                         card-height: 200;
                     }
@@ -617,6 +629,7 @@ export component GamePage inherits Window {
                         width: parent.width;
                         height: parent.height;
                         clicked => {
+                            root.selected-card-index = -1;
                             root.request-draw-card();
                         }
                     }
@@ -624,15 +637,17 @@ export component GamePage inherits Window {
 
                 // 弃牌堆 - 右侧
                 DiscardCard {
-                    x: parent.width - 130px - 80px;
+                    scale: root.scale;
-                    y: (parent.height - 200px) / 2;
+                    x: parent.width - 130px * scale - 80px * scale;
+                    y: (parent.height - 200px * scale) / 2;
                     card-width: 130;
                     card-height: 200;
                     card-image: root.discard-top-card;
                 }
 
                 // 方向环光点 - 在牌堆上面
-               DirectionRingOrbs {
+                DirectionRingOrbs {
+                    scale: root.scale;
                     x: (parent.width - self.width) / 2;
                     y: (parent.height - self.height) / 2;
                     ring-width: 560;
@@ -645,23 +660,24 @@ export component GamePage inherits Window {
 
         // ===== 底部：当前玩家区域 =====
         Rectangle {
-            height: 320px;
+            height: 350px * scale;
             background: #FDFBF8;
-            border-radius: 16px;
+            border-radius: 16px * scale;
-            drop-shadow-blur: 10px;
+            drop-shadow-blur: 10px * scale;
             drop-shadow-color: #00000010;
-            drop-shadow-offset-y: -2px;
+            drop-shadow-offset-y: -2px * scale;
             HorizontalLayout {
-                padding: 20px;
+                padding: 20px * scale;
-                padding-left: 40px;
+                padding-left: 40px * scale;
-                padding-right: 40px;
+                padding-right: 40px * scale;
-                spacing: 30px;
+                spacing: 30px * scale;
                 alignment: space-between;
 
                 // 当前玩家头像 - 靠左，垂直居中与UNO按钮对齐
                 VerticalLayout {
                     alignment: center;
                     PlayerAvatar {
+                        scale: root.scale;
                         player-name: current-player-name;
                         card-count: current-player-card-count;
                         has-uno: current-player-has-uno;
@@ -672,17 +688,18 @@ export component GamePage inherits Window {
                 // 手牌区域
                 VerticalLayout {
                     horizontal-stretch: 1;
-                    spacing: 10px;
+                    spacing: 10px * scale;
                     alignment: center;
 
                     // 出牌按钮 (放在手牌上方)
                     Rectangle {
-                        height: 50px;
+                        height: 50px * scale;
                         background: transparent;
                         HorizontalLayout {
                             alignment: center;
-                            padding-bottom: 10px;
+                            padding-bottom: 10px * scale;
                             Button {
+                                scale: root.scale;
                                 text: "出牌";
                                 enabled: is-current-player-turn && selected-card-index >= 0 && hand-cards[selected-card-index].can-be-played;
                                 clicked => {
@@ -704,20 +721,24 @@ export component GamePage inherits Window {
 
                     // 手牌列表 - 上方留出空间给选中效果
                     Rectangle {
-                        height: 210px;
+                        width: 1200px * scale;
+                        height: 230px * scale;
+                        horizontal-stretch: 1;
                         background: transparent;
 
-                        // 手牌容器，向下偏移以给选中卡牌留空间，居中显示
+                        // 手牌滚动容器
-                        Rectangle {
+                        ScrollView {
-                            x: (parent.width - self.width) / 2;
+                            width: 100%;
-                            y: 25px;
+                            height: 100%;
-                            width: hand-cards-layout.preferred-width;
+                            
-                            height: 180px;
+                            // 手牌容器，向下偏移以给选中卡牌留空间
                             hand-cards-layout := HorizontalLayout {
+                                y: 25px * scale;
                                 alignment: center;
-                                spacing: -35px; // 卡牌重叠效果
+                                spacing: -35px * scale; // 卡牌重叠效果
 
                                 for card[index] in hand-cards: HandCardItem {
+                                    scale: root.scale;
                                     card-image: card.image-path;
                                     is-selected: index == selected-card-index;
                                     clicked => {
@@ -740,6 +761,7 @@ export component GamePage inherits Window {
                 VerticalLayout {
                     alignment: center;
                     UnoButton {
+                        scale: root.scale;
                         clicked => {
                             root.request-uno();
                         }
@@ -751,6 +773,7 @@ export component GamePage inherits Window {
 
     // 颜色选择弹窗 (覆盖在最上层)
     ColorPickerDialog {
+        scale: root.scale;
         show: root.show-color-picker;
         color-selected(color) => {
             root.show-color-picker = false;

ui/MainWindow.slint

@@ -1,6 +1,12 @@
 import { ConnectPage } from "ConnectPage.slint";
 import { StartPage } from "StartPage.slint";
-import { GamePage, OtherPlayer, HandCard, CardColor, GameDirection } from "GamePage.slint";
+import {
+    GamePage,
+    OtherPlayer,
+    HandCard,
+    CardColor,
+    GameDirection,
+} from "GamePage.slint";
 
 enum PageType {
     ConnectPage,
@@ -35,17 +41,23 @@ export component MainWindow inherits Window {
     callback request-draw-card;
     callback request-uno;
 
-    width: 1920px;
+    preferred-width: 1920px;
-    height: 1080px;
+    preferred-height: 1080px;
+    min-width: 960px;
+    min-height: 600px;
     title: "UNO!";
 
+    property <float> scale: min(self.width / 1920px, self.height / 1080px);
+
     if root.active-page == PageType.ConnectPage: connect-page := ConnectPage {
+        scale: root.scale;
         is-connecting: root.is-connecting;
         request-connect(server-address, server-port, player-name) => {
             root.request-connect(server-address, server-port, player-name);
         }
     }
     if root.active-page == PageType.StartPage: start-page := StartPage {
+        scale: root.scale;
         is-ready: root.is-ready;
         is-restart: root.is-restart;
         request-start => {
@@ -53,6 +65,7 @@ export component MainWindow inherits Window {
         }
     }
     if root.active-page == PageType.GamePage: game-page := GamePage {
+        scale: root.scale;
         other-players: root.other-players;
         current-player-name: root.current-player-name;
         current-player-card-count: root.current-player-card-count;

ui/StartPage.slint

@@ -1,13 +1,14 @@
 import {Button} from "Components.slint";
 
-export component StartPage inherits Window {
+export component StartPage inherits Rectangle {
+    in property <float> scale;
     in property <bool> is-ready;
     in property <bool> is-restart;
 
     callback request-start;
 
-    width: 1920px;
+    width: 100%;
-    height: 1080px;
+    height: 100%;
 
     // 背景渐变 (从左上角的米色到右下角的淡粉色)
     Rectangle {
@@ -16,29 +17,29 @@ export component StartPage inherits Window {
 
     // 中心卡片
     Rectangle {
-        width: 600px;
+        width: 600px * scale;
-        height: 600px; // 根据内容高度调整
+        height: 600px * scale; // 根据内容高度调整
         background: #FDFBF8; // 略微区别于背景的米白色
-        border-radius: 20px;
+        border-radius: 20px * scale;
 
         // 简单的阴影模拟
-        drop-shadow-blur: 20px;
+        drop-shadow-blur: 20px * scale;
         drop-shadow-color: #00000015;
-        drop-shadow-offset-y: 4px;
+        drop-shadow-offset-y: 4px * scale;
 
         VerticalLayout {
-            padding: 40px;
+            padding: 40px * scale;
-            spacing: 20px;
+            spacing: 20px * scale;
             alignment: center;
 
             // 标题区域
             VerticalLayout {
-                spacing: 8px;
+                spacing: 8px * scale;
                 alignment: center;
 
                 Text {
                     text: "UNO";
-                    font-size: 96px;
+                    font-size: 96px * scale;
                     font-weight: 700;
                     color: #222222;
                     horizontal-alignment: center;
@@ -46,7 +47,7 @@ export component StartPage inherits Window {
 
                 Text {
                     text: is-restart ? "游戏结束，重新准备以重新开始游戏" : "连接成功，所有玩家准备后开始游戏";
-                    font-size: 14px;
+                    font-size: 14px * scale;
                     color: #666666;
                     horizontal-alignment: center;
                 }
@@ -54,15 +55,16 @@ export component StartPage inherits Window {
 
             // 占位间隔
             Rectangle {
-                height: 10px;
+                height: 10px * scale;
             }
 
             // 底部按钮区域 (增加一点顶部间距)
             HorizontalLayout {
-                padding-top: 10px;
+                padding-top: 10px * scale;
                 alignment: center;
 
                 Button {
+                    scale: root.scale;
                     enabled: !is-ready;
                     text: is-ready ? "已准备" : "准备";
                     clicked => {