---
description: 在history页面新增特码冷热查询功能 — 选定某一期，向前推算y期，判定该期特码属于冷号还是热号
status: complete
date: 2026-04-24
---

# Quick Task Summary: 特码冷热查询

## What was built

新增「特码冷热查询」功能，允许用户选择任意历史期号，设定向前追溯期数（10-100期），系统自动判定该期特码在追溯范围内属于冷号、温号还是热号。

## Changes made

### Backend — Model (`application/admin/model/History.php`)
- 新增 `getSpecialHotColdByExpect($expect, $lookback)` 方法
- 逻辑：根据指定期号找到该期特码，向前取 lookback 期数据，统计49个号码各自的出现次数
- 判定标准：出现次数 > 平均值×1.5 → 热号；< 平均值×0.5 → 冷号；其余为温号
- 返回包含：特码值、出现次数、平均值、冷热状态、频率排名、热号Top5、冷号Top5

### Backend — Controller (`application/admin/controller/History.php`)
- 新增 `specialHotColdAction()` 接口方法
- 接收 `expect`（期号，必填）和 `lookback`（向前期数，默认30，范围10-100）
- 已加入 `noNeedRight` 白名单

### Frontend — View (`application/admin/view/history/index.html`)
- 在 toolbar 新增「特码冷热」按钮（红色主题，fa-fire 图标）

### Frontend — JS (`public/assets/js/backend/history.js`)
- 新增 `showSpecialHotColdDialog()` — 弹窗包含：期号下拉选择（加载最近50期）、向前期数输入框、查询按钮
- 新增 `querySpecialHotCold()` — AJAX 请求后端
- 新增 `renderSpecialHotCold()` — 卡片式渲染结果：大号球显示特码、冷热状态标签、统计数据、热号/冷号Top5球

## Commit
`2513bbb`