开始使用
按照以下步骤启用并开始使用 Moustellix。
- 1启用 Finder 扩展在 Moustellix 总览中点击“管理扩展”，在系统设置中启用当前版本的 Finder 扩展。
- 2选择菜单范围在偏好设置 → 通用 → 右键菜单中开启“全局 Finder 右键菜单”，或在“文件访问”中添加授权目录。
- 3选择并操作文件在 Finder 中右键文件、文件夹或目录空白处，打开 Moustellix 子菜单，选择需要的操作。
你也可以直接使用应用中的“总览”或“工具箱”。需要文件的功能会先打开选择器，取消选择不会执行操作。
右键菜单
标准版通过 Finder 扩展在原生右键菜单中追加一个 Moustellix 子菜单，保留系统的打开、复制和显示简介等项目。
“全局 Finder 右键菜单”适用于普通 Finder 文件目录及已挂载磁盘；关闭该开关时，菜单只在你授权的目录范围内显示。搜索、最近使用、系统保护区域和部分云盘视图中的菜单显示由 macOS 决定。
在应用左侧的“右键菜单”页面中，你可以启用、排序、改名或折叠操作项目。菜单显示范围不会自动授予文件读写权限。
快捷唤出
在偏好设置 → 通用 → 快捷唤出中，按需启用全局快捷键或鼠标中键。默认键盘组合为：
点击快捷键框后按下新的组合键即可录制；Esc 取消。若提示快捷键被占用，请录制其他组合。
鼠标中键在松开后呼出菜单。Finder 在前台时，快捷菜单尝试读取其选中文件；其他应用在前台时，使用 Moustellix 当前的操作对象。请核对菜单顶部的对象再操作。
标准版提供 Finder 扩展、全局快捷键与中键菜单。“替换整个 Finder 右键菜单”属于独立本地增强版的功能，不包含在标准版中。
文件访问
标准版保留 App Sandbox。首次操作某些文件或目录时，系统选择器会请求你授权访问；在偏好设置 → 文件访问中可以添加或移除授权目录。
读取 Finder 选择、调用终端或执行 AppleScript 时，macOS 可能请求自动化权限。你可以在系统设置 → 隐私与安全性 → 自动化中管理这些权限。
云盘文件应先下载到本机，并为相应目录授权。若云盘视图未显示菜单，可使用工具箱或快捷菜单。完全磁盘访问不能替代标准版的目录授权。
备份与同步
在偏好设置 → 备份与同步中，可以导出或导入菜单、模板、收藏及脚本配置。导入配置不会自动授予文件访问权限，在另一台 Mac 上需要重新授权目录。
你可以选择自己的 iCloud Drive 或其他同步文件夹。应用将配置写入该目录，实际同步由你选择的云盘服务完成；应用不会改变云盘的系统设置。
配置文件可能包含目录路径、文件书签、脚本文本及导入的模板内容。请按需要选择保存位置；停止同步后，已经写入的云盘副本需要由你自行管理。
常见问题
右键菜单没有出现？
检查“启用菜单”和当前版本的 Finder 扩展是否均已开启。全局模式需要开启“全局 Finder 右键菜单”；仅授权目录模式需要检查目录列表。切换设置后重新打开 Finder 窗口再试，部分特殊视图可能受系统限制。
为什么出现两个 Moustellix 菜单？
通常是标准版和本地增强版的 Finder 扩展同时启用。请在系统设置中仅保留当前使用版本的 Finder 扩展。主应用退出后，Finder 扩展仍可由系统单独运行。
新建文件支持哪些格式？
内置模板包括纯文本、Markdown、JSON、Word、Excel、PowerPoint、RTF、HTML、CSS、JavaScript、TypeScript、Python、Shell、Swift、YAML、XML 和 CSV。Pages、Numbers、Keynote 或 WPS 等格式可导入你自己的有效文件作为模板。
加密归档是密码 ZIP 吗？
不是。加密归档使用 Moustellix 的 .mouvault 格式，通过 AES-256-GCM 加密 ZIP 内容；解密后得到普通 ZIP。当前加密归档最多处理 256 MiB 的 ZIP 数据。归档密码不会保存，遗失后无法恢复。普通 ZIP 压缩没有该上限。
如何安装或更新应用？
当前测试版本通过受邀请的 TestFlight 测试分发。收到邀请后，在 Mac 的 TestFlight 中接受并安装；新测试构建也通过 TestFlight 更新。官网暂未提供公开下载链接，获取方式可联系支持。
怎样报告问题？
请提供 macOS 版本、应用版本与构建号、重现步骤和错误提示。可附上已去除私人信息的截图。请勿发送密码、完整私钥或不必要的私人文件。
仍需帮助？请发邮件至 zhoukj2026@yeah.net。 联系支持