| | |
|---|
| | | |
|---|
| | | ## Todo |
|---|
| | | |
|---|
| | | - [2026-05-28] OverlayWindowController 收口。 |
|---|
| | | - 目标: 把 `AppDelegate` 里的 overlay 显示、隐藏、层级、屏幕选择拆出去。 |
|---|
| | | - 时机: Quick Search 窗口边界稳定后再做。 |
|---|
| | | - 验收: 全屏、Split View、Settings、Force Quit、文件面板、Dock 图标重复问题。 |
|---|
| | | |
|---|
| | | - [2026-05-28] AppLibraryController / 数据刷新管线整理。 |
|---|
| | | - 目标: 把扫描、reconcile、Smart Start、annotate、Quick Search documents 更新从 `ContentView` 中抽离。 |
|---|
| | | - 验收: 启动扫描、拖拽改标签、Quick Search 索引同步、新安装 App 后刷新。 |
|---|
| | | |
|---|
| | | - [2026-05-28] 设置页和 Smart Start 模块化。 |
|---|
| | | - 目标: 低频路径后置整理。 |
|---|
| | | - 验收: 语言、通用、快捷键、标签、数据、关于页都保持现有行为。 |
|---|
| | | - [发布后独立任务] 设置页 tab 容器 AppKit/自控化评估与实现。 |
|---|
| | | - 决策: 当前发布前 No-Go；保留 SwiftUI `TabView`，不改 QA 脚本。 |
|---|
| | | - 背景: QA 过程中曾观察到设置页顶部 tab 偶发折叠/消失，但目前不是稳定可复现 release blocker。 |
|---|
| | | - 约束: 必须单独开分支、单独提交、单独构建、单独 QA、单独验收；不得混入当前 quick search/window 修复或 App Store 发布包。 |
|---|
| | | - 改动边界: 优先只改 `Apptag/PreferencesView.swift`；不碰 `AppDelegate`、`OverlayWindowController`、窗口层级、quick search、App Grid、数据导入导出逻辑。 |
|---|
| | | - 风险点: 需要保留 Language/General/Hotkeys/Tags/Data/About 六页行为；特别注意 `Tags` 页 `scanApps()`、`Data` 页 `refreshDataState()`、语言热切换、toast/confirmation overlay、固定 `880x460` 布局高度和 accessibility。 |
|---|
| | | - 验证要求: `bash build.sh`、`codesign --verify --deep --strict`、`Scripts/window_logic_qa.sh`；手工复核 6 个设置页、全屏/Split View 中 Settings 层级、文件面板层级、长文本语言和键盘/辅助功能导航。 |
|---|
| | | |
|---|
| | | ## Done |
|---|
| | | |
|---|
| | | - [2026-05-29] 版本拆分与 7.8.1 默认图标大小调整。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: `CHANGELOG.md` 已补充 `7.7.0`、`7.8.0`、`7.8.1` 三段版本记录；源码版本号更新为 `7.8.1`；新用户默认 `iconSize` 从 `80` 调整为 `64`。 |
|---|
| | | - 范围: 只影响无既有 `iconSize` 偏好设置的新安装用户；已有用户保存过的图标大小不会被覆盖。 |
|---|
| | | - 验证: 构建、签名、DMG 校验。 |
|---|
| | | |
|---|
| | | - [2026-05-29] 第二批：AppGrid 滚动流畅性优化。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: AppGrid 滚动期间只在滚动 burst 开始时通知 SwiftUI 清理 hover 气泡，不再每次 bounds 变化重复写状态；滚动停止后再恢复 hover replay 和 visible item runtime state。 |
|---|
| | | - 范围: 不改布局算法、不改拖拽、不改 hover 气泡展示规则，只降低滚动期间的刷新频率。 |
|---|
| | | - 验证: `bash build.sh`、`codesign --verify --deep --strict`、`Scripts/window_logic_qa.sh` 全部通过；滚动后 Space/Esc 连续循环 QA 保持通过。 |
|---|
| | | |
|---|
| | | - [2026-05-29] 第一批：未分类拖拽确认记忆 + 滚动后键盘兜底。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: “拖到未分类”弹窗新增独立“不再提醒”checkbox 和 `skipUncategorizedDropConfirm` 持久化；overlay 键盘处理增加 AppKit `sendEvent` 兜底；AppGrid 滚轮进入时重新声明 key/front，避免滚动后 Space/Esc 偶发丢失。 |
|---|
| | | - 范围: 不改拖到空隙移除单标签语义；不改全屏/Split View 窗口层级；不改 Quick Search 独立面板结构。 |
|---|
| | | - 验证: `bash build.sh`、`codesign --verify --deep --strict`、`Scripts/window_logic_qa.sh` 全部通过；新增滚动后 Space/Esc 连续循环 QA；屏幕 smoke 验证滚动后 Space 打开 Quick Search、Esc 关闭 Quick Search、再次 Esc 关闭 AppGrid。 |
|---|
| | | |
|---|
| | | - [2026-05-29] 设置页和 Smart Start 模块化。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: `SmartStartNoticeOverlay` 已从 `ContentView` 拆出；设置页“应用系统智能化初始分类”的扫描、Smart Start 应用和 snapshot 组装改由 `AppLibraryController` 统一处理；窗口 QA 脚本同步适配 `OverlayWindowController` 的屏幕选择静态检查。 |
|---|
| | | - 范围: 不改设置页 UI 布局、不改 Smart Start 分类规则、不改导入/导出/恢复行为。 |
|---|
| | | - 验证: `bash build.sh`、`codesign --verify --deep --strict`、设置页语言/通用/快捷键/标签/数据/关于六个 tab 屏幕复核、`Scripts/window_logic_qa.sh` 全部通过。 |
|---|
| | | |
|---|
| | | - [2026-05-29] AppLibraryController / 数据刷新管线整理。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: 新增 `AppLibraryController` 和 `AppLibrarySnapshot`，把扫描、reconcile、Smart Start、annotate、Quick Search documents、标签颜色和标签顺序组装从 `ContentView` 的刷新路径中抽离。 |
|---|
| | | - 范围: 不改扫描、数据库、搜索匹配、拖拽改标签逻辑；`ContentView` 只应用 snapshot 并刷新 UI。 |
|---|
| | | - 验证: `bash build.sh`、`codesign --verify --deep --strict`、启动 App Grid 屏幕复核、Quick Search `sor` 索引复核、上下键复核、`Scripts/window_logic_qa.sh` 全部通过。 |
|---|
| | | |
|---|
| | | - [2026-05-29] OverlayWindowController 收口。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: 新增 `OverlayWindowController`，将 overlay window 实例、generation、Space 避让、show/focus/hide 编排、panel 创建、屏幕选择、全屏/Split View 判定从 `AppDelegate` 中收口出去。 |
|---|
| | | - 范围: AppDelegate 保留菜单、热键、Settings、Quick Search 和 app chrome 协调入口；窗口策略保持原行为。 |
|---|
| | | - 验证: `bash build.sh`、`codesign --verify --deep --strict`、`Scripts/window_logic_qa.sh` 全部通过，覆盖全屏、Split View、Settings、Force Quit、文件面板、Dock 图标重复和屏幕跟随。 |
|---|
| | | |
|---|
| | | - [2026-05-29] Quick Search 独立面板化。 |
|---|
| | | - 提交: 本次提交 |
|---|
| | | - 结果: Quick Search 面板已从主 overlay SwiftUI 层拆出，改为独立 `NSPanel` 并作为 overlay child window 显示；搜索状态、输入框、结果列表、启动逻辑保持原路径。 |
|---|
