Claude Cursor Skill

5minbtc

BTC 5分钟K线实时方向预测 + 币安预测市场错价套利(paper)。v6.0 真OFI驱动: 方向由当前K线原生 in-candle OFI 净流一票决定(ofi_n=2*(tb/v)-1, REST klines[9] 聚合, 零WS依赖; WS ofi.json 做新鲜度反转保护与交叉校准), 概率=P(close>open|ofi) 经验校准表+Bayesian shrink, edge=EV=p−ask 错价检测, 方向二选一无中性。13因子自v5.9起收敛到3个有证据信号且不再决定bias。黑天鹅防护: ATR spike+FNG<25。l

LLM Mart · 0 points · 5 views 134 listing impressions 0 install-command copies
Download aAAaqwq-AGI-Super-Team-skills_5minbtc-8e7ac34.zip · 3303 KB

Install

skills CLI npx skills add https://github.com/aAAaqwq/AGI-Super-Team/tree/main/skills/5minbtc
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install aaaaqwq-agi-super-team@llmmart
Git git clone https://github.com/aAAaqwq/AGI-Super-Team.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole aaaaqwq/agi-super-team collection as a plugin from our marketplace. Git is the plain clone.

README

5minbtc — BTC 5 分钟实时方向预测引擎

引擎 + LLM 混合架构:真 OFI 净流定方向 + 错价检测定 edge,LLM 综合裁决,预测 BTC 单根 5 分钟 K 线的方向与收盘价区间。

⚠️ v6.0 起方向不再来自因子打分 — 13 个价量因子中 11 个经公平回测为 47–49%(等同抛硬币),现仅保留输出供参考,方向由当前 K 线原生 OFI 净流一票决定。详见 对抗式审查报告。

⚠️ NOT FINANCIAL ADVICE / 非投资建议 — 本项目仅为量化研究与学习目的,不构成任何投资、交易或持仓建议。预测存在显著误差,实际交易将面临资金损失风险。详见文末 免责声明。

Engine Python Deps


目录


核心理念

5minbtc 解决一个具体问题:在每根 5 分钟 BTC K 线进行到 ~60–80% 时,预测这根 K 线收盘时的方向和价格区间。

它不是全自动交易机器人,而是一个 引擎 + LLM 混合决策系统:

   量化引擎 (12 因子 + ATR 归一化)        LLM (新闻 + 因子 + 裁决规则)
   ┌─────────────────────────┐           ┌──────────────────────────┐
   │ 4 路并行拉取市场数据      │  JSON →  │ 3 路并行新闻搜索          │
   │ 12 正交因子打分           │ ──────→  │ 综合裁决 (可微调引擎结论)  │
   │ Platt Scaling 置信度      │           │ 模板化输出 (15–25 行)      │
   └─────────────────────────┘           └──────────────────────────┘
         纯 Python 标准库                       可由 cron 调度

为什么要混合? 回测证明:纯价格因子在公平(无前视)条件下无显著预测力(47–49%)。实盘的 edge 主要来自 K 线后段(progress ≥ 0.9)的"已确认走势延续"以及新闻冲击。把数值因子交给 LLM 做上下文综合,比纯规则或纯 LLM 都更稳健。

系统架构

组件

