快乐8选五候选与命中分布回测

适用场景

这是快乐8选五预测分析套餐中的独立技能 kl8-select5-candidate-review，只做买家自有或公开授权数据的离线统计，不访问账号、不下注、不代购。

解决的问题

从80号历史特征中生成有限五号码集合，可选四区目标，并将候选与实际20号集合按交集大小复盘。

输入与输出

• - 输入：PASS的选五特征JSON、candidatecount、可选zonetarget和至少三期已结束20号holdout。
• 输出：READY/HOLD、五号码候选、四区、频率评分、最高命中分布、随机基线提示和review_hash。

安装与执行

仅需 Python 3.10+ 标准库。将脱敏 JSON 保存到本地后运行 python scripts/run.py 输入.json，从标准输出保存 JSON。

执行步骤

检查特征状态和留出数据；从频率/遗漏排序池中组合5号；按可选四区约束过滤；统计每期候选最高命中个数；样本不足返回HOLD。

错误恢复

缺少字段、期号重复、号码数量错误、范围越界、上游状态不正确或样本不足时返回 REVIEW/HOLD 与具体错误，不会补造数据。修正输入后重新运行。

权限与隐私边界

脚本只读取买家显式传入的本地 JSON，不保存账号、Cookie、Token或个人资料，不调用远程接口，不执行购买、下注、提醒或其他外部动作。

验收

用 examples/input.json 运行，检查状态、80号字段、5号候选和 hash；同一输入重复运行时排序与 hash 应保持一致。结果只能作为概率/候选分析或历史描述，不代表必中或收益。