KeyTip 0.2.1

KeyTip 0.2.1

• docs: 重写 README，补全 Releases 下载和配置说明，增加 HUD 主截图
• ui: 优化 HUD 滚动区，移除默认滚动条

需要 macOS 14.0+，首次运行需授予辅助功能权限。

KeyTip 0.2.0

这个版本引入了按应用生效的展示配置能力。现在可以从 HUD 直接打开当前 App 的配置文件，并通过 TOML 配置控制展示内容。

新增内容

• 支持按应用存储配置文件
• 配置文件格式改为 TOML
• HUD 中新增“配置”按钮，可直接打开当前 App 的配置文件
• 支持 include_system_shortcuts，控制是否显示系统读取到的默认快捷键
• 支持 hide，隐藏指定系统快捷键
• 支持自定义展示项
• 自定义展示项支持两种类型：
  • shortcut
  • command
• command 为展示型命令，不执行实际动作

HUD 交互增强

• 系统项支持复制 ID
• 系统项支持直接隐藏
• 隐藏后会立即写回当前 App 的 TOML 配置
• 隐藏后的内容会立即从当前 HUD 中消失

配置文件位置

~/Library/Application Support/KeyTip/apps/<bundle-id>.toml

KeyTip 0.1.0

这是项目的第一个版本，当前已经实现基础可用的核心能力：通过全局触发方式唤起 HUD，读取当前前台应用的菜单栏快捷键，并按分组展示出来。

本版本包含

• 菜单栏常驻运行
• 辅助功能权限检查与引导
• 当前前台应用识别
• 菜单栏快捷键读取
• HUD 浮层展示快捷键
• 触发修饰键和长按时长设置
• 按应用保存自定义配置
• 支持隐藏系统快捷键和追加自定义快捷键

当前限制

• 暂时还不能在界面中直接编辑隐藏项和自定义快捷键
• “登录时自动启动”尚未实现
• 不同应用对 Accessibility API 的支持程度不同，部分快捷键可能无法读取
• 测试覆盖还比较有限

说明

0.1.0 主要用于完成第一阶段能力验证，确认整体交互和技术方案可行。后续版本会继续补齐配置编辑、启动项、稳定性和兼容性方面的能力。