Coin Vp Scanner

# ⚡ coin-vp-scanner — 量价能高杠杆短线突破扫描（skill）

> 项目代码：`~/projects/coin-vp-scanner/`（scanner.py + 回测/规律/耗时 全套工具）
> 版本 v4 · 判定逻辑：确定性结构突破（非黑箱）· 目标：1-30min 吃到自适应小 TP
> 本 SKILL.md 是操作索引；报告模板见下方「六」。

## 触发
`coin-vp` / `vp扫描` / `量价能` / `突破信号` / `扫币` / `R2突破` / `短线币`

## 一、是什么（一句话）
全量扫币安 USDT 永续，只报"**量价能结构突破**"的高确定性信号——
放量 + 强实体 + **收盘破 1h 结构位** + 趋势同向，每个信号带完整判定链和交易参数。

## 二、快速开始
```bash
python3 ~/projects/coin-vp-scanner/scanner.py               # 标准扫描 (默认 10m 币池, 12%风险)
python3 ~/projects/coin-vp-scanner/scanner.py --min-vol 5m --vol-min 1.5 --body-min 0.4 --risk 20
    # 激进档: 更宽币池 + 更松门槛 + 20% 单笔风险
python3 ~/projects/coin-vp-scanner/scanner.py --risk 12     # 稳健档 (推荐默认)
```

## 三、确定性判定规则（全 ✓ 才算信号，逐条可复核）
1. **放量**：触发 K线 量能 ≥ 基线 × 门槛（默认 2x）
2. **实体**：|涨跌| ≥ 门槛（默认 0.5%）
3. **结构破位**（关键）：UP→收盘 破前 12 根(1h)高点；DOWN→破前低；且开盘未远离结构位
4. **趋势同向**：方向与 15m 趋势一致
5. 少任何一条 → 丢弃，不做区间噪声

**量能分析要点**：巨量长阳在顶部 = 常是出货/诱多；安静放量干净破位 = 更可能是真吸筹。别只看放量大小，看"破位是否干净 + 1h 是否过热"。

## 四、交易参数铁律
```
止损距离 × 杠杆 ≤ 15% 本金（扫描默认按 12% 输出杠杆）
时间止损：进场 10min 未到 TP 也未止损 → 主动平（数据: 到TP者中位 5min, 前倾严重）
到 TP 耗时参考：0.3%→79% | 0.5%→67% | 0.7%→56% | 1.0%→47%（到TP率）
```
- **目标自适应**：按 ATR5 定，别死等 1% 踏空（活泼币才有 1%，安静币给 0.3-0.5%）
- **1h 过热不追**：1h 已涨/跌 >15% 的币谨慎（追顶风险）
- **相关信号只挑 1-2 个**：全市场同向齐破 = 一个行情，不是 N 个机会

## 五、工作流（每单走完整闭环）
```
① 扫描 → ② 按下方模板出报告(奖牌排序) → ③ 挑 1-2 个(1h同向+不过热+破位干净)
④ 填 REPORT_TEMPLATE.md 存档到 reports/ → ⑤ 30min 回填结果(到TP/止损/平推)
⑥ 攒样本 → 周度统计真实命中率（回测 60-82%，活体验证 ~50%，以活体为准）
```

## 六、输出报告模板（统一交易卡格式 · 扫描报告与交易卡同一格式）

> 扫描报告 = 一排"统一交易卡" + 奖牌排序；选定某一单 = 同一张卡存档进 reports/ 并回填结果。
> 扫描报告与交易卡共用同一字段集，字段顺序固定如下。

```
🥇 SYMBOL DIR —— 一句理由（如：1h同向+干净破位, 唯一想动的话做它）
   入场 x.xxx | TP x.xxx (+x.x%) | SL x.xxx (-x.x%)
   杠杆 Nx → 目标 +x.x% / 止损亏 -x.x% | 现价x.xxx | ATRx.xx% | 量能x.x | 资金费率±x.xx%
   趋势: 15m↑x.xx% 1h↑x.xx% 24h+x.x% | 参考命中 xx%
   时间: 到TP中位~5min → 10min未到TP也未止损就平(不傻等)
   判定链: 放量x.x✓ → 实体x.xx%✓ → 破位(位价)越过x.xx%✓ → 15m同向✓

🥈 SYMBOL DIR —— 次选（一句话）
   （同上格式）
⚠️ SYMBOL —— 不建议追
   • 理由1（过热/逆势/破位薄）
```

**交易卡模板（单笔存档）** = 同一张卡 + 以下三节：
- 杠杆记录（止损×杠杆≤15%、单笔风险、仓位）
- 结果验证（30min 回填：到TP✅ / 触止损❌ / 平推⏳ + 实际盈亏）
- 铁律自查（含时间止损 10min）

详细可复制模板见 `~/projects/coin-vp-scanner/REPORT_TEMPLATE.md`。

## 七、工具索引（~/projects/coin-vp-scanner/）
| 文件 | 用途 |
|------|------|
| `scanner.py` | 主扫描器（信号+交易参数+判定链）|
| `backtest.py` | 方向评分历史回测 |
| `pattern_1pct.py` | 1% 目标竞速规律挖掘（R2 来源）|
| `tp_sizing.py` | 自适应 TP 规律 |
| `time_to_tp.py` | 到 TP 耗时分布 |
| `validate_breakout.py` | 破位条件客观验证 |
| `breakout_confidence.py` | 确认层(L1-L4)命中提升验证 |
| `REPORT_TEMPLATE.md` | 交易报告模板 |
| `reports/` | 每单留档（判定链/交易卡/杠杆/结果）|

## 八、诚实边界
- 到 TP 率 60-82% 是 10 天回测值；**活体验证累计仅 ~50%**，以 paper 攒数据为准
- 样本 <50 前别下"稳赚"结论；行情切换(震荡期)命中会掉
- 75x + 宽止损 = 必爆；杠杆永远服从「止损×杠杆≤15%」
- 不构成投资建议；高倍数收益图都有幸存者偏差