一、前言为什么要“自研一款局域网互传工具日常办公/生活中PC与手机互传文件痛点非常多手机厂商的互传软件常常需要同品牌的笔记本电脑用魔改版效率非常慢光识别手机都得费个几分钟。用微信又很麻烦既要上传又要下载而且软件本身很臃肿。第三方互传软件大多捆绑广告、强制登录账号、后台偷跑流量。为此分享一款完全开源、轻量化、去中心化的局域网传输项目——妙享传输 Miaoxiang。项目地址项目地址核心定位同一WiFi下或者直连PC与安卓无需登录、无需公网、无需数据线自动发现设备支持多文件/文件夹传输、剪贴板文字互传后台常驻低资源占用。pc安卓端二、项目核心功能一览1. 设备层零配置自动发现UDP广播19876端口扫描局域网设备自动展示在线PC/安卓无需手动填写IP。自定义设备名称区分多台设备界面不展示IP更直观。安卓前台服务Wifi锁/组播锁避免锁屏后设备消失。2. 文件传输核心能力拖拽批量发送文件/文件夹大文件流畅传输实时进度展示。双向可控任意一端随时取消传输对端立即终止。10秒超时保护无人确认、网络断连自动终止传输避免卡死。同名文件自动追加(1)/(2)后缀永不覆盖本地文件。PC托盘后台常驻安卓后台通知栏接收文件切后台不中断任务。### 3. 剪贴板跨端同步高频刚需PC右键一键发送电脑剪贴板文字到手机。安卓长按发送按钮推送手机复制文本至电脑。接收文字弹窗预览一键复制到本机剪贴板。4. 易用性设计- Windows一键安装包、安卓独立APK开箱即用。分卷下载包30MB/卷免登录下载完整包一键获取。- 可自定义PC文件保存路径安卓统一存Download/MiaoXiang/。传输请求弹窗10秒无操作自动拒绝避免恶意文件骚扰。三、整体技术架构P2P去中心化无中间服务器整体分为两大通信通道端口固定不冲突通道端口协议作用设备发现通道19876UDP局域网广播DISCOVER探测设备、单播返回设备信息数据传输通道19877TCP文件请求、文件二进制流、剪贴板文本、取消指令等统一TCP消息帧协议重点技术点所有TCP通信统一封装固定格式解决粘包问题4字节大端长度前缀 UTF-8 JSON消息体┌───────┬───────────────┐ │ 长度(4字节) │ JSON 消息体(type区分) │ │ big-endian │ FILEREQUEST / TEXTDATA │ └───────┴───────────────┘内置完整消息类型设备探测、文件请求、确认/拒绝、文件分片、传输完成、取消传输、文本收发等扩展简单。两端技术栈1. PC Windows端语言Python3GUI框架PyQt5核心库socket、threading、json、PyInstaller打包、Inno Setup制作安装包模块分层界面层、UDP发现服务、TCP传输服务、协议编解码、托盘管理2. Android移动端主体原生JavaminSdk 26Android8.0配套前台服务、通知渠道、WifiMulticastLock、文件存储权限管理预研分支Kotlin Jetpack Compose版本仓库未收录可自行拓展四、仓库目录结构快速看懂代码分层miaoxiang/ ├── Android/ # 安卓Java源码 │ ├── app/src/main/java/com/androidmiaoxiang/app/ │ │ ├── DiscoveryService # UDP设备发现前台服务 │ │ ├── TransferService # TCP文件/文字传输核心 │ │ ├── MainActivity # 主界面、设备列表、文件选择 │ │ ├── Protocol.java # 端口、消息常量定义 │ │ └── NotificationHelper # 通知栏横幅、进度通知封装 ├── PC/ # Python PyQt5 PC端源码 │ ├── main.pyw # 程序入口、防火墙授权、托盘初始化 │ ├── ui_main.py # 主窗口、拖拽文件列表、传输任务卡片 │ ├── discovery.py # UDP广播扫描服务 │ ├── transfer.py # TCP收发、文件分块传输逻辑 │ └── protocol.py # 帧编解码、消息类型统一管理 ├── 应用PC安卓/ # 打包成品可直接下载使用 │ ├── 妙享_pcandroid.zip # 完整安装包PC exe Android apk │ └── 分卷版无需登录/ # 30MB分卷压缩包适合Gitee限流场景 ├── pc截图.PNG / 安卓截图.jpg # 两端UI截图 ├── README.md └── LICENSE五、快速上手使用教程普通用户友好1. 下载安装仓库「应用PC安卓」目录提供两种下载方式完整包妙享_pcandroid.zip30MB包含Windows安装程序安卓APK分卷免登录版下载全部分卷cmd执行copy /b *.zip all.zip合并后解压。解压产物-妙享传输_Setup_v1.0.0.exeWindows安装包-妙享传输.apk安卓安装包安卓8.0及以上可用。2. PC端使用步骤运行exe安装首次启动弹窗允许防火墙放行否则无法被手机发现同一WiFi下自动加载所有安卓设备发文件直接拖拽文件/文件夹到列表选中设备点击发送发剪贴板复制文字 → 选中设备 → 发送剪切板关闭窗口自动最小化系统托盘右键托盘图标完全退出程序。3. Android端使用步骤安装APK授予存储权限、通知权限、后台运行权限关闭电池优化首页自动扫描局域网PC设备发送文件点击选择文件选中设备发送发送剪贴板长按设备「发送」按钮推送复制文本后台接收锁屏后通过横幅通知接收文件通知栏实时查看传输进度随时取消。4. 文件保存路径Windows默认用户文档目录设置页可自定义Android内部存储Download/MiaoXiang/文件夹。