--- title: "Peeka 使用帮助｜Mac 快速查看设置与文件预览教程" description: "了解如何在 macOS 14 及更新版本中启用 Peeka 快速查看，管理格式与 Pro，在访达中预览应用包、Markdown、结构化文本、SQLite 和压缩包。" url: https://mellowbit.studio/zh-cn/peeka/support/ lang: zh-CN tokens: 3750 --- [返回 Peeka](https://mellowbit.studio/zh-cn/peeka/) # Peeka 使用帮助 启用快速查看、选择预览格式，在访达中浏览开发者文件。 Peeka 0.1.7 已通过 Mac App Store 审核。 [Peeka 更新说明](https://mellowbit.studio/zh-cn/peeka/release-notes/) Peeka 0.1.8（20261028.1）已通过 TestFlight 审核，状态于 2026 年 10 月 29 日确认。本页整理相较 TestFlight 0.1.6 的累计更新；Mac App Store 正式版仍为 0.1.7。 [Peeka Beta 更新说明](https://mellowbit.studio/zh-cn/peeka/beta-release-notes/) **从 Mac App Store 下载 Peeka。** 在 [Mac App Store](https://apps.apple.com/app/peeka-ultimate-quicklook-app/id6813012289) 获取应用。需要 macOS 14 Sonoma 或更新版本。 - [启用 Peeka 快速查看扩展](https://mellowbit.studio/zh-cn/peeka/support/#setup) - [在 Mac 上预览 APK 和 AAB 文件](https://mellowbit.studio/zh-cn/peeka/support/#apk-aab) - [在访达中预览 Markdown](https://mellowbit.studio/zh-cn/peeka/support/#markdown) - [预览结构化文本与配置](https://mellowbit.studio/zh-cn/peeka/support/#text) - [预览 SQLite 数据库](https://mellowbit.studio/zh-cn/peeka/support/#sqlite) - [浏览压缩包条目](https://mellowbit.studio/zh-cn/peeka/support/#archives) - [管理预览格式与 Peeka Pro](https://mellowbit.studio/zh-cn/peeka/support/#pro) - [快速查看预览未出现时如何排查](https://mellowbit.studio/zh-cn/peeka/support/#troubleshooting) ## 我可以预览什么？ Peeka 支持预览 Android 和 Apple 包、Markdown、结构化文本、SQLite 与压缩包。文件在本地处理，不上传，也无需 Peeka 账号。可用格式与详情取决于已安装版本及 Pro 权益。 ## 启用 Peeka 快速查看扩展 {#setup} 从 Mac App Store 安装并打开 Peeka。需要 macOS 14 Sonoma 或更新版本。 1. 在 Peeka 中打开「设置 → 通用 → 打开扩展设置」。macOS 15 或更新版本也可从「系统设置 → 通用 → 登录项与扩展」进入。 2. 在快速查看设置中启用 Peeka，再在主应用的格式目录中搜索并开启需要的预览。免费格式默认开启，Pro 格式需要 Peeka Pro。 3. 回到访达，选中支持的文件并按下空格键。再按一次空格键即可关闭预览。 ## 在 Mac 上预览 APK 和 AAB 文件 {#apk-aab} 分享构建或核对版本信息之前，可以直接在访达中查看 Android 安装包。Peeka 只预览包内信息，不会在 macOS 上安装或运行 Android 应用。 1. **在访达中选择安装包** 选中本地的 .apk 或 .aab 文件，例如 Android 项目导出的构建产物。请使用完整文件，而不是仍在下载中的文件。 2. **按下空格键** 启用 Peeka 扩展后，快速查看会显示安装包预览，无需另开应用。 3. **核对应用信息与 Pro 权益** APK 的名称、版本、SDK 要求与架构等基础信息免费。AAB、APKS、XAPK、APKM 和 AAR 预览需要 Pro，权限和签名摘要也需要 Pro。 IPA、.app 与 .appex 基础预览免费。Pro 增加 Xcode 归档、XCFramework, Framework, dSYM、动态库、描述文件和可用的签名身份。DMG 与扁平 PKG 显示元数据摘要。签名元数据不代表签名有效性验证。 DMG 与扁平 PKG 可在快速查看中逐步显示受支持应用的名称与图标，无需挂载或安装。 ## 在访达中预览 Markdown {#markdown} 免费阅读原生排版的 README 或项目笔记，支持标题、列表、代码块、表格、任务列表与删除线。 1. **选中 Markdown 文档** 在访达中选择本地 .md 文件，例如 README.md。如果文件存储在云端，请先确保它已下载到 Mac。 2. **打开快速查看预览** 按下空格键，阅读排版后的文档。预览不会编辑文件；需要修改时，请使用你平时的编辑器。 3. **阅读完成后关闭预览** 再按一次空格键回到访达，继续处理文件。 本地图片须位于文档目录内，且文件访问权限允许。预览不获取远程图片，也不执行 HTML 或脚本。数学公式与脚注不会渲染。Markdown 中的 Mermaid 源码高亮免费；图形模式需要 Pro 与 macOS 14.4+。不支持的语法或超出资源限制时，会回退到高亮源码并说明原因。标明 Peeka 认识的语言时，围栏代码块会使用轻量着色。 ## 预览结构化文本与配置 {#text} 受支持的开发者文本格式均免费。JSON 提供校验与格式化，JSONL 按行处理；其他格式显示源码或简洁摘要。 1. **选择支持的文件** 选中 JSON、JSONL、XML、YAML、TOML、SQL、diff/patch、proto、GraphQL、INI、properties、editorconfig、plist、CSV 或 TSV。 2. **按下空格阅读** 受支持的结构化源码使用轻量语法高亮。属性列表显示摘要，CSV 与 TSV 显示分隔文本摘要，而非电子表格。 3. **留意截断提示** 文本预览上限为 1 MB。需要查看完整文件或修改内容时，请使用编辑器。 dotenv 解析仅显示键名、隐藏值，但 .env 与 .env.\* 的访达分发受限。已支持的源码文件（包括 HTML、CSS 与 JavaScript）以只读源码预览。受支持的日志（包括 Android Logcat 与 Android Studio 布局）提供免费高亮原文预览。Pro 增加已识别内容的概要与结构化详情。TXT／TEXT 保留普通原文，不自动识别内容类型。 ## 预览 SQLite 数据库 {#sqlite} SQLite 概要与表结构免费。记录分页和 BLOB 预览需要 Pro，支持范围随版本变化。具体以你安装的版本支持的内容为准。 1. **选择本地 SQLite 文件** 使用完整数据库，例如 .sqlite、.sqlite3 或 .db。如有 WAL 与 SHM 旁路文件，请保留在同一目录；单独选择旁路文件不会打开数据库。 2. **打开快速查看** 查看数据库概要与可用的表结构。如果当前版本提供数据视图，可以选择表，并在结构与数据之间切换。 3. **查看 Pro 数据预览** 新界面每页最多显示 100 行，可查看选中 BLOB 的前 4 KiB。视图、虚拟表与影子表仅显示结构。 Peeka 以只读方式打开数据库，不编辑、修复或迁移。加密、损坏、锁定或权限不足的文件可能无法预览。文件名特殊或没有扩展名的文件，可能无法从访达打开。 ## 浏览压缩包条目 {#archives} ZIP、TAR、TAR.GZ/TGZ 与 JAR/WAR 基础列表免费；独立 gzip 显示原文件元数据。7z 列表与 Java 清单详情需要 Pro。 1. **在访达中选择压缩包** 选中支持的本地压缩包，按下空格键。 2. **浏览可用条目** 通过列表或分栏浏览已加载条目。大型压缩包按需读取元数据，支持索引、排序与取消；达到资源上限时会明确提示列表不完整。 3. **关闭预览** 按空格回到访达。Peeka 列出条目，不将其解压到磁盘；需要解压或打开包内文件时，请使用压缩包应用。 Pro 支持兼容的 LZMA／LZMA2 头和单 coder solid 7z 目录；加密头、过滤链或不支持的布局可能无法列出文件。旧编码文件名识别可能误判歧义名称，资源限制仍适用。 ## 管理预览格式与 Peeka Pro {#pro} 主应用提供引导、可搜索的格式目录、预览开关、设置与购买入口。预览在访达中打开。主应用没有独立的文件检查器、对比视图与导出功能。 1. **选择 Peeka 预览的格式** 按名称或扩展名搜索，使用格式开关控制预览。修改后关闭并重新打开访达预览；开关控制 Peeka 是否处理请求，不改变系统扩展优先级。 2. **打开「设置 → Peeka Pro」** 查看可选的一次性内购及所在地区的价格，或恢复购买。无订阅，也不按预览次数收费。 3. **预览新解锁的格式** 购买或恢复并新获得 Pro 后，全部 Pro 格式自动开启。之后手动关闭的格式保持关闭，之前关闭的免费格式也不会重新打开。 受支持的 Android 与 Apple 包内图标缩略图无需 Pro，也不受格式预览开关控制。访达仍可能显示缓存或系统图标。 ## 快速查看预览未出现时如何排查 {#troubleshooting} ### 访达只显示图标或源文本 确认 Peeka 的系统快速查看扩展与该格式的预览开关均已启用，已安装的版本支持该格式，需要 Pro 时已解锁。修改开关后请关闭并重新打开预览。 ### 某个文件预览失败，但其他文件正常 确认文件已完整下载，并且能在 Mac 上正常读取。尝试另一个同格式文件，帮助判断问题来自文件本身还是扩展。不要通过修改扩展名让不支持的文件看起来像受支持的格式。 ### 预览被其他扩展接管 macOS 会选择实际预览提供者。如果其他扩展接管了同一格式，可在系统设置中暂时停用后重新预览。CSV 可能使用系统预览；访达不一定把 dotenv 文件交给 Peeka。格式开关不改变系统优先级。 ### 应用无法安装或不再能打开 在 Mac App Store 中检查兼容性，以及是否有可用更新。问题持续存在时，请将下方所列信息发送给支持邮箱。 ## 有疑问或发现了问题？ 请在邮件中简要描述问题。反馈预览问题时，请提供： - 你的 macOS 版本，以及 Peeka 版本（如已安装）。 - 你尝试预览的文件类型。 - 你期望看到的内容，以及实际发生的情况。 - 导致问题的操作步骤，如有截图更好。 分享任何文件或截图前，请移除其中的个人信息、签名凭据和私密项目细节。 [邮件联系支持](mailto:support@mellowbit.studio?subject=Peeka%20%E6%94%AF%E6%8C%81&body=macOS%20%E7%89%88%E6%9C%AC%EF%BC%9A%0APeeka%20%E7%89%88%E6%9C%AC%EF%BC%88%E5%A6%82%E5%B7%B2%E5%AE%89%E8%A3%85%EF%BC%89%EF%BC%9A%0A%E6%96%87%E4%BB%B6%E7%B1%BB%E5%9E%8B%EF%BC%9A%0A%0A%E5%8F%91%E7%94%9F%E4%BA%86%E4%BB%80%E4%B9%88%EF%BC%9F%0A%0A%E4%BD%A0%E6%9C%9F%E6%9C%9B%E7%9A%84%E7%BB%93%E6%9E%9C%EF%BC%9F%0A%0A%E5%A4%8D%E7%8E%B0%E6%AD%A5%E9%AA%A4%EF%BC%9A%0A) [support@mellowbit.studio](mailto:support@mellowbit.studio) ## 更多关于 Peeka - [Peeka 使用文档](https://mellowbit.studio/zh-cn/peeka/docs/) - [Peeka 常见问题](https://mellowbit.studio/zh-cn/peeka/#faq) - [更新说明](https://mellowbit.studio/zh-cn/peeka/release-notes/) - [Peeka 隐私政策](https://mellowbit.studio/zh-cn/peeka/privacy/) - [了解 Mellowbit Studio](https://mellowbit.studio/zh-cn/about/)