LibMCPP API文档
API 文档按 library 组织，与 libraries/ 源码目录一一对应。
mcbase — 基础库
数据类型与容器
反射与序列化
- reflect - 反射系统
- json - JSON 编解码（variant 原生，支持按字段浮点格式化与循环引用检测）
- json_wrapper - JSON 序列化/反序列化
- pretty_name - 编译期类型名称
字符串与时间
- common - 作用域计时器与线程标识的共享库接口
- string - 字符串格式化与工具函数
- time - 时间处理
- filesystem - 文件系统操作
异常与日志
- exception - 异常处理系统
- error_engine - 错误引擎
- error_message_converter - 标准错误注册表延迟加载与协议字段转换
- log - 日志系统
- log_write_stats - 日志写入量统计（应用层打点，供 mdb_info.log 使用）
- trace - 分布式追踪（OpenTelemetry 风格）
- metric - 进程内度量采集与 SHM 存储（catalog + 同步仪器）
异步与并发
- future - 异步 Future/Promise
- notify - 异步通知原语（tokio Notify 语义）
- wait_group - 等待一组任务完成（Go WaitGroup 语义）
- coro - 协程
- runtime - 线程池与 runtime 运行时长
- entry_admission - RPC 入口准入队列与调度后端接口
- execution_context - runtime 执行上下文捕获与恢复
- sync - 同步原语（锁）
- memory - 智能指针与内存池
- timer - 定时器（stop 后生命周期归还调用方，reset 确定释放）
事件与信号
- object - 对象层次、名称快照、事件投递与执行器绑定
- signal_slot - 信号槽
- singleton - 单例模式
进程间通信
- interprocess - 共享内存 IPC (SHM)
- mdb_privilege - MDB 权限验证
其他
- validate - 参数校验
- proxy_object - 代理对象
- lru_cache - LRU 缓存
- crypto - CRC8/CRC16/CRC32 校验
- variant_lua_utils - Lua variant 工具
- db_table - 内存对象表与重索引契约（
mc::db::table） - radix_tree - 不可变基数树与事务（
mc::im，db 本地存储引擎底层索引）
mcengine — 对象引擎
- object - 对象/接口/属性核心
- context - 调用上下文
- property - Property 处理器
- match - 匹配路由
- dispatcher - 调度/消息/服务
- dbus_error_mapping - 各传输通道共用的 D-Bus 错误映射
- proxy - 对象代理与属性源
- mdb - MDB 对象树查询
- runtime_object - 运行时动态对象
- metric - engine 层
create_*/apply_metric_config（与 mcbase metric 同一文档）
mcapp — 应用框架
- application - 应用生命周期
- service - 服务管理
- external_proto - 外部宿主传输适配
- mdb_resolver - 内存 MDB 查询与宿主 transport 的完整异步解析
- discovery - 自发现服务
- monitor - Monitor 内置对象与 D-Bus 接口
- task - 任务管理
- 资源协作接口 API - 从 libmcpp 实现生成的 D-Bus 接口能力文档
- 资源协作接口一致性报告 - libmcpp 实现与 MDB 定义的比较结果
mcexpr — 表达式引擎
- expr - 表达式求值引擎
mcdbus — D-Bus 通信
- dbus - DBus 模块总览
- connection - 连接管理
- message - 消息处理
- error - 错误处理
- signal - 信号发射
- match - 匹配规则
- enums - 枚举类型
- sd_bus - sd_bus 客户端
- dynamic_object - 动态对象
- validator - 名称验证
- shm - 共享内存通信
mcdatabase — 数据库
- database - 数据库操作模块
- database - 连接管理
- table - 表定义
- field - 字段类型
- row - 行操作
- statement - 查询构建
- sqlite_wrapper - SQLite 封装
- hook - 操作监控
- statistics - 写操作统计
- db_size_check - 存储限制
- persist_client - 持久化客户端
- utils - 工具函数
lmc — Lua 绑定
- lmc - libmcpp 的 Lua 绑定总览（mc 模块地图、mc.class、mc.reflect、强类型容器、信号、异步原语、C++ 嵌入入口）
- lmc/actor - actor 并发模型的 Lua API（mc.actor spawn/register/find/服务动词、actor_ref 透明代理与 sync/async 视图）
- lmc/runtime - 线程池管理的 Lua API（mc.runtime 内置池句柄、new_pool 自建池、current_pool 归属自省、与 actor pool 选项打通）
- lmc/channel - actor 间通道（mc.channel MPMC 有界通道：进度流/fan-in/reply-channel，句柄经 spawn/call 实参跨 VM 传递）
- lmc/sync - actor 同步原语（mc.notify / mc.waitgroup / mc.select；promise 跨 actor；future tap/cancel）
- lmc/binding - 通用 C++↔Lua 绑定核心（usertype、栈转换定制点、高层句柄、重载/可变参数、异常贯通）
- lmc/engine - mcengine 的 Lua 协作面（register/class、实例 get/set/invoke/emit、proxy、service、match/message、context/privilege、mdb、describe）
- lmc/app - mcapp 的 Lua 协作面（mc.app.service 应用层服务：state/short_name/has_dbus、继承 engine service 全部方法、宿主级表达式管线）
- lmc/test - Lua 测试框架（assert_eq 跨类型相等、深度比较、分层 setup/teardown、run 按名筛选、慢测试汇总）
mchttp — HTTP 库
- mchttp (C++) - HTTP 服务端管线/路由/流式/客户端
- mc.http (Lua) - mc.http Lua 绑定