gksdud 是一款专为 macOS 打造的韩英切换（한영 전환）工具：不用 Karabiner、不用复杂配置，一个应用就能实现无延迟、不吞字的韩英切换，还支持长按韩英键切大小写、特殊字符输入、多语言输入源管理等 8 项实用功能。如果你受够了系统切换的卡顿与吞字，这篇指南带你 5 分钟上手全部进阶玩法。

为什么 macOS 韩英切换总"卡一下"？

macOS 的系统切换快捷键在松手时才生效，快速打字时经常出现两个经典问题：

• 切换延迟：按下韩英键后，要等松手才切换，打断输入节奏
• 吞字（씹힘）：连续输入中切换时，有一个字符用旧输入法打进去了

gksdud 的思路很巧妙：把韩英键映射到 F 键（默认 F19），并在按下的瞬间就触发"选择上一个输入源"系统快捷键，从而在系统处理前完成切换——既快又不吞字。它不直接改输入法状态，只做键映射和事件转发，所以设置不容易"越弄越乱"。

实现细节可以参考 docs/tricks.md。

安装 gksdud：Homebrew 一条命令搞定

🏁两种安装方式，推荐 Homebrew：

brew install --cask codingnoye/tap/gksdud

或者手动安装：从发布页下载 ZIP，解压后将gksdud.app拖入"应用程序"文件夹即可。

三步启用：

1. 运行 gksdud，菜单栏会出现一个类似系统输入源的图标（可用⌘+拖拽调整位置）
2. 按提示允许辅助功能权限，然后打开"启用"
3. 在任意输入框中韩英来回切换测试一下——速度差异立刻能感受到

完整说明见 README.md。

功能 1：韩英键自定义——右⌘、Caps Lock 随便选

默认系统切换用 Caps Lock 或⌃ + 空格，很多人想换成右手更顺手的键。gksdud 支持把以下键设为韩英键：

• right-command（右⌘，默认推荐）
• right-option、right-control、caps-lock
• 组合键：ctrl-space、cmd-space、opt-space、shift-space

而且支持多键并用（比如右⌘和 Caps Lock 都当韩英键），还能按键盘分别设置——外接键盘和内置键盘可以各用各的韩英键。相关逻辑在 KeyboardManagement.swift 中实现。

功能 2：按下即切换——彻底告别延迟和吞字

这是 gksdud 的核心体验。传统方案（Karabiner + 手动改系统快捷键）仍然是"松手切换"，而 gksdud 在事件层面拦截韩英键，按下瞬间就发出"按下 + 抬起"的 F 键事件对，赶在系统快捷键处理之前完成切换：

• 按下即切，零延迟
• 快速输入中切换，不再吞字
• 不需要安装 Karabiner，应用退出后自动还原原映射

原理细节见 docs/tricks.md。

功能 3：长按韩英键切换大小写（进阶玩法 ⭐）

这是标题点名的进阶功能，也是最"反直觉"的玩法。开启long-press后：

• 轻点韩英键 → 正常切换韩/英
• 长按 0.5 秒→ 先切换到英文，再直接切换 Caps Lock 大小写

关键在于它没有等待延迟：按下瞬间就先完成韩英切换，如果你继续按住不放，0.5 秒后自动翻转大小写状态。也就是说"切换 + 切大小写"一次按键全搞定，不用先按 Caps Lock 再切换。

📌 适用场景：写英文邮件时想快速切到大写首字母、或者经常在小写/大写间反复横跳。设置项为long-press（on/off），源码见 FeatureTests.swift 中的对应测试。

功能 4：韩英切换时大小写保持

韩文输入法切到韩文时会强制关闭 Caps Lock，导致切回英文后大小写"丢失"。开启preserve-case后：

• 英文大写字母状态下切去韩文，再切回英文时依然保持大写
• 与功能 3 的长按功能可独立开关、也可叠加使用

功能 5：韩文状态下用 Caps Lock 切大小写

默认韩文模式下 Caps Lock 是"摆设"。开启korean-caps-lock后：

• 韩文状态下按 Caps Lock 也能记录英文大小写状态，Caps Lock 指示灯与实际大小写一致
• 从韩文按 Caps Lock 切回英文时，大小写正确还原

⚠️ 注意：此功能依赖功能 4（大小写保持）开启，且不能在用 Caps Lock 当韩英键的同时使用。

