Run any Skill in Manus with one click

5minbtc

Stars73

Forks16

UpdatedJune 17, 2026 at 15:07

BTC 5分钟K线实时方向预测。v5.7.2半K线策略——第2分钟执行(progress~40%)，12正交因子含half_body实体延续+momentum/decel冲突降权+V反转+放量突破+Chainlink价格对齐+Platt Scaling+Bull惩罚。ATR乘数x0.55。黑天鹅防护: ATR spike+FNG<25过滤+新闻冲击熔断。v5.7.2冲突裁决: half_body vs imbalance/microprice(已验证2次实盘)+fatigue≥0.8均值回归预警。Binance端点双向故障切换。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

aAAaqwq

aAAaqwq/AGI-Super-Team

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Data ScientistsComputer and Mathematical Occupations·SOC 15-2051

File Explorer

57 files

SKILL.md

readonly

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

最后更新: 2026-05-28 v5.7 半K线策略

v5.7 变更 (2026-05-28)

核心策略变更: 在K线第4分钟执行(progress~80%)，利用前半根K线实体方向确认延续

设计思路(Daniel提出): 实盘66%准确率的edge来自"确认当前K线已有走势"(progress=0.9+)，v5.7把这个隐性优势显性化。

变更项	详情	效果
S1 `half_body_momentum()`	新因子，progress≥0.45时激活，ATR归一化实体+tanh压缩	将实盘edge显性建模
S2 ATR乘数×0.55	pred_close乘数 0.20/0.12→0.11/0.066	只预测剩余~2.5分钟
S3 half_range缩窄	0.65→0.40	区间更紧凑
Cron调度	第2分钟执行(`2,7,12...`)	progress~40%，前2根1min构建半K线
`BASE_W['half_body']=1.2`	所有因子中最高权重	核心edge因子
`REGIME_ADJ` 更新	所有4个regime添加half_body权重	regime-aware调整

half_body_momentum() 关键设计:

激活阈值: progress≥0.45 (给K线足够时间形成实体)
进度加权: min(1.0, (progress-0.3)/0.7) — 0.45→0.2, 0.8→0.71, 1.0→1.0
ATR归一化: body/ATR → tanh(×2.0) → [-1, 1]
progress<0.45时返回0.0 (不干扰其他因子)

v5.8 回测方法论突破 (2026-05-28)

关键改进: 用真实1分钟K线构建半K线状态，零前视偏差

之前v5.7回测用 (open+actual_close)/2 模拟中点→71.2%但含前视偏差；用前一根5min body→48.1%无预测力。 正确方法(Daniel提出): 用对应5min K线的前2-3根真实1分钟K线的OHLCV构建半程状态。

回测结果(半年, 27,237轮方向性):

前1根1min (20%)	前2根 (40%)	前3根 (60%)	前4根 (80%)	前5根 (100%)
56.7%	61.4%	65.8%	69.5%	76.1%

核心发现:

半K线延续性是真正的alpha来源 — 越接近完成越准，近似线性增长
前2根(当前cron配置): 27,237轮→61.4%, edge +11.4pp, 最长连胜22
half_body因子方向准确率仅48.5% — alpha不在因子本身，在于触发了更紧的ATR阈值
volume是唯一有独立预测力的因子(56-58%)，其他因子全部49-51%
之前的实盘66%准确率谜团已解开 — 就是半K线延续性效应

回测文件: backtest/run_backtest_v58.py (数据: backtest/data/btcusdt_1m.json, 259k根) 用法: python3 run_backtest_v58.py --fast --compare 或 --half 3 (前3根1min)

v5.6 变更 (2026-05-27)

基于3次方向错误深度复盘的4项修复（已实施验证）：

修复项	变更	根因
R1 momentum/decel冲突检测	\|mom\|>0.7且\|decel\|>0.8且方向相反时，动态降权mom 1.0→0.4, 升权decel 0.7→0.9	V型反转点momentum锁定错误方向
R2 V型反转因子	`v_reversal_detect()` 检测低点抬高模式 [-1,1], BASE_W=0.8	捕捉结构性的反转信号
R3 放量突破因子	`vol_breakout_signal()` 用最近3根完整K线的最大量K线方向 [-1,1], BASE_W=0.4	避免未完成K线的量价误导
R4 Chainlink价格对齐	`fetch_chainlink_ref()` Coinbase BTC-USD作参考，自动补偿Binance偏移	Polymarket结算价≠Binance价格

关键代码模式：

冲突降权用saved_base模式: saved_base = BASE_W.copy() → 临时改权重 → combine_factors() → BASE_W.update(saved_base) 恢复。避免跨调用污染全局权重。
Chainlink偏移安全边界: |offset|>300时不补偿（防止API异常导致预测价飞出合理范围）
V反转用已完成K线: 取 candles[-4:-1]（最近3根完成K线），不用当前未完成K线
输出新增字段: chainlink_offset 追踪每次偏移量, v_reversal/vol_breakout 因子值

v5.5 变更 (2026-05-26)

基于120轮v5.4实战复盘的4项优化：

优先级	修复项	变更	影响
P0-1	置信度校准	`40+abs(score)` → Platt Scaling sigmoid	conf与准确率正相关
P0-2	新闻因子	98% NEUTRAL死代码，保留扫描给LLM	减少噪声
P1-1	Bull bias	score>0时×0.92衰减	bear 70.2% > bull 65.4%修正
P1-2	高vol惩罚	HIGH_VOL 0.6→0.45	放量准确率更低

附加优化：

neutral区收缩 [-2,2]→[-1,1]，减少无信息预测
置信度上限 80→85，让强信号有区分度
calibrate_confidence() 独立函数，midpoint=15, steepness=0.10

概述

对当前5min K线做方向判断和收盘预测。架构：引擎脚本算指标+给基准建议，LLM做综合分析+微调+完整输出。

铁律

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

⚠️ Pitfalls

Binance API 端点选择与故障切换

三层端点策略（按优先级）：

优先级	端点	场景	状态
1	`api.binance.us`	通用首选（低延迟网络稳定；2026-06-17间歇超时）	⚠️
2	`data-api.binance.vision`	备选（低延迟可用，高延迟SSL超时；2026-06-17反向可用）	⚠️
3	`api.binance.com`	仅供非中国大陆网络	❌ 中国大陆451

高延迟网络下的已知问题：

当 ping 8.8.8.8 >250ms 时，data-api.binance.vision 的 SSL 握手经常超时（Python urlopen timeout=10 不够）
api.binance.us 在此类网络下仍然可用
双向故障切换 (2026-06-17): api.binance.us 也可能间歇性超时（URLError: timed out），此时 data-api.binance.vision 反而可用。两个端点都可能出问题，故障切换必须是双向的——哪个通就用哪个，不要假设某一端总是稳定
详见 references/binance-api-geo.md

引擎 + 日志模块端点快速切换（双向故障切换，两个方向都要支持）：

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

# 方向A: 切换到 api.binance.us (当 data-api 不可用时)
sed -i 's|BINANCE_KLINES = .*|BINANCE_KLINES = "https://api.binance.us/api/v3/klines"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|BINANCE_DEPTH = .*|BINANCE_DEPTH = "https://api.binance.us/api/v3/depth"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|data-api.binance.vision|api.binance.us|g' $SKILL_DIR/5minbtc-log.py

# 方向B: 切换到 data-api.binance.vision (当 api.binance.us 不可用时)
sed -i 's|BINANCE_KLINES = .*|BINANCE_KLINES = "https://data-api.binance.vision/api/v3/klines"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|BINANCE_DEPTH = .*|BINANCE_DEPTH = "https://data-api.binance.vision/api/v3/depth"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|api.binance.us|data-api.binance.vision|g' $SKILL_DIR/5minbtc-log.py

# 验证
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1 | head -3

验证命令:

# 快速测试哪个端点可用
for ep in "api.binance.us" "data-api.binance.vision"; do
  code=$(curl -s --connect-timeout 10 --max-time 15 -o /dev/null -w "%{http_code}" "https://$ep/api/v3/klines?symbol=BTCUSDT&interval=5m&limit=1")
  echo "$ep → HTTP $code"
done

路径硬编码

不要用 WORKSPACE = dirname(dirname(dirname(...))) 指向旧 OpenClaw workspace。用 SKILL_DIR = os.path.dirname(os.path.abspath(__file__))。

全局字典临时修改模式

当需要临时修改 BASE_W / REGIME_ADJ 等模块级字典做单次计算时，必须用 saved_base 模式：

saved_base = BASE_W.copy()
BASE_W['momentum'] = 0.4  # 临时修改
raw = combine_factors(factors, regime)
BASE_W.update(saved_base)  # 立即恢复

不要直接修改后不恢复——Python 模块级字典是全局可变的，下次调用会读到脏数据。

🔴 CRITICAL: 回测证明因子无预测力，但半K线延续性有真实edge (2026-05-28更新)

365天105,120根K线回测（backtest/目录）揭示的真相：

v5.6纯价格因子(开盘预测):

模式	当前K线数据	方向准确率	本质
historical_only	屏蔽	47.4%	低于随机50%
fair_live_sim	屏蔽	48.8%	等于随机
full_lookahead	含close	61.1%	前视偏差
实盘 (298轮)	progress=0.9+	66.1%	间接前视

v5.8真实1min半K线回测(零前视偏差):

前2根1min(40%进度)	前3根(60%)	前4根(80%)
61.4% (+11.4pp)	65.8% (+15.8pp)	69.5% (+19.5pp)

