AwesomeREA.org

案例

RKD Telemetry Extractor：解读 Race-Keeper 赛道日录制数据

记录 Race-Keeper “Instant Video” 记录仪所写的专有 .rkd 遥测格式（随附播放器仅支持 Windows），并以结果一致的 Python 与 Go 解析器把 GPS 和 IMU 通道导出为 Telemetry Overlay CSV 与 GPX。作者称十六进制分析和假设检验由 Claude Code 协助完成，并以已知车辆编号、赛道位置和车速作为锚点。字段含义依据作者自有录制数据的物理交叉核对得出，若干记录类型仍未完全解读。

使用条件与局限

  • 所审阅的固定版本对应 2026 年 2 月的 Python 包 1.0.0。它解读 8 字节文件签名、元数据头、10 字节记录头，以及配置、GPS、加速度计、陀螺仪、周期、时间戳和结束记录，再导出 30 Hz 的 Telemetry Overlay CSV、约 5 Hz 的 GPX 和会话摘要。它只读取遥测数据，.mp4 视频原样使用；由于源录制未连接扫描器，OBD-II 通道尚不支持。
  • 使用者需提供自己的 Race-Keeper 录制所产生的 .rkd 文件。仓库附有作者 2021 年会话的截断样本（约 50 个 GPS 定位点）及参考 CSV 和 GPX 输出，但不含厂商播放器、U 盘内容或完整录制。Python 3.9+ 与 Go 工具链均只使用标准库；README 称需 Go 1.21+，而 go.mod 声明 go 1.24.7。
  • 研究笔记和会话日志将分析归功于 Claude Code（claude-opus-4-6），共进行了三次 2026 年 2 月的会话，另有第四次会话完成测试、文档和 Go 移植。README 与笔记称约用时四小时，而日志所列各会话时长合计更多。JSONL 对话记录虽有说明但未公开，因此无法依据仓库核对对话过程。
  • 报告的验证包括：将记录车速与按 haversine 公式推算的车速比较（误差低于 1%），以 1 g 核对垂直加速度均值，依据 GPS 航向变化拟合约 28 的陀螺仪除数，并将海拔与赛道地形比对。CRC 多项式、周期与计时字段、结束记录中的两个字段以及陀螺仪的精确标定仍未知或属经验值。CI 在 Python 3.9、3.11 与 3.13 上运行测试并要求 100% 分支覆盖率，另在 Ubuntu 与 macOS 上运行 Go 测试，将 Go 输出与仓库中的 Python 参考 CSV 和 GPX 比较；本合集未运行这些测试。
  • 项目声明采用 MIT，并称其独立于 Race-Keeper 和 Trivinci Systems LLC，未获其认可。解读范围限于作者检查过的硬件版本和录制数据，其他设备或固件版本可能不同。所审阅来源未确立 REA 使用。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
应用

来源复核于

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

一手来源

  1. RESEARCH_NOTES.md GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  2. README.md GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  3. RKD_FORMAT_SPEC.md GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  4. SESSION_LOG.md GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  5. samples/README.md GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  6. python/pyproject.toml GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  7. go/go.mod GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  8. .github/workflows/ci.yml GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37
  9. LICENSE GitHub · sam-dumont/rkd-telemetry-extractor · 修订 8db9f37