Local Software

本地软件状态

用于日常比赛前检查数据库、API、Web、导出备份目录和硬件接入预留。

API 已连接

API 健康检查

API 正常响应。若比赛数据为空，请进入赛事配置初始化赛事和名单。

https://timing.cwzrzt.cn/api/health检查时间：2026/9/22 10:08:52

数据库

所有赛事、轮次、成绩、审计、导出和备份记录落在本地 PostgreSQL。启动入口会先运行 pnpm db:check。

DATABASE_URL恢复动作：启动 PostgreSQL 后重新打开本地软件。

赛事数据

2026 CSI2*广德国际马术场地障碍赛：1 个场次，134 名骑手，156 匹马，4 台设备。

https://timing.cwzrzt.cn/api/demo/overview赛事数据已就绪 · 继续赛事配置

运行版本

当前运行通道：未知版本。可显示为稳定版 / 候选版 / 开发预览版，便于确认现场是否正在使用未验收代码。

build id: unknowngit HEAD: unknown未提交改动：不包含未提交改动构建时间：unknown

桌面运行时

未检测到 Electron 桌面壳状态文件；当前可能是普通本地启动器或开发预览。

EQUESTRIAN_DESKTOP_STATUS_PATH数据库模式：未连接桌面壳PostgreSQL 数据目录：未连接桌面壳PostgreSQL 升级备份目录：未连接桌面壳PostgreSQL 二进制：未连接桌面壳PostgreSQL manifest：未连接桌面壳PostgreSQL manifest 状态：未连接桌面壳PostgreSQL 凭据状态：未连接桌面壳PostgreSQL 凭据文件：未连接桌面壳PostgreSQL 凭据问题：未连接桌面壳PostgreSQL manifest 问题：未连接桌面壳PostgreSQL 生命周期：未连接桌面壳PostgreSQL 进程计划：未连接桌面壳PostgreSQL 迁移前备份：未连接桌面壳PostgreSQL 迁移恢复：未连接桌面壳PostgreSQL 恢复清单：未连接桌面壳PostgreSQL 缺口：未连接桌面壳日志目录：未连接桌面壳诊断目录：未连接桌面壳上传目录：未连接桌面壳导出目录：未连接桌面壳备份目录：未连接桌面壳资源目录：未连接桌面壳源码 release：未连接桌面壳硬件：HTTP unknown / 串口 unknown / TCP unknown硬件接入状态：硬件状态未知 / 当前页面没有读取到桌面硬件运行状态。硬件配置文件：未连接桌面壳硬件日志：未连接桌面壳串口原始帧日志：未连接桌面壳串口检测：未连接桌面壳串口配置：未连接桌面壳FT-DI-12：未启用FT-DI-12 状态文件：未连接 FT-DI-12FT-DI-12 通道状态：暂无状态文件FT-DI-12 最后事件：暂无FT-DI-12 最近转发：暂无FT-DI-12 错误：无TCP 配置：未连接桌面壳

Web / 大屏 / OBS

Web 就绪后可进入计时台、裁判台、大屏控制、OBS overlay、导出和备份页面。

http://localhost:3000OBS Browser Source 使用 /overlay 或独立 overlay 子页面。

导出与备份

导出中心下载成绩文件；备份恢复页创建赛事 JSON 备份，恢复时创建新赛事副本，不覆盖当前数据。

backups/恢复动作必须填写原因并写入审计。

Recovery

恢复操作

从本地软件入口重新启动

优先双击 Open-Equestrian-Timing.command；如果已经在终端里，运行 pnpm start:local。启动窗口需要保持打开。

数据库不可用时

启动器会先执行 pnpm db:check。失败时检查 .env 的 DATABASE_URL、PostgreSQL 是否已启动，确认后重新打开软件。

API 或 Web 未就绪时

等待启动器显示 API health ready 和 Web app ready；如果超时，查看启动窗口里的失败步骤，再点击本页刷新。