crazy-macs/tag-launcher.git

parent: bd792cd3 | patch | commit | ignore whitespace

Record 7.9.1 build 20260614.1454 release pack

Ariver

2026-06-14 1ed3b22d0c1dfe2d9e1b78ab4ecb63e4d7f91425

Record 7.9.1 build 20260614.1454 release pack

9 files added

	src/Release/AppStore-7.9.1-20260614.1454/APP_REVIEW_NOTES.md	39 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/APP_STORE_CONNECT_METADATA.md	114 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/APP_STORE_RELEASE_CHECKLIST.md	48 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg	patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/PKG_PREFLIGHT_REPORT.md	56 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/QA_RELEASE_EVIDENCE.md	74 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/README.md	31 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/RELEASE_MANIFEST.md	80 ●●●●● patch \| view \| raw \| blame \| history
	src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg	patch \| view \| raw \| blame \| history

 src/Release/AppStore-7.9.1-20260614.1454/APP_REVIEW_NOTES.md

New file
@@ -0,0 +1,39 @@
# App Review Notes

## English

TagLauncher is a local macOS utility for organizing and launching installed apps by tag. No account or demo login is required.

How to test:

1. Launch TagLauncher.
2. Open the App Grid from the menu bar icon or press Option-Shift-Space.
3. Use Quick Search from the grid by pressing Space.
4. Create or use a tag group, then drag an app icon within the same group to change the display order.
5. Create an empty tag in Settings > Tags; the empty tag remains visible in the App Grid with a minimal placeholder container.
6. Drag an app to blank space outside containers to remove that tag assignment.
7. Open Settings > General to hide or show App Grid usage tips.
8. Open Settings > Data to export or import the local category layout.

Version 7.9.1 build 20260614.1454 fixes incomplete localized App Grid usage-tip text in non-Chinese languages. It keeps the existing 7.9.1 empty-tag visibility, macOS 14 blank-space tag removal behavior, and App Grid usage guidance improvements. The app does not collect user data and does not use analytics, ads, tracking, accounts, or cloud sync.

If the Dock icon is hidden, the menu bar icon remains available. The Dock visibility setting can be changed in Settings > General.

## Simplified Chinese

TagLauncher 是一个本地 macOS 工具，用于按标签整理和启动已安装的应用。不需要账号或演示登录。

测试方式：

1. 启动 TagLauncher。
2. 点击菜单栏图标打开 App Grid，或按 Option-Shift-Space。
3. 在 App Grid 中按 Space 打开 Quick Search。
4. 创建或使用一个标签分组，在同一个分组内拖动应用图标即可调整显示顺序。
5. 在 Settings > Tags 创建一个空标签；空标签会继续显示在 App Grid 中，并带有最小占位容器。
6. 把应用拖到容器外空白处，可以移除该标签归属。
7. 打开 Settings > General，可以关闭或开启 App Grid 底部使用技巧。
8. 打开 Settings > Data，可以导出或导入本地分类布局。

版本 7.9.1 build 20260614.1454 修复非中文语种下 App Grid 使用技巧文案显示不完整的问题，并保留 7.9.1 已有的空标签显示、macOS 14 下空白处解除标签行为和 App Grid 使用引导改进。本应用不收集用户数据，不包含分析、广告、追踪、账号或云同步。

如果 Dock 图标被隐藏，菜单栏图标仍可使用。Dock 显示设置可在 Settings > General 中调整。

 src/Release/AppStore-7.9.1-20260614.1454/APP_STORE_CONNECT_METADATA.md

New file
@@ -0,0 +1,114 @@
# App Store Connect Metadata Draft

Generated: 2026-06-14

## App Information

- Name: `TagLauncher`
- Bundle ID: `com.taglauncher.app`
- SKU: `taglauncher-macos`
- Category: `Utilities`
- Version: `7.9.1`
- Build: `20260614.1454`
- Minimum macOS: `14.0`

## URLs

- Marketing URL: `https://shanghai3168.github.io/taglauncher/index.html`
- Support URL: `https://shanghai3168.github.io/taglauncher/support.html`
- Privacy Policy URL: `https://shanghai3168.github.io/taglauncher/privacy.html`
- Chinese Privacy Policy URL: `https://shanghai3168.github.io/taglauncher/privacy-zh.html`

## Subtitle Options

- English: `Tag-based app launcher`
- English: `Beyond Launchpad folders`
- Simplified Chinese: `标签化应用启动器`

## What's New

### English

Version 7.9.1 build 20260614.1454 fixes localized App Grid usage-tip text in non-Chinese languages so the instructions are complete and easier to read in the two-line tips HUD.

This build keeps the 7.9.1 App Grid improvements: empty tag groups stay visible, dragging an app to blank space outside containers can remove its tag assignment more reliably on macOS 14, and the App Grid includes native usage tips that can be hidden in Settings.

### Simplified Chinese

版本 7.9.1 build 20260614.1454 修复非中文语种下 App Grid 使用技巧文案显示不完整的问题，让两行提示中的操作说明更完整、更容易阅读。

本 build 继续保留 7.9.1 的 App Grid 改进：空标签会持续显示，macOS 14 上把应用拖到容器外空白处解除标签更稳定，App Grid 底部原生使用技巧提示也可在设置中关闭。

