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 调用）
本指标为技术分析辅助工具，不构成投资建议，需结合基本面和风险管理