suzmii
a0e6a83691
Project CI / Backend tests (push) Failing after 7m10s
Project CI / Repository checks (push) Successful in 2m19s
Project CI / Frontend tests (push) Successful in 3m32s
Project CI / Native shell tests (push) Failing after 19m48s
修复 AGC 模型选择入口、交互与默认模型回退 (#299)
### 背景
AGC 后台已支持维护 LLM 模型目录（`agc_model_catalog`），客户端此前只在项目右侧对话浮出模型选择，且存在几个体验问题：
1. 首页聊天框架缺少模型选择入口；
2. 首次进入项目时，右侧模型选择器「点不动」（被 disabled）；
3. 模型选择下拉失去焦点不自动收起；
4. 默认模型缺少可视标识；
5. 已保存的选择被后台停用/移除后，客户端显示「请选择模型」，未自动回退默认模型；首页因懒加载在打开前也一直显示「选择模型」。
### 改动内容（完整变更集）
- **首页聊天框架新增模型选择入口**，复用项目右侧对话的 `ConversationModelSelect`；上传按钮在左，模型选择器与发送按钮在右（同一组，模型选择器紧挨发送按钮）。
- **修复首次进入项目时右侧模型选择器点不动**：选择器不再因目录加载（`busy`）或对话进行中（`controlBusy`）被禁用；切换模型只写回客户端配置并作用于后续轮次，发送仍由 `controlBusy` / `modelReady` 把关。
- **模型下拉支持点击外部 / Esc 自动收起**：给组件容器挂 ref，监听 `document` 的 `mousedown` 与 `keydown`，点击容器外或按 Esc 即收起（仅在展开时挂监听）。
- **默认模型增加「默认」标识**：组件记录 `defaultModelId`，在下拉选项中给默认模型显示小标签；亮暗主题自适应。
- **模型选择始终回退默认模型**：已保存选择仍可用时沿用；被停用/移除或从未选择时回退到后台默认模型并写回配置；只有默认模型本身不可用才走错误分流。首页由「懒加载」改为「挂载即加载」，触发按钮直接落在默认模型上，不再出现「选择模型」空态。
- **清理**：移除组件中已无调用方的 `lazy` 加载路径。
- **文档**：同步更新 `【技术方案】AGC后台模型别名与对话选择-2026-09-05.md`（首页入口、对话进行中可切换模型、失焦收起等行为）。
### 关键交互/行为说明
- 触发按钮永远显示模型名（默认或当前选择），不再出现「选择模型」占位，除非默认模型不可用。
- 模型下拉的加载中、刷新、选中态沿用原有交互；默认模型有「默认」标签，便于识别。
- 首页模型选择器不改动「开启创作」门控：目录不可用时仍可创建项目并走后台默认项。
### 验证
- `npm run test -- apps/ai-game-creator-shell/tests/conversationModelSelect.test.tsx` -> 7/7 通过
- `npm run test -- apps/ai-game-creator-shell/tests/appSurface.test.ts` -> 386/386 通过
- `npm run ai-game-creator-shell:typecheck` 通过
- `npm run check:encoding`（4309 文件）通过
- `git diff --check` 通过
### 影响范围与注意事项
- 变更集中在 AGC 客户端（`apps/ai-game-creator-shell`），不涉及 SpacetimeDB schema / 后端接口 / 契约。
- `GET /api/llm/models` 语义不变（仍只返回启用项 + 默认项），本次不改后端。
- 模型下拉在窄屏的换行/遮挡，以及「默认」标签对比度，建议在真机确认一下观感（单测只覆盖逻辑）。
### 关联
- 无关联 Issue；本 PR 独立提交。
---------
Co-authored-by: 段舒康 <kdletters@qq.com>
Reviewed-on: #299
Co-authored-by: 董羽秦 <suzmii@qq.com>
Co-committed-by: 董羽秦 <suzmii@qq.com>
2026-09-08 22:05:15 +08:00
..
2026-09-05 19:48:27 +08:00
2026-09-08 22:05:15 +08:00
2026-09-01 17:00:44 +08:00
2026-09-01 17:00:44 +08:00
2026-08-22 13:17:26 +08:00