fix: fit main window within screen on startup

progress.md

@@ -1271,3 +1271,19 @@
 - 代码：`app/gui/main_window.py` 主窗口标题改为「蝦皮圈優化助手」；`app/gui/__init__.py` 的 PySide6 缺失启动提示带上中文品牌名；`tests/test_gui.py` 补充窗口标题断言。
 - 边界：只改显示层和文档层；`cmshopee` 继续作为仓库、包名、exe、数据库、日志、配置、回写后缀和兼容标识符保留；未改任何文件名、schema、AI、Excel、DB、CDP 或 Shopee 更新流程。
 - 验证：`python -m py_compile app\gui\main_window.py app\gui\__init__.py tests\test_gui.py` 通过；`python -m unittest discover -s tests -p test_gui.py` 通过（95 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过；`git diff --check` 通过。
+
+## 【2026-07-07】T-541 文档 · 打包版窗口左上角显示不全
+
+- 现象：运行打包后的 `dist/cmshopee/cmshopee.exe` / release 包时，Windows 10 虚拟机或小分辨率环境可能出现主窗口贴到屏幕左上角、左边和标题栏显示不全，用户看不到品牌标题且无法拖动窗口到中间。
+- 原因：`MainWindow.__init__()` 当前只 `resize(1180, 760)`，没有读取 `QApplication.primaryScreen().availableGeometry()` 限制初始尺寸、居中显示，也没有保证窗口标题栏完整落在可用屏幕内。
+- 文档：`docs/06-tasks.md` 新增 T-541；`docs/troubleshooting.md` 增加临时处理（`Alt+Space` → `M` → 方向键移动）和正式修复方案；`docs/packaging.md` 打包验收清单新增标题栏完整可见/可拖动检查；`docs/current-state.md` 记录 T-541 修复口径。
+- 方案：后续代码在主窗口启动时根据屏幕可用区域限制尺寸并居中，保证标题栏可见；小屏继续适配，不保存坏的历史窗口坐标。
+- 边界：本轮只更新文档，未改 GUI 代码、打包脚本、业务逻辑、DB、AI、Excel、CDP 或 Shopee 流程。
+
+## 【2026-07-07】T-541 完成 · 打包版主窗口初始位置与小屏适配
+
+- 状态：DONE
+- 代码：`app/gui/main_window.py` 新增 `_fit_and_center_window()`，启动时读取 `QApplication.primaryScreen().availableGeometry()`，将主窗口尺寸限制在可用屏幕范围内并居中；首次 `showEvent` 后再应用一次，避免打包版在 Windows 10 VM/小分辨率环境标题栏出屏。
+- 文档：`docs/06-tasks.md` 将 T-541 标记为 DONE；`docs/troubleshooting.md`、`docs/packaging.md`、`docs/current-state.md` 更新为当前修复与打包验收口径。
+- 测试：`tests/test_gui.py` 新增小屏和大屏 mock geometry 单测，覆盖尺寸限制与居中位置；`scripts/build_exe.ps1` 已重新构建 release，确认 T-541 合入后仍可打包。
+- 边界：不保存/恢复窗口历史坐标；未改业务流程、DB、AI、Excel、CDP/Shopee、打包产物结构或用户数据路径。