Wi-Fi 体检台
macOS · Windows
这是本人设备和本人家庭网络的排障记录
本文仅复盘本人设备以及本人所有、管理的家庭网络。网站页面是静态文章，不会读取访问者的网络状态。案例工具只在用户主动操作并取得系统授权后，通过操作系统公开接口读取本机连接指标和执行常规联网检查。
工具不读取通信内容、账号密码或其他设备数据，不连接其他无线网络，不尝试访问受保护资源，也不会自动登录或修改网络设备。使用类似工具时，应仅检查本人所有或已获得网络管理者明确授权的网络。
表面信号不差，实际体验却不稳定
项目起点是一次家庭 Wi-Fi 稳定性排查。当时电脑连接 5 GHz 网络，路由器工作在信道 40、160 MHz 频宽。信号表面上没有明显问题，但网页、视频和实时应用仍会卡顿。
关键证据不是“信号弱”，而是无线空口长时间处于繁忙状态。160 MHz 会占用更宽的频谱，在周围网络较多时更容易与其他信号重叠。把频宽调整为 80 MHz 后，稳定性和实际体验明显改善。
频宽是否合适取决于现场环境、设备能力和实际回测。案例的价值在于根据本人网络的真实证据作出调整，而不是把某个参数当成普遍答案。
现有工具给了数字，却没有给判断
普通测速工具通常只显示一个速度结果，专业工具则可能堆叠 RSSI、SNR、信道和频宽等术语。两类工具都很难直接回答普通用户真正关心的问题。
需要区分本机无线连接、家庭内部链路和互联网访问。
每个判断都应对应真实指标，不能只凭主观体感。
原始数值需要配合统一阈值和体验解释。
同一位置、相近时间的前后回测比单次结果更有价值。
先分层，再给出“结论 → 证据 → 动作”
解决方法不是增加更多指标，而是把不同链路分开观察，再用同一种信息结构解释结果。
| 观察层次 | 主要证据 | 要回答的问题 |
|---|---|---|
| 本机无线连接 | 频段、信道、频宽、RSSI、噪声、SNR | 当前电脑的无线连接是否稳定 |
| 家庭内部链路 | 本机到默认网关的延迟、抖动和丢包 | 异常是否发生在家庭内部 |
| 基础联网状态 | 域名解析、网页访问、公网延迟、下载和上传 | 路由器之外的互联网访问是否异常 |
| 前后回测 | 相同条件下的历史结果与变更标记 | 调整是否带来可重复观察的改善 |
先说明当前最值得关注的层次。
展示触发判断的本机指标与阈值。
给出可以人工执行并重新验证的下一步。
把一次排障方法整理成可重复流程
Wi-Fi 体检台围绕“先看现状、完整体检、理解频宽、调整后回测”组织功能，而不是把所有参数塞进同一张仪表盘。
显示本机无线指标，并解释影响、判定标准和本次结果。
在用户发起后持续采样并检查常规联网状态。
分别展示下载与上传变化，并明确单位换算。
只展示操作系统公开提供的广播信道与频宽摘要。
在本机保存记录，并标记“变更前”和“变更后”。
把原始指标转换为统一、可阅读的状态说明。
两个平台读取本机真实数据，共享同一套判断
macOS 与 Windows 的系统接口不同，项目分别使用平台公开能力读取本机数据，再共享阈值、信息层级和交互方法。
| 平台 | 界面与本机数据来源 | 项目状态 |
|---|---|---|
| macOS | SwiftUI、CoreWLAN 与系统网络能力 | 主要功能已完成验证 |
| Windows | .NET、Avalonia 与 Windows 系统无线接口 | 预览版本，持续核对平台差异 |
- 同一个指标的文字、颜色和总览结论来自统一判定。
- 系统接口取不到的数据明确显示“未检测”，不使用推算值冒充采集值。
- 单一指标不能独立证明故障，结论需要结合多项本机证据。
- 历史记录只用于本机前后比较，不上传到项目自建服务器。
效果是形成了可复用、可回测的方法
原始问题通过把频宽从 160 MHz 调整为 80 MHz 得到明显改善。项目进一步把这次经验整理成可以重复执行的观察、调整和回测流程。
项目没有保留调整前后的完整原始吞吐、时延或丢包数据，因此本文不声称具体提速比例，也不把单次家庭网络结果包装成普遍准确率。
隐私与能力边界
本文只是静态文章，不读取访问者设备、网络或位置信息。
只有在用户启动功能并授予系统权限后，才读取本机可见指标。
不会自动修改信道、频宽、域名解析或其他网络设置。
不获取账号密码、通信正文、其他设备文件或受保护数据。
记录可能包含网络名称和诊断指标，用户可在本机自行管理和清除。
只应检查本人所有或已获得网络管理者明确授权的网络。
无线环境概览基于系统公开提供的可见信号摘要，只用于理解本人网络环境，不能替代专业测试设备。
项目资料
本文仅作个人项目的设计与问题解决复盘，不在本站托管或分发软件。项目细节以仓库当前说明为准。