## Description Draft

### English

TagLauncher is a fast tag-based launcher for Mac apps.

Organize installed apps into visual tag groups, open a fullscreen-friendly app grid from a global hotkey, and jump directly to apps with Quick Search. It is designed for people who have many apps and want a calmer, faster way to find the right one without hunting through Launchpad, Finder, or the Dock.

Highlights:

- Open the app grid with Option-Shift-Space.
- Search apps, tags, and notes with Quick Search.
- Group apps by custom tags.
- Reorder apps inside each tag group.
- Tune icon size, tag position, app list style, Dock visibility, and usage tips visibility.
- Import and export your category layout.
- Works across multiple displays and fullscreen Spaces.
- Keeps data local on your Mac, with no account required.

### Simplified Chinese

TagLauncher 是一个基于标签的 Mac 应用启动器。

你可以把已安装的应用整理成可视化标签分组，用全局快捷键唤出应用网格，也可以通过 Quick Search 直接搜索应用、标签和备注。它适合安装了很多应用、希望更快找到目标应用的人。

亮点：

- 使用 Option-Shift-Space 打开应用网格。
- 使用 Quick Search 搜索应用、标签和备注。
- 用自定义标签整理应用。
- 在同一个标签分组内手动调整应用顺序。
- 可调整图标大小、标签位置、列表样式、Dock 显示和使用技巧显示。
- 支持分类布局的导入和导出。
- 支持多显示器和全屏 Space 场景。
- 数据保存在本机，无需账号。

## Keywords

English:

`launcher,launchpad,tags,apps,organizer,notes,backup,hotkey,search,utility,macos`

Simplified Chinese:

`启动器,启动台,标签,应用,整理,排序,备忘,备份,快捷键,搜索,效率,工具`

## Promotional Text

English:

`Organize Mac apps by tag, reorder each group by drag, and launch faster with a keyboard-friendly grid and Quick Search.`

Simplified Chinese:

`用标签整理 Mac 应用，拖拽调整分组内顺序，再用快捷键和 Quick Search 更快启动应用。`

## App Privacy Recommended Answers

- Data collection: `No, this app does not collect data`
- Tracking: `No`
- Analytics: `No`
- Ads: `No`
- Data linked to user: `No`

Explanation:

TagLauncher indexes installed apps locally so users can organize and launch them. Tags, notes, preferences, app order, tips visibility, and layout data stay on the user's Mac. The app does not include ads, analytics SDKs, tracking, account registration, or cloud sync in this build.

## App Review Information

- Demo account required: `No`
- Contact email: `shanghai3168@gmail.com`
- Review notes: use `APP_REVIEW_NOTES.md`

 src/Release/AppStore-7.9.1-20260614.1454/APP_STORE_RELEASE_CHECKLIST.md

New file
@@ -0,0 +1,48 @@
# App Store Release Checklist

Version: `7.9.1`

Build: `20260614.1454`

## Before Upload

- [x] Source commit frozen: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
- [x] Release directory created under `src/Release/AppStore-7.9.1-20260614.1454`
- [x] Marketing version kept at `7.9.1`
- [x] Build updated to `20260614.1454`
- [x] DMG generated and verified
- [x] App Store `.pkg` generated with Installer certificate
- [x] Final `.pkg` expanded and inspected
- [x] Bundle ID, version, build, category, and minimum macOS verified
- [x] Embedded provisioning profile verified
- [x] Signed entitlements verified
- [x] `com.apple.quarantine` absent from expanded package
- [x] SHA256 recorded
- [x] Release tag created: `v7.9.1-build20260614.1454`

## Upload With Transporter

1. Open Transporter for macOS.
2. Add this package:

```text
/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg
```

3. Deliver the package.
4. Wait for App Store Connect processing to finish.
5. In App Store Connect, open the TagLauncher macOS version `7.9.1` page.
6. Select build `20260614.1454`.
7. Fill metadata from `APP_STORE_CONNECT_METADATA.md`.
8. Fill review notes from `APP_REVIEW_NOTES.md`.
9. Submit for review.

## Do Not Upload

- Do not upload `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`.
- Do not upload any temporary package under `/private/tmp` or `/var/folders`.

## After Upload

- Record App Store Connect processing result.
- If Apple rejects the binary, do not reuse the same build number for a new package. Increment `CFBundleVersion` with a new `YYYYMMDD.HHMM` build.

 src/Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg

Binary files differ

 src/Release/AppStore-7.9.1-20260614.1454/PKG_PREFLIGHT_REPORT.md

New file
@@ -0,0 +1,56 @@
# TagLauncher 7.9.1 App Store `.pkg` 预检报告

生成日期：2026-06-14

上传包：

`Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

SHA256：

`7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`

## Build Inputs

| 项目 | 值 |
| --- | --- |
| Version | `7.9.1` |
| Build | `20260614.1454` |
| Bundle ID | `com.taglauncher.app` |
| Team ID | `CR3J54M8BQ` |
| Minimum macOS | `14.0` |
| Category | `public.app-category.utilities` |
| App signing identity | `0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C` |
| Installer signing identity | `3rd Party Mac Developer Installer: Hainan Wanxing Technology Co., Ltd. (CR3J54M8BQ)` |
| Provisioning profile | `TagLauncher Mac App Store 20260605.2337` |
| Profile UUID | `da7839d6-2489-4272-b999-c61efccfe473` |
| Profile expiration | `2027-06-04 21:48:21 CST` |

## Verification

| 检查项 | 结果 |
| --- | --- |
| `.pkg` 文件生成 | PASS |
| `.pkg` Installer 证书签名 | PASS |
| 展开最终 `.pkg` 并找到 `TagLauncher.app` | PASS |
| Bundle ID | PASS: `com.taglauncher.app` |
| `CFBundleShortVersionString` | PASS: `7.9.1` |
| `CFBundleVersion` | PASS: `20260614.1454` |
| `LSMinimumSystemVersion` | PASS: `14.0` |
| `LSApplicationCategoryType` | PASS: `public.app-category.utilities` |
| 嵌入 `embedded.provisionprofile` | PASS |
| Profile application identifier | PASS: `CR3J54M8BQ.com.taglauncher.app` |
| Signed application identifier | PASS: `CR3J54M8BQ.com.taglauncher.app` |
| Signed team identifier | PASS: `CR3J54M8BQ` |
| Signed sandbox entitlement | PASS |
| Signed user-selected file entitlement | PASS |
| Signed keychain access groups | PASS: `CR3J54M8BQ.*` |
| Expanded package has `com.apple.quarantine` | PASS: `0` |
| Package payload AppleDouble `._*` entries | PASS: `0` |
| Executable architecture | PASS: `arm64` |

## Next Upload Step

Use Transporter and select:

`/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

 src/Release/AppStore-7.9.1-20260614.1454/QA_RELEASE_EVIDENCE.md

New file
@@ -0,0 +1,74 @@
# QA Evidence - TagLauncher 7.9.1 build 20260614.1454

## Target

- Version: `7.9.1`
- Build: `20260614.1454`
- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
- DMG: `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
- PKG: `Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

## Automated QA

| Check | Result |
| --- | --- |
| `git diff --check -- src/Apptag/Info.plist src/CHANGELOG.md src/Apptag/AppGridCollectionView.swift src/Scripts/usage_tips_qa.sh src/Apptag/Localization` | PASS |
| `Scripts/usage_tips_qa.sh` | PASS |
| `Scripts/app_ordering_data_qa.sh` | PASS |
| `Scripts/macos14_availability_typecheck_qa.sh` | PASS |
| `Scripts/macos14_build_metadata_qa.sh` | PASS |
| `Scripts/quick_search_app_name_qa.sh` | SKIP: Sunlogin wrapper app not installed on this Mac |
| `Scripts/quick_search_system_app_qa.sh` | PASS |
| `Scripts/smartstart_catalog_resource_qa.sh` | PASS |

## Localization QA

| Check | Result |
| --- | --- |
| 27 non-Chinese languages, tips 1-8 each contain exactly one ASCII comma separator | PASS |
| 27 non-Chinese languages, tips 1-8 have no `>`, `->`, `-->`, `→`, or `＞` separator | PASS |
| 27 non-Chinese languages, both sides of the separator are non-empty | PASS |
| `zh-Hans` and `zh-Hant` usage-tip copy unchanged in this fix | PASS |

## Manual Acceptance

| Check | Result |
| --- | --- |
| App Grid usage tips paging and click behavior | PASS: user manually accepted before this packaging step |

## Package Verification

| Check | Result |
| --- | --- |
| DMG generated | PASS |
| `hdiutil verify` | PASS |
| Built app version/build | PASS: `7.9.1 / 20260614.1454` |
| App Store `.pkg` generated | PASS |
| `.pkg` Installer certificate signature | PASS |
| Expanded `.pkg` contains `TagLauncher.app` | PASS |
| Bundle ID | PASS: `com.taglauncher.app` |
| `CFBundleShortVersionString` | PASS: `7.9.1` |
| `CFBundleVersion` | PASS: `20260614.1454` |
| Minimum macOS | PASS: `14.0` |
| Category | PASS: `public.app-category.utilities` |
| Embedded provisioning profile | PASS |
| Profile application identifier | PASS: `CR3J54M8BQ.com.taglauncher.app` |
| Signed application identifier | PASS: `CR3J54M8BQ.com.taglauncher.app` |
| Signed team identifier | PASS: `CR3J54M8BQ` |
| Sandbox entitlement | PASS |
| User-selected file read/write entitlement | PASS |
| Keychain access group | PASS: `CR3J54M8BQ.*` |
| Expanded package quarantine xattr | PASS: `0` |
| Package payload AppleDouble entries | PASS: `0` |
| Executable architecture | PASS: `arm64` |

## Hashes

- DMG SHA256: `2cb29528ef1c137db330ff8a28baa3c622705916f8368b28c373ca95aefd6981`
- PKG SHA256: `7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`

## Notes

- The package is arm64-only, consistent with the current build pipeline.
- `pkgutil --check-signature` reports a valid Apple-issued Installer certificate chain on this machine.
- No extra GUI automation was run after the user's manual acceptance of the latest tips behavior.

 src/Release/AppStore-7.9.1-20260614.1454/README.md

