双色球选号器
概述
从福彩官方接口获取最近 188 期真实开奖数据，用「六因子加权评分 → 七项结构约束 → 加权抽样」三步生成号码，并自动校验数据时效性。核心逻辑与网页版完全同源，两端覆盖率数据一致。
快速开始
SKILL=~/.workbuddy/skills/ssq-lottery-picker
python3 "$SKILL/scripts/ssq.py" status # 数据时效 + 冷热/遗漏概览
python3 "$SKILL/scripts/ssq.py" pick -n 5 # 生成 5 注（均衡型 / 标准约束）
status 与 pick 都会自动检查数据是否落后，落后则先联网刷新；联网失败时回退本地缓存或内置快照，不会报错中断。
使用流程
- 先确认数据时效。执行
status，把「样本区间 / 最新一期 / 时效性 / 下一期」四项告知用户。若显示落后 N 期且刷新失败，必须明确提示用户样本不是最新。 - 解析需求，映射参数。按下方映射表确定策略与档位，用户没说明就用默认值。
- 执行
pick，把脚本输出原样保留，不要自行改写号码、不要"优化"。 - 用表格呈现结果，末尾附数据口径与理性提示。
策略映射
| 用户表述 | 参数 |
|---|---|
| 均衡、正常、随便、帮我选 | -s balanced（默认） |
| 热号、追热、近期活跃、走势强 | -s hot |
| 冷号、遗漏、回补、久未出现、该出了 | -s cold |
| 未明确说明 | -s balanced |
约束档位映射
| 用户表述 | 参数 | 历史形态覆盖率 |
|---|---|---|
| 宽松、不用太讲究 | -p loose |
77.5% |
| 未明确说明 | -p std（默认） |
35.8% |
| 严格、只要最标准的形态 | -p strict |
19.3% |
注数
默认 5 注。用户指定数字则用 -n，支持 1—20。单张彩票最多打 5 注，超过 5 注时提醒用户需分票或倍投。
输出格式
用 Markdown 表格呈现，保留脚本给出的全部结构指标：
| # | 红球 | 蓝球 | 和值 | 跨度 | 奇偶 | 三区 | AC |
|---|---|---|---|---|---|---|---|
| 1 | 04 15 16 18 25 30 | 01 | 108 | 26 | 2:4 | 1-3-2 | 8 |
表格之后附一行数据口径：
> 样本 188 期（2025082—2026118）· 数据已是最新 · 下一期 2026119（2026-10-18 周日）
最后必须附理性提示，措辞可变化但含义不可省略：
> 每注中奖概率恒为 1/17,721,088，本模型只调整号码形态，不提高中奖概率。
数据时效机制
- 缓存位置
~/.workbuddy/cache/ssq-188.json，TTL 6 小时。 - 除 TTL 外还做日历校验：按每周二/四/日 21:15 开奖推算，若截止日之后应已开奖却未纳入，则强制重新抓取。因此 TTL 内跨过开奖日也会自动更新。
- 回退顺序：新鲜缓存 → 官方接口 → 过期缓存 → 内置快照
assets/snapshot-188.json。 - 官方接口不返回 CORS 头，浏览器端无法直连，本技能走 Python 服务端抓取，不受此限制。
生成可交互网页
python3 "$SKILL/scripts/ssq.py" html -o ~/Desktop/双色球选号器.html
产出单文件离线网页（约 61 KB，数据内嵌、无外部依赖），含策略/档位/注数切换、频次与遗漏图表、数据同步入口、奖级表。生成后用 present_files 呈现给用户。
其他参数
| 参数 | 用途 |
|---|---|
--plain |
只输出号码行，便于用户复制粘贴 |
--json |
结构化输出，含结构指标与模型分 |
--pool |
附红球 TOP12 / 蓝球 TOP5 参考池 |
--seed N |
固定随机种子，可复现同一批号码 |
--refresh |
强制跳过缓存重新抓取 |
边界
- 不得声称能提高中奖率、算出"必出号"或"内部号"。
- 不得用历史规律暗示可预测下一期；双色球每期独立同分布。
- 用户要求"预测""包中"时，明确说明彩票随机性，再提供号码作为娱乐参考。
- 涉及未成年人购彩时提示：未满 18 周岁不得购买彩票。
- 遇到用户追问选号逻辑，引用
references/logic.md中的公式与统计依据回答，不要凭空编造。
资源
scripts/ssq.py—— 全部功能入口（status / pick / html / update），仅依赖 Python 标准库。references/logic.md—— 评分公式、约束定义、188 期统计依据、数据结构与已知坑。assets/template.html—— 网页模板，含__DATA_JSON__占位符。assets/snapshot-188.json—— 离线兜底快照，断网时保证可用。
