ek_ui/

render.rs

//! 唯一渲染入口(L2):真实 eframe App 与 kittest 建构走同一个 `render_body`。
//!
//! 布局 v5(BD-UI-29 面板化,官方面板组合;蓝本 = Python 主窗 mainwindow.py):
//! **TopBottomPanel(菜单) → TopBottomPanel(行情带) → SidePanel(下单侧) →
//! CentralPanel(2×2 监控格) → Window 弹窗**,两带物理分离。
//! - 行情带(TopBottomPanel::resizable = Python 分带 splitter 语义,缺省 240):
//!   交易所二级 tab(只列有 tick 的所)+ tick 表(唯一源 = `eTick.`
//!   订阅流,不从 bar 回);行内任意格单击 = 带入下单面板(ek 增值,方案钉;
//!   盘口四列带方向:买1 价/量 → 卖,卖1 价/量 → 买,价格列顺带填价,其余列
//!   方向保持默认——0.2.1 `import_tick`),行内任意格双击 = 弹 K线窗。
//! - 下单侧(SidePanel::resizable,缺省 250):下单面板常驻(Python
//!   TradingWidget 等价:9 字段 + 委托 + 全撤;表单 = 网格,按钮/提示语都是
//!   网格行;网格后置 err label 由 ScrollArea 吸收 sizing 退让,BD-UI-27)+
//!   盘口(买5卖5,Python TradingWidget 内序:字段钮 → 盘口)。
//! - 2×2 监控格(CentralPanel 内,响应式分配,无定宽定高,BD-UI-29)
//!   「委托|未成交」「成交」「持仓」「资金|日志」(撤单钮仅活动行,既有 s11
//!   钉口径;委托行双击 = 撤单,Python OrderMonitor 等价;格内宽表走横向滚动,
//!   D7 口径)。
//! - 弹窗两式(BD-UI-32):运维窗(菜单「运维」:插件/服务/依赖;0.2.10 起
//!   流控查询钮随 sim 退场撤除)、
//!   CTP 配置窗(菜单「网关」,CTP 插件自己的界面)= egui::Window 依附主窗;
//!   查询合约窗(菜单「查询合约」:查询 + 勾选 + 订阅钮,Python ContractManager
//!   等价)、K线窗(双击弹出,按合约多开)= 独立 OS 窗(show_viewport_immediate,
//!   原生最小化/最大化/关闭,可拖出主窗;后端不支持多窗自动回退 egui::Window,
//!   kittest 走回退面断言)。
//! - 订阅两入口(用户裁定,网关窗不定死订阅):下单面板代码框**回车**订阅
//!   (Python returnPressed 等价);查询合约窗**勾选订阅**。合约数据 =
//!   `eContract.` 自动回流(ek-ctp 登录后自动查询,UI 只收不催)。
//! - 回灌表单与票据文本框已退役(界面面);总线口(`UiCmd::Reload` 等)保留。
//!
//! kittest 断言面:各单元格独立 Label(`get_by_label` 直查);操作走
//! `push_cmd` 入队(ui 插件 eTimer 辞行出队),确认状态就地翻位,零自制通道。
//! 隔离红标:行状态含 Quarantin(快照扫描,BD-UI-17)。

use ek_data::constant::{Direction, Offset, OrderType};
use ek_station::wire::PlugRow;

use crate::state::{
    BottomRightTab, CellView, ConfirmStep, TopLeftTab, UiCmd, UiShared, beijing_tz, is_quarantined,
};

/// 清空日志按钮的唯一可访问性标签(测试与 UI 同源)。
pub const BTN_CLEAR_LOGS: &str = "清空日志";
/// 取消待确认按钮标签。
pub const BTN_CANCEL_CONFIRM: &str = "取消确认";
/// 下单提交按钮标签(v4 = Python「委托」钮)。
pub const BTN_SEND_ORDER: &str = "委托";
/// 全撤按钮标签(v4;活动委托逐个走既有撤单 ask)。
pub const BTN_CANCEL_ALL: &str = "全撤";
/// 撤单按钮前缀(S5;行级标签 = `撤单 {orderid}`)。
pub const BTN_CANCEL_ORDER: &str = "撤单";
/// 账户面板:添加账户钮(派生注册名 → svctl.start + {gw}.configure)。
pub const BTN_ACCOUNT_ADD: &str = "添加账户";
/// 菜单项:运维(弹运维窗)。
pub const MENU_OPS: &str = "运维";
/// 菜单项:账户(弹账户面板;多账号面入口,规划 §5.B。旧「网关」单账号窗
/// 已退役收纳进账户面板的添加/编辑表单,旧常量随之删除)。
pub const MENU_ACCOUNTS: &str = "账户";
/// 菜单项:帮助。
pub const MENU_HELP: &str = "帮助";
/// 菜单项:查询合约(弹查询合约窗;Python ContractManager 等价)。
pub const MENU_CONTRACTS: &str = "查询合约";
/// 菜单项 → 弹窗入口钮(BD-UI-31 一键直达:菜单钮即入口,一步弹窗,
/// 不再挂下拉层;入口钮标签 = 菜单名本身)。
/// 查询合约窗订阅钮(勾选集 → ask ctp.subscribe)。
pub const BTN_SUBSCRIBE_SELECTED: &str = "订阅选中";

/// F4 口径句(0.2.20,D-UI-F4-SCOPE):账户面板底部与配置弹窗**共用这一条常量**。
/// 两处各写一遍字面量 = 将来不同式的坑(s57 数的是"两处都在")。
pub const TXT_PRODUCT_CLASS_SCOPE: &str = "收录勾选只管该网关自己收录并上抛的合约;公用合约表 = 在场各网关的并集(合约与行情公用,规划 D3)。改勾选须『连接/重试』才下发到网关。";

fn remove_button_label(name: &str, armed_on: Option<&str>) -> String {
    if armed_on == Some(name) {
        format!("确认移除 {name} ?")
    } else {
        format!("移除 {name}")
    }
}

/// 订阅路由(规划 §5.C):行情订阅一律发往**行情元账号**。
///
/// 未指定行情源时回 `Err` —— 不静默发给某个从账号(纯 TD 账号收到订阅会
/// 恒 `ok:true` 但永远不来 tick,是观测黑洞)。
fn subscribe_target(shared: &UiShared) -> Result<String, String> {
    let md = shared.md_source();
    if md.is_empty() {
        return Err("未指定行情源:账户面板点某账户的『设为行情源』后再订阅".to_string());
    }
    Ok(md)
}

fn state_text(r: &PlugRow) -> String {
    r.state.clone()
}

// 0.3.1(Wave D,BD-UI-49):时间列格式收进 `crate::format::time_hms_millis`(`HH:MM:SS.mmm`)。
// 口径没变:北京时间 +08,数据面时间戳统一存 UTC 纳秒 —— CTP 回报的自然日本就是北京钟面,
// 入账按 +08 换算存 UTC,展示面换回来,表内时间列与交易员作息同钟面,且与日志同源。

// 展示面统一时区 = `crate::state::beijing_tz`(0.2.27 提到 state:日志入环打戳
// 与表格时间列必须同一个口径,一份实现两处共用)。这里不留 doc comment ——
// 它后面没有 item,clippy `empty_lines_after_doc_comment` 正是钉这种。

// ---- BD-UI-31(R3)行高亮:0.2.29 起由表格层承担(BD-UI-44)----
// 原来这里有两支手绘助手:`paint_row_bg`(行底色 = 各格响应矩形并集 + 硬编码半透明蓝)
// 和 `click_cell`(在标签矩形上叠一层点击感应)。换成 egui_extras::TableBuilder 后,
// 选中/悬停底色 = `TableRow::set_selected` 与库自己的悬停跟踪(egui_extras layout.rs:137
// 起:底色吃 `visuals.selection.bg_fill` / `widgets.hovered.bg_fill`,并按半间距补缝 =
// 整行连续),格可点 = `TableBuilder::sense(Sense::click())` + `TableRow::col` 返回的
// Response。两支助手撤除 = 少两处自己维护的几何,行底色也改跟主题(0.2.27 斑马纹同口径)。

/// 委托是否可撤(与 ek-data ACTIVE_STATUSES 同口径)。
fn order_active(status: ek_data::constant::Status) -> bool {
    ek_data::constant::ACTIVE_STATUSES.contains(&status)
}

/// 行情带入(0.2.1 扩展):任意列单击 = 带入合约+交易所;盘口四列带方向
/// (买1价/买1量 → 卖,卖1价/卖1量 → 买 —— 吃对手挂价口径),两个价格列
/// 顺带把该价填进价格格;其余列方向/价格保持表单默认(用户裁定)。
pub fn import_tick(shared: &UiShared, t: &ek_data::tick::TickData, exchange: &str, col: usize) {
    let mut f = shared.order_form();
    f.symbol = t.symbol.clone();
    f.exchange = exchange.to_string();
    match col {
        8 => {
            f.direction = Direction::SHORT;
            f.price = crate::format::price(t.bid_price_1);
        }
        9 => f.direction = Direction::SHORT,
        10 => {
            f.direction = Direction::LONG;
            f.price = crate::format::price(t.ask_price_1);
        }
        11 => f.direction = Direction::LONG,
        _ => {}
    }
    shared.set_order_form(f);
}

/// 按合约找最新 tick(下单面板名称/盘口/随价共用)。
/// 交易所非空 = 精确 EX.symbol 匹配(跨所同码不串);空 = 仅按代码找。
fn tick_of(shared: &UiShared, exchange: &str, symbol: &str) -> Option<ek_data::tick::TickData> {
    if symbol.is_empty() {
        return None;
    }
    shared.tick_rows().into_iter().find(|t| {
        t.symbol == symbol
            && (exchange.is_empty() || t.exchange.as_str().eq_ignore_ascii_case(exchange))
    })
}

/// 字号 + 间距 + 控件规格 + 主题视觉(0.2.30 起全部走 `crate::tokens`;主题只有一套
/// Qt深色,`Theme` 枚举与菜单循环钮已删 —— 裁定 8)。真实 App、独立子窗(immediate
/// 共享同一 Context)、kittest 三处同源。
/// 语义色(涨红跌绿 / 多红空绿 / 警告橙 / 错误深红 / 成功深绿 / 次级灰)不在这一层:
/// 它们在 `tokens::semantic` 里恒定,渲染侧直绘,不随视觉档漂移(金融语义不玩配色)。
pub fn apply_ui_style(ctx: &egui::Context) {
    ctx.style_mut(|style| {
        crate::tokens::apply(style);
    });
    ctx.set_visuals(crate::tokens::visuals());
}

/// 表格与页签的「chrome」配色(表头带、分隔线、tab 头底、选中 tab 下划线)。
///
/// 为什么要有这个结构:qdarkstyle 有 `QHeaderView::section`(表头带底 `#455364`)和
/// `QTabBar::tab:top:selected`(选中 tab `#54687A` 底 + 3px `#259AE9` 下划线)这两个概念,
/// **egui 的 `Visuals` 里没有对应字段**(它只有 `selection.bg_fill` 一根,且
/// `selectable_label` 只能整块填充)。所以这一层只能在渲染侧直绘。
///
/// 取色口径(审计「多余」条):不新造颜色,全部从主题**已经声明过**的字段里取 ——
/// 取出来正是 qss 原值(`noninteractive.bg_stroke` = `#455364` = `QHeaderView::section`
/// 底;`hovered.bg_fill` = `#54687A` = 选中 tab 底;`hyperlink_color` = `#259AE9` =
/// 选中 tab 下划线)。0.2.30 起主题只有一套,原来「按主题分叉」的那条 match 随之消失。
#[derive(Clone, Copy)]
struct Chrome {
    /// 表头带底 + 一切分隔线/网格线(1px)。
    line: egui::Color32,
    /// 表头带文字。
    header_text: egui::Color32,
    /// 未选中 tab 的「头」底(qss `QTabBar::tab:top` 正是表头带同色)。
    tab_head_fill: egui::Color32,
    /// 选中 tab 的底。
    tab_fill: egui::Color32,
    /// 选中 tab 的文字。
    tab_text: egui::Color32,
    /// 选中 tab 的下划线(qss 3px 那支)。
    tab_underline: egui::Color32,
}

impl Chrome {
    /// 从当前 visuals 派生(唯一主题 → 唯一派生规则,不再按主题分叉)。
    fn of(v: &egui::Visuals) -> Self {
        let line = v.widgets.noninteractive.bg_stroke.color;
        Self {
            line,
            header_text: v.widgets.noninteractive.fg_stroke.color,
            tab_head_fill: line,
            tab_fill: v.widgets.hovered.bg_fill,
            tab_text: v.widgets.hovered.fg_stroke.color,
            tab_underline: v.hyperlink_color,
        }
    }
}

/// 页签(BD-UI-41,对照 qdarkstyle `QTabBar::tab:top`)。
///
/// Python 侧四个区全是 QTabWidget(`mainwindow.py:106-204`,连只有一个 tab 的
/// 「成交」「持仓」也带 tab 头),qss 给 tab 的形态是:
///   未选中 `QTabBar::tab:top { background #455364; padding 2px 4px }` +
///     `!selected { border-bottom: 2px solid #19232D }`(qss:1579 / 1559)
///   选中   `QTabBar::tab:top:selected { background #54687A;
///     border-bottom: 3px solid #259AE9; 上圆角 4px }`(qss:1592)
/// egui 的 `selectable_label` 只有「整块 selection 填充」,画不出下划线,也没有
/// 「未选中也有头底」这一层。所以这里照 pinned_table 表头带同一套路子:
/// **控件仍走 selectable_label**(可访问性标签 / 点击 / 键盘都不换),只是随后用
/// painter 盖上头底 + 下划线,并重画文字(epaint 0.33 没有 z-order,后画的填充
/// 会盖住先画的文字,所以文字必须重画 —— 与表头带同一处理)。
fn tab_label(ui: &mut egui::Ui, selected: bool, text: impl Into<String>) -> egui::Response {
    let ch = Chrome::of(ui.visuals());
    let text: String = text.into();
    let resp = ui.selectable_label(selected, text.clone());
    let r = resp.rect;
    let radius = ui.visuals().widgets.inactive.corner_radius;
    let font = ui.style().text_styles[&egui::TextStyle::Button].clone();
    let p = ui.painter();
    let (fill, ink, underline) = if selected {
        (
            ch.tab_fill,
            ch.tab_text,
            egui::Stroke::new(3.0, ch.tab_underline), // qss 的 3px 那支
        )
    } else {
        (
            ch.tab_head_fill,
            ui.visuals().widgets.inactive.fg_stroke.color,
            egui::Stroke::new(2.0, ch.line), // qss 未选中 tab 的 2px 下边线
        )
    };
    p.rect_filled(r, radius, fill);
    p.hline(r.x_range(), r.max.y, underline);
    p.text(
        r.center(),
        egui::Align2::CENTER_CENTER,
        text.as_str(),
        font,
        ink,
    );
    resp
}

/// 普通 Grid 的表头带(BD-UI-41)。
///
/// 与 `pinned_table` 的覆盖带同一套路子:头行照常在 grid 里占格(列宽由它量出来,
/// 这是唯一权威源),随后 painter 盖上带底 + 下边线并重画文字(epaint 0.33 无 z-order,
/// 填充盖字 → 文字必须重画)。
///
/// 为什么这三处不走 `pinned_table`:它们是**自动尺寸浮动窗里的短表**(账户清单 /
/// 运维插件表 / 服务目录)。0.2.17 实锤(s39):`pinned_table` =
/// `auto_shrink(false)` 滚动区吃满整块可用高 + 覆盖式表头带,在自动尺寸浮动窗里
/// 两者凑不出正确高度 → 表行与其后的口径句互相压字。账户行最多几个,不需要固定
/// 表头滚动面,只要那根带。
///
/// 0.2.29(BD-UI-44)把这条边界写死:数据监控表(行情/委托/成交/持仓/日志/合约/资金)
/// 一律 TableBuilder;自动尺寸浮动窗里的短表一律 Grid + 这根带。资金表原来在第三类里,
/// 实测它和日志表共用同一块 tab 容器(不是浮动窗)→ 已并入 TableBuilder 一侧。
fn header_band(ui: &mut egui::Ui, heads: &[(egui::Rect, String)], content_right: f32) {
    if heads.is_empty() {
        return;
    }
    let ch = Chrome::of(ui.visuals());
    // 带的横向范围 = **整行**(这一格 / 这一窗的可用宽),不是表头文字矩形的并集。
    // 根因(0.2.28 用户实看指出「运维窗表头背景没按整行、最后一列只有文字有背景」):
    // `Response::rect` 是控件自己的矩形,不是列框(grid.rs:180-193 —— `next_cell`
    // 给出列框,`align_size_within_rect` 按 LEFT_CENTER 对齐后返回子控件尺寸)。
    // 表头 label 的 rect 宽 = 文字宽。原来按表头 rect 的并集算带 → 带只盖到
    // 最后一列**表头文字**的右端,列内比它宽的部分(运维窗『操作』列的两个按钮、
    // 服务目录的空实例列、资金格右侧)没有带 = 看上去断开一截。
    // 口径照 Python:QHeaderView 铺满整个表视口;也与 `pinned_table` 那条带一致
    // (那条铺的是 ScrollArea 的 inner_rect = 整格宽)。
    let left = ui.max_rect().min.x;
    // 0.2.30(BD-UI-47):带的右端取「可用宽」与**表体实际右端**的较大者。
    // 浮动窗是自动尺寸的,而 `header_band` 在 Grid 之后才画 —— 令牌把控件交互宽
    // 从 egui 缺省 128 收到 40 后,窗内 Grid 的实际宽度比窗的可用宽更宽(s69 实测
    // 带 640 / 体表 727),带就盖不住最后一列。口径不变:带必须盖住整行。
    let right = ui.max_rect().max.x.max(content_right);
    let top = heads[0].0.min.y;
    let bottom = heads[0].0.max.y + ui.spacing().item_spacing.y;
    let strip = egui::Rect::from_min_max(egui::pos2(left, top), egui::pos2(right, bottom));
    let p = ui.painter();
    p.rect_filled(strip, 0.0, ch.line);
    p.hline(
        strip.x_range(),
        strip.max.y,
        egui::Stroke::new(1.0, ch.line),
    );
    let font = ui.style().text_styles[&egui::TextStyle::Small].clone();
    let mid_y = (top + heads[0].0.max.y) * 0.5;
    for (rect, text) in heads {
        p.text(
            egui::pos2(rect.min.x, mid_y),
            egui::Align2::LEFT_CENTER,
            text.as_str(),
            font.clone(),
            ch.header_text,
        );
    }
}

