mirror of
https://github.com/Syngnat/GoNavi.git
synced 2026-07-14 17:03:25 +08:00
b2df94a3ba
## 问题描述 macOS 多屏环境下，普通窗口恢复/修正位置时可能被定位到当前屏幕外，尤其是在外接屏位于主屏左侧或上方、浏览器 `screen.availLeft/availTop` 出现全局偏移时更容易触发。 ## 复现条件说明 该问题不是所有 macOS 用户都能稳定复现，更依赖特定显示器布局和窗口状态。高概率触发条件包括： - 使用 macOS 多屏。 - 外接屏位于主屏左侧或上方，导致 `screen.availLeft` / `screen.availTop` 为负数或非零。 - GoNavi 处于普通窗口态，而不是最大化或全屏。 - 应用保存过窗口位置，并在重启、切屏、拔插显示器、focus/resize 后触发窗口 bounds 恢复或修正。 单屏 mac、外接屏仅位于主屏右侧、始终最大化/全屏打开，或未保存过异常窗口位置的用户通常不容易触发。 ## 根本原因 Wails 的 `WindowSetPosition(x, y)` 在 macOS 上接收的是当前 monitor 可见区域内的局部坐标，而不是全局桌面坐标。原逻辑把 `window.screen.availLeft/availTop` 作为可见区起点传入恢复算法，导致保存的局部坐标和恢复时的全局偏移混用。 ## 修复方案 - 新增 `resolveWailsWindowVisibleViewport`，集中处理 Wails 主窗口恢复使用的可见区域。 - macOS 下将可见区原点固定为当前 monitor 局部 `(0, 0)`，避免把浏览器 screen 全局偏移继续传给 Wails。 - 补充单元测试覆盖负 `availLeft` 的外接屏场景。 - 更新 App 窗口恢复源码断言测试。 ## 变更文件 | 文件 | 修改说明 | 变更行数 | |---|---|---| | `frontend/src/App.tsx` | macOS 下使用 Wails 局部坐标解析窗口可见区 | +7 -7 | | `frontend/src/utils/wailsWindowViewport.ts` | 新增 Wails 窗口可见区解析工具 | +52 | | `frontend/src/utils/wailsWindowViewport.test.ts` | 覆盖 macOS 局部原点和 fallback 场景 | +43 | | `frontend/src/App.tool-center.test.ts` | 同步窗口恢复源码断言 | +2 -1 | ## 合并注意事项 - **影响功能点**：桌面端普通窗口启动恢复、focus/resize 后窗口 bounds 修正。 - **验证方式**： - `npm test -- --run src/utils/wailsWindowViewport.test.ts src/utils/windowRestoreBounds.test.ts src/utils/windowStartupLayout.test.ts src/App.tool-center.test.ts` - `npm run build` - **回归风险**：低。变更集中在窗口可见区解析；非 macOS 平台保留原 `screen.availLeft/availTop` 处理。 - **回滚方式**：revert 此 PR 即可。