玉米糊的个人笔记

f1tr：给 F1 25 配一个会说话的 AI 比赛工程师

Thu, 20 Aug 2026 00:00:00 GMT

f1tr：给 F1 25 配一个会说话的 AI 比赛工程师

继续记录我的开源项目。这次是 kemi-20/f1tr——一个给 F1 25 玩家准备的 Windows 桌面应用：监听游戏 UDP 遥测数据，让 AI 扮演比赛工程师，实时给出策略建议，并用 MiMo TTS 把建议用语音播报出来。

::github{repo="kemi-20/f1tr"}

它能做什么

一边玩 F1 25，应用会：

接收全部遥测数据：速度 / 档位 / 转速、四轮磨损与温度（表温 / 内温 / 刹车温）、车身损伤、燃料、ERS、天气、旗语，以及所有对手的位置 / 圈速 / 差距 / 轮胎 / 进站 / 罚时
关键时刻主动播报：轮胎磨损越界、被后车追近、进站窗口打开、安全车 / 虚拟安全车、变天、碰撞、低油等，工程师会用无线电口吻给出建议
语音播报：通过 MiMo TTS 把建议转成语音，支持中文 / English / 中英混合三种模式，带优先级抢断队列
语音输入：按热键或点 Speak 按钮说话，录音转文字后发给 AI 工程师（MiMo ASR）
音频直传：如果默认模型支持音频输入，录音直接发给模型（跳过 ASR 转写）；不支持时走 MiMo ASR 转文字
游戏截图：AI 可主动调用截图工具查看游戏画面，支持图片输入的模型直接看图，不支持的自动用 MiMo 视觉模型描述后转达
全局热键：系统级热键，F1 25 全屏运行时也能触发语音输入
UDP 断线保护：游戏断连超 2 分钟自动暂停 AI 工程师，恢复后自动重启
完整驾驶舱界面：精确赛道俯视图（世界坐标校准）、驾驶 HUD（换挡灯 / ERS / DRS）、四轮卡片（剩余寿命 / 温度 / 刹车）、损伤面板、对手榜、工程师对话流

对手榜双模式

正赛：显示与你的时间差、四胎平均磨损、进站次数
练习赛 / 排位赛：显示每个人的最佳圈速和与你的圈数差（三位小数，精确到赛道进度）

智能上下文

正赛才提醒 DRS 攻防，练习赛 / 排位赛不讲 DRS
雨天 / 湿地自动标记 DRS 禁用，告知 AI 不可开 DRS
人工 Ask 强制播报；自动消息由 AI 判断紧急程度决定是否播报
工程师风格可选 GP / Bono / Bozzi / Adami 四种真实无线电语气

快速开始

1. 下载

去 Releases 页面下载最新版：

F1 Race Engineer Setup x.x.x.exe — 安装版（推荐）
F1 Race Engineer-x.x.x-portable.exe — 绿色版，解压即用

:::note 首次运行 Windows SmartScreen 可能提示「未知发布者」（因为没有代码签名），点「更多信息」→「仍要运行」即可。 :::

2. 配置 AI 与语音密钥

在应用同目录创建 .env 文件，填入：

# AI（OpenAI 兼容端点，支持 DeepSeek / OpenAI / 本地 Ollama 等）
AI_API_BASE_URL=api.deepseek.com
AI_API_KEY=sk-你的密钥
AI_MODEL=deepseek-v4-flash

# MiMo TTS & ASR（语音合成 + 语音识别 + 视觉描述共用）
MIMO_API_BASE_URL=api.xiaomimimo.com
MIMO_API_KEY=sk-你的mimo密钥

.env 不会上传、不含在程序里，纯本地读取。也可启动后在右上角设置面板里临时改连接。

3. 在 F1 25 中开启遥测

Options -> Settings -> UDP Telemetry Settings：

端口 20777
速率 20 / 30 / 60 Hz（推荐 30）
Telemetry Format：2023 / 2024 / 2025 均可（应用会自动识别）

4. 启动

双击 "F1 Race Engineer"。进入比赛后，工程师会在关键时刻自动播报；也可以在右下角工程师面板手动 Ask 提问，或按 Speak 按钮语音输入。

语音输入