结论更新:

11个技术因子(momentum/RSI/meanrev等)在5分钟尺度上确实无预测力(49-51%)
volume因子是唯一有独立alpha的(56-58%)
但半K线延续性效应是真实的alpha — 用真实1min K线构建半K线状态后，准确率61-70%
实盘66%的谜团已解开: 不是前视偏差，是价格动量延续性
half_body因子的贡献机制: 不是因子本身有方向预测力(48.5%)，而是它触发了更紧的ATR阈值，让延续性效应更好地转化为预测区间

回测方法论教训: 模拟半K线状态时，绝不能用 (open+actual_close)/2(前视偏差)或前一根5min body(太粗糙)。必须用对应时间段的真实1分钟K线数据。详见 backtest/run_backtest_v58.py。

🔴 Python 3.11 Unicode Strictness in Engine Source Files

Python 3.11.15 (uv cpython build) rejects any non-ASCII character in .py files — not just in code, but in comments and docstrings too. This includes:

Full-width punctuation: ，：；（）！？、。 → must use ASCII ,;:()!?.,
Math symbols: ≤ ≥ × ÷ ± ★ → <= >= * / +- *
Arrows/dashes: → ← ∞ — – → > < inf -- -
Smart quotes: ' ' " " → ' "
Tilde as "approximately" before decimals: ~2.5 → Python parses ~ as bitwise NOT, giving "invalid decimal literal"
Hidden Unicode quotes: Three """ that look correct but contain Unicode left/right double quotes (U+201C/U+201D) instead of ASCII 0x22 — causes "unterminated triple-quoted string"

Fix strategy (in order):

sed -i or Python script for bulk replacements of known character classes
Regex: insert space between CJK chars and operators/digits (CJK+* → CJK + *)
If still failing, use xxd or hexdump to inspect the raw bytes around the error line
Nuclear option: strip ALL non-CJK non-ASCII with content = ''.join(c if ord(c) < 128 or 0x4E00 <= ord(c) <= 0x9FFF else '<REPLACED>' for c in content)

Prevention: When writing Chinese comments/docstrings in engine .py files, never mix full-width punctuation or math symbols. Use ASCII punctuation only.

Cron Job 版本同步

升级引擎后必须同步更新 cron job 的 name 字段（如 "5minbtc v5.6"）。cron 不自动感知引擎文件版本——它只执行 5minbtc-engine-v5.py，文件内容变了 cron 就跑新代码，但 job name 仍是旧标签，导致复盘时混淆实际运行的引擎版本。操作: 每次 engine 升级后，执行 cronjob(action='update', job_id=..., name='5minbtc vX.Y')。

执行步骤

Step 1: 并行启动（5个调用同时发出）

并行组:
├── exec: settle-all + 引擎脚本 + 新闻扫描（合并一条命令）
├── web_search: "Bitcoin BTC breaking news price" count=3 freshness=day
├── web_search: "crypto market macro stocks today" count=3 freshness=day
└── web_search: "比特币 BTC 最新 晚间" count=3 freshness=day

搜索优化: 3组通用搜索经常返回首页/目录页而非具体新闻。如果初始结果不具体，立即追加1-2组上下文定制搜索：

用引擎当前价格方向："Bitcoin BTC price [rise/drop/crash] today [当前日期]"
用新闻扫描发现的关键事件："BTC [事件关键词] crypto impact [月份] [年份]"
这组搜索在引擎执行后、LLM分析前发起，延迟<30秒但信息价值显著提升

引擎命令（绝对路径）：

SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1; \
  echo "---ENGINE---"; \
  python3 $SKILL_DIR/5minbtc-engine-v5.7.py 2>&1; \
  echo "---NEWS---"; \
  python3 $SKILL_DIR/5minbtc-news.py 2>&1

新闻扫描会自动更新 data/news-risk-level.json（结构化情绪+风险等级），供Step 2使用。

Step 2: LLM完整分析（参考引擎数据，不是机械填模板）

LLM收到引擎JSON后，必须：

A. 验收上一根K线（从settle输出）

显示：K线时间、预测 vs 实际、误差、方向✅/❌、区间✅/❌
1句偏差复盘

B. 综合判断方向（引擎给基准，LLM最终决定）

引擎的bias/strength是参考起点，不是最终答案
读取 data/news-risk-level.json 获取结构化新闻情绪
LLM必须考虑引擎忽略的因素：
- 超卖/超买后的反转概率
- BB下轨/上轨的支撑/阻力效应
- 连续阴/阳线后的疲劳
- 🔴 fatigue≥0.8均值回归预警: 连续下跌/上涨后市场疲劳→反转概率显著升高。即使全因子同向，也必须将confidence上限压至40，并提升反向情景概率至少10pp
- K线形态（十字星、锤子线、吞没等）
- 新闻方向的权重调整
如果LLM调整了引擎方向，必须说明理由
half_body vs imbalance/microprice 冲突裁决 (v5.7.2): 当 half_body 与 imbalance/microprice 方向相反时，优先 half_body。原因——imbalance 和 microprice 基于已完成K线的 orderbook 快照（滞后），而 half_body 反映当前半K线的实时价格动量（即时）。实盘验证: 2026-06-04 引擎因 imbalance=-0.82/microprice=-0.82 判 bear weak，但半K线实体+$376 (half_body=+0.35) 是明确 bull 信号——实盘收涨✅；2026-06-17 引擎因 imbalance=+0.99/microprice=+0.99 判 bull weak，但半K线实体-$82 (half_body=-0.41) + MACD转负是明确 bear 信号——实盘收跌✅。两次验证均证明: 已完成K线的 orderbook 因子在K线初段是滞后指标，半K线实时动量是即时指标。裁决条件: |half_body|>0.25 且 |imbalance|>0.5 且方向冲突时触发

C. 微调预测价（引擎给基准，LLM微调±ATR*0.3以内）

引擎pred_close是数学基准
LLM可基于K线形态、新闻、超卖反弹等调整
调整幅度不超过ATR*0.3

D. 完整输出（包含技术分析逻辑，不是只列数字）

Step 3: 记录日志

SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py log \
  "<engine.candle.iso>" \
  <final_pred_close> \
  <final_pred_high> \
  <final_pred_low> \
  <confidence> \
  <final_bias> \
  <news_sentiment> \
  <engine.indicators.vol_pct>

输出模板

✅ 验收: [上次K线时间] pred=$XX,XXX actual=$XX,XXX err=±$XX (±X.XX%) dir✅/❌ rng✅/❌
[1句复盘]

📈 BTC 5min 实时预测 @ HH:MM:SS
当前K线: HH:MM→HH:MM | ⏱ XX.X% (剩XmXs)
实时价: $XX,XXX | O=XX,XXX H=XX,XXX L=XX,XXX C=XX,XXX (body ±$XX)
---
📰 今日关键新闻 [结构化信号: 🟢BULLISH/🟡NEUTRAL/🔴BEARISH | 风险: LOW_RISK/NORMAL/ELEVATED/HIGH_VOL]:
- 🟢 [新闻1] — 影响
- 🟡 [新闻2] — 影响
- 🔴 [新闻3] — 影响
新闻净效应: 🟢/🟡/🔴 [原因] | 结构化: [news-risk-level.json sentiment]

🧭 方向: 📈/📉 [bull/bear] [strong/medium/weak] | 依据: [2-3个关键指标+新闻]
- 引擎基准: [engine bias/strength] → LLM调整: [如有调整写理由，无则写"确认引擎判断"]
- EMA9=$XX,XXX / EMA21=$XX,XXX (Δ±$XX)
- RSI=XX.X [超买/超卖/中性]
- MACD=XX.X / Signal=XX.X (Hist=XX.X)
- BB: $XX,XXX / $XX,XXX / $XX,XXX [价格位置]
- ATR=$XX.X | Vol=XX% of avg [放量/缩量/正常]

[2-3句核心分析：结合技术+新闻+K线形态的综合判断]

---
🎯 收盘预测:
| 情景 | 目标区间 | 概率 |
|------|---------|------|
| [主要情景] | $XX,XXX-$XX,XXX | XX% ← |
| [次要情景] | $XX,XXX-$XX,XXX | XX% |

**开盘$XX,XXX → 预测$XX,XXX** (±$XX, ±X.XX%) → 📈/📉

> [1句关键备注]

引擎JSON结构（LLM直接读取）

v5.6输出示例（实际字段名）：

{
  "version": "5.6",
  "candle": {"now":"22:10:26","candle_start":"22:10","candle_end":"22:15","progress_pct":8.9,"remaining_sec":273,"iso":"..."},
  "price": {"current":74978.01,"open":75020.0,"high":75037.42,"low":74950.64,"body":-42,"body_pct":-0.056},
  "recent_candles": [{"O":75000,"H":75102,"L":74928,"C":75073}, ...],
  "indicators": {
    "ema9":75099.4, "ema21":75298.7, "ema_delta":-199.3,
    "rsi":32.5, "macd":-209.78, "macd_signal":-191.92, "macd_hist":-17.86,
    "bb_upper":76060.4, "bb_mid":75357.1, "bb_lower":74653.9,
    "atr":155.6, "vol_pct":19.0
  },
  "fng": {"value":25, "label":"Extreme Fear"},
  "factors": {
    "momentum": -0.968, "meanrev": 0.431, "rsi": -0.351,
    "volume": 0.25, "fatigue": 0, "imbalance": 0.234,
    "microprice": 0.246, "decel": 1.0, "position": 0.798,
    "v_reversal": 0, "vol_breakout": 0
  },
  "regime": "TREND",
  "chainlink_offset": -152,
  "prediction": {"bias":"bull","strength":"weak","confidence":45,"score":1,
                 "pred_close":74860,"pred_high":74954,"pred_low":74766}
}

v5.6新增字段说明:

chainlink_offset: Binance→Chainlink价格偏移（$），已自动补偿pred_close/high/low。LLM在输出末尾注明此偏移即可
fng: Fear & Greed Index，值为null时API不可用
factors.v_reversal: V型反转因子 [-1,1]，0=无反转信号
factors.vol_breakout: 放量突破因子 [-1,1]，0=无突破信号
atr_spike: ATR异常检测 {detected, ratio, consecutive} — v5.7.1 P0-1
fng_black_swan: bool — v5.7.1 P0-2: FNG<25时为True
news_risk: str — v5.7.1 P0-3: "NORMAL"/"BLACK_SWAN"/"CRITICAL"
black_swan_warning: str|null — v5.7.1 P0-3: 黑天鹅警告信息
price.body_pct: body百分比，正=阳线，负=阴线


## 复盘

```bash
SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py stats

新闻数据源

源	延迟	状态
CoinDesk	~14min	✅ RSS实时
Cointelegraph	~3min	⚠️ 需TG脚本（已降级为RSS fallback）
TreeNews	~120min	⚠️ 需TG脚本（已降级）

版本演进

版本	架构	方向准确率	关键变更
v3.1	线性打分(EMA+RSI+MACD+Vol)	64%	基础版，引擎+LLM混合
v3.5.1	+低vol衰减/VWAP因子	77%	最佳版本
v4.0	Hermes迁移	60.5%	路径适配，功能不变
v4.1	Phase1修复	目标70%+	过度自信压制+放量反转+bull修正+疲劳增强
v5.4	正交因子+Regime	68.1%(120r)	9正交因子+sigmoid+TREND dampening+meanrev反转
v5.5	+校准置信度	71.4%(28r)	Platt Scaling+Bull惩罚+高vol增强+neutral区收缩
v5.6	+冲突检测+V反转+Chainlink	66.1%(298r实盘) / 47.4%(105k回测)	mom/decel冲突降权+V反转因子+放量突破+Coinbase价格对齐。⚠️ 实盘edge来自前视偏差(progress=0.9+)，公平回测无预测力
v5.7	半K线策略+half_body因子	61.4%回测(前2min) / 69.5%(前4min)	第2分钟执行+half_body_momentum因子(BASE_W=1.2)+ATR×0.55+half_range 0.40。v5.8回测用真实1min K线证实半K线延续性有真实edge(+11.4~+19.5pp)
v5.7.1	+黑天鹅防护	72.0% (100r实盘) / 61.4%回测(V8)	P0-1: ATR spike检测(1.5x阈值+连续3根→regime强制HIGH_VOL+conf减半) / P0-2: FNG<25极端恐惧过滤(v_reversal×0.5+decel×0.7) / P0-3: news_risk circuit breaker(BLACK_SWAN/CRITICAL→neutral+conf=30)。2026-05-28美伊空袭复盘驱动。6月实盘100轮方向83.0%: 06-03=79.2%(24r) → 06-06=90.9%(33r)🏆 → 06-09=88.9%(18r) → 06-12=68.0%(25r) 缩量(≤80% vol)方向≥95% ✅
v5.7.2	+imbalance冲突裁决+fatigue预警	2/2裁决验证✅	**half_body vs imbalance/microprice冲突裁决规则:

⚠️ 回测警示(2026-05-28更新): v5.6纯价格因子在开盘预测时准确率仅47-49%。但v5.8用真实1min K线构建半K线后，准确率61.4%(前2根)~69.5%(前4根)，证实半K线延续性有真实edge。half_body因子本身无方向预测力(48.5%)，其贡献在于触发更紧ATR阈值。详见 references/backtest-findings.md 和 backtest/run_backtest_v58.py。

全量复盘 (273笔结算, 截至2026-05-27)

日期	引擎	笔数	方向	区间	行情特征
05-05	v4.x	107	64.5%	55.1%	震荡+突破
05-06	v4.x	28	57.1%	71.4%	横盘
05-11	v4.x	12	66.7%	91.7%	小样本
05-12	v4.x	5	40.0%	60.0%	小样本最差
05-23	v5.4	37	64.9%	73.0%	v5.4首日
05-24	v5.4	30	73.3%	76.7%	-1.09%单边下跌🏆
05-25	v5.4	26	61.5%	88.5%	+0.43%震荡
05-27	v5.5	28	71.4%	75.0%	-0.78%震荡下跌
06-03	v5.7.1	24	79.2%	54.2%	-6.9%单边下跌, FNG=11
06-06	v5.7.1	33	90.9% 🏆	78.8%	缩量震荡, FNG=12~14
06-09	v5.7.1	18	88.9%	61.1%	16连胜, 缩量≤80%方向100%
06-12	v5.7.1	25	68.0%	40.0%	bear中量区44.4%溃败
06-14	v5.7.1	32	65.6%	53.1%	bear弱反弹盲区57.9%, 10连胜开局

引擎迭代对比:

v4.x (152轮): 方向 62.5% | Range 61.2%
v5.4 (93轮): 方向 66.7% | Range 78.5%
v5.5 (28轮): 方向 71.4% | Range 75.0%
v5.7.1 (100轮): 方向 83.0% (06-03: 79.2%, 06-06: 90.9%🏆, 06-09: 88.9%, 06-12: 68.0%, 06-14: 65.6%)
v5.x合计 (221轮): 方向 77.8% (+15.3pp vs v4)

核心教训

🔴 纯价格因子无预测力，但半K线延续性有真实edge — 11因子全部49-51%，但用真实1min K线构建半K线后准确率61-70%。edge来自价格动量延续，不是技术指标。回测时必须用真实1min数据，不能用模拟中点
半K线延续性是可利用的真实效应 — v5.8回测(27k轮)证实: 前2根1min=61.4%, 前4根=69.5%。越接近K线完成越准。实盘66%准确率已解释
过度自信是最致命问题 — conf≥60准确率56.8% < conf<60的65.4%，极端信号=行情末端
放量≠确认方向，放量=反转预警 — 放量(≥80%)准确率仅50%
bull偏向严重 — bull准确率57.3% < bear 63.4%，引擎过度解读EMA金叉
线性打分是初学者错误 — 多个共线指标叠加不增加信息量
🔴 缩量场景(<50% vol) = 半K线策略最强edge — 2026-06-03实盘7/7 100%准确率 — 缩量意味着没有突发因素干扰半K线延续性，half_body因子在低vol市场中被锁定。这从v5.4时代"低vol微波动准确率最高"(66%)的观察，升级为半K线策略的核心优势。v5.8回测中volume因子是唯一有独立预测力的因子(56-58%)，与实盘互为印证。这条经验来自2026-06-03实盘复盘。
EMA在底部反弹期天然滞后 — VWAP因子部分修复
momentum/decel冲突时，decel通常是正确的 — 当 |momentum_tstat|>0.7 且 |decel|>0.8 且方向相反时，长期斜率锁定错误方向，短期反转才是真相（V型反转场景）
volume因子使用未完成K线判断方向是致命缺陷 — 预测时点candle仅完成60-70%，应改为用最近3根完整K线的量价关系
bear方向在中量区(40-80%)是v5.7.1最大盲区 (2026-06-12) — 缩量场景(<40%)和bull方向表现优异(87-100%)，但bear中量区准确率仅44.4%(低于随机)。趋势市场中的区间震荡导致半K线延续性失效。修复方向: bear中量区需增加额外确认规则(如连续2根同向半K线才出方向)
- 变体: 持续下跌后的弱反弹是bear方向另一盲区 (2026-06-14): 32轮方向65.6%，bear仅57.9%(11/19)。8次bear误判全部是"预测跌但实际涨" — 持续下跌后BTC出现弱反弹时，半K线延续性错误地将反弹视为继续下跌。21:00-22:00区间6次bear全部打脸。根因: 下跌半K线延续性过强，无法区分"延续下跌"vs"震荡筑底反弹"。修复方向: 连续3根以上bear完成K线+当前半K线收涨时，bear需降权或升至中立
imbalance/microprice 因子滞后于半K线实时动量 (v5.7.2) — 当当前半K线实体方向与 imbalance/microprice 冲突时，已完成K线的 orderbook 因子是滞后指标，半K线实时动量是即时指标。裁决: |half_body|>0.25 且 |imbalance|>0.5 时优先 half_body。2026-06-04 实盘: 引擎判 bear(imbalance=-0.82)，但半K线 bull 实体+$376 正确
周末低流动性放大误差 (2026-06-14): 周日(06-14)的MAE=0.045%与平日相当，但22:35出现了-0.22%的极端误差（pred=$64,020 actual=$63,880）。周末BTC波动率降低但偶发性价差放大，建议周末自行降低ATR乘数或减少预测频率
🔴 fatigue≥0.8 = 均值回归预警 (2026-06-17): 22:40 candle — 全因子bear共振(momentum=-0.85/imbalance=-0.73/MACD hist=-26.6/vol=3%)，LLM判bear medium，但实际收涨(+$87)。根因: fatigue=0.8表示连续下跌后市场疲劳，缩量环境下的均值回归概率显著升高。裁决规则: fatigue≥0.8时，即使全因子同向，也需将置信度上限压至40，并提升反向情景概率至少10pp。fatigue=0.8是本轮唯一反向信号，却被忽略，导致方向误判。与06-14 bear弱反弹盲区(教训11)的关联: 两者都是"连续下跌后的反弹"模式——06-14是半K线延续性过强无法区分筑底，06-17是fatigue信号被全因子压制。共同修复方向: 连续下跌≥3根K线后，需增加反弹确认机制

2026-06-03 复盘新增经验

v5.7.1首日实盘(6月3日): 24轮已结算，方向准确率79.2%(19/24)，区间54.2%(13/24)，MAE 0.106%。详见 review-2026-06-03.md。

5个方向误判的根因模式:

时间	引擎方向	实际方向	误差	vol	根因模式
20:04	bear	+0.30%	❌❌	163%	巨量开盘+冲突降权未完全覆盖
20:37	bear	+0.21%	❌❌	83%	开仓延迟: 20:36 bull→20:37 bear转多
20:54	bear	+0.16%	❌❌	34%	纯噪声区间: 缩量反向锁死
20:57	bull	-0.06%	❌❌	37%	量价背离: 缩量bear bull锁死
21:06	bull	-0.08%	❌❌	81%	Pattern A: momentum 15-candle OLS滞后
21:28	bull	-0.01%	❌❌	156%	缩量变放量+开仓末期反转

缩量场景(<50% vol)表现: 7/7方向100%准确率 — 半K线策略的核心优势区域。 FNG=11极端恐惧下表现: 黑天鹅防护正常激活，v_reversal×0.5+decel×0.7，但ATR正常+news=NORMAL未触发熔断 — 设计合理。

v5.0 升级路线图

详见 references/quant-knowledge-index.md 和 ~/.hermes/profiles/cqo/quant-knowledge/R12-integration-blueprint.md

v5.6 方向错误修复（✅ 已实施 2026-05-27）

基于2026-05-27深度复盘的3次方向错误分析，已全部落地到引擎代码：

优先级	修复项	状态	实现
R0	momentum/decel冲突检测	✅ `direction_rule_v5()`	saved_base模式动态降权mom→0.4, decel→0.9
R1	V型反转因子	✅ `v_reversal_detect()`	BASE_W=0.8, TREND/HIGH_VOL下加权至0.9/1.0
R2	放量突破因子	✅ `vol_breakout_signal()`	用最近3根完成K线，BASE_W=0.4
R3	Chainlink价格对齐	✅ `fetch_chainlink_ref()+run()`	Coinbase BTC-USD参考，偏移补偿上限±$300

案例复盘要点：

20:20巨量突破(vol=182%)：decel=+1.0正确预判反转，但mom=-0.98权重×1.0淹没反转信号 → R0冲突检测修复
20:25放量延续(vol=123%)：同上，momentum仍在消化15根K线的下跌斜率 → R0冲突检测修复
20:50低vol(vol=33%)：RANGE regime下meanrev权重放大推高bull，实际仅$2波动 → v5.5 neutral区收缩已覆盖

实时验证: 22:09 CST 运行恰好命中冲突场景(mom=-0.981, decel=+1.0)，输出bear conf=45% score=-1

P0 — 立即实施（回测验证后的修订优先级）

🔴 OFI微结构因子是唯一出路 — 回测证明纯价格因子无预测力。必须接入Binance WebSocket获取orderbook L2数据，实现OFI(Cont et al. 2014)和Stoikov microprice。学术文献R²=15-25%，是5分钟尺度唯一有实证支持的信号
新闻脉冲信号 — 突发事件(Big发布/SEC/ETF)可在5分钟内产生方向性冲击，作为互补信号
降低实盘仓位 — 在edge来源明确前，不应按66%胜率预期下注。实盘66%大概率是小样本+前视偏差的假象

P1 — 2-4周

Regime-aware仓位 (HMM检测)
LightGBM自动化因子筛选
CVaR动态止损

P2 — 1-2月

TFT多时间尺度模型 → 替代贝叶斯引擎
期权IV信号 (Deribit)
完整压力测试框架

关键数学升级

OFI (Cont et al. 2014) → 替代纯价格指标
Microprice (Stoikov 2018) → 替代 mid price
Kalman滤波 → 动态EMA权重
HMM Regime → 自适应仓位
GPD尾部 → 替代固定止损

参考文件

references/binance-api-geo.md — Binance API 区域封禁解决方案和迁移记录
references/quant-knowledge-index.md — 50轮蒸馏知识库索引(14份报告/~80KB)，含升级优先级
references/polymarket-data-source.md — Polymarket BTC价格结算源(Chainlink Data Streams)、与Binance价差分析、对预测引擎的影响
references/performance-history.md — 全量实战记录(273轮/8天)，按日详细数据+引擎迭代对比+3大错误模式归因
references/backtest-findings.md — 365天回测深度复盘：因子无预测力证据、前视偏差诊断、A/B三种模式对比、战略建议
references/session-2026-06-17.md — 2026-06-17 5轮实时预测: v5.7.2冲突裁决再验证(2/2)✅、fatigue≥0.8误判分析、Binance端点双向故障切换
references/dreaming-cron-recovery.md — Dreaming Cron故障恢复指南: 数据源不可用恢复步骤、验证命令、配置参考
references/backtest-v58-1min-findings.md — v5.8真实1min半K线回测：零前视偏差方法论、前2根1min=61.4%准确率、因子贡献分析、半K线延续性alpha证据

复盘记录文件

存放在 skill 目录根下，按日期命名：

review-2026-05-24.md — v5.4 单边下跌日复盘（方向73.3%）
review-2026-05-25.md — v5.4 震荡市复盘（Range 88.5%历史最佳，方向61.5%）
review-2026-05-27.md — v5.6 3次方向错误深度复盘 + 4项修复实施 + 8天273轮总战绩
review-2026-06-03.md — v5.7.1 首日24轮实盘复盘（方向79.2%, 缩量100%, 5个误判模式分析）
backtest/review-backtest-2026-05-27.md — 365天回测深度复盘 + 因子无预测力证据 + 前视偏差诊断

报告库

14份深度蒸馏报告存放在 reports/ 目录（也同步在 AGI-Super-Team 仓库）：

R01-R12：50轮蒸馏（因子理论、策略、DeFi、组合、ML、数据源、前沿研究、期权、微结构、风控、机构方法论、整合蓝图）
R13：准确率优化方案（178笔复盘后）
R14：引擎审计报告（顶尖量化审查，4个Critical修复→v5.0架构设计基础）

仓库同步

Skill已同步至 AGI-Super-Team 仓库 skills/5minbtc/。

# 1. rsync 本地最新版到共享仓库（排除运行时数据和日志）
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/

# 2. 提交推送
cd /home/aa/clawd/repos/AGI-Super-Team
git add skills/5minbtc/
git commit -m "sync(skills/5minbtc): <变更简述>"
git push origin master

Commit message 惯例: sync(skills/5minbtc): <版本> 全量同步 — 引擎+回测+复盘+参考文档

同步内容:

✅ 引擎 (5minbtc-engine*.py)、日志模块 (5minbtc-log.py)、新闻模块 (5minbtc-news.py)
✅ SKILL.md（含冲突裁决规则同步）
✅ backtest/（含脚本、结果JSON、README）
✅ references/（含黑天鹅防御、Dreaming恢复、Binance地理、性能历史）
✅ review-*.md 全量复盘记录
❌ data/、__pycache__/（运行时产物）
❌ *.jsonl、*.jsonl.*.gz（海量预测日志，按需同步）

同步前dry-run验证:

rsync -av --dry-run \
  --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/

推送前检查point: 确保不包含敏感数据（密钥、API凭证）、市场数据（data/）、海量日志（*.jsonl.gz）

回测系统

backtest/
├── fetch_data.py            # Binance历史数据下载器(分页+断点续传)
├── run_backtest.py          # v5.6回测引擎(导入v5.6因子模块, A/B三种模式)
├── run_backtest_v57.py      # v5.7回测(用模拟半K线，已证实有前视偏差问题)
├── run_backtest_v58.py      # v5.8回测(用真实1min K线构建半K线，零前视偏差) ← 推荐使用
├── run.sh                   # 一键运行(--fast/--sample/--days/--skip-fetch)
├── README.md                # 使用文档
├── data/
│   ├── btcusdt_5m.json      # 5分钟K线数据(105k根, 12MB)
│   └── btcusdt_1m.json      # 1分钟K线数据(259k根, 29MB) — v5.8回测用
└── results/                 # 回测结果(gitignore)

运行命令:

cd backtest && python3 run_backtest_v58.py --fast --compare — v5.8快速回测(推荐)
cd backtest && python3 run_backtest_v58.py --half 3 — 用前3根1min
cd backtest && python3 run_backtest_v58.py --days 180 --full-report — 完整半年报告

name	5minbtc
version	5.7.2
description	BTC 5分钟K线实时方向预测。v5.7.2半K线策略——第2分钟执行(progress~40%)，12正交因子含half_body实体延续+momentum/decel冲突降权+V反转+放量突破+Chainlink价格对齐+Platt Scaling+Bull惩罚。ATR乘数x0.55。黑天鹅防护: ATR spike+FNG<25过滤+新闻冲击熔断。v5.7.2冲突裁决: half_body vs imbalance/microprice(已验证2次实盘)+fatigue≥0.8均值回归预警。Binance端点双向故障切换。
triggers	["5minbtc","5min btc","btc 5min"]
tools	["terminal","web"]

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

最后更新: 2026-05-28 v5.7 半K线策略

v5.7 变更 (2026-05-28)

核心策略变更: 在K线第4分钟执行(progress~80%)，利用前半根K线实体方向确认延续

设计思路(Daniel提出): 实盘66%准确率的edge来自"确认当前K线已有走势"(progress=0.9+)，v5.7把这个隐性优势显性化。

变更项	详情	效果
S1 `half_body_momentum()`	新因子，progress≥0.45时激活，ATR归一化实体+tanh压缩	将实盘edge显性建模
S2 ATR乘数×0.55	pred_close乘数 0.20/0.12→0.11/0.066	只预测剩余~2.5分钟
S3 half_range缩窄	0.65→0.40	区间更紧凑
Cron调度	第2分钟执行(`2,7,12...`)	progress~40%，前2根1min构建半K线
`BASE_W['half_body']=1.2`	所有因子中最高权重	核心edge因子
`REGIME_ADJ` 更新	所有4个regime添加half_body权重	regime-aware调整

half_body_momentum() 关键设计:

激活阈值: progress≥0.45 (给K线足够时间形成实体)
进度加权: min(1.0, (progress-0.3)/0.7) — 0.45→0.2, 0.8→0.71, 1.0→1.0
ATR归一化: body/ATR → tanh(×2.0) → [-1, 1]
progress<0.45时返回0.0 (不干扰其他因子)

v5.8 回测方法论突破 (2026-05-28)

关键改进: 用真实1分钟K线构建半K线状态，零前视偏差

回测结果(半年, 27,237轮方向性):

前1根1min (20%)	前2根 (40%)	前3根 (60%)	前4根 (80%)	前5根 (100%)
56.7%	61.4%	65.8%	69.5%	76.1%

核心发现:

半K线延续性是真正的alpha来源 — 越接近完成越准，近似线性增长
前2根(当前cron配置): 27,237轮→61.4%, edge +11.4pp, 最长连胜22
half_body因子方向准确率仅48.5% — alpha不在因子本身，在于触发了更紧的ATR阈值
volume是唯一有独立预测力的因子(56-58%)，其他因子全部49-51%
之前的实盘66%准确率谜团已解开 — 就是半K线延续性效应

回测文件: backtest/run_backtest_v58.py (数据: backtest/data/btcusdt_1m.json, 259k根) 用法: python3 run_backtest_v58.py --fast --compare 或 --half 3 (前3根1min)

v5.6 变更 (2026-05-27)

基于3次方向错误深度复盘的4项修复（已实施验证）：

修复项	变更	根因
R1 momentum/decel冲突检测	\|mom\|>0.7且\|decel\|>0.8且方向相反时，动态降权mom 1.0→0.4, 升权decel 0.7→0.9	V型反转点momentum锁定错误方向
R2 V型反转因子	`v_reversal_detect()` 检测低点抬高模式 [-1,1], BASE_W=0.8	捕捉结构性的反转信号
R3 放量突破因子	`vol_breakout_signal()` 用最近3根完整K线的最大量K线方向 [-1,1], BASE_W=0.4	避免未完成K线的量价误导
R4 Chainlink价格对齐	`fetch_chainlink_ref()` Coinbase BTC-USD作参考，自动补偿Binance偏移	Polymarket结算价≠Binance价格

关键代码模式：

冲突降权用saved_base模式: saved_base = BASE_W.copy() → 临时改权重 → combine_factors() → BASE_W.update(saved_base) 恢复。避免跨调用污染全局权重。
Chainlink偏移安全边界: |offset|>300时不补偿（防止API异常导致预测价飞出合理范围）
V反转用已完成K线: 取 candles[-4:-1]（最近3根完成K线），不用当前未完成K线
输出新增字段: chainlink_offset 追踪每次偏移量, v_reversal/vol_breakout 因子值

v5.5 变更 (2026-05-26)

基于120轮v5.4实战复盘的4项优化：

优先级	修复项	变更	影响
P0-1	置信度校准	`40+abs(score)` → Platt Scaling sigmoid	conf与准确率正相关
P0-2	新闻因子	98% NEUTRAL死代码，保留扫描给LLM	减少噪声
P1-1	Bull bias	score>0时×0.92衰减	bear 70.2% > bull 65.4%修正
P1-2	高vol惩罚	HIGH_VOL 0.6→0.45	放量准确率更低

附加优化：

neutral区收缩 [-2,2]→[-1,1]，减少无信息预测
置信度上限 80→85，让强信号有区分度
calibrate_confidence() 独立函数，midpoint=15, steepness=0.10

概述

对当前5min K线做方向判断和收盘预测。架构：引擎脚本算指标+给基准建议，LLM做综合分析+微调+完整输出。

铁律

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

⚠️ Pitfalls

Binance API 端点选择与故障切换

三层端点策略（按优先级）：

优先级	端点	场景	状态
1	`api.binance.us`	通用首选（低延迟网络稳定；2026-06-17间歇超时）	⚠️
2	`data-api.binance.vision`	备选（低延迟可用，高延迟SSL超时；2026-06-17反向可用）	⚠️
3	`api.binance.com`	仅供非中国大陆网络	❌ 中国大陆451

高延迟网络下的已知问题：

当 ping 8.8.8.8 >250ms 时，data-api.binance.vision 的 SSL 握手经常超时（Python urlopen timeout=10 不够）
api.binance.us 在此类网络下仍然可用
双向故障切换 (2026-06-17): api.binance.us 也可能间歇性超时（URLError: timed out），此时 data-api.binance.vision 反而可用。两个端点都可能出问题，故障切换必须是双向的——哪个通就用哪个，不要假设某一端总是稳定
详见 references/binance-api-geo.md

引擎 + 日志模块端点快速切换（双向故障切换，两个方向都要支持）：

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

# 方向A: 切换到 api.binance.us (当 data-api 不可用时)
sed -i 's|BINANCE_KLINES = .*|BINANCE_KLINES = "https://api.binance.us/api/v3/klines"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|BINANCE_DEPTH = .*|BINANCE_DEPTH = "https://api.binance.us/api/v3/depth"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|data-api.binance.vision|api.binance.us|g' $SKILL_DIR/5minbtc-log.py

# 方向B: 切换到 data-api.binance.vision (当 api.binance.us 不可用时)
sed -i 's|BINANCE_KLINES = .*|BINANCE_KLINES = "https://data-api.binance.vision/api/v3/klines"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|BINANCE_DEPTH = .*|BINANCE_DEPTH = "https://data-api.binance.vision/api/v3/depth"|' $SKILL_DIR/5minbtc-engine-v5.7.py
sed -i 's|api.binance.us|data-api.binance.vision|g' $SKILL_DIR/5minbtc-log.py

# 验证
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1 | head -3

验证命令:

# 快速测试哪个端点可用
for ep in "api.binance.us" "data-api.binance.vision"; do
  code=$(curl -s --connect-timeout 10 --max-time 15 -o /dev/null -w "%{http_code}" "https://$ep/api/v3/klines?symbol=BTCUSDT&interval=5m&limit=1")
  echo "$ep → HTTP $code"
done

路径硬编码

不要用 WORKSPACE = dirname(dirname(dirname(...))) 指向旧 OpenClaw workspace。用 SKILL_DIR = os.path.dirname(os.path.abspath(__file__))。

全局字典临时修改模式

当需要临时修改 BASE_W / REGIME_ADJ 等模块级字典做单次计算时，必须用 saved_base 模式：

saved_base = BASE_W.copy()
BASE_W['momentum'] = 0.4  # 临时修改
raw = combine_factors(factors, regime)
BASE_W.update(saved_base)  # 立即恢复

不要直接修改后不恢复——Python 模块级字典是全局可变的，下次调用会读到脏数据。

🔴 CRITICAL: 回测证明因子无预测力，但半K线延续性有真实edge (2026-05-28更新)

365天105,120根K线回测（backtest/目录）揭示的真相：

v5.6纯价格因子(开盘预测):

模式	当前K线数据	方向准确率	本质
historical_only	屏蔽	47.4%	低于随机50%
fair_live_sim	屏蔽	48.8%	等于随机
full_lookahead	含close	61.1%	前视偏差
实盘 (298轮)	progress=0.9+	66.1%	间接前视

v5.8真实1min半K线回测(零前视偏差):

前2根1min(40%进度)	前3根(60%)	前4根(80%)
61.4% (+11.4pp)	65.8% (+15.8pp)	69.5% (+19.5pp)

结论更新:

11个技术因子(momentum/RSI/meanrev等)在5分钟尺度上确实无预测力(49-51%)
volume因子是唯一有独立alpha的(56-58%)
但半K线延续性效应是真实的alpha — 用真实1min K线构建半K线状态后，准确率61-70%
实盘66%的谜团已解开: 不是前视偏差，是价格动量延续性
half_body因子的贡献机制: 不是因子本身有方向预测力(48.5%)，而是它触发了更紧的ATR阈值，让延续性效应更好地转化为预测区间

🔴 Python 3.11 Unicode Strictness in Engine Source Files

Python 3.11.15 (uv cpython build) rejects any non-ASCII character in .py files — not just in code, but in comments and docstrings too. This includes:

Full-width punctuation: ，：；（）！？、。 → must use ASCII ,;:()!?.,
Math symbols: ≤ ≥ × ÷ ± ★ → <= >= * / +- *
Arrows/dashes: → ← ∞ — – → > < inf -- -
Smart quotes: ' ' " " → ' "
Tilde as "approximately" before decimals: ~2.5 → Python parses ~ as bitwise NOT, giving "invalid decimal literal"
Hidden Unicode quotes: Three """ that look correct but contain Unicode left/right double quotes (U+201C/U+201D) instead of ASCII 0x22 — causes "unterminated triple-quoted string"

