我们在开源什么
zhenyi 是一套基于 Go 的实时应用后端方案：在 zhenyi-base（MIT 基础库）之上，提供 Actor 运行时、统一网关（TCP/WebSocket/KCP）、服务发现与跨进程总线、指标与追踪 等能力，面向游戏、IM、推送、物联网等长连接、低延迟场景。
当前 AGPL-3.0 + 商业双授权 首发，配套文档、示例与持续 CI（测试、race、文档链接检查等）。商业/闭源场景请先阅读仓库内 COMMERCIAL_LICENSE.md。
为什么值得关注
- 服务级 Actor：MPSC 邮箱、Tick/RPC、监督与扩展点，业务按消息驱动组织，而不是到处散落锁与 channel。
- 统一网关
zgate：多协议接入、会话与路由衔接网关与 Actor，减少「网络层一套、业务层又一套」的重复造轮子。 - 可扩展的分布式路径：Etcd 发现、NATS 跨进程、远程路由（含 RendezvousHash 等策略），示例里有多进程 IM 可走通。
- 可观测：Prometheus、健康探针、链路追踪等可接入，便于从 demo 往「能运维」演进。
几分钟跑起来
单机 IM 示例不依赖 Etcd/NATS：
git clone https://github.com/aiyang-zh/zhenyi.git
cd zhenyi
go run ./examples/im_single_demo
# 另开终端
go run ./examples/im_single_client -addr 127.0.0.1:8001 -user 10001 -nick alice -room lobby -msgLogin 1 -msgJoin 2 -msgLeave 3 -msgSend 4
更多示例与分布式说明见 EXAMPLES。
图书（与代码对齐）
开源书稿 《Go Actor 模型：实时应用架构与实战》 与仓库目录对齐，从网络、Actor、网关到分布式与可观测，并串起 IM 示例。
- 书稿入口：github.com/aiyang-zh/z…
- 在线阅读（静态站）：zhenyi-site.pages.dev/book/
我们需要什么
Issue / PR / 文档勘误都欢迎。若你在实时后端、网关或 Actor 落地上有实践经验，也欢迎交流——好的开源项目离不开真实场景里的反馈。
链接汇总
| 项目 | 地址 |
|---|---|
| zhenyi 主仓库 | github.com/aiyang-zh/z… |
| zhenyi-base | github.com/aiyang-zh/z… |
| 官网 | zhenyi-site.pages.dev/ |
| 文档索引 | github.com/aiyang-zh/z… |
（正文以仓库与文档为准；性能与容量结论请以你本地环境与压测为准。）
