KeySwitch
下载

Documentation · 0.23.3

KeySwitch 使用手册

从第一次绑定到复杂窗口切换，查找当前版本的准确操作说明。

快速开始

  1. 打开 KeySwitch，点击“绑定应用”。
  2. 搜索并选择应用，无需手动填写程序路径。
  3. 点击快捷键录制按钮，按下包含修饰键的组合键，例如 Alt + W。
  4. 选择 Toggle 或“始终激活”，保存后立即生效。

也可以使用“批量添加”“从任务栏选择”或“从运行中选择”，一次配置多个应用。

录制快捷键时，KeySwitch 会在保存前立即检查是否已分配给其他绑定应用、是否为保留快捷键，以及是否被其他程序占用。发生冲突时会显示冲突应用名称或占用来源，并保留原快捷键设置。

切换行为

  • 快捷键触发后会立即启动、激活或 Toggle 目标应用，不需要先松开 Alt、Ctrl、Shift 或 Win。KeySwitch 不会合并目标应用的输入线程；修饰键释放后只清理当前目标的残留菜单状态，不会再次切换窗口。

当前应用的多个窗口

  • 在“通用设置”第一屏的“同应用窗口切换”重点卡中开启或关闭，默认开启；卡片会直接展示快捷键和切换范围，关闭全局快捷键总开关时会一起暂停。
  • 按 `Alt + `` 在当前前台应用的有效窗口之间循环，不需要为该应用创建绑定。
  • 窗口按稳定的最近使用顺序循环；完成一轮后回到第一个窗口，不会在末尾隐藏窗口。
  • “当前桌面”只处理本桌面的普通主窗口；“跨桌面”处理所有桌面的普通主窗口，优先在窗口原桌面激活并切换过去，只有激活失败时才把窗口移动到当前桌面。
  • 两种范围都排除开发者工具、弹窗、工具窗口和辅助窗口；范围选择修改后立即生效并在重启后保留。
  • 只有一个有效窗口时不执行任何操作；目标窗口最小化时会恢复并激活。
  • 该功能不启动或隐藏应用，不改变窗口坐标、尺寸或最大化状态，并随“启用全局快捷键”总开关一起暂停或启用。
  • `Alt + `` 是 KeySwitch 保留快捷键，不能再绑定给单个应用。

Toggle

  • 单窗口应用：窗口在前台时隐藏，再次按快捷键恢复并激活。
  • 多窗口应用：按最近使用顺序循环，循环结束后隐藏该应用的全部有效窗口。
  • 对具有 D3D 输入宿主和托盘能力的应用，KeySwitch 会按窗口框架选择安全 Toggle：Chromium 顶层窗口由应用自行收起并从原入口唤醒；Qt 外壳窗口保留原句柄，恢复时执行完整窗口恢复而不是普通显示。
  • 不移动或缩放窗口，不改变正常窗口坐标和尺寸。
  • 应用窗口已经最小化时，快捷键会恢复最近使用的窗口。

始终激活

  • 应用没有运行时启动应用。
  • 应用已经运行时激活最近使用的有效窗口。
  • 重复按键不会主动隐藏窗口。

虚拟桌面

每个应用都可以单独设置虚拟桌面范围：

  • 跟随应用：只切换当前桌面窗口；没有窗口时由应用决定复用还是新建。
  • 全局复用：跨桌面查找已有窗口，并将选中的窗口移动到当前桌面。适合微信等只希望保留一组窗口的应用。
  • 当前桌面独立：只使用当前桌面窗口；没有时发出新窗口启动请求。VS Code 可配合 --new-window 参数使用。

应用自身如果强制单实例，KeySwitch 不会绕过该限制。

应用更新

WindowsApps/MSIX 应用更新后，KeySwitch 会使用 Package Family 和 AUMID 自动修复旧路径。正常情况下不需要重新绑定快捷键或手动刷新缓存。

外观与通用设置

  • 外观支持跟随系统、浅色和深色主题，并可选择强调色和紧凑布局。
  • 通用设置支持全局热键开关、登录启动、关闭到托盘、切换浮层和托盘图标。
  • “显示语言”默认跟随 Windows，也可以手动选择简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语、葡萄牙语（巴西）或俄语。切换后立即生效并自动保存。
  • 十种语言的界面和安装程序均完整本地化；中文界面打开中文手册，其他语言界面暂时统一打开英文手册。
  • 关闭主窗口后，KeySwitch 默认继续在系统托盘运行。

