需求背景

新版的Mac系统去掉了launch pad

访问APP的方式放到了spotlight里面

新版的spotlight用五指去抓触摸板的时候会调出APP列表，而且也做了分组.

但是分组的名称是系统定义死的，不可更改.

需求描述 v0

设计一个在Mac上可以安装的APP

APP名称：Apptag

这个APP（Apptag）有以下功能

用户可以自定义在spotlight里面查看APP列表时的分组名称.

这些分组名称的来源:根据用户给APP在finder里面所添加的标签，并将将这些标签显示为spotlight里面APP列表的分组名称。

备忘

1

   ◆ Hermes: Plan saved at `/Users/ar/Projects/Apptag/.hermes/plans/2026-05-05_124500-apptag-design.md`              │
│                                                                                                                     │
│             Here's the architecture at a glance:                                                                    │
│                                                                                                                     │
│             ```                                                                                                     │
│             Apptag.app (menubar-only, no dock icon)                                                                 │
│               AppIndexer  →  scans for .app bundles                                                                 │
│               TagStore    →  reads Finder tags via NSURL API                                                        │
│               ContentView →  full-screen overlay with blurred bg                                                    │
│               HotkeyMgr   →  global shortcut (default: ⌥+Space)                                                     │
│             ```                                                                                                     │
│                                                                                                                     │
│             Four build phases: (1) tag reading + scanning, (2) overlay UI, (3) grouped grid rendering, (4) hotkey + │
│ preferences.                                                                                                        │
│                                                                                                                     │
│             ---                                                                                                     
│                                                                                                                     │
│             A quick design call: now's the time to weigh in on defaults. I'm thinking:                              │
│                                                                                                                     │
│             - Default hotkey: Option+Space (avoids conflict with Spotlight's Cmd+Space)                             │
│             - Untagged apps group: shown under "Other" but user can rename it                                       │
│             - Search: filters as you type, live results                                                             │
│             - Appearance: follows system theme (light/dark)                                                         │
│                                                                                                                     │
│             Sound right, or want to tweak any of those? Otherwise I'll start building.         

2

All five phases done. Here's what was built:

Apptag — at /Users/ar/Projects/Apptag/build/Apptag.app

How to launch:

open ~/Projects/Apptag/build/Apptag.app

What it does:

• Scans /Applications, ~/Applications, and /System/Applications for .app bundles
• Reads Finder tags via the native NSURL tag API (the same tags you set in Finder's "Tags" field)
• Displays them in a full-screen overlay with a frosted-glass background
• Groups apps by their tags — untagged apps go under "Other" (renameable in Preferences)
• Search bar at the top filters in real-time, Enter opens the first match
• Escape or clicking the backdrop dismisses the overlay
• Shift+Option+Space triggers the overlay (Carbon hotkey API, no Accessibility permission needed)
• Menubar icon (tag.fill) as backup trigger + right-click menu

Currently on your system: 51 apps already have Finder tags, so you'll see real groupings immediately.

3

code-sign it with an ad-hoc signature

4

  ┊ 📖 preparing read_file…
  ┊ 📖 read      /Users/ar/Projects/Apptag/Apptag/ApptagApp.swift  1.1s
  ┊ 👁️ preparing vision_analyze…
  ┊ 👁️  vision    Describe what text or controls are cut off or truncated in this Settings/Preferences window screenshot. What's the layout and where are things not fitting?  0.2s [error]

 ⚕ Hermes 
    Vision not available, but based on the code I can see the issues. Three changes:
    
    1. Remove "Grouping" section (the Other name field)
    2. Widen the window and use proper layout to prevent text truncation  
    3. Swap Columns Stepper for a Slider like font size