Shield

Skynet 启发的 Lua-first 游戏服务器运行时

单节点优先

最小运行路径聚焦单进程/单节点游戏服务，多节点能力通过官方可选模块显式扩展。

游戏逻辑以 Lua service 编写，C++ 承载运行时基础设施、网络、配置和插件边界。

core 聚焦 service、message、timer 和 coroutine 语义；插件、运维、集群和玩家系统不反向进入 core。

后端能力通过 manifest-first 插件包提供，使用稳定 C ABI、显式实例、显式 binding 和依赖注入。

架构、Lua API、配置、错误码和插件 ABI 以权威文档为准，示例只作为使用参考。

cluster、global、player、server、ops 等可选模块编译开关默认关闭，不属于默认最小运行路径。

Shield 当前文档以文档地图为入口。读者应先区分权威契约、运行时语义、参考文档和草案归档，再进入具体专题。

当前实现路径以单节点 Lua service、配置验证、网络 gateway、插件系统 v1 和官方插件为主。官方可选模块 P0 已落地（见路线图）；旧 DI/IoC、annotations、events、middleware chain、旧插件 v0 等方向不再作为兼容目标。

Shield 面向游戏服务器项目，强调显式 wiring、可审计配置和 Lua 业务迭代。CAF、网络、配置、日志和插件加载属于运行时实现细节；业务侧主要面对 shield.* Lua API 和按配置启动的 service。