NATIVE MAC APP / OPEN SOURCE

你的 Mac 配置,
终于有入口。

忘了快捷键,找不到配置文件?
把终端、编辑器和桌面习惯,收进一套
找得到、改得明白、能恢复的配置。

v0.3.5 · 安装包 11.9 MB · macOS 14+ · Apple Silicon · 免费开源

MacKit 原生 App:快捷键列表、查询入口与配置来源
真实 Mac App 截图 · 查键与配置入口

v0.3.5 · 完善隔离自检与发行溯源;日常功能、配置与使用习惯保持原状。

zshNeovimHammerspoonGhosttytmuxYaziKarabiner / yabai

LESS HUNTING, MORE DOING

不用再猜,
它到底写在哪。

应用仍然使用自己的配置格式。MacKit 把入口、键位、个人偏好和恢复记录整理好。

01 / FIND

一个入口,找到配置

配置文件 → 读取文件 → 备份并保存

主配置和快捷键分别打开。行号、终端、桌面热键都有明确来源。

02 / UNDERSTAND

记得用途,就能查键

快捷键 → 输入“编号” → 查看按键与来源

搜索功能描述,同时看到按键、模式与源文件;在线手册由相同声明生成。

03 / RESTORE

先看变化,再安装

预览配置变化 → 备份并安装 → 按记录恢复

已有配置先备份。每次安装有恢复记录,重复应用不会叠加改动。

资源占用

资源占用与响应速度。

原生 SwiftUI;配置引擎仅在操作时启动并退出,没有轮询或定时任务。随包附带 Python 标准库运行环境;剥离符号并移除运行不需要的开发文件。

11.9 MB

安装包

下载文件大小;装好后 23.9 MB。

49.3 MB

空闲内存

所列采样窗口内存,口径为 phys_footprint。

0 %

空闲 CPU

不操作时 60 秒内的平均占用。

395 ms

速度

冷启动到窗口出现(中位数)。

v0.3.5 (0.3.5) · Mac16,12 / Apple M4 / macOS 27.2 · 真实本机配置:tianli 预设 14 个组件、1017 条快捷键声明(含现有外部键表) · 测量日期 2026-10-01。数字来自所列设备实测,版本更新后重新测量。

WINDOWS · YABAI + SKHD

窗口管理,
不用记参数。

v0.3.0 新增「窗口」页(⌘5)。yabai 和 skhd 本来只有配置文件;现在每项设置都有中文说明,改完一键生效。

MacKit 窗口页:yabai 运行状态与带说明的设置表单
真实 App 截图 · 运行状态与 yabai 设置(右侧灰字为当前实际运行值)
MacKit 窗口页:skhd 快捷键列表,可点按录制并选择动作
真实 App 截图 · skhd 快捷键:点按录制,动作从列表选
01 / SETTINGS

设置有说明,留空即默认

布局、间隙、鼠标修饰键、焦点跟随等做成表单,旁边显示 yabai 当前实际运行的值。

02 / SHORTCUTS

按一下就录好快捷键

不用写 skhd 语法。录入时对照快捷键目录,标出与 Hammerspoon、Keyboard Maestro 等的全局键冲突。

03 / SAFE SAVE

先备份,再生成配置

保存时重新生成 yabairc / skhdrc,旧文件先备份;文件被别处改过会拒绝覆盖。可立即在运行中的 yabai、skhd 生效,也能在页面上启动或停止它们。

SEE IT WORK

看一次,就会用。

命令行补充演示 · v0.1.0。在隔离目录运行真实 CLI,按步骤回放输出;App 界面见上方截图。

v0.1.0 · 真实 CLI 输出回放 · 分段字幕 · 无配音下载 MP4 · 操作文字版

GET STARTED

下载、拖入,然后配置。

App 自带运行环境,无需先装 Python 或 Git。支持 macOS 14+ 和 M 系列芯片,Developer ID 签名并经 Apple 公证。

01

下载并拖进应用程序

在“下载”文件夹打开 DMG,把 MacKit 拖到 Applications。然后从“应用程序”打开。

下载 Mac App · v0.3.5 ↓
02

选组件,预览与装依赖

在“安装配置”选预设和组件,点“预览配置变化”。点“安装缺失软件与依赖”;没有 Homebrew 时,先用 App 的“安装 Homebrew”入口完成系统安装器。

03

备份并安装配置

确认文件列表后,点“备份并安装配置”。重新打开终端和相关应用;在“检查与恢复”检查结果或恢复原配置。

管理员密码只在系统安装器输入。桌面权限按应用提示确认;yabai/skhd 需按官方说明安装,装好后可在「窗口」页启动或停止。下载校验值 · 发行说明 · CLI 配置包(含 Intel 用法)

YOUR HABITS, YOUR CHOICE

通用默认,个人预设。

保留习惯不等于把同一套激进热键强加给所有人。默认从终端组件开始。

DEFAULT / DEVELOPER

给直接安装的开发者

保留 Neovim 原生移动键与 Ctrl-W 窗口操作。桌面全局热键不默认启用,AI 插件不默认启用。

App 选择 Developer · 通用开发

OPTIONAL / TIANLI

给熟悉这套习惯的人

S 保存,Q 退出,J/K 跳 15 行;右 Option → Hyper。Hammerspoon 菜单里逐项开关;右 Command 切应用改由独立的 Initials 提供。

App 选择 Tianli · 个人习惯

已安装用户切换预设前,先在“检查与恢复”恢复当前安装。个人路径、账号和设备标识留在 ~/.config/mackit,不随开源包分发。

WHEN YOU GET STUCK

看到问题,知道下一步。

我记得是 01、02 那个键?

Neovim 中按 V 选中行,用 j/k 扩选,再依次按「空格 n l」,文本会变成 01_、02_。屏幕左侧的行号是另一项设置,用 mackit edit number 修改。

doctor 提示 missing command 或 missing app

回到“安装配置”,预览后点击“安装缺失软件与依赖”。若安装器要求管理员密码或权限,在系统窗口完成;遇到网络失败,可保留已有成果后重试。

第一次打开 Neovim,插件没下载成功

先检查能否用 Git 访问 GitHub,再重新打开 Neovim,运行 :Lazy sync。代理返回 503 时需修复网络后重试。原生编辑不依赖 AI 账号;Copilot 只在个人预设启用,使用前需自行授权。

安装后全局热键没有反应

确认使用 tianli 预设,Hammerspoon 正在运行,并在 macOS「隐私与安全性」授予它辅助功能权限。点击菜单栏 ⌨ 检查开关。Karabiner 的系统扩展与输入监控权限按 App 自带引导完成。yabai/skhd 装好后可在 App「窗口」页启动或停止。

想恢复原来的配置

打开“检查与恢复”,点击“恢复最近一次安装”,按从新到旧的顺序恢复。如果你安装后换成了新文件,恢复命令会提示先保留新内容,避免覆盖。

它能判断所有快捷键冲突吗?

doctor 检查套件内的声明范围与重复键。系统权限、插件内建默认键,以及其他 App 是否抢先拦截,需要运行时核查;它不会把“配置存在”当成“按键一定送达”。

KEEP YOUR FLOW

下次忘了,
从一个入口重新找到。