# UI 修复交付模式：Sticky Header + 证据优先验证

**日期：** 2026-02-27
**标签：** ui, viewer, testing, workflow, pr

## 背景

一个小型 UI 行为修复（viewer detail panel 的操作控件 sticky）需要以可靠证据交付，便于 review。

## 有效做法

1. 先应用最小化、仅 CSS 的修复，不改动 JS 行为。
2. 提前运行快速质量 gate（`ruff` + `pytest`）以快速发现回归。
3. 产出可视化证据（滚动前/后状态）供 PR review。
4. 在 `AGENTS.md` 添加明确流程要求，确保未来 UI 变更始终附带 E2E 验证与截图。

## 为什么这个模式好

- 低风险：改动面很小。
- review 清晰度高：截图可直接证明行为。
- 流程可复用：同样流程可应用于后续 UI 变更。

## 经验

对 UI 行为修复，证据是交付物的一部分。好的 PR 不只是“代码 + 测试”，还包括“可视化证明 + 明确验证步骤”。
