- 登录：扫码（含短信二次验证）或手机号+短信验证码；cookie 失效自动重新登录
- 私信 + 群聊：同一套收发，群聊事件带
is_group、群号即conv_id - 收消息：文本、图片（自动解密）、视频（CENC 自动解密，
play_url拿来即播）、表情、系统提示 - 发消息：文本、图片、视频、表情、引用回复（私信/群聊通用）
- 会话列表：
get_conversations拉群 + 私信（含成员、群头像、最后消息时间） - 撤回消息
- HTTP 接口发消息 + WebSocket 推事件（见 API.md）
- 原始 protobuf 帧调试通道
/oriws
CGO_ENABLED=0 go build -ldflags="-s -w" -o dist/jumpbyte-bot ./cmd/botjumpbyte-bot 探测 cookie（失效自动重新登录）→ 连接 IM → 启动网关
jumpbyte-bot login 登录（有 phone 走验证码，否则扫码），写 cookie.json
jumpbyte-bot --selftest 自检算法
jumpbyte-bot --smoke 给自己发一条测试消息，验证收发联机
首次运行无 cookie.json 时自动进入扫码登录，终端打印二维码并存一份 qrcode.png。
二维码默认半块渲染，设 GOBOT_QR=braille 切换为更小的盲文点阵。
手机号+验证码登录：在 cookie.json 填 phone（cookie 留空即可），启动后自动发短信、
终端提示输入验证码换取 cookie；之后 cookie 失效也会用同一手机号重新走验证码登录。
手机号与验证码都用 code_encrypt（XOR 5+hex）加密，签名与扫码登录同源。
cookie.json（账号，login 自动写入）：
{
"id": "main",
"name": "主号",
"cookie": "sessionid=...; ...",
"phone": "",
"uid": "1234567890",
"device_id": "3249781169",
"proxy": "",
"channel": 1,
"enabled": true
}只想用验证码登录：
{ "phone": "13800138000", "enabled": true }即可，cookie/uid会在登录后自动补全。
bot.json（网关，首次启动自动生成，token 随机）：
{
"host": "127.0.0.1",
"port": 9503,
"token": "<自动生成>",
"queue_limit": 1000,
"emit_self": false,
"send_channel": "http"
}
send_channel：http（默认，走 imapi）或ws（走安卓 frontier WS）。二者内容/会话逻辑完全一致， 只是传输外壳不同。群聊在 HTTP 通道可能被风控拒（status_code 7523），此时切ws用安卓端身份绕开。
启动后监听 bot.json 里的 host:port（默认 127.0.0.1:9503）：
| 端点 | 用途 |
|---|---|
POST /api/{动作} |
发消息 / 撤回，Authorization: Bearer <token> |
ws /ws?access_token=<token> |
事件流（message / connect / disconnect） |
ws /oriws?access_token=<token> |
原始 protobuf 帧（base64 + 解码树），调试 / 逆向新消息类型 |
GET /health |
存活与账号状态，免鉴权 |
动作：send_text、send_image、upload_image、send_video、send_emoji、send_reply、recall、get_video_url、get_conversations、get_accounts。字段与示例见 API.md。
跑起来的终端也可直接输入 @<conv_id> <文本> 回车发消息。
连上后每收到一帧下推：
{
"type": "raw",
"time": 1787735984,
"len": 711,
"b64": "CNiJ2ZMT...",
"fields": [
{ "f": 1, "t": "varint", "v": "100" },
{ "f": 8, "t": "message", "v": [ { "f": 100, "t": "message", "v": [ ] } ] }
]
}b64 是原始字节，fields 是宽松解码树（字段号 / 类型 / 值），用来对照抓包分析未支持的消息类型。
cmd/bot 入口：命令分发、扫码登录、收发主循环
internal/
sign passport web 签名（sign / qs / xor5 / msToken）
abogus a_bogus（SM3 + RC4变体 + base64变体）
login 扫码 / 手机号验证码登录、MFA、cookie 探测
qr 二维码渲染 + 存 PNG
engine IM 引擎
proto.go 裸 protobuf 编解码器
wsconn.go WebSocket（收消息）
client.go 连接 / 收包解析
httpsend.go 发消息 HTTP 通道（imapi）+ 通道分发
wssend.go 发消息 WS 通道（安卓 frontier，风控绕行）
convlist.go 会话列表（群 + 私信）
imactions.go 撤回 / 表情 / 回复
upload.go 图片上传（SigV4 → TOS）
video.go 视频分片上传
media 图片 AES-256-GCM 解密 + 视频 CENC(AES-128-CTR) 解密 + 本地代理
webapi 昵称解析（带缓存）
store sqlite 昵称缓存
gateway HTTP + WS 网关
config cookie.json / bot.json
收消息走 WebSocket；发消息默认走 HTTP、可切安卓 WS，二者 protobuf 同源，共用一套编解码器与内容/会话逻辑。
单账号。send_card / send_action_card / 点赞未实现。
message_self（自己发的消息）需在 bot.json 里开 emit_self。
- 本项目仅供 学习、研究与技术交流，用于理解 IM 协议与逆向工程原理，严禁用于任何商业、违法或滥用场景。
- 逆向与调试仅应针对 你自己拥有的账号与设备，请勿用于窥探、骚扰、爬取或侵犯任何第三方。
- 一经下载 / 编译 / 运行本项目，即视为你已完全知悉并同意：由此产生的一切后果——包括但不限于账号封禁、限流、封号、数据丢失、法律纠纷、社死、被雷劈——统统由你自己承担，与作者、贡献者、GitHub 及一切相关方无关。
- 本项目与任何平台 / 公司 没有任何关联，非官方、未获授权、不代表其立场，所有商标归各自所有者。
- 请自行遵守你所在地的法律法规以及相关平台的服务条款；因违反而产生的任何责任由使用者独自承担。
- 依据 GPLv3，本软件按「原样」提供，不附带任何明示或暗示的担保（包括适销性、特定用途适用性、不侵权等）。
- 作者可能随时删库跑路，本声明拥有横跨三次元的最终解释权。不接受即刻删除，接受请继续。