acprof 0.3.0__py3-none-any.whl

acprof/_bundle/acprof/tui/views.py

@@ -0,0 +1,706 @@
+"""TUI 页面布局、公共控件与确认弹窗。"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from textual import on
+from textual.app import ComposeResult
+from textual.containers import Grid, Horizontal, Vertical, VerticalScroll
+from textual.screen import ModalScreen
+from textual.widgets import (
+    Button,
+    Checkbox,
+    Collapsible,
+    ContentSwitcher,
+    Label,
+    Rule,
+    Static,
+    TabPane,
+)
+from textual.widgets.button import ButtonVariant
+
+from acprof.tui.app_contracts import translated_app
+from acprof.tui.field_validation import ConfigField
+from acprof.tui.i18n import LANGUAGE_OPTIONS, message_id
+from acprof.tui.input import BarCursorInput as Input
+from acprof.tui.log import SelectableLog
+from acprof.tui.model_input import ModelInput
+from acprof.tui.presentation import NOT_APPLICABLE, format_input_number
+from acprof.tui.rendering import CjkCompositor
+from acprof.tui.run_form import PRESET_OPTIONS
+from acprof.tui.table import ResizableDataTable
+from acprof.tui.themes import THEME_OPTIONS
+
+if TYPE_CHECKING:
+    from acprof.tui.app import AcprofTui
+
+
+# Keep the original triangles with one extra cell before the title text.
+COLLAPSED_SYMBOL = "▶ "
+EXPANDED_SYMBOL = "▼ "
+
+
+class StatusCheckbox(Checkbox):
+    """Checkbox whose selected mark is unambiguous in dark terminals."""
+
+    BUTTON_INNER = "✓"
+
+
+class EnvironmentPreflightScreen(ModalScreen[bool]):
+    """Show cached issues without running probes while the dialog is open."""
+
+    AUTO_FOCUS = "#preflight-close"
+    BINDINGS = [("escape", "close", "关闭详情")]
+    CSS = """
+    EnvironmentPreflightScreen { align: center middle; }
+    #preflight-dialog {
+        width: 92%; max-width: 100; height: auto; max-height: 85%;
+        border: round $accent; background: $surface; padding: 1 2;
+    }
+    #preflight-title { height: auto; text-style: bold; margin-bottom: 1; }
+    #preflight-scroll { height: auto; max-height: 45vh; margin-bottom: 1; }
+    #preflight-details { height: auto; }
+    #preflight-buttons { height: auto; align-horizontal: right; }
+    #preflight-buttons Button { margin-left: 1; }
+    """
+
+    def __init__(self, details: str, *, retry_disabled: bool):
+        super().__init__()
+        self._compositor = CjkCompositor()
+        self.details = details
+        self.retry_disabled = retry_disabled
+
+    def compose(self) -> ComposeResult:
+        tr = translated_app(self.app).tr
+        with Vertical(id="preflight-dialog"):
+            yield Static(tr("环境状态"), id="preflight-title")
+            with VerticalScroll(id="preflight-scroll"):
+                yield Static(tr(self.details), id="preflight-details", markup=False)
+            with Horizontal(id="preflight-buttons"):
+                yield Button(tr("关闭详情"), id="preflight-close")
+                yield Button(tr("重新检查"), id="preflight-retry", variant="primary",
+                             disabled=self.retry_disabled)
+
+    @on(Button.Pressed, "#preflight-close")
+    def action_close(self) -> None:
+        self.dismiss(False)
+
+    @on(Button.Pressed, "#preflight-retry")
+    def retry(self) -> None:
+        self.dismiss(True)
+
+
+class ConfirmActionScreen(ModalScreen[bool]):
+    """Small confirmation screen for long-running or mutating actions."""
+
+    # 打开时不预选按钮；鼠标悬停与主动使用 Tab 聚焦仍保留高亮。
+    AUTO_FOCUS = ""
+
+    BINDINGS = [("escape", "cancel", "取消")]
+
+    CSS = """
+    ConfirmActionScreen {
+        align: center middle;
+    }
+
+    #confirm-dialog {
+        width: 92%;
+        max-width: 100;
+        height: auto;
+        max-height: 80%;
+        border: round $accent;
+        background: $surface;
+        padding: 1 2;
+    }
+
+    #confirm-title {
+        text-style: bold;
+        margin-bottom: 1;
+    }
+
+    #confirm-message {
+        height: auto;
+        max-height: 40vh;
+        overflow-y: auto;
+        margin-bottom: 1;
+    }
+
+    #confirm-buttons {
+        height: auto;
+        align-horizontal: right;
+    }
+
+    #confirm-buttons Button {
+        margin-left: 1;
+    }
+    """
+
+    def __init__(
+        self, title: str, message: str, confirm_label: str = "确认", *,
+        variant: ButtonVariant = "primary",
+    ):
+        super().__init__()
+        self._compositor = CjkCompositor()
+        self.dialog_title = title
+        self.message = message
+        self.confirm_label = confirm_label
+        self.confirm_variant = variant
+
+    def compose(self) -> ComposeResult:
+        tr = translated_app(self.app).tr
+        with Vertical(id="confirm-dialog"):
+            yield Static(tr(self.dialog_title), id="confirm-title", markup=False)
+            yield Static(tr(self.message), id="confirm-message", markup=False)
+            with Horizontal(id="confirm-buttons"):
+                yield Button(tr("取消"), id="confirm-no")
+                yield Button(
+                    tr(self.confirm_label),
+                    id="confirm-yes",
+                    variant=self.confirm_variant,
+                )
+
+    @on(Button.Pressed, "#confirm-yes")
+    def confirm(self) -> None:
+        self.dismiss(True)
+
+    def on_mount(self) -> None:
+        for button in self.query(Button):
+            button.active_effect_duration = 0
+
+    @on(Button.Pressed, "#confirm-no")
+    def cancel(self) -> None:
+        self.dismiss(False)
+
+    def action_cancel(self) -> None:
+        self.dismiss(False)
+
+
+class LogPanel(Vertical):
+    """Keep the log controls available when the log fills the terminal."""
+
+    ALLOW_MAXIMIZE = True
+
+
+def compose_number_field(app: AcprofTui, label: str, widget_id: str, value: int | float | str,
+                         unit: str, *, placeholder: str = "") -> ComposeResult:
+    yield app.localization.localized_widget(Label(label))
+    yield ConfigField(Horizontal(
+        app.localization.localized_widget(Input(
+            value=format_input_number(value), id=widget_id, classes="config-control",
+            placeholder=placeholder,
+        )), app.localization.localized_widget(Label(unit, classes="field-unit")), classes="number-field"), field_id=widget_id)
+
+
+def compose_run_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("实验配置", id="run-tab"):
+        with Vertical(classes="page-header"):
+            yield app.localization.localized_widget(Static("", id="config-summary", classes="page-summary", markup=False))
+            yield Static("", id="preflight-run-reason", markup=False)
+        with ContentSwitcher(initial="run-form", id="experiment-pages"):
+            with VerticalScroll(id="run-form", classes="pane-scroll"):
+                with Grid(classes="form-grid"):
+                    yield app.localization.localized_widget(Label("模型 ID"))
+                    with Horizontal(classes="model-picker-row"):
+                        yield ConfigField(app.localization.localized_widget(ModelInput(
+                            value=app.configuration.initial_config.model,
+                            placeholder="google-bert/bert-base-uncased",
+                            id="model", classes="config-control",
+                            tooltip="自由输入模型 ID；F4 搜索本地候选与验证记录。",
+                        )), field_id="model")
+                        yield app.localization.localized_widget(Button("模型候选", id="model-candidates"))
+                    yield app.localization.localized_widget(Label("模型来源"))
+                    yield ConfigField(app.localization.localized_select((("Hugging Face", "huggingface"),
+                        ("ModelScope", "modelscope")), value=app.configuration.initial_config.model_source, allow_blank=False,
+                        id="model-source", classes="config-control"), field_id="model-source")
+                    yield app.localization.localized_widget(Label("输出目录"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.output_dir,
+                        id="output-dir",
+                        classes="config-control",
+                    )), field_id="output-dir")
+
+                    yield app.localization.localized_widget(Label("运行预设"))
+                    yield app.localization.localized_select(
+                        PRESET_OPTIONS,
+                        value=app.configuration.initial_preset,
+                        allow_blank=False,
+                        id="run-preset",
+                    )
+
+                    yield app.localization.localized_widget(Label("CPU 列表"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.cpus,
+                        placeholder="1,2,4,8",
+                        id="cpus",
+                        classes="config-control",
+                    )), field_id="cpus")
+                    yield app.localization.localized_widget(Label("内存 GB"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.mems,
+                        placeholder="2,4,8,16",
+                        id="mems",
+                        classes="config-control",
+                    )), field_id="mems")
+
+                    yield app.localization.localized_widget(Label("GPU 模式"))
+                    yield ConfigField(app.localization.localized_select(
+                        app.configuration.gpu_options(),
+                        value=app.configuration.initial_config.gpus,
+                        allow_blank=False,
+                        id="gpus",
+                        classes="config-control",
+                    ), field_id="gpus")
+                    yield app.localization.localized_widget(Label("输入规模", id="input-scales-label"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.input_scales,
+                        placeholder="留空自动规划；如 64,128,256",
+                        id="input-scales",
+                        classes="config-control",
+                    )), field_id="input-scales")
+
+                with app.localization.localized_widget(Collapsible(
+                    title="完整命令（自动更新）",
+                    collapsed=True,
+                    collapsed_symbol=COLLAPSED_SYMBOL,
+                    expanded_symbol=EXPANDED_SYMBOL,
+                    id="command-details",
+                )):
+                    yield app.localization.localized_widget(Static("", id="command-preview", markup=False))
+                    yield app.localization.localized_widget(Static(
+                        "测量窗口内暂停常规界面刷新，不读取正在写入的 CSV。",
+                        id="science-note",
+                        markup=False,
+                    ))
+
+            with VerticalScroll(id="advanced-form", classes="pane-scroll"):
+                with Grid(classes="form-grid"):
+                    for label, field, unit in (
+                        ("Warmup", "warmup", "次"), ("Repeat", "repeat", "次"),
+                        ("采样频率", "sample_hz", "Hz"), ("Idle 基线", "idle_seconds", "s"),
+                        ("冷却时间", "idle_cooldown_seconds", "s"), ("连接/读取超时", "request_timeout_seconds", "s"),
+                        ("Batch size", "batch_size", ""), ("窗口请求数", "repeat_in_window", "次"),
+                        ("自动窗口", "repeat_window_seconds", "s"),
+                    ):
+                        yield from compose_number_field(
+                            app, label, field.replace("_", "-"), getattr(app.configuration.initial_config, field), unit,
+                            placeholder="0 表示自动校准" if field == "repeat_in_window" else "",
+                        )
+                with Grid(classes="form-grid"):
+                    yield app.localization.localized_widget(Label("输入规划"))
+                    yield ConfigField(app.localization.localized_select(
+                        (("自动范围", "auto"), ("最小单一尺度", "minimal")),
+                        value=app.configuration.initial_config.input_scale_policy, allow_blank=False,
+                        id="input-scale-policy", classes="config-control",
+                    ), field_id="input-scale-policy")
+                    yield app.localization.localized_widget(Label("画像模式"))
+                    yield ConfigField(app.localization.localized_select(
+                        (("完整（RAPL / perf / 抓包）", "full"), ("基础（延迟 / CPU / 内存）", "basic")),
+                        value=app.configuration.initial_config.profiling_mode,
+                        allow_blank=False, id="profiling-mode", classes="config-control",
+                    ), field_id="profiling-mode")
+                    yield app.localization.localized_widget(Label("固定 CPU 集合"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.cpuset_cpus, id="cpuset-cpus",
+                        placeholder="可选；如 0-3,8；用于正式采集", classes="config-control",
+                    )), field_id="cpuset-cpus")
+                    yield app.localization.localized_widget(Label("抓包网卡"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.sniff_iface,
+                        id="sniff-iface",
+                        classes="config-control",
+                    )), field_id="sniff-iface")
+                    yield app.localization.localized_widget(Label("通知"))
+                    yield ConfigField(app.localization.localized_select(
+                        (
+                            ("自动", "auto"),
+                            ("关闭", "none"),
+                            ("企业微信", "wecom"),
+                        ),
+                        value=app.configuration.initial_config.notify,
+                        allow_blank=False,
+                        id="notify",
+                        classes="config-control",
+                    ), field_id="notify")
+
+                yield app.localization.localized_widget(Static("深度性能分析", classes="section-title"))
+                yield app.localization.localized_widget(Static(
+                    "按需选择；分析器分别运行，可能增加准备时间。首次采集建议关闭。",
+                    classes="page-hint", markup=False,
+                ))
+                with Grid(classes="profiler-grid"):
+                    for widget_id, label, enabled in (
+                        ("torch-profiler", "PyTorch Profiler — 算子与框架计算分析",
+                         app.configuration.initial_config.compute_profile_tool in {"torch", "both"}),
+                        ("ncu-profiler", "NVIDIA NCU — GPU 内核性能分析",
+                         app.configuration.initial_config.compute_profile_tool in {"ncu", "both"}),
+                        ("massif-profiler", "Valgrind Massif — CPU 内存分析",
+                         app.configuration.initial_config.execution_profile_tool in {"massif", "both"}),
+                        ("nsys-profiler", "NVIDIA Nsys — CPU/GPU 执行时序分析",
+                         app.configuration.initial_config.execution_profile_tool in {"nsys", "both"}),
+                    ):
+                        yield app.localization.localized_widget(StatusCheckbox(
+                            label, value=enabled, id=widget_id,
+                            classes="config-control option-checkbox profiler-checkbox",
+                        ))
+
+                yield app.localization.localized_widget(Static("识别覆盖（通常留空）", classes="section-title"))
+                with Grid(classes="form-grid"):
+                    yield app.localization.localized_widget(Label("模型 revision"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.revision, id="revision", classes="config-control",
+                        placeholder="留空解析默认 revision；候选选择会固定 commit SHA",
+                    )), field_id="revision")
+                    yield app.localization.localized_widget(Label("Task"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.task,
+                        placeholder="如 text-generation",
+                        id="task",
+                        classes="config-control",
+                    )), field_id="task")
+                    yield app.localization.localized_widget(Label("Task family"))
+                    yield ConfigField(app.localization.localized_select(
+                        (
+                            ("自动识别", ""),
+                            ("NLP", "nlp"),
+                            ("CV", "cv"),
+                            ("Audio", "audio"),
+                            ("Time series", "timeseries"),
+                            ("Diffusion", "diffusion"),
+                            ("Multimodal", "multimodal"),
+                            ("结构化数据／策略", "structured"),
+                        ),
+                        value=app.configuration.initial_config.task_family,
+                        allow_blank=False,
+                        id="task-family",
+                        classes="config-control",
+                    ), field_id="task-family")
+                    yield app.localization.localized_widget(Label("Backend"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.backend,
+                        placeholder="留空自动识别",
+                        id="backend",
+                        classes="config-control",
+                    )), field_id="backend")
+                    yield app.localization.localized_widget(Label("模型接口声明"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.model_spec,
+                        placeholder="模型接口 JSON，可留空",
+                        id="model-spec",
+                        classes="config-control",
+                    )), field_id="model-spec")
+                    yield app.localization.localized_widget(Label("Workload manifest"))
+                    yield ConfigField(app.localization.localized_widget(Input(
+                        value=app.configuration.initial_config.workload_spec,
+                        placeholder="输入素材 manifest，可留空",
+                        id="workload-spec",
+                        classes="config-control",
+                    )), field_id="workload-spec")
+
+                with Collapsible(title=app.tr(message_id('ui.0223')), collapsed=True):
+                    with Grid(classes="form-grid"):
+                        for key, label, placeholder in (
+                            ("max-download", "下载预算", "5GB；留空不设上限"),
+                            ("model-store", "Model Store 路径", "留空使用用户缓存目录"),
+                        ):
+                            yield app.localization.localized_widget(Label(label))
+                            yield ConfigField(app.localization.localized_widget(Input(value=getattr(app.configuration.initial_config, key.replace("-", "_")),
+                                placeholder=placeholder, id=key, classes="config-control")), field_id=key)
+                        yield app.localization.localized_widget(Label("预计下载大小"))
+                        yield app.localization.localized_widget(Static("待解析", id="download-estimate", markup=False))
+                    yield app.localization.localized_widget(Static("下载策略：自动。使用系统网络环境。", markup=False))
+                    with Collapsible(title=app.tr(message_id('ui.0063')), collapsed=True):
+                        yield app.localization.localized_widget(Label("Model Store 容量上限"))
+                        yield ConfigField(app.localization.localized_widget(Input(value=app.configuration.initial_config.model_store_max,
+                            placeholder="100GB；留空不设上限", id="model-store-max", classes="config-control")), field_id="model-store-max")
+                        yield Static("", id="network-download-summary", markup=False)
+                    yield app.localization.localized_widget(Button("Model Store 占用与清理", id="open-model-store", classes="config-control"))
+
+                with Horizontal(classes="checkbox-row"):
+                    yield app.localization.localized_widget(StatusCheckbox(
+                        "启动 OOM 剪枝",
+                        value=app.configuration.initial_config.prune_startup_oom,
+                        id="prune-startup-oom",
+                        classes="config-control option-checkbox",
+                    ))
+                    yield app.localization.localized_widget(StatusCheckbox(
+                        "Idle 诊断",
+                        value=app.configuration.initial_config.idle_debug,
+                        id="idle-debug",
+                        classes="config-control option-checkbox",
+                    ))
+                with Horizontal(classes="button-row"):
+                    yield app.localization.localized_widget(Button("记住实验配置", id="save-run-default"))
+                with Collapsible(title=app.tr(message_id('ui.0680')), collapsed=True, id="image-build-options"):
+                    yield app.localization.localized_widget(StatusCheckbox(
+                        "重新构建镜像（仅本次）",
+                        value=app.configuration.initial_config.rebuild_image,
+                        id="rebuild-image",
+                        classes="config-control option-checkbox",
+                        tooltip="仅用于下一次采集或探测，不保存为默认配置；仍可使用 Docker 构建缓存。",
+                    ))
+
+        with Vertical(id="run-footer"):
+            yield app.localization.localized_widget(Static("", id="run-plan-summary", markup=False))
+            with Horizontal(id="run-actions", classes="action-bar"):
+                with Horizontal(classes="action-secondary"):
+                    yield app.localization.localized_widget(Button("高级参数", id="open-run-settings"))
+                    yield app.localization.localized_widget(Button("探测最大输入", id="probe-largest"))
+                with Horizontal(classes="action-primary"):
+                    yield app.localization.localized_widget(Button("开始采集", id="start-run", variant="primary"))
+
+
+def compose_monitor_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("运行监控", id="monitor-tab"):
+        with Vertical(id="monitor-panel"):
+            with Grid(id="status-grid", classes="page-header"):
+                yield app.localization.localized_widget(Static("阶段", classes="status-label"))
+                yield app.localization.localized_widget(Static("等待", id="status-stage", markup=False))
+                yield app.localization.localized_widget(Static("运行时间", classes="status-label"))
+                yield app.localization.localized_widget(Static(NOT_APPLICABLE, id="status-elapsed", markup=False))
+
+                yield app.localization.localized_widget(Static("Case", classes="status-label"))
+                yield app.localization.localized_widget(Static("0/0", id="status-case", markup=False))
+                yield app.localization.localized_widget(Static("资源", classes="status-label"))
+                yield app.localization.localized_widget(Static("CPU=—  MEM=—  GPU=—", id="status-resource", markup=False))
+
+                yield app.localization.localized_widget(Static("警告 / 错误", classes="status-label"))
+                yield app.localization.localized_widget(Static("0 / 0", id="status-errors", markup=False))
+                yield app.localization.localized_widget(Static("详情", classes="status-label"))
+                yield app.localization.localized_widget(Static("尚未启动", id="status-detail", markup=False))
+
+            yield Static("", id="status-preparation", markup=False)
+            with LogPanel(id="log-panel"):
+                with Horizontal(id="log-toolbar", classes="action-bar"):
+                    with Horizontal(classes="action-secondary"):
+                        yield app.localization.localized_widget(Button("复制选区", id="copy-log", classes="log-tool"))
+                        yield app.localization.localized_widget(Button("回到底部", id="follow-log", classes="log-tool"))
+                        yield app.localization.localized_widget(Button("放大日志", id="expand-log", classes="log-tool"))
+                        yield app.localization.localized_widget(Button("返回监控", id="restore-log", classes="log-tool"))
+                        yield app.localization.localized_widget(Button("清空日志", id="clear-log", classes="log-tool"))
+                    with Horizontal(classes="action-primary"):
+                        yield app.localization.localized_widget(Button(
+                            "终止任务", id="stop-run", classes="log-tool",
+                            variant="error", disabled=True,
+                        ))
+                yield SelectableLog(
+                    id="run-log",
+                    max_lines=app.configuration.preferences.log_max_lines,
+                    wrap=app.configuration.preferences.log_wrap,
+                )
+            with Horizontal(id="run-recovery-actions"):
+                yield app.localization.localized_widget(Button("恢复 / 重试", id="review-run-recovery"))
+
+
+def compose_plot_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("绘图工具", id="plot-tab"):
+        with Vertical(classes="page-header"):
+            yield app.localization.localized_widget(Static(
+                "读取结果 CSV，查看摘要或生成图表。", classes="page-summary", markup=False,
+            ))
+        with VerticalScroll(id="plot-body", classes="pane-scroll"):
+            with Grid(classes="form-grid tool-form-grid"):
+                yield app.localization.localized_widget(Label("结果 CSV"))
+                with Horizontal(classes="path-picker-row"):
+                    yield app.localization.localized_widget(Input(app.configuration.saved_settings.last_result_csv, id="result-csv"))
+                    yield app.localization.localized_widget(Button("选择实验", name="result-csv", id="choose-result-csv", classes="experiment-picker"))
+            yield app.localization.localized_widget(Static(
+                "选择或完成一次实验后，这里会显示结果摘要。",
+                id="result-summary",
+                markup=False,
+            ))
+        with Horizontal(id="plot-actions", classes="action-bar"):
+            with Horizontal(classes="action-secondary"):
+                yield app.localization.localized_widget(Button("读取摘要", id="summarize-results"))
+            with Horizontal(classes="action-primary"):
+                yield app.localization.localized_widget(Button("生成图表", id="plot-results", variant="primary"))
+
+
+def compose_reports_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("统计报告", id="reports-tab"):
+        with Vertical(classes="page-header"):
+            yield app.localization.localized_widget(Static(
+                "CSV / 目录：计算统计；JSON：查看报告。采集结束后操作。",
+                id="report-status", classes="page-summary", markup=False,
+            ))
+        with Vertical(id="report-panel"):
+            with app.localization.localized_widget(Collapsible(title="独立实验比较", collapsed=True, id="comparison-options")):
+                with Grid(classes="form-grid tool-form-grid"):
+                    for side, label in (("left", "左侧实验"), ("right", "右侧实验")):
+                        yield app.localization.localized_widget(Label(label))
+                        with Horizontal(classes="path-picker-row"):
+                            yield app.localization.localized_widget(Input(id=f"comparison-{side}", classes="report-control",
+                                placeholder="实验目录；同组多个目录用分号分隔"))
+                            yield app.localization.localized_widget(Button("选择实验", name=f"comparison-{side}", id=f"choose-comparison-{side}", classes="experiment-picker"))
+                    yield app.localization.localized_widget(Label("基线"))
+                    yield app.localization.localized_select((("左侧实验", "left"), ("右侧实验", "right")),
+                        value="left", allow_blank=False, id="comparison-baseline", classes="report-control")
+                    yield app.localization.localized_widget(Label("比较用途"))
+                    yield app.localization.localized_select((("相同硬件", "same-hardware"), ("跨硬件", "cross-hardware"), ("资源配置扩展", "resource-scaling")),
+                        value="same-hardware", allow_blank=False, id="comparison-purpose", classes="report-control")
+                yield app.localization.localized_widget(Button("比较实验", id="report-compare", classes="report-control"))
+            with Horizontal(classes="path-picker-row"):
+                yield app.localization.localized_widget(Input(
+                    app.configuration.saved_settings.last_result_csv, id="report-source", classes="report-control",
+                    placeholder="实验目录、结果 CSV 或报告 JSON 路径",
+                ))
+                yield app.localization.localized_widget(Button("选择实验", name="report-source", id="choose-report-source", classes="experiment-picker"))
+            yield Rule(classes="content-divider")
+            yield app.localization.localized_widget(ResizableDataTable(
+                id="report-table", cursor_type="row", zebra_stripes=True, fixed_columns=1))
+            yield app.localization.localized_widget(Static(
+                "表格可滚动；选择一行查看口径与数据来源。",
+                id="report-detail", markup=False,
+            ))
+        with Horizontal(id="report-actions", classes="action-bar"):
+            with Horizontal(classes="action-secondary"):
+                yield app.localization.localized_widget(Button("查看报告", id="report-open", classes="report-control"))
+            with Horizontal(classes="action-primary"):
+                yield app.localization.localized_widget(Button("计算统计", id="report-calculate", classes="report-control", variant="primary"))
+
+
+def compose_profile_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("补采工具", id="profile-tab"):
+        with VerticalScroll(id="profile-body", classes="pane-scroll"):
+            with Grid(classes="form-grid tool-form-grid"):
+                yield app.localization.localized_widget(Label("结果目录"))
+                with Horizontal(classes="path-picker-row"):
+                    yield app.localization.localized_widget(Input(app.configuration.saved_settings.last_result_dir, id="result-dir"))
+                    yield app.localization.localized_widget(Button("选择实验", name="result-dir", id="choose-result-dir", classes="experiment-picker"))
+                yield app.localization.localized_widget(Label("补采工具"))
+                with Grid(id="profile-tools"):
+                    for tool, label, tooltip in (
+                        ("torch", "torch · CPU / GPU", "逻辑 FLOP；点击或按空格切换。"),
+                        ("ncu", "ncu · GPU", "GPU 实际执行 FLOP；点击或按空格切换。"),
+                        ("nsys", "nsys · GPU", "CUDA API、kernel 和 memcpy 时间线；点击或按空格切换。"),
+                        ("massif", "massif · CPU", "CPU-only 进程生命周期内存峰值；点击或按空格切换。"),
+                    ):
+                        yield app.localization.localized_widget(StatusCheckbox(
+                            label,
+                            value=tool in {"torch", "ncu"},
+                            name=tool,
+                            id=f"profile-tool-{tool}",
+                            classes="option-checkbox profile-tool",
+                            tooltip=tooltip,
+                        ))
+        with Horizontal(id="profile-actions", classes="action-bar"):
+            with Horizontal(classes="action-secondary"):
+                yield app.localization.localized_widget(Button("补采计划（dry-run）", id="profile-dry-run"))
+            with Horizontal(classes="action-primary"):
+                yield app.localization.localized_widget(Button("执行补采", id="profile-run", variant="warning"))
+
+
+def compose_settings_tab(app: AcprofTui) -> ComposeResult:
+    with TabPane("应用设置", id="settings-tab"):
+        with Vertical(classes="page-header"):
+            yield app.localization.localized_widget(Static("应用设置", classes="page-title"))
+            yield app.localization.localized_widget(Static(
+                "修改立即生效，点击保存后下次启动沿用。",
+                id="settings-status", classes="page-summary", markup=False,
+            ))
+        with VerticalScroll(id="settings-body", classes="pane-scroll"):
+            with Vertical(id="settings-interface", classes="settings-section") as section:
+                app.localization.set_text(section, "界面与交互", "border_title")
+                with Grid(classes="form-grid"):
+                    yield app.localization.localized_widget(Label("界面语言"))
+                    yield app.localization.localized_select(
+                        LANGUAGE_OPTIONS,
+                        value=app.configuration.preferences.language, allow_blank=False,
+                        id="ui-language", classes="ui-preference",
+                    )
+                    yield app.localization.localized_widget(Label("界面主题"))
+                    yield app.localization.localized_select(
+                        THEME_OPTIONS,
+                        value=app.configuration.preferences.theme, allow_blank=False,
+                        id="ui-theme", classes="ui-preference",
+                    )
+                yield app.localization.localized_widget(StatusCheckbox(
+                    "显示底部快捷命令框",
+                    value=app.configuration.preferences.show_command_bar,
+                    id="ui-command-bar", classes="ui-preference option-checkbox",
+                ))
+            with Vertical(id="settings-logs", classes="settings-section") as section:
+                app.localization.set_text(section, "日志", "border_title")
+                with Grid(classes="form-grid"):
+                    yield app.localization.localized_widget(Label("保留日志行数"))
+                    yield app.localization.localized_select(
+                        ((str(n), n) for n in (500, 1000, 3000, 10000)),
+                        value=app.configuration.preferences.log_max_lines, allow_blank=False,
+                        id="ui-log-lines", classes="ui-preference",
+                    )
+                yield app.localization.localized_widget(StatusCheckbox(
+                    "日志自动换行", value=app.configuration.preferences.log_wrap,
+                    id="ui-log-wrap", classes="ui-preference option-checkbox",
+                ))
+            with Vertical(id="settings-connections", classes="settings-section") as section:
+                app.localization.set_text(section, "连接与权限", "border_title")
+                yield app.localization.localized_widget(Static(
+                    "配置 Hugging Face、代理、企业微信通知和采集权限。",
+                    classes="page-hint", markup=False,
+                ))
+                yield app.localization.localized_widget(Button("管理连接与权限", id="open-environment-settings"))
+            yield app.localization.localized_widget(Static("", id="settings-location", classes="page-hint", markup=False))
+        with Horizontal(id="settings-actions", classes="action-bar"):
+            with Horizontal(classes="action-secondary"):
+                yield app.localization.localized_widget(Button("恢复界面默认", id="restore-ui-defaults"))
+            with Horizontal(classes="action-primary"):
+                yield app.localization.localized_widget(Button("保存设置", id="save-ui-settings", variant="primary"))
+
+
+def compose_images_tab(app: AcprofTui) -> ComposeResult:
+    from acprof.tui.images import (
+        IMAGE_HINT,
+        IMAGE_PLATFORMS,
+        ImageDetailPanel,
+        ImageDetailResizeHandle,
+        ImageTable,
+        ImageTree,
+        ImageTreeHeader,
+        ImageWorkspace,
+    )
+
+    with TabPane("镜像管理", id="images-tab"):
+        with Horizontal(id="image-header", classes="page-header"):
+            with Vertical(id="image-heading"):
+                yield app.localization.localized_widget(Static(IMAGE_HINT, id="image-status", classes="page-summary", markup=False))
+        with Vertical(id="image-panel"):
+            with Horizontal(id="image-filters"):
+                yield app.localization.localized_select(
+                    (("AC-Prof 镜像", "acprof"), ("全部镜像", "all"), ("模型相关", "models"),
+                     ("公共依赖", "runtime"), ("公共基础", "base"),
+                     *((IMAGE_PLATFORMS[key], key) for key in ("cpu", "cu124", "cu128")),
+                     ("无标签", "untagged")),
+                    value="acprof", allow_blank=False, id="image-scope", classes="image-control",
+                )
+                yield app.localization.localized_widget(Input(
+                    placeholder="搜索模型、依赖、标签或镜像 ID", id="image-search", classes="image-control",
+                ))
+                for label, view in (("镜像树", "tree"), ("镜像列表", "list"), ("层共享", "layers")):
+                    yield app.localization.localized_widget(Button(
+                        label, id="image-view-" + view, classes="image-control image-view-button",
+                        variant="primary" if view == "tree" else "default",
+                    ))
+                yield app.localization.localized_widget(Button("存储空间", id="image-storage", classes="image-control"))
+            with ImageWorkspace(id="image-workspace"):
+                with ContentSwitcher(initial="image-tree-view", id="image-browser"):
+                    with Vertical(id="image-tree-view"):
+                        yield app.localization.localized_widget(ImageTreeHeader(
+                            id="image-tree-header", classes="image-control", show_cursor=False))
+                        yield ImageTree("", id="image-tree", classes="image-control")
+                    for table in (
+                        ImageTable(id="image-table", classes="image-control", cursor_type="row",
+                                   zebra_stripes=True, fixed_columns=1),
+                        ResizableDataTable(id="image-layer-table", classes="image-control", cursor_type="row", zebra_stripes=True),
+                    ):
+                        yield app.localization.localized_widget(table)
+                yield app.localization.localized_widget(ImageDetailResizeHandle(id="image-detail-resize", classes="image-control"))
+                yield ImageDetailPanel(id="image-detail-scroll")
+        with Horizontal(id="image-actions", classes="action-bar"):
+            with Horizontal(classes="action-secondary"):
+                for label, widget_id in (("勾选/取消", "image-toggle"),
+                                         ("选择同模型", "image-model"), ("清空选择", "image-clear")):
+                    yield app.localization.localized_widget(Button(label, id=widget_id, classes="image-control", disabled=True))
+            with Horizontal(classes="action-primary"):
+                yield app.localization.localized_widget(Button(
+                    "删除所选", id="image-delete", classes="image-control", variant="error", disabled=True,
+                ))