功能定位：为什么需要一键检测节点限速
跨境办公或 4K 追剧时，节点一旦被运营商限速，带宽会瞬间掉档，却未必触发客户端掉线提示。快连把「一键检测」做成独立入口，30 秒内给出「延迟-带宽-丢包」三元组，先量化损失再决定切换，避免盲目跳转浪费每日流量配额。
该检测与「AI 智能加速」并行运行：前者只测速并记录结果，后者负责自动选路；两者数据隔离，因此测速不会占用正常会话带宽，也不会影响游戏专线抖动指标。
核心入口：三端最短路径对照
Windows / macOS
主面板 → 右侧节点列表悬浮「···」→ 限速检测（中文）/ Speed Limit Check（英文）。点击后弹出测速浮层，5 秒后显示结果。
Android / iOS
首页「节点」卡片 → 长按目标节点 → 底部出现工具栏 → 点「测速」。若未出现，请确认客户端已升级至截至当前的最新版本。
TV 与路由器
TV 版暂不支持；路由器管理页 → 节点管理 → 对应节点后方「诊断」→ 限速检测。因路由器 CPU 性能差异，测速耗时可能达桌面端的 2–3 倍。
测速逻辑拆解：带宽、延迟、丢包如何判定限速
客户端会在 3 s 内并发 6 条 HTTPS 下载线程，目标文件大小 100 MB，服务器侧限速 200 Mbps。若实测带宽＜节点标称带宽的 50 % 且持续 4 s 以上，即判定为「疑似限速」；同时读取 ICMP 延迟与 TCP 重传率，丢包 > 2 % 时标记「高丢包」。
经验性观察：晚高峰（21:00–23:00）部分省际出口会对 UDP 443 进行间歇性限速，此时测速结果带宽下降明显，但延迟仅小幅抬升；若你主要使用游戏通道，可优先看「抖动」指标而非下载带宽。
结果面板：三色灯与数字的取舍
| 颜色 | 阈值 | 建议动作 |
|---|---|---|
| 🟢 绿色 | 带宽 ≥ 标称 70 % 且丢包 ≤ 1 % | 继续使用 |
| 🟡 黄色 | 带宽 30–70 % 或丢包 1–3 % | 轻度限速，可暂时保留并观察 5 min |
| 🔴 红色 | 带宽 < 30 % 或丢包 > 3 % | 立即切换节点或协议 |
黄色区间最容易误判——若后台正跑系统更新，带宽会被正常抢占。此时可点击「重新检测」→ 勾选「暂停后台流量」获得干净环境。
常见失败分支与回退方案
现象 1：测速按钮灰色
原因：节点处于「连接中」或「重连」状态；客户端禁止并行测速。回退：等待 10 s 状态变为「已连接」即可恢复。
现象 2：测速卡在 0 %
原因：本地防火墙拦截测速域名 *.qos.quicklink.pub。验证：浏览器访问测速域名，若同样无法下载，即确认被拦截。处置：把测速域名加入白名单或临时切换至「兼容模式」。
现象 3：结果带宽远高于套餐标称
原因：校园网多拨或宽带叠加。经验性观察：Windows 11 + 并行接口开启后，曾出现 1.8 倍标称值，属正常叠加效应，不代表节点未限速。
进阶：把检测数据导出给外部脚本
桌面端设置 → 高级 → 诊断日志 → 勾选「记录测速原始数据」。路径因系统而异，Windows 默认在安装目录 logsqos_timestamp.json，可用 Python 脚本批量解析 bandwidth 字段，绘制 24 h 趋势。
提示：若你管理 10 人以上外贸团队，可把每日红色节点写入飞书表格，通过飞书机器人推送「限速预警」，减少人工巡检。
什么时候不该依赖一键检测
- 目标服务器本身带宽不足：例如某些海外 SVN 仓库限速 5 Mbps，此时节点再快也无法提升。
- 你需要长时间稳定 IP：AI Region-Shift 会在检测失败后自动切换，导致 IP 变动，若正在跑银行风控接口，请关闭自动切换改用静态节点。
- 合规审计场景：测速日志含出口 IP 与时间戳，若公司要求零日志，请关闭「记录测速原始数据」。
适用/不适用场景清单
| 场景 | 建议 | 理由 |
|---|---|---|
| 4K 直播前 | 必测 | 提前发现带宽瓶颈，避免开播后码率骤降 |
| 游戏团战 | 看抖动而非带宽 | 限速对 UDP 游戏通道影响小，抖动 > 10 ms 才需换节点 |
| CI 自动测试 | 关闭 | 频繁测速会占用每日流量配额，建议用外部 ping 脚本 |
最佳实践：5 条决策规则
- 每日首次连接后先测速，记录颜色截图，方便后续投诉客服。
- 出现黄色结果先不换节点，关闭后台同步再复测一次，排除本地抢占。
- 连续 3 次红色才触发「AI Region-Shift」，避免频繁 IP 跳动。
- 外贸 Zoom 会议前 5 min 若测得带宽 < 10 Mbps，手动切至「东京-静态 IP」。
- 月末流量紧张时，用路由器端检测替代桌面端，减少重复下载消耗。
FAQ：一键限速检测常见疑问
测速会消耗多少流量？
每次约 100 MB，若每日测 10 次≈1 GB。可在设置里将「测速文件大小」改为 50 MB 减半，但精度会下降。
节点标注「200 Mbps」却测出 90 Mbps，是否算限速？
按官方定义，低于 50 %（即 100 Mbps）才标红。90 Mbps 属黄色区间，建议结合丢包一起看；若丢包为 0，可视为正常波动。
iOS 客户端找不到「测速」按钮？
请确认已升至 App Store 最新版；TestFlight 旧版在 v9.3 阶段曾短暂下线该功能，切换至正式版即可恢复。
测速结果能否分享给好友？
结果页右上角「分享」可生成加密链接，24 h 内有效；对方无需登录即可查看，但不可二次编辑。
限速检测会留下日志吗？
客户端本地保留 7 天，RAM-disk 节点不保存；若关闭「记录测速原始数据」，则重启后自动清空。
收尾与下一步行动
一键限速检测的核心价值是「量化再决策」：先拿数据，再决定换不换节点，避免拍脑袋。建议你今晚就按文中路径做一次基准测速，把绿黄红三色截图保存，当作后续投诉或调优的客观凭证。若发现连续三日红色占比超过 30 %，可在官方论坛「节点反馈」帖附日志，运营通常会在 48 h 内调整出口限速策略。
未来版本可能会把「黄色区间」细分为「浅黄/深黄」并开放阈值自定义，同时引入周级趋势报告，方便团队管理员一次性评估多条出口。保持客户端自动更新，即可在第一时间体验这些改进。
