mPreview 使用支持

适用于商店版 1.0.0，要求 macOS 13.0 或更高版本。

开始浏览文件

1. 启动应用，按 Command+O 选择一个或多个文件，或将文件拖入主窗口。
2. 如需浏览文件夹，按 Shift+Command+O 明确选择该文件夹。
3. 使用左右方向键在本次选择的文件集合中切换。仅打开单个文件不会自动扫描父目录。

常用操作

• Command+,：打开设置，调整字号、行号、换行或唤起快捷键。
• Command+F：在支持查找的普通文本、Markdown 或 Office 内容中查找。
• PDF：点击缩略图跳页，或用 Page Up / Page Down 翻页；点击页码输入数字后按回车确认。
• JSON：点击节点展开或折叠；树形区域获得焦点后，↑↓选择、空格展开或折叠、Command+C 复制所选字段路径。
• 系统预览：在主窗口按回车，或选择“文件 → Quick Look 预览”。

大文本与超长行

超过普通文本处理阈值或单行过长的文件会进入按需读取模式。长行分段显示，续行标记不改变原文件。关闭自动换行后，可按内容溢出情况横向滚动；横向可滚动范围随已读取内容逐步扩展。

大文本模式暂不提供全文搜索和语法高亮。文件变化或读取失败时，请关闭后重新选择文件。

快捷键没有反应

应用必须已经运行，全局快捷键才会生效。进入设置选择其他组合；若注册冲突，界面会提示。快捷键用于打开或聚焦应用，不会获取 Finder 当前选中的文件。

Office 排版与原文件不一样

主窗口对 DOCX、XLSX、PPTX 提取结构化内容，并非完整 Office 编辑器。按回车打开系统预览面板查看系统支持的效果。部分旧格式只提供系统缩略图或原生预览。

Finder 中没有显示 mPreview 预览

在 macOS 系统设置的扩展管理中启用 mPreview 的 Quick Look 扩展。入口名称随系统版本变化。然后在 Finder 选中文件，按空格。

系统内置预览与同类扩展可能优先处理某些格式。Finder 没有选用 mPreview，不代表应用内预览失败；可以直接用主窗口打开文件。

不支持或无法打开文件

当前不支持 RAR。其他格式也可能因大小限制、损坏、加密或系统预览服务限制而无法显示。遇到权限提示，请通过系统文件选择对话框重新打开；不要为了预览随意更改文件权限。

问题反馈

mPreview 由个人开发者维护。当前测试用户可打开 TestFlight，选择 mPreview，使用“发送 Beta 反馈”入口提交问题；反馈功能及名称以当前 TestFlight 界面为准。

使用问题、意见反馈或隐私咨询，请发送邮件至 support@airtools.tools。

请准备以下信息，以便定位问题：

• 应用版本、macOS 版本和 Mac 芯片类型。
• 文件格式与大小，问题发生在主窗口还是 Finder 预览。
• 可重复的操作步骤，以及界面显示的错误信息。

如果通过 TestFlight 获得应用，可使用 TestFlight 的反馈入口。反馈或截图中请去除隐私、密码及商业机密，不需要提交原始敏感文件。