相机到手机的导入助手
USB 有线导入 · FTP 无线接收 · 浏览选择 · 队列传输 · 历史回看
GitHub · 核心亮点 · 功能全景 · 快速开始 · 常见问题
首页大概长这样：一屏完成 USB 连接、FTP 接收、已传输照片入口，以及连接提示。 设置、权限和关于页都从顶部入口进入，尽量不打断导入主流程。
💚 PixGo 开源可自建，欢迎放心使用。
项目基于 Apache License 2.0 开源。请优先从 GitHub Releases 下载官方 APK。
若遇到不明渠道收费安装包，请勿付款，并优先回到官方仓库核对。
PixGo 把连接、浏览、接收、传输和记录管理收进同一条工作流，让相机素材尽快落到手机。
- 🔌 双通道导入 — USB 有线浏览导入，FTP 无线接收推送，按场景选
- 🗂️ 本地优先 — 文件保存到设置目录；自动同步到系统相册是可选项，互不替代
- ⚡ 可恢复传输 — 批量队列、断点续传、增量跳过已导入文件
- 🖼️ 可回看 — 网格历史、详情预览、评分/信息等轻量整理
按日常使用顺序浏览即可。每个模块先看能力说明，再对照截图。
- 一屏入口 — USB 连接、FTP 接收、已传输照片
- 连接提示 — 数据线授权与 FTP 同网配置说明
- 权限引导 — 媒体访问、通知、USB 访问按需授权
- 三步导入 — 连相机 → 选文件 → 开始导入
- 设备兼容 — MTP / Mass Storage；Sony / Canon / Nikon / DJI 等常见机型
- 网格选择 — 多选照片、RAW、视频后批量下载
- 实时进度 — 速度、队列、暂停/返回
连接相机后，在手机中选择文件并导入；文件保存到设置目录，也可同步到系统相册。
在文件浏览器里勾选要导入的素材，支持批量选择后一键下载。
队列调度当前批次，显示当前文件、速度和可用空间。
- 手机开接收端 — 显示 IP、端口、用户名和密码
- 相机主动推送 — 同网配置后把照片发到手机
- 接收记录 — 运行中可看已接收数量与今日列表
让相机和手机连接同一网络，再把 PixGo 显示的参数填入相机。
以页面当前显示的参数为准配置相机；密码由 Android Keystore 保护。
仅建议在可信局域网使用。
- 时间线 / 网格 — 按天回看已导入照片
- 详情预览 — 旋转、评分、信息、删除等轻量操作
- 本地路径 — 历史记录指向真实保存文件
- 连接方式 — 首页是否显示 USB / FTP 入口
- 传输行为 — 自动连接、增量导入、同步到相册、保存目录
- 预览与设备 — 屏幕常亮等运行行为
- 关于 — 版本信息与项目说明
保存目录是主落点；「自动同步到相册」只负责发布到系统相册，二者独立。
当前版本以 app/build.gradle.kts 中的 versionName 为准（现为 1.0.1）。
完整技术变更见 CHANGELOG.md。此处只保留对外可感知的要点。
- 修复关闭「同步到相册」后 FTP 文件落在私有目录、用户找不到的问题
- 修复传输历史「清空」后被保存目录扫描自动复活的问题
- 修复从历史页连点返回首页可能白屏的问题
- 修复 FTP 已完成照片因路径归一化在传输历史中不可见的问题
- 本地 / 历史大图查看页增加「分享」
- 首个正式版本：USB 导入、FTP 接收、传输历史、设置与安全基线
- Sony / DJI 路径性能与缩略图优化；备份与完整性加固
| 项目 | 要求 |
|---|---|
| 系统 | Android 10+（API 29），推荐 13+ |
| 设备 | 支持 USB OTG 的手机 / 平板 |
| 空间 | 建议 ≥100MB 可用 |
| 网络 | 仅 FTP 接收需要；USB 导入可不联网 |
- 下载 GitHub Releases 中的最新
PixGo-vX.X.X.apk（可选对照checksums.txt） - 安装 允许未知来源后安装
- 授权 按引导完成媒体访问、通知等必要权限
（可对照上方 首页与引导） - 开始导入
- 用数据线 / OTG 连接相机；相机设为 PC Remote / MTP / PTP（勿用仅充电）
- 手机弹出 USB 授权时点允许
- 在 PixGo 中打开相机浏览 → 选择文件 → 传输
- 打开应用内 FTP 接收 页并启动
- 以页面当前显示的 IP、端口、用户名、密码为准 配置相机
（密码由 Android Keystore 保护；勿使用旧文档中的固定弱凭据） - 相机与手机同网后推送照片
文件最终保存在哪里？和「自动同步到相册」有什么区别？
A： 传输完成后，文件始终保存到设置里的 保存目录。
「自动同步到相册」是可选附加动作：开启后会再发布到系统相册（MediaStore / DCIM 等路径）。
两者独立——关闭相册同步，文件仍应在保存目录中，并在传输历史可见。
FTP 密码是什么？旧文档里的固定密码还能用吗？
A： 以应用内 FTP 接收页当前显示的凭据为准。自定义密码经 Android Keystore 保护保存。
不要使用旧文档或第三方转载里的固定弱密码。
USB 连上了但扫不到相机？
A： 确认：
- 手机支持 OTG，并已授权 USB 访问
- 相机 USB 模式不是「仅充电」
- 数据线能传数据（部分充电线不行）
- 在 PixGo 首页点 USB 连接后重新扫描
FTP 推送失败怎么办？
A： 先确认相机和手机在同一局域网或同一热点。
再核对页面显示的 IP / 端口 / 用户名 / 密码是否与相机设置完全一致。
仅建议在可信局域网使用。
传输历史里看不到照片？
A： 历史页读取的是已完成任务对应的本地文件。
请先确认设置中的保存目录可写，并在传输完成后再打开历史。
若刚改过保存目录，新传输会落到新目录；旧记录仍指向旧路径。
支持哪些相机？
A： USB 侧覆盖常见 MTP / Mass Storage 设备（Sony / Canon / Nikon / DJI 等）。
FTP 侧取决于相机是否支持向手机 FTP 服务器推送。具体机型以真机验证为准。
Clean Architecture + MVVM · Jetpack Compose · Hilt · Coroutines · Room
| 类别 | 技术 | 版本 |
|---|---|---|
| 语言 | Kotlin | 2.1.20 |
| UI | Compose BOM | 2025.05.01 |
| DI | Hilt | 2.55 |
| DB | Room | 2.7.0 |
| USB | libaums | 0.10.0 |
| FTP | Apache FTP Server | 1.2.0 |
| SDK | compile/target 36 · min 29 |
依赖目录：gradle/libs.versions.toml
版本号唯一真相：app/build.gradle.kts
- FTP 参数以应用内显示为准；自定义密码经 Keystore 保存
- 漏洞请通过 Security Advisories 私密报告，勿公开 Issue
公益与开发支持：l0veyou、Joverna、君の公益、Any Router、辛佬/Nexus Studio、DC 社区、Sharedchat
开源：libaums、Apache FTP Server、Jetpack Compose；主题参考 komi-store
- Issues / Discussions: github.com/guliacer/PixGo
- Email: guliacer556@gmail.com
- WeChat: 1504481883（紧急）
最后更新: 2026-08-10