From 8fec0d26e8637a1c96dbcac841417fdd176d480a Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Sun, 07 Jun 2026 01:28:37 +0800
Subject: [PATCH] docs: add App Store Connect filling guide

---
 Scripts/window_logic_qa.sh |  109 +++++++++++++++++++++++++++++++++++++++---------------
 1 files changed, 79 insertions(+), 30 deletions(-)

diff --git a/Scripts/window_logic_qa.sh b/Scripts/window_logic_qa.sh
index 5935181..d30af67 100755
--- a/Scripts/window_logic_qa.sh
+++ b/Scripts/window_logic_qa.sh
@@ -349,6 +349,20 @@
   click_xy "$x" "$y"
 }
 
+open_overlay_from_dock_with_retry() {
+  local output=""
+  for _ in {1..3}; do
+    click_taglauncher_dock_tile
+    sleep 0.8
+    if output="$(wait_swift_assert overlay 2>&1)"; then
+      printf '%s\n' "$output"
+      return 0
+    fi
+  done
+  printf '%s\n' "$output" >&2
+  return 1
+}
+
 assert_frontmost_taglauncher() {
   local frontmost
   frontmost="$(osascript -e 'tell application "System Events" to get name of first application process whose frontmost is true')"
@@ -795,13 +809,13 @@
             && height >= 120
             && height <= 850
     }), let bounds = quickSearch[kCGWindowBounds as String] as? NSDictionary else {
-        fputs("FAIL: could not find quick search bounds\n", stderr)
+        fputs("FAIL: could not find quick search result-list bounds\n", stderr)
         exit(1)
     }
     let x = dimension(bounds, "X")
     let y = dimension(bounds, "Y")
     let width = dimension(bounds, "Width")
-    print("\(Int(round(x + width * 0.35))) \(Int(round(y + 125)))")
+    print("\(Int(round(x + width * 0.35))) \(Int(round(y + 190)))")
 case "fullscreen-target-center":
     guard let target = raw.first(where: { ($0[kCGWindowName as String] as? String) == "TagLauncherFullscreenQATargetFullscreen" }),
           let bounds = target[kCGWindowBounds as String] as? NSDictionary else {
@@ -1015,16 +1029,51 @@
   return 1
 }
 
