2026-06-19 AppGrid 材质需求

用户目标

将关于 App Grid 裸露区域毛玻璃/材质优化的讨论结论整理成研发和 QA 可落地的需求文档。

已完成事项

• 分析了当前代码现状：
• App Grid 主背景位于 src/Apptag/ContentView.swift，当前使用 VisualEffectView(material: .hudWindow, blendingMode: .behindWindow)。
• App Grid 分组卡片位于 src/Apptag/AppGridCollectionView.swift，当前为手绘圆角 surface，不是每张卡片独立 NSVisualEffectView。
• 当前项目最低系统版本为 macOS 14.0。
• 使用子代理从专业 macOS UI 设计角度评审了用户参考图和当前截图。
• 形成产品/研发决策：
• 不照搬 iOS 文件夹强毛玻璃。
• 使用 macOS 14 可用的语义 material 改善裸露区域质感。
• 优先尝试 .contentBackground，备选 .windowBackground。
• 避免 macOS 15+/26+ API、私有 API、自定义 blur shader。

文件变更

• 新增研发需求文档：
• src/Docs/Requirements/2026-06-19-app-grid-material-background.md

未决问题

• 研发实现后需要通过截图确认 .contentBackground 是否足够稳定；如背景噪声过强，再加轻量自适应 overlay。
• 卡片 opacity、border、shadow 是否需要 Phase 2 调整，应以 Phase 1 截图评审结果为准。

后续建议

• 第一版只改 App Grid 背景 material，保持 patch 小。
• QA 重点覆盖 macOS 14、Light/Dark、Reduce Transparency、Increase Contrast、全屏/Split View、Quick Search 覆盖 App Grid、拖拽和滚动行为。