ZenConverter 是一个完全在本地运行的 Android 文件转换工具，所有转换都在手机上完成，文件不会上传到任何服务器。它的部署方式非常简单，因为它就是一个 APK 应用，不需要服务器，也不需要 Docker。

📥 方式一：直接安装 APK（推荐，最简单）

这是绝大多数用户的首选，从官方渠道下载安装即可。

渠道一：Google Play（最省心）
直接在 Google Play 搜索 “ZenConverter”，或访问应用页面下载。通过 Play 安装的好处是后续更新由商店自动管理。

渠道二：GitHub Releases（适合无法访问 Google Play 的用户）
前往 GitHub Releases 页面 下载最新的 APK 文件。下载后需要在手机上开启“允许安装未知来源应用”，然后点击安装。

注意：GitHub 版本的 APK 会申请 INTERNET 权限，但官方明确说明这个权限仅用于手动检查应用更新和按需下载 AI 模型/字体，文件转换过程本身不联网。Google Play 版本连联网权限都没有申请。

🛠️ 方式二：从源码编译（适合开发者）

如果你想自己编译，或者想参与贡献，可以按以下步骤操作。需要准备 Android SDK 和 Gradle 环境。

1
2
3
4
5
git clone https://github.com/Jasonzhu1207/ZenConverter.git
cd ZenConverter

# 使用 Gradle 编译 release 版本
./gradlew assembleRelease

编译产物会输出在 app/build/outputs/apk/release/ 目录下。首次编译可能需要下载依赖，耐心等待即可。

📱 首次使用与核心功能速览

首次启动
打开应用后，会请求存储权限（Android 13+ 使用 Photo Picker），授权后即可开始使用。如果要用 AI 超分辨率功能，首次使用时应用会按需下载模型文件（几百 MB），需要保持网络连接。

基本操作流程
点击界面上的 “+” 按钮导入文件，选择目标格式和参数，然后点击“开始”即可。转换任务会通过前台服务运行，所以即使切换应用或关屏也不会中断（但建议大文件转换时保持手机唤醒、留够存储空间和电量）。

核心能力一览

类型 支持的转换与功能
视频 MP4/MKV/MOV/GIF 互转；视频合并、压缩、裁剪、倒放、镜像等；提取音频为 MP3/M4A/WAV/FLAC/WMA
图片 JPG/PNG/WEBP/HEIC/ICO 互转；AI 超分辨率（Real-ESRGAN 4× 放大，支持动漫/通用/高质量模型）
PDF 图片↔PDF、PDF 合并、压缩、加密/解密、文本提取
字体 TTF/OTF/WOFF/WOFF2 互转
字幕 SRT/VTT/LRC/ASS 互转
Office DOCX/PPTX/XLSX → PDF/TXT/MD（Beta，单文件限 64MB，版式保真度有限）

⚠️ 几个需要留意的地方

  • AI 超分对硬件有要求：Real-ESRGAN 模型需要 GPU 加速，中端以上芯片体验较好，极低端手机可能跑得很慢甚至失败。
  • 大文件需要预留空间：长视频转换的输出文件可能比源文件更大，转换前确认手机剩余空间充足。
  • Office 转换是 Beta：DOCX/PPTX/XLSX 转 PDF 的版式还原度有限，复杂排版的文档效果可能不理想。
  • AGPL-3.0 协议：如果你修改源码并提供网络服务，需要按 AGPL 条款开源你的修改。个人使用和私有部署没有这个义务。

ZenConverter 的部署本质上就是装一个 App，没有后端依赖，也不涉及服务器配置。如果你在安装或使用某个具体功能时遇到问题，可以再告诉我具体情况。