VistileSafariA1
项目文档
Project notes
A window map for your Mac
把散落的窗口，
放回一张工作地图。
先看清哪些窗口正在打开，再回到需要的那一个。Vistile 用窗口缩略图和工作台整理正在进行的任务，减少反复寻找窗口的操作。
Apple Silicon · macOS 14+
窗口与应用的兼容性仍在持续验证，请先阅读下方说明。
TerminalA2
运行日志
workspace / demo----------------
ready to continue
▍
NotesA3
今日清单
□ 核对界面文案
□ 回看方案草稿
□ 整理本周记录
FinderB1
素材文件
参考图folder
方案.mdtext
封面.pngimage
EditorB2
工作文件
section window-maptitle: Vistile
layout: overview
status: demo
PreviewB3
参考画面 / example
点击一个示例窗口，查看聚焦与返回的关系。本页示意 · 不读取或控制你的 Mac 窗口
试一试：选择窗口、输入关键词，或按 Esc 返回。
示意图使用虚构窗口与静态内容；实际应用的缩略图、布局和操作以发行版为准。
From overview to work
先找窗口，
再继续手头的事。
总览负责帮你定位，真实窗口负责继续工作。安装后先给权限、观察当前窗口，再逐步尝试聚焦与返回，不必一开始就改变整个桌面习惯。
打开窗口总览
通过菜单栏入口或快捷键查看符合条件的窗口。用画面和标题辨认目标，不必只靠应用图标猜测。
筛选并选择窗口
窗口多时先缩小查找范围，再选择需要的窗口。网页上方的交互示意展示了这个基本关系。
在真实窗口中操作
Vistile 的窗口操作依赖 macOS 的辅助功能权限。切换后，你继续使用原应用，文件仍由原应用管理。
What you can use
围绕窗口，
提供具体的操作。
下面的功能按已发布版本核对。窗口管理会受到应用本身、系统权限、显示器和 Space 状态影响，兼容情况不能只从一张示意图判断。
每块屏幕都有窗口总览
以固定格子显示符合条件的窗口实时缩略图。默认快捷键或菜单可打开总览，每台显示器分别显示一张总览；输入窗口名可以缩小候选范围。
选择真实窗口并随时返回
点选卡片后，应用自己的真实窗口放大到接近全屏，其余窗口留在原处作为背景。点背景空白回总览；收回不最小化窗口，退出时恢复临时调整过的位置和尺寸。
L 型工作台保留周边窗口预览
从总览点选后进入工作台：顶部和侧边两条预览轨道围绕真实主窗口。点轨道卡片可换主窗口；预览面板不占用主应用键盘输入，主副交换只涉及参与切换的两个窗口，其余窗口继续留在原位置。
换主窗口时保留轨道位置
工作台里切换主窗口只更新被选中的窗口身份，不会把旧主窗口塞进新主窗口的卡片位置。当前窗口用系统强调色标记，并由 VoiceOver 读出；主窗口自己的缩略图也会继续显示。
键盘筛选与方向键选择
在总览里输入文字按窗口名筛选，支持中文输入法提交；方向键移动选择，Enter 打开当前选择。Escape 有筛选词时先清空筛选，再退出总览。
整理空位，减少卡片位置变动
⌥空格将尚未排入格子的窗口整理到空位；手动拖动也可调整位置。关闭一个窗口只清理它自己的位置，其他卡片不会因此整体前移；窗口数量按实际窗口统计。
打开新应用时保留窗口上下文
在总览中打开新应用后，新窗口可以补入空位；切到已经打开的应用时会离开总览。在工作台打开新应用，会回到总览继续整理新窗口。
权限引导与辅助功能授权修复
首次引导分别检查屏幕录制和辅助功能授权，并在缺权限时说明影响。0.1.28 增加仅清除 Vistile 自身辅助功能授权、重新申请并打开系统设置的修复入口；最终仍由用户在系统设置中开启权限。
从 GitHub Releases 检查和下载更新
启动后可按 24 小时节流自动检查，也能从菜单手动检查。发现版本时先显示更新说明，由用户选择稍后、跳过或打开 GitHub 下载；应用不会静默安装，下载后需要手动将 app 拖到“应用程序”覆盖旧版本。
画面留在内存，日志不记标题
窗口像素只保留在 GPU/内存纹理，不写入磁盘；恢复记录包含窗口位置、尺寸等信息，不包含窗口标题或画面。窗口捕获与操作使用 macOS 提供的公开接口。
Install & permissions
装好以后，
先完成两项授权。
下载并安装
前往 GitHub 最新正式发行页，选择 Apple Silicon 的 DMG。打开后把 Vistile 拖入「应用程序」，再启动应用。
按引导授权
到「系统设置 → 隐私与安全性」，授予屏幕录制和辅助功能权限。需要重启应用时按提示完成。
从菜单栏打开总览
Vistile 常驻菜单栏。先打开几个普通应用窗口，再通过菜单入口查看，确认窗口画面和操作是否正常。
逐项尝试自己的工作场景
先测试单显示器上的普通窗口，再尝试多显示器、不同应用与工作方式。遇到授权或窗口恢复异常时，先退出工具并检查原窗口。
Controls & shortcuts
常用操作，
可以先记住这几个。
快捷键是否生效取决于焦点、当前模式以及其他应用的占用。菜单栏始终提供可见入口，设置中的实际配置优先。
| 入口或按键 | 用途与条件 |
|---|---|
| ⌃⌥空格 | 打开/切换总览；设置中可以修改。若全局快捷键注册失败，可从菜单栏打开总览。 |
| Esc | 仅当总览持有键盘焦点时生效；有筛选词先清除筛选，再退出总览。 |
| 方向键 / Enter | 用方向键移动当前卡片选择，按 Enter 聚焦该窗口。 |
| 输入文字 / Backspace | 按窗口名筛选；退格逐字删除筛选词，中文输入经系统输入法提交。 |
| ⌥空格 | 把未排入格子的窗口整理到空位。 |
安装前，先确认适合你的使用场景。
授权要求：实时预览需要屏幕录制权限，移动/调整窗口需要辅助功能权限；撤销屏幕录制权限后，需退出并重新打开应用才能恢复捕获。
应用兼容性尚未完整验收：关键功能的整体验收尚未通过。全屏 Space、Stage Manager 窗口组、DRM 内容、无辅助功能支持的进程等兼容性未测；不要承诺所有应用、窗口类型或显示模式都能正常预览和聚焦。
性能数据有限：当前文档没有覆盖 30 个窗口的压力场景，也没有足够的真机样本用于承诺刷新率或切换延迟。
Intel Mac：当前发布只提供 Apple Silicon arm64 包；Intel 安装包和 Intel 实机兼容性没有验证。
权限修复验收：辅助功能授权修复已进入 v0.1.28，但仓库验收说明记录其真实清权流程尚未实际操作验收。
Practical questions
开始使用前，你可能关心。
它会改变真实窗口的位置吗？
会。聚焦和工作台操作会调整参与操作的真实窗口。应用记录临时修改前的窗口位置与尺寸，并在退出时进行恢复；这些行为仍需在你的应用组合中验证，不能把示意图当作兼容性保证。
为什么菜单栏有图标，Dock 里没有？
Vistile 是菜单栏常驻应用。使用菜单栏图标打开总览、进入设置或检查更新；默认的 Control + Option + 空格也能打开总览。快捷键冲突时可从菜单进入。
总览和双轨工作台有什么关系？
总览用于找到窗口；选择卡片后，真实窗口进入主区，顶部和侧边的预览轨道保留其他窗口。点击轨道卡片可更换主窗口，卡片位置保持独立，便于继续辨认。
辅助功能已开启，应用仍提示未授权怎么办？
先回到应用重新检查权限。0.1.28 提供“清除授权并重新授权”入口，只重置 Vistile 自身的辅助功能授权，再由你去系统设置开启。此入口已发布，但真实清权流程尚未完成实机验收，不应把它理解为一定能修复所有授权问题。
窗口没有实时画面，先检查什么？
先检查屏幕录制权限，再测试一个普通、未受保护的应用窗口。撤销屏幕录制权限后，需要退出并重新打开 Vistile。DRM 内容、全屏 Space、Stage Manager 等场景仍缺少完整兼容验收。
窗口画面会保存或上传吗？
项目设计将窗口像素保留在本机 GPU / 内存中，不把画面写入磁盘；事务日志不包含窗口标题与画面。检查版本更新会访问 GitHub Releases。
检查更新后会自动覆盖安装吗？
不会静默安装。应用可节流自动检查，也能手动检查；发现新版后可稍后、跳过或打开 GitHub 下载。下载完成后，由你把新应用拖到“应用程序”替换旧版本。
Vistile / macOS
给正在做的事，
留一张看得见的地图。
查看当前版本说明，再决定是否适合你的 Mac。