# 需求背景

新版的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
```