OnlineRpg/关键模块与接口.md

# **1\. 数据库 Schema (SQLite)**

\-- 用户表 (Users)  
CREATE TABLE IF NOT EXISTS Users (  
    UserID INTEGER PRIMARY KEY AUTOINCREMENT,  
    Username TEXT NOT NULL UNIQUE,  
    PasswordHash TEXT NOT NULL,  
    CreatedAt DATETIME DEFAULT CURRENT\_TIMESTAMP  
);

\-- 角色表 (Characters)  
CREATE TABLE IF NOT EXISTS Characters (  
    CharacterID INTEGER PRIMARY KEY AUTOINCREMENT,  
    UserID INTEGER NOT NULL,  
    ClassName TEXT NOT NULL,  \-- e.g., "Warrior", "Mage"  
    Level INTEGER NOT NULL DEFAULT 1,  
    HP INTEGER NOT NULL DEFAULT 100,  
    MP INTEGER NOT NULL DEFAULT 50,  
    Attack INTEGER NOT NULL DEFAULT 10,  
    Speed INTEGER NOT NULL DEFAULT 5,  
    FOREIGN KEY(UserID) REFERENCES Users(UserID)  
);

# **2\. 网络通信协议 (Protocol.h)**

使用 | 分隔的文本协议。所有消息以换行符 \\n 结束。

## **2.1. 客户端 \-\> 服务器 (C2S)**

* **注册**: C2S\_REG|username|password\\n  
* **登录**: C2S\_LOGIN|username|password\\n  
* **大厅聊天**: C2S\_CHAT|message\_content\\n  
* **获取列表**: C2S\_LIST\_PLAYERS\\n  
* **邀请对战**: C2S\_INVITE|target\_username\\n  
* **回应邀请**: C2S\_INVITE\_RSP|inviter\_username|accept\_or\_reject\\n (e.g., "accept" / "reject")  
* **战斗行动**: C2S\_BATTLE\_ACTION|skill\_name|target\_name\\n

## **2.2. 服务器 \-\> 客户端 (S2C)**

* **通用响应**: S2C\_RESPONSE|OK|message\\n 或 S2C\_RESPONSE|ERROR|error\_message\\n  
* **登录成功**: S2C\_LOGIN\_OK|username|ClassName|Level|HP|MP\\n  
* **大厅消息**: S2C\_MSG|sender\_username|message\_content\\n  
* **玩家列表**: S2C\_LIST\_PLAYERS|user1,user2,user3\\n  
* **收到邀请**: S2C\_INVITE|inviter\_username\\n  
* **邀请结果**: S2C\_INVITE\_RESULT|target\_username|result\\n (e.g., "accepted" / "rejected")  
* **战斗开始**: S2C\_BATTLE\_START|opponent\_name|opponent\_class\\n  
* **战斗回合**: S2C\_BATTLE\_TURN|YOUR\_TURN\\n 或 S2C\_BATTLE\_TURN|OPPONENT\_TURN\\n  
* **战斗战报**: S2C\_BATTLE\_LOG|log\_message\\n  
* **战斗结束**: S2C\_BATTLE\_END|WIN\\n 或 S2C\_BATTLE\_END|LOSE\\n

# **3\. 关键类接口定义 (C++ Header 风格)**

## **3.1. Core: HistoryLog.h (模板 \+ 链表)**

\#pragma once  
\#include \<vector\>

// 必须手写实现链表节点  
template \<typename T\>  
struct Node {  
    T data;  
    Node\<T\>\* next;  
    Node(T d) : data(d), next(nullptr) {}  
};

// 必须使用手写的 Node\<T\> 作为底层结构  
template \<typename T\>  
class HistoryLog {  
private:  
    Node\<T\>\* head;  
    int size;

public:  
    HistoryLog();  
    \~HistoryLog(); // 必须正确释放链表所有节点的内存

    void add(T logEntry); // 在链表头部插入  
    std::vector\<T\> getAllEntries(); // 遍历链表，返回一个 vector  
    int getSize();  
};

## **3.2. Core: ICharacter.h & ISkill.h (多态)**

\#pragma once  
\#include \<string\>  
\#include \<vector\>

class ICharacter; // 前向声明

// 技能基类  
class ISkill {  
public:  
    virtual \~ISkill() {}  
    virtual std::string getName() \= 0;  
    virtual void execute(ICharacter& caster, ICharacter& target) \= 0; // 纯虚函数  
};

// 角色基类  
class ICharacter {  
protected:  
    std::string m\_name;  
    int m\_hp;  
    int m\_maxHp;  
    int m\_speed;  
    std::vector\<ISkill\*\> m\_skills; // STL

public:  
    virtual \~ICharacter(); // 必须是虚析构函数，并清理 m\_skills  
    virtual std::string getName() { return m\_name; }  
    virtual int getHp() { return m\_hp; }  
    virtual bool isAlive() { return m\_hp \> 0; }  
    virtual int getSpeed() { return m\_speed; }  
    virtual ISkill\* getSkill(const std::string& name);

    virtual void takeDamage(int damage) \= 0; // 纯虚函数  
    virtual void heal(int amount) \= 0;  
};

// 派生类 (示例)  
class Warrior : public ICharacter {  
public:  
    Warrior(std::string name);  
    virtual void takeDamage(int damage) override; // 重写，实现格挡逻辑  
    virtual void heal(int amount) override;  
};

class Mage : public ICharacter {  
public:  
    Mage(std::string name);  
    virtual void takeDamage(int damage) override; // 重写，实现法力护盾逻辑  
    virtual void heal(int amount) override;  
};

## **3.3. Server: ClientHandler.h (网络 \+ STL \+ 多线程)**

\#pragma once  
\#include \<thread\>  
\#include \<string\>  
\#include "SocketWrapper.h" // 假设已封装

class GameServer; // 前向声明

class ClientHandler {  
public:  
    // 构造函数，传入 socket 描述符和服务器实例指针  
    ClientHandler(int socketFd, GameServer\* server);  
    \~ClientHandler();

    void startHandlerThread(); // 启动 run() 循环  
    void stopHandler();        // 停止循环并关闭 socket  
    void sendMessage(const std::string& message); // 发送消息给这个客户端

private:  
    void run(); // 线程主循环 (recv, parse, handle)  
    void parseCommand(const std::string& command);

    int m\_socketFd;  
    GameServer\* m\_server; // 用于回调服务器 (e.g., 广播)  
    std::thread m\_thread; // STL  
    bool m\_isRunning;  
      
    // 玩家状态  
    std::string m\_username;  
    enum class State { Unauthenticated, Lobby, InBattle };  
    State m\_state;  
};