DevFlow/temp/UX走查-设置全局域-2026-10-03.md

UX 走查 — 设置域与全局交互 (2026-10-03)

只读勘察,零代码改动。路径均相对 src/。已排除:UX token 化、settings.css 三防线、上传端点纵排、信任目录文案重叠、Ctrl+I 徽章、9-28#17 图片上传外域。 复现栏仅写关键步骤;修法一句话供派工参考。

P1 (2)

1. Escape 在分离窗口任意位置按下即关闭整窗(含输入中)

• 现象:ai-detached 分离窗口内,按 Esc(想关技能联想浮层/取消编辑/仅 blur)→ 整个分离窗口直接关闭。
• 根因:components/AiChat.vue:362-368 window 级 keydown 对 Esc 无 target 守卫,props.detached 分支直接 store.closeDetachedWindow();components/ai/ChatInput.vue:680-695 各 Esc 分支只 preventDefault() 不 stopPropagation(),照常冒泡到 window;composables/ai/useAiWindow.ts:247-265 关窗前不校验未发送内容(beforeunload 守卫对原生 close 不保证触发)。
• 复现:分离窗口 → 输入框打字 → 按 Esc → 窗口消失,输入内容丢失。
• 严重度:P1
• 修法:window Esc 分支加输入控件 target 守卫,且 ChatInput Esc 消费分支补 stopPropagation()。

2. 「测试连接」重拉模型列表静默清空用户已配 enabled/weight

• 现象:拉取模型→关掉部分模型/调权重→保存→再点「测试连接」→ 全部模型复位为 enabled + weight 50。
• 根因:components/settings/ProviderPanel.vue:484-493 探测合并仅保留 probe_source==='user_set' 的 modalities/capabilities,enabled/weight 一律取新探测值,旧记录(old)只用于判 isManual。
• 复现:AI 模型页 → 编辑 provider → 测试连接 → 调 weight/关模型 → 再点测试连接 → 设置全丢(无任何提示)。
• 严重度:P1
• 修法:合并时对已存在的 model_id 保留 old.enabled/old.weight,仅新增模型用探测默认值。

P2 (6)

3. 全局快捷键无输入焦点守卫(Ctrl+I 及同族 Ctrl+N/R/L/B/K)

• 现象:任意输入框打字时按 Ctrl+I → AI 面板被关闭/最大化;Ctrl+B → 会话侧栏被关;Ctrl+L → 弹清空对话确认。
• 根因:App.vue:153-158 handleKeydown 不检查 e.target;components/AiChat.vue:321-355 Ctrl+N/R/L/B/K 同样无守卫。
• 复现:焦点在设置搜索框/聊天输入框 → 按 Ctrl+I → 面板模式跳变。
• 严重度:P2
• 修法:各全局 handler 首行判 e.target 为 input/textarea/contenteditable(且无修饰需求)即 return。

4. 主题「跟随系统」不监听系统切换

• 现象:选 system 档后,OS 深浅色切换应用不跟随,需重启或重选档位。
• 根因:components/settings/AppearanceSection.vue:68-78 与 App.vue:145-148 均只 matchMedia(...).matches 取值一次,全仓无 addEventListener('change')。
• 复现:主题=跟随系统 → Windows 切深→浅 → 应用不变。
• 严重度:P2
• 修法:applyTheme 时对 matchMedia 挂 change 监听,theme==='system' 时重算 data-theme。

5. 顶栏点 provider 名「切换」实为静默改写全局默认 provider

• 现象:聊天顶栏点 provider bar 循环切换(toast 仅"已切换"),但后端互斥写 DB is_default — 与设置页「设为默认」同一 IPC ai_set_provider(src-tauri/src/commands/ai/commands/provider.rs:252-273)。设置页默认徽标随之漂移,新会话/负载均衡默认全被改。
• 根因:components/ai/TopBar.vue:542-554 → composables/ai/useAiPanel.ts:178-183 setProvider 直写默认;会话级 active 与 DB default 两概念共用一条 IPC。
• 复现:双 provider → 聊天顶栏点一下切到 B → 设置页 AI 模型列表:默认徽标已移到 B。
• 严重度:P2
• 修法:拆分 active(会话级,不落 is_default)与 default 两条命令,顶栏只改 active。

6. 关窗即隐入托盘,首次无任何解释

