比分入库系统 - 使用帮助

自然语言录入 · LLM 结构化 · SQLite 存储  ·  版本 001.005-2026.11.22  ·  接口更新: 2026-11-22

系统简介

本系统把不规则的比赛比分描述(如「2号运动员,第五轮,200分」)通过大模型解析成结构化记录, 经人工确认后写入 SQLite 数据库,并提供筛选查询与删除功能。

当前解析模型:MiniMax-M3,服务状态: 已配置。 每次提交一条比分,最多 200 字。

录入步骤

  1. 在首页「一、输入一条比分」的文本框中输入或粘贴一名选手的一条成绩,可以是简短描述,也可以是现场解说的口语。
  2. 点击「解析」,等待大模型返回;解析结果出现在「二、解析结果」区域。
  3. 核对编号、轮次、得分、状态;黄色行是模型未识别出的内容,需要手工补全, 补不全的行可以点「移除」丢弃。
  4. 勾选「同轮次重复时覆盖」(默认勾选)后点击「保存入库」。 不勾选时,已存在的同编号同轮次记录会被跳过。
  5. 重复以上步骤录入下一条;在「三、已入库记录」中按编号、轮次、状态筛选或删除。
[注意] 输入框一次只接受一条比分,超过 200 字或粘贴多行会被拒绝,请逐条提交。

手机语音录入

  1. 手机访问 http://192.168.66.45:8135/mobile,或点击首页「手机语音」。
  2. 按住「语音输入」按钮开始说话,松开后自动上传音频。
  3. FunASR 识别成中文后,页面显示识别原文,并自动调用 LLM 解析。
  4. 核对编号、轮次、得分、状态,点击「确认入库」。
[浏览器限制] 标准手机浏览器只允许 HTTPS 或 localhost 页面调用麦克风。 HTTP 环境下可使用页面的「系统录音 / 选择音频」入口;如需按住录音,请为系统配置受信任的 HTTPS 证书。

输入规则与示例

支持简短描述,也支持带口头禅、赞美和过程描写的现场解说。以下写法都能识别:

2号运动员,第五轮,200分
23号飞行员234分第2轮
4号运动员第4轮弃权
下面向我们飞过来的七十五号飞行员,他姿态优美,太好了,上靶子了,我们看看多少分,23分,
朋友们这是非常好的成绩,这本次比赛最后一轮,本次比赛一共六轮。

识别约定:

[警告] 大模型可能存在识别偏差,入库前请务必人工核对预览结果,尤其是得分与轮次。

字段与状态

字段含义约束
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

参数类型必填说明
textstring是一条比分文本,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

参数类型必填说明
itemsarray是记录数组,最多 5 条
overwritebool否同编号同轮次是否覆盖,默认 false(跳过)
batch_idstring否解析批次号,便于追溯
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_noint按编号筛选,可选
round_noint按轮次筛选,可选
statusstringnormal 或 abstain,可选
page / sizeint页码(默认 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_TEXT400文本为空或类型错误
TEXT_TOO_LONG400文本超过字数上限
LLM_NOT_CONFIGURED503服务端未配置 LLM 密钥
LLM_ERROR502大模型调用失败或返回无法解析
NO_RESULT422模型未识别出任何记录
INVALID_ITEM400入库数据不合法(附 details 明细)
TOO_MANY_ITEMS400超过单次条数上限
NOT_FOUND404记录或接口不存在
DB_ERROR500数据库异常
[禁止] 本系统不带登录鉴权,只能部署在内网;不要通过端口映射直接暴露到公网。
P-HELP-001