开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 34 条记录。
项目全部项目智慧乐活圈 lehuoquan乐活圈 OA 考勤 lehuoquan-oaMagicEngine 悦居魔法引擎如影随形 TraceMate悦居集团数字化 · 统一后台悦居智能 CRM悦居可视通话 yueju-call悦居存储管家 StorageMate悦居反诈专家 AntiFraud悦居智能NVR小红花 LittleBlossom悦居统计后台 DashboardFileBreeze悦居护眼卫士 EyeGuard宠物小程序贝芽妈(lovely-child)悦居智能官网悦居存储管家 AndroidSmartHome 安卓控制端适老智家 AgeHome悦居 AI 日历轻风快传官网 FileBreeze中航天业竞价小程序绿荫网球中心官网绿荫网球小程序青年公社小程序青年公社官网中羊坊村官网 Zhongyangfang自动化脚本集 automation我的减肥日记 WeightLoss画山别墅的旅行家 Travel画山别墅里的国学世界 GuoXue冰雪冬奥张山营延庆骑行网 YanqingBike延庆徒步网 GoHike智能门锁 SmartLock排队仿真 QueueSimulation悦居智能小程序 yueju-miniprogram智能会议室预约 meeting乡村文旅 VillageHub减肥日记小程序日常运维国学小程序 guoxue3D智慧城市 SmartCityLiveRobot 数字人应梦寺爬山smart_home_chat花间向导 SmartGuideWorkBuddy 指标看板T5AI 聊天机器人悦居AI相册(相册管家)
2026-10-26
电视端落地: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 不会误入电视界面。
2026-10-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,四端安装包全部上传
2026-10-20
中转通道被旧连接误删导致 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 内存转发,
2026-10-17
全端版本对齐 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 项全通过。
- 遗留「视频播放失败」是播放器解码该流失败,与传输无关。
2026-10-14
真机装机成功不能只看退出码:安装命令几乎不打印任何输出
- 真机装包退出码 0 却几乎无输出,容易误判静默失败;该命令成功时本就只打两行,接管道还会被缓冲吞掉。
- 判据落到设备:用构建工具链内置工具查应用标识是否已装,再列设备应用清单确认。
- 系统设备管理命令对这台手机一直报「设备未找到」,只有项目自带工具链认得。
- 装机是先卸载再装,传输历史与设置会被清空,验收前先告知使用者。
传输到一半打开 WiFi 就停了:断网 / 切网现在会自动续传
- 传到一半开 WiFi 就停:重试 1 次+退避 1 秒约 2 秒窗口,远短于换网 5–15 秒;续传数据存了却没有恢复入口。
- 新增「等待网络」状态(占住并发位、最长 3 分钟),恢复后自动续传并重新解析对端地址;分片超时 30→15 秒。
- 网络类异常走等恢复、业务类走退避,两套计数器;顺带修状态文本只转入参小写、并发分片重复上报开始。
- 客户端 86 项全过(新增 8 项覆盖网络恢复);涉及传输层,两端须同版本。
决策:暂不购买 Apple 开发者账号,iOS 维持开发期分发
- iOS 用免费个人团队签名,描述文件 7 天到期需重装,无分发证书与 TestFlight 权限。
- 结论:产品暂无收入,不购买 Apple 开发者账号,上架与 TestFlight 整体搁置。
- 出口合规声明、隐私清单、发布导出配置三项准备也先不做,有收入再补。
iOS 相册「既不授权也不弹框」的根因:权限库的编译宏没打开
- iOS 相册既不授权也不弹框:权限库的相册读写编译宏没在工程里打开,请求落到未知权限分支直接拒绝。
- 依赖安装钩子补两个宏并重跑安装;新增统一权限网关:查状态→说用途→弹框→被拒给去设置。
- 有限访问视为通过;接收预检从「全是图片」放宽为「图片+视频」,原来收视频压根不申请权限。
- 修掉保存路径里已删依赖的调用;静态分析 0 错、测试 78 项全过,真机安装成功。
2026-10-13
开发机自用:启动台里的图标一直指向半年前的旧构建
- 启动台图标指向半年前旧构建(带调试残留),最新构建一直躺在构建目录。
- 原因:同一应用标识在注册表登记多份(调试目录、中间产物、备份副本),互相抢链接归属与图标。
- 处理:旧副本移到项目外备份,用保留扩展属性与签名的拷贝方式覆盖,清理多余登记只留「应用程序」那份,刷新启动台。
- 做成脚本:一键同步最新构建并打印版本号,已实跑可重复执行。
iOS 首次真机构建:依赖索引被墙 + 一个失效的镜像劫持了依赖克隆
- iOS 首次真机构建卡两层,均非代码问题。
- 依赖索引 CDN 被墙:改配置文件地址无效(代码有短路逻辑),必须改代码常量。
- 更隐蔽:一条全局地址改写规则把某依赖劫持到 git 协议握手失败的镜像,首页 HTTP 仍返 200;判断方法是绕开规则直连一次。
- 修好后依赖安装 1 分 18 秒完成,35 个包全部就位。
- 环境结论:只能用项目自带工具链装机;安装会先卸载旧版、清空本地数据。
两条并行的版本线合并为 1.5.0 —— 顺手拦住一次错误码撞号
- 两条并行版本线(微信小程序传输 / 应用内更新与版本详情页)合并为 1.5.0。
- 冲突两处:版本号取远程(远程更高且已发布);错误码撞号——本地号段与远程「页面不存在」同数字,服务端只按数字入库会混统计,整段挪到空闲号段。
- 四处自动合并(本地服务、主入口、传输引擎、传输任务)双方改动均保留。
- 静态分析 0 错误,客户端测试 33 项全通过。教训:加错误码前先查小程序侧已占码表。
2026-10-12
电脑端接收小程序文件:落盘位置、临时文件残留与「全程无提示」
- 电脑端接收文件修三处:落盘改到下载文件夹根,不再多套产品子目录;分片暂存移到应用支持目录,合并后连空暂存根一并清理。
- 局域网直传不走信令,原先全程无提示;主界面加接收提示:发送中、已接收 N 个文件并给「打开文件夹」、失败显示原因。
- 顺带修进度估算:分片变小后仍按旧假设反推会提前跑满,改为采纳发送方清单里的分片数。
小程序错误上报链路打通:写接口加配额、读接口加鉴权
- 小程序错误上报链路打通:写接口加专用限流 + 条目级配额,实测 30 次请求 × 100 条即可冲空环形缓冲。
- 读接口此前完全无鉴权,一次请求就能爬走完整调用栈、设备标识与任务号,本轮补上。
- 超配额返回成功但标记已丢弃,避免客户端整批回队重试放大压力;健康检查暴露已丢弃条数。
- 客户端补齐两个错误码,与小程序侧同码同义,两侧文件头互标「必须同步」。
小程序工程纳入主仓库 —— 此前它完全不在任何版本库里
- 小程序源码此前只存在于开发机、不在任何版本库,几轮修复无历史可回溯。
- 整体迁入主仓库,拷贝后逐文件校验与源目录逐字节一致。
- 补忽略清单:开发者工具私有配置、约 5MB 端到端测试产物。
- 迁移后自检 110 项、冒烟 14 项全过,打包不受影响仍约 70KB;用开发者工具打开须选仓库子目录而非根。
2026-10-11
服务端镜像构建上下文缺忽略清单,环境变量文件与备份目录被打进镜像
- 服务端镜像构建缺忽略清单(该文件从未入库),环境变量文件(含签名密钥与后台口令)与备份目录被打进镜像层。
- 危害等同凭据泄露,换变量值后旧镜像层仍留旧值。
- 补上忽略清单,环境变量、备份、临时文件一律不进构建上下文。
- 中转接口同期加独立限流与单文件/单会话/文件数/有效期上限,落盘名由服务端生成防路径穿越。
- 此后交付前增加构建上下文内容检查。
发布 1.4.0:微信小程序「轻风快传」上线,微信 ⇄ 电脑双向传文件
- 微信小程序「轻风快传」1.4.0 上线:微信 ⇄ 电脑双向传文件,扫码即用,不用装 App 和数据线。
- 同一 WiFi 走局域网直连、不经服务器;跨网自动回退服务器中转,凭取件码取件。
- 上行分片上传,电脑端同名文件自动加序号不覆盖;下行可选中文件共享给手机,末片附校验值、收完即比对。
- 受小程序平台约束(须备案加密域名、连接创建次数上限、单次写入上限),全程复用一条长连接、分片调小。
2026-10-07
macOS 打包踩坑:签名校验失败的真因是可执行文件名大小写不一致
- 签名校验报「信息清单或签名已被修改」,但应用双击能正常打开,容易误判成打包改坏了文件。
- 真因:包内信息清单声明的可执行文件名与磁盘实际文件名大小写不一致;文件系统不区分大小写所以运行无异常,签名按字节比对即判篡改。
- 修法已固化成打包脚本:对齐文件名、移除旧签名、逐个内部框架重签(不用已废弃的深层签名参数)、整体签名后强制校验,不过就不出包。
发布 1.3.0:macOS 桌面版安装包首发 + Android 应用内更新
- 发 1.3.0,补齐官网此前指向 404 的下载入口。
- macOS 桌面版首个 DMG 安装包,Apple Silicon 与 Intel 通用,拖入应用程序即装。
- Android 应用内更新:应用内下载并拉起系统安装器,含进度、取消与失败原因,区分应用内下载与跳外部下载页两条路径。
- 接收端加总进度与「已完成 M / N 个文件」。两端包归档、清单更新到 1.3.0;核验产物哈希一致、直链字节数与本地一致。
2026-10-06
Windows 1.1.2 上架官网下载(zip 免安装)
- Windows 版首次上架官网(zip 免安装):构建 90.9s,Release 32M,打成 13.2 MiB 的包(顶层目录 + 30 项)。
- 上传下载目录,versions.json 的 latest.windows 指向 1.1.2 / build 9,history 加记录并镜像同步;官网 Windows 按钮原先只有 UI 没有 url,已补进压缩 JS。
- 坑:nginx 给 JS 标了 immutable 30 天,改名才生效——按新 sha256 前 8 位重命名并改 index.html 引用,验证旧名 404。
- 验证:zip 直链 200(application/zip,13.86 MB);沙盒拦 Add-Type,改用 tar 校验包结构。
发布 Android 1.1.2(build 9)+ macOS 同步重编
- 发 1.1.2(build 9),补丁版本、无协议变更,新旧版可混用。
- 内容:根治共享文件 ID 撞号导致只收到一个、接收端同名追加序号、进度条回落、任务卡显示文件数量。
- Android 包归档,版本清单与下载页同步;桌面端同步重编到同一版本号。
- 两台不同品牌手机覆盖安装成功,确认 1.1.2 / build 9,冷启动后服务端三台设备在线可互见。上架仍缺 release keystore、i18n 迁移、商店物料与隐私声明核对。
修复多文件传输进度条反复回落导致的「单文件闪烁」
- 现象:多文件传输进度条涨一段就归零,看着像在重复传同一个文件。
- 根因:进度 = 已收分片 / 总分片,文件合并后其分片从已收表移除,分子骤降,顺序发送时每个文件都走一遍涨满归零。
- 修复:以已落盘文件累计字节为基座(只增不减),加当前文件已收分片比例,夹在 [0, 总字节];同名文件按出现次序匹配清单尺寸。
- 顺带把任务卡副标题最前面明写「N 个文件」,避免长文件名截断后看成单文件。新增真实分片上传回归,50/50 通过。
根治「选多个文件发送、对方只收到一个」:共享文件 ID 撞号 + 同名覆盖
- 现象:手机选 5 张图发电脑,两端都报成功,磁盘只有 1 个文件。
- 根因:文件 ID 用毫秒时间戳,多选同步连发全落在同一毫秒,映射表后写覆盖前写;传输历史里 5 条的名称、大小、ID 全相同且等于任务号。
- 修复:ID 改微秒时间戳 + 自增序号并循环校验不冲突;接收端同名自动追加序号、绝不覆盖;合并落盘返回实际路径,完成判定改为已合并数达到清单长度。
- 顺带修:原先用待收分片表为空判整批完成,顺序发送时首文件合并完就提前报成。新增 11 例回归,49/49 通过。
发布 Android 1.1.1(build 8):传输可靠性修复 + macOS 版本号对齐
- 发 1.1.1(build 8),补丁版本、无协议变更,新旧版可混用。
- 内容:地址不可用导致整单失败(缺端口自动降级中转)、信令半开 75 秒判死重连 + 无限重连 + 60 秒巡检、错误码、全选与滑动多选、系统程序打开与文件管理器定位。
- Android 包归档,版本清单与下载页同步;服务端同步部署按地址完整性决定直连或中转。
- macOS 同步重编,修掉打包配置写死版本号导致上报恒为初始值,版本号来源统一。验证三台设备在线且端口齐全,手机确认 1.1.1 / build 8。
修复「对端设备地址不可用」:网络变化丢端口 + 自动降级中转 + 错误码体系
- 根因:网络变化回调里用不带端口的构造方式重建设备信息,本地服务端口被清空,上报地址只剩 IP,发送方前置校验直接判死。
- 三层防护:重建时保留端口;服务端发现接收方地址缺端口改走中转;客户端把直接判死改为「直连→中转」降级,并给发送入口补异常兜底,避免任务永久停在传输中占并发位。
- 错误码体系落地:失败提示带编号(如 E1005),14 个失败分支统一带码,补齐 WebRTC / 蓝牙码位,修掉重试时旧错误文案残留。
- 验证:静态分析 0 error,客户端 38/38(新增 5 例)、服务端 32/32(新增 2 例),三台设备上报端口全部非空。
根治长时间挂机后设备失联:信令半开自愈 + 无限重连 + 定时健康巡检
- 现象:桌面端长挂后进程活着、界面显示在线,但各端互相看不到,只能重启恢复。
- 根因:TCP 半开时收不到关闭也收不到错误回调,连接状态仍显示已连接;两处缺陷是重连有次数上限、心跳只发不等回。
- 改法:心跳升级往返探测,3 个周期无服务端消息即判死重建;移除重连上限,退避最长 30 秒永不放弃;局域网发现广播 30 秒未成功即重建;另加每 60 秒健康巡检。
- 用只握手不回数据的假信令服务器验证:第 75 秒准确触发重连;回归 21/21 通过。
媒体选择器支持全选与长按滑动多选
- 媒体选择器补两种批量选择:全选 / 取消全选,选中项带序号角标,底部显示「选好了 (N)」。
- 长按任一缩略图进入批量模式(带触觉反馈),按住滑动可连续选中或取消经过的条目。
- 实现:长按赢得手势竞争后接管拖拽,网格滚动让位;指针旁路层按滚动偏移换算网格下标(内容坐标 = 局部坐标 + 滚动偏移)。
- 选择结果带序号,传输顺序与选择顺序一致;静态分析 0 问题,真机全选与滑动均正常。
2026-10-04
macOS 重编踩坑:依赖锁文件被忽略导致版本漂移 + 国内网络下 66MB 二进制下载
- macOS 重编卡在二进制依赖两处。坑一:报错称最低系统版本不够,实为锁文件锁了旧版二进制;该锁文件被忽略规则排除、从未提交,版本漂移无人察觉。
- 清理锁文件重新解析,最低系统版本抬到 12.0,工程配置与构建脚本两处同步改,只改一处仍在安装阶段报错。
- 坑二:66MB 二进制国内直连不通,镜像单线程衰减到几 KB/s;切 8 段并行续传并加低速超时重连,约 330 KB/s、3 分半完成,缓存按原始校验和补齐。
- 重编后注册正常:服务端 120 秒窗口内仅 1 次注册,此前每 30 秒上万次的重注册风暴确认根治。
发布 1.1.0(build 7):服务端生产部署 + Android 包上线
- 发 1.1.0(build 7),因含传输协议变更(本地接收加一次性配对令牌鉴权)走 minor 号,新旧版混用会单向失败。
- 服务端生产部署:先补环境变量(JWT 密钥、后台口令、跨域白名单),缺变量会拒绝启动;容器编排改读环境文件,原配置改文件不生效。
- 上线探针全绿:健康检查含 Redis、WebSocket 升级 101、错误上报读写、后台登录、服务端单测 30/30。
- Android 包归档,官网下载入口与版本清单(latest + history)同步;待办商店上架仍在推进。
错误上报链路真正打通:固定 API 基地址 + 运行期全局异常兜底
- 错误上报此前从未成功:地址由信令地址派生,信令迁 wss 后拼出的地址带 wss 前缀,HTTP 客户端不支持,异常被吞。
- 改为固定 API 基地址常量,所有 REST 调用只认这一处,不再派生。
- 日志初始化改幂等可更新:启动早期只传上报地址,初始化前记录暂存内存(上限 200 条),完成后统一补写补报。
- 入口包进 runZonedGuarded,加 FlutterError.onError 与 PlatformDispatcher.onError 兜底,统一映射崩溃码 9999。
- 验证:analyze 0 error,test 21/21,服务端 /api/errors 读写正常。
P1/P2 全部修复:完整性校验、文件策略、合规页与 i18n、单测补齐
- 修完 8 项 P1 + 7 项 P2(6593827,31 文件)。
- P1:隐私协议内置、中英切换、错误上报落库、SHA-256 校验、10GB 阻断、Redis 降级、单测 21+30。
- P2:删重复 _checkUpdate、并发常量单一来源、relay 改实例字段、CI 与 systemd。
- 坑:flutter test 需 pumpAndSettle;intl 需升 ^0.20.2。
- 验证:analyze 0 error、test 21/21、jest 30/30、构建 29.8s。
2026-10-02
上线前安全加固:修复全部 7 项 P0 阻断问题
- 上线就绪审查修完 7 项 P0(819cbdc,25 文件 +1054/-298)。
- 覆盖路径穿越、配对令牌 + CORS、缺 JWT_SECRET 拒启、限流 + WS 校验、强制签名、版本号统一、删死分支。
- 坑:集成测试 open 后才注册监听,connected 握手丢失成静默超时;SessionHandler 未 close 致进程不退,17s→1.8s。
- 验证:analyze 0 error、Windows 构建 56.9s、服务端 25/25。P0-2 涉协议,两端需同步升级。
2026-09-25
五端构建全部通过
- macOS / Windows / Android / iOS / Web 五端构建验证通过。
- 相册权限封装完成。
- 文件选择器封装完成。
2026-09-20
P2P Socket 协议栈打通
- 自研 P2P 协议栈完成握手。
- 数据帧收发打通。
- 同类设备可不经中转直接传文件。