双色球数据分析 Skill

目的

抓取中国福利彩票双色球历史开奖数据，做频率、冷热号、遗漏、形态（奇偶/大小/三区/和值/连号）统计，输出精确的理论中奖概率，并可选生成频率加权的参考号码。最终交付一份 Markdown 分析报告。

合规底线（必须遵守）

1. 报告开头必须包含声明：每期开奖相互独立，历史数据无预测力，仅供数据研究与娱乐参考，理性购彩。
2. 严禁使用「必中」「稳赚」「精准预测」「提高中奖率」等措辞；参考号码必须标注与机选概率相同。
3. 概率数字使用脚本计算的组合数学精确值，不得编造。
4. 规则细节与概率表见 references/rules.md，用户质疑数字时引用该文件核对。

工作流程

第 1 步：获取数据

运行抓取脚本（工作目录建议放在当前会话工作区，避免写入 skill 目录）：

python <skill_dir>/scripts/fetch_history.py --pages 10 --out <工作目录>/ssq_history.json

• --pages 10 约抓取最近 300 期（约 2 年）。用户要更长历史可加大（最大约 30 页）。
• 脚本自动缓存合并：重复运行会按期号去重追加，保持最新在前。
• 官网接口失败时自动降级中彩网；两者都失败时，若有旧缓存则提示用户使用了缓存数据。

第 2 步：统计分析

python <skill_dir>/scripts/analyze_ssq.py --data <工作目录>/ssq_history.json --recent 50 --recommend 5 --out <工作目录>/ssq_report.md

• --recent：近期窗口期数，默认 50。用户说「最近 30 期」「近 100 期」时对应调整。
• --recommend：参考号码注数；用户只要分析不要号码时设 0。
• 输出报告含：最新开奖、冷热号、当前遗漏、形态统计、频率明细表、理论中奖概率表、参考号码（如启用）。

第 3 步：呈现结果

• 读取生成的 ssq_report.md，在回复中给出摘要：最新一期号码、近 N 期红蓝球热号 TOP、关键理论概率（一等奖约 1/1772 万、任一奖级约 1/15），并用 present_files 把完整报告交付给用户。
• 如用户要求可视化（走势图、频率柱状图），基于 ssq_history.json 用图表工具另行绘制。
• 用户问「能预测下期号码吗」时，明确回答不能，并解释独立随机原理（见 references/rules.md 第 4 节），随后可提供统计描述与参考号码作为娱乐。

常见问题

• 网络受限/抓取失败：检查是否首次运行无缓存；可缩小 --pages 重试；仍失败则如实告知并改用用户提供的本地数据文件（接受同结构 JSON 或让用户贴近期开奖，由助手整理成 JSON 后走第 2 步）。
• 用户想分析大乐透等其他彩种：本 skill 仅覆盖双色球；说明差异并拒绝套用本脚本（大乐透为 5+2、号码范围不同，概率表完全不同）。