ZRightClick 是一款原生 macOS Finder 右键增强工具,专注于日常文件操作。选好需要的菜单、文件类型和终端,关闭设置窗口后,它会安静地留在菜单栏中。
项目状态: 已提供 1.1 通用版下载(Apple 芯片 + Intel)。当前使用临时签名,未经 Apple 公证;尚未提供 Developer ID 正式签名版或 Mac App Store 版本。源码公开不代表授予软件使用许可,详见使用与版权。
| 功能 | 使用体验 |
|---|---|
| 新建文件 | 两级右键菜单,内置 .txt、.md、.docx、.xlsx、.pptx,附带类型图标。 |
| 自定义文件类型 | 添加 .js、.py、.json、.d.ts 等后缀来创建空文件。内置类型可勾选启用,自定义类型可添加、停用或删除。 |
| 复制路径 | 一次复制多个选中文件或文件夹的路径。 |
| 在此处打开终端 | 自选系统 Terminal、iTerm2、Ghostty 或 Warp;显示安装状态,所选终端不可用时,本次回退系统终端。 |
| 菜单栏常驻 | 关闭设置窗口后隐藏 Dock 图标,应用继续运行。从菜单栏重新打开设置或真正退出。 |
| 中英文切换 | 中文与 English 即时切换,自动保存选择,并同步到 Finder 扩展。 |
三个一级菜单都有独立开关。设置自动保存,下次打开右键菜单时生效。
应用使用 SwiftUI + AppKit,右键菜单由 FinderSync 扩展提供,没有第三方软件包依赖。
下载 DMG 安装包 · ZIP 压缩包 · 更新说明与校验值
- 打开 DMG,将 ZRightClick.app 拖入应用程序。使用 ZIP 时,解压后将应用移入应用程序目录。
- 从应用程序目录启动,按首次启用引导打开系统扩展设置,并开启 ZRightClick。
- 当前版本未经 Apple 公证。如果 macOS 阻止打开,请先确认下载来源与校验值,再参考 Apple 官方打开说明,在可用时前往系统设置 → 隐私与安全性 → 仍要打开。
同一安装包包含 arm64 和 x86_64,支持 Apple 芯片与 Intel Mac,要求 macOS 15 及以上。原位替换同一应用时会保留已有设置和目录授权。
- 运行: macOS 15 及以上。
- 构建: Xcode、macOS SDK 与命令行工具。当前工程已在 Xcode 27.0 beta 上验证,旧版 Xcode 尚未验证。
- 模板检查: Python 3。应用运行本身不依赖 Python。
git clone https://github.com/inexom/ZRightClick.git
cd ZRightClick
./scripts/dev.sh脚本会编译 Release 版本、替换 /Applications/ZRightClick.app、注册 Finder 扩展、启动应用,并重启 Finder。构建失败时会停止,不会安装旧产物。这是本地开发安装流程,并非正式签名的分发安装包。
也可以用 Xcode 打开 ZRightClick.xcodeproj,选择 ZRightClick scheme。仅编译的命令、签名说明和检查方式见开发文档。
- 首次打开时,点击引导中的打开系统设置,在系统列表中启用 ZRightClick,返回应用后点击开始使用。部分 macOS 版本将此列表称为“文件提供程序”。手动入口通常在系统设置 → 通用 → 登录项与扩展中。
- 打开 ZRightClick,勾选希望显示的右键功能。
- 在普通文件夹空白处右键使用新建文件;选中文件或文件夹后,可复制路径或打开对应位置的终端。
- 首次执行文件或终端操作时,在系统弹窗中选择目标文件夹或它的上级目录。
授权会保存供后续复用。新建文件需要读写权限,打开终端可使用只读权限。在目录授权页可以查看或移除已保存的授权。
扩展未启用时,设置页会持续显示提醒;可以通过右上角的**扩展设置…**重新打开引导。引导检测真实系统状态,不会代替你开启开关。
- Office 文档使用应用自带的空白模板,无需安装 Microsoft Office 即可创建。后续打开文档需要兼容的软件。
- 中文界面默认创建
未命名.ext,英文界面创建Untitled.ext。重名时自动编号,不覆盖已有文件、目录或符号链接。 - 创建后在 Finder 中选中文件,不自动打开编辑器。按 Return 即可重命名。
- 自定义后缀创建空文件。PDF、图片、旧版 Office 等已知需要特定结构的格式,不能作为自定义空文件添加。
在终端设置中选择默认应用。全新安装默认使用系统 Terminal,页面会显示各终端的安装状态,也可以选择文件夹测试打开;测试不会新增保存的目录授权。
如果所选终端已被移除或启动请求失败,本次会尝试系统 Terminal,同时保留你的偏好。第三方终端首次使用时,可能需要先完成它自己的初始设置。
主应用和 Finder 扩展均保留 App Sandbox。扩展把固定操作和路径转交给主应用,由主应用通过系统文件夹选择器请求权限,并保存安全作用域书签。
打开终端通过应用 URL 实现,不生成 shell 命令,也不请求 Apple Events 自动化权限。已保存的目录授权可以在设置中移除。语言切换作用于应用自身的文案;系统文件选择器中的控件仍由 macOS 决定语言。
Finder 右键菜单没有出现怎么办?
确认系统设置中已启用 Finder 扩展、应用内对应开关已打开,然后关闭并重新展开右键菜单。请先在普通文件夹中测试,避免搜索等虚拟视图。开发安装问题可运行 ./scripts/dev.sh status,并查看排查说明。
每次使用都需要重新授权吗?
正常情况下不需要。应用会保存安全作用域书签,在需要时恢复授权,包括主应用退出后的再次使用。授权失效或被移除时可能需要重新选择目录。已有只读授权不会自动升级为写入权限。
关闭窗口是不是退出应用?
不是。关闭窗口会释放设置界面、隐藏 Dock 图标,同时保留菜单栏入口。选择退出 ZRightClick才会停止主应用。Finder 扩展由 macOS 单独管理,之后的 Finder 文件操作仍可重新唤起主应用。
所有终端都经过完整实测了吗?
系统 Terminal、iTerm2 和 Ghostty 已进行本机测试。Warp 的启动请求已成功,但首次设置之后的实际 shell 工作目录尚未确认。当前验证范围与限制见开发文档。
运行 Foundation 层测试和 Office 模板检查:
./scripts/test.sh开发文档介绍了架构、本地构建、Finder 手动验证和已知限制。欢迎通过 GitHub Issues反馈问题、提出功能建议或改进翻译。
Copyright © 2026 inexom。保留所有权利。
当前未授予软件许可(No license)。源码公开不代表授权他人使用、修改、再分发或商业化;其他人的商业使用需要取得版权所有者许可。GitHub 平台提供的公开仓库查看与 fork 权利仍依其服务条款执行。参见 GitHub 关于无许可证仓库的说明。
