Skip to main content

ek_ui/
render.rs

1//! 唯一渲染入口(L2):真实 eframe App 与 kittest 建构走同一个 `render_body`。
2//!
3//! 布局 v7(0.4.1 BD-UI-54:拆停靠库、回归原生容器;蓝本 = Python 主窗 mainwindow.py):
4//! **TopBottomPanel(菜单) → TopBottomPanel(行情带) → SidePanel(下单) →
5//! CentralPanel(数据区 2×2 = 薄 QSplitter 两刀) → Window 弹窗**。
6//! - 行情带 = 六所固定 tab 条(`state::MARKET_ORDER`,用户裁定「每个交易所都要一个」;
7//!   标签 = 交易所**中文名**,条在**表之下**且先给它预留高度不许外溢 —— 九期 BD-UI-62)
8//!   加当前所的行情表;每个所都有自己的表与空态。只有 tick 表,没有按所的滚动表
9//!   —— 唯一源 = `eTick.` 订阅流,不从 bar 回。行内任意格单击 = 带入下单面板
10//!   (ek 增值,方案钉:盘口四列带方向,买1 价/量 → 卖,卖1 价/量 → 买,价格列
11//!   顺带填价,其余列方向保持默认 —— 0.2.1 `import_tick`),双击 = 弹 K线窗。
12//! - 下单侧(`SidePanel::left`,缺省 300 ≈ Python `setFixedWidth(300)`):下单面板
13//!   (Python TradingWidget 等价:9 字段 + 委托 + 全撤;表单 = 网格,按钮/提示语都是
14//!   网格行;网格后置 err label 由 ScrollArea 吸收 sizing 退让,BD-UI-27)+
15//!   盘口(买5卖5,Python TradingWidget 内序:字段钮 → 盘口)。
16//! - 数据区组容器:委托|未成交 / 成交 / 持仓 / 资金|日志 四组(Python 四个 QTabWidget
17//!   等价,tab 条 = 自绘 `tab_label`),2×2 两刀 = `crate::splitters`(份额可拖,
18//!   态在 `shared.data_split`,恢复布局回 50:50);撤列后的撤单口径:行双击 + 全撤 +
19//!   先撤(0.8.5,s11 改向);委托行双击 = 撤单,Python OrderMonitor 等价;
20//!   格内宽表走横向滚动,D7 口径)。
21//! - 弹窗两式(BD-UI-32):运维窗(菜单「运维」:插件/服务/依赖;0.2.10 起
22//!   流控查询钮随 sim 退场撤除)、
23//!   CTP 配置窗(菜单「网关」,CTP 插件自己的界面)= egui::Window 依附主窗;
24//!   查询合约窗(菜单「查询合约」:查询 + 勾选 + 订阅钮,Python ContractManager
25//!   等价)、K线窗(双击弹出,按合约多开)= 独立 OS 窗(show_viewport_immediate,
26//!   原生最小化/最大化/关闭,可拖出主窗;后端不支持多窗自动回退 egui::Window,
27//!   kittest 走回退面断言)。
28//! - 订阅两入口(用户裁定,网关窗不定死订阅):下单面板代码框**回车**订阅
29//!   (Python returnPressed 等价);查询合约窗**勾选订阅**。合约数据 =
30//!   `eContract.` 自动回流(ek-ctp 登录后自动查询,UI 只收不催)。
31//! - 回灌表单与票据文本框已退役(界面面);总线口(`UiCmd::Reload` 等)保留。
32//!
33//! kittest 断言面:各单元格独立 Label(`get_by_label` 直查);操作走
34//! `push_cmd` 入队(ui 插件 eTimer 辞行出队),确认状态就地翻位,零自制通道。
35//! 隔离红标:行状态含 Quarantin(快照扫描,BD-UI-17)。
36
37use ek_data::constant::{Direction, Offset, OrderType};
38use ek_station::SVCTL_NAME;
39use ek_station::wire::PlugRow;
40
41use crate::plugin::UI_NAME;
42use crate::state::{
43    BottomRightTab, CellView, ConfirmStep, TopLeftTab, UiCmd, UiShared, beijing_tz, is_quarantined,
44};
45
46/// 取消待确认按钮标签。
47pub const BTN_CANCEL_CONFIRM: &str = "取消确认";
48/// 下单提交按钮标签(v4 = Python「委托」钮)。
49pub const BTN_SEND_ORDER: &str = "委托";
50/// 全撤按钮标签(v4;活动委托逐个走既有撤单 ask)。
51pub const BTN_CANCEL_ALL: &str = "全撤";
52/// 撤单按钮前缀(S5;行级标签 = `撤单 {orderid}`)。
53pub const BTN_CANCEL_ORDER: &str = "撤单";
54/// 账户面板:添加账户钮(派生注册名 → svctl.start + {gw}.configure)。
55pub const BTN_ACCOUNT_ADD: &str = "添加账户";
56/// 菜单项:运维(弹运维窗)。
57pub const MENU_OPS: &str = "运维";
58// 0.9.34:旧 `MENU_ACCOUNTS`("账户")已随账户面板升级成「交易网关」模块窗删除 ——
59// 菜单项名不再由常量给,而是从挂载表 `MODULES` 的 `title` 来(单源)。
60/// 菜单项:帮助。
61pub const MENU_HELP: &str = "帮助";
62/// 菜单项:查询合约(弹查询合约窗;Python ContractManager 等价)。
63pub const MENU_CONTRACTS: &str = "查询合约";
64/// 菜单项 → 弹窗入口钮(BD-UI-31 一键直达:菜单钮即入口,一步弹窗,
65/// 不再挂下拉层;入口钮标签 = 菜单名本身)。
66/// 查询合约窗订阅钮(勾选集 → ask ctp.subscribe)。
67pub const BTN_SUBSCRIBE_SELECTED: &str = "订阅选中";
68/// 运维窗:装配显形手动重问钮(0.5 M3 —— 管线读数改吃事件后唯一的手动口子)。
69pub const BTN_PIPELINE_REFRESH: &str = "重问管线";
70/// 运维窗「配置托底」节:段目录刷新钮(0.6.0 环节8)。
71pub const BTN_CFG_REFRESH: &str = "刷新段落目录";
72
73/// F4 口径句(0.2.20,D-UI-F4-SCOPE):配置弹窗**唯一在场位**(0.9.10 面板底部
74/// 说明行退役,用户裁定「表下不留杂说明」;改勾选的现场 = 弹窗,口径跟着现场走)。
75pub const TXT_PRODUCT_CLASS_SCOPE: &str = "收录勾选只管该网关自己收录并上抛的合约;公用合约表 = 在场各网关的并集(合约与行情公用,规划 D3)。改勾选须『连接/重试』才下发到网关。";
76
77/// 订阅路由(规划 §5.C):行情订阅一律发往**行情元账号**。
78///
79/// 未指定行情源时回 `Err` —— 不静默发给某个从账号(纯 TD 账号收到订阅会
80/// 恒 `ok:true` 但永远不来 tick,是观测黑洞)。
81fn subscribe_target(shared: &UiShared) -> Result<String, String> {
82    let md = shared.md_source();
83    if md.is_empty() {
84        return Err("未指定行情源:账户面板点某账户的『设为行情源』后再订阅".to_string());
85    }
86    Ok(md)
87}
88
89fn state_text(r: &PlugRow) -> String {
90    r.state.clone()
91}
92
93/// 运维窗「统计」列的颜色(0.4.5 P7d 首发;0.5 M6 加容量参数;0.7.0 背压刀改吃水位)。
94///
95/// 新口径(随 ek-core 0.5.0 无界邮箱):判据的**主角是积压**(`pending`),
96/// 阈值吃**这一行自己的软顶**(`soft_cap`,由 ek-station 0.4.0 随快照带来):
97/// - `panics > 0` / `spilled > 0`(已触顶丢新帧)/ 积压越红阈 → ERROR;
98/// - 积压越黄阈 → WARN;
99/// - 全 0 → MUTED(这一格的意思是「没事」,不是数据)。
100///
101/// 软顶必须传进来:界面自己 10 万、网关吃缺省 262144,同一根绝对线在一边是
102/// 「快炸了」在另一边是「刚起步」(阈值口径见 `state::pending_thresholds`)。
103/// 公开是为了让这一判据可钉 —— 颜色本身在 kittest 里只能靠形状颜色判,
104/// 把决策抽成纯函数才能直接断言。
105pub fn stat_color(
106    theme: crate::tokens::Theme,
107    spilled: u64,
108    panics: u64,
109    pending: u64,
110    soft_cap: u64,
111) -> egui::Color32 {
112    let (warn, crit) = crate::state::pending_thresholds(soft_cap);
113    let s = crate::tokens::semantic_of_theme(theme);
114    if panics > 0 || spilled > 0 || pending >= crit {
115        s.error
116    } else if pending >= warn {
117        s.warn
118    } else {
119        s.muted
120    }
121}
122
123// 0.3.1(Wave D,BD-UI-49):时间列格式收进 `crate::format::time_hms_millis`(`HH:MM:SS.mmm`)。
124// 口径没变:北京时间 +08,数据面时间戳统一存 UTC 纳秒 —— CTP 回报的自然日本就是北京钟面,
125// 入账按 +08 换算存 UTC,展示面换回来,表内时间列与交易员作息同钟面,且与日志同源。
126
127// 展示面统一时区 = `crate::state::beijing_tz`(0.2.27 提到 state:日志入环打戳
128// 与表格时间列必须同一个口径,一份实现两处共用)。这里不留 doc comment ——
129// 它后面没有 item,clippy `empty_lines_after_doc_comment` 正是钉这种。
130
131// ---- BD-UI-31(R3)行高亮:由表格层承担(0.2.29 BD-UI-44 定口径,0.4.1 BD-UI-55 换库)----
132// 原来这里有两支手绘助手:`paint_row_bg`(行底色 = 各格响应矩形并集 + 硬编码半透明蓝)
133// 和 `click_cell`(在标签矩形上叠一层点击感应)。两支助手在 BD-UI-44 撤除:底色改吃主题
134// (`visuals.selection.bg_fill` / `widgets.hovered.bg_fill`,整行连续),格可点 = 表格层
135// 自己给的 Response。BD-UI-55 迁 egui_table 之后这条口径没变,只是实现搬到 delegate 的
136// `row_ui`(选中 / 悬停底色,行带全宽)与 `pin_cell`(格点击感应)。行底色仍跟主题
137// (0.2.27 斑马纹同口径:唯一主题下 `visuals.striped = false`,不许硬开)。
138
139/// 委托是否可撤(与 ek-data ACTIVE_STATUSES 同口径)。
140fn order_active(status: ek_data::constant::Status) -> bool {
141    ek_data::constant::ACTIVE_STATUSES.contains(&status)
142}
143
144/// 行情带入(0.2.1 扩展):任意列单击 = 带入合约+交易所;盘口四列带方向
145/// (买1价/买1量 → 卖,卖1价/卖1量 → 买 —— 吃对手挂价口径),两个价格列
146/// 顺带把该价填进价格格;其余列方向/价格保持表单默认(用户裁定)。
147pub fn import_tick(shared: &UiShared, t: &ek_data::tick::TickData, exchange: &str, col: usize) {
148    let mut f = shared.order_form();
149    f.symbol = t.symbol.clone();
150    f.exchange = exchange.to_string();
151    match col {
152        8 => {
153            f.direction = Direction::SHORT;
154            f.price = crate::format::price(t.bid_price_1);
155        }
156        9 => f.direction = Direction::SHORT,
157        10 => {
158            f.direction = Direction::LONG;
159            f.price = crate::format::price(t.ask_price_1);
160        }
161        11 => f.direction = Direction::LONG,
162        _ => {}
163    }
164    shared.set_order_form(f);
165}
166
167/// 按合约找最新 tick(下单面板名称/盘口/随价共用)。
168/// 交易所非空 = 精确 EX.symbol 匹配(跨所同码不串);空 = 仅按代码找。
169fn tick_of(shared: &UiShared, exchange: &str, symbol: &str) -> Option<ek_data::tick::TickData> {
170    if symbol.is_empty() {
171        return None;
172    }
173    shared.tick_rows().into_iter().find(|t| {
174        t.symbol == symbol
175            && (exchange.is_empty() || t.exchange.as_str().eq_ignore_ascii_case(exchange))
176    })
177}
178
179/// 字号 + 间距 + 控件规格 + 主题视觉(0.2.30 起全部走 `crate::tokens`;主题只有一套
180/// Qt深色,`Theme` 枚举与菜单循环钮已删 —— 裁定 8)。真实 App、独立子窗(immediate
181/// 共享同一 Context)、kittest 三处同源。
182/// 语义色(涨红跌绿 / 多红空绿 / 警告橙 / 错误深红 / 成功深绿 / 次级灰)**不在这一层**:
183/// 它们在 `tokens::semantic` 里恒定 —— 0.8.0 的口径是「**hue 恒定、明度跟档**」
184/// (判据 `u11` 钉着:浅档也不许把跌染成蓝),渲染侧走 `tokens::rise(ctx)` 等访问器取当前档。
185pub fn apply_ui_style(ctx: &egui::Context, theme: crate::tokens::Theme) {
186    ctx.style_mut(|style| {
187        crate::tokens::apply(style);
188    });
189    // 0.8.0 双档:档写进 Context::data(渲染侧取色访问器的唯一读源)+ 装这一档的 Visuals。
190    crate::tokens::set_theme(ctx, theme);
191    ctx.set_visuals(crate::tokens::visuals_for(theme));
192}
193
194/// 表格与页签的「chrome」配色(表头带、分隔线、tab 头底、选中 tab 下划线)。
195///
196/// 为什么要有这个结构:shadcn 有「表头带底」(`secondary` `#262626`)和「选中 tab 底 +
197/// 下划线」这两个概念,Python 侧对应 qdarkstyle 的 `QHeaderView::section`
198/// (表头带底 `#455364`)与 `QTabBar::tab:top:selected`(选中 tab `#54687A` 底 + 3px
199/// `#259AE9` 下划线),**egui 的 `Visuals` 里没有对应字段**(它只有 `selection.bg_fill`
200/// 一根,且 `selectable_label` 只能整块填充)。所以这一层只能在渲染侧直绘。
201///
202/// 取色口径(审计「多余」条):不新造颜色,全部从主题**已经声明过**的字段里取 ——
203/// 带底取 `widgets.inactive.bg_fill`,描边取 `noninteractive.bg_stroke`,表头文字取
204/// `noninteractive.fg_stroke`,选中 tab 底取 `widgets.hovered.bg_fill`,下划线取
205/// `hyperlink_color`。0.2.30 起主题只有一套,原来「按主题分叉」的那条 match 随之消失。
206///
207/// 0.4.1 四期(BD-UI-57)拆掉一根旧耦合:旧 qdark 里 `BG4` **同时**是表头带底和一切描边
208/// (`noninteractive.bg_stroke` = `#455364` = 带底),所以 `line` 一支两用。Nova 把这两件事
209/// 分成 `secondary` `#262626`(带底)与 `border`(白 10%,一切描边)→ 于是多出 `band_fill`
210/// 这一支,`line` 只管线不管底。
211///
212/// 0.4.0 期间 tab 那四支随「组内二级 tab 条撤除、tab 归 dock」删过一轮;0.4.1
213/// (BD-UI-54)tab 形态回归原生(自绘 `tab_label`),四支原样归位 —— 派生路径
214/// (同一份 `visuals`,`s67` 钉住)不变。
215#[derive(Clone, Copy)]
216struct Chrome {
217    /// 一切分隔线 / 网格线 / 行线 / 窗框(1px)。旧口径这一支兼做表头带底,现已拆开。
218    line: egui::Color32,
219    /// **行线专用**(0.8.2):参考站分 `--st-line`(表头那根)与 `--st-line-soft`(行线),
220    /// 0.8.0 通吃一支 → 行线比参考站重一档。表头带下边线与窗框仍然吃 `line`。
221    line_soft: egui::Color32,
222    /// 表头带底 + 未选中 tab 的头底。
223    band_fill: egui::Color32,
224    /// 表头带文字。
225    header_text: egui::Color32,
226    /// 选中 tab 的底。
227    tab_fill: egui::Color32,
228    /// 选中 tab 的文字。
229    tab_text: egui::Color32,
230    /// 选中 tab 的下划线(qss 3px 那支)。
231    tab_underline: egui::Color32,
232}
233
234impl Chrome {
235    /// 从当前 visuals + 当前档派生(0.8.0 双档:派生规则唯一,只是入参多了一个档)。
236    ///
237    /// 0.8.0 新增的口径:**表头文字走次级色 `text3`**(参考站 `th{color:var(--st-ink-muted)}`
238    /// 口径,也是裁定 C 引入三层文字后的一层落点)。旧口径表头文字 = `noninteractive.fg_stroke`
239    /// = 正文色,与表体同色 = 层级塌一档。
240    ///
241    /// 0.8.2 的教训写在这里:这一支在 0.8.0 就**存在且被判据钉过**(u10/`Chrome` 字段钉),
242    /// 但六张表的表头是 `header_cell_ui` 自己画的、那里**没吃这一支** → 钉绿而屏幕错。
243    /// 现在表头两处(Grid 短表的覆盖带 + pinned_table 的 `header_cell_ui`)都吃 `header_text`,
244    /// 判据 `s94` 钉的是**落屏颜色**,不是字段值。
245    fn of(v: &egui::Visuals, theme: crate::tokens::Theme) -> Self {
246        Self {
247            line: v.widgets.noninteractive.bg_stroke.color,
248            line_soft: theme.palette().border_soft,
249            band_fill: v.widgets.inactive.bg_fill,
250            header_text: theme.palette().text3,
251            tab_fill: v.widgets.hovered.bg_fill,
252            tab_text: v.widgets.hovered.fg_stroke.color,
253            tab_underline: v.hyperlink_color,
254        }
255    }
256}
257
258/// 页签(BD-UI-41,对照 qdarkstyle `QTabBar::tab:top`)。
259///
260/// Python 侧四个区全是 QTabWidget(`mainwindow.py:106-204`,连只有一个 tab 的
261/// 「成交」「持仓」也带 tab 头),qss 给 tab 的形态是:
262///   未选中 `QTabBar::tab:top { background #455364; padding 2px 4px }` +
263///     `!selected { border-bottom: 2px solid #19232D }`(qss:1579 / 1559)
264///   选中   `QTabBar::tab:top:selected { background #54687A;
265///     border-bottom: 3px solid #259AE9; 上圆角 4px }`(qss:1592)
266/// egui 的 `selectable_label` 只有「整块 selection 填充」,画不出下划线,也没有
267/// 「未选中也有头底」这一层。所以这里照 pinned_table 表头带同一套路子:
268/// **控件仍走 selectable_label**(可访问性标签 / 点击 / 键盘都不换),只是随后用
269/// painter 盖上头底 + 下划线,并重画文字(epaint 0.33 没有 z-order,后画的填充
270/// 会盖住先画的文字,所以文字必须重画 —— 与表头带同一处理)。
271fn tab_label(ui: &mut egui::Ui, selected: bool, text: impl Into<String>) -> egui::Response {
272    let ch = Chrome::of(ui.visuals(), crate::tokens::theme_of(ui.ctx()));
273    let text: String = text.into();
274    let resp = ui.selectable_label(selected, text.clone());
275    let r = resp.rect;
276    let radius = ui.visuals().widgets.inactive.corner_radius;
277    let font = ui.style().text_styles[&egui::TextStyle::Button].clone();
278    let p = ui.painter();
279    let (fill, ink, underline) = if selected {
280        (
281            ch.tab_fill,
282            ch.tab_text,
283            egui::Stroke::new(3.0_f32, ch.tab_underline), // qss 的 3px 那支
284        )
285    } else {
286        (
287            ch.band_fill,
288            ch.header_text,
289            egui::Stroke::new(2.0_f32, ch.line), // 未选中 tab 的 2px 下边线
290        )
291    };
292    p.rect_filled(r, radius, fill);
293    p.hline(r.x_range(), r.max.y, underline);
294    p.text(
295        r.center(),
296        egui::Align2::CENTER_CENTER,
297        text.as_str(),
298        font,
299        ink,
300    );
301    resp
302}
303
304/// 普通 Grid 的表头带(BD-UI-41)。
305///
306/// 与 `pinned_table` 的覆盖带同一套路子:头行照常在 grid 里占格(列宽由它量出来,
307/// 这是唯一权威源),随后 painter 盖上带底 + 下边线并重画文字(epaint 0.33 无 z-order,
308/// 填充盖字 → 文字必须重画)。
309///
310/// 为什么这三处不走 `pinned_table`:它们是**自动尺寸浮动窗里的短表**(账户清单 /
311/// 运维插件表 / 服务目录)。0.2.17 实锤(s39):`pinned_table` =
312/// `auto_shrink(false)` 滚动区吃满整块可用高 + 覆盖式表头带,在自动尺寸浮动窗里
313/// 两者凑不出正确高度 → 表行与其后的口径句互相压字。账户行最多几个,不需要固定
314/// 表头滚动面,只要那根带。
315///
316/// 0.2.29(BD-UI-44)把这条边界写死:数据监控表(行情/委托/成交/持仓/日志/合约/资金)
317/// 一律走表格层(0.4.1 BD-UI-55 = egui_table 的 `pinned_table`);自动尺寸浮动窗里的
318/// 短表一律 Grid + 这根带。资金表原来在第三类里,实测它和日志表共用同一块 tab 容器
319/// (不是浮动窗)→ 已并入表格层一侧。
320pub(crate) fn header_band(
321    ui: &mut egui::Ui,
322    heads: &[(egui::Rect, String)],
323    content_right: f32,
324) -> egui::Rect {
325    if heads.is_empty() {
326        return egui::Rect::NOTHING;
327    }
328    let ch = Chrome::of(ui.visuals(), crate::tokens::theme_of(ui.ctx()));
329    // 带的横向范围 = **整行**(这一格 / 这一窗的可用宽),不是表头文字矩形的并集。
330    // 根因(0.2.28 用户实看指出「运维窗表头背景没按整行、最后一列只有文字有背景」):
331    // `Response::rect` 是控件自己的矩形,不是列框(grid.rs:180-193 —— `next_cell`
332    // 给出列框,`align_size_within_rect` 按 LEFT_CENTER 对齐后返回子控件尺寸)。
333    // 表头 label 的 rect 宽 = 文字宽。原来按表头 rect 的并集算带 → 带只盖到
334    // 最后一列**表头文字**的右端,列内比它宽的部分(运维窗『操作』列的两个按钮、
335    // 服务目录的空实例列、资金格右侧)没有带 = 看上去断开一截。
336    // 口径照 Python:QHeaderView 铺满整个表视口;也与 `pinned_table` 那条带一致
337    // (那条铺的是 ScrollArea 的 inner_rect = 整格宽)。
338    let left = ui.max_rect().min.x;
339    // 0.2.30(BD-UI-47):带的右端取「可用宽」与**表体实际右端**的较大者。
340    // 浮动窗是自动尺寸的,而 `header_band` 在 Grid 之后才画 —— 令牌把控件交互宽
341    // 从 egui 缺省 128 收到 40 后,窗内 Grid 的实际宽度比窗的可用宽更宽(s69 实测
342    // 带 640 / 体表 727),带就盖不住最后一列。口径不变:带必须盖住整行。
343    let right = ui.max_rect().max.x.max(content_right);
344    // 带高与表格层**同一个数**(0.4.1 八期 BD-UI-61,用户问「表头的高度都一样吗」):
345    // 表格层带高 = 表头行高 `head_h`(26)+ `clip_rect_margin`(3)= 29;短表层原来取
346    // 「文字高 + 上下各半间距」= 22 → 同一屏里菜单窗的表头比主窗矮 7 px(探针实测 22.0 vs 29.0)。
347    // 现在按同一条公式算,并以**表头行的垂直中心**为带中心 → 带高一致、文字在带里居中。
348    let head_h = table_heights(ui).1;
349    let band_h = head_h + ui.visuals().clip_rect_margin;
350    let mid = heads[0].0.center().y;
351    let top = mid - band_h * 0.5;
352    let bottom = mid + band_h * 0.5;
353    let strip = egui::Rect::from_min_max(egui::pos2(left, top), egui::pos2(right, bottom));
354    let p = ui.painter();
355    p.rect_filled(strip, 0.0, ch.band_fill);
356    p.hline(
357        strip.x_range(),
358        strip.max.y,
359        egui::Stroke::new(1.0_f32, ch.line),
360    );
361    let font = ui.style().text_styles[&egui::TextStyle::Small].clone();
362    // 表头文字的锚定线 = **带的垂直中心**(0.4.1 七期 BD-UI-60)。旧口径取 galley 中心
363    // `(top + heads[0].0.max.y)/2`,比带中心高 2.5 px → 文字在带里偏上(实测上隙 4.5 / 下隙 8.5)。
364    let mid_y = (strip.min.y + strip.max.y) * 0.5;
365    for (rect, text) in heads {
366        p.text(
367            egui::pos2(rect.min.x, mid_y),
368            egui::Align2::LEFT_CENTER,
369            text.as_str(),
370            font.clone(),
371            ch.header_text,
372        );
373    }
374    strip
375}
376
377/// 判据侧读口(0.4.1 七期 BD-UI-60):这张表这一拍的「列宽总和」与「补宽目标宽」。
378///
379/// 目标宽 = 所在区域可用宽 − 这张表自己的滚动条占位。判据钉的是「补过之后 Σ ≥ 目标 9 成」
380/// —— 表宽 = 所在区域 100% 这条裁定在 kittest 里唯一不靠猜的读法(列线撤除后,列边界
381/// 在形状表里已经没有落点了)。
382pub fn table_fill_probe(ctx: &egui::Context, table_id: &str) -> (f32, f32) {
383    let fill_id = egui::Id::new(("table_fill", table_id));
384    ctx.data(|d| {
385        (
386            d.get_temp::<f32>(fill_id.with("stored")).unwrap_or(0.0),
387            d.get_temp::<f32>(fill_id).unwrap_or(0.0),
388        )
389    })
390}
391
392/// Grid 短表的网格线(0.4.1 五期 BD-UI-58,用户裁定「网格线在黑色背景下反而显得整齐」
393/// → 表格层与短表层同一口径:每行一根行线、每两列一根列线)。
394///
395/// - 行线 = 这一行内容底沿往下半个 `item_spacing.y`。Grid 的行间距就是 `item_spacing`
396///   (grid.rs:113 / 432),半个间距 = 两行正中;最后一行的行线就是这张表的底边线,
397///   与 `pinned_table` 里「行线画在行底」同一条不变式(那边行间距为 0)。
398/// - 列线 = 第 2..n 列表头矩形的左沿往左半个 `item_spacing.x`。Grid 格内是 LEFT 对齐
399///   (`align_size_within_rect`),控件左沿就是列左沿 → 半个间距正是两列正中。
400/// - 表头行那根下边线由 `header_band` 画,这里不重复画第二根。
401///
402/// `row_bottoms` = 各**表体行**在 `end_row` 前测到的 `ui.min_rect().max.y`。空态(0 行)
403/// 时它是空的:没有行线可画,列线只到表头带底(0.4.1 六期 BD-UI-59 起空态不画提示行,短表空态
404/// = 只有表头那一行)。
405pub(crate) fn grid_chrome(
406    ui: &egui::Ui,
407    band: egui::Rect,
408    heads: &[(egui::Rect, String)],
409    row_bottoms: &[f32],
410) {
411    if !band.is_positive() || heads.is_empty() {
412        return;
413    }
414    let ch = Chrome::of(ui.visuals(), crate::tokens::theme_of(ui.ctx()));
415    let sp = ui.spacing().item_spacing;
416    let p = ui.painter();
417    for &rb in row_bottoms {
418        p.hline(
419            band.x_range(),
420            rb + sp.y * 0.5,
421            // 行线 = `line_soft`(0.8.2,参考站 td{border-bottom:var(--st-line-soft)};
422            // 表头带那根下边线才是 `line`,由 `header_band` 画)。
423            egui::Stroke::new(1.0_f32, ch.line_soft),
424        );
425    }
426    // 列线(0.4.1 七期 BD-UI-60,用户裁定「表格里所有的列分割线都去掉,只要行的分割线」):
427    // 短表层这套自绘列线直接撤除,`heads` 从此只用来判「有没有表头」与定带的宽。
428}
429
430/// 画一窗(官方面板组合:render_body 直接开顶层面板,不自嵌 CentralPanel)。
431///
432/// v7 框架(0.4.1,BD-UI-54):TopBottomPanel(菜单) → TopBottomPanel(行情带) →
433/// SidePanel(下单)| CentralPanel(数据区 2×2 薄 QSplitter) → 弹窗。
434/// 0.4.0 的整窗 dock 拆除。官方纪律(panel.rs 模块文档):顶层面板不得互相嵌套、
435/// CentralPanel 最后加、Window 挂在所有面板之后。
436pub fn render_body(ctx: &egui::Context, shared: &UiShared) {
437    apply_ui_style(ctx, shared.theme());
438    // 0.3.1(Wave D,BD-UI-49)退出确认:关窗先问一句(照 Python `closeEvent`)。
439    // 拦关闭用的是 egui 0.33 的 `ViewportCommand::CancelClose`;用户在窗里点「确认退出」
440    // 才置放行位并重发 `Close` —— 否则确认完也关不掉。
441    let close_requested = ctx.input(|i| i.viewport().close_requested());
442    if close_requested && !shared.exit_confirmed() && !shared.exit_confirm_open() {
443        ctx.send_viewport_cmd(egui::ViewportCommand::CancelClose);
444        shared.open_exit_confirm();
445    }
446    // 0.3.2(Wave E,BD-UI-50)告警 toast 每帧收口(队列常驻在 UiShared,不是这里的局部变量)。
447    crate::toast::drain_and_show(ctx, shared);
448    if shared.exit_confirm_open() {
449        // 0.9.10 P2a(四面美化·关窗确认):tone 钮(取消=Ghost,确认退出=Confirm 红)、
450        // 一句正文带现场(在线账户数 = 退出的真实代价)、窗随内容自适应。
451        let online = shared
452            .accounts()
453            .iter()
454            .filter(|a| a.stage == crate::state::AccountStage::Assembled)
455            .count();
456        let body = |ui: &mut egui::Ui| {
457            ui.label(format!(
458                "确认退出?在线账户 {} 个,退出将断开全部连接并收场。",
459                online
460            ));
461            ui.horizontal(|ui| {
462                if op_button(ui, "取消", OpTone::Ghost).clicked() {
463                    shared.close_exit_confirm();
464                }
465                if op_button(ui, "确认退出", OpTone::Confirm).clicked() {
466                    shared.confirm_exit();
467                    shared.close_exit_confirm();
468                    ctx.send_viewport_cmd(egui::ViewportCommand::Close);
469                }
470            });
471        };
472        let mut probe = egui::Ui::new(
473            ctx.clone(),
474            egui::Id::new("exit_confirm_probe"),
475            egui::UiBuilder::new()
476                .global_scope(true)
477                .invisible()
478                .max_rect(egui::Rect::from_min_size(
479                    egui::pos2(0.0, 0.0),
480                    egui::vec2(48.0, 1.0e5),
481                ))
482                .layout(egui::Layout::top_down(egui::Align::Min)),
483        );
484        body(&mut probe);
485        let want = probe.min_rect().size() + egui::vec2(28.0, 44.0);
486        egui::Window::new("退出确认")
487            .collapsible(false)
488            .resizable(false)
489            .auto_sized()
490            .min_size(egui::vec2(260.0, 90.0))
491            .default_size(want)
492            .show(ctx, |ui| {
493                body(ui);
494            });
495    }
496    // ---- 菜单栏(顶层面板,最先 = 最外) ----
497    egui::TopBottomPanel::top("menu_bar").show(ctx, |ui| {
498        render_menu_bar(ui, shared);
499    });
500
501    // ---- 上带:行情带(全宽独占,可拖分隔条;缺省高 = Python v_splitter 30:70 分带) ----
502    egui::TopBottomPanel::top("market_band")
503        .resizable(true)
504        .default_height(crate::tokens::MARKET_BAND_HEIGHT)
505        .show(ctx, |ui| {
506            // 外层 ScrollArea auto_shrink(false) = resizable 面板吃满前提(BD-UI-27
507            // 口径;s3 实锤:撤掉后空态带塌成一行,2×2 行位全漂移)。内层
508            // pinned_table 自己会收缩适配 → 外层滚动条永不出现。
509            egui::ScrollArea::both()
510                .id_salt("market_band_scroll")
511                .auto_shrink([false, false])
512                .show(ui, |ui| {
513                    render_market_band(ui, shared);
514                });
515        });
516
517    // ---- 下带左侧:下单面板 + 盘口(Python TradingWidget setFixedWidth(300)) ----
518    egui::SidePanel::left("order_side")
519        .resizable(true)
520        .default_width(crate::tokens::ORDER_SIDE_WIDTH)
521        .show(ctx, |ui| {
522            // ScrollArea 吸收 sizing 退让(BD-UI-27):网格后置 err label 不再叠回网格
523            egui::ScrollArea::vertical()
524                .id_salt("order_side_scroll")
525                .auto_shrink([false, false])
526                .show(ui, |ui| {
527                    render_order_panel(ui, shared);
528                    ui.separator();
529                    render_book_frame(ui, shared);
530                });
531        });
532
533    // ---- 下带右侧:数据区 2×2(薄 QSplitter 两刀;份额可拖,态在 UiShared) ----
534    egui::CentralPanel::default().show(ctx, |ui| {
535        render_data_area(ui, shared);
536    });
537
538    // ---- 弹窗面(官方口径:Window 在顶层面板之后) ----
539    render_windows(ctx, shared);
540}
541
542/// 行情带 = 当前所的行情表 + 六所固定 tab 条(0.4.1 BD-UI-54 回归原生容器;
543/// 「每交易所一格」= 六个 tab,每个 tab 都有自己的表与空态,s73 口径不变)。
544///
545/// 0.4.1 用户裁定(2026-10-22):**tab 条放在表下面**(原来在表上面)。
546/// 这是对 Python 侧 `QTabWidget` 缺省 tabPosition=North 的一处偏离,记 DESIGN。
547/// 判据面不受影响:六所 tab 序钉(V2)与「行情带横跨全宽」钉(s3)取的都是
548/// tab 标签在场 + 格内容左沿/高度关系,与 tab 条在表的哪一侧无关。
549/// 交易所 tab 名 = **中文名**(0.4.1 九期 BD-UI-62,用户裁定「不要显示交易所的代码,
550/// 而是显示交易所的名字」)。叫法照 Python 侧(`xt_gateway.py:1089-1094` 与
551/// `datafeed/ak/futures_member_pos.py:14-19` 的映射:中金所=CFFEX / 上期所=SHFE /
552/// 郑商所=CZCE / 大商所=DCE / 广期所=GFEX,INE = 能源中心)。
553pub fn exchange_tab_name(ex: ek_data::constant::Exchange) -> &'static str {
554    use ek_data::constant::Exchange as E;
555    match ex {
556        E::SHFE => "上期所",
557        E::DCE => "大商所",
558        E::CZCE => "郑商所",
559        E::CFFEX => "中金所",
560        E::GFEX => "广期所",
561        E::INE => "能源中心",
562        // 行情带只有上面六所(`state::MARKET_ORDER`);其余变体回落线上代码。
563        other => other.as_str(),
564    }
565}
566
567fn render_market_band(ui: &mut egui::Ui, shared: &UiShared) {
568    let active = shared.selected_exchange();
569    let active_ex = crate::state::MARKET_ORDER
570        .iter()
571        .copied()
572        .find(|e| e.as_str() == active)
573        .unwrap_or(crate::state::MARKET_ORDER[0]);
574    // **先给 tab 条留出高度,再让表吃剩下的**(0.4.1 九期 BD-UI-62,用户实看:「表格被下面
575    // 标签给挡住了,只有滚动才能看到」)。根因:表(内层 ScrollArea)先分配 = 把整块面板高
576    // 吃干,tab 条排在它后面就被推到面板底边之外(探针实测 1280×860:面板底 ≈275,
577    // tab 标签落在 y 274..300 = 面板之外,还与数据区「委托」tab 头 278..304 压在一起)。
578    // tab 条是固定条,不该跟表格滚动抢地方。
579    // 预留高度照 `tab_label` 真正用的那一档:`selectable_label` 走 `TextStyle::Button`
580    // + `button_padding`(不是 Small —— 用 Small 会少算,窗口一窄就又开始外溢)。
581    let tab_h = ui.text_style_height(&egui::TextStyle::Button)
582        + ui.spacing().button_padding.y * 2.0_f32
583        + 4.0_f32;
584    let avail = ui.available_size();
585    let table_rect = egui::Rect::from_min_size(
586        ui.cursor().min,
587        egui::vec2(avail.x, (avail.y - tab_h).max(40.0)),
588    );
589    ui.scope_builder(egui::UiBuilder::new().max_rect(table_rect), |ui| {
590        // 表头带的上隙(`clip_rect_margin`)要在子 ui 里留出地方:子 ui 的 clip = 这块
591        // max_rect,若表从 cursor 顶开始画,带顶那 3 px 会被裁掉(带高 26 而不是 29,
592        // s79「所有表头带同一档」当场红)。
593        ui.add_space(ui.visuals().clip_rect_margin);
594        render_market_pane(ui, shared, active_ex);
595    });
596    ui.horizontal(|ui| {
597        for ex in crate::state::MARKET_ORDER {
598            if tab_label(ui, ex == active_ex, exchange_tab_name(ex)).clicked() {
599                shared.set_selected_exchange(ex.as_str());
600            }
601        }
602    });
603}
604
605/// 数据区 2×2 = 上下(顶部:委托|未成交 | 成交;底部:持仓 | 资金|日志),
606/// 两刀都是可拖的薄 QSplitter(份额在 `shared.data_split`,恢复布局回 0.5)。
607fn render_data_area(ui: &mut egui::Ui, shared: &UiShared) {
608    let split = shared.data_split();
609    // 0.4.1 九期 BD-UI-62:2×2 改走 `splitters::quad`(一根贯穿横线 + 一根贯穿竖线)。
610    // 旧口径 = `split_v` 上下分完再在每排里各来一刀 `split_h` → 「竖刀」实为两条独立线段,
611    // 悬 / 拖只有被碰的那半亮(用户实看)。份额仍是同一对 `DataSplit { row, col }`。
612    crate::splitters::quad(
613        ui,
614        egui::Id::new("ek_data_quad"),
615        split.row,
616        split.col,
617        |row| {
618            shared.set_data_split(crate::state::DataSplit {
619                col: split.col,
620                row,
621            });
622        },
623        |col| {
624            shared.set_data_split(crate::state::DataSplit {
625                col,
626                row: split.row,
627            });
628        },
629        |ui| render_topleft_group(ui, shared),
630        |ui| render_trades_group(ui, shared),
631        |ui| render_positions_group(ui, shared),
632        |ui| render_bottomright_group(ui, shared),
633    );
634}
635
636/// 委托|未成交 组(Python tab_widget1:两 tab 同一容器)。
637fn render_topleft_group(ui: &mut egui::Ui, shared: &UiShared) {
638    let tab = shared.topleft_tab();
639    ui.horizontal(|ui| {
640        if tab_label(ui, tab == TopLeftTab::Orders, TopLeftTab::Orders.label()).clicked() {
641            shared.set_topleft_tab(TopLeftTab::Orders);
642        }
643        if tab_label(ui, tab == TopLeftTab::Active, TopLeftTab::Active.label()).clicked() {
644            shared.set_topleft_tab(TopLeftTab::Active);
645        }
646    });
647    render_orders_table(ui, shared, tab == TopLeftTab::Active);
648}
649
650/// 资金|日志 组(Python tab_widget4;Account 分支 = 0.4.0 修好的「空态带表头」版)。
651fn render_bottomright_group(ui: &mut egui::Ui, shared: &UiShared) {
652    let tab = shared.bottomright_tab();
653    ui.horizontal(|ui| {
654        if tab_label(
655            ui,
656            tab == BottomRightTab::Account,
657            BottomRightTab::Account.label(),
658        )
659        .clicked()
660        {
661            shared.set_bottomright_tab(BottomRightTab::Account);
662        }
663        if tab_label(
664            ui,
665            tab == BottomRightTab::Logs,
666            BottomRightTab::Logs.label(),
667        )
668        .clicked()
669        {
670            shared.set_bottomright_tab(BottomRightTab::Logs);
671        }
672    });
673    match tab {
674        BottomRightTab::Account => render_funds_pane(ui, shared),
675        BottomRightTab::Logs => render_logs(ui, shared),
676    }
677}
678
679// 0.4.1(BD-UI-54):数据区组的容器 = 薄 QSplitter 的两块内容区(sql)。格边框与
680// 分隔线走色板令牌(`splitters::run_split` 只吃 `tokens::shadcn`,V5 钉住);
681// 0.3.0 dock 容器曾接管过这层,0.4.1 拆 dock 后归位。
682// 0.2.30 那条教训仍然成立并记在 DESIGN.md:egui 0.33.3 的 `Frame` 没有 `min_size`,
683// `Frame::paint` 的描边按**内容** min_rect 算(frame.rs:486)——内容少的格边框会跟着缩。
684
685// 表头固定表(BD-UI-34 用户裁定「每个表的表头都要固定」;0.2.29 BD-UI-44 起换成表格库,
686// 0.4.1 BD-UI-55 表格库 = `egui_table 0.7`,用户裁定「表格使用 egui_table」)。
687//
688// 为什么要表格库(实拍毛病 2/3/5,对照 Python 的 QTableView):
689// - **列宽跟内容**:手绘 Grid 的列宽只能取各格 `Response::rect` 的最大值,而
690//   `Response::rect` 是控件矩形不是列框(0.2.28 实锤,egui grid.rs:180-193)
691//   → 列宽只能"差不多",数字列对不齐。表格库的列宽是库自己量出来的(egui_table:
692//   `Column::range` 夹 `max_column_widths`,table.rs:816-843 写回 `ColumnState.width`)。
693// - **表头天生固定**:表头行画在体表滚动区之外(egui_table `Table::show` 先 `header_ui`
694//   再 `SplitScroll`,table.rs:470-537)→ 0.2.8 起那块「ScrollArea 之后重画覆盖带 +
695//   重画表头文字」的 DIY 全撤(当年 DIY 是因为 egui 没有表;scroll_area.rs:412
696//   那句「painting a sticky header on top of it」就是 DIY 的出处)。
697// - **横向溢出**:成交表 14 列比格子宽,Python 出横向滚动条(毛病 5)。egui_table 的
698//   `SplitScroll` 自带横 + 纵两条滚动条:表头跟着体表一起横滚(不错位),竖滚仍归表体
699//   (表头不动)。
700// - **选中 / 悬停底色吃主题**:egui_table 不提供行选中(全库无 `set_selected`)→ 底色由
701//   delegate 的 `row_ui` 自己画,色仍取 `visuals.selection.bg_fill` /
702//   `widgets.hovered.bg_fill`,且按行带全宽画 = 整行底色连续
703//   → 手绘 `paint_row_bg` 那支硬编码半透明蓝撤掉(与 0.2.27「斑马纹跟主题」同口径)。
704// - **网格线(0.4.1 五期 BD-UI-58 起:全部表统一都有)**:列线 = 可拖列边界那根线
705//   (egui_table `Column::resizable` + `chrome().line`),行线 = delegate 每行的行底。
706//   旧口径是「只有合约表开网格」(Python `widget.py:367` 的 `setShowGrid(False)` 只加在
707//   交易表上,合约表 `widget.py:2423`/`2621` 没关,qss `gridline-color:#455364`)——
708//   用户 2026-10-22 实看后裁定撤掉这条分叉:「网格线在黑色背景下比较暗,有横向竖向这些线
709//   反而显得整齐」→ 交易表跟合约表一样都画,`GridLines` 这个开关随之退役。
710//
711// body 闭包在表体内执行(行循环归闭包);行高由本模块统一算,body 只写每格内容。
712// pub(crate):`pinned_table_impl_cols` 是 pub(crate)(日志表字体量宽入口要用)。
713
714/// 行高 / 表头高 = 字号 + 6。Python QTableView 的 sizeHint ≈ 字体高 + 4~6;
715/// 0.2.28 之前 Grid 自然行高在 kittest 实测行间距 21 = 正文 14.7 + 6,同值。
716pub(crate) fn table_heights(ui: &egui::Ui) -> (f32, f32) {
717    let st = ui.style();
718    // 行高必须取「文字高 + 6」与**控件交互高令牌**的较大者。格里有钮 / 勾选框时
719    // 表格层的实际行高 = max(请求值, 格内最高控件):请求值 22 < 实际 26 时,
720    // 行线公式按假行高算 —— 0.2.30 实锤:行线画在 y=514 而第 3 行文字中心在 511
721    // = 0.2.28 治过的毛病 8(行线压到文字中心上)复发。别把这个 max 拆掉。
722    let floor_h = crate::tokens::INTERACT_HEIGHT;
723    (
724        (st.text_styles[&egui::TextStyle::Body].size + 6.0).max(floor_h),
725        (st.text_styles[&egui::TextStyle::Small].size + 6.0).max(floor_h),
726    )
727}
728
729// ================= egui_table 0.7.0 适配层(BD-UI-55,用户裁定「表格使用 egui_table」) =========
730//
731// egui_table 的形制是「拉」:建 `Table`(列/表头/行数)+ `TableDelegate`(表头/行/格的
732// 逐个绘制回调);egui_extras::TableBuilder 的形制是「推」(调用点闭包直接喂行)。
733// 本层把推改成拉:调用点的 body 闭包**原样保留**(行循环 + 每格内容),只是行收进
734// `PinBody`/`PinRow` 的延迟画笔,show 时由 delegate 逐格执行 —— 每张表调用点只多写
735// `selected` 一个参数与 `pin_cell` 一层包装。
736//
737// 每格左内边距 = 6px(egui_table 离 battery 之外不加 margins,old TableBuilder 的
738// item_spacing 缩进由 Frame::inner_margin 补回来,不然文字贴列边框)。
739
740/// 单格延迟画笔(行收集物;腰上 `'b` = pinned_table_impl 的本次调用)。
741/// **FnMut 不是 FnOnce**:egui_table 首帧在同一帧里把每格跑两遍(全量量内容的
742/// invisible sizing pass + 真绘 pass,库自己 `request_discard`)—— FnOnce 在
743/// sizing pass 里就被消费掉,真绘 pass 会全空(0.4.1 实锤:所有格文字消失)。
744/// 格内动作要幂等(select_row/set_order_form 等同帧重放语义不变;egui 的
745/// request_discard 本来就是「整帧重来」)。
746/// 第二个参数 = 这一格的上下文(满格命中层),由 delegate 的 `cell_ui` 造,见 `PinCellCtx`。
747pub(crate) type PinCell<'b> = Box<dyn FnMut(&mut egui::Ui, &PinCellCtx) + 'b>;
748
749/// 一格真实绘制时由 delegate 递给调用点的上下文(BD-UI-55)。
750pub(crate) struct PinCellCtx {
751    /// 满格命中层:在**格那一层**注册的响应(`Ui::interact`,矩形 = 整格)。
752    ///
753    /// 为什么不是 `ui.allocate_rect(ui.max_rect(), ..)`(BD-UI-55 最大拦路虎,已修):
754    /// `allocate_rect` 的口径是「忽略布局,这块地归我」—— 布局 cursor 被推到整格之外,
755    /// 之后格内的内容排到**下一格**去。实锤(临时探针 + vendor 出来的 egui 打点,
756    /// 脚手架已随本次提交拆除,读数留档在交接报告 §4.1 / 交接报告主文 §21.3):
757    /// 格 clip `[901..1001]`,格内 label 的实际矩形 `[1003..1088]` = 错开一整列宽 →
758    /// `Label` 的绘制门 `ui.is_rect_visible(response.rect)` 判假 → 表体文字既不画、
759    /// 也不进语义树。`interact` 不推进布局(ui.rs:1131 只 `create_widget`),
760    /// 满格命中与格内真控件的响应照旧两层并立 = 0.2.29「两边都看」口径不变。
761    ///
762    /// `interact_rect` = 注册处 ui 的 clip ∩ 矩形(ui.rs:1140),所以这颗必须注册在
763    /// **格那一层**(clip = 整格),不能注册在 Frame 内层(clip 已被内边距缩掉 6px)。
764    pub hit: egui::Response,
765}
766
767/// 一行(PinBody 收集物)。行高统一走 delegate 的 `row_h`(`table_heights`),
768/// egui_table 的行是相邻接等高带 —— `body.row(h, ..)` 的 h 现在只是调用点形状兼容,
769/// 不再逐行生效(0.4.1 适配层口径)。
770struct PinRow<'b> {
771    selected: bool,
772    cells: Vec<PinCell<'b>>,
773}
774
775/// 体表 push 收集器(替代 `egui_extras::TableBody` 的角色;BD-UI-55)。
776#[derive(Default)]
777pub(crate) struct PinBody<'b> {
778    rows: Vec<PinRow<'b>>,
779}
780
781impl<'b> PinBody<'b> {
782    /// 与旧 `body.row(h, |mut row| ..)` 同形,多一个 `selected`
783    /// (选中底色从构建时的 `set_selected` 改为收集物,绘制时 `row_ui` 画)。
784    pub(crate) fn row(&mut self, _h: f32, selected: bool, add: impl FnOnce(&mut PinRowAdd<'b>)) {
785        let mut r = PinRowAdd {
786            selected,
787            cells: Vec::new(),
788        };
789        add(&mut r);
790        self.rows.push(r.finish());
791    }
792}
793
794/// 行头的 `PinRow::row` 闭包参数,负责收格。
795pub(crate) struct PinRowAdd<'b> {
796    selected: bool,
797    cells: Vec<PinCell<'b>>,
798}
799
800impl<'b> PinRowAdd<'b> {
801    /// 一格,与旧 `row.col(|ui| ..)` 同形(形态不同点:内容延迟到体表真实绘制时跑,
802    /// 且首帧同帧跑两遍 —— FnMut,见 `PinCell`;多出来的第二个参数 = 这一格的
803    /// `PinCellCtx`,由 delegate 的 `cell_ui` 造)。
804    pub(crate) fn cell(&mut self, make: impl FnMut(&mut egui::Ui, &PinCellCtx) + 'b) {
805        self.cells.push(Box::new(make));
806    }
807    fn finish(self) -> PinRow<'b> {
808        PinRow {
809            selected: self.selected,
810            cells: self.cells,
811        }
812    }
813}
814
815/// 与旧 `tcell(row, right, make)` 等价的一格:格响应 = 整格可点那一层
816/// (`PinCellCtx::hit`,在格那一层注册的 `interact`),格内控件自己的响应跟随
817/// `CellOutcome::response()`;命中判定(旧宏里 `cell_r.clicked() || inner_r.clicked()`)
818/// 由这两个响应合成:返回 `(cell_r, inner_r)`,闭包内接着写行动作 ——
819/// 与 0.2.29 的「两边都看」完全同口径(egui 一颗点击只发给一个响应,见 `CellOutcome`)。
820///
821/// **0.8.0 对齐统一:撤掉 `right_align` 形参。** 旧口径六张表各有一份 `RIGHT_COLS`
822/// (行情 10 / 持仓 11 / 委托 4 / 成交 3 / 资金 3 / 合约 2 = 35 个右对齐格位)经
823/// `RIGHT_COLS.contains(&$col)` 传进来,而表头 100% 左对齐 —— 用户报的
824/// 「表头和表的内容对齐方式不一致」的真身。裁定 D = **全左对齐** → 右对齐那半退役,
825/// 「数字成列」由 `tokens::num_text`(等宽数字)那一半守(代价与口径见 `num_text` 注释)。
826pub(crate) fn pin_cell<R: CellOutcome>(
827    ui: &mut egui::Ui,
828    ctx: &PinCellCtx,
829    make: impl FnOnce(&mut egui::Ui) -> R,
830) -> (egui::Response, Option<egui::Response>) {
831    let inner = make(ui);
832    (ctx.hit.clone(), inner.response())
833}
834
835/// SplitScroll 的**退化象限**判定(BD-UI-55 实查;`row_ui` 用)。
836///
837/// `num_sticky_cols = 0` 时左上/左下象限的 rect 恒零宽,可 egui_table 无条件调四个
838/// 象限的 delegate(split_scroll.rs:79-151)→ 左下象限里每一行都会调一次 `row_ui`。
839/// 那里画不出任何东西(裁剪矩形零面积 → tessellator.rs:1367 直接丢),但选中底色 /
840/// 行线仍会被登记进本帧形状表 —— 判据读的正是形状表,所以就地不画。
841///
842/// 判据 = 「clip 与格矩形**共边**(宽恰为 0)而格矩形本身正」。这与「格在视口之外」
843/// (clip 与格矩形不相交 → 宽为**负**)是两种不同的退化,后者不能砍:首帧列宽量测靠的
844/// 就是「全列都跑一遍」(table.rs:633-637 的 `do_full_sizing_pass` → `col_range = 0..len`)。
845/// 表头那一侧这两种退化在几何上长得一样,分不开 → `header_cell_ui` 改用调用序判据。
846fn quadrant_is_degenerate(ui: &egui::Ui) -> bool {
847    let c = ui.clip_rect();
848    let m = ui.max_rect();
849    (c.width() == 0.0 && m.width() > 0.0) || (c.height() == 0.0 && m.height() > 0.0)
850}
851
852impl egui_table::TableDelegate for PinDelegate<'_, '_> {
853    fn header_cell_ui(&mut self, ui: &mut egui::Ui, cell: &egui_table::HeaderCellInfo) {
854        // 表头在 SplitScroll 里被画**两遍**:调用序 = right_bottom → left_top → right_top
855        // → left_bottom(split_scroll.rs:79-151)。`num_sticky_cols = 0` → left_top 那一遍
856        // 在零宽象限里:形状画不出(裁剪退化 → tessellator.rs:1367 直接丢),可 egui 的
857        // `Rect::intersects` 用 `<=`(零宽 clip 与文字矩形「相切」也算相交)→
858        // `is_rect_visible` 判真 → 同一颗表头在 AccessKit 语义树里两颗(0.4.1 实锤:
859        // s3/s26/s63/s71 的「成交金额 / 成交号 / 信息 / 最小变动」各两颗)。
860        //
861        // 判据用**调用序**而不是几何:退化象限里 clip 与格矩形相交时宽恰为 0、不相交时
862        // 为负,而「格在视口之外」的 clip 也是负 —— 几何上分不开(本轮实撞:按几何判
863        // 要么漏掉 left_top 的第 2 列起,要么把视口外的表头一起砍掉)。left_top 恒在
864        // right_top 之前 → 本 pass 里这一列的第一次调用就是退化象限,不画。
865        //
866        // 第二遍(视口那一层)**照画,视口外的列也画**:首帧列宽量测靠的就是「全列都跑
867        // 一遍」(table.rs:633-637 的 `do_full_sizing_pass` → `col_range = 0..len`);
868        // 漏掉表头,那一列就只量到体表内容(0.4.1 实锤:「成交金额」列 24px 而表头文字
869        // 57px,表头文字压进隔壁列)。视口外的格 `is_rect_visible` 判假 → 不画也不建
870        // 语义节点,所以照画不会带回双节点。
871        let i = cell.col_range.start;
872        let Some(seen) = self.header_drawn.get(i) else {
873            return;
874        };
875        let seen = *seen;
876        if !seen {
877            self.header_drawn[i] = true;
878            return;
879        }
880        // 表头格:文字(0.4.0 前的形制 == strong + small)+ 可点(排序入口)。
881        // 带色底与铺满全宽的带已在 pinned_table_impl 里画好(在表 show 之前 =
882        // z 序在下),这里只画文字 + register 点击。
883        let i = cell.col_range.start;
884        let mark = match self.sort {
885            Some((c, asc)) if c == i => {
886                if asc {
887                    " ▲"
888                } else {
889                    " ▼"
890                }
891            }
892            _ => "",
893        };
894        // 表头文字上下居中(0.4.1 七期 BD-UI-60,用户裁定「表格里的文字包括抬头都要上下居中」)。
895        // 旧口径:库给的表头格 child ui 起笔在格顶 → 实测带高 29 时文字视觉盒上隙 11 / 下隙 4。
896        // 光靠格内起笔调不出来(galley 的**视觉盒**比它的行盒偏下几 px)→ 直接把这一颗文字
897        // 按带的垂直中心摆:在 `band_mid ∓ 行高/2` 处开一个与格同宽的子 ui。
898        let cell = ui.max_rect();
899        let gh = ui.text_style_height(&egui::TextStyle::Small);
900        // **表头文字起笔 = 格左缘 + 格内内边距**(0.8.0 对齐统一,判据 s91):体表格每一格
901        // 套了 `Frame::inner_margin(left = CELL_INSET_X)`(见 `cell_ui`),旧口径表头从
902        // `cell.min.x` 起笔 → 表头比表体内容**靠左 6px**,就是用户报的「表头和表的内容
903        // 对齐方式不一致」。两处吃同一个常量,逐列左沿对齐(竖线共用)。
904        let target = egui::Rect::from_min_size(
905            egui::pos2(
906                cell.min.x + crate::tokens::CELL_INSET_X,
907                self.band_mid - gh * 0.5,
908            ),
909            egui::vec2(cell.width() - crate::tokens::CELL_INSET_X, gh),
910        );
911        ui.scope_builder(egui::UiBuilder::new().max_rect(target), |ui| {
912            // **表头文字色 = 当前档的 text3**(0.8.2 补的落点,判据 `s94`):参考站
913            // `th{color:var(--st-ink-muted)}`。0.8.0 只把这一支做进了 `Chrome` 与 Grid 短表
914            // 的覆盖带,六张表的表头在这里画、没吃它 → 表头与表体同色(用户复看「表头和表格里
915            // 的字的颜色就不对」的实底)。`.strong()` 只加字重,颜色显式给。
916            ui.label(
917                egui::RichText::new(format!("{}{mark}", self.headers[i]))
918                    .strong()
919                    .small()
920                    .color(crate::tokens::theme_of(ui.ctx()).palette().text3),
921            );
922        });
923        // 点表头 = 排序。id 用「这颗表头格自己的 ui id」:egui_table 给表头格的 child ui
924        // 带 `id_salt(("header", row_nr, group_index))`(table.rs:586-593)→ 列间唯一、
925        // 帧间稳定;旧口径(`ui.id().with(("ek_table_header", table_id, i))`)的等价物。
926        let id = ui.id().with(("hdr_click", i));
927        if ui
928            .interact(ui.max_rect(), id, egui::Sense::click())
929            .clicked()
930        {
931            self.clicked.get_or_insert(i);
932        }
933    }
934
935    fn row_ui(&mut self, ui: &mut egui::Ui, row_nr: u64) {
936        // 左下象限(零宽,`num_sticky_cols = 0`)也会逐行调到这里 —— 与表头同理,
937        // 别让它把选中底色 / 行线登记进形状表。
938        if quadrant_is_degenerate(ui) {
939            return;
940        }
941        let r = ui.max_rect();
942        // **整行**底色,不是「有内容的那几格」(0.4.1 九期 BD-UI-62,用户裁定「我们选的是整行,
943        // 包括空行的也一起给它标上颜色」)。库给的行矩形 = `col_x[0]..=col_x[last]`
944        // (table.rs:689-690) = 所有列的宽度并集;列总宽窄于可视区时(日志表两列、接管版
945        // 列宽的表),行矩形右边就比可视区短一截 → 高亮只到最后一列右边,右边空余不亮。
946        // 补法:右边至少铺到「与表头带同宽」(带 = 可视区宽,`band_x` 构造时已捕获)。
947        let band_w = self.band_x.max - self.band_x.min;
948        let fill = egui::Rect::from_min_max(
949            egui::pos2(r.min.x, r.min.y),
950            egui::pos2(r.max.x.max(r.min.x + band_w), r.max.y),
951        );
952        // 选中底色(0.2.29 口径 = 主题 `selection.bg_fill`,不再手绘蓝)。
953        if let Some(row) = self.rows.get(row_nr as usize) {
954            if row.selected {
955                ui.painter()
956                    .rect_filled(fill, 0.0, ui.visuals().selection.bg_fill);
957            } else if ui.rect_contains_pointer(fill) {
958                // 悬停判定也用 `fill`(整行)而不是 `r`(内容宽):否则「行尾空余」这一带
959                // 鼠标放进去根本不会亮 —— 那等于只把颜色补宽了,裁定没做全。
960                ui.painter()
961                    .rect_filled(fill, 0.0, ui.visuals().widgets.hovered.bg_fill);
962            }
963            // 行线(0.4.1 五期 BD-UI-58:全部表都有,不再是合约表专属)。
964            // x 横跨**表体可视宽**而不是这一行的内容宽:旧口径取 TableBuilder body 的
965            // `max_rect().x_range()` = 横向 ScrollArea 内层 ui 的可用宽 = 整张表宽;
966            // 按单行内容宽画,列内容窄于面板时行线只到最后一列右边,与表头带不同宽
967            // (0.4.1 实锤:合约表行线 427..825,带 423..991 → 判据里 13 行数成 1 根)。
968            // 行线(0.4.1 五期 BD-UI-58:全部表都有;六期 BD-UI-60 起它是**唯一**的网格线,
969            // 列线按用户裁定撤除)。颜色取 delegate 构造时捕获的 `line` —— 表 scope 里
970            // `noninteractive.bg_stroke` 已被改成透明(见 `pinned_table_impl`),在这里现取
971            // 会连行线一起抹掉。
972            ui.painter()
973                .hline(self.band_x, r.max.y, egui::Stroke::new(1.0_f32, self.line));
974        }
975    }
976
977    fn cell_ui(&mut self, ui: &mut egui::Ui, cell: &egui_table::CellInfo) {
978        // 每格左内边距 6(注释见模块头);按列取出延迟画笔就地执行(FnMut,
979        // 首帧两遍都跑;不 replace —— FnOnce 那套会让第二遍全空,0.4.1 实锤)。
980        let Some(row) = self.rows.get_mut(cell.row_nr as usize) else {
981            return;
982        };
983        let Some(slot) = row.cells.get_mut(cell.col_nr) else {
984            // 空态行只推了首格(§4.2 低优):缺格静默跳过。
985            return;
986        };
987        // 满格命中层(见 `PinCellCtx::hit`):注册在格这一层 —— 这层的 clip 就是整格,
988        // `interact` 的 interact_rect = clip ∩ 整格 = 整格。id 用这层自己的 ui.id():
989        // egui_table 给格 child ui 带 `id_salt((row_nr, col_nr))`(table.rs:713-720)
990        // → 格间唯一、帧间稳定(旧 `TableRow::col` 那颗格响应的等价物)。
991        let hit = ui.interact(
992            ui.max_rect(),
993            ui.id().with("pin_cell"),
994            egui::Sense::click(),
995        );
996        let ctx = PinCellCtx { hit };
997        // 格内左右内边距 = `tokens::CELL_INSET_X`(0.8.0 对齐统一:表头文字起笔吃的是
998        // **同一个常量**,旧口径两处各写 6 → 表头比表体靠左 6px = 用户报的对不齐)。
999        let inset = crate::tokens::CELL_INSET_X as i8;
1000        egui::Frame::new()
1001            .inner_margin(egui::Margin {
1002                left: inset,
1003                right: inset,
1004                top: 0,
1005                bottom: 0,
1006            })
1007            .show(ui, |ui| slot(ui, &ctx));
1008    }
1009
1010    fn default_row_height(&self) -> f32 {
1011        self.row_h
1012    }
1013}
1014
1015/// pinned_table 用的 delegate(见模块头说明;字段随 `pinned_table_impl` 收集)。
1016struct PinDelegate<'d, 'b> {
1017    headers: &'d [&'d str],
1018    sort: Option<(usize, bool)>,
1019    rows: &'d mut [PinRow<'b>],
1020    row_h: f32,
1021    clicked: Option<usize>,
1022    /// 本 pass 里每列表头已画过没有(表头在 SplitScroll 里被画两遍,见 `header_cell_ui`)。
1023    header_drawn: Vec<bool>,
1024    /// 表头带的 x 范围 = 表体可视宽。行线按它画,不按单行的内容宽(旧口径,见 `row_ui`)。
1025    line: egui::Color32,
1026    band_x: egui::Rangef,
1027    /// 表头带的垂直中心(0.4.1 七期 BD-UI-60:表头文字按它上下居中,见 `header_cell_ui`)。
1028    band_mid: f32,
1029}
1030
1031/// 行高/表头高 = 字号 + 6(`table_heights` 见上;两值直接进 `HeaderRow`/行收集)。
1032///
1033/// 四个入口都要带自由 `'p`:行收集物 `PinBody<'p>` 的行延迟画笔寿命 = **调用方帧**
1034/// (add_body 闭包里的格闭包借用外层局部 —— `'p` 由调用点挑一个盖住它们的生命周期)。
1035/// 写成匿名的 `PinBody<'_>`(HRTB ⇒ for<'x> 任一寿命)会让借用逃逸出函数体
1036/// (E0521/E0597,本轮实撞)。
1037pub(crate) fn pinned_table<'p>(
1038    ui: &mut egui::Ui,
1039    table_id: &str,
1040    headers: &[&str],
1041    body: impl FnOnce(&mut PinBody<'p>, f32),
1042) -> Option<usize> {
1043    pinned_table_impl(ui, table_id, headers, None, body)
1044}
1045
1046/// 0.3.1(Wave D,BD-UI-49)可排序表:`sort` = 当前排序键,返回**这一拍被点过的表头列**。
1047/// 排序键由调用方从 `UiShared::table_sort` 取、点完表头再写回 `toggle_table_sort`.
1048fn pinned_table_sorted<'p>(
1049    ui: &mut egui::Ui,
1050    table_id: &str,
1051    headers: &[&str],
1052    sort: Option<(usize, bool)>,
1053    body: impl FnOnce(&mut PinBody<'p>, f32),
1054) -> Option<usize> {
1055    pinned_table_impl(ui, table_id, headers, sort, body)
1056}
1057
1058/// pinned_table 的共用实现(0.4.1 BD-UI-55 起换 egui_table 0.7.0):
1059/// - **表头天生粘顶**(egui_table `headers` 半 sticky row,0.2.6 DIY 覆盖带撤除)。
1060/// - **横向溢出**:SplitScroll 的右下象限 = 横向滚动区,表头(右象限)与体表同滚不错位,
1061///   表头带照画全宽(带底画在 show 之前 = z 序最底)。
1062/// - **列宽**:库的首帧全量量测(do_full_sizing_pass)+ 之后冻结可持续拖/resizable 列。
1063///   没有「每帧 auto_size_this_frame」:那会让 delegate(连同我们的action闭包)每帧跑两遍
1064///   —— egui 的 sizing pass = request_discard 重跑一遍帧,行动作一切两半(0.4.1 实查:
1065///   table.rs:384-443 的 discard 挂 per-column,content 变化重测路径库注释自己也标
1066///   TODO)。内容超宽的列(日志正文)由调用方传列宽。
1067/// - **行交互**:egui_table 不给格/行级 Response —— 每格用 `pin_cell` 自己建「满格
1068///   allocate + 控件响应」的两层判定(与 0.2.29 的旧「格响应+控件响应」等价)。
1069/// - **选中/悬停**:delegate 的 `row_ui`(行带全宽;旧 TableBuilder 的 expand 缝补
1070///   不再需要 —— egui_table 行与行零间隙)。
1071/// - **斑马纹依旧没有**(0.2.27 起跟主题 = visuals.striped = false)。
1072fn pinned_table_impl<'p>(
1073    ui: &mut egui::Ui,
1074    table_id: &str,
1075    headers: &[&str],
1076    sort: Option<(usize, bool)>,
1077    add_body: impl FnOnce(&mut PinBody<'p>, f32),
1078) -> Option<usize> {
1079    pinned_table_impl_cols(ui, table_id, headers, sort, None, add_body)
1080}
1081
1082/// 空态列宽(0.4.1 五期 BD-UI-58,用户裁定「按表头分配各列比例,等有数据再按数据调整」):
1083/// 按**表头文字宽的比例**把这一拍的可用宽分掉。表头总宽 > 可用宽时不放大(照内容走横向
1084/// 滚动,与 Python `ResizeToContents` 同形)。`+12` = 格左右内边距 6+6(`cell_ui` 的
1085/// `inner_margin`),下限 24 = `Column::range` 下限。
1086fn header_proportional_widths(ui: &egui::Ui, headers: &[&str], available: f32) -> Vec<f32> {
1087    let head_font = ui.style().text_styles[&egui::TextStyle::Small].clone();
1088    let head_w = |s: &str| -> f32 {
1089        let g = ui.painter().layout_no_wrap(
1090            s.to_string(),
1091            head_font.clone(),
1092            egui::Color32::TRANSPARENT,
1093        );
1094        (g.size().x + 12.0).max(24.0)
1095    };
1096    fill_proportional(headers.iter().map(|h| head_w(h)).collect(), available)
1097}
1098
1099/// 表头份额不足可用宽时按比例放大到刚好填满;够宽(会溢出)时原样返回(走横向滚动)。
1100fn fill_proportional(mut base: Vec<f32>, available: f32) -> Vec<f32> {
1101    let sum: f32 = base.iter().sum();
1102    if sum > 0.0 && sum < available {
1103        let k = available / sum;
1104        for w in base.iter_mut() {
1105            *w *= k;
1106        }
1107    }
1108    base
1109}
1110
1111/// 列宽接管版(BD-UI-55 适配层第二入口):内容**逐帧生长**的表(日志正文)由调用方
1112/// 传列当前宽 —— 字体量串走 egui 的 galley 缓存(同串命中),不走库的
1113/// auto_size_this_frame(那条路 = request_discard 每帧双 pass,action 闭包跑两遍)。
1114/// 空态(这一拍没有数据行,由 `n_rows == 0` 现场判定,不用调用方声明)且没传列宽时,
1115/// 按表头比例分配(见 `header_proportional_widths`)。
1116pub(crate) fn pinned_table_impl_cols<'p>(
1117    ui: &mut egui::Ui,
1118    table_id: &str,
1119    headers: &[&str],
1120    sort: Option<(usize, bool)>,
1121    col_current: Option<Vec<f32>>,
1122    add_body: impl FnOnce(&mut PinBody<'p>, f32),
1123) -> Option<usize> {
1124    let ch = Chrome::of(ui.visuals(), crate::tokens::theme_of(ui.ctx()));
1125    let (row_h, head_h) = table_heights(ui);
1126    let sp = ui.spacing().item_spacing;
1127    let m = ui.visuals().clip_rect_margin;
1128    // 表头带:整行宽(Python QHeaderView 铺满表视口;0.2.28 给浮动窗短表补的
1129    // header_band 铺整行是同一件事)。画在表之前 = 在表头文字之下,零布局副作用
1130    // (0.2.6「资金右多一根竖线」那类 min_rect 被撑宽的病在这里不会再犯)。
1131    let left = ui.cursor().min.x - sp.x * 0.5;
1132    let top = ui.cursor().top();
1133    // 带底 = 表头行底边,egui_table 的表头行高就是 `head_h` 且**体表紧接着开始**
1134    // (行与行、表头与体表都不留 item_spacing,table.rs:404-411 `header_row_y` 累加
1135    // `header.height()`)。旧 TableBuilder 在表头与首行之间留了一格 `sp.y`,带底才多画
1136    // 那 6 px —— 照搬过来带底就压进首行(0.4.1 实锤:带 407..442,首行 436..462,
1137    // 首行文字 440..458 被带底横线从中间切过)。
1138    let band = egui::Rect::from_min_max(
1139        egui::pos2(left, top - m),
1140        egui::pos2(left + ui.available_width() + sp.x, top + head_h),
1141    );
1142    ui.painter().rect_filled(band, 0.0, ch.band_fill);
1143    // 带底下边线:表头带与体表的分界(Python 的表头带与体表是两种底色,天然有界;
1144    // 我们只有一根带,补线才有界)。
1145    ui.painter().hline(
1146        band.x_range(),
1147        band.max.y,
1148        egui::Stroke::new(1.0_f32, ch.line),
1149    );
1150    // 滚动条形态:全局一处口径(`tokens::apply` 的 `spacing.scroll`,0.4.1 七期 BD-UI-60
1151    // 起 5 px 细 + BG4 暗把手)。SplitScroll 内部是标准 ScrollArea,吃同一套 spacing。
1152    let mut body = PinBody::default();
1153    add_body(&mut body, row_h);
1154    let n_rows = body.rows.len() as u64;
1155
1156    // 列(0.4.1 五期 BD-UI-58,用户裁定):`resizable` **恒开**,两个理由绑在一起 ——
1157    // ① 列线:库只在 resizable 列上画那根可拖边界线(table.rs:740-749 登记 + 896 画线),
1158    //    这就是用户要的「竖向线显得整齐」;旧口径只有合约表 + 日志表 + 开了右键开关的
1159    //    成交表有列线,委托/持仓/资金/行情没有 → 形制不统一。
1160    // ② 列宽随内容生长:`finish` 的 grow-only 分支(table.rs:840-843)只对 resizable 列
1161    //    生效,旧口径非 resizable 的表列宽只在**首帧**量一次(首帧空态 → 列宽 = 表头
1162    //    文字宽,数据进来也不长;BD-UI-56 实测:成交表首帧空态列宽 [63.3, 28.4, 43.4,
1163    //    …] 喂进「螺纹钢2605 / 71230.5 / 142461.0」再跑三帧,一模一样)。这条缺陷跟着
1164    //    恒开一起修掉。右键菜单里那个「调整列宽」开关因此失去意义 → 一并退役。
1165    let mut delegate = PinDelegate {
1166        headers,
1167        sort,
1168        rows: &mut body.rows,
1169        row_h,
1170        clicked: None,
1171        header_drawn: vec![false; headers.len()],
1172        band_x: band.x_range(),
1173        // 行线吃 **line_soft**(0.8.2,参考站 `td{border-bottom:var(--st-line-soft)}`);
1174        // 表头带那根下边线仍然吃 `line`(参考站 `th{border-bottom:var(--st-line)}`)。
1175        line: ch.line_soft,
1176        band_mid: band.center().y,
1177    };
1178    // egui_table 的表 scope **不带 id_salt**:SplitScroll 内部 `ui.new_child()`
1179    // 的 ScrollArea auto-id 由父 ui 的 child 计数器派生 —— 2×2 各格的表(
1180    // order_grid 与 log_grid)实测滚出同一个 id(17412…5594)—— 滚动状态互相
1181    // 污染 → `ScrollArea::show_scroll` 每帧交替翻转 → request_repaint 死循环
1182    // (kittest max_steps 实锤,本轮 `[scrollflip]` 打点)。所以这里显式
1183    // scope 一层,把每张表的整个子 ui 树根挂在以 table_id 命名的盐上,
1184    // 滚动 id 与列宽状态各自独立。
1185    let _ret = ui.scope_builder(
1186        egui::UiBuilder::new()
1187            .id_salt(("pinned_table", table_id))
1188            // scope 的可用区必须从**当前 cursor** 起,不是从 max_rect 左上角:
1189            // `Table::show` 的 col_x / 表头行 y 都取 `ui.cursor().min`(table.rs:393-411),
1190            // 而上面那条表头带是按 cursor 画的 —— 用 `ui.max_rect()` 会让表画到
1191            // cursor **上方**去,带与表头行错开(0.4.1 实锤 s70:资金表头格 y 568..594,
1192            // 带却画在 y 597..632 = 差一整行)。
1193            .max_rect(egui::Rect::from_min_max(ui.cursor().min, ui.max_rect().max)),
1194        |ui| {
1195            // 列宽校准(BD-UI-58 立,BD-UI-60 补全):表宽 = 所在区域的 100%。
1196            // Python 侧交易表是 `resizeSections(ResizeToContents)`(widget.py:646)+ Qt
1197            // `stretchLastSection` 默认 True(全仓只有 portfoliomanager 的树控件显式关掉它)
1198            // → 列按内容量,剩余宽由**最后一列**吃掉,表宽恒等于视口宽;列总宽超过视口时
1199            // Qt 不压缩、出横向滚动条 —— 我们照这个口径,超宽不压。
1200            // 为什么必须**写进 `TableState`**而不是只传 `Column::new(w)`:库只在状态里
1201            // 没有这张表时才读 `column.current`(table.rs:370-375),而那一刻恰好就是首帧
1202            // ——首帧库给每列打上 `auto_size_this_frame`(table.rs:377-379),`finish` 于是
1203            // 走「按内容收缩」那一支(table.rs:837-839)把种子覆盖掉(0.4.1 五期实测:只传
1204            // 种子,空态右侧照样空 663 px)。先写状态,`TableState::load` 就不再是 None。
1205            // 只在「状态里的列宽总和还填不满可用宽」时动手:用户手动拖宽之后不再跟他抢。
1206            let state_id = egui_table::TableState::id(ui, egui::Id::new(table_id));
1207            // 目标宽要扣掉这张表自己的滚动条占位(`floating = false` 时 ScrollArea 会真的
1208            // 留出 bar_width + 内外边距):不扣就会把列总宽做到「比可视区还宽」,最后一列
1209            // 被推到视口外,egui_table 剔掉视口外的列 → 那一列上的撤单钮 / 时间格直接消失
1210            // (0.4.1 七期实撞:s11 撤单钮、s38 已摘除标注、w6 成交时间列同因)。
1211            let sc = &ui.style().spacing.scroll;
1212            let reserve = if sc.floating {
1213                0.0
1214            } else {
1215                sc.bar_width + sc.bar_inner_margin + sc.bar_outer_margin
1216            };
1217            let target = (ui.available_width() - reserve).max(0.0);
1218            // 补宽**一次只补一次**,不每帧补:库的 `finish` 把列宽写回成 `max(可视内容宽)`,
1219            // 被剔出视口的列写回的是它这一帧的量测宽 → 每帧补就「补宽 → 更挤 → 更多列被剔 →
1220            // 存宽更小 → 再补」滚起来(0.4.1 七期实撞:每帧补时 s11/s21/t3/f2/w6 同时丢格)。
1221            // 判据 = 「区域宽变了」或「存宽变了」(= 数据变了)才重新允许补一次;最后一列最多
1222            // 吃掉半张表,补不出无限宽的列。
1223            let fill_id = egui::Id::new(("table_fill", table_id));
1224            let (last_target, last_stored, filled) = ui.ctx().data(|d| {
1225                (
1226                    d.get_temp::<f32>(fill_id).unwrap_or(0.0),
1227                    d.get_temp::<f32>(fill_id.with("stored")).unwrap_or(0.0),
1228                    d.get_temp::<bool>(fill_id.with("filled")).unwrap_or(false),
1229                )
1230            });
1231            let mut st = egui_table::TableState::load(ui.ctx(), state_id).unwrap_or_default();
1232            let stored: f32 = st.col_widths.values().sum();
1233            let may_fill = !filled
1234                && ((target - last_target).abs() > 8.0 || (stored - last_stored).abs() > 0.5);
1235            let mut did_fill = false;
1236            let mut new_stored = stored;
1237            if col_current.is_none() && may_fill && stored < target {
1238                if stored <= 0.0 {
1239                    // 这一张表还没量过列宽。**只有空态**才在这里按表头比例下种子(BD-UI-58
1240                    // 口径);有数据时不写,让库在首帧做全量内容量测(`do_full_sizing_pass`)
1241                    // —— 提前下种子会把「时间」「接口」这类窄表头列压成 26 px,格内文字被
1242                    // 列宽裁掉(0.4.1 七期实撞:w6 成交时间列、s38 已摘除标注)。
1243                    if n_rows == 0 {
1244                        for (i, w) in header_proportional_widths(ui, headers, target)
1245                            .into_iter()
1246                            .enumerate()
1247                        {
1248                            st.col_widths.insert(egui::Id::new(i), w);
1249                        }
1250                        did_fill = true;
1251                    }
1252                } else {
1253                    // 已有列宽(按内容量过):剩余补给最后一列 = stretchLastSection 等价。
1254                    let last = egui::Id::new(headers.len() - 1);
1255                    let cur = st.col_widths.get(&last).copied().unwrap_or(24.0);
1256                    let add = (target - stored).min((target * 0.5 - cur).max(0.0));
1257                    if add > 0.5 {
1258                        st.col_widths.insert(last, cur + add);
1259                        did_fill = true;
1260                    }
1261                }
1262                if did_fill {
1263                    new_stored = st.col_widths.values().sum::<f32>();
1264                    st.store(ui.ctx(), state_id);
1265                }
1266            }
1267            ui.ctx().data_mut(|d| {
1268                d.insert_temp(fill_id, target);
1269                d.insert_temp(fill_id.with("stored"), new_stored);
1270                d.insert_temp(fill_id.with("filled"), did_fill || filled);
1271            });
1272            let seed: Option<Vec<f32>> = col_current;
1273            // 列线(0.4.1 七期 BD-UI-60,用户裁定「表格里所有的列分割线都去掉,只要行的分割线」):
1274            // 库里那根线撤不掉 —— 它只在**可拖列边界**上画(table.rs:738-749 登记 + 896 画线),
1275            // 而 `resizable` 必须恒开(列宽随内容生长靠它,BD-UI-56 那条缺陷就堵在这)。
1276            // 做法 = 把它的**常态**描边改成全透明 → 平时看不见;hover / 拖拽仍走
1277            // `widgets.hovered` / `widgets.active` 的描边 → 拖列宽时那根线亮出来(用户裁定保留)。
1278            // 只改这一支,不改 `BORDER` 本体:行线、表头带底边线、窗框都另有取色(行线取
1279            // delegate 里捕获的 `line`)。
1280            ui.style_mut().visuals.widgets.noninteractive.bg_stroke =
1281                egui::Stroke::new(1.0_f32, egui::Color32::TRANSPARENT);
1282            // 列宽从哪来(0.4.1 实查,库侧两条硬事实):
1283            // ① `Table::show` 只在**首帧**(`TableState::load` 为 None)做全量内容量测
1284            //    (`do_full_sizing_pass`,table.rs:365-379);
1285            // ② 量出来的宽度只有 **resizable 列**才会写回 `TableState` —— `finish`
1286            //    (table.rs:816-843)只遍历 `visible_column_lines`,而这两根线只在
1287            //    `column.resizable` 时登记(table.rs:614、table.rs:738-749)。
1288            // 0.4.1 五期(BD-UI-58)起 `resizable` 恒开:①②两条从此**每张表都吃到**
1289            // (列宽随内容生长 + 每列一根可拖列线),不再需要「首帧临时全标 resizable」
1290            // 那套补丁。起手宽 = 空态种子(按表头比例)或 100(库随后按内容量测覆盖)。
1291            let columns: Vec<egui_table::Column> = match &seed {
1292                Some(ws) => headers
1293                    .iter()
1294                    .zip(ws.iter().copied())
1295                    .enumerate()
1296                    .map(|(i, (_, w))| {
1297                        egui_table::Column::new(w)
1298                            .range(24.0..=f32::INFINITY)
1299                            .id(egui::Id::new(i))
1300                            .resizable(true)
1301                    })
1302                    .collect(),
1303                None => headers
1304                    .iter()
1305                    .enumerate()
1306                    .map(|(i, _)| {
1307                        egui_table::Column::new(100.0)
1308                            .range(24.0..=f32::INFINITY)
1309                            .id(egui::Id::new(i))
1310                            .resizable(true)
1311                    })
1312                    .collect(),
1313            };
1314            egui_table::Table::new()
1315                .id_salt(table_id)
1316                .num_rows(n_rows)
1317                .columns(columns)
1318                .headers([egui_table::HeaderRow::new(head_h)])
1319                .auto_size_mode(egui_table::AutoSizeMode::Never)
1320                .show(ui, &mut delegate);
1321        },
1322    );
1323    delegate.clicked
1324}
1325/// 为什么要这个:egui 的点击只发给**一个**响应 —— `context.rs:1384`
1326/// `let clicked = Some(id) == viewport.interact_widgets.clicked;` 比的是单个 Id,
1327/// 后加的控件优先。格里有真控件(钮 / 勾选框)时,点击归那个控件,归不到
1328/// `TableRow::col` 返回的「格响应」。所以行动作必须两边都看(0.2.29 实锤:
1329/// 只看格响应 → 行情首列钮、委托撤单钮、合约勾选框三处点击全丢)。
1330/// `pin_cell` 是 pub(crate)(kittest 判据要用),所以本 trait 也要 pub(crate)
1331/// (否则 clippy private-trait 警报)。
1332pub(crate) trait CellOutcome {
1333    fn response(&self) -> Option<egui::Response>;
1334}
1335
1336impl CellOutcome for egui::Response {
1337    fn response(&self) -> Option<egui::Response> {
1338        Some(self.clone())
1339    }
1340}
1341
1342impl CellOutcome for () {
1343    fn response(&self) -> Option<egui::Response> {
1344        None
1345    }
1346}
1347
1348impl<T: CellOutcome> CellOutcome for egui::InnerResponse<T> {
1349    fn response(&self) -> Option<egui::Response> {
1350        self.inner
1351            .response()
1352            .or_else(|| Some(self.response.clone()))
1353    }
1354}
1355
1356/// 喂表前的快照副本排序(W2 的判据对象)。`key` 返回**可比较字符串**;数字列调用方给
1357/// 零填充串(`{:020.4}`)保证字典序 == 数值序。`sort` 为 `None` = 原序,一行都不动。
1358fn sorted_rows<'a, T>(
1359    rows: &'a [T],
1360    sort: Option<(usize, bool)>,
1361    key: impl Fn(&T, usize) -> String,
1362) -> Vec<&'a T> {
1363    let mut out: Vec<&'a T> = rows.iter().collect();
1364    if let Some((col, asc)) = sort {
1365        out.sort_by(|a, b| {
1366            let (ka, kb) = (key(a, col), key(b, col));
1367            if asc { ka.cmp(&kb) } else { kb.cmp(&ka) }
1368        });
1369    }
1370    out
1371}
1372
1373/// 成交行的展示字符串(`TRADE_HEADERS` 同序)。**排序键与「保存数据」CSV 共用这一份口径** ——
1374/// 表里看见什么,导出来就是什么,不留第二套格式化。
1375/// 0.3.3 Wave F:这一份的顺序就是 `TRADE_HEADERS` 的顺序(判据 F1 钉「内容与表头同列」,
1376/// 两处不同序 = CSV 与屏幕不一致)。
1377fn trade_cells(t: &ek_data::trade::TradeData) -> Vec<String> {
1378    vec![
1379        t.symbol.clone(),
1380        if t.name.is_empty() {
1381            // 0.11.0 第5刀 R6:导出与屏幕同口径 —— 缺名兜底 = 代码
1382            t.symbol.clone()
1383        } else {
1384            t.name.clone()
1385        },
1386        t.exchange.as_str().to_string(),
1387        t.direction
1388            .map(|d| d.as_str().to_string())
1389            .unwrap_or_else(|| "-".to_string()),
1390        t.offset.as_str().to_string(),
1391        crate::format::price(t.price),
1392        crate::format::volume(t.volume),
1393        crate::format::price(t.traded_amount),
1394        crate::format::time_hms_millis(t.datetime),
1395        t.tradeid.clone(),
1396        t.orderid.clone(),
1397        t.gateway_name.clone(),
1398    ]
1399}
1400
1401/// 排序键:数字列给**零填充串**(`{:020.4}`)保证字典序 == 数值序;文本列直接比。
1402/// 注意不能直接拿 `trade_cells` 的显示串当排序键 —— "101" < "12.345" < "3.5" 是字典序,
1403/// 不是价格序(本轮实撞,判据 W1 当场红出来的)。
1404/// 列序 0.3.3 Wave F 跟着 `TRADE_HEADERS` 走:5 = 价格,6 = 数量,7 = 成交金额,8 = 时间。
1405fn trade_sort_key(t: &ek_data::trade::TradeData, col: usize) -> String {
1406    match col {
1407        5 => format!("{:020.4}", t.price),
1408        6 => format!("{:020.4}", t.volume),
1409        7 => format!("{:020.4}", t.traded_amount),
1410        8 => t.datetime.map(|ns| format!("{ns:025}")).unwrap_or_default(),
1411        c => trade_cells(t).get(c).cloned().unwrap_or_default(),
1412    }
1413}
1414
1415/// 「保存数据」:当前表(已按界面排序键排好的那份副本)写成 CSV 到 `target/ek-ui-<表>.csv`。
1416/// 只写界面看见的内容,不碰后端、不碰数据模型。
1417fn save_table_csv<T>(
1418    table: &str,
1419    headers: &[&str],
1420    rows: &[&T],
1421    cells: impl Fn(&T) -> Vec<String>,
1422) -> std::io::Result<()> {
1423    let mut s = headers.join(",");
1424    s.push('\n');
1425    for r in rows {
1426        s.push_str(&cells(r).join(","));
1427        s.push('\n');
1428    }
1429    let dir = std::env::current_dir()?.join("target");
1430    std::fs::create_dir_all(&dir)?;
1431    std::fs::write(dir.join(format!("ek-ui-{table}.csv")), s)
1432}
1433
1434// ================= 菜单栏 =================
1435
1436pub(crate) fn render_menu_bar(ui: &mut egui::Ui, shared: &UiShared) {
1437    ui.horizontal(|ui| {
1438        // ---- 0.9.34 模块区:一模块一项,点谁开谁 ----
1439        // 载体窗(运维 / 查询合约 / K线)与插件窗(交易网关 / 数据管理 / 交易中枢 / 天勤桥)
1440        // 走同一张挂载表 —— 菜单只有这一条代码路径,新增窗口 = 加一行 `MODULES`。
1441        shared.modules().menu(ui, shared);
1442        ui.separator();
1443        // 0.3.0(Wave C,BD-UI-48)→ 0.4.1(BD-UI-54):布局可复位 —— 一键回
1444        // Python 框架等价(分刀份额 50:50 + 三个 tab 态回缺省;行情带/下单侧两块
1445        // 顶层面板的记忆尺寸一并清掉 = 下帧回 default_height/default_width)。
1446        if ui.button("恢复布局").clicked() {
1447            shared.reset_layout();
1448            ui.ctx().data_mut(|d| {
1449                d.remove::<egui::containers::panel::PanelState>(egui::Id::new("market_band"));
1450                d.remove::<egui::containers::panel::PanelState>(egui::Id::new("order_side"));
1451            });
1452        }
1453        // **0.8.0 配色双档(BD-UI-61):两档切换钮 —— 裁定 8 的改判点。**
1454        // 0.2.30(裁定 8,BD-UI-46)删掉的是「五套主题一键循环」;0.4.1(BD-UI-57)
1455        // 把那一套定成 Nova 深色。本轮用户实看判词「这个配色特别刺眼睛」+ 指定参考站
1456        // 要「白色和黑色两款」→ 深色档重调 + 新增浅色档 + 菜单放**一颗**两档钮。
1457        // 标签 = **要去的那一档**(参考站「图标指向目标档」的语义,我们用中文,不引图标字体)。
1458        // 入口只有这一颗(参考站那两处是它的长设置页,我们的设置面就是菜单这一行)。
1459        // 0.9.36(用户裁定):**标签 = 当前档**,不加冒号、不写"要去的那档"。
1460        // 旧写法 `主题:深色` 表达的是"点了会变成深色"(目标档),用户看成"深色主题"
1461        // 会误解当前状态 —— 现在深色时显示「深色主题」,浅色时显示「浅色主题」,
1462        // 点一下切到另一档。图标/箭头都不用,就是一颗两态钮。
1463        let theme = shared.theme();
1464        let label = match theme {
1465            crate::tokens::Theme::Light => "浅色主题",
1466            crate::tokens::Theme::Dark => "深色主题",
1467        };
1468        if ui
1469            .button(label)
1470            .on_hover_text(format!(
1471                "当前{};点一下切到{}",
1472                label,
1473                match theme {
1474                    crate::tokens::Theme::Light => "深色主题",
1475                    crate::tokens::Theme::Dark => "浅色主题",
1476                }
1477            ))
1478            .clicked()
1479        {
1480            let next = shared.toggle_theme();
1481            ui.ctx().request_repaint();
1482            shared.log_line(format!(
1483                "[ui] 主题:{}(下一帧生效,已记 ui.theme)",
1484                match next {
1485                    crate::tokens::Theme::Light => "浅色",
1486                    crate::tokens::Theme::Dark => "深色",
1487                }
1488            ));
1489        }
1490        ui.menu_button(MENU_HELP, |ui| {
1491            ui.label(format!("ek-station 观测台 v{}", env!("CARGO_PKG_VERSION")));
1492            ui.label("布局 = Python 主窗框架等价(行情带/交易带/弹窗)");
1493            ui.label("配色 = 深/浅两档(缺省深色);菜单那颗钮显示**当前**档(深色主题/浅色主题),点一下切另一档,存 ui.theme");
1494        });
1495    });
1496}
1497
1498// ================= 行情格 =================
1499
1500/// 行情表头(16 列,与 `tick_sort_key` 同序;成交额/持仓量 2026-10-28 按对照
1501/// python 期货指数行情窗补列 —— `TickData.turnover/open_interest` 已有,纯显示层)。
1502const TICK_HEADERS: [&str; 16] = [
1503    "代码",
1504    "名称",
1505    "最新价",
1506    "涨跌幅",
1507    "成交量",
1508    "成交额",
1509    "持仓量",
1510    "今开",
1511    "最高",
1512    "最低",
1513    "买1价",
1514    "买1量",
1515    "卖1价",
1516    "卖1量",
1517    "时间",
1518    "行情源",
1519];
1520
1521/// 行情格:一个交易所一格(0.4.0)。组内那条「按所二级 tab」条已撤除 —— 所的身份由
1522/// dock tab 承担(该格只画本所的行;哪一所在前台由 dock 树记)。
1523pub(crate) fn render_market_pane(
1524    ui: &mut egui::Ui,
1525    shared: &UiShared,
1526    ex: ek_data::constant::Exchange,
1527) {
1528    // 表状态按格分开:6 个所的行情格各有各的排序与列宽(同一个 id 会被 egui 当重复)。
1529    let table_id = format!("tick_{}", ex.as_str());
1530    let groups = shared.tick_groups();
1531    let ticks: Vec<ek_data::tick::TickData> = groups
1532        .iter()
1533        .find(|(e, _)| e == ex.as_str())
1534        .map(|(_, v)| v.clone())
1535        .unwrap_or_default();
1536    // 空态口径(0.4.1 五期 BD-UI-58 + 六期 BD-UI-59 两次裁定合起来):表头恒在(s73 钉),但**不画那一行
1537    // 「(无数据)」提示** —— 表体就是空的,用户看得见;列宽这一拍按表头比例填满(s74 钉)。
1538    // 「这一拍没有数据行」由 `pinned_table_impl_cols` 现场数 `n_rows == 0` 判定,
1539    // 调用方不再分支:空与非空走同一条路,body 收出 0 行就是空表。
1540    // (0.4.0 那条「空态不得吞掉表头」的修正仍然成立:这里原来直接 `muted_label + return`,
1541    // 整张表含表头都不画,六个行情格在没有订阅时全是光秃秃一句提示。Python 也是空表照画表头。)
1542    // 0.3.3(收 Wave D 欠账):行情格也吃「点表头排序」(缺省序 = 按所/symbol)。
1543    let sort = shared.table_sort(&table_id);
1544    let ticks = sorted_rows(&ticks, sort, tick_sort_key);
1545    let clicked = pinned_table_sorted(ui, &table_id, &TICK_HEADERS, sort, |body, row_h| {
1546        for t in &ticks {
1547            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 带入下单面板
1548            // (盘口四列带方向:买1价/买1量 → 卖,卖1价/卖1量 → 买,价格列
1549            // 顺带填价;其余列方向/价格保持默认——用户裁定);任何一格双击
1550            // = 弹 K线窗。选中行 = 下单面板当前合约(带入即跳色)。
1551            let row_sel = shared.order_form().symbol == t.symbol;
1552            body.row(row_h, row_sel, |r| {
1553                // 延迟画笔(BD-UI-55):格内容在体表真实绘制时跑;点击/双击与
1554                // 行动作的判定照旧在「格响应 || 控件响应」两边看,BD-UI-55 实查:
1555                // egui_table 每帧只跑一遍(不用 auto_size_this_frame,那会双跑)。
1556                // 闭包不 move(借用 shared / t / key —— 它们都是外层的只读局部,
1557                // 出不了 pinned_table_impl 的调用帧,借给 'b 完全合法)。
1558                macro_rules! cell {
1559                    ($make:expr, $col:expr) => {{
1560                        r.cell(|ui, ctx| {
1561                            let (cell_r, inner_r) = pin_cell(ui, ctx, $make);
1562                            let hit =
1563                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
1564                            if hit {
1565                                // import_tick(用户裁定:0.4.1 行单击不再切交易所 ——
1566                                // 本格已是该所;这里只把合约带进下单面板)。
1567                                import_tick(shared, t, ex.as_str(), $col);
1568                            }
1569                            let dbl = cell_r.double_clicked()
1570                                || inner_r.as_ref().is_some_and(|r| r.double_clicked());
1571                            if dbl {
1572                                shared.open_kline(t.symbol.clone());
1573                            }
1574                        });
1575                    }};
1576                }
1577                cell!(|ui| ui.button(t.symbol.clone()), 0);
1578                cell!(
1579                    |ui| ui.label(if t.name.is_empty() {
1580                        // 0.11.0 第5刀 R6:名称兜底 = 代码(不是「-」;行永不因缺名被丢)
1581                        t.symbol.clone()
1582                    } else {
1583                        t.name.clone()
1584                    }),
1585                    1
1586                );
1587                cell!(
1588                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.last_price))),
1589                    2
1590                );
1591                cell!(
1592                    |ui| ui.label(
1593                        crate::tokens::num_text(crate::format::pct(t.pct_change))
1594                            .color(crate::tokens::rise_fall(ui.ctx(), t.pct_change)),
1595                    ),
1596                    3
1597                );
1598                cell!(
1599                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(t.volume))),
1600                    4
1601                );
1602                cell!(
1603                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.turnover))),
1604                    5
1605                );
1606                cell!(
1607                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(
1608                        t.open_interest
1609                    ))),
1610                    6
1611                );
1612                cell!(
1613                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.open_price))),
1614                    7
1615                );
1616                cell!(
1617                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.high_price))),
1618                    8
1619                );
1620                cell!(
1621                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.low_price))),
1622                    9
1623                );
1624                cell!(
1625                    |ui| ui.label(
1626                        crate::tokens::num_text(crate::format::price(t.bid_price_1))
1627                            .color(crate::tokens::rise(ui.ctx())),
1628                    ),
1629                    10
1630                );
1631                cell!(
1632                    |ui| ui.label(
1633                        crate::tokens::num_text(crate::format::volume(t.bid_volume_1))
1634                            .color(crate::tokens::rise(ui.ctx())),
1635                    ),
1636                    11
1637                );
1638                cell!(
1639                    |ui| ui.label(
1640                        crate::tokens::num_text(crate::format::price(t.ask_price_1))
1641                            .color(crate::tokens::fall(ui.ctx())),
1642                    ),
1643                    12
1644                );
1645                cell!(
1646                    |ui| ui.label(
1647                        egui::RichText::new(crate::format::volume(t.ask_volume_1))
1648                            .color(crate::tokens::fall(ui.ctx())),
1649                    ),
1650                    13
1651                );
1652                cell!(
1653                    |ui| ui.label(if t.update_time.is_empty() {
1654                        crate::format::time_hms_millis(Some(t.datetime))
1655                    } else {
1656                        t.update_time.clone()
1657                    }),
1658                    14
1659                );
1660                cell!(|ui| ui.label(t.gateway_name.clone()), 15);
1661            });
1662        }
1663    });
1664    if let Some(col) = clicked {
1665        shared.toggle_table_sort(&table_id, col);
1666    }
1667}
1668
1669/// 行情行的排序键(列序 == 行情带 16 列):数字列零填充,时间列纳秒零填充。
1670fn tick_sort_key(t: &ek_data::tick::TickData, col: usize) -> String {
1671    match col {
1672        0 => t.symbol.clone(),
1673        1 => t.name.clone(),
1674        2 => format!("{:020.4}", t.last_price),
1675        3 => format!("{:020.4}", t.pct_change),
1676        4 => format!("{:020.4}", t.volume),
1677        5 => format!("{:020.4}", t.turnover),
1678        6 => format!("{:020.4}", t.open_interest),
1679        7 => format!("{:020.4}", t.open_price),
1680        8 => format!("{:020.4}", t.high_price),
1681        9 => format!("{:020.4}", t.low_price),
1682        10 => format!("{:020.4}", t.bid_price_1),
1683        11 => format!("{:020.4}", t.bid_volume_1),
1684        12 => format!("{:020.4}", t.ask_price_1),
1685        13 => format!("{:020.4}", t.ask_volume_1),
1686        14 => {
1687            if t.update_time.is_empty() {
1688                format!("{:025}", t.datetime)
1689            } else {
1690                t.update_time.clone()
1691            }
1692        }
1693        15 => t.gateway_name.clone(),
1694        _ => String::new(),
1695    }
1696}
1697
1698// ================= 下单面板(常驻;0.4.1 BD-UI-54 回原生 SidePanel) =================
1699
1700fn render_order_panel(ui: &mut egui::Ui, shared: &UiShared) {
1701    // BD-UI-31(R4):面板题字撤除(下单侧栏即身份)。
1702    let mut f = shared.order_form();
1703    let before = f.clone();
1704    let mut err: Option<String> = None;
1705
1706    // 随价勾选:价格框随该合约最新 tick(勾选态)
1707    if f.follow_price
1708        && let Some(t) = tick_of(shared, &f.exchange, &f.symbol)
1709        && t.last_price > 0.0
1710    {
1711        f.price = crate::format::price(t.last_price);
1712    }
1713
1714    // 交易所下拉:有 tick 的所 ∪ 六家常用所(操作面默认,不是配置面)
1715    let mut ex_opts: Vec<String> = shared
1716        .tick_groups()
1717        .iter()
1718        .map(|(e, _)| e.clone())
1719        .collect();
1720    for e in ["SHFE", "DCE", "CZCE", "CFFEX", "INE", "GFEX"] {
1721        if !ex_opts.iter().any(|x| x == e) {
1722            ex_opts.push(e.to_string());
1723        }
1724    }
1725    if !ex_opts.contains(&f.exchange) {
1726        ex_opts.insert(0, f.exchange.clone());
1727    }
1728    // 接口下拉:账户清册(注册序)∪ trade_snap 网关去重集(B3 退役:
1729    // 不再硬编码 `["ctp"]`;0.2.10 BD-UI-38 sim 纸面网关退场同口径)。
1730    let ts = shared.trade_snap();
1731    let mut gw_opts: Vec<String> = Vec::new();
1732    // 0.2.18(规划 Q4):下单归属只列**已装配**账户 —— 只添加了还没连接的账户
1733    // 进了下拉,选它下单只会撞 `unknown:gateway`。
1734    // 账本侧历史网关名的口径(执行核查补的洞):清册非空时,**不在清册的历史网关
1735    // = 已摘除账户**,它留在下拉里同样是选它下单撞 `unknown:gateway` → 不进下拉
1736    // (撤单不受影响:撤单归属按每笔单自己的网关走,与这里的下拉无关)。
1737    // 清册为空 = 不干预(纯账本巡回钉 s27/s14 那类无账户配置面的形)。
1738    let known_gws = account_gateways(shared);
1739    for g in shared
1740        .accounts()
1741        .iter()
1742        .filter(|a| a.connected)
1743        .map(|a| a.gateway.clone())
1744        .chain(
1745            ts.orders
1746                .iter()
1747                .map(|o| o.gateway_name.clone())
1748                .chain(ts.trades.iter().map(|t| t.gateway_name.clone()))
1749                .chain(ts.accounts.iter().map(|a| a.gateway_name.clone()))
1750                .filter(|g| known_gws.is_empty() || known_gws.contains(g)),
1751        )
1752    {
1753        if !g.is_empty() && !gw_opts.contains(&g) {
1754            gw_opts.push(g);
1755        }
1756    }
1757    if !gw_opts.contains(&f.gateway)
1758        && !f.gateway.is_empty()
1759        && (known_gws.is_empty() || known_gws.contains(&f.gateway))
1760    {
1761        gw_opts.insert(0, f.gateway.clone());
1762    }
1763    // 手动选过的网关若已不在可选面(被摘除 / 未装配)= 就地回落到默认阶梯:
1764    // 否则下拉里挂着一个注定 `unknown:gateway` 的选项,且它会成为下一笔单的归属。
1765    if !f.gateway.is_empty() && !gw_opts.contains(&f.gateway) {
1766        f.gateway = shared.default_gateway().unwrap_or_default();
1767    }
1768    // 表单网关位为空 = 未手动选过:回填默认账户阶梯(上次选择 → 首个已连接 → 首个)。
1769    // 只改本地 `f` 副本 —— 面板末尾的 `f != before` 写回负责落盘,不在这里重复写。
1770    if f.gateway.is_empty()
1771        && let Some(def) = shared.default_gateway()
1772    {
1773        f.gateway = def;
1774    }
1775    let no_accounts = gw_opts.is_empty();
1776
1777    // 表单网格(Python TradingWidget 字段排;委托/全撤 = 网格行;
1778    // 网格后不挂面板内容 —— 帧内 sizing 退让会把后置行叠回网格,盘口独立帧)。
1779    egui::Grid::new("order_form_grid")
1780        .num_columns(2)
1781        .show(ui, |ui| {
1782            ui.label("交易所");
1783            egui::ComboBox::from_id_salt("of_exchange")
1784                .selected_text(f.exchange.clone())
1785                .show_ui(ui, |ui| {
1786                    for e in &ex_opts {
1787                        ui.selectable_value(&mut f.exchange, e.clone(), e.clone());
1788                    }
1789                });
1790            ui.end_row();
1791            ui.label("代码");
1792            let sym_resp = ui.add(
1793                egui::TextEdit::singleline(&mut f.symbol)
1794                    .hint_text("cu2709")
1795                    .desired_width(150.0),
1796            );
1797            // 代码回车 = 订阅(Python TradingWidget returnPressed → set_en_symbol 等价)。
1798            // egui 单行 TextEdit 遇 Enter 即 surrender_focus,has_focus 在检查时已
1799            // false —— 规范口径 lost_focus + key_pressed(第五轮审计钉:s20 实测
1800            // has_focus 口径回车订阅从不触发)。
1801            if sym_resp.lost_focus() && ui.input(|i| i.key_pressed(egui::Key::Enter)) {
1802                let s = f.symbol.trim().to_string();
1803                // 与查询合约窗同口径:输入带 EX. 前缀则剥成裸代码(ctp.subscribe
1804                // 收裸码);剥后回写表单,名称/盘口/随价的 tick 查找同步可用。
1805                // 归一化交给网关侧实现(`ek_ctp::map::instrument_id`):界面前后两份
1806                // "剥 EX. 前缀"就是重复;手剥还会把 `XX.ag2612` 这种未知前缀悄悄剥成合法码。
1807                let bare = ek_ctp::map::instrument_id(&s).unwrap_or_default();
1808                if bare.is_empty() && !s.is_empty() {
1809                    shared.log_line(format!("[订阅] 合约代码无法归一(交易所前缀未知):{s}"));
1810                }
1811                if !bare.is_empty() {
1812                    f.symbol = bare.clone();
1813                    // 订阅一律路由到行情元账号(规划 §5.C:单源;从账号无 MD 会话,
1814                    // 发给它只会静默成功 = 观测黑洞,所以路由在界面侧定死)。
1815                    match subscribe_target(shared) {
1816                        Ok(gw) => {
1817                            shared.push_cmd(UiCmd::CtpSubscribe {
1818                                gateway: gw.clone(),
1819                                symbols: vec![bare.clone()],
1820                            });
1821                            shared
1822                                .log_line(format!("[ops] 订阅已入列 {bare} → {gw}(代码回车订阅)"));
1823                        }
1824                        Err(e) => shared.log_line(format!("[订阅] {e}")),
1825                    }
1826                }
1827            }
1828            ui.end_row();
1829            ui.label("名称");
1830            ui.label(
1831                tick_of(shared, &f.exchange, &f.symbol)
1832                    .map(|t| {
1833                        if t.name.is_empty() {
1834                            // 0.11.0 第5刀 R6:缺名兜底 = 代码
1835                            t.symbol.clone()
1836                        } else {
1837                            t.name
1838                        }
1839                    })
1840                    .unwrap_or_else(|| "无行情".to_string()),
1841            );
1842            ui.end_row();
1843            ui.label("方向");
1844            egui::ComboBox::from_id_salt("of_direction")
1845                .selected_text(f.direction.as_str())
1846                .show_ui(ui, |ui| {
1847                    for d in [Direction::LONG, Direction::SHORT] {
1848                        ui.selectable_value(&mut f.direction, d, d.as_str());
1849                    }
1850                });
1851            ui.end_row();
1852            ui.label("开平");
1853            ui.horizontal(|ui| {
1854                egui::ComboBox::from_id_salt("of_offset")
1855                    .selected_text(f.offset.as_str())
1856                    .show_ui(ui, |ui| {
1857                        for o in [
1858                            Offset::OPEN,
1859                            Offset::CLOSE,
1860                            Offset::CLOSETODAY,
1861                            Offset::CLOSEYESTERDAY,
1862                        ] {
1863                            ui.selectable_value(&mut f.offset, o, o.as_str());
1864                        }
1865                    });
1866                // 0.1.1 BD-UI-30:自动开平勾选(开 = Auto 走拆单器;关 = None 原样)。
1867                ui.checkbox(&mut f.auto_split, "自动开平");
1868            });
1869            ui.end_row();
1870            ui.label("类型");
1871            egui::ComboBox::from_id_salt("of_order_type")
1872                .selected_text(f.order_type.as_str())
1873                .show_ui(ui, |ui| {
1874                    for ot in [OrderType::LIMIT, OrderType::MARKET] {
1875                        ui.selectable_value(&mut f.order_type, ot, ot.as_str());
1876                    }
1877                });
1878            ui.end_row();
1879            ui.label("价格");
1880            ui.horizontal(|ui| {
1881                ui.add(
1882                    egui::TextEdit::singleline(&mut f.price)
1883                        .hint_text("107660")
1884                        .desired_width(90.0),
1885                );
1886                ui.checkbox(&mut f.follow_price, "随价");
1887            });
1888            ui.end_row();
1889            ui.label("数量");
1890            ui.add(
1891                egui::TextEdit::singleline(&mut f.volume)
1892                    .hint_text("1")
1893                    .desired_width(90.0),
1894            );
1895            ui.end_row();
1896            ui.label("接口");
1897            egui::ComboBox::from_id_salt("of_gateway")
1898                .selected_text(if f.gateway.is_empty() {
1899                    "(未选账户)".to_string()
1900                } else {
1901                    f.gateway.clone()
1902                })
1903                .show_ui(ui, |ui| {
1904                    for g in &gw_opts {
1905                        ui.selectable_value(&mut f.gateway, g.clone(), g.clone());
1906                    }
1907                });
1908            ui.end_row();
1909            ui.label("操作");
1910            ui.horizontal(|ui| {
1911                // 无账户 = 无网关可下单(旧「空 → 字面量 ctp」兜底已退役,B4)。
1912                let send = ui
1913                    .add_enabled_ui(!no_accounts, |ui| {
1914                        crate::ui_ext::primary_button(ui, BTN_SEND_ORDER)
1915                    })
1916                    .inner
1917                    .clicked();
1918                if send {
1919                    match f.to_request() {
1920                        Ok(req) => {
1921                            let fallback = shared.default_gateway();
1922                            match crate::state::parse_gateway(&f.gateway, fallback.as_deref()) {
1923                                Ok(gateway) => {
1924                                    shared.push_cmd(UiCmd::SendOrder {
1925                                        req,
1926                                        gateway,
1927                                        mode: if f.auto_split {
1928                                            ek_oms::LockMode::Auto
1929                                        } else {
1930                                            ek_oms::LockMode::None
1931                                        },
1932                                    });
1933                                    shared.log_line("[ops] 下单请求已入列(等 eTimer 请辞)");
1934                                }
1935                                Err(e) => {
1936                                    shared.log_line(format!("[下单] {e}"));
1937                                    err = Some(e);
1938                                }
1939                            }
1940                        }
1941                        Err(e) => {
1942                            shared.log_line(format!("[下单] {e}"));
1943                            err = Some(e);
1944                        }
1945                    }
1946                }
1947                if ui.button(BTN_CANCEL_ALL).clicked() {
1948                    // 全撤 = 活动委托逐个走 oms.cancel_order(界面侧扇出;
1949                    // 守卫逐单计数在 oms,不可绕过——0.1.1 BD-UI-30)
1950                    let mut n = 0usize;
1951                    for o in ts.orders.iter().filter(|o| order_active(o.status)) {
1952                        // 撤单跟着**这笔单自己的网关**走(多账号面:不再回落 ctp)。
1953                        let gw = if !o.gateway_name.is_empty() {
1954                            o.gateway_name.clone()
1955                        } else {
1956                            shared.default_gateway().unwrap_or_default()
1957                        };
1958                        if gw.is_empty() {
1959                            continue;
1960                        }
1961                        shared.push_cmd(UiCmd::CancelOrder {
1962                            orderid: o.orderid.clone(),
1963                            gateway: gw,
1964                        });
1965                        n += 1;
1966                    }
1967                    shared.log_line(format!("[ops] 全撤入列 {n} 笔(等 eTimer 请辞)"));
1968                }
1969            });
1970            ui.end_row();
1971            crate::ui_ext::muted_label(ui, "代码回车 = 订阅");
1972            ui.label("");
1973            ui.end_row();
1974        });
1975    if let Some(e) = err {
1976        ui.label(egui::RichText::new(e).color(crate::tokens::error(ui.ctx())));
1977    }
1978    if no_accounts {
1979        // 侧栏底部独立行(不落钮行内:会把「全撤」推出侧栏宽域,s3 结构钉)。
1980        ui.label(
1981            egui::RichText::new("无账户:先在「账户」面板添加账户(委托钮已禁用)")
1982                .color(crate::tokens::warn(ui.ctx())),
1983        );
1984    }
1985    if f != before {
1986        shared.set_order_form(f.clone());
1987    }
1988}
1989
1990/// 盘口帧(选中合约 tick 五档;Python 买5卖5 等价;独立帧避网格叠行)。
1991/// BD-UI-31(R4):题字撤除(含括号合约代码——选中合约已由下单面板代码格与
1992/// 行情带跳色行指认,盘口帧不重复报幕)。
1993/// 盘口买 / 卖侧色(0.8.0:走当前档的访问器,浅档才会跟档 —— 旧口径是 `const`,
1994/// const 拿不到 `Context`,直用深档常量 = 浅色档下这两支不跟档)。
1995/// 卖 = 跌绿,买 = 涨红(hue 恒定,明度跟档,判据 `u11`)。
1996fn book_ask_color(ctx: &egui::Context) -> egui::Color32 {
1997    crate::tokens::fall(ctx)
1998}
1999fn book_bid_color(ctx: &egui::Context) -> egui::Color32 {
2000    crate::tokens::rise(ctx)
2001}
2002
2003/// 盘口一行 = 三格:档位标签 / 价 / 量(BD-UI-55:egui_extras 退役,盘口换
2004/// `egui::Grid` 三列 —— 它只是一块自适应小表,没有表头/粘顶/角色,够不上
2005/// egui_table 的 delegate 拉动化)。
2006/// **0.8.0 对齐统一(裁定 D):价与量不再右对齐** —— 与档位标签同一左沿,数字走
2007/// `tokens::num_text`(等宽)。这一块的数字仍成列,靠的是等宽不是贴右(毛病 6
2008/// 「盘口贴左缘」由三列小表解决,右对齐退役后由等宽接着守)。
2009fn book_row(row: &mut egui::Ui, tag: String, color: egui::Color32, price: f64, volume: f64) {
2010    row.label(egui::RichText::new(tag).color(color));
2011    row.label(crate::tokens::num_text(crate::format::price(price)).color(color));
2012    row.label(crate::tokens::num_text(crate::format::volume(volume)).color(color));
2013}
2014
2015fn render_book_frame(ui: &mut egui::Ui, shared: &UiShared) {
2016    let f = shared.order_form();
2017    let Some(t) = tick_of(shared, &f.exchange, &f.symbol) else {
2018        crate::ui_ext::muted_label(ui, "(无 tick)");
2019        return;
2020    };
2021    // 0.2.29 Wave A 尾巴(BD-UI-45,毛病 6 的本体):五档盘口原来是一支文本
2022    // `ui.label("卖5  101.5  3")` —— 价与量靠**空格**对齐,位数一变(101.5 → 12345.5)
2023    // 整块就错位、贴左缘。换成三列小表(档 / 价 / 量),价与量右对齐成列。
2024    // 这里**不**用 `pinned_table`:下单侧是窄列 + 外层已有 ScrollArea,`pinned_table`
2025    // 的 `auto_shrink([false, false])` 会吃满整块可用高(0.2.17 s39 那条教训同型)。
2026    // 表头也不加:Python 侧没有五档盘口这个块(只有行情表的买1价/买1量/卖1价/卖1量
2027    // 四列),这是我们自加的常驻盘口,保持无表头。
2028    let (_, _head_h) = table_heights(ui);
2029    let asks: [(f64, f64); 5] = [
2030        (t.ask_price_5, t.ask_volume_5),
2031        (t.ask_price_4, t.ask_volume_4),
2032        (t.ask_price_3, t.ask_volume_3),
2033        (t.ask_price_2, t.ask_volume_2),
2034        (t.ask_price_1, t.ask_volume_1),
2035    ];
2036    let bids: [(f64, f64); 5] = [
2037        (t.bid_price_1, t.bid_volume_1),
2038        (t.bid_price_2, t.bid_volume_2),
2039        (t.bid_price_3, t.bid_volume_3),
2040        (t.bid_price_4, t.bid_volume_4),
2041        (t.bid_price_5, t.bid_volume_5),
2042    ];
2043    // 取色**提到 Grid 之前**(0.8.0):`book_ask_color` 要读 `ui.ctx()`,在 `show` 的闭包里
2044    // 读会和 `grid` 的可变借用撞(E0502);一帧里档不会变,取两次就够。
2045    let ask_color = book_ask_color(ui.ctx());
2046    let bid_color = book_bid_color(ui.ctx());
2047    // `num_columns` 会让**最后一列吃掉父 ui 剩下的宽度**(egui grid.rs:144-154 +
2048    // Grid::num_columns 的注释)→ 「量」贴到面板右缘,价与量之间空出一大截。旧口径是
2049    // TableBuilder 三列 `Column::auto()`(列宽 = 内容)→ 这里不给列数,列宽回到内容驱动
2050    // (0.4.1 实锤 t8:十行里只有 3 个量格还在 x<280 的盘口块里)。
2051    egui::Grid::new("book_grid")
2052        .spacing([4.0, 0.0])
2053        .show(ui, |grid| {
2054            for (k, (p, v)) in asks.iter().enumerate() {
2055                book_row(grid, format!("卖{}", 5 - k), ask_color, *p, *v);
2056                grid.end_row();
2057            }
2058            for (k, (p, v)) in bids.iter().enumerate() {
2059                book_row(grid, format!("买{}", k + 1), bid_color, *p, *v);
2060                grid.end_row();
2061            }
2062        });
2063}
2064
2065// ================= 数据格(2×2;0.4.1 回原生:tab 条在 render_topleft_group 等) =================
2066
2067/// 委托表(17 列逐值 = Python OrderMonitor 蓝图:代码/名称/交易所/类型/方向/
2068/// 开平/价格/总量/已成/成交均价/状态/状态描述/时间/委托号/来源/接口 + 操作;
2069/// 活动行撤单钮 + 双击撤单,终态行只读)。
2070fn render_orders_table(ui: &mut egui::Ui, shared: &UiShared, active_only: bool) {
2071    let ts = shared.trade_snap();
2072    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
2073    let known_gws = account_gateways(shared);
2074    // 表题撤除(第五轮审计):格身份就是 dock tab,再挂同名 label = 三重撞名
2075    // (下单钮/tab/表题),纯冗余。
2076    let rows: Vec<_> = ts
2077        .orders
2078        .iter()
2079        .filter(|o| !active_only || order_active(o.status))
2080        .collect();
2081    // 委托表列头单源(空/非空两分支同源,0.2.7 审计口径)。
2082    // 16 列(2026-10-28 用户裁定:删「操作」撤单钮列 —— 撤单走行双击与全撤,
2083    // Python OrderMonitor 同口径;列序照 Python 16 列蓝图)。
2084    const ORDER_HEADERS: [&str; 16] = [
2085        "代码",
2086        "名称",
2087        "交易所",
2088        "类型",
2089        "方向",
2090        "开平",
2091        "价格",
2092        "总量",
2093        "已成",
2094        "成交均价",
2095        "状态",
2096        "状态描述",
2097        "时间",
2098        "委托号",
2099        "来源",
2100        "接口",
2101    ];
2102    // 0.3.3(收 Wave D 欠账):委托表也吃「点表头排序」—— 表 id 先算出来,
2103    // 空态与非空态共用一份(排序键住在 UiShared,按表 id 分槽)。
2104    let table_id = if active_only {
2105        "active_grid"
2106    } else {
2107        "order_grid"
2108    };
2109    let sort = shared.table_sort(table_id);
2110    // 空态不再分支、不再画提示行(0.4.1 六期 BD-UI-59):body 收出 0 行 = 空表,
2111    // 列宽由 `pinned_table_impl_cols` 按表头比例填满。
2112    // 排序只作用在「喂表前的快照副本」上(W2 口径,数据模型不被界面排序改写)。
2113    let rows = sorted_rows(&rows, sort, |o, col| order_sort_key(o, col));
2114    let clicked = pinned_table_sorted(ui, table_id, &ORDER_HEADERS, sort, |body, row_h| {
2115        // move 格闭包要把这几样所有权收进去 —— 预先用引用整形(move 闭包拷贝引用,
2116        // 不搬 Vec;known_gws/rows 都活到调用帧外,E0382/E0505 实撞)。
2117        let known_gws = &known_gws;
2118        for o in &rows {
2119            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
2120            // 任何一格双击 = 撤单(Python OrderMonitor itemDoubleClicked→
2121            // cancel_order 等价,活动行限定;显式撤单钮同令并存)。
2122            let key = format!("{}.{}", o.gateway_name, o.orderid);
2123            let row_sel = shared.row_selected("orders", &key);
2124            body.row(row_h, row_sel, |r| {
2125                macro_rules! cell {
2126                    ($make:expr, $col:expr) => {{
2127                        // key 是**行内局部**:格延迟画笔要活到 show,必须自带 key 的
2128                        // 所有权(每格一份克隆;借用会随 add_body 帧悬空,E0373 实撞)。
2129                        let key = key.clone();
2130                        r.cell(move |ui, ctx| {
2131                            let (cell_r, inner_r) =
2132                                pin_cell(ui, ctx, $make);
2133                            let hit =
2134                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
2135                            if hit {
2136                                shared.select_row("orders", &key);
2137                            }
2138                            let dbl = cell_r.double_clicked()
2139                                || inner_r.as_ref().is_some_and(|r| r.double_clicked());
2140                            if dbl && order_active(o.status) {
2141                                // 双击撤单同按钮口径:跟着这笔单自己的网关(空串回落默认账户阶梯)。
2142                                let gw = if !o.gateway_name.is_empty() {
2143                                    o.gateway_name.clone()
2144                                } else {
2145                                    shared.default_gateway().unwrap_or_default()
2146                                };
2147                                if !gw.is_empty() {
2148                                    shared.push_cmd(UiCmd::CancelOrder {
2149                                        orderid: o.orderid.clone(),
2150                                        gateway: gw,
2151                                    });
2152                                }
2153                            }
2154                        });
2155                    }};
2156                }
2157                cell!(|ui| ui.label(o.symbol.clone()), 0);
2158                cell!(
2159                    |ui| ui.label(if o.name.is_empty() {
2160                        // 0.11.0 第5刀 R6:名称兜底 = 代码(不是「-」;行永不因缺名被丢)
2161                        o.symbol.clone()
2162                    } else {
2163                        o.name.clone()
2164                    }),
2165                    1
2166                );
2167                cell!(|ui| ui.label(o.exchange.as_str().to_string()), 2);
2168                cell!(|ui| ui.label(o.order_type.as_str().to_string()), 3);
2169                cell!(
2170                    |ui| ui.label(
2171                        egui::RichText::new(o.direction.map(|d| d.as_str()).unwrap_or("-")).color(
2172                            if o.direction == Some(Direction::SHORT) {
2173                                crate::tokens::fall(ui.ctx())
2174                            } else {
2175                                crate::tokens::rise(ui.ctx())
2176                            },
2177                        ),
2178                    ),
2179                    4
2180                );
2181                cell!(|ui| ui.label(o.offset.as_str().to_string()), 5);
2182                cell!(
2183                    |ui| ui.label(crate::tokens::num_text(crate::format::price(o.price))),
2184                    6
2185                );
2186                cell!(
2187                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(o.volume))),
2188                    7
2189                );
2190                cell!(
2191                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(o.traded))),
2192                    8
2193                );
2194                cell!(
2195                    |ui| ui.label(crate::tokens::num_text(crate::format::price(
2196                        o.traded_price
2197                    ))),
2198                    9
2199                );
2200                cell!(
2201                    |ui| ui.label(egui::RichText::new(o.status.as_str()).color(
2202                        if o.status == ek_data::constant::Status::REJECTED {
2203                            crate::tokens::rise(ui.ctx())
2204                        } else if o.status == ek_data::constant::Status::ALLTRADED {
2205                            crate::tokens::fall(ui.ctx())
2206                        } else {
2207                            crate::tokens::warn(ui.ctx())
2208                        },
2209                    )),
2210                    10
2211                );
2212                cell!(|ui| ui.label(o.status_msg.clone()), 11);
2213                cell!(
2214                    |ui| ui.label(crate::format::time_hms_millis(o.datetime)),
2215                    12
2216                );
2217                cell!(|ui| ui.label(o.orderid.clone()), 13);
2218                cell!(
2219                    |ui| ui.label(if o.reference.is_empty() {
2220                        "-".to_string()
2221                    } else {
2222                        o.reference.clone()
2223                    }),
2224                    14
2225                );
2226                cell!(
2227                    |ui| ui.label(ledger_gw_label(&o.gateway_name, known_gws)),
2228                    15
2229                );
2230                // 2026-10-28 用户裁定:原 17 列的「操作」撤单钮列删除。行内撤单 = 双击
2231                // (本行下面那支响应,Python OrderMonitor itemDoubleClicked 等价),
2232                // 下单面板「全撤」与账户窗「先撤 N 笔」走同一 oms 通道,撤单能力不减档。
2233            });
2234        }
2235    });
2236    if let Some(col) = clicked {
2237        shared.toggle_table_sort(table_id, col);
2238    }
2239}
2240
2241/// 委托行的排序键(列序 == `ORDER_HEADERS`):数字列给零填充串保证字典序 == 数值序
2242/// (`价格/总量/已成/成交均价`),时间列给纳秒零填充,其余给该列的文本。
2243/// 0.3.3 收 Wave D 欠账时新增 —— 与成交表的 `trade_sort_key` 同一口径。
2244fn order_sort_key(o: &ek_data::order::OrderData, col: usize) -> String {
2245    match col {
2246        0 => o.symbol.clone(),
2247        1 => o.name.clone(),
2248        2 => o.exchange.as_str().to_string(),
2249        3 => o.order_type.as_str().to_string(),
2250        4 => o
2251            .direction
2252            .map(|d| d.as_str().to_string())
2253            .unwrap_or_default(),
2254        5 => o.offset.as_str().to_string(),
2255        6 => format!("{:020.4}", o.price),
2256        7 => format!("{:020.4}", o.volume),
2257        8 => format!("{:020.4}", o.traded),
2258        9 => format!("{:020.4}", o.traded_price),
2259        10 => o.status.as_str().to_string(),
2260        11 => o.status_msg.clone(),
2261        12 => o.datetime.map(|ns| format!("{ns:025}")).unwrap_or_default(),
2262        13 => o.orderid.clone(),
2263        14 => o.reference.clone(),
2264        15 => o.gateway_name.clone(),
2265        _ => String::new(),
2266    }
2267}
2268
2269/// 成交格(12 列逐值 = Python TradeMonitor 蓝图)。
2270pub(crate) fn render_trades_group(ui: &mut egui::Ui, shared: &UiShared) {
2271    // 单 tab(Python `tab_widget2.addTab(trade_widget, "成交")`:那区也是 QTabWidget,
2272    // 只有一个 tab 也带 tab 头 —— BD-UI-41 补齐;0.4.0 删过,0.4.1 回归原生后恢复)。
2273    tab_label(ui, true, "成交");
2274    let ts = shared.trade_snap();
2275    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
2276    let known_gws = account_gateways(shared);
2277    // 成交表列头单源(空/非空两分支同源,0.2.7 审计口径)。
2278    // 0.3.3 Wave F(BD-UI-51):列序照 Python `TradeMonitor.headers`(widget.py:1270-1283)——
2279    // 代码在首列,成交号在第 10 列;原来我们把「成交号」放首列,是差集里唯一一条纯 UI 差集。
2280    // 列名「成交额」→「成交金额」同 Python。
2281    const TRADE_HEADERS: [&str; 12] = [
2282        "代码",
2283        "名称",
2284        "交易所",
2285        "方向",
2286        "开平",
2287        "价格",
2288        "数量",
2289        "成交金额",
2290        "时间",
2291        "成交号",
2292        "委托号",
2293        "接口",
2294    ];
2295    // 空态不再分支、不再画提示行(0.4.1 六期 BD-UI-59,同未成交口径)。
2296    let sort = shared.table_sort("trade_grid");
2297    let rows = sorted_rows(&ts.trades, sort, trade_sort_key);
2298    let clicked = pinned_table_sorted(ui, "trade_grid", &TRADE_HEADERS, sort, |body, row_h| {
2299        // move 格闭包要把这几样所有权收进去 —— 预先引用整形(同委托表口径)。
2300        let rows = &rows;
2301        let known_gws = &known_gws;
2302        for t in rows.iter().copied() {
2303            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
2304            // 方向列上色(R2,与委托/持仓表同口径:空绿/多红)。
2305            let key = format!("{}.{}", t.gateway_name, t.tradeid);
2306            let row_sel = shared.row_selected("trades", &key);
2307            body.row(row_h, row_sel, |r| {
2308                macro_rules! cell {
2309                    ($make:expr, $col:expr) => {{
2310                        // key 是行内局部:格延迟画笔要活到 show,每格自备克隆(见委托表)。
2311                        let key = key.clone();
2312                        r.cell(move |ui, ctx| {
2313                            let (cell_r, inner_r) =
2314                                pin_cell(ui, ctx, $make);
2315                            let hit =
2316                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
2317                            if hit {
2318                                shared.select_row("trades", &key);
2319                            }
2320                            // 0.3.1(Wave D,BD-UI-49)双击联动:双击成交行 = 该合约进下单面板
2321                            // (Python 双击成交/持仓行带入下单,`mainwindow.py:276` 等价)。
2322                            let dbl = cell_r.double_clicked()
2323                                || inner_r.as_ref().is_some_and(|r| r.double_clicked());
2324                            if dbl {
2325                                let mut f = shared.order_form();
2326                                f.symbol = t.symbol.clone();
2327                                if let Some(d) = t.direction {
2328                                    f.direction = d;
2329                                }
2330                                shared.set_order_form(f);
2331                            }
2332                            // 0.3.1(Wave D)右键菜单(照 Python 表上右键:调整列宽 / 保存数据)。
2333                            // 只挂首列 = 一行一颗菜单,不在每格挂一颗。
2334                            // 0.3.3(收 Wave D 欠账):菜单挂在**真控件**上 —— 首格内容是
2335                            // `Label::new(..).sense(Sense::click())`(有 AccessKit 动作的真控件),
2336                            // 菜单由它自己的 `context_menu` 开。
2337                            // 0.4.1 五期(BD-UI-58):菜单里的「调整列宽」退役 —— 列边界可拖
2338                            // 与列线现在是全部表的固定形制(见 `pinned_table_impl_cols`),
2339                            // 一个只影响这一张表、还只影响「能不能拖」的开关成了空壳钮。
2340                        });
2341                    }};
2342                }
2343                // 首格是**真控件**(可点 + 可右键):右键菜单挂在这颗 Label 上。
2344                cell!(
2345                    |ui| {
2346                        let r = ui
2347                            .add(egui::Label::new(t.symbol.clone()).sense(egui::Sense::click()))
2348                            .on_hover_text("右键:保存数据");
2349                        r.context_menu(|ui| {
2350                            if ui.button("保存数据").clicked() {
2351                                let _ =
2352                                    save_table_csv("trade_grid", &TRADE_HEADERS, rows, trade_cells);
2353                                ui.close();
2354                            }
2355                        });
2356                        r
2357                    },
2358                    0
2359                );
2360                cell!(
2361                    |ui| ui.label(if t.name.is_empty() {
2362                        // 0.11.0 第5刀 R6:名称兜底 = 代码(不是「-」;行永不因缺名被丢)
2363                        t.symbol.clone()
2364                    } else {
2365                        t.name.clone()
2366                    }),
2367                    1
2368                );
2369                cell!(|ui| ui.label(t.exchange.as_str().to_string()), 2);
2370                cell!(
2371                    |ui| ui.label(
2372                        egui::RichText::new(t.direction.map(|d| d.as_str()).unwrap_or("-")).color(
2373                            if t.direction == Some(Direction::SHORT) {
2374                                crate::tokens::fall(ui.ctx())
2375                            } else {
2376                                crate::tokens::rise(ui.ctx())
2377                            },
2378                        ),
2379                    ),
2380                    3
2381                );
2382                cell!(|ui| ui.label(t.offset.as_str().to_string()), 4);
2383                cell!(
2384                    |ui| ui.label(crate::tokens::num_text(crate::format::price(t.price))),
2385                    5
2386                );
2387                cell!(
2388                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(t.volume))),
2389                    6
2390                );
2391                cell!(
2392                    |ui| ui.label(crate::tokens::num_text(crate::format::price(
2393                        t.traded_amount
2394                    ))),
2395                    7
2396                );
2397                // 「时间」列(第 8 列)0.8.0 **不进等宽改造**:这一列旧口径就是左对齐
2398                // (不在六张表的右对齐格位清单里),本轮改造范围 = 旧右对齐格位 + 盘口
2399                // (方案 §5 的 R8 范围钉)。实撞:给它上等宽(FONT_MONO 15px)把列撑宽 →
2400                // 列被推出视口 → 判据 W6 的标签数变 0。
2401                cell!(|ui| ui.label(crate::format::time_hms_millis(t.datetime)), 8);
2402                cell!(|ui| ui.label(t.tradeid.clone()), 9);
2403                cell!(|ui| ui.label(t.orderid.clone()), 10);
2404                cell!(
2405                    |ui| ui.label(ledger_gw_label(&t.gateway_name, known_gws)),
2406                    11
2407                );
2408            });
2409        }
2410        // 右键菜单已挂在第 1 格那颗真控件上(见体表 cell!(.., 0))。
2411    });
2412    if let Some(col) = clicked {
2413        shared.toggle_table_sort("trade_grid", col);
2414    }
2415}
2416
2417/// 持仓格(16 列逐值 = Python PositionMonitor 蓝图;双击行带入下单面板,
2418/// Python mainwindow.py:276 等价,不开 K线)。
2419pub(crate) fn render_positions_group(ui: &mut egui::Ui, shared: &UiShared) {
2420    // 单 tab(Python `tab_widget3.addTab(position_widget, "持仓")`;BD-UI-41 补齐,
2421    // 0.4.0 删过,0.4.1 回归原生后恢复)。
2422    tab_label(ui, true, "持仓");
2423    let ts = shared.trade_snap();
2424    // 摘除标注口径(规划 U8):清册非空时,账本行网关不在清册 = 该账户已摘除。
2425    let known_gws = account_gateways(shared);
2426    // 持仓表列头单源(空/非空两分支同源,0.2.7 审计口径)。
2427    // 11 列(2026-10-28 用户裁定:撤五个恒 0 死列「可用/在途/市值/最新价/盈亏比」
2428    // —— 网关直推那份不填它们;BD-UI-71/L2117 那条挂账由此收案。「名称」列保留,
2429    // 名称富化仍是 C22 的在册骨架)。列序照 python PositionMonitor 缩编版。
2430    const POS_HEADERS: [&str; 11] = [
2431        "代码",
2432        "名称",
2433        "交易所",
2434        "方向",
2435        "数量",
2436        "昨仓",
2437        "冻结",
2438        "成本",
2439        "均价",
2440        "盈亏",
2441        "接口",
2442    ];
2443    // 空态不再分支、不再画提示行(0.4.1 六期 BD-UI-59,同未成交口径)。
2444    // 0.3.3(收 Wave D 欠账):持仓表也吃「点表头排序」。
2445    let sort = shared.table_sort("pos_grid");
2446    let rows = sorted_rows(&ts.positions, sort, pos_sort_key);
2447    let clicked = pinned_table_sorted(ui, "pos_grid", &POS_HEADERS, sort, |body, row_h| {
2448        // move 格闭包要把这几样所有权收进去 —— 预先引用整形(同委托表口径)。
2449        let known_gws = &known_gws;
2450        for p in &rows {
2451            // 行交互(BD-UI-31 扩展):行内任何一格单击 = 选中行(跳色);
2452            // 任何一格双击 = 带入下单面板(Python mainwindow.py:276 等价,
2453            // 不开 K线;方向随持仓方向,Python 同口径)。
2454            let key = format!("{}.{}.{}", p.gateway_name, p.symbol, p.direction.as_str());
2455            let row_sel = shared.row_selected("positions", &key);
2456            body.row(row_h, row_sel, |r| {
2457                macro_rules! cell {
2458                    ($make:expr, $col:expr) => {{
2459                        // key 是行内局部:格延迟画笔要活到 show,每格自备克隆(见委托表)。
2460                        let key = key.clone();
2461                        r.cell(move |ui, ctx| {
2462                            let (cell_r, inner_r) =
2463                                pin_cell(ui, ctx, $make);
2464                            let hit =
2465                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
2466                            if hit {
2467                                shared.select_row("positions", &key);
2468                            }
2469                            let dbl = cell_r.double_clicked()
2470                                || inner_r.as_ref().is_some_and(|r| r.double_clicked());
2471                            if dbl {
2472                                let mut f = shared.order_form();
2473                                f.symbol = p.symbol.clone();
2474                                f.exchange = p.exchange.as_str().to_string();
2475                                f.direction = p.direction;
2476                                // B1 修:行级网关带入(旧实现不带网关 → 平掉哪条腿由上一单残留决定)。
2477                                if !p.gateway_name.is_empty() {
2478                                    f.gateway = p.gateway_name.clone();
2479                                }
2480                                shared.set_order_form(f);
2481                                shared.log_line(format!(
2482                                    "[ops] 持仓带入下单面板 {}(接口 {})",
2483                                    p.symbol, p.gateway_name
2484                                ));
2485                            }
2486                        });
2487                    }};
2488                }
2489                cell!(|ui| ui.label(p.symbol.clone()), 0);
2490                cell!(
2491                    |ui| ui.label(if p.name.is_empty() {
2492                        // 0.11.0 第5刀 R6:名称兜底 = 代码
2493                        p.symbol.clone()
2494                    } else {
2495                        p.name.clone()
2496                    }),
2497                    1
2498                );
2499                cell!(|ui| ui.label(p.exchange.as_str().to_string()), 2);
2500                cell!(
2501                    |ui| ui.label(egui::RichText::new(p.direction.as_str()).color(
2502                        if p.direction == ek_data::constant::Direction::SHORT {
2503                            crate::tokens::fall(ui.ctx())
2504                        } else {
2505                            crate::tokens::rise(ui.ctx())
2506                        },
2507                    )),
2508                    3
2509                );
2510                cell!(
2511                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(p.volume))),
2512                    4
2513                );
2514                cell!(
2515                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(p.yd_volume))),
2516                    5
2517                );
2518                cell!(
2519                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(p.frozen))),
2520                    6
2521                );
2522                // 2026-10-28 用户裁定:撤五个恒 0 死列(可用 can_use_volume / 在途
2523                // on_road_volume / 市值 market_value / 最新价 last_price / 盈亏比
2524                // profit_rate)—— 网关直推那份不填它们,挂账收案见 CHANGELOG 0.8.5。
2525                // 0.3.3 Wave F(BD-UI-51)两处收口:
2526                // ① 成本 / 均价原来**取值互换** —— ek-data 里 `avg_price` = 成本价、
2527                //    `price` = 持仓均价(position.rs:22-23 / 38-39),Python 也是
2528                //    成本 ← avg_price、均价 ← price(widget.py:1491-1492)。判据 F2 抓到这条。
2529                // ② 五处裸 `format!("{:.2}")` / `{:+.1}` / `{:+.4}` 改走 `format.rs`
2530                //    (Python BaseCell 是 `round(content, 3)`,同一张表里三种精度就是毛病 3)。
2531                cell!(
2532                    |ui| ui.label(crate::tokens::num_text(crate::format::price(p.avg_price))),
2533                    7
2534                );
2535                cell!(
2536                    |ui| ui.label(crate::tokens::num_text(crate::format::price(p.price))),
2537                    8
2538                );
2539                cell!(
2540                    |ui| ui.label(crate::tokens::num_text(crate::format::price(p.pnl)).color(
2541                        if p.pnl < 0.0 {
2542                            crate::tokens::fall(ui.ctx())
2543                        } else {
2544                            crate::tokens::rise(ui.ctx())
2545                        }
2546                    ),),
2547                    9
2548                );
2549                cell!(
2550                    |ui| ui.label(ledger_gw_label(&p.gateway_name, known_gws)),
2551                    10
2552                );
2553            });
2554        }
2555    });
2556    if let Some(col) = clicked {
2557        shared.toggle_table_sort("pos_grid", col);
2558    }
2559}
2560
2561/// 持仓行的排序键(列序 == `POS_HEADERS`;与屏幕取值同源:
2562/// 成本 = `avg_price`、均价 = `price`,0.3.3 Wave F 修的那一对)。
2563fn pos_sort_key(p: &ek_data::position::PositionData, col: usize) -> String {
2564    match col {
2565        0 => p.symbol.clone(),
2566        1 => p.name.clone(),
2567        2 => p.exchange.as_str().to_string(),
2568        3 => p.direction.as_str().to_string(),
2569        4 => format!("{:020.4}", p.volume),
2570        5 => format!("{:020.4}", p.yd_volume),
2571        6 => format!("{:020.4}", p.frozen),
2572        7 => format!("{:020.4}", p.avg_price),
2573        8 => format!("{:020.4}", p.price),
2574        9 => format!("{:020.4}", p.pnl),
2575        10 => p.gateway_name.clone(),
2576        _ => String::new(),
2577    }
2578}
2579
2580/// 资金格(0.4.0:独立 dock 格 —— 原来它是「资金|日志」组内 tab 的一半)。
2581pub(crate) fn render_funds_pane(ui: &mut egui::Ui, shared: &UiShared) {
2582    let ts = shared.trade_snap();
2583    // 0.2.29(BD-UI-44):资金表跟着日志表换 TableBuilder —— 同一套固定表头 + 按内容
2584    // 列宽;权益/可用/冻结是数字列(右对齐成列)。「余额」改名「权益」
2585    // (2026-10-28 用户裁定:CTP Balance 是盯市权益,不是静态余额)。
2586    //
2587    // 0.4.0 修正(用户实看:「资金…表头都没有」):空态**不得吞掉表头**。原来这里
2588    // `if accounts.is_empty() { muted_label; return; }` —— 没有网关时整张表连表头一起
2589    // 消失,而它就是「资金|日志」格默认前台的那一格,用户第一眼看到的就是一句空态。
2590    // 口径统一成「表头恒在」(委托/成交/持仓/日志同此);0.4.1 六期(BD-UI-59)起空态
2591    // 那一行提示文字也撤了 —— 表体就是空的,列宽按表头比例填满。
2592    pinned_table_impl(
2593        ui,
2594        "acct_grid",
2595        &["账号", "接口", "权益", "可用", "冻结"],
2596        None,
2597        |body, row_h| {
2598            for a in &ts.accounts {
2599                body.row(row_h, false, |r| {
2600                    macro_rules! cell {
2601                        ($make:expr, $col:expr) => {{
2602                            r.cell(|ui, ctx| {
2603                                let _ = pin_cell(ui, ctx, $make);
2604                            });
2605                        }};
2606                    }
2607                    cell!(|ui| ui.label(a.accountid.clone()), 0);
2608                    cell!(|ui| ui.label(a.gateway_name.clone()), 1);
2609                    // 0.3.3 Wave F:三处裸 `{:.2}` 改走 `format.rs`(同一口径,毛病 3)。
2610                    cell!(
2611                        |ui| ui.label(crate::tokens::num_text(crate::format::price(a.balance))),
2612                        2
2613                    );
2614                    cell!(
2615                        |ui| ui.label(crate::tokens::num_text(crate::format::price(a.available()))),
2616                        3
2617                    );
2618                    cell!(
2619                        |ui| ui.label(crate::tokens::num_text(crate::format::price(a.frozen))),
2620                        4
2621                    );
2622                });
2623            }
2624        },
2625    );
2626}
2627
2628/// 日志表(BD-UI-41,对照 Python 版)。
2629///
2630/// Python 侧「日志」tab 里放的是 `LogMonitor` —— 一个带 **时间/信息/接口** 表头的
2631/// QTableWidget(`widget.py:1167-1180`,BaseMonitor 子类),跟着 Dock 一起伸展。
2632/// 我们原来是一坨 monospace 行 + `ScrollArea::max_height(180.0)` 硬顶:窗口最大化
2633/// 它还是 180px —— 用户报的「整体放到最大,日志那边表格还是很小」根因就是那 180。
2634/// 现在走 `pinned_table`(与委托/成交/持仓同一套容器:表头固定 + 体滚 + 横滚),
2635/// 硬顶撤除 → 格多大,表多大。
2636///
2637/// 两处偏离(记 DESIGN BD-UI-41):
2638/// ① Python 有第三列「接口」;我们的 `log_line` 调用点不带网关(正文自带 `[ops]` /
2639///   `[订阅]` 这类前缀),硬造一列空列不如不造,所以只有两列。
2640/// ② `stick_to_bottom` 撤除:Python 的 QTableWidget 也不自动跟到最后一行,
2641///   要看最新行自己滚到底(与那张表同口径)。
2642fn render_logs(ui: &mut egui::Ui, shared: &UiShared) {
2643    // 「清空日志」钮已撤除(0.4.1 用户裁定 2026-10-22:日志面不要这个钮)。
2644    // 状态层的 `UiShared::clear_logs()` 保留(它是状态口,测试与后续「日志面重置」
2645    // 都用得上),只是界面不再给入口。
2646    let (entries, spilled) = shared.logs_entries();
2647    if spilled > 0 {
2648        // 口径写明(G1 实连证据的收口):回扫日志取证不可靠 —— 巡回里「重加后 90 秒
2649        // 没抓到『交易服务器登录成功』行」不是没登录,是这一环被状态推送流挤满了。
2650        // 登录/掉线/查询被拒这些事实的事实源是账户面板的状态列与状态细节(网关状态口),
2651        // 不是日志窗。单独一行,不挤在钮旁:长文案在横向行里会被压(s39 那类实锤)。
2652        ui.label(format!(
2653            "已丢弃 {spilled} 条(环形 {}):日志窗是窗口不是历史 —— 登录/掉线/查询被拒看账户面板的状态列与状态细节,别回扫这里;全量在盘:%APPDATA%\\ek\\logs\\ekapp-<日>.log",
2654            crate::state::RING_CAP
2655        ));
2656    }
2657    // BD-UI-55(egui_table 迁入):日志正文逐帧生长 → 列宽走**接管版**(字体量串,
2658    // egui galley 缓存受益;不走库 per-frame auto-size,那条路 = 每帧双 pass,
2659    // 行动作用闭包会跑两遍 —— 适配层注释)。时间列定宽 90,信息列 = 最宽正文。
2660    let mono_font = egui::TextStyle::Monospace.resolve(ui.style());
2661    // 空态不接管列宽 —— 走「按表头比例分配」那条路(BD-UI-58)。
2662    let widths: Option<Vec<f32>> = if entries.is_empty() {
2663        None
2664    } else {
2665        Some(vec![
2666            {
2667                let g = ui.painter().layout_no_wrap(
2668                    "18:00:00.000".to_string(),
2669                    mono_font.clone(),
2670                    egui::Color32::TRANSPARENT,
2671                );
2672                g.size().x + 12.0
2673            },
2674            {
2675                let mut w: f32 = 120.0;
2676                for e in &entries {
2677                    let g = ui.painter().layout_no_wrap(
2678                        e.text.clone(),
2679                        mono_font.clone(),
2680                        egui::Color32::TRANSPARENT,
2681                    );
2682                    w = w.max(g.size().x + 12.0);
2683                }
2684                w
2685            },
2686        ])
2687    };
2688    pinned_table_impl_cols(
2689        ui,
2690        "log_grid",
2691        &["时间", "信息"],
2692        None,
2693        widths,
2694        |body, row_h| {
2695            for e in &entries {
2696                body.row(row_h, false, |r| {
2697                    r.cell(|ui, _ctx| {
2698                        ui.monospace(e.at.clone());
2699                    });
2700                    r.cell(|ui, _ctx| {
2701                        ui.monospace(e.text.clone());
2702                    });
2703                });
2704            }
2705        },
2706    );
2707}
2708
2709// ================= 独立窗面(BD-UI-32/33)=================
2710
2711/// 独立窗几何(BD-UI-34:助手参数收敛,8→6 闸 clippy too_many_arguments)。
2712struct WinGeom {
2713    inner: [f32; 2],
2714    min_inner: [f32; 2],
2715    /// 0.9.10(用户裁定「开多少大,最大只能那么大,不能超过最大」):自适应的
2716    /// **天花板** —— want 被夹进 [min_inner, max_inner];内容超天花板 =
2717    /// 窗停在 max_inner,正文出滚动(不再长窗,也不许越过屏幕工作区)。
2718    max_inner: [f32; 2],
2719    maximized: bool,
2720    /// 0.9.10(用户裁定「窗口随内容自动调整」):Immediate 窗按内容实测尺寸
2721    /// 下发 `ViewportCommand::InnerSize`(仅变化 >0.5px 时发,防 resize 风暴)。
2722    fit: bool,
2723}
2724
2725/// 独立 OS 窗统一开法(BD-UI-33,四窗一型:运维/CTP/查询合约/K线)。
2726///
2727/// - **守卫(0.2.3 教训内建):** 调用方按状态位辞行——位关不调本函数 =
2728///   viewport 本拍未 used = egui/eframe GC 销毁 OS 窗(销毁判据源码
2729///   context.rs「never used this pass」)。
2730/// - Embedded 回退(后端不支持多窗:kittest/WEB)= 主窗内 egui::Window 同本体,
2731///   回退面关闭 = embedded 闭包返回 true。
2732/// - Immediate 面 OS X = close_requested → 返回 true(调用方翻负状态位)。
2733/// - `geom.maximized` = 打开即最大化(BD-UI-34,K线窗用户裁定;OS 窗属性,
2734///   Embedded 回退面无此概念 = 忽略)。
2735/// - `body` 返回 true = 内容侧请求关闭(BD-UI-34:K线窗 ESC 键快捷关闭;
2736///   键事件按子窗焦点路由,主窗按键不会误关)。
2737///
2738/// 返回 = "本拍该窗被关"(调用方负责状态位/列表出表)。
2739fn show_independent_window(
2740    ctx: &egui::Context,
2741    id_salt: impl std::hash::Hash,
2742    title: &str,
2743    geom: &WinGeom,
2744    embedded: impl Fn(&egui::Context) -> bool,
2745    mut body: impl FnMut(&mut egui::Ui) -> bool,
2746) -> bool {
2747    let closed = std::cell::Cell::new(false);
2748    let mut builder = egui::ViewportBuilder::default()
2749        .with_title(title)
2750        .with_inner_size(geom.inner)
2751        .with_min_inner_size(geom.min_inner)
2752        .with_max_inner_size(geom.max_inner)
2753        .with_minimize_button(true)
2754        .with_maximize_button(true)
2755        .with_close_button(true);
2756    if geom.maximized {
2757        builder = builder.with_maximized(true);
2758    }
2759    ctx.show_viewport_immediate(
2760        egui::ViewportId::from_hash_of(id_salt),
2761        builder,
2762        |ctx2, class| {
2763            if class == egui::ViewportClass::Embedded {
2764                closed.set(embedded(ctx2));
2765                return;
2766            }
2767            if ctx2.input(|i| i.viewport().close_requested()) {
2768                closed.set(true);
2769                return;
2770            }
2771            // 0.9.10 自适应 = **一次性**(用户两轮实看定罪 + 裁定定稿):
2772            // 「宽度不停增加」(v1-v3)治好后仍剩两个病 —— ①每帧量尺 = body 每帧
2773            // 跑两遍;②窗尺寸被 want 长期锁定:**最大化被 InnerSize 顶掉、手动拖宽
2774            // 下一帧被吸回**。「最大化都最大不了」实锤后裁定:
2775            // **只在首次内容填充之后调一次,此后不再自动调整**。
2776            // 判据 = 量尺自然尺寸连续 3 帧不变且已过 6 帧(数据一拍 1s,首帧常是
2777            // 空态)→ 下发一次 InnerSize(夹进 [min,max])→ 本窗 fit 退役:
2778            // 量尺停跑、任何后续帧(含最大化/拖拽后)都不再发尺寸。
2779            // 状态 per-viewport(temp 随窗销毁 = 重开窗重新走一遍一次性适应)。
2780            #[derive(Clone, Copy)]
2781            struct FitOneShot {
2782                w: f32,
2783                h: f32,
2784                stable: u8,
2785                frames: u16,
2786                done: bool,
2787            }
2788            if geom.fit {
2789                let maximized = ctx2.viewport(|vp| vp.builder.maximized.unwrap_or(false));
2790                let prev =
2791                    ctx2.data(|d| d.get_temp::<FitOneShot>(egui::Id::new(("fit_oneshot", title))));
2792                let st = prev.unwrap_or(FitOneShot {
2793                    w: -1.0,
2794                    h: -1.0,
2795                    stable: 0,
2796                    frames: 0,
2797                    done: false,
2798                });
2799                // 最大化帧 = 用户接管尺寸:不量、不发(恢复后也不再量 = done 已置
2800                // 或不推进 = 永不发第二刀)。
2801                if !st.done && !maximized {
2802                    // 量尺纪律(v4;翻车定罪与收敛三件套见 git 史):① 小值起量
2803                    // (上帧量得的内容宽摆进 max_rect,撑满控件最多撑到量尺宽,
2804                    // 不动点 = 非撑满内容的天然宽);② 禁折行(整句宽计,Grid
2805                    // 列宽 = 天然列宽之和);③ probe **隐形** = 零动作面(点击/
2806                    // 勾选/键入零副作用),行带 paint 在 probe 里 is_visible() 为假
2807                    // → 零绘面。
2808                    let mut sc = (*ctx2.style()).clone();
2809                    sc.wrap_mode = Some(egui::TextWrapMode::Extend);
2810                    let measure_w = ctx2.data(|d| {
2811                        d.get_temp::<f32>(egui::Id::new(("fit_w", title)))
2812                            .unwrap_or(48.0)
2813                    });
2814                    let mut probe = egui::Ui::new(
2815                        ctx2.clone(),
2816                        egui::Id::new(("fit_probe", title)),
2817                        egui::UiBuilder::new()
2818                            .global_scope(true)
2819                            .invisible()
2820                            .style(sc)
2821                            .max_rect(egui::Rect::from_min_size(
2822                                egui::pos2(0.0, 0.0),
2823                                egui::vec2(measure_w.max(48.0), 1.0e5),
2824                            ))
2825                            .layout(egui::Layout::top_down(egui::Align::Min)),
2826                    );
2827                    let _ = body(&mut probe);
2828                    let nat_w = probe.min_rect().width();
2829                    let nat_h = probe.min_rect().height();
2830                    ctx2.data_mut(|d| {
2831                        d.insert_temp(egui::Id::new(("fit_w", title)), nat_w);
2832                    });
2833                    let stable = (nat_w - st.w).abs() < 0.5 && (nat_h - st.h).abs() < 0.5;
2834                    let mut next = FitOneShot {
2835                        w: nat_w,
2836                        h: nat_h,
2837                        stable: if stable { st.stable + 1 } else { 0 },
2838                        frames: st.frames + 1,
2839                        done: false,
2840                    };
2841                    if next.stable >= 3 && next.frames >= 6 {
2842                        let want = egui::vec2(
2843                            (nat_w + 20.0).clamp(geom.min_inner[0], geom.max_inner[0]),
2844                            (nat_h + 26.0).clamp(geom.min_inner[1], geom.max_inner[1]),
2845                        );
2846                        ctx2.send_viewport_cmd(egui::ViewportCommand::InnerSize(want));
2847                        next.done = true;
2848                    }
2849                    ctx2.data_mut(|d| {
2850                        d.insert_temp(egui::Id::new(("fit_oneshot", title)), next);
2851                    });
2852                }
2853            }
2854            egui::CentralPanel::default().show(ctx2, |ui| {
2855                if body(ui) {
2856                    closed.set(true);
2857                }
2858            });
2859        },
2860    );
2861    closed.get()
2862}
2863
2864pub(crate) fn render_windows(ctx: &egui::Context, shared: &UiShared) {
2865    // ---- 0.9.34 模块窗(一模块一菜单一窗):先画模块区 ----
2866    shared.modules().windows(ctx, shared);
2867    // 旧「CTP 网关配置窗」退役收纳于此窗,BD-UI-33 独立 OS 窗形态沿用)。
2868    // 账户配置弹窗(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):
2869    // 『添加账户』与『编辑 <账户>』开同一个弹窗的两种模式;**非 modal**(不阻塞主窗与行情观察)。
2870    // 关闭(窗 × 或『取消』)= 放弃未保存(规划 Q24),绝不静默写入清册留档。
2871    if shared.account_edit_open() {
2872        let closed = show_independent_window(
2873            ctx,
2874            "account_edit_win",
2875            "账户配置",
2876            &WinGeom {
2877                inner: [680.0, 340.0],
2878                min_inner: [480.0, 240.0],
2879                max_inner: [900.0, 780.0],
2880                maximized: false,
2881                fit: true,
2882            },
2883            |ctx2| {
2884                let mut open = shared.account_edit_open();
2885                let title = match shared.editing_account() {
2886                    Some(gw) => format!("账户配置 — 编辑 {gw}"),
2887                    None => "账户配置 — 添加".to_string(),
2888                };
2889                egui::Window::new(title)
2890                    .id(egui::Id::new("account_edit_win"))
2891                    .default_pos([700.0, 380.0])
2892                    .default_size([660.0, 320.0])
2893                    .open(&mut open)
2894                    .show(ctx2, |ui| {
2895                        render_account_edit_window(ui, shared);
2896                    });
2897                if !open {
2898                    shared.end_account_edit();
2899                }
2900                !open
2901            },
2902            |ui| {
2903                render_account_edit_window(ui, shared);
2904                false
2905            },
2906        );
2907        if closed && shared.account_edit_open() {
2908            shared.end_account_edit();
2909        }
2910    }
2911}
2912
2913/// K线窗体(0.9.34:宿主自有窗并入挂载表后,**窗框由 `crate::mount` 统一提供**,
2914/// 这里只画内容;独立成函数是为了让 `Body::Host` 能按合约复用同一份实现)。
2915///
2916/// 返回 `true` = 本帧请求关闭(ESC;键按子窗焦点路由,主窗按键不误关)。
2917pub(crate) fn render_kline_body(ui: &mut egui::Ui, shared: &UiShared, sym: &str) -> bool {
2918    if ui.input(|i| i.key_pressed(egui::Key::Escape)) {
2919        return true;
2920    }
2921    let cell = shared.market().find_cell(sym);
2922    render_kline_cell(ui, cell.as_ref());
2923    false
2924}
2925/// 运维窗:插件表(svctl 操作 + 二次确认)+ 待确认横幅 + 服务目录(三列)
2926/// + 依赖图。回灌界面面已退役(总线口保留;流控查询钮 0.2.10 随 sim 退场撤除)。
2927pub(crate) fn render_ops_window(ui: &mut egui::Ui, shared: &UiShared) {
2928    crate::ui_ext::section_title(ui, "插件");
2929    // 0.5 M3:装配显形改吃事件(启动 / `ePlugUp.oms`),这里只留一个手动口子。
2930    // 为什么放在「插件」节而不是「oms 管线」节:问不到时那一节整节不画(s87b 口径),
2931    // 钮挂在那儿就等于「有读数才给重问」—— 恰恰在没读数的时候最需要重问。
2932    ui.horizontal(|ui| {
2933        if ui.small_button(BTN_PIPELINE_REFRESH).clicked() {
2934            shared.request_pipeline_refresh();
2935        }
2936        ui.label(
2937            egui::RichText::new("管线读数只在 oms 上线 / 启动 / 这里手动触发时问一次")
2938                .color(crate::tokens::info(ui.ctx())),
2939        );
2940    });
2941    let snap = shared.snapshot();
2942    // 账户清册里的实例名(一次取好,别在每行每帧各 clone 一遍整表)。
2943    let account_gateways: std::collections::HashSet<String> = shared
2944        .accounts()
2945        .iter()
2946        .map(|a| a.gateway.clone())
2947        .collect();
2948    let mut plug_heads: Vec<(egui::Rect, String)> = Vec::new();
2949    let mut plug_rows: Vec<f32> = Vec::new();
2950    // 装配锁水印(0.9.5 阶段机 S2):锁定期摘/注钮同旗 disable,水印行在场。
2951    if shared.assembly_locked() {
2952        ui.label(
2953            egui::RichText::new("已锁定(运行中):装配面只可看不可动")
2954                .color(crate::tokens::warn(ui.ctx()))
2955                .small(),
2956        );
2957    }
2958    // 列宽下限(BD-UI-60:短表表宽 = 所在区域 100%,口径与实现见 `ui_ext::grid_col_width`)。
2959    let plug_col_w = crate::ui_ext::grid_col_width(ui, "plug_grid", 6);
2960    // 行高下限与表格层同一口径(BD-UI-61:`table_heights` 同一对数,短表行高 = 主表行高)。
2961    let plug_row_h = table_heights(ui).0;
2962    let band_x1 = ui.max_rect().max.x;
2963    egui::Grid::new("plug_grid")
2964        .num_columns(6)
2965        .min_col_width(plug_col_w)
2966        .min_row_height(plug_row_h)
2967        .show(ui, |ui| {
2968            for h in ["名称", "状态", "版本", "依赖", "统计", "操作"] {
2969                // 表头 = 透明占位格,字由 header_band 画(注释见账户面板同款)。
2970                let r = ui.label(
2971                    egui::RichText::new(h)
2972                        .strong()
2973                        .small()
2974                        .color(egui::Color32::TRANSPARENT),
2975                );
2976                plug_heads.push((r.rect, h.to_string()));
2977            }
2978            ui.end_row();
2979            // 空态不再画提示行(0.4.1 六期 BD-UI-59):快照空 = 这张表只有表头那一行。
2980            for r in &snap.rows {
2981                let row_y = ui.cursor().min.y;
2982                let row_x0 = ui.cursor().min.x;
2983                // 行带跳色见 `paint_row_band`(行首注册,形制注释在那)。
2984            paint_row_band(ui, row_x0, row_y, band_x1);
2985            if is_quarantined(&r.state) {
2986                    ui.label(
2987                        egui::RichText::new(r.name.clone()).color(crate::tokens::error(ui.ctx())),
2988                    );
2989                    ui.label(
2990                        egui::RichText::new(state_text(r))
2991                            .color(crate::tokens::error(ui.ctx()))
2992                            .strong(),
2993                    );
2994                } else {
2995                    ui.label(r.name.clone());
2996                    ui.label(state_text(r));
2997                }
2998                ui.label(r.version.clone());
2999                ui.label(format!("deps:[{}]", r.deps.join(",")));
3000                // 统计列(0.4.5 P7d 首发;0.7.0 背压刀加水位):丢=软顶触发的丢弃累计,
3001                // 爆=panic 累计,积压=当前邮箱深度,峰=历史峰值,软=该插件自己的软顶。
3002                // 上色按最坏一项(判据纯函数 stat_color);只上色不改布局。
3003                ui.label(
3004                    egui::RichText::new(format!(
3005                        "丢:{} 爆:{} 积压:{} 峰:{} 软:{}",
3006                        r.spilled, r.panics, r.pending, r.peak, r.soft_cap
3007                    ))
3008                    .color(stat_color(
3009                        crate::tokens::theme_of(ui.ctx()),
3010                        r.spilled,
3011                        r.panics,
3012                        r.pending,
3013                        r.soft_cap,
3014                    )),
3015                );
3016                ui.horizontal(|ui| {
3017                    // Q17 收口(0.2.20):账户清册里的实例不在运维窗起停。
3018                    // 账户面板的『移除』带全套守卫(活跃委托闸 + 二次确认 + 持仓提示),
3019                    // 运维窗这条是同一动作的无守卫副本 —— 同一个实例两条移除路、守卫只长在
3020                    // 一条上,等于守卫可以绕过(规划 Q17 的边界就在这)。
3021                    // 清册外的 `ctp_*` 实例(手工起的 / 旧流程残留)仍留这条出口,否则没有退路。
3022                    // 0.9.10 P2b(四面美化·运维面):按钮光杆化(行即对象,同账户面板口径)
3023                    // + 说明从行内长句改**徽章 + tooltip**。
3024                    if account_gateways.contains(&r.name) {
3025                        let badge = ui.label(
3026                            egui::RichText::new("归账户面板")
3027                                .color(crate::tokens::info(ui.ctx()))
3028                                .small(),
3029                        );
3030                        badge.on_hover_text("起停归『账户』面板(带撤单守卫),运维窗不给无守卫副本");
3031                    } else if r.name == UI_NAME || r.name == SVCTL_NAME {
3032                        // 管制面与观测面自身不给移除钮(0.4.3 BD-UI-64,审核 P1)。
3033                        // 摘 svctl = 单向门:工厂表(default_kinds / ui_kinds)都不登记 "svctl",
3034                        // 摘掉后连『重注入 svctl』也只会回 unknown factory,启停面没有恢复入口。
3035                        // 摘 ui = 自己等自己:这条指令正是 ui 自己的 worker 在执行,只能走到
3036                        // ek-core close_one 的 2 秒超时 detach 分支,窗口还在但不再刷新。
3037                        // 插件侧同一道闸:supervisor 拒摘 svctl(ek-station 0.2.11)、
3038                        // UiPlugin 直拒摘 ui(本 crate plugin.rs)。
3039                        let badge = ui.label(
3040                            egui::RichText::new("自身不摘")
3041                                .color(crate::tokens::info(ui.ctx()))
3042                                .small(),
3043                        );
3044                        badge.on_hover_text(
3045                            "管制面/观测面自身:不在运维窗摘除(摘 svctl = 单向门;摘 ui = 自己等自己)",
3046                        );
3047                        if ui
3048                            .add_enabled(
3049                                !shared.assembly_locked(),
3050                                egui::Button::new("重注入").small(),
3051                            )
3052                            .clicked()
3053                        {
3054                            shared.push_cmd(UiCmd::Start {
3055                                factory: r.name.clone(),
3056                                name: String::new(),
3057                            });
3058                        }
3059                    } else {
3060                        if ui
3061                            .add_enabled(
3062                                !shared.assembly_locked(),
3063                                egui::Button::new("重注入").small(),
3064                            )
3065                            .clicked()
3066                        {
3067                            // 运维窗按「注册名 = 工厂名」的旧插件重注入(dm/oms/ui);
3068                            // 命名网关实例(`ctp_<broker>_<账号>`)不是工厂名,会被
3069                            // supervisor 回拒 unknown factory —— 那类实例的起停归「账户」面板。
3070                            shared.push_cmd(UiCmd::Start {
3071                                factory: r.name.clone(),
3072                                name: String::new(),
3073                            });
3074                        }
3075                        // 装配锁(0.9.5 阶段机):启动全成功后摘/注钮 disable ——
3076                        // 与勾选器同旗,锁不被绕过(审核定案的覆盖面)。
3077                        let armed = shared.pending_confirm();
3078                        let armed_here = ui
3079                            .add_enabled_ui(!shared.assembly_locked(), |ui| {
3080                                op_button(
3081                                    ui,
3082                                    if armed.as_deref() == Some(r.name.as_str()) {
3083                                        "确认移除?"
3084                                    } else {
3085                                        "移除"
3086                                    },
3087                                    if armed.as_deref() == Some(r.name.as_str()) {
3088                                        OpTone::Confirm
3089                                    } else {
3090                                        OpTone::Danger
3091                                    },
3092                                )
3093                                .clicked()
3094                            })
3095                            .inner
3096                            && shared.confirm_step(&r.name) == ConfirmStep::Fired;
3097                        if armed_here {
3098                            shared.push_cmd(UiCmd::Remove {
3099                                name: r.name.clone(),
3100                            });
3101                        }
3102                    }
3103                });
3104                plug_rows.push(ui.min_rect().max.y);
3105                ui.end_row();
3106            }
3107        });
3108    let plug_band = header_band(ui, &plug_heads, ui.min_rect().max.x);
3109    grid_chrome(ui, plug_band, &plug_heads, &plug_rows);
3110
3111    if let Some(name) = shared.pending_confirm() {
3112        ui.horizontal(|ui| {
3113            // 钮光杆化后行上写的是「移除」不是「移除 {name}」—— 点名放括号,
3114            // 指的路径要与行上字样一致(用户口径:按钮字样 = 所见即所点)。
3115            ui.label(
3116                egui::RichText::new(format!("待二次确认:再次点击该行的『移除』完成({name})"))
3117                    .color(crate::tokens::warn(ui.ctx())),
3118            );
3119            if ui.small_button(BTN_CANCEL_CONFIRM).clicked() {
3120                shared.confirm_cancel();
3121            }
3122        });
3123    }
3124
3125    // oms 管线(0.4.4,P5-a 裁定接的那条服务):装配显形。
3126    // 插件表给「谁在场」,这一节给「oms 里面装了什么」——五段管线 / 限速与撤单守卫 /
3127    // 拆单器 / 每道风控闸一行(工厂注入 ek_risk::standard_gates 缺省限额那四道)。
3128    // 问不到(oms 不在场 → TargetGone 快错,或超时)整节不画:这里没有表、没有可空的
3129    // 东西,与六期 BD-UI-59「空态 = 表头 + 0 行」不是同一种空。
3130    let pipeline = shared.pipeline_lines();
3131    if !pipeline.is_empty() {
3132        crate::ui_ext::space_group(ui);
3133        crate::ui_ext::section_title(ui, "oms 管线");
3134        for line in &pipeline {
3135            ui.label(egui::RichText::new(line).monospace());
3136        }
3137    }
3138
3139    // 配置托底(0.6.0,BD-CFG 环节8):段落目录(零值面)+ 清段/重存段。
3140    // save 联线的另一半长在网关自己身上(`{gw}.configure` 受理成功 → 三行序,
3141    // ek-station DESIGN BD-CFG-14 的 0.10.1 扩)。这里给的是运维面:
3142    // 看段落目录(哪个 ns 有哪些键、哪些是引用)、修格式 rev、误配后抹段。
3143    crate::ui_ext::space_group(ui);
3144    crate::ui_ext::section_title(ui, "配置托底");
3145    ui.horizontal(|ui| {
3146        if ui.small_button(BTN_CFG_REFRESH).clicked() {
3147            shared.arm_cfg_delete(None);
3148            shared.request_cfg_refresh();
3149        }
3150        ui.label(
3151            egui::RichText::new(format!(
3152                "段落目录零值面(只要键名/形态;小键名 = 明面,(引用) = {} 形)",
3153                ek_cfg::legacy::REF_PREFIX
3154            ))
3155            .color(crate::tokens::info(ui.ctx())),
3156        );
3157    });
3158    match shared.cfg_briefs() {
3159        None => {
3160            ui.label(
3161                egui::RichText::new("(未问过段落目录;点『刷新段落目录』再画)")
3162                    .color(crate::tokens::muted(ui.ctx())),
3163            );
3164        }
3165        Some(briefs) if briefs.is_empty() => {
3166            ui.label(
3167                egui::RichText::new("(无段落;配置受理成功后会出现)")
3168                    .color(crate::tokens::muted(ui.ctx())),
3169            );
3170        }
3171        Some(briefs) => {
3172            let b_col_w = crate::ui_ext::grid_col_width(ui, "cfgb_grid", 4);
3173            let b_row_h = table_heights(ui).0;
3174            let band_x1 = ui.max_rect().max.x;
3175            egui::Grid::new("cfgb_grid")
3176                .num_columns(4)
3177                .min_col_width(b_col_w)
3178                .min_row_height(b_row_h)
3179                .show(ui, |ui| {
3180                    for h in ["ns", "rev", "键", "操作"] {
3181                        // 表头 = 透明占位格;这张表没挂 header_band(在滚动节里),
3182                        // 表头字面 = 占位格直画,口径照主界面 = strong+small+text3。
3183                        ui.label(
3184                            egui::RichText::new(h)
3185                                .strong()
3186                                .small()
3187                                .color(crate::tokens::theme_of(ui.ctx()).palette().text3),
3188                        );
3189                    }
3190                    ui.end_row();
3191                    for b in &briefs {
3192                        let row_y = ui.cursor().min.y;
3193                        let row_x0 = ui.cursor().min.x;
3194                        paint_row_band(ui, row_x0, row_y, band_x1);
3195                        ui.label(b.ns.clone());
3196                        ui.label(b.rev.to_string());
3197                        ui.label(format!(
3198                            "{} 条:{}",
3199                            b.keys.len(),
3200                            b.keys
3201                                .iter()
3202                                .map(|k| if k.secret {
3203                                    format!("{}(引用)", k.key)
3204                                } else {
3205                                    k.key.clone()
3206                                })
3207                                .collect::<Vec<_>>()
3208                                .join("、"),
3209                        ));
3210                        // 光杆钮(0.9.10 运维面统一,同插件表口径:行即对象,
3211                        // 二次确认的「再点一次」状态写进按钮字样,不带段名)。
3212                        ui.horizontal(|ui| {
3213                            let armed = shared.cfg_delete_armed();
3214                            let armed_here = armed.as_deref() == Some(b.ns.as_str());
3215                            let label = if armed_here {
3216                                "确认清段?"
3217                            } else {
3218                                "清段"
3219                            };
3220                            if ui.small_button(label).clicked() {
3221                                if armed_here {
3222                                    shared.arm_cfg_delete(None);
3223                                    shared.push_cmd(UiCmd::CfgDelete { ns: b.ns.clone() });
3224                                } else {
3225                                    shared.arm_cfg_delete(Some(b.ns.clone()));
3226                                }
3227                            }
3228                            if ui.small_button("重存段").clicked() {
3229                                shared.push_cmd(UiCmd::CfgResave { ns: b.ns.clone() });
3230                            }
3231                        });
3232                        ui.end_row();
3233                    }
3234                });
3235        }
3236    }
3237
3238    crate::ui_ext::space_group(ui);
3239    crate::ui_ext::section_title(ui, "服务");
3240    let flat: Vec<String> = snap
3241        .services
3242        .iter()
3243        .flat_map(|(n, ids)| {
3244            if ids.is_empty() {
3245                vec![format!("{n} 服务"), "-".to_string()]
3246            } else {
3247                ids.iter()
3248                    .flat_map(|id| [format!("{n} 服务"), id.clone()])
3249                    .collect()
3250            }
3251        })
3252        .collect();
3253    // 表头(BD-UI-41,用户指出「配置那边表格也要有表头」):这张表原来六列纯数据没有头行,
3254    // 列语义 = 三对「服务名 / 实例 id」,头就照这个写。
3255    // 0.4.0 修正(用户实看:「运维…的表格也都要处理」):空态**不得吞掉表头**。原来空态只剩
3256    // 一句「(无服务目录)」,表头带与列宽全没了 —— 与资金格同一个病;口径 = 表头恒画。
3257    // (当时补的那句「空态是表体内的一行」到六期 BD-UI-59 撤除:空态 = 表头 + 0 行。)
3258    let mut svc_heads: Vec<(egui::Rect, String)> = Vec::new();
3259    let mut svc_rows: Vec<f32> = Vec::new();
3260    // 列宽下限同 plug_grid(BD-UI-60)。
3261    let svc_col_w = crate::ui_ext::grid_col_width(ui, "svc_grid", 6);
3262    let svc_row_h = table_heights(ui).0;
3263    let band_x1 = ui.max_rect().max.x;
3264    egui::Grid::new("svc_grid")
3265        .num_columns(6)
3266        .min_col_width(svc_col_w)
3267        .min_row_height(svc_row_h)
3268        .show(ui, |ui| {
3269            for _ in 0..3 {
3270                for h in ["服务", "实例"] {
3271                    // 表头 = 透明占位格,字由 header_band 画(注释见账户面板同款)。
3272                    let r = ui.label(
3273                        egui::RichText::new(h)
3274                            .strong()
3275                            .small()
3276                            .color(egui::Color32::TRANSPARENT),
3277                    );
3278                    svc_heads.push((r.rect, h.to_string()));
3279                }
3280            }
3281            ui.end_row();
3282            // 空态不再画提示行(0.4.1 六期 BD-UI-59):目录空 = 这张表只有表头那一行
3283            // (`rows = 0` → 循环不跑),表头带照画。
3284            let rows = flat.len().div_ceil(6); // 每列 2 字段 × 3 列
3285            for r in 0..rows {
3286                let row_y = ui.cursor().min.y;
3287                let row_x0 = ui.cursor().min.x;
3288                // 行带跳色见 `paint_row_band`(行首注册)。
3289                paint_row_band(ui, row_x0, row_y, band_x1);
3290                for c in 0..3 {
3291                    let i = c * rows * 2 + r * 2;
3292                    if i < flat.len() {
3293                        ui.label(flat[i].clone());
3294                        ui.label(flat[i + 1].clone());
3295                    } else {
3296                        ui.label("");
3297                        ui.label("");
3298                    }
3299                }
3300                svc_rows.push(ui.min_rect().max.y);
3301                ui.end_row();
3302            }
3303        });
3304    let svc_band = header_band(ui, &svc_heads, ui.min_rect().max.x);
3305    grid_chrome(ui, svc_band, &svc_heads, &svc_rows);
3306
3307    ui.label("依赖");
3308    if !snap.rows.iter().any(|r| !r.deps.is_empty()) {
3309        ui.label("(全部无依赖)");
3310    }
3311    for r in &snap.rows {
3312        if !r.deps.is_empty() {
3313            ui.label(format!("{} → {}", r.name, r.deps.join(" + ")));
3314        }
3315    }
3316}
3317
3318/// 账户面板(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):
3319/// 列表上方 = 行情源一览 + 账户计数(软上限)+ 『添加账户』入口;
3320/// 列表 = **跨账户一览**(状态 / 行情源 / 收录勾选与网关实际收录 / 行操作);
3321/// 配置表单**移入独立弹窗**(`render_account_edit_window`)—— 本窗不再内嵌表单,
3322/// 旧「窗内一张共享表单」退役(消 U4 凭据串味 / U6 取消编辑不清空的界面根)。
3323/// 账户面板操作钮的统一外观(0.9.10 用户裁定「按钮要一眼是按钮」):
3324/// 主 = 强调底(连接/添加), 素 = 面板底+描边(断开/编辑), 险 = 警示描边(移除),
3325/// 确认 = 危险实底(确认移除)。尺寸一致(min_side 26),不再用 small_button。
3326pub(crate) enum OpTone {
3327    Primary,
3328    Ghost,
3329    Danger,
3330    Confirm,
3331}
3332
3333// ================= 行带(表格行悬停跳色,0.9.10 全桌面统一)=================
3334// 主界面表(egui_table `pinned_table`)的形制 = 悬停整行 `widgets.hovered.bg_fill`
3335// 跳色(delegate `row_ui`:先画带底,格内文字后画 = 带在字下)。子窗的手搭表
3336// (账户面板 / 运维插件表 / 服务目录 / 配置托底表)与配置弹窗表单行照抄同一条:
3337// **行开画处先注册带** —— 层内按 add 序画,行首注册 = 带在整行所有图元之下,
3338// 实色 `hovered.bg_fill` 不遮字,与主界面同形制(行尾补画会压字,半透明色是
3339// 遮字缺陷的补丁而非答案,已废)。两条纪律:
3340// ① 带右缘 = 调用方给的**可视右缘**(行尾 min_rect 右缘只到最后一格内容右边,
3341//    列内容窄时带不齐;主界面 pinned_table 的带 = 表头带同宽 = 可视右缘)。
3342// ② **量尺面不画** —— fit 的 probe 每帧把 body 重跑一遍(probe 在 (0,0) 起量,
3343//    pointer 恰落其带时会往窗角贴一块可见跳色)。probe 是 invisible Ui,
3344//    `is_visible()` 为假 → 直接返回(probe 零绘面,与零动作面同一纪律)。
3345pub(crate) fn paint_row_band(ui: &egui::Ui, x0: f32, row_y: f32, x1: f32) {
3346    if !ui.is_visible() {
3347        return;
3348    }
3349    let band = egui::Rect::from_min_max(
3350        egui::pos2(x0, row_y),
3351        egui::pos2(x1.max(x0), row_y + table_heights(ui).0),
3352    );
3353    row_band_paint(ui, band);
3354}
3355
3356/// 带底注册(见 `paint_row_band` 纪律;矩形由调用方给全)。
3357pub(crate) fn row_band_paint(ui: &egui::Ui, band: egui::Rect) {
3358    if !ui.is_visible() {
3359        return;
3360    }
3361    if band.width() <= 0.5 || band.height() <= 0.5 {
3362        return;
3363    }
3364    if ui.rect_contains_pointer(band) {
3365        ui.ctx()
3366            .layer_painter(ui.layer_id())
3367            .add(egui::Shape::rect_filled(
3368                band,
3369                0.0,
3370                ui.visuals().widgets.hovered.bg_fill,
3371            ));
3372    }
3373}
3374
3375pub(crate) fn op_button(ui: &mut egui::Ui, label: &str, tone: OpTone) -> egui::Response {
3376    let v = ui.visuals();
3377    let (fill, stroke, fg) = match tone {
3378        OpTone::Primary => {
3379            let bg = v.selection.bg_fill;
3380            // 对比字色手算(0.33 的 Color32 无 luminance 口,0.34 才有):
3381            let c = bg.to_srgba_unmultiplied();
3382            let lum =
3383                (0.2126 * f64::from(c[0]) + 0.7152 * f64::from(c[1]) + 0.0722 * f64::from(c[2]))
3384                    / 255.0;
3385            let fg = if lum > 0.55 {
3386                egui::Color32::BLACK
3387            } else {
3388                egui::Color32::WHITE
3389            };
3390            (bg, egui::Stroke::new(1.0, fg), fg)
3391        }
3392        OpTone::Ghost => (
3393            v.widgets.inactive.bg_fill,
3394            egui::Stroke::new(1.0, v.widgets.inactive.fg_stroke.color),
3395            v.widgets.inactive.fg_stroke.color,
3396        ),
3397        OpTone::Danger => (
3398            v.widgets.inactive.bg_fill,
3399            egui::Stroke::new(1.2, crate::tokens::warn(ui.ctx())),
3400            crate::tokens::warn(ui.ctx()),
3401        ),
3402        OpTone::Confirm => (
3403            crate::tokens::error(ui.ctx()).linear_multiply(0.22),
3404            egui::Stroke::new(1.2, crate::tokens::error(ui.ctx())),
3405            crate::tokens::error(ui.ctx()),
3406        ),
3407    };
3408    ui.add(
3409        egui::Button::new(egui::RichText::new(label).strong().color(fg))
3410            .min_size(egui::vec2(52.0, 26.0))
3411            .fill(fill)
3412            .stroke(stroke),
3413    )
3414}
3415
3416/// 账户配置弹窗(0.2.18 Commit B,规划裁定「一张列表 + 配置弹窗」):『添加账户』与
3417/// 『编辑 <账户>』开**同一个弹窗的两种模式**;非 modal(不阻塞主窗与行情观察)。
3418/// 账号/前置全部界面手工输入,插件不读文件;密码位掩码;**无订阅字段** ——
3419/// 用户裁定:订阅走下单面板代码回车或查询合约窗勾选。
3420/// 关闭(『取消』或窗 ×)= **放弃未保存**(规划 Q24);被拦 → 弹窗不关 + 原因上屏(规划 Q26)。
3421/// 账户表单的标签列(0.4.1 九期 BD-UI-62,用户裁定「这几个字段全部放成一列,数值也放成一列,
3422/// 每一个字段一行」):标签占固定宽,数值列因此对齐成一列。
3423///
3424/// 为什么不用 `Grid`:0.2.17 实锤(s39 同一段)—— 表单 Grid 的列宽在测量期被「窗宽 / 列数」
3425/// 夹死(实测每格 ≈120px),`desired_width` 永不生效,一根真实前置 `tcp://182.254.242.81:30001`
3426/// 只显示出 "tcp:/"。固定宽的标签格 + 同一行剩下的宽度给数值,两头都不夹。
3427const ACCT_FORM_LABEL_W: f32 = 86.0;
3428
3429fn acct_form_label(ui: &mut egui::Ui, text: &str) {
3430    ui.scope_builder(
3431        egui::UiBuilder::new().max_rect(egui::Rect::from_min_size(
3432            ui.cursor().min,
3433            egui::vec2(
3434                ACCT_FORM_LABEL_W,
3435                ui.text_style_height(&egui::TextStyle::Body),
3436            ),
3437        )),
3438        |ui| {
3439            ui.label(text);
3440        },
3441    );
3442}
3443
3444/// 0.9.10 P2c(用户裁定「账户配置界面也要美化」):弹窗表单行 = **行带跳色**,
3445/// 与主界面 pinned_table / 账户面板同一形制(形制与两条纪律的注释见
3446/// `paint_row_band`:行首注册实色带 + probe 面不画)。
3447fn acct_form_row(ui: &mut egui::Ui, add: impl FnOnce(&mut egui::Ui)) {
3448    let row_y = ui.cursor().min.y;
3449    let x0 = ui.cursor().min.x;
3450    let band = egui::Rect::from_min_max(
3451        egui::pos2(x0, row_y),
3452        egui::pos2(ui.max_rect().max.x, row_y + table_heights(ui).0),
3453    );
3454    row_band_paint(ui, band);
3455    ui.horizontal(|ui| {
3456        add(ui);
3457    });
3458}
3459
3460fn render_account_edit_window(ui: &mut egui::Ui, shared: &UiShared) {
3461    let editing: Option<crate::state::AccountRow> =
3462        shared.editing_account().and_then(|g| shared.account(&g));
3463    let editing_on = editing.is_some();
3464    let md = shared.md_source();
3465    let locked = shared.accounts_locked();
3466    let mut form: crate::state::CtpForm = shared.ctp_form();
3467    let mut alias = shared.edit_alias();
3468    // 被拦原因上屏(形制校验 / 清册守卫 / 装配被拒):弹窗不关(规划 U3 / Q26)。
3469    if let Some(e) = shared.edit_error() {
3470        ui.label(egui::RichText::new(format!("拦下:{e}")).color(crate::tokens::error(ui.ctx())));
3471    }
3472    // 0.2.17 布局口径:表单用 horizontal 行不用 Grid —— Grid 列宽在测量期被
3473    // 「窗宽 / 列数」夹死(实测每格 ≈120px),`desired_width` 永不生效,
3474    // 一根真实前置 `tcp://182.254.242.81:30001`(30 字符)只显示出 "tcp:/"。
3475    // 身份行:别名(仅显示用,不参与寻址,规划 Q3)+ broker + td 前置 + td 用户。
3476    // 编辑模式 broker / td 用户**只读**(规划 Q25:它们决定派生注册名,就地改 = 孤儿实例 + 账本错配)。
3477    // 0.4.1 九期 BD-UI-62:一字段一行(原来四个字段挤在一行,窄窗里数值列互相挤)。
3478    acct_form_row(ui, |ui| {
3479        acct_form_label(ui, "别名");
3480        if ui
3481            .add(
3482                egui::TextEdit::singleline(&mut alias)
3483                    .hint_text("显示用,可空")
3484                    .desired_width(210.0),
3485            )
3486            .changed()
3487        {
3488            shared.set_edit_alias(alias.clone());
3489        }
3490    });
3491    acct_form_row(ui, |ui| {
3492        acct_form_label(ui, "broker");
3493        ui.add_enabled_ui(!editing_on, |ui| {
3494            ctp_edit(ui, shared, &mut form.broker_id, "9999", CtpField::Broker);
3495        });
3496    });
3497    acct_form_row(ui, |ui| {
3498        acct_form_label(ui, "td 前置");
3499        ctp_edit(
3500            ui,
3501            shared,
3502            &mut form.td_addr,
3503            "tcp://host:40001",
3504            CtpField::TdAddr,
3505        );
3506    });
3507    acct_form_row(ui, |ui| {
3508        acct_form_label(ui, "td 用户");
3509        ui.add_enabled_ui(!editing_on, |ui| {
3510            ctp_edit(ui, shared, &mut form.td_user, "用户号", CtpField::TdUser);
3511        });
3512    });
3513    if let Some(r) = &editing {
3514        // 只读口径说明(规划 Q25):派生注册名由 broker + 账号决定,就地改会留下
3515        // 跑着旧名的孤儿实例(svctl 侧无改名口),账本里的归属也会错配。
3516        ui.label(
3517            egui::RichText::new(format!(
3518                "派生注册名 = {}(由 broker + 账号决定):要改这两格请『移除后重加』",
3519                r.gateway
3520            ))
3521            .color(crate::tokens::warn(ui.ctx())),
3522        );
3523        // 0.9.0 档案行提示(BD-APP-1;密码不回显口径):存档密码在密库,表单草稿
3524        // 被清成空 —— 界面永远显示不了密码,这不是 bug。
3525        // 分支:
3526        // - 引用在位:只改地址/别名/勾选 → 密码留空点『保存』(不碰档案);
3527        //   『连接』走存档仍用密库密码。「保存并连接」要先重输密码(网关拒收空密码)。
3528        // - 引用不在位:该档当初没存密码(或密库被清过)→ 连接必然因缺密码被拒,
3529        //   重输密码后『保存并连接』受理即补录档案。
3530        let hint = if r.password_ref {
3531            "档案行:密码在密库(**不回显**)。只改地址/勾选 → 密码留空『保存』即可;『保存并连接』要重输密码"
3532        } else {
3533            "档案行:**缺密码引用**(该档没存密码/密库被清)——重输密码后『保存并连接』补录档案,否则连接会被拒"
3534        };
3535        ui.label(
3536            egui::RichText::new(hint)
3537                .color(crate::tokens::muted(ui.ctx()))
3538                .small(),
3539        );
3540    }
3541    acct_form_row(ui, |ui| {
3542        acct_form_label(ui, "td 密码");
3543        ctp_edit(
3544            ui,
3545            shared,
3546            &mut form.td_password,
3547            "密码",
3548            CtpField::TdPassword,
3549        );
3550    });
3551    acct_form_row(ui, |ui| {
3552        acct_form_label(ui, "AppID");
3553        ctp_edit(ui, shared, &mut form.td_app_id, "app", CtpField::AppId);
3554    });
3555    acct_form_row(ui, |ui| {
3556        acct_form_label(ui, "AuthCode");
3557        ctp_edit(
3558            ui,
3559            shared,
3560            &mut form.td_auth_code,
3561            "授权码",
3562            CtpField::AuthCode,
3563        );
3564    });
3565    // 单源纪律(规划 Q12):编辑模式下「非行情源账户 + 行情源已锁定」→ md 位置灰。
3566    // 它当不了源,填了也会在装配侧被清空;要换源须先移除在场账户(规划 D3)。
3567    let md_editable = match &editing {
3568        None => true,
3569        Some(r) => !locked || r.gateway == md,
3570    };
3571    // md 账号 / 密码**不再单列**(0.4.1 九期 BD-UI-62,用户裁定「MD 的那个账号和密码不要单独列了,
3572    // 默认的就是不用登录嘛,我们就不用填」)。口径与 Python 一致:Python 侧 CTP 配置只有
3573    // 一套账号/密码(`trader/utility.py:339` 一带,`appID` 那一格),行情会话复用同一套凭据 ——
3574    // 全仓 grep 不到任何 `md_user` / `md_password`。我们的 `CtpForm.md_user/md_password` 因此
3575    // 退回成「装配侧内部字段」:表单不给填,留空 = 回落 td 凭据(与 Python 同一行为)。
3576    acct_form_row(ui, |ui| {
3577        acct_form_label(ui, "md 前置");
3578        ui.add_enabled_ui(md_editable, |ui| {
3579            ctp_edit(
3580                ui,
3581                shared,
3582                &mut form.md_addr,
3583                "tcp://host:40011",
3584                CtpField::MdAddr,
3585            );
3586        });
3587    });
3588    if !md_editable {
3589        ui.horizontal(|ui| {
3590            acct_form_label(ui, "");
3591            ui.label(
3592                egui::RichText::new("非行情源账户:md 位留空(换源需先移除在场账户)")
3593                    .color(crate::tokens::warn(ui.ctx())),
3594            );
3595        });
3596    }
3597    // 收录勾选(ek-ctp 0.6.0 D-PC-FILTER):网关收录哪些产品类。勾选变更立刻回写共享表单
3598    // —— 与 ctp_edit 同一口径,否则下一帧从 shared 重读就把这次点击丢了。
3599    // 尾句收进 tooltip(0.9.10 用户裁定:说明不堆行里,行带里一眼看得清控件)。
3600    acct_form_row(ui, |ui| {
3601        ui.label("收录勾选:");
3602        let fut = ui.checkbox(&mut form.accept_futures, "期货('1')").changed();
3603        let opt = ui.checkbox(&mut form.accept_options, "期权('2')").changed();
3604        if fut || opt {
3605            shared.set_ctp_form(form.clone());
3606        }
3607        let hint = ui.label(
3608            egui::RichText::new("勾选意图")
3609                .color(crate::tokens::muted(ui.ctx()))
3610                .small(),
3611        );
3612        hint.on_hover_text(
3613            "都不勾 = 回落默认期货;未勾选的合约收到即丢(其持仓/成交/tick 一并不上账)",
3614        );
3615    });
3616    // F4 口径(0.2.20,与账户面板底部同一句 —— 共用 `TXT_PRODUCT_CLASS_SCOPE` 常量)。
3617    // 公用合约表是在场各网关的并集:从账户改了勾选、行情源账户没改,表就不会多一行期权。
3618    ui.label(egui::RichText::new(TXT_PRODUCT_CLASS_SCOPE).weak());
3619    // 只读回带区(规划 U9):勾选是**意图**,网关回带才是**事实** ——
3620    // 旧口径 `ConfigureReply.product_classes` 既不回填也不显示,勾选是否生效无从判断。
3621    if let Some(r) = &editing {
3622        acct_form_row(ui, |ui| {
3623            ui.label("网关实际收录(只读回带):");
3624            ui.label(if r.effective_classes.is_empty() {
3625                "—(尚未装配或无回带)".to_string()
3626            } else {
3627                classes_label(&r.effective_classes)
3628            });
3629            ui.label("装配/登录状态(只读):");
3630            ui.label(format!(
3631                "{}{}",
3632                r.status_label(),
3633                r.fail_note
3634                    .as_ref()
3635                    .map(|n| format!(" —— {n}"))
3636                    .unwrap_or_default()
3637            ));
3638        });
3639    }
3640    // 操作行(规划 §3.3 四态):『保存』只写清册;『保存并连接』= 保存 + 入列一条 Connect 令;
3641    // 『取消』= 放弃未保存(与窗 × 同口径,规划 Q24)。被拦 → 弹窗不关 + 原因上屏(规划 Q26)。
3642    if shared.account_edit_dirty() {
3643        ui.label(
3644            egui::RichText::new("有未保存修改:『保存』写入清册,『取消』或关闭 = 放弃")
3645                .color(crate::tokens::warn(ui.ctx())),
3646        );
3647    }
3648    // 0.9.10 P2c(四面美化):tone 化 = 主行动(保存/保存并连接)Primary 实底,
3649    // 放弃路(取消)Ghost;说明从按钮行摘出(按钮行只放按钮,用户裁定口径)。
3650    ui.horizontal(|ui| {
3651        if op_button(ui, "保存", OpTone::Primary).clicked() {
3652            match save_account_draft(shared, &form, &alias, false) {
3653                Ok(()) => shared.end_account_edit(),
3654                Err(e) => {
3655                    shared.log_line(format!("[账户] 保存被拦:{e}"));
3656                    shared.set_edit_error(Some(e));
3657                }
3658            }
3659        }
3660        if op_button(ui, "保存并连接", OpTone::Primary).clicked() {
3661            match save_account_draft(shared, &form, &alias, true) {
3662                Ok(()) => shared.end_account_edit(),
3663                Err(e) => {
3664                    shared.log_line(format!("[账户] 保存并连接被拦:{e}"));
3665                    shared.set_edit_error(Some(e));
3666                }
3667            }
3668        }
3669        if op_button(ui, "取消", OpTone::Ghost).clicked() {
3670            shared.end_account_edit();
3671        }
3672    });
3673    ui.label(
3674        egui::RichText::new("订阅不在本窗定死:查询合约窗勾选或下单面板代码回车(一律路由到行情源)")
3675            .weak()
3676            .small(),
3677    );
3678}
3679
3680/// 账户清册里的派生名集合(账本标注用,每表算一次,不在每格里克隆清册)。
3681fn account_gateways(shared: &UiShared) -> std::collections::BTreeSet<String> {
3682    shared
3683        .accounts()
3684        .iter()
3685        .map(|a| a.gateway.clone())
3686        .collect()
3687}
3688
3689/// 账本行的网关标注(0.2.18 Commit B,规划 U8):该网关已不在账户清册 = **已摘除账户的残留行**。
3690///
3691/// 摘除不清账本(柜台侧不受影响,重加该账户后由轮转查询重建视图 —— F5 实连复测:
3692/// 摘除后账本 81/29/44/2 原封不动),但界面必须说清这一行属于谁:旧口径零标注,
3693/// 用户会把已摘除账户的委托当成在场账户的。
3694/// 口径边界:**清册为空 = 不标注**(没有账户配置面时谈不上「摘除」,纯账本巡回钉 s27 即此形);
3695/// 资金格不标注(那里的网关位是账户来源标签,`ctp` 这类历史字面量不在清册口径内 —— 刻意划界)。
3696fn ledger_gw_label(gateway: &str, known: &std::collections::BTreeSet<String>) -> String {
3697    if known.is_empty() || gateway.is_empty() || known.contains(gateway) {
3698        gateway.to_string()
3699    } else {
3700        format!("{gateway}(已摘除)")
3701    }
3702}
3703
3704/// 产品类短标签(`"1"` → 期货,`"2"` → 期权):勾选意图与网关回带事实并排显示用。
3705pub(crate) fn classes_label(classes: &[String]) -> String {
3706    if classes.is_empty() {
3707        return "—".to_string();
3708    }
3709    classes
3710        .iter()
3711        .map(|c| match c.as_str() {
3712            "1" => "期货",
3713            "2" => "期权",
3714            other => other,
3715        })
3716        .collect::<Vec<_>>()
3717        .join("+")
3718}
3719
3720/// 『连接』入口的唯一出令处(四态分离:一条令做完 `svctl.start` + `{gw}.configure`)。
3721///
3722/// 入列同时就地置「装配中」:插件出队时也会置(幂等),但**入列到出队之间**若不置,
3723/// 行上的『连接/重试』钮还亮着 = 可重复入列(规划 Q7 防重入的界面侧一半)。
3724/// 0.9.10:桌面相自动连接(清点勾选项)也走这一口 = 手点/自动**同一出令处**。
3725pub(crate) fn push_connect(shared: &UiShared, gateway: &str, form: &crate::state::CtpForm) {
3726    shared.push_cmd(UiCmd::Connect {
3727        gateway: gateway.to_string(),
3728        form: form.clone(),
3729    });
3730    shared.note_connect_sent(gateway);
3731    shared.log_line(format!(
3732        "[账户] {gateway} 连接已入列(svctl.start + {}.configure)",
3733        gateway
3734    ));
3735}
3736
3737/// 配置弹窗『保存』/『保存并连接』的共同路径:**校验 → 写清册 →(可选)入列一条 Connect 令**。
3738///
3739/// - 编辑模式:覆盖该账户留档 + 别名(broker/账号只读 → 派生名不变,规划 Q25)。
3740/// - 添加模式:派生建行(别名随行入册,唯一性在 `add_account` 守卫里)+ 单源定源(规划 §5.C / D3)。
3741///
3742/// 被拦返回原因字符串:调用方**不关弹窗**,把原因写进 `edit_error` 显形(规划 Q26)。
3743fn save_account_draft(
3744    shared: &UiShared,
3745    form: &crate::state::CtpForm,
3746    alias: &str,
3747    connect: bool,
3748) -> Result<(), String> {
3749    form.validate()?;
3750    if let Some(gw) = shared.editing_account() {
3751        // 编辑目标必须还在清册(弹窗非 modal:期间该行可能被摘除)。
3752        if shared.account(&gw).is_none() {
3753            return Err(format!(
3754                "编辑目标 {gw} 已不在清册(该行被摘除):关闭弹窗后重新『添加』"
3755            ));
3756        }
3757        shared.update_account_form(&gw, form.clone());
3758        if !shared.set_account_alias(&gw, alias) {
3759            return Err(format!(
3760                "别名 {alias:?} 不可用(已被其他账户占用;别名须唯一)"
3761            ));
3762        }
3763        shared.log_line(format!(
3764            "[账户] 保存 {gw}(留档已更新;未重连:点行内『连接/重试』才下发到网关)"
3765        ));
3766        if connect {
3767            push_connect(shared, &gw, form);
3768        }
3769        return Ok(());
3770    }
3771    // 多前置派生(0.9.10):在场清册 = taken 清单,同 broker+账号 换 td 前置
3772    // = 自动后缀 `_2`(三处全同 = 拒,弹窗显形)。
3773    let taken: Vec<(String, String, String, String)> = shared
3774        .accounts()
3775        .iter()
3776        .map(|a| {
3777            (
3778                a.gateway.clone(),
3779                a.broker_id.clone(),
3780                a.account.clone(),
3781                a.form.td_addr.clone(),
3782            )
3783        })
3784        .collect();
3785    let mut row = crate::state::AccountRow::derive_with(form, &taken)?;
3786    row.alias = alias.trim().to_string();
3787    let gateway = row.gateway.clone();
3788    let account = row.account.clone();
3789    shared.add_account(row.clone())?;
3790    // 单源纪律在「保存」这一刻定源(规划 §5.C / D3):无源且无账户在场 → 新账户就是元账号
3791    // (md 前置保留 —— 清掉它等于这个账户自己也永远收不到 tick);
3792    // 已有源或已有账户在场 → 按纯 TD 装配(md 位清空,**留档与下发同一份**,消 U4)。
3793    let md = shared.md_source();
3794    let mut f = row.form.clone();
3795    if md.is_empty() && !shared.accounts_locked() {
3796        match shared.set_md_source(&gateway) {
3797            Ok(()) => {
3798                if f.md_addr.trim().is_empty() {
3799                    shared.log_line(format!(
3800                        "[账户] {gateway} 已设为行情源但 md 前置为空:点『编辑 {account}』补填 md 前置才出行情"
3801                    ));
3802                } else {
3803                    shared.log_line(format!("[账户] {gateway} = 行情源(首个账户自动指定,§5.C)"));
3804                }
3805            }
3806            Err(e) => {
3807                shared.log_line(format!("[账户] {e}"));
3808                f.md_addr.clear();
3809                f.md_user.clear();
3810                f.md_password.clear();
3811            }
3812        }
3813    } else {
3814        f.md_addr.clear();
3815        f.md_user.clear();
3816        f.md_password.clear();
3817        if md.is_empty() {
3818            shared.log_line("[账户] 已有账户在场:新账户按纯 TD 装配,换源需先移除在场账户");
3819        }
3820    }
3821    shared.update_account_form(&gateway, f.clone());
3822    // **四态分离:『保存』到此为止** —— 不 start、不 configure(规划裁定)。
3823    shared.log_line(format!(
3824        "[账户] 添加 {gateway}(未装配:点行内『连接 {account}』上线)"
3825    ));
3826    if connect {
3827        push_connect(shared, &gateway, &f);
3828    }
3829    Ok(())
3830}
3831
3832/// 查询合约窗(Python ContractManager 等价):查询串(代码/交易所/名称模糊,
3833/// 留空 = 全部)+ 勾选表 + 订阅钮(勾选集 → UiCmd::CtpSubscribe → ask
3834/// ctp.subscribe)。合约数据 = `eContract.` 自动回流,窗不催查询。
3835pub(crate) fn render_contracts_window(ui: &mut egui::Ui, shared: &UiShared) {
3836    let mut q = shared.contract_query();
3837    ui.horizontal(|ui| {
3838        ui.label("代码或交易所(留空 = 全部):");
3839        if ui
3840            .add(
3841                egui::TextEdit::singleline(&mut q)
3842                    .hint_text("cu 或 SHFE")
3843                    .desired_width(200.0),
3844            )
3845            .changed()
3846        {
3847            shared.set_contract_query(q.clone());
3848        }
3849    });
3850    let rows = shared.contracts(&q);
3851    // 表头单源(0.2.6 审计修:空态分支曾误写另一套表头「代码/…/最后价」,
3852    // 与非空分支不一致——列语义两处必须同源)。
3853    // 六列(2026-10-28 用户裁定:①「选(代码)」列删 —— 勾选改行点(行内任一格
3854    // 单击 = 翻转该行的订阅勾选,原勾选框的两个动作合一在行级);②接口列不做
3855    // (用户裁定);③补「合约分类」「最小委托量」两列 —— ContractData 里
3856    // asset / min_limit_order_volume 都在,纯显示层,对齐 python ContractManager 列集)。
3857    const CONTRACT_HEADERS: [&str; 6] = [
3858        "交易所",
3859        "名称",
3860        "合约分类",
3861        "乘数",
3862        "最小变动",
3863        "最小委托量",
3864    ];
3865    // 空态不再分支、不再画提示行(0.4.1 六期 BD-UI-59,同未成交口径)。
3866    // 0.2.29 那条审计修仍然成立:空态与非空态必须走同一条路(同一 id_salt、同一列语义),
3867    // 原来空态分支走无列线的入口、非空走有列线的入口,同一张表在空/非空之间切换时形制会变。
3868    let selected = shared.selected_contracts();
3869    // 动作行在前、表格吃满剩余窗高(BD-UI-33,用户实看指出):旧
3870    // max_height(260) 是内嵌弹窗时代残留——OS 窗里表格定高 260px,
3871    // 放大窗口表格不跟着长,放大就没了意义。现在放大窗口 = 表格变高,
3872    // 行溢出才出滚动条。
3873    ui.horizontal(|ui| {
3874        ui.label(format!("已选 {} 项 / 共 {} 项", selected.len(), rows.len()));
3875        if ui.button(BTN_SUBSCRIBE_SELECTED).clicked() {
3876            if selected.is_empty() {
3877                shared.log_line("[查询合约] 未勾选任何合约,订阅未发");
3878            } else {
3879                // en_symbol 勾选集 → CTP 裸代码订阅(ask {gw}.subscribe 收裸代码)
3880                // 同上一条:归一化只有网关那一份实现;归不了的点名,不静默下发。
3881                let dropped: Vec<&String> = selected
3882                    .iter()
3883                    .filter(|k| ek_ctp::map::instrument_id(k).is_none())
3884                    .collect();
3885                if !dropped.is_empty() {
3886                    shared.log_line(format!("[查询合约] 代码无法归一(交易所前缀未知):{:?}", dropped));
3887                }
3888                let symbols: Vec<String> = selected
3889                    .iter()
3890                    .filter_map(|k| ek_ctp::map::instrument_id(k))
3891                    .collect();
3892                match subscribe_target(shared) {
3893                    Ok(gw) => {
3894                        shared.push_cmd(UiCmd::CtpSubscribe {
3895                            gateway: gw.clone(),
3896                            symbols,
3897                        });
3898                        shared.log_line(format!(
3899                            "[ops] 查询合约窗订阅 {} 项已入列 → {gw}(等 eTimer 请辞 → {}.subscribe)",
3900                            selected.len(),
3901                            gw
3902                        ));
3903                    }
3904                    Err(e) => shared.log_line(format!("[订阅] {e}")),
3905                }
3906            }
3907        }
3908    });
3909    // 网格线:这张表曾经是「全仓唯一开网格线的表」(Python 侧只有合约表没调
3910    // `setShowGrid(False)`:widget.py:2423 / 2621 建表时没关,交易表在 367 关了)。
3911    // 0.4.1 五期 BD-UI-58 按用户裁定反过来:网格线是**全部表**的固定形制,这条 Python
3912    // 差异从此不再成立(记死在 CHANGELOG / DESIGN / README)。
3913    pinned_table(ui, "contract_grid", &CONTRACT_HEADERS, |body, row_h| {
3914        for c in &rows {
3915            let key = format!("{}.{}", c.exchange.as_str(), c.symbol);
3916            // 0.8.5:原「勾选钮标签 = en_symbol」的勾选框列已撤;勾选身份 = en_symbol,
3917            // 由订阅钮吃勾选集;行点击 = 翻转(见 cell! 宏)。
3918            // BD-UI-31 扩展(2026-10-28 收口):行选中即勾选 —— 原勾选框列删除,
3919            // 「动作归行」升级:行内任一格单击 = 翻转订阅勾选 + 记行选。
3920            // 「已选 N 项 / 订阅」钮吃同一份勾选存储,行为不变。
3921            let row_sel = shared.row_selected("contracts", &key);
3922            // key 是行内局部:格延迟画笔要活到 show,必须自带所有权 ——
3923            // 在 rep_row 闭包外准备 key 克隆,各格自己再取。
3924            let key_owned = key.clone();
3925            body.row(row_h, row_sel, |r| {
3926                macro_rules! cell {
3927                    ($make:expr, $col:expr) => {{
3928                        let key = key_owned.clone();
3929                        r.cell(move |ui, ctx| {
3930                            let (cell_r, inner_r) = pin_cell(ui, ctx, $make);
3931                            let hit =
3932                                cell_r.clicked() || inner_r.as_ref().is_some_and(|r| r.clicked());
3933                            if hit {
3934                                shared.toggle_contract_selection(&key.clone());
3935                                shared.select_row("contracts", &key.clone());
3936                            }
3937                        });
3938                    }};
3939                }
3940                // 2026-10-28 用户裁定:「选(代码)」勾选框列删。订阅勾选改在行级:
3941                // 行内任一格单击 = 翻转该行的勾选(原「勾选 = 订阅选择 + 行选中」
3942                // 两动作合一在行上),「已选 N 项」与「订阅勾选集」钮照吃同一存储。
3943                cell!(|ui| ui.label(c.exchange.as_str().to_string()), 0);
3944                cell!(|ui| ui.label(c.name.clone()), 1);
3945                cell!(|ui| ui.label(c.asset.as_str().to_string()), 2);
3946                cell!(
3947                    |ui| ui.label(crate::tokens::num_text(crate::format::volume(c.size))),
3948                    3
3949                );
3950                cell!(
3951                    |ui| ui.label(crate::tokens::num_text(crate::format::price_tick(
3952                        c.price_tick
3953                    ))),
3954                    4
3955                );
3956                cell!(
3957                    |ui| ui.label(
3958                        c.min_limit_order_volume
3959                            .map(|v| crate::tokens::num_text(crate::format::volume(v)))
3960                            .unwrap_or_else(|| "-".to_string().into())
3961                    ),
3962                    5
3963                );
3964            });
3965        }
3966    });
3967}
3968
3969/// CTP 表单字段枚举(ctp_edit 回写定位;订阅标的字段已撤出网关窗)。
3970enum CtpField {
3971    Broker,
3972    TdAddr,
3973    TdUser,
3974    TdPassword,
3975    AppId,
3976    AuthCode,
3977    MdAddr,
3978}
3979
3980/// 单行 TextEdit + changed 回写 CTP 表单(密码位掩码)。
3981fn ctp_edit(ui: &mut egui::Ui, shared: &UiShared, val: &mut String, hint: &str, field: CtpField) {
3982    let is_secret = matches!(field, CtpField::TdPassword | CtpField::AuthCode);
3983    let mut w = egui::TextEdit::singleline(val)
3984        .hint_text(hint)
3985        // 0.2.17:输入位加宽(旧 110 装不下一根 CTP 前置 `tcp://182.254.242.81:30001`
3986        // = 30 字符,用户看不见自己填的前置,也无法核对端口;快照钉 s39 前后对照)。
3987        .desired_width(210.0);
3988    if is_secret {
3989        w = w.password(true);
3990    }
3991    if ui.add(w).changed() {
3992        let mut f = shared.ctp_form();
3993        match field {
3994            CtpField::Broker => f.broker_id = val.clone(),
3995            CtpField::TdAddr => f.td_addr = val.clone(),
3996            CtpField::TdUser => f.td_user = val.clone(),
3997            CtpField::TdPassword => f.td_password = val.clone(),
3998            CtpField::AppId => f.td_app_id = val.clone(),
3999            CtpField::AuthCode => f.td_auth_code = val.clone(),
4000            CtpField::MdAddr => f.md_addr = val.clone(),
4001        }
4002        shared.set_ctp_form(f);
4003    }
4004}
4005
4006/// K线窗内容(dm bar 合成序列;格定点 = 该合约格;无格占位)。
4007///
4008/// 图实例每帧重建(BD-UI-20 口径:数据在 store 不丢,交互状态不跨帧)。
4009fn render_kline_cell(ui: &mut egui::Ui, cell: Option<&CellView>) {
4010    let Some(c) = cell else {
4011        // F1 键统一(0.9.9):空窗必须说"补数在途 + 没来的根因去向",
4012        // 不许装"等 dm 合成"的静默空图(开窗即入队 tq 历史补数)。
4013        ui.label("(K线无格:tq 历史补数在途;若长期不画,多半是 tq 桥/网关未上线)");
4014        return;
4015    };
4016    if c.bars.is_empty() {
4017        ui.label(format!("(K线:{}@{} 批空)", c.symbol, c.interval));
4018        return;
4019    }
4020    // 柱时间按北京钟面给图:egui_charts 0.2 的 Bar 只吃 DateTime<Utc> 且按
4021    // UTC 钟面画刻度 —— 用「换到 +08 再标回 UTC」的重标定,让横轴刻度显示
4022    // 北京钟面(数据面存 UTC 纳秒;重标定只挪刻度,不挪序)。
4023    let mut data = egui_charts::model::bar::BarData::new();
4024    for b in &c.bars {
4025        let dt = chrono::DateTime::<chrono::Utc>::from_timestamp_nanos(b.datetime)
4026            .with_timezone(&beijing_tz())
4027            .with_timezone(&chrono::Utc);
4028        data.push(egui_charts::model::bar::Bar::new(
4029            dt,
4030            b.open_price,
4031            b.high_price,
4032            b.low_price,
4033            b.close_price,
4034            b.volume,
4035        ));
4036    }
4037    ui.label(format!(
4038        "K线 {}@{}s({} 根)",
4039        c.symbol,
4040        c.interval,
4041        c.bars.len()
4042    ));
4043    // 0.2.30(BD-UI-46):图表色板不再自带它那套 TradingView 令牌。
4044    // egui_charts 0.2 的 `ChartConfig::default()` 读的是它自己的 RON `DESIGN_TOKENS`
4045    // (bullish `#26a69a` 青 / bearish `#F23645` 红)——**涨跌方向正好和我们的
4046    // 红涨绿跌相反**,而且它**不读 egui `Visuals`**,界面换什么档都影响不到它。
4047    // 所以这里显式覆盖五支:涨 = RISE(红)、跌 = FALL(绿)、底 = 当前档 `bg1`、
4048    // 网格 = 当前档 `border`、文字 = 当前档 `text1`。
4049    // 0.8.0 双档补的正是这后三支(判据 `s93`):旧口径直写 `shadcn::BG1/BORDER/TEXT1`
4050    // = 深档常量,浅色档下 K 线会是界面里唯一一块黑底 —— 这一处必须跟着档走。
4051    let pal = crate::tokens::palette(ui.ctx());
4052    let cfg = egui_charts::config::ChartConfig {
4053        bullish_color: crate::tokens::rise(ui.ctx()),
4054        bearish_color: crate::tokens::fall(ui.ctx()),
4055        background_color: pal.bg1,
4056        grid_color: pal.border,
4057        text_color: pal.text1,
4058        ..egui_charts::config::ChartConfig::default()
4059    };
4060    let mut chart = egui_charts::widget::Chart::with_config(data, cfg).visible_bars(60);
4061    chart.set_symbol(&c.symbol);
4062    chart.set_timeframe_label(&format!("{}s", c.interval));
4063    chart.enable_tracking_mode();
4064    let _ = chart.show(ui);
4065}
4066
4067#[cfg(test)]
4068mod tests {
4069    use super::*;
4070
4071    // 表头带**派生规则**钉(BD-UI-41,0.2.30 收缩成一套主题):
4072    // Chrome 的每个角色必须取到令牌里那一档,不许自己挑。
4073    // (色板原值本身由 `tests/ui_kittest.rs` 的 `u1_palette_matches_source` 钉 ——
4074    //  色值字面量只留在测试侧,src 侧不写 `from_rgb`。)
4075    // 原来这里还有一条「不得与金融深色那一列混同」:金融深色已随主题面删除,
4076    // 判据对象不存在,删掉,不留一条空转的断言。
4077    // 0.4.0:tab 那三档派生判据随 `tab_label` 一起撤除 —— tab 形态归 dock,
4078    // 其样式来自同一份 `visuals`(v5 钉住 `Style::from_egui` 这条派生路径)。
4079    #[test]
4080    fn chrome_derives_from_token_palette() {
4081        // 0.8.0 双档:派生规则对**两档各钉一遍**(浅档漏一支 = u9 钉的事,这里钉的是
4082        // 「表头文字必须走次级色」这条新口径在两档都成立)。
4083        for theme in [crate::tokens::Theme::Dark, crate::tokens::Theme::Light] {
4084            let v = crate::tokens::visuals_for(theme);
4085            let ch = Chrome::of(&v, theme);
4086            let p = theme.palette();
4087            // 0.4.1 四期(BD-UI-57):旧口径 `line` 一支兼做「带底 + 描边」(qss:1959-1970
4088            // `QHeaderView::section { background #455364 }` 与描边同色)。Nova 把两者拆开 →
4089            // 两条断言各钉一支,谁也不许兼谁的活。
4090            assert_eq!(ch.line, p.border, "{theme:?} 档的描边必须取 border 那支");
4091            assert_eq!(ch.band_fill, p.bg4, "{theme:?} 档的表头带底必须取 BG4 那支");
4092            // 0.8.0 裁定 C:表头文字走次级色(参考站 `th{color:ink-muted}`),
4093            // 与表体(`text2`)/ 标题(`text1`)是三层,不许塌回一层。
4094            assert_eq!(
4095                ch.header_text, p.text3,
4096                "{theme:?} 档的表头文字必须走次级色"
4097            );
4098            assert_ne!(
4099                ch.header_text, p.text1,
4100                "{theme:?} 档的表头文字与正文同色 = 层级塌一档"
4101            );
4102        }
4103    }
4104
4105    // 日志入环打戳钉(BD-UI-41):日志表格化后「时间」列的事实源是 `LogRing`,
4106    // 打戳必须与表内时间列(`fmt_dt`)同一个口径 = 北京 +08,不能跟本机时区走
4107    // (本机不是 +08 时,口径错 = 日志与成交表差几小时,交易员对不上账)。
4108    #[test]
4109    fn log_entries_stamp_beijing_wall_clock() {
4110        let mut ring = crate::state::LogRing::new(4);
4111        ring.push("[ops] 一行");
4112        let e = &ring.entries()[0];
4113        assert_eq!(e.text, "[ops] 一行", "正文不得被时间戳污染");
4114        assert_eq!(e.at.len(), 8, "时间戳必须是 HH:MM:SS(8 字符),实测 {}", e.at);
4115        for seg in e.at.split(':') {
4116            assert!(seg.parse::<u32>().is_ok(), "时间戳有非数字段:{seg}");
4117        }
4118        let want = chrono::Utc::now()
4119            .with_timezone(&beijing_tz())
4120            .format("%H:%M:%S")
4121            .to_string();
4122        let secs = |s: &str| -> i64 {
4123            s.split(':')
4124                .map(|x| x.parse::<i64>().unwrap())
4125                .fold(0, |acc, v| acc * 60 + v)
4126        };
4127        let (a, b) = (secs(&e.at), secs(&want));
4128        let d = (a - b).abs();
4129        // 允许跨秒抖动,并容忍跨午夜(差值接近 86400 即同一口径的另一侧)。
4130        assert!(
4131            d <= 2 || d > 86_398,
4132            "日志时间戳必须走北京 +08:实测 {a} vs 期望 {b}"
4133        );
4134        // 旧门面不变:`snapshot()` 仍只给正文(测试与巡回取证靠它)。
4135        assert_eq!(ring.snapshot(), vec!["[ops] 一行".to_string()]);
4136    }
4137
4138    // 表内时间列北京钟面钉(0.2.13):数据面存 UTC 纳秒,展示换回 +08 ——
4139    // 北京 09:30:01 入账后是 UTC 01:30:01,fmt_dt 必须显示 09:30:01,
4140    // 不是 01:30:01(旧实现的 UTC 直显,交易员看差 8 小时)。
4141    #[test]
4142    fn fmt_dt_shows_beijing_wall_clock() {
4143        let expect = chrono::DateTime::<chrono::Utc>::from_timestamp_nanos(
4144            ek_data::time::civil_to_nanos(ek_data::time::Civil {
4145                year: 2026,
4146                month: 4,
4147                day: 16,
4148                hour: 1,
4149                minute: 30,
4150                second: 1,
4151                nanos: 0,
4152            }),
4153        );
4154        // 真值自洽:UTC 01:30:01 ↔ 北京 09:30:01(双向换算回原钟面)
4155        let beijing = expect.with_timezone(&beijing_tz());
4156        assert_eq!(beijing.format("%H:%M:%S").to_string(), "09:30:01");
4157        // 再来一个跨日钉:北京 00:00:30 = UTC 前日 16:00:30(同 UTC 日,
4158        // 不同北京日 —— 旧实现会把这根显示成 16:00:30)
4159        let ns = ek_data::time::civil_to_nanos(ek_data::time::Civil {
4160            year: 2026,
4161            month: 4,
4162            day: 15,
4163            hour: 16,
4164            minute: 0,
4165            second: 30,
4166            nanos: 0,
4167        });
4168        // 0.3.1(Wave D):格式从 `HH:MM:SS` 收成 `HH:MM:SS.mmm`(照 Python `TimeCell`),
4169        // 时区口径没动 —— 这条钉的仍是「北京墙钟」这件事,不是小数位。
4170        assert_eq!(crate::format::time_hms_millis(Some(ns)), "00:00:30.000");
4171        // None → 占位
4172        assert_eq!(crate::format::time_hms_millis(None), "-");
4173    }
4174}