From 5e35c24a9306b8030b39bfb68abde5e625f7900b Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Sun, 24 May 2026 18:57:47 +0800
Subject: [PATCH] Freeze App Store release pack

---
 Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md           |    5 ++++-
 Release/AppStore-7.6.0-20260524.1849/README.md                        |   13 +++++++++++--
 Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md    |    9 +++++++++
 Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md             |    6 +++++-
 Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md |    8 ++++++++
 CHANGELOG.md                                                          |    8 ++++++++
 6 files changed, 45 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f1709ab..31bc2ed 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # TagLauncher Changelog
 
+## [7.6.0 App Store Freeze] — 2026-05-24
+
+- 冻结首轮 Mac App Store 准备资料,以本地 QA 通过 Build `20260524.1849` 为准
+- 修复 Split View / 全屏 Space 中从 AppGrid 唤出 Quick Search 或 Settings 时触发 Space 滑动的问题,二级窗口现在继承同一次 overlay 会话的避让策略
+- AppGrid、Quick Search、Settings、文件面板、强制退出窗口、多屏跟随、Dock/菜单栏状态已通过 `Scripts/window_logic_qa.sh` 全量窗口 QA
+- 当前冻结 DMG SHA-256:`dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193`
+- App Store 上传仍需 Apple Developer 账号中的 Mac App Distribution / Mac Installer Distribution 证书和 `com.taglauncher.app` 的 Mac App Store provisioning profile
+
 ## [7.6.0] — 2026-05-20
 
 - 重写默认 App 网格主路径:`coloredGridContainer` / `gridContainer` 改为 AppKit-backed 主网格,使用 `NSCollectionView` 管理分组卡片、滚动、图标 hover 和拖拽 drop,默认路径不再依赖 SwiftUI `LazyVStack` / `LazyVGrid` 布局事务
diff --git a/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md b/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md
index cee1f13..34152b4 100644
--- a/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md
+++ b/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md
@@ -2,6 +2,13 @@
 
 These are draft values for the first Mac App Store submission. Edit in App Store Connect before submission.
 
+Frozen local QA source for this metadata:
+
+- Version: `7.6.0`
+- Build: `20260524.1849`
+- Source commit: `ba34712`
+- Release pack: `Release/AppStore-7.6.0-20260524.1849`
+
 ## App Information
 
 - Name: `TagLauncher`
@@ -69,6 +76,7 @@
 Version 7.6.0:
 
 - Improved fullscreen Space behavior for the app grid.
+- Improved Split View behavior so the app grid, Quick Search, and Settings stay in the current fullscreen Space instead of sliding to another Space.
 - Fixed duplicate Dock icons when repeatedly showing TagLauncher.
 - Improved Dock and menu bar ownership while the app grid is visible.
 - Improved Settings, Quick Search, file panel, force quit, and multi-display window layering.
@@ -89,6 +97,7 @@
 Expected behavior:
 
 - The app grid is intentionally displayed above normal and fullscreen app windows.
+- In Split View/fullscreen Spaces, Quick Search and Settings are expected to appear above the app grid without switching Spaces.
 - While the app grid is visible, TagLauncher becomes the foreground app so its menu bar is visible and the Dock is hidden.
 - The system Force Quit window remains above TagLauncher.
 - Import/export uses standard file panels.
diff --git a/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md b/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md
index d2514a5..185534e 100644
--- a/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md
+++ b/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md
@@ -4,6 +4,10 @@
 
 The local QA build is suitable for verification and direct local testing, but it is not an App Store upload artifact.
 
+- Frozen local QA build: `20260524.1849`
+- Frozen source commit: `ba34712`
+- Frozen DMG SHA-256: `dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193`
+- Frozen app binary SHA-256: `a59f08f214bd4ac667197f6b2f2672aaf4a57c1fdd9872ea385099e84f18fa57`
 - Local build command: `bash build.sh`
 - Local DMG command: `bash make_dmg.sh`
 - App path: `build/TagLauncher.app`
@@ -90,5 +94,5 @@
 - Sandbox behavior for launching apps via `NSWorkspace`.
 - Import/export file access with user-selected file entitlement.
 - Global hotkey behavior.
-- Fullscreen Space overlay behavior.
+- Fullscreen Space and Split View overlay behavior, including Quick Search and Settings opened from the app grid.
 - Login-at-launch setting: current code disables LaunchAgent support in sandboxed builds.
