edit | blame | history | raw

TagLauncher TODO

Workflow

  • 每次修改前先检查本文件。
  • 如果用户提出的新需求不在清单中，先新增到 Todo 或 In Progress。
  • 开始做任务时，把任务移动到 In Progress。
  • 任务完成并验证后，把任务移动到 Done，补一句完成结果。
  • 每个任务必须单独提交、单独构建、单独验收；验收通过后再进入下一个任务。
  • 每个任务的 QA 顺序固定为：自动化/半自动化验证 → QA 屏幕点击复核 → 用户最终体验验收。

In Progress

  • [2026-05-28] 第二批 AppKit 化第 1 项：清理 ContentView 的 App Grid 交互职责。
  • 分支: codex/post-freeze-new-requirement
  • 目标: 先做低风险状态收口，把 App Grid 的 bubble、drag、drop、refresh toast 等临时交互状态集中管理，降低后续标签栏 AppKit 化风险。
  • 原则: 不改变用户可见 UI，不改变拖拽/hover/Quick Search/窗口行为。
  • 验收: bash build.sh、codesign --verify --deep --strict、localization JSON 解析、App Grid 交互 targeted QA、必要时跑 Scripts/window_logic_qa.sh。
  • QA: 自动化通过后，由 QA 屏幕点击复核；用户只做最终体验验收。

Todo

  • [2026-05-28] 第二批 AppKit 化第 2 项：标签栏 AppKit 化第一阶段，只读导航。
  • 目标: 抽 TagNavItem / callbacks 边界，新增可回滚的 AppKit 标签栏。
  • 范围: 顶部、左侧、右侧标签栏显示；点击标签滚动到对应分组。
  • 暂不做: 标签拖拽排序。
  • 回滚: 保留旧 SwiftUI 标签栏作为开关。
  • 验收: 三种标签位置、点击滚动、长标签、多语言、全屏和 Split View。

  • [2026-05-28] 第二批 AppKit 化第 3 项：标签栏 AppKit 化第二阶段，hover 与容器高亮。

  • 目标: hover 标签时高亮对应容器，保留 colorless container 的填充/取消逻辑。
  • 验收: hover 触发频率、滚动不过度、视觉不闪烁、全屏/Split View 不跳 Space。

  • [2026-05-28] 第二批 AppKit 化第 4 项：标签栏 AppKit 化第三阶段，拖拽排序。

  • 目标: 用 AppKit hit-testing 替换 SwiftUI GeometryReader + preference 的标签排序命中逻辑。
  • 持久化: 继续走 TagEditor.reorderTags。
  • 验收: 顶部/左/右三种方向拖拽排序；关闭重开后顺序保留；数据库顺序正确。

  • [2026-05-28] 清理或改名 AppGridItem.swift 残留。

  • 目标: 该文件现在主要是 shared metrics / bubble 类型，不再是旧浏览态 grid，名称容易误导。
  • 验收: 构建通过，App Grid smoke test 通过。

  • [2026-05-28] Quick Search 结果列表 AppKit 化。

  • 目标: 先只替换结果列表，不动独立面板。
  • 保持: 输入框、搜索逻辑、快捷键行为不变。
  • 验收: 默认选中、上下键、Return、滚动、鼠标 hover、无结果状态。

  • [2026-05-28] Quick Search 独立面板化。

  • 目标: 从主 overlay 里拆出来，做 Spotlight 风格独立 NSPanel。
  • 风险: 高，涉及焦点、Esc、外部点击、全局快捷键、窗口层级。
  • 验收: 普通桌面、全屏、Split View、Settings 同时存在时都不跳 Space。

  • [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 模块化。

  • 目标: 低频路径后置整理。
  • 验收: 语言、通用、快捷键、标签、数据、关于页都保持现有行为。

Done

  • [2026-05-28] 冻结发布版本并从冻结 tag 拉出新需求分支。
  • 冻结 tag: appstore-7.6.0-20260527.0124
  • 新需求分支: codex/post-freeze-new-requirement
  • 说明: 新需求开发失败时可直接回到冻结 tag，不影响准备发布的版本。

  • [2026-05-28] 新增“拖出容器空隙只移除来源标签”的确认逻辑。

  • 提交: 71bfdd4、da71eb5
  • 行为: 非 Flat/list 的容器视图中，APP 拖到容器空隙时确认是否只移除来源容器对应的 1 个标签。
  • 补强: “知道了，以后不用再提醒我”改为清晰可见的自绘勾选框。
  • 验证: 用户已验证功能正常。