Peeka 使用帮助

启用 Peeka 快速查看扩展

从 Mac App Store 安装并打开 Peeka。需要 macOS 14 Sonoma 或更新版本。

1. 在 Peeka 中打开「设置 → 通用 → 打开扩展设置」。macOS 15 或更新版本也可从「系统设置 → 通用 → 登录项与扩展」进入。
2. 在快速查看设置中启用 Peeka，再在主应用的格式目录中搜索并开启需要的预览。免费格式默认开启，Pro 格式需要 Peeka Pro。
3. 回到访达，选中支持的文件并按下空格键。再按一次空格键即可关闭预览。

在 Mac 上预览 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

免费阅读原生排版的 README 或项目笔记，支持标题、列表、代码块、表格、任务列表与删除线。

1. 选中 Markdown 文档

   在访达中选择本地 .md 文件，例如 README.md。如果文件存储在云端，请先确保它已下载到 Mac。

2. 打开快速查看预览

   按下空格键，阅读排版后的文档。预览不会编辑文件；需要修改时，请使用你平时的编辑器。

3. 阅读完成后关闭预览

   再按一次空格键回到访达，继续处理文件。

本地图片须位于文档目录内，且文件访问权限允许。预览不获取远程图片，也不执行 HTML 或脚本。数学公式与脚注不会渲染。Markdown 中的 Mermaid 源码高亮免费；图形模式需要 Pro 与 macOS 14.4+。不支持的语法或超出资源限制时，会回退到高亮源码并说明原因。标明 Peeka 认识的语言时，围栏代码块会使用轻量着色。

预览结构化文本与配置

受支持的开发者文本格式均免费。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 概要与表结构免费。记录分页和 BLOB 预览需要 Pro，支持范围随版本变化。具体以你安装的版本支持的内容为准。

1. 选择本地 SQLite 文件

   使用完整数据库，例如 .sqlite、.sqlite3 或 .db。如有 WAL 与 SHM 旁路文件，请保留在同一目录；单独选择旁路文件不会打开数据库。

2. 打开快速查看

   查看数据库概要与可用的表结构。如果当前版本提供数据视图，可以选择表，并在结构与数据之间切换。

3. 查看 Pro 数据预览

   新界面每页最多显示 100 行，可查看选中 BLOB 的前 4 KiB。视图、虚拟表与影子表仅显示结构。

Peeka 以只读方式打开数据库，不编辑、修复或迁移。加密、损坏、锁定或权限不足的文件可能无法预览。文件名特殊或没有扩展名的文件，可能无法从访达打开。

浏览压缩包条目

ZIP、TAR、TAR.GZ/TGZ 与 JAR/WAR 基础列表免费；独立 gzip 显示原文件元数据。7z 列表与 Java 清单详情需要 Pro。

1. 在访达中选择压缩包

   选中支持的本地压缩包，按下空格键。

2. 浏览可用条目

   通过列表或分栏浏览已加载条目。大型压缩包按需读取元数据，支持索引、排序与取消；达到资源上限时会明确提示列表不完整。

3. 关闭预览

   按空格回到访达。Peeka 列出条目，不将其解压到磁盘；需要解压或打开包内文件时，请使用压缩包应用。

Pro 支持兼容的 LZMA／LZMA2 头和单 coder solid 7z 目录；加密头、过滤链或不支持的布局可能无法列出文件。旧编码文件名识别可能误判歧义名称，资源限制仍适用。

管理预览格式与 Peeka Pro

主应用提供引导、可搜索的格式目录、预览开关、设置与购买入口。预览在访达中打开。主应用没有独立的文件检查器、对比视图与导出功能。

1. 选择 Peeka 预览的格式

   按名称或扩展名搜索，使用格式开关控制预览。修改后关闭并重新打开访达预览；开关控制 Peeka 是否处理请求，不改变系统扩展优先级。

2. 打开「设置 → Peeka Pro」

   查看可选的一次性内购及所在地区的价格，或恢复购买。无订阅，也不按预览次数收费。

3. 预览新解锁的格式

   购买或恢复并新获得 Pro 后，全部 Pro 格式自动开启。之后手动关闭的格式保持关闭，之前关闭的免费格式也不会重新打开。

受支持的 Android 与 Apple 包内图标缩略图无需 Pro，也不受格式预览开关控制。访达仍可能显示缓存或系统图标。

快速查看预览未出现时如何排查