5minbtc

name	5minbtc
version	5.9.0
description	BTC 5分钟K线实时方向预测。v5.9对抗式审查重构: 13因子收敛到3个有证据信号(half_body延续+volume放量+meanrev回归, 11个47-49%硬币因子清零) + 三层独立信息过滤(多周期4h/1h/15m趋势 + 跨资产ETH/SOL广度 + 真订单流OFI) + 移除bull×0.92惩罚/Platt置信度门控。半K线策略第2分钟执行。黑天鹅防护: ATR spike+FNG<25。Binance端点双向故障切换。
triggers	["5minbtc","5min btc","btc 5min"]
tools	["terminal","web"]

5minbtc — BTC 5分钟实时预测 v5.9.0

BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。 SKILL.md 是索引, 详细内容见 references/。 v5.9 核心转变: 从"13因子预测器"→"3信号错价检测器"(见 对抗式审查报告)

触发

5minbtc / 5min btc / btc 5min / 监控 (配合持续盯盘)

何时使用

场景	做法
当前 5min K线 方向+价位	✅ 标准流程, 有真实 edge (v5.8 回测 61-70%)
会话内持续盯盘, 等明确信号	✅ 监控模式 (scripts/5minbtc-monitor.py + Monitor 工具)
币安预测市场 Up/Down 5m 交易	✅ paper 模拟/实时监控 (见 预测市场策略)
"今晚 BTC 涨跌" (宽窗口)	⚠️ 跑当前 K线 + 给方向倾向, 标注"超出引擎置信区间"
"下根 K线" / "1小时后"	引导在该 K线 起始时间再触发

监控模式 (Claude Code)

详见 monitoring-claude-code.md

# 无限持续, 直到用户喊停 (会话内盯盘推荐)
Monitor(command: "python3 <SKILL>/scripts/5minbtc-monitor.py --max-runs 0", persistent: true)

# 默认 20 次采样 (约 40 分钟)
python3 <SKILL>/scripts/5minbtc-monitor.py

# 单次判断 (非持续)
python3 <SKILL>/scripts/5minbtc-monitor.py --dry-run

• 明确信号 = bias 非中性 + strength∈{medium,moderate,strong} + conf≥50 → 自动停 (⚠️ 实测引擎 strength 输出 medium, 判定集合需同时含 medium 和 moderate)
• 每根 K 线第 2/3 分钟采样 (progress ~40-70%), 比 cron 第 4 分钟更早
• 事件流: START / DIR-CHANGE / CLEAR-SIGNAL / ENGINE-ERR / MAX-RUNS
• 停止: 用户说「停/结束」→ TaskStop 停 Monitor
• CLEAR-SIGNAL 后必须拉一次完整引擎快照二次确认
• 引擎验证: python3 -m pytest scripts/test_engine_v58.py -v (12 项)

快速开始

SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc

# 1. 并行: 引擎 + 新闻 + settle (前一根)
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1
python3 $SKILL_DIR/5minbtc-engine-v5.7.py 2>&1
python3 $SKILL_DIR/5minbtc-news.py 2>&1

# 2. 3 路 web_search (并行)
# "Bitcoin BTC breaking news price" / "crypto market macro stocks today" / "比特币 BTC 最新 晚间"

# 3. LLM 分析 → 输出 (见 output-template.md)
# 4. 写日志
python3 $SKILL_DIR/5minbtc-log.py log \
  "<candle.iso>" <pred_close> <pred_high> <pred_low> \
  <conf> <bias> <news_sent> <vol_pct>

架构 (1 行/组件)

• 引擎 5minbtc-engine-v5.7.py (v5.9): 3信号方向判断(half_body延续1.2 + volume放量0.8 + meanrev回归0.3) + 三层独立过滤(多周期4h/1h/15m + 跨资产ETH/SOL + 真订单流OFI) + 9路并行HTTP
• 订单流 scripts/ofi_feed.py: trade+bookTicker 组合流 tick规则推断主动买卖, 写 ~/bb-auto/ofi.json (launchd: com.daniel.ofi-feed)
• 日志 5minbtc-log.py: jsonl 追加 + 增量 settle (写入 logs/)
• 新闻 5minbtc-news.py: CoinDesk RSS (唯一稳定源, ~14min 延迟)
• LLM: 因子打分基准 + LLM 综合裁决 + 模板输出

