修改交易记录问题

crypto_monitor_binance/更新文档.md

@@ -6,14 +6,14 @@
 |------|------|------|------|
 | 1 | 关键位监控 | `/key_monitor` | 关键位添加、实时门控、历史 |
 | 2 | 实盘下单 | `/trade` | 人工开仓、划转、实时持仓（**默认首页** `/` → `/trade`） |
-| 3 | 交易记录与复盘 | `/records` | 未改动 |
-| 4 | 统计分析 | `/stats` | 未改动 |
+| 3 | 交易记录与复盘 | `/records` | 交易记录、复盘表单、AI 历史（受顶栏 UTC 时间窗筛选） |
+| 4 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
 
 ## 关键位监控页
 
 - 标题去掉「5m」；规则条从 `.env` 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
 - 左列：活跃关键位，**pos-card** 样式展示现价/距上沿/距下沿/门控。
-- 右列：关键位历史（失效/结案），与左列等高滚动。
+- 右列：关键位历史（失效/结案），与左列等高滚动；**受顶栏 UTC 列表时间窗筛选**（默认 UTC 当日）。
 - 监控类型新增：**斐波回调0.618**、**斐波回调0.786**（与 Gate 主站同一套规则，计算逻辑见仓库根目录 `fib_key_monitor_lib.py`）。
 
 ### 斐波关键位监控（方案 A：交易所限价）
@@ -41,11 +41,52 @@
 - 自动开仓写入 `order_monitors.key_signal_type`：`箱体突破` 或 `收敛突破`。
 - 持仓与交易记录展示「来源 · 信号类型」。
 
+## 列表时间窗（UTC，全站顶栏）
+
+共用模块：仓库根目录 `history_window_lib.py`（Gate / Binance 主站一致）。
+
+| 项 | 说明 |
+|----|------|
+| 默认 | **UTC 当日**（`win_preset=utc_today`，从 UTC 0:00 至当前时刻） |
+| 可选 | 近 24 小时、近 7 天、自定义起止（UTC，`datetime-local`） |
+| 作用范围 | 关键位历史、交易记录列表、复盘记录 API、AI 历史 API、导出「交易记录」「关键位历史」 |
+| 与统计的关系 | **仅影响列表/导出**；**统计分析页仍按北京时间 `TRADING_DAY_RESET_HOUR`（默认 8:00）切交易日** |
+| 库内时间 | DB 存北京时间字符串；后端用 `utc_window_to_bj_sql_strings()` 换算后再 SQL 比较 |
+| 切换方式 | 顶栏「列表筛选（UTC）」→ 选预设 → **应用**（保留当前路由，如 `/records?win_preset=…`） |
+
+查询参数示例：
+
+- `?win_preset=utc_today`
+- `?win_preset=utc_last24h` / `utc_last7d`
+- `?win_preset=custom&from_utc=2026-05-18 00:00:00&to_utc=2026-05-19 12:00:00`
+
 ## 交易记录与复盘
 
 - 支持从交易所收入流水等同步已实现盈亏；盈亏列标注 **所** / **估**。
 - 记录页 **立即同步**（`POST /api/sync_exchange_pnl`）。
 - 未人工复盘时优先展示交易所盈亏（已同步时）。
+- **列表默认只显示当前 UTC 时间窗内**的记录（见上节）；导出 CSV 同步该时间窗。
+- 表头 **「止损(开仓)」**：展示开仓快照 `initial_stop_loss`（无则回退 `stop_loss`）；核对/复盘仍可用有效止损字段。
+- 平仓写入 `trade_records` 时：`stop_loss` 与 `initial_stop_loss` 均写入**开仓时止损快照**；`key_signal_type` 保留箱体/收敛/斐波来源（`fib_key_monitor_lib.key_signal_type_for_trade_record`）。
+- **开仓类型**（`entry_reason`）：机器单平仓入库时，若未手填，按 `key_signal_type` 自动映射（见下表）；列表/导出「开仓类型」列 = 复盘核对值优先，否则入库值，否则按信号映射。
+
+| `key_signal_type` | 自动写入的 `entry_reason` |
+|-------------------|---------------------------|
+| 箱体突破 | 关键位箱体突破 |
+| 收敛突破 | 关键位收敛突破 |
+| 斐波回调0.618 | 关键位斐波0.618 |
+| 斐波回调0.786 | 关键位斐波0.786 |
+
+- 复盘表单 **开仓类型** 下拉新增上述四条固定文案（与趋势/波段类并列）。
+- 复盘 **离场触发** 新增 **「止盈」**；从交易记录「填入复盘」时，若结果为「止盈/保本止盈/移动止盈/止损/手动平仓」会自动选中对应触发项，并按 `key_signal_type` 预填开仓类型。
+- 勾选「保存时自动生成多周期 K 线图」时：以 **平仓时间** 为锚点，各周期向前约 `ORDER_CHART_LIMIT`（默认 100）根 K 线（`_fetch_ohlcv_ending_at`），不再固定拉「最近 100 根」。
+- `/api/journals`、`/api/reviews` 支持同一时间窗 query，与列表一致。
+
+### 导出（交易记录 v3）
+
+- 文件名：`trade_records_v3_YYYYMMDD.csv`
+- 相对 v2 增加：`key_signal_type`、`initial_stop_loss`（及开仓快照列）、`planned_rr`、`actual_rr`、`risk_amount`、交易所盈亏与时间字段等；末列「开仓类型」为有效展示文案。
+- 「关键位历史」导出同样受 UTC 时间窗限制。
 
 ## 实盘下单页
 
