Touchline Football
在 DeepSeek Harness(DSH)中查看足球比分、比赛事件和 2D 球场,支持本地追踪回放。
下载 0.8.0 预发布 · 配置说明 · 反馈问题 · 更新记录
当前为预发布。直播球场根据阵型和事件推演,不是真实连续球员追踪;真实赛事的端到端延迟仍待验收。
能做什么
- 比赛小窗:可拖动、可切换尺寸,配合会话输入区的比分胶囊。
- 比分与事件:选择直播场次,查看比分和关键事件;默认使用 ESPN 公开接口,无需付费数据源。
- 本地回放:支持播放/暂停、整场追踪、换人、进度跳转与帧间插值。没有直播时也能进入回放。
- 快捷隐藏:按
Ctrl+Shift+X同时隐藏或恢复小窗和胶囊。
安装
已在 Windows / DSH 0.2.2-rc.1 验证。其他宿主版本尚未建立兼容矩阵。
- 从 Release 下载
dsh-plugin-touchline-0.8.0.tgz。请选择这个安装包,GitHub 自动生成的 Source code 归档用于开发。 - 在 DSH 打开“插件 → 添加插件 → 安装第三方插件”,输入下载文件的绝对路径并安装。
- 启用插件,返回会话页面,在输入区的比分胶囊中选择直播或回放。若界面未更新,刷新 Web GUI;更新宿主代码后可能需要重载插件或重启 DSH。
普通用户无需克隆仓库或执行构建命令。可用 Release 中的 SHA256SUMS-0.8.0.txt 校验下载文件。
DSH Market 尚未收录,目前通过 GitHub Release 安装。公开名称为 Touchline Football,内部包名保留 dsh-plugin-touchline,兼容已有安装和配置。
没有直播时如何体验
“暂无直播”表示当前数据源没有返回正在进行的比赛,不会自动生成虚构直播。回放需要本地数据文件,安装包不附带赛事数据。
可下载或克隆源码,安装开发依赖后生成一个合成演示:
npm ci
npm run replay:demo
在 DSH 的插件行配置中,将 replayDir 设置为生成的 data/replay 文件夹的绝对路径,再从胶囊选择回放。合成演示不是真实比赛。
需要真实追踪回放时,可按数据源说明获取 Metrica 官方开放样本;整场转换命令为:
npm run data:fetch -- --game 1 --full --fps 10
详细配置见插件说明。
数据与已知限制
- 直播比分和事件来自 ESPN 公开接口,可能延迟、缺失或发生结构变化;连续球员位置由引擎推演。
- 5 秒是正常轮询目标,不代表真实直播端到端延迟。断流时保留最后位置,界面显示同步状态。
- 真实 DSH 的挂载、停用清理、重新启用和回放已验收;直播同步使用明确标记的模拟事件流验收,真实正在进行赛事的连续观察仍待补验。
- 回放精度取决于导入数据。官方 Metrica 第 1 场整场回放及六次换人已本地验证,样本不随安装包分发。
开发
使用 Node.js 22(与 CI 一致),在仓库根目录运行:
npm ci
npm run plugin:pack # 类型检查、单元测试、构建和打包
产物为 dist/dsh-plugin-touchline-<version>.tgz。开发验收也使用 .tgz 安装:本机宿主卸载 link: 插件时曾清空源码链接目标,见记录。
npm run check:plugin # 本机 Edge 中的模拟宿主回归
npm run check:live # 直播同步与运动约束回归
npm run check:replay # 官方样本回放回归,需先获取数据
npm run release:prepare # 生成安装包、源码归档、清单与校验文件
独立网页仅用于开发调试,使用方式见开发指南。正式交付物为 DSH 插件。
| 目录 | 用途 |
|---|---|
plugin/ |
插件宿主接口、客户端、小窗与胶囊 |
plugin/host/sources/ |
数据源及归一化 |
src/lib/engine.ts、src/replay/ |
共用球场引擎与回放 |
src/App.tsx、src/components/、server/ |
本地调试页面与服务 |
tests/、scripts/ |
测试、打包及数据转换 |
贡献与许可
欢迎通过 Issues 反馈问题,提交前请阅读 CONTRIBUTING.md。报告问题时请移除账号、聊天内容、本机路径及其他私人信息。
代码采用 MIT 许可。第三方赛事数据适用其自身条款,不在 MIT 授权范围内。发布包不含赛事数据、下载样本或队徽文件。发布流程见发布指南。
No comments yet. Be the first to write one.