WhatCable

WhatCable：彻底看清你的 USB-C 线缆性能

在当今的硬件生态中，USB-C 接口已经无处不在，但一个极大的困扰也随之而来：每一根 USB-C 线缆看起来都一模一样，但它们的性能却天差地别。有些线缆仅支持极慢的充电速度，有些则无法传输视频信号，甚至连高速数据传输也无法胜任。WhatCable 正是为了解决这一痛点而生的专业 macOS 菜单栏诊断工具。

什么是 WhatCable？

WhatCable 是一款专为 Apple Silicon 架构 Mac 设计的 macOS 菜单栏诊断应用。它能够深入读取 macOS 系统底层的 USB-C 和 USB Power Delivery（USB PD）数据，并将其转化为通俗易懂的语言，告诉你线缆的真实能力。无论是充电限制、数据瓶颈还是 e-marker 芯片数据，WhatCable 都能让你一目了然，不再为线缆性能靠猜而烦恼。

核心价值：WhatCable 解释线缆速度、充电极限、e-marker 数据以及连接设备的背景，让复杂的硬件参数变得简单明了。

为什么你需要 WhatCable？

你的抽屉里可能堆满了外观相同的线缆，但它们内部的规格决定了不同的用途：

• USB 2.0 线缆：仅支持 480 Mbps 传输和 60W 充电。它们充电缓慢，不支持视频输出，仅适合连接键盘或鼠标。
• USB4 线缆：支持 40 Gbps 高速数据和 100W 充电，能轻松驱动大多数显示器和外部 SSD。
• Thunderbolt 4 线缆：支持 40 Gbps 数据、最高 240W 充电以及双 4K 显示器输出。这是扩展坞的理想选择，但仅凭肉眼根本无法将其与普通线缆区分开来。

WhatCable 让你无需专业的测试仪，即可在 Mac 上直接识别这些线缆的差异。

WhatCable 的核心功能

1. 充电与数据瓶颈分析

WhatCable 能够实时显示充电状态，并指出瓶颈所在。它是会告诉你到底是线缆、充电器还是 Mac 限制了当前的充电速率，并高亮显示协商后的电力配置文件（Power Profile）。同样，在数据传输方面，它能给出通俗的裁定，告诉你连接速度受限于 Mac 端口、线缆还是外设设备。

2. 线缆 e-marker 数据解码

对于带有 e-marker 芯片的高性能线缆，WhatCable 可以解码并展示其详细规格，包括：

• 线缆额定速度
• 额定电流
• 供应商身份（Vendor Identity）
• USB PD 功能标志

3. 活动传输路径识别

软件可以在物理端口下识别当前正在运行的协议路径，包括 USB 2、USB 3、USB4、Thunderbolt 以及 DisplayPort (DP) 路径。

4. 强大的线缆信任信号

WhatCable 会根据 USB Power Delivery 规范检查 e-marker 数据。如果发现异常（如供应商 ID 为 0x0000、延迟字段使用保留值、或声称支持 5A 但速度仅为 USB 2.0），它会显示橙色警告卡片。这虽然不能 100% 确定线缆是假货，但能有效提醒用户注意潜在的质量问题。

5. 工程师模式与设备识别

通过 Option-点击，用户可以开启工程师模式，查看底层 IOKit 属性和注册表级的原始事实。同时，WhatCable 能将存储设备、集线器、扩展坞等外设准确匹配到它们正在使用的端口，并显示协商好的 USB 速度。

6. 命令行界面 (CLI)

对于开发者和高级用户，WhatCable 捆绑了强大的 CLI 工具。支持快速快照查看、输出 JSON 格式供脚本调用，以及在测试线缆时实时监测端口变动的 --watch 模式。

如何安装与使用 WhatCable

WhatCable 需要运行在 Apple Silicon (M1 或更高版本) 芯片 且系统版本为 macOS 14+ 的 Mac 上。

安装方式

• 推荐方式（Homebrew）： 同时安装菜单栏应用和 CLI 工具：

  brew tap darrylmorley/whatcable
  brew install --cask whatcable
  

• 仅安装 CLI：

  brew tap darrylmorley/whatcable
  brew install whatcable-cli
  

• 直接下载：前往 GitHub Releases 下载最新的 .zip 包，并将 WhatCable.app 拖入应用程序文件夹。

使用技巧

• 启动与设置：安装后，你可以设置 WhatCable 在登录时自动启动。在设置中，你还可以选择“隐藏空端口”以保持菜单栏整洁，或者开启“通知”功能，在线缆连接或断开时接收提醒。
• CLI 运行示例： 在终端输入 whatcable，你可能会看到如下输出：

  USB-C Port 1: 充电正常 (96W)，线缆支持 USB4 40 Gbps。 USB-C Port 2: 线缆限制了充电速度 (仅 60W)，连接设备为 USB 10 Gbps 外部 SSD。

典型使用场景 (Use Case)

• 排查充电缓慢原因：当你发现 Mac 充电很慢时，打开 WhatCable 查看是由于充电器功率不足，还是误用了一根只支持 60W 的旧线缆。
• 验证新购买的线缆：新买的 Thunderbolt 4 线缆是否名副其实？通过 WhatCable 查看其 e-marker 芯片报告的厂商 ID 和带宽数据。
• 显示器连接诊断：如果显示器无法点亮或分辨率受限，查看 WhatCable 以确认 DisplayPort Alt Mode 是否正确激活，以及带宽是否被线缆限制。
• 批量线缆检测：利用 CLI 的 --watch 模式，技术人员可以快速插拔测试多根线缆，并即时获取性能报告。

WhatCable Pro：进阶诊断功能

虽然免费版已经足够强大，但 WhatCable Pro（一次性付费 £4.99）为电力用户提供了更深层次的洞察：

• 实时电力计量：每 2 秒更新一次各端口的瓦特、安培和电压数据。
• 协商诊断：侧向对比 Mac 端口、线缆和外设的支持情况，并高亮薄弱环节。
• 端口健康计数器：查看端口的重置次数、短路记录、错误及 FET 故障。
• PD 合约检查器：查看完整的 PDO 列表、活动电压/电流及不匹配标志。
• DP Alt Mode 与 EDID：查看车道数、链路速率及显示器的完整身份信息。

常见问题解答 (FAQ)

Q: WhatCable 支持 Intel 芯片的 Mac 吗？ A: 不支持。Intel Mac 使用的 Titan Ridge Thunderbolt 控制器不会通过公共 macOS API 暴露 USB-PD 状态或 e-marker 数据。WhatCable 必须依赖 Apple Silicon 芯片读取这些信息。

Q: 它真的免费吗？ A: 是的。WhatCable 基础版是完全免费且开源的（基于 MIT 协议），没有广告和追踪。Pro 版是可选的付费增值功能。

Q: 它会收集我的数据吗？ A: 不会。WhatCable 没有分析插件、没有远程测量，也不会发起网络请求。它仅在本地读取 IOKit 数据。你可以随时在 GitHub 上查看源代码。

Q: 为什么我的线缆显示没有 e-marker 数据？ A: 廉价的 USB 2.0 线缆和大多数额定电流在 3A 以下的线缆内部没有 e-marker 芯片。WhatCable 只能读取线缆报告的数据，如果没有芯片，就无法解码数据。

Q: 它能判断线缆是否为假货吗？ A: 不能给出绝对定论。它提供的“信任信号”会标记出不符合 USB-PD 规范的异常值。如果出现标志，说明该线缆“值得检查”，但不代表一定是伪造品。