# qumenu
**Repository Path**: qukaifa/qumenu
## Basic Information
- **Project Name**: qumenu
- **Description**: 免费的Macos右键菜单扩展软件
- **Primary Language**: Swift
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-09-18
- **Last Updated**: 2026-09-27
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# QuMenu
[English](README_EN.md) | **中文**
🚀 轻量的 macOS Finder 右键菜单增强工具。完全免费，仅供个人使用。
---
## ✨ 功能亮点
### 📂 右键打开
把常用应用加入 Finder 右键菜单，一键"用 XX 打开"。文件、文件夹、多选、空白处右键统统支持。
### 📄 快速创建
自定义"创建新文件"菜单项，右键即可快速创建指定类型的文件(docx/xlsx/pptx/txt等)，告别繁琐操作。
### 🖥️ 双击回桌面
在 桌面任意空白位置双击鼠标，立即回到桌面，点击Dock栏应用恢复
### 🖼️ 图像处理
在 Finder 里选中图片右键，直接跑预设好的处理流水线——压缩、转格式、改尺寸、去 EXIF，一次搞定；多选批量也行。
- 预设在主界面「图像处理」里配置，右键菜单只列预设名，点一下整套跑完
- 结果生成在原图旁边（`photo-网页分享.jpg`），**原文件不动**
- 支持 JPEG / PNG / TIFF / AVIF / HEIC / BMP / GIF / TGA / PSD
首次启动会注入一个 `默认预设`：`压缩 75% · mozjpeg → 调整 1280 → 保存到 qumenu`——压到 75%、长边缩到 1280、收进原目录下的 `qumenu/` 子文件夹。不需要的话直接删掉即可。
**推荐预设**（照着在「图像处理」里建就行）：
| 预设名 | 动作流水线 | 产出示例 | 适合场景 |
|---|---|---|---|
| `网页分享` | 压缩 75% → 调整 1920 → 去除 EXIF | `photo-网页分享.jpg` | 发博客 / 邮件：体积小、宽度受控、不带拍摄位置 |
| `转AVIF` | 转换 → AVIF → 压缩 75% | `photo-转AVIF.avif` | 要最小体积的备份 / 上传 |
| `去隐私` | 去除 EXIF | `photo-去隐私.<原格式>` | 保留原格式，只清掉拍摄位置等元数据 |
| `缩略图` | 调整 640 → 保存到 缩略图 | `缩略图/photo-缩略图.<原格式>` | 批量出一版长边 640 的小图 |
> 一个预设里每种动作只能有一个，要改就编辑原条目。`压缩` 只对 JPEG / AVIF / HEIC 生效，对 PNG / TIFF 这类无损格式没有效果。
---
## 💻 系统要求
- macOS 15.0+（仅 Apple Silicon 芯片，暂不支持 Intel）
- 仅限 macOS
## 📦 安装
1. 从 [Releases 页面](https://gitee.com/qukaifa/qumenu/releases) 下载 `QuMenu-{版本}-mac-arm64.dmg` 并双击打开
2. 将 `QuMenu.app` 拖入旁边的「应用程序」文件夹，完成后可弹出 dmg
3. 首次打开参考下方「首次启动」解除系统拦截
> 如果直接双击了镜像里的应用，QuMenu 会提示一键复制到「应用程序」并重新打开。
## 🔓 首次启动
本软件未通过 Apple 开发者签名，首次打开会被系统拦截，这是正常的，参考一下方案
一、**系统设置**
双击打开 → 系统设置 → 隐私与安全性 → 点击"仍要打开"，允许运行任意来源
```bash
sudo spctl --master-disable
```
**二、解决签名或兼容性问题**
绕过macOS隔离机制，有助于排除因元数据异常导致的崩溃或运行不正常
```bash
xattr -cr /Applications/QuMenu.app
```
> 只需操作一次，之后正常启动即可。
## 🔐 权限说明
⚠️频繁弹窗提示"想访问其他App数据"
> 新安装或版本更新出现这个问题，需要在磁盘完全访问权限里：删除应用再重新添加QuMenu
>
> 原因是：未签名的应用会出现安全沙箱机制问题，重新安装的应用和历史授权不是同一个应用
macOS 的隐私保护会按需拦截功能。下表按"用到该权限的功能"列出应用可能需要的所有授权，以及不授权时的具体影响：
| 权限 | 不授权的症状 | 系统设置位置 |
|---|---|---|
| **Finder 扩展** | 右键菜单完全不出现 | macOS 27+：隐私与安全性 → **设备控制和数据访问**
macOS 26 及更早：通用 → **登录项与扩展** |
| **完全磁盘访问** | 右键菜单只剩"移动到 / 复制路径 / 隔空投送"3 项 | 隐私与安全性 → **完全磁盘访问** |
| **辅助功能** | 双击显示桌面、快捷键无反应 | macOS 27+：隐私与安全性 → **设备控制和数据访问**（与 Finder 扩展同分区，但为独立条目）
macOS 26 及更早：隐私与安全性 → **辅助功能** |
> macOS 27+ 的 Finder 扩展和辅助功能都在"设备控制和数据访问"分区下，但对应不同的系统条目，需分别授权。
>
> 升级或重装新版本后，系统设置可能仍显示"已开启"但实际已失效（未签名应用的权限绑定到具体安装副本）。重启 QuMenu，下次启动会重新触发授权窗。
---
## ⛓️ 已知限制
- iCloud 云文件夹（iCloud Drive、iCloud 桌面与文稿）内右键菜单不生效。这是 macOS 对 Finder 扩展的限制，本地目录不受影响。
- 图像处理不支持 **WebP** 和 **RAW**：系统的图像编解码器无法写出 WebP，RAW 处理慢且效果差。
---
## 🔧 技术架构
- **QuMenu**：SwiftUI 主应用，负责配置管理
- **QuMenuFinderExt**：Finder Sync 扩展，负责右键菜单
- **Shared**：共享配置与数据通信
## 📝 许可证
仅供学习与个人使用。
## 💬 反馈
有问题或建议？欢迎到 [Gitee Issues](https://gitee.com/qukaifa/qumenu/issues) 反馈。