/// 画一窗(官方面板组合:render_body 直接开顶层面板,不自嵌 CentralPanel)。
///
/// v5 框架(BD-UI-29 面板化):TopBottomPanel(菜单) → TopBottomPanel(行情带,
/// resizable = Python 分带 splitter 语义) → SidePanel(下单面板 + 盘口,
/// resizable) → CentralPanel(2×2 监控格,响应式分配,必须最后) → 弹窗。
/// 官方纪律(panel.rs 模块文档):顶层面板不得互相嵌套、CentralPanel 最后加、
/// Window 挂在所有面板之后。
pub fn render_body(ctx: &egui::Context, shared: &UiShared) {
    apply_ui_style(ctx);
    // 0.3.1(Wave D,BD-UI-49)退出确认:关窗先问一句(照 Python `closeEvent`)。
    // 拦关闭用的是 egui 0.33 的 `ViewportCommand::CancelClose`;用户在窗里点「确认退出」
    // 才置放行位并重发 `Close` —— 否则确认完也关不掉。
    let close_requested = ctx.input(|i| i.viewport().close_requested());
    if close_requested && !shared.exit_confirmed() && !shared.exit_confirm_open() {
        ctx.send_viewport_cmd(egui::ViewportCommand::CancelClose);
        shared.open_exit_confirm();
    }
    // 0.3.2(Wave E,BD-UI-50)告警 toast 每帧收口(队列常驻在 UiShared,不是这里的局部变量)。
    crate::toast::drain_and_show(ctx, shared);
    if shared.exit_confirm_open() {
        egui::Window::new("退出确认")
            .collapsible(false)
            .resizable(false)
            .show(ctx, |ui| {
                ui.label("确认退出 ek-ui?");
                ui.horizontal(|ui| {
                    if ui.button("取消").clicked() {
                        shared.close_exit_confirm();
                    }
                    if ui.button("确认退出").clicked() {
                        shared.confirm_exit();
                        shared.close_exit_confirm();
                        ctx.send_viewport_cmd(egui::ViewportCommand::Close);
                    }
                });
            });
    }
    // ---- 菜单栏(顶层面板,最先 = 最外) ----
    egui::TopBottomPanel::top("menu_bar").show(ctx, |ui| {
        render_menu_bar(ui, shared);
    });

    // ---- 上带:行情带(全宽独占;可拖分隔条,缺省 240 ≈ Python 30:70 分带) ----
    egui::TopBottomPanel::top("market_band")
        .resizable(true)
        .default_height(crate::tokens::MARKET_BAND_HEIGHT)
        .show(ctx, |ui| {
            // 外层 ScrollArea auto_shrink(false) = resizable 面板吃满前提(BD-UI-27
            // 口径;s3 实锤:撤掉后空态带塌成一行,2×2 行位全漂移)。内层
            // pinned_table 自己会收缩适配 → 外层滚动条永不出现。
            egui::ScrollArea::both()
                .id_salt("market_band_scroll")
                .auto_shrink([false, false])
                .show(ui, |ui| {
                    render_market_band(ui, shared);
                });
        });

    // ---- 下带左侧:下单面板 + 盘口(Python TradingWidget 内序:字段钮 → 盘口) ----
    egui::SidePanel::left("order_side")
        .resizable(true)
        .default_width(crate::tokens::ORDER_SIDE_WIDTH)
        .show(ctx, |ui| {
            // ScrollArea 吸收 sizing 退让(BD-UI-27):网格后置 err label 不再叠回网格
            egui::ScrollArea::vertical()
                .id_salt("order_side_scroll")
                .auto_shrink([false, false])
                .show(ui, |ui| {
                    render_order_panel(ui, shared);
                    ui.separator();
                    render_book_frame(ui, shared);
                });
        });

    // ---- 下带右侧:2×2 监控格(CentralPanel 最后;响应式分配,无定宽定高) ----
    egui::CentralPanel::default().show(ctx, |ui| {
        crate::dock::show_monitor_dock(ui, shared);
    });

    // ---- 弹窗面(官方口径:Window 在顶层面板之后) ----
    render_windows(ctx, shared);
}

// 0.3.0(Wave C,BD-UI-48):`group_frame_plain`(BD-UI-34 的「预留矩形 + 描边」格容器)退役。下带四组的容器换 `egui_dock` 自己的
// leaf 容器 —— 格边框与分隔条由 dock `Style` 给,而 dock 的 `Style` 只从 `tokens::apply`
// 填好的 egui `Style` 派生(`Style::from_egui`),不新增第二套颜色。
// 0.2.30 那条教训仍然成立并记在 DESIGN.md:egui 0.33.3 的 `Frame` 没有 `min_size`,
// `Frame::paint` 的描边按**内容** min_rect 算(frame.rs:486)——内容少的格边框会跟着缩。

/// 表头固定表(BD-UI-34 用户裁定「每个表的表头都要固定」;0.2.29 起实现换成
/// `egui_extras::TableBuilder`,BD-UI-44)。
///
/// 为什么换(实拍毛病 2/3/5,对照 Python 的 QTableView):
/// - **列宽跟内容**:手绘 Grid 的列宽只能取各格 `Response::rect` 的最大值,而
///   `Response::rect` 是控件矩形不是列框(0.2.28 实锤,egui grid.rs:180-193)
///   → 列宽只能"差不多",数字列对不齐。TableBuilder 的列宽是库自己量出来的
///   (`Column::auto()` → `max_used_widths`,egui_extras table.rs:840-852)。
/// - **表头天生固定**:表头行画在体表 ScrollArea 之外(egui_extras table.rs:746
///   `ScrollArea::new([false, vscroll])` = 横向不滚、纵向滚)→ 0.2.8 起那块
///   「ScrollArea 之后重画覆盖带 + 重画表头文字」的 DIY 全撤(当年 DIY 是因为
///   egui 没有表;scroll_area.rs:412 那句「painting a sticky header on top of it」
///   就是 DIY 的出处)。
/// - **横向溢出**:成交表 14 列比格子宽,Python 出横向滚动条(毛病 5)。TableBuilder
///   自己只开竖滚 → 整张表(表头 + 体表)包在一层横向 ScrollArea 里:表头跟着体表
///   一起横滚(不错位),竖滚仍归表体(表头不动)。
/// - **选中 / 悬停底色**改吃主题:`TableRow::set_selected` → egui_extras layout.rs:137
///   用 `visuals.selection.bg_fill`,悬停用 `widgets.hovered.bg_fill`,且两者都按
///   `expand2(0.5 * item_spacing)` 补缝(layout.rs:125-127)= 整行底色连续
///   → 手绘 `paint_row_bg` 那支硬编码半透明蓝撤掉(与 0.2.27「斑马纹跟主题」同口径)。
/// - **网格线**:列线 = 可拖列边界那根线(egui_extras table.rs:894-907,色 =
///   `widgets.noninteractive.bg_stroke` = chrome 线色);行线 = 每行上报的行底 +
///   半间距。只有合约表开:Python `widget.py:367` 的 `setShowGrid(False)` 只加在
///   交易表上,合约表(`widget.py:2423` / `2621`)没关(`gridline-color:#455364`,qss:1882)。
///
/// body 闭包在表体内执行(行循环归闭包);行高由本模块统一算,body 只写每格内容。
enum GridLines {
    /// 不画网格线(Python 交易表口径)。
    Plain,
    /// 列线 + 行线(Python 合约表口径)。
    Grid,
}

/// 行高 / 表头高 = 字号 + 6。Python QTableView 的 sizeHint ≈ 字体高 + 4~6;
/// 0.2.28 之前 Grid 自然行高在 kittest 实测行间距 21 = 正文 14.7 + 6,同值。
fn table_heights(ui: &egui::Ui) -> (f32, f32) {
    let st = ui.style();
    // 行高必须取「文字高 + 6」与**控件交互高令牌**的较大者。格里有钮 / 勾选框时
    // TableBuilder 的实际行高 = max(请求值, 格内最高控件):请求值 22 < 实际 26 时,
    // 行线公式按假行高算 —— 0.2.30 实锤:行线画在 y=514 而第 3 行文字中心在 511
    // = 0.2.28 治过的毛病 8(行线压到文字中心上)复发。别把这个 max 拆掉。
    let floor_h = crate::tokens::INTERACT_HEIGHT;
    (
        (st.text_styles[&egui::TextStyle::Body].size + 6.0).max(floor_h),
        (st.text_styles[&egui::TextStyle::Small].size + 6.0).max(floor_h),
    )
}

/// 格内容闭包的返回值里能不能取到一个 `Response`。
/// 为什么要这个:egui 的点击只发给**一个**响应 —— `context.rs:1384`
/// `let clicked = Some(id) == viewport.interact_widgets.clicked;` 比的是单个 Id,
/// 后加的控件优先。格里有真控件(钮 / 勾选框)时,点击归那个控件,归不到
/// `TableRow::col` 返回的「格响应」。所以行动作必须两边都看(0.2.29 实锤:
/// 只看格响应 → 行情首列钮、委托撤单钮、合约勾选框三处点击全丢)。
trait CellOutcome {
    fn response(&self) -> Option<egui::Response>;
}

impl CellOutcome for egui::Response {
    fn response(&self) -> Option<egui::Response> {
        Some(self.clone())
    }
}

impl CellOutcome for () {
    fn response(&self) -> Option<egui::Response> {
        None
    }
}

impl<T: CellOutcome> CellOutcome for egui::InnerResponse<T> {
    fn response(&self) -> Option<egui::Response> {
        self.inner
            .response()
            .or_else(|| Some(self.response.clone()))
    }
}

/// 一格:把调用点写的闭包交给库的 `TableRow::col`,并带回**两个**响应 ——
/// 格响应(整格可点,`TableBuilder::sense` 给的)与格内容自己的响应(钮/勾选框)。
/// 助手签名把「参数 = `&mut egui::Ui`」写死,调用点那个闭包(表达式形态
/// `|ui| ui.label(..)`,本身返回 `egui::Response`)于是有了确定的期望类型 ——
/// 参数类型推得出来;返回值在这里被助手吃掉(库的 `col` 要的是返回 `()` 的闭包,
/// rustc 不会替你把 `Response` 隐式丢成 unit,它只提示「consider using a semicolon」)。
/// 宏里套一层定义点闭包再塞 `$make` 时,期望类型来得太晚:调用点闭包的参数类型
/// 推不出来(E0282,本轮实撞)。
/// `right_align`(0.2.29,毛病 3「数字不成列」):数字列走 `Layout::right_to_left`
/// → 同一列里每行数字的右边界落在格右缘,数字因此成列对齐。
fn tcell<R: CellOutcome>(
    row: &mut egui_extras::TableRow<'_, '_>,
    right_align: bool,
    make: impl FnOnce(&mut egui::Ui) -> R,
) -> (egui::Response, Option<egui::Response>) {
    let mut captured: Option<R> = None;
    let (_, cell_r) = row.col(|ui| {
        captured = Some(if right_align {
            // 0.2.30:右对齐这件事的实现搬进 `ui_ext::num_cell`(UiExt 五支之一),
            // 这里只留「要不要走数字格」这个开关。
            crate::ui_ext::num_cell(ui, make)
        } else {
            make(ui)
        });
    });
    let inner = captured.as_ref().and_then(|r| r.response());
    (cell_r, inner)
}

/// body 闭包的形状(0.2.29):`(表体, 行高) -> 行数`。
/// 行高由 `table_heights` 统一算;返回值 = 这一拍画了几行 —— 网格线按它算
/// (N 行 → N-1 根行线)。
///
/// 为什么 body 直接吃 `egui_extras::TableBody` 而不是我们包一层上下文:包一层就是
/// 双层高阶生命周期(bounded closure 里再套 bounded closure),调用点里
/// `row.col(|ui| ..)` 的闭包参数类型推不出来(E0282,本轮实撞)。照库自己的形状传最稳。
fn pinned_table(
    ui: &mut egui::Ui,
    table_id: &str,
    headers: &[&str],
    body: impl FnOnce(&mut egui_extras::TableBody<'_>, f32) -> usize,
) -> Option<usize> {
    pinned_table_impl(ui, table_id, headers, GridLines::Plain, None, false, body)
}

/// 0.3.1(Wave D,BD-UI-49)可排序表:`sort` = 当前排序键,返回**这一拍被点过的表头列**。
/// 排序键由调用方从 `UiShared::table_sort` 取、点完表头再写回 `toggle_table_sort` --
/// 排序只作用在「喂表前的快照副本」上(`sorted_rows`),数据模型不被界面排序改写。
fn pinned_table_sorted(
    ui: &mut egui::Ui,
    table_id: &str,
    headers: &[&str],
    sort: Option<(usize, bool)>,
    resize: bool,
    body: impl FnOnce(&mut egui_extras::TableBody<'_>, f32) -> usize,
) -> Option<usize> {
    pinned_table_impl(ui, table_id, headers, GridLines::Plain, sort, resize, body)
}

/// 喂表前的快照副本排序(W2 的判据对象)。`key` 返回**可比较字符串**;数字列调用方给
/// 零填充串(`{:020.4}`)保证字典序 == 数值序。`sort` 为 `None` = 原序,一行都不动。
fn sorted_rows<'a, T>(
    rows: &'a [T],
    sort: Option<(usize, bool)>,
    key: impl Fn(&T, usize) -> String,
) -> Vec<&'a T> {
    let mut out: Vec<&'a T> = rows.iter().collect();
    if let Some((col, asc)) = sort {
        out.sort_by(|a, b| {
            let (ka, kb) = (key(a, col), key(b, col));
            if asc { ka.cmp(&kb) } else { kb.cmp(&ka) }
        });
    }
    out
}

