From 02793fb1086b1fa791ae8642b631e06639b62bcc Mon Sep 17 00:00:00 2001
From: chengma <chengma2027@gmail.com>
Date: Tue, 21 Jul 2026 09:29:30 +0800
Subject: [PATCH] docs(tasks): add custom gateway layout task

---
 docs/tasks/T-682.md | 59 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 docs/tasks/T-682.md

diff --git a/docs/tasks/T-682.md b/docs/tasks/T-682.md
new file mode 100644
index 0000000..2ea9dae
--- /dev/null
+++ b/docs/tasks/T-682.md
@@ -0,0 +1,59 @@
+---
+id: T-682
+title: 收紧自定义网关模型配置区间距
+phase: 5
+deps: [T-680, T-681]
+status: TODO
+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：自定义网关模型名称重命名。
+
+## 执行记录
+
+- 待实现。