# Remote

**Repository Path**: iOSDevLog/remote

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iOS Remote Desktop

完整的远程桌面解决方案，包含 PC Server (Python) 和 iOS Client (Swift)。

## 🎉 项目状态

**核心功能**: ✅ 100% 完成
- **PC Server**: 任务 1-9 ✅ 完成
- **iOS Client**: 任务 10-22 ✅ 完成
- **测试覆盖**: ✅ 所有必需的属性测试已完成

详细状态请查看：
- [项目完成状态](ios-client/PROJECT_COMPLETION_STATUS.md)
- [下一步工作指南](NEXT_STEPS.md)

## 功能特性

### PC Server
- ✅ 实时屏幕捕获和传输（15-60 FPS）
- ✅ 鼠标和键盘输入模拟
- ✅ 安全的 TLS 加密连接
- ✅ 身份验证和防暴力破解
- ✅ 自适应带宽调整
- ✅ 跨平台支持（Windows、macOS、Linux）

### iOS Client
- ✅ 全屏远程桌面显示
- ✅ 丰富的手势支持（点击、双击、拖动、缩放、滚动）
- ✅ 虚拟键盘和快捷键
- ✅ 实时性能监控（FPS、延迟、带宽）
- ✅ 灵活的设置调整（质量、帧率、分辨率）
- ✅ 快捷操作菜单
- ✅ 现代 SwiftUI 界面

## 快速开始

### 1. 安装 PC Server

```bash
# 安装依赖
pip install -r requirements.txt

# 创建用户
python create_user.py

# 启动服务器
python src/server/main.py
```

### 2. 设置 iOS Client

详细设置指南请查看 [ios-client/SETUP.md](ios-client/SETUP.md)

```bash
# 在 Xcode 中打开项目
cd ios-client
open Package.swift  # 或打开你的 Xcode 项目

# 添加 SwiftCheck 依赖
# File → Add Packages → https://github.com/typelift/SwiftCheck

# 配置 Info.plist 权限（在 Xcode 项目设置中）
# - NSLocalNetworkUsageDescription
# - NSBonjourServices
# - NSAppTransportSecurity

# 运行应用
# 选择目标设备，点击 Run (⌘R)
```

### 3. 连接

1. 确保 PC Server 正在运行
2. 在 iOS 应用中输入 PC 的 IP 地址和端口（默认 8765）
3. 输入用户名和密码
4. 点击连接

## 配置

### PC Server 配置

编辑 `config.json` 文件：

```json
{
  "server": {
    "host": "0.0.0.0",
    "port": 8765,
    "use_tls": false
  },
  "screen": {
    "fps": 30,
    "quality": 80
  },
  "security": {
    "max_failed_attempts": 3,
    "block_duration": 300
  }
}
```

### iOS Client 配置

在应用内的设置界面中调整：
- 图像质量（0-100）
- 帧率（15-60 FPS）
- 分辨率（多种预设）

## 测试

### PC Server 测试

```bash
# 运行所有测试
pytest

# 运行特定测试
pytest tests/test_auth.py -v

# 查看覆盖率
pytest --cov=src
```

### iOS Client 测试

```bash
# 在 Xcode 中运行测试
⌘U

# 或使用命令行
xcodebuild test -scheme RemoteDesktop -destination 'platform=iOS Simulator,name=iPhone 14'
```

## 项目结构

```
.
├── src/
│   ├── server/          # 服务器组件
│   │   ├── screen_capturer.py
│   │   ├── video_encoder.py
│   │   ├── input_simulator.py
│   │   ├── server_connection.py
│   │   └── main.py
│   └── common/          # 共享模型和工具
│       └── models.py
├── tests/               # 测试文件
├── config.json          # 配置文件
└── requirements.txt     # Python 依赖
```

## 安全注意事项

- 默认使用 TLS 加密
- 需要生成 SSL 证书（或使用自签名证书）
- 建议在局域网内使用或通过 VPN 访问
- 支持用户名/密码认证
- 自动阻止暴力破解尝试

## 故障排除

遇到问题？查看 [TROUBLESHOOTING.md](TROUBLESHOOTING.md) 获取详细的故障排除指南。

常见问题：
- ModuleNotFoundError → 使用 `./run_server.sh` 启动
- 权限错误 → 授予屏幕录制和辅助功能权限 (macOS)
- 端口占用 → 修改 config.json 中的端口号
- 依赖安装失败 → 逐个安装或使用镜像源

## 文档

- [QUICKSTART.md](QUICKSTART.md) - 5 分钟快速入门
- [PROJECT_STATUS.md](PROJECT_STATUS.md) - 详细实施状态
- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - 故障排除指南
- [SETUP_COMPLETE.md](SETUP_COMPLETE.md) - 设置完成确认

## 许可证

MIT License