63 lines
3.1 KiB
Markdown
63 lines
3.1 KiB
Markdown
---
|
||
id: T-682
|
||
title: 收紧自定义网关模型配置区间距
|
||
phase: 5
|
||
deps: [T-680, T-681]
|
||
status: DONE
|
||
created: 2026-07-21
|
||
---
|
||
|
||
# T-682 收紧自定义网关模型配置区间距
|
||
|
||
## 问题 / 背景
|
||
|
||
设置页切换到「自定义网关」后，模型列表下方仍显示“模型详情”标题。当前模型已由列表选中，该标题不提供额外信息，却额外占用一行及其上下留白，使连接配置字段离模型名称操作过远。
|
||
|
||
## 方案
|
||
|
||
- 删除仅用于该区域的“模型详情”标题组件及其显隐逻辑。
|
||
- 保留模型选择框、「新增 / 重命名 / 删除」和其下全部模型配置字段、保存/测试按钮与测试结果。
|
||
- 将模型选择区到配置表单的固定间距收紧为 8px，使配置字段整体上移，但仍保留清晰的视觉分组，避免控件贴边或误认为同一行操作。
|
||
- 默认网关切换、自定义网关模型新增/重命名/删除、保存、连接测试、角色模型下拉与未保存更改语义保持不变。
|
||
|
||
## 验收要点
|
||
|
||
- [ ] 选择「自定义网关」后不显示“模型详情”文字。
|
||
- [ ] 模型配置表单紧跟模型选择区并按 8px 间距显示，字段没有重叠、裁切或顺序变化。
|
||
- [ ] 「新增 / 重命名 / 删除」、保存、测试连接、测试结果和标题/图片默认模型下拉仍可用。
|
||
- [ ] 切换默认网关/自定义网关后的面板显隐和待保存状态不回归。
|
||
- [ ] 所有用户可见文案保持中文。
|
||
|
||
## 测试与文档
|
||
|
||
- 更新 `tests/test_gui.py`：自定义网关不再存在“模型详情”标题，模型选择区与配置表单仍显示；默认/自定义网关切换回归。
|
||
- 更新 `docs/routes.md` 设置页自定义网关说明。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
py -3.10 -m unittest tests.test_gui
|
||
py -3.10 -m unittest discover -s tests
|
||
py -3.10 -m ruff check app tests main.py
|
||
py -3.10 -m compileall app main.py
|
||
git diff --check
|
||
```
|
||
|
||
## 边界（不改什么）
|
||
|
||
- 不改模型字段、模型名称管理、模型配置保存格式、默认模型引用或 API Key 处理。
|
||
- 不重排其它设置组，不改变默认网关字段、网关来源单选框、生成参数或路径端口区域。
|
||
- 不改 AI 请求、商品套图、Chrome/CDP、采集或更新蝦皮逻辑。
|
||
|
||
## 关联
|
||
|
||
- T-680：设置页同行网关来源单选框。
|
||
- T-681：自定义网关模型名称重命名。
|
||
|
||
## 执行记录
|
||
|
||
- 删除自定义网关专用的“模型详情”标题组件及其显隐逻辑；模型选择区后的固定间距由 14px 标题间隔收紧为 8px，模型配置表单随之上移，原有字段、保存/测试按钮和结果区域不变。
|
||
- 更新设置页路由说明，明确自定义网关直接在模型列表下显示紧凑配置字段。
|
||
- 更新 GUI 回归：默认网关隐藏模型选择与配置面板，自定义网关显示两者；不存在“模型详情”文字，并验证选择区与配置表单之间保留 8px 间距。
|
||
- 验证通过：`py -3.10 -m unittest tests.test_gui`（212 项）、`py -3.10 -m unittest discover -s tests`（653 项）、`py -3.10 -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`git diff --check`。
|