+open_quick_search_with_retry() {
+  local output=""
+  for _ in {1..3}; do
+    send_quick_search_hotkey
+    sleep 0.8
+    if output="$(wait_swift_assert quick-search 2>&1)"; then
+      printf '%s\n' "$output"
+      return 0
+    fi
+  done
+  printf '%s\n' "$output" >&2
+  return 1
+}
+
+open_appgrid_quick_search_with_retry() {
+  local output=""
+  for _ in {1..3}; do
+    send_keycode 49
+    sleep 0.4
+    if output="$(wait_swift_assert quick-search 2>&1)"; then
+      printf '%s\n' "$output"
+      return 0
+    fi
+  done
+  printf '%s\n' "$output" >&2
+  return 1
+}
+
 assert_fullscreen_overlay_stable() {
   local output=""
+  local consecutive_successes=0
   for _ in {1..20}; do
-    if ! output="$(swift "$assert_swift" fullscreen-overlay 2>&1)"; then
-      printf '%s\n' "$output" >&2
-      return 1
+    if output="$(swift "$assert_swift" fullscreen-overlay 2>&1)"; then
+      consecutive_successes=$((consecutive_successes + 1))
+      if [[ "$consecutive_successes" -ge 6 ]]; then
+        printf '%s\n' "$output"
+        return 0
+      fi
+    else
+      consecutive_successes=0
     fi
     sleep 0.1
   done
-  printf '%s\n' "$output"
+  printf '%s\n' "$output" >&2
+  return 1
 }
 
 show_overlay() {
@@ -1063,9 +1112,9 @@
 
 hover_quick_search_results() {
   local coords x y
-  coords="$(swift "$coords_swift" quick-search-result)"
+  coords="$(quick_search_result_coords_with_retry)"
   read -r x y <<<"$coords"
-  for offset in 0 42 84 126 84 42 0; do
+  for offset in 0 8 16 8 0; do
     move_xy "$x" "$((y + offset))"
     sleep 0.08
   done
@@ -1073,9 +1122,22 @@
 
 click_quick_search_result() {
   local coords x y
-  coords="$(swift "$coords_swift" quick-search-result)"
+  coords="$(quick_search_result_coords_with_retry)"
   read -r x y <<<"$coords"
   click_xy "$x" "$y"
+}
+
+quick_search_result_coords_with_retry() {
+  local output
+  for _ in {1..8}; do
+    if output="$(swift "$coords_swift" quick-search-result 2>&1)"; then
+      printf '%s\n' "$output"
+      return 0
+    fi
+    sleep 0.15
+  done
+  printf '%s\n' "$output" >&2
+  return 1
 }
 
 page_scroll_appgrid() {
@@ -1179,9 +1241,7 @@
 assert_single_dock_tile
 swift_assert no-overlay
 log "==> QA Dock reopen: showDockIcon=true opens App Grid from explicit app reopen"
-click_taglauncher_dock_tile
-sleep 1.0
-wait_swift_assert overlay
+open_overlay_from_dock_with_retry
 send_keycode 53
 sleep 0.4
 wait_swift_assert no-overlay
@@ -1202,9 +1262,7 @@
 prepare_isolated_app_instance
 assert_no_dock_tile
 log "==> QA hidden Dock: Fn+Space Quick Search hover does not resurrect App Grid"
-send_quick_search_hotkey
-sleep 0.8
-wait_swift_assert quick-search
+open_quick_search_with_retry
 hover_quick_search_results
 sleep 0.8
 wait_swift_assert quick-search
@@ -1219,9 +1277,7 @@
 prepare_isolated_app_instance
 assert_no_dock_tile
 log "==> QA hidden Dock: clicking Quick Search result closes without showing App Grid"
-send_quick_search_hotkey
-sleep 0.8
-wait_swift_assert quick-search
+open_quick_search_with_retry
 click_quick_search_result
 sleep 1.4
 wait_swift_assert no-overlay
@@ -1244,9 +1300,7 @@
   wait_swift_assert fullscreen-overlay
   assert_fullscreen_overlay_stable
   log "==> QA fullscreen Space: quick search from appgrid does not switch Space"
-  send_keycode 49
-  sleep 0.4
-  wait_swift_assert quick-search
+  open_appgrid_quick_search_with_retry
   assert_fullscreen_overlay_stable
   send_keycode 53
   sleep 0.3
@@ -1278,8 +1332,7 @@
 swift_assert overlay
 
 log "==> QA 1/7 and 4/7: settings floats above appgrid and quick search"
-send_keycode 49
-sleep 0.4
+open_appgrid_quick_search_with_retry
 send_cmd_comma
 sleep 0.7
 swift_assert settings
@@ -1298,8 +1351,7 @@
 assert_frontmost_taglauncher
 
 log "==> QA 4/7 and 5/7: appgrid-space quick search and double-Esc behavior"
-send_keycode 49
-sleep 0.4
+open_appgrid_quick_search_with_retry
 send_keycode 53
 sleep 0.4
 swift_assert overlay
@@ -1311,9 +1363,7 @@
 show_overlay
 for _ in {1..5}; do
   page_scroll_appgrid
-  send_keycode 49
-  sleep 0.35
-  swift_assert quick-search
+  open_appgrid_quick_search_with_retry
   send_keycode 53
   sleep 0.25
   swift_assert overlay
@@ -1325,8 +1375,7 @@
 
 log "==> QA 5/7: clicking outside quick search closes search, not appgrid"
 show_overlay
-send_keycode 49
-sleep 0.4
+open_appgrid_quick_search_with_retry
 click_overlay_outside_quick_search
 sleep 0.4
 swift_assert overlay

--
Gitblit v1.9.3