开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 3 条记录。
项目全部项目智慧乐活圈 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-27
多端不做 N 个 SDK,做一个协议 + N 个薄适配层
- 需要覆盖 Web、小程序、App、电视四类端。直觉是各写一个 SDK,但那是四条互相不知道对方存在的时间线
- 四份实现(JavaScript / Kotlin / Swift / Dart)迟早会在派生字段上漂移。最先出事的会是「会话累计时长」这种要计算的字段:一份从页面进入算、一份从会话开始算,两套口径就永久分叉了,而且没人会发现 —— 看板上只是两个数不一样
- 唯一有效的防线是契约测试:一套共享的 JSON 用例,每个实现都必须逐字节通过。原生实现只要写几十行执行器就能跑同一批
- 基线用「改造前的 Web 行为」生成,改造后逐字节一致 —— 这才证明重构没有改变任何现有行为,而不是「我觉得没改」
- 核心层同时做了能力化:必需接口 13 个,其余能力自动探测,缺能力只少一个字段而不是抛错。否则原生端要写一堆空实现,漏一个就崩
- 另一层设计:平台差异不在「怎么发 HTTP」,而在「什么算一次会话」。电视上一集剧 45 分钟,沿用 30 分钟超时会把一集切成两段,会话数直接翻倍、平均时长对半砍 —— 这种错在报表上看起来完全正常。所以会话超时、最短停留、离线队列都按平台分档,写进协议而不是写死成全局常量
- 电视端目前不做:没有真实项目,做出来就是没验证的代码,等真有项目时需求一定会变。协议里已预留客户端枚举和阈值覆盖,将来只需「写一个适配层」,不必「改协议」
- 服务端同步补了三个接收口径:客户端名归一化(多端一并入必然出现各种写法,不归一按端分组会碎成十几个桶)、设备维度允许自报(原生端没有 UA,否则设备分布图只能看见 Web)、协议版本收下并做版本自检(用来发现「某个端静默跑着半年前的老 SDK」)
沉默页面必须双层数据源 —— 无人问津的页面在埋点里根本不存在
- 直觉做法是「查一下哪些页面很久没有访问记录」。这只覆盖了一半
- 它能找到的是「曾经活过、现在死了」的页面:这些页面留下过数据,所以能上榜单
- 但「上线之后一次都没人访问」的页面在埋点里连一条记录都没有 —— 它不会出现在任何榜单上,也就永远不会被发现该下线。这恰恰是最该下线的那些
- 解法:除被动埋点外,再开一条主动通道,由站点上报自己有哪些页面。两路交叉比对:清单里有、埋点里没有 = 上线即无人问津
- 附带一条必须显性化的结论:如果站点根本没上报清单,覆盖度就是 0,此时「沉默为零」不是好消息,是「还看不见」。界面上专门留了一块警告说明这件事,而不是让一个漂亮的 0 蒙混过去
- 现状:22 个站一个都没上报清单,所以那块警告一直在亮 —— 这是真的
- 另一条相关设计:功能名不做预登记。埋点随手命名,事后自动归集 + 一键合并同义名,改名不丢历史
2026-10-15
隐私从「配置项」改成「架构约束」
- 常见做法是用一个配置开关控制「要不要记 IP」,但那只是承诺,不是约束 —— 一个手滑的日志、一次临时排查就能绕过去
- 改成结构性约束:IP 只在内存里查一次归属地,查完立刻置空,继续往下传的对象上根本不存在这个字段。存储域在代码结构上就拿不到 IP,不需要靠任何人不犯错
- 访客标识一律做带盐的单向哈希(32 位十六进制),并立为不变量:库里任何匿名标识都必须是哈希,不许直接把会话 id 塞进去当「匿名 id」—— 那只是把明文字段换了个名字
- UA 默认不落原文,只留操作系统 / 浏览器 / 设备类型三个分类值
- 这条不变量写成了自动化自检脚本并进发布门禁:跑不过就发不出去,不靠人看
- 理由:隐私一旦是「配置项」,它就会在某个赶进度的下午被打开,而且再也不会被关闭