Add modular docs with index, WeChat templates, and AI guide.

Document per-module order logic, risk rules, and WeChat message templates with a central INDEX for navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/KEY_MONITORS.md

@@ -4,6 +4,8 @@
 
 关键位监控用于在指定价格区间上设置 **5 分钟收盘** 触发规则，分为 **自动单**（箱体/收敛突破）与 **仅微信提醒**（关键支阻区）两类。
 
+**文档索引**：[INDEX.md](./INDEX.md) · 微信模板：[WECHAT.md §6–§8](./WECHAT.md) · 风控：[RISK.md](./RISK.md)
+
 ---
 
 ## 监控类型
@@ -30,7 +32,7 @@
 |------|------|
 | 区间 | **上沿 = 阻力**，**下沿 = 支撑**，合并为一个关键支阻区 |
 | 触发 | 5m 收盘突破上沿或跌破下沿 |
-| 推送 | 企业微信，格式含突破方向、触发收盘、区间上下沿等 |
+| 推送 | 企业微信，见 [WECHAT §8](./WECHAT.md#8-关键支阻区提醒) |
 | 次数 | 最多 **3 次**，间隔约 **5 分钟**（人工盯盘提醒） |
 | 自动开仓 | **否** |
 | 结案 | 第 3 次推送后自动归档 |
@@ -61,4 +63,31 @@
 - 自动单逻辑：`key_monitor_lib.py` + `install_trading._execute_key_breakout`  
 - 止盈止损监控：`sl_tp_guard.py`（移动保本 + 显式止盈价可同时生效）  
 
-详见 [FEATURES.md](./FEATURES.md) 功能总览。
+## 下单逻辑（自动单）
+
+1. 后台 `background_task` 约每 3 秒调用 `run_key_monitor_check()`。
+2. 拉取 5m K 线（优先 CTP），判断收盘价是否突破上/下沿。
+3. **箱体突破 / 收敛突破**：
+   - 顺势/反转决定方向（上破做多或做空等）。
+   - 校验：交易时段、CTP、`assert_can_open()`、[RISK.md](./RISK.md) 全部规则。
+   - 手数：按 `risk_percent` + `max_margin_pct` 计算。
+   - **止损**：突破 K 线最低（多）/ 最高（空）± **2 跳**。
+   - **止盈**：默认盈亏比 **2**（可改 0.5～10）；开启移动保本时默认 **3R** TP。
+   - **报单**：CTP 市价开仓 → 写入 `trade_order_monitors` → `sl_tp_guard` 守护。
+4. 同一根 5m K 线只触发一次；触发后移入历史（成败皆然）。
+5. 成交：微信 [§7](./WECHAT.md#7-关键位开仓成功)；失败/摘要：[§6](./WECHAT.md#6-关键位自动单)。
+
+## 风控规则
+
+| 规则 | 自动单 | 支阻区 |
+|------|--------|--------|
+| assert_can_open | ✓ | — |
+| 保证金 / 品种 | ✓ | — |
+| 交易时段 | ✓ | — |
+| 自动下单 | ✓ | ✗ |
+
+全局规则见 [RISK.md](./RISK.md)。
+
+---
+
+详见 [FEATURES.md](./FEATURES.md) · [INDEX.md](./INDEX.md)