BTC 动能理论分析器 功能概述
本 Skill 实现基于 MACD 的多时间级别嵌套动能理论分析系统，提供：
多时间级别数据获取: 从 OKX API 获取 8 个时间级别的 BTC K线数据
2日线 (2d), 1日线 (1d), 12小时 (12h), 6小时 (6h) 4小时 (4h), 2小时 (2h), 1小时 (1h), 30分钟 (30m)
技术指标计算:
EMA26, EMA52（短期和中期趋势线） MACD(12, 26, 9): DIF（黄线）, DEA（白线）, Histogram（柱状图）
线段分类: 每个时间级别的市场状态识别
上涨线段（DEA > 0） 下跌线段（DEA < 0） 过渡期和突破尝试
动能理论分析（详见 THEORY.md）:
单位调整周期：判断处于第几个调整周期 分立调控：检测离散的动能调整模式 连续跳空背离：价格与柱状图的背离 + 跳空 黄白线背离：DIF 与 DEA 的背离检测 隐形信号：隐藏的动能变化
多时间级别联动:
上级周期对下级周期的影响 多周期共振确认 嵌套关系的递归分析
交易信号生成:
买卖点识别（规则定义在 THEORY.md） 止损止盈建议 置信度评估 动能理论体系
完整的理论定义请参考 THEORY.md，包括：
上涨线段 / 下跌线段的精确定义 单位调整周期的识别方法 分立调控的检测算法 连续跳空背离的判断标准 黄白线背离的分析规则 买点 / 卖点的触发条件 时间级别联动的分析框架
重要：所有交易参数、阈值、规则均在 THEORY.md 中定义，本 Skill 不包含硬编码的交易逻辑。
使用指南 一键分析（推荐）
Claude 会自动执行完整的分析流程，你只需提问：
示例问题：
"分析当前 BTC 的动能状态" "BTC 现在处于哪个单位调整周期？" "检测 BTC 多时间级别的背离情况" "BTC 有买点吗？给我详细分析"
Skill 会自动：
获取 8 个时间级别的实时数据（OKX API） 计算所有指标（EMA26/52, MACD） 进行嵌套动能分析 生成详细报告 手动执行步骤（高级用户）
如需手动控制分析流程，可按以下步骤执行：
第一步：获取多时间级别数据 python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/fetch_btc_data.py \ --symbol BTC-USDT \ --timeframes 2d,1d,12h,6h,4h,2h,1h,30m \ --limit 200 \ --exchange okx
参数说明：
--symbol: 交易对（OKX 格式：BTC-USDT） --timeframes: 逗号分隔的时间级别列表 --limit: 每个时间级别获取的 K 线数量 --exchange: 交易所（okx, binance, bybit）
输出：JSON 文件，包含所有时间级别的 OHLCV 数据
第二步：计算技术指标 python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/calculate_indicators.py \ /Users/adrian/Desktop/BA/MACD/data/btc_multi_timeframe.json \ --ema-periods 26,52 \ --macd-params 12,26,9
输出：带有 EMA 和 MACD 指标的注释数据
第三步：动能理论分析 python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/analyze_momentum.py \ /Users/adrian/Desktop/BA/MACD/data/btc_indicators.json \ --theory-file /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/THEORY.md
输出：
每个时间级别的线段分类 单位调整周期判断 分立调控检测结果 背离分析（连续跳空背离、黄白线背离） 多时间级别联动关系 第四步：生成交易报告 python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/generate_report.py \ /Users/adrian/Desktop/BA/MACD/data/btc_analysis.json \ --format text \ --detail full
输出：结构化的多时间级别嵌套分析报告
典型输出示例 完整动能分析报告 ========================= BTC 动能理论分析报告 分析时间: 2025-12-10 16:30:00 UTC =========================
多时间级别嵌套分析
【2日线级别】 线段状态: 上涨线段 - DEA: +1250.3 (0轴上方，强势多头) - DIF: +1580.7 - Histogram: +330.4 (持续扩张) - 线段持续时间: 8 根 K 线 - EMA 排列: EMA26 (98,500) > EMA52 (96,200) ✓ - 单位调整周期: 第 2 个周期 - 周期间背离: 无 - 黄白线背离: 无（DIF 和 DEA 同向上升）
【1日线级别】 线段状态: 上涨线段 - DEA: +850.5 (0轴上方) - DIF: +920.3 - Histogram: +69.8 (正柱，动能减弱) - 线段持续时间: 12 根 K 线 - EMA 排列: EMA26 (98,200) > EMA52 (96,800) ✓ - 单位调整周期: 第 1 个周期 - 周期间背离: 无 - 黄白线背离: ⚠️ 轻微背离（价格新高，DIF 未新高） - 与上级关系: 与 2日线 共振向上
【12小时级别】 线段状态: 上涨线段 - DEA: +420.8 - DIF: +380.2 - Histogram: -40.6 (负柱，动能转弱) - 线段持续时间: 18 根 K 线 - EMA 排列: EMA26 (98,100) > EMA52 (97,200) ✓ - 单位调整周期: 第 2 个周期 - 周期间背离: ✓ 检测到背离（第1周期高点 vs 第2周期） - 黄白线背离: ✓ 顶背离（DIF 下穿 DEA，死叉） - 分立调控: 无 - 与上级关系: 1日线 上涨，但 12h 动能衰竭
【6小时级别】 线段状态: 过渡期（上涨线段后调整） - DEA: +180.3 - DIF: +120.5 - Histogram: -59.8 (负柱，回调) - 线段持续时间: 6 根 K 线（过渡期） - EMA 排列: EMA26 (97,800) < EMA52 (97,850) ✗ (短期破位) - 单位调整周期: N/A（处于过渡期） - 分立调控: ✓ 检测到（第 3-5 根 K 线出现离散调整） - 与上级关系: 12h 背离警告，6h 进入调整
【4小时级别】 线段状态: 过渡期 - DEA: +80.2 - DIF: +50.1 - Histogram: -30.1 - 线段持续时间: 10 根 K 线 - EMA 排列: EMA26 (97,600) < EMA52 (97,700) ✗ - 连续跳空背离: 无 - 黄白线背离: ✓ 死叉背离 - 与上级关系: 6h 调整延续至 4h
【2小时级别】 线段状态: 下跌线段（警告） - DEA: -20.5 (已下穿 0 轴) - DIF: -45.3 - Histogram: -24.8 - 线段持续时间: 4 根 K 线 - EMA 排列: EMA26 (97,400) < EMA52 (97,650) ✗ - 单位调整周期: 第 1 个周期（下跌段开始） - 与上级关系: 4h 调整转为 2h 下跌
【1小时级别】 线段状态: 下跌线段 - DEA: -35.8 - DIF: -50.2 - Histogram: -14.4 - 线段持续时间: 8 根 K 线 - EMA 排列: EMA26 (97,350) < EMA52 (97,550) ✗ - 单位调整周期: 第 1 个周期 - 连续跳空背离: 无 - 黄白线背离: 无（同向下跌） - 与上级关系: 2h 下跌延续至 1h
【30分钟级别】 线段状态: 下跌线段 - DEA: -45.2 - DIF: -55.8 - Histogram: -10.6 - 线段持续时间: 12 根 K 线 - EMA 排列: EMA26 (97,300) < EMA52 (97,500) ✗ - 单位调整周期: 第 1 个周期 - 隐形信号: ⚠️ 柱状图收敛（可能即将反转） - 与上级关系: 1h 下跌延续
多时间级别联动总结
【大周期趋势】(2日线 - 1日线) ✓ 上涨线段确认 - 2日线 处于第 2 个单位调整周期，强势上涨 - 1日线 出现轻微黄白线背离，需警惕
【中周期调整】(12h - 6h - 4h) ⚠️ 调整期 - 12h 检测到周期间背离 + 黄白线死叉背离 - 6h 发现分立调控，进入过渡期 - 4h 延续调整，动能持续减弱
【小周期下跌】(2h - 1h - 30m) ✗ 短期下跌 - 2h 已确认下跌线段（DEA 下穿 0 轴） - 1h, 30m 延续下跌，但 30m 出现柱状图收敛（隐形反转信号）
交易信号与建议
【当前市场状态】 多空分歧：大周期多头 vs 小周期空头
【买点分析】 ❌ 不建议立即开多单 原因： 1. 12h 级别出现明显顶背离（价格新高，DIF 未新高） 2. 6h 检测到分立调控，市场处于调整期 3. 2h/1h 已确认下跌线段，短期趋势向下 4. 需等待小周期企稳后再考虑入场
【潜在买点触发条件】（参考 THEORY.md 规则） 1. 30m 级别 DEA 上穿 0 轴，确认反转 2. 1h 级别 EMA26 重新上穿 EMA52 3. 2h 级别调整结束，与 4h 恢复共振 4. 大周期 1日线、2日线 保持上涨线段
【卖点分析】 ⚠️ 空单风险提示 原因： 1. 大周期（2日线、1日线）仍处于强势上涨线段 2. 当前下跌可能只是大周期的正常回调 3. 30m 柱状图收敛，可能即将反弹
【建议操作】 观望为主，等待以下情况之一： 1. 30m 反转信号确认 → 小仓位做多（顺大周期） 2. 2h DEA 继续下穿至 -100 以下 → 考虑短线空单 3. 1日线 DEA 下穿 0 轴 → 大周期转向，谨慎做空
【风险等级】: 中等 【置信度】: 60% (观望建议)
关键监控指标
- 30分钟 Histogram: 收敛后是否放量反转
- 2小时 DEA: 是否继续下探或企稳
- 12小时 黄白线: 背离后是否形成新的多头排列
- 1日线 EMA26/EMA52: 是否保持多头排列
========================= 报告生成时间: 2025-12-10 16:30:12 UTC 数据来源: OKX API 理论依据: THEORY.md (用户自定义动能理论) =========================
数据来源说明 OKX API
本 Skill 使用 OKX 交易所的免费公开 API：
优势：
免费，无需 API Key（公开数据） 支持所有需要的时间级别（2d, 1d, 12h, 6h, 4h, 2h, 1h, 30m） 数据质量高，延迟低 限制：20 请求/2秒
API 端点：
https://www.okx.com/api/v5/market/candles
时间级别映射：
2d → 2D 1d → 1D 12h → 12H 6h → 6H 4h → 4H 2h → 2H 1h → 1H 30m → 30m 备用数据源
本地缓存：
位置：/Users/adrian/Desktop/BA/MACD/data/btc_cache_{timeframe}.json 缓存有效期：根据时间级别动态调整（30m 缓存 5 分钟，2d 缓存 1 小时）
Binance API（降级）：
如果 OKX API 不可用，自动切换 注意：Binance 的时间级别名称略有不同
手动导出：
从 TradingView 或其他平台导出 CSV 放置在 data/ 目录 脚本可自动识别并解析 输出格式 文本报告（默认）
结构化的多时间级别嵌套报告，包含：
每个时间级别的详细分析 线段状态、单位周期、背离检测 多时间级别联动总结 交易信号和操作建议 关键监控指标 JSON 报告 --format json
机器可读格式，适合进一步处理或存储。
简化报告 --detail simple
仅包含关键信息和交易建议，适合快速查看。
分析深度控制
根据需要调整分析的详细程度：
完整分析（默认） python3 scripts/analyze_momentum.py data.json --detail full
包含所有 8 个时间级别的完整分析
重点分析 python3 scripts/analyze_momentum.py data.json --focus 1h,4h,1d
仅分析指定的时间级别，但仍考虑上下级联动关系
快速扫描 python3 scripts/analyze_momentum.py data.json --mode quick
仅输出当前线段状态和关键信号，跳过详细分析
错误处理
脚本内置多层错误处理：
API 限流：自动等待并重试 网络错误：自动重试 3 次，失败后降级到缓存 数据缺失：跳过缺失的时间级别，记录警告 计算异常：返回 null 值，不中断流程 THEORY.md 解析错误：使用默认规则并警告用户 性能优化 并行获取数据：8 个时间级别并行请求，缩短等待时间 增量更新：只获取新增 K 线，减少数据传输 智能缓存：根据时间级别动态设置缓存过期时间 懒加载：仅在需要时计算详细指标 相关文件 THEORY.md - 动能理论完整定义（核心，需用户填写） EXAMPLES.md - 使用示例和问答 MACD.pine - 参考的 Pine Script 策略（仅供参考） README.md - 原有策略文档 支持的问题类型
本 Skill 会在检测到以下关键词时自动激活：
动能分析类：
"BTC 动能"、"比特币动能状态" "分析 BTC"、"BTC 行情分析"
线段和周期类：
"上涨线段"、"下跌线段"、"线段状态" "单位调整周期"、"第几个周期" "周期间背离"
背离和信号类：
"连续跳空背离"、"柱状图背离" "黄白线背离"、"DIF DEA 背离" "分立调控"、"隐形信号"
交易相关：
"买点"、"卖点"、"交易信号" "开多"、"开空"、"止损"
时间级别：
"1小时"、"4小时"、"日线" "多时间级别"、"时间级别联动" 限制和注意事项
THEORY.md 必须完善：
本 Skill 不包含任何硬编码的交易逻辑 所有规则、参数、阈值均从 THEORY.md 读取 如果 THEORY.md 不完整，分析结果可能不准确
数据延迟：
OKX API 数据可能有 1-2 秒延迟 大周期（2日线）数据更新较慢
指标精度：
Python 计算的 MACD 与 TradingView 可能有微小差异 EMA 初始值计算方式需与你的理论一致
API 限制：
OKX: 20 请求/2秒 8 个时间级别 = 8 个请求，约 1 秒完成
风险提示：
本 Skill 仅提供分析参考，不构成投资建议 多时间级别可能出现矛盾信号，需综合判断 维护和更新 脚本位置：.claude/skills/btc-momentum-analyzer/scripts/ 理论更新：修改 THEORY.md 后立即生效，无需重启 参数调整：所有参数在 THEORY.md 中配置 版本控制：通过 git 提交更新，团队成员自动同步 下一步
完善 THEORY.md：
定义所有动能理论概念 指定买卖点触发条件 配置所有阈值和参数
测试数据获取：
python3 scripts/fetch_btc_data.py --symbol BTC-USDT --timeframes 1h --limit 10
验证指标计算：
对比 Python 计算结果与 TradingView 确保 EMA26/52 和 MACD 数值一致
完整分析测试：
运行完整分析流程 检查报告格式和内容 根据实际交易经验调整 THEORY.md
重要提示：本 Skill 的核心是 THEORY.md，请务必完整填写该文件中的所有规则和定义。Skill 会严格按照你定义的理论进行分析，不会添加任何主观判断。