/// 同上 + **体表网格线**(BD-UI-41)。口径照 Python:全仓只有合约表有网格线。
fn pinned_table_grid(
    ui: &mut egui::Ui,
    table_id: &str,
    headers: &[&str],
    body: impl FnOnce(&mut egui_extras::TableBody<'_>, f32) -> usize,
) -> Option<usize> {
    pinned_table_impl(ui, table_id, headers, GridLines::Grid, None, false, body)
}

/// 成交行的展示字符串（`TRADE_HEADERS` 同序）。**排序键与「保存数据」CSV 共用这一份口径** ——
/// 表里看见什么，导出来就是什么，不留第二套格式化。
/// 0.3.3 Wave F:这一份的顺序就是 `TRADE_HEADERS` 的顺序(判据 F1 钉「内容与表头同列」,
/// 两处不同序 = CSV 与屏幕不一致)。
fn trade_cells(t: &ek_data::trade::TradeData) -> Vec<String> {
    vec![
        t.symbol.clone(),
        if t.name.is_empty() {
            "-".to_string()
        } else {
            t.name.clone()
        },
        t.exchange.as_str().to_string(),
        t.direction
            .map(|d| d.as_str().to_string())
            .unwrap_or_else(|| "-".to_string()),
        t.offset.as_str().to_string(),
        crate::format::price(t.price),
        crate::format::volume(t.volume),
        crate::format::price(t.traded_amount),
        crate::format::time_hms_millis(t.datetime),
        t.tradeid.clone(),
        t.orderid.clone(),
        t.gateway_name.clone(),
    ]
}

/// 排序键:数字列给**零填充串**(`{:020.4}`)保证字典序 == 数值序;文本列直接比。
/// 注意不能直接拿 `trade_cells` 的显示串当排序键 —— "101" < "12.345" < "3.5" 是字典序,
/// 不是价格序(本轮实撞,判据 W1 当场红出来的)。
/// 列序 0.3.3 Wave F 跟着 `TRADE_HEADERS` 走:5 = 价格,6 = 数量,7 = 成交金额,8 = 时间。
fn trade_sort_key(t: &ek_data::trade::TradeData, col: usize) -> String {
    match col {
        5 => format!("{:020.4}", t.price),
        6 => format!("{:020.4}", t.volume),
        7 => format!("{:020.4}", t.traded_amount),
        8 => t.datetime.map(|ns| format!("{ns:025}")).unwrap_or_default(),
        c => trade_cells(t).get(c).cloned().unwrap_or_default(),
    }
}

/// 「保存数据」：当前表（已按界面排序键排好的那份副本）写成 CSV 到 `target/ek-ui-<表>.csv`。
/// 只写界面看见的内容，不碰后端、不碰数据模型。
fn save_table_csv<T>(
    table: &str,
    headers: &[&str],
    rows: &[&T],
    cells: impl Fn(&T) -> Vec<String>,
) -> std::io::Result<()> {
    let mut s = headers.join(",");
    s.push('\n');
    for r in rows {
        s.push_str(&cells(r).join(","));
        s.push('\n');
    }
    let dir = std::env::current_dir()?.join("target");
    std::fs::create_dir_all(&dir)?;
    std::fs::write(dir.join(format!("ek-ui-{table}.csv")), s)
}

fn pinned_table_impl(
    ui: &mut egui::Ui,
    table_id: &str,
    headers: &[&str],
    grid_lines: GridLines,
    sort: Option<(usize, bool)>,
    resize: bool,
    add_body: impl FnOnce(&mut egui_extras::TableBody<'_>, f32) -> usize,
) -> Option<usize> {
    let mut clicked: Option<usize> = None;
    let mut header_cells: Vec<(usize, egui::Rect)> = Vec::with_capacity(headers.len());
    let ch = Chrome::of(ui.visuals());
    let (row_h, head_h) = table_heights(ui);
    let sp = ui.spacing().item_spacing;
    let m = ui.visuals().clip_rect_margin;
    // 表头带:整行宽(Python QHeaderView 铺满表视口;0.2.28 给浮动窗短表补的
    // header_band 铺整行是同一件事)。画在表之前 = 在表头文字之下,零布局副作用
    // (0.2.6「资金右多一根竖线」那类 min_rect 被撑宽的病在这里不会再犯)。
    let left = ui.cursor().min.x - sp.x * 0.5;
    let top = ui.cursor().top();
    let band = egui::Rect::from_min_max(
        egui::pos2(left, top - m),
        egui::pos2(left + ui.available_width() + sp.x, top + head_h + sp.y),
    );
    ui.painter().rect_filled(band, 0.0, ch.line);
    // 带底下边线:表头带与体表的分界(Python 的表头带与体表是两种底色,天然有界;
    // 我们只有一根带,补线才有界)。
    ui.painter()
        .hline(band.x_range(), band.max.y, egui::Stroke::new(1.0, ch.line));
    // 横向溢出:整张表(表头 + 体表)包在一层横向 ScrollArea 里,见模块头注释。
    // 滚动条必须看得见(0.2.29 实锤,s21 + chk-0229 实拍):egui 缺省
    // `scroll.foreground_color = false` → 把手色 = `visuals.bg_fill` = 体表色
    // (scroll_area.rs:1418-1425)→ 条其实画了,但和体表同色 = 看不见 =
    // 毛病 5「最后一列被切掉且没有横向滚动提示」只治了一半。
    // Qt 口径:滚动条占位(不悬浮盖内容)+ 高对比把手。
    {
        let scroll = &mut ui.style_mut().spacing.scroll;
        scroll.floating = false;
        scroll.foreground_color = true;
        scroll.bar_width = 10.0;
    }
    egui::ScrollArea::horizontal()
        .id_salt(format!("{table_id}_hscroll"))
        .auto_shrink([false, false])
        .show(ui, |ui| {
            // 斑马纹跟主题(0.2.27 口径):TableBuilder 缺省就是 visuals().striped
            // (table.rs:482),这里明写出来,免得日后又被硬开成 striped(true)。
            // (先取出来:TableBuilder::new 已把 ui 可变借走,链上再读 ui 会撞借用检查。)
            let striped = ui.visuals().striped;
            let mut tb = egui_extras::TableBuilder::new(ui)
                .id_salt(table_id)
                .striped(striped)
                .cell_layout(egui::Layout::left_to_right(egui::Align::Center))
                .sense(egui::Sense::click())
                .auto_shrink([false, false])
                // 列分隔线只给合约表(它也是全仓唯一能拖列宽的表:拖列边界改宽度 +
                // 双击列边界重新按内容自适应,table.rs:864-888)。其余表不给线 =
                // Python `setShowGrid(False)` 的口径。
                .resizable(matches!(grid_lines, GridLines::Grid) || resize);
            for _ in 0..headers.len() {
                tb = tb.column(egui_extras::Column::auto().at_least(24.0));
            }
            tb.header(head_h, |mut hr| {
                for (i, h) in headers.iter().enumerate() {
                    // 表头比正文小一档(Python:13px vs 14.7px)。
                    // 0.3.1(Wave D,BD-UI-49):表头可点 = 排序入口(照 Python QTableView 单击表头
                    // 排序),当前排序列在表头文字后挂 ▲/▼(Python 同样是表头带箭头)。
                    let mark = match sort {
                        Some((c, asc)) if c == i => {
                            if asc {
                                " ▲"
                            } else {
                                " ▼"
                            }
                        }
                        _ => "",
                    };
                    // 表头格只有 hover 感(egui_extras 的 `.sense(click())` 作用在体表格,表头格
                    // 不吃 —— 本轮两次实撞:先「点表头没反应」,再「在格内 interact 也没反应」)。
                    // 正解:先把每格的矩形收下来,表建完以后在同一层里补 interact。
                    let (cell_rect, _) = hr.col(|ui| {
                        ui.label(egui::RichText::new(format!("{h}{mark}")).strong().small());
                    });
                    header_cells.push((i, cell_rect));
                }
            })
            .body(|mut body| {
                let n_rows = add_body(&mut body, row_h);
                if matches!(grid_lines, GridLines::Grid) {
                    // 行线 = 相邻两行的间隙中点。行高是显式给定的(不是量出来的),
                    // 所以「表体顶 + (k+1)*行高 + k*行间距 + 半行间距」就在缝里 ——
                    // 0.2.28 那套按行数等分推算(毛病 8 的根因:把行线画到文字中心上)
                    // 在这里没有存在必要。N 行 → N-1 根。
                    // 表体顶 = `max_rect().min.y`:StripLayout::new 取 ui 的
                    // available_rect_before_wrap 左上角 = 第一行的左上角(layout.rs:64-71)。
                    let top = body.max_rect().min.y;
                    let x = body.max_rect().x_range();
                    // 已知遗留(0.2.30 记录,交接报告 §7.1 待办):`row_h` 是
                    // `table_heights` 算出的**请求**行高,而 TableBuilder 实际行高取
                    // max(请求值, 格内最高控件)—— 令牌把控件交互高从 egui 缺省 18 提到
                    // 26 后两者不再相等,行线相对真实行边界上漂(实测 6 px,不压文字中心)。
                    // 本轮不追:追它要同时改 `table_heights` 与每格控件高度,牵连 15 张
                    // 快照与三张浮动窗快照。判据 s72 已按「缺口 ≤ 8 px」钉住,不许变大。
                    let p = body.ui_mut().painter();
                    for k in 0..n_rows.saturating_sub(1) {
                        let k = k as f32;
                        let y = top + (k + 1.0) * row_h + k * sp.y + sp.y * 0.5;
                        p.hline(x, y, egui::Stroke::new(1.0, ch.line));
                    }
                }
            });
            // 表建完,在同一层(横向 ScrollArea 的内层 ui)给每格表头补一次点击感。
            // 必须在这里做:格内的 ui 被 TableBuilder 借走,而且坐标要落在同一层里才对得上。
            for (i, rect) in &header_cells {
                let id = ui.id().with(("ek_table_header", table_id, *i));
                if ui.interact(*rect, id, egui::Sense::click()).clicked() {
                    clicked = Some(*i);
                }
            }
        });
    clicked
}

// ================= 菜单栏 =================

fn render_menu_bar(ui: &mut egui::Ui, shared: &UiShared) {
    ui.horizontal(|ui| {
        // BD-UI-31(R1):一键直达 —— 菜单钮即入口,单击直接弹窗(去下拉层)。
        if ui.button(MENU_OPS).clicked() {
            shared.set_ops_window_open(true);
        }
        if ui.button(MENU_ACCOUNTS).clicked() {
            shared.set_accounts_window_open(true);
        }
        if ui.button(MENU_CONTRACTS).clicked() {
            shared.set_contracts_window_open(true);
        }
        // 0.3.0(Wave C,BD-UI-48):dock 布局可复位 —— 拖乱了有一键回默认 2×2。
        if ui.button("恢复布局").clicked() {
            *shared.dock_tree() = Some(crate::dock::default_tree());
        }
        ui.menu_button(MENU_HELP, |ui| {
            ui.label(format!("ek-station 观测台 v{}", env!("CARGO_PKG_VERSION")));
            ui.label("布局 = Python 主窗框架等价(行情带/交易带/弹窗)");
        });
        // 0.2.30(裁定 8,BD-UI-46):主题一键循环钮删除。界面只有一套 Qt深色
        // (qdarkstyle 3.2.3 复刻),「可换主题」这件事本身从产品面上撤掉了。
    });
}

// ================= 行情带 =================

fn render_market_band(ui: &mut egui::Ui, shared: &UiShared) {
    // BD-UI-31(R4):表题文字撤除(带位即身份,Python TickMonitor 无题同口径)。
    let groups = shared.tick_groups();
    if groups.is_empty() {
        ui.label("(等待 eTick 订阅)");
        return;
    }
    // 二级 tab:只列有 tick 的所
    let sel = shared.selected_exchange();
    let active = if groups.iter().any(|(e, _)| *e == sel) {
        sel.clone()
    } else {
        groups[0].0.clone()
    };
    ui.horizontal(|ui| {
        for (ex, _) in &groups {
            if tab_label(ui, *ex == active, ex.clone()).clicked() {
                shared.set_selected_exchange(ex.clone());
            }
        }
    });
    let ticks = groups
        .iter()
        .find(|(e, _)| *e == active)
        .map(|(_, v)| v.clone())
        .unwrap_or_default();
    // 状态行「tick N 格 / 最后更新 …」撤除(BD-UI-35,用户裁定:此信息早已
    // 不需要,行情带 tab + 表格即全部)。
    // 0.3.3(收 Wave D 欠账):行情带也吃「点表头排序」(缺省序 = 按所/symbol)。
    let sort = shared.table_sort("tick_grid");
    let ticks = sorted_rows(&ticks, sort, tick_sort_key);
    let clicked = pinned_table_sorted(
        ui,
        "tick_grid",
        &[
            "代码",
            "名称",
            "最新价",
            "涨跌幅",
            "成交量",
            "今开",
            "最高",
            "最低",
            "买1价",
            "买1量",
            "卖1价",
            "卖1量",
            "时间",
            "行情源",
        ],
        sort,
        false,
        |body, row_h| {
            const RIGHT_COLS: [usize; 10] = [2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
            for t in &ticks {
                // 行交互(BD-UI-31 扩展):行内任何一格单击 = 带入下单面板
                // (盘口四列带方向:买1价/买1量 → 卖,卖1价/卖1量 → 买,价格列
                // 顺带填价;其余列方向/价格保持默认——用户裁定);任何一格双击
                // = 弹 K线窗。选中行 = 下单面板当前合约(带入即跳色)。
                let row_sel = shared.order_form().symbol == t.symbol;
                body.row(row_h, |mut row| {
                    // 选中底色改吃主题(0.2.29,BD-UI-44):`set_selected` → egui_extras
                    // layout.rs:137 用 `visuals.selection.bg_fill`,并按半间距补缝 = 整行
                    // 连续 → 手绘 `paint_row_bg`(硬编码半透明蓝)撤除。
                    row.set_selected(row_sel);
                    let mut dbl = false;
                    macro_rules! cell {
                        ($make:expr, $col:expr) => {{
                            let (cell_r, inner_r) =
                                tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                            let hit =
                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
                            if hit {
                                shared.set_selected_exchange(active.clone());
                                import_tick(shared, t, &active, $col);
                            }
                            dbl |= cell_r.double_clicked()
                                || inner_r.as_ref().is_some_and(|r| r.double_clicked());
                        }};
                    }
                    cell!(|ui| ui.button(t.symbol.clone()), 0);
                    cell!(
                        |ui| ui.label(if t.name.is_empty() {
                            "-".to_string()
                        } else {
                            t.name.clone()
                        }),
                        1
                    );
                    cell!(|ui| ui.label(crate::format::price(t.last_price)), 2);
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(crate::format::pct(t.pct_change))
                                .color(crate::tokens::rise_fall(t.pct_change)),
                        ),
                        3
                    );
                    cell!(|ui| ui.label(crate::format::volume(t.volume)), 4);
                    cell!(|ui| ui.label(crate::format::price(t.open_price)), 5);
                    cell!(|ui| ui.label(crate::format::price(t.high_price)), 6);
                    cell!(|ui| ui.label(crate::format::price(t.low_price)), 7);
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(crate::format::price(t.bid_price_1))
                                .color(crate::tokens::semantic::RISE),
                        ),
                        8
                    );
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(crate::format::volume(t.bid_volume_1))
                                .color(crate::tokens::semantic::RISE),
                        ),
                        9
                    );
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(crate::format::price(t.ask_price_1))
                                .color(crate::tokens::semantic::FALL),
                        ),
                        10
                    );
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(crate::format::volume(t.ask_volume_1))
                                .color(crate::tokens::semantic::FALL),
                        ),
                        11
                    );
                    cell!(
                        |ui| ui.label(if t.update_time.is_empty() {
                            crate::format::time_hms_millis(Some(t.datetime))
                        } else {
                            t.update_time.clone()
                        }),
                        12
                    );
                    cell!(|ui| ui.label(t.gateway_name.clone()), 13);
                    if dbl {
                        shared.open_kline(t.symbol.clone());
                    }
                });
            }
            ticks.len()
        },
    );
    if let Some(col) = clicked {
        shared.toggle_table_sort("tick_grid", col);
    }
}

/// 行情行的排序键(列序 == 行情带 14 列):数字列零填充,时间列纳秒零填充。
fn tick_sort_key(t: &ek_data::tick::TickData, col: usize) -> String {
    match col {
        0 => t.symbol.clone(),
        1 => t.name.clone(),
        2 => format!("{:020.4}", t.last_price),
        3 => format!("{:020.4}", t.pct_change),
        4 => format!("{:020.4}", t.volume),
        5 => format!("{:020.4}", t.open_price),
        6 => format!("{:020.4}", t.high_price),
        7 => format!("{:020.4}", t.low_price),
        8 => format!("{:020.4}", t.bid_price_1),
        9 => format!("{:020.4}", t.bid_volume_1),
        10 => format!("{:020.4}", t.ask_price_1),
        11 => format!("{:020.4}", t.ask_volume_1),
        12 => {
            if t.update_time.is_empty() {
                format!("{:025}", t.datetime)
            } else {
                t.update_time.clone()
            }
        }
        13 => t.gateway_name.clone(),
        _ => String::new(),
    }
}

// ================= 下单面板(常驻) =================

fn render_order_panel(ui: &mut egui::Ui, shared: &UiShared) {
    // BD-UI-31(R4):面板题字撤除(下单侧栏即身份)。
    let mut f = shared.order_form();
    let before = f.clone();
    let mut err: Option<String> = None;

    // 随价勾选:价格框随该合约最新 tick(勾选态)
    if f.follow_price {
        if let Some(t) = tick_of(shared, &f.exchange, &f.symbol) {
            if t.last_price > 0.0 {
                f.price = crate::format::price(t.last_price);
            }
        }
    }

    // 交易所下拉:有 tick 的所 ∪ 六家常用所(操作面默认,不是配置面)
    let mut ex_opts: Vec<String> = shared
        .tick_groups()
        .iter()
        .map(|(e, _)| e.clone())
        .collect();
    for e in ["SHFE", "DCE", "CZCE", "CFFEX", "INE", "GFEX"] {
        if !ex_opts.iter().any(|x| x == e) {
            ex_opts.push(e.to_string());
        }
    }
    if !ex_opts.contains(&f.exchange) {
        ex_opts.insert(0, f.exchange.clone());
    }
    // 接口下拉:账户清册(注册序)∪ trade_snap 网关去重集(B3 退役:
    // 不再硬编码 `["ctp"]`;0.2.10 BD-UI-38 sim 纸面网关退场同口径)。
    let ts = shared.trade_snap();
    let mut gw_opts: Vec<String> = Vec::new();
    // 0.2.18(规划 Q4):下单归属只列**已装配**账户 —— 只添加了还没连接的账户
    // 进了下拉,选它下单只会撞 `unknown:gateway`。
    // 账本侧历史网关名的口径(执行核查补的洞):清册非空时,**不在清册的历史网关
    // = 已摘除账户**,它留在下拉里同样是选它下单撞 `unknown:gateway` → 不进下拉
    // (撤单不受影响:撤单归属按每笔单自己的网关走,与这里的下拉无关)。
    // 清册为空 = 不干预(纯账本巡回钉 s27/s14 那类无账户配置面的形)。
    let known_gws = account_gateways(shared);
    for g in shared
        .accounts()
        .iter()
        .filter(|a| a.connected)
        .map(|a| a.gateway.clone())
        .chain(
            ts.orders
                .iter()
                .map(|o| o.gateway_name.clone())
                .chain(ts.trades.iter().map(|t| t.gateway_name.clone()))
                .chain(ts.accounts.iter().map(|a| a.gateway_name.clone()))
                .filter(|g| known_gws.is_empty() || known_gws.contains(g)),
        )
    {
        if !g.is_empty() && !gw_opts.contains(&g) {
            gw_opts.push(g);
        }
    }
    if !gw_opts.contains(&f.gateway)
        && !f.gateway.is_empty()
        && (known_gws.is_empty() || known_gws.contains(&f.gateway))
    {
        gw_opts.insert(0, f.gateway.clone());
    }
    // 手动选过的网关若已不在可选面(被摘除 / 未装配)= 就地回落到默认阶梯:
    // 否则下拉里挂着一个注定 `unknown:gateway` 的选项,且它会成为下一笔单的归属。
    if !f.gateway.is_empty() && !gw_opts.contains(&f.gateway) {
        f.gateway = shared.default_gateway().unwrap_or_default();
    }
    // 表单网关位为空 = 未手动选过:回填默认账户阶梯(上次选择 → 首个已连接 → 首个)。
    // 只改本地 `f` 副本 —— 面板末尾的 `f != before` 写回负责落盘,不在这里重复写。
    if f.gateway.is_empty() {
        if let Some(def) = shared.default_gateway() {
            f.gateway = def;
        }
    }
    let no_accounts = gw_opts.is_empty();

    // 表单网格(Python TradingWidget 字段排;委托/全撤 = 网格行;
    // 网格后不挂面板内容 —— 帧内 sizing 退让会把后置行叠回网格,盘口独立帧)。
    egui::Grid::new("order_form_grid")
        .num_columns(2)
        .show(ui, |ui| {
            ui.label("交易所");
            egui::ComboBox::from_id_salt("of_exchange")
                .selected_text(f.exchange.clone())
                .show_ui(ui, |ui| {
                    for e in &ex_opts {
                        ui.selectable_value(&mut f.exchange, e.clone(), e.clone());
                    }
                });
            ui.end_row();
            ui.label("代码");
            let sym_resp = ui.add(
                egui::TextEdit::singleline(&mut f.symbol)
                    .hint_text("cu2709")
                    .desired_width(150.0),
            );
            // 代码回车 = 订阅(Python TradingWidget returnPressed → set_en_symbol 等价)。
            // egui 单行 TextEdit 遇 Enter 即 surrender_focus,has_focus 在检查时已
            // false —— 规范口径 lost_focus + key_pressed(第五轮审计钉:s20 实测
            // has_focus 口径回车订阅从不触发)。
            if sym_resp.lost_focus() && ui.input(|i| i.key_pressed(egui::Key::Enter)) {
                let s = f.symbol.trim().to_string();
                // 与查询合约窗同口径:输入带 EX. 前缀则剥成裸代码(ctp.subscribe
                // 收裸码);剥后回写表单,名称/盘口/随价的 tick 查找同步可用。
                let bare = match s.split_once('.') {
                    Some((_, b)) => b.trim().to_string(),
                    None => s,
                };
                if !bare.is_empty() {
                    f.symbol = bare.clone();
                    // 订阅一律路由到行情元账号(规划 §5.C:单源;从账号无 MD 会话,
                    // 发给它只会静默成功 = 观测黑洞,所以路由在界面侧定死)。
                    match subscribe_target(shared) {
                        Ok(gw) => {
                            shared.push_cmd(UiCmd::CtpSubscribe {
                                gateway: gw.clone(),
                                symbols: vec![bare.clone()],
                            });
                            shared
                                .log_line(format!("[ops] 订阅已入列 {bare} → {gw}(代码回车订阅)"));
                        }
                        Err(e) => shared.log_line(format!("[订阅] {e}")),
                    }
                }
            }
            ui.end_row();
            ui.label("名称");
            ui.label(
                tick_of(shared, &f.exchange, &f.symbol)
                    .map(|t| {
                        if t.name.is_empty() {
                            "-".to_string()
                        } else {
                            t.name
                        }
                    })
                    .unwrap_or_else(|| "-".to_string()),
            );
            ui.end_row();
            ui.label("方向");
            egui::ComboBox::from_id_salt("of_direction")
                .selected_text(f.direction.as_str())
                .show_ui(ui, |ui| {
                    for d in [Direction::LONG, Direction::SHORT] {
                        ui.selectable_value(&mut f.direction, d, d.as_str());
                    }
                });
            ui.end_row();
            ui.label("开平");
            ui.horizontal(|ui| {
                egui::ComboBox::from_id_salt("of_offset")
                    .selected_text(f.offset.as_str())
                    .show_ui(ui, |ui| {
                        for o in [
                            Offset::OPEN,
                            Offset::CLOSE,
                            Offset::CLOSETODAY,
                            Offset::CLOSEYESTERDAY,
                        ] {
                            ui.selectable_value(&mut f.offset, o, o.as_str());
                        }
                    });
                // 0.1.1 BD-UI-30:自动开平勾选(开 = Auto 走拆单器;关 = None 原样)。
                ui.checkbox(&mut f.auto_split, "自动开平");
            });
            ui.end_row();
            ui.label("类型");
            egui::ComboBox::from_id_salt("of_order_type")
                .selected_text(f.order_type.as_str())
                .show_ui(ui, |ui| {
                    for ot in [OrderType::LIMIT, OrderType::MARKET] {
                        ui.selectable_value(&mut f.order_type, ot, ot.as_str());
                    }
                });
            ui.end_row();
            ui.label("价格");
            ui.horizontal(|ui| {
                ui.add(
                    egui::TextEdit::singleline(&mut f.price)
                        .hint_text("107660")
                        .desired_width(90.0),
                );
                ui.checkbox(&mut f.follow_price, "随价");
            });
            ui.end_row();
            ui.label("数量");
            ui.add(
                egui::TextEdit::singleline(&mut f.volume)
                    .hint_text("1")
                    .desired_width(90.0),
            );
            ui.end_row();
            ui.label("接口");
            egui::ComboBox::from_id_salt("of_gateway")
                .selected_text(if f.gateway.is_empty() {
                    "(未选账户)".to_string()
                } else {
                    f.gateway.clone()
                })
                .show_ui(ui, |ui| {
                    for g in &gw_opts {
                        ui.selectable_value(&mut f.gateway, g.clone(), g.clone());
                    }
                });
            ui.end_row();
            ui.label("操作");
            ui.horizontal(|ui| {
                // 无账户 = 无网关可下单(旧「空 → 字面量 ctp」兜底已退役,B4)。
                let send = ui
                    .add_enabled_ui(!no_accounts, |ui| {
                        crate::ui_ext::primary_button(ui, BTN_SEND_ORDER)
                    })
                    .inner
                    .clicked();
                if send {
                    match f.to_request() {
                        Ok(req) => {
                            let fallback = shared.default_gateway();
                            match crate::state::parse_gateway(&f.gateway, fallback.as_deref()) {
                                Ok(gateway) => {
                                    shared.push_cmd(UiCmd::SendOrder {
                                        req,
                                        gateway,
                                        mode: if f.auto_split {
                                            ek_oms::LockMode::Auto
                                        } else {
                                            ek_oms::LockMode::None
                                        },
                                    });
                                    shared.log_line("[ops] 下单请求已入列(等 eTimer 请辞)");
                                }
                                Err(e) => {
                                    shared.log_line(format!("[下单] {e}"));
                                    err = Some(e);
                                }
                            }
                        }
                        Err(e) => {
                            shared.log_line(format!("[下单] {e}"));
                            err = Some(e);
                        }
                    }
                }
                if ui.button(BTN_CANCEL_ALL).clicked() {
                    // 全撤 = 活动委托逐个走 oms.cancel_order(界面侧扇出;
                    // 守卫逐单计数在 oms,不可绕过——0.1.1 BD-UI-30)
                    let mut n = 0usize;
                    for o in ts.orders.iter().filter(|o| order_active(o.status)) {
                        // 撤单跟着**这笔单自己的网关**走(多账号面:不再回落 ctp)。
                        let gw = if !o.gateway_name.is_empty() {
                            o.gateway_name.clone()
                        } else {
                            shared.default_gateway().unwrap_or_default()
                        };
                        if gw.is_empty() {
                            continue;
                        }
                        shared.push_cmd(UiCmd::CancelOrder {
                            orderid: o.orderid.clone(),
                            gateway: gw,
                        });
                        n += 1;
                    }
                    shared.log_line(format!("[ops] 全撤入列 {n} 笔(等 eTimer 请辞)"));
                }
            });
            ui.end_row();
            crate::ui_ext::muted_label(ui, "代码回车 = 订阅");
            ui.label("");
            ui.end_row();
        });
    if let Some(e) = err {
        ui.label(egui::RichText::new(e).color(crate::tokens::semantic::ERROR));
    }
    if no_accounts {
        // 侧栏底部独立行(不落钮行内:会把「全撤」推出侧栏宽域,s3 结构钉)。
        ui.label(
            egui::RichText::new("无账户:先在「账户」面板添加账户(委托钮已禁用)")
                .color(crate::tokens::semantic::WARN),
        );
    }
    if f != before {
        shared.set_order_form(f.clone());
    }
}

