文档

快速开始

安装客户端 → 允许本地网络权限 → 开始发现 → 扫码或手动 IP 配对 → 确认 SAS → 选择文件发送。

1. 01

   安装并授权

   安装客户端后，允许「本地网络」权限。移动端还需允许局域网发现。

2. 02

   开始发现

   两端都在同一局域网时，点击开始发现即可看到候选设备。

3. 03

   核对 SAS

   扫码或手动连接后，双方屏幕上出现同一组短数字，一致才各自确认。

4. 04

   发送与接收

   选择文件发送；接收方在 60 秒内确认，传输开始并可续传。

发现设备

同一局域网内通过 mDNS 服务 _ssnd._tcp 广播候选；扫描结果只含设备名与地址，不含任何身份声明，因此发现到 ≠ 可信。

• AP 隔离、跨 VLAN、企业防火墙会阻断发现，此时进入 limited discovery。
• 手动连接：直接填对端 IP，默认端口 39551。
• 发现阶段不上传任何设备信息到服务器。

配对与 SAS

配对载荷由长期身份密钥（Ed25519）签名，在引擎内验签后才展示 SAS。SAS 是应用层校验，TLS 不能替代它（ADR-001）。

• 配对窗口 120 秒，超时需重新开始。
• 两侧数字不一致 = 存在中间人，直接终止，不要「差不多就确认」。
• 已配对设备会写入本地信任库，可逐设备撤销。

发送文件

未信任设备发出的 FileOffer 会被引擎直接拒绝——这不是 UI 拦截，是引擎状态机的硬约束。

• 接收方需在 60 秒内确认，超时视为拒绝。
• 目录与单个文件都按传输任务处理，未收齐不会标记成功。
• 传输全程应用层 AEAD，中继路径同样如此。

续传

中断后凭 resumeToken 续传，落盘使用 .ssnd.partial 临时文件，完成后原子 rename。

• 不会出现「显示完成但文件不完整」的状态。
• 校验和不匹配时任务标记失败并可重试。

诊断

诊断页可导出日志包用于排查。导出内容不含私钥，也不含信任库中的身份密钥。

• 导出前可预览条目，敏感字段默认脱敏。
• 无法连接时优先看：网络、防火墙、端口 39551、版本是否一致。