back
loading skill details...
中国体育彩票全玩法号码分析、条件筛选、走势图、历史数据查询与数据参考综合工具。 覆盖超级大乐透、排列3、排列5、七星彩、竞彩足球、竞彩篮球、传统足彩全部玩法。 Triggers: "大乐透走势图", "排列三图表", "七星彩数据", "竞彩分析", "体彩号码统计", "历史开奖查询", "杀号定胆", "大乐透和值跨度", "足彩过滤", "后区分析", "冷热号走势", "复式胆拖计算", "大乐透号码", "排列3数据", "体彩遗漏分析", "号码核验", "走势图分析", "复式投注计算", "概率数据", "位置分析", "大小形态", "奇偶形态"
---
name: 体彩筛选
description: |
中国体育彩票全玩法号码分析、条件筛选、走势图、历史数据查询与数据参考综合工具。
覆盖超级大乐透、排列3、排列5、七星彩、竞彩足球、竞彩篮球、传统足彩全部玩法。
Triggers: "大乐透走势图", "排列三图表", "七星彩数据", "竞彩分析", "体彩号码统计", "历史开奖查询", "杀号定胆", "大乐透和值跨度", "足彩过滤", "后区分析", "冷热号走势", "复式胆拖计算", "大乐透号码", "排列3数据", "体彩遗漏分析", "号码核验", "走势图分析", "复式投注计算", "概率数据", "位置分析", "大小形态", "奇偶形态"
version: 1.1.0
category: 数据分析
platforms:
- Claude Code
- Cursor
- Codex
- Gemini CLI
author: gavin1024
license: MIT
metadata:
tags: 体彩, 彩票, 大乐透, 排列三, 排列五, 七星彩, 竞彩足球, 竞彩篮球, 传统足彩, 胜负彩, 筛选, 历史数据, 走势图, 胆拖, 复式, 杀号, 定胆, 冷热分析
---
# 体彩筛选 Skill
体育彩票号码分析与数据参考工具。覆盖乐透数字型、竞猜型全部玩法，提供号码查询、条件筛选、走势图分析、历史数据统计全链路功能。
> ⚠️ **合规声明**：本工具仅供数据分析与学习研究使用，**不提供任何投注建议，不承诺中奖概率，不用于实际博彩行为**。所有输出内容均基于统计学原理，彩票开奖结果具有完全随机性，任何分析方法均无法预测开奖结果。请遵守《彩票管理条例》及相关法律法规，理性对待。
---
## 一、项目简介
### 技能定位
面向体育彩票爱好者和分析型用户，提供号码生成、多条件过滤、走势图可视化、历史数据统计等功能。用户通过自然语言描述需求，AI 自动解析并执行对应分析逻辑。
### 版本
| 版本 | 日期 | 说明 |
|------|------|------|
| 1.0.0 | 2026-07 | 初始版本，覆盖全部体彩玩法 |
| 1.1.0 | 2026-07 | 新增8个Python工具：遗漏分析/号码核验/复式全组合/杀号/定胆/概率/合并/报告 |
### 支持平台
| 平台 | 安装方式 | 说明 |
|------|---------|------|
| Claude Code | `skill` 工具加载 | 原生支持 |
| Cursor | skill 目录识别 | 兼容 |
| Codex | skill 目录识别 | 兼容 |
| Gemini CLI | `activate_skill` 工具 | 兼容 |
| 其他 OpenClaw 兼容客户端 | skillhub CLI 安装 | 通过注册中心分发 |
---
## 二、覆盖玩法
### 玩法规则对比总表
| 彩种 | 类型 | 号码范围 | 选号规则 | 总注数 | 开奖频率 | 头奖概率 |
|------|------|---------|---------|--------|---------|---------|
| 超级大乐透 | 乐透型 | 前区01-35, 后区01-12 | 前5+后2 | 2142万 | 一/三/六 | 1/2142万 |
| 排列3 | 数字型 | 每位0-9 | 3位 | 1000 | 每日 | 1/1000 |
| 排列5 | 数字型 | 每位0-9 | 5位 | 10万 | 每日 | 1/10万 |
| 七星彩 | 数字型 | 每位0-9 | 7位 | 1000万 | 二/五/日 | 1/1000万 |
| 竞彩足球 | 竞猜型 | — | 猜赛果 | — | 每日 | 视玩法 |
| 竞彩篮球 | 竞猜型 | — | 猜赛果 | — | 每日 | 视玩法 |
| 传统足彩 | 竞猜型 | — | 猜14场/9场/半全场/进球 | — | 周中/周末 | — |
| 顶呱刮 | 即开型 | — | 即开即兑 | — | — | 视票种 |
### 超级大乐透投注方式
| 方式 | 说明 | 中奖条件示例 |
|------|------|-------------|
| 单式 | 前5+后2 基本投注 | 5+2 → 一等奖 |
| 前区复式 | 前区≥6码, 后区2码 | 组合注数=C(前区选号,5) |
| 后区复式 | 前区5码, 后区≥3码 | 组合注数=C(后区选号,2) |
| 双区复式 | 前区≥6码+后区≥3码 | 组合注数=C(前,5)×C(后,2) |
| 前区胆拖 | 前区1-4胆+拖, 后区2码 | 组合注数=C(拖码,5-胆码数) |
| 后区胆拖 | 前区5码, 后区1胆+拖 | 组合注数=C(拖码,2-1) |
| 双区胆拖 | 前后区均胆拖 | 前区组合×后区组合 |
| 追加投注 | +1元, 浮动奖+80% | — |
| 多倍投注 | 2-99倍 | — |
### 排列3投注方式
| 方式 | 说明 |
|------|------|
| 直选单式 | 3位数字唯一排列作为一注 |
| 直选定位复式 | 每位选≥2个数字的多注直选 |
| 组选单式(组选3) | 2同+1异, 所有排列为1注 |
| 组选单式(组选6) | 3位各不相同, 所有排列为1注 |
| 组选3跨度 | 对指定跨度的所有组选3号码投注 |
| 直组混合单式 | 直选+组选混合投注 |
| 包点(和值) | 指定和值的所有号码 |
### 排列5投注方式
| 方式 | 说明 |
|------|------|
| 直选单式 | 5位数字唯一排列 |
| 直选定位复式 | 每位选≥2个数字 |
| 直选组合复式(五不同) | 5个数字各不相同 |
| 直选组合复式(二同) | 2个相同, 如11234 |
| 直选组合复式(三同) | 3个相同, 如11123 |
| 直选组合复式(两组二同) | 两组2个相同, 如11223 |
| 直选组合复式(四同) | 4个相同, 如11112 |
| 直选组合复式(三同二同) | 3+2, 如11122 |
### 七星彩投注方式
| 方式 | 说明 |
|------|------|
| 单式 | 7位数字唯一排列 |
| 定位复式 | 至少1位选≥2个数字 |
| 前区组合复式 | 第1-6位组合+第7位单独选号 |
### 竞彩足球玩法
| 玩法 | 代码 | 选项数 | 说明 |
|------|------|--------|------|
| 胜平负 | SPF | 3 | 主胜/平/客胜 |
| 让球胜平负 | RQSPF | 3 | 含让球调整 |
| 比分 | BF | 32 | 猜具体比分 |
| 总进球 | ZJQ | 8 | 0-7+球 |
| 半全场 | BQC | 9 | 上半场×全场组合 |
### 竞彩篮球玩法
| 玩法 | 代码 | 选项数 | 说明 |
|------|------|--------|------|
| 胜负 | SF | 2 | 主胜/客胜 |
| 让分胜负 | RFSF | 2 | 含让分调整 |
| 大小分 | DFS | 2 | 大/小于预设总分 |
| 胜分差 | SFC | 12 | 主/客胜分差区间 |
### 传统足彩玩法
| 玩法 | 场次 | 结果数 | 奖级 |
|------|------|--------|------|
| 胜负彩(14场) | 14场 | 3^14 | 一/二等奖 |
| 任选9场 | 任选9/14场 | 3^9 | 一个奖级 |
| 6场半全场 | 6场(12结果) | 9^6 | 一个奖级 |
| 4场进球彩 | 4场(8结果) | 4^8 | 一个奖级 |
---
## 三、功能模块
### 3.1 历史数据查询
用户通过自然语言查询开奖数据，支持多种查询维度。
**查询方式**：
| 方式 | 说明 | 示例 |
|------|------|------|
| 按彩种查询 | 指定彩种的历史记录 | "查大乐透最近20期" |
| 按期号查询 | 指定期号结果 | "查大乐透第25001期" |
| 按日期查询 | 指定日期结果 | "查2026年6月开奖" |
| 多期对比 | 多期数据对比 | "对比近10期号码" |
| 历史同期 | 历年同期对比 | "历年同期开奖数据" |
**输出指标**：期号、开奖号码、和值、跨度、奇偶比、大小比、012路、奖池金额、中奖注数。
### 3.2 数据分析
对历史数据进行多维度统计分析，输出结构化报告。提供 `lottery_filter.py csv`（频率统计）和 `lottery_missing.py`（遗漏深度分析）两个命令行工具。
**分析维度**：
| 维度 | 说明 | 工具 |
|------|------|------|
| 号码频率 | 各号码出现次数排名 | `lottery_filter.py csv` |
| 遗漏分析 | 当前遗漏/最大遗漏/平均遗漏 | `lottery_missing.py` |
| 冷热分布 | 热号(≤5期)/温号(6-15期)/冷号(≥16期) | `lottery_missing.py` |
| 回补信号 | 遗漏超均值+标准差 → 关注反弹 | `lottery_missing.py` |
| 遗漏分布 | 冷/温/热各区数量+比例 | `lottery_missing.py` |
| 和值走势 | 均值/标准差/极值/区间分布 | — |
| 跨度走势 | 大/中/小跨度占比 | — |
### 3.3 条件筛选
支持对全部数字彩进行多条件组合过滤。用户以自然语言输入条件，AI 自动解析验证并生成满足条件的号码。提供 `lottery_kill.py` 进行多策略杀号缩减号码池。
**筛选条件速查**：
| 条件 | 适用彩种 | 说明 |
|------|---------|------|
| 奇偶比 | 全部数字彩 | 奇偶号码数量比 |
| 大小比 | 全部数字彩 | 大小号数量比 |
| 质合比 | 大乐透/排列3/5/七星彩 | 质数合数比 |
| 和值范围 | 全部数字彩 | 号码总和区间 |
| 跨度范围 | 全部数字彩 | 最大-最小值区间 |
| 连号 | 全部数字彩 | 相邻连续号码组数 |
| 重号 | 全部数字彩 | 与上期重复个数 |
| 冷热号 | 全部数字彩 | 冷/热号出现个数 |
| AC值 | 大乐透 | 复杂度指标范围 |
| 012路 | 全部数字彩 | 除3余数分布 |
| 定位 | 排列3/5/七星彩 | 每位号码范围 |
| 振幅 | 排列3/5/七星彩 | 同位置差值 |
| 区位分布 | 大乐透 | 一/二/三区出号数 |
| 尾数 | 大乐透/排列5 | 个位数分布 |
| 赔率 | 竞彩 | 赔率范围过滤 |
| 凯利指数 | 竞彩 | 投注价值过滤 |
**执行流程**：
```
用户输入条件 → 解析条件类型与适用彩种 → 验证条件自洽性
→ 生成号码池 → 逐条件过滤 → 统计满足注数 → 输出 TOP 参考
```
### 3.4 号码参考
根据用户偏好或默认设置，生成符合条件的号码组合。提供 `lottery_dan.py`（多策略定胆）和 `lottery_bet_gen.py`（复式全组合生成）两个辅助工具。
**参考逻辑**：
1. 彩种识别与条件收集
2. 候选号码池生成（随机/加权）
3. 条件过滤引擎逐层过滤
4. 遗漏值/冷热号加权排序
5. 按需输出指定注数
**输出模式**：
| 模式 | 说明 | 输出内容 |
|------|------|---------|
| 单式参考 | 符合条件的单注号码列表 | N注号码+条件说明 |
| 胆拖参考 | 指定胆码+拖码 | 胆码+拖码+组合注数 |
| 复式参考 | 指定号码池的全组合 | 号码池+注数+金额 |
| 杀号过滤 | 从号码池中剔除无效号码 | 原始池→剩余池+缩减率 |
| 综合参考 | 合并多策略胆码 | 热号/冷号/邻号/近期高频+综合 |
**输出格式**：
```
参考一：03 08 15 22 31 + 05 10 参考二：06 11 19 25 33 + 02 07
参考三：01 09 17 28 30 + 04 11
分析：奇偶比 3:2 | 大小比 2:3 | 和值 70-90 | 跨度 20-30
投注建议：单式5注，合计10元
```
### 3.5 号码核验
提供 `lottery_compare.py` 核对自选号码与官方开奖结果是否一致，精确到奖级。
| 彩种 | 核验方式 | 奖级识别 |
|------|---------|---------|
| 大乐透 | 前区5个+后区2个匹配 | 7个奖级(一等~七等) |
| 排列3 | 直选/组选3/组选6自动识别 | 按命中精度输出 |
| 排列5 | 5位精确匹配 | 全对=中奖 |
| 七星彩 | 7位精确匹配 | 全部一致=中奖 |
支持按指定期号核验或遍历全部历史数据。
### 3.6 概率计算
提供 `lottery_probability.py` 计算各彩种各奖级的精确中奖概率。
| 彩种 | 计算内容 |
|------|---------|
| 大乐透 | 7个奖级分别的概率 + 整体中奖率 |
| 排列3 | 直选/组选3/组选6 分别概率 |
| 排列5 | 直选概率 |
| 七星彩 | 一等奖~六等奖分别概率 |
### 3.7 数据管理
| 工具 | 功能 |
|------|------|
| `lottery_merge.py` | 合并多个CSV文件、去重、排序（混合彩种自动识别） |
| `lottery_report.py` | 生成 HTML 综合分析报告（频率/和值/跨度/冷热统计） |
| `validate_csv.py` | 校验 CSV 格式是否符合规范 |
| `generate_data.py` | 生成示例开奖数据（按实际开奖日） |
| `fetch_data.py` | 在线拉取历史数据（三源自动降级到本地生成） |
### 3.8 走势图
以文本/表格形式生成 9 种走势图，支持 10/20/30/50/100 期及历史同期周期。
**走势图类型**：
| # | 类型 | 适用彩种 | 核心内容 |
|---|------|---------|---------|
| 1 | 号码综合走势 | 全部数字彩 | 每期号码+和值+跨度+奇偶+大小+012路 |
| 2 | 和值走势 | 全部数字彩 | 和值变化曲线+区间分布+均值统计 |
| 3 | 跨度走势 | 全部数字彩 | 跨度变化+大/中/小占比 |
| 4 | 定位走势 | 排列3/5/七星彩 | 每位号码分布+振幅 |
| 5 | 冷热走势 | 全部数字彩 | 频率+遗漏+冷热状态+趋势 |
| 6 | 奇偶/大小形态 | 全部数字彩 | 形态比例变化+趋势 |
| 7 | 遗漏走势 | 全部数字彩 | 各号码遗漏值曲线+极值提示 |
| 8 | 区位分布 | 大乐透 | 三区出号分布+断区分析 |
| 9 | 后区走势 | 大乐透 | 后区号码+跨度+奇偶搭配 |
**走势图综合分析报告**：
综合多种走势图，输出结构化的分析结论，包含：和值/跨度趋势判断、冷热号分布与回补提示、区位参考、后区搭配建议、综合号码池参考。
### 3.9 完整工作流示例
以下展示从数据输入到分析到输出的全链路操作：
#### 示例：大乐透下期号码参考
```bash
# Step 1: 查看走势图（近10期综合走势）
python3 scripts/lottery_charts.py examples/dlt_sample.csv --type comprehensive --periods 10
# Step 2: 遗漏分析（冷热号 + 回补信号）
python3 scripts/lottery_missing.py examples/dlt_sample.csv --top 5
# Step 3: 定胆参考（多策略综合）
python3 scripts/lottery_dan.py examples/dlt_sample.csv --count 3
# Step 4: 杀号过滤（尾数 + 区间 + 分区）
python3 scripts/lottery_kill.py --pool 01-35 --kill-tail 0,1 --sections 5
# Step 5: 条件生成（奇偶3:2 + 和值80-110）
python3 scripts/lottery_filter.py generate --oe 3:2 --sum 80-110 --count 5
# Step 6: 概率说明
python3 scripts/lottery_probability.py --lottery 大乐透
# Step 7: 生成报告
python3 scripts/lottery_report.py examples/dlt_sample.csv -o report.html
```
#### 示例：排列3形态分析
```bash
# 定位走势
python3 scripts/lottery_charts.py examples/pl3_sample.csv --lottery 排列3 --type position --pos 0 --pos-name 百位
# 遗漏分析
python3 scripts/lottery_missing.py examples/pl3_sample.csv --lottery 排列3
# 形态生成（奇奇奇）
python3 scripts/lottery_filter.py generate --lottery 排列3 --oe-shape 奇奇奇 --count 5
# 定位复式
python3 scripts/lottery_bet_gen.py --lottery 排列3 --front "0,2,4,6,8/1,3,5,7,9/0,2,4,6,8"
```
#### 示例：历史数据管理
```bash
# 校验 CSV 格式
python3 scripts/validate_csv.py examples/dlt_sample.csv
# 合并多个 CSV
python3 scripts/lottery_merge.py csv1.csv csv2.csv -o merged.csv
# 核对自选号码是否中奖
python3 scripts/lottery_compare.py "05 12 19 26 33 + 03 10" -d examples/dlt_sample.csv
```
### 3.10 走势参考
多维度走势分析方法，按彩种差异化输出。
**分析方法**：
| 方法类 | 具体方法 | 说明 |
|--------|---------|------|
| 概率统计 | 冷热配比 | 热:温:冷按 3:1:1 配比 |
| 概率统计 | 均值回归 | 长期遗漏冷号回补 |
| 概率统计 | 正态分布 | 和值/跨度取均值±标准差 |
| 趋势分析 | 移动平均线 | 5/10/20期均线中枢 |
| 趋势分析 | 布林带 | 上下轨突破信号 |
| 趋势分析 | 振幅分析 | 每位振幅循环规律 |
| 杀号 | 和值/跨度杀号 | 反推排除号码 |
| 杀号 | 边缘号杀号 | 高位>30和低位<05 |
| 杀号 | 公式杀号 | 开奖号码运算结果 |
| 定胆 | 热号定胆 | 高频号码作胆 |
| 定胆 | 重号/邻号定胆 | 上期号码±1 |
| 定胆 | 遗漏定胆 | 长期冷号反弹 |
**彩种参考策略**：
| 彩种 | 核心方法 | 辅助方法 |
|------|---------|---------|
| 大乐透 | 冷热配比+和值跨度区间+区位 | 胆拖参考、杀号过滤 |
| 排列3 | 定位振幅+组选形态+和值跨度 | 百十个位独立分析 |
| 排列5 | 前3位(排列3)+后2位分拆 | 形态参考 |
| 七星彩 | 每位振幅+前区综合 | 后区单独分析 |
| 竞彩足球 | 赔率模型+球队状态+交锋 | 凯利指数修正 |
| 竞彩篮球 | 场均得分模型+让分走势 | 大小分趋势 |
---
## 四、数据流
### 4.1 数据源说明
本工具**不内置实时抓取功能**，依赖用户提供或预先加载的开奖数据。
### 4.2 缓存策略
| 层级 | 说明 | 有效期 |
|------|------|--------|
| 会话缓存 | 用户当前对话中已提供的数据 | 会话结束 |
| 持久化缓存 | 用户可维护的 CSV 文件（见 4.3） | 文件更新 |
**策略说明**：
- 同一会话内重复查询同彩种不重复请求用户提供数据
- 用户可主动刷新数据：`更新大乐透数据到最新XX期`
- 数据格式遵循 4.3 节定义
### 4.3 CSV 格式定义
#### 乐透数字型 CSV
```csv
彩种,期号,开奖日期,号码1,号码2,号码3,号码4,号码5,号码6,号码7,奖池(亿),销量(亿)
大乐透,25001,2026-01-03,05,12,19,26,33,03,10,9.62,2.85
排列3,26158,2026-06-17,1,5,8,,,,
排列5,26158,2026-06-17,1,5,8,3,9,,
七星彩,26001,2026-01-02,3,8,1,5,9,2,6,,
```
**字段说明**：
- `彩种`：大乐透 / 排列3 / 排列5 / 七星彩
- `期号`：5-6 位数字
- `开奖日期`：YYYY-MM-DD
- `号码1~号码5`：前区（大乐透）/ 数字彩依次排列
- `号码6~号码7`：后区（大乐透）/ 第6-7位（七星彩）；数字彩该列为空
- `奖池(亿)` / `销量(亿)`：仅大乐透
#### 竞彩 CSV
```csv
彩种,日期,编号,主队,客队,主胜赔,平赔,客胜赔,让球,让球主胜,让球客胜,比分
竞彩足球,2026-06-17,001,主队A,客队B,1.85,3.40,3.75,0.5,1.60,2.20,2-0
```
**字段说明**：
- `让球`：让球数（负值为客让）
- `让球主胜/客胜`：让球后胜平负赔率
- `比分`：最终赛果
### 4.4 处理流程
```
[用户输入] → [自然语言解析] → [意图识别]
├─ 查询意图 → CSV 数据源 → 统计分析引擎 → 结果格式化 → 输出
├─ 筛选意图 → 条件解析器 → 条件验证 → 号码生成引擎 → 输出
├─ 走势意图 → 走势图引擎 → 图表示例生成 → 统计注释 → 输出
├─ 统计输出意图 → 加权随机发生器 → 条件过滤器 → 排序 → 输出
└─ 走势意图 → 走势图引擎 → 图表示例生成 → 统计注释 → 输出
```
---
## 五、项目结构
```
ticai-shai-xuan/ # 技能根目录
├── SKILL.md # 技能入口文件（即本文档）
├── _meta.json # 技能元数据
├── references/ # （可选）参考资料
│ ├── dlt-rules.md # 大乐透完整规则
│ ├── pl3-rules.md # 排列3完整规则
│ ├── pl5-rules.md # 排列5完整规则
│ ├── qxc-rules.md # 七星彩完整规则
│ ├── jczq-rules.md # 竞彩足球规则
│ ├── jclq-rules.md # 竞彩篮球规则
│ └── terms.md # 术语表扩展
├── scripts/ # （可选）辅助脚本
│ ├── lottery_filter.py # 号码分析/条件生成/复式胆拖/CSV统计
│ ├── lottery_charts.py # 6种ASCII走势图(综合/和值/跨度/定位/冷热/奇偶)
│ ├── lottery_missing.py # 遗漏深度分析(冷热号/回补信号/分布统计)
│ ├── lottery_compare.py # 号码对比核验(精确到奖级)
│ ├── lottery_bet_gen.py # 复式/胆托/定位复式全组合生成器
│ ├── lottery_kill.py # 多策略杀号(尾数/区间/和值尾/分区/历史差值)
│ ├── lottery_dan.py # 多策略定胆(热号/冷号/邻号/近期高频/综合)
│ ├── lottery_probability.py # 中奖概率精确计算(全部4种数字彩)
│ ├── lottery_merge.py # CSV合并/去重/排序(混合彩种自动识别)
│ ├── lottery_report.py # HTML综合分析报告生成器
│ ├── validate_csv.py # CSV 格式校验
│ ├── generate_data.py # 示例数据生成器
│ └── fetch_data.py # 历史数据拉取(三源自动降级)
├── examples/ # （可选）使用示例
│ ├── dlt-sample.csv # 大乐透示例数据
│ ├── pl3-sample.csv # 排列3示例数据
│ └── jczq-sample.csv # 竞彩示例数据
└── assets/ # （可选）资源文件
└── icon.png # 技能图标
```
**目录约定**：
| 目录 | 必需 | 说明 |
|------|------|------|
| `SKILL.md` | 是 | 技能入口，frontmatter + markdown 正文 |
| `_meta.json` | 否 | 元数据（TCR 发布需要） |
| `references/` | 否 | 规则文档拆分，单文件 >5000 tokens 时使用 |
| `scripts/` | 否 | 工具脚本 |
| `examples/` | 否 | 示例数据文件 |
| `assets/` | 否 | 图标等资源 |
---
## 六、CLI 使用
### 6.1 安装 SkillHub CLI
```bash
curl -fsSL https://skillhub.cn/install/install.sh | bash
```
验证安装：
```bash
skillhub -h
```
### 6.2 登录
```bash
skillhub login
```
按提示完成认证（账号密码或浏览器 OAuth）。
### 6.3 初始化技能
```bash
skillhub init --name "体彩筛选" --category "数据分析"
```
此命令创建技能目录及必要的配置文件。
### 6.4 推送文件
```bash
# 在技能目录中
skillhub push
```
将本地文件推送到 SkillHub 平台，不会立即发布。
### 6.5 发布上线
```bash
# 确认可发布后
skillhub publish
```
提交审核，审核通过后自动上架。
### 6.6 版本管理
```bash
# 更新 SKILL.md 中的 version 后重新推送
skillhub push
skillhub publish
# 查看已发布的版本
skillhub versions
```
### 6.7 本地 CLI 脚本速查
#### 号码分析
```bash
# 分析单注号码(奇偶/大小/和值/跨度/AC值/012路)
python3 scripts/lottery_filter.py analyze "05 12 19 26 33 + 03 10"
# 按条件生成参考号码
python3 scripts/lottery_filter.py generate --oe 3:2 --sum 80-100 --count 5
# CSV 频率统计
python3 scripts/lottery_filter.py csv examples/dlt_sample.csv
# 复式/胆拖注数计算
python3 scripts/lottery_filter.py comb --front-num 6 --back-num 3
```
#### 走势图
```bash
# 号码综合走势
python3 scripts/lottery_charts.py examples/dlt_sample.csv --type comprehensive
# 和值走势
python3 scripts/lottery_charts.py examples/dlt_sample.csv --type sum
# 定位走势（排列3）
python3 scripts/lottery_charts.py examples/pl3_sample.csv --lottery 排列3 --type position --pos 0 --pos-name 百位
# 冷热图
python3 scripts/lottery_charts.py examples/dlt_sample.csv --type hotcold
```
#### 遗漏分析
```bash
# 冷热号遗漏 + 回补信号 + 分布统计
python3 scripts/lottery_missing.py examples/dlt_sample.csv --top 10
# 排列3遗漏
python3 scripts/lottery_missing.py examples/pl3_sample.csv --lottery 排列3
```
#### 号码核验
```bash
# 核对自选号码是否中奖
python3 scripts/lottery_compare.py "05 12 19 26 33 + 03 10" -d examples/dlt_sample.csv
# 排列3核验（直选 + 组选3/6自动识别）
python3 scripts/lottery_compare.py "9 5 7" --lottery 排列3 -d examples/pl3_sample.csv
```
#### 复式全组合
```bash
# 大乐透前6+后3复式（仅统计注数）
python3 scripts/lottery_bet_gen.py --front 01,02,03,04,05,06 --back 01,02,03
# 排列3定位复式（百位3个×十位3个×个位3个）
python3 scripts/lottery_bet_gen.py --lottery 排列3 --front "1,2,3/4,5,6/7,8,9"
# 输出全组合到 CSV
python3 scripts/lottery_bet_gen.py --front 01-07 --back 01-03 --output combos.csv
```
#### 杀号
```bash
# 多策略杀号：尾数0和5 + 区间1-5 + 分区杀空区
python3 scripts/lottery_kill.py --pool 01-35 --kill-tail 0,5 --kill-range 1-5 --sections 3
# 排列3杀号
python3 scripts/lottery_kill.py --pool 0-9 --kill-tail 0,9 --lottery 排列3
```
#### 定胆
```bash
# 多策略定胆参考（热号/冷号/邻号/近期高频/综合）
python3 scripts/lottery_dan.py examples/dlt_sample.csv --count 3
```
#### 概率计算
```bash
# 精确中奖概率（全部奖级）
python3 scripts/lottery_probability.py --lottery 大乐透
python3 scripts/lottery_probability.py --lottery 排列3
```
#### 数据合并
```bash
# 合并多个CSV + 去重 + 排序
python3 scripts/lottery_merge.py examples/dlt_sample.csv examples/pl3_sample.csv -o merged.csv
```
#### 生成报告
```bash
# HTML 综合分析报告（频率/和值/跨度/遗漏/热号）
python3 scripts/lottery_report.py examples/dlt_sample.csv -o report.html
```
#### 数据管理
```bash
# CSV 格式校验
python3 scripts/validate_csv.py examples/dlt_sample.csv
# 生成示例数据
python3 scripts/generate_data.py --lottery 七星彩 --count 10 -o qxc_data.csv
# 在线拉取（自动降级到本地生成）
python3 scripts/fetch_data.py -l 大乐透 -n 20
```
### 6.8 本地测试
```bash
# 校验 SKILL.md frontmatter 格式
python3 -c "import yaml; yaml.safe_load(open('SKILL.md')); print('✅ valid')"
```
## 七、发布指引
### 7.1 发布方式一：CLI 发布（推荐）
流程：`skillhub login` → `skillhub init` → 编写 SKILL.md → `skillhub push` → `skillhub publish`
### 7.2 发布方式二：Web 发布
1. 访问 https://skillhub.cn
2. 登录账号
3. 进入技能发布页面
4. 填写技能信息（名称/描述/版本/分类/平台）
5. 上传 SKILL.md 及辅助文件
6. 提交审核
### 7.3 TRACE 审核标准
SkillHub 采用 TRACE 五维评测体系，本技能对应达标措施如下：
| 维度 | 审核要求 | 本技能达标措施 |
|------|---------|--------------|
| **T**rust（可信任度） | 内容真实可靠，不夸大承诺，不含诱导性表述 | ① 多处明示"分析参考、不构成投注建议" ② 强调开奖完全随机，任何方法无法预测 ③ 不承诺中奖率、准确率 ④ 注明数据来源和样本量限制 ⑤ 所有输出附带"理性购彩"提示 |
| **R**eliability（可靠性） | 功能稳定一致，输入输出可预期，异常可处理 | ① 所有脚本有统一的参数接口（argparse） ② 条件输入前自动验证自洽性 ③ CSV 数据有格式校验（validate_csv.py） ④ 异常输入给出明确错误定位与修正建议 ⑤ 不满足条件时提示放宽条件 ⑥ 输出格式固定，AI 可解析 |
| **A**daptability（适用性） | 覆盖多种场景和用户表达方式 | ① 覆盖 8 种体彩彩种、全部数字彩玩法 ② 24+ 触发短语覆盖口语与书面语 ③ 支持 6 种工作模式（查询/分析/筛选/参考/走势/统计） ④ 自然语言输入自动解析为结构化参数 ⑤ 支持单注分析到批量 CSV 统计 ⑥ 竞彩和数字彩分别处理 |
| **C**onvention（规范性） | 文档结构清晰，命名统一，术语一致，可读性好 | ① 10 章标准结构 ② 全篇统一术语（"彩种"非"彩票类型"、"期号"非"期数"） ③ frontmatter YAML 格式正确 ④ 表格/代码块格式一致 ⑤ 附录含完整术语表 ⑥ 文件命名遵循 kebab-case ⑦ 版本遵循 semver |
| **E**ffectiveness（有效性） | 实际使用能解决问题，工作流完整 | ① 从数据输入到分析到报告输出全链路覆盖 ② 13 个 Python 脚本可独立运行也可组合使用 ③ 提供示例数据和完整 CLI 命令 ④ 走势图/遗漏/定胆/杀号/概率五维交叉分析 ⑤ HTML 报告可直接浏览 ⑥ 离线可用，无需依赖外部 API
### 7.4 安全审核流程
提交后触发三线并行安全审核：
1. **内容合规过滤**：关键声明包含"分析参考""不做投注建议""未成年人不得购彩"
2. **科恩实验室深度漏洞扫描**：代码/脚本安全检测
3. **云鼎实验室 AI 模型安全评估**：AI 行为合规性
---
## 八、技术细节
### 8.1 数据源降级策略
| 场景 | 行为 |
|------|------|
| 用户未提供数据 | 输出通用分析模板，引导用户提供数据 |
| 用户提供部分期数 | 基于已有数据分析，标注数据范围 |
| CSV 格式异常 | 提示格式问题，给出修正示例 |
| 数据不满足筛选条件 | 提示放宽条件，给出当前数据分布参考 |
### 8.2 依赖
| 依赖 | 版本 | 用途 |
|------|------|------|
| Python 3.8+ | 可选 | CSV 校验脚本 |
| `skillhub` CLI | latest | 技能发布 |
| `clawhub` CLI | latest | 替代发布方式（TCR） |
### 8.3 字体与编码
- 文件编码：UTF-8（不含 BOM）
- 换行符：LF（Unix 风格）
- CSV 分隔符：逗号 `,`
- 示例数据中文字段如需对齐：使用 UTF-8 全角空格或制表符
### 8.4 号码计算规则
**组合注数公式**：
| 类型 | 公式 |
|------|------|
| 前区复式 | C(n, 5)，n 为前区选号数 |
| 后区复式 | C(n, 2)，n 为后区选号数 |
| 双区复式 | C(n₁, 5) × C(n₂, 2) |
| 前区胆拖 | C(m, 5-k)，m 为拖码数，k 为胆码数 |
| 后区胆拖 | C(m, 2-k)，m 为拖码数，k 为胆码数 |
**概率计算**：
| 奖级 | 大乐透条件 | 概率 |
|------|-----------|------|
| 一等奖 | 5+2 | 1/21,425,712 |
| 二等奖 | 5+1 | 1/1,071,286 |
| 三等奖 | 5+0 / 4+2 | 1/476,127 |
| 四等奖 | 4+1 | 1/39,678 |
| 五等奖 | 4+0 / 3+2 | 1/6,613 |
| 六等奖 | 3+1 / 2+2 | 1/1,082 |
| 七等奖 | 3+0 / 2+1 / 1+2 / 0+2 | 1/55 |
### 8.5 输出格式保证
所有 CLI 脚本输出格式一致，固定为以下模板：
| 场景 | 输出结构 | 示例 |
|------|---------|------|
| 号码分析 | 彩种 → 号码 → 各维度指标逐行 | `前区: [5,12,19,26,33]` → `奇偶比: 3:2` → `和值: 95` |
| 号码参考 | `参考N: 号码` 格式，前缀固定 | `参考1: 03 08 15 22 31 + 05 10` |
| 组合注数 | 数量 + 金额 + 追加金额 | `注数: 18注 金额: 36元 (追加54元)` |
| 遗漏分析 | 冷号表+热号表+回补信号+分布 | 表格分隔，TOP N 可配置 |
| 杀号 | 原始池→各策略杀号明细→剩余池→缩减率 | 逐策略列出杀除号码 |
| 走势图 | 表头+分隔线+每期一行 | ASCII 表格，列宽固定 |
### 8.6 输入验证流
```
用户输入 → 格式校验 → 彩种识别 → 范围验证 → 条件自洽性检查 → 执行 → 输出
├─ 号码格式错误 → 提示正确格式 "05 12 19 26 33 + 03 10"
├─ 号码超范围 → 提示彩种号码范围（大乐透前区01-35 后区01-12）
├─ 条件自相矛盾 → 提示矛盾原因并建议放宽条件
└─ 数据不足 → 提示当前数据量并输出基于已有数据的分析
```
### 8.7 可靠性设计
| 场景 | 处理方式 |
|------|---------|
| CSV 缺少字段 | 仅处理可用字段，缺失字段提示日志 |
| 号码类型不匹配 | validate_csv.py 自动校验类型和范围 |
| 竞彩/数字彩混排 | lottery_merge.py 自动识别彩种字段差异 |
| 无数据 | 输出引导模板，提示用户提供数据 |
| 条件无满足结果 | 提示"当前条件无满足组合"，给出当前数据分布帮助用户放宽 |
| 注数过多 | 超过 `--max` 限制时只统计不生成明细，避免输出爆炸 |
### 8.8 术语表
| 术语 | 英文 | 说明 |
|------|------|------|
| 彩种 | Lottery Type | 体育彩票的具体种类（大乐透、排列3等） |
| 期号 | Draw Number | 每期开奖的唯一编号 |
| 前区 | Front Zone | 大乐透前5个号码（01-35） |
| 后区 | Back Zone | 大乐透后2个号码（01-12） |
| 和值 | Sum | 一组号码的总和 |
| 跨度 | Span | 最大号码与最小号码之差 |
| 奇偶比 | Odd/Even Ratio | 奇数号码与偶数号码的数量比 |
| 大小比 | Big/Small Ratio | 大号与小号的数量比（大乐透以17为界） |
| 质合比 | Prime/Composite Ratio | 质数与合数的数量比 |
| AC值 | AC Value | 号码复杂度指标，用于评估号码分散程度 |
| 012路 | Mod 3 | 号码除以3的余数分类（0路/1路/2路） |
| 遗漏 | Missing | 号码未出现的连续期数 |
| 胆码 | Bold Number | 号码组合中的核心参考号码 |
| 拖码 | Drag Number | 与胆码组合的非核心号码 |
| 复式 | Compound Bet | 选号数超出基本注的投注方式 |
| 单注 | Single Bet | 基本投注单位（2元） |
| 追加 | Additional Bet | 大乐透+1元追加投注（浮动奖+80%） |
| 杀号 | Number Killing | 通过策略排除不可能出现的号码 |
| 回补信号 | Rebound Signal | 遗漏值超过均值+标准差，可能回调 |
| 振幅 | Amplitude | 同位置相邻两期的号码差值 |
---
## 九、开发约定
### 9.1 命名规范
| 项 | 规范 |
|---|------|
| 技能 `name` | 中文名，见前文 |
| 目录名 | kebab-case（如 `ticai-shai-xuan`） |
| 文件/脚本名 | kebab-case（如 `validate-csv.sh`） |
| CSV 字段名 | 中文，见 4.3 节 |
| 版本号 | semver（`major.minor.patch`） |
| 触发短语 | 自然语言，涵盖口语与书面语 |
### 9.2 参数传递
AI 内部处理时，参数统一格式：
```javascript
{
"lottery": "大乐透", // 彩种
"periods": 20, // 期数
"filters": { // 筛选条件
"奇偶比": "3:2",
"大小比": "2:3",
"和值": [80, 100],
"跨度": [20, 28]
},
"mode": "recommend", // 模式: query/analyze/filter/recommend/predict
"output": 5 // 输出注数
}
```
### 9.3 分目录规范
当 SKILL.md 超过 5000 tokens 时，建议拆分：
| 文件 | 内容 |
|------|------|
| `SKILL.md` | 简介 + 功能简介 + 触发指令 |
| `references/dlt-rules.md` | 大乐透完整规则与投注方式 |
| `references/pl3-rules.md` | 排列3完整规则 |
| `references/pl5-rules.md` | 排列5完整规则 |
| `references/qxc-rules.md` | 七星彩完整规则 |
| `references/jczq-rules.md` | 竞彩足球完整规则 |
| `references/jclq-rules.md` | 竞彩篮球完整规则 |
| `references/terms.md` | 术语表扩展 |
### 9.4 版本兼容
| 版本变更类型 | 操作 |
|-------------|------|
| 新增彩种支持 | 次版本号+1（如 1.1.0） |
| 新增筛选条件 | 次版本号+1 |
| 修复错误逻辑 | 补丁版本号+1（如 1.0.1） |
| 不兼容变更 | 主版本号+1（如 2.0.0） |
---
## 十、免责声明
1. **分析参考**：本工具输出的所有数据统计、走势图表、号码参考仅供分析参考，**不构成任何投注建议**。用户据此产生的投注行为后果自负，与本工具及开发者无关。
2. **零预测能力**：彩票开奖结果具有完全随机性，任何分析方法（包括但不限于概率统计、趋势分析、机器学习、走势图）**均无法预测、保证或提高中奖概率**。本工具不承诺中奖率、准确率、命中率等任何量化指标。
3. **理性购彩**：请用户理性购彩，量力而行，切勿沉迷。体育彩票的本质是为公益事业筹集资金。如发现购彩行为影响正常生活，请拨打 12386 寻求帮助。
4. **数据来源限制**：本工具不内置实时开奖数据抓取功能，依赖用户提供的开奖数据进行分析。分析结果受数据完整性、样本量大小、数据时效性影响。数据量越小，分析参考价值越低。
5. **未成年人保护**：根据《彩票管理条例》，不得向未成年人销售彩票或兑付奖金。本工具不对未成年人提供服务。
6. **合规声明**：本工具仅在中国大陆合法使用，遵守《彩票管理条例》《彩票管理条例实施细则》等相关法律法规。禁止用于非法博彩、跨境赌博等违法行为。
7. **无担保**：本技能按"现状"提供，不附带任何明示或暗示的担保，包括但不限于适销性、特定用途适用性的担保。
don't have the plugin yet? install it then click "run inline in claude" again.