New file
@@ -0,0 +1,31 @@
# TagLauncher 7.9.1 App Store Release Pack

This directory freezes TagLauncher `7.9.1` build `20260614.1454` for App Store upload.

Version stays `7.9.1`; only `CFBundleVersion` was updated from the previous `20260613.2020` build.

## Upload Package

Upload this file with Transporter:

```text
/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg
```

Do not upload the DMG in `Archive/`; the DMG is only for local rollback and smoke testing.

## Artifacts

- App Store upload pkg: `Upload/TagLauncher-7.9.1-build20260614.1454.pkg`
- Local archive DMG: `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
- Release tag: `v7.9.1-build20260614.1454`

## Files

- `APP_STORE_CONNECT_METADATA.md`: App Store Connect fields and copy.
- `APP_STORE_RELEASE_CHECKLIST.md`: upload checklist.
- `APP_REVIEW_NOTES.md`: review notes for Apple.
- `PKG_PREFLIGHT_REPORT.md`: local package inspection report.
- `QA_RELEASE_EVIDENCE.md`: QA evidence.
- `RELEASE_MANIFEST.md`: reproducible release manifest.

 src/Release/AppStore-7.9.1-20260614.1454/RELEASE_MANIFEST.md

New file
@@ -0,0 +1,80 @@
# Release Manifest - TagLauncher 7.9.1 build 20260614.1454

## Identity

- Product: TagLauncher
- Version: `7.9.1`
- Build: `20260614.1454`
- Bundle ID: `com.taglauncher.app`
- Minimum macOS: `14.0`
- Category: `public.app-category.utilities`
- Generated at: `2026-06-14 15:03 CST`
- Branch: `codex/appgrid-usage-tips`
- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
- Release tag: `v7.9.1-build20260614.1454`

## Artifacts

- Local archive DMG: `Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
- App Store upload pkg: `Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`
- DMG SHA256: `2cb29528ef1c137db330ff8a28baa3c622705916f8368b28c373ca95aefd6981`
- PKG SHA256: `7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`
- DMG size: `6093221` bytes
- PKG size: `5894105` bytes

## Build Commands

```bash
cd /Users/ar/Projects/Taglauncher/src
APP_BUILD=20260614.1454 bash build.sh
bash make_dmg.sh
mv build/TagLauncher.dmg build/TagLauncher-7.9.1-build20260614.1454.dmg
cp build/TagLauncher-7.9.1-build20260614.1454.dmg Release/AppStore-7.9.1-20260614.1454/Archive/
```

## App Store Package Commands

```bash
cd /Users/ar/Projects/Taglauncher/src

codesign --force --deep --options runtime \
  --sign 0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C \
  --entitlements /tmp/taglauncher-appstore-7.9.1.72KIck/TagLauncher-AppStore-full.entitlements \
  /tmp/taglauncher-appstore-7.9.1.72KIck/stage/TagLauncher.app

productbuild \
  --component /tmp/taglauncher-appstore-7.9.1.72KIck/stage/TagLauncher.app /Applications \
  --sign "3rd Party Mac Developer Installer: Hainan Wanxing Technology Co., Ltd. (CR3J54M8BQ)" \
  build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg
```

Before signing, the staging app embedded `TagLauncher Mac App Store 20260605.2337` and ran `xattr -cr` to remove quarantine attributes from the app bundle.

## Verification Commands

```bash
git diff --check -- src/Apptag/Info.plist src/CHANGELOG.md src/Apptag/AppGridCollectionView.swift src/Scripts/usage_tips_qa.sh src/Apptag/Localization
bash Scripts/usage_tips_qa.sh
bash Scripts/app_ordering_data_qa.sh
bash Scripts/macos14_availability_typecheck_qa.sh
bash Scripts/macos14_build_metadata_qa.sh
bash Scripts/quick_search_app_name_qa.sh
bash Scripts/quick_search_system_app_qa.sh
bash Scripts/smartstart_catalog_resource_qa.sh
hdiutil verify Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg
pkgutil --check-signature build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg
pkgutil --expand-full build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg /tmp/taglauncher-pkg-preflight-7.9.1-20260614.1454
codesign --verify --deep --strict --verbose=2 /tmp/taglauncher-pkg-preflight-7.9.1-20260614.1454/com.taglauncher.app.pkg/Payload/TagLauncher.app
```

## Release Scope

- Keeps version `7.9.1`; only updates build to `20260614.1454`.
- Fixes incomplete non-Chinese App Grid usage-tip sentences by using a comma in localized strings as the line-break marker.
- Keeps Simplified Chinese and Traditional Chinese usage-tip copy unchanged.
- Keeps the 7.9.1 App Grid features from build `20260613.2020`: empty tag visibility, blank-space tag removal reliability on macOS 14, native AppKit usage tips HUD, tips settings toggle, and manual app ordering.

## Apple Upload

- Upload the `.pkg` in `Upload/`, not the `.dmg` in `Archive/`.
- After Transporter upload, wait for App Store Connect processing to finish, then select build `20260614.1454` for version `7.9.1`.

 src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg

Binary files differ