/// 盘口帧(选中合约 tick 五档;Python 买5卖5 等价;独立帧避网格叠行)。
/// BD-UI-31(R4):题字撤除(含括号合约代码——选中合约已由下单面板代码格与
/// 行情带跳色行指认,盘口帧不重复报幕)。
/// 盘口买 / 卖侧色。**仍是硬编码**(§7.1 记的两处:卖 `0x2E9E2E` / 买 `0xE05050`),
/// Wave B 的设计令牌层接管后这两支并进语义色,这里先集中成常量免得散落。
const BOOK_ASK_COLOR: egui::Color32 = crate::tokens::semantic::FALL;
const BOOK_BID_COLOR: egui::Color32 = crate::tokens::semantic::RISE;

/// 盘口一行 = 三格:档位标签 / 价 / 量。价与量走右对齐(与数据表数字列同一口径)。
fn book_row(
    row: &mut egui_extras::TableRow<'_, '_>,
    tag: String,
    color: egui::Color32,
    price: f64,
    volume: f64,
) {
    let _ = tcell(row, false, |ui| {
        ui.label(egui::RichText::new(tag).color(color));
    });
    let _ = tcell(row, true, |ui| {
        ui.label(egui::RichText::new(crate::format::price(price)).color(color));
    });
    let _ = tcell(row, true, |ui| {
        ui.label(egui::RichText::new(crate::format::volume(volume)).color(color));
    });
}

fn render_book_frame(ui: &mut egui::Ui, shared: &UiShared) {
    let f = shared.order_form();
    let Some(t) = tick_of(shared, &f.exchange, &f.symbol) else {
        crate::ui_ext::muted_label(ui, "(无 tick)");
        return;
    };
    // 0.2.29 Wave A 尾巴(BD-UI-45,毛病 6 的本体):五档盘口原来是一支文本
    // `ui.label("卖5  101.5  3")` —— 价与量靠**空格**对齐,位数一变(101.5 → 12345.5)
    // 整块就错位、贴左缘。换成 TableBuilder 三列(档 / 价 / 量),价与量右对齐成列。
    // 这里**不**用 `pinned_table`:下单侧是窄列 + 外层已有 ScrollArea,`pinned_table`
    // 的 `auto_shrink([false, false])` 会吃满整块可用高(0.2.17 s39 那条教训同型)。
    // 表头也不加:Python 侧没有五档盘口这个块(只有行情表的买1价/买1量/卖1价/卖1量
    // 四列),这是我们自加的常驻盘口,保持无表头。
    let (row_h, _head_h) = table_heights(ui);
    let asks: [(f64, f64); 5] = [
        (t.ask_price_5, t.ask_volume_5),
        (t.ask_price_4, t.ask_volume_4),
        (t.ask_price_3, t.ask_volume_3),
        (t.ask_price_2, t.ask_volume_2),
        (t.ask_price_1, t.ask_volume_1),
    ];
    let bids: [(f64, f64); 5] = [
        (t.bid_price_1, t.bid_volume_1),
        (t.bid_price_2, t.bid_volume_2),
        (t.bid_price_3, t.bid_volume_3),
        (t.bid_price_4, t.bid_volume_4),
        (t.bid_price_5, t.bid_volume_5),
    ];
    egui_extras::TableBuilder::new(ui)
        .id_salt("book_grid")
        .striped(false)
        .auto_shrink([true, true])
        .column(egui_extras::Column::auto())
        .column(egui_extras::Column::auto())
        .column(egui_extras::Column::auto())
        .body(|mut body| {
            for (k, (p, v)) in asks.iter().enumerate() {
                body.row(row_h, |mut row| {
                    book_row(&mut row, format!("卖{}", 5 - k), BOOK_ASK_COLOR, *p, *v);
                });
            }
            for (k, (p, v)) in bids.iter().enumerate() {
                body.row(row_h, |mut row| {
                    book_row(&mut row, format!("买{}", k + 1), BOOK_BID_COLOR, *p, *v);
                });
            }
        });
}

// ================= 2×2 监控格 =================

pub(crate) fn render_topleft_group(ui: &mut egui::Ui, shared: &UiShared) {
    let tab = shared.topleft_tab();
    ui.horizontal(|ui| {
        if tab_label(ui, tab == TopLeftTab::Orders, TopLeftTab::Orders.label()).clicked() {
            shared.set_topleft_tab(TopLeftTab::Orders);
        }
        if tab_label(ui, tab == TopLeftTab::Active, TopLeftTab::Active.label()).clicked() {
            shared.set_topleft_tab(TopLeftTab::Active);
        }
    });
    render_orders_table(ui, shared, tab == TopLeftTab::Active);
}

/// 委托表(17 列逐值 = Python OrderMonitor 蓝图:代码/名称/交易所/类型/方向/
/// 开平/价格/总量/已成/成交均价/状态/状态描述/时间/委托号/来源/接口 + 操作;
/// 活动行撤单钮 + 双击撤单,终态行只读)。
fn render_orders_table(ui: &mut egui::Ui, shared: &UiShared, active_only: bool) {
    let ts = shared.trade_snap();
    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
    let known_gws = account_gateways(shared);
    // 表题撤除(第五轮审计):tab「委托|未成交」即 Python 口径的表身份,
    // 再挂同名 label = 三重撞名(下单钮/tab/表题),纯冗余。
    let rows: Vec<_> = ts
        .orders
        .iter()
        .filter(|o| !active_only || order_active(o.status))
        .collect();
    // 委托表列头单源(空/非空两分支同源,0.2.7 审计口径)。
    const ORDER_HEADERS: [&str; 17] = [
        "代码",
        "名称",
        "交易所",
        "类型",
        "方向",
        "开平",
        "价格",
        "总量",
        "已成",
        "成交均价",
        "状态",
        "状态描述",
        "时间",
        "委托号",
        "来源",
        "接口",
        "操作",
    ];
    // 0.3.3(收 Wave D 欠账):委托表也吃「点表头排序」—— 表 id 先算出来,
    // 空态与非空态共用一份(排序键住在 UiShared,按表 id 分槽)。
    let table_id = if active_only {
        "active_grid"
    } else {
        "order_grid"
    };
    let sort = shared.table_sort(table_id);
    if rows.is_empty() {
        // 空态提示移入表格 body(BD-UI-35,用户裁定:提示不得在表头上方,
        // 应在表头之下):label 成为 grid 首格 = 表头下第一行,格不缩。
        pinned_table(ui, table_id, &ORDER_HEADERS, |body, row_h| {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    ui.label(if active_only {
                        "(无未成交)"
                    } else {
                        "(无委托:等网关 send_order)"
                    });
                });
            });
            1
        });
        return;
    }
    // 排序只作用在「喂表前的快照副本」上(W2 口径,数据模型不被界面排序改写)。
    let rows = sorted_rows(&rows, sort, |o, col| order_sort_key(o, col));
    let clicked = pinned_table_sorted(ui, table_id, &ORDER_HEADERS, sort, false, |body, row_h| {
        const RIGHT_COLS: [usize; 4] = [6, 7, 8, 9];
        for o in &rows {
            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
            // 任何一格双击 = 撤单(Python OrderMonitor itemDoubleClicked→
            // cancel_order 等价,活动行限定;显式撤单钮同令并存)。
            let key = format!("{}.{}", o.gateway_name, o.orderid);
            let row_sel = shared.row_selected("orders", &key);
            body.row(row_h, |mut row| {
                row.set_selected(row_sel);
                let mut dbl = false;
                macro_rules! cell {
                    ($make:expr, $col:expr) => {{
                        let (cell_r, inner_r) = tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                        let hit = cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
                        if hit {
                            shared.select_row("orders", &key);
                        }
                        dbl |= cell_r.double_clicked()
                            || inner_r.as_ref().is_some_and(|r| r.double_clicked());
                    }};
                }
                cell!(|ui| ui.label(o.symbol.clone()), 0);
                cell!(
                    |ui| ui.label(if o.name.is_empty() {
                        "-".to_string()
                    } else {
                        o.name.clone()
                    }),
                    1
                );
                cell!(|ui| ui.label(o.exchange.as_str().to_string()), 2);
                cell!(|ui| ui.label(o.order_type.as_str().to_string()), 3);
                cell!(
                    |ui| ui.label(
                        egui::RichText::new(o.direction.map(|d| d.as_str()).unwrap_or("-")).color(
                            if o.direction == Some(Direction::SHORT) {
                                crate::tokens::semantic::FALL
                            } else {
                                crate::tokens::semantic::RISE
                            },
                        ),
                    ),
                    4
                );
                cell!(|ui| ui.label(o.offset.as_str().to_string()), 5);
                cell!(|ui| ui.label(crate::format::price(o.price)), 6);
                cell!(|ui| ui.label(crate::format::volume(o.volume)), 7);
                cell!(|ui| ui.label(crate::format::volume(o.traded)), 8);
                cell!(|ui| ui.label(crate::format::price(o.traded_price)), 9);
                cell!(
                    |ui| ui.label(egui::RichText::new(o.status.as_str()).color(
                        if o.status == ek_data::constant::Status::REJECTED {
                            crate::tokens::semantic::RISE
                        } else if o.status == ek_data::constant::Status::ALLTRADED {
                            crate::tokens::semantic::FALL
                        } else {
                            crate::tokens::semantic::WARN
                        },
                    )),
                    10
                );
                cell!(|ui| ui.label(o.status_msg.clone()), 11);
                cell!(
                    |ui| ui.label(crate::format::time_hms_millis(o.datetime)),
                    12
                );
                cell!(|ui| ui.label(o.orderid.clone()), 13);
                cell!(
                    |ui| ui.label(if o.reference.is_empty() {
                        "-".to_string()
                    } else {
                        o.reference.clone()
                    }),
                    14
                );
                cell!(
                    |ui| ui.label(ledger_gw_label(&o.gateway_name, &known_gws)),
                    15
                );
                if dbl && order_active(o.status) {
                    // 双击撤单同按钮口径:跟着这笔单自己的网关(空串回落默认账户阶梯)。
                    let gw = if !o.gateway_name.is_empty() {
                        o.gateway_name.clone()
                    } else {
                        shared.default_gateway().unwrap_or_default()
                    };
                    if !gw.is_empty() {
                        shared.push_cmd(UiCmd::CancelOrder {
                            orderid: o.orderid.clone(),
                            gateway: gw,
                        });
                    }
                }
                row.col(|ui| {
                    ui.horizontal(|ui| {
                        if order_active(o.status)
                            && ui
                                .small_button(format!("{BTN_CANCEL_ORDER} {}", o.orderid))
                                .clicked()
                        {
                            // 撤单跟随委托的来路网关(行级 gateway_name;
                            // 多账号面:空串回落默认账户阶梯,不再硬编码 ctp)
                            let gw = if !o.gateway_name.is_empty() {
                                o.gateway_name.clone()
                            } else {
                                shared.default_gateway().unwrap_or_default()
                            };
                            if gw.is_empty() {
                                shared.log_line(format!(
                                    "[撤单] {} 无网关可撤(账户清册空)",
                                    o.orderid
                                ));
                            } else {
                                shared.push_cmd(UiCmd::CancelOrder {
                                    orderid: o.orderid.clone(),
                                    gateway: gw,
                                });
                            }
                        }
                    });
                });
            });
        }
        rows.len()
    });
    if let Some(col) = clicked {
        shared.toggle_table_sort(table_id, col);
    }
}

/// 委托行的排序键(列序 == `ORDER_HEADERS`):数字列给零填充串保证字典序 == 数值序
/// (`价格/总量/已成/成交均价`),时间列给纳秒零填充,其余给该列的文本。
/// 0.3.3 收 Wave D 欠账时新增 —— 与成交表的 `trade_sort_key` 同一口径。
fn order_sort_key(o: &ek_data::order::OrderData, col: usize) -> String {
    match col {
        0 => o.symbol.clone(),
        1 => o.name.clone(),
        2 => o.exchange.as_str().to_string(),
        3 => o.order_type.as_str().to_string(),
        4 => o
            .direction
            .map(|d| d.as_str().to_string())
            .unwrap_or_default(),
        5 => o.offset.as_str().to_string(),
        6 => format!("{:020.4}", o.price),
        7 => format!("{:020.4}", o.volume),
        8 => format!("{:020.4}", o.traded),
        9 => format!("{:020.4}", o.traded_price),
        10 => o.status.as_str().to_string(),
        11 => o.status_msg.clone(),
        12 => o.datetime.map(|ns| format!("{ns:025}")).unwrap_or_default(),
        13 => o.orderid.clone(),
        14 => o.reference.clone(),
        15 => o.gateway_name.clone(),
        // 第 17 列是「操作」= 撤单钮,没有可排的数据 → 空串(点它排序等于不动)。
        _ => String::new(),
    }
}

