e307eef690
Implements shared account_risk_lib with 4h/1h cooloff and daily freeze rules, wires hooks into all four exchange apps and hub monitor UI, with tests and docs. Co-authored-by: Cursor <cursoragent@cursor.com>
367 lines
11 KiB
Python
367 lines
11 KiB
Python
"""账户冷静期 / 日冻结风控(四所实例共用)。"""
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from datetime import datetime, timezone
|
|
from typing import Any, Callable, Optional
|
|
|
|
STATUS_NORMAL = "normal"
|
|
STATUS_FREEZE_1H = "freeze_1h"
|
|
STATUS_FREEZE_4H = "freeze_4h"
|
|
STATUS_DAILY = "freeze_daily"
|
|
|
|
STATUS_LABELS = {
|
|
STATUS_NORMAL: "正常",
|
|
STATUS_FREEZE_1H: "1h冻结",
|
|
STATUS_FREEZE_4H: "4h冻结",
|
|
STATUS_DAILY: "日冻结",
|
|
}
|
|
|
|
MOOD_ISSUE_OPTIONS = (
|
|
"怕踏空",
|
|
"报复开仓",
|
|
"盈利飘了",
|
|
"拿不住单",
|
|
"扛单",
|
|
"重仓违规",
|
|
)
|
|
|
|
EXTERNAL_CLOSE_RESULTS = frozenset({"外部平仓"})
|
|
|
|
|
|
def _env_bool(key: str, default: bool = True) -> bool:
|
|
raw = (os.getenv(key) or "").strip().lower()
|
|
if not raw:
|
|
return default
|
|
return raw in ("1", "true", "yes", "on")
|
|
|
|
|
|
def _env_hours(key: str, default: float) -> float:
|
|
try:
|
|
v = float(os.getenv(key, str(default)))
|
|
except (TypeError, ValueError):
|
|
v = default
|
|
return max(0.0, v)
|
|
|
|
|
|
def risk_control_enabled() -> bool:
|
|
return _env_bool("RISK_CONTROL_ENABLED", True)
|
|
|
|
|
|
def cooling_hours_manual() -> float:
|
|
return _env_hours("RISK_COOLING_HOURS_MANUAL", 4.0)
|
|
|
|
|
|
def cooling_hours_external() -> float:
|
|
return _env_hours("RISK_COOLING_HOURS_EXTERNAL", 4.0)
|
|
|
|
|
|
def cooling_hours_manual_journal() -> float:
|
|
return _env_hours("RISK_COOLING_HOURS_MANUAL_JOURNAL", 1.0)
|
|
|
|
|
|
def manual_close_daily_limit() -> int:
|
|
try:
|
|
return max(1, int(os.getenv("RISK_MANUAL_CLOSE_DAILY_LIMIT", "2")))
|
|
except (TypeError, ValueError):
|
|
return 2
|
|
|
|
|
|
def mood_issues_daily_freeze_enabled() -> bool:
|
|
return _env_bool("RISK_MOOD_ISSUES_DAILY_FREEZE", True)
|
|
|
|
|
|
def ensure_account_risk_schema(conn) -> None:
|
|
conn.execute(
|
|
"""CREATE TABLE IF NOT EXISTS account_risk_state (
|
|
id INTEGER PRIMARY KEY CHECK (id = 1),
|
|
trading_day TEXT,
|
|
manual_close_count INTEGER DEFAULT 0,
|
|
cooloff_until_ms INTEGER,
|
|
cooloff_hours INTEGER,
|
|
daily_frozen INTEGER DEFAULT 0,
|
|
pending_journal_trade_id INTEGER,
|
|
last_close_at_ms INTEGER,
|
|
updated_at TEXT
|
|
)"""
|
|
)
|
|
row = conn.execute("SELECT id FROM account_risk_state WHERE id=1").fetchone()
|
|
if not row:
|
|
conn.execute(
|
|
"INSERT INTO account_risk_state (id, trading_day, manual_close_count, daily_frozen) VALUES (1, '', 0, 0)"
|
|
)
|
|
|
|
|
|
def _row_get(row, key, default=None):
|
|
if row is None:
|
|
return default
|
|
try:
|
|
return row[key]
|
|
except (KeyError, IndexError, TypeError):
|
|
return default
|
|
|
|
|
|
def _now_ms(now: Optional[datetime] = None) -> int:
|
|
dt = now or datetime.now()
|
|
if dt.tzinfo is None:
|
|
return int(dt.replace(tzinfo=timezone.utc).timestamp() * 1000)
|
|
return int(dt.timestamp() * 1000)
|
|
|
|
|
|
def _ms_to_local_str(ms: Optional[int], fmt_local: Callable[[int], str]) -> Optional[str]:
|
|
if ms is None:
|
|
return None
|
|
try:
|
|
return fmt_local(int(ms))
|
|
except Exception:
|
|
return None
|
|
|
|
|
|
def _load_state(conn):
|
|
ensure_account_risk_schema(conn)
|
|
return conn.execute("SELECT * FROM account_risk_state WHERE id=1").fetchone()
|
|
|
|
|
|
def _sync_trading_day(conn, trading_day: str, now: Optional[datetime] = None) -> Any:
|
|
row = _load_state(conn)
|
|
td = (trading_day or "").strip()
|
|
stored = str(_row_get(row, "trading_day") or "").strip()
|
|
if stored != td:
|
|
conn.execute(
|
|
"""UPDATE account_risk_state SET
|
|
trading_day=?,
|
|
manual_close_count=0,
|
|
daily_frozen=0,
|
|
updated_at=?
|
|
WHERE id=1""",
|
|
(td, (now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S")),
|
|
)
|
|
row = _load_state(conn)
|
|
return row
|
|
|
|
|
|
def _set_cooloff(
|
|
conn,
|
|
*,
|
|
trading_day: str,
|
|
close_at_ms: int,
|
|
hours: float,
|
|
now: Optional[datetime] = None,
|
|
) -> None:
|
|
_sync_trading_day(conn, trading_day, now=now)
|
|
h = max(0.0, float(hours))
|
|
until_ms = int(close_at_ms + h * 3600 * 1000)
|
|
conn.execute(
|
|
"""UPDATE account_risk_state SET
|
|
cooloff_until_ms=?,
|
|
cooloff_hours=?,
|
|
last_close_at_ms=?,
|
|
updated_at=?
|
|
WHERE id=1""",
|
|
(
|
|
until_ms,
|
|
int(h) if h == int(h) else int(round(h)),
|
|
int(close_at_ms),
|
|
(now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S"),
|
|
),
|
|
)
|
|
|
|
|
|
def _set_daily_frozen(conn, *, trading_day: str, now: Optional[datetime] = None) -> None:
|
|
_sync_trading_day(conn, trading_day, now=now)
|
|
conn.execute(
|
|
"""UPDATE account_risk_state SET daily_frozen=1, updated_at=? WHERE id=1""",
|
|
((now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S"),),
|
|
)
|
|
|
|
|
|
def parse_mood_issues(raw: Any) -> list[str]:
|
|
if raw is None:
|
|
return []
|
|
if isinstance(raw, (list, tuple)):
|
|
parts = [str(x).strip() for x in raw if str(x).strip()]
|
|
else:
|
|
parts = [x.strip() for x in str(raw).split(",") if x.strip()]
|
|
return [p for p in parts if p in MOOD_ISSUE_OPTIONS]
|
|
|
|
|
|
def on_manual_close(
|
|
conn,
|
|
*,
|
|
trade_record_id: int,
|
|
closed_at_ms: Optional[int],
|
|
trading_day: str,
|
|
now: Optional[datetime] = None,
|
|
) -> None:
|
|
if not risk_control_enabled():
|
|
return
|
|
row = _sync_trading_day(conn, trading_day, now=now)
|
|
count = int(_row_get(row, "manual_close_count") or 0) + 1
|
|
close_ms = int(closed_at_ms) if closed_at_ms else _now_ms(now)
|
|
conn.execute(
|
|
"""UPDATE account_risk_state SET
|
|
manual_close_count=?,
|
|
pending_journal_trade_id=?,
|
|
updated_at=?
|
|
WHERE id=1""",
|
|
(count, int(trade_record_id), (now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S")),
|
|
)
|
|
if count >= manual_close_daily_limit():
|
|
_set_daily_frozen(conn, trading_day=trading_day, now=now)
|
|
return
|
|
_set_cooloff(
|
|
conn,
|
|
trading_day=trading_day,
|
|
close_at_ms=close_ms,
|
|
hours=cooling_hours_manual(),
|
|
now=now,
|
|
)
|
|
|
|
|
|
def on_external_close(
|
|
conn,
|
|
*,
|
|
closed_at_ms: Optional[int],
|
|
trading_day: str,
|
|
now: Optional[datetime] = None,
|
|
) -> None:
|
|
if not risk_control_enabled():
|
|
return
|
|
close_ms = int(closed_at_ms) if closed_at_ms else _now_ms(now)
|
|
_set_cooloff(
|
|
conn,
|
|
trading_day=trading_day,
|
|
close_at_ms=close_ms,
|
|
hours=cooling_hours_external(),
|
|
now=now,
|
|
)
|
|
conn.execute(
|
|
"UPDATE account_risk_state SET pending_journal_trade_id=NULL, updated_at=? WHERE id=1",
|
|
((now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S"),),
|
|
)
|
|
|
|
|
|
def on_journal_saved(
|
|
conn,
|
|
*,
|
|
early_exit_trigger: str,
|
|
early_exit_note: str,
|
|
mood_issues_raw: Any,
|
|
trading_day: str,
|
|
now: Optional[datetime] = None,
|
|
) -> None:
|
|
if not risk_control_enabled():
|
|
return
|
|
row = _sync_trading_day(conn, trading_day, now=now)
|
|
mood_list = parse_mood_issues(mood_issues_raw)
|
|
if mood_issues_daily_freeze_enabled() and mood_list:
|
|
_set_daily_frozen(conn, trading_day=trading_day, now=now)
|
|
conn.execute(
|
|
"UPDATE account_risk_state SET pending_journal_trade_id=NULL, updated_at=? WHERE id=1",
|
|
((now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S"),),
|
|
)
|
|
return
|
|
pending = _row_get(row, "pending_journal_trade_id")
|
|
trigger = (early_exit_trigger or "").strip()
|
|
note = (early_exit_note or "").strip()
|
|
if pending and trigger == "手动平仓" and note:
|
|
last_close_ms = _row_get(row, "last_close_at_ms")
|
|
base_ms = int(last_close_ms) if last_close_ms else _now_ms(now)
|
|
_set_cooloff(
|
|
conn,
|
|
trading_day=trading_day,
|
|
close_at_ms=base_ms,
|
|
hours=cooling_hours_manual_journal(),
|
|
now=now,
|
|
)
|
|
conn.execute(
|
|
"UPDATE account_risk_state SET pending_journal_trade_id=NULL, updated_at=? WHERE id=1",
|
|
((now or datetime.now()).strftime("%Y-%m-%d %H:%M:%S"),),
|
|
)
|
|
|
|
|
|
def compute_account_risk_status(
|
|
conn,
|
|
*,
|
|
trading_day: str,
|
|
now: Optional[datetime] = None,
|
|
fmt_local_ms: Optional[Callable[[int], str]] = None,
|
|
) -> dict[str, Any]:
|
|
if not risk_control_enabled():
|
|
return {
|
|
"enabled": False,
|
|
"status": STATUS_NORMAL,
|
|
"status_label": STATUS_LABELS[STATUS_NORMAL],
|
|
"can_trade": True,
|
|
"reason": "",
|
|
"cooloff_until_ms": None,
|
|
"cooloff_until": None,
|
|
"manual_close_count": 0,
|
|
"daily_frozen": False,
|
|
}
|
|
row = _sync_trading_day(conn, trading_day, now=now)
|
|
now_ms = _now_ms(now)
|
|
daily_frozen = int(_row_get(row, "daily_frozen") or 0) == 1
|
|
cooloff_until_ms = _row_get(row, "cooloff_until_ms")
|
|
try:
|
|
cooloff_until_ms = int(cooloff_until_ms) if cooloff_until_ms is not None else None
|
|
except (TypeError, ValueError):
|
|
cooloff_until_ms = None
|
|
cooloff_hours = _row_get(row, "cooloff_hours")
|
|
manual_close_count = int(_row_get(row, "manual_close_count") or 0)
|
|
|
|
status = STATUS_NORMAL
|
|
reason = ""
|
|
if daily_frozen:
|
|
status = STATUS_DAILY
|
|
reason = f"账户今日已冻结(手动平仓 {manual_close_count} 次或复盘情绪标签)"
|
|
elif cooloff_until_ms is not None and cooloff_until_ms > now_ms:
|
|
h = int(cooloff_hours or cooling_hours_manual())
|
|
status = STATUS_FREEZE_1H if h <= 1 else STATUS_FREEZE_4H
|
|
until_str = _ms_to_local_str(cooloff_until_ms, fmt_local_ms) if fmt_local_ms else None
|
|
label = STATUS_LABELS[status]
|
|
reason = f"账户{label}中"
|
|
if until_str:
|
|
reason += f",至 {until_str}"
|
|
|
|
can_trade = status == STATUS_NORMAL
|
|
return {
|
|
"enabled": True,
|
|
"status": status,
|
|
"status_label": STATUS_LABELS[status],
|
|
"can_trade": can_trade,
|
|
"reason": reason,
|
|
"cooloff_until_ms": cooloff_until_ms if cooloff_until_ms and cooloff_until_ms > now_ms else None,
|
|
"cooloff_until": _ms_to_local_str(cooloff_until_ms, fmt_local_ms)
|
|
if fmt_local_ms and cooloff_until_ms and cooloff_until_ms > now_ms
|
|
else None,
|
|
"manual_close_count": manual_close_count,
|
|
"daily_frozen": daily_frozen,
|
|
"pending_journal_trade_id": _row_get(row, "pending_journal_trade_id"),
|
|
}
|
|
|
|
|
|
def account_risk_blocks_trading(
|
|
conn,
|
|
*,
|
|
trading_day: str,
|
|
now: Optional[datetime] = None,
|
|
fmt_local_ms: Optional[Callable[[int], str]] = None,
|
|
) -> tuple[bool, str]:
|
|
"""返回 (允许交易, 拒绝原因)。"""
|
|
st = compute_account_risk_status(
|
|
conn, trading_day=trading_day, now=now, fmt_local_ms=fmt_local_ms
|
|
)
|
|
if st.get("can_trade"):
|
|
return True, ""
|
|
return False, str(st.get("reason") or STATUS_LABELS.get(st.get("status"), "账户冻结"))
|
|
|
|
|
|
def should_apply_external_close_risk(result: str) -> bool:
|
|
return (result or "").strip() in EXTERNAL_CLOSE_RESULTS
|
|
|
|
|
|
def insert_trade_record_id(conn) -> int:
|
|
row = conn.execute("SELECT last_insert_rowid()").fetchone()
|
|
return int(row[0] if row else 0)
|