From deb240d4eb1cd154a9b2c4f4cfbff8664acf4fe7 Mon Sep 17 00:00:00 2001
From: dekun <dekun@local>
Date: Thu, 18 Jun 2026 22:04:50 +0800
Subject: [PATCH] docs(risk): clarify cooloff countdown uses last manual close
 only

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/account-risk-cooldown.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/account-risk-cooldown.md b/docs/account-risk-cooldown.md
index d4bf3d7..163dc72 100644
--- a/docs/account-risk-cooldown.md
+++ b/docs/account-risk-cooldown.md
@@ -58,9 +58,18 @@
 说明：
 
 - 中控全平 / 实例手动平仓后，只要在 4h 窗口内完成上述操作即可降为 1h。
+- 复盘保存后会同步更新 `last_close_at_ms`，倒计时以 **最后一次手动平仓 + 当前档位数** 为准，不会继续读库内旧 4h 结束时间。
+- 1h 窗口已结束后，即使库里残留旧 `cooloff_until_ms`，状态也会恢复 **正常**。
 - 若超过「平仓 + 1h」才复盘，则从 **保存复盘时刻** 起再计 1h（不延长原 4h）。
+- **止盈 / 保本止盈 / 止损** 等自动平仓不触发风控，也不会刷新冷静期。
 - 代码更新后需 **重启对应实例** 并硬刷新页面。
 
+### 倒计时与标签
+
+- 结束时刻 = `last_close_at_ms + cooloff_hours`（`APP_TIMEZONE` 默认北京时间）
+- 1h / 4h 标签按实际剩余时长判断，与倒计时一致
+- 切交易日后，若冷静期已过期，自动清库内残留字段
+
 ## 环境变量
 
 ```env