docs: v2.x 状态对齐 — dev.md 标废弃 + AGENTS/harness-health 更新
dev.md 是 v1 设计稿但路线图已与 README 冲突;加废弃声明 + 优先级表,
指向 README / AGENTS / ai/adr 作为权威来源。AGENTS §2 与 harness-health
同步 v2.x 进度(Bollinger / Vegas / derivatives signal ✅;per-interval
完整化 + 箱体 + CI 未完)。README 路线图分段 v2.0/v2.x/v3,与 G12 守卫
扩白名单(derivatives_signal.go)保持一致。
This commit is contained in:
21
AGENTS.md
21
AGENTS.md
@@ -1,6 +1,8 @@
|
||||
# AGENTS.md — cryptoHermes 操作指南
|
||||
|
||||
本文件是 AI 编码代理在此仓库工作的最小操作手册。完整项目设计见 `docs/dev.md`,用户向文档见 `README.md`。
|
||||
本文件是 AI 编码代理在此仓库工作的最小操作手册。用户向文档见 `README.md`,harness 健康度见 `ai/harness-health.md`。
|
||||
|
||||
`docs/dev.md` 是 v1 初始设计稿,**路线图与当前状态判断不再以它为准**(见该文件顶部废弃声明);其余章节作为设计源头仍可参考。
|
||||
|
||||
---
|
||||
|
||||
@@ -22,11 +24,20 @@ cryptoHermes 是给上游 Hermes 量化分析引擎用的 **Binance Futures 行
|
||||
|
||||
---
|
||||
|
||||
## 2. 当前状态
|
||||
## 2. 当前状态(2026-05-25)
|
||||
|
||||
- v1 MVP 已完成(Milestone 1-5),可启动、可采集、可返回完整 `/v1/market/context`
|
||||
- Technical 指标计算(Milestone 6)留待 v2
|
||||
- 详细路线图见 `docs/dev.md` 第 19 章和 README "路线图"段
|
||||
- **v1 MVP**:✅ 已完成。`/v1/market/context` 可返回 K 线 / Funding / OI / 多空比 / Taker 主动量,cron 全部上线。
|
||||
- **v2.0**:✅ 已完成。primary `1h` 周期的 Pivot S/R + P95/P5 区间 + LSR 穿越价位中位数;算法层 `indicator.go` 单测覆盖 ~98%,repo / mapper 关键路径有 pgxmock / table-driven 覆盖。
|
||||
- **v2.x**:🟡 **进行中**。
|
||||
- ✅ Bollinger(SMA20 + 2σ + Squeeze)、Vegas(EMA12/144/169 + 趋势)已落地并有单测(`internal/usecase/indicator.go` + `indicator_test.go`)。
|
||||
- ✅ Derivatives signal(funding / OI / LSR → 语义化字段)已加(`derivatives_signal.go` + 表驱动测试)。
|
||||
- ⚠️ per-interval 只到 `IntervalTechnicals`(BB + Vegas),**未升级到完整 `map[interval]TechnicalStructure`**(Support / Resistance / Range / LSLine 仍只在 primary `1h`)。是否升级需要 ADR 锁定决策。
|
||||
- ⚠️ 箱体(per-interval 突破信号)未实现;目前只有顶层 `RangeHigh/Low` 沿用 v2.0 的 P95/P5。
|
||||
- ❌ testcontainers 集成测试未起。
|
||||
- ❌ CI(GitHub Actions / 任何托管 CI)未起,仓库无 `.github/`。harness-health W3 长期挂 partial。
|
||||
- **v3**:未启动。`docs/coinglass/` 是 v3 的提前侦察(私有 API 解密 + endpoint 索引),**当前阶段不接入**,详见该目录 README。
|
||||
|
||||
详细路线图段以 `README.md` 末尾 "路线图" 为准。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user