/// 成交组(12 列逐值 = Python TradeMonitor 蓝图)。
pub(crate) fn render_trades_group(ui: &mut egui::Ui, shared: &UiShared) {
    // 单 tab(Python `tab_widget2.addTab(trade_widget, "成交")` 等价:那个区也是
    // QTabWidget,只有一个 tab 也带 tab 头 —— BD-UI-41 补齐)。
    tab_label(ui, true, "成交");
    let ts = shared.trade_snap();
    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
    let known_gws = account_gateways(shared);
    // 成交表列头单源(空/非空两分支同源,0.2.7 审计口径)。
    // 0.3.3 Wave F(BD-UI-51):列序照 Python `TradeMonitor.headers`(widget.py:1270-1283)——
    // 代码在首列,成交号在第 10 列;原来我们把「成交号」放首列,是差集里唯一一条纯 UI 差集。
    // 列名「成交额」→「成交金额」同 Python。
    const TRADE_HEADERS: [&str; 12] = [
        "代码",
        "名称",
        "交易所",
        "方向",
        "开平",
        "价格",
        "数量",
        "成交金额",
        "时间",
        "成交号",
        "委托号",
        "接口",
    ];
    if ts.trades.is_empty() {
        // 空态提示移入表格 body(0.2.8,BD-UI-35,同未成交口径)
        pinned_table(ui, "trade_grid", &TRADE_HEADERS, |body, row_h| {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    crate::ui_ext::muted_label(ui, "(无成交)");
                });
            });
            1
        });
        return;
    }
    let sort = shared.table_sort("trade_grid");
    let rows = sorted_rows(&ts.trades, sort, trade_sort_key);
    let clicked = pinned_table_sorted(
        ui,
        "trade_grid",
        &TRADE_HEADERS,
        sort,
        shared.table_resize_on("trade_grid"),
        |body, row_h| {
            const RIGHT_COLS: [usize; 3] = [5, 6, 7];
            for t in &rows {
                // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
                // 方向列上色(R2,与委托/持仓表同口径:空绿/多红)。
                let key = format!("{}.{}", t.gateway_name, t.tradeid);
                let row_sel = shared.row_selected("trades", &key);
                body.row(row_h, |mut row| {
                    row.set_selected(row_sel);
                    macro_rules! cell {
                    ($make:expr, $col:expr) => {{
                        let (cell_r, inner_r) = tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                        let hit = cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
                        if hit {
                            shared.select_row("trades", &key);
                        }
                        // 0.3.1(Wave D,BD-UI-49)双击联动:双击成交行 = 该合约进下单面板
                        // (Python 双击成交/持仓行带入下单,`mainwindow.py:276` 等价)。
                        let dbl = cell_r.double_clicked()
                            || inner_r.as_ref().is_some_and(|r| r.double_clicked());
                        if dbl {
                            let mut f = shared.order_form();
                            f.symbol = t.symbol.clone();
                            if let Some(d) = t.direction {
                                f.direction = d;
                            }
                            shared.set_order_form(f);
                        }
                        // 0.3.1(Wave D)右键菜单(照 Python 表上右键:调整列宽 / 保存数据)。
                        // 只挂首列 = 一行一颗菜单,不在每格挂一颗。
                        // 0.3.3(收 Wave D 欠账):菜单挂在**真控件**上 —— 首格内容是
                        // `Label::new(..).sense(Sense::click())`(有 AccessKit 动作的真控件),
                        // 菜单由它自己的 `context_menu` 开(见下面第 1 格)。原来那一套
                        // (收首格矩形 + 体表层自己补 `interact`)在 kittest 里收不到二级点击:
                        // 体表格的格吃过一次 hit-test,后补的 interact 与表不同层,
                        // `secondary_clicked` 永远为假。
                    }};
                }
                    // 首格是**真控件**(可点 + 可右键):右键菜单挂在这颗 Label 上。
                    cell!(
                        |ui| {
                            let r = ui
                                .add(egui::Label::new(t.symbol.clone()).sense(egui::Sense::click()))
                                .on_hover_text("右键:调整列宽 / 保存数据");
                            r.context_menu(|ui| {
                                if ui.button("调整列宽").clicked() {
                                    shared.toggle_table_resize("trade_grid");
                                    ui.close();
                                }
                                if ui.button("保存数据").clicked() {
                                    let _ = save_table_csv(
                                        "trade_grid",
                                        &TRADE_HEADERS,
                                        &rows,
                                        trade_cells,
                                    );
                                    ui.close();
                                }
                            });
                            r
                        },
                        0
                    );
                    cell!(
                        |ui| ui.label(if t.name.is_empty() {
                            "-".to_string()
                        } else {
                            t.name.clone()
                        }),
                        1
                    );
                    cell!(|ui| ui.label(t.exchange.as_str().to_string()), 2);
                    cell!(
                        |ui| ui.label(
                            egui::RichText::new(t.direction.map(|d| d.as_str()).unwrap_or("-"))
                                .color(if t.direction == Some(Direction::SHORT) {
                                    crate::tokens::semantic::FALL
                                } else {
                                    crate::tokens::semantic::RISE
                                },),
                        ),
                        3
                    );
                    cell!(|ui| ui.label(t.offset.as_str().to_string()), 4);
                    cell!(|ui| ui.label(crate::format::price(t.price)), 5);
                    cell!(|ui| ui.label(crate::format::volume(t.volume)), 6);
                    cell!(|ui| ui.label(crate::format::price(t.traded_amount)), 7);
                    cell!(|ui| ui.label(crate::format::time_hms_millis(t.datetime)), 8);
                    cell!(|ui| ui.label(t.tradeid.clone()), 9);
                    cell!(|ui| ui.label(t.orderid.clone()), 10);
                    cell!(
                        |ui| ui.label(ledger_gw_label(&t.gateway_name, &known_gws)),
                        11
                    );
                });
            }
            // 右键菜单已挂在第 1 格那颗真控件上(见体表 cell!(.., 0)),
            // 不再需要「收格矩形 + 表外层补 interact」那一套(0.3.3 收欠账)。
            ts.trades.len()
        },
    );
    if let Some(col) = clicked {
        shared.toggle_table_sort("trade_grid", col);
    }
}

/// 持仓组(16 列逐值 = Python PositionMonitor 蓝图;双击行带入下单面板,
/// Python mainwindow.py:276 等价,不开 K线)。
pub(crate) fn render_positions_group(ui: &mut egui::Ui, shared: &UiShared) {
    // 单 tab(Python `tab_widget3.addTab(position_widget, "持仓")` 等价,BD-UI-41)。
    tab_label(ui, true, "持仓");
    let ts = shared.trade_snap();
    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
    let known_gws = account_gateways(shared);
    // 持仓表列头单源(空/非空两分支同源,0.2.7 审计口径)。
    const POS_HEADERS: [&str; 16] = [
        "代码",
        "名称",
        "交易所",
        "方向",
        "数量",
        "昨仓",
        "可用",
        "冻结",
        "在途",
        "市值",
        "成本",
        "均价",
        "最新价",
        "盈亏",
        "盈亏比",
        "接口",
    ];
    if ts.positions.is_empty() {
        // 空态提示移入表格 body(0.2.8,BD-UI-35,同未成交口径)
        pinned_table(ui, "pos_grid", &POS_HEADERS, |body, row_h| {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    crate::ui_ext::muted_label(ui, "(无持仓)");
                });
            });
            1
        });
        return;
    }
    // 0.3.3(收 Wave D 欠账):持仓表也吃「点表头排序」。
    let sort = shared.table_sort("pos_grid");
    let rows = sorted_rows(&ts.positions, sort, pos_sort_key);
    let clicked = pinned_table_sorted(ui, "pos_grid", &POS_HEADERS, sort, false, |body, row_h| {
        const RIGHT_COLS: [usize; 11] = [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14];
        for p in &rows {
            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
            // 任何一格双击 = 带入下单面板(Python mainwindow.py:276 等价,
            // 不开 K线;方向随持仓方向,Python 同口径)。
            let key = format!("{}.{}.{}", p.gateway_name, p.symbol, p.direction.as_str());
            let row_sel = shared.row_selected("positions", &key);
            body.row(row_h, |mut row| {
                row.set_selected(row_sel);
                let mut dbl = false;
                macro_rules! cell {
                    ($make:expr, $col:expr) => {{
                        let (cell_r, inner_r) = tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                        let hit = cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
                        if hit {
                            shared.select_row("positions", &key);
                        }
                        dbl |= cell_r.double_clicked()
                            || inner_r.as_ref().is_some_and(|r| r.double_clicked());
                    }};
                }
                cell!(|ui| ui.label(p.symbol.clone()), 0);
                cell!(
                    |ui| ui.label(if p.name.is_empty() {
                        "-".to_string()
                    } else {
                        p.name.clone()
                    }),
                    1
                );
                cell!(|ui| ui.label(p.exchange.as_str().to_string()), 2);
                cell!(
                    |ui| ui.label(egui::RichText::new(p.direction.as_str()).color(
                        if p.direction == ek_data::constant::Direction::SHORT {
                            crate::tokens::semantic::FALL
                        } else {
                            crate::tokens::semantic::RISE
                        },
                    )),
                    3
                );
                cell!(|ui| ui.label(crate::format::volume(p.volume)), 4);
                cell!(|ui| ui.label(crate::format::volume(p.yd_volume)), 5);
                cell!(|ui| ui.label(crate::format::volume(p.can_use_volume)), 6);
                cell!(|ui| ui.label(crate::format::volume(p.frozen)), 7);
                cell!(|ui| ui.label(crate::format::volume(p.on_road_volume)), 8);
                cell!(|ui| ui.label(crate::format::price(p.market_value)), 9);
                // 0.3.3 Wave F(BD-UI-51)两处收口:
                // ① 成本 / 均价原来**取值互换** —— ek-data 里 `avg_price` = 成本价、
                //    `price` = 持仓均价(position.rs:22-23 / 38-39),Python 也是
                //    成本 ← avg_price、均价 ← price(widget.py:1491-1492)。判据 F2 抓到这条。
                // ② 五处裸 `format!("{:.2}")` / `{:+.1}` / `{:+.4}` 改走 `format.rs`
                //    (Python BaseCell 是 `round(content, 3)`,同一张表里三种精度就是毛病 3)。
                cell!(|ui| ui.label(crate::format::price(p.avg_price)), 10);
                cell!(|ui| ui.label(crate::format::price(p.price)), 11);
                cell!(|ui| ui.label(crate::format::price(p.last_price)), 12);
                cell!(
                    |ui| ui.label(egui::RichText::new(crate::format::price(p.pnl)).color(
                        if p.pnl < 0.0 {
                            crate::tokens::semantic::FALL
                        } else {
                            crate::tokens::semantic::RISE
                        }
                    ),),
                    13
                );
                cell!(|ui| ui.label(crate::format::price(p.profit_rate)), 14);
                cell!(
                    |ui| ui.label(ledger_gw_label(&p.gateway_name, &known_gws)),
                    15
                );
                if dbl {
                    let mut f = shared.order_form();
                    f.symbol = p.symbol.clone();
                    f.exchange = p.exchange.as_str().to_string();
                    f.direction = p.direction;
                    // B1 修:行级网关带入(旧实现不带网关 → 平掉哪条腿由上一单残留决定)。
                    if !p.gateway_name.is_empty() {
                        f.gateway = p.gateway_name.clone();
                    }
                    shared.set_order_form(f);
                    shared.log_line(format!(
                        "[ops] 持仓带入下单面板 {}(接口 {})",
                        p.symbol, p.gateway_name
                    ));
                }
            });
        }
        rows.len()
    });
    if let Some(col) = clicked {
        shared.toggle_table_sort("pos_grid", col);
    }
}

/// 持仓行的排序键(列序 == `POS_HEADERS`;与屏幕取值同源:
/// 成本 = `avg_price`、均价 = `price`,0.3.3 Wave F 修的那一对)。
fn pos_sort_key(p: &ek_data::position::PositionData, col: usize) -> String {
    match col {
        0 => p.symbol.clone(),
        1 => p.name.clone(),
        2 => p.exchange.as_str().to_string(),
        3 => p.direction.as_str().to_string(),
        4 => format!("{:020.4}", p.volume),
        5 => format!("{:020.4}", p.yd_volume),
        6 => format!("{:020.4}", p.can_use_volume),
        7 => format!("{:020.4}", p.frozen),
        8 => format!("{:020.4}", p.on_road_volume),
        9 => format!("{:020.4}", p.market_value),
        10 => format!("{:020.4}", p.avg_price),
        11 => format!("{:020.4}", p.price),
        12 => format!("{:020.4}", p.last_price),
        13 => format!("{:020.4}", p.pnl),
        14 => format!("{:020.4}", p.profit_rate),
        15 => p.gateway_name.clone(),
        _ => String::new(),
    }
}

pub(crate) fn render_bottomright_group(ui: &mut egui::Ui, shared: &UiShared) {
    let tab = shared.bottomright_tab();
    ui.horizontal(|ui| {
        if tab_label(
            ui,
            tab == BottomRightTab::Account,
            BottomRightTab::Account.label(),
        )
        .clicked()
        {
            shared.set_bottomright_tab(BottomRightTab::Account);
        }
        if tab_label(
            ui,
            tab == BottomRightTab::Logs,
            BottomRightTab::Logs.label(),
        )
        .clicked()
        {
            shared.set_bottomright_tab(BottomRightTab::Logs);
        }
    });
    match tab {
        BottomRightTab::Account => {
            let ts = shared.trade_snap();
            if ts.accounts.is_empty() {
                crate::ui_ext::muted_label(ui, "(无资金:等网关 eAccount.)");
                return;
            }
            // 0.2.29(BD-UI-44):资金表跟着日志表换 TableBuilder —— 同一块 tab 容器,
            // 同一套固定表头 + 按内容列宽;余额/可用/冻结是数字列(右对齐成列)。
            pinned_table(
                ui,
                "acct_grid",
                &["账号", "接口", "余额", "可用", "冻结"],
                |body, row_h| {
                    const RIGHT_COLS: [usize; 3] = [2, 3, 4];
                    for a in &ts.accounts {
                        body.row(row_h, |mut row| {
                            macro_rules! cell {
                                ($make:expr, $col:expr) => {{
                                    let _ = tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                                }};
                            }
                            cell!(|ui| ui.label(a.accountid.clone()), 0);
                            cell!(|ui| ui.label(a.gateway_name.clone()), 1);
                            // 0.3.3 Wave F:三处裸 `{:.2}` 改走 `format.rs`(同一口径,毛病 3)。
                            cell!(|ui| ui.label(crate::format::price(a.balance)), 2);
                            cell!(|ui| ui.label(crate::format::price(a.available())), 3);
                            cell!(|ui| ui.label(crate::format::price(a.frozen)), 4);
                        });
                    }
                    ts.accounts.len()
                },
            );
        }
        BottomRightTab::Logs => {
            render_logs(ui, shared);
        }
    }
}

/// 日志格(BD-UI-41,对照 Python 版)。
///
/// Python 侧「日志」tab 里放的是 `LogMonitor` —— 一个带 **时间/信息/接口** 表头的
/// QTableWidget(`widget.py:1167-1180`,BaseMonitor 子类),跟着 Dock 一起伸展。
/// 我们原来是一坨 monospace 行 + `ScrollArea::max_height(180.0)` 硬顶:窗口最大化
/// 它还是 180px —— 用户报的「整体放到最大,日志那边表格还是很小」根因就是那 180。
/// 现在走 `pinned_table`(与委托/成交/持仓同一套容器:表头固定 + 体滚 + 横滚),
/// 硬顶撤除 → 格多大,表多大。
///
/// 两处偏离(记 DESIGN BD-UI-41):
/// ① Python 有第三列「接口」;我们的 `log_line` 调用点不带网关(正文自带 `[ops]` /
///   `[订阅]` 这类前缀),硬造一列空列不如不造,所以只有两列。
/// ② `stick_to_bottom` 撤除:Python 的 QTableWidget 也不自动跟到最后一行,
///   要看最新行自己滚到底(与那张表同口径)。
fn render_logs(ui: &mut egui::Ui, shared: &UiShared) {
    ui.horizontal(|ui| {
        if ui.button(BTN_CLEAR_LOGS).clicked() {
            shared.clear_logs(); // LOCAL-FIRST:就地清,零往返
        }
    });
    let (entries, spilled) = shared.logs_entries();
    if spilled > 0 {
        // 口径写明(G1 实连证据的收口):回扫日志取证不可靠 —— 巡回里「重加后 90 秒
        // 没抓到『交易服务器登录成功』行」不是没登录,是这一环被状态推送流挤满了。
        // 登录/掉线/查询被拒这些事实的事实源是账户面板的状态列与状态细节(网关状态口),
        // 不是日志窗。单独一行,不挤在钮旁:长文案在横向行里会被压(s39 那类实锤)。
        ui.label(format!(
            "已丢弃 {spilled} 条(环形 {}):日志窗是窗口不是历史 —— 登录/掉线/查询被拒看账户面板的状态列与状态细节,别回扫这里",
            crate::state::RING_CAP
        ));
    }
    pinned_table(ui, "log_grid", &["时间", "信息"], |body, row_h| {
        if entries.is_empty() {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    crate::ui_ext::muted_label(ui, "(无日志)");
                });
                row.col(|ui| {
                    ui.label("");
                });
            });
            return 1;
        }
        for e in &entries {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    ui.monospace(e.at.clone());
                });
                row.col(|ui| {
                    ui.monospace(e.text.clone());
                });
            });
        }
        entries.len()
    });
}

// ================= 独立窗面(BD-UI-32/33)=================

/// 独立窗几何(BD-UI-34:助手参数收敛,8→6 闸 clippy too_many_arguments)。
struct WinGeom {
    inner: [f32; 2],
    min_inner: [f32; 2],
    maximized: bool,
}

/// 独立 OS 窗统一开法(BD-UI-33,四窗一型:运维/CTP/查询合约/K线)。
///
/// - **守卫(0.2.3 教训内建):** 调用方按状态位辞行——位关不调本函数 =
///   viewport 本拍未 used = egui/eframe GC 销毁 OS 窗(销毁判据源码
///   context.rs「never used this pass」)。
/// - Embedded 回退(后端不支持多窗:kittest/WEB)= 主窗内 egui::Window 同本体,
///   回退面关闭 = embedded 闭包返回 true。
/// - Immediate 面 OS X = close_requested → 返回 true(调用方翻负状态位)。
/// - `geom.maximized` = 打开即最大化(BD-UI-34,K线窗用户裁定;OS 窗属性,
///   Embedded 回退面无此概念 = 忽略)。
/// - `body` 返回 true = 内容侧请求关闭(BD-UI-34:K线窗 ESC 键快捷关闭;
///   键事件按子窗焦点路由,主窗按键不会误关)。
///
/// 返回 = "本拍该窗被关"(调用方负责状态位/列表出表)。
fn show_independent_window(
    ctx: &egui::Context,
    id_salt: impl std::hash::Hash,
    title: &str,
    geom: &WinGeom,
    embedded: impl Fn(&egui::Context) -> bool,
    body: impl Fn(&mut egui::Ui) -> bool,
) -> bool {
    let closed = std::cell::Cell::new(false);
    let mut builder = egui::ViewportBuilder::default()
        .with_title(title)
        .with_inner_size(geom.inner)
        .with_min_inner_size(geom.min_inner)
        .with_minimize_button(true)
        .with_maximize_button(true)
        .with_close_button(true);
    if geom.maximized {
        builder = builder.with_maximized(true);
    }
    ctx.show_viewport_immediate(
        egui::ViewportId::from_hash_of(id_salt),
        builder,
        |ctx2, class| {
            if class == egui::ViewportClass::Embedded {
                closed.set(embedded(ctx2));
                return;
            }
            if ctx2.input(|i| i.viewport().close_requested()) {
                closed.set(true);
                return;
            }
            egui::CentralPanel::default().show(ctx2, |ui| {
                if body(ui) {
                    closed.set(true);
                }
            });
        },
    );
    closed.get()
}

