Skip to content

chore: 修正与代码不符的注释,删掉面板用不到的排序写入和死分支 - #87

Merged
stqfdyr merged 3 commits into
mainfrom
chore/hub-comment-drift
Oct 1, 2026
Merged

stqfdyr merged 3 commits into
mainfrom
chore/hub-comment-drift

Conversation

@stqfdyr

@stqfdyr stqfdyr commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

通读 hub 源码、面板和安装脚本后的清理,不改任何功能。

注释改正

  • 64 KiB 请求体上限:这一层管的是面板与登录的 JSON,上报走 WebSocket,不经过它
  • 分片上传:单个请求的上限是 MAX_CHUNK(8 MiB),4 MiB 是面板每片的大小
  • 压缩层排除备份的理由:备份并不是压缩文件,排除它是因为体积大、压缩会长时间占 CPU
  • db_backup:导出走自己的连接,不占 agent 写入那条
  • ping_record 的重建在 migrate_to_1,不在 open();Throttle 有登录与注册两份;Scratch 测试辅助的用途
  • install-hub.sh:--site 不合法时,面板现在会直接指出 --site
  • agent 转发处的 ponytail:保留缺口说明,钉摘要的方案写成「评估后未采用」及理由
  • 过去式的回忆写法改成「否则会怎样」,实测数字不变

删掉的

  • NodePatch.sort:面板从不发送;它还能绕过排序接口「必须列全所有节点」的校验。PUT /api/nodes/{id} 带上的 sort 从此被忽略,节点顺序只走 PUT /api/nodes/order
  • 安装弹窗里 token 为空的分支:token 列非空,1.0.0 以来每个节点都有
  • App.tsx 对节点的二次排序:hub 返回时已经是 sort, id 顺序;面板的 Node 类型随之去掉不再读取的 sort
  • /api/nodes 每次复制整份缓存帧,改为直接复用

其它

  • frontend.rs 里一条中文日志改为英文;测试里一条重复断言合并,一段被 rustfmt 挤歪的注释理顺

验证:cargo test(132 通过)、cargo clippy --all-targets、cargo fmt --check、面板 npm test / lint / build;本地起 hub 请求 /api/nodes,返回 200、application/json。

- 注释改正:请求体上限、分片上限、压缩层对备份的说明、导出走独立连接、迁移所在函数、
  Throttle 的两个用途、--site 报错的去向;agent 转发处的 ponytail 不再把已否决的方案写成升级方向
- 回忆式写法改成「否则会怎样」
- NodePatch 去掉 sort:面板从不发送,且它能绕过排序接口「必须列全」的校验
- 面板删掉 token 为空的死分支和重复的节点排序;/api/nodes 直接复用缓存帧,不再复制
- 一条中文日志改为英文,测试里重复的断言合并
@stqfdyr
stqfdyr merged commit 42926e4 into main Oct 1, 2026
1 check passed
@stqfdyr
stqfdyr deleted the chore/hub-comment-drift branch October 1, 2026 07:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant