在 macOS 生态中，USB-C 接口的统一性既是便利也是困惑的来源。一根看似相同的线缆，可能是 USB 2.0 充电线，也可能是支持 240W 供电与 40 Gbps 数据传输的 Thunderbolt 4 线缆。WhatCable 作为一款开源的 macOS 菜单栏应用，通过 SwiftUI 与 IOKit 的深度整合，将这些隐藏的技术细节以直观的方式呈现给用户。本文聚焦其 GUI 可视化层面的工程实现，探讨如何将底层 USB-C 协议信息转化为友好的菜单栏界面。
菜单栏应用的架构设计
WhatCable 采用经典的 macOS 菜单栏应用架构，核心分为三个模块：数据采集层、诊断引擎层与表现层。数据采集层直接与 IOKit 交互，读取四个关键服务树；诊断引擎层负责解析原始数据并生成「人类可读」的描述；表现层则使用 SwiftUI 构建菜单栏弹出面板与设置界面。这种分层设计使得核心逻辑（WhatCableCore）可以被菜单栏应用与命令行工具同时复用，后者同样打包在应用内部。
菜单栏图标采用 SF Symbols，在有设备连接时显示对应的连接状态，无设备时则显示通用图标。用户点击图标后弹出 NSPopover，其中包含所有已连接端口的详细信息。这种设计既保持了菜单栏的简洁性，又提供了足够的信息展示空间。弹出面板支持滚动浏览，当用户连接多根线缆或多台设备时，可以逐一查看每个物理端口的状态。
实时数据的可视化策略
WhatCable 的可视化设计遵循「一眼可读」原则，每个端口的信息被组织为多个视觉层次。最顶层是标题行，用简短的英文短语概括端口当前状态：Thunderbolt / USB4、USB 设备、仅充电、慢速 USB 充电线或无设备连接。这一设计借鉴了状态指示器的设计模式，用最少的认知负荷传达关键信息。
充电诊断是用户最关心的功能之一，WhatCable 为此设计了专门的横幅区域。当检测到充电问题时，应用会显示具体原因：「Cable is limiting charging speed」表示线缆额定功率低于充电器；「Charging at 30W (charger can do up to 96W)」表示 Mac 端请求功率较低（例如电池已接近充满）；「Charging well at 96W」表示一切正常。这种诊断逻辑将技术细节转化为用户可操作的反馈，帮助用户理解为何充电速度未达预期。
对于高级用户或开发者，按住 Option 键点击菜单栏图标（或在设置中开启开关）可以显示底层的 IOKit 属性。这一功能将原始的键值对以字典形式展开，用户可以看到诸如 currentpd, selectedpdo, VendorID 等原始字段的值。这种设计既满足了普通用户的简洁界面需求，也为技术探索者提供了深入了解的入口。
E-Marker 信息的结构化呈现
USB-C 线缆中的 E-Marker 芯片存储了线缆的关键能力参数，WhatCable 从 IOPortTransportComponentCCUSBPDSOP 服务中读取这些数据，并以结构化的方式呈现。速度评级显示为 USB 2.0、5 Gbps、10 Gbps、20 Gbps、40 Gbps 或 80 Gbps；电流额定值显示为 3 A 或 5 A，对应 60W、100W 或 240W 的功率上限；此外还显示 E-Marker 芯片的供应商信息。
这种结构化呈现的关键在于将十六进制的协议数据解码为人类可理解的术语。应用内部使用 USB Power Delivery 3.x 规范定义的位域解析逻辑，将 PDO（Power Data Object）与 VDO（Vendor Defined Object）中的字段提取出来。例如，电流额定值通过读取 VDO 中的 Current 字段并映射到 3A 或 5A，功率上限则根据 Current 与 Voltage 的乘积计算得出。供应商名称的解析则依赖于内置的常见 VID（Vendor ID）查找表，未知厂商则回退到显示十六进制 VID。
命令行工具的补充设计
除了图形界面，WhatCable 还附带了一个命令行工具，可通过 Homebrew 安装或手动创建符号链接链接到应用内的可执行文件。命令行接口提供了四种输出模式：默认的人类可读摘要、--json 结构化输出、--watch 实时流式更新以及 --raw 包含完整 IOKit 属性。这种设计使得 WhatCable 的诊断能力可以融入自动化脚本或系统监控流程，例如在 CI 环境中验证测试设备的充电配置，或在终端中实时监控线缆插拔事件。
命令行工具与 GUI 共享同一个 WhatCableCore 诊断引擎，确保两者对同一线缆的判断一致。这种共享架构减少了维护成本，也保证了用户体验的连贯性。对于需要批量检测或集成到其他工具链中的开发者而言，命令行接口提供了图形界面之外的灵活选择。
技术限制与适用场景
需要注意的是，WhatCable 的功能存在明确的硬件与系统限制。首先，E-Marker 信息仅对包含该芯片的线缆有效，大多数 60W 以下的 USB-C 线缆为无标识的「纯充电线」，无法读取任何规格信息。其次，应用依赖 Apple Silicon Mac 上的 IOKit 驱动暴露的 USB-PD 协商状态，Intel Mac 使用的 Thunderbolt 3 控制器（Titan Ridge）不提供这些接口，因此功能受限。最后，应用需要绕过 App Store 的沙盒限制以访问 IOKit 服务，这意味着它无法上架 macOS App Store，需要手动安装或通过 Homebrew 分发。
综合来看，WhatCable 为 macOS 用户提供了一种低门槛的方式了解连接中的 USB-C 线缆真实能力，将原本隐藏在系统深处的协议信息转化为可操作的诊断反馈。对于经常使用不同线缆进行充电与数据传输的用户，这款应用能够有效减少「为何充电这么慢」的困惑，也为开发者提供了研究 macOS IOKit 与 USB-C 协议的技术参考。
资料来源：WhatCable GitHub 仓库（https://github.com/darrylmorley/WhatCable）