Fix strategy (in order):

sed -i or Python script for bulk replacements of known character classes
Regex: insert space between CJK chars and operators/digits (CJK+* → CJK + *)
If still failing, use xxd or hexdump to inspect the raw bytes around the error line
Nuclear option: strip ALL non-CJK non-ASCII with content = ''.join(c if ord(c) < 128 or 0x4E00 <= ord(c) <= 0x9FFF else '<REPLACED>' for c in content)

Prevention: When writing Chinese comments/docstrings in engine .py files, never mix full-width punctuation or math symbols. Use ASCII punctuation only.

Cron Job 版本同步

执行步骤

Step 1: 并行启动（5个调用同时发出）

并行组:
├── exec: settle-all + 引擎脚本 + 新闻扫描（合并一条命令）
├── web_search: "Bitcoin BTC breaking news price" count=3 freshness=day
├── web_search: "crypto market macro stocks today" count=3 freshness=day
└── web_search: "比特币 BTC 最新 晚间" count=3 freshness=day

搜索优化: 3组通用搜索经常返回首页/目录页而非具体新闻。如果初始结果不具体，立即追加1-2组上下文定制搜索：

用引擎当前价格方向："Bitcoin BTC price [rise/drop/crash] today [当前日期]"
用新闻扫描发现的关键事件："BTC [事件关键词] crypto impact [月份] [年份]"
这组搜索在引擎执行后、LLM分析前发起，延迟<30秒但信息价值显著提升

