# tradehk 开发历史与 TODO

> 返回：[tradehk 文档中心](./README.md)
> 源文件：`ideas.md`、`notes-indicator-status.txt`、`todo.md`

## 项目演进概述

tradehk 从一个简单的 K 线图工具逐步演进为完整的量化交易终端，核心功能按以下顺序开发：

```
K线图显示 → 技术指标 → 信号引擎 → 飞书通知 → EWO专项通知 → 自动交易
```

---

## 已完成功能

### 基础功能

- [x] Binance 实时 K 线图（lightweight-charts）
- [x] 多币对监控（Watchlist 管理）
- [x] 多周期切换（1m ~ 1M）
- [x] 深色专业交易终端 UI（Elite Dark Dashboard）
- [x] 用户认证（JWT + Manus OAuth）

### 技术指标（16个）

- [x] MA（简单移动平均线）
- [x] EMA（指数移动平均线）
- [x] EWO（艾略特波浪振荡器）
- [x] MACD（10, 20, 10 参数）
- [x] AO（动量振荡器）
- [x] RSI（相对强弱指数）
- [x] KDJ（随机指标衍生版）
- [x] Stoch（随机指标）
- [x] StochRSI（随机相对强弱指数）
- [x] 布林带（Bollinger Bands）
- [x] MFI（资金流量指数）
- [x] OBV（能量潮）
- [x] DMI/ADX（趋向运动指标）
- [x] SuperTrend（超级趋势指标）
- [x] ATR（平均真实波动幅度）
- [x] TTM Squeeze（挤压动量指标）

### 信号系统

- [x] 多指标共振评分引擎（generateSignal）
- [x] 动态强度阈值（根据启用指标数调整）
- [x] 信号持久化（MySQL signals 表）
- [x] 信号去重（同币同方向同时间戳）
- [x] 大周期偏向判定（assessBigTimeframeBias）

### 通知系统

- [x] 飞书 Webhook 推送
- [x] EWO 转换专项通知（红→绿 / 绿→红）
- [x] 信号通知（可选，all_signals 模式）
- [x] 定期汇总通知（每N小时）
- [x] 信号推送频控（冷却时间可配置）
- [x] EWO 转换去重（全局共享去重槽）

### 部署

- [x] Docker Compose 部署
- [x] Nginx 反向代理
- [x] MySQL 数据库
- [x] 一键部署脚本（deploy.sh）
- [x] 数据库迁移（Drizzle Kit）

---

## 待开发功能（TODO）

以下内容来自 `ideas.md` 和 `todo.md`，按优先级排列：

### 高优先级

| 功能 | 说明 | 难度 |
|------|------|------|
| EWO 穿越强度过滤 | 对微弱穿越（如 SOL 0.044）添加警告或过滤 | 低 |
| 品种自适应阈值 | 不同币种使用不同的 EWO 绝对值/相对值阈值 | 中 |
| 大周期偏向粘性 | 连续3次确认才切换大周期方向，避免频繁切换 | 低 |
| 通知加入大周期信息 | EWO 转换通知中附带 4h 大周期方向 | 低 |

### 中优先级

| 功能 | 说明 | 难度 |
|------|------|------|
| MTF 三层联动 | 4h→1h→10m 三层周期联动过滤 | 高 |
| 阶段持续时间奖励 | EWO 阶段持续时间越长，穿越信号越可靠 | 中 |
| 成交量确认 | 穿越时成交量放大才确认信号 | 中 |
| 价格突破通知 | 价格突破关键阻力/支撑位通知 | 中 |
| 移动止损 | 基于 ATR 的动态止损线 | 高 |

### 低优先级 / 探索中

| 功能 | 说明 | 难度 |
|------|------|------|
| 链上数据集成 | 接入 Glassnode/Coinglass 链上指标 | 高 |
| 情绪指标 | 恐惧贪婪指数、资金费率集成 | 中 |
| 回测功能 | 历史数据回测信号胜率 | 高 |
| 多交易所支持 | 接入 OKX、Bybit 等 | 高 |
| 移动端适配 | React Native 移动端 | 极高 |

---

## 指标开发状态

来自 `notes-indicator-status.txt`：

| 指标 | 计算状态 | 图表显示 | 信号评分 | 备注 |
|------|---------|---------|---------|------|
| MA | ✅ 完成 | ✅ 完成 | ✅ 完成 | 主图叠加 |
| EMA | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 主图叠加，用于 EWO/MACD 计算 |
| EWO | ✅ 完成 | ✅ 完成 | ✅ 完成 | 核心指标，权重最高 |
| MACD | ✅ 完成 | ✅ 完成 | ✅ 完成 | 使用 (10,20,10) 非标准参数 |
| AO | ✅ 完成 | ✅ 完成 | ✅ 完成 | |
| RSI | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认开启 |
| KDJ | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认关闭 |
| Stoch | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认关闭 |
| StochRSI | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 仅图表显示 |
| 布林带 | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认开启 |
| MFI | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 仅图表显示 |
| OBV | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 仅图表显示 |
| DMI/ADX | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认关闭，需 ADX>25 |
| SuperTrend | ✅ 完成 | ✅ 完成 | ✅ 完成 | 默认关闭 |
| ATR | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 被 SuperTrend/DMI 内部使用 |
| TTM Squeeze | ✅ 完成 | ✅ 完成 | ❌ 无独立评分 | 仅图表显示 |

**待添加评分的指标**：MFI、OBV、StochRSI、TTM Squeeze（这些指标已有计算和显示，但尚未集成到信号评分引擎中）

---

## 设计理念

tradehk 的设计遵循以下原则：

**1. 已收线确认优先**：所有信号和通知均基于已收线的 K 线，避免未收线数据的噪音。

**2. 去重和频控并重**：EWO 转换使用去重（同转换只推一次），信号通知使用频控（冷却时间），两种机制针对不同场景。

**3. 动态阈值适应**：信号强度阈值根据启用的指标数量动态调整，确保信号质量一致性。

**4. 用户配置优先**：所有参数（指标参数、通知设置、监控规则）都可以用户级别配置，不强制全局统一。

---

## 相关优化建议

基于源码分析，以下是最值得优先落地的改进：

1. **EWO 穿越幅度过滤**（1-2天工作量）：在 `indicators.ts` 约第 481 行加入品种阈值判断
2. **通知加入大周期信息**（半天工作量）：在 `marketEngine.ts` 第 682 行附近加入 4h EWO 方向
3. **大周期偏向粘性**（1天工作量）：在 `assessBigTimeframeBias` 调用处加入连续确认计数

详见：→ [优化建议汇总](./优化建议汇总.md)

## 相关文档

- [优化建议汇总](./优化建议汇总.md) — 完整优化路线图
- [信号评分引擎](./信号评分引擎.md) — 当前信号机制
- [EWO 阈值过滤完整流程](../../12_信号系统优化/EWO阈值过滤完整落地流程.md) — 优化详细说明