BKAppSwitch

简体中文 · English

✨ 功能 · 🚀 快速开始 · ⚡ 快捷键 · ❓ 常见问题 · 🤝 参与贡献

👋 简介

BKAppSwitch 是一个开源的 macOS 菜单栏窗口切换器。

开着好几个 VS Code 项目，还要在浏览器和终端之间来回跳？macOS 自带的 ⌘ Tab 只能按应用切换。BKAppSwitch 把你选中的应用的所有窗口放进同一个列表，按住 ⌥、按下 Tab，就能直接跳到要找的那个窗口。

• 🪶 原生 Swift + SwiftUI + AppKit，无第三方依赖
• 🔒 无网络请求，不读项目文件，无需账号
• 📄 采用 MIT 许可证，可自由使用、修改和分发

📸 界面预览

_{同一个列表里显示不同应用的窗口。高亮行是当前选择；VS Code 窗口突出项目名，同时保留原始标题；最小化的窗口带有标记。截图使用内置演示数据，不包含真实工作内容。}

🎯 三步切换

✨ 功能特性

💻 系统要求

🚀 快速开始

方式一：从源码构建（推荐）

打开“终端”，依次执行：

git clone https://github.com/binbinku/AppSwitch.git
cd AppSwitch
zsh scripts/build-app.sh
zsh scripts/install-app.sh
open /Applications/BKAppSwitch.app --args --settings

构建结果为 dist/BKAppSwitch.app，安装脚本会把它复制到 /Applications/BKAppSwitch.app。如果没有编译工具，先运行 xcode-select --install，按系统提示完成安装。

[!TIP] 建议安装到“应用程序”后再授权，并且始终使用这一份。构建和安装脚本不会覆盖正在运行的 BKAppSwitch，升级前请先从菜单栏退出。

方式二：安装 DMG

如果 Releases 里有安装镜像，可以直接下载，无需安装开发工具：

1. 下载适合你设备的 .dmg 文件。
2. 打开镜像，把 BKAppSwitch 拖到 Applications（应用程序）。
3. 推出镜像，从“应用程序”启动 BKAppSwitch。
4. 按下一节完成辅助功能授权。

[!NOTE] 当前镜像仅适用于 Apple 芯片 Mac，使用本地临时签名，未经过 Apple 公证。首次打开如果被系统阻止，请确认来源可信后，在“系统设置 → 隐私与安全性”中按提示允许打开。

🔑 首次使用：授权并选择应用

1. BKAppSwitch 启动后常驻屏幕顶部菜单栏，没有 Dock 图标。点击菜单栏的叠放窗口图标，打开“设置与权限…”。
2. 点击“授权辅助功能”，前往“系统设置 → 隐私与安全性 → 辅助功能”。
3. 添加并启用 /Applications/BKAppSwitch.app，必要时退出 BKAppSwitch 再重新打开。以设置页显示“辅助功能：已授权”为准。
4. 在“参与切换的应用”中保留 VS Code，或点击“添加应用…”选择其他应用，确保对应开关已打开。
5. 打开这些应用的窗口，按住 ⌥，按 Tab，开始切换 🎉

添加应用不会自动启动它。列表只显示已启用、正在运行且能提供窗口信息的应用；移除应用也不会关闭它的窗口。

⚡ 快捷键

以下是默认快捷键（Option 键也写作 ⌥ 或 Alt）：

也可以从菜单栏点击“显示窗口列表”，让列表保持打开，再点击目标窗口或按 Return 确认。

唤起快捷键可以在设置中改为 ⌃ ⌥ Tab 或 ⌥ Space。无论选哪一种，松开 ⌥ 都会确认，加上 Shift 则反向选择。

📌 为什么列表不按使用频率重排？

固定位置更容易记住目标窗口在哪儿。已有窗口在本次运行中保持相对顺序；新窗口排到末尾，关闭的窗口移出列表。最近使用记录只决定初始选中项（方便切回上一个窗口），不会改变各行的位置。BKAppSwitch 重启后会重新建立顺序。

🏷️ 让 VS Code 项目名更清楚

