feat(ws): release generic WebSocket client and server v0.31.0-preview

CHANGELOG.md

@@ -1,3 +1,12 @@
+# v0.31.0-preview — WebSocket（2026-10-29）
+
+- 新增 `ws` 通用 Client/Server/Session：WS/WSS、文本/二进制/JSON、TLS/mTLS、代理、握手认证/Origin/子协议、心跳、有限队列、重连、关闭握手和完整后台完成屏障。
+- 新增进程内 `ws/hub` 分组广播、可选 `ws/rpc` 对称调用/事件/取消与显式订阅恢复、`ws/observe` 安全日志与统计快照。消息不自动重放，不承诺离线或跨节点可靠投递。
+- App 新增 OnStop/OnDrain，复用 Runtime 的依赖保留规则；ws/omni 适配记录真实 101。API 生成入口支持可选的项目自有 RegisterCustomRoutes 方法。
+- 增加真实 TCP/TLS/代理、竞态、安全、模糊测试、性能基准和可运行示例。新增 Gorilla WebSocket 依赖；保持 Go 1.22 语言基线；CLI 默认框架版本同步为 v0.31.0-preview。
+- 兼容边界：nethttp HTTP/1.1；native、独立实验 HTTP/2 和 HTTPS 出站代理当前不支持。
+- 已知限制：原有 x/net HTTP/2 依赖仍有 4 项可达漏洞；浏览器实测未完成，详见 [验收记录](reports/websocket-validation-2026-10-29.md)。
+
 # v0.30.0-preview
 
 - 新增通用 `telemetry.HeaderPropagator` 与 `HeaderPropagationConfig`，配置化接入 Trace ID、Span ID、Request ID Header；不绑定任何网关名称。