使用统计

“使用统计”记录累计调用次数、最近七天趋势和各应用占比。数据仅保存在本机，不记录普通键盘输入或窗口内容。

许可证与试用

  • 侧边栏“关于”页面集中展示产品信息、许可证、帮助、诊断和隐私信息；许可证区域显示当前套餐、状态、权益、账号、许可证或试用到期时间和设备上限，不显示离线剩余天数或离线截止时间。
  • 免费版支持最多 5 个应用绑定、标准桌面模式和最近 7 天用量；当前 0.23.3 为权益预览模式，超出免费权益只提示，不会停用已有快捷键或配置。
  • 每个邮箱账号可在许可证网页领取一次 14 天 Pro 试用。当前客户端已识别不限绑定、高级虚拟桌面和完整用量等 Pro 权益；配置备份、配置组、规则和同步仍在规划中，尚未开放使用。
  • 在许可证网页用邮箱验证码登录，生成 10 分钟有效的一次性激活码，再回到客户端完成激活。每个账号同时只有一个有效激活码；从任意试用或 Pro 许可证生成新码后，此前未使用的码立即失效。默认最多激活 3 台设备。
  • 客户端联网时每 24 小时刷新授权；离线且许可证仍有效时按最近一次签发的权益继续运行，并保持显示正常“已激活”状态，不展示“离线宽限”、剩余天数或截止时间。
  • 更换设备前可在客户端解绑，也可以在网页“设备”页解绑。支付、价格和网页购买尚未接入，Pro 许可证当前由管理员发放。
  • 管理员降低设备上限后，最近连接的设备优先保留授权，超出上限的旧设备会在下次刷新时显示“设备已满”；快捷键和配置不会因此被删除。
  • 管理员可在许可证网页“管理”页搜索普通用户并选择“模拟登录”。模拟期间顶部会持续显示目标账号和原管理员，只能使用普通用户功能；点击“返回管理员账号”可退出。进入、退出及代用户写操作都会写入审计，管理员账号之间不能互相模拟。
  • 未激活时，“关于”页面显示激活码输入；激活成功后该区域自动隐藏，解绑后重新出现。授权服务地址由客户端内置，不在界面或用户设置中提供修改入口。
  • 如果本地许可证文件损坏或无法验证，“关于”页面的许可证区域会显示“验证失败”且不会授予 Pro 权益。重新输入网页生成的激活码即可恢复，原有快捷键和应用配置不会被删除。
  • 如果登录、激活或刷新操作过于频繁，服务会暂时限流；等待一分钟后重试即可，不要连续重复提交。

常见问题

快捷键没有反应

  1. 确认应用绑定已启用，且“全局热键”总开关已开启。
  2. 检查快捷键是否被其他软件占用。
  3. 在“通用设置”中打开日志，查看对应 HOTKEY、LOOKUP、ACTIVATE 或 ERROR 记录。

更新应用后无法启动

新版会在首次快捷键调用时自动修复稳定身份。如果仍失败，在“通用设置”中刷新应用缓存，再查看日志中的 PACKAGE_IDENTITY_REPAIRED 或错误信息。

虚拟桌面上重复打开应用

将该应用编辑为“全局复用”。已经存在的重复窗口不会被自动关闭，KeySwitch 只负责后续复用，避免继续重复启动。

Toggle 后窗口无法点击

对于具有 D3D 输入宿主和托盘能力的应用，KeySwitch 会按窗口框架选择安全恢复方式，避免普通显示破坏输入路由。Chromium 顶层窗口由应用自行隐藏和恢复；使用 Qt 外壳的嵌入式 Chromium 窗口保留原句柄，并通过完整窗口恢复重新建立输入状态。如果应用进程已被旧版本切换到无法点击的状态，请完整退出并重新打开该应用一次；升级后重复 Toggle 应能在恢复后的第一次点击立即响应。如果问题持续，请保留现场并打开日志，不要删除配置。

本地数据

  • 配置：%APPDATA%\KeySwitch\settings.json
  • 缓存：%LOCALAPPDATA%\KeySwitch\Cache
  • 日志：%LOCALAPPDATA%\KeySwitch\switch.log
  • 本地许可证：%APPDATA%\KeySwitch\license.dat（使用当前 Windows 账号的 DPAPI 加密）
  • 安装目录：%LOCALAPPDATA%\Programs\KeySwitch\Active

卸载应用不会主动删除上述用户配置和统计数据。