MaoQiu Transfer

第一版目标：同一 WiFi / 同一局域网内，不经过服务器，客户端之间点对点互传文件。

核心设计：

• UDP 9526：每 2 秒广播设备信息，超过 8 秒未出现则从附近设备列表移除。
• TCP 9527：发送传输请求、等待接收方确认、流式传输文件数据。
• 文件接收：先写入 .part 临时文件，SHA-256 校验成功后再改为正式文件名。
• 保存目录：默认 Downloads/MaoQiuTransfer，支持在设置页修改。
• 手动 IP：发现失败时可以输入对方 IP 和端口继续发送。
• 一键快传：发送端生成邀请二维码；扫码手机端开启临时热点，发送端自动连接手机热点后发起传输。
• 检查更新：启动后自动查询 GitHub Releases，并按当前平台下载 .apk / .exe / .pkg / .dmg。
• macOS：Release 同时产出 .pkg 安装包和 .dmg；客户端优先下载 .pkg。

当前仓库状态

这个目录已经包含 Flutter 源码、服务层和 UI。由于本机当前没有安装 flutter / dart 命令，平台目录需要在安装 Flutter 后生成：

flutter create . --platforms=android
./tool/patch_android_platform.sh
flutter pub get
flutter run -d android

Android 端生成平台目录后，需要确认 android/app/src/main/AndroidManifest.xml 至少包含：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-feature android:name="android.hardware.camera" android:required="false" />

仓库里的 tool/patch_android_platform.sh 会在生成 Android 平台目录后自动补齐这些权限、APK 应用名、UDP 发现所需的 MulticastLock 和 LocalOnlyHotspot 原生通道。GitHub Actions 在线打包也会执行这个脚本。

连接模式

同一 WiFi 自动发现

两台设备都打开客户端后，通过 UDP 广播自动出现在首页“附近设备”列表中。点击设备后选择文件发送。 Android 端会在应用运行期间获取 Wi-Fi 组播锁，避免系统过滤同网 UDP 发现包。发现到设备时优先使用 UDP 包的来源 IP，避免 VPN 或虚拟网卡自报 IP 导致连接失败。