cmshoppe/docs/tasks/T-682.md

id, title, phase, deps, status, created

id	title	phase	deps	status	created
T-682	收紧自定义网关模型配置区间距	5	T-680 T-681	TODO	2026-07-21

T-682 收紧自定义网关模型配置区间距

问题 / 背景

设置页切换到「自定义网关」后，模型列表下方仍显示“模型详情”标题。当前模型已由列表选中，该标题不提供额外信息，却额外占用一行及其上下留白，使连接配置字段离模型名称操作过远。

方案

• 删除仅用于该区域的“模型详情”标题组件及其显隐逻辑。
• 保留模型选择框、「新增 / 重命名 / 删除」和其下全部模型配置字段、保存/测试按钮与测试结果。
• 将模型选择区到配置表单的固定间距收紧为 8px，使配置字段整体上移，但仍保留清晰的视觉分组，避免控件贴边或误认为同一行操作。
• 默认网关切换、自定义网关模型新增/重命名/删除、保存、连接测试、角色模型下拉与未保存更改语义保持不变。

验收要点

• 选择「自定义网关」后不显示“模型详情”文字。
• 模型配置表单紧跟模型选择区并按 8px 间距显示，字段没有重叠、裁切或顺序变化。
• 「新增 / 重命名 / 删除」、保存、测试连接、测试结果和标题/图片默认模型下拉仍可用。
• 切换默认网关/自定义网关后的面板显隐和待保存状态不回归。
• 所有用户可见文案保持中文。

测试与文档

• 更新 tests/test_gui.py：自定义网关不再存在“模型详情”标题，模型选择区与配置表单仍显示；默认/自定义网关切换回归。
• 更新 docs/routes.md 设置页自定义网关说明。

验证

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：自定义网关模型名称重命名。

执行记录

• 待实现。