铁律

1. 每次必须重新执行引擎脚本 — 不缓存
2. 每次必须重新搜索3组新闻
3. 先 settle 上一根, 再 log 新预测
4. LLM 可微调引擎的 bias/pred_close/range, 但必须说明理由
5. 输出 15-25 行 (平衡深度和 Telegram 可读性)

关键裁决规则 (LLM 决策时必查, 详见 output-template.md)

• half_body vs imbalance 冲突 (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body
• TREND 强趋势 decel 约束 (v5.7.4): EMA delta>$100 时 |decel|>0.7 需 |half_body|>0.15 同向确认
• fatigue≥0.8: conf 上限 40, 反向 +10pp
• chainlink_offset 矛盾: bias=bull 但 pred_close<current → 以 current 为锚 ±ATR×0.3
• 极端进度 (>80%): pred_close 按剩余时间比例缩放
• Body=0 持续模式: pred_close → current ± ATR×0.2, conf 降至 35-42%

性能快照 (2026-07-05)

• v5.7.1 实盘 273 轮方向 75.7% (v4.x 62.5%, +13.2pp)
• v5.8 回测: 前2根 1min=61.4%, 前4根=69.5% (半 K线延续性)
• 当前 cron: zai/glm-5.2 (8-15s/次) | opencaio 实测 MiniMax-M3 ~2.7s 可作更快选项

📚 引用索引 (references/)

核心方法论

• strategy-adversarial-review.md — 对抗式审查报告: 第一性原理 + 13因子证伪 + 该留/删/缺失 + P0/P1/P2行动清单 (v5.9 依据)
• lessons.md — 25 条核心教训 (必读, 含 2026-07-05 新增 23-25)
• pitfalls.md — 17 条 pitfalls 集中索引 (必读, 含并行 max() 评估陷阱)
• changelog.md — v5.0 ~ v5.7.4 详细变更
• architecture.md — 引擎架构 + 因子模型 + v5.0 升级路线图
• skill-organization.md — Skill 文件结构模式 (可复用) — SKILL.md INDEX + references/ 分专题

执行与输出

• execution.md — 完整执行步骤 + 铁律 + 宽窗口处理
• output-template.md — LLM 输出模板 + 裁决规则
• monitoring-claude-code.md — 监控模式: Monitor 工具集成 + 事件协议
• prediction-trading-cli.md — 币安预测交易 CLI: 5minbtc_trader.py 用法/参数/安全契约/API端点 (含 --paper/--paper-monitor 模拟)
• prediction-market-strategy.md — 预测市场盈利策略: EV=p−P, 价格门控, 凯利仓位, paper 模拟

数据源 & 网络

• news-sources.md — 新闻源评估 (清理后只剩 CoinDesk)
• binance-api-geo.md — Binance 端点区域问题
• binance-endpoint-flapping.md — 端点双向故障切换
• high-latency-network-handling.md — 高延迟网络处理 (SSL 超时)
• polymarket-data-source.md — Polymarket 结算源 (Chainlink)

引擎专项

• engine-parallelization-v573.md — v5.7.3 HTTP 并行化 + positional arg 陷阱
• black-swan-defense-v571.md — v5.7.1 黑天鹅防护 (ATR+FNG+news)
• decel-collapse-pattern.md — decel 极值崩塌 = V反完成
• cron-llm-provider-failure.md — Cron LLM Provider 失效诊断
• cron-setup.md — Cron Job 配置 + 版本同步
• dreaming-cron-recovery.md — Dreaming Cron 恢复

回测 & 复盘

• backtest-findings.md — 365 天回测深度复盘 + 因子无预测力
• backtest-v58-1min-findings.md — v5.8 真实 1min 半 K线回测
• review-procedure.md — 每日复盘流程 + 数据质量检查
• performance-history.md — 273 笔全量战绩 + 引擎迭代对比

单次 session 记录

• session-2026-06-17.md — 5 轮实时预测, v5.7.2 验证
• session-2026-06-18.md — 00:10 mispredict 复盘 → v5.7.4 规则

数据采集 & 仓库

• daily-stock-analysis-data-sources.md — daily_stock_analysis 17-fetcher 评估
• sync-procedure.md — AGI-Super-Team 同步流程
• quant-knowledge-index.md — 50 轮蒸馏知识库索引

复盘记录 (reviews/)

按月归档:

reviews/
├── 2026-05/  (6 份: review-2026-05-05.md, 24, 25, 27, 27-backtest, 29)
├── 2026-06/  (15 份: 03, 06, 09, 12, 14, 15, 16, 17, 18, 19, 21, 23, 24, 27, 28)
└── 2026-07/  (2 份: 01, 02)

报告库

14 份深度蒸馏报告在 reports/ 目录 (也同步在 AGI-Super-Team): R01-R14。

仓库同步

详见 sync-procedure.md。简述:

rsync -av --exclude='data/' --exclude='__pycache__/' \
  --exclude='*.jsonl' --exclude='*.jsonl.*' --exclude='*.gz' \
  /home/aa/.hermes/profiles/cqo/skills/5minbtc/ \
  /home/aa/clawd/repos/AGI-Super-Team/skills/5minbtc/
cd /home/aa/clawd/repos/AGI-Super-Team
git add skills/5minbtc/ && git commit -m "sync(skills/5minbtc): <版本>" && git push origin master

回测系统

backtest/
├── fetch_data.py            # Binance 历史数据下载
├── run_backtest.py          # v5.6 回测 (因子无预测力, 公平回测)
├── run_backtest_v57.py      # v5.7 回测 (含前视偏差, 已知)
├── run_backtest_v58.py      # v5.8 回测 (真实 1min 半 K线, 零前视) ← 推荐
├── run.sh                   # 一键运行
├── data/                    # 5min (105K) + 1min (259K) K线
└── results/                 # 回测结果 (gitignore)

文件结构

5minbtc/
├── SKILL.md                      # 本文件 (~170 行 INDEX)
├── 5minbtc-engine-v5.7.py        # 主引擎 (v5.7.4 规则, cron 调用)
├── 5minbtc-news.py               # 新闻扫描 (CoinDesk RSS, 唯一稳定源)
├── 5minbtc-log.py                # 日志记录 (写入 logs/)
├── archive/                      # 归档
│   └── engines/
│       └── 5minbtc-engine-v5.py  # v5 旧版 (回测因子模块 import)
├── logs/                         # 日志输出
│   ├── 5minbtc-log.jsonl         # 当前活跃 (cron 写入)
│   ├── 5minbtc-log.jsonl.1       # 最新备份
│   └── 5minbtc-log.jsonl.{2..22}.gz  # 历史归档
├── reviews/                      # 每日复盘 (按月归档)
│   ├── 2026-05/  (6 份)
│   ├── 2026-06/  (15 份)
│   └── 2026-07/  (2 份)
├── references/                   # 26 份专项 ref (含 skill-organization 模式)
├── backtest/                     # 回测系统
├── data/                         # 运行时 (news-risk-level.json 等)
├── scripts/                      # 复盘/监控/交易脚本
│   ├── 5minbtc-monitor.py        # ★ 监控脚本 (Claude Code Monitor 集成, v1.0)
│   ├── 5minbtc_watch.py          # ★ Telegram 推送监控 daemon (事件驱动+预测记录+收盘结算)
│   ├── 5minbtc_day_stats.py      # 预测战绩查询 (今日/历史, --push 推送)
│   ├── 5minbtc_trader.py         # ★ 币安预测交易桥接 (--once/--loop/--monitor/--paper/--paper-monitor)
│   ├── prediction_ws_feed.py     # 币安 w3w-prediction WS 实时价源 (<200ms)
│   ├── ofi_feed.py               # ★ 真订单流采集 (trade+bookTicker tick规则, launchd com.daniel.ofi-feed)
│   ├── 5minbtc_keyless_paper.py  # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价)
│   ├── telegram_push.py          # 通用 Telegram 推送助手
│   ├── daily-review-stats.py
│   └── fetch-github-repo.sh
14. 🔴 高延迟网络 — 引擎timeout临时修补 (2026-06-24)
15. 🔴 Web搜索不可用时的降级策略
16. 🔴 并行工具调用延迟评估 = max() not sum() (2026-07-05)
17. 🔴 SKILL.md 维护: 定期重构为 INDEX 风格 (2026-07-05)

---
最后更新: 2026-07-05 — 清理 news.py 死代码 (-54%) + SKILL.md 重构为 INDEX (-82%) + logs/reviews 归档 + 25 条教训