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

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

⚠️ 别和 5minbtc 混用 —— 两个都是交易 skill 但赌的不是同一件事。 本 skill = 抓"价格放量破位了"（全市场永续、结构规则、直接做合约）； 5minbtc = 赌"市场定价错了"（单标的 BTC、5min K线、真 OFI 净流 vs 预测市场 token 价 EV = p − P、仅 paper）。 完整对照表见 5minbtc SKILL.md 的「与 coin-vp-scanner 的分工」。 一句话选型：要抓突破 → 用本 skill；要赌错价 → 用 5minbtc。

触发

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

一、是什么（一句话）

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

二、快速开始

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%」
• 不构成投资建议；高倍数收益图都有幸存者偏差