RenderVision.hpp

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <atomic>
#include <mutex>
#include <string>
 
namespace eve {
class IRenderCapture;
}
 
namespace eve::dev {
 
class EVENGINE_API_FOUNDATION RenderVision {
public:
    static RenderVision& instance();
 
    RenderVision(const RenderVision&)            = delete;
    RenderVision& operator=(const RenderVision&) = delete;
 
    // --- Config (env-backed on first use) ---
    void setBaseUrl(std::string url);
    void setApiKey(std::string key);
    void setModel(std::string model);
    void setPath(std::string path);
    void setTimeoutMs(int ms);
    std::string configJson();
    bool        configured();
 
    // --- Cache ---
    std::string latest() const;
    std::string lastError() const;
 
    // --- Pending trigger (recorded off-main; dumped on main thread) ---
    void notifyPending(const std::string& reason, const std::string& source, int line);
    bool pending() const;
    std::string pendingReason() const;
 
    std::string describe(eve::IRenderCapture* cap, const std::string& renderDataJson, bool fresh,
                         const std::string& reason = {});
 
    void pollPending(eve::IRenderCapture* cap, const std::string& renderDataJson);
 
private:
    // Immortal<RenderVision> constructs the singleton (devtools/Immortal.hpp).
    template <typename> friend struct Immortal;
    RenderVision() = default;
 
    void ensureEnvLocked();
    std::string doDescribe(eve::IRenderCapture* cap, const std::string& renderDataJson, const std::string& reason);
 
    mutable std::mutex mu_;
    std::string baseUrl_ = "http://127.0.0.1:11434/v1";
    std::string apiKey_;
    std::string model_ = "llava";
    std::string path_  = "/chat/completions";
    int         timeoutMs_ = 20000;
    bool        envLoaded_ = false;
 
    std::string latest_;
    std::string lastError_;
 
    std::atomic<bool> pending_{false};
    std::string pendingReason_;
    std::string pendingLoc_;
};
 
}  // namespace eve::dev