New file
			@@ -0,0 +1,39 @@
			# App Review Notes

			## English

			TagLauncher is a local macOS utility for organizing and launching installed apps by tag. No account or demo login is required.

			How to test:

			1. Launch TagLauncher.
			2. Open the App Grid from the menu bar icon or press Option-Shift-Space.
			3. Use Quick Search from the grid by pressing Space.
			4. Create or use a tag group, then drag an app icon within the same group to change the display order.
			5. Create an empty tag in Settings > Tags; the empty tag remains visible in the App Grid with a minimal placeholder container.
			6. Drag an app to blank space outside containers to remove that tag assignment.
			7. Open Settings > General to hide or show App Grid usage tips.
			8. Open Settings > Data to export or import the local category layout.

			Version 7.9.1 build 20260614.1454 fixes incomplete localized App Grid usage-tip text in non-Chinese languages. It keeps the existing 7.9.1 empty-tag visibility, macOS 14 blank-space tag removal behavior, and App Grid usage guidance improvements. The app does not collect user data and does not use analytics, ads, tracking, accounts, or cloud sync.

			If the Dock icon is hidden, the menu bar icon remains available. The Dock visibility setting can be changed in Settings > General.

			## Simplified Chinese

			TagLauncher 是一个本地 macOS 工具，用于按标签整理和启动已安装的应用。不需要账号或演示登录。

			测试方式：

			1. 启动 TagLauncher。
			2. 点击菜单栏图标打开 App Grid，或按 Option-Shift-Space。
			3. 在 App Grid 中按 Space 打开 Quick Search。
			4. 创建或使用一个标签分组，在同一个分组内拖动应用图标即可调整显示顺序。
			5. 在 Settings > Tags 创建一个空标签；空标签会继续显示在 App Grid 中，并带有最小占位容器。
			6. 把应用拖到容器外空白处，可以移除该标签归属。
			7. 打开 Settings > General，可以关闭或开启 App Grid 底部使用技巧。
			8. 打开 Settings > Data，可以导出或导入本地分类布局。

			版本 7.9.1 build 20260614.1454 修复非中文语种下 App Grid 使用技巧文案显示不完整的问题，并保留 7.9.1 已有的空标签显示、macOS 14 下空白处解除标签行为和 App Grid 使用引导改进。本应用不收集用户数据，不包含分析、广告、追踪、账号或云同步。

			如果 Dock 图标被隐藏，菜单栏图标仍可使用。Dock 显示设置可在 Settings > General 中调整。

New file
			@@ -0,0 +1,114 @@
			# App Store Connect Metadata Draft

			Generated: 2026-06-14

			## App Information

			- Name: `TagLauncher`
			- Bundle ID: `com.taglauncher.app`
			- SKU: `taglauncher-macos`
			- Category: `Utilities`
			- Version: `7.9.1`
			- Build: `20260614.1454`
			- Minimum macOS: `14.0`

			## URLs

			- Marketing URL: `https://shanghai3168.github.io/taglauncher/index.html`
			- Support URL: `https://shanghai3168.github.io/taglauncher/support.html`
			- Privacy Policy URL: `https://shanghai3168.github.io/taglauncher/privacy.html`
			- Chinese Privacy Policy URL: `https://shanghai3168.github.io/taglauncher/privacy-zh.html`

			## Subtitle Options

			- English: `Tag-based app launcher`
			- English: `Beyond Launchpad folders`
			- Simplified Chinese: `标签化应用启动器`

			## What's New

			### English

			Version 7.9.1 build 20260614.1454 fixes localized App Grid usage-tip text in non-Chinese languages so the instructions are complete and easier to read in the two-line tips HUD.

			This build keeps the 7.9.1 App Grid improvements: empty tag groups stay visible, dragging an app to blank space outside containers can remove its tag assignment more reliably on macOS 14, and the App Grid includes native usage tips that can be hidden in Settings.

			### Simplified Chinese

			版本 7.9.1 build 20260614.1454 修复非中文语种下 App Grid 使用技巧文案显示不完整的问题，让两行提示中的操作说明更完整、更容易阅读。

			本 build 继续保留 7.9.1 的 App Grid 改进：空标签会持续显示，macOS 14 上把应用拖到容器外空白处解除标签更稳定，App Grid 底部原生使用技巧提示也可在设置中关闭。

			## Description Draft

			### English

			TagLauncher is a fast tag-based launcher for Mac apps.

			Organize installed apps into visual tag groups, open a fullscreen-friendly app grid from a global hotkey, and jump directly to apps with Quick Search. It is designed for people who have many apps and want a calmer, faster way to find the right one without hunting through Launchpad, Finder, or the Dock.

			Highlights:

			- Open the app grid with Option-Shift-Space.
			- Search apps, tags, and notes with Quick Search.
			- Group apps by custom tags.
			- Reorder apps inside each tag group.
			- Tune icon size, tag position, app list style, Dock visibility, and usage tips visibility.
			- Import and export your category layout.
			- Works across multiple displays and fullscreen Spaces.
			- Keeps data local on your Mac, with no account required.

			### Simplified Chinese

			TagLauncher 是一个基于标签的 Mac 应用启动器。

			你可以把已安装的应用整理成可视化标签分组，用全局快捷键唤出应用网格，也可以通过 Quick Search 直接搜索应用、标签和备注。它适合安装了很多应用、希望更快找到目标应用的人。

			亮点：

			- 使用 Option-Shift-Space 打开应用网格。
			- 使用 Quick Search 搜索应用、标签和备注。
			- 用自定义标签整理应用。
			- 在同一个标签分组内手动调整应用顺序。
			- 可调整图标大小、标签位置、列表样式、Dock 显示和使用技巧显示。
			- 支持分类布局的导入和导出。
			- 支持多显示器和全屏 Space 场景。
			- 数据保存在本机，无需账号。

			## Keywords

			English:

			`launcher,launchpad,tags,apps,organizer,notes,backup,hotkey,search,utility,macos`

			Simplified Chinese:

			`启动器,启动台,标签,应用,整理,排序,备忘,备份,快捷键,搜索,效率,工具`

			## Promotional Text

			English:

			`Organize Mac apps by tag, reorder each group by drag, and launch faster with a keyboard-friendly grid and Quick Search.`

			Simplified Chinese:

			`用标签整理 Mac 应用，拖拽调整分组内顺序，再用快捷键和 Quick Search 更快启动应用。`

			## App Privacy Recommended Answers

			- Data collection: `No, this app does not collect data`
			- Tracking: `No`
			- Analytics: `No`
			- Ads: `No`
			- Data linked to user: `No`

			Explanation:

			TagLauncher indexes installed apps locally so users can organize and launch them. Tags, notes, preferences, app order, tips visibility, and layout data stay on the user's Mac. The app does not include ads, analytics SDKs, tracking, account registration, or cloud sync in this build.

			## App Review Information

			- Demo account required: `No`
			- Contact email: `shanghai3168@gmail.com`
			- Review notes: use `APP_REVIEW_NOTES.md`

