分布式实时应用（Actor 引擎）
基于 zhenyi-base（MIT）；zhenyi 采用 AGPL-3.0 + 商业双授权 · 长连接 · 低延迟
English · 文档索引 · 信创 · Actions · zhenyi-base
zhenyi 在 zhenyi-base 之上提供 Actor 运行时、统一网关（TCP/WS/KCP）、跨进程总线/发现、指标与追踪等能力，面向长连接与实时业务后台。模块清单与架构说明见 文档索引（勿在本页重复维护大表）。
- Actor 运行时：服务级 Actor、MPSC 邮箱、Tick/RPC、协程池；可选熔断与限流。
- 统一网关：
zgate支持 TCP / WebSocket / KCP，可选 HTTP、TLS/国密 GM-TLS、线协议载荷加密等。 - 分布式：Etcd 服务发现、NATS 跨进程总线、远程路由（含 RendezvousHash 等）。
- 可观测：Prometheus、健康探针、链路追踪、监控快照；详见 监控总览。
- 持续剖析（可选）：
zpyroscope与zmetrics解耦；见 监控总览 第 4 节。 - 性能取向：消息对象池、引用计数与零拷贝取向（以源码与基准为准）。
- 信创：国产化构建与运行要点见 信创适配。
go test ./... -count=1
go run ./examples/im_single_demo
# 另开终端：go run ./examples/im_single_client单机示例 不依赖 Etcd/NATS；多进程示例（如 im_multi_demo）需要 Etcd + NATS → 示例总览（含 --reactor / --sharedSendWorker、mmo_web_demo 等）。
| 文档 | 链接 |
|---|---|
| 总目录（索引、Support、安全、监控、发布等） | DOCS_INDEX.md |
| 新手教程 | BEGINNER_GUIDE.md |
| 架构 | ARCHITECTURE.md |
| 模块与 API | MODULE_API.md |
| 信创适配 | XINCHUANG.md |
| 图书（与实现对齐） | go-actor-realtime |
AGPL-3.0 + 商业双授权。 开源使用须遵守 LICENSE。商业、闭源或对外网络服务等场景请先阅读 COMMERCIAL_LICENSE.md。
商业联系：1093993119@qq.com
make test # 单测
make release-check # 发布前：文档链接 + 测试等更多 Make 目标与基准测试见各目录 Makefile 与 示例说明。
本 README 仅作入口；各包文档见子目录
README.md，统一从 文档索引 进入。
部分文档在写作过程中使用 AI 辅助，并经人工校对；仓库持续运行 CI（测试、race、覆盖率、go vet、文档链接检查等，见.github/workflows）。权利义务以 LICENSE 为准；文档与实现不一致时，以可复现的源码与测试结果为准。欢迎 Issue / PR。