功能 6：韩文状态下输入特殊字符（Option 字符）

macOS 韩文模式下按⌥ + 字符无法像英文那样输入特殊符号。gksdud 提供三档模式（special-chars设置）：

这个功能背后是完整的"英语往返"机制：临时切换到英文输入源、发送按键事件、再把期间的所有按键按序回传给韩文输入源，连 dead key（如⌥E）的连音组合都能正确处理。源码见 SpecialCharacters.swift。

功能 7：₩ 与 ` 键位互换

英文键盘上`键输出反引号，但切到韩文后同一位置输出 ₩。开启backquote后：

• 韩文下直接输出`（和英文一致）
• 需要 ₩ 时用⌥ + ₩输入

对经常写代码（反引号无处不在）又兼用韩文的用户非常实用。

功能 8：多语言输入源管理（中文、日文一键循环）

如果你还输入中文或日文，系统的"上一个输入源"切换顺序很难用。gksdud 的输入源管理（added-sources）可以：

• 自定义韩英键的循环顺序，如：韩 → 英 → 简中 → 日 → 韩……
• 为某个输入源设置专属切换键，在"该输入源 ↔ 韩/英"之间直接来回
• 菜单栏图标只显示最终到达的输入源（最多 3 字符的语言代码）
• 提供 Universal Control 兼容模式（universal-control），避免多 Mac 互联时的切换冲突，见 UniversalControl.swift

输入源相关实现在 InputSources.swift。

加分项：CLI 命令行，脚本化控制一切 🚀

除了图形界面，gksdud 还内置了gksdud命令行工具，可以和 Hammerspoon、Karabiner-Elements、skhd、Raycast、Shell 脚本无缝集成：

gksdud pause # 临时暂停（比如用远程桌面/虚拟机时） gksdud resume # 恢复 gksdud set long-press=on escape=on # 改配置并立即生效 gksdud source ko # 切换到韩文输入源 gksdud status --json # 查看当前状态

典型用法：

• 切到远程桌面/虚拟机应用时自动暂停，让韩英键"原样透传"给系统，几毫秒内完成，不触碰系统快捷键
• 给中/英/日各设一个快捷键（如⌘⌥1/2/3），直接切换输入源
• 用--wait参数确保切换落地后再发按键，适合自动化工具

完整命令、设置项和退出码说明见 docs/cli.md，CLI 实现在 CLITool.swift 与 CLIServer.swift。

更多细节功能速览

功能与权限依赖的完整对照表见 docs/tricks.md。

常见问题 FAQ

Q：为什么"启用"是灰的，点不了？A：gksdud 需要辅助功能权限来拦截键盘事件。按设置窗口的提示到"系统设置 → 隐私与安全性 → 辅助功能"中允许后，再手动打开"启用"。

Q：退出 gksdud 后我的键盘会恢复原样吗？A：会。gksdud 在写入任何映射前先保存原始信息，退出或卸载时只还原自己写入的部分，不会动你原有的 Karabiner 等配置。

Q：能同时用 Caps Lock 当韩英键 + 韩文 Caps Lock 大小写吗？A：不能，二者互斥。把 Caps Lock 用作韩英键后，系统层面 Caps Lock 功能已被占用，此时建议用"长按韩英键切大小写"替代。

Q：切换中/日等输入源时偶尔不生效？A：可开启"兼容性模式"（compatibility），它会在连续切换间增加安全间隔，兼容 WeChat 输入法等第三方输入法。

总结

gksdud 用极简的"键映射 + 事件转发"思路，把 macOS 韩英切换的体验拉满：

1. ✅ 韩英键自定义，多键盘差异化设置
2. ✅ 按下即切，零延迟不吞字
3. ⭐ 长按韩英键 0.5 秒切大小写
4. ✅ 韩英切换大小写保持
5. ✅ 韩文下 Caps Lock 切大小写
6. ✅ Option 特殊字符 / 拦截
7. ✅ ₩ 与`互换
8. ✅ 多语言输入源循环 + 专属切换键
9. 🎁 附赠 CLI 脚本化、ESC 小写、菜单栏图标替换

想深入了解实现原理，可以阅读 docs/tricks.md（各功能的实现技巧与互斥关系）；想参与开发，参考 CONTRIBUTING.md 和 SelfTest.swift 的自测工具。