1. Go Actor 模型：实时应用架构与实战

面向 Go 的实时服务端笔记：网络层、Actor 运行时、网关、分布式发现与路由、可观测性，并以 IM 示例（examples/im_*）串起端到端路径。

1.1. 适合读者

• 具备一定 Go 基础，希望系统了解高性能长连接与消息路径的开发者
• 从事游戏、IM、物联网等实时场景的工程师
• 希望了解 服务级 Actor 在 Go 中如何落地的读者

1.2. 本书特点

• 对照仓库：章节与 zhenyi、zhenyi-base 及 examples/ 示例对齐，优先以源码为准
• 性能与工程：零拷贝、邮箱、网关快速路径、跨进程路由等可落到代码与指标
• 可观测与部署：第 6 章与生产侧建议衔接，便于和 Prometheus / 追踪 / 部署实践对照阅读

1.3. 阅读顺序与结构

• 前言：写作动机与本书边界
• 正文：第 1–8 章（见 SUMMARY.md 目录）
• 附录：API 速查（易随版本漂移，务必与 go doc / 源码核对）
• 致谢

第八章（扩展与社区）与第 7 章 IM 实战、第 6 章可观测性可交叉阅读。

1.4. 在线阅读

官网静态站已托管构建版（侧边栏目录、搜索）：https://zhenyi-site.pages.dev/book/

1.5. 配套代码

• zhenyi：https://github.com/aiyang-zh/zhenyi
• zhenyi-base：https://github.com/aiyang-zh/zhenyi-base

IM 与压测示例见 examples/im_single_demo、im_multi_demo、im_single_client、im_multi_client_load 等。

1.6. 写作约定

• 术语：正文优先中文术语，首次出现可附英文；代码标识符与仓库一致（如 msgId、SessionId）。
• 代码块：尽量标注语言（go、bash、text 等）。
• 节末：各节以「本节要点」或等价小结收束（与早期「本章小结」混排时，以新版为准）。

1.7. 声明

本书为面向工程实践的教程型书稿，非行业标准或厂商规范；架构与性能相关表述仅供对照仓库时参考，重要决策请以源码与官方文档为准并自行验证。

关于其它发行渠道：曾设想是否于掘金小册等形式提供同一套正文，仅为设想，不承诺一定上架；是否实施、何时实施，以届时单独说明为准。若在第三方平台成行，正文仍与本书稿保持一致，修订以本仓库 main 为主线，并与该平台版本同步跟进。当前请以本仓库与官网构建版为阅读来源。

zhenyi 及书中示例尚未经大规模、长周期线上验证；用于生产前请自行压测与演练。书稿有错或过时，欢迎提 Issue / PR。

1.8. 许可证

本书正文（本仓库中的 Markdown 源文件）采用 CC BY-NC-ND 4.0（另有说明的除外）。若在掘金等第三方平台购买或阅读与本书稿对应的版本，涉及平台服务、支付与账号等，以该平台用户协议及相关规则为准。