New file
			@@ -0,0 +1,48 @@
			# App Store Release Checklist

			Version: `7.9.1`

			Build: `20260614.1454`

			## Before Upload

			- [x] Source commit frozen: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
			- [x] Release directory created under `src/Release/AppStore-7.9.1-20260614.1454`
			- [x] Marketing version kept at `7.9.1`
			- [x] Build updated to `20260614.1454`
			- [x] DMG generated and verified
			- [x] App Store `.pkg` generated with Installer certificate
			- [x] Final `.pkg` expanded and inspected
			- [x] Bundle ID, version, build, category, and minimum macOS verified
			- [x] Embedded provisioning profile verified
			- [x] Signed entitlements verified
			- [x] `com.apple.quarantine` absent from expanded package
			- [x] SHA256 recorded
			- [x] Release tag created: `v7.9.1-build20260614.1454`

			## Upload With Transporter

			1. Open Transporter for macOS.
			2. Add this package:

			```text
			/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg
			```

			3. Deliver the package.
			4. Wait for App Store Connect processing to finish.
			5. In App Store Connect, open the TagLauncher macOS version `7.9.1` page.
			6. Select build `20260614.1454`.
			7. Fill metadata from `APP_STORE_CONNECT_METADATA.md`.
			8. Fill review notes from `APP_REVIEW_NOTES.md`.
			9. Submit for review.

			## Do Not Upload

			- Do not upload `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`.
			- Do not upload any temporary package under `/private/tmp` or `/var/folders`.

			## After Upload

			- Record App Store Connect processing result.
			- If Apple rejects the binary, do not reuse the same build number for a new package. Increment `CFBundleVersion` with a new `YYYYMMDD.HHMM` build.

New file
			@@ -0,0 +1,56 @@
			# TagLauncher 7.9.1 App Store `.pkg` 预检报告

			生成日期：2026-06-14

			上传包：

			`Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

			SHA256：

			`7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`

			## Build Inputs

			\| 项目 \| 值 \|
			\| --- \| --- \|
			\| Version \| `7.9.1` \|
			\| Build \| `20260614.1454` \|
			\| Bundle ID \| `com.taglauncher.app` \|
			\| Team ID \| `CR3J54M8BQ` \|
			\| Minimum macOS \| `14.0` \|
			\| Category \| `public.app-category.utilities` \|
			\| App signing identity \| `0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C` \|
			\| Installer signing identity \| `3rd Party Mac Developer Installer: Hainan Wanxing Technology Co., Ltd. (CR3J54M8BQ)` \|
			\| Provisioning profile \| `TagLauncher Mac App Store 20260605.2337` \|
			\| Profile UUID \| `da7839d6-2489-4272-b999-c61efccfe473` \|
			\| Profile expiration \| `2027-06-04 21:48:21 CST` \|

			## Verification

			\| 检查项 \| 结果 \|
			\| --- \| --- \|
			\| `.pkg` 文件生成 \| PASS \|
			\| `.pkg` Installer 证书签名 \| PASS \|
			\| 展开最终 `.pkg` 并找到 `TagLauncher.app` \| PASS \|
			\| Bundle ID \| PASS: `com.taglauncher.app` \|
			\| `CFBundleShortVersionString` \| PASS: `7.9.1` \|
			\| `CFBundleVersion` \| PASS: `20260614.1454` \|
			\| `LSMinimumSystemVersion` \| PASS: `14.0` \|
			\| `LSApplicationCategoryType` \| PASS: `public.app-category.utilities` \|
			\| 嵌入 `embedded.provisionprofile` \| PASS \|
			\| Profile application identifier \| PASS: `CR3J54M8BQ.com.taglauncher.app` \|
			\| Signed application identifier \| PASS: `CR3J54M8BQ.com.taglauncher.app` \|
			\| Signed team identifier \| PASS: `CR3J54M8BQ` \|
			\| Signed sandbox entitlement \| PASS \|
			\| Signed user-selected file entitlement \| PASS \|
			\| Signed keychain access groups \| PASS: `CR3J54M8BQ.*` \|
			\| Expanded package has `com.apple.quarantine` \| PASS: `0` \|
			\| Package payload AppleDouble `._*` entries \| PASS: `0` \|
			\| Executable architecture \| PASS: `arm64` \|

			## Next Upload Step

			Use Transporter and select:

			`/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