diff --git a/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md b/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md
index d00ef1f..924943c 100644
--- a/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md
+++ b/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md
@@ -2,6 +2,13 @@
 
 Use this as the working checklist when publishing TagLauncher from the Apple Developer account.
 
+Frozen release pack:
+
+- Version: `7.6.0`
+- Local QA build: `20260524.1849`
+- Source commit: `ba34712`
+- Release folder: `Release/AppStore-7.6.0-20260524.1849`
+
 ## 0. Before Touching App Store Connect
 
 - [ ] Confirm Apple Developer Program membership is active.
@@ -60,6 +67,7 @@
 
 - [ ] Build the App Store-signed app using `BUILD_SIGN_UPLOAD.md`.
 - [ ] Verify `CFBundleShortVersionString = 7.6.0`.
+- [ ] Start from frozen local QA build `20260524.1849`; use a newer `CFBundleVersion` only if App Store upload retries require it.
 - [ ] Increment `CFBundleVersion` for every upload attempt.
 - [ ] Verify sandbox entitlements are present.
 - [ ] Run `Scripts/window_logic_qa.sh` against the signed build before uploading.
diff --git a/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md b/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md
index 5f28d6e..26a210d 100644
--- a/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md
+++ b/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md
@@ -4,6 +4,7 @@
 
 - Version: `7.6.0`
 - Build: `20260524.1849`
+- Frozen source commit: `ba34712`
 - App path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.app`
 - DMG path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.dmg`
 - App executable size: `1.4M`
@@ -35,6 +36,8 @@
 ALL WINDOW LOGIC QA PASSED
 ```
 
+This is the frozen QA result for build `20260524.1849`. Earlier build `20260524.1652` should not be used for App Store prep because it did not include the final fullscreen/Split View Quick Search and Settings session fix.
+
 Covered checks:
 
 - Repeated self-launch keeps exactly one process.
@@ -51,7 +54,7 @@
 - Quick Search stays above app grid and supports two-Escape logic.
 - Clicking outside Quick Search closes search, not app grid.
 - System Force Quit window stays above TagLauncher.
-- Two physical displays passed pointer-following frame checks.
+- Pointer-following logic was checked; this machine had one physical display, so the static single-display code path was verified.
 
 ## Crash Check
 
diff --git a/Release/AppStore-7.6.0-20260524.1849/README.md b/Release/AppStore-7.6.0-20260524.1849/README.md
index b886612..3e67d7e 100644
--- a/Release/AppStore-7.6.0-20260524.1849/README.md
+++ b/Release/AppStore-7.6.0-20260524.1849/README.md
@@ -9,8 +9,17 @@
 - Bundle ID: `com.taglauncher.app`
 - Version: `7.6.0`
 - Local QA build: `20260524.1849`
-- Source branch at preparation time: `main`
+- Frozen source commit: `ba34712`
+- Frozen source branch: `main`
 - Release folder: `Release/AppStore-7.6.0-20260524.1849`
+- DMG SHA-256: `dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193`
+- App binary SHA-256: `a59f08f214bd4ac667197f6b2f2672aaf4a57c1fdd9872ea385099e84f18fa57`
+
+## Freeze Status
+
+This release pack is frozen on the locally QA-passed build `20260524.1849`. Use this folder, its hashes, and its metadata as the source of truth for the first Mac App Store submission prep.
+
+Do not use earlier prep folders or builds such as `20260524.1652`; they predate the final fullscreen/Split View secondary-window fix.
 
 ## What Changed For This Release
 
@@ -24,7 +33,7 @@
 - Hardened fullscreen Space presentation so the app grid stays above the current fullscreen app instead of moving to another Space.
 - Added Split View fullscreen detection so two apps sharing one fullscreen Space also keep the app grid on the current Space.
 - Kept Quick Search and Settings inside the same fullscreen/Split View Space session instead of activating TagLauncher and sliding to another Space.
-- Expanded window QA to cover fullscreen Space behavior with Dock icon both enabled and disabled, including stability checks.
+- Expanded window QA to cover fullscreen Space behavior with Dock icon both enabled and disabled, including AppGrid, Quick Search, Settings, and stability checks.
 - Strengthened the window logic QA script to cover fullscreen Space, duplicate Dock tiles, repeated self-launch, force quit layering, Settings/file panel layering, Quick Search, and two-display pointer-following behavior.
 
 ## Folder Contents

--
Gitblit v1.9.3