# 常见问题 (FAQ)

## 通用问题

### Q: SwiftMTP 是什么？

A: SwiftMTP 是一个现代化的 macOS Android MTP 文件传输工具，采用 SwiftUI 构建，支持多语言本地化。

### Q: SwiftMTP 支持哪些操作系统？

A: SwiftMTP 支持 macOS 26.0 及更高版本。

### Q: SwiftMTP 是免费的吗？

A: 是的，SwiftMTP 采用 MIT 许可证，完全免费开源。

### Q: 如何获取 SwiftMTP？

A: 你可以从 [GitHub Releases](https://github.com/wang93wei/SwiftMTP/releases) 下载最新版本，或者从源代码构建。

## 安装问题

### Q: 如何安装 SwiftMTP？

A: 下载 DMG 文件，拖拽到应用程序文件夹即可。详细步骤请参考 [安装指南](Installation.md)。

### Q: 安装时提示"无法验证开发者"怎么办？

A: 在系统设置中允许运行未签名的应用：
1. 打开"系统设置" → "隐私与安全性"
2. 找到"SwiftMTP"被阻止的消息
3. 点击"仍要打开"
4. 输入管理员密码

### Q: 需要禁用沙盒吗？

A: 是的，SwiftMTP 需要禁用沙盒才能访问 USB 设备。在应用设置中，确保"App Sandbox"已禁用。

## 设备连接问题

### Q: 为什么我的设备无法被检测到？

A: 请检查以下几点：
1. 确保设备已通过 USB 连接到 Mac
2. 确保设备已启用 MTP 模式
3. 尝试更换 USB 线缆或 USB 端口
4. 重启设备和应用
5. 检查 USB 权限设置

### Q: 如何启用 MTP 模式？

A: 在 Android 设备上：
1. 连接设备到 Mac
2. 下拉通知栏
3. 点击"正在通过 USB 充电"
4. 选择"文件传输"或"MTP"

### Q: 设备连接后立即断开怎么办？

A: 可能的原因：
1. USB 线缆质量不好，更换线缆
2. USB 端口供电不足，更换端口
3. 设备进入休眠模式，保持设备唤醒
4. USB 驱动问题，更新系统或驱动

### Q: 支持多设备连接吗？

A: 目前 SwiftMTP 仅支持单设备连接。多设备支持计划在未来的版本中实现。

## 文件传输问题

### Q: 为什么文件上传/下载失败？

A: 请检查：
1. 确保设备有足够的存储空间
2. 确保文件路径有效且可访问
3. 检查文件名是否包含特殊字符
4. 尝试重新连接设备
5. 查看错误消息了解具体原因

### Q: 支持哪些文件类型？

A: SwiftMTP 支持所有文件类型，包括图片、视频、音频、文档等。

### Q: 文件传输速度慢怎么办？

A: 可能的原因：
1. USB 2.0 接口，升级到 USB 3.0
2. 文件过大，分批传输
3. USB 线缆质量不好，更换线缆
4. 其他应用占用带宽，关闭其他应用

### Q: 可以传输文件夹吗？

A: 目前 SwiftMTP 仅支持单个文件传输。文件夹传输计划在未来的版本中实现。

### Q: 为什么传输进度不准确？

A: 传输进度可能不准确，这是由于 MTP 协议的限制。未来版本会改进进度显示。

## 性能问题

### Q: 应用占用内存过高怎么办？

A: SwiftMTP 使用缓存提高性能，如果内存占用过高：
1. 清空文件缓存（在设置中）
2. 关闭应用后重新打开
3. 重启 Mac

### Q: 设备扫描速度慢怎么办？

A: 设备扫描速度取决于：
1. USB 接口速度
2. 设备响应速度
3. 连接的设备数量
4. 系统负载

如果扫描速度慢，可以调整扫描间隔（在设置中）。

### Q: 文件列表加载慢怎么办？

A: 文件列表加载慢可能是因为：
1. 目录中文件数量过多
2. 设备存储速度慢
3. 缓存未命中

可以尝试清空缓存或增加缓存大小。

## 本地化问题

### Q: 如何切换语言？

A: 在设置中选择语言，应用会立即切换语言，无需重启。

### Q: 支持哪些语言？

A: SwiftMTP 支持以下语言：
- 英语
- 中文（简体）
- 日语
- 韩语
- 俄语
- 法语
- 德语

### Q: 如何添加新语言？

A: 欢迎贡献翻译！请参考 [贡献指南](Contributing.md) 了解详情。

### Q: 翻译不准确怎么办？

A: 欢迎提交 PR 改进翻译，或在 GitHub 上提交 Issue。

## 安全问题

### Q: SwiftMTP 安全吗？

A: SwiftMTP 采用了多种安全措施：
- 路径安全验证
- 输入验证
- 文件大小限制
- 符号链接检测
- 代码签名和公证

### Q: 会上传我的文件到云端吗？

A: 不会。SwiftMTP 是本地应用，所有文件传输都在本地进行，不会上传到任何云端。

### Q: 会收集我的数据吗？

A: SwiftMTP 不收集任何用户数据。所有操作都在本地进行。

### Q: 为什么需要 USB 权限？

A: SwiftMTP 需要 USB 权限才能与 MTP 设备通信。这是正常的安全要求。

## 开发问题

### Q: 如何从源代码构建？

A: 请参考 [开发环境搭建](Development-Setup.md) 了解详细步骤。

### Q: 开发需要什么工具？

A: 需要：
- Xcode 16.0+
- Go 1.25.5+
- Homebrew

### Q: 如何贡献代码？

A: 欢迎贡献！请参考 [贡献指南](Contributing.md) 了解详情。

### Q: 如何报告问题？

A: 请在 [GitHub Issues](https://github.com/wang93wei/SwiftMTP/issues) 上提交 Issue，并提供详细的错误信息和复现步骤。

### Q: 如何请求新功能？

A: 请在 [GitHub Issues](https://github.com/wang93wei/SwiftMTP/issues) 上提交 Feature Request。

## 故障排除

### Q: 应用崩溃了怎么办？

A: 请尝试：
1. 重启应用
2. 重启 Mac
3. 检查系统日志
4. 提交 Issue 并附上崩溃日志

### Q: 如何查看崩溃日志？

A: 崩溃日志位于：
`~/Library/Logs/DiagnosticReports/SwiftMTP-*.crash`

### Q: 如何重置应用设置？

A: 删除以下文件夹：
`~/Library/Containers/SwiftMTP`

### Q: 如何卸载 SwiftMTP？

A: 将应用拖到废纸篓，然后清空废纸篓即可。

## 其他问题

### Q: SwiftMTP 与 Android File Transfer 有什么区别？

A: SwiftMTP 的优势：
- 更现代的 UI 设计
- 更好的性能
- 多语言支持
- 开源免费
- 持续更新

### Q: 可以在虚拟机中使用吗？

A: 可以，但需要确保虚拟机支持 USB 直通（USB Passthrough）。

### Q: 支持 Windows 或 Linux 吗？

A: 目前 SwiftMTP 仅支持 macOS。Windows 和 Linux 版本计划在未来的版本中实现。

### Q: 有移动版本吗？

A: 目前没有移动版本。iOS 版本计划在未来的版本中实现。

### Q: 如何获取支持？

A: 你可以通过以下方式获取支持：
- 提交 [GitHub Issue](https://github.com/wang93wei/SwiftMTP/issues)
- 查看 [故障排除](Troubleshooting.md)
- 查看 [文档](Home.md)

### Q: 如何捐赠？

A: 感谢你的支持！目前我们不接受捐赠，但欢迎通过代码贡献、翻译、测试等方式支持项目。

### Q: 有商业版本吗？

A: 没有。SwiftMTP 是完全免费开源的，没有商业版本。

### Q: 可以用于商业用途吗？

A: 可以。SwiftMTP 采用 MIT 许可证，可以自由用于商业用途。

## 获取更多帮助

如果以上问题没有解决你的问题，请：

1. 查看 [故障排除](Troubleshooting.md)
2. 查看 [文档](Home.md)
3. 提交 [GitHub Issue](https://github.com/wang93wei/SwiftMTP/issues)
4. 加入社区讨论（如果有）

## 更新日志

查看 [GitHub Releases](https://github.com/wang93wei/SwiftMTP/releases) 了解最新更新。