AltTab Dev 0.2.2

AltTab Dev

Windows 风格的 ⌥+Tab 窗口切换器（macOS）。

本版变化（0.2.2）

面向开发者的一版，应用功能与 0.2.1 完全一致（可继续使用旧版）：

• 新增一键 E2E 验证入口 ./Scripts/verify.sh：构建 → 单测 → 枚举冒烟 → 缩略图管线 → JIT E2E → 真实 .app 截图判定；--quick 为不打扰屏幕的快速档
• 截图像素判定改为显示自适应（原来硬编码了特定机型坐标，换显示器必失败）
• 文档：README 验证工具说明、仓库级开发约定（CLAUDE.md）

安装

1. 下载下方附件 AltTab-Dev-0.2.2.zip 并解压
2. 将 AltTab Dev.app 拖入「应用程序」文件夹
3. 首次打开（见下方「安全放行」），然后在 系统设置 → 隐私与安全性 → 辅助功能 中授权；想启用窗口缩略图，再在 屏幕录制 中授权（可选，授权后需重启应用）

安全放行（自签名应用）

本应用未购买 Apple 开发者账号（$99/年），使用自签名分发，首次打开会被
Gatekeeper 拦截（「无法验证开发者」）。放行方式任选其一：

• 方式 A：打开被拦提示后，前往 系统设置 → 隐私与安全性 → 拉到底，
  点「仍要打开」
• 方式 B：在终端执行
  xattr -dr com.apple.quarantine /Applications/AltTab\ Dev.app

说明：TCC 权限（辅助功能）按二进制签名记录。由于是自签名，每个新
版本下载后需要重新授权一次辅助功能（旧授权不匹配新二进制）。这仅
影响升级场景，日常使用不受影响。

使用

• 按住 ⌥ 按 Tab：呼出切换器 / 前进焦点（全部窗口）
• ⌥+`：只在当前应用的窗口间循环
• 方向键 / Tab 导航，松开 ⌥ 或按 ↵ 切换窗口
• 状态栏图标可退出应用

AltTab Dev 0.2.1

AltTab Dev

Windows 风格的 ⌥+Tab 窗口切换器（macOS）。

v0.2.1 变化

• 修复全新安装时的屏幕录制授权引导：先调用系统 CGRequestScreenCaptureAccess() 注册应用并弹出系统提示，再引导打开设置页——此前新安装的应用可能不出现在「屏幕录制」列表中，导致无从授权（Copilot review 发现）

v0.2.0 变化

• 修复缩略图显示错误内容的问题：此前截屏实际是"整个屏幕按窗口矩形裁剪"（窗口 ID 被系统 API 忽略），会显示别的应用或桌面的画面；现在截取真正的单窗口内容，被遮挡也正确
• 未授予屏幕录制权限时不再显示空白矩形，自动降级为应用图标，并在启动时引导授权（授权后需重启应用）
• 菜单栏移除无效的"权限设置"项；每次呼出切换器重新截取缩略图（内容实时）
• 其他 Space / 最小化的窗口显示应用图标（系统 API 不返回不可见窗口内容）

安装

1. 下载下方附件 AltTab-Dev-<版本>.zip 并解压
2. 将 AltTab Dev.app 拖入「应用程序」文件夹
3. 首次打开（见下方「安全放行」），然后在 系统设置 → 隐私与安全性 → 辅助功能 中授权；想启用窗口缩略图，再在 屏幕录制 中授权（可选，授权后需重启应用）

安全放行（自签名应用）

本应用未购买 Apple 开发者账号（$99/年），使用自签名分发，首次打开会被
Gatekeeper 拦截（「无法验证开发者」）。放行方式任选其一：

• 方式 A：打开被拦提示后，前往 系统设置 → 隐私与安全性 → 拉到底，
  点「仍要打开」
• 方式 B：在终端执行
  xattr -dr com.apple.quarantine /Applications/AltTab\ Dev.app

说明：TCC 权限（辅助功能）按二进制签名记录。由于是自签名，每个新
版本下载后需要重新授权一次辅助功能（旧授权不匹配新二进制）。这仅
影响升级场景，日常使用不受影响。

使用

• 按住 ⌥ 按 Tab：呼出切换器 / 前进焦点（全部窗口）
• ⌥+`：只在当前应用的窗口间循环
• 方向键 / Tab 导航，松开 ⌥ 或按 ↵ 切换窗口
• 状态栏图标可退出应用

AltTab Dev 0.2.0

docs: mention optional screen-recording grant in release notes (#2)

Thumbnails need it since v0.2.0; without the grant the switcher shows
app icons only, and the grant requires an app relaunch.

Co-authored-by: Claude Code <noreply@anthropic.com>

AltTab Dev 0.1.0

AltTab Dev

Windows 风格的 ⌥+Tab 窗口切换器（macOS）。

安装

1. 下载下方附件 AltTab-Dev-<版本>.zip 并解压
2. 将 AltTab Dev.app 拖入「应用程序」文件夹
3. 首次打开（见下方「安全放行」），然后在 系统设置 → 隐私与安全性 → 辅助功能 中授权

安全放行（自签名应用）

本应用未购买 Apple 开发者账号（$99/年），使用自签名分发，首次打开会被
Gatekeeper 拦截（「无法验证开发者」）。放行方式任选其一：

• 方式 A：打开被拦提示后，前往 系统设置 → 隐私与安全性 → 拉到底，
  点「仍要打开」
• 方式 B：在终端执行
  xattr -dr com.apple.quarantine /Applications/AltTab\ Dev.app

说明：TCC 权限（辅助功能）按二进制签名记录。由于是自签名，每个新
版本下载后需要重新授权一次辅助功能（旧授权不匹配新二进制）。这仅
影响升级场景，日常使用不受影响。

使用

• 按住 ⌥ 按 Tab：呼出切换器 / 前进焦点（全部窗口）
• ⌥+`：只在当前应用的窗口间循环
• 方向键 / Tab 导航，松开 ⌥ 或按 ↵ 切换窗口
• 状态栏图标可退出应用