1. 项目背景与核心目标
在软件开发中,数据结构和日志系统是两大基础组件。数据结构决定了程序如何组织和存储数据,而日志系统则是程序运行时的"黑匣子",记录了系统行为的关键信息。本项目的核心目标是通过C++实现一套可复用的基础数据结构,并基于spdlog库封装一个线程安全的日志系统。
为什么需要自己实现这些基础组件?在商业级项目中,直接使用原生数据结构或简单打印日志往往存在以下问题:
- 数据结构缺乏业务语义的封装
- 日志输出混乱难以维护
- 多线程环境下日志丢失或错乱
- 缺乏统一的日志格式和级别控制
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础数据结构设计与实现
2.1 消息结构体设计
消息结构体(Message)是对话系统的核心载体,需要包含以下关键字段:
cpp复制struct Message {
std::string _messageid; // UUID保证唯一性
std::string _role; // user/assistant/system
std::string _content; // UTF-8编码文本
std::time_t _timestamp; // 毫秒级时间戳
Message(const std::string& role, const std::string& content)
: _role(role), _content(content) {
_timestamp = std::chrono::system_clock::to_time_t(
std::chrono::system_clock::now());
}
};
关键设计点:
- 使用time_t而非string存储时间戳,便于后续时间计算和排序
- 构造函数仅需必要参数,其他字段自动初始化
- 消息ID建议采用UUIDv4生成算法,避免分布式系统冲突
2.2 配置参数结构体
模型配置参数使用继承体系实现:
cpp复制struct Config {
std::string _modelid;
double _temperature = 0.7; // 推荐默认值
int _max
