WristBeam：为 Mac 配套应用重建佳明手表协议

使用条件与局限

• 审阅版本为 VERSION 0.3.7 及未发布的改动。需要 macOS 13+、已关闭心率广播的佳明手表；使用云端功能时，还需通过佳明官方页面登录佳明中国或国际账号。本地模式会暂停所有佳明云端访问。不支持应用层加密、原生 MLR／CoreTransfer 和桌面小组件，Mac 休眠时无法同步。
• 协议源码注释称，GFDI 分帧（COBS、CRC-16）、多链路注册、设备信息、文件目录与传输、电池状态及账号身份字段均以 Swift 独立实现，并逐项对应自备佳明 Android 安装包中的具名类。Gadgetbridge、garmin-bridge 和 garmin-ble 被列为相互印证的线上协议观察资料，仅作参考而未移植。所审阅文件树不含 APK 或反编译清单；云端历史数据使用 Connect 客户端接口，开发者指南说明这些接口并非佳明公开的 API 约定。
• 构建需要 macOS 13+、Swift 5.9+ 和 Command Line Tools；原生 swift test 及 CodeQL 分析需要完整 Xcode，由 CI 提供。CONTRIBUTING 列出了代码检查、本地化、密钥扫描、发布流水线及核心回归脚本。发布包为临时（ad hoc）签名，未经 Apple 公证。
• 设备矩阵仅将 Instinct 2 Solar 于 2026-10-13 的配对、实时通知、原始 FIT 下载、中国区上传和每日图表标为已验证，且未记录固件版本。其他 Instinct、fēnix、epix、Forerunner、Venu 和 vívoactive 型号以及国际区的实际上传仍未验证。VERIFICATION.md 记录的回归数量通过 Command Line Tools 运行，而非完整 XCTest；本次核查只阅读源码，未运行应用或连接手表。
• MIT 覆盖项目本身，项目声明与佳明无关联；佳明服务、Android 安装包、手表固件和健康数据保留各自条款。MCP、HTTP／HTTPS API 和 Webhook 在启用前均为关闭状态。所审阅来源未确立该应用的开发与 AI 或 REA 有关。

关于此条目

类型

案例

类别

独立重建案例

关联

独立重建项目

目标

应用 · 协议

来源复核于 2026-10-19

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 ↗建议修正翻译 ↗

一手来源

1. README.md GitHub · kongdayan/wristbeam · 修订 712f577
2. Sources/GarminBar/Protocol/GFDISession.swift GitHub · kongdayan/wristbeam · 修订 712f577
3. Sources/GarminBar/Protocol/GFDICodec.swift GitHub · kongdayan/wristbeam · 修订 712f577
4. Sources/GarminBar/Protocol/GFDIFiles.swift GitHub · kongdayan/wristbeam · 修订 712f577
5. Sources/GarminBar/Protocol/GFDIBattery.swift GitHub · kongdayan/wristbeam · 修订 712f577
6. Sources/GarminBar/Protocol/GFDICoreIdentity.swift GitHub · kongdayan/wristbeam · 修订 712f577
7. docs/DEVICES.md GitHub · kongdayan/wristbeam · 修订 712f577
8. VERIFICATION.md GitHub · kongdayan/wristbeam · 修订 712f577
9. docs/developer/API.md GitHub · kongdayan/wristbeam · 修订 712f577
10. docs/developer/WATCH-REQUESTS.md GitHub · kongdayan/wristbeam · 修订 712f577
11. CONTRIBUTING.md GitHub · kongdayan/wristbeam · 修订 712f577
12. Package.swift GitHub · kongdayan/wristbeam · 修订 712f577
13. VERSION GitHub · kongdayan/wristbeam · 修订 712f577
14. CHANGELOG.md GitHub · kongdayan/wristbeam · 修订 712f577
15. LICENSE GitHub · kongdayan/wristbeam · 修订 712f577