数字筛选 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万 |

超级大乐透选择方式

| 方式 | 说明 | 匹配条件示例 | |------|------|-------------| | 基础 | 前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组, 扩展参数调整 | — | | 多倍选择 | 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位单独选择 |

三、功能模块

3.1 往期历史数据查询

用户通过自然语言查询历史数据，支持查询指定期数或最近一期历史数据。

查询方式：

| 方式 | 说明 | 示例 | |------|------|------| | 按类型查询 | 指定类型的历史记录 | "查大乐透最近20期" | | 按期号查询 | 指定期号结果 | "查大乐透第25001期" | | 按日期查询 | 指定日期结果 | "查2026年6月历史" | | 多期对比 | 多期数据对比 | "对比近10期数字" | | 历史同期 | 历年同期对比 | "历年同期历史数据" |

输出指标：期号、数据序列、和值、跨度、奇偶比、大小比、012路、总值、匹配计数。

3.2 频次统计与趋势分析

对历史数据进行多维度统计分析，提供频次统计、数字频率、缺失值等趋势分析。提供 num_filter.py csv（频率统计）和 num_missing.py（缺失深度分析）两个命令行工具。

分析维度：

| 维度 | 说明 | 工具 | |------|------|------| | 数字频率 | 各数字出现次数排名 | num_filter.py csv | | 缺失分析 | 当前缺失/最大缺失/平均缺失 | num_missing.py | | 频次分布 | 热号(≤5期)/温号(6-15期)/冷号(≥16期) | num_missing.py | | 回补信号 | 缺失超均值+标准差 → 关注反弹 | num_missing.py | | 缺失分布 | 冷/温/热各区数量+比例 | num_missing.py | | 和值趋势 | 均值/标准差/极值/区间分布 | — | | 跨度趋势 | 大/中/小跨度占比 | — |

3.3 条件过滤

支持按奇偶、大小、和值、跨度、区间、连号、质数、频次等条件过滤数字组合。提供 num_exclude.py 进行多策略排除缩减数据池。

筛选条件速查：

| 条件 | 适用类型 | 说明 | |------|---------|------| | 奇偶比 | 全部数字彩 | 奇偶数字数量比 | | 大小比 | 全部数字彩 | 大小号数量比 | | 质合比 | 大乐透/排列3/5/七星彩 | 质数合数比 | | 和值范围 | 全部数字彩 | 数字总和区间 | | 跨度范围 | 全部数字彩 | 最大-最小值区间 | | 连号 | 全部数字彩 | 相邻连续数字组数 | | 重号 | 全部数字彩 | 与上期重复个数 | | 频次 | 全部数字彩 | 冷/热号出现个数 | | AC值 | 大乐透 | 复杂度指标范围 | | 012路 | 全部数字彩 | 除3余数分布 | | 定位 | 排列3/5/七星彩 | 每位数字范围 | | 振幅 | 排列3/5/七星彩 | 同位置差值 | | 区位分布 | 大乐透 | 一/二/三区出号数 | | 尾数 | 大乐透/排列5 | 个位数分布 | | 比率 | | 比率范围过滤 |

执行流程：

用户输入条件 → 解析条件类型与适用类型 → 验证条件自洽性
→ 生成数据池 → 逐条件过滤 → 统计满足注数 → 输出 TOP 参考

3.4 组合方案生成

根据用户偏好或默认设置，生成符合条件的数字组合。提供 num_select.py（多策略定位）和 num_combo.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 往期历史核对

提供 num_match.py 核对输入数字与往期历史数据的匹配情况。

| 类型 | 核验方式 | 等级识别 | |------|---------|---------| | 大乐透 | 主区5个+副区2个匹配 | 7个等级(一等~七等) | | 排列3 | 直选/组选3/组选6自动识别 | 按命中精度输出 | | 排列5 | 5位精确匹配 | 全对=匹配 | | 七星彩 | 7位精确匹配 | 全部一致=匹配 |

支持按指定期号核验或遍历全部历史数据。

3.6 概率统计

提供 num_prob.py 计算各玩法各等级的概率。

| 类型 | 计算内容 | |------|---------| | 大乐透 | 7个等级分别的概率 + 整体匹配率 | | 排列3 | 直选/组选3/组选6 分别概率 | | 排列5 | 直选概率 | | 七星彩 | 一等奖~六等奖分别概率 |

3.7 数据管理