• 现象:无运行会话时点主窗 X → 窗口无声消失,进程驻留托盘;用户以为已退出(托盘通知气泡只在"有会话运行"且每进程一次时出现)。
• 根因:src-tauri/src/lib.rs:524-544 一律 prevent_close+hide;App.vue:227-233 tray-hide-notice 仅 running>0 才弹。
• 复现:无会话 → 点 X → 桌面无窗口、任务栏无项、无任何提示。
• 严重度:P2
• 修法:首次关窗也 emit 一次"已最小化到托盘"气泡,或设置页提供关窗行为开关(退出/托盘)。

7. Provider 表单脏态拦截只盖 Cancel 按钮,切分类/离开即丢

• 现象:编辑 provider(或调模型列表)后点左侧任一分类/路由离开 → 表单连同未保存修改无确认直接销毁。
• 根因:components/settings/ProviderPanel.vue:649-658 已暴露 isFormDirty 但注释自认"Settings.vue 未接入 nav 拦截";views/Settings.vue:25-34 v-else-if 切 activeCategory 即卸载面板。
• 复现:AI 模型页 → 改 baseUrl 不保存 → 点「性能」→ 回来全丢。
• 严重度:P2
• 修法:Settings.vue 在切分类/卸载前查 providerPanelRef.isFormDirty 走 confirmDialog。

8. 池权重 debounce 单计时器跨 provider 互踩,先改的静默丢

• 现象:连续给 A、B 两个 provider 改权重(间隔<300ms),A 的保存 IPC 被 clearTimeout 吞掉,视图值与库值漂移。
• 根因:components/settings/ProviderPanel.vue:603,631-641 _poolTimer 为全面板单例,A 乐观更新后计时被 B 的变更清掉。
• 复现:改 A 权重→立即改 B 权重→刷新:A 仍是旧值。
• 严重度:P2
• 修法:timer 按 provider id 建 Map,或新变更先 flush 前一待发。

P3 (10)

9. API 密钥输入无显隐切换,编辑态"留空=不改"无提示

• ProviderPanel.vue:95(type=password 恒定无眼睛钮)、:394(编辑清空 apiKey 但表单无 hint)。修法:加显隐 toggle + "留空保持原密钥" hint。

10. 表单校验只 toast 不定位字段;测试连接禁用无原因

• ProviderPanel.vue:534-537/ConnectionPanel.vue:177-186 缺哪个字段无高亮;ProviderPanel.vue:120 按钮禁用态无 tooltip 说明缺 baseUrl 还是 key。修法:字段级 inline 错误 + 禁用原因 title。

11. 「已保存」假成功族(反馈先于持久化结果)

• AppearanceSection.vue:9-39,86-89 markSaved 不等 set 结果;PerformanceSection.vue:118-128 debounce IPC 失败仅 console,前面已显"已保存";views/Settings.vue:44-50 anthropicCache 开关无任何反馈。修法:反馈挂 await/IPC 结果,失败改 error toast。

12. 日志级别"已保存"但运行时生效链路存疑

• AdvancedSection.vue:229-236 注释自认运行时是否读该值未知,UI 仍显"已保存"。修法:desc 注明生效时机或补齐热生效。

13. 连接表单 Cancel 无脏确认,保存无成功反馈

• ConnectionPanel.vue:37 直接关表单(对比 ProviderPanel L19 有确认);:176-209 saveConn 成功无 toast(删除反有)。修法:对齐脏确认+成功 toast。

14. 数值输入越界不拦:temperature/并发上限

• ProviderPanel.vue:549-552 temperature 仅判 isFinite,手输 99 照存(min/max 只限步进);PerformanceSection.vue:112 并发无上界。修法:保存前 clamp + 提示修正值。

15. i18n 残留硬编码中文 / 假环境信息

• App.vue:230 后台运行气泡;src-tauri/src/tray.rs:28-29,65-70 托盘菜单;components/ai/TopBar.vue:487 osInfo 恒 'Windows 11 / PowerShell'(非事实)。修法:入 i18n;osInfo 用 Tauri os 插件取真值。

16. 双全局 toast 同位重叠

• App.vue:317-327 df-toast 与 df-toast--info 都 fixed bottom:24px 居中,错误+托盘提示同现互相压盖。修法:合并进同一纵向堆叠容器。

17. 设置搜索每键强制跳分类

• SettingsNav.vue:131-144 输入即改 activeCategory+滚动,浏览 A 类打字被拽到 B 类。修法:输入只高亮,Enter/点击才跳转定位。

18. 无首次使用引导/空态引导单薄

• 全仓无 onboarding;provider 未配置仅 AI 顶栏一行红字(i18n/zh-CN/aiChat.ts:63),Dashboard/AiHome 无引导卡。修法:provider 为空时主界面一次性引导卡(直达设置)。