点击右下角 Speak 按钮开始录音，按钮变红，再点一次结束（30 秒超时自动停止）
或按全局热键（默认空格键，可在设置中更改），游戏全屏时也能触发
录音编码为 MP3 格式，发送给 MiMo 语音识别（mimo-v2.5-asr）转为文字
转写文字自动作为车手消息发给 AI 工程师，工程师回复会通过 TTS 播报
热键仅在 UDP 连接中或断开不超过 2 分钟时生效
如果默认模型支持音频输入（设置中开启），录音直接发给模型，跳过 ASR

设置面板（右上角齿轮）

AI / LLM：连接地址、模型、温度（0-2）、最大回复 tokens、图片输入开关、音频输入开关、测试连接
TTS - MiMo：语音密钥状态 + 测试
语音 - 语言：中文 / English / 中英混合 + 嗓音选择 + 工程师风格（GP / Bono / Bozzi / Adami）
遥测 - 触发：端口、轮胎磨损阈值、防守距离、心跳间隔等
音频 - 主题：音量、静音、高优先级抢断、停止播报、配色主题
快捷键：语音输入热键配置（默认空格键，按任意键捕获）

从源码构建

需要 Node.js 18+：

git clone https://github.com/kemi-20/f1tr.git
cd f1tr
npm install
npm run dev          # 开发模式（热重载）
npm run build:win    # 打包 Windows 安装器 + 绿色版（产物在 release/）

技术栈

Electron + TypeScript：主进程负责 UDP 解码 / LLM / TTS / ASR / 截图 / 全局热键，渲染进程负责 UI 与 Web Audio 播放
F1 25 UDP 解码：支持 2025 与 2026 赛季包两种线缆格式，自动按包头分派
React + Tailwind：深色赛车玻璃拟态界面
OpenAI 兼容 LLM：默认 DeepSeek（自动禁用 thinking 模式以降低延迟），支持 tool calling（截图工具）
MiMo TTS：24000Hz 单声道 PCM16 流式播放，带优先级抢断队列
MiMo ASR：语音转文字（mimo-v2.5-asr），录音编码 MP3 128kbps
MiMo Vision：游戏截图描述（mimo-v2.5），为不支持图片输入的模型提供视觉
lamejs：浏览器端 MP3 编码
Electron globalShortcut：系统级热键，游戏全屏时也能响应

项目使用 MIT 许可，欢迎提 issue 和 PR。如果你也玩 F1 25，装上试试，听工程师在你耳边喊「Box Box Box」的感觉还挺上头的。

opgo：把 Coding Plan 套餐共享给多人的轻量网关

Thu, 20 Aug 2026 00:00:00 GMT

opgo：把 Coding Plan 套餐共享给多人的轻量网关

这是本站的第一篇文章，介绍一下我最近写的一个小项目：kemi-20/opgo。

::github{repo="kemi-20/opgo"}

它是什么

opgo 是一个用 Go 编写的轻量共享网关：把一份 Coding Plan 套餐共享给多人使用。成员请求被透明转发到上游，网关按模型单价与真实 token 用量计费（内部 8 位小数精度），额度按 5 小时 / 一周 / 31 天 三个滚动窗口限制，并附带一个 Web 用量查询页。

简单说，就是一家人 / 一个小团队合买一份套餐，opgo 负责：转发、计费、限流、记账、查账。

核心功能

透明反代：只替换认证头，请求体原样转发，兼容 OpenAI / Anthropic 协议
按 token 精确计费：模型单价写在 config.jsonc（已预置 deepseek-v4-flash、deepseek-v4-pro、mimo-v2.5、gpt-5.6-luna、hy3 定价）
每人独立额度：每个用户（uuid）拥有 5 小时 / 一周 / 31 天滚动窗口，多 key 共享额度
峰谷时计费：模型级 peak 配置，Peak 时段（UTC 01:00-04:00 与 06:00-10:00）自动按倍率加倍扣款，配置里只需填谷时价
总池保护：以上游实时余量接口为准，套餐额度用尽即返回 429
流式请求照常计费：自动注入 include_usage，流式响应也能拿到真实用量
SQLite 记录全部用量，Web 查询页普通用户查自己、管理员看全部
密钥防泄露：任何接口和前端都不返回任何 key，内置 opgo -audit 自检
单文件静态二进制，Windows / Linux 均可直接运行

安装教程

