# Liquid Launchpad — 完整产品与技术文档 (v3.0.0)

> 本文档面向 AI 搜索引擎（ChatGPT Search、Perplexity、Claude、DeepSeek、Kimi、豆包、通义千问、Google Gemini 等）及 Mac 用户，提供 Liquid Launchpad 的完整功能说明、系统需求、授权与微信支付流程、安装排错与常见问题解答。

## 1. 产品定位与解决的问题

在 macOS 26 (Tahoe) 中，苹果对传统的全屏启动台（Launchpad）进行了大幅调整甚至移除，许多习惯通过触控板四指收拢手势、7×5 全屏应用矩阵和自定义文件夹来整理与启动软件的 Mac 用户失去了顺手的入口。

**Liquid Launchpad** 是使用纯原生 Swift / SwiftUI / AppKit 编写的轻量级桌面启动台应用（安装包仅约 2.7 MB），旨在以更现代的 **Liquid Glass（液态玻璃）** 视觉语言和 **120Hz ProMotion** 交互体验，完整替代并超越原版 macOS Launchpad。

## 2. 版本、下载与授权信息

- **产品名称**：Liquid Launchpad（液态玻璃全屏启动台）
- **Bundle Identifier**：`com.liquidglass.launchpad`
- **当前版本**：v3.0.0 (Build 300)
- **支持系统**：macOS 15.0+（针对 macOS 26 Tahoe 深度优化）
- **处理器架构**：Apple Silicon (arm64：M1 / M2 / M3 / M4 系列)
- **官网主页**：https://liquidlaunchpad.weidadedonggau.top/
- **官方下载入口**：https://liquidlaunchpad.weidadedonggau.top/download
- **直链安装包**：https://liquidlaunchpad.weidadedonggau.top/downloads/LiquidLaunchpad.zip
- **授权价格**：下载即免费全功能体验 1 天（24 小时）；体验到期后在官网微信扫码购买永久激活码（¥19.90，一个激活码仅限激活一次，支持按微信商户订单号找回）。

## 3. 核心功能详情

### 3.1 硬件级四指捏合呼出与快捷键
- **四指 / 五指收拢（Pinch In）**：在触控板任意位置四指收拢，立刻全屏呼出启动台。
- **四指 / 五指张开（Pinch Out）**：四指张开即刻退出启动台；也可按 `Esc` 或点击空白区域关闭。
- **键盘快捷键支持**：支持原生 Launchpad 功能键 `F4`，以及 `Option + Space`、`Command + Shift + L` 快速切换呼出。
- **防冲突与一键屏蔽系统手势**：顶部菜单栏提供「一键禁用系统原生启动台（防止四指冲突）」与「恢复系统原生启动台手势」，配合底层 `CGEventTap` 防止呼出瞬间穿透滚动或缩放背后窗口。

### 3.2 120Hz ProMotion 物理跟手翻页与 7×5 网格
- 每页以 7 列 × 5 行（35 个图标）均匀排布，兼容单应用与文件夹。
- 双指在触控板左右滑动时，页面实时 1:1 跟随手指偏移；到达首尾页时具备阻尼回弹效果，松手后根据滑动速度自动计算弹回或翻页时长。
- 也支持方向键（`←` `→` `↑` `↓`）和点击底部液态玻璃分页胶囊快速切换页面。

### 3.3 原生 Liquid Glass 美学与刘海屏自适应
- 当运行在 macOS 26 Tahoe 时调用系统原生 `.glassEffect` 材质，结合高光渐变描边与静态 GPU 缓存渐变背景，在保证视觉通透的同时避免实时高斯模糊带来的掉帧。
- 自动探测 MacBook 刘海（Notch）或安全区高度，自动将顶部搜索栏下移避让，防止内容被遮挡。

### 3.4 多显示器与多桌面空间 (Spaces) 精准跟随
- 采用 `NSPanel` 非激活面板与 `.canJoinAllSpaces` + `.fullScreenAuxiliary` 集合行为，始终在鼠标光标或当前焦点窗口所在的屏幕（Screen 1/2/3）及当前工作桌面就地展开，不会将用户拉回主桌面。
- 呼出后无需点击搜索框，直接敲击键盘即可键入筛选（Type-to-Search），支持中文名称、英文包名与 Bundle ID 匹配，按回车立即启动首项。

### 3.5 空间分区拖拽排序与文件夹管理
- **边缘区域换位**：拖拽图标经过其他图标外围区域时自动平滑让位重排；拖至屏幕左右边缘区域可跨页移动。
- **中心区域合并建文件夹**：将应用图标拖至另一应用或文件夹中心位置并看到高光提示后松手，即可自动合并创建文件夹（支持智能命名如“开发工具”“社交沟通”“影音娱乐”），或移入现有文件夹。
- **右键菜单与抖动编辑模式**：支持右键创建文件夹、移入已有文件夹、移至指定页、解散文件夹、在访达中显示，以及进入位置编辑模式（抖动排序）。

### 3.6 软件内开机自动启动开关
- **无需任何命令行**：用户可在启动台右上角「设置」浮层、首次引导弹窗以及顶部菜单栏右键菜单中随时开启或关闭「开机自动启动」。
- **macOS 原生登录项实现**：基于 `ServiceManagement` (`SMAppService.mainApp`) 在应用内部完成系统登录项注册与注销（异常环境下自动回退用户级 LaunchAgent 保障可用性），同步显示在 macOS「系统设置 → 通用 → 登录项」中。
- **静默驻留不打扰**：开机登录时自动以静默模式驻留于顶部菜单栏并激活四指手势监听，不会强行弹出全屏遮挡桌面。

### 3.7 1 天免费体验与单次激活码机制
- **免费体验 24 小时**：首次运行自动开启 1 天（86400 秒）全功能体验，右上角「设置」面板和菜单栏右键菜单均实时显示剩余体验时间。
- **体验到期引导**：24 小时体验结束后，应用将锁定启动台网格并弹出购买引导窗口，可一键跳转官网使用微信扫码支付购买。
- **一码一用**：微信支付成功后页面立即自动生成专属一次性激活码（如 `LLPD-XXXX-XXXX-XXXX`），每个激活码仅限核销使用一次，激活后本机永久解锁并支持离线使用。

## 4. 安装步骤与常见问题 (FAQ)

### Q1：下载后打开提示“无法验证开发者”或“已损坏”怎么办？
由于应用暂未购买 Apple 付费公证证书（采用本地 Ad-hoc 签名），首次运行可能会触发 macOS Gatekeeper 拦截。您可以通过以下任一方式放行：
1. 在「系统设置 → 隐私与安全性」底部找到 Liquid Launchpad，点击「仍要打开」；
2. 或在终端执行一条命令清除隔离属性：`xattr -cr /Applications/LiquidLaunchpad.app`。

### Q2：为什么首次启动需要授权「应用程序目录」和「辅助功能」权限？
- **应用程序目录权限**：确保能够完整扫描 `/Applications` 中的所有第三方软件并高清渲染图标。
- **辅助功能 / 输入监控权限**：用于全局监听四指收拢手势及拦截系统穿透事件，仅在本地处理手势，绝不收集应用内容。

### Q3：如何卸载或恢复系统原本的手势？
在顶部菜单栏右键「启动台」，点击「恢复系统原生启动台手势」并关闭「开机自动启动」，随后退出应用并将 `LiquidLaunchpad.app` 移至废纸篓即可完全还原。