fn render_windows(ctx: &egui::Context, shared: &UiShared) {
    // 运维窗(菜单「运维」;BD-UI-33 转独立 OS 窗,用户裁定「四窗皆可脱离主窗」)。
    if shared.ops_window_open() {
        let closed = show_independent_window(
            ctx,
            "ops_win",
            "运维窗",
            &WinGeom {
                inner: [680.0, 420.0],
                min_inner: [420.0, 260.0],
                maximized: false,
            },
            |ctx2| {
                let mut open = shared.ops_window_open();
                egui::Window::new("运维窗")
                    .id(egui::Id::new("ops_win"))
                    .default_pos([80.0, 320.0])
                    .default_size([640.0, 380.0])
                    .open(&mut open)
                    .show(ctx2, |ui| {
                        render_ops_window(ui, shared);
                    });
                shared.set_ops_window_open(open);
                !open
            },
            |ui| {
                render_ops_window(ui, shared);
                false
            },
        );
        if closed {
            shared.set_ops_window_open(false);
        }
    }

    // 账户面板(菜单「账户」;多账号面:账户清单 + 行情源选择 + 添加/编辑表单;
    // 旧「CTP 网关配置窗」退役收纳于此窗,BD-UI-33 独立 OS 窗形态沿用)。
    if shared.accounts_window_open() {
        let closed = show_independent_window(
            ctx,
            "account_win",
            "账户面板",
            &WinGeom {
                inner: [760.0, 520.0],
                min_inner: [520.0, 320.0],
                maximized: false,
            },
            |ctx2| {
                let mut open = shared.accounts_window_open();
                egui::Window::new("账户面板")
                    .id(egui::Id::new("account_win"))
                    .default_pos([640.0, 320.0])
                    .default_size([720.0, 470.0])
                    .open(&mut open)
                    .show(ctx2, |ui| {
                        render_accounts_window(ui, shared);
                    });
                shared.set_accounts_window_open(open);
                !open
            },
            |ui| {
                render_accounts_window(ui, shared);
                false
            },
        );
        if closed {
            shared.set_accounts_window_open(false);
        }
    }

    // 账户配置弹窗(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):
    // 『添加账户』与『编辑 <账户>』开同一个弹窗的两种模式;**非 modal**(不阻塞主窗与行情观察)。
    // 关闭(窗 × 或『取消』)= 放弃未保存(规划 Q24),绝不静默写入清册留档。
    if shared.account_edit_open() {
        let closed = show_independent_window(
            ctx,
            "account_edit_win",
            "账户配置",
            &WinGeom {
                inner: [680.0, 340.0],
                min_inner: [480.0, 240.0],
                maximized: false,
            },
            |ctx2| {
                let mut open = shared.account_edit_open();
                let title = match shared.editing_account() {
                    Some(gw) => format!("账户配置 — 编辑 {gw}"),
                    None => "账户配置 — 添加".to_string(),
                };
                egui::Window::new(title)
                    .id(egui::Id::new("account_edit_win"))
                    .default_pos([700.0, 380.0])
                    .default_size([660.0, 320.0])
                    .open(&mut open)
                    .show(ctx2, |ui| {
                        render_account_edit_window(ui, shared);
                    });
                if !open {
                    shared.end_account_edit();
                }
                !open
            },
            |ui| {
                render_account_edit_window(ui, shared);
                false
            },
        );
        if closed && shared.account_edit_open() {
            shared.end_account_edit();
        }
    }

    // 查询合约窗(菜单「查询合约」;Python ContractManager 等价:查询 + 勾选 + 订阅)。
    if shared.contracts_window_open() {
        let closed = show_independent_window(
            ctx,
            "contracts_win",
            "查询合约窗",
            &WinGeom {
                inner: [620.0, 460.0],
                min_inner: [420.0, 260.0],
                maximized: false,
            },
            |ctx2| {
                let mut open = shared.contracts_window_open();
                egui::Window::new("查询合约窗")
                    .id(egui::Id::new("contracts_win"))
                    .default_pos([420.0, 300.0])
                    .default_size([560.0, 420.0])
                    .open(&mut open)
                    .show(ctx2, |ui| {
                        render_contracts_window(ui, shared);
                    });
                shared.set_contracts_window_open(open);
                !open
            },
            |ui| {
                render_contracts_window(ui, shared);
                false
            },
        );
        if closed {
            shared.set_contracts_window_open(false);
        }
    }

    // K线窗(双击弹出,按合约多开;出 kline_symbols 列表 = 不再 show = 销毁)。
    // BD-UI-34:打开即最大化(maximized)+ ESC 键快捷关闭(body 请求关闭;
    // 键按子窗焦点路由,主窗按键不误关)。
    let mut closed: Vec<String> = Vec::new();
    for sym in shared.kline_symbols() {
        let is_closed = show_independent_window(
            ctx,
            format!("kline_win:{sym}"),
            &format!("K线 — {sym}"),
            &WinGeom {
                inner: [560.0, 360.0],
                min_inner: [360.0, 220.0],
                maximized: true,
            },
            |ctx2| {
                let esc = ctx2.input(|i| i.key_pressed(egui::Key::Escape));
                let resp = egui::Window::new(format!("K线 — {sym}"))
                    .id(egui::Id::new(("kline_win", sym.clone())))
                    .default_pos([300.0, 340.0])
                    .default_size([540.0, 330.0])
                    .show(ctx2, |ui| {
                        let cell = shared
                            .market()
                            .cells()
                            .into_iter()
                            .find(|c| c.symbol == sym);
                        render_kline_cell(ui, cell.as_ref());
                    });
                esc || resp.is_none()
            },
            |ui| {
                if ui.input(|i| i.key_pressed(egui::Key::Escape)) {
                    return true;
                }
                let cell = shared
                    .market()
                    .cells()
                    .into_iter()
                    .find(|c| c.symbol == sym);
                render_kline_cell(ui, cell.as_ref());
                false
            },
        );
        if is_closed {
            closed.push(sym);
        }
    }
    for s in closed {
        shared.close_kline(&s);
    }
}

/// 运维窗:插件表(svctl 操作 + 二次确认)+ 待确认横幅 + 服务目录(三列)
/// + 依赖图。回灌界面面已退役(总线口保留;流控查询钮 0.2.10 随 sim 退场撤除)。
fn render_ops_window(ui: &mut egui::Ui, shared: &UiShared) {
    crate::ui_ext::section_title(ui, "插件");
    let snap = shared.snapshot();
    // 账户清册里的实例名(一次取好,别在每行每帧各 clone 一遍整表)。
    let account_gateways: std::collections::HashSet<String> = shared
        .accounts()
        .iter()
        .map(|a| a.gateway.clone())
        .collect();
    let mut plug_heads: Vec<(egui::Rect, String)> = Vec::new();
    egui::Grid::new("plug_grid").num_columns(6).show(ui, |ui| {
        for h in ["名称", "状态", "版本", "依赖", "统计", "操作"] {
            let r = ui.label(egui::RichText::new(h).strong().small());
            plug_heads.push((r.rect, h.to_string()));
        }
        ui.end_row();
        if snap.rows.is_empty() {
            ui.label("(快照空:等 eTimer 首拉)");
            ui.end_row();
        }
        for r in &snap.rows {
            if is_quarantined(&r.state) {
                ui.label(egui::RichText::new(r.name.clone()).color(crate::tokens::semantic::ERROR));
                ui.label(
                    egui::RichText::new(state_text(r))
                        .color(crate::tokens::semantic::ERROR)
                        .strong(),
                );
            } else {
                ui.label(r.name.clone());
                ui.label(state_text(r));
            }
            ui.label(r.version.clone());
            ui.label(format!("deps:[{}]", r.deps.join(",")));
            ui.label(format!("spilled:{} panics:{}", r.spilled, r.panics));
            ui.horizontal(|ui| {
                // Q17 收口(0.2.20):账户清册里的实例不在运维窗起停。
                // 账户面板的『移除』带全套守卫(活跃委托闸 + 二次确认 + 持仓提示),
                // 运维窗这条是同一动作的无守卫副本 —— 同一个实例两条移除路、守卫只长在
                // 一条上,等于守卫可以绕过(规划 Q17 的边界就在这)。
                // 清册外的 `ctp_*` 实例(手工起的 / 旧流程残留)仍留这条出口,否则没有退路。
                if account_gateways.contains(&r.name) {
                    ui.label(
                        egui::RichText::new("起停归『账户』面板(带撤单守卫)")
                            .color(crate::tokens::semantic::INFO),
                    );
                } else {
                    if ui.small_button(format!("重注入 {}", r.name)).clicked() {
                        // 运维窗按「注册名 = 工厂名」的旧插件重注入(dm/oms/ui);
                        // 命名网关实例(`ctp_<broker>_<账号>`)不是工厂名,会被
                        // supervisor 回拒 unknown factory —— 那类实例的起停归「账户」面板。
                        shared.push_cmd(UiCmd::Start {
                            factory: r.name.clone(),
                            name: String::new(),
                        });
                    }
                    let armed = shared.pending_confirm();
                    let armed_here = ui
                        .small_button(remove_button_label(&r.name, armed.as_deref()))
                        .clicked()
                        && shared.confirm_step(&r.name) == ConfirmStep::Fired;
                    if armed_here {
                        shared.push_cmd(UiCmd::Remove {
                            name: r.name.clone(),
                        });
                    }
                }
            });
            ui.end_row();
        }
    });
    header_band(ui, &plug_heads, ui.min_rect().max.x);

    if let Some(name) = shared.pending_confirm() {
        ui.horizontal(|ui| {
            ui.label(
                egui::RichText::new(format!("待二次确认:再次点击『移除 {name}』完成"))
                    .color(crate::tokens::semantic::WARN),
            );
            if ui.small_button(BTN_CANCEL_CONFIRM).clicked() {
                shared.confirm_cancel();
            }
        });
    }

    crate::ui_ext::space_group(ui);
    crate::ui_ext::section_title(ui, "服务");
    let flat: Vec<String> = snap
        .services
        .iter()
        .flat_map(|(n, ids)| {
            if ids.is_empty() {
                vec![format!("{n} 服务"), "-".to_string()]
            } else {
                ids.iter()
                    .flat_map(|id| [format!("{n} 服务"), id.clone()])
                    .collect()
            }
        })
        .collect();
    if flat.is_empty() {
        crate::ui_ext::muted_label(ui, "(无服务目录)");
    } else {
        let rows = flat.len().div_ceil(6); // 每列 2 字段 × 3 列
        // 表头(BD-UI-41,用户指出「配置那边表格也要有表头」):这张表原来六列
        // 纯数据没有头行。列语义 = 三对「服务名 / 实例 id」,头就照这个写。
        let mut svc_heads: Vec<(egui::Rect, String)> = Vec::new();
        egui::Grid::new("svc_grid").num_columns(6).show(ui, |ui| {
            for _ in 0..3 {
                for h in ["服务", "实例"] {
                    let r = ui.label(egui::RichText::new(h).strong().small());
                    svc_heads.push((r.rect, h.to_string()));
                }
            }
            ui.end_row();
            for r in 0..rows {
                for c in 0..3 {
                    let i = c * rows * 2 + r * 2;
                    if i < flat.len() {
                        ui.label(flat[i].clone());
                        ui.label(flat[i + 1].clone());
                    } else {
                        ui.label("");
                        ui.label("");
                    }
                }
                ui.end_row();
            }
        });
        header_band(ui, &svc_heads, ui.min_rect().max.x);
    }

    ui.label("依赖");
    if !snap.rows.iter().any(|r| !r.deps.is_empty()) {
        ui.label("(全部无依赖)");
    }
    for r in &snap.rows {
        if !r.deps.is_empty() {
            ui.label(format!("{} → {}", r.name, r.deps.join(" + ")));
        }
    }
}

