Module subprotocol 

WebSocket 子协议协商

提供 WebSocket 子协议的注册与协商能力。 子协议用于在 WebSocket 握手阶段协商应用层协议（Sec-WebSocket-Protocol header）。

设计

模块提供两层 API：

• SubProtocolRegistry：基础注册表，支持简单的名称匹配协商。
• VersionedNegotiator：版本感知协商器，支持协议版本、优先级与元数据。

协商遵循 RFC 6455：服务端从客户端提供的列表中选取第一个支持的协议。 VersionedNegotiator 额外支持按优先级排序与版本兼容性检查。

Structs

NegotiationStats

协商统计信息，用于可观测性。

ProtocolMetadata

子协议元数据，携带版本、优先级与描述信息。

SubProtocolRegistry

WebSocket 子协议注册表（基础版）。

VersionedNegotiator

版本感知的子协议协商器。

Enums

NegotiationOutcome

协商结果，携带详细的匹配信息。

Type Aliases

ProtocolVersion

协议版本号（语义化版本的简化表示，如 “1.0”、“2.1”）。