New file
			@@ -0,0 +1,74 @@
			# QA Evidence - TagLauncher 7.9.1 build 20260614.1454

			## Target

			- Version: `7.9.1`
			- Build: `20260614.1454`
			- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
			- DMG: `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
			- PKG: `Upload/TagLauncher-7.9.1-build20260614.1454.pkg`

			## Automated QA

			\| Check \| Result \|
			\| --- \| --- \|
			\| `git diff --check -- src/Apptag/Info.plist src/CHANGELOG.md src/Apptag/AppGridCollectionView.swift src/Scripts/usage_tips_qa.sh src/Apptag/Localization` \| PASS \|
			\| `Scripts/usage_tips_qa.sh` \| PASS \|
			\| `Scripts/app_ordering_data_qa.sh` \| PASS \|
			\| `Scripts/macos14_availability_typecheck_qa.sh` \| PASS \|
			\| `Scripts/macos14_build_metadata_qa.sh` \| PASS \|
			\| `Scripts/quick_search_app_name_qa.sh` \| SKIP: Sunlogin wrapper app not installed on this Mac \|
			\| `Scripts/quick_search_system_app_qa.sh` \| PASS \|
			\| `Scripts/smartstart_catalog_resource_qa.sh` \| PASS \|

			## Localization QA

			\| Check \| Result \|
			\| --- \| --- \|
			\| 27 non-Chinese languages, tips 1-8 each contain exactly one ASCII comma separator \| PASS \|
			\| 27 non-Chinese languages, tips 1-8 have no `>`, `->`, `-->`, `→`, or `＞` separator \| PASS \|
			\| 27 non-Chinese languages, both sides of the separator are non-empty \| PASS \|
			\| `zh-Hans` and `zh-Hant` usage-tip copy unchanged in this fix \| PASS \|

			## Manual Acceptance

			\| Check \| Result \|
			\| --- \| --- \|
			\| App Grid usage tips paging and click behavior \| PASS: user manually accepted before this packaging step \|

			## Package Verification

			\| Check \| Result \|
			\| --- \| --- \|
			\| DMG generated \| PASS \|
			\| `hdiutil verify` \| PASS \|
			\| Built app version/build \| PASS: `7.9.1 / 20260614.1454` \|
			\| App Store `.pkg` generated \| PASS \|
			\| `.pkg` Installer certificate signature \| PASS \|
			\| Expanded `.pkg` contains `TagLauncher.app` \| PASS \|
			\| Bundle ID \| PASS: `com.taglauncher.app` \|
			\| `CFBundleShortVersionString` \| PASS: `7.9.1` \|
			\| `CFBundleVersion` \| PASS: `20260614.1454` \|
			\| Minimum macOS \| PASS: `14.0` \|
			\| Category \| PASS: `public.app-category.utilities` \|
			\| Embedded provisioning profile \| PASS \|
			\| Profile application identifier \| PASS: `CR3J54M8BQ.com.taglauncher.app` \|
			\| Signed application identifier \| PASS: `CR3J54M8BQ.com.taglauncher.app` \|
			\| Signed team identifier \| PASS: `CR3J54M8BQ` \|
			\| Sandbox entitlement \| PASS \|
			\| User-selected file read/write entitlement \| PASS \|
			\| Keychain access group \| PASS: `CR3J54M8BQ.*` \|
			\| Expanded package quarantine xattr \| PASS: `0` \|
			\| Package payload AppleDouble entries \| PASS: `0` \|
			\| Executable architecture \| PASS: `arm64` \|

			## Hashes

			- DMG SHA256: `2cb29528ef1c137db330ff8a28baa3c622705916f8368b28c373ca95aefd6981`
			- PKG SHA256: `7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`

			## Notes

			- The package is arm64-only, consistent with the current build pipeline.
			- `pkgutil --check-signature` reports a valid Apple-issued Installer certificate chain on this machine.
			- No extra GUI automation was run after the user's manual acceptance of the latest tips behavior.

New file
			@@ -0,0 +1,31 @@
			# TagLauncher 7.9.1 App Store Release Pack

			This directory freezes TagLauncher `7.9.1` build `20260614.1454` for App Store upload.

			Version stays `7.9.1`; only `CFBundleVersion` was updated from the previous `20260613.2020` build.

			## Upload Package

			Upload this file with Transporter:

			```text
			/Users/ar/Projects/Taglauncher/src/Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg
			```

			Do not upload the DMG in `Archive/`; the DMG is only for local rollback and smoke testing.

			## Artifacts

			- App Store upload pkg: `Upload/TagLauncher-7.9.1-build20260614.1454.pkg`
			- Local archive DMG: `Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
			- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
			- Release tag: `v7.9.1-build20260614.1454`

			## Files

			- `APP_STORE_CONNECT_METADATA.md`: App Store Connect fields and copy.
			- `APP_STORE_RELEASE_CHECKLIST.md`: upload checklist.
			- `APP_REVIEW_NOTES.md`: review notes for Apple.
			- `PKG_PREFLIGHT_REPORT.md`: local package inspection report.
			- `QA_RELEASE_EVIDENCE.md`: QA evidence.
			- `RELEASE_MANIFEST.md`: reproducible release manifest.