Ubuntu / Debian（amd64）一键安装

curl -fsSL https://raw.githubusercontent.com/kemi-20/opgo/main/install.sh | sudo bash

首次启动会自动生成 /opt/opgo/config.jsonc（示例配置），编辑后重启服务：

sudo systemctl restart opgo

Windows 本地运行

先安装 Go（1.23.12 或更高），然后在项目目录下构建并运行：

go build -o opgo.exe .
.\opgo.exe

首次运行会在当前目录自动生成 config.jsonc，修改后重启即可。

配置文件说明

配置文件名为 config.jsonc（JSONC = JSON with Comments），程序会自动剥离注释再解析，所以行内 // 注释可以放心写；VSCode 打开时把语言模式选为 JSONC 即可消除红色波浪线。也兼容旧版 config.json：两者同时存在时优先读 .jsonc。

核心字段：

字段	说明
listen	监听地址，默认 `:3003`
upstream_base	上游地址（必填）
master_key	母 key（必填）
admin_password	Web 管理员密码（必填）
balance_url	余量接口，留空用默认值
balance_interval_seconds	余量同步间隔，默认 120
rate_limit_per_minute	每用户每分钟限流，0 = 不限
limits_per_user	每人的 5h / 1w / 1m 美元限额
pricing	模型单价（每百万 token）+ context_length + max_output_tokens + modality + transformation + tag
users	uuid + 备注（可空）+ key 列表

一个最小示例：

{
  "listen": ":3003",
  "upstream_base": "https://api.example.com",
  "master_key": "你的母key",
  "admin_password": "管理员密码",
  "limits_per_user": {
    "5h": 1.0,
    "1w": 10.0,
    "1m": 30.0
  },
  "pricing": {
    "deepseek-v4-flash": {
      "input_per_million": 0.44,
      "output_per_million": 1.32,
      "cached_read_per_million": 0.014,
      "cached_write_per_million": 0,
      "context_length": 1000000,
      "max_output_tokens": 384000
    }
  },
  "users": [
    {
      "uuid": "user-1",
      "remark": "张三",
      "keys": ["用户key-1"]
    }
  ]
}

配置支持热更新：程序后台每 1 秒轮询配置文件，修改保存后无需重启立即生效（仅 listen 变更需要重启）。配置文件非法时自动保留旧配置并在日志中告警，不影响运行。

客户端接入

客户端把 baseURL 指向 http://<主机IP>:3003/v1 即可：

OpenAI SDK / openai-compatible：baseURL: http://IP:3003/v1，自动请求 /v1/chat/completions、/v1/responses
Anthropic SDK：baseURL: http://IP:3003/v1，自动请求 /v1/messages（x-api-key 填你的用户 key）
模型列表：GET http://IP:3003/v1/models
套餐余量（与上游官方格式一致）：GET http://IP:3003/v1/usage（Authorization: Bearer 你的用户 key）

代理会自动剥离 /v1 前缀并转发到上游对应端点；/v1/models 与 /v1/usage 由本地提供，不经过上游。

Web 用量查询

浏览器打开 http://主机:3003/：

用户页签：输入自己的 key，查看三个窗口已用 / 限额 / 百分比与总池实时余量
管理员页签：输入密码，查看全部用户（uuid / 备注 / 用量）与总池

密钥自检与数据查询

opgo -audit -config /opt/opgo/config.jsonc

全部 PASS 退出码为 0；任何响应中出现 key 都会 FAIL。用量数据存在 SQLite 里，可直接查询：

sqlite3 /opt/opgo/usage.db "select uuid, model, total_tokens, cost_units, datetime(created_at_epoch_ms/1000,'unixepoch') from usage order by id desc limit 20;"

注意事项

:::warning 共享订阅可能违反上游服务条款，请自行确认合规性。 :::

管理员密码走明文 HTTP，公网使用请在前置 Nginx / Caddy 上加 HTTPS
同一窗口内并发请求可能把消费略推过限额（最多一个请求的量）
发布版本只需打 tag：git tag v0.1.0 && git push origin v0.1.0，CI 会自动构建并发布 Release（opgo-linux-amd64 / opgo-windows-amd64.exe）

项目目前还很年轻，欢迎提 issue 和 PR。后续我也会在这里记录更多使用心得和踩坑经验。