From 86f0b4bd20cdec86dfb5bdb7978d1f6ff4af111a Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Fri, 14 Aug 2026 22:41:54 +0800
Subject: [PATCH] [verified] feat: export performance diagnostics

---
 CHANGELOG.md |   77 ++++++++++++++++++++++++++++++++++++++
 1 files changed, 77 insertions(+), 0 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 87858d1..8814333 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,82 @@
 # Changelog
 
+## 0.1.14 / 20260814.2230
+
+- 新增本地性能诊断包导出入口，可从菜单栏或 Aligner 应用菜单保存为 zip 并发送给测试负责人。
+- 诊断包包含版本、设备与显示器、权限、偏好、最近 Quick Switch 性能阶段、应用名称和窗口数量，以及循环性能日志。
+- 诊断包不包含窗口标题、截图或键入内容；新增归档结构单测，覆盖 zip 的摘要、性能日志和说明文件。
+
+## 0.1.13 / 20260814.0445
+
+- 修复 Quick Switch 在 App Shelf 自动换成两行时，首行 App 图标被 Space Lane 裁挡的问题。
+- App Shelf 两行布局改为按真实行高预留 shelf 高度，并保持 Space Lane / App Shelf / Waterfall 的固定纵向间距。
+- 增强 App Shelf fixture QA，断言两行 App 图标必须完整落在 shelf 内，并保留 Space Lane 与 Waterfall 间距。
+
+## 0.1.12 / 20260625.2320
+
+- 修复 App Shelf 图标点击误触关闭的问题：图标主体点击优先打开该 App 的第一个窗口，只有明确点到关闭按钮视觉区域才进入关闭确认。
+- 过滤低置信 AX-only 普通窗口候选：非最小化、非全屏且没有高置信 Space 归属的 AX-only 残留不再进入 Quick Switch，避免 App badge 数量和 Waterfall 卡片虚高。
+- 激活明确失败时，本次投影视图会抑制失败 windowID，避免用户继续点到同一张不可激活的 stale 卡片。
+- 增强 App Shelf 鼠标 fixture 和窗口激活 fixture，覆盖 near-close 图标点击不进关闭流、激活失败目标被移除。
+
+## 0.1.11 / 20260625.1705
+
+- 优化 Finder 多页签 / CG-only 窗口激活的等待体验：交互路径增加 1.5 秒预算和阶段耗时日志，避免一次点击长时间卡在系统等待态。
+- Finder 页签循环兜底从 24 轮收敛为最多 5 轮；5 轮无法命中时快速返回失败，不再继续高耗时硬转。
+- Finder 直接 AX / WindowServer 激活后新增前台标题校验：标题不匹配时进入有预算的页签 fallback，避免把“看似激活成功但实际跳错页签”记录为成功。
+- Window activation QA 报告新增 `lastActivationDurationMilliseconds`，并补源码 guardrail 验证 5 轮循环上限和预算字段。
+
+## 0.1.10 / 20260624.2359
+
+- 修复 Quick Switch 窗口卡片点击偶发不准的问题：鼠标命中测试改用动画中的 presentation frame，避免过滤、对齐或横栏滚动动画期间点到视觉卡片却按旧位置提交。
+- 强化真实窗口激活链路：窗口级 AX 动作从 focus / raise 扩展为 focus / main / raise，并在 AX 短暂缺失或首次动作失败时重读一次目标窗口再尝试前置。
+- 激活 / 关闭服务接入 live Space resolver，和 snapshot 使用同一套 SkyLight Space 数据，降低 Finder、多页签、跨 Space 场景的错误 host fallback。
+- `appActivatedOnly` 不再作为窗口卡片精准激活成功语义；它只保留为诊断结果。
+- 修正 Obsidian 跨 Space live QA 在环境不满足时的脚本崩溃，改为明确 skipped 并记录原因。
+
+## 0.1.9 / 20260624.2019
+
+- 新增 Dock reopen 打开 Quick Switch：用户从 Dock 重新点击 / 双击 Aligner 图标时，复用 `Option+Tab` 的 Quick Switch 打开路径。
+- Dock reopen 只负责打开 Quick Switch，不改主题、视图模式或布局选择，全部沿用现有默认逻辑。
+- 增加 Dock reopen fixture QA，并纳入主 UI 回归入口；同步放宽真实 `Option+Tab` 触发 QA 的默认等待，降低事件 tap 启动时序误判。
+
+## 0.1.8 / 20260624.1311
+
+- 将 Aligner 的最低系统版本下探到 macOS 14.0，统一 SwiftPM、Info.plist、AppInfo 和 public manifest 元数据。
+- 为 `ScreenCaptureKit` 的 `includeChildWindows` 增加 macOS 14.2 可用性保护，保证 macOS 14.0 / 14.1 可编译运行。
+- 增加 macOS 14 兼容 QA 入口，并补 release manifest / release config 的最低系统版本 guardrail。
+
+## 0.1.7 / 20260622.1828
+
+- 修复 App Shelf 真实 hover 在 view-model / 截图刷新后丢失的问题：鼠标停在 App 图标上不动时，图标保持放大和上浮，Waterfall 联动保持有效。
+- 纵栏瀑布和横栏瀑布共用同一套 hover 持久化逻辑。
+- 增强 App Shelf fixture QA，新增 view-model rebuild 后 hover 仍保持的纵栏 / 横栏回归。
+
+## 0.1.6 / 20260622.1734
+
+- 修复 App Shelf hover 视觉覆盖不完整的问题：纵栏瀑布和横栏瀑布下都去掉 App 图标外侧蓝色矩形边框。
+- 保留真实 hover App 图标本身放大和轻微上浮，不恢复邻居图标跟随。
+- 增强 App Shelf fixture QA，新增横栏瀑布 case，并断言背景层、容器层、图标层边框均为 0。
+
+## 0.1.5 / 20260622.1717
+
+- 收敛 App Shelf hover 视觉：保留真实 hover App 图标放大效果，但移除图标背后的蓝色矩形底。
+- 取消邻近 App 图标视觉跟随，左右邻居不再放大、不上浮、不暴露 `magneticNeighbor`。
+- 增强 App Shelf fixture QA，验证 hover 背景透明、邻居保持普通尺寸、close button 只属于真实 hover App。
+
+## 0.1.4 / 20260622.1641
+
+- 优化 App Shelf hover 动效为 Magnetic Dock Lite：当前 App 图标放大并轻微上浮，邻近图标做轻量跟随。
+- 邻近 App 只做视觉动效，不触发 hover 语义、不显示关闭按钮、不联动 Waterfall / Space。
+- 用户开启 Reduce Motion 时禁用磁性放大动效。
+- 增强 App Shelf fixture QA，覆盖浅色 / 深色主题、邻近图标动效、hover 语义隔离和横栏瀑布回归。
+
+## 0.1.3 / 20260620.1337
+
+- 增加 Option 两位窗口码输入过程中的 Waterfall 实时筛选反馈：第一键筛选 App 时，匹配窗口保持亮，其它 Waterfall 窗口变暗。
+- 增加单窗口 App 首键直达：当某个 App 当前只有一个可见窗口时，按该 App 序号会直接打开唯一窗口，不再等待第二个窗口序号。
+- 增加两位码筛选 fixture QA，并纳入主 UI 回归入口。
+
 ## 0.1.2 / 20260620.0319
 
 - 修复深色模式下 Space tile hover 浅色高亮时，Space 编号、窗口数量、App 文本、Split View 标签、角标线和占用条仍为浅色导致不可读的问题。

--
Gitblit v1.9.3