引擎命令（绝对路径）：

SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1; \
  echo "---ENGINE---"; \
  python3 $SKILL_DIR/5minbtc-engine-v5.7.py 2>&1; \
  echo "---NEWS---"; \
  python3 $SKILL_DIR/5minbtc-news.py 2>&1

新闻扫描会自动更新 data/news-risk-level.json（结构化情绪+风险等级），供Step 2使用。

Step 2: LLM完整分析（参考引擎数据，不是机械填模板）

LLM收到引擎JSON后，必须：

A. 验收上一根K线（从settle输出）

显示：K线时间、预测 vs 实际、误差、方向✅/❌、区间✅/❌
1句偏差复盘

B. 综合判断方向（引擎给基准，LLM最终决定）

引擎的bias/strength是参考起点，不是最终答案
读取 data/news-risk-level.json 获取结构化新闻情绪
LLM必须考虑引擎忽略的因素：
- 超卖/超买后的反转概率
- BB下轨/上轨的支撑/阻力效应
- 连续阴/阳线后的疲劳
- 🔴 fatigue≥0.8均值回归预警: 连续下跌/上涨后市场疲劳→反转概率显著升高。即使全因子同向，也必须将confidence上限压至40，并提升反向情景概率至少10pp
- K线形态（十字星、锤子线、吞没等）
- 新闻方向的权重调整
如果LLM调整了引擎方向，必须说明理由
half_body vs imbalance/microprice 冲突裁决 (v5.7.2): 当 half_body 与 imbalance/microprice 方向相反时，优先 half_body。原因——imbalance 和 microprice 基于已完成K线的 orderbook 快照（滞后），而 half_body 反映当前半K线的实时价格动量（即时）。实盘验证: 2026-06-04 引擎因 imbalance=-0.82/microprice=-0.82 判 bear weak，但半K线实体+$376 (half_body=+0.35) 是明确 bull 信号——实盘收涨✅；2026-06-17 引擎因 imbalance=+0.99/microprice=+0.99 判 bull weak，但半K线实体-$82 (half_body=-0.41) + MACD转负是明确 bear 信号——实盘收跌✅。两次验证均证明: 已完成K线的 orderbook 因子在K线初段是滞后指标，半K线实时动量是即时指标。裁决条件: |half_body|>0.25 且 |imbalance|>0.5 且方向冲突时触发

