# WSS 协议要点

本文件记录 Go 版本当前实现依据，来源包括浏览器手动抢购 HAR、软件运行 HAR/日志、逆向导出的分析文本，以及 Python 参考项目 `/Users/yml/codes/douyu_login_py/core/huya`。

## 连接

- WebSocket URL：`wss://<host>/?baseinfo=<base64 taf>`
- 默认 host：`77bc035c-ws.va.huya.com`
- host 来自 `launch.queryHttpDns` 或浏览器抓包，不应长期写死。
- 握手启用 `permessage-deflate`。
- Go 版本使用 `github.com/gorilla/websocket` 处理握手、mask 与压缩。

`baseinfo` 是 `WSConnectParaInfo` 的 TAF 编码后 base64，再 URL escape。WSS 模式会把 Cookie 中的 `huya_ua` 归一为：

```text
webh5&0.0.1&websocket&&diypc_52775
```

## 外层消息

Python 参考中对应 `WssMessage/WssCommand`，Go 版本实现为 `internal/huya/wss_message.go`。

```text
1B version(0) + 1B command + 4B sequence(big-endian) + body
```

已知命令：

- `0x03`：RPC request
- `0x04`：RPC response
- `0x10`：heartbeat send
- `0x11`：heartbeat recv
- `0x17`：confirm
- `0x21`：register

已知 sequence：

- 心跳：`0x1d00000d`
- `launch.wsLaunch`：`0x1d000078`
- `mobileui.getConfig`：`0x1d000076`
- register：`0x1d00003c`
- confirm：`0x1d000002`
- 业务 RPC：`0x1d000106`

## RPC body

WUP 请求由 `internal/wup` 编码，输出自带 4 字节大端总长度。

小包格式：

```text
[4B WUP 总长度][WUP body] + 2c 36 00 4c 5c 66 00
```

大包格式：

```text
[1B 长度低字节][4B WUP 总长度][裸 WUP body] + trace 尾部
```

其中 trace 尾部形如：

```text
,6%<hex16>:<hex16>:0:3 + 4c 5c 66 00
```

响应解析时，Go 版本会从 WSS body 中切出内部 WUP 包，再交给 `wup.Response.Decode`。

## 初始化流程

WSS session 建立后按以下顺序初始化：

1. 发送心跳。
2. 调用 `launch.wsLaunch`，读取 `guid` 和 `clientIp`。
3. 调用 `mobileui.getConfig`，失败只记录日志，继续后续流程。
4. 使用 `wsLaunch` 返回的 `guid` 发送 register。
5. 发送 confirm。

之后业务接口复用同一个连接，并用 FIFO 队列匹配 `0x04` RPC response。

## 活动接口

当前 Go 版本的 HTTP 与 WSS 都实现 `huya.ActivityClient`：

- `webActUI.getActPrizeList`
- `webActUI.getUserScore`
- `webActUI.getUserPrizeRecords`
- `webActUI.scoreExchangePrize`

抢购兑换请求结构：

```text
tReq.user
tReq.sid
tReq.pid
tReq.ip = ""
tReq.clientEnv = {}
tReq.source = ""
tReq.isRole = 1
```

浏览器手动抢购小黄鸭成功回包确认：

- `webActUI.scoreExchangePrize`
- `sid=2203`
- `pid=12889`
- `status=200`
- `msg=请求成功`
- `exchangeInfo.pid=12889`
- `exchangeInfo.exchangeScore=988`
- `exchangeInfo.desc=兑换奖品：套装-潮萌小黄鸭`

## 待完善

- 自动调用 `launch.queryHttpDns` 获取最新 WSS host。
- 对 WSS RPC response 做 request id 或业务包级匹配，当前与 Python 参考一致使用 FIFO。
- 增加基于真实抓包样本的 WSS body 编解码单测。