New file
			@@ -0,0 +1,80 @@
			# Release Manifest - TagLauncher 7.9.1 build 20260614.1454

			## Identity

			- Product: TagLauncher
			- Version: `7.9.1`
			- Build: `20260614.1454`
			- Bundle ID: `com.taglauncher.app`
			- Minimum macOS: `14.0`
			- Category: `public.app-category.utilities`
			- Generated at: `2026-06-14 15:03 CST`
			- Branch: `codex/appgrid-usage-tips`
			- Source commit: `bd792cd36d57b8f0741af9a6a64e59969cdce490`
			- Release tag: `v7.9.1-build20260614.1454`

			## Artifacts

			- Local archive DMG: `Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg`
			- App Store upload pkg: `Release/AppStore-7.9.1-20260614.1454/Upload/TagLauncher-7.9.1-build20260614.1454.pkg`
			- DMG SHA256: `2cb29528ef1c137db330ff8a28baa3c622705916f8368b28c373ca95aefd6981`
			- PKG SHA256: `7ad097a23c736fc7a7b34a9575348cbc52a968d5fbf433584ace353b120a32ef`
			- DMG size: `6093221` bytes
			- PKG size: `5894105` bytes

			## Build Commands

			```bash
			cd /Users/ar/Projects/Taglauncher/src
			APP_BUILD=20260614.1454 bash build.sh
			bash make_dmg.sh
			mv build/TagLauncher.dmg build/TagLauncher-7.9.1-build20260614.1454.dmg
			cp build/TagLauncher-7.9.1-build20260614.1454.dmg Release/AppStore-7.9.1-20260614.1454/Archive/
			```

			## App Store Package Commands

			```bash
			cd /Users/ar/Projects/Taglauncher/src

			codesign --force --deep --options runtime \
			--sign 0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C \
			--entitlements /tmp/taglauncher-appstore-7.9.1.72KIck/TagLauncher-AppStore-full.entitlements \
			/tmp/taglauncher-appstore-7.9.1.72KIck/stage/TagLauncher.app

			productbuild \
			--component /tmp/taglauncher-appstore-7.9.1.72KIck/stage/TagLauncher.app /Applications \
			--sign "3rd Party Mac Developer Installer: Hainan Wanxing Technology Co., Ltd. (CR3J54M8BQ)" \
			build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg
			```

			Before signing, the staging app embedded `TagLauncher Mac App Store 20260605.2337` and ran `xattr -cr` to remove quarantine attributes from the app bundle.

			## Verification Commands

			```bash
			git diff --check -- src/Apptag/Info.plist src/CHANGELOG.md src/Apptag/AppGridCollectionView.swift src/Scripts/usage_tips_qa.sh src/Apptag/Localization
			bash Scripts/usage_tips_qa.sh
			bash Scripts/app_ordering_data_qa.sh
			bash Scripts/macos14_availability_typecheck_qa.sh
			bash Scripts/macos14_build_metadata_qa.sh
			bash Scripts/quick_search_app_name_qa.sh
			bash Scripts/quick_search_system_app_qa.sh
			bash Scripts/smartstart_catalog_resource_qa.sh
			hdiutil verify Release/AppStore-7.9.1-20260614.1454/Archive/TagLauncher-7.9.1-build20260614.1454.dmg
			pkgutil --check-signature build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg
			pkgutil --expand-full build/AppStore/TagLauncher-7.9.1-build20260614.1454.pkg /tmp/taglauncher-pkg-preflight-7.9.1-20260614.1454
			codesign --verify --deep --strict --verbose=2 /tmp/taglauncher-pkg-preflight-7.9.1-20260614.1454/com.taglauncher.app.pkg/Payload/TagLauncher.app
			```

			## Release Scope

			- Keeps version `7.9.1`; only updates build to `20260614.1454`.
			- Fixes incomplete non-Chinese App Grid usage-tip sentences by using a comma in localized strings as the line-break marker.
			- Keeps Simplified Chinese and Traditional Chinese usage-tip copy unchanged.
			- Keeps the 7.9.1 App Grid features from build `20260613.2020`: empty tag visibility, blank-space tag removal reliability on macOS 14, native AppKit usage tips HUD, tips settings toggle, and manual app ordering.

			## Apple Upload

			- Upload the `.pkg` in `Upload/`, not the `.dmg` in `Archive/`.
			- After Transporter upload, wait for App Store Connect processing to finish, then select build `20260614.1454` for version `7.9.1`.