| 工具 | 功能 | |------|------| | csv_merge.py | 合并多个CSV文件、去重、排序（混合类型自动识别） | | report_gen.py | 生成 HTML 综合分析报告（频率/和值/跨度/频次统计） | | validate_csv.py | 校验 CSV 格式是否符合规范 | | generate_data.py | 生成示例历史数据（按实际历史日） |

3.8 趋势图

以文本/表格形式生成 9 种趋势图，支持 10/20/30/50/100 期及历史同期周期。

趋势图类型：

| # | 类型 | 适用类型 | 核心内容 | |---|------|---------|---------| | 1 | 数字综合趋势 | 全部数字彩 | 每期数字+和值+跨度+奇偶+大小+012路 | | 2 | 和值趋势 | 全部数字彩 | 和值变化曲线+区间分布+均值统计 | | 3 | 跨度趋势 | 全部数字彩 | 跨度变化+大/中/小占比 | | 4 | 定位趋势 | 排列3/5/七星彩 | 每位数字分布+振幅 | | 5 | 频次趋势 | 全部数字彩 | 频率+缺失+频次状态+趋势 | | 6 | 奇偶/大小形态 | 全部数字彩 | 形态比例变化+趋势 | | 7 | 缺失趋势 | 全部数字彩 | 各数字缺失值曲线+极值提示 | | 8 | 区位分布 | 大乐透 | 三区出号分布+断区分析 | | 9 | 副区趋势 | 大乐透 | 副区数字+跨度+奇偶搭配 |

趋势图综合分析报告：

综合多种趋势图，输出结构化的分析结论，包含：和值/跨度趋势判断、频次分布与回补提示、区位参考、副区搭配建议、综合数据池参考。

3.9 完整工作流示例

以下展示从数据输入到分析到输出的全链路操作：

示例：大乐透数字方案生成

# Step 1: 查看趋势图（近10期综合趋势）
python3 scripts/num_charts.py data.csv --type comprehensive --periods 10

# Step 2: 缺失分析（频次 + 回补信号）
python3 scripts/num_missing.py data.csv --top 5

# Step 3: 定位（多策略综合）
python3 scripts/num_select.py data.csv --count 3

# Step 4: 排除过滤（尾数 + 区间 + 分区）
python3 scripts/num_exclude.py --pool 01-35 --kill-tail 0,1 --sections 5

# Step 5: 条件生成（奇偶3:2 + 和值80-110）
python3 scripts/num_filter.py generate --oe 3:2 --sum 80-110 --count 5

# Step 6: 概率说明
python3 scripts/num_prob.py --lottery 大乐透

# Step 7: 生成报告
python3 scripts/report_gen.py data.csv -o report.html

示例：排列3形态分析

# 定位趋势
python3 scripts/num_charts.py data.csv --lottery 排列3 --type position --pos 0 --pos-name 百位

# 缺失分析
python3 scripts/num_missing.py data.csv --lottery 排列3

# 形态生成（奇奇奇）
python3 scripts/num_filter.py generate --lottery 排列3 --oe-shape 奇奇奇 --count 5

# 定位组合
python3 scripts/num_combo.py --lottery 排列3 --front "0,2,4,6,8/1,3,5,7,9/0,2,4,6,8"

示例：历史数据管理

# 校验 CSV 格式
python3 scripts/validate_csv.py data.csv

# 合并多个 CSV
python3 scripts/csv_merge.py csv1.csv csv2.csv -o merged.csv

# 核对输入数字是否匹配
python3 scripts/num_match.py "05 12 19 26 33 + 03 10" -d data.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

类型,期号,日期,数字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位（七星彩）；数字彩该列为空
• 总值(亿) / 统计(亿)：仅大乐透

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              # 七星彩完整规则
│   └── terms.md                  # 术语表扩展
├── scripts/                      # （可选）辅助脚本
│   ├── num_filter.py         # 数字分析/条件生成/组合/CSV统计
│   ├── num_charts.py         # 6种ASCII趋势图(综合/和值/跨度/定位/频次/奇偶)
│   ├── num_missing.py        # 缺失深度分析(频次/回补信号/分布统计)
│   ├── num_match.py        # 数字对比核验(精确到等级)
│   ├── num_combo.py        # 组合/胆托/定位组合全组合生成器
│   ├── num_exclude.py           # 多策略排除(尾数/区间/和值尾/分区/历史差值)
│   ├── num_select.py            # 多策略定位(热号/冷号/邻号/近期高频/综合)
│   ├── num_prob.py    # 匹配概率精确计算(全部4种数字彩)
│   ├── csv_merge.py          # CSV合并/去重/排序(混合类型自动识别)
│   ├── report_gen.py         # HTML综合分析报告生成器
│   ├── validate_csv.py           # CSV 格式校验
│   ├── generate_data.py          # 示例数据生成器
├──                      # （可选）使用示例
│   ├── dlt-sample.csv            # 大乐透示例数据
│   ├── pl3-sample.csv            # 排列3示例数据
│   └── sample-sample.csv           # 示例数据
└── assets/                       # （可选）资源文件
    └── icon.png                  # 技能图标