/// 账户面板(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):
/// 列表上方 = 行情源一览 + 账户计数(软上限)+ 『添加账户』入口;
/// 列表 = **跨账户一览**(状态 / 行情源 / 收录勾选与网关实际收录 / 行操作);
/// 配置表单**移入独立弹窗**(`render_account_edit_window`)—— 本窗不再内嵌表单,
/// 旧「窗内一张共享表单」退役(消 U4 凭据串味 / U6 取消编辑不清空的界面根)。
fn render_accounts_window(ui: &mut egui::Ui, shared: &UiShared) {
    let accounts = shared.accounts();
    let locked = shared.accounts_locked();
    let md = shared.md_source();
    let snap = shared.trade_snap();

    // 行内显示名(别名优先,空回退账号;重名回退派生名)。
    // 同一行里『编辑 X』与『移除 X』必须用同一个 X(规划 U10 口径齐),
    // 而寻址恒用派生名 —— 别名只是显示,不参与寻址(规划 Q3)。
    let row_label: std::collections::BTreeMap<String, String> = accounts
        .iter()
        .map(|a| {
            let d = a.display_name();
            let dup = accounts.iter().filter(|x| x.display_name() == d).count() > 1;
            (a.gateway.clone(), if dup { a.gateway.clone() } else { d })
        })
        .collect();

    // 列表上方:行情源一览(订阅一律走它,与账户增删无关)+ 计数 + 添加入口。
    ui.horizontal(|ui| {
        ui.label(
            egui::RichText::new(format!(
                "当前行情源 = {}",
                if md.is_empty() {
                    "(未指定)".to_string()
                } else {
                    md.clone()
                }
            ))
            .strong(),
        );
        ui.label(format!(
            "账户 {}/{}",
            accounts.len(),
            crate::state::MAX_ACCOUNTS
        ));
        if shared.can_add_account() {
            if ui.button(BTN_ACCOUNT_ADD).clicked() {
                shared.begin_account_edit(None);
            }
        } else {
            ui.label(
                egui::RichText::new(format!(
                    "账户已达软上限 {} 个:先移除一个再添加(『添加账户』已禁用)",
                    crate::state::MAX_ACCOUNTS
                ))
                .color(crate::tokens::semantic::WARN),
            );
        }
    });

    const ACCOUNT_HEADERS: [&str; 7] = [
        "网关(派生名)",
        "别名",
        "账号",
        "状态",
        "行情源",
        "收录(勾→实)",
        "操作",
    ];
    // 0.2.17 布局修复:账户清单不用 pinned_table。pinned_table = ScrollArea
    // (auto_shrink=false,吃掉整块可用高)+ 覆盖式表头带;账户窗是**自动尺寸浮动窗**,
    // 两者凑不出正确高度 → 表行与其后的口径句**互相压字**(快照钉 s39 实锤)。
    // 账户行最多个位数,普通 Grid 就够,不需要固定表头滚动面 —— 但表头带照补
    // (BD-UI-41:走 `header_band`,它正是为「自动尺寸浮动窗里的短表」准备的)。
    let mut acct_heads: Vec<(egui::Rect, String)> = Vec::new();
    egui::Grid::new("account_grid")
        .num_columns(7)
        .show(ui, |ui| {
            for h in &ACCOUNT_HEADERS {
                let r = ui.label(egui::RichText::new(*h).strong().small());
                acct_heads.push((r.rect, h.to_string()));
            }
            ui.end_row();
        if accounts.is_empty() {
            crate::ui_ext::muted_label(ui, "(无账户:上方『添加账户』开配置弹窗)");
            for _ in 0..6 {
                ui.label("");
            }
            ui.end_row();
        }
        for a in &accounts {
            let is_md = a.gateway == md;
            let name = row_label
                .get(&a.gateway)
                .cloned()
                .unwrap_or_else(|| a.gateway.clone());
            ui.label(a.gateway.clone());
            // 别名(空 = 显示 "—";寻址恒用派生名,别名不参与,规划 Q3)。
            ui.label(if a.alias.trim().is_empty() {
                "—".to_string()
            } else {
                a.alias.clone()
            });
            ui.label(a.account.clone());
            // 状态列(0.2.19 起两段):装配态(svctl 在场位)+ **登录态**(`{gw}.status` 读数)。
            // 登录成败不再靠猜:ek-ctp 0.9.0 的 `{gw}.status` 是事实源(规划 P3 / 裁定 3),
            // 没有读数时仍写「已装配·登录态未知」,不得写成「已连接」(规划 U5 口径不变)。
            // 文案一律 `Extend`(不换行):账户面板是 Grid,状态列被挤窄时逐字竖排
            // 会把一行撑成十几行高(s39 快照实锤过)。
            match a.stage {
                crate::state::AccountStage::AssembleFailed => {
                    ui.add(
                        egui::Label::new(
                            egui::RichText::new(format!(
                                "装配失败:{}",
                                a.fail_note.clone().unwrap_or_else(|| "未知原因".to_string())
                            ))
                            .color(crate::tokens::semantic::ERROR),
                        )
                        .wrap_mode(egui::TextWrapMode::Extend),
                    );
                }
                _ => {
                    let color = match a.login {
                        crate::state::LoginState::Online => crate::tokens::semantic::OK,
                        crate::state::LoginState::LoginFailed
                        | crate::state::LoginState::FrontDown => {
                            crate::tokens::semantic::ERROR
                        }
                        crate::state::LoginState::QueryStarved => {
                            crate::tokens::semantic::WARN
                        }
                        // Unknown / Stopped:灰 —— 没有证据与主动停会话都不该着色成"出事"
                        _ => crate::tokens::semantic::MUTED,
                    };
                    ui.add(
                        egui::Label::new(
                            egui::RichText::new(a.status_label()).color(color),
                        )
                        .wrap_mode(egui::TextWrapMode::Extend),
                    );
                }
            }
            // 行情元账号:配置阶段任选;任何账户已装配即锁定(规划 D3)。
            ui.horizontal(|ui| {
                if is_md {
                    ui.label(egui::RichText::new("● 行情源").strong());
                }
                let resp = ui.add_enabled_ui(!locked || is_md, |ui| {
                    ui.small_button(if is_md {
                        "已是行情源"
                    } else {
                        "设为行情源"
                    })
                });
                if resp.inner.clicked() {
                    match shared.set_md_source(&a.gateway) {
                        Ok(()) => shared.log_line(format!("[账户] 行情源 = {}", a.gateway)),
                        Err(e) => shared.log_line(format!("[账户] {e}")),
                    }
                }
            });
            // 收录:勾选(意图)→ 网关实际回带(事实),并排显示(规划 U9)。
            // 旧口径:`ConfigureReply.product_classes` 既不回填也不显示,勾选是否生效无从判断。
            ui.vertical(|ui| {
                ui.add(
                    egui::Label::new(egui::RichText::new(format!(
                        "勾:{}",
                        classes_label(&a.form.product_classes())
                    )))
                    .wrap_mode(egui::TextWrapMode::Extend),
                );
                ui.add(
                    egui::Label::new(egui::RichText::new(format!(
                        "实:{}",
                        if a.effective_classes.is_empty() {
                            "—".to_string()
                        } else {
                            classes_label(&a.effective_classes)
                        }
                    )))
                    .wrap_mode(egui::TextWrapMode::Extend),
                );
            });
            // 操作:连接/重试(四态分离的『连接』入口)/ 断开(0.2.19 停会话)/ 编辑(开配置弹窗)/ 移除(守卫 + 先撤入口)。
            ui.horizontal(|ui| {
                let failed = a.stage == crate::state::AccountStage::AssembleFailed;
                let idle = a.stage == crate::state::AccountStage::NotAssembled;
                // 会话被主动停掉(『断开』)但实例还在:恢复入口仍是这一颗『连接』
                // (走 `UiCmd::Connect` → svctl 回「已在场」→ 插件侧改走重投凭据,规划裁定 1)。
                let stopped = a.login == crate::state::LoginState::Stopped;
                if failed || idle || stopped {
                    // 规划 U3 定盘:装配失败**不回滚清册行**,行留着给『重试』
                    // (旧口径"必须先移除才能重试"作废)。
                    let label = if failed {
                        format!("重试 {name}")
                    } else {
                        format!("连接 {name}")
                    };
                    if ui.small_button(label).clicked() {
                        push_connect(shared, &a.gateway, &a.form);
                    }
                }
                // 该账户的活跃委托数(『断开』与『移除』共用同一道守卫,见下)。
                let open = snap
                    .orders
                    .iter()
                    .filter(|o| o.gateway_name == a.gateway && o.is_active())
                    .count();
                // 『断开』(0.2.19,规划裁定 1「断开 = 停会话,移除 = 停实例」):
                // 只对**已装配、会话还活着、且没有活跃委托**的行开。
                // - 未装配没有会话可停(规划 Q21:口不存在时不留死钮;现在口已实现,钮才允许出现);
                // - 有活跃委托时不给断开 —— 会话一停就撤不了单、也不再回报,与『移除』
                //   要挡的是同一个观测黑洞(规划 §5.B),出口同样是旁边那句『先撤 N 笔』。
                // `&&` 短路即"条件不成立就不画这颗钮",不是画出来再禁用。
                if a.stage == crate::state::AccountStage::Assembled
                    && a.login != crate::state::LoginState::Stopped
                    && open == 0
                    && ui.small_button(format!("断开 {name}")).clicked()
                {
                    shared.push_cmd(UiCmd::Disconnect {
                        gateway: a.gateway.clone(),
                    });
                    shared.log_line(format!(
                        "[账户] 断开 {gateway}:已入列(停会话;实例与订阅保留,『连接』可恢复)",
                        gateway = a.gateway
                    ));
                }
                if ui.small_button(format!("编辑 {name}")).clicked() {
                    // 编辑 = 开配置弹窗(草稿 = 该账户自己的留档)。
                    // 旧的 `select_row("account_grid", …)` 行选记槽已无读者(内嵌表单时代遗留)→ 撤除。
                    shared.begin_account_edit(Some(&a.gateway));
                }
                let has_pos = snap
                    .positions
                    .iter()
                    .any(|p| p.gateway_name == a.gateway && (p.volume + p.yd_volume) > 0.0);
                if open > 0 {
                    // 守卫硬挡:柜台还在跑单而没人能撤 = 观测黑洞(规划 §5.B)。
                    ui.label(
                        egui::RichText::new(format!("有 {open} 笔活跃委托:先撤单才能移除"))
                            .color(crate::tokens::semantic::WARN),
                    );
                    // 规划 U10:守卫不能只把用户堵在门口,要给出口 ——
                    // 『先撤 N 笔』按该账户的活跃委托逐笔入列(与「全撤」同一条 oms 通道,
                    // 走每笔单自己的网关,撞撤单计数守卫时显形 limit:cancel-guard)。
                    if ui.small_button(format!("先撤 {open} 笔")).clicked() {
                        for o in snap
                            .orders
                            .iter()
                            .filter(|o| o.gateway_name == a.gateway && o.is_active())
                        {
                            shared.push_cmd(UiCmd::CancelOrder {
                                orderid: o.orderid.clone(),
                                gateway: a.gateway.clone(),
                            });
                        }
                        shared.log_line(format!(
                            "[账户] 先撤 {}:{} 笔活跃委托已入列(撤完才可移除)",
                            a.gateway, open
                        ));
                    }
                } else {
                    // 二次确认的记槽按**派生名**(寻址主键),按钮文案用显示名 ——
                    // 两者必须在这里对上,否则首点后按钮永远翻不到『确认移除』(Commit B 自查抓到的坑)。
                    let armed = shared.pending_confirm();
                    let armed_here = armed.as_deref() == Some(a.gateway.as_str());
                    let fired = ui
                        .small_button(remove_button_label(
                            &name,
                            if armed_here { Some(name.as_str()) } else { None },
                        ))
                        .clicked()
                        && shared.confirm_step(&a.gateway) == ConfirmStep::Fired;
                    if fired {
                        shared.push_cmd(UiCmd::Remove {
                            name: a.gateway.clone(),
                        });
                        shared.remove_account(&a.gateway);
                        // 弹窗是非 modal:若这行正在被编辑,摘除必须连带关弹窗放弃,
                        // 否则弹窗会静默退化成「添加模式」,点『保存』会拿旧凭据建新账户。
                        shared.end_account_edit_if_editing(&a.gateway);
                        if has_pos {
                            shared.log_line(format!(
                                "[账户] 移除 {}:有持仓 —— 柜台侧不受影响,重加该账户后由轮转查询重建视图",
                                a.gateway
                            ));
                        }
                    }
                }
            });
            ui.end_row();
        }
    });
    header_band(ui, &acct_heads, ui.min_rect().max.x);

    if let Some(gw) = shared.pending_confirm() {
        // 提示句与行内钮同一显示名(行里写『移除 220380』,提示就不能写『移除 ctp_9999_220380』)。
        let shown = row_label.get(&gw).cloned().unwrap_or(gw.clone());
        ui.horizontal(|ui| {
            ui.label(
                egui::RichText::new(format!("待二次确认:再次点击『移除 {shown}』完成"))
                    .color(crate::tokens::semantic::WARN),
            );
            if ui.small_button(BTN_CANCEL_CONFIRM).clicked() {
                shared.confirm_cancel();
            }
        });
    }

    ui.label(if locked {
        "行情源已锁定(有账户已装配):换源需先移除该账户 → 改配置 → 重连(规划 D3)"
    } else {
        "行情源:配置阶段任选;非源账户的 md 前置一律留空(单源纪律 §5.C)"
    });
    // 状态口径统一说明(面板底部一句,不逐行重复 —— 逐行会把状态列撑成竖排):
    ui.label(
        egui::RichText::new(format!(
            "状态列 = 实例装配 + 网关状态口 {{gw}}.status(每 {} 秒轮询);『断开』= 停会话(实例与订阅保留),『移除』= 停实例",
            crate::state::STATUS_POLL_TICKS
        ))
        .color(crate::tokens::semantic::INFO),
    );
    // F4 口径显形(0.2.20):多账户下「谁查谁过滤」此前只能靠猜 —— 实连 S14b 里
    // 账户 B 把勾选改成「期货+期权」,公用合约表仍是 852 条、期权 0 条,用户没有任何
    // 办法判断是自己没生效、还是网关没查到。这里把口径写死成一句(不靠界面猜):
    // 勾选只管**这个网关自己**收录并上抛的部分,公用表是在场各网关的并集。
    ui.label(egui::RichText::new(TXT_PRODUCT_CLASS_SCOPE).color(crate::tokens::semantic::INFO));
    // 状态细节(0.2.19):凡是有话可说的行都给一句(带次数、带秒数、带原因)。
    // 为什么不在状态列里带:Grid 列宽实测会被长文案挤成竖排(s39 实锤)。
    // 为什么不只给告警行:「状态口问不到」与「纯行情账户」也是事实 ——
    // 灰色徽标不给原因,用户就只能猜「是没问到还是没登录」。
    // 只给已装配的行:会话读数属于那个实例,行都「未装配」了还印「掉线 2 次」
    // 就是在替一个不存在的会话说话(状态侧由 `sync_accounts_connected` 一并作废,
    // 这里是不对称时刻——快照还没刷——的第二道闸)。
    // 健康行没有细节(`count_note(…, 0) = None`),所以这一段不会随账户数无谓变长。
    for a in accounts
        .iter()
        .filter(|a| a.stage == crate::state::AccountStage::Assembled && a.status_note.is_some())
    {
        let note = a.status_note.clone().unwrap_or_default();
        let alarm = a.login.is_alarm() || a.login == crate::state::LoginState::QueryStarved;
        let color = if alarm {
            crate::tokens::semantic::ERROR
        } else {
            crate::tokens::semantic::INFO
        };
        ui.label(egui::RichText::new(format!("状态细节 {}：{}", a.gateway, note)).color(color));
        // 0.3.2(Wave E,BD-UI-50):告警 toast **不在这里产生**。产生口只有一处
        // = `UiShared::note_gateway_status`(轮询一拍),判据 e6 钉着这条归属。
        // 在这里弹 = 账户窗没开就没有告警,而 Python 的 AlertEngine 与哪个窗在不在无关。
    }
    // 元账号 md 前置为空 = 永远收不到 tick(添加时被单源纪律清空,须编辑页补填)。
    if let Some(src) = accounts.iter().find(|a| a.gateway == md) {
        if src.form.md_addr.trim().is_empty() {
            ui.label(
                egui::RichText::new(format!(
                    "元账号 {} 的 md 前置为空:点『编辑 {}』补填 md 前置,否则行情带不会出数",
                    src.gateway,
                    row_label
                        .get(&src.gateway)
                        .cloned()
                        .unwrap_or_else(|| src.account.clone())
                ))
                .color(crate::tokens::semantic::WARN),
            );
        }
    }
}

/// 账户配置弹窗(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):『添加账户』与
/// 『编辑 <账户>』开**同一个弹窗的两种模式**;非 modal(不阻塞主窗与行情观察)。
/// 账号/前置全部界面手工输入,插件不读文件;密码位掩码;**无订阅字段** ——
/// 用户裁定:订阅走下单面板代码回车或查询合约窗勾选。
/// 关闭(『取消』或窗 ×)= **放弃未保存**(规划 Q24);被拦 → 弹窗不关 + 原因上屏(规划 Q26)。
fn render_account_edit_window(ui: &mut egui::Ui, shared: &UiShared) {
    let editing: Option<crate::state::AccountRow> =
        shared.editing_account().and_then(|g| shared.account(&g));
    let editing_on = editing.is_some();
    let md = shared.md_source();
    let locked = shared.accounts_locked();
    let mut form: crate::state::CtpForm = shared.ctp_form();
    let mut alias = shared.edit_alias();
    // 被拦原因上屏(形制校验 / 清册守卫 / 装配被拒):弹窗不关(规划 U3 / Q26)。
    if let Some(e) = shared.edit_error() {
        ui.label(egui::RichText::new(format!("拦下:{e}")).color(crate::tokens::semantic::ERROR));
    }
    // 0.2.17 布局口径:表单用 horizontal 行不用 Grid —— Grid 列宽在测量期被
    // 「窗宽 / 列数」夹死(实测每格 ≈120px),`desired_width` 永不生效,
    // 一根真实前置 `tcp://182.254.242.81:30001`(30 字符)只显示出 "tcp:/"。
    // 身份行:别名(仅显示用,不参与寻址,规划 Q3)+ broker + td 前置 + td 用户。
    // 编辑模式 broker / td 用户**只读**(规划 Q25:它们决定派生注册名,就地改 = 孤儿实例 + 账本错配)。
    ui.horizontal(|ui| {
        ui.label("别名");
        if ui
            .add(
                egui::TextEdit::singleline(&mut alias)
                    .hint_text("显示用,可空")
                    .desired_width(120.0),
            )
            .changed()
        {
            shared.set_edit_alias(alias.clone());
        }
        ui.label("broker");
        ui.add_enabled_ui(!editing_on, |ui| {
            ctp_edit(ui, shared, &mut form.broker_id, "9999", CtpField::Broker);
        });
        ui.label("td 前置");
        ctp_edit(
            ui,
            shared,
            &mut form.td_addr,
            "tcp://host:40001",
            CtpField::TdAddr,
        );
        ui.label("td 用户");
        ui.add_enabled_ui(!editing_on, |ui| {
            ctp_edit(ui, shared, &mut form.td_user, "用户号", CtpField::TdUser);
        });
    });
    if let Some(r) = &editing {
        // 只读口径说明(规划 Q25):派生注册名由 broker + 账号决定,就地改会留下
        // 跑着旧名的孤儿实例(svctl 侧无改名口),账本里的归属也会错配。
        ui.label(
            egui::RichText::new(format!(
                "派生注册名 = {}(由 broker + 账号决定):要改这两格请『移除后重加』",
                r.gateway
            ))
            .color(crate::tokens::semantic::WARN),
        );
    }
    ui.horizontal(|ui| {
        ui.label("td 密码");
        ctp_edit(
            ui,
            shared,
            &mut form.td_password,
            "密码",
            CtpField::TdPassword,
        );
        ui.label("AppID");
        ctp_edit(ui, shared, &mut form.td_app_id, "app", CtpField::AppId);
        ui.label("AuthCode");
        ctp_edit(
            ui,
            shared,
            &mut form.td_auth_code,
            "授权码",
            CtpField::AuthCode,
        );
    });
    // 单源纪律(规划 Q12):编辑模式下「非行情源账户 + 行情源已锁定」→ md 三格置灰。
    // 它当不了源,填了也会在装配侧被清空;要换源须先移除在场账户(规划 D3)。
    let md_editable = match &editing {
        None => true,
        Some(r) => !locked || r.gateway == md,
    };
    ui.horizontal(|ui| {
        ui.label("md 前置");
        ui.add_enabled_ui(md_editable, |ui| {
            ctp_edit(
                ui,
                shared,
                &mut form.md_addr,
                "tcp://host:40011",
                CtpField::MdAddr,
            );
            ui.label("md 用户");
            ctp_edit(
                ui,
                shared,
                &mut form.md_user,
                "空=td 回落",
                CtpField::MdUser,
            );
            ui.label("md 密码");
            ctp_edit(
                ui,
                shared,
                &mut form.md_password,
                "空=td 回落",
                CtpField::MdPassword,
            );
        });
        if !md_editable {
            ui.label(
                egui::RichText::new("非行情源账户:md 位留空(换源需先移除在场账户)")
                    .color(crate::tokens::semantic::WARN),
            );
        }
    });
    // 收录勾选(ek-ctp 0.6.0 D-PC-FILTER):网关收录哪些产品类。勾选变更立刻回写共享表单
    // —— 与 ctp_edit 同一口径,否则下一帧从 shared 重读就把这次点击丢了。
    ui.horizontal(|ui| {
        ui.label("收录勾选:");
        let fut = ui.checkbox(&mut form.accept_futures, "期货('1')").changed();
        let opt = ui.checkbox(&mut form.accept_options, "期权('2')").changed();
        if fut || opt {
            shared.set_ctp_form(form.clone());
        }
        ui.label("都不勾 = 回落默认期货;未勾选的合约收到即丢(其持仓/成交/tick 一并不上账)");
    });
    // F4 口径(0.2.20,与账户面板底部同一句 —— 共用 `TXT_PRODUCT_CLASS_SCOPE` 常量)。
    // 公用合约表是在场各网关的并集:从账户改了勾选、行情源账户没改,表就不会多一行期权。
    ui.label(egui::RichText::new(TXT_PRODUCT_CLASS_SCOPE).weak());
    // 只读回带区(规划 U9):勾选是**意图**,网关回带才是**事实** ——
    // 旧口径 `ConfigureReply.product_classes` 既不回填也不显示,勾选是否生效无从判断。
    if let Some(r) = &editing {
        ui.horizontal(|ui| {
            ui.label("网关实际收录(只读回带):");
            ui.label(if r.effective_classes.is_empty() {
                "—(尚未装配或无回带)".to_string()
            } else {
                classes_label(&r.effective_classes)
            });
            ui.label("装配/登录状态(只读):");
            ui.label(format!(
                "{}{}",
                r.status_label(),
                r.fail_note
                    .as_ref()
                    .map(|n| format!(" —— {n}"))
                    .unwrap_or_default()
            ));
        });
    }
    // 操作行(规划 §3.3 四态):『保存』只写清册;『保存并连接』= 保存 + 入列一条 Connect 令;
    // 『取消』= 放弃未保存(与窗 × 同口径,规划 Q24)。被拦 → 弹窗不关 + 原因上屏(规划 Q26)。
    if shared.account_edit_dirty() {
        ui.label(
            egui::RichText::new("有未保存修改:『保存』写入清册,『取消』或关闭 = 放弃")
                .color(crate::tokens::semantic::WARN),
        );
    }
    ui.horizontal(|ui| {
        if ui.button("保存").clicked() {
            match save_account_draft(shared, &form, &alias, false) {
                Ok(()) => shared.end_account_edit(),
                Err(e) => {
                    shared.log_line(format!("[账户] 保存被拦:{e}"));
                    shared.set_edit_error(Some(e));
                }
            }
        }
        if ui.button("保存并连接").clicked() {
            match save_account_draft(shared, &form, &alias, true) {
                Ok(()) => shared.end_account_edit(),
                Err(e) => {
                    shared.log_line(format!("[账户] 保存并连接被拦:{e}"));
                    shared.set_edit_error(Some(e));
                }
            }
        }
        if ui.button("取消").clicked() {
            shared.end_account_edit();
        }
        ui.label("订阅不在本窗定死:查询合约窗勾选或下单面板代码回车(一律路由到行情源)");
    });
}

/// 账户清册里的派生名集合(账本标注用,每表算一次,不在每格里克隆清册)。
fn account_gateways(shared: &UiShared) -> std::collections::BTreeSet<String> {
    shared
        .accounts()
        .iter()
        .map(|a| a.gateway.clone())
        .collect()
}

/// 账本行的网关标注(0.2.18 Commit B,规划 U8):该网关已不在账户清册 = **已摘除账户的残留行**。
///
/// 摘除不清账本(柜台侧不受影响,重加该账户后由轮转查询重建视图 —— F5 实连复测:
/// 摘除后账本 81/29/44/2 原封不动),但界面必须说清这一行属于谁:旧口径零标注,
/// 用户会把已摘除账户的委托当成在场账户的。
/// 口径边界:**清册为空 = 不标注**(没有账户配置面时谈不上「摘除」,纯账本巡回钉 s27 即此形);
/// 资金格不标注(那里的网关位是账户来源标签,`ctp` 这类历史字面量不在清册口径内 —— 刻意划界)。
fn ledger_gw_label(gateway: &str, known: &std::collections::BTreeSet<String>) -> String {
    if known.is_empty() || gateway.is_empty() || known.contains(gateway) {
        gateway.to_string()
    } else {
        format!("{gateway}(已摘除)")
    }
}

/// 产品类短标签(`"1"` → 期货,`"2"` → 期权):勾选意图与网关回带事实并排显示用。
fn classes_label(classes: &[String]) -> String {
    if classes.is_empty() {
        return "—".to_string();
    }
    classes
        .iter()
        .map(|c| match c.as_str() {
            "1" => "期货",
            "2" => "期权",
            other => other,
        })
        .collect::<Vec<_>>()
        .join("+")
}

