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

httpx/README.md

@@ -0,0 +1,31 @@
+# httpx
+
+Gin 服务的统一出入参收口。
+
+## 响应
+
+统一信封 `{"code":0,"msg":"OK","data":...}`：
+
+- `OkJson(c, data)` —— 成功出参
+- `ErrorJson(c, err)` —— 错误出参；`*CodeMsg` 携带的错误码**透出**（如 401），其余错误折叠为 code 1
+- `wsc.New(401, "未登录")` 构造带码错误
+
+## Handler 收口
+
+```go
+// 泛型：Parse 取参 → 调 logic → 统一出参
+httpx.Handle(c, func(req *CreateReq) (*CreateResp, error) { return svc.Create(req) })
+httpx.HandleResult(c, data, err) // 非泛型场景
+```
+
+## Parse 参数绑定
+
+`Parse(c, &req)` 按固定顺序绑定：**uri → query → header → json body**，全部绑定后统一跑
+binding tag 校验（`bindingValidator`，与 gin 同源 tag 名）。
+
+注意事项：
+
+- 包 `init()` 会设置 `binding.Validator = nil`（关闭 gin 内置校验，避免 query 阶段误报
+  json 字段的 required）。**引入本包即全局生效**，服务内不要绕过 Parse 自行 ShouldBind。
+- 请求结构体可实现 `Validate() error` 接口做自定义校验，在 binding 校验之前调用。
+- body 解析用 `json.NewDecoder` 直解，不触发 gin 内部校验。