File List

Here is a list of all documented files with brief descriptions:

public
cpp
actor
actor_base
core
actor.cpp	Actor消息队列调度与优先级处理实现
actor.h	带消息队列、优先级调度和广播支持的Actor。
actor_base.cpp	实现actor_base状态转换和消息推送
actor_base.h	所有actor的基类，包含guid、状态机和消息推送接口。
actor_db.h	Actor的数据库组件，将Actor绑定到其持久化存储表。
actor_manage.cpp	分层actor调度系统实现
actor_manage.h	分层actor调度。
handle_pram.cpp	实现handle_pram的构造和协议类型解析。
handle_pram.h	消息调度参数块，携带发送者、接收者和负载信息。
nactortype.h	Actor类型枚举（ENUM_ACTOR）和单例/动态分类辅助函数。
naddress.cpp	实现地址表查找和跨节点消息转发
naddress.h	跨节点地址表，将Actor全局唯一标识符映射到服务器会话。
ndb_modular.cpp	实现数据库模块化加载/保存和表注册
ndb_modular.h	数据库模块化组件，为Actor提供可组合的数据库持久化。
ndbclient.h	Actor的数据库客户端组件，绑定单个数据库表。
nguid.cpp	实现nguid字符串转换和工厂方法
nguid.h	64位Actor全局唯一标识符，包含打包的类型、区域和数据ID字段。
nmanage_dbclient.cpp	实现数据库客户端管理器的加载/保存协调
nmanage_dbclient.h	数据库客户端管理器，协调多个ndbclient实例的加载、保存和生命周期管理。
nregister.h	协议处理器注册表（nrfun），用于Actor消息分发。
nrfun.cpp	实现Actor消息分发注册表
nrfun.h	声明Actor消息分发注册表。
nscript.cpp	实现Lua脚本与Actor系统的桥接
nscript.h	Actor的Lua脚本绑定组件，支持脚本化行为。
nthread.cpp	Actor工作线程实现
nthread.h	Actor工作线程。
ntimer.cpp	实现定时器调度、tick处理和回调分发
ntimer.h	Actor内的定时器组件，用于调度周期性和一次性回调。
nsp
nsp.cpp	实现NSP（Network Security Protocol）注册和字段权限管理
nsp.h	网络服务协议（NSP）注册和分发框架。
nsp_read.h	NSP读端处理器，用于反序列化入站协议消息。
nsp_read_function.h	NSP读端函数模板，用于类型化消息反序列化。
nsp_server.h	NSP服务端处理器，用于在服务端处理协议消息。
nsp_server_function.h	NSP服务端函数模板实现，用于类型化消息处理。
nsp_write.h	NSP写端处理器，用于序列化出站协议消息。
nsp_write_function.h	NSP写端函数模板，用于类型化消息序列化。
actor_logic
actor_activity_manage
message
actor_activity_manage_handle.cpp	活动管理Actor消息处理器实现
activity.cpp	活动基类和活动类型注册实现
activity.h	活动数据结构和生命周期管理。
activity_drawcompliance.h	活动抽奖合规逻辑声明。
activity_rank.cpp	活动排行榜排名逻辑实现
activity_rank.h	活动排行榜排名逻辑声明。
activitydb.cpp	活动数据库持久化操作实现
activitydb.h	活动数据库持久化声明。
activitytimedb.cpp	活动时间窗口数据库操作实现
activitytimedb.h	活动定时器数据库持久化声明。
actor_activity_manage.cpp	活动管理Actor实现
actor_activity_manage.h	活动管理Actor声明
actor_brief
message
actor_brief_handle.cpp	简介Actor的消息处理器
actor_brief.cpp	简介Actor实现
actor_brief.h	简介Actor声明
briefdb.h	简介数据库持久化组件。
actor_chat
message
actor_chat_handle.cpp	聊天Actor消息处理器实现
actor_chat.cpp	聊天Actor实现
actor_chat.h	聊天Actor声明
actor_client
actor_client.cpp	客户端路由Actor实现
actor_client.h	客户端类型节点的路由Actor，处理跨节点消息转发和Actor发现。
actor_create
actor_create.cpp	角色创建Actor实现
actor_create.h	角色创建Actor，处理新玩家注册和初始数据设置
actor_csvclient
message
actor_csvclient_handle.cpp	CSV客户端Actor的消息处理器
actor_csvclient.cpp	CSV客户端Actor实现
actor_csvclient.h	CSV客户端Actor，从CSV服务端请求并缓存配置表数据。
actor_csvserver
message
actor_csvserver_handle.cpp	CSV服务端Actor的消息处理器
actor_csvserver.cpp	CSV服务端Actor实现
actor_csvserver.h	CSV服务端Actor，加载配置表数据并分发到请求节点。
actor_demo01
message
actor_demo01_handle.cpp	实现demo01示例Actor的消息处理器（玩家进入、输入、离线）。
actor_demo01.cpp	演示地图Actor实现
actor_demo01.h	演示地图Actor头文件
actor_demo01_manager
message
actor_demo01_manager_handle.cpp	Demo01 地图管理器消息处理器实现
actor_demo01_manager.cpp	Demo01 地图实例管理 Actor 实现
actor_demo01_manager.h	Demo01 地图实例管理 Actor 头文件
actor_events
actor_events.h	事件Actor，管理定时游戏事件和活动调度
events_logic.cpp	事件逻辑和定时事件调度实现
events_logic.h	事件逻辑和定时事件调度声明
events_map.cpp	事件地图数据结构和空间事件触发实现
events_map.h	事件地图数据结构和空间事件触发声明。
actor_example_guess_number
message
actor_example_guess_number_handle.cpp	猜数字游戏消息处理器实现
actor_example.h	示例游戏Actor基类，提供共享的会话管理。
actor_example_guess_number.cpp	猜数字游戏 Actor 实现
actor_example_guess_number.h	示例猜数字游戏Actor，演示回合制游戏逻辑。
actor_example_manage
message
actor_example_manage_handle.cpp	示例玩法管理器消息处理器实现
actor_example_manage.cpp	示例玩法管理器 Actor 实现
actor_example_manage.h	示例游戏管理器 Actor，协调匹配和房间生命周期
actor_example_match
message
actor_example_match_handle.cpp	示例匹配 Actor 消息处理器实现
actor_example_match.cpp	示例玩法匹配 Actor 实现
actor_example_match.h	示例匹配Actor，将玩家配对到游戏会话中。
actor_family
message
actor_family_handle.cpp	家族系统消息处理器实现
actor_family.cpp	家族（公会）系统 Actor 实现
actor_family.h	家族/公会Actor，管理公会成员、职位和公会级操作。
family.cpp	实现家族数据操作和公会状态转换
family.h	家族/公会数据结构和数据库持久化。
actor_friends
message
actor_friends_handle.cpp	好友系统消息处理器实现
actor_friends.cpp	好友系统 Actor 实现
actor_friends.h	好友Actor，追踪好友列表、好友请求和在线状态。
friends.h	好友数据结构和好友关系管理。
actor_gateway
message
actor_gateway_handle.cpp	实现网关Actor的各类消息处理器（会话关闭、登录、KCP、进程切换等）。
actor_gateway.cpp	实现网关Actor的构造、会话管理与登录/重连处理逻辑。
actor_gateway.h	网关Actor，桥接外部客户端连接与内部Actor路由。
gateway_info.cpp	网关会话信息管理实现
gateway_info.h	网关会话信息，跟踪已连接客户端及其路由元数据。
actor_gateway_c2g
message
actor_gateway_c2g_handle.cpp	客户端到网关Actor的消息处理器
actor_gateway_c2g.cpp	客户端到网关（C2G）协议转发 Actor 实现
actor_gateway_c2g.h	客户端到网关的协议Actor声明
actor_gateway_g2c
message
actor_gateway_g2c_handle.cpp	网关到客户端Actor的消息处理器
actor_gateway_g2c.cpp	网关到客户端（G2C）协议转发 Actor 实现
actor_gateway_g2c.h	网关到客户端的协议Actor声明
actor_gm
message
actor_gm_handle.cpp	GM Actor的消息处理器
actor_gm.cpp	GM 命令处理 Actor 实现
actor_gm.h	GM命令Actor，处理来自授权操作员的管理命令。
gcmd.h	GM命令定义和命令处理器注册。
actor_gmclient
message
actor_gmclient_handle.cpp	GM客户端Actor的消息处理器
actor_gmclient.cpp	GM 客户端 Actor 实现
actor_gmclient.h	GM客户端Actor，将外部工具的GM命令中继到GM Actor。
actor_kcp
message
actor_kcp_handle.cpp	KCP Actor的消息处理器
actor_kcp.cpp	KCP 可靠 UDP 协议 Actor 实现
actor_kcp.h	KCP Actor，管理UDP/KCP传输会话以实现低延迟通信。
actor_keyvalue
message
actor_keyvalue_handle.cpp	键值存储Actor的消息处理器
actor_keyvalue.cpp	键值存储 Actor 实现
actor_keyvalue.h	键值存储Actor，提供跨Actor共享的持久命名存储。
keyvaluedb.h	键值存储的数据库后端存储组件。
actor_log
message
actor_log_handle.cpp	日志Actor消息处理器
actor_log.cpp	日志Actor实现
actor_log.h	日志Actor，接收来自其他Actor的日志条目并写入持久存储。
actor_login
message
actor_login_handle.cpp	登录Actor消息处理器
account.cpp	账号数据库组件实现
account.h	登录会话跟踪和凭证验证的账号数据结构。
actor_login.cpp	登录Actor实现
actor_login.h	登录Actor，负责验证客户端凭证并协调会话创建。
actor_mail
message
actor_mail_handle.cpp	邮件Actor消息处理器
actor_mail.cpp	邮件Actor实现
actor_mail.h	邮件Actor，管理带附件的异步玩家间邮件。
mail.cpp	邮件数据库组件实现
mail.h	邮件数据结构和邮箱操作。
actor_notice
message
actor_notice_handle.cpp	公告Actor消息处理器
actor_notice.cpp	公告Actor实现
actor_notice.h	公告Actor，向在线玩家广播服务器级通知。
notice.cpp	公告数据库组件实现
notice.h	公告数据结构和通知生命周期管理。
actor_ranklist
message
actor_ranklist_handle.cpp	排行榜Actor消息处理器
actor_ranklist.cpp	排行榜Actor实现
actor_ranklist.h	排行榜Actor，维护多个排名维度的排序排行榜。
rank_item.cpp	排行榜条目实现
rank_item.h	排行榜条目数据结构和比较操作。
ranklist.cpp	排行榜数据库组件实现
ranklist.h	排行榜数据结构和排序逻辑声明。
rankset.h	排名集合，在一个Actor下分组多个排名维度。
actor_robot
message
actor_robot_handle.cpp	机器人Actor消息处理器
actor_robot.cpp	机器人Actor实现
actor_robot.h	机器人Actor头文件，模拟玩家客户端用于自动化测试和压力测试。
actor_robot_manage
message
actor_robot_manage_handle.cpp	实现机器人管理Actor的命令行指令处理逻辑。
actor_robot_manage.cpp	机器人管理Actor实现
actor_robot_manage.h	机器人管理器Actor，生成和协调多个机器人实例。
actor_role
logic
attribute
attribute.cpp	实现玩家属性计算和属性聚合
attribute.h	玩家属性系统
attribute_value.cpp	实现属性值存储和修改器应用
attribute_value.h	属性值容器
buff.h	Buff效果定义
cooldown.h	技能冷却计时器管理
skill.cpp	实现技能定义和战斗技能执行
skill.h	战斗技能定义
unit.cpp	实现战斗单位状态和属性解析
unit.h	战斗单位
bag
autoitem.cpp	实现自动物品使用和触发规则
autoitem.h	自动物品使用规则
bag.cpp	实现玩家背包管理和槽位操作
bag.h	玩家背包
consume.cpp	实现物品消耗和资源扣减
consume.h	物品消耗逻辑
drop.h	掉落表计算
itme.cpp	实现物品数据结构和物品类型操作
itme.h	物品数据结构
synthesis.cpp	实现物品合成和配方逻辑
synthesis.h	物品合成
nmap
aoi.cpp	实现视野兴趣区域(AOI)跟踪和实体可见性
aoi.h	视野兴趣区域(AOI)系统
grid.cpp	实现单个网格单元的实体跟踪
grid.h	单个网格单元
grids.cpp	实现网格集合的空间分区操作
grids.h	网格集合
map.cpp	实现游戏地图逻辑和实体管理
map.h	游戏地图逻辑
task
task.cpp	实现玩家任务进度跟踪和完成逻辑
task.h	玩家任务系统
remakes.cpp	角色备注存储实现
remakes.h	用户定义注释的玩家备注存储
roleinfo.cpp	角色资料信息管理实现
roleinfo.h	玩家资料信息查询和显示名称管理
rolekv.cpp	角色键值存储实现
rolekv.h	角色键值存储组件
message
actor_role_handle.cpp	角色Actor消息处理器
actor_role.cpp	实现玩家角色Actor的构造和子模块初始化
actor_role.h	玩家角色Actor
actor_role_manage
message
actor_role_manage_handle.cpp	角色管理器Actor消息处理器
actor_role_manage.cpp	角色管理器Actor实现
actor_role_manage.h	角色管理器Actor头文件
actor_server
actor_server.cpp	实现服务器路由Actor的节点注册、地址表同步与转发逻辑。
actor_server.h	服务器路由Actor，负责集群节点注册和地址表同步。
actor_testai
message
actor_testai_handle.cpp	测试AI Actor的消息处理器
actor_testai.cpp	测试AI Actor实现
actor_testai.h	测试AI Actor头文件
actor_testlua
message
actor_testlua_handle.cpp	Lua测试Actor消息处理器
actor_testlua.cpp	Lua脚本测试Actor实现
actor_testlua.h	用于验证Lua脚本集成的测试Actor。
testlua.cpp	Lua测试数据组件实现
testlua.h	Lua测试Actor的脚本绑定声明。
actor_testlua2
message
actor_testlua2_handle.cpp	扩展Lua测试Actor消息处理器
actor_testlua2.cpp	扩展Lua测试Actor实现
actor_testlua2.h	扩展Lua测试Actor，用于高级绑定场景。
nforward.h	跨节点消息转发辅助工具。
nprotocol_c2g.cpp	客户端到游戏服（C2G）协议转发注册
nprotocol_g2c.cpp	游戏服到客户端（G2C）协议转发注册
protocol
nactor_auto.cpp	实现自动生成的Actor协议处理逻辑。
nprotocol.cpp	实现协议数据结构的序列化和反序列化逻辑。
nprotocol.h	声明游戏服务器内部协议相关接口。
nprotocol_template.h	声明协议数据结构的序列化和反序列化模板接口。
protocol.cpp	实现协议处理类的静态成员和核心方法。
protocol.h	声明协议处理和分发接口。
tprotocol.cpp	实现模板化协议处理类的静态成员和映射表。
tprotocol.h	声明模板化协议处理接口，支持Lua绑定和协议映射。
tab
ttab_activity.h	声明活动配置表的接口。
ttab_activity_drawcompliance.h	声明活动抽奖合规配置表的接口。
ttab_activity_toprank.h	声明活动排行榜配置表的接口。
ttab_activityalways.h	声明常驻活动配置表的接口。
ttab_activityopenserver.h	声明开服活动配置表的接口。
ttab_attribute.h	声明属性配置表的接口。
ttab_card.h	声明卡牌配置表的接口。
ttab_chat.h	声明聊天配置表的接口。
ttab_consume.h	声明消耗配置表的接口。
ttab_dbload.h	声明数据库加载配置表的接口。
ttab_equip.h	声明装备配置表的接口。
ttab_equiplv.h	声明装备等级配置表的接口。
ttab_errormessage.h	声明错误消息配置表的接口。
ttab_familylv.h	声明家族等级配置表的接口。
ttab_filterword.h	声明敏感词配置表的接口。
ttab_item.h	声明道具配置表的接口。
ttab_mail.h	声明邮件配置表的接口。
ttab_map.h	声明地图配置表的接口。
ttab_matching.h	声明匹配配置表的接口。
ttab_mergearea.h	声明合服区域配置表的接口。
ttab_plays.h	声明玩法配置表的接口。
ttab_random.h	声明随机配置表的接口。
ttab_ranklist.h	声明排行榜配置表的接口。
ttab_recharge.h	声明充值配置表的接口。
ttab_servers.h	声明tab表的接口。
ttab_specialid.h	声明特殊ID配置表的接口。
ttab_synthesis.h	声明合成配置表的接口。
ttab_task.h	声明任务配置表的接口。
net
tcp
ws
asio_ws.cpp	实现基于TCP的WebSocket传输逻辑。
asio_ws.h	基于Boost.Beast的WebSocket传输实现。
nws.cpp	实现WebSocket传输初始化和会话生命周期。
nws.h	WebSocket传输门面类，拥有acceptor并管理活跃会话。
asio_tcp.cpp	实现TCP接受循环、会话创建和数据分发。
asio_tcp.h	基于Asio的TCP acceptor和会话管理。
asio_ws.h	兼容性头文件，从net/tcp/ws重新导出WebSocket传输。
ntcp.cpp	实现TCP传输初始化和会话生命周期。
ntcp.h	TCP传输门面类，拥有acceptor并管理活跃会话。
udp
kcp
asio_kcp.cpp	实现基于Asio的UDP套接字KCP收发。
asio_kcp.h	基于Boost.Asio的UDP套接字KCP收发封装。
kcp_endpoint.cpp	实现KCP端点地址解析和会话管理。
kcp_endpoint.h	表示远端地址和会话ID的KCP端点。
kcp_session.cpp	实现KCP会话状态机和重传调度。
kcp_session.h	KCP会话管理器，封装ikcp状态并管理重传定时器。
nkcp.cpp	实现KCP协议适配器和可靠传输逻辑。
nkcp.h	KCP协议适配器，管理多端口ukcp实例与端口分配。
udp_cmd.cpp	实现KCP握手和控制的UDP命令解析。
udp_cmd.h	KCP握手和控制消息的UDP命令定义。
ukcp.cpp	实现KCP传输门面、会话管理和更新循环。
ukcp.h	拥有会话并驱动更新循环的高层KCP传输门面。
asio_base.cpp	实现Asio I/O上下文初始化和运行循环。
asio_base.h	所有传输层共享的Asio I/O上下文封装。
asio_timer.cpp	实现定时器调度和回调分发。
asio_timer.h	基于Asio的心跳和维护定时器。
net_pack.h	将pack缓冲区绑定到其来源会话的网络包封装。
net_session.h	声明socket会话ID范围的辅助函数。
nnet.cpp	实现基于会话的TCP和WS传输分发。
nnet.h	声明基于会话的TCP和WS传输分发接口。
node_pack.h	跨节点消息路由的节点级数据包封装。
server_session.cpp	实现服务器会话生命周期和连接到actor的绑定。
server_session.h	将网络连接绑定到actor进行消息分发的服务端会话。
server_session_pool.cpp	实现节点间多连接池的生命周期管理和hash路由。
server_session_pool.h	节点间多连接池，按 actor_id hash 选连接分散 IO 负载。
tools
ai
nbt.h	行为树集成：节点工厂、执行上下文和各种节点类型封装。
db
redis
dbredis.cpp	实现Redis客户端连接、命令执行和发布/订阅
dbredis.h	Redis客户端封装，用于键值存储和数据缓存。
sql
mysql
nmysql.cpp	实现MySQL连接生命周期管理和查询执行
nmysql.h	MySQL连接封装，支持查询执行和结果集迭代。
nmysql_manage.cpp	实现MySQL连接管理器的路由和连接池选择逻辑
nmysql_manage.h	MySQL连接管理器，将查询路由到正确的连接池。
nmysql_pool.cpp	实现MySQL连接池的借出、归还和健康检查
nmysql_pool.h	MySQL连接池，支持连接的按索引借出与归还。
postgresql
npostgresql.cpp	实现PostgreSQL连接生命周期管理和查询执行
npostgresql.h	PostgreSQL连接封装，支持查询执行和结果集迭代。
npostgresql_manage.cpp	实现PostgreSQL连接管理器的路由和连接池选择逻辑
npostgresql_manage.h	PostgreSQL连接管理器，将查询路由到正确的连接池。
npostgresql_pool.cpp	实现PostgreSQL连接池的借出、归还和健康检查
npostgresql_pool.h	PostgreSQL连接池，支持自动借出和健康检查。
db_buff.h	用于在actor投递前暂存查询结果的SQL结果缓冲区。
db_cache.h	数据库记录内存缓存层
db_data.h	数据库数据访问对象，管理内存缓存和ID索引。
scope_guard.h	RAII作用域守卫，用于自动执行清理操作。
log
bi
bi.h	BI日志系统，用于业务智能数据采集和上报。
bi_item.h	BI日志条目数据结构，用于业务智能数据采集。
logprintf.cpp	实现带有基于级别着色的控制台日志格式化
logprintf.h	日志格式化输出和文件日志管理。
nactor_logitem.h	Actor日志条目数据结构，用于异步日志投递。
nlog.cpp	实现日志路由到控制台和日志actor
nlog.h	日志路由：将日志条目分发到控制台输出和日志actor。
script
lua
luafunction.h	Lua函数绑定辅助工具，用于C++与Lua之间的类型安全调用。
serialize_lua.cpp	实现C++到Lua值转换的Lua序列化
serialize_lua.h	C++类型与Lua值的双向序列化框架。
serialize
ndefine.h	序列化宏、类型别名和协议ID定义。
nrate.h	用于每个socket消息频率控制的速率限制器。
nserialize.h	基于模板的序列化引擎，将C++类型映射到二进制线路格式。
pack.cpp	实现二进制pack的分配、池化和缓冲区管理。
pack.h	网络协议消息的二进制序列化打包/解包。
pack_head.cpp	实现数据包头部解析和帧验证。
pack_head.h	定义二进制协议帧字段的数据包头部布局。
segpack.cpp	实现分段数据包重组
segpack.h	面向流传输（TCP）的分段数据包重组。
socket_pool.h	线程本地socket缓冲池，带有按桶划分的全局空闲队列。
structbytes.h	固定布局协议结构体与字节之间的转换辅助工具。
tab
csv
csv.cpp	实现CSV文件解析和行到结构体的映射
csv.h	CSV表加载器和解析器
ncsv.cpp	实现CSV表注册表和批量加载协调
ncsv.h	CSV表注册表和批量加载协调器
json
njson.h	基于RapidJSON的JSON配置文件读取器和类型安全的值访问器。
xml
sysconfig.cpp	实现基于XML的运行时配置加载及派生的网关路由元数据
sysconfig.h	系统配置管理器
xml.cpp	实现XML配置加载逻辑
xml.h	声明XML相关接口。
xml_serialize.cpp	实现XML序列化辅助函数
xml_serialize.h	XML序列化辅助工具
xmlinfo.cpp	实现XML配置信息结构体的序列化逻辑
xmlinfo.h	XML配置数据结构定义
xmlprotocol.cpp	实现XML协议定义加载逻辑
xmlprotocol.h	XML协议定义加载器
tools
tools_base.cpp	实现工具库中的基础、字节序和Base64辅助函数
tools_base.h	声明工具库中的基础、字节序和Base64辅助函数。
tools_cmd.h	命令分发器：基于键值的函数注册与执行框架。
tools_code.cpp	实现工具库中的二进制编解码辅助函数
tools_code.h	二进制编解码辅助工具
tools_consume.cpp	实现资源消耗跟踪和耗时校验
tools_consume.h	资源消耗跟踪和耗时校验辅助工具
tools_core.cpp	实现核心工具函数（随机数、UUID生成等）
tools_core.h	声明工具库中的共享辅助函数和模板。
tools_curl.cpp	实现基于libcurl的HTTP GET/POST请求和邮件发送
tools_curl.h	基于libcurl的HTTP客户端封装，支持GET/POST请求和SMTP邮件发送。
tools_enum.h	枚举值与字符串的双向映射工具。
tools_file.cpp	实现文件和目录I/O操作
tools_file.h	文件读写工具类，支持按行读取和CSV模式。
tools_filterword.cpp	实现聊天敏感词过滤和UTF-8输入验证
tools_filterword.h	敏感词过滤和文本验证工具
tools_group.h	Actor分组管理工具，用于批量操作和成员管理。
tools_hash.cpp	实现工具库中的哈希辅助函数
tools_hash.h	哈希和摘要算法工具函数声明。
tools_impl.h	Pimpl（指向实现）辅助包装类。
tools_misc.cpp	实现工具库中的杂项辅助函数
tools_misc.h	杂项辅助函数和Protobuf特性萃取
tools_nhash.cpp	实现用于字符串键查找的命名哈希函数
tools_nhash.h	类型安全的命名哈希码生成器。
tools_nwork.h	工作队列：单线程消费者模式的任务处理队列。
tools_pb_field.cpp	实现Protobuf字段反射，用于动态消息检查
tools_pb_field.h	Protobuf字段反射辅助工具
tools_split.cpp	实现工具库中的拆分和拼接辅助函数
tools_split.h	字符串拆分与拼接工具。
tools_sys.cpp	实现工具库中的系统和文件系统辅助函数
tools_sys.h	系统和文件系统辅助函数
tools_text.cpp	实现工具库中的文本、正则、URL和大小写转换辅助函数
tools_text.h	文本处理工具：字符编码转换、正则表达式、URL编解码、字符串操作。
tools_thread.h	线程原语：shared_mutex RAII宏、信号量封装和线程辅助工具。
tools_time.cpp	实现时间工具：纪元转换和格式化时间戳
tools_time.h	时间工具：纪元转换、格式化时间戳、星期/日期边界辅助函数。
tools_time_wheel.cpp	实现时间轮定时器逻辑
tools_time_wheel.h	时间轮定时器接口
tools.h	聚合拆分的工具头文件。
type.h	项目范围的类型别名定义。
server
demo
01
demo_game_state.cpp	实现demo01示例客户端的游戏状态管理逻辑。
demo_game_state.h	Demo01示例客户端的游戏状态、场景枚举与玩家数据结构声明。
main.cpp	Demo01示例客户端主入口（SDL3 + ImGui 渲染与机器人驱动）。
libnglcore
core
bootstrap
init_dbdata.cpp	实现数据库数据初始化（种子数据写入）逻辑。
init_dbdata.h	数据库数据初始化声明。
init_server.cpp	实现服务器初始化逻辑。
init_server.h	服务器初始化辅助函数声明。
server_main.cpp	实现核心库主入口 ngl_main 与崩溃转储邮件转发回调。
server_main.h	声明核心库主入口 ngl_main 与崩溃转储回调接口，并定义导出宏。
start_actor.cpp	实现Actor启动逻辑。
start_actor.h	Actor启动辅助函数声明。
start_cross.cpp	实现跨服启动逻辑。
start_cross.h	跨服启动辅助函数声明。
start_crossdb.cpp	实现跨服数据库启动逻辑。
start_crossdb.h	跨服数据库启动辅助函数声明。
start_csvserver.cpp	实现CSV服务端启动逻辑。
start_csvserver.h	CSV服务端启动辅助函数声明。
start_db.cpp	实现数据库节点启动逻辑。
start_db.h	数据库节点启动辅助函数声明。
start_game.cpp	实现游戏服启动逻辑。
start_game.h	游戏服启动辅助函数声明。
start_gateway.cpp	实现网关启动逻辑。
start_gateway.h	网关启动辅助函数声明。
start_log.cpp	实现日志节点启动逻辑。
start_log.h	声明用于log-node启动的引导入口点。
start_login.cpp	实现登录服启动逻辑。
start_login.h	登录服启动辅助函数声明。
start_node.cpp	实现节点启动逻辑。
start_node.h	节点启动辅助函数声明。
start_pushcfg.cpp	实现配置推送启动逻辑。
start_pushcfg.h	配置推送启动辅助函数声明。
start_robot.cpp	实现机器人节点启动逻辑。
start_robot.h	机器人节点启动辅助函数声明。
start_world.cpp	实现世界服启动逻辑。
start_world.h	世界服启动辅助函数声明。
node
core
dumper.h	崩溃转储辅助工具声明。
gdbdmp.cpp	实现GDB调试转储辅助工具。
main.cpp	服务器节点主入口点。
mdump.cpp	实现Windows平台基于dbghelp的崩溃minidump转储逻辑。
tests
actor_manage_gtest.cpp	Actor管理器的单元测试。
actor_role_gtest.cpp	Actor角色系统的单元测试。
bootstrap_gtest.cpp	引导启动流程的单元测试。
net_gtest.cpp	网络层的单元测试。
nfilterword_gtest.cpp	敏感词过滤器的单元测试。
perf_gtest.cpp	性能基准测试。
runtime_gtest.cpp	运行时系统的单元测试。
runtime_helpers.h	运行时测试辅助工具声明。
runtime_test_support.h	运行时测试支持工具声明。
serialize_gtest.cpp	序列化模块的单元测试。
smoke_gtest.cpp	冒烟测试，验证基本启动和关闭流程。
socket_pool_gtest.cpp	Socket缓冲池的单元测试。
startup_support.cpp	测试启动支持工具实现。
test_support.h	测试支持工具声明。
tools_gtest.cpp	工具库的单元测试。
xml_sysconfig_gtest.cpp	XML系统配置的单元测试。
tools
idl
core
idl.cpp	实现IDL解析器逻辑。
idl.h	IDL（接口定义语言）解析器声明。
idlcpp_protocol.h	IDL C++协议生成器声明。
main.cpp	IDL代码生成工具主入口点。
makeproto
core
main.cpp	XML协议生成工具主入口点。
xml_protocol.cpp	实现XML协议生成器逻辑。
xml_protocol.h	XML协议生成器声明。
map_editor
core
main.cpp	地图编辑器 —— SDL3 + ImGui 瓦片地图编辑工具。
rebuild
core
main.cpp	数据库重建工具主入口点。
mi_new.cpp	将全局 C++ new/delete 路由到 mimalloc 的编译单元。