1. 开始前
1.1. KeyTiler 能做什么？
KeyTiler 是一款 macOS 菜单栏应用，用于移动和整理当前窗口。你可以通过快速布局、布局面板选择位置，也可以直接按全局快捷键。它操作的是你正在使用的窗口，不会替换或干扰你正在运行的应用。
1.2. 当前 Preview 支持哪个 macOS 版本？
当前 Preview 的目标系统是 macOS 15 及更高版本。KeyTiler 采用 Mac App Store 之外的独立发行方式，因为它使用 macOS 辅助功能 API 来管理窗口，这一使用场景不被商店接受。
1.3. KeyTiler 支持哪些语言？
当前版本的 KeyTiler 界面支持 12 种语言或语言变体：英语、简体中文、繁体中文、日语、韩语、法语、俄语、西班牙语、德语、意大利语、葡萄牙语和阿拉伯语。KeyTiler 官网目前提供英文和简体中文页面。
1.4. KeyTiler 的翻译经过人工校对吗？
如果不同语言的含义出现差异，请以英文界面为语义基准。简体中文和繁体中文界面经过人工校对；其他 9 种界面语言使用 AI 翻译，尚未经过人工校对，可能存在错误、遗漏或不自然的表述。发现翻译问题，欢迎通过联系页面告诉我们。
1.5. 这里所说的 Preview 是什么？
Preview 是 KeyTiler 在 1.0 之前、用于验证功能、兼容性和用户体验的发布阶段。它不是商业试用，不代表长期免费渠道，也不代表最终价格。Stable Release 正式版从 1.0 开始。
2. 安装与所需权限
2.1. 如何安装？
下载当前 DMG 文件，打开它，然后将 KeyTiler.app 拖入 Applications。之后从 Applications 启动 KeyTiler；它会留在菜单栏中。首次启动可能会请求这项权限。macOS 27 及之后的版本也可以手动打开系统设置 > 隐私与安全性 > 设备控制和数据访问；更早的版本请打开系统设置 > 隐私与安全性 > 辅助功能。
macOS 27 中的权限名称变化
macOS 27 将系统设置中的权限名称改为“设备控制和数据访问”。macOS 27 之前的版本仍使用“辅助功能”。这两个名称指的是同一项 macOS 权限。
2.2. 为什么 KeyTiler 需要这项权限？
macOS 要求应用获得这项权限，才能读取执行布局所需的窗口信息，并移动其他应用的窗口。KeyTiler 只会将这项权限用于你要求它执行的窗口管理动作。
2.3. 在哪里授予这项权限？
macOS 27 及之后的版本，请打开系统设置 > 隐私与安全性 > 设备控制和数据访问；更早的版本请打开系统设置 > 隐私与安全性 > 辅助功能。找到 KeyTiler.app 并打开开关。如果修改开关时 KeyTiler 已经在运行，请退出后重新打开，再尝试布局动作。
2.4. 窗口没有移动时应该检查什么？
确认 KeyTiler.app 已在“设备控制和数据访问”列表中启用。macOS 27 之前的版本请在“辅助功能”列表中检查。还要确认目标窗口正在使用中，并且系统版本受当前版本 App 支持。你也可以随时在同一个系统设置页面撤销权限。
3. 三种布局方式
KeyTiler 提供三种操作方式：快速布局（Quick Palette）、布局面板（Layout Panel）和直接全局快捷键。三者都只操作触发时正在使用的窗口。详细对比见教程。
4. 快速布局（Quick Palette）
4.1. 什么是快速布局？
快速布局是一个纯鼠标布局选择器。按 ⌃ + ⌥ + Z 后，它会出现在鼠标附近，你通过位置和布局图选择当前窗口的去处。界面默认只显示常用动作，三分、六分和四条带等高级组合需要时才展开。
4.2. 如何使用快速布局？
- 激活要整理的窗口。
- 按 ⌃ + ⌥ + Z 打开快速布局。
- 将鼠标移到目标区域，高亮会显示窗口将占据的范围。
- 点击执行。
按 Esc、再次按 ⌃ + ⌥ + Z，或点击快速布局之外的区域，都可以取消本次操作。
4.3. 为什么打开后第一次悬停没有反应？
快速布局不会把你打开面板前就停在某个区域的指针当作选择。打开后需要先移动鼠标，选择从第一次移动开始。悬停只改变预览，不会移动真实窗口；点击才会执行。
4.4. 中央区域提供哪些位置？
中央圆环提供八个常用位置：左、右、上、下半屏，以及左上、右上、左下、右下四分之一。每个区域的方向与窗口最终位置一致，不需要读文字标签。
4.5. 三分、六分和四条带在哪里？
在快速布局的外围。把鼠标移到其中一个基础区域并稍作停留，该布局家族的组合图就会展开。你可以直接点击基础区域，也可以移入展开图选择组合区域。例如三分布局包含三个单独区域和两个 2/3 组合，四条带展开后中间两格可以合成一个中央半屏。目标显示器为竖屏时，这些布局会改为对应的纵向排列。
4.6. 快速布局支持多显示器或键盘吗？
快速布局只面向当前窗口所在的显示器，不提供跨显示器选择；除了打开、关闭和 Esc 取消，也不支持键盘选择和 VoiceOver。需要键盘或跨显示器操作时，请使用布局面板。
4.7. 快速布局被屏幕边缘裁切了怎么办？
鼠标靠近屏幕边缘时，快速布局会自动调整组合图的位置和展开方向。如果空间仍然不足，部分内容可能被裁切，此时建议改用布局面板。
5. 布局面板与快捷键
5.1. 如何使用鼠标操作布局面板？
打开布局面板，选择布局家族；连接多块显示器时先选择显示器，再点击目标区域。随后 KeyTiler 会将当前窗口应用到这次选择的位置。
5.2. 如何不使用鼠标操作布局面板？
使用面板全局快捷键打开面板。用数字键选择显示器，用 Tab 或 Shift + Tab 切换布局，再用 UI 中提示的热键选择目标区域。
5.3. 什么是直接全局快捷键？
直接全局快捷键可以不打开任何面板，直接应用熟悉的位置。当前版本提供 Halves 和 Quarters 的直接位置，也提供最大化、居中窗口、移动到下一个或上一个显示器等通用动作。面板模式快捷键只是打开指定布局家族的面板，不会产生另一套布局系统。
5.4. KeyTiler 如何处理多块显示器？
布局面板会反映已连接显示器的排列。连接多块显示器时，可先选择显示器（默认当前显示器），再选择区域。可用的显示器几何会随当前排列变化。
5.5. 可以修改或停用快捷键吗？
可以。在 偏好设置 > 快捷键 中为布局动作录入新的绑定，停用不需要的动作，或将所有动作恢复为默认值。如果绑定与 macOS 系统快捷键冲突，KeyTiler 会报告冲突，不会静默修改系统快捷键。
5.6. 默认全局快捷键是什么？
完整默认映射如下。这些绑定只是参考值，并非固定要求：所有动作都可以在 偏好设置 > 快捷键 中修改。
快速布局
| 动作 | 默认值 |
|---|---|
| 快速布局 | ⌃ + ⌥ + Z |
布局面板
| 动作 | 默认值 |
|---|---|
| 打开布局面板 | ⌃ + ⌥ + X |
| 打开二分面板 | ⌃ + ⌥ + Y |
| 打开四分面板 | ⌃ + ⌥ + U |
| 打开三分面板 | ⌃ + ⌥ + I |
| 打开六分面板 | ⌃ + ⌥ + O |
| 打开四条带面板 | ⌃ + ⌥ + P |
二分
| 动作 | 默认值 |
|---|---|
| 左半屏 | ⌃ + ⌥ + ← |
| 右半屏 | ⌃ + ⌥ + → |
| 上半屏 | ⌃ + ⌥ + ↑ |
| 下半屏 | ⌃ + ⌥ + ↓ |
四分
| 动作 | 默认值 |
|---|---|
| 左上四分之一 | ⌃ + ⌥ + H |
| 右上四分之一 | ⌃ + ⌥ + J |
| 左下四分之一 | ⌃ + ⌥ + N |
| 右下四分之一 | ⌃ + ⌥ + M |
通用
| 动作 | 默认值 |
|---|---|
| 最大化 | ⌃ + ⌥ + Return |
| 居中窗口 | ⌃ + ⌥ + C |
| 下一个显示器 | ⌃ + ⌥ + ⌘ + → |
| 上一个显示器 | ⌃ + ⌥ + ⌘ + ← |
6. Preview、更新、隐私与联系
6.1. Preview 到期后会发生什么？
Preview 到期（Preview Expiration）是写入 Preview Release 的生命周期截止点。到期后，正常的全局布局快捷键工作流会被停用，直到你安装新的 Preview 或 Stable Release。菜单栏、关于、偏好设置、更新检查和迁移入口仍然可用，方便你恢复使用。
6.2. 什么是 Preview 迁移？
Preview 迁移（Preview Migration）是指从当前安装的 Preview Release 更新到新的 Preview Release，或更新到 1.0 Stable Release 正式版。它描述的是发布版本的可用性与连续使用，不是商业升级、试用转正或价格承诺。
6.3. KeyTiler 会自动安装更新吗？
不会。你可以选择关闭、每周或每月进行后台更新检查，也可以手动发起检查。更新检查只会寻找更新版本；安装更新前仍需要用户确认。如果应用的更新访问权限到期，官方网站上的 DMG 手动迁移（Manual DMG Migration）会作为更新可用性兜底路径。
6.4. 产品使用分析是必需的吗？
不是。产品使用分析在你于首次启动授权窗口或 General Preferences 中明确选择允许前，始终处于关闭状态。启用后，KeyTiler 会在本地十天滚动时间窗口中记录粗粒度的布局使用累计次数；不会有意发送窗口标题或内容、前台应用名称、原始快捷键、显示器名称、坐标或硬件指纹。
6.5. 在哪里提交联系请求？
通过联系页面提交兼容性问题、产品建议、产品支持、隐私请求，或 Terms 和 Preview 许可问题。可以填写预期结果、实际结果，以及已知的 KeyTiler 或 macOS 版本。联系流程不要求邮箱，也不接受截图、日志或附件。