系统简介
本系统把不规则的比赛比分描述(如「2号运动员,第五轮,200分」)通过大模型解析成结构化记录, 经人工确认后写入 SQLite 数据库,并提供筛选查询与删除功能。
当前解析模型:MiniMax-M3,服务状态:
已配置。
每次提交一条比分,最多 200 字。
录入步骤
- 在首页「一、输入一条比分」的文本框中输入或粘贴一名选手的一条成绩,可以是简短描述,也可以是现场解说的口语。
- 点击「解析」,等待大模型返回;解析结果出现在「二、解析结果」区域。
- 核对编号、轮次、得分、状态;黄色行是模型未识别出的内容,需要手工补全, 补不全的行可以点「移除」丢弃。
- 勾选「同轮次重复时覆盖」(默认勾选)后点击「保存入库」。 不勾选时,已存在的同编号同轮次记录会被跳过。
- 重复以上步骤录入下一条;在「三、已入库记录」中按编号、轮次、状态筛选或删除。
[注意] 输入框一次只接受一条比分,超过 200 字或粘贴多行会被拒绝,请逐条提交。
手机语音录入
- 手机访问
http://192.168.66.45:8135/mobile,或点击首页「手机语音」。 - 按住「语音输入」按钮开始说话,松开后自动上传音频。
- FunASR 识别成中文后,页面显示识别原文,并自动调用 LLM 解析。
- 核对编号、轮次、得分、状态,点击「确认入库」。
[浏览器限制] 标准手机浏览器只允许 HTTPS 或 localhost 页面调用麦克风。
HTTP 环境下可使用页面的「系统录音 / 选择音频」入口;如需按住录音,请为系统配置受信任的 HTTPS 证书。
输入规则与示例
支持简短描述,也支持带口头禅、赞美和过程描写的现场解说。以下写法都能识别:
2号运动员,第五轮,200分
23号飞行员234分第2轮
4号运动员第4轮弃权
下面向我们飞过来的七十五号飞行员,他姿态优美,太好了,上靶子了,我们看看多少分,23分,
朋友们这是非常好的成绩,这本次比赛最后一轮,本次比赛一共六轮。
识别约定:
- 只保留编号数字,编号后的「运动员 / 飞行员」等身份词不入库;中文数字会换算,如「七十五号」→ 75。
- 普通得分只取带「分 / 环」等单位的数字,为 0 - 500 的整数,不会把轮次、编号当成分数。
- 轮次:「第五轮」「第2轮」归一化为整数;「最后一轮 / 末轮」在文中给出总轮数时取总轮数 (「一共六轮」→ 第 6 轮),否则留空待补。
- 「试飞轮」按第 0 轮记录。
- 「弃权 / 退赛 / 未参加 / 未上靶 / 脱靶 / 放弃 / DNS / DNF」归一化为弃权状态,得分固定为 503。
- 「清除,2号运动员,第三轮成绩」只生成 2 号、第 3 轮、507 分的清除标记记录,不调用删除或修改接口。
- 赞美、口头禅、动作描写(「姿态优美」「太好了」「朋友们」「上靶子了」)会被忽略。
- 缺少编号或轮次的记录不会被猜测,会进入黄色待补全行。
[警告] 大模型可能存在识别偏差,入库前请务必人工核对预览结果,尤其是得分与轮次。
字段与状态
| 字段 | 含义 | 约束 |
|---|---|---|
| athlete_no | 运动员编号 | 整数 1 - 99999,必填 |
| round_no | 轮次 | 整数 0 - 20,必填 |
| score | 得分 | 普通得分 0 - 500 的整数;弃权固定 503;清除标记固定 507 |
| status | 状态 | normal=正常得分;abstain=弃权/退赛 |
| raw_text | 原始文本 | 保留原文,便于追溯,最多 500 字 |
| batch_id | 解析批次 | 同一次解析生成的批次号,可追溯 |
| submitted_at | 提交时间 | 用户点击解析、请求到达服务端的时间 |
| completed_at | 完成时间 | 大模型返回解析结果的时间 |
| elapsed_seconds | 时间差 | 完成时间减去提交时间,单位秒,保留 3 位小数 |
同一运动员同一轮次只保留一条记录(数据库唯一索引保证),重复入库时按「覆盖」选项处理。
常见问题
解析一直失败或提示 LLM 报错
检查服务器与 LLM 网关的连通性、密钥是否有效;错误会直接显示在页面顶部提示条中,
同时写入容器日志 logs/app.log。
提示「模型未识别出任何比分记录」
说明输入里没有符合「编号 + 轮次 + 得分」结构的内容,请补充编号或轮次后重试。
保存时提示有数据不合法
通常是编号或轮次为空、得分超出范围。请按预览表格中的提示补全后再次保存。
删除后能否恢复
不能。删除为物理删除,请谨慎操作。数据库文件位于服务端 /srv/apps/score-entry/data/score.db,
可由运维定期备份。
接口文档
接口统一返回 JSON,结构如下;成功时 ok 为 true,失败时 ok 为 false 并带
error.code 与 error.message。
成功: {"ok": true, "data": {...}}
失败: {"ok": false, "error": {"code": "INVALID_TEXT", "message": "请先输入比分内容"}}
所有接口均不鉴权,仅限内网使用。除音频上传使用 application/octet-stream 外,
其余写接口请求体必须是 application/json。
语音识别 POST /api/transcribe
请求体为原始音频字节流(WAV/WebM/OGG/MP3/M4A 等),默认最大 5MB。服务端转发至 FunASR, 返回中文文本与识别耗时;该接口本身不调用 LLM、不入库。
curl -s -X POST http://192.168.66.45:8135/api/transcribe \
-H "Content-Type: application/octet-stream" --data-binary @recording.webm
{"ok":true,"data":{"text":"2号运动员第五轮200分","elapsed_seconds":0.812}}
解析文本 POST /api/parse
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 是 | 一条比分文本,1 - 200 字,不支持多行 |
curl -s -X POST http://192.168.66.45:8135/api/parse \
-H "Content-Type: application/json" \
-d '{"text":"下面向我们飞过来的七十五号飞行员,我们看看多少分,23分,本次比赛最后一轮,一共六轮。"}'
{"ok":true,"data":{"batch_id":"9f2c...","model":"MiniMax-M3",
"submitted_at":"2026-11-22 14:20:30","completed_at":"2026-11-22 14:20:31",
"elapsed_seconds":1.182,
"items":[{"line":1,"athlete_no":75,"round_no":6,"score":23.0,
"status":"normal","note":"按共六轮推断为第6轮","raw_text":"..."}],
"invalid":[]}}
接口返回提交时间、完成时间与时间差(秒);入库时把 batch_id 一并提交,
记录会自动沿用这次解析的时间。
保存记录 POST /api/records
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items | array | 是 | 记录数组,最多 5 条 |
| overwrite | bool | 否 | 同编号同轮次是否覆盖,默认 false(跳过) |
| batch_id | string | 否 | 解析批次号,便于追溯 |
curl -s -X POST http://192.168.66.45:8135/api/records \
-H "Content-Type: application/json" \
-d '{"overwrite":true,"items":[{"athlete_no":2,"round_no":5,"score":200,"status":"normal","raw_text":"2号运动员,第五轮,200分"}]}'
{"ok":true,"data":{"inserted":1,"updated":0,"skipped":0}}
查询记录 GET /api/records
| 参数 | 类型 | 说明 |
|---|---|---|
| athlete_no | int | 按编号筛选,可选 |
| round_no | int | 按轮次筛选,可选 |
| status | string | normal 或 abstain,可选 |
| page / size | int | 页码(默认 1)/ 每页条数(默认 50,最大 200) |
curl -s "http://192.168.66.45:8135/api/records?round_no=5&page=1&size=50"
删除记录 DELETE /api/records/{id}
curl -s -X DELETE http://192.168.66.45:8135/api/records/1
批量删除:POST /api/records/delete,请求体 {"ids":[1,2,3]},单次最多 500 条。
统计汇总 GET /api/stats
{"ok":true,"data":{"total":12,"athletes":9,"rounds":5,"abstain":1,
"total_score":2388,"avg_elapsed":1.182,"last_completed_at":"2026-11-22 14:20:31"}}
健康检查 GET /api/health
{"ok":true,"data":{"status":"healthy","version":"001.001-2026.11.22"}}
错误码
| 错误码 | HTTP | 说明 |
|---|---|---|
| INVALID_TEXT | 400 | 文本为空或类型错误 |
| TEXT_TOO_LONG | 400 | 文本超过字数上限 |
| LLM_NOT_CONFIGURED | 503 | 服务端未配置 LLM 密钥 |
| LLM_ERROR | 502 | 大模型调用失败或返回无法解析 |
| NO_RESULT | 422 | 模型未识别出任何记录 |
| INVALID_ITEM | 400 | 入库数据不合法(附 details 明细) |
| TOO_MANY_ITEMS | 400 | 超过单次条数上限 |
| NOT_FOUND | 404 | 记录或接口不存在 |
| DB_ERROR | 500 | 数据库异常 |
[禁止] 本系统不带登录鉴权,只能部署在内网;不要通过端口映射直接暴露到公网。