一句话简介:这是“高频红球统计”桌面工具对应的纯静态网页版(站点 https://gaopin.csh.space),通过浏览器调用 api.csh.space 的高频红球 API,提供双色球/大乐透红球频次、历史对比、高频分布、号码推荐、连号统计与回测,面向希望在任意设备用浏览器查看高频红球统计的使用者。
一、这是什么 / 适用场景
- 网页化统计:把桌面版高频红球统计能力搬到浏览器,覆盖双色球/大乐透红球 TOP20 频次、历史开奖与滚动高频对比、高频个数分布、号码/连号推荐、连号统计与回测。
- 零安装使用:纯静态站,用户无需装 Python 或客户端,浏览器打开即用。
- API 驱动:所有计算在后端
api.csh.space完成,前端只负责展示与交互,需X-API-Key鉴权。 - 适用人群:已习惯桌面版高频统计、希望随时随地用浏览器查询与分享的用户。
二、环境准备与安装启动
2.1 本地预览(开发/验证用)
- Python 3(仅用于起一个静态文件服务器,站点本身不需要 Python 运行时)。
- 浏览器(Chrome/Edge 等现代浏览器)。
python -m http.server 5501
2.2 正式部署(宝塔)
架构(选自宝塔部署说明):
浏览器 https://gaopin.csh.space
│ 静态页面(HTML/CSS/JS)
▼
宝塔 Apache 站点目录 /www/wwwroot/gaopin.csh.space
│ fetch + X-API-Key
▼
https://api.csh.space/api/v1/tools/gaopin/*
- 纯静态站,网页服务器不需要安装 Python。
- DNS:
gaopin的 A 记录指向服务器公网 IP(与 api.csh.space 相同,如43.154.109.213)。
三、快速上手(第一次怎么用)
- 首次进入若提示设置 API Key:在设置处填写自己的 Key(演示 Key 已内置,可用;无限量 Key 见“捐助”页或加 QQ 群 253799100 申请)。Key 保存在浏览器
localStorage(键gaopin_web_api_key)。 - 在频次统计页选择彩种(双色球/大乐透),查看红球 TOP20 频次。
- 切到历史对比 / 高频分布页查看滚动高频与个数分布。
- 使用号码推荐 / 连号推荐页生成推荐,连号统计页查看与回测。
- 需要最新数据时点“刷新数据”(对应
POST /refresh)。
四、核心功能详解
4.1 功能页面与接口对应(宝塔部署说明)
| 页面 | 接口 |
|---|---|
| 频次统计 | POST /api/v1/tools/gaopin/frequency |
| 历史对比 | POST /api/v1/tools/gaopin/draw-compare |
| 高频分布 | POST /api/v1/tools/gaopin/hf-distribution |
| 号码推荐 | POST /api/v1/tools/gaopin/recommend |
| 连号统计 | POST /api/v1/tools/gaopin/consecutive |
| 连号推荐 | POST /api/v1/tools/gaopin/recommend/consecutive |
| 连号回测 | POST /api/v1/tools/gaopin/backtest/consecutive |
| 刷新数据 | POST /api/v1/tools/gaopin/refresh |
4.2 API Key 与鉴权(依据 assets/js/api.js)
- 每次请求带请求头
X-API-Key;未填 Key 时前端直接提示“请先在设置中填写 API Key”。 - Key 读取优先级:
localStorage中的值 >config.js的defaultApiKey。可在设置中setApiKey覆盖。 - 还有
/api/v1/auth/me、/health、/meta用于身份、探活与元信息。 - 遇到 HTTP 429(限额)时,前端提示加 QQ 群 253799100 申请个人 Key,或到“捐助”页扫码开通无限量 Key。
4.3 指南与分享
guides/目录含top20-howto.html、backtest-note.html等使用指南页面;donate.html为捐助页;assets/js/share.js、qrcode.min.js提供分享与二维码。llms.txt、robots.txt、sitemap.xml、assets/og.png用于 SEO 与社交分享。
五、近期更新功能(重点)
项目文档(README、宝塔部署说明)时间为 2026-08-21,索引记录项目最近更新为 2026-10-19,未见专项更新日志。以下依据文档与目录结构整理,推断处标注。
- 网页版上线,覆盖桌面版高频统计能力
- 依据:README“覆盖桌面版能力”列出频次/TOP20、历史对比、高频分布、号码推荐、连号统计与回测。
- 对用户操作的影响:从“只能在桌面看”变为“浏览器打开
gaopin.csh.space即可用”,多设备一致体验。(依据文档)
- 一键部署脚本
deploy_gaopin_web.py
- 依据:README 与宝塔部署说明,脚本中定义
DOMAIN = "gaopin.csh.space"、REMOTE_ROOT = "/www/wwwroot/gaopin.csh.space"。
- API Key 自助管理与限额引导
- 依据:
api.js中的getApiKey/setApiKey、429 限额提示与“捐助”页引导。
- 项目整体更新(依据索引时间戳推断)
- 依据:索引 latest=2026-10-19,晚于文档日期 2026-08-21。
- 对用户操作的影响:线上版本为 10 月后状态;本地若有旧副本建议以
deploy_gaopin_web.py重新部署。(依据索引时间戳推断)
六、常见问题与排错(FAQ)
Q1:打开页面提示“请先在设置中填写 API Key”?
在页面设置里填入有效 X-API-Key;演示环境可用 config.js 内置 Key,正式使用建议申请个人 Key。Key 存于浏览器 localStorage,清除浏览器数据后需重填。
Q2:提示 HTTP 429(调用超限)怎么办?
按前端提示加 QQ 群 253799100 申请个人 Key,或打开“捐助”页扫码开通无限量 Key。
Q3:本地预览显示示例/无数据?
确认 config.js 的 apiBase 指向 https://api.csh.space 且网络可达;本地 python -m http.server 5501 只提供静态文件,数据来自远程 API,需联网。
Q4:部署后打不开 / 跳不过 HTTPS?
确认 DNS 的 gaopin A 记录已指向服务器公网 IP;SSL 未签发时确认 DNS 生效后重新运行 python deploy_gaopin_web.py,或在宝塔面板手动申请证书并开启强制 HTTPS。
七、补充信息
- API 前缀:
https://api.csh.space/api/v1/tools/gaopin/;后端源码见“API总库”项目中的deploy_gaopin_api.py与对应路由。 - 文件结构:
index.html主页面;assets/css/(app.css、guides.css)、assets/js/(config.js、api.js、app.js、share.js、qrcode.min.js);guides/指南页;deploy_gaopin_web.py部署脚本。 - 关联项目:与“双色球大乐透开奖数据查询系统网页版”“子午流注网页版”同为 csh.space 站群的静态网页工具,均依赖 api.csh.space 与宝塔部署体系。