QuickPath

macOS 菜单栏工具：把当前 Finder 路径一键打开到终端 / 编辑器，或复制为可粘贴的 shell 路径。

功能

• Finder 右键菜单与工具栏操作
• 默认终端 / 默认编辑器（支持从应用列表选择，也可选择任意 .app）
• 复制 shell 转义后的路径
• 菜单栏快捷操作与单击快速执行
• 全局快捷键（可限制仅在 Finder 前台生效）
• 登录时启动
• 原生 SwiftUI 设置界面

系统要求

• macOS 26 或更高版本
• 从源码构建需要 Xcode

安装

1. 从 Releases 下载 QuickPath-x.y.z-macOS.zip
2. 解压后将 QuickPath.app 拖到「应用程序」
3. 首次打开后：
   • 在设置中启用 Finder 扩展
   • 首次打开终端 / 复制路径时，允许 自动化（控制 Finder）

从源码构建

./script/build_and_run.sh --verify

构建产物：dist/QuickPath.app

其他常用命令：

./script/build_and_run.sh          # 构建并启动
./script/build_and_run.sh --debug  # 构建并以 lldb 启动
./script/build_and_run.sh --logs   # 构建、启动并跟踪日志
./script/run_tests.sh              # 运行单元测试
./script/package_release.sh        # 构建并打包发布 zip

使用提示

• 隐藏菜单栏图标后，可再次打开应用（启动台 / 再次运行 App）进入设置
• Finder 扩展支持主目录、外置磁盘等常见位置
• Neovim 会自动查找本机 nvim 路径

致谢

QuickPath 受 OpenInTerminal（Jianing Wang）启发。感谢原项目与贡献者。

快捷键录制 UI 使用 ShortcutRecorder。

许可证

MIT。详见 LICENSE。