开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 5 条记录。
项目全部项目智慧乐活圈 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
补上版本控制:此前两周一直不是 git 仓库
- 项目从 10-15 起就一直不是 git 仓库。能跑、能部署,但没有任何「什么时候改了什么」的证据
- 补上时第一件事不是
git add .,而是先把排除规则写对:运行数据、数据库与 WAL、哈希盐、环境变量、日志全部排除 - 排除规则里最容易被漏的是备份目录:
data.bak-*这种名字不被data/规则覆盖,一不留神就把 7MB 演示数据悄无声息地收进仓库。第一次提交前逐条核对过一遍,确认没有库文件 / 密钥 / 依赖目录 - 因为补得晚,五笔提交全落在同一天,但实际开发跳了 13 天。这种「时间线失真」是无法事后修的 —— 能记录真实日期的地方是开发日记,不是提交时间
- 一个反思:版本控制不该等到「要交付了」才补。在它不是 git 仓库的那两周里,任何一次改坏都没有回退点,只是恰巧没出事
页面停留改用独立细桶:一把尺子量不了两种东西
- 现象:页面停留的 P50 恒等于 P90,每一行都是同一个数
- 根因:页面停留复用了会话时长的分桶。会话时长跨 5 秒到几十分钟,桶在 0~60 秒内只有 3 格;而页面停留集中在 0.3~60 秒,两个分位数直接落进同一格,取到同一个代表值
- 这不是算错,是尺子不对。改成给页面停留单独一套 8 格细桶后,分位数立刻分开
- 同时拆了会话桶的尾部:原来的「10 分钟以上」是个巨桶,会吞掉一切,导致 P75 与 P90 也常常相等
- 一个时机判断:现在是改桶边界的唯一窗口期。桶名是字符串存在表里的,线上还没有新口径数据时改边界零迁移成本;一旦积累几个月真实数据,就得处理新旧两套桶名混在同一张表里
- 演示数据也一并修了:原先所有页面共用一个均匀分布,导致每页停留一模一样。改成每页一个中位数 + 对数正态抽样 —— 真实停留是右偏的,少数长尾拉长平均,中位数才是那个「一般情况」
- 结论:分位数用直方图近似是省存储的正确做法,但「一套桶到处用」是错的。桶边界必须贴着每个指标的真实分布分别设计
M1b:导航按「要回答什么问题」重新分组,补上四个模块
- 导航从 3 个 tab 扩到 7 个,按「要回答什么问题」分三组:概览(总览 / 实时)、分析(流量 / 时长)、治理(沉默资产 / 崩溃 / 功能)
- 使用分析:会话时长分桶直方图 + P50/P75/P90 + 快速退出率 + 深度使用率 + 页面停留榜
- 沉默资产:阈值可调 30/60/90/180/365 天,双路数据源交叉比对
- 崩溃监控:崩溃率趋势双轴图 + 无崩溃率 + 按指纹分组 + 行内展开堆栈
- 功能归集:跨站排行 + 按站点勾选合并同义名 + 一键撤销
- 每个模块都能直接分享链接(hash 路由),不用教人怎么点进去
- 顺手修了一处显示:相邻分位数落进同一个桶时合并成一行(如 P50–P90)并说明「是分布集中,不是算错」。界面摆三个一模一样的数字,用户第一反应是系统坏了
- 折叠处理:沉默资产的覆盖度表默认铺满 19 行「缺失」会把整页占完,改成一行摘要 + 展开按钮
2026-10-22
M1a:重构成 ingest / store / query 三分域,打点接口不再阻塞
- 原先是单进程双库,读写混在一起,查询一慢就拖到打点
- 重构成三域:ingest(脱敏后立即返回 204,永不阻塞)→ store(唯一落盘出口)→ query(只读,预聚合 + 30 秒缓存)
- 实测推翻了一个假设:存储不是瓶颈(每个事件约 321 字节),真正的瓶颈是同步 SQLite 接口把事件循环堵住
- 所以光做「内存微批」不够 —— 一批 750 行照样一口气写完,一次堵上百毫秒。改成每片 150 行 + 主动让出事件循环:不切片时 p99 59ms,切片后单片 8ms
- 崩溃明细单独一个库只留 30 天,但崩溃率的趋势聚合仍然留 12 个月 —— 明细是排查用的,趋势是决策用的,保留期不应一样长
- 存储域启动时预热:三库连接与语句预先备好,冷启动开销不摊给第一个访客(实测 14.4ms)
2026-10-15
v0.1 打通链路:埋点 → 落库 → 看板渲染全通
- 三个模块:总览 / 实时 / 流量。一套脚本嵌进站点就能出数
- 链路:浏览器采集 → 打点接口 → 落库 → 查询接口 → 看板渲染
- 当天定下三条底线:单租户自用(不做 SaaS,无注册 / 无计费 / 无多租户)、隐私优先、打点不能影响业务站
- 打点路径定在
/fbtrack而不是/api/track:各站自己的/api/已被业务后台占用,会抢先匹配。这个坑不看代码看不出来,接第二个站的时候才会炸 - 接入成本压到一行脚本 + 一行初始化,不用改 nginx
- 同时产出产品规划、架构设计与交付说明三份文档