常见问题
常见问题
按主题整理，每条答案都对照过 v0.1.4 的源码。
产品定位
杯况是做什么的？
一款 2026 世界杯的桌面资讯工具：赛程、比分、积分榜、淘汰赛对阵，开球时间全部换成北京时间。它常驻在系统托盘里，开球前弹通知，屏幕角落可以放一条置顶的悬浮比分条。
杯况和 FIFA、官方转播有关系吗？
没有。杯况是独立第三方工具，与 FIFA、各国足协及任何官方转播机构都没有隶属、授权或合作关系，只展示公开的赛程、比分、积分等事实数据。见合规说明。
赛事已经结束了，现在装还有什么用？
决赛在 2026-07-20 03:00北京 开球，本届赛事已经结束，开赛通知、悬浮比分条、比赛中的比分这些功能现在用不上了。还能用的是：按北京时间查 104 场的赛程与赛果、看各组积分和淘汰赛对阵。
赛果以数据源同步到的为准。
数据与比分
数据从哪里来？
两个公开数据源：openfootball（CC0 公共领域，104 场的赛程、场馆和赛后比分）和 football-data.org 的免费层（比赛状态与比分，需要 token）。杯况不抓取 CCTV、咪咕等持权转播方的接口或网页。
比分多久更新一次？为什么有延迟？
赛程与赛果每次启动拉一次。比赛中的比分要满足三个条件才联网：填了 football-data token、「比分」页开着、有比赛处在开球前 30 分钟到开球后 135 分钟之间；满足时每 30 秒一次。各页面每 30 秒从本机缓存重读。
公开数据源本身就比直播慢，比分页底部写着「数据可能有延迟，仅供参考」。要零延迟，请以持权平台的直播为准。完整的更新节奏
不填 football-data token 能用吗？
能看赛程、积分榜和淘汰赛，但比赛中的比分不会联网刷新，比分要等 openfootball 社区更新后、下次启动应用时才同步过来。想要赛中比分，到 football-data.org 免费注册一个 token，填进「设置 → 数据源与防剧透」，保存后会立刻联网补一次已结束比赛的赛果。
已更正：旧版文档写「内置离线赛程，开箱即用」。实际首次启动要联网拉一次赛程，拉到之后才能离线查看。
所有时间都是北京时间吗？
是。数据源给的场馆当地时间先换成世界协调时存在本机，显示时统一加 8 小时，和你电脑的时区设置无关。比如墨西哥城 13:00（UTC-6）开球的揭幕战，表里写 06-12 03:00北京。
积分榜怎么排？
由已完场的小组赛现算：胜 3 分、平 1 分、负 0 分，同分依次比净胜球、进球数。每组前两名标绿（出线区），第三名标金（最佳第三候选）。12 个第三名里最终哪 8 个出线，以官方公布为准。
已更正：旧版文档写「A～H 八个小组」。2026 年是 48 队、A–L 12 个小组。
桌面功能
悬浮比分条是什么？怎么打开？
一条 280 × 44 的小窗，始终在所有窗口上面，不占任务栏，可以拖到任意位置。有比赛进行时显示比分（多场时显示第一场和「+N」），没有就显示下一场的倒计时。今日概览的「悬浮比分条」按钮或「设置 → 桌面体验」里的「开/关」都能切换。
已更正：旧版文档写「半透明」。为避开部分 Windows 上透明窗口整窗空白的问题，悬浮条是深色不透明的。
关掉窗口就退出了吗？
不会。点关闭按钮是收进系统托盘。点托盘图标重新打开窗口，有比赛进行中会直接跳到比分页；要真正退出，右键托盘图标选「退出」。
开赛通知会通知哪些比赛？
全部场次，不只是你关注的球队。默认开球前 15 分钟弹，可在「设置 → 开赛提醒」改成 1 到 120 分钟，或整个关掉。通知内容只有对阵和北京时间开球时刻。
全局热键能改吗？
现在固定是 Ctrl+Alt+C，暂不支持改键。被别的软件占用时杯况不会注册它，其他功能不受影响。
开机自启后是直接进托盘吗？
不是。「设置 → 桌面体验」打开开机自启后，杯况随系统启动，主窗口会正常弹出；点关闭收进托盘即可。
已更正：旧版文档写「启动后直接最小化到托盘」，当前版本没有这样实现。
怎么防止被剧透？
点顶栏或赛程页的眼睛图标，已完场的比分都换成「··」，下次打开还记得。悬浮比分条和托盘提示不在防剧透范围内，等回放时先把它们关掉。
费用与授权
杯况收费吗？
收费，是订阅制软件。首次启动自动开始免费试用，剩余天数在「设置 → 授权管理」里看；到期后整个应用会被遮罩，订阅或输入激活码后继续使用。试用天数、套餐与价格由授权服务器下发，以应用内显示为准。使用前需同意的条款见用户协议与免责声明。
AI 分析的追问另外需要你自己的大模型 Key，费用由你和模型服务商结算，与杯况无关。
已更正：旧版常见问题写「本体免费使用」，与下载页的「订阅授权」自相矛盾，以订阅制为准。
一个授权能装几台电脑？
授权按设备绑定，可绑定的台数取决于你买的套餐，在「设置 → 授权管理」能看到当前绑定情况。
隐私与联网
哪些东西会联网？
| 赛程数据源 | R2 镜像、jsDelivr、GitHub，每次启动 |
| football-data.org | 填了 token 才连，请求头里带你的 token |
| 国旗图片 | 从 flagcdn.com 加载 |
| 授权服务器 | license.ruoyi.plus：设备指纹（主机名、系统、硬件标识算出的哈希）、电脑名、系统版本 |
| 更新检查 | 启动 5 秒后读一次 update.json |
| AI 服务商 | 只在你提问时，发送你的问题和这场比赛的统计数据 |
已更正：旧版文档写「个人偏好只存本机，不上传」，没有提授权服务器会收到设备信息。
关注球队、预测记录、token 存在哪？
都在本机的 app.db（Windows 在 %APPDATA%\com.cupwatch.app\），不上传。football-data token 和模型 Key 目前以明文存在这个文件里，不要把它发给别人。
AI 分析与预测
AI 分析会给投注建议吗？
不会。问题里出现「下注、赔率、盘口、买谁、怎么押、让球、大小球、竞彩」等词，杯况在本机直接拒答，不发给模型；发给模型的提示词也要求只做赛事资讯解读。页面上的数据对比和概率都附有「仅供资讯参考，不构成投注或决策建议」的说明。
用 AI 追问需要什么？
你自己的大模型 API Key。点 AI 分析页的「配置模型」，从预设里选服务商（DeepSeek、通义千问、Kimi、智谱、OpenAI 等），填 Key 后可以先「测试连接」。也支持粘贴已有配置一键导入。
「我的预测」是什么？涉及钱吗？
一个只给自己看的记录：开球前在胜 / 平 / 负里记下你的判断，开球后不能再改；完场后按公开赛果标出与赛果是否一致。记录只存在本机。
不涉及钱：完全免费，没有积分兑换、奖品或任何可变现的东西，也没有排行榜。
其他
支持哪些系统？有手机版吗？
Windows（64 位）、macOS（Apple Silicon 与 Intel）、Linux（.deb 与 AppImage）。没有手机版：源码里只有移动端的骨架，没有发布。
已更正：旧版常见问题写「为 Windows 设计」，下载页却提供三个平台，以下载页为准。
怎么更新？
启动 5 秒后杯况会自己检查一次，有新版本就弹窗问你。也可以在「设置 → 关于与更新」点「检查更新」，或回下载页下载新版覆盖安装。