什么是 Vivid
Vivid 的定位、核心特性、架构与适用场景
Vivid 是一个高性能、类型安全的 Go 语言 Actor 模型实现库，提供完整的 Actor 系统、消息传递、远程通信、监督策略等核心能力，用于构建可扩展、高并发的分布式应用。
核心特性
| 能力 | 说明 |
|---|---|
| 完整 Actor 模型 | 系统、上下文、引用等核心抽象，树状层级与生命周期管理 |
| 消息传递 | 发后即忘、请求-响应（返回 Future）、回复、结果转发、托管异步任务等 |
| 网络透明 | 配置好远程与编解码后，本地与远程使用同一套调用方式，框架按地址自动选择本地投递或跨网络发送 |
| 远程通信 | 内置跨节点通信，配置绑定/广告地址与编解码后即可实现透明的跨节点消息投递 |
| 集群 | 在远程通信之上可选启用：多节点成员发现与视图同步、故障检测与选主、集群内唯一单例、多数据中心与法定人数。详见 集群 |
| 监督策略 | 一对一 / 一对多，支持重启、优雅重启、停止、优雅停止、恢复、升级等决策，可配置退避与抖动 |
| 调度 | 内置调度器，支持延时一次、固定间隔、Cron 表达式；任务与 Actor 生命周期绑定 |
| 行为栈 | 动态切换与恢复消息处理行为，便于实现状态机 |
| 生命周期钩子 | 启动前、重启前、重启后；以及监听其他 Actor 终止 |
| 消息暂存 | 暂存当前消息并在条件满足时恢复，便于“条件未满足时缓冲” |
| 事件流 | 系统级发布/订阅，事件按类型投递到订阅者邮箱，与普通消息一致 |
| 指标 | 可选启用指标收集，监控 Actor 数量、失败数、重启数、死信等；支持指标更新通知到事件流 |
| 健康检查 | 向目标 Actor 发送探测并同步等待回应，用于可达性检测与往返时延 |
| 类型安全 | 充分利用 Go 类型系统，消息与 Future 泛型、错误链与标准 error 处理 |
| 错误体系 | 预定义错误码（如 Actor 已存在、Future 超时等），支持标准库 errors.Is/As 判定、错误链与跨节点序列化 |
架构概览
Actor 系统层级
系统由 ActorSystem 统一管理所有 Actor。Actor 之间呈树状父子关系：根 Actor 由系统创建，其余均为某 Actor 的子 Actor（由上下文创建）。系统内置事件流与调度器，并可选启用指标、远程通信与集群（集群依赖远程通信）。
-
Actor 树：所有 Actor 呈父子树状结构，根由系统创建，子由上下文创建。
-
系统能力：事件流（发布/订阅）、调度器（延时与周期任务），Actor 通过上下文使用。
-
可选扩展：指标用于监控；远程通信负责跨节点消息投递；集群在远程通信之上提供成员发现、选主与集群单例等。
-
ActorSystem：系统入口，负责启动与停止、创建根 Actor、向任意 Actor 发送消息、按路径查找引用；启用集群时还可获取集群上下文。
-
ActorContext：处理每条消息时注入，提供当前 Actor 的引用与本次消息、发送方、子 Actor 管理、创建子 Actor、向其他 Actor 发消息或回复、行为切换、消息暂存、订阅与监听、事件流、调度器、日志与指标；启用集群时还可访问集群上下文。
-
ActorRef：Actor 的引用，带有地址与路径，发消息时由框架按地址自动路由到本地或远程。
-
集群：在远程通信之上可选开启。框架负责多节点成员发现、故障检测与选主；业务可查询成员与多数派状态、优雅退出、使用集群内唯一单例等，详见 集群。
消息传递流程
- 发送方将消息发往目标引用；框架根据引用中的地址判断本机或远程。
- 本机：消息投递到目标 Actor 的邮箱，由目标串行取信并处理。
- 远程：框架经远程通信序列化并发送，由对端投递到目标 Actor。
- 若为请求-响应模式，接收方回复后，框架将结果交回发送方。
位置透明
远程节点上的 Actor 拥有不同的网络地址，Remoting 负责跨节点序列化与网络传输。业务代码无需区分本地或远程：配置好编解码后，向任意 Actor 发消息的写法一致，框架按引用自动选择本地投递或跨网络发送。
适用场景
分布式系统
跨节点应用，利用网络透明的消息投递与 Remoting
高并发服务
通过 Actor 模型做线程安全、串行化的并发处理
微服务
服务间异步消息与 RPC 风格请求-响应的基础设施
状态机
用行为栈（Become/UnBecome）实现复杂状态机
事件驱动
用 EventStream 构建松耦合的事件驱动架构
定时任务
用内置 Scheduler 做一次性、周期与 Cron 任务
容错系统
用监督策略与生命周期钩子实现自动恢复与优雅停机
集成
官方维护的集成与生态项目（如 Protocol Buffers Codec）见文档 集成 分类，当前包含 vivid-proto 等。
完整 API 与类型定义见 pkg.go.dev。