Skip to content

lan-send 0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 07 Sep 07:42
· 54 commits to main since this release
v0.1.0
879a1d0

首个版本：命令行客户端，覆盖里程碑 1–3（协议、发现、传输、断点续传、IPv6、配对、剪贴板同步）。

Added

  • 发布流程：推送 v* 标签在 GitHub Actions 构建安装包并发布到 Releases——macOS 通用 .pkg（有证书时签名与公证）、Windows .msi（WiX，加入 PATH）、各平台免安装压缩包、SHA256SUMS.txt；ADR-0012，流程见 docs/release.md。
  • 里程碑 3（第三部分）：剪贴板文件列表同步——复制文件时转为带 x-lanext.intent = "clipboard" 的普通传输，已配对的接收方自动接受并把收到的文件写入自己的剪贴板；receive 与 clip watch 共用同一套接收逻辑；send 的传输流程抽成可复用的 transfer。
  • 里程碑 3（第二部分）：剪贴板同步——ClipboardItem 模型，POST /api/ext/v1/clipboard（JSON / multipart，仅限已配对设备，大小上限），同步引擎（回环防止环形缓冲、超限提示、并行推送），macOS NSPasteboard 后端（changeCount 轮询，PNG 优先、TIFF 转 PNG，文件 URL），Windows clipboard-win 后端（事件监听、PNG 优先、CF_DIB 转 PNG、CF_HDROP），敏感文本启发式，剪贴板历史（默认 50 条，图片存缓存目录），CLI clip watch / push / history。
  • 里程碑 3（第一部分）：设备配对——POST /api/ext/v1/pair / unpair，双方各自显示由指纹派生的 6 位校验码并确认；服务端维护已配对指纹集合供私有端点鉴权；CLI pair <device>、receive 处理配对请求、devices --unpair，设备列表标记 P。
  • 里程碑 2（第三部分）：IPv6——每个有 IPv6 的接口按索引加入 ff12::fd3a:e420 组播组，HTTP 服务同时监听 [::]（v6-only），链路本地地址带 scope 回拨（自定义 DNS 解析器编码 fe80::1%3），命令行目标支持 [fe80::1%en1]:53317；设置 ipv6 可关闭。
  • 里程碑 2（第二部分）：断点续传扩展——x-resume-token / x-resume-offsets、带 Range 的上传、GET /api/ext/v1/resume 断点查询、会话内与跨会话恢复、上传空闲超时（30 秒）与会话闲置回收（10 分钟）；进程内端到端测试覆盖中断后续传与官方式发送方的兼容路径。
  • 里程碑 2（第一部分）：settings.json 与 SQLite 持久化（传输历史默认 200 条、已知设备与收藏、断点记录表）；发送文件夹（递归、跳过符号链接与隐藏文件、保留相对路径、发送前汇总）；接收目录按设备 / 日期 / 类型分子目录，同名策略 rename / overwrite / ask；CLI 新增 history、devices，send 与 receive 读取设置并写入历史；发现阶段探测收藏与最近 7 天见过的设备地址。
  • 里程碑 1：lan-send-core 的 protocol（v2.2 DTO、x-lanext 扩展字段、指纹）、transport（RSA-2048 自签名身份、强制/可选客户端证书的 rustls 策略、reqwest 客户端、axum 上传 API 服务端、流式落盘与 SHA-256/字节数校验、文件名净化）、discovery（每接口一个组播 socket、公告脉冲、HTTP register 回应、已知地址探测、/24 子网扫描回退）、store（应用目录、私钥文件权限）。
  • CLI：lan-send discover / send / receive / identity，PIN 交互、进度条、--auto-accept、--config-dir、--client-certs。
  • 互操作测试 tests/interop/run.py：与官方 localsend-cli 1.18.2 双向收发（pexpect 驱动官方 TUI），CI 在 Linux 与 macOS 上运行。
  • 仓库骨架：Cargo 工作区、lan-send-core 与 lan-send-cli 空壳、命令行参数定义。
  • 文档：开发简报、LocalSend v2.2 接口核对清单、协议差异与扩展、三端平台约束、UI 视觉参考、ADR-0001 仓库布局。
  • CI：macOS / Windows / Linux 格式与 clippy 与测试，iOS 交叉检查，Windows 与 macOS CLI 产物，cargo-deny 许可证检查，标签发布。

安装：macOS 双击 .pkg（未签名版本需在“系统设置 › 隐私与安全性”允许），Windows 运行 .msi（会把 lan-send 加入 PATH），或解压压缩包后把 lan-send 放到 PATH 里。校验和见 SHA256SUMS.txt。

Assets 10
Loading