118bcbe83c8fcaeffd7590890d8bff0f1d5e5b9b
Highway 上传超过 1 MiB 的载荷(多 chunk 场景)会失败,OneBot 侧表现 为 retcode=1200 / `connection closed before response`。 根因:`uploadHighwayHttp` 用同一个 TCP socket,靠 HTTP keep-alive 把 每个 1 MiB chunk 依次 POST 出去。但 QQ highway 的边缘节点(以及链 路上的代理/NAT)经常在第一次响应之后立刻 FIN 关闭连接,第二个 chunk 的 POST 写到一个已被对端 close 的 socket 上,`readHttpResponseBody` 立刻收到 `close` 事件并抛出 `connection closed before response`。 为什么之前看起来像网络问题:≤1 MiB 的载荷(文本、PTT、小图)只发一 次 POST,永远不会触发;但凡跨过 `HIGHWAY_BLOCK_SIZE = 1 MiB`,第二 个 chunk 路径必然失败。改 Clash MTU、关 TUN、加直连规则都没用,因 为问题不在网络层。 改动: - `uploadHighwayHttp`:每个 chunk 都新开一个 TCP 连接,`finally` 里 `destroy()`。建连开销相对 1 MiB chunk 的传输时间可以忽略,行为也 和 NapCat / Lagrange 在大文件上传时的连接生命周期一致。 - `readHttpResponseBody`:报错信息带上 `received=NB, headerSeen= true|false`,方便后续区分 “连接刚握手就被关” 和 “响应读到一半被 截断” 两种情况。 测试:`packages/core/tests/highway/highway-client.test.ts` 三个用例 (0.5 MiB 单 chunk / 1.5 MiB 两 chunk —— 即本次 bug 复现 / 2.5 MiB 三 chunk),断言 `net.createConnection` 被调用的次数等于 `ceil(size / HIGHWAY_BLOCK_SIZE)`,并且每个用过的 socket 在下一次 建连之前都被 destroy。 线上验证:之前每次发 1 MB 以上图片必出 retcode=1200 的账号,打补丁 后通过 OneBot HTTP 已能正常发出图片。
Next Remote Protocol Framework.
Releases · Issues · QQ 群 · Telegram
SnowLuma 是一个基于 TypeScript 的协议转换框架,旨在为 QQ 客户端提供 OneBot v11 标准接口,支持 WebSocket/HTTP 适配、多账号并行及 WebUI 管理。
特性
- OneBot v11 兼容:支持文本、音视频、Markdown、JSON 等消息格式。
- 高性能架构:TypeScript 全栈,基于 pnpm monorepo 管理,核心逻辑分离。
- 现代化管理:内置 WebUI 面板,支持实时日志、密码热更、多账号管理。
- 多适配器支持:WebSocket (Server/Client)、HTTP (Server/Post)。
- 数据持久化:使用 SQLite 存储好友、群组等关系数据。
快速开始
- 从 Releases 下载最新发布包并解压。
- 运行
./launcher.bat(Windows) 或./launcher.sh(Linux)。 - 访问
http://localhost:5099(初始账号admin,密码见控制台输出)。
鸣谢
参考了 LagrangeV2 的协议定义与 NapCatQQ 的实现思路。
Languages
TypeScript
98.9%
CSS
0.5%
JavaScript
0.5%