BKAppSwitch 会尝试从 VS Code 标题中识别项目名。如果你用了自定义标题，可以在设置中选择“项目名在前”“文件名在前”或“完整原始标题”。

推荐在 VS Code 的用户级 settings.json 中加入以下设置，再把 BKAppSwitch 的识别方式改为“项目名在前”：

{
  "window.title": "${rootName}${separator}${activeEditorShort}"
}

自动识别是启发式判断，完整原始标题始终保留。同名项目可以用 ${rootPath} 或不同的 .code-workspace 文件名区分。标题识别只对 VS Code 系列生效，其他应用显示完整窗口标题。BKAppSwitch 不会修改 VS Code 设置，也不需要安装扩展。

❓ 常见问题

open /Applications/BKAppSwitch.app --args --settings

🔒 隐私与权限

• 🛡️ 辅助功能用于读取窗口标题、识别窗口和激活所选窗口，由你手动授权。
• 📴 应用没有任何网络请求，不上传窗口标题，不读取项目文件内容。
• 💾 应用列表、快捷键和标题识别方式保存在本机偏好设置中。
• 🙅 不需要输入监控或屏幕录制权限。
• 🩺 诊断文件只在显式传入参数时写入，内容为状态、计数和运行路径，不包含窗口标题或文件内容。

🛠️ 开发

测试与构建

swift test
zsh scripts/build-app.sh

核心逻辑测试覆盖固定窗口顺序、最近窗口选择、菜单重建、应用列表持久化、标题识别、双向循环，以及加载期间的快速按键和取消。系统授权、跨桌面、全屏和多显示器行为仍需实机验证。

🎭 演示模式

不授权也可以预览界面：

open -n dist/BKAppSwitch.app --args --demo

演示模式使用示例数据，不注册系统热键，也不会切换真实窗口。正常模式下，设置页同样提供“界面预览”入口。

🩺 诊断

排查问题时可以显式指定诊断文件路径：

open dist/BKAppSwitch.app --args --diagnostic-file /tmp/appswitch-status.json

📦 打包与签名

zsh scripts/package-release.sh

会生成 dist/BKAppSwitch-<版本号>-macOS-arm64.dmg 和对应的 .sha256 校验文件，镜像包含应用、Applications 快捷方式和中文安装说明。打包在独立目录中完成；如果已有同名发布文件，脚本会停止，避免覆盖。

本机构建默认使用临时签名。如果有 Apple Developer 签名身份，可以这样指定：

APPSWITCH_SIGN_IDENTITY='Developer ID Application: Your Name (TEAMID)' zsh scripts/build-app.sh

公开分发应完成 Developer ID 签名和 Apple 公证；当前脚本还没有自动公证流程。

🗂️ 代码结构

AppSwitch/
├── Sources/
│   ├── BKAppSwitch/          # 菜单栏入口、设置界面、窗口列表、热键、辅助功能交互
│   └── AppSwitchCore/      # 标题识别、应用选择、固定排序、切换状态（可独立测试）
├── Tests/
│   └── AppSwitchCoreTests/ # 核心逻辑单元测试
├── Resources/              # Info.plist、图标生成脚本、安装说明
├── scripts/                # 构建、安装、运行状态检查、DMG 打包
└── docs/images/            # README 图片

🤝 参与贡献

欢迎各种形式的贡献 💚

• 🐛 反馈问题：在 Issues 中描述问题。涉及窗口兼容性时，请附上 macOS 版本、芯片类型、BKAppSwitch 版本、目标应用及其版本、复现步骤，以及是否涉及全屏或多个桌面。
• 💡 提出建议：同样欢迎在 Issues 中讨论新想法。
• 🔧 提交代码：发起 Pull Request 前请运行 swift test 和构建脚本；涉及窗口交互的改动，请说明已经验证过的应用和场景。

[!WARNING] 提交截图和诊断信息前，请先检查并移除其中的私人内容。

📄 许可证

本项目基于 MIT 许可证 开源 © 2026 binbinku。

你可以自由使用、修改和分发本项目，只需保留许可证中的版权及许可声明。

_{如果 BKAppSwitch 对你有帮助，欢迎点一个 ⭐️}