目录约定：

| 目录 | 必需 | 说明 | |------|------|------| | SKILL.md | 是 | 技能入口，frontmatter + markdown 正文 | | _meta.json | 否 | 元数据（TCR 发布需要） | | references/ | 否 | 规则文档拆分，单文件 >5000 tokens 时使用 | | scripts/ | 否 | 工具脚本 | | `` | 否 | 示例数据文件 | | assets/ | 否 | 图标等资源 |

---

六、CLI 使用

6.1 安装 SkillHub CLI

curl -fsSL https://skillhub.cn/install/install.sh | bash

验证安装：

skillhub -h

6.2 登录

skillhub login

按提示完成认证（账号密码或浏览器 OAuth）。

6.3 初始化技能

skillhub init --name "数字筛选" --category "数据分析"

此命令创建技能目录及必要的配置文件。

6.4 推送文件

# 在技能目录中
skillhub push

将本地文件推送到 SkillHub 平台，不会立即发布。

6.5 发布上线

# 确认可发布后
skillhub publish

提交审核，审核通过后自动上架。

6.6 版本管理

# 更新 SKILL.md 中的 version 后重新推送
skillhub push
skillhub publish

# 查看已发布的版本
skillhub versions

6.7 本地 CLI 脚本速查

数字分析

# 分析单注数字(奇偶/大小/和值/跨度/AC值/012路)
python3 scripts/num_filter.py analyze "05 12 19 26 33 + 03 10"

# 按条件生成数字方案
python3 scripts/num_filter.py generate --oe 3:2 --sum 80-100 --count 5

# CSV 频率统计
python3 scripts/num_filter.py csv data.csv

# 组合/定位注数计算
python3 scripts/num_filter.py comb --front-num 6 --back-num 3

趋势图

# 数字综合趋势
python3 scripts/num_charts.py data.csv --type comprehensive

# 和值趋势
python3 scripts/num_charts.py data.csv --type sum

# 定位趋势（排列3）
python3 scripts/num_charts.py data.csv --lottery 排列3 --type position --pos 0 --pos-name 百位

# 频次图
python3 scripts/num_charts.py data.csv --type hotcold

缺失分析

# 频次缺失 + 回补信号 + 分布统计
python3 scripts/num_missing.py data.csv --top 10

# 排列3缺失
python3 scripts/num_missing.py data.csv --lottery 排列3

数字核验

# 核对输入数字是否匹配
python3 scripts/num_match.py "05 12 19 26 33 + 03 10" -d data.csv

# 排列3核验（直选 + 组选3/6自动识别）
python3 scripts/num_match.py "9 5 7" --lottery 排列3 -d data.csv

组合全组合

# 大乐透前6+后3组合（仅统计注数）
python3 scripts/num_combo.py --front 01,02,03,04,05,06 --back 01,02,03

# 排列3定位组合（百位3个×十位3个×个位3个）
python3 scripts/num_combo.py --lottery 排列3 --front "1,2,3/4,5,6/7,8,9"

# 输出全组合到 CSV
python3 scripts/num_combo.py --front 01-07 --back 01-03 --output combos.csv

排除

# 多策略排除：尾数0和5 + 区间1-5 + 分区杀空区
python3 scripts/num_exclude.py --pool 01-35 --kill-tail 0,5 --kill-range 1-5 --sections 3

# 排列3排除
python3 scripts/num_exclude.py --pool 0-9 --kill-tail 0,9 --lottery 排列3

定位

# 多策略定位（热号/冷号/邻号/近期高频/综合）
python3 scripts/num_select.py data.csv --count 3

概率计算

# 精确匹配概率（全部等级）
python3 scripts/num_prob.py --lottery 大乐透
python3 scripts/num_prob.py --lottery 排列3

数据合并

# 合并多个CSV + 去重 + 排序
python3 scripts/csv_merge.py data.csv data.csv -o merged.csv

