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:
dela
2026-05-25 10:43:24 +08:00
parent fa769331c2
commit 319e73d91f
4 changed files with 53 additions and 18 deletions

View File

@@ -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**:🟡 **进行中**
- ✅ BollingerSMA20 + 2σ + Squeeze、VegasEMA12/144/169 + 趋势)已落地并有单测(`internal/usecase/indicator.go` + `indicator_test.go`)。
- ✅ Derivatives signalfunding / 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 集成测试未起。
- ❌ CIGitHub Actions / 任何托管 CI未起仓库无 `.github/`。harness-health W3 长期挂 partial。
- **v3**:未启动。`docs/coinglass/` 是 v3 的提前侦察(私有 API 解密 + endpoint 索引),**当前阶段不接入**,详见该目录 README。
详细路线图段以 `README.md` 末尾 "路线图" 为准。
---