Triple Resonance Scanner
概述
本 skill 对 OKX 永续合约进行多周期技术指标共振扫描，核心判断逻辑：
三重共振 = 1H + 4H + 1D 三个时间框架评分同时为正（多头共振）或同时为负（空头共振）
单个时间框架评分维度（-10 ~ +15）：
| 指标 | 多头信号 | 空头信号 |
|---|---|---|
| MA 位置/排列 | 价格 > MA7/25/50，多头排列 | 价格 < MA |
| MACD | 金叉刚触发 +3，延续 +2 | 死叉 -2 |
| RSI | < 30 超卖 +3，30-45 偏多 +1 | > 70 超买 -2 |
| 布林带 | %B < 20% 超卖 +2 | %B > 80% 超买 -2 |
| 量能 | 放量 > 1.5x +1 | — |
| 双动量 | 5周期+10周期均正 +1 | — |
工作流程
Step 1：触发检测
识别用户意图后，立即执行扫描脚本，无需额外确认。
常见触发语：
- "有三重共振信号吗" / "扫描三重共振"
- "哪些币 1H 4H 日线方向一致"
- "找多周期共振的标的"
- "三重共振报告"
Step 2：执行扫描
使用脚本 scripts/triple_resonance.py：
# 标准扫描（默认 Top-20 合约，代理 127.0.0.1:10808）
python "${SKILL_DIR}/scripts/triple_resonance.py"
# 自定义合约列表
python "${SKILL_DIR}/scripts/triple_resonance.py" --symbols BTC-USDT-SWAP,ETH-USDT-SWAP,SOL-USDT-SWAP
# 指定代理
python "${SKILL_DIR}/scripts/triple_resonance.py" --proxy http://127.0.0.1:10808
# 指定输出路径
python "${SKILL_DIR}/scripts/triple_resonance.py" --output /path/to/report.html
> 注意：${SKILL_DIR} 是本 skill 的实际安装路径，运行时替换为绝对路径。
> 用户本机代理默认为 http://127.0.0.1:10808。
脚本参数一览：
| 参数 | 默认值 | 说明 |
|---|---|---|
--symbols |
默认 Top-20 | 逗号分隔的合约 instId |
--top20 |
— | 等同于不传 --symbols |
--proxy |
http://127.0.0.1:10808 |
HTTP 代理 |
--output |
resonance_report.html |
HTML 报告路径 |
--json |
resonance_result.json |
JSON 数据路径 |
Step 3：解读结果
扫描完成后，脚本输出两个文件：
- resonance_report.html：暗色系可视化报告，用 preview_url 展示
- resonance_result.json：原始数据，按需读取
结果分三类：
| 类型 | 条件 | 操作建议 |
|---|---|---|
| 多头三重共振 | 1H > 0 且 4H > 0 且 1D > 0 | 可考虑做多，综合评分越高优先级越高 |
| 空头三重共振 | 1H < 0 且 4H < 0 且 1D < 0 | 可考虑做空 |
| 接近共振(2/3) | 2个周期同向 | 候选观察，等待第三个周期确认 |
Step 4：报告展示
# 启动本地 HTTP 服务器预览报告
import subprocess, sys
subprocess.Popen([sys.executable, "-m", "http.server", "8765",
"--bind", "127.0.0.1", "--directory", "<output_dir>"])
# 然后 preview_url("http://127.0.0.1:8765/resonance_report.html")
或直接用 open_result_view 打开 HTML 文件。
Step 5：信号解读建议
扫描结果回报给用户时，重点提示：
- 综合均分 avg_score：越高（多头）或越低（空头）信号越强
- MACD 刚金叉（JustCross）：最强短期信号，标注
! - RSI 位置：超买（>70）追高风险，超卖（<30）或中性最佳
- 资金费率：负值 = 空头支付多头，有利多头；过高正值有风险
- 1H 方向：若 1H 评分为负但 4H/1D 强，属于"回调买入"机会
默认扫描列表（Top-20）
BTC ETH SOL BNB XRP DOGE ADA AVAX DOT LINK
UNI ATOM LTC BCH NEAR APT OP ARB SUI TRX
均为 -USDT-SWAP 合约。
注意事项
- 数据源：OKX 公开 API（无需 API Key）
- 代理：若在中国大陆使用，需开启代理（默认 127.0.0.1:10808）
- 频率：单次扫描约 60-90 秒（60 次 API 调用）
- 本指标为技术分析辅助工具，不构成投资建议，需结合基本面和风险管理
