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

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

- 类型：案例
- 目标：应用
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-19
- 原始资源：<https://github.com/sam-dumont/rkd-telemetry-extractor>
- 一手来源：<https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/RESEARCH_NOTES.md>
- 目录页面：<https://awesomerea.org/zh/resources/rkd-telemetry-extractor-case/>
- 记录 JSON：<https://awesomerea.org/resources/rkd-telemetry-extractor-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/rkd-telemetry-extractor-case/index.md)

## 使用条件与局限

- **前提条件：**使用者需提供自己的 Race-Keeper 录制所产生的 .rkd 文件。仓库附有作者 2021 年会话的截断样本（约 50 个 GPS 定位点）及参考 CSV 和 GPX 输出，但不含厂商播放器、U 盘内容或完整录制。Python 3.9+ 与 Go 工具链均只使用标准库；README 称需 Go 1.21+，而 go.mod 声明 go 1.24.7。
- **范围：**所审阅的固定版本对应 2026 年 2 月的 Python 包 1.0.0。它解读 8 字节文件签名、元数据头、10 字节记录头，以及配置、GPS、加速度计、陀螺仪、周期、时间戳和结束记录，再导出 30 Hz 的 Telemetry Overlay CSV、约 5 Hz 的 GPX 和会话摘要。它只读取遥测数据，.mp4 视频原样使用；由于源录制未连接扫描器，OBD-II 通道尚不支持。
- **署名：**研究笔记和会话日志将分析归功于 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，未获其认可。解读范围限于作者检查过的硬件版本和录制数据，其他设备或固件版本可能不同。

## 一手来源

1. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/RESEARCH_NOTES.md>
2. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/README.md>
3. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/RKD_FORMAT_SPEC.md>
4. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/SESSION_LOG.md>
5. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/samples/README.md>
6. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/python/pyproject.toml>
7. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/go/go.mod>
8. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/.github/workflows/ci.yml>
9. <https://github.com/sam-dumont/rkd-telemetry-extractor/blob/8db9f373e1a7162d3f2efa297986bdfa86d9400f/LICENSE>

## 同分区更多条目：应用

- [Elgato HDR：为 Elgato 4K X 的 10 位模式提供用户态采集通路](https://awesomerea.org/zh/resources/elgato-hdr-uvc-capture-case/index.md) · 案例
- [LGwebOS-menubar：LG webOS 电视的原生 macOS 遥控器](https://awesomerea.org/zh/resources/lgwebos-menubar-remote-case/index.md) · 案例
- [Galaxy Buds Client：基于三星耳机协议的非官方管理器](https://awesomerea.org/zh/resources/galaxy-buds-client-protocol-case/index.md) · 案例
- [Wino Mail：重建 Windows 邮件与日历体验](https://awesomerea.org/zh/resources/wino-mail-case/index.md) · 案例
- [ScooterLink：重建 Honda RoadSync 车把按键协议](https://awesomerea.org/zh/resources/scooterlink-honda-roadsync-case/index.md) · 案例
- [iX500 Scan：基于逆向 ScanSnap Wi-Fi 协议的 macOS 客户端](https://awesomerea.org/zh/resources/ix500-scan-scansnap-wifi-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。