组件 文件 职责
引擎 5minbtc-engine-v6.0.py 拉数据 → 计算 OFI(ofi_n=2*(tb/v)-1) → OFI 一票定方向 + 概率 P(close>open\|ofi) → 输出预测 JSON(stdout)。13 因子仍计算但只作参考
新闻 5minbtc-news.py 抓取 CoinDesk RSS,输出风险等级到 data/news-risk-level.json
日志 5minbtc-log.py 预测记录追加(jsonl)+ 增量 settle(结算上一根 K 线实际结果)
回测 backtest/*.py 历史数据回测,多版本(v5.6 / v5.7 / v5.8)
LLM (外部) 读引擎 JSON + 新闻,综合裁决并输出

数据流(单次预测)

cron 触发 (每根 5min K线 第4分钟)
   │
   ├─ 5minbtc-log.py settle-all      ← 结算上一根 K 线(写入实际收盘)
   │
   ├─ 5minbtc-engine-v6.0.py         ← 引擎核心
   │     │
   │     ├─ ThreadPoolExecutor(4) 并行:
   │     │    ├─ Binance  Klines   (200 根 5min K线)
   │     │    ├─ Binance  Depth    (订单簿 top-20)
   │     │    ├─ alternative.me FNG (恐惧贪婪指数)
   │     │    └─ Coinbase  BTC-USD  (Chainlink 参考)
   │     │
   │     ├─ 指标: EMA9/21, RSI, MACD, Bollinger, Wilder ATR, Vol-Regime
   │     ├─ 12 正交因子 → score → bias / confidence
   │     ├─ 黑天鹅过滤 (ATR spike / FNG<25 / 新闻熔断)
   │     └─ Chainlink 偏移补偿 (±$300 上限)
   │
   ├─ 5minbtc-news.py                 ← 写 news-risk-level.json
   │
   └─ LLM 读取引擎 JSON + 3 路新闻 → 裁决 → 写日志

引擎单次执行约 ~3 秒(v5.7.3 并行化后,原串行 ~11–18 秒)。

12 正交因子体系

v5.0 起用正交因子替代共线指标,所有阈值经 ATR 归一化,避免波动率变化导致阈值失效。

因子 类别 含义
momentum 趋势 EMA9−EMA21 差值,ATR 归一化的 t-stat
meanrev 均值回归 偏离布林带中轨程度
rsi 动量 Wilder RSI 的 Z-score
volume 量能 条件化放量信号(区分突破 vs 衰竭)
fatigue 衰竭 趋势动能衰减检测
imbalance 微结构 订单簿买卖盘失衡
microprice 微结构 Stoikov microprice 偏离 mid
decel 衰竭 价格变化减速(动量冲突时动态降权)
position 位置 K 线在布林带中的相对位置
v_reversal 反转 低点抬高 + 收>开 的 V 型反转模式
vol_breakout 突破 最近 3 根完成 K 线的放量突破
half_body 半 K 线 核心 edge:progress≥45% 时已形成 body 的延续性

权重由 BASE_W 表给定,并随波动率 Regime(TREND / RANGE / HIGH_VOL / LOW_VOL)动态调整。

半 K 线预测策略(Half‑Candle)

这是 v5.7 的核心贡献,也是实盘 edge 的正式建模:

  • S1:在 K 线进度 ≥ 45% 时激活 half_body 因子——已经形成的 body 方向在剩余时间内倾向于延续。
  • S2:预测范围收窄——ATR 乘数 × 0.55,只预测剩余 ~55% 时间内的波动。
  • S3:调度时机从每根 K 线第 2 分钟推迟到第 4 分钟(progress ~60–80%),让前半段充分形成信号再预测后半段。

实证:回测中 11 因子组合无预测力(47–49%),但实盘 66% 的胜率主要来自 progress=0.9+ 时"确认已有走势"——half_body 把这个隐性逻辑变成了显式因子。

黑天鹅三重防护(v5.7.1)

引擎在输出预测前进行三层过滤,任一触发即压低置信度或转为 neutral:

  1. ATR Spike 检测:当前 ATR 相对历史出现尖峰时,方向可靠性下降。
  2. FNG < 25 过滤:恐惧贪婪指数低于 25(极度恐慌)时标记 fng_black_swan。
  3. 新闻冲击熔断:5minbtc-news.py 写入 BLACK_SWAN/CRITICAL 时,引擎强制 bias=neutral、confidence=30。

数据源

全部为公开、免认证接口,零 API Key:

数据 来源 用途
K 线 data-api.binance.vision/api/v3/klines 200 根 5min OHLCV
订单簿 data-api.binance.vision/api/v3/depth top-20 bids/asks
恐惧贪婪 api.alternative.me/fng/ 黑天鹅过滤
参考价 api.coinbase.com/v2/prices/BTC-USD/spot Chainlink 偏移补偿
新闻 www.coindesk.com/.../rss/ 风险等级(~14min 延迟)

快速开始

依赖:仅 Python 3.8+ 标准库,无需 pip install 任何第三方包。

# 单次运行引擎(输出预测 JSON 到 stdout)
python3 5minbtc-engine-v6.0.py

# 单独跑新闻扫描
python3 5minbtc-news.py

# 结算上一根 K 线 + 追加新预测
python3 5minbtc-log.py settle-all
python3 5minbtc-log.py log "<candle.iso>" <pred_close> <pred_high> <pred_low> \
    <conf> <bias> <news_sent> <vol_pct>

引擎输出示例(节选):

{
  "version": "5.7.3",
  "candle": { "progress_pct": 72.3, "...": "..." },
  "indicators": { "ema9": 61950.1, "rsi": 47.2, "atr": 85.4, "...": "..." },
  "factors": { "half_body": -0.31, "momentum": -0.42, "...": "..." },
  "regime": "TREND",
  "news_risk": "NORMAL",
  "prediction": {
    "bias": "bear", "strength": "moderate",
    "confidence": 48, "pred_close": 61920, "pred_high": 61960, "pred_low": 61870
  }
}

完整运行流程

完整的"引擎 + LLM"混合流程由 cron 每 5 分钟触发:

SKILL_DIR=/path/to/5minbtc

# 1. 并行执行:结算 + 引擎 + 新闻
python3 $SKILL_DIR/5minbtc-log.py settle-all
python3 $SKILL_DIR/5minbtc-engine-v6.0.py
python3 $SKILL_DIR/5minbtc-news.py

# 2. LLM 侧:3 路并行新闻搜索
#    - "Bitcoin BTC breaking news price"
#    - "crypto market macro stocks today"
#    - "比特币 BTC 最新 晚间"

# 3. LLM 综合引擎 JSON + 新闻 → 按模板输出(15–25 行)

# 4. 写入预测日志
python3 $SKILL_DIR/5minbtc-log.py log "<candle.iso>" <pred_close> ...

💡 用 cp .env.example .env 并设置 SKILL_DIR 指向你的克隆目录,可避免把路径写死。详见 配置说明。

目录结构

5minbtc/
├── 5minbtc-engine-v6.0.py     # 主引擎(cron 调用,输出预测 JSON)
├── 5minbtc-engine-v5.py       # v5 旧版(回测因子模块 import 用)
├── 5minbtc-news.py            # 新闻扫描(CoinDesk RSS)
├── 5minbtc-log.py             # 日志记录 + settle
├── SKILL.md                   # 技能索引文档(Hermes/Claude skill 格式)
├── README.md                  # 本文件
├── .env.example               # 配置模板
├── 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/                  # 缓存的 K 线 JSON
│   └── results/               # 回测结果(.gitignore)
├── references/                # 深度文档(架构/教训/pitfalls/黑天鹅…)
├── reviews/                   # 每日复盘报告(按月归档)
├── scripts/                   # 辅助脚本
└── data/                      # 运行时数据(新闻风险等级,.gitignore)

回测系统

cd backtest

# 一键回测(下载最新数据 + 运行)
./run.sh

# 快速模式(每小时采样,最近 180 天)
./run.sh --fast

# 最近 90 天,每 6 根 K 线采样
./run.sh --days 90 --sample=6

# 完整因子贡献分析
./run.sh --full-report

# 模拟 K 线进度(progress=0.5 = 中段)
python3 run_backtest.py --progress=0.5

公平性保障:

  • 无前视偏差(当前 K 线价格信息被屏蔽:c=h=l=open, v=0)
  • 因子仅基于 200 根已完成 K 线计算
  • 回测中订单簿不可获取,imbalance/microprice 设为 0

详见 backtest/README.md。

性能快照

以下为历史实测数据,过去表现不代表未来收益,且小样本下统计显著性有限。

版本 设定 方向准确率
v4.x 实盘 62.5%
v5.7.1 实盘 273 轮 75.7% (+13.2pp)
v5.8 回测(前 2 根 1min) 61.4%
v5.8 回测(前 4 根 1min) 69.5%

⚠️ 见 references/backtest-findings.md:公平回测下纯价格因子无预测力。实盘高胜率很可能部分来自小样本 + K 线后段信息优势,并非稳定 edge。在 edge 来源明确前,不应按高胜率预期下注。

配置说明

当前引擎不读取任何环境变量——所有参数(symbol、interval、HTTP timeout、ATR 乘数、因子权重)均硬编码在 .py 源码中,这保证了 cron 调用的零配置可复现性。

.env.example 列出了建议配置化的项(当前为预留/文档用途),供希望二次开发的用户参考。如需让引擎实际读取这些变量,需要修改对应源码(欢迎 PR)。

主要硬编码常量位置:

常量 默认值 位置
symbol BTCUSDT fetch_klines() / fetch_depth() 形参
interval 5m fetch_klines() 形参
HTTP timeout 5–10 s urlopen() 调用
ATR 乘数 0.55 predict_close_v5()
BASE_W 因子权重表 模块级常量
REGIME_ADJ Regime 权重调整 模块级常量

已知局限

  1. 回测与实盘的差距:公平回测下因子无预测力,实盘 edge 主要来自 K 线后段信息优势(可能不稳定的"半前视")。
  2. 订单簿简化:仅用 top-20 深度,未实现完整的 OFI(Cont et al. 2014)与 microprice 模型。
  3. 新闻延迟:CoinDesk RSS 约 14 分钟延迟,无法捕捉瞬时冲击。
  4. SSL 验证禁用:引擎全局设置 ssl._create_unverified_context,是为对抗高延迟网络下的 SSL 握手超时(见 references/high-latency-network-handling.md)。在可信网络环境下可安全恢复验证。
  5. 无自动交易:本项目只输出预测,不执行任何下单。

路线图

  • ✅ OFI 微结构因子(v6.0 已落地):引擎现由真 OFI 净流一票决定方向 + P(close>open|ofi) 概率, 见 SKILL.md 架构 与 strategy-adversarial-review.md
  • 🟡 HMM Regime 检测 + 自适应仓位
  • 🟡 LightGBM 自动化因子筛选
  • 🟡 CVaR 动态止损
  • 🟢 TFT 多时间尺度模型替代贝叶斯引擎

原 references/architecture.md(13 因子模型 + 升级路线图)已于 2026-09-10 删除: 其"13 正交因子"描述被 v5.9 清零、OFI 也已从路线图变为已实现,内容已由 changelog.md 与 SKILL.md 取代。

  • 🟢 Deribit 期权 IV 信号

免责声明 (NOT FINANCIAL ADVICE)

本项目是量化研究与教育项目,不构成投资建议、交易信号或任何形式的财务建议。

  • 加密货币市场波动剧烈,交易可能导致全部本金损失。
  • 引擎预测存在显著误差,历史准确率不代表未来表现。
  • 作者与贡献者对任何基于本项目的交易决策不承担责任。
  • 请在了解当地法律法规的前提下自行承担风险。

如本项目对你有帮助,欢迎 Star。但请勿将其视为稳赚的交易工具。

License

本项目暂未指定开源许可证。如需使用、修改或分发代码,请先联系作者或等待 License 文件添加。在未指定 License 前,根据默认版权法,代码保留全部权利(仅供阅读与学习)。

Skill manifest

5minbtc — BTC 5分钟实时预测 v6.0.0

BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。 SKILL.md 是索引, 详细内容见 references/。 v5.9 认知转变: 从"13因子预测器"→"3信号错价检测器" — 方向准确率不是 edge, EV = p − P − 成本 才是 (见 对抗式审查报告) v6.0 执行转变: 方向从"body 延续统计"改成真 OFI 净流一票决定 — 赌的是"净流已发生、token 价还没定价"的 flow-gap

⚠️ 同名易混: 本 skill 只做 BTC 单标的 5min 方向 + 预测市场 EV。要做全市场永续的量价突破扫描, 用 coin-vp-scanner — 两者区别见下方 与 coin-vp-scanner 的分工。

触发

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

何时使用

场景 做法
当前 5min K线 方向+价位 ✅ 标准流程, 方向=OFI 净流, edge=错价 EV (v5.8 零前视回测 61.4% 是延续性不是 alpha, 见性能快照)
会话内持续盯盘, 等明确信号 ✅ 监控模式 (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 scripts/test_engine.py (13 项, 自带 runner 无需 pytest; 慢测加 --slow) — 装了 pytest 也可 python3 -m pytest scripts/test_engine.py -v (原文件名 test_engine_v58.py 带版本号, 引擎升到 v6.0 后即漂移, 2026-09-10 改为不带版本号)

快速开始

SKILL_DIR=$HOME/.hermes/profiles/cqo/skills/5minbtc

# 1. 并行: 引擎 + 新闻 + settle (前一根)
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1
python3 $SKILL_DIR/5minbtc-engine-v6.0.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-v6.0.py (v6.0, 输出 "version": "6.0.0"): bias 由真 OFI 净流一票决定 (ofi_n>0→bull / <0→bear, 二选一无中性; ofi_n 缺失/为0 用 body 符号兜底并标 meta.body_fallback) + 概率 P(close>open|ofi) 三层(经验校准表 Bayesian shrink + flow-gap + 最近60s流) + 三层独立过滤(多周期4h/1h/15m 结构 + 跨资产ETH/SOL 广度 + WS OFI 新鲜度反转保护) + 9路并行HTTP
    • ⚠️ K 线开局阶段概率不可信(已知问题,见 pitfalls):主源 ofi_n = 2*(tb/v)−1 取自当前进行中的 K 线,_ofi_native() 只挡 v<=0、无最小样本量保护 → 开局几秒的少量成交就能把 ofi_n 推到 ±0.9。而 vol_gate(L692 按 MIN_VOL_FRAC=0.25 判断流量是否够)算出来但从不参与任何决策,只是输出里的装饰字段。建议只在进度 ≥40% 后采信概率/下单
    • 门限: T_OFI_GATE=0.20 / T_OFI_60=0.35 / WS 质量闸 OFI_CR_MIN=0.80 / OFI_BAYES_N=30
    • 13 因子仍计算并输出(JSON 契约保留), 但自 v6.0 起不参与 bias 决策 — score 只用于 strength 标签与 LLM 参考
  • 订单流 scripts/ofi_feed.py: trade+bookTicker 组合流 tick规则推断主动买卖, 写 ~/bb-auto/ofi.json, 带 ts 保鲜(>30s 引擎降级为只信 REST 主源) (launchd: com.daniel.ofi-feed)
  • 日志 5minbtc-log.py: jsonl 追加 + 增量 settle (写入 logs/)
  • 新闻 5minbtc-news.py: CoinDesk RSS (唯一稳定源, ~14min 延迟)
  • 常驻进程 (launchd): 5minbtc_realtime.py (5s 刷新, 预测快照+EV下单) / 5minbtc_watch.py / 5minbtc_trader.py --paper-monitor
  • LLM: 因子打分基准 + LLM 综合裁决 + 模板输出

铁律

  1. 每次必须重新执行引擎脚本 — 不缓存
  2. 每次必须重新搜索3组新闻
  3. 先 settle 上一根, 再 log 新预测
  4. LLM 可微调引擎的 pred_close/range, 但必须说明理由 ⚠️ bias 不要轻易覆盖 (v6.0): 方向是 OFI 一票决定的, LLM 用因子/新闻翻方向 = 退回被证伪的路径。 仅在 meta.body_fallback=True 或 OFI 数据缺失时才允许改 bias, 并显式写明原因。
  5. 输出 15-25 行 (平衡深度和 Telegram 可读性)

关键裁决规则 (⚠️ 历史规则: v5.7.x 因子打分路径)

v6.0 起 bias 由真 OFI 一票决定, 下列规则不再决定方向。 仅在两条兜底路径上仍有参考价值: ① meta.body_fallback=True (ofi_n 缺失/为0, 方向退回 body 符号) ② LLM 复核时解释 meta 冲突字段。 引擎的 raw score 仍输出, 但只影响 strength 标签, 不影响 bias。

  • half_body vs imbalance 冲突 (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body (注: 两者自 v5.9 起权重已清零)
  • 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-09-10 更新)

数字口径以 对抗式审查报告 为准 — 旧数字多数含前视偏差。

  • v5.7 回测 71.2% 含前视偏差(文件里自己标注"已知"); 零前视 v5.8: 前2根1min=61.4%, 前4根=69.5%
  • 但 61–70% 是"看着 K 线走完再确认"的延续性, 不是 alpha — 做市商已把它定价进 token 价
  • 去掉水分后的真实基准: non-neutral 方向 57.7% | bull 63.9% (唯一显著) | bear 50.0% = 纯硬币
  • paper 交易: 全样本 UP 成交 44% (+$0.24) | 甜区 UP ask 0.40–0.50 → 60% (+$1.39) ← 唯一正 EV 区间
  • 结论: edge 不在方向准不准, 在 EV = p − P − 成本 > 0。v6.0 的错价检测(flow-gap)就是直接做这件事。
  • 当前 LLM: 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 — 20 条 pitfalls 集中索引 (必读, 含并行 max() 评估陷阱; #18 = K线开局概率不可信; #19 = "真OFI" 只覆盖单一市场; #20 = 端点故障致静默断档)
  • changelog.md — v5.0 ~ v6.0 详细变更
  • skill-organization.md — Skill 文件结构模式 (可复用) — SKILL.md INDEX + references/ 分专题

执行与输出

数据源 & 网络

Binance 三种故障模式各一份(431/451 区域、隧道抖动、高延迟 SSL 超时),不是重复文档,见 setup-from-scratch.md §6。

引擎专项

回测 & 复盘

数据采集 & 仓库

  • sync-procedure.md — AGI-Super-Team 同步流程 (路径映射 + -c 校验 + logs 归档策略)
  • archive.md — 版本归档: v5.0→v6.0 沿革 + 哪些版本已不可取回 + 归档 SOP
  • setup-from-scratch.md — 从零搭建: 依赖/目录/密钥/6 个 launchd 服务/验证清单/日志轮转/故障表
  • scheduled-tasks.md — 系统级定时任务教程: 常驻型vs定时型 / 2 个任务 / launchd+cc-connect+hermes 三路线 / plist 模板 / 13 条坑
  • quant-knowledge-index.md — 50 轮蒸馏知识库索引

复盘记录

⚠️ reviews/ 目录本地不存在 —— 早期文件树声称有 23 份按月归档的复盘记录(2026-05/06/07),实际从未落盘。 复盘结论目前散落在 lessons.md、pitfalls.md、 strategy-adversarial-review.md 与 reports/ 里。 若要恢复这个习惯,需先补 review-procedure.md 的落盘步骤,别只在文档里声明。

报告库

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

与 coin-vp-scanner 的分工

两个都是交易类 skill, 但赌的不是同一件事, 不要混用:

5minbtc (本 skill) coin-vp-scanner
标的 单标的 BTC 全量币安 USDT 永续
周期 单根 5min K线 1–30min 短线
核心逻辑 真 OFI 净流 + 错价检测 (净流已发生、token 价未定价 → flow-gap) 确定性结构突破 (放量 + 强实体 + 收盘破 1h 结构位 + 趋势同向, 四条全 ✓)
决策依据 概率 P(close>open\|ofi) vs 市场 token 价 → EV = p − P 结构规则布尔判定, 非概率
输出 方向 bull/bear + 概率 + edge 杠杆 / TP / SL 交易卡
落地方式 预测市场 Up/Down token, 仅 paper (LIVE_GATE 硬闸门) 直接做合约短线
代码位置 本目录自包含 (引擎+脚本+launchd) 代码在 ~/projects/coin-vp-scanner/, 本 skill 只是索引

一句话选型: 要赌"市场定价错了" → 5minbtc; 要抓"价格放量破位了" → coin-vp-scanner。

仓库同步

详见 sync-procedure.md。简述:

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

回测系统

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-v6.0.py        # 主引擎 (v6.0 真OFI 一票定方向, launchd 调用)
├── 5minbtc-news.py               # 新闻扫描 (CoinDesk RSS, 唯一稳定源)
├── 5minbtc-log.py                # 日志记录 (写入 logs/)
├── logs/                         # 日志 (当月 live + 历史按月压缩)
│   ├── 5minbtc-log.jsonl         # 当月 live (不入库)
│   └── archive/*.jsonl.gz        # 月度压缩归档 (入库, 见 archive.md)
├── references/                   # 24 份专项 ref (含 skill-organization 模式)
├── backtest/                     # 回测系统 (results/ 不入库)
├── 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, launchd com.daniel.ofi-feed)
│   ├── 5minbtc_keyless_paper.py  # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价)
│   ├── telegram_push.py          # 通用 Telegram 推送助手
│   ├── daily-review-stats.py
│   └── fetch-github-repo.sh

⚠️ archive/ 目录与 reviews/ 目录本地并不存在 —— 本文件早期版本的文件树里声称有它们(还列了 23 份复盘),属于文档/现实漂移,已更正为上面的实际结构:

  • 旧版本引擎源码不保留在本地,只留文字归档 → references/archive.md
  • 每日复盘从未落盘到 reviews/,复盘结论散在 references/lessons.md / pitfalls.md 与 reports/

最后更新: 2026-09-10 — 引擎 v5.7→v6.0 改名 (文件/SKILL/引用全线对齐, 修引擎内"无中性"过期注释) + SKILL.md 版本刷到 6.0.0 + 性能快照改为审查后的诚实口径 + 补 v5.9/v5.10/v6.0 changelog + 新增与 coin-vp-scanner 的分工说明 + 修文件树未闭合的代码块与 archive//reviews/ 假目录声明 + 新增 archive.md 与 setup-from-scratch.md + logs 月度压缩归档入库

Files (agi-super-team)
  • backtest
    • results
      • backtest_20260527_2328.json 16.3 MB
        Loading…
      • backtest_v57_20260528_1433.json 7.1 KB
        Loading…
      • backtest_v58_1min_20260528_2018.json 3.7 KB
        Loading…
      • backtest_v58_1min_20260528_2019.json 2 KB
        Loading…
      • backtest_v58_1min_20260528_2020.json 2 KB
        Loading…
      • latest_summary.json 5.1 KB
        Loading…
      • latest_v57_summary.json 10 KB
        Loading…
      • latest_v58_1min_summary.json 245 B
        Loading…
    • fetch_data.py 6 KB
      Loading…
    • README.md 2.7 KB
      Loading…
    • run.sh 2.8 KB
      Loading…
    • run_backtest.py 19.7 KB
      Loading…
    • run_backtest_v57.py 25 KB
      Loading…
    • run_backtest_v58.py 19.8 KB
      Loading…
  • logs
    • archive
      • 5minbtc-log.2026-08.jsonl.gz 429.2 KB · in bundle
      • 5minbtc-log.2026-09.jsonl.gz 636.5 KB · in bundle
  • references
    • archive.md 7.9 KB
      Loading…
    • backtest-findings.md 4.7 KB
      Loading…
    • backtest-v58-1min-findings.md 3.1 KB
      Loading…
    • binance-api-geo.md 2.4 KB
      Loading…
    • binance-endpoint-flapping.md 3.4 KB
      Loading…
    • changelog.md 13 KB
      Loading…
    • cron-llm-provider-failure.md 12.4 KB
      Loading…
    • execution.md 2 KB
      Loading…
    • high-latency-network-handling.md 3.3 KB
      Loading…
    • lessons.md 14.7 KB
      Loading…
    • monitoring-claude-code.md 4.9 KB
      Loading…
    • news-sources.md 812 B
      Loading…
    • output-template.md 12.2 KB
      Loading…
    • pitfalls.md 29.9 KB
      Loading…
    • prediction-market-strategy.md 6.7 KB
      Loading…
    • prediction-trading-cli.md 7.5 KB
      Loading…
    • quant-knowledge-index.md 3.5 KB
      Loading…
    • review-procedure.md 1.6 KB
      Loading…
    • scheduled-tasks.md 13.5 KB
      Loading…
    • setup-from-scratch.md 8.9 KB
      Loading…
    • skill-organization.md 3.6 KB
      Loading…
    • strategy-adversarial-review.md 18.9 KB
      Loading…
    • sync-procedure.md 4.5 KB
      Loading…
    • telegram-push-monitor.md 2.8 KB
      Loading…
  • reports
    • R01-factor-theory.md 4.5 KB
      Loading…
    • R02-strategy-theory.md 4.9 KB
      Loading…
    • R03-crypto-quant-defi.md 4 KB
      Loading…
    • R04-portfolio-theory.md 4.8 KB
      Loading…
    • R05-ml-quant-trading.md 4.5 KB
      Loading…
    • R06-data-sources.md 5.1 KB
      Loading…
    • R07-frontier-research-2024-2026.md 5.3 KB
      Loading…
    • R08-options-volatility.md 6.8 KB
      Loading…
    • R09-market-microstructure.md 8.6 KB
      Loading…
    • R10-risk-management-frontier.md 7.3 KB
      Loading…
    • R11-institutional-methodology.md 5.4 KB
      Loading…
    • R12-integration-blueprint.md 9.9 KB
      Loading…
    • R13-accuracy-optimization-plan.md 8.8 KB
      Loading…
    • R14-engine-audit-report.md 4.2 KB
      Loading…
  • scripts
    • 5minbtc-engine-server.py 3.2 KB
      Loading…
    • 5minbtc-monitor.py 6.8 KB
      Loading…
    • 5minbtc_day_stats.py 4.2 KB
      Loading…
    • 5minbtc_keyless_paper.py 12.7 KB
      Loading…
    • 5minbtc_order.py 4 KB
      Loading…
    • 5minbtc_realtime.py 22.1 KB
      Loading…
    • 5minbtc_signal_stats.py 7.2 KB
      Loading…
    • 5minbtc_trader.py 59.6 KB
      Loading…
    • 5minbtc_watch.py 15 KB
      Loading…
    • daily-review-stats.py 7.7 KB
      Loading…
    • engine_client.py 2.1 KB
      Loading…
    • fetch-github-repo.sh 2.3 KB
      Loading…
    • ofi_feed.py 8.1 KB
      Loading…
    • prediction_ws_feed.py 7.9 KB
      Loading…
    • telegram_push.py 2 KB
      Loading…
    • test_engine.py 9.6 KB
      Loading…
  • .env.example 3.5 KB · in bundle
  • .gitignore 626 B · in bundle
  • .npmignore 97 B · in bundle
  • 5minbtc-engine-v6.0.py 52.2 KB
    Loading…
  • 5minbtc-log.py 11.8 KB
    Loading…
  • 5minbtc-news.py 7.9 KB
    Loading…
  • README.md 14.7 KB
    # 5minbtc — BTC 5 分钟实时方向预测引擎
    
    > 引擎 + LLM 混合架构:**真 OFI 净流定方向 + 错价检测定 edge**,LLM 综合裁决,预测 BTC 单根 5 分钟 K 线的方向与收盘价区间。
    >
    > ⚠️ **v6.0 起方向不再来自因子打分** — 13 个价量因子中 11 个经公平回测为 47–49%(等同抛硬币),现仅保留输出供参考,方向由当前 K 线原生 OFI 净流一票决定。详见 [对抗式审查报告](references/strategy-adversarial-review.md)。
    >
    > ⚠️ **NOT FINANCIAL ADVICE / 非投资建议** — 本项目仅为量化研究与学习目的,不构成任何投资、交易或持仓建议。预测存在显著误差,实际交易将面临资金损失风险。详见文末 [免责声明](#免责声明-not-financial-advice)。
    
    [![Engine](https://img.shields.io/badge/engine-v6.0.0-blue)]() [![Python](https://img.shields.io/badge/python-3.8%2B-green)]() [![Deps](https://img.shields.io/badge/dependencies-stdlib%20only-success)]()
    
    ---
    
    ## 目录
    
    - [核心理念](#核心理念)
    - [系统架构](#系统架构)
    - [12 正交因子体系](#12-正交因子体系)
    - [半 K 线预测策略](#半-k-线预测策略half--candle)
    - [黑天鹅三重防护](#黑天鹅三重防护)
    - [数据源](#数据源)
    - [快速开始](#快速开始)
    - [完整运行流程](#完整运行流程)
    - [目录结构](#目录结构)
    - [回测系统](#回测系统)
    - [性能快照](#性能快照)
    - [配置说明](#配置说明)
    - [已知局限](#已知局限)
    - [路线图](#路线图)
    - [免责声明](#免责声明-not-financial-advice)
    - [License](#license)
    
    ---
    
    ## 核心理念
    
    5minbtc 解决一个具体问题:**在每根 5 分钟 BTC K 线进行到 ~60–80% 时,预测这根 K 线收盘时的方向和价格区间**。
    
    它不是全自动交易机器人,而是一个 **引擎 + LLM 混合决策系统**:
    
    ```
       量化引擎 (12 因子 + ATR 归一化)        LLM (新闻 + 因子 + 裁决规则)
       ┌─────────────────────────┐           ┌──────────────────────────┐
       │ 4 路并行拉取市场数据      │  JSON →  │ 3 路并行新闻搜索          │
       │ 12 正交因子打分           │ ──────→  │ 综合裁决 (可微调引擎结论)  │
       │ Platt Scaling 置信度      │           │ 模板化输出 (15–25 行)      │
       └─────────────────────────┘           └──────────────────────────┘
             纯 Python 标准库                       可由 cron 调度
    ```
    
    **为什么要混合?** 回测证明:纯价格因子在公平(无前视)条件下无显著预测力(47–49%)。实盘的 edge 主要来自 K 线后段(progress ≥ 0.9)的"已确认走势延续"以及新闻冲击。把数值因子交给 LLM 做上下文综合,比纯规则或纯 LLM 都更稳健。
    
    ## 系统架构
    
    ### 组件
    
    | 组件 | 文件 | 职责 |
    |------|------|------|
    | **引擎** | `5minbtc-engine-v6.0.py` | 拉数据 → 计算 OFI(`ofi_n=2*(tb/v)-1`) → **OFI 一票定方向** + 概率 `P(close>open\|ofi)` → 输出预测 JSON(stdout)。13 因子仍计算但只作参考 |
    | **新闻** | `5minbtc-news.py` | 抓取 CoinDesk RSS,输出风险等级到 `data/news-risk-level.json` |
    | **日志** | `5minbtc-log.py` | 预测记录追加(jsonl)+ 增量 settle(结算上一根 K 线实际结果) |
    | **回测** | `backtest/*.py` | 历史数据回测,多版本(v5.6 / v5.7 / v5.8)|
    | **LLM** | (外部) | 读引擎 JSON + 新闻,综合裁决并输出 |
    
    ### 数据流(单次预测)
    
    ```
    cron 触发 (每根 5min K线 第4分钟)
       │
       ├─ 5minbtc-log.py settle-all      ← 结算上一根 K 线(写入实际收盘)
       │
       ├─ 5minbtc-engine-v6.0.py         ← 引擎核心
       │     │
       │     ├─ ThreadPoolExecutor(4) 并行:
       │     │    ├─ Binance  Klines   (200 根 5min K线)
       │     │    ├─ Binance  Depth    (订单簿 top-20)
       │     │    ├─ alternative.me FNG (恐惧贪婪指数)
       │     │    └─ Coinbase  BTC-USD  (Chainlink 参考)
       │     │
       │     ├─ 指标: EMA9/21, RSI, MACD, Bollinger, Wilder ATR, Vol-Regime
       │     ├─ 12 正交因子 → score → bias / confidence
       │     ├─ 黑天鹅过滤 (ATR spike / FNG<25 / 新闻熔断)
       │     └─ Chainlink 偏移补偿 (±$300 上限)
       │
       ├─ 5minbtc-news.py                 ← 写 news-risk-level.json
       │
       └─ LLM 读取引擎 JSON + 3 路新闻 → 裁决 → 写日志
    ```
    
    引擎单次执行约 **~3 秒**(v5.7.3 并行化后,原串行 ~11–18 秒)。
    
    ## 12 正交因子体系
    
    v5.0 起用正交因子替代共线指标,所有阈值经 **ATR 归一化**,避免波动率变化导致阈值失效。
    
    | 因子 | 类别 | 含义 |
    |------|------|------|
    | `momentum` | 趋势 | EMA9−EMA21 差值,ATR 归一化的 t-stat |
    | `meanrev` | 均值回归 | 偏离布林带中轨程度 |
    | `rsi` | 动量 | Wilder RSI 的 Z-score |
    | `volume` | 量能 | 条件化放量信号(区分突破 vs 衰竭)|
    | `fatigue` | 衰竭 | 趋势动能衰减检测 |
    | `imbalance` | 微结构 | 订单簿买卖盘失衡 |
    | `microprice` | 微结构 | Stoikov microprice 偏离 mid |
    | `decel` | 衰竭 | 价格变化减速(动量冲突时动态降权)|
    | `position` | 位置 | K 线在布林带中的相对位置 |
    | `v_reversal` | 反转 | 低点抬高 + 收>开 的 V 型反转模式 |
    | `vol_breakout` | 突破 | 最近 3 根完成 K 线的放量突破 |
    | **`half_body`** | **半 K 线** | **核心 edge:progress≥45% 时已形成 body 的延续性** |
    
    权重由 `BASE_W` 表给定,并随波动率 Regime(TREND / RANGE / HIGH_VOL / LOW_VOL)动态调整。
    
    ## 半 K 线预测策略(Half‑Candle)
    
    这是 v5.7 的核心贡献,也是实盘 edge 的正式建模:
    
    - **S1**:在 K 线进度 ≥ 45% 时激活 `half_body` 因子——已经形成的 body 方向在剩余时间内倾向于延续。
    - **S2**:预测范围收窄——ATR 乘数 × 0.55,只预测剩余 ~55% 时间内的波动。
    - **S3**:调度时机从每根 K 线第 2 分钟推迟到第 4 分钟(progress ~60–80%),让前半段充分形成信号再预测后半段。
    
    > 实证:回测中 11 因子组合无预测力(47–49%),但实盘 66% 的胜率主要来自 progress=0.9+ 时"确认已有走势"——`half_body` 把这个隐性逻辑变成了显式因子。
    
    ## 黑天鹅三重防护(v5.7.1)
    
    引擎在输出预测前进行三层过滤,任一触发即压低置信度或转为 neutral:
    
    1. **ATR Spike 检测**:当前 ATR 相对历史出现尖峰时,方向可靠性下降。
    2. **FNG < 25 过滤**:恐惧贪婪指数低于 25(极度恐慌)时标记 `fng_black_swan`。
    3. **新闻冲击熔断**:`5minbtc-news.py` 写入 `BLACK_SWAN`/`CRITICAL` 时,引擎强制 bias=neutral、confidence=30。
    
    ## 数据源
    
    全部为**公开、免认证**接口,零 API Key:
    
    | 数据 | 来源 | 用途 |
    |------|------|------|
    | K 线 | `data-api.binance.vision/api/v3/klines` | 200 根 5min OHLCV |
    | 订单簿 | `data-api.binance.vision/api/v3/depth` | top-20 bids/asks |
    | 恐惧贪婪 | `api.alternative.me/fng/` | 黑天鹅过滤 |
    | 参考价 | `api.coinbase.com/v2/prices/BTC-USD/spot` | Chainlink 偏移补偿 |
    | 新闻 | `www.coindesk.com/.../rss/` | 风险等级(~14min 延迟)|
    
    ## 快速开始
    
    **依赖**:仅 Python 3.8+ 标准库,无需 `pip install` 任何第三方包。
    
    ```bash
    # 单次运行引擎(输出预测 JSON 到 stdout)
    python3 5minbtc-engine-v6.0.py
    
    # 单独跑新闻扫描
    python3 5minbtc-news.py
    
    # 结算上一根 K 线 + 追加新预测
    python3 5minbtc-log.py settle-all
    python3 5minbtc-log.py log "<candle.iso>" <pred_close> <pred_high> <pred_low> \
        <conf> <bias> <news_sent> <vol_pct>
    ```
    
    引擎输出示例(节选):
    
    ```json
    {
      "version": "5.7.3",
      "candle": { "progress_pct": 72.3, "...": "..." },
      "indicators": { "ema9": 61950.1, "rsi": 47.2, "atr": 85.4, "...": "..." },
      "factors": { "half_body": -0.31, "momentum": -0.42, "...": "..." },
      "regime": "TREND",
      "news_risk": "NORMAL",
      "prediction": {
        "bias": "bear", "strength": "moderate",
        "confidence": 48, "pred_close": 61920, "pred_high": 61960, "pred_low": 61870
      }
    }
    ```
    
    ## 完整运行流程
    
    完整的"引擎 + LLM"混合流程由 cron 每 5 分钟触发:
    
    ```bash
    SKILL_DIR=/path/to/5minbtc
    
    # 1. 并行执行:结算 + 引擎 + 新闻
    python3 $SKILL_DIR/5minbtc-log.py settle-all
    python3 $SKILL_DIR/5minbtc-engine-v6.0.py
    python3 $SKILL_DIR/5minbtc-news.py
    
    # 2. LLM 侧:3 路并行新闻搜索
    #    - "Bitcoin BTC breaking news price"
    #    - "crypto market macro stocks today"
    #    - "比特币 BTC 最新 晚间"
    
    # 3. LLM 综合引擎 JSON + 新闻 → 按模板输出(15–25 行)
    
    # 4. 写入预测日志
    python3 $SKILL_DIR/5minbtc-log.py log "<candle.iso>" <pred_close> ...
    ```
    
    > 💡 用 `cp .env.example .env` 并设置 `SKILL_DIR` 指向你的克隆目录,可避免把路径写死。详见 [配置说明](#配置说明)。
    
    ## 目录结构
    
    ```
    5minbtc/
    ├── 5minbtc-engine-v6.0.py     # 主引擎(cron 调用,输出预测 JSON)
    ├── 5minbtc-engine-v5.py       # v5 旧版(回测因子模块 import 用)
    ├── 5minbtc-news.py            # 新闻扫描(CoinDesk RSS)
    ├── 5minbtc-log.py             # 日志记录 + settle
    ├── SKILL.md                   # 技能索引文档(Hermes/Claude skill 格式)
    ├── README.md                  # 本文件
    ├── .env.example               # 配置模板
    ├── 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/                  # 缓存的 K 线 JSON
    │   └── results/               # 回测结果(.gitignore)
    ├── references/                # 深度文档(架构/教训/pitfalls/黑天鹅…)
    ├── reviews/                   # 每日复盘报告(按月归档)
    ├── scripts/                   # 辅助脚本
    └── data/                      # 运行时数据(新闻风险等级,.gitignore)
    ```
    
    ## 回测系统
    
    ```bash
    cd backtest
    
    # 一键回测(下载最新数据 + 运行)
    ./run.sh
    
    # 快速模式(每小时采样,最近 180 天)
    ./run.sh --fast
    
    # 最近 90 天,每 6 根 K 线采样
    ./run.sh --days 90 --sample=6
    
    # 完整因子贡献分析
    ./run.sh --full-report
    
    # 模拟 K 线进度(progress=0.5 = 中段)
    python3 run_backtest.py --progress=0.5
    ```
    
    **公平性保障**:
    - 无前视偏差(当前 K 线价格信息被屏蔽:c=h=l=open, v=0)
    - 因子仅基于 200 根已完成 K 线计算
    - 回测中订单簿不可获取,imbalance/microprice 设为 0
    
    详见 [`backtest/README.md`](backtest/README.md)。
    
    ## 性能快照
    
    > 以下为历史实测数据,**过去表现不代表未来收益**,且小样本下统计显著性有限。
    
    | 版本 | 设定 | 方向准确率 |
    |------|------|-----------|
    | v4.x | 实盘 | 62.5% |
    | v5.7.1 | 实盘 273 轮 | **75.7%** (+13.2pp) |
    | v5.8 | 回测(前 2 根 1min) | 61.4% |
    | v5.8 | 回测(前 4 根 1min) | 69.5% |
    
    ⚠️ 见 [`references/backtest-findings.md`](references/backtest-findings.md):公平回测下纯价格因子无预测力。实盘高胜率很可能部分来自小样本 + K 线后段信息优势,并非稳定 edge。**在 edge 来源明确前,不应按高胜率预期下注。**
    
    ## 配置说明
    
    当前引擎**不读取任何环境变量**——所有参数(symbol、interval、HTTP timeout、ATR 乘数、因子权重)均硬编码在 `.py` 源码中,这保证了 cron 调用的零配置可复现性。
    
    `.env.example` 列出了**建议配置化**的项(当前为预留/文档用途),供希望二次开发的用户参考。如需让引擎实际读取这些变量,需要修改对应源码(欢迎 PR)。
    
    主要硬编码常量位置:
    
    | 常量 | 默认值 | 位置 |
    |------|--------|------|
    | `symbol` | `BTCUSDT` | `fetch_klines()` / `fetch_depth()` 形参 |
    | `interval` | `5m` | `fetch_klines()` 形参 |
    | HTTP timeout | `5`–`10` s | `urlopen()` 调用 |
    | ATR 乘数 | `0.55` | `predict_close_v5()` |
    | `BASE_W` | 因子权重表 | 模块级常量 |
    | `REGIME_ADJ` | Regime 权重调整 | 模块级常量 |
    
    ## 已知局限
    
    1. **回测与实盘的差距**:公平回测下因子无预测力,实盘 edge 主要来自 K 线后段信息优势(可能不稳定的"半前视")。
    2. **订单簿简化**:仅用 top-20 深度,未实现完整的 OFI(Cont et al. 2014)与 microprice 模型。
    3. **新闻延迟**:CoinDesk RSS 约 14 分钟延迟,无法捕捉瞬时冲击。
    4. **SSL 验证禁用**:引擎全局设置 `ssl._create_unverified_context`,是为对抗高延迟网络下的 SSL 握手超时(见 `references/high-latency-network-handling.md`)。在可信网络环境下可安全恢复验证。
    5. **无自动交易**:本项目只输出预测,不执行任何下单。
    
    ## 路线图
    
    - ✅ **OFI 微结构因子**(v6.0 已落地):引擎现由真 OFI 净流一票决定方向 + `P(close>open|ofi)` 概率,
      见 [SKILL.md 架构](SKILL.md#架构-1-行组件) 与 [strategy-adversarial-review.md](references/strategy-adversarial-review.md)
    - 🟡 HMM Regime 检测 + 自适应仓位
    - 🟡 LightGBM 自动化因子筛选
    - 🟡 CVaR 动态止损
    - 🟢 TFT 多时间尺度模型替代贝叶斯引擎
    
    > 原 `references/architecture.md`(13 因子模型 + 升级路线图)已于 2026-09-10 删除:
    > 其"13 正交因子"描述被 v5.9 清零、OFI 也已从路线图变为已实现,内容已由
    > [changelog.md](references/changelog.md) 与 [SKILL.md](SKILL.md) 取代。
    - 🟢 Deribit 期权 IV 信号
    
    ## 免责声明 (NOT FINANCIAL ADVICE)
    
    本项目是**量化研究与教育项目**,不构成投资建议、交易信号或任何形式的财务建议。
    
    - 加密货币市场波动剧烈,交易可能导致**全部本金损失**。
    - 引擎预测存在显著误差,历史准确率不代表未来表现。
    - 作者与贡献者对任何基于本项目的交易决策**不承担责任**。
    - 请在了解当地法律法规的前提下自行承担风险。
    
    如本项目对你有帮助,欢迎 Star。但**请勿**将其视为稳赚的交易工具。
    
    ## License
    
    本项目暂未指定开源许可证。如需使用、修改或分发代码,请先联系作者或等待 License 文件添加。在未指定 License 前,根据默认版权法,代码保留全部权利(仅供阅读与学习)。
    
  • SKILL.md 16.9 KB
    ---
    name: 5minbtc
    version: 6.0.0
    description: "BTC 5分钟K线实时方向预测 + 币安预测市场错价套利(paper)。v6.0 真OFI驱动: 方向由当前K线原生 in-candle OFI 净流一票决定(ofi_n=2*(tb/v)-1, REST klines[9] 聚合, 零WS依赖; WS ofi.json 做新鲜度反转保护与交叉校准), 概率=P(close>open|ofi) 经验校准表+Bayesian shrink, edge=EV=p−ask 错价检测, 方向二选一无中性。13因子自v5.9起收敛到3个有证据信号且不再决定bias。黑天鹅防护: ATR spike+FNG<25。launchd 常驻 realtime/watch/trader。⚠️ Binance 端点**人工**双向切换(引擎为单端点硬依赖,无自动故障切换;2026-09-11 曾因 data-api SSL 失败静默断档 6h)。"
    triggers:
      - 5minbtc
      - 5min btc
      - btc 5min
    tools:
      - terminal
      - web
    ---
    
    # 5minbtc — BTC 5分钟实时预测 v6.0.0
    
    > BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。
    > **SKILL.md 是索引, 详细内容见 `references/`。**
    > **v5.9 认知转变**: 从"13因子预测器"→"3信号错价检测器" — 方向准确率不是 edge, `EV = p − P − 成本` 才是 (见 [对抗式审查报告](references/strategy-adversarial-review.md))
    > **v6.0 执行转变**: 方向从"body 延续统计"改成**真 OFI 净流一票决定** — 赌的是"净流已发生、token 价还没定价"的 flow-gap
    
    > ⚠️ **同名易混**: 本 skill 只做 BTC 单标的 5min 方向 + 预测市场 EV。要做全市场永续的量价突破扫描, 用 [`coin-vp-scanner`](../coin-vp-scanner/SKILL.md) — 两者区别见下方 [与 coin-vp-scanner 的分工](#与-coin-vp-scanner-的分工)。
    
    ## 触发
    `5minbtc` / `5min btc` / `btc 5min` / `监控` (配合持续盯盘)
    
    ## 何时使用
    | 场景 | 做法 |
    |------|------|
    | 当前 5min K线 方向+价位 | ✅ 标准流程, **方向=OFI 净流, edge=错价 EV** (v5.8 零前视回测 61.4% 是延续性不是 alpha, 见性能快照) |
    | 会话内持续盯盘, 等明确信号 | ✅ 监控模式 (scripts/5minbtc-monitor.py + Monitor 工具) |
    | 币安预测市场 Up/Down 5m 交易 | ✅ paper 模拟/实时监控 (见 [预测市场策略](references/prediction-market-strategy.md)) |
    | "今晚 BTC 涨跌" (宽窗口) | ⚠️ 跑当前 K线 + 给方向倾向, 标注"超出引擎置信区间" |
    | "下根 K线" / "1小时后" | 引导在该 K线 起始时间再触发 |
    
    ## 监控模式 (Claude Code)
    
    > 详见 [monitoring-claude-code.md](references/monitoring-claude-code.md)
    
    ```bash
    # 无限持续, 直到用户喊停 (会话内盯盘推荐)
    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 scripts/test_engine.py` (13 项, 自带 runner **无需 pytest**; 慢测加 `--slow`)
      — 装了 pytest 也可 `python3 -m pytest scripts/test_engine.py -v`
      (原文件名 `test_engine_v58.py` 带版本号, 引擎升到 v6.0 后即漂移, 2026-09-10 改为不带版本号)
    
    ## 快速开始
    
    ```bash
    SKILL_DIR=$HOME/.hermes/profiles/cqo/skills/5minbtc
    
    # 1. 并行: 引擎 + 新闻 + settle (前一根)
    python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1
    python3 $SKILL_DIR/5minbtc-engine-v6.0.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-v6.0.py` (v6.0, 输出 `"version": "6.0.0"`): **bias 由真 OFI 净流一票决定** (ofi_n>0→bull / <0→bear, **二选一无中性**; ofi_n 缺失/为0 用 body 符号兜底并标 `meta.body_fallback`) + **概率 `P(close>open|ofi)`** 三层(经验校准表 Bayesian shrink + flow-gap + 最近60s流) + 三层独立过滤(多周期4h/1h/15m 结构 + 跨资产ETH/SOL 广度 + WS OFI 新鲜度反转保护) + 9路并行HTTP
      - ⚠️ **K 线开局阶段概率不可信**(已知问题,见 [pitfalls](references/pitfalls.md)):主源 `ofi_n = 2*(tb/v)−1` 取自**当前进行中**的 K 线,`_ofi_native()` 只挡 `v<=0`、**无最小样本量保护** → 开局几秒的少量成交就能把 ofi_n 推到 ±0.9。而 `vol_gate`(L692 按 `MIN_VOL_FRAC=0.25` 判断流量是否够)**算出来但从不参与任何决策**,只是输出里的装饰字段。**建议只在进度 ≥40% 后采信概率/下单**
      - 门限: `T_OFI_GATE=0.20` / `T_OFI_60=0.35` / WS 质量闸 `OFI_CR_MIN=0.80` / `OFI_BAYES_N=30`
      - **13 因子仍计算并输出**(JSON 契约保留), 但自 v6.0 起**不参与 bias 决策** — score 只用于 `strength` 标签与 LLM 参考
    - **订单流** `scripts/ofi_feed.py`: trade+bookTicker 组合流 tick规则推断主动买卖, 写 `~/bb-auto/ofi.json`, 带 ts 保鲜(>30s 引擎降级为只信 REST 主源) (launchd: com.daniel.ofi-feed)
    - **日志** `5minbtc-log.py`: jsonl 追加 + 增量 settle (写入 logs/)
    - **新闻** `5minbtc-news.py`: CoinDesk RSS (唯一稳定源, ~14min 延迟)
    - **常驻进程** (launchd): `5minbtc_realtime.py` (5s 刷新, 预测快照+EV下单) / `5minbtc_watch.py` / `5minbtc_trader.py --paper-monitor`
    - **LLM**: 因子打分基准 + LLM 综合裁决 + 模板输出
    
    ## 铁律
    1. 每次必须重新执行引擎脚本 — 不缓存
    2. 每次必须重新搜索3组新闻
    3. 先 settle 上一根, 再 log 新预测
    4. LLM 可微调引擎的 `pred_close`/range, 但必须说明理由
       ⚠️ **bias 不要轻易覆盖** (v6.0): 方向是 OFI 一票决定的, LLM 用因子/新闻翻方向 = 退回被证伪的路径。
       仅在 `meta.body_fallback=True` 或 OFI 数据缺失时才允许改 bias, 并显式写明原因。
    5. 输出 15-25 行 (平衡深度和 Telegram 可读性)
    
    ## 关键裁决规则 (⚠️ 历史规则: v5.7.x 因子打分路径)
    
    > **v6.0 起 bias 由真 OFI 一票决定, 下列规则不再决定方向。** 仅在两条兜底路径上仍有参考价值:
    > ① `meta.body_fallback=True` (ofi_n 缺失/为0, 方向退回 body 符号) ② LLM 复核时解释 `meta` 冲突字段。
    > 引擎的 `raw score` 仍输出, 但只影响 `strength` 标签, 不影响 bias。
    
    - **half_body vs imbalance 冲突** (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body <sub>(注: 两者自 v5.9 起权重已清零)</sub>
    - **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-09-10 更新)
    
    > 数字口径以 [对抗式审查报告](references/strategy-adversarial-review.md) 为准 — 旧数字多数含前视偏差。
    
    - **v5.7 回测 71.2% 含前视偏差**(文件里自己标注"已知"); 零前视 v5.8: 前2根1min=**61.4%**, 前4根=69.5%
    - 但 61–70% 是"看着 K 线走完再确认"的延续性, **不是 alpha** — 做市商已把它定价进 token 价
    - 去掉水分后的真实基准: non-neutral 方向 **57.7%** | bull **63.9%** (唯一显著) | **bear 50.0% = 纯硬币**
    - paper 交易: 全样本 UP 成交 **44%** (+$0.24) | 甜区 UP ask 0.40–0.50 → **60%** (+$1.39) ← 唯一正 EV 区间
    - **结论: edge 不在方向准不准, 在 `EV = p − P − 成本 > 0`。v6.0 的错价检测(flow-gap)就是直接做这件事。**
    - 当前 LLM: `zai/glm-5.2` (8-15s/次) | opencaio 实测 MiniMax-M3 ~2.7s 可作更快选项
    
    ## 📚 引用索引 (references/)
    
    ### 核心方法论
    - [strategy-adversarial-review.md](references/strategy-adversarial-review.md) — **对抗式审查报告: 第一性原理 + 13因子证伪 + 该留/删/缺失 + P0/P1/P2行动清单** (v5.9 依据)
    - [lessons.md](references/lessons.md) — **25 条核心教训** (必读, 含 2026-07-05 新增 23-25)
    - [pitfalls.md](references/pitfalls.md) — **20 条 pitfalls 集中索引** (必读, 含并行 max() 评估陷阱; #18 = K线开局概率不可信; #19 = "真OFI" 只覆盖单一市场; #20 = 端点故障致静默断档)
    - [changelog.md](references/changelog.md) — v5.0 ~ v6.0 详细变更
    - [skill-organization.md](references/skill-organization.md) — **Skill 文件结构模式 (可复用)** — SKILL.md INDEX + references/ 分专题
    
    ### 执行与输出
    - [execution.md](references/execution.md) — 完整执行步骤 + 铁律 + 宽窗口处理
    - [output-template.md](references/output-template.md) — LLM 输出模板 + 裁决规则
    - [monitoring-claude-code.md](references/monitoring-claude-code.md) — **监控模式: Monitor 工具集成 + 事件协议**
    - [telegram-push-monitor.md](references/telegram-push-monitor.md) — **Telegram 推送 daemon: watch 采样节奏/事件类型/记录与结算/launchd 持久化**
    - [prediction-trading-cli.md](references/prediction-trading-cli.md) — **币安预测交易 CLI: 5minbtc_trader.py 用法/参数/安全契约/API端点 (含 --paper/--paper-monitor 模拟)**
    - [prediction-market-strategy.md](references/prediction-market-strategy.md) — **预测市场盈利策略: EV=p−P, 价格门控, 凯利仓位, paper 模拟**
    
    ### 数据源 & 网络
    - [news-sources.md](references/news-sources.md) — 新闻源评估 (清理后只剩 CoinDesk)
    - [binance-api-geo.md](references/binance-api-geo.md) — Binance 端点区域问题
    - [binance-endpoint-flapping.md](references/binance-endpoint-flapping.md) — 端点双向故障切换
    - [high-latency-network-handling.md](references/high-latency-network-handling.md) — 高延迟网络处理 (SSL 超时)
    
    > Binance 三种故障模式各一份(431/451 区域、隧道抖动、高延迟 SSL 超时),**不是重复文档**,见 [setup-from-scratch.md §6](references/setup-from-scratch.md#6-网络地区修复geo)。
    
    ### 引擎专项
    - [cron-llm-provider-failure.md](references/cron-llm-provider-failure.md) — Cron LLM Provider 失效诊断 (含 job 列表 §8) + 版本同步规则
    
    ### 回测 & 复盘
    - [backtest-findings.md](references/backtest-findings.md) — 365 天回测深度复盘 + 因子无预测力
    - [backtest-v58-1min-findings.md](references/backtest-v58-1min-findings.md) — v5.8 真实 1min 半 K线回测
    - [review-procedure.md](references/review-procedure.md) — 每日复盘流程 + 数据质量检查
    
    ### 数据采集 & 仓库
    - [sync-procedure.md](references/sync-procedure.md) — AGI-Super-Team 同步流程 (路径映射 + `-c` 校验 + logs 归档策略)
    - [archive.md](references/archive.md) — **版本归档: v5.0→v6.0 沿革 + 哪些版本已不可取回 + 归档 SOP**
    - [setup-from-scratch.md](references/setup-from-scratch.md) — **从零搭建: 依赖/目录/密钥/6 个 launchd 服务/验证清单/日志轮转/故障表**
    - [scheduled-tasks.md](references/scheduled-tasks.md) — **系统级定时任务教程: 常驻型vs定时型 / 2 个任务 / launchd+cc-connect+hermes 三路线 / plist 模板 / 13 条坑**
    - [quant-knowledge-index.md](references/quant-knowledge-index.md) — 50 轮蒸馏知识库索引
    
    ## 复盘记录
    
    ⚠️ **`reviews/` 目录本地不存在** —— 早期文件树声称有 23 份按月归档的复盘记录(2026-05/06/07),实际从未落盘。
    复盘结论目前散落在 [lessons.md](references/lessons.md)、[pitfalls.md](references/pitfalls.md)、
    [strategy-adversarial-review.md](references/strategy-adversarial-review.md) 与 `reports/` 里。
    若要恢复这个习惯,需先补 `review-procedure.md` 的落盘步骤,别只在文档里声明。
    
    ## 报告库
    14 份深度蒸馏报告在 `reports/` 目录 (也同步在 AGI-Super-Team): R01-R14。
    
    ## 与 coin-vp-scanner 的分工
    
    两个都是交易类 skill, **但赌的不是同一件事, 不要混用**:
    
    | | **5minbtc** (本 skill) | [coin-vp-scanner](../coin-vp-scanner/SKILL.md) |
    |---|---|---|
    | 标的 | **单标的 BTC** | 全量币安 USDT 永续 |
    | 周期 | 单根 5min K线 | 1–30min 短线 |
    | 核心逻辑 | **真 OFI 净流 + 错价检测** (净流已发生、token 价未定价 → flow-gap) | **确定性结构突破** (放量 + 强实体 + 收盘破 1h 结构位 + 趋势同向, 四条全 ✓) |
    | 决策依据 | 概率 `P(close>open\|ofi)` vs 市场 token 价 → `EV = p − P` | 结构规则布尔判定, 非概率 |
    | 输出 | 方向 bull/bear + 概率 + edge | 杠杆 / TP / SL 交易卡 |
    | 落地方式 | 预测市场 Up/Down token, **仅 paper** (`LIVE_GATE` 硬闸门) | 直接做合约短线 |
    | 代码位置 | 本目录自包含 (引擎+脚本+launchd) | 代码在 `~/projects/coin-vp-scanner/`, 本 skill 只是索引 |
    
    **一句话选型**: 要赌"市场定价错了" → 5minbtc; 要抓"价格放量破位了" → coin-vp-scanner。
    
    ## 仓库同步
    详见 [sync-procedure.md](references/sync-procedure.md)。简述:
    ```bash
    rsync -av --exclude='data/' --exclude='__pycache__/' \
      --exclude='*.jsonl' --exclude='*.jsonl.*' --exclude='*.gz' \
      $HOME/.hermes/profiles/cqo/skills/5minbtc/ \
      $HOME/clawd/repos/AGI-Super-Team/skills/5minbtc/
    cd $HOME/clawd/repos/AGI-Super-Team
    git add skills/5minbtc/ && git commit -m "sync(skills/5minbtc): <版本>" && git push origin main
    ```
    
    ## 回测系统
    ```
    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-v6.0.py        # 主引擎 (v6.0 真OFI 一票定方向, launchd 调用)
    ├── 5minbtc-news.py               # 新闻扫描 (CoinDesk RSS, 唯一稳定源)
    ├── 5minbtc-log.py                # 日志记录 (写入 logs/)
    ├── logs/                         # 日志 (当月 live + 历史按月压缩)
    │   ├── 5minbtc-log.jsonl         # 当月 live (不入库)
    │   └── archive/*.jsonl.gz        # 月度压缩归档 (入库, 见 archive.md)
    ├── references/                   # 24 份专项 ref (含 skill-organization 模式)
    ├── backtest/                     # 回测系统 (results/ 不入库)
    ├── 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, launchd com.daniel.ofi-feed)
    │   ├── 5minbtc_keyless_paper.py  # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价)
    │   ├── telegram_push.py          # 通用 Telegram 推送助手
    │   ├── daily-review-stats.py
    │   └── fetch-github-repo.sh
    ```
    
    > ⚠️ **`archive/` 目录与 `reviews/` 目录本地并不存在** —— 本文件早期版本的文件树里声称有它们(还列了 23 份复盘),属于文档/现实漂移,已更正为上面的实际结构:
    > - 旧版本引擎源码**不保留在本地**,只留文字归档 → [references/archive.md](references/archive.md)
    > - 每日复盘从未落盘到 `reviews/`,复盘结论散在 `references/lessons.md` / `pitfalls.md` 与 `reports/`
    
    
    ---
    最后更新: 2026-09-10 — 引擎 v5.7→**v6.0** 改名 (文件/SKILL/引用全线对齐, 修引擎内"无中性"过期注释) + SKILL.md 版本刷到 6.0.0 + 性能快照改为审查后的诚实口径 + 补 v5.9/v5.10/v6.0 changelog + 新增与 coin-vp-scanner 的分工说明 + **修文件树未闭合的代码块与 `archive/`/`reviews/` 假目录声明** + 新增 [archive.md](references/archive.md) 与 [setup-from-scratch.md](references/setup-from-scratch.md) + logs 月度压缩归档入库
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.