/// 『连接』入口的唯一出令处(四态分离:一条令做完 `svctl.start` + `{gw}.configure`)。
///
/// 入列同时就地置「装配中」:插件出队时也会置(幂等),但**入列到出队之间**若不置,
/// 行上的『连接/重试』钮还亮着 = 可重复入列(规划 Q7 防重入的界面侧一半)。
fn push_connect(shared: &UiShared, gateway: &str, form: &crate::state::CtpForm) {
    shared.push_cmd(UiCmd::Connect {
        gateway: gateway.to_string(),
        form: form.clone(),
    });
    shared.note_connect_sent(gateway);
    shared.log_line(format!(
        "[账户] {gateway} 连接已入列(svctl.start + {}.configure)",
        gateway
    ));
}

/// 配置弹窗『保存』/『保存并连接』的共同路径:**校验 → 写清册 →(可选)入列一条 Connect 令**。
///
/// - 编辑模式:覆盖该账户留档 + 别名(broker/账号只读 → 派生名不变,规划 Q25)。
/// - 添加模式:派生建行(别名随行入册,唯一性在 `add_account` 守卫里)+ 单源定源(规划 §5.C / D3)。
///
/// 被拦返回原因字符串:调用方**不关弹窗**,把原因写进 `edit_error` 显形(规划 Q26)。
fn save_account_draft(
    shared: &UiShared,
    form: &crate::state::CtpForm,
    alias: &str,
    connect: bool,
) -> Result<(), String> {
    form.validate()?;
    if let Some(gw) = shared.editing_account() {
        // 编辑目标必须还在清册(弹窗非 modal:期间该行可能被摘除)。
        if shared.account(&gw).is_none() {
            return Err(format!(
                "编辑目标 {gw} 已不在清册(该行被摘除):关闭弹窗后重新『添加』"
            ));
        }
        shared.update_account_form(&gw, form.clone());
        if !shared.set_account_alias(&gw, alias) {
            return Err(format!(
                "别名 {alias:?} 不可用(已被其他账户占用;别名须唯一)"
            ));
        }
        shared.log_line(format!(
            "[账户] 保存 {gw}(留档已更新;未重连:点行内『连接/重试』才下发到网关)"
        ));
        if connect {
            push_connect(shared, &gw, form);
        }
        return Ok(());
    }
    let mut row = crate::state::AccountRow::derive(form)?;
    row.alias = alias.trim().to_string();
    let gateway = row.gateway.clone();
    let account = row.account.clone();
    shared.add_account(row.clone())?;
    // 单源纪律在「保存」这一刻定源(规划 §5.C / D3):无源且无账户在场 → 新账户就是元账号
    // (md 前置保留 —— 清掉它等于这个账户自己也永远收不到 tick);
    // 已有源或已有账户在场 → 按纯 TD 装配(md 位清空,**留档与下发同一份**,消 U4)。
    let md = shared.md_source();
    let mut f = row.form.clone();
    if md.is_empty() && !shared.accounts_locked() {
        match shared.set_md_source(&gateway) {
            Ok(()) => {
                if f.md_addr.trim().is_empty() {
                    shared.log_line(format!(
                        "[账户] {gateway} 已设为行情源但 md 前置为空:点『编辑 {account}』补填 md 前置才出行情"
                    ));
                } else {
                    shared.log_line(format!("[账户] {gateway} = 行情源(首个账户自动指定,§5.C)"));
                }
            }
            Err(e) => {
                shared.log_line(format!("[账户] {e}"));
                f.md_addr.clear();
                f.md_user.clear();
                f.md_password.clear();
            }
        }
    } else {
        f.md_addr.clear();
        f.md_user.clear();
        f.md_password.clear();
        if md.is_empty() {
            shared.log_line("[账户] 已有账户在场:新账户按纯 TD 装配,换源需先移除在场账户");
        }
    }
    shared.update_account_form(&gateway, f.clone());
    // **四态分离:『保存』到此为止** —— 不 start、不 configure(规划裁定)。
    shared.log_line(format!(
        "[账户] 添加 {gateway}(未装配:点行内『连接 {account}』上线)"
    ));
    if connect {
        push_connect(shared, &gateway, &f);
    }
    Ok(())
}

/// 查询合约窗(Python ContractManager 等价):查询串(代码/交易所/名称模糊,
/// 留空 = 全部)+ 勾选表 + 订阅钮(勾选集 → UiCmd::CtpSubscribe → ask
/// ctp.subscribe)。合约数据 = `eContract.` 自动回流,窗不催查询。
fn render_contracts_window(ui: &mut egui::Ui, shared: &UiShared) {
    let mut q = shared.contract_query();
    ui.horizontal(|ui| {
        ui.label("代码或交易所(留空 = 全部):");
        if ui
            .add(
                egui::TextEdit::singleline(&mut q)
                    .hint_text("cu 或 SHFE")
                    .desired_width(200.0),
            )
            .changed()
        {
            shared.set_contract_query(q.clone());
        }
    });
    let rows = shared.contracts(&q);
    // 表头单源(0.2.6 审计修:空态分支曾误写另一套表头「代码/…/最后价」,
    // 与非空分支「选(代码)/…/最小变动」不一致——列语义两处必须同源)。
    const CONTRACT_HEADERS: [&str; 5] = ["选(代码)", "交易所", "名称", "乘数", "最小变动"];
    if rows.is_empty() {
        // 空态提示移入表格 body(0.2.8,BD-UI-35,同未成交口径);动作行无意义可省。
        // 0.2.29 审计修:空态分支原来走 `pinned_table`(无列线 / 列不可拖),与非空分支
        // `pinned_table_grid` 不一致 —— 同一张表(id_salt 相同)在空/非空之间切换时
        // 列语义与可拖状态都该同源。
        pinned_table_grid(ui, "contract_grid", &CONTRACT_HEADERS, |body, row_h| {
            body.row(row_h, |mut row| {
                row.col(|ui| {
                    crate::ui_ext::muted_label(
                        ui,
                        "(无合约:先连接 CTP,合约随 eContract. 自动回流)",
                    );
                });
            });
            1
        });
        return;
    }
    let selected = shared.selected_contracts();
    // 动作行在前、表格吃满剩余窗高(BD-UI-33,用户实看指出):旧
    // max_height(260) 是内嵌弹窗时代残留——OS 窗里表格定高 260px,
    // 放大窗口表格不跟着长,放大就没了意义。现在放大窗口 = 表格变高,
    // 行溢出才出滚动条。
    ui.horizontal(|ui| {
        ui.label(format!("已选 {} 项 / 共 {} 项", selected.len(), rows.len()));
        if ui.button(BTN_SUBSCRIBE_SELECTED).clicked() {
            if selected.is_empty() {
                shared.log_line("[查询合约] 未勾选任何合约,订阅未发");
            } else {
                // en_symbol 勾选集 → CTP 裸代码订阅(ask {gw}.subscribe 收裸代码)
                let symbols: Vec<String> = selected
                    .iter()
                    .map(|k| {
                        k.split_once('.')
                            .map(|(_, s)| s.to_string())
                            .unwrap_or_else(|| k.clone())
                    })
                    .collect();
                match subscribe_target(shared) {
                    Ok(gw) => {
                        shared.push_cmd(UiCmd::CtpSubscribe {
                            gateway: gw.clone(),
                            symbols,
                        });
                        shared.log_line(format!(
                            "[ops] 查询合约窗订阅 {} 项已入列 → {gw}(等 eTimer 请辞 → {}.subscribe)",
                            selected.len(),
                            gw
                        ));
                    }
                    Err(e) => shared.log_line(format!("[订阅] {e}")),
                }
            }
        }
    });
    // 网格线(BD-UI-41):Python 侧只有合约表开着网格(`widget.py:2423` / `2621` 建表时
    // 没调 `setShowGrid(False)`,交易表在 `367` 关了)→ 照它:合约表加,交易表不加。
    pinned_table_grid(ui, "contract_grid", &CONTRACT_HEADERS, |body, row_h| {
        const RIGHT_COLS: [usize; 2] = [3, 4];
        for c in &rows {
            let key = format!("{}.{}", c.exchange.as_str(), c.symbol);
            let mut on = selected.contains(&key);
            // 勾选钮标签 = en_symbol(唯一可定位;订阅钮按勾选集发)。
            // BD-UI-31 扩展:勾选 = 订阅选择 + 行选中;其余格单击 =
            // 行选中(动作归行,不归某一列)。
            let row_sel = shared.row_selected("contracts", &key);
            body.row(row_h, |mut row| {
                row.set_selected(row_sel);
                macro_rules! cell {
                    ($make:expr, $col:expr) => {{
                        let (cell_r, inner_r) = tcell(&mut row, RIGHT_COLS.contains(&$col), $make);
                        let hit = cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
                        if hit {
                            shared.select_row("contracts", &key);
                        }
                    }};
                }
                // 勾选框的 `changed()` 只在勾选框自己的 Response 上(格响应看不到它,
                // 见 `CellOutcome` 注释)→ 动作必须在格闭包里就地取。
                let mut ck_changed = false;
                row.col(|ui| {
                    if ui.checkbox(&mut on, key.clone()).changed() {
                        ck_changed = true;
                    }
                });
                if ck_changed {
                    shared.toggle_contract_selection(&key);
                    shared.select_row("contracts", &key);
                }
                cell!(|ui| ui.label(c.exchange.as_str().to_string()), 1);
                cell!(|ui| ui.label(c.name.clone()), 2);
                cell!(|ui| ui.label(crate::format::volume(c.size)), 3);
                cell!(|ui| ui.label(crate::format::price_tick(c.price_tick)), 4);
            });
        }
        rows.len()
    });
}

/// CTP 表单字段枚举(ctp_edit 回写定位;订阅标的字段已撤出网关窗)。
enum CtpField {
    Broker,
    TdAddr,
    TdUser,
    TdPassword,
    AppId,
    AuthCode,
    MdAddr,
    MdUser,
    MdPassword,
}

/// 单行 TextEdit + changed 回写 CTP 表单(密码位掩码)。
fn ctp_edit(ui: &mut egui::Ui, shared: &UiShared, val: &mut String, hint: &str, field: CtpField) {
    let is_secret = matches!(
        field,
        CtpField::TdPassword | CtpField::MdPassword | CtpField::AuthCode
    );
    let mut w = egui::TextEdit::singleline(val)
        .hint_text(hint)
        // 0.2.17:输入位加宽(旧 110 装不下一根 CTP 前置 `tcp://182.254.242.81:30001`
        // = 30 字符,用户看不见自己填的前置,也无法核对端口;快照钉 s39 前后对照)。
        .desired_width(210.0);
    if is_secret {
        w = w.password(true);
    }
    if ui.add(w).changed() {
        let mut f = shared.ctp_form();
        match field {
            CtpField::Broker => f.broker_id = val.clone(),
            CtpField::TdAddr => f.td_addr = val.clone(),
            CtpField::TdUser => f.td_user = val.clone(),
            CtpField::TdPassword => f.td_password = val.clone(),
            CtpField::AppId => f.td_app_id = val.clone(),
            CtpField::AuthCode => f.td_auth_code = val.clone(),
            CtpField::MdAddr => f.md_addr = val.clone(),
            CtpField::MdUser => f.md_user = val.clone(),
            CtpField::MdPassword => f.md_password = val.clone(),
        }
        shared.set_ctp_form(f);
    }
}

/// K线窗内容(dm bar 合成序列;格定点 = 该合约格;无格占位)。
///
/// 图实例每帧重建(BD-UI-20 口径:数据在 store 不丢,交互状态不跨帧)。
fn render_kline_cell(ui: &mut egui::Ui, cell: Option<&CellView>) {
    let Some(c) = cell else {
        ui.label("(K线无格:等 dm 合成)");
        return;
    };
    if c.bars.is_empty() {
        ui.label(format!("(K线:{}@{} 批空)", c.symbol, c.interval));
        return;
    }
    // 柱时间按北京钟面给图:egui_charts 0.2 的 Bar 只吃 DateTime<Utc> 且按
    // UTC 钟面画刻度 —— 用「换到 +08 再标回 UTC」的重标定,让横轴刻度显示
    // 北京钟面(数据面存 UTC 纳秒;重标定只挪刻度,不挪序)。
    let mut data = egui_charts::model::bar::BarData::new();
    for b in &c.bars {
        let dt = chrono::DateTime::<chrono::Utc>::from_timestamp_nanos(b.datetime)
            .with_timezone(&beijing_tz())
            .with_timezone(&chrono::Utc);
        data.push(egui_charts::model::bar::Bar::new(
            dt,
            b.open_price,
            b.high_price,
            b.low_price,
            b.close_price,
            b.volume,
        ));
    }
    ui.label(format!(
        "K线 {}@{}s({} 根)",
        c.symbol,
        c.interval,
        c.bars.len()
    ));
    // 0.2.30(BD-UI-46):图表色板不再自带它那套 TradingView 令牌。
    // egui_charts 0.2 的 `ChartConfig::default()` 读的是它自己的 RON `DESIGN_TOKENS`
    // (bullish `#26a69a` 青 / bearish `#F23645` 红)——**涨跌方向正好和我们的
    // 红涨绿跌相反**,而且它不读 egui `Visuals`,界面换什么主题都影响不到它。
    // 所以这里显式覆盖:涨 = RISE(红)、跌 = FALL(绿),底/网格/文字走 qdark 色板,
    // 让 K 线和界面是一家人(交接报告 §3 Wave B 的「ChartConfig 显式覆盖」项)。
    let cfg = egui_charts::config::ChartConfig {
        bullish_color: crate::tokens::semantic::RISE,
        bearish_color: crate::tokens::semantic::FALL,
        background_color: crate::tokens::qdark::BG1,
        grid_color: crate::tokens::qdark::BG4,
        text_color: crate::tokens::qdark::TEXT1,
        ..egui_charts::config::ChartConfig::default()
    };
    let mut chart = egui_charts::widget::Chart::with_config(data, cfg).visible_bars(60);
    chart.set_symbol(&c.symbol);
    chart.set_timeframe_label(&format!("{}s", c.interval));
    chart.enable_tracking_mode();
    let _ = chart.show(ui);
}

#[cfg(test)]
mod tests {
    use super::*;

    // 表头带 / tab chrome **派生规则**钉(BD-UI-41,0.2.30 收缩成一套主题):
    // Chrome 的每个角色必须取到令牌里那一档,不许自己挑。
    // (qss 原值本身由 `tests/ui_kittest.rs` 的 `u1_qdark_palette_matches_qss` 钉 ——
    //  色值字面量只留在测试侧,src 侧不写 `from_rgb`。)
    // 原来这里还有一条「不得与金融深色那一列混同」:金融深色已随主题面删除,
    // 判据对象不存在,删掉,不留一条空转的断言。
    #[test]
    fn chrome_derives_from_token_palette() {
        let v = crate::tokens::visuals();
        let ch = Chrome::of(&v);
        // qss:1959-1970 `QHeaderView::section { background #455364; color #DFE1E2 }`
        assert_eq!(ch.line, crate::tokens::qdark::BG4);
        assert_eq!(ch.header_text, crate::tokens::qdark::TEXT1);
        // qss:1579 `QTabBar::tab:top { background-color: #455364 }`
        assert_eq!(ch.tab_head_fill, crate::tokens::qdark::BG4);
        // qss:1592 `QTabBar::tab:top:selected { background #54687A;
        //   border-bottom: 3px solid #259AE9 }`
        assert_eq!(ch.tab_fill, crate::tokens::qdark::BG5);
        assert_eq!(ch.tab_underline, crate::tokens::qdark::ACCENT4);
    }

    // 日志入环打戳钉(BD-UI-41):日志表格化后「时间」列的事实源是 `LogRing`,
    // 打戳必须与表内时间列(`fmt_dt`)同一个口径 = 北京 +08,不能跟本机时区走
    // (本机不是 +08 时,口径错 = 日志与成交表差几小时,交易员对不上账)。
    #[test]
    fn log_entries_stamp_beijing_wall_clock() {
        let mut ring = crate::state::LogRing::new(4);
        ring.push("[ops] 一行");
        let e = &ring.entries()[0];
        assert_eq!(e.text, "[ops] 一行", "正文不得被时间戳污染");
        assert_eq!(e.at.len(), 8, "时间戳必须是 HH:MM:SS(8 字符),实测 {}", e.at);
        for seg in e.at.split(':') {
            assert!(seg.parse::<u32>().is_ok(), "时间戳有非数字段:{seg}");
        }
        let want = chrono::Utc::now()
            .with_timezone(&beijing_tz())
            .format("%H:%M:%S")
            .to_string();
        let secs = |s: &str| -> i64 {
            s.split(':')
                .map(|x| x.parse::<i64>().unwrap())
                .fold(0, |acc, v| acc * 60 + v)
        };
        let (a, b) = (secs(&e.at), secs(&want));
        let d = (a - b).abs();
        // 允许跨秒抖动,并容忍跨午夜(差值接近 86400 即同一口径的另一侧)。
        assert!(
            d <= 2 || d > 86_398,
            "日志时间戳必须走北京 +08:实测 {a} vs 期望 {b}"
        );
        // 旧门面不变:`snapshot()` 仍只给正文(测试与巡回取证靠它)。
        assert_eq!(ring.snapshot(), vec!["[ops] 一行".to_string()]);
    }

    // 表内时间列北京钟面钉(0.2.13):数据面存 UTC 纳秒,展示换回 +08 ——
    // 北京 09:30:01 入账后是 UTC 01:30:01,fmt_dt 必须显示 09:30:01,
    // 不是 01:30:01(旧实现的 UTC 直显,交易员看差 8 小时)。
    #[test]
    fn fmt_dt_shows_beijing_wall_clock() {
        let expect = chrono::DateTime::<chrono::Utc>::from_timestamp_nanos(
            ek_data::time::civil_to_nanos(ek_data::time::Civil {
                year: 2026,
                month: 4,
                day: 16,
                hour: 1,
                minute: 30,
                second: 1,
                nanos: 0,
            }),
        );
        // 真值自洽:UTC 01:30:01 ↔ 北京 09:30:01(双向换算回原钟面)
        let beijing = expect.with_timezone(&beijing_tz());
        assert_eq!(beijing.format("%H:%M:%S").to_string(), "09:30:01");
        // 再来一个跨日钉:北京 00:00:30 = UTC 前日 16:00:30(同 UTC 日,
        // 不同北京日 —— 旧实现会把这根显示成 16:00:30)
        let ns = ek_data::time::civil_to_nanos(ek_data::time::Civil {
            year: 2026,
            month: 4,
            day: 15,
            hour: 16,
            minute: 0,
            second: 30,
            nanos: 0,
        });
        // 0.3.1(Wave D):格式从 `HH:MM:SS` 收成 `HH:MM:SS.mmm`(照 Python `TimeCell`),
        // 时区口径没动 —— 这条钉的仍是「北京墙钟」这件事,不是小数位。
        assert_eq!(crate::format::time_hms_millis(Some(ns)), "00:00:30.000");
        // None → 占位
        assert_eq!(crate::format::time_hms_millis(None), "-");
    }
}