feat: 新增 tradehk 专属 Wiki 文档体系（10个文档）

- 系统架构总览：技术栈、目录结构、数据流向 - 指标引擎详解：16个指标完整原理与参数（含源码行号） - 信号评分引擎：多指标共振评分机制、动态阈值、案例分析 - 大周期偏向判定：assessBigTimeframeBias 完整说明 - EWO转换检测机制：evaluateEwoTurnForUser 逐步流程 - 飞书通知格式规范：三类通知完整格式模板 - 类型系统参考：所有 TypeScript 类型完整文档 - 数据库与存储：MySQL 表结构、缓存机制、维护指南 - 部署运维指南：Docker Compose、Nginx、飞书配置 - 开发历史与TODO：功能状态表、优先级路线图 - 优化建议汇总：9项优化建议含源码位置和预期效果
2026-03-05 23:14:31 -05:00
--- a/wiki/tradehk/开发历史与TODO.md
+++ b/wiki/tradehk/开发历史与TODO.md
@@ -0,0 +1,162 @@
+# 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) — 优化详细说明