Improve dashboard risk card styling, colors, and add risk control docs.

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

docs/风控说明.md

@@ -0,0 +1,97 @@
+# 数据看板 · 风控说明
+
+**路径**：`/dashboard`（数据看板）· 风控说明卡片
+
+本文说明看板 **风控说明** 区域各指标含义、颜色规则及对应配置。全局风控逻辑详见 [RISK.md](./RISK.md)。
+
+---
+
+## 状态行（卡片顶部）
+
+顶栏红色/绿色一行文字为 **当前风控结论**，例如：
+
+| 显示 | 含义 |
+|------|------|
+| 正常 · 可新开仓 | 未触发冻结，可新开仓 |
+| 仓位上限冻结 · 已达仓位上限 1/1 | 同时 active 持仓数已达上限，禁止新开仓，**滚仓/加仓仍允许** |
+| 1h / 4h 冻结 | 手动平仓触发冷静期 |
+| 日冻结 | 复盘勾选情绪问题或当日规则触发，禁止新开仓 |
+
+- **绿色**：当前可交易（`can_trade=true`）
+- **红色**：当前禁止新开仓（`can_trade=false`）
+
+---
+
+## 指标一览
+
+| 指标 | 说明 | 配置来源 |
+|------|------|----------|
+| **风控开关** | 是否启用账户冷静期等风控 | `.env` → `RISK_CONTROL_ENABLED` |
+| **持仓限制** | 当前 active 持仓数 / 同时持仓上限 | `.env` → `MAX_ACTIVE_POSITIONS` |
+| **日持仓限制** | 当日已开仓次数（含已平）/ 日开仓上限 | `.env` → `RISK_DAILY_POSITION_LIMIT`（默认 5） |
+| **日交易风险** | 当日累计止损风险占权益 / 上限 | `.env` → `RISK_DAILY_TRADING_RISK_PCT`（默认 2%） |
+| **手动平仓（冷静期触发）** | 当日手动平仓次数 / 上限 | `.env` → `RISK_MANUAL_CLOSE_DAILY_LIMIT` |
+| **冷静期(默认)** | 超限后默认冻结时长 | `.env` → `RISK_COOLING_HOURS_MANUAL`（默认 4h） |
+| **复盘后冷静** | 填写复盘情绪日记后缩短的冷静期 | `.env` → `RISK_COOLING_HOURS_MANUAL_JOURNAL`（默认 1h） |
+| **冷静剩余** | 当前冷静期剩余时间 | 运行时计算 |
+| **综合保证金占比** | 占用保证金占权益比例 / 单仓上限 | 系统设置 `max_margin_pct` |
+| **单仓保证金上限** | 新开仓允许的保证金占权益上限 | 系统设置 `max_margin_pct`（默认 30%） |
+| **综合保证金上限** | 滚仓/加仓时允许的更高保证金占比 | 系统设置 `roll_max_margin_pct` |
+| **计仓模式** | 固定金额（以损定仓）或固定手数 | 系统设置 |
+| **交易日切** | 统计日重置时刻 | `.env` → `TRADING_DAY_RESET_HOUR`（默认 8:00） |
+
+---
+
+## 颜色规则（看板 UI）
+
+### 风控开关
+
+| 状态 | 颜色 |
+|------|------|
+| 开启 | **绿色** |
+| 关闭 | **红色** |
+
+### 综合保证金占比
+
+显示格式：`已用% / 单仓上限%`
+
+| 已用占上限比例 | 已用部分颜色 |
+|----------------|--------------|
+| < 85% | **绿色**（安全） |
+| 85% ~ 100% | **琥珀色**（接近上限） |
+| ≥ 100% | **红色**（已达或超过单仓上限） |
+
+斜杠后的 **上限数值** 为 **蓝色**，与「单仓保证金上限」一致。
+
+### 单仓保证金上限 / 综合保证金上限
+
+| 指标 | 数值颜色 |
+|------|----------|
+| 单仓保证金上限 | **蓝色**（新开仓保证金天花板） |
+| 综合保证金上限 | **琥珀色**（滚仓/加仓专用，通常高于单仓上限） |
+
+### 持仓方向（持仓信息、平仓记录）
+
+| 方向 | 颜色 |
+|------|------|
+| 做多 | **绿色** |
+| 做空 | **红色** |
+
+---
+
+## 与全局风控的关系
+
+- 看板 **实时展示** 账户风控状态；下单前各板块仍调用 `assert_can_open()` 做相同校验。
+- **日持仓限制**、**日交易风险** 为新增维度，与「同时持仓上限」「冷静期」并列生效，任一超限即禁止新开仓。
+- **综合保证金占比** 使用 CTP 柜台权益与占用保证金实时计算；断线时可能短暂显示 `—`。
+
+---
+
+## 相关文档
+
+| 文档 | 内容 |
+|------|------|
+| [RISK.md](./RISK.md) | 全局账户风控规则与 env 变量 |
+| [SETTINGS.md](./SETTINGS.md) | 保证金上限、计仓模式等系统设置 |
+| [ORDER_MONITOR.md](./ORDER_MONITOR.md) | 下单监控顶栏风控状态 |
+| [INDEX.md](./INDEX.md) | 文档总索引 |