C. 微调预测价（引擎给基准，LLM微调±ATR*0.3以内）

引擎pred_close是数学基准
LLM可基于K线形态、新闻、超卖反弹等调整
调整幅度不超过ATR*0.3

D. 完整输出（包含技术分析逻辑，不是只列数字）

Step 3: 记录日志

SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py log \
  "<engine.candle.iso>" \
  <final_pred_close> \
  <final_pred_high> \
  <final_pred_low> \
  <confidence> \
  <final_bias> \
  <news_sentiment> \
  <engine.indicators.vol_pct>

输出模板

✅ 验收: [上次K线时间] pred=$XX,XXX actual=$XX,XXX err=±$XX (±X.XX%) dir✅/❌ rng✅/❌
[1句复盘]

📈 BTC 5min 实时预测 @ HH:MM:SS
当前K线: HH:MM→HH:MM | ⏱ XX.X% (剩XmXs)
实时价: $XX,XXX | O=XX,XXX H=XX,XXX L=XX,XXX C=XX,XXX (body ±$XX)
---
📰 今日关键新闻 [结构化信号: 🟢BULLISH/🟡NEUTRAL/🔴BEARISH | 风险: LOW_RISK/NORMAL/ELEVATED/HIGH_VOL]:
- 🟢 [新闻1] — 影响
- 🟡 [新闻2] — 影响
- 🔴 [新闻3] — 影响
新闻净效应: 🟢/🟡/🔴 [原因] | 结构化: [news-risk-level.json sentiment]

