前言¶
在 DeepSeek Harness（DSH）里做工作流或陪练类助手时，赛车游戏往往只有一个圈速数字，很难回答「慢在哪、为什么慢、先改哪」。第三方遥测软件要单独安装，把数据交给模型又费 token、也涉及上传。dsh-sim-telemetry 把 F1 25 的 UDP 遥测接到 DSH 插件里：采集和分析都在本机 Python 完成，模型主要读报告结论，适合需要可复现、可落地的圈速诊断场景。
这是什么¶
维护者 jingjie43 在 GitHub 开源的 DSH 插件（分类：工作流）。它监听 F1 25 游戏遥测，按赛道距离对齐多圈数据，识别弯道与失误，输出圈速一致性、逐弯对比、时间损失归因和改进建议，并生成图表与 CSV。不依赖额外遥测软件，原始数据落在本地目录，可反复分析。
核心功能¶
采集¶
- F1 25 UDP 遥测，端口与游戏内设置一致（默认可用 20777）。
- 玩家完整数据及全部 22 辆车摘要。
- Motion 包：世界坐标、三轴 G、车头朝向
yaw；方向盘转角；赛道位置m_lapDistance（0 至赛道全长）。 - 原始帧落盘为
frames_*.jsonl，便于事后重跑分析管线。
分析¶
- 多圈按赛道距离对齐，圈速差数秒也不会错位，逐弯对比针对同一弯位。
- 由车头朝向变化率求曲率识别弯道，不依赖「减速」；多圈平均曲率减轻走线差异与 yaw 噪声。
- 速度断崖且横向 G 塌陷才判 spin / 打滑，减少正常刹车误报。
- 时间损失按每 100 米归因；逐弯对比 apex 速度、方向盘峰值、出弯给油点、刹车点等。
产出¶
跑满设定圈数后自动生成，无需再点导出：
- 工程师报告：圈速、失误、时间损失、逐弯表（第 N 弯）、改进建议。
- 轨迹诊断图（实跑轨迹、弯位编号、颜色分级、带方向性的调整建议，例如
方向 多打 −0.36、给油 晚 −125 m）。 - 速度曲线图、油门刹车图。
- CSV 与完整明细 Markdown。
报告检出失误后会主动询问是否对比最快圈逐秒细节（刹车、方向等），便于在对话里继续深挖。
安装与启用¶
DSH 采用「一切皆插件」的扩展方式；社区目录页在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，安装前建议自行查看源码与 MIT 许可证。插件在 DSH 进程权限下运行，涉及本机 UDP 监听与写盘，请确认环境可信。
在 DSH「设置 → 插件」中填写仓库地址：
https://github.com/jingjie43/dsh-sim-telemetry
装完后重启 DSH，设置左侧会出现「赛车遥测」。package.json 要求 Node >=22；分析侧需要 Python 3.10+（3.11 / 3.12 / 3.13 均可），画图依赖 Pillow。面板会检测 Python，未安装时可使用「一键安装 Python 3.12」。
典型用法¶
游戏内遥测¶
F1 25 → 设置 → 遥测设置：
| 项目 | 值 |
|---|---|
| UDP 遥测 | 开 |
| UDP 广播 | 关 |
| 端口 | 与插件设置一致（默认 20777） |
| 发送频率 | 20Hz |
| 格式 | 2025 |
记录与分析¶
- 在插件设置里选择圈数（1 / 3 / 5 圈）。
- 点击「开始记录」，正常跑圈。
- 跑满后自动停止并生成全部结果。
数据目录：
~/.dsh/sim-telemetry/
├── frames_*.jsonl # 原始遥测
├── laps_*.csv # 每圈汇总
├── summary_full_*.md # 完整明细
├── plots/ # 速度图 / 油门图 / 轨迹诊断图
└── settings.json # 面板设置
适用场景与注意¶
适合：本机玩 F1 25、希望用结构化报告驱动 DSH 对话改走线；需要本地留存遥测、少把长 raw 数据塞进模型上下文的情况。
限制（以 README 为准）：
- 弯位校准目前完整支持 银石（Silverstone，18 弯）；其余 23 条赛道尚未填官方弯数，弯道识别可能不准。弯位需实跑遥测校准，维护者计划按赛道逐步补齐。
- 同时只能有一个采集任务、一个监听端口。
- 仅支持 F1 25「2025 赛制」UDP 格式；F2、经典模式未适配。
- 弯位误差量级约几十米（基于实跑走线）；弯名与序号尚未一一对应，报告用「第 N 弯」与轨迹图为主。
- 路线图包括 ACC、AC 等游戏的采集适配，分析管线共用。
结尾¶
dsh-sim-telemetry 把 F1 25 UDP 遥测、本地 Python 分析与 DSH 设置面板串成一条工作流：跑几圈即可得到工程师式结论与图表，再在 Harness 里针对性追问单弯细节。目录页：https://www.skillhub.cn/plugins/jingjie43/dsh-sim-telemetry；源码与说明：https://github.com/jingjie43/dsh-sim-telemetry。
