8 Commits

Author	SHA1	Message	Date
suzmii	d9c883675d	补充AGC模型目录异常revision的客户端用例 ... - 补充旧服务端不返回 revision（两次响应均为 undefined）时仍按目录变化刷新的用例 - 补充服务端目录重建导致 revision 回退（7 到 0）时仍更新界面的用例 - 补充 revision 未变化时不更新界面、沿用已应用目录的用例	2026-09-09 13:03:46 +08:00
suzmii	07fc26953a	修复AGC模型目录同步的加载态与保存竞态 ... - ConversationModelSelect：目录同步与配置读取/写回失败时统一在 finally 收起加载态，避免选择器永久卡在 busy、无法切换或刷新 - ConversationModelSelect：配置读取失败单独提示「读取客户端配置失败」，不再误报为模型目录加载失败 - ConversationModelSelect：配置写回串行化，发送前校验等待在途保存并读取最新配置，避免保存中放行旧选择、或用旧快照覆盖刚完成的选择 - ConversationModelSelect：服务端未返回 revision 时按目录已变化处理，避免界面停止刷新 - ProjectSupervisorView：提交前模型校验期间禁用输入框与发送按钮，避免重复提交与校验窗口内编辑丢失 - 测试：补充配置读取失败恢复、保存中发送前校验等待、目录请求去重用例；修正依赖配置读取时序的 appSurface 用例 - 文档：修正首页入口「按需加载」与实现不符的描述	2026-09-09 12:00:10 +08:00
suzmii	2942489575	Merge remote-tracking branch 'origin/master' into feat/agc-client-sync-llm-config ... # Conflicts: # apps/ai-game-creator-shell/src/features/project-workspace/ConversationModelSelect.tsx # apps/ai-game-creator-shell/src/features/project-workspace/ProjectSupervisorView.tsx # apps/ai-game-creator-shell/tests/conversationModelSelect.test.tsx # docs/technical/【技术方案】AGC后台模型别名与对话选择-2026-09-05.md	2026-09-09 10:04:05 +08:00
suzmii	a0e6a83691	修复 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
suzmii	4fc9451492	修复AGC客户端未跟随服务端默认模型 ... - 客户端配置新增 selectedModelIsDefault，记录当前选择是否来自平台默认项 - 服务端默认项变化时，跟随默认项的选择自动切换并提示，手动选择不受影响 - 所选模型失效回退默认项时标记为默认项选择 - 补充配置读写与客户端定向测试，同步技术方案文档	2026-09-08 16:38:37 +08:00
suzmii	d60c4ce6ec	优化AGC客户端同步LLM配置 ... - GET /api/llm/models 增加目录 revision，客户端据此做条件刷新 - AGC 客户端在项目切换、对话表面挂载、下拉展开、窗口聚焦时按 revision 条件刷新 - 模型目录请求同一时刻只保留一个在途请求，刷新失败保留上一次有效目录与本地选择 - 发起对话前校验所选模型，已停用或删除时回退默认模型并提示 - 新增模型目录缓存模块与定向测试，同步技术方案与后端架构文档	2026-09-08 16:11:36 +08:00
suzmii	34e3f70409	补充服务启动配置校验并优化模型菜单 ... 启动时校验 LLM Router 地址、模型和相关密钥配置 将刷新操作移入模型展开菜单并修复菜单样式覆盖 更新启动运维文档与定向测试	2026-09-05 19:48:27 +08:00
suzmii	4f3f0f24ff	接入AGC后台模型目录与对话模型选择 ... 新增后台 AGC 模型目录、别名、启停和默认项管理 客户端设置页恢复原状，对话框右下角按别名选择模型 服务端按稳定模型标识映射并校验实际模型白名单 修复 AGC 配套后端端口漂移、启动等待和 SpacetimeDB 版本检查 补充迁移、文档、启动与模型选择测试	2026-09-05 19:10:49 +08:00