🧭 方向: 📈/📉 [bull/bear] [strong/medium/weak] | 依据: [2-3个关键指标+新闻]
- 引擎基准: [engine bias/strength] → LLM调整: [如有调整写理由，无则写"确认引擎判断"]
- EMA9=$XX,XXX / EMA21=$XX,XXX (Δ±$XX)
- RSI=XX.X [超买/超卖/中性]
- MACD=XX.X / Signal=XX.X (Hist=XX.X)
- BB: $XX,XXX / $XX,XXX / $XX,XXX [价格位置]
- ATR=$XX.X | Vol=XX% of avg [放量/缩量/正常]

[2-3句核心分析：结合技术+新闻+K线形态的综合判断]

---
🎯 收盘预测:
| 情景 | 目标区间 | 概率 |
|------|---------|------|
| [主要情景] | $XX,XXX-$XX,XXX | XX% ← |
| [次要情景] | $XX,XXX-$XX,XXX | XX% |

**开盘$XX,XXX → 预测$XX,XXX** (±$XX, ±X.XX%) → 📈/📉

> [1句关键备注]

引擎JSON结构（LLM直接读取）

v5.6输出示例（实际字段名）：

{
  "version": "5.6",
  "candle": {"now":"22:10:26","candle_start":"22:10","candle_end":"22:15","progress_pct":8.9,"remaining_sec":273,"iso":"..."},
  "price": {"current":74978.01,"open":75020.0,"high":75037.42,"low":74950.64,"body":-42,"body_pct":-0.056},
  "recent_candles": [{"O":75000,"H":75102,"L":74928,"C":75073}, ...],
  "indicators": {
    "ema9":75099.4, "ema21":75298.7, "ema_delta":-199.3,
    "rsi":32.5, "macd":-209.78, "macd_signal":-191.92, "macd_hist":-17.86,
    "bb_upper":76060.4, "bb_mid":75357.1, "bb_lower":74653.9,
    "atr":155.6, "vol_pct":19.0
  },
  "fng": {"value":25, "label":"Extreme Fear"},
  "factors": {
    "momentum": -0.968, "meanrev": 0.431, "rsi": -0.351,
    "volume": 0.25, "fatigue": 0, "imbalance": 0.234,
    "microprice": 0.246, "decel": 1.0, "position": 0.798,
    "v_reversal": 0, "vol_breakout": 0
  },
  "regime": "TREND",
  "chainlink_offset": -152,
  "prediction": {"bias":"bull","strength":"weak","confidence":45,"score":1,
                 "pred_close":74860,"pred_high":74954,"pred_low":74766}
}

v5.6新增字段说明:

chainlink_offset: Binance→Chainlink价格偏移（$），已自动补偿pred_close/high/low。LLM在输出末尾注明此偏移即可
fng: Fear & Greed Index，值为null时API不可用
factors.v_reversal: V型反转因子 [-1,1]，0=无反转信号
factors.vol_breakout: 放量突破因子 [-1,1]，0=无突破信号
atr_spike: ATR异常检测 {detected, ratio, consecutive} — v5.7.1 P0-1
fng_black_swan: bool — v5.7.1 P0-2: FNG<25时为True
news_risk: str — v5.7.1 P0-3: "NORMAL"/"BLACK_SWAN"/"CRITICAL"
black_swan_warning: str|null — v5.7.1 P0-3: 黑天鹅警告信息
price.body_pct: body百分比，正=阳线，负=阴线


## 复盘

