cmshoppe/docs/tasks/T-682.md

---
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`。