生成报告

# HTML 综合分析报告（频率/和值/跨度/缺失/热号）
python3 scripts/report_gen.py data.csv -o report.html

数据管理

# CSV 格式校验
python3 scripts/validate_csv.py data.csv

# 生成示例数据
python3 scripts/generate_data.py --lottery 七星彩 --count 10 -o qxc_data.csv

6.8 本地测试

# 校验 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 五维评测体系，本技能对应达标措施如下：

| 维度 | 审核要求 | 本技能达标措施 | |------|---------|--------------| | Trust（可信任度） | 内容真实可靠，不夸大承诺，不含诱导性表述 | ① 多处明示"分析参考、不构成分析参考" ② 强调历史完全随机，任何方法无法分析 ③ 不承诺匹配率、准确率 ④ 注明数据来源和样本量限制 ⑤ 所有输出附带"理性分析"提示 | | Reliability（可靠性） | 功能稳定一致，输入输出可预期，异常可处理 | ① 所有脚本有统一的参数接口（argparse） ② 条件输入前自动验证自洽性 ③ CSV 数据有格式校验（validate_csv.py） ④ 异常输入给出明确错误定位与修正建议 ⑤ 不满足条件时提示放宽条件 ⑥ 输出格式固定，AI 可解析 | | Adaptability（适用性） | 覆盖多种场景和用户表达方式 | ① 覆盖 8 种数字类型、全部数字彩玩法 ② 24+ 触发短语覆盖口语与书面语 ③ 支持 6 种工作模式（查询/分析/筛选/参考/趋势/统计） ④ 自然语言输入自动解析为结构化参数 ⑤ 支持单注分析到批量 CSV 统计 ⑥ 和数字彩分别处理 | | Convention（规范性） | 文档结构清晰，命名统一，术语一致，可读性好 | ① 10 章标准结构 ② 全篇统一术语（"类型"非"类型"、"期号"非"期数"） ③ frontmatter YAML 格式正确 ④ 表格/代码块格式一致 ⑤ 附录含完整术语表 ⑥ 文件命名遵循 kebab-case ⑦ 版本遵循 semver | | Effectiveness（有效性） | 实际使用能解决问题，工作流完整 | ① 从数据输入到分析到报告输出全链路覆盖 ② 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 扩展: 54 | | 缺失分析 | 冷号表+热号表+回补信号+分布 | 表格分隔，TOP N 可配置 | | 排除 | 原始池→各策略排除明细→剩余池→缩减率 | 逐策略列出杀除数字 | | 趋势图 | 表头+分隔线+每期一行 | ASCII 表格，列宽固定 |

8.6 输入验证流

用户输入 → 格式校验 → 类型识别 → 范围验证 → 条件自洽性检查 → 执行 → 输出
  ├─ 数字格式错误 → 提示正确格式 "05 12 19 26 33 + 03 10"
  ├─ 数字超范围 → 提示类型数字范围（大乐透主区01-35 副区01-12）
  ├─ 条件自相矛盾 → 提示矛盾原因并建议放宽条件
  └─ 数据不足 → 提示当前数据量并输出基于已有数据的分析

8.7 可靠性设计

| 场景 | 处理方式 | |------|---------| | CSV 缺少字段 | 仅处理可用字段，缺失字段提示日志 | | 数字类型不匹配 | validate_csv.py 自动校验类型和范围 | | /数字彩混排 | csv_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 | 数量扩展调整 | | 排除 | 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 内部处理时，参数统一格式：

{
  "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/terms.md | 术语表扩展 |

9.4 版本兼容

| 版本变更类型 | 操作 | |-------------|------| | 新增类型支持 | 次版本号+1（如 1.1.0） | | 新增筛选条件 | 次版本号+1 | | 修复错误逻辑 | 补丁版本号+1（如 1.0.1） | | 不兼容变更 | 主版本号+1（如 2.0.0） |

---

十、免责声明

1. 分析参考：本工具输出的所有数字筛选、统计分析、趋势判断仅供分析参考，不构成任何分析参考。
2. 随机性：历史数据具有完全随机性，任何分析方法均无法分析历史数据。
3. 理性分析：请用户理性分析，量力而行，切勿沉迷。
4. 数据来源：本工具依赖用户提供的历史数据进行分析，分析结果受数据完整性影响。
5. 合规声明：本工具仅在中国大陆合法使用，遵守相关法律法规。