AiPanel.hpp

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <cstdint>
#include <deque>
#include <mutex>
#include <string>
#include <vector>
 
namespace eve::dev {
 
struct EVENGINE_API_FOUNDATION_INLINE AiLogEntry {
    std::string timestamp;  // ISO-ish local time
    std::string kind;       // tool | note | system | error
    std::string title;
    std::string detail;
};
 
class EVENGINE_API_FOUNDATION AiPanel {
public:
    static AiPanel& instance();
 
    AiPanel(const AiPanel&)            = delete;
    AiPanel& operator=(const AiPanel&) = delete;
 
    void setVisible(bool on);
    bool isVisible() const;
    void toggleVisible();
 
    void setMcpPort(int port);
    int  mcpPort() const;
    void setMcpConnected(bool on);
    bool mcpConnected() const;
    void setClientName(std::string name);
    std::string clientName() const;
 
    void clearLog();
    void addLog(std::string kind, std::string title, std::string detail = {});
    void addNote(std::string text);
    std::vector<AiLogEntry> recentLog(size_t max = 64) const;
    std::string formatLog(size_t max = 64) const;
 
    std::string statusLine() const;
 
    void drawImGui();
 
    using ImGuiDrawer = void (*)(AiPanel& panel);
    static void setImGuiDrawer(ImGuiDrawer fn);
 
    void setMaxEntries(size_t n);
    size_t maxEntries() const { return maxEntries_; }
 
private:
    // Immortal<AiPanel> constructs the singleton (devtools/Immortal.hpp).
    template <typename> friend struct Immortal;
    AiPanel() = default;
 
    static std::string nowStamp();
 
    mutable std::mutex mu_;
    bool               visible_      = true;
    int                mcpPort_      = 0;
    bool               mcpConnected_ = false;
    std::string        clientName_;
    size_t             maxEntries_   = 200;
    std::deque<AiLogEntry> log_;
};
 
}  // namespace eve::dev