张家训
2.5 KiB
2.5 KiB
底部工具区与公共历史表格优化设计
目标
根据用户验收截图修复两个公共 UI 问题：消除应用顶部重复操作入口，并让 API、扫描、MyBatis SQL 导出的共享历史表格使用稳定、可读且无 filler 空白的列宽布局。
应用外壳
- 顶部栏只保留 WorkUtils 品牌、插件面包屑/页面标题和弹性留白。
- 顶部不创建
MENU或SETTINGS按钮；删除而不是按状态隐藏。 NavigationRail底部建立独立工具区，与业务插件列表通过 1px 分隔线分组。- 工具区固定顺序为：系统设置、展开/收缩。展开/收缩永远是最底部控件。
- 展开态设置入口显示 Feather 齿轮和“系统设置”；折叠态只显示齿轮，同时保留 Tooltip 和 accessible text。
- 设置入口复用现有
openSettingsEmbedded路由和内容区，不创建新窗口、不改变配置格式。 - 设置入口使用与业务导航一致的 hover、selected、focus 语义；进入插件时取消设置选中态，进入设置时清除业务插件选中态。
公共历史表格
- 修复点只位于共享
ExportHistoryPane，不为 API 页面增加专属列或条件分支。 - 表格维持六个真实语义列：操作、序号、查询/格式、生成文件、数量、时间；不添加空列。
- 操作列固定 150px，序号列固定 64px，查询/格式列固定 140px，数量列固定 88px，时间列固定 180px。
- 生成文件列是唯一可调整列，最小 220px，并吸收表格扣除固定列后的全部剩余宽度。
- 使用 JavaFX constrained resize policy，使表头和数据行铺满可用宽度，不出现右侧 filler。
- Scanner、MyBatis SQL 导出、API 历史继续通过原有
ExportHistoryPane构造器使用同一策略。
验收与回归
- 架构测试证明顶部没有 MENU/SETTINGS 按钮，底部工具区顺序正确。
- 行为测试覆盖设置路由、插件返回、折叠 Tooltip/accessibility 和底部唯一折叠入口。
- 表格测试覆盖列数、列标题、固定列宽、序号紧凑、文件列唯一增长以及宽表格无 filler。
- 运行聚焦测试、全量测试、编译和
git diff --check。 - 用真实 JavaFX Scene 截图与用户截图同批对照；不伪造 Windows 原生标题栏。
自审
- 范围仅包含已批准的外壳入口调整和共享历史表格布局。
- 没有 API 专属 hack、空 filler 列、新窗口、配置迁移或业务行为变化。
- 所有尺寸、顺序和选择语义均已明确，没有待定项。