localsend功能异常时应升级至最新版：windows用户推荐用v1.17.0 exe覆盖安装；混合安装问题需powershell卸载msix残留后重装；android端更新至v1.7.0并检查权限；macos/linux用户手动替换二进制文件。
如果您正在使用LocalSend，但发现功能异常、设备无法被识别或传输失败，则可能是由于当前版本存在已知兼容性问题或底层协议不匹配。以下是升级LocalSend到最新版的具体方法：
一、通过官方安装包覆盖安装（推荐）
该方法适用于所有Windows平台用户，利用最新exe安装包直接覆盖旧版本，可自动清理大部分残留并同步更新运行时组件。
1、访问LocalSend官方下载页面 https://localsend.org/，确认页面显示的最新版本号为v1.17.0（发布于2026年2月21日）。
2、点击“Download for Windows”按钮，保存LocalSend_1.17.0.exe安装文件至本地磁盘。
3、双击运行该exe文件，在安装向导中选择“为所有用户安装”，勾选“启动LocalSend”选项后点击【Install】。
4、安装完成后，原桌面快捷方式将自动指向新版本，无需手动卸载旧版。
二、使用PowerShell强制卸载msix残留后重装
该方法专用于解决因混合安装（如先装msix再装exe）导致的“设备不可见”“接收模块失效”等问题，可彻底清除注册表与容器化部署残留。
1、以管理员身份打开Windows PowerShell。
2、执行命令：Get-AppxPackage *LocalSend*，检查是否返回类似“TienDoNam.LocalSend_1.15.0.0_x64__8wekyb3d8bbwe”的msix包名。
3、若存在结果，逐条执行：Remove-AppxPackage TienDoNam.LocalSend_1.15.0.0_x64__8wekyb3d8bbwe（请将示例包名替换为实际查得的完整名称）。
4、手动删除残留目录：%LocalAppData%\Packages\TienDoNam.LocalSend_*及%ProgramFiles%\WindowsApps\TienDoNam.LocalSend_*（需启用显示隐藏项目并获取文件夹所有权）。
5、完成清理后，按方法一重新安装v1.17.0 exe安装包。
三、Android端静默升级流程
该方法确保移动端配置与服务端协议完全对齐，避免因API版本错配引发的“连接超时”或“接收中断”现象。
1、打开手机应用商店，搜索LocalSend，确认开发者为Tien Do Nam。
2、进入详情页，核对版本信息是否为v1.7.0（2026年3月30日发布）；若非此版本，点击【更新】按钮。
3、更新完成后，长按LocalSend图标 → 应用信息 → 权限管理 → 确保已授予本地网络访问与后台弹窗显示权限。
4、重启LocalSend应用，观察“附近设备”列表是否实时刷新且无灰色禁用标识。
四、macOS与Linux平台手动替换二进制文件
该方法适用于通过tar.gz分发包安装的用户，绕过系统包管理器缓存，确保动态链接库与主程序版本严格一致。
1、前往https://github.com/localsend/localsend/releases，下载对应平台的最新压缩包（如localsend-macos-x64-v1.17.0.tar.gz）。
2、解压后定位到localsend.app/Contents/MacOS/localsend（macOS）或localsend-linux-x64/localsend（Linux）路径。
3、将原安装目录下的同名可执行文件（如/usr/local/bin/localsend）备份为localsend.bak。
4、使用sudo命令复制新文件：sudo cp /path/to/new/localsend /usr/local/bin/localsend，并赋予执行权限：sudo chmod +x /usr/local/bin/localsend。
