docs: Update /signal command description and add detailed trading signal explanation with examples and lock status.

2026-02-06 21:30:52 +08:00
parent c33593115a
commit e0aefbcea7
2 changed files with 55 additions and 13 deletions
@@ -19,7 +19,7 @@ python run.py

 | 指令         | 描述             | 用法                          |
 | :----------- | :--------------- | :---------------------------- |
-| `/signal`    | **获取交易信号** | 返回当前最值得关注的 3 个档位 |
+| `/signal`    | **获取交易信号** | 返回最早结算市场的 Top 5 档位 |
 | `/portfolio` | **查看模拟仓位** | 获取实时模拟交易盈亏汇总报告  |
 | `/status`    | **检查系统状态** | 确认监控引擎是否在线          |
 | `/help`      | **指令帮助**     | 显示所有可用指令              |
@@ -75,10 +75,33 @@ python run.py
 - **触发时间**: 北京时间 23:55 左右自动推送。
 - **内容**: 汇总当日所有模拟仓位的浮动盈亏、余额变动及胜率统计。

-### 5. 🎯 交易信号 (指令查询)
+### 5. 🎯 交易信号 (`/signal` 指令)

- 对比气象预报与市场价格偏差。
- 包含：城市、档位、当地时间、预期温度（含单位自适应）、偏差评分。
+优先显示**最早结算日期**的市场，按机会价值排序，返回 **Top 5** 档位：
+
+```
+🎯 即将结算市场 (2026-02-06)
+共 43 个活跃选项
+
+🔥 1. Dallas 76-77°F
+   💡 预测80.7°高于77° → 买NO ✓
+   📊 Buy No 94¢ | ⏳接近锁定
+
+🔥 2. Atlanta 56-57°F
+   💡 预测60.4°高于57° → 买NO ✓
+   📊 Buy No 94¢ | ⏳接近锁定
+
+⭐ 3. Miami 62-63°F
+   💡 预测65.3°高于63° → 买NO ✓
+   📊 Buy No 88¢ | ⏳接近锁定
+```
+
+**锁定状态说明**:
+
+- 🔒锁定: 价格 ≥95¢
+- ⏳接近锁定: 价格 85-94¢
+- 👀观望: 价格 70-84¢
+- ⚖️均衡: 价格 <70¢

 ---

@@ -17,12 +17,12 @@ This command launches:

 ## 🤖 Telegram Bot Commands

-| Command      | Description             | Usage                                        |
-| :----------- | :---------------------- | :------------------------------------------- |
-| `/signal`    | **Get Trading Signals** | Returns top 3 markets with highest deviation |
-| `/portfolio` | **View Portfolio**      | Get real-time paper trading profit report    |
-| `/status`    | **Check Status**        | Confirm if the monitoring engine is online   |
-| `/help`      | **Help**                | Display all available commands               |
+| Command      | Description             | Usage                                          |
+| :----------- | :---------------------- | :--------------------------------------------- |
+| `/signal`    | **Get Trading Signals** | Returns Top 5 markets with earliest settlement |
+| `/portfolio` | **View Portfolio**      | Get real-time paper trading profit report      |
+| `/status`    | **Check Status**        | Confirm if the monitoring engine is online     |
+| `/help`      | **Help**                | Display all available commands                 |

 ---

@@ -74,10 +74,29 @@ The system automatically decides the position size based on **Open-Meteo Weather
 - **Trigger**: Triggered automatically around 23:55 (Beijing Time).
 - **Content**: Summarizes daily floating PnL, balance changes, and win rate.

-### 5. 🎯 Trading Signals (Query)
+### 5. 🎯 Trading Signals (`/signal`)

- Comparison between weather forecasts and market pricing.
- Includes: City, bucket, local time, expected temperature (unit-aware), and deviation score.
+Prioritizes markets with the **earliest settlement date**, sorted by opportunity value, returns **Top 5**:
+
+```
+🎯 Upcoming Settlement (2026-02-06)
+43 active options
+
+🔥 1. Dallas 76-77°F
+   💡 Prediction 80.7° above 77° → Buy NO ✓
+   📊 Buy No 94¢ | ⏳Near Lock
+
+🔥 2. Atlanta 56-57°F
+   💡 Prediction 60.4° above 57° → Buy NO ✓
+   📊 Buy No 94¢ | ⏳Near Lock
+```
+
+**Lock Status**:
+
+- 🔒Locked: Price ≥95¢
+- ⏳Near Lock: Price 85-94¢
+- 👀Watch: Price 70-84¢
+- ⚖️Balanced: Price <70¢

 ---