LocalSend Kotlin

LocalSend Kotlin 是一个使用 Kotlin 编写的非官方、轻量级原生 Android LocalSend 客户端。本项目与原版 LocalSend 项目没有隶属、赞助或官方授权关系，目标是与原版客户端互操作，并支持在局域网内安全传输文件，包括较旧的 Android 设备。

已实现功能：

• 使用 LocalSend v2 UDP 多播发现局域网设备，多播失败时回退到 HTTPS 扫描，并支持选择网络接口。
• 支持只读的 LocalSend v2 设备信息接口（/api/localsend/v2/info），返回设备指纹等信息。
• 支持发送和接收文件、文件夹、媒体、文本和剪贴板内容。
• 支持多文件队列、进度显示、取消传输、可配置的接收行为和历史记录。
• 支持 HTTPS、基于证书指纹的设备身份校验、可选 PIN 验证和 SHA-256 校验和。
• 支持系统默认、简体中文和 English 界面，不支持的系统语言回退为英文；支持主题色、深色模式、设备与收藏设备管理和网络/传输设置。
• 使用前台服务支持锁屏传输、通知操作和可选的保持屏幕唤醒模式。
• 支持 Android 7.0（API 24）及以上版本的系统快捷设置磁贴，可切换后台传输服务。
• 注册为 Android 系统分享入口，支持分享单个文件、多个文件和文本内容。

兼容性：

• 支持 Android 5.0（API 21）及以上版本。
• 两台设备需要连接到同一个局域网。
• 客户端对外声明的协议版本为 2.0，已实现 LocalSend v2 的主要发现和上传流程；尚未验证协议的完整符合性。浏览器下载 API 尚未实现（download: false）。
• 访客网络、AP/客户端隔离、多播过滤或厂商防火墙可能会阻止设备发现或 TCP 连接。

存储方式：

• Android 10 及以上版本默认使用 MediaStore 保存到公共下载目录。
• Android 5.0 至 Android 9 默认保存到 Download/LocalSend Kotlin 目录，并需要传统存储权限。

当前限制包括传输队列界面仍需完善、不支持通过浏览器链接接收、不支持多线程传输和断点续传，也尚未进行大文件性能优化。目前不支持 Android 4.x。

这是一个适合早期用户测试的 Alpha 项目。反馈问题时，请附上 Android 版本、设备型号、双方客户端版本和可复现步骤。