安装与权限

这页说明 Tangrid 的安装前提、首次引导、权限要求，以及几个最容易影响体验的系统因素。

系统要求

• 建议运行在 macOS 14 或更高版本。
• 多窗口、多显示器场景会更能体现 Tangrid 的价值。
• 如果你希望正常显示窗口缩略图，建议同时授予 屏幕录制权限。

安装 Tangrid

如果你拿到的是应用包，建议按常见的 macOS 方式安装：

1. 获取 Tangrid.app。
2. 如有需要先解压安装包或打开镜像。
3. 将应用拖入“应用程序”文件夹。
4. 启动 Tangrid。

Tangrid 启动后会进入首次引导，而不是直接丢给你一堆设置。

首次引导会带你完成什么

Tangrid 的引导流程通常会覆盖这些步骤：

1. 欢迎页。
2. 需要权限 检查。
3. 选择 窗口管理模式。
4. 设置 拖拽修饰键。
5. 选择 窗口切换器 的唤起修饰键。
6. 选择 窗口切换器 风格。
7. 了解 Dock预览。
8. 完成并启动核心能力。

如果你之后还想重新走一遍，可以从状态栏菜单点击 显示欢迎向导。

必须了解的三项权限/系统条件

辅助功能权限

这是 Tangrid 最关键的系统权限，用来完成：

• 移动窗口。
• 调整窗口大小。
• 切换、聚焦和操作窗口。
• 执行平铺、吸附、居中、最小化等动作。

如果没有 辅助功能权限，Tangrid 的大部分窗口管理能力都无法正常运行。

屏幕录制权限

屏幕录制权限 主要影响预览相关功能，例如：

• 窗口切换器 中的窗口缩略图。
• Dock预览 中的窗口缩略图。

Tangrid 的引导文案已经明确说明：这些预览只是为了显示，不会被录制或保存。

禁用台前调度

Tangrid 会建议你 禁用台前调度，原因是：

• 能减少系统自身窗口编排与 Tangrid 之间的冲突。
• 在多窗口、跨屏、跨桌面时更稳定。
• 会让窗口管理体验更接近 Tangrid 的设计预期。

这项不是绝对强制，但强烈建议关闭。

如果权限没有生效

如果你已经授权过，但 Tangrid 仍然识别不到权限，可以尝试在引导页使用 修复权限。

当前实现会做这些事：

• 重置 Tangrid 的无障碍与录屏授权记录。
• 打开对应系统设置页面。
• 再次触发授权流程。

为什么选择 ⌥ Option 可能会报冲突

Tangrid 支持把 拖拽修饰键 设成 ⌥，但这时会检查 macOS 自带的窗口平铺快捷行为。

原因是：

• 系统本身可能也使用 ⌥ 参与原生窗口平铺。
• Tangrid 也可能用 ⌥ 来触发吸附或浮动/平铺切换。

一旦冲突，Tangrid 会提醒你关闭系统的对应设置。

安装完成后的快速自检

建议你做 4 个简单检查：

• 菜单栏里能看到 Tangrid 图标。
• 按 ⌘Tab 能唤起 窗口切换器。
• 悬停 Dock 图标时，Dock预览 能正常显示。
• 拖动窗口时，Tangrid 能按你选择的模式做出响应。

接下来建议阅读 Window Layouts & Snapping。