# FilleManager

**Repository Path**: iOSDevLog/fille-manager

## Basic Information

- **Project Name**: FilleManager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iPhone 文件管理器 (FilleManager)

类似爱思助手的 iPhone 文件管理工具，用于在 macOS 上浏览和管理连接的 iPhone 文件。

## 功能特性

- ✅ 自动检测连接的 iPhone 设备
- ✅ 浏览 iPhone 文件系统
- ✅ 查看文件详细信息（大小、修改时间等）
- ✅ 下载文件到 Mac
- ✅ 上传文件到 iPhone
- ✅ 删除文件
- ✅ 支持多种文件类型图标显示
- ✅ 路径导航和历史记录

## 系统要求

- macOS 12.0 或更高版本
- Xcode 14.0 或更高版本
- 已安装 Homebrew

## 安装依赖

在使用本应用前，需要安装 libimobiledevice 工具：

```bash
# 安装 libimobiledevice（用于与 iPhone 通信）
brew install libimobiledevice

# 安装 ifuse（用于挂载 iPhone 文件系统）
brew install ifuse

# 验证安装
idevice_id -l
```

## 首次使用

1. 用数据线连接 iPhone 到 Mac
2. 在 iPhone 上点击"信任此电脑"
3. 启动本应用
4. 应用会自动检测连接的设备
5. 选择设备后即可浏览文件

## 项目结构

```
FilleManager/
├── Models/
│   └── iPhoneDevice.swift          # 设备和文件数据模型
├── Services/
│   └── iPhoneDeviceManager.swift   # 设备管理和文件操作
├── Views/
│   ├── DeviceListView.swift        # 设备列表视图
│   └── FileListView.swift          # 文件浏览视图
├── ContentView.swift               # 主视图
└── FilleManagerApp.swift           # 应用入口
```

## 使用说明

### 浏览文件
- 双击文件夹打开
- 单击选择文件
- 使用工具栏按钮导航（返回、前进、上一级）

### 下载文件
1. 选择要下载的文件
2. 点击工具栏的"下载"按钮
3. 选择保存位置

### 上传文件
1. 点击工具栏的"上传"按钮
2. 选择要上传的文件
3. 文件将上传到当前目录

### 删除文件
1. 选择要删除的文件
2. 点击工具栏的"删除"按钮或右键菜单
3. 确认删除操作

## 技术实现

- **Swift + SwiftUI**：原生 macOS 应用
- **libimobiledevice**：与 iOS 设备通信
- **AFC 协议**：Apple File Conduit，访问 iOS 文件系统
- **ifuse**：FUSE 文件系统，挂载 iOS 设备

## 常见问题

### Q: 检测不到设备？
A: 
1. 确保已安装 libimobiledevice：`brew install libimobiledevice`
2. 检查 iPhone 是否已信任此电脑
3. 尝试重新插拔数据线
4. 运行 `idevice_id -l` 查看是否能检测到 UDID

### Q: 无法访问某些文件夹？
A: 
iOS 的沙盒机制限制了对某些系统文件的访问。本应用主要访问：
- DCIM（相机照片）
- Downloads（下载文件）
- Books（电子书）
- 应用的文档目录

### Q: 下载速度慢？
A: 
- 使用原装或 MFi 认证的数据线
- 避免使用 USB 集线器
- 关闭 iPhone 的低电量模式

## 开发计划

- [ ] 文件预览功能
- [ ] 批量下载/上传
- [ ] 文件搜索
- [ ] 应用数据访问
- [ ] 照片备份
- [ ] 文件重命名
- [ ] 创建文件夹
- [ ] 进度显示优化

## 许可证

本项目仅供学习和个人使用。

## 致谢

灵感来源于爱思助手，使用了以下开源工具：
- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)
- [ifuse](https://github.com/libimobiledevice/ifuse)