核心用法
LocalSend 是一个基于 LocalSend v2 协议的局域网文件传输技能，允许用户在本地网络内的设备间直接发送和接收文件，无需互联网连接或第三方云服务。
主要功能模块：
1. 设备发现 (discover): 扫描局域网内所有运行 LocalSend 的设备，返回 JSON 格式的设备列表（名称、IP、设备类型）
2. 文件发送 (send): 通过 --to 参数指定目标设备名称（支持大小写不敏感的部分匹配）传输文件
3. 文件接收 (receive): 启动 HTTPS 服务器监听传入请求，支持 -y 自动接受模式
交互模式：支持 Telegram 按钮式交互流程，包括主菜单导航、设备选择器、发送确认和接收状态管理。
关键注意事项：
--alias为全局参数，必须位于子命令之前（如localsend-cli --alias NAME receive）- 接收命令会阻塞运行，必须通过
run_in_background方式后台执行以保持代理响应 - 默认端口 53317 被占用时会自动回退到 53318/53319
显著优点
- 零配置传输：同一 WiFi 下自动发现，无需配对码或账户
- 跨平台兼容：支持 Android、iOS、Windows、macOS、Linux 的 LocalSend 官方应用
- 隐私优先：端到端加密（HTTPS），数据不经过任何服务器
- 无网络依赖：纯局域网传输，适合敏感文件或离线环境
- 开源可信：LocalSend 为开源项目，协议公开透明
潜在缺点与局限性
- 网络环境受限：必须处于同一局域网，VPN 或复杂网络拓扑可能导致发现失败
- 无传输进度反馈：CLI 阻塞直至完成，大文件（>100MB）需用户耐心等待
- 并发限制：同一时间只能处理一个活跃传输会话（409 Busy 错误）
- 依赖 GUI 应用：目标设备必须安装并打开 LocalSend 官方应用才能被发现
- 端口冲突风险：与本地运行的 LocalSend GUI 版本可能产生端口竞争
适合人群
- 需要在手机、电脑、平板间快速传输文件的开发者或设计师
- 注重隐私、不愿使用云存储或即时通讯工具传文件的用户
- 处于无互联网环境（如内网、离线会议室）需要文件交换的场景
- 自动化工作流中需要集成文件接收能力的系统管理员
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 传输拦截 | 局域网内流量可能被同一网络攻击者嗅探 | 使用 WPA3 或强密码保护的 WiFi；协议本身使用 HTTPS 加密 |
| 自动接受风险 | `-y` 模式自动接收任何传入文件 | 仅在可信网络环境启用；定期检查 `~/incoming` 目录 |
| 文件名冲突 | 同名文件可能被覆盖 | 技能默认保存至 `~/incoming`，建议用户建立文件管理规范 |
| 后台进程残留 | 接收服务未正确停止可能长期占用端口 | 提供 `[🛑 Stop Receiver]` 按钮，确保用户可手动终止 |
| 社会工程攻击 | 攻击者可能伪装设备名称诱导发送 | 设备发现时显示完整 IP 地址，建议用户核对设备标识 |