# 双色球数据实验室 · SSQ Data Lab
[](https://wanghao137.github.io/ssq-data-lab/)
[](https://ssq-data-lab.pages.dev/)
[](./LICENSE)
[](./tests)
[](./index.html)
[English](./README.en.md) · **中文**
一个**诚实**的双色球历史数据分析站点：用 3400+ 期真实开奖数据做可视化、分布分析、卡方检验与娱乐性号码推荐。**不预测、不承诺中奖、不引导购彩**。
> 彩票是独立同分布的随机事件。历史频率无法预测未来——这个项目就是要用数据本身证明这一点。
## Live Demo
- **GitHub Pages**（海外友好）：
- **Cloudflare Pages**（国内友好镜像）：
## 截图
> 暗色主题（默认）+ 亮色主题，编辑级排版 · 玻璃态顶栏 · 系统化色板。
> 顶栏右上角的月亮/太阳按钮可一键切换主题，URL hash 同步当前 Tab。
## 特性
### 数据与可视化
- **走势图**：近 30/50/100 期红蓝点阵，球体加高光、当期 6 球低饱和连线
- **冷热 / 遗漏分析**：频次柱状图 + 距上次出现的期数
- **分布分析**：奇偶比、大小比、质合比、012 路、三区比、AC 值、和值、跨度
- **卡方拟合优度检验**：实时 p 值，验证「均匀分布」假设（差异化功能）
### 工具
- **加权随机生成器**：热 / 冷 / 混合 / 均匀策略 × 和值 / 奇偶 / 跨度 / 分区 / AC / 连号约束
- **胆码 / 排除**：胆码必含、排除红蓝球、避开上一期红球
- **低撞号 + 分散覆盖**：多注之间降低撞号风险（不提高单注命中率）
- **胆拖 / 复式注数试算**：实时 C(n, k) 与金额
- **号码体检**：任意一注红蓝号码，输出 10 项分布指标 + 历史完全重合查询
### 数据
- **开奖记录**：搜索（期号 / 日期 / 红球组合 / 蓝 NN）+ CSV 导出
- **数据源**：500.com 历史接口，每周一/三/五 GitHub Actions 自动拉取最近 30 期合并
### 设计与交互
- **双主题**：暗色 / 亮色一键切换，本地持久化
- **响应式**：从 360px 手机到 4K 显示器自适应
- **键盘可访问**：Tab / 方向键导航，跳到主要内容链接，ARIA tabpanel
- **零构建零依赖**：纯 ES Modules + SVG，加载即用
- **离线兜底**：双击 `index.html` 也能跑（通过 `data/draws.js` 内置兜底数据）
- **打印样式**：可直接打印任意分析页
**技术栈**：原生 ES Modules + SVG，零构建；Python stdlib 抓取；Node.js / unittest 测试。**无任何 runtime 依赖**。
## 快速开始
```bash
# 克隆
git clone https://github.com/wanghao137/ssq-data-lab
cd ssq-data-lab
# 起服务器
npm run serve
# → http://localhost:5173/
# 跑测试
npm test # 前端单测（65 个）
npm run test:py # 抓取脚本（15 个）
# 抓最新数据
npm run update-data
```
> 要求：Node.js ≥ 18、Python ≥ 3.10。
## 设计语言
**编辑级排版**：标题 serif、正文 sans-serif、数字 JetBrains Mono / 系统等宽字体回退，所有数字 `tabular-nums` 对齐。
**Token 化色板**：`--bg-*` / `--surface-*` / `--stroke-*` / `--muted-*` 三层；`--red` / `--blue` / `--acid` / `--gold` / `--plum` 五种语义色；通过 `[data-theme="light|dark"]` 切换整套 Token。
**玻璃拟态顶栏**：`backdrop-filter: blur + saturate`，配合三层径向极光背景与可见网格。
**球体**：radial-gradient 高光 + inset shadow，逼近实物质感；红/蓝两色与单一蓝球前的「+」分隔均由 CSS 完成。
## 目录结构
```
ssq-data-lab/
├── index.html 单页入口，8 个 Tab
├── assets/
│ ├── styles.css Token 化设计系统（dark + light 双主题）
│ └── js/
│ ├── main.js 生命周期 + 事件
│ ├── data.js fetch + window.__SSQ_DATA__ 兜底
│ ├── stats.js 频次 / 遗漏 / TopN
│ ├── distribution.js 分布分析（奇偶/大小/012路/AC 值...）
│ ├── chi-square.js 卡方检验 + 不完全伽马 p 值
│ ├── combinatorics.js 胆拖 / 复式 / C(n,k)
│ ├── trend.js 走势矩阵
│ ├── trend-chart.js 走势点阵 SVG
│ ├── chart.js 频次柱状图 SVG
│ ├── generator.js 加权采样
│ ├── ui.js DOM 渲染 / 主题 / Toast
│ └── utils.js $ / pad2 / clamp / ...
├── data/
│ ├── draws.json 3450+ 期主数据
│ └── draws.js window.__SSQ_DATA__ 等价副本（file:// 兜底）
├── tools/
│ ├── parse_ssq.py txt / xlsx → draws.json
│ ├── update_ssq.py 500.com 抓取 + 合并
│ └── fixtures/ 离线测试 HTML
├── tests/
│ ├── stats.test.mjs
│ ├── generator.test.mjs
│ ├── distribution.test.mjs
│ ├── chi-square.test.mjs
│ ├── combinatorics.test.mjs
│ ├── utils.test.mjs
│ └── test_update_ssq.py
├── docs/
│ └── DEPLOYMENT.md
└── .github/
├── workflows/
│ ├── update-data.yml 数据自动更新
│ └── pages.yml GitHub Pages 部署
├── ISSUE_TEMPLATE/
└── PULL_REQUEST_TEMPLATE.md
```
## 开发
```bash
# 前端测试
npm test
# 抓取脚本测试
npm run test:py
# 手动抓一次
python tools/update_ssq.py --count 30
# 离线跑（不发网络请求）
python tools/update_ssq.py --fixture tools/fixtures/500_history.html
# 重新解析历史 txt/xlsx
python tools/parse_ssq.py 历史.txt data/draws.json
```
## 部署
见 [docs/DEPLOYMENT.md](./docs/DEPLOYMENT.md)。推荐 **GitHub Pages + Cloudflare Pages 双通道**（覆盖海外 + 国内）。
## 这个项目和别的「彩票分析工具」哪里不一样
GitHub 上的「双色球分析」基本只有两类：
1. **走势图玩具** — 抄 500.com 的版式，没有任何统计严谨度
2. **「AI 预测」项目** — LSTM 预测下一期，把统计上不可能的东西包装成聪明
本项目都不是。它**用真正的统计学说明没有什么可预测的** —— 卡方面板实时计算 p 值，告诉你能否拒绝「均匀分布」的原假设。3400 期数据上的答案是：**蓝球与均匀随机不可区分；红球存在与硬件噪声一致的边缘偏差；两者都不构成可预测性。**
这就是这个项目想说的。生成器明确地被定义为「为了好玩的加权骰子」—— 它不会改变中奖概率。
## 贡献
欢迎 PR。先读 [CONTRIBUTING.md](./CONTRIBUTING.md)。
**有些东西永远不会被合入**：
- "AI/LSTM/神经网络预测下一期" —— 这是伪命题，项目底线
- 任何引导未成年人购彩的功能
- 封闭式爬虫（数据源必须可替换）
## 免责声明
- 彩票为随机事件，历史统计**无法**预测未来
- 本工具仅输出「加权随机」建议，**不提高**中奖概率
- 理性消费、量力而行；**未成年人禁止参与**
- 本项目不从购彩行为中获取任何直接或间接收益
## License
[MIT](./LICENSE)