F
核心亮点
- 自研 P2P Socket 协议栈,同类设备直连不过中转
- macOS / Windows / Android / iOS / Web 五端同一套逻辑
- 上线前安全加固:本地服务配对令牌鉴权 + 路径穿越防护 + 服务端限流与来源校验
- 端到端 SHA-256 完整性校验,损坏文件不落地
- 内置隐私政策与用户协议(离线可访问),中英双语界面
技术栈
开发成果 33/34
- P2P Socket 协议栈
- admin 后端
- filebreeze_picker 组件
- 五端构建验证通过
- 相册权限 / 错误日志统计
- 上线前安全加固(全部 P0 阻断项)
- P1/P2 质量与合规补齐(SHA-256 / 文件策略 / i18n / CI)
- 错误上报链路打通 + 运行期全局异常兜底
- 服务端生产部署(v1.1.0)
- Android 1.1.0 发布(官网可下载)
- macOS 端重编与真机验证
- 长时间挂机自愈:信令半开检测 + 无限重连 + 60s 健康巡检
- 媒体选择器:全选与长按滑动多选
- 传输地址丢失修复 + 错误码体系
- Android 1.1.1 发布(build 8)
- 多文件清单撞号 + 传输进度回退修复
- Android 1.1.2 发布(build 9)+ macOS 重编
- Windows 1.1.2 上架官网下载(zip 免安装)
- macOS 桌面版安装包首发(DMG 直装,Apple Silicon & Intel 通用)
- 应用内更新(Android)+ 版本详情页
- 接收端多文件进度(总进度 + 已完成 M / N 个文件)
- 微信小程序「轻风快传」双向互传(局域网直连 + 服务器中转取件码)
- 小程序工程纳入主仓库 + 小程序错误上报链路
- Windows 1.4.0 发布(跨端互传)
- 两条版本线合并为 1.5.0(小程序传输 / 应用内更新 / 接收端进度)
- iOS 真机落地:Bundle ID 归位 + 相册与相机权限按需授权
- 网络中断 / 中途切网自动续传(等待网络状态 + 断点续传恢复入口)
- 通讯录导入导出 + 按号码/姓名三档合并去重 + 多选整体发送(含平台能力矩阵)
- 收到传输请求自动前置窗口(macOS 置顶策略 / Windows 原生 SetForegroundWindow)
- 传输详情面板 + 中途真停止 + 中转任务一键改直连
- 中转通道重绑 + 静默丢包修复(Unknown channel 回 CHANNEL_LOST,客户端挂起等恢复)
- 电视端入口(LEANBACK_LAUNCHER + banner + UiModeManager 检测)
- 电视端遥控器界面:焦点导航 + 纯接收 + 收完直接播放
- 应用商店上架(keystore / 商店物料 / 隐私声明核对)
开发历程 34 条
电视端落地:LEANBACK 入口 + 遥控器焦点界面 + 收完直接播放
- 背景:国产 Android 电视。现有 APK 能装但等于打不开:只有 LAUNCHER 入口(桌面不显示图标)、0 处 FocusNode / onKeyEvent(遥控器点不动)、0 处响应式断点。
- 方案:不动手机端页面,另建一套电视界面,main.dart 按
TvMode.isTv分流;手机/桌面继续走原来的 _MainNavigation。 - 入口与判定:Manifest 加 LEANBACK_LAUNCHER + 三档 banner + touchscreen/leanback required=false(aapt2 已验两个 launchable 都在);判定读 UiModeManager.currentModeType,不用机型白名单,异常一律当「非电视」——手机被误判就完全不能用。
- 遥控器两个坑:Flutter 默认不认 DPAD_CENTER 且各家 ROM 键值不一(select / enter / gameButtonA)→ 五种键统一映射 ActivateIntent;
onShowFocusHighlight只在键盘高亮模式触发,页面刚开是 touch 模式 → 焦点框不显示,改用onFocusChange。 - 🔴 第三个坑(收到的视频放不了):
_saveMediaToGalleryIfNeeded存相册后删临时副本,而播放页正是读这个路径;且电视没有相册 App。处理:电视跳过入相册 + 不设 mediaStagingDir,媒体直接落 downloadDir。 - 验证与配套:analyze 0 error;flutter test 162 项全过(新增 tv_mode 4 + tv_focusable 6);APK 40.9MB。
--dart-define=FB_FORCE_TV=true桌面预览;tool/preview用 golden 渲图自检(需手动加载中文字体 + MaterialIcons,否则全是方框)。 - 待真机验收:桌面图标可见、遥控器能聚焦能点、收完能播放、手机装 +25 不会误入电视界面。
全端发布 1.5.0+24:三端安装包上官网,文件名带 build 号避免缓存
- 发版 1.5.0+24,四端安装包全部上传
(服务器路径),文件名带 build 号(-24)避开浏览器缓存:APK 40.7MB / DMG 41.3MB / Windows zip 14.0MB,上传后 md5 与本地逐个一致。 versions.jsonlatest 三平台 build=24,history 顶部新增1.5.0+24;DownloadSection.vueverTag →v1.5.0+24,feature 换成“通讯录多选一键发送”“传输中可中途停止”。官网构建部署后验证:线上引用index-CfCcDH-C.js,JS 内 grep 到 3 处v1.5.0+24与三个-24文件名。- Windows 构建踩了 SSH 坑:直接
ssh ... flutter.bat build windows会把进程连同会话一起挂死(19 分钟无产物、tasklist 里无 dart/msbuild)。改用Invoke-CimMethod Win32_Process Create脱离会话 + 日志重定向,再轮询日志才跑通,实际 166.5s。另有首行Nuget.exe not found(走 storage.googleapis.com)干等 2~3 分钟,不是死机。 - 提交:App
a6abcfd(+24)、官网cdce6cb(发版清单与下载区)。华为 P70 18→24、小米 17 21→24 均已覆盖安装、数据保留。
- 发版 1.5.0+24,四端安装包全部上传
中转通道被旧连接误删导致 37 帧静默丢包
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
relayChannels在 relayEnd/断连即释放;唯一落盘是取件码 DropStore(TTL 24h、5min 扫),实测目录为空。 - 顺手查出真 bug:
cleanupByDevice不判断设备是否已被新连接接管就删 relay 通道。现场 13:58 tao-mac→华为:通道 04 秒建立、14 秒接收端断开被清、16~20 秒发送方又推 37 帧全部Unknown channel,而代码只console.warn不回帧 → 客户端进度条照走、接收端缺片。 - 修复:服务端改为按
deviceId重绑 from/to + 30s 宽限期(期间重连自动恢复),Unknown channel 回relayError(CHANNEL_LOST)(同 requestId 只报一次),新增relayAlive探活回复relayAccept(recovered);客户端RelayTransfer区分暂时/致命,分片边界awaitChannelReady挂起等恢复,超时 30s 才失败。 - 验证:服务端 jest 52/52(新增 relay-rebind 5 项)、客户端 flutter test 152/152(新增 4 项);生产
tool/relay_rebind_live_check.js实测断开前 3/3、重连后 20/20 帧,日志出现🔁 Rebound channel。 - 坑与部署:服务端 src 长期「线上比仓库新」(bindings 修复只改了服务器),本次先回写仓库再改再部署;
docker compose up -d --build后 health OK / WS 101,顺手把已提交未上线的/api/errors限流+读鉴权一并带上线。提交7b4063f已推 Gitee。
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
全端版本对齐 1.5.0(build 16)并更新线上清单
- 1.5.0+16(含分片 flush 修复),全端对齐:macOS 40.7MB / Android 40.5MB / Windows 14.0MB 三包上站。
- versions.json、下载卡片、web-send.html 页脚三处同步。
- Mac、tao-mac、win-halle 重装并 9527 监听;华为 USB、小米无线 ADB 用 install -r 保数据。
- 三包 URL 全 200,线上 JS 含 4 处 v1.5.0,Web 接收页逐字节一致,回归 61/61;两端须同版本。
华为→iPhone 传视频失败:分片写盘没关文件句柄
- 华为→iPhone 传视频失败:接收端 pipe 完没 flush/close 就返回 200,缓冲未落盘,合并读到空分片,SHA-256 校验 422。
- 三条写盘路径全包 finally flush + close;中转合并前对账已收分片数 vs 声明数,缺片报缺哪几片,4xx/5xx 响应体 ≤500B 带进异常。
- 新增「2 分片并发上传」单测,不 await close 必坏可稳定复现;客户端测试 88 项全通过。
- 遗留「视频播放失败」是播放器解码该流失败,与传输无关。
真机装机成功不能只看退出码:安装命令几乎不打印任何输出
- 真机装包退出码 0 却几乎无输出,容易误判静默失败;该命令成功时本就只打两行,接管道还会被缓冲吞掉。
- 判据落到设备:用构建工具链内置工具查应用标识是否已装,再列设备应用清单确认。
- 系统设备管理命令对这台手机一直报「设备未找到」,只有项目自带工具链认得。
- 装机是先卸载再装,传输历史与设置会被清空,验收前先告知使用者。
传输到一半打开 WiFi 就停了:断网 / 切网现在会自动续传
- 传到一半开 WiFi 就停:重试 1 次+退避 1 秒约 2 秒窗口,远短于换网 5–15 秒;续传数据存了却没有恢复入口。
- 新增「等待网络」状态(占住并发位、最长 3 分钟),恢复后自动续传并重新解析对端地址;分片超时 30→15 秒。
- 网络类异常走等恢复、业务类走退避,两套计数器;顺带修状态文本只转入参小写、并发分片重复上报开始。
- 客户端 86 项全过(新增 8 项覆盖网络恢复);涉及传输层,两端须同版本。
决策:暂不购买 Apple 开发者账号,iOS 维持开发期分发
- iOS 用免费个人团队签名,描述文件 7 天到期需重装,无分发证书与 TestFlight 权限。
- 结论:产品暂无收入,不购买 Apple 开发者账号,上架与 TestFlight 整体搁置。
- 出口合规声明、隐私清单、发布导出配置三项准备也先不做,有收入再补。
周期
2026-04-23 → 未定