llbc 用户指南

llbc 是一个简洁、高性能、跨平台、多语言支持的服务端开发框架，面向 Service + Component 的组织方式，底层由 C++17 实现，广泛用于游戏与通用服务端开发。

注：llbc 框架本身不包含具体业务组件；较为通用的组件由独立仓库 llbc_comps 提供，欢迎贡献。

为什么选 llbc

Service + Component 模型 —— 业务逻辑以 LLBC_Component 挂载到 LLBC_Service，生命周期钩子清晰，天然可组合。
高性能网络层 —— 可插拔 Poller 后端（Linux epoll / Windows IOCP / 通用 select），协议栈可定制。
一站式核心库 —— 线程、定时器、日志、对象池、序列化（LLBC_Stream）、配置（ini/xml/properties）、时间、随机、LLBC_Variant 等常用能力开箱即用。
跨平台 —— Linux / Windows 一级支持；macOS 二级支持；iOS/Android 尽力支持。
多语言封装 —— 在 C++ 核心之上提供 Python（pyllbc）、C#（csllbc）、Lua（lullbc）封装。

游戏服务端、长连接网关、房间/对局服、通用 TCP 服务，以及任何需要「组件化业务 + 高性能网络 + 完整基础库」的 C++ 服务端。

本文档按学习旅程线性组织。当前正以 llbc wiki 为内容基准逐步迁移完善—— 下列标 ✅ 的页面已就绪可直接阅读，其余页面暂为占位、保留目录结构，内容后续补充。

入门
- 安装与构建 ✅：在 Linux/macOS/Windows 上编译核心库。
- Hello World ✅：最小可运行程序，理解 LLBC_Startup/LLBC_Cleanup。
- 第一个 Service：创建 Service、挂载 Component、启动运行。
核心概念
- 架构总览、Service 与 Component、生命周期与事件。
使用指南
- 序列化 Stream ✅。
更多 —— 示例项目、常见问题、贡献指南、更新日志。