feat: wscclient 并入 wsc(wsc.Client), 信封/心跳约定单一来源; 客户端 API 改名 NewClient/ClientConfig/BindPayload/PayloadHandler; 补各包 README

README.md

@@ -1,24 +1,27 @@
 # zogo
 
-zeroone Go 通用库（单仓多包）。被各后端服务以 Go module 依赖引用：
+zeroone Go 通用库（单仓多包，顶层即包）。被各后端服务以 Go module 依赖引用：
 `go get git.zeroonesoft.cn/golib/zogo/xxx`
 
 ## 包清单
 
-| 包 | 用途 | 主要依赖 |
+| 包 | 用途 | 文档 |
 |---|---|---|
-| `httpx` | Gin 统一出入参：OkJson/ErrorJson（CodeMsg 错误码透传）、Handle/HandleResult、Parse（uri→query→header→json 顺序绑定 + binding 校验收口） | gin, validator |
-| `logger` | logrus 日志初始化（文件轮转） | logrus, rotatelogs |
-| `wsc` | WebSocket 服务框架（会话/房间/路由/反射绑定） | gin, gorilla/websocket, uuid, logrus |
-| `wscclient` | WebSocket 客户端（自动重连） | gorilla/websocket |
-| `jwtx` | 轻量 HMAC-SHA256 JWT 签发与校验 | 无 |
+| `httpx` | Gin 统一出入参：OkJson/ErrorJson（CodeMsg 错误码透传）、Handle/HandleResult、Parse（uri→query→header→json 顺序绑定 + binding 校验收口） | [httpx/README.md](httpx/README.md) |
+| `logger` | logrus 日志初始化（控制台彩色 + 按天轮转文件 + 历史压缩） | [logger/README.md](logger/README.md) |
+| `wsc` | WebSocket 服务端框架（会话/房间/路由）+ 配套客户端（自动重连），同一 Message 信封 | [wsc/README.md](wsc/README.md) |
+| `jwtx` | 轻量 HMAC-SHA256 令牌签发与校验 | [jwtx/README.md](jwtx/README.md) |
+
+> 历史说明：v0.1.0 曾存在独立包 `wscclient`，v0.2.0 起并入 `wsc`（`wsc.Client`）——
+> 客户端与服务端共用信封定义，协议单一来源防两端漂移。
 
 ## 约定
 
 - 通用性准入：被 ≥2 个服务复制使用过的包才进入本仓库；仅单服务使用的留在服务内。
-- 改动流程：在本仓库修复/演进 → 打 tag（如 v0.1.1）→ 各服务 `go get -u git.zeroonesoft.cn/golib/zogo@v0.1.1`。
+- 改动流程：在本仓库修复/演进 → 打 tag（如 v0.2.0）→ 各服务 `go get git.zeroonesoft.cn/golib/zogo@v0.2.0`。
 - 本地联动开发：在 `D:\zomaintain\backend\go.work` 中 `use D:/golib/zogo`（go.work 不提交）。
 - go.mod 声明 go 1.24（不高于最低版本消费方），不要随意上调。
+- 每个包自带 README.md（定位/用法/注意事项），改 API 先改文档。
 
 ## 私有模块拉取配置（每台开发机/CI 一次）