体彩足球竞彩网页版(站点 sporttery.csh.space)是桌面分析软件「盘口棱镜」的 Web 端呈现。它是纯静态站点,调用 https://api.csh.space/api/v1/tools/sporttery/ 获取赛果、在售赔率、赔率监控、传统足彩、λ/dest 分析等数据,让用户在浏览器里查看竞彩足球数据,无需安装桌面软件。本站还提供一款「补录赛果」便携小工具,供代录人员手工补录比分与终赔并同步到网站。数据仅供学习研究,不构成投注建议。
一、这是什么 / 适用场景
- 网页看数据:在浏览器查看最近 1–7 天竞彩赛果、在售赔率、赔率变动监控、传统足彩、λ/dest 分析,无需安装软件。
- 数据同步架构:桌面端在大陆抓官网数据 → FTP 同步只读 JSON 到网站 → 网页走 API 展示;重计算与授权走 API,香港机不直连竞彩官网。
- 补录赛果:官网尚未出分或终赔缺失时,用便携 EXE 手工补录比分与终赔并同步到网站。
- 代理兜底:香港服务器访问竞彩官网常返回 HTTP 567,支持用户自填公网代理或站长全站配置代理。
二、环境准备与安装启动
本地预览(开发者)
python -m http.server 5500
线上部署(站长)
- DNS:
sporttery.csh.space的 A 记录指向服务器 IP; - 再部署网页:
python deploy_sporttery_web.py; - 站点根目录
/www/wwwroot/sporttery.csh.space,纯静态无需 PHP;SSL 由部署脚本尝试签发,失败可在宝塔面板申请 Let's Encrypt。
补录赛果工具:独立 EXE,对方电脑无需 Python。分发时带整个文件夹(补录赛果.exe + ftp_config.json + 说明),首次拷到任意位置后双击运行;Windows 提示未知发布者选「仍要运行」。需能上网访问 webapi.sporttery.cn(建议大陆网络)。
三、快速上手(第一次怎么用)
- 打开网站:浏览器访问
https://sporttery.csh.space。 - 配置 API Key:点右上角「API 设置」,确认预置演示 Key;额度用尽时填入个人 Key。Key 只保存在本机浏览器。
- 看赛果:切到「赛果」Tab,查看最近 1–7 天比分、半全场、各玩法开奖与终赔。
- 看在售:切到「数据获取」Tab,查看 had/crs/ttg/hafu/mix 在售对阵与赔率。
- 看监控:切到「监控赔率」Tab,按场次查看赔率变动记录(时间、玩法、旧→新、升/降)。
- 遇 HTTP 567:若获取数据失败,在「API 设置」的「HTTP 代理」填公网代理(见 4.4),保存后重试。
- 补录赛果(代录人员):用便携 EXE 拉取官网 → 手补未出分场次 → 同步到网站 → 网页
Ctrl+F5强制刷新查看。
四、核心功能详解
4.1 网页 Tab 与 API 对照
| 功能 | 方法 | API 路径 |
|---|---|---|
| 探活 | GET | /api/v1/tools/sporttery/health |
| 赛果(缓存) | GET | /api/v1/tools/sporttery/results?days=3 |
| 刷新赛果 | POST | /api/v1/tools/sporttery/results/fetch |
| 在售数据(缓存) | GET | /api/v1/tools/sporttery/matches?play_type=mix |
| 刷新在售 | POST | /api/v1/tools/sporttery/matches/fetch |
| 监控会话 | GET | /api/v1/tools/sporttery/monitor |
| 盘口雷达 | GET | /api/v1/tools/sporttery/radar |
| 规则摘要 | POST | /api/v1/tools/sporttery/analyze |
| 传统足彩 | GET | /api/v1/tools/sporttery/ctzc?play=sfc |
请求头用 X-API-Key;可选代理头 X-Sporttery-Proxy。统一响应格式 { success, message, data }。
4.2 已上线能力
- 赛果 / 历史库入库(
/results、/history/)、数据获取(/matches)、监控赔率(/monitor)、传统足彩(/ctzc)、过关试算(/parlay)、λ / dest 分析(/lambda/、/dest/*)。 - 第一期新增:历史交锋(
GET/POST /h2h、POST /h2h/today)、联赛赛程(/schedule及 meta/leagues)、图分析(POST /graph/brief,近况/共同对手/简易泊松摘要)。数据文件jcw_history.db、football_analytics.duckdb部署到sporttery.csh.space/data/。 - 网页明确不做:本机开停监控/提示音、删库管理、注册激活/经验包售卖、500 整站欧亚爬取。
4.3 补录赛果便携工具
- 日常流程:勾选「拉官网后自动补终赔」(默认勾)→ 点「拉取官网」按场拉终赔 → 来源列出现「完赛+终赔」或「人工+终赔」即正确 → 仅官网未出分的场次手补比分 → 点「同步到网站」。
- 终赔说明:未停售时接口末档是盘中价(来源标「+赔」),完赛后再点一次「拉取终赔」才是终止赔率。
- 本地文件:补录记录
data/manual_results_overrides.json,终赔缓存data/jc_fixed_bonus_cache.json,待上传data/results_latest.json。
4.4 代理配置(HTTP 567)
香港服务器访问 webapi.sporttery.cn 常返回 HTTP 567,需大陆 HTTP 代理。
五、近期更新功能(重点)
依据 落地计划-第一期.md(2026-09-23)、补录赛果-使用说明.txt(2026-11-01)、代理配置说明.md 与 网页版扩展功能计划.md(2026-08-22),均为 2026-05 之后:
| 时间 | 更新 | 更新前 → 更新后 / 对操作的影响 |
|---|---|---|
| 2026-09-23 | 网页扩展第一期:交锋/赛程/图分析 | 更新前网页只有赛果/在售/监控/传统足彩等基础 Tab;更新后新增历史交锋(/h2h、一键查今日)、联赛赛程(/schedule,含未进竞彩场次)、图分析(/graph/brief,近况/共同对手/简易泊松摘要)。用户可在网页查两队交锋与赛程,不必开桌面端。 |
| 2026-08-22 | 代理配置方案 | 更新前香港机直连竞彩官网常 567、用户无解;更新后用户可在「API 设置」填公网 HTTP 代理(X-Sporttery-Proxy),站长可配 SPORTTERY_HTTP_PROXY 全站一次搞定。用户遇 567 有明确自助解决路径。 |
| 2026-08-22 | 网页版扩展规划落地 | 明确「桌面抓数/建库 → FTP/脚本同步只读库 → 网页走 API」架构;已上线赛果、在售、监控、传统足彩、过关试算、λ/dest;规划中的球队画像、知识库分析、终盘复盘等按迭代推进。用户获得稳定只读的网页数据服务,重计算与授权仍在 API/桌面端。 |
说明:规划文档中标注「第二期/第三期」「设想/规划」的功能尚未上线,以网站实际可见 Tab 为准。
六、常见问题与排错(FAQ)
- 同步后网页没看到补录比分:网页需
Ctrl+F5强制刷新;不要立刻点「获取赛果」拉官网,以免暂时盖住补录数据(API 已支持合并人工场次)。 - 提示未填写 API Key / 额度用尽:右上角「API 设置」保存 Key;演示 Key 共用额度,用尽需申请个人 Key。
七、补充信息
- 架构原则:桌面端在大陆抓数并 FTP 同步,网页只读同步结果 + 轻量计算,重计算/授权走 API,不把官网密钥与抓取压力放到香港机。
- 数据文件:
jcw_history.db(竞彩网历史)、football_analytics.duckdb(欧洲联赛等)部署在站点data/目录;同步 JSON 含results_latest.json、matches_*.json、monitor_latest.json。 - 相关项目:
体彩足球竞彩(桌面主程序「盘口棱镜」)、WEBSITE(站群 API 与门户)、API总库( sporttery API 服务部署源)。