```bash
SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc && \
  python3 $SKILL_DIR/5minbtc-log.py stats

新闻数据源

源	延迟	状态
CoinDesk	~14min	✅ RSS实时
Cointelegraph	~3min	⚠️ 需TG脚本（已降级为RSS fallback）
TreeNews	~120min	⚠️ 需TG脚本（已降级）

版本演进

版本	架构	方向准确率	关键变更
v3.1	线性打分(EMA+RSI+MACD+Vol)	64%	基础版，引擎+LLM混合
v3.5.1	+低vol衰减/VWAP因子	77%	最佳版本
v4.0	Hermes迁移	60.5%	路径适配，功能不变
v4.1	Phase1修复	目标70%+	过度自信压制+放量反转+bull修正+疲劳增强
v5.4	正交因子+Regime	68.1%(120r)	9正交因子+sigmoid+TREND dampening+meanrev反转
v5.5	+校准置信度	71.4%(28r)	Platt Scaling+Bull惩罚+高vol增强+neutral区收缩
v5.6	+冲突检测+V反转+Chainlink	66.1%(298r实盘) / 47.4%(105k回测)	mom/decel冲突降权+V反转因子+放量突破+Coinbase价格对齐。⚠️ 实盘edge来自前视偏差(progress=0.9+)，公平回测无预测力
v5.7	半K线策略+half_body因子	61.4%回测(前2min) / 69.5%(前4min)	第2分钟执行+half_body_momentum因子(BASE_W=1.2)+ATR×0.55+half_range 0.40。v5.8回测用真实1min K线证实半K线延续性有真实edge(+11.4~+19.5pp)
v5.7.1	+黑天鹅防护	72.0% (100r实盘) / 61.4%回测(V8)	P0-1: ATR spike检测(1.5x阈值+连续3根→regime强制HIGH_VOL+conf减半) / P0-2: FNG<25极端恐惧过滤(v_reversal×0.5+decel×0.7) / P0-3: news_risk circuit breaker(BLACK_SWAN/CRITICAL→neutral+conf=30)。2026-05-28美伊空袭复盘驱动。6月实盘100轮方向83.0%: 06-03=79.2%(24r) → 06-06=90.9%(33r)🏆 → 06-09=88.9%(18r) → 06-12=68.0%(25r) 缩量(≤80% vol)方向≥95% ✅
v5.7.2	+imbalance冲突裁决+fatigue预警	2/2裁决验证✅	**half_body vs imbalance/microprice冲突裁决规则:

⚠️ 回测警示(2026-05-28更新): v5.6纯价格因子在开盘预测时准确率仅47-49%。但v5.8用真实1min K线构建半K线后，准确率61.4%(前2根)~69.5%(前4根)，证实半K线延续性有真实edge。half_body因子本身无方向预测力(48.5%)，其贡献在于触发更紧ATR阈值。详见 references/backtest-findings.md 和 backtest/run_backtest_v58.py。

全量复盘 (273笔结算, 截至2026-05-27)

日期	引擎	笔数	方向	区间	行情特征
05-05	v4.x	107	64.5%	55.1%	震荡+突破
05-06	v4.x	28	57.1%	71.4%	横盘
05-11	v4.x	12	66.7%	91.7%	小样本
05-12	v4.x	5	40.0%	60.0%	小样本最差
05-23	v5.4	37	64.9%	73.0%	v5.4首日
05-24	v5.4	30	73.3%	76.7%	-1.09%单边下跌🏆
05-25	v5.4	26	61.5%	88.5%	+0.43%震荡
05-27	v5.5	28	71.4%	75.0%	-0.78%震荡下跌
06-03	v5.7.1	24	79.2%	54.2%	-6.9%单边下跌, FNG=11
06-06	v5.7.1	33	90.9% 🏆	78.8%	缩量震荡, FNG=12~14
06-09	v5.7.1	18	88.9%	61.1%	16连胜, 缩量≤80%方向100%
06-12	v5.7.1	25	68.0%	40.0%	bear中量区44.4%溃败
06-14	v5.7.1	32	65.6%	53.1%	bear弱反弹盲区57.9%, 10连胜开局

引擎迭代对比:

v4.x (152轮): 方向 62.5% | Range 61.2%
v5.4 (93轮): 方向 66.7% | Range 78.5%
v5.5 (28轮): 方向 71.4% | Range 75.0%
v5.7.1 (100轮): 方向 83.0% (06-03: 79.2%, 06-06: 90.9%🏆, 06-09: 88.9%, 06-12: 68.0%, 06-14: 65.6%)
v5.x合计 (221轮): 方向 77.8% (+15.3pp vs v4)

核心教训

🔴 纯价格因子无预测力，但半K线延续性有真实edge — 11因子全部49-51%，但用真实1min K线构建半K线后准确率61-70%。edge来自价格动量延续，不是技术指标。回测时必须用真实1min数据，不能用模拟中点
半K线延续性是可利用的真实效应 — v5.8回测(27k轮)证实: 前2根1min=61.4%, 前4根=69.5%。越接近K线完成越准。实盘66%准确率已解释
过度自信是最致命问题 — conf≥60准确率56.8% < conf<60的65.4%，极端信号=行情末端
放量≠确认方向，放量=反转预警 — 放量(≥80%)准确率仅50%
bull偏向严重 — bull准确率57.3% < bear 63.4%，引擎过度解读EMA金叉
线性打分是初学者错误 — 多个共线指标叠加不增加信息量
🔴 缩量场景(<50% vol) = 半K线策略最强edge — 2026-06-03实盘7/7 100%准确率 — 缩量意味着没有突发因素干扰半K线延续性，half_body因子在低vol市场中被锁定。这从v5.4时代"低vol微波动准确率最高"(66%)的观察，升级为半K线策略的核心优势。v5.8回测中volume因子是唯一有独立预测力的因子(56-58%)，与实盘互为印证。这条经验来自2026-06-03实盘复盘。
EMA在底部反弹期天然滞后 — VWAP因子部分修复
momentum/decel冲突时，decel通常是正确的 — 当 |momentum_tstat|>0.7 且 |decel|>0.8 且方向相反时，长期斜率锁定错误方向，短期反转才是真相（V型反转场景）
volume因子使用未完成K线判断方向是致命缺陷 — 预测时点candle仅完成60-70%，应改为用最近3根完整K线的量价关系
bear方向在中量区(40-80%)是v5.7.1最大盲区 (2026-06-12) — 缩量场景(<40%)和bull方向表现优异(87-100%)，但bear中量区准确率仅44.4%(低于随机)。趋势市场中的区间震荡导致半K线延续性失效。修复方向: bear中量区需增加额外确认规则(如连续2根同向半K线才出方向)
- 变体: 持续下跌后的弱反弹是bear方向另一盲区 (2026-06-14): 32轮方向65.6%，bear仅57.9%(11/19)。8次bear误判全部是"预测跌但实际涨" — 持续下跌后BTC出现弱反弹时，半K线延续性错误地将反弹视为继续下跌。21:00-22:00区间6次bear全部打脸。根因: 下跌半K线延续性过强，无法区分"延续下跌"vs"震荡筑底反弹"。修复方向: 连续3根以上bear完成K线+当前半K线收涨时，bear需降权或升至中立
imbalance/microprice 因子滞后于半K线实时动量 (v5.7.2) — 当当前半K线实体方向与 imbalance/microprice 冲突时，已完成K线的 orderbook 因子是滞后指标，半K线实时动量是即时指标。裁决: |half_body|>0.25 且 |imbalance|>0.5 时优先 half_body。2026-06-04 实盘: 引擎判 bear(imbalance=-0.82)，但半K线 bull 实体+$376 正确
周末低流动性放大误差 (2026-06-14): 周日(06-14)的MAE=0.045%与平日相当，但22:35出现了-0.22%的极端误差（pred=$64,020 actual=$63,880）。周末BTC波动率降低但偶发性价差放大，建议周末自行降低ATR乘数或减少预测频率
🔴 fatigue≥0.8 = 均值回归预警 (2026-06-17): 22:40 candle — 全因子bear共振(momentum=-0.85/imbalance=-0.73/MACD hist=-26.6/vol=3%)，LLM判bear medium，但实际收涨(+$87)。根因: fatigue=0.8表示连续下跌后市场疲劳，缩量环境下的均值回归概率显著升高。裁决规则: fatigue≥0.8时，即使全因子同向，也需将置信度上限压至40，并提升反向情景概率至少10pp。fatigue=0.8是本轮唯一反向信号，却被忽略，导致方向误判。与06-14 bear弱反弹盲区(教训11)的关联: 两者都是"连续下跌后的反弹"模式——06-14是半K线延续性过强无法区分筑底，06-17是fatigue信号被全因子压制。共同修复方向: 连续下跌≥3根K线后，需增加反弹确认机制

2026-06-03 复盘新增经验

v5.7.1首日实盘(6月3日): 24轮已结算，方向准确率79.2%(19/24)，区间54.2%(13/24)，MAE 0.106%。详见 review-2026-06-03.md。

5个方向误判的根因模式:

时间	引擎方向	实际方向	误差	vol	根因模式
20:04	bear	+0.30%	❌❌	163%	巨量开盘+冲突降权未完全覆盖
20:37	bear	+0.21%	❌❌	83%	开仓延迟: 20:36 bull→20:37 bear转多
20:54	bear	+0.16%	❌❌	34%	纯噪声区间: 缩量反向锁死
20:57	bull	-0.06%	❌❌	37%	量价背离: 缩量bear bull锁死
21:06	bull	-0.08%	❌❌	81%	Pattern A: momentum 15-candle OLS滞后
21:28	bull	-0.01%	❌❌	156%	缩量变放量+开仓末期反转

v5.0 升级路线图

详见 references/quant-knowledge-index.md 和 ~/.hermes/profiles/cqo/quant-knowledge/R12-integration-blueprint.md

v5.6 方向错误修复（✅ 已实施 2026-05-27）

基于2026-05-27深度复盘的3次方向错误分析，已全部落地到引擎代码：

优先级	修复项	状态	实现
R0	momentum/decel冲突检测	✅ `direction_rule_v5()`	saved_base模式动态降权mom→0.4, decel→0.9
R1	V型反转因子	✅ `v_reversal_detect()`	BASE_W=0.8, TREND/HIGH_VOL下加权至0.9/1.0
R2	放量突破因子	✅ `vol_breakout_signal()`	用最近3根完成K线，BASE_W=0.4
R3	Chainlink价格对齐	✅ `fetch_chainlink_ref()+run()`	Coinbase BTC-USD参考，偏移补偿上限±$300

案例复盘要点：

20:20巨量突破(vol=182%)：decel=+1.0正确预判反转，但mom=-0.98权重×1.0淹没反转信号 → R0冲突检测修复
20:25放量延续(vol=123%)：同上，momentum仍在消化15根K线的下跌斜率 → R0冲突检测修复
20:50低vol(vol=33%)：RANGE regime下meanrev权重放大推高bull，实际仅$2波动 → v5.5 neutral区收缩已覆盖

实时验证: 22:09 CST 运行恰好命中冲突场景(mom=-0.981, decel=+1.0)，输出bear conf=45% score=-1

P0 — 立即实施（回测验证后的修订优先级）

🔴 OFI微结构因子是唯一出路 — 回测证明纯价格因子无预测力。必须接入Binance WebSocket获取orderbook L2数据，实现OFI(Cont et al. 2014)和Stoikov microprice。学术文献R²=15-25%，是5分钟尺度唯一有实证支持的信号
新闻脉冲信号 — 突发事件(Big发布/SEC/ETF)可在5分钟内产生方向性冲击，作为互补信号
降低实盘仓位 — 在edge来源明确前，不应按66%胜率预期下注。实盘66%大概率是小样本+前视偏差的假象

P1 — 2-4周

Regime-aware仓位 (HMM检测)
LightGBM自动化因子筛选
CVaR动态止损

P2 — 1-2月

TFT多时间尺度模型 → 替代贝叶斯引擎
期权IV信号 (Deribit)
完整压力测试框架

关键数学升级

OFI (Cont et al. 2014) → 替代纯价格指标
Microprice (Stoikov 2018) → 替代 mid price
Kalman滤波 → 动态EMA权重
HMM Regime → 自适应仓位
GPD尾部 → 替代固定止损

参考文件

references/binance-api-geo.md — Binance API 区域封禁解决方案和迁移记录
references/quant-knowledge-index.md — 50轮蒸馏知识库索引(14份报告/~80KB)，含升级优先级
references/polymarket-data-source.md — Polymarket BTC价格结算源(Chainlink Data Streams)、与Binance价差分析、对预测引擎的影响
references/performance-history.md — 全量实战记录(273轮/8天)，按日详细数据+引擎迭代对比+3大错误模式归因
references/backtest-findings.md — 365天回测深度复盘：因子无预测力证据、前视偏差诊断、A/B三种模式对比、战略建议
references/session-2026-06-17.md — 2026-06-17 5轮实时预测: v5.7.2冲突裁决再验证(2/2)✅、fatigue≥0.8误判分析、Binance端点双向故障切换
references/dreaming-cron-recovery.md — Dreaming Cron故障恢复指南: 数据源不可用恢复步骤、验证命令、配置参考
references/backtest-v58-1min-findings.md — v5.8真实1min半K线回测：零前视偏差方法论、前2根1min=61.4%准确率、因子贡献分析、半K线延续性alpha证据

复盘记录文件

存放在 skill 目录根下，按日期命名：

review-2026-05-24.md — v5.4 单边下跌日复盘（方向73.3%）
review-2026-05-25.md — v5.4 震荡市复盘（Range 88.5%历史最佳，方向61.5%）
review-2026-05-27.md — v5.6 3次方向错误深度复盘 + 4项修复实施 + 8天273轮总战绩
review-2026-06-03.md — v5.7.1 首日24轮实盘复盘（方向79.2%, 缩量100%, 5个误判模式分析）
backtest/review-backtest-2026-05-27.md — 365天回测深度复盘 + 因子无预测力证据 + 前视偏差诊断

报告库

14份深度蒸馏报告存放在 reports/ 目录（也同步在 AGI-Super-Team 仓库）：

R01-R12：50轮蒸馏（因子理论、策略、DeFi、组合、ML、数据源、前沿研究、期权、微结构、风控、机构方法论、整合蓝图）
R13：准确率优化方案（178笔复盘后）
R14：引擎审计报告（顶尖量化审查，4个Critical修复→v5.0架构设计基础）

仓库同步

Skill已同步至 AGI-Super-Team 仓库 skills/5minbtc/。

# 1. rsync 本地最新版到共享仓库（排除运行时数据和日志）
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/

# 2. 提交推送
cd /home/aa/clawd/repos/AGI-Super-Team
git add skills/5minbtc/
git commit -m "sync(skills/5minbtc): <变更简述>"
git push origin master

Commit message 惯例: sync(skills/5minbtc): <版本> 全量同步 — 引擎+回测+复盘+参考文档

同步内容:

✅ 引擎 (5minbtc-engine*.py)、日志模块 (5minbtc-log.py)、新闻模块 (5minbtc-news.py)
✅ SKILL.md（含冲突裁决规则同步）
✅ backtest/（含脚本、结果JSON、README）
✅ references/（含黑天鹅防御、Dreaming恢复、Binance地理、性能历史）
✅ review-*.md 全量复盘记录
❌ data/、__pycache__/（运行时产物）
❌ *.jsonl、*.jsonl.*.gz（海量预测日志，按需同步）

同步前dry-run验证:

rsync -av --dry-run \
  --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/

推送前检查point: 确保不包含敏感数据（密钥、API凭证）、市场数据（data/）、海量日志（*.jsonl.gz）

回测系统

backtest/
├── fetch_data.py            # Binance历史数据下载器(分页+断点续传)
├── run_backtest.py          # v5.6回测引擎(导入v5.6因子模块, A/B三种模式)
├── run_backtest_v57.py      # v5.7回测(用模拟半K线，已证实有前视偏差问题)
├── run_backtest_v58.py      # v5.8回测(用真实1min K线构建半K线，零前视偏差) ← 推荐使用
├── run.sh                   # 一键运行(--fast/--sample/--days/--skip-fetch)
├── README.md                # 使用文档
├── data/
│   ├── btcusdt_5m.json      # 5分钟K线数据(105k根, 12MB)
│   └── btcusdt_1m.json      # 1分钟K线数据(259k根, 29MB) — v5.8回测用
└── results/                 # 回测结果(gitignore)

运行命令:

cd backtest && python3 run_backtest_v58.py --fast --compare — v5.8快速回测(推荐)
cd backtest && python3 run_backtest_v58.py --half 3 — 用前3根1min
cd backtest && python3 run_backtest_v58.py --days 180 --full-report — 完整半年报告

5minbtc

More from this repository

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

v5.7 变更 (2026-05-28)

v5.8 回测方法论突破 (2026-05-28)

v5.6 变更 (2026-05-27)

v5.5 变更 (2026-05-26)

概述

铁律

⚠️ Pitfalls

Binance API 端点选择与故障切换

路径硬编码

全局字典临时修改模式

🔴 CRITICAL: 回测证明因子无预测力，但半K线延续性有真实edge (2026-05-28更新)

🔴 Python 3.11 Unicode Strictness in Engine Source Files

Cron Job 版本同步

执行步骤

Step 1: 并行启动（5个调用同时发出）

Step 2: LLM完整分析（参考引擎数据，不是机械填模板）

Step 3: 记录日志

输出模板

引擎JSON结构（LLM直接读取）

新闻数据源

版本演进

全量复盘 (273笔结算, 截至2026-05-27)

核心教训

2026-06-03 复盘新增经验

v5.0 升级路线图

v5.6 方向错误修复（✅ 已实施 2026-05-27）

P0 — 立即实施（回测验证后的修订优先级）

P1 — 2-4周

P2 — 1-2月

关键数学升级

参考文件

复盘记录文件

报告库

仓库同步

回测系统

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

v5.7 变更 (2026-05-28)

v5.8 回测方法论突破 (2026-05-28)

v5.6 变更 (2026-05-27)

v5.5 变更 (2026-05-26)

概述

铁律

⚠️ Pitfalls

Binance API 端点选择与故障切换

路径硬编码

全局字典临时修改模式

🔴 CRITICAL: 回测证明因子无预测力，但半K线延续性有真实edge (2026-05-28更新)

🔴 Python 3.11 Unicode Strictness in Engine Source Files

Cron Job 版本同步

执行步骤

Step 1: 并行启动（5个调用同时发出）

Step 2: LLM完整分析（参考引擎数据，不是机械填模板）

Step 3: 记录日志

输出模板

引擎JSON结构（LLM直接读取）

新闻数据源

版本演进

全量复盘 (273笔结算, 截至2026-05-27)

核心教训

2026-06-03 复盘新增经验

v5.0 升级路线图

v5.6 方向错误修复（✅ 已实施 2026-05-27）

P0 — 立即实施（回测验证后的修订优先级）

P1 — 2-4周

P2 — 1-2月

关键数学升级

参考文件

复盘记录文件

报告库

仓库同步

回测系统

More from this repository