@@ -53,6 +94,16 @@
 - 右列：实时持仓（独立模块）。
 - **人工开仓门控**：计划盈亏比 < `MANUAL_MIN_PLANNED_RR`（默认 **1.4**）时前端弹窗 + 后端拒绝。
 
+## 统计分析页（`/stats`）
+
+| 项 | 说明 |
+|----|------|
+| 切日 | **北京时间**；交易日边界 = 每日 `TRADING_DAY_RESET_HOUR:00`（`.env` 默认 **8**） |
+| 分块 | 页内按品类各一块：**全部已平仓**、**人工·下单监控**、**关键位箱体突破**、**关键位收敛突破**、**关键位斐波0.618**、**关键位斐波0.786** |
+| 每块指标 | 日 / 周 / 月：开单次数、平仓笔数、胜率、净盈亏、回撤、连续亏损等（与原口径一致） |
+| 开单次数 | 人工块：`monitor_type=下单监控` 且无 `key_signal_type`；关键位块：按 `order_monitors.key_signal_type` 计数 |
+| 不受 UTC 窗影响 | 统计始终基于库内全部已平仓记录，按北京交易日归类，**不**随顶栏 UTC 列表窗切换 |
+
 ## 持仓与计仓
 
 - `MAX_ACTIVE_POSITIONS` 默认 **1**（可在 `.env` 调大）。
@@ -72,12 +123,24 @@
 
 `key_monitors` 斐波字段：`fib_limit_order_id`、`fib_entry_price`、`fib_stop_loss`、`fib_take_profit`、`fib_order_amount`、`fib_margin_capital`、`fib_leverage`。
 
-`trade_records` / `order_monitors`：`key_signal_type`、`exchange_realized_pnl`、`exchange_opened_at`、`exchange_closed_at`、`exchange_sync_key`。
+`trade_records` / `order_monitors`：`key_signal_type`、`exchange_realized_pnl`、`exchange_opened_at`、`exchange_closed_at`、`exchange_sync_key`、`entry_reason`、`reviewed_entry_reason`、`initial_stop_loss`。
+
+**历史数据**：本次**不做**旧记录的批量回填（`entry_reason` / `initial_stop_loss` / `key_signal_type` 等）；仅**新产生**的平仓与复盘按新逻辑写入。旧行展示可回退已有字段。
+
+## 涉及文件（便于排查）
+
+| 路径 | 说明 |
+|------|------|
+| `history_window_lib.py` | UTC 时间窗解析与转北京时间 SQL 字符串 |
+| `fib_key_monitor_lib.py` | 斐波计算、`KEY_ENTRY_REASON_BY_SIGNAL`、`entry_reason_from_key_signal` |
+| `crypto_monitor_binance/app.py` | 列表筛选、统计分块、导出 v3、复盘 K 线锚点、入库逻辑 |
+| `crypto_monitor_binance/templates/index.html` | 顶栏时间窗、统计分块 UI、止损(开仓)列、复盘预填 |
 
 ## 升级步骤
 
 1. `git pull` 后对比 `.env.example`，把新增变量合并进本地 `.env`。
 2. 在 VPS 上为 Binance / Gate / Gate Bot **各执行一次** `bash scripts/install_backup_cron.sh`（若尚未安装）。
-3. 重启 Binance 实例（如 `pm2 restart crypto_binance`）；SQLite 会自动 `ALTER` 新列。
+3. 重启 Binance 实例（如 `pm2 restart crypto_binance`）；SQLite 会自动 `ALTER` 缺列（斐波、交易所盈亏、`entry_reason` 等）。
 4. 浏览器强刷（Ctrl+F5）避免旧版 `index.html` 缓存。
-5. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常。
+5. 打开任意页确认顶栏出现 **「列表筛选（UTC）」**；`/stats` 可见分品类统计与「北京 8:00 切日」说明。
+6. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常；平仓后检查交易记录止损(开仓)与开仓类型。