edit | blame | history | raw

2026-06-19 AppGrid 材质背景实现

用户目标

根据 /Users/ar/Projects/Taglauncher/src/Docs/Requirements/2026-06-19-app-grid-material-background.md 开发 App Grid 背景材质优化需求。

已完成事项

  • 读取全局与项目规则、CODE_GOVERNANCE.md、相关研发/交付/QA 规则和 macOS App 开发技能说明。
  • 按需求文档 Phase 1 的低风险路径实现:将 App Grid 根背景从 .hudWindow 改为 .contentBackground
  • 未修改 App Grid 布局、拖拽、Quick Search、卡片绘制参数、窗口层级或 macOS 15+ API。
  • 新增 src/Scripts/app_grid_material_background_qa.sh,防止 App Grid 背景回退到 .hudWindow,并断言背景保持不可命中。

文件变更

  • /Users/ar/Projects/Taglauncher/src/Apptag/ContentView.swift
  • /Users/ar/Projects/Taglauncher/src/Scripts/app_grid_material_background_qa.sh

QA 结果

  • git diff --check -- src/Apptag/ContentView.swift src/Scripts/app_grid_material_background_qa.sh:通过。
  • bash Scripts/app_grid_material_background_qa.sh:通过。
  • bash Scripts/macos14_availability_typecheck_qa.sh:通过,目标 arm64-apple-macosx14.0
  • bash build.sh:通过,生成 /Users/ar/Projects/Taglauncher/src/build/TagLauncher.app
  • bash Scripts/macos14_build_metadata_qa.sh:通过,LSMinimumSystemVersion=14.0minos=14.0arches=arm64
  • codesign --verify --deep --strict --verbose=2 /Users/ar/Projects/Taglauncher/src/build/TagLauncher.app:通过。
  • 本机启动构建版并用快捷键打开 App Grid,截图保存到 /Users/ar/Projects/Taglauncher/src/build/appgrid-material-smoke.png

未决问题

  • 本轮只完成需求文档建议的 Phase 1。未调整卡片填充、边框或阴影。
  • 未在真实 macOS 14 真机上人工覆盖 Light/Dark、Reduce Transparency、Increase Contrast 全矩阵;当前本机完成了编译、构建、元数据和一次视觉 smoke。

后续建议

  • 若主观视觉仍觉得卡片与背景层次不足,再按需求文档 Phase 2 小范围调 cardSurfaceColor() 或 hover shadow。