开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 104 条记录。
2026-11-17
几个不报错的坑:坐标差 538 米、华为装包四步、种子账号「女儿」
- 高德给的是 GCJ-02、库里存的是 WGS-84,延庆实测差 538 米 —— 而围栏半径只有 100 米。后果:人站在门口也被判外勤,而且任何地方不报错,只能看报表时才发现全员外勤。
- 修法:入库前一律
gcj2wgs(),转换算法只在server/src/gcj.js一份;后台另给一个「高德坐标转 WGS」按钮(拿高德抄回来的坐标先转再存)。 - 华为 HBN-AL00 装包四步(微信发 apk 装不上的真因):① 提示「应用备案状态未知」;② 底部「已了解此应用未经检测」不勾,「继续安装」是灰的、点不动;③ 勾完才能继续;④ 还要输手机锁屏密码。原来文案只写「点安装 → 允许」,而那台机上根本没有「允许」这个按钮 ⇒ 同事找不到就以为包坏了。已把这四步写进更新弹窗与
/dl/落地页。 - 会话与密码两个坑:登录查
SELECT *而会话查指定列 ⇒pw_must_change读不到,刷新一下就绕过了强制改密(两处必须同源);/api/auth/me会话失效返回 200 + user:null(不是 401),拿状态码当判据会漏。 - 伴迹种子账号「女儿」删不掉:
db.js每次启动INSERT OR IGNORE ... VALUES (2,'女儿','child')。之前靠「已标离职」这个巧合挡住,谁点一下恢复她就进考勤表、变成天天缺勤的员工。改成按角色白名单(只认employee/self),花名册 / 员工表 / 看板共用一份。
这个项目踩过的坑:天气源、讯飞签名与帧长、服务器不是自己的那台
天气源别随手选:
open-meteo在本机和服务器都是 TLS 握手 12 秒超时(不是 DNS,是握手就挂住),两台机器表现一致。换http://t.weather.itboy.net/api/weather/city/<编码>(延庆 101010800)后服务器 Node fetch 65ms / 200。区县级,跟老人手机上天气 App 口径一致。讯飞三个坑:签名
origin = host + date + request-line,date必须同一次请求里取,取两次就10105;IAT 送音频必须 40ms 一帧(1280 样本×2 字节),帧长直接断流;开了dwa:'wpgs'就必须处理pgs==='rpl'——那段是替换上一段不是追加,不处理同一句会被念两遍。Node 22 自带全局WebSocket,连讯飞零依赖。线上服务器是 154.8.211.18,不是自己的 (服务器IP)(
*.filebreeze.cn都指 176,但 lehuoquan.filebreeze.cn 在 154)。deploy.sh 里HOST默认值写死的就是 154,用错键找不到路径。同一个实例连跑两遍接口测试必大面积失败:不是代码问题。「进行中订单」互相挡、幂等键复用返回
replayed而非 201。要测就换端口 + 空数据目录。清测试数据前先打备份:数据库 WAL 模式,
lehuoquan.db主文件才 4KB、WAL 已 2.4MB,直接拷主文件会拷到空库。先用PRAGMA wal_checkpoint(TRUNCATE)归并。
2026-11-15
素材不够狠,第八次:判据跑绿只说明两个实现碰巧给出同一个数
- 现象:一共十来条判据,写完跑绿,改一行代码去破它(变异演练),结果也绿。判据不红,等于没写。到这一轮已经是第八次。
- 八次的名字:① 漏了闭合标记
Z(纯填充会隐式闭合,必须加stroke才看得见)②stroke-linecap(一条直线看不出圆头与平头的区别)③ 填充规则(一块实心方块上NonZero与EvenOdd同一个数)④ 组不透明度(单块方块上「每个孩子乘 alpha」与「整层打 5 折」同数;必须用两块重叠的)⑤ 自适应离散(tiger.svg的曲线本来就偏小,断成三段与断成三十段看不出差)⑥preserveAspectRatio(圆对sx/sy交换完全无感 —— 交换只是把椭圆转 90°)⑦ 掩码(拿Framebuffer::new当掩码,那张连 RGB 都是 0,两种实现同数)⑧ 裁剪(裁剪框与被裁元素完全重合时,「裁剪形状被当普通图形画出来」这个错画面一模一样)。 - 共同形状一句话:素材必须让那条代码路径有机会把答案改掉。 判据能“通过”是因为两个实现都落在同一个数值上——那不是同意,是没测到。
- 第八次最贵,因为它花了两次才认。第一次是裁剪 ① 用整块 200×200 元素被 100×100 框裁,演练报「期望红但没红」。我第一反应是「判据有洞」,去查判据;真正的真相是素材里那个洞恰好被填住了。改成元素只占上半张(200×100)后,交集 5000 与元素自身 20000 分得开,同一份变异立刻红。
- 可操作的做法:写判据时先问一句「错的那个实现算出来是多少」。答不出来就是不知道自己要区分什么,那就没写完。这一句后来直接进了几份场景文件的注释。
坑:跨天单的「滞留时长」算出了负数
- 派单页 KPI「最长滞留」第一版算出来是 -1.0 小时:因为待派单池里有隔夜单(SO-20261106-088,昨天 16:10 受理),只比时分就会得负数。
- 正确算法是先把日期差折成分钟:
(new Date(TODAY) - new Date(单日)) / 60000 + NOWM - hm(at),昨天 16:10 到今天 10:00 应该是 17.8 小时。 - 修正后同时加了兜底:
Math.max(0, ...),即使池里只有未来单也不会出负数。 - 教训:任何「距今多久」的计算都不能只看时分,跨天、跨月全靠日期差。而且自检要盯边界值 —— 负数比错数字更容易看出问题,但也更容易被一句
Math.abs()掩盖过去。
iframe.srcdoc 设了却加载空白 —— 包被 body.innerHTML 抹了
现象:
f.srcdoc = html执行成功,但contentDocument.body.innerHTML.length == 0,也不报错。两个真因,分两次才找全:
1. base64 包放在了 body 里。主原型每次
renderApp()都重写document.body.innerHTML,body 里的<script id="chainPkg">第一次渲染就被抹掉,getElementById('chainPkg').textContent读出空串 → 解码得空串 → srcdoc 为空。包必须放<head>。2. iframe 还没 append 就赋 srcdoc。游离节点赋值不触发加载,先
body.appendChild(f)再赋 srcdoc 才行。另两条坑:
blob:URL 在file://下被 CORS 挡死(SecurityError),srcdoc同源可读可调contentWindow,选 srcdoc。- 覆盖层(演示导览、应用框)要挂
document.documentElement,挂 body 同样被重写清掉,而且会让 iframe 重载、推演进度归零。
2026-11-10
链路里少一张领料单,毛利表的成本就永远是 0
- 现象:把三条链接到项目毛利表,成本永远是 0、毛利率永远 100%
- 查:手数 p2p 的 9 张单 —— 请购 → 比价 → 采购 → 收货 → 质检 → 发票 → 应付 → 付款 → 凭证。料进了仓库(借 库存商品 460),但没有任何一张单把它从仓库挪到工地
- 根因:收货只让料「从供应商搬到仓库」,资产还是资产。要领到工地才算项目成本。原链路把「入库」当成了终点,漏了「出库」
- 修:补一张领料出库单(借 合同履约成本 460 / 贷 库存商品 460),插在质检之后、收票之前。补完后库存清零、合同履约成本 460、毛利 64
- 教训:「账能不能自动出来」是检验链路完整性的最好尺子。页面画得再全,只要报表某一行永远出不来,就说明链路缺了一张单 —— 这个漏洞看单据流看不出来,一算账就暴露
发版前多了步 md5 对拍,救回 490 条产品规格
发版前把服务器上前后端每个文件的 md5 算成清单,跟本地逐一比对——而不是直接 rsync --delete。对出两个文件只存在于服务器、从未进过 Git:一份供应商价格表数据源(已补全过规格)、一张规格标签对照表(多 11 个键);旁边还躺着两个 .bak 和四个一次性修复脚本。
直接部署会怎样:用本地版覆盖后,490 条产品的结构化规格(显指 / 色温 / 尺寸 / 灯珠)静默退回旧版,官网规格区大面积空掉;65 条产品的「配件」标签全没;11 个标签消失、界面直接显示英文键名。而部署日志、健康检查、首页 200 全都会显示成功。
处置:线上版本取回入库(逐条确认仅线上多 490 条规格、少 9 条表格说明行);四个脚本原样存档并标「路径写死指向线上库,不要跑」,它们恰好解释了那批规格怎么补出来的。
两条教训:① 数据源与标签白名单只能改仓库,直接改线上会在下次部署时静默还原;② rsync --delete 前一步固定是 md5 对拍,不是可选项——健康检查只能告诉你「进程活着」,告诉不了你「数据还在」。
分支落后 168 个提交,代价是重做了 A1 三天前的活
- 今天上午从零查「100 个刚体堆 10 秒会倒」,花了 6 个假说。下午合并
origin/main时发现:A1 在 11-06 就提了N-153写了同一个病(“今天掉 22 个”、临界 7 层、与宽度无关),而我的分支落后 168 个提交,板子上没有它。 - 结论对上了,力气白花了。更贵的是:我一直把“板子上没有”当成“没发生”,而那其实是“我没拉到”。
- 可操作的规则:分支落后超过一周就先 merge,再判断“这事没人管”。合并本身有成本(
negotiation.md有冲突、需要脚本解析块来合),但比重复劳动便宜得多。 - 合并的副产品:发现 10 条我自己答复过却没改状态的条目(“谁答复谁改状态”没做到)——
watch.py一直在把 A3 列进「在等」,我的待办虚高 10 条。 - 合并还顺手纠正了 A1 的半个结论:他测的
20/10、40/20是把 velocity 与 position 一起提的,两半效果相反(velocity 提了变好、position 提了会崩)。同事报的“调更多没用”可能只是他的调法里有一项是负作用。 分开扫比信结论便宜。
- 今天上午从零查「100 个刚体堆 10 秒会倒」,花了 6 个假说。下午合并
「看着像就安一个教科书机制」是本项目最贵的错:它给出贵而不起作用的方案
- 背景:一个 10 层堆叠会倒。第一版没查数据,直接根据两个现象(塔倒 + 锁旋转就稳住)安了一个教科书机制(顺序求解净扭矩)。那个结论听起来专业、做起来很贵(3–5 人日)、而且做完不用验证就能交差——没人知道它本来就不该治这个病。
- 真实原因花了六次实验才找到:默认 8 轮迭代传不完 10 层串联接触。而
StepStats一直是pub的,里面有pairs/manifolds/normal_impulse。直接打印它,比猜六个机制的力气小一个量级。 - 具体判别读数:底层
vy在 8 轮下卡在 28px/s 不降、32 轮下三步收敛到 0。这个数比「塔倒了」有用一百倍——后者只能确认现象,前者能定位层。 - 一个现象能同时解释两条通路时,它不能当判据。 「锁旋转就不倒」看着像「所以是转动问题」,其实锁旋转同时把塔变成了只能竖直传力的质点链,同一病因换了表现。排除法要求“若否则大不同”,不是“如果像那就是”。
- 改之前先量。 「接触容差为 0 导致 chatter」听着很对,加上 0.5px 容差后:单列逐位无变化(说明从来不是瓶颈),10×10 直接爆到 41km(让并排箱子互相粘住)。一次都没量过的改动,很容易在不相关的场景里造成爆炸。
- 还得注意写文档的副作用:11-07 我把错结论写进了 CHANGELOG 和判据文件头,A1 会按它排期。错结论进了文档就会自己长腿跑。 定了之后要么第一时间通知,要么改成“待验”状态再写。
2026-11-08
移动端表格把中文压成一字一行,先别急着认定为横向溢出
现象:430px 宽下,订单表的客户名和「上门安装服务」被压成一字一行,右侧内容看着像被裁掉。
根因:
table没设最小宽度,浏览器按容器宽度硬分列;中文没有词边界不能断词,只能一个字一行。修法:760px 以下
table.tb设min-width: 820px、td.k设 132px,走横向滚动而不是压缩。820 不是拍的——先用探针量出max(各列最小可读宽)再加合。真正值得记的是怎么发现的:一开始靠截图目测,以为是横向溢出。用 DOM 探针实测才看清:无头 Chrome 的
--window-size=430实际innerWidth是 526,截图看着像被裁,探针报scrollWidth 485无溢出——问题根本不是溢出,是列宽不够。教训:窄屏判断一律用 DOM 探针(
clientWidth/scrollWidth/getComputedStyle),不要用截图目测。否则会去修一个不存在的 bug。
2026-11-07
容差按「结果的量级」算是错的:f32 相消会把 1e-5 顶到 3.5e-5
- 给
me-math写对 f64 的 10⁵ 组对拍时,第一版容差用1e-5 × |结果|,红了 6 条而没一条是真缺陷。 - 原因:
cross(a,b)在输入 ±1024 时是两个 1e6 量级的数相减得到 185,两个乘积各自的舍入误差就有1e6 × 6e-8 ≈ 0.06,相对 185 是 3.5e-5 —— 比 1e-5 大 3 倍多。那不是实现错,是 f32 的 24 位尾数在 185 这个量级上能给的全部。 - 正确写法:容差按各项绝对值之和算(
1e-5 × max(Σ|各项|, 1.0)),条件数进分母。相消表达式没有「相对结果」这个量级的保证。 - 同类的第二个错:测量穿透时第一版「只量竖直方向」。两个转 45° 的盒子并排,支撑半宽各 14.142、竖直方向相加得 28.28,报出「穿透 28.18px」——真实值是最紧那根轴上的 1.69px。方向对、量级错 17 倍,而它还是全场最大值,判据会踩着一个假数红/绿。得用真 SAT(四根面法线取最小重叠)。
- 教训是同一个:自己的测量代码也要有判据。
pair_penetration哪天悄悄返回 0,上面四条会永远绿。
- 给
S13 第 8–9 条补齐五件;顺带踩到「变异忘还原会让 git status 撒谎」
- 五件补齐(me-fx2d 判据 39 → 74):序列帧
flipbook.rs(帧号吃 age 不吃 progress,Hold 夹末帧,起始帧默认随机)、屏幕抖动shake.rs(幅度 = trauma²,按绝对时间算,零创伤精确 0)、混合批次blend.rs(给下标数组不重排粒子,稳定排序)、拖尾trail.rs(按 min_dist 过滤不按帧)、后效挂钩点Action::PostFx(只给数据,后处理管线不在 L5) - 演示覆盖 physics-lab 153/153 公开函数,四个 crate 的 FUNCTIONS.html 全部重生成
- 16 组变异逐组跑过,其中两组逼出「恒绿判据」:集成判据里粒子恰好本来就分组(改成交错发才抓得到)、
sort_unstable_by_key对 5 个元素恰好稳定(加到 500 个才打乱) - 最大的坑:这 16 组是手改手还原跑的,漏了两处在
apps/studio-shell/probe/src/(move_to少了self.anchor = None)。而本机.git/config的core.bare = true让需要工作区的命令报错、报错被管道吞掉、输出为空 —— 看起来工作区干净。于是下一轮全量 CI 红在三条「拖动锚没释放」的判据上,查了半轮才发现红是自己留的 - 教训:①
git status空输出不等于干净,先看退出码 ② 变异必须一条一条单独注 —— 两处合起来会互相掩盖(hit()兜底成恒Hit::Input就给「输入框内缩」兜住了,看起来像抓不到)③ 演练脚本化,还原不能靠记性 - 已落地:15 条变异收进
tools/ci/drill-fx.py(7 → 22 条),末尾加git diff --quiet核对(这条核对自己也证过会红) - 收尾:自绘壳八条通道 96 条判据全绿(--edit 31 / --smoke 17 / --hit 9 / --box 11 / --sel 7 / --keys 21)
- 五件补齐(me-fx2d 判据 39 → 74):序列帧
隐私政策写了 5 项没做的功能,属于描述不实
web/privacy.html里写了通知使用权、本地 VPN、悬浮窗、对话记录查看/删除、应用内申诉入口五项。- App 实际一个都没实现(v1 只有应用扫描、链接核验、专家对话、案例库、网页守护)。
- 这是「隐私政策描述不实」,不是文案小毛病——商店审核和备案都可能追问,且用户可据此投诉。
- 处置二选一:①把五项标注为「后续版本提供」(半小时,风险归零)②或真做出来。
- 建议先改文档。隐私政策只能滞后于实现,不能超前。
2026-10-31
官网 5 处事实错误:全部「看起来正常」,没有一处会报错
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
Last-Modified停在 10-10,下载页 10-13,这 21 天恰好是功能最密集的一段。 - 错处一(硬伤):4 个页面顶栏「Web 版」都链到
(内网地址):3000,而本机已在(内网地址)网段。对外站放局域网 IP 本身就是错的设计 —— 任何公网访客点了必然失败。已直接去掉该入口,下载页留「访问同一网络下的系统地址」说明。 - 错处二(数字):原写「¥0.003/次、日均 50 次、¥4.7/月」。10 月账本实测 3311 次 / ¥17.52,其中低谷 75%、高峰 25%:低谷中位 ¥0.0037、高峰 ¥0.0075、综合 ≈¥0.005;有活动的 10 天日均 326 次 ⇒ 月约 ¥50。把 ¥4.7 改成 ¥50 看起来是「把自己写贵了 10 倍」,但那是真实账单。
- 错处三:「4 品牌 5 设备」→ 实际 6 台(新增地下室 .20,车库换 .76)。错处四:下载页版本号与 SHA。错处五:about.html 正文有 Markdown 星号泄漏(
带价值判据的事件管道),页面会真显示**。 - 为什么这些能活 21 天:它们都是「看起来正常」的东西 —— 链接是蓝色的、数字是像模像样的、版本号也有。没有一处会报错,只会默默指向错的地方。
- 验收:4 页本地与线上字节逐一相等;从线上拉回 dmg 算 SHA-256 与页面标注一致;并给下载页做了强制显示副本截图,实测四张卡片底边与按钮对齐(macOS 描述原来多一行把按钮顶高 5px,已缩到同宽)。
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
车库子码流 H.265→H.264:406 拒绝才是重启的真凶
背景:6 台主码流全 H.265,子码流里只有车库(id=11,海康白牌 800x448)也是 H.265。flv.js 只认 codecId=7、ExoPlayer FlvExtractor 只认 AVC ⇒ 仅这一路在 Web/TV 黑屏。设备无配置入口,只能转码。
链路:cam_11_sub → h264_videotoolbox → cam_11_sub_h264;网关自动发现
_h264变体,三端零改动。实测 5.5% 单核(libx264 speed 0.855x 跟不上)、拉 10 秒得 151 帧且 time=10.11s。四个坑
- ffmpeg 8.1.1 没有
-rw_timeout(rc=8 秒退)⇒ rtsp demuxer 用-timeout(微秒) - 不加
-fps_mode passthrough⇒ ZLM 声明 fps=22(源 15)快放 1.47× stderr=PIPE只在退出时读 ⇒ 警告写满 64KB 阻塞转码(进程活、画面不动)- ffmpeg 被 kill 后 ZLM 不立刻释放发布者 ⇒ 重推同名流必吃
ANNOUNCE 406(rc=8)。正常退出不触发、像「随机偶发」。推流前close_streams force=1,黑屏 10~20s → 3s
两个假阴性:
launchctl list恒空 ≠ 未注册;grep -E "^\s+(state|pid) ="在 BSD grep 下\s不匹配,会误报「未注册」。自省:曾把 aliveSecond 很大当成僵尸源,踢了一个正出数据的流(speed 34KB/s)。判据应是
bytesSpeed>0。- ffmpeg 8.1.1 没有
`same` 那句是假话;深度第三次演练,红在了第 ① 条而不是第 ⑥ 条
- 一句写错的表头能存活很久:
compare.rs的表头原写「same只有几何/光栅规则不同时才会小于总数」。实测反例干净得刺眼——整块 R/B 互换(max_delta140、gross10000)与整块 alpha 差 1(max_delta1、gross0)给出分毫不差的same,覆盖与质心两条都是 0 差。same只说「全等/不全等」,它说不出差在哪。 - 同一张表里还有个不存在的名字:
off_by_more_than_8,真名叫gross。它在反引号里、不是 intra-doc 链接,rustdoc 一声不响——名字错从不报红,只会让读表的人去找一个不存在的字段。 compare一直是「间接使用」:被scenes/rules/mutations隔着「先画再判」用到,所以「这张表里写错一句,没有任何东西会红」。这一轮才给它补上它自己的第一批判据(tests/compare.rs)。- 第三次真机演练,期望与结果错位:把
clear_depth: Some(1.0)改成None(不清深度),指望第 ⑥ 条的四把尺子发声,红的是第 ① 条——预热的z=0.05把后面四遍全拒了,四张对照图「深度开」的两张变整屏清屏色,尺子那四列也一律是清屏色(它们量的是同一个已经被拒的缓冲)。所以写进文档的是分工而不是新判据:尺子管「z 落在哪儿」,清屏本身失效归预热管。「四把尺子全绿」不该被读成「深度这一整套没问题」。 - 另一条演练是对的方向:HLSL 的
z改成0.5*z+0.25→ 前四列一个字节没变、尺子列[清屏色][清屏色][红][红],红在「第 ⑥ 条·尺子 2(清屏深度 0.25):近的独占区 280,300 应当是 [220,40,40,255],实际 [16,18,22,255]」。 - 「抓不到」这句话必须配一个真能跑的反例。模块头从上一轮起就写着「两点之间的曲线形状抓不到」,但没有可执行的映射。这一轮补上
t²幂次重映射(端点不动 ⇒ 四张图与四把尺子逐字节相同 ⇒ 判据全绿)——证明的是信息量不够,不是判据写得不好;同时钉住补法(多一块z=0.5的矩形 + 一把清屏0.5−ε,两支当场分开)。
- 一句写错的表头能存活很久:
30 条变异扫描:6 条改错没人响,全是同一类 —— 判据被调钝或干脆被蕴含
把问法从「判据绿不绿」换成「这一行改错了,有没有东西会响」,对
me-compare做了 30 条手工变异(每条改一处、跑全组测试):深度 16 条、compare8 条、judge6 条。24 条当场被抓住,6 条存活——而存活的 6 条是同一类。- 被完全蕴含的判据是死门。深度第 ⑥ 条原来只有一把清屏 0.5 的尺子,而它被「清屏 0.75−ε」那把完全蕴含(凡过后者必过前者)——它永远不会是红的那一条,却让读报文的人以为「这一档通过了」是额外信息。换成四把(
f(0.25)与f(0.75)的上下界)之后,上一轮写进「抓不到」的窄带重映射f(z)=0.5z+0.25当场被抓出来。ε 是两头夹出来的:1e-4 × 2^24 ≈ 1677档,量化翻不了「低于」。 - 容差本身就是判据。
half.max_cover_dev0.0→0.01、half.max_centroid1.5→15、srgb.max_deltaSome(1)→Some(3)三条全部存活:报文照旧绿、结论照旧「通过」,只是能抓的错少一档。其中 0.0 那条是「整行漂移」的唯一探针(一行几百像素,比例远在 4% 以内、质心只偏 1px,另两条容差都放过它)。 - 只在真机腿被验的那一行,等于没被
cargo test验。GLSL 里a_pos.z * 2.0 - 1.0(窗口深度 ↔ NDC)被删掉,30 条里没人响——因为这一行只在浏览器里跑得到,而真机腿在没装 Chrome 的机器上会降级成「本轮没跑」。补了一条文本代理测试,注释里写清它挡不住什么(写成2.0*(z-0.5)就抓不到)。 - 还有两条更朴素的:
is_bg只比 RGB(alpha 不参与背景判定)、差异图把差异处标成黑而不是纯红——前者让覆盖数与质心的语义悄悄变味,后者让一张全黑的差异图被读成「没有差异」,而报文里明明写着「差 57600 个像素」。
共补 6 条判据,每条都把对应的错真做出来看它红,再还原。工具在
tools/ci/sweep_mutants.py(手动、不进 CI:一轮八到十分钟,push 每次多等八分钟的结果一定是有人开始绕过钩子)。教训一句话:「绿着」只说明当前代码没有这些缺陷,不说明判据挡得住下一版。
- 被完全蕴含的判据是死门。深度第 ⑥ 条原来只有一把清屏 0.5 的尺子,而它被「清屏 0.75−ε」那把完全蕴含(凡过后者必过前者)——它永远不会是红的那一条,却让读报文的人以为「这一档通过了」是额外信息。换成四把(
一句没核实过的理由挡住了正确改动整整五版;一条从 v21 起就走不到的分支没人验过
- v21 拒绝换掉
format里0的含义,理由写得像回事:「RGBA8 layer 不被支持,所以把 0 读成 RGBA8 在 Metal 上就是静默降级」。后半句没人量过。 v26 拿同一个CAMetalLayer、只换pixelFormat跑了三次:80 / 70 / 115 都能拿到 drawable 且texture.pixelFormat回读一致 ⇒ 那个理由不成立,而它挡住了一个正确的改动五版。 - 反向对照(
R8Unorm/B5G6R5/Depth32Float)不是「返回错误」,而是
*** Terminating app due to uncaught exception 'CAMetalLayerInvalid', reason: 'invalid pixel format 40'setPixelFormat:抛 ObjC 异常,跨 FFI 进 Rust 是 UB,表现是进程直接终止(整个测试二进制没了)。所以surface_format()那个穷举白名单不是「顺手校验一下」,它是防止进程被杀的那道墙:加格式值必须有实测记录,不许看文档像支持就加。- 另一条同族的:
acquire_frame里「读到pixelFormat == 70就报TEX_RGBA8且把me_frame.flags位 0 归零」从 v21 到 v25 永远走不到(没有任何输入能把图层设成 80 以外),而同期所有测试都是绿的。v26 换掉0的含义之后它第一次可达,判据当场能分辨真假。 - 读数法:见到
if x == 某个常量的分支,先问「什么路径能把x变成那个值」;答不出来就该怀疑它是装饰,而不是去给它写注释。
- v21 拒绝换掉
2026-10-30
「AppID 无效」是假象:109 其实是 token 过期,且有过 24 小时首次使用窗口
- 现象:语音可以跳转,但入会失败,界面上写「AppID 无效」。参数一字未改,两端同时挂。
- 真因:声网返回的是
109,含义是 Token 已过期;我们自己的errHint()把 109 写成了「AppID 无效」,把排查带偏了。官方对照:101 = AppID 无效,109 = Token 过期,110 = Token 无效(与频道 / uid 不匹配)。 - 更关键的冷知识:烤进 APK 的 token 有 24 小时首次使用窗口——生成后 24 小时内没被任何设备用过就作废,与
gen_token.sh里设的 7 天expire是两件事。所以「装完放两天的设备一开就挂」是必然。 - 修:错误文案按官方重写;token 改服务端现签。
- 同时发现
channel字段不复位:传过一次 channel 后不传仍沿用旧频道,INV发出去rc=-2,对端永远收不到 → 改成没带 channel 就回默认频道,实测错频道失败后紧接着调起能 381ms 入会。
2026-10-27
通知权限未声明,告警通道静默失效
- Android 13 起通知默认关闭,不声明 POST_NOTIFICATIONS 就一条也发不出去。
- 真机实测(小米 2509FPN0BC / Android 16):
cmd appops get ... POST_NOTIFICATION返回ignore,而grep -c POST_NOTIFICATIONS AndroidManifest.xml是 0——连权限都没声明。 - 最坑的是界面上完全看不出来「提醒已经断了」,属于静默失效。
- 已修:manifest 声明 + 开屏用
ActivityResultContracts请求 + 拿没拿到都立即上报心跳;加了 debug 探针am broadcast -a cn.yueju.antifraud.PROBE。 - 修后验证:
dumpsys notification --noredact能看到id=1001 importance=4 channel=guard_alert。 - 教训:告警通道必须能被观测到「没发出去」,不能只验证「发得出去」。
压力关第一次上真机:揪出「整页中文变白块」,并拿到真实的 draw call 代价
- 白块的根因在压力关自己:
StressScene::new忘了上传字体图集,而TextStyle的默认纹理号是0(游戏把图集传到 0,压力关的精灵从 100 起)⇒ 800 个字形矩形全部采样到一张不存在的贴图,GPU 给纯白。数字全对(批次 401 / 顶点 4800 / 字形 800),所以 8 条数字判据一条都没红;第一张肉眼截图恰好在「纯静态」档(无文字)。 - 修法与判据:显式
TEX_FONT+ 建场景时上传 + 标签TextStyle写明纹理号;新增 2 条判据(图集尺寸必须落在 sink 里 / 每条标签的纹理必须已登记),反向验证去掉上传即红。 - 真机代价(TCL / MT5879 / 1920×1080):3000 精灵时六纹理档 3001 批 → cpu p50 24ms、帧间隔 33.3ms、36.9fps;同一画面单图集 2 批 → 15.4ms / 52fps,批优先 7 批 → 14.3ms / 53.9fps,纯静态 1 批 → 7.9ms / 61fps。3001 次 draw call 比 7 次多花约 9ms/帧,且是四档里唯一掉出 60fps 的。
- 真机没有 CDP ⇒ 压力页加了
?auto=1自跑自报(逐格 POST 到 serve.py 的/verdict),并写了run-phone.sh一键跑。路上踩到:why字段被截 64 字符(四档拼一行必丢后两档)、am start -d url在浏览器进程活着时会把 URL 丢掉(Status: ok照样返回)、设备护眼卫士连续 20 分钟弹全屏遮罩。 - 未完成:小米那台锁屏,PIN 不在手上,手机侧数据待补;三档精灵数全扫被遮罩打断,数据分两次采集。
- 白块的根因在压力关自己:
一次页面离开产生 3 条 page_leave,停留时长虚高 3 倍
- 用真实浏览器实测:1 个 page_view 对应 3 个 page_leave,时长分别 2466 / 2482 / 2482ms
- 原因:Web 端同时监听了 pagehide、beforeunload、visibilitychange 三个事件,关页面时三个连续触发同一个回调,而结算函数没有幂等保护
- 后果比数字难看:页面停留样本量、会话时长、停留直方图的计数全部虚高 3 倍。这种错不报错、不崩溃,报表看起来完全正常,只是每个数都错了
- 修法:幂等锁加在核心层而不是适配层 —— 因为原生端有一模一样的问题(Android 的 onPause + onStop、iOS 的 viewWillDisappear + didEnterBackground 都是连续两个回调),一处修全部端
- 一个细节:短停留(低于最短停留阈值)既不结算也不上锁,留给下一次离开机会 —— 用户可能只是短暂切到后台又回来
- 修完复验:1 个 page_view → 1 个 page_leave
- 这类 bug 的特点:不会有人报障,因为界面全部正常,只是分母比分子胖了三倍
2026-10-26
踩坑合集:Gradle 缺 .ok 标记、代理环境变量、UTF-16-LE 搜中文
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
(本机路径)里只有 zip 和解压目录、缺.ok完成标记,Gradle 每次都重新下载 234MB。touch .../gradle-9.3.1-all.zip.ok解决。千万不要把 distributionUrl 换成镜像 —— 目录名是 URL 的哈希,换了等于重新下载。 flutter test/flutter run报 Invalid WebSocket upgrade:本机HTTP_PROXY=127.0.0.1:51582干扰。必须env -u HTTP_PROXY -u HTTPS_PROXY ... NO_PROXY=127.0.0.1。flutter build apk报 Unable to locate a Java Runtime:要显式JAVA_HOME=(服务器路径)。- 无头 Chrome 一启动就 FATAL(GPU process isn't usable):必须
--no-sandbox --disable-gpu --disable-dev-shm-usage。 - release web 包里的中文搜不到:被编译成
\uXXXX转义,直接 grep 中文字符串一定是 0;APK 里libapp.so则是 UTF-16-LE。两者都要编成对应形式再查。 - 设计稿全局样式会泄漏:
a { border-bottom }把侧边导航也画上了下划线,看起来像分隔线错位。 - 8GB M1 同时跑无头浏览器 + web 编译:load average 能上 30,编译从 70s 拖到 5 分钟以上;先关浏览器再编译。
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
看板重核:10 处失真已修,其中一处是我自己刚犯的 —— 分支的工程量不是发布基线
用户让「更新一下项目看板和项目管理平台」。云端的 49 号项目板是手工同步的(它自己第 ⑩ 条就写着「腐坏时不报错」),所以这次先量后改。
第一版改错了,值得原样记下来:我按工作区(A2 分支)跑 --scale 读出「743 个文件 / 218,103 行 / 47 完成」,就照这个数写进了 description 与 notes。写完之后
git fetch origin main—— main 已经到 53 完成 / 46%,同一句 --scale 在 main 上是 747 / 216,978。差 3.9 万行不是谁算错了,是 A2 握着 39 笔未合并提交。分支的工程量与完成度都不是发布基线,整段重做。用了git worktree add把 origin/main 检出到临时目录里跑 --scale,这样既不碰工作区,也不用手工 checkout。这次修掉的 10 处(每处都有「旧值 → 新值」):工程量 598/178,031 → 747/216,978(差 3.9 万行 / 149 文件)· crate 15 → 14 · 契约 15 → 16 · docs 37 → 35 篇 · 测试 1464 → 1669(main 侧;A2 当轮 1700,两个口径都写进板上)· CI 降级「4 项」→ 当轮实测 2 项(另两项只在非 Mac 宿主上降级,4 项是跨机器并集)· 进度 182/433·51 任务 → 201/433·53 任务 · extras 52 → 48 · wip 名单整份过期(板上写的 5 条只有 S6-8 还在,实际是 S7-4 / S3-9 / S6-8 / S3-8 / S5-6 / S8-4)· 分支口径从没写过。
顺手补的一条结构性事实:A2 分支上根本生成不出一份合法看板 —— main 版 board.json 里 S1-10 的证据路径
tools/doc/gen_mir_manual.py与 S5-6 的crates/me-cli/tests/provenance_ledger.rs在这条分支上都不存在,拷过来跑 --check 直接红两条。所以「看板页在哪条分支上生成」不是风格问题。仓库侧:
plan/board.json只加了两处(S3-7 的 why 从一句扩成五处取舍 —— 中文 1 位点阵 / 单图集槽位 / 度量必须与真正画的字体一致 / 对白字幕条 16.2:1 / 生成物与 rustfmt 打架;extras 48 → 49 记关卡文本压着进包)。没有提交 site/board/index.html:A2 生成出来是 47 完成,合并时要么冲突要么把 53 退回 47,页面留给合并后在 main 上重建(已在协同区 ask A1)。另一个自找的坑:
say.py --body "…\n…"走 bash 双引号时\n是字面两个字符,argparse 收到不是换行,于是整段挤成一行、还带着字面的 \n。已经用 Python 把那两条流水的正文改成真换行,教训写进记忆:多段正文用 heredoc,不用双引号。数字核对过两遍(
get_project读回:wip 六条编号逐个对、46% = 201/433、747/216,978、1669 测试、extras 48)。点阵收字改成走词法:续行不再静默丢字,代价 8 292 字节
上一笔的包体腾挪收尾后接着查了一个更深的坑:点阵收字的扫描器靠正则猜「哪些字在字符串字面量里」,两处近似都在打这个判断的主意 —— ① 正则里「反斜杠 + 任意字符」在非 DOTALL 下不匹配「反斜杠 + 换行」,于是任何一处续行都让它后面的引号配对整体错位一格,哪些字被收进来变成靠运气(我这次写了一句续行断言消息,点阵从 459 字静默掉到 407 字);② 旧版只丢「整行以斜杠斜杠开头」的行,行尾注释里的字被烘进表(实测 14 个:倾双弓抱拳掌推握横步独立膝马,逐条核过,全部只出现在注释里,一个都不在字面量中)。
改成走一遍 Rust 词法:引号起头就找配对的引号(反斜杠连下一个字符一起吃掉,续行就这样被消化),行注释到行尾、块注释整块跳过。注释的判定变成「在不在字面量里」,不再有两种互相矛盾的近似。
成本:+8 292 字节,wasm 724.1 → 732.2 KB,余量 75.9 → 67.8 KB。569 字(原 465):多烘 118 个(几乎全是测试断言的消息,永不上屏)、少收 14 个注释字。不省这 8 KB 是有意的 —— 要省就得让扫描器区分测试模块与生产代码,切错了是静默漏字,等于拿字节换一种新的静默失败。
顺手纠正半个自己的判断:原以为 BakeReport.missing 没人断言是个缺口,查下去发现它是「恒为 0」——建局时把整个 GLYPHS 表喂给烘图集,missing 在数学上永远是 0,加断言只能测出「表为空」,是装饰。真正的残留风险只有一条:上屏中文若写在扫描列表之外的新模块里,字永远进不了表,而生成物自检也不会红(它只比「表与那三份源是否同步」)。修法是让扫描列表变 glob,代价多烘一批错误消息里的字(估 8~16 KB),余量刚花掉 8 KB,先记着不动。
数字:me-render 206 passed · me-runtime 424 passed · 离屏判据全绿(SWITCH 12/12,逐关币数与改前一致)· CI 通过 250s · 2 项降级。
巡逻怪锚点判据 + 复核对方的取景纠错 + 两轮假红的真因
- 巡逻怪也有锚点判据(反向:纸白 ≤45%)。实测 0.047,左侧对照 1.000(21.3×);怪消失时 0.993 ⇒ 真红。
- 争议点已复核:另一会话指出我的取景框里 43% 是玩家(相机跟玩家 ⇒ 玩家屏幕位置固定),认。但它说「旧取景该红时不红」我量不出来:旧取景怪消失时 0.793,照样红。结论换取景不变,理由改成「判据有一部分在量玩家」。
- 顺手把四条锚点帧全审了:只有巡逻怪那帧被玩家污染过;门那帧两种 warp 下暗占比都是 0.424(玩家被门遮住),尖刺/平台纵向不重叠。
- 今晚两轮假红是我自己造成的:同一棵树上还有另一会话,抢 target/。症状是「红的步骤每次不一样」,认它要看 git status 里有没有不是自己的文件。
- 另一会话正把 SWITCH-MANUAL 降级换成真跑(headless+swiftshader,72/72,6.4s)—— 我当初那条降级理由(沙箱 GPU SIGTRAP)指的是 GUI Chrome,不适用于 headless。
「没命中」被读成「不存在」:D-04 的探针写错,结论反了
- 技术债表里
D-04一直挂「待重测」。原因是我 grep 单行找ops.iter().find没命中,据此判成「代码不存在」,还在表里写「Ctx根本没有ops字段」。 - 真实代码是三行写的,且挂在
LegalizeReport(frame.rs:255)不是Ctx。「没命中」被读成「不存在」:git grep逐行匹配而代码是分行写的;当工具表达不了一种形态,人只能用更弱的探针凑,再用弱探针的结果下强结论。 - 修法不是「下次仔细点」,是给工具加那种形态:
check_debt_baseline.py新增第三种探针text(全文正则 +re.S,能跨行匹配;对排版不敏感、对结构敏感)+label字段(报格里印人话而不是正则)。 - 量到的三个数:0.017(小图)/ 0.455(26.8×)/ 48.006ms(105.5×)。真凶是
op_of在Facts::scan的双重循环里逐节点调用,修法是HashMap查表,已提N-310。 - 体检结论也跟着纠正:11 条里 5 条主干真实(
D-04、D-07~D-10)、4 条分支特有、2 已消、「待重测」那格现在是空的。 - 又踩了另一个坑,同一个晚上第二次:变异测试五个全红,但实际是我改出来的代码有
SyntaxError(global BASELINE的位置非法),一次都没跑起来。变异测试自己也要核验「红的原因」——红得对但红错了原因,比不红更危险,因为它给的是「已验证」的错觉。 - 探针的三种形态现在都验过:分行命中、压成单行仍命中、换
HashMap转 absent。成本最高的一条教训写进了plan/debt-baseline.json头部的$comment。
- 技术债表里
Gate 0 第一版报 8.3%,真实 36.7%:写防自欺的那一页时先自欺了一次
- 做 Gate 0 六项仪表盘,M2 包体那一项第一版报 349,848 B(8.3%)。读数很漂亮,问题是它是假的。
- 它读的是
dist/pack.json——一份.gitignore的本地生成物,比源码旧两天。重跑me pack后真实值是 1.47MB(36.7%),差 4 倍。 - 难受的一点在哪儿:
pack.json就在磁盘上、schema 对、字段全、解析不报错。它是一条「看起来完全正常」的陈旧数据。CI 不看它,所以它永远不会红。 - 改法不是「下次记得重跑」,是换掉获取方式:现算
me pack <dir> --check --json(零写盘),只在找不到me时才降级读账本,且必须比对 mtime 并在结论里明说「可能过期」。 - 另一条自己定的规矩:不要用自己写的第二份实现去量体积。第一版想过自己 walk 目录加总和——那就是第二份实现,两边差 1KB 时没人分得出谁对(之前已经栽过一次 190 vs 189KB)。调
me pack是复用唯一实现。 - 六项的实际状态(写这一页的收获):2 项通过(包体 7.7% / 零手写 GLSL)、1 项有数但答不了(本机 Iris Xe 核显 p95 0.41ms,达标但机型不是低端安卓 ⇒ 报 unknown 而不是 pass)、3 项缺证据(尚未上线,所以没有真实数据)。四态是刻意的:pass / fail / unknown / gap,后两态都不算通过。
- 仪表盘 恒 exit 0:还没到 W26 就长期红着的门,等于没有门。它只回答「现在有什么数」,不负责拦人。
- 底层那条教训:「缺证据」不允许被折叠成「待定」——Go/No-Go 里没有第三种答案,把 gap 写成「大概没问题」是这个门最容易的作弊方式。
主包 1.47MB 里 71% 是演示页素材,而演示页根本不在包里
- Gate 0 的包体那项一直报「通过,但 71% 是一个演示素材目录」。查到底,结论有点荒唐:页被剔除了,页的素材留在了包里。
- 上传白名单按后缀拦(
.html进不去),所以me pack每次都把wushu.html剔掉并打一条警告;但它引用的wushu/那 1.06MB 序列帧、nav.js按后缀是白名单内的,于是照旧进包——而包里没有任何代码会去读它(读它的那个页面自己没进包)。 - 改法两行:
apps/coin-run/project.config.json的packOptions.ignore加folder wushu+file nav.js。主包 1,539,020 B(36.7%)→ 426,914 B(10.2%),进包文件 18 → 9;装 binaryen 后wasm-opt -Oz真的跑起来,再降到 321,975 B(7.7%)。 - 根因不是粗心,是判据的形状:按后缀的剔除表天生不知道「谁引用谁」。这类残留不会让任何检查变红——包能上传、游戏能跑,只是白背 1MB。以后新增演示页,要连素材一起登记。
- 对外一个页面都没少:可试玩页
web/play/coin-run/只有index.html+wasm/,演示页从来不在它里面(本地serve.sh直接读源目录,不经dist/)。去掉的是只有上传包才背的那 1MB。 - 顺手改掉一处写死的建议:排除之后大头变成
wasm/(71%),而 Gate 0 页里那句「拆分包第一候选」对 wasm 是做不到的建议(分包只切内容)。现在按归因分支——大头是wasm//js/时说「再降只能靠压缩」(S8-1 纹理 / S8-2 wasm),否则才说「拆分包」。一条写死的建议,会在它描述的事实变化后继续以同样自信的语气出现。 - 另一条顺带确认的假设:
me pack --check不写盘,所以 CI 跑一百遍dist/也不会更新——本地dist/当晚仍是含 wushu 的旧产物,已重建。
2026-10-25
项目板全量重核:8 处陈述已和仓库不符,而它腐坏时不报错
做了什么:把项目板(id=49)的 description 与 notes 逐项对了一遍仓库,不是只改个百分比。目的是找出「哪几句已经不真了」。
查出 8 处过时,每一处都是静默的:工程量 383 文件/96,136 行 → 591/169,253(标签写「10-24 快照」却贴着 10-22 的数,一天之内看上去完全正常);crate 13→14(me-cooked);契约 13→14 份(rhi.ffi.h 已 v6,板上还写 v4);测试 790→1331;CI 17 步→33 步 144s;ADR-001/008 已 Accepted 3-4 天而板上仍写 Proposed/待裁决;D0 6/6、M0.2 4/4 已收口而板上还写 4/6、2/4;me pack 早已实装(dist/ + pack.json + 四档预算 + exit 70 自校验)而板上写「仍是占位」。
同步结果:进度 32%→33%(141/433 人日、37/110 任务),与 /arch/ 与 /board/ 同值;wip 3 条→4 条并逐条重写「还差什么」(S2-4 差图集分配等 S3-6、S2-9 基准 0/3、S3-8 只差真机手指、S6-8 已拆掉包体分析)。
为什么能腐到这程度:本板是手工同步的——CI 跑 33 步没有一步看它,它不会变红也不会变旧,只会静静地看上去「正常」。
改法(不是「下次注意」):notes 加前置纪律「快照日期必须与数字同时取,更新前先跑
--scale,不许贴上次的值」;已知缺口新增第 ⑩ 条,把「手工同步、腐坏不报错」写成显式缺口;D0 标题里的 FFI 数字换成当轮 CI 实测 12.34/10.34/11.23 ns(旧值 8.4/9.5/11.4 不写日期就会被当成当前值,相差 47%)。顺带修正我自己写错的两处:ADR 段初稿写「002-0006 一系列已接受」,而 ADR-002(wasm-first)恰好是仍悬着的两份之一;另,
ADR-001…008与ADR-0002…0012是两套并存编号,光看号分不出哪套。证据:
build_board.py --scale·/tmp/ci-1025.log(33 步/144s/1331 测试)·interface/MANIFEST.json(14 份)·crates/me-cli/src/pack.rs(83KB)· commit65ffbe4
2026-10-23
陷阱:基线不能取「上一次构建的产物」
- 问题:看板要标「哪些变了」,就要知道「上次发布的是哪一版」。第一版设计里我把基线取成「上一次构建的产物」——听起来合理,因为它代表「上次部署到线上的那一页」。
- 它错在哪里:产物会被本地预览反复重写。为了看一眼效果建两次,第二次算出来的变化集就是空的,然后发版把线上的绿点覆盖成一片平静。一次预览就吃掉了真正的更新,而没有任何东西会报这件事——页面里一个字都不会提示「基线丢了」。
- 修正:基线落在仓库文件
plan/board.revs.json(生成物),由 site.sh 在 rsync + 冒烟 + 逐文件哈希全部成功之后调--publish前移。 - 为什么必须在成功之后:失败也写,就会把没发出去的内容记成「已发布」,那批改动从此不再标绿。漏标比重复标危险得多——重复只是烦一下,漏了是永远的沉默。所以这一步自身失败也不阻断发版结果(页面确实发出去了),只打一行警告。
- 没有基线时退到 git:「不 dirty 用 H^、dirty 用 HEAD」。但它只覆盖「最后一次改 board.json 的提交」,不是「上次发布以来的全部变化」——所以它是过渡退路,不是常规路径。
- 一句话结论:「上次构建」和「上次发布」不是一回事,把两者当成一回事的代价,是静默地少报。
陷阱:HTTP 200 不等于「这一次的内容」
- 事实:22:54 那次发版,冒烟 7 条路径全 200,脚本打印「完成」。半小时后核对,线上
/board/是一次更旧的构建:行尾 CRLF、任务清单少了「在写」两条、工程量还是旧数字。 - 写入者没定位到:同一份工作区里有另一个会话在并行提交+发版;SSH 只有一个 key(本机)一个 IP,不是外部入侵。但结论与写入者无关:
HTTP 200只回答“这个路径有东西”。 - 这是同一族的第二次:上一次是
/board/404 而脚本说完成(没有校验对象,因为清单是手写的);这一次是校验对象太弱(只看状态码)。 - 改法:
tools/deploy/site.sh新增「内容校验」——本地 site/ 每个文件的 md5 == 远端同一文件的 md5,不一致就打印 diff 并 exit 1。三条不许退化的判据:本地为空 / md5 缺失 / 远端取不到,各自单独报错(否则“两边都是空”会被当成相等,这是最便宜的假绿灯)。 - 演练:远端注入一行 + 把 rsync 换成空转 shim → 红并点名 index.html;撤销后 7 个文件逐个哈希相等。
- 额外发现:同一个 nginx 根下可能有两份不同的「同一个工程」产物在互相覆盖——两个会话、一份工作区,发版前不必先打协议,但发版后必须验哈希。
- 事实:22:54 那次发版,冒烟 7 条路径全 200,脚本打印「完成」。半小时后核对,线上
四个坑:--done 重排 361 行 / 双开遇 UU 别动 / 渐变背景的对比度假阳性 / 全角括号吃变量
- 工程量(本次):378 个文件 / 92,592 行(源码 54,255 · 文档 13,106 · 脚本与配置 25,231),44 个二进制资产。
- 坑一:
--done把整个 board.json 重排。 它用json.dumps(indent=2)写回,于是「加一条任务」的 diff 是 +361/−90,真正的改动淹在重排里。那种 diff 没有人真的 review,而「没人 review 的 diff」正是这个账本想避免的。修法:按手写排版序列化,只对两类短结构内联(ev 字符串数组、{text,done} 判据),内联与否按显示宽度 ≤130 列判(用 len() 会把一行 90 个汉字当 90 列,实际 180 列)。判据是一条 round-trip 断言:dump(load(文件)) == 文件字节,当前逐字节相同;并且--check也守它,不一致就提示跑--fmt。改完同一个操作的 diff 是 +4 行。 - 坑二:双开时不要抢着解冲突。 我跑 CI 的时候,另一个会话在同一工作区开始了 merge,
git status出现UU tools/ci/cross-sector.txt。我读了那处冲突就退出去了——它不属于我这一笔,动它只会让两边的解决互相覆盖。判据:看到 UU 就别写文件,等对方收口。 - 坑三:对比度脚本在渐变背景上会造假阳性。 实测
.gauge-cap报 1.92:1,实际是深色 hero 渐变上的浅灰字(约 8:1)。因为backgroundColor是透明的,脚本一路走到 body 白底去算。背景是渐变时,computed backgroundColor 不可信。 - 坑四:
$code(…又被自己的 CI 抓了一次。 变量后紧跟全角括号,bash 3.2 会把它当变量名的一部分。七小时前刚在 cross-sector.txt 里记过同一类错误,还是手滑了——这类规则不能靠记性,只能靠检查器。
今天踩的五个坑:都是「没东西会因为你做错而变红」的那一类
今天这一轮全部是「工具没报错、但结果不对」的类型,共同特征是没有任何东西会因为你做错了而变红。
- 同一目录开两个会写代码的会话 = 编辑会静默丢失:4 次编辑都报成功,
git diff只剩最后 24 行;另一会话在期间做了 3 次 merge 并git stash了我的改动。对策:不再在同一目录双开写代码;必须改多文件时用 Python 脚本原子写盘,且每个锚点都assert count == 1。 git merge报Already up to date是假成功:本地agent/A3停在一周前的提交,merge 一句话就把人骗了。唯一判据是git log --oneline origin/main..origin/<branch>有东西。同理:本地grep是 toybox shim,grep -o '[0-9]*'多字节下返回空、-Eo '[0-9]+'正常。- 100% 误报的检查会马上被关掉,然后连真问题一起忽略:
check_coverage首版用绝对路径比相对路径,报出「全部文档未登记」;改成relative_to(ROOT).as_posix()才是真值 1 处。 - 误报率 5/6 的检查不能上线:试扫 docs 里 44 个代码路径引用,6 处「不存在」只有 1 处是真问题——那 1 处人工看,不上检查。
- 缺席的契约比写错的更隐蔽:
docs/qa/diagnostics-review.md写着「归 A1:建interface/diag.codes.md」,而这个文件从未存在,me-cli 已经在用它。写错的会红,缺席的不会。 - 一类 bug 只有截图看得见:既不溢出也不重叠、对比度全绿,但文字被 flex 压成竖排;或
[hidden]被display:grid顶掉导致同一栏冒出两倍的卡。能自动量的量一遍,量不到的必须看一眼,两者不是替代关系。
- 同一目录开两个会写代码的会话 = 编辑会静默丢失:4 次编辑都报成功,
2026-10-22
性能门禁 25% 概率假失败,问题不在代码在测量
- 同一份没改过的代码,四次跑出 5.01 / 7.39 / 4.22 / 14.91ms,阈值 10ms —— 有一次直接判红
- 三个原因叠在一起:
① 单轮 500 样本算 P99 只有 5 个数据点,基本被操作系统调度主导
② 测量顶着上一轮自己造的队列积压(落盘上限约 750 行/秒,而压测远高于此)
③ 存储域懒加载,第一次写入把编译开销也算进了延迟
- 修法:三轮取中位、新增「服务端 handler P99 < 5ms」第二阈值、每轮前等队列排空、启动预热。连跑三次 5.51 / 4.31 / 4.09ms 稳定通过
- 教训:一个会随机报错的门禁比没有门禁更糟 —— 它教会所有人忽略红灯
- 同族的另一条:开着一个副本服务和浏览器时测出 9.4ms 贴着阈值,清场后立刻回到 4.5ms。看性能数字之前先看环境干不干净,否则测的是「谁在抢 CPU」
2026-10-20
踩坑:跨库搬产品图不能按 id 搬,要按「供应商+型号+名称」反查
跨库搬产品图时把
product_images.product_id直接搬过去,会把图挂到隔壁产品上。- 本地库与线上库的
products.id并不一一对应:同一批供应商在不同时间导入,id 段整体偏移(这次差 7 条),4283 条里有 3190 条的 id 对不上。 - 正确做法:按「供应商 + 型号 + 名称」的交集反查目标库的行;同名多行按产品 id 顺序一一配对。只按名称会命中重复,只按型号会命中同款四色,交集才唯一。
- 动手前先跑映射预演,并核对一件事:
原有覆盖是否被新覆盖完全包含。这次原有覆盖 369 个产品、新覆盖 668 个、原有而新缺失 0 个,才落库。 - 第二个坑:
product_images.created_at是 NOT NULL 且没有默认值,手写 INSERT 必须显式补时间戳 —— 否则抛 IntegrityError,而delete已经在同一事务里执行过,看着很像「数据已经没了」(实际会回滚)。 - 第三个坑:先传了图片文件、后补数据库记录,中间跑了一次审查脚本,被判成「233 条没有产品图」—— 审查脚本查的是
product_images表,不是文件系统。文件和记录要一起到位再跑审查。
- 本地库与线上库的
华为只保留 184 个应用中 70 个使用记录
真机上「僵尸应用 0 个」,一开始当成是逻辑 bug。查下来是系统在裁剪数据:
dumpsys usagestats里这台华为只保留了 184 个应用中的 70 个的使用记录,其余应用不是「没用过」,而是「系统把记录扔了」。这直接影响措辞和归类。改成:
- 有确切打开记录的才叫「90 天没打开」
- 查不到记录的归「系统没留记录」,副标题写明「不等于没用过」
- 覆盖不足时默认只展开 8 行(
DORMANT_PREVIEW = 8),不让一屏陌生名字堆在面前 - 该分组不算进「建议卸载」的推荐量,只作为参考
教训:“我没查到”不等于“不存在”。在别人的 ROM 上做判断,先弄清楚它愿意给我们看多少。
「能打断」不能听 HAL 声明:三层探测才问得出真话
- AcousticEchoCanceler.isAvailable() 只是厂商 HAL 的声明,不等于这条录音真的有回声消除。真判据是 create(sessionId) 成功且 getEnabled() 为真,而且必须在 startRecording 之前 enable——启动后再挂上去,HAL 已经按无 AEC 的路径把管道建好了。
- 最终还要看运行时:播报期间跟踪「自己说话时麦克风里还剩多少」。AEC 有效时残余只有几十,人声 300+ 立刻超线;无效时基线被抬到上千,人声压不过它,于是自动退化成「打不断」(连续 1.6 秒残余超过 1600 直接判定 AEC 是摆设并关麦)。
- 于是按能力分档而不是按机型写死:有 AEC 的电视边说边听,说话即打断;没有的退回半双工,播报时关麦。家里四台电视装同一个包,不用改配置。
- 遥控器语音键(219/231)根本到不了 App:在 framework 层被厂商语音助手吃掉,日志里连 key= 都没有,同一时刻发 OK 键(23)正常记录。所以半双工机器的打断入口是「OK=打断并聆听、BACK=只停播报」,播报时界面上直接写「按 OK 打断」,否则这能力等于不存在。
- 打断不能借用「停播报」那条路:它会把会话状态一起清掉,用户刚开口就被踢出对话。只停播放器、保留会话,也不清预录缓冲——开口那几百毫秒正好补回来。
- 顺带修掉两个「好电视反而变差」:好电视通常带系统识别引擎,原来「有就用」会把自建链路整个让出去,丢掉离线唤醒分流、10 秒连续对话和打断;TTS 也统一走云端同一音色,免得四台电视四种声音。
健康检查直连 /yqm/ 必 404:nginx proxy_pass 尾斜杠把前缀剥了,误触发一次回滚
- 写
--platform-only的健康检查时直接curl 127.0.0.1:8095/yqm/,三项判失败、触发了自动回滚(回滚本身工作正常,线上未受影响)。 - 根因:nginx 是
location ^~ /yqm/ { proxy_pass http://127.0.0.1:8095/; }—— 尾斜杠把/yqm/前缀剥掉了,服务自身只认/。反观/m/那条是proxy_pass .../m/(保留前缀)所以直连 200,两条规则行为不一致,特别容易看错。 - 结论:直连自检一律用
/,/yqm/只用于经 nginx 的对外验证。 - 附带两个坑:① 远端
for f in $FILES前必须把换行清单tr '\n' ' ',否则换行被 bash 当命令分隔,报syntax error near unexpected token 'package.json';② macOS bsdtar 的com.apple.provenance扩展属性在服务器 GNU tar 上刷几十行警告 ⇒tar --no-xattrs。 - 哈希回查仍然必须两边先
tr -d '\r':线上是 CRLF、工作副本是 LF,不剥行尾会整文件全红(假的)。
- 写
2026-10-19
WorkBuddy 基座接入的四个坑(都已定位)
① CLI -p 模式必崩:SetupGalileo → Config.startPull 里 setProxy instanceof 报错,只能走 --serve。
② --version 能跑是假阳性,不代表链路通——曾据此误判「CLI 可用但模型不回应」。
③ 所有请求必须带 x-codebuddy-request: 1,否则 403。
④ ACP 的 initialize SSE 流不能断开,一断就 Server not initialized;session/new 不收 model 字段。
另:⛔ 绝不能设 CODEBUDDY_BASE_URL(三个域名全 405),不设反而成功。
2026-10-16
并行会话的改动随部署上线后补交入库(685dda8)
- 工作区留了 5 项并行会话的改动没提交:about.html、两个 css、展厅图、自检脚本。
- 这批已随 22:48 整站部署上线,线上有而仓库没有就是纯风险,需回头补交。
- 逐文件核对线上哈希一致(17af676c…、图 56628B),显式 add 提交 685dda8,推送 60b7f17..685dda8,工作区清空。
- 含 about 页技术突破区块与 contrast 页两处静默 bug 修复;BSD grep 的 \| 坑须用 grep -E。
线上 plans.html 是「中间版」不是「最新版」:「线上 vs 仓库」只比两层,漏了工作区那一层
- 拉线上 plans.html 实测(43017 字节):线上是第二版(九个套餐),仓库 HEAD 更早,工作区才是第四版,昨天「线上比仓库新」只说了一半。
- 教训:只比线上与仓库两层,工作区有未提交改动时必漏判,要三层并列、比归一化内容而非时间戳。
- 已提交推送 c69373d + dfc82ca,双机 merge 到 60b7f17,仓库升级为第四版,与线上差距反而拉大。
- 线上仍是第二版,本轮未跑 deploy.sh;工作区还有 about 那批未提交改动,整站部署会顺带传上去。
部署前比对拦下一场事故:线上主站 3 页 + 3 css + 35 张图都比仓库新(未提交未推送)
- 上线前做线上/仓库/工作区三方比对:线上主站 3 页 + 3 css + 35 图都比仓库新且未提交,整站部署会覆盖并删掉展厅图。
- 逐文件比内容哈希(剥 ?v=、去 CR),不比 mtime;35 图差异与日记去角标批次对上(47−12)。
- 先备份线上 42 文件 / 1.6MB,给 deploy.sh 加 --screen-only(1181d93),只同步 screen/。
- 大屏 12 产物哈希全绿,外网底图 498KB、towns.json 8 个服务站;主站三页哈希与备份逐位一致。
取证与磁盘操作的三个教训(陈旧帧 / 抢焦点 / 误动用户会话文件)
- 截图取证踩两坑:screencapture 返回陈旧帧(两图 md5 相同);窗口抢焦点,误截到含真实地址的浏览器页面,已删图不外传。
- 无辅助功能权限,osascript 定位窗口一律 -10004,改整屏截图后按逻辑坐标裁窗口。
- 为截登录页移走 session.json,事后 accounts.json 显示 logins 1→2,移走的正是刚建好的会话,已放回。
- 结论:动用户文件前先看时间戳;get-task-allow 来自 Flutter release 默认 ad-hoc 签名,不是配置错。
踩坑:macOS 沙盒让「CLI 产数据包」与「App 读数据包」永远看不见对方 —— 最终关掉沙盒
- 数据包放好 App 仍读范例:开沙盒后 HOME 指向容器,CLI 与 Finder 写真实家目录,互相看不见。
- 第一次修法方向错:沙盒里读不到真实家目录,只靠手工复制进容器才看着好。
- 最终关掉 App Sandbox,统一落点 Application Support/yueju_calendar/,账户文件一并迁走。
- 取证坑:screencapture 返回陈旧帧、旧实例挡住画面(先 pgrep)、kill 的 SIGTRAP 不是崩溃根因。
- 交付前结束旧实例,摘掉 dev-autologin 标记。
push 被拒才发现远端领先 10 个 commit:本地 `branch.ab +0 -0` 是旧记忆,不是现状
- Windows 侧 push 被拒,远端已被领先 10 个 commit,本地 branch.ab 却仍 +0 −0。
- 根因:本地 origin/master 引用停在 10-15,未 fetch 的领先/落后只是上次的印象。
- 处置:fetch 后比两向差异,确认只碰 deploy.sh 不同行,pull 干净合并。
- 合并后核对 deploy.sh 含底图且 0 个 CR;merge commit 497d925 推送成功。
- 固化为流程:推送前 fetch → 比差异 → 有领先先合再推。
2026-10-15
system.html「三个时刻」「三步走」层层嵌套:整卡套链接时全局把 </article> 替成 </a> 打穿了同文件其它区块
- 「三个时刻」「三步走」卡层层嵌套、卡高 2084/1371/687:整卡套链接时全局把 </article> 替成 </a>。
- 修 14 处错标签(8 处 →span、6 处 →article),一条 27 字正文收到 24 字。
- .sy-steps 三列断点 660→900;列表 flex 吃余高,底距 30/63/63→30/30/30。
- 16 页标签配对零错配、352 组全过;批量替换绝不能用全局 </article>→</a>。
2026-10-14
实机部署的五个坑,每一个都伪装成别的问题
- 五个坑:变量名后紧跟中文被并入变量名;端口被占,反向隧道只绑 IPv6 仍返成功,请求打到别家返回 200。
- 本机 8000 被另一项目容器占用,烤箱服务改可配端口 8001。
- 本地网络权限:包管理器装的 framework 解释器连不通,借 Docker 网络做 TCP 转发;测连通要用真正跑服务的解释器。
- 依赖漏声明,查清该库本就在公共索引上,改回正常依赖管理。
- 分段体检才能定位断在哪一段。
真机装机成功不能只看退出码:安装命令几乎不打印任何输出
- 真机装包退出码 0 却几乎无输出,容易误判静默失败;该命令成功时本就只打两行,接管道还会被缓冲吞掉。
- 判据落到设备:用构建工具链内置工具查应用标识是否已装,再列设备应用清单确认。
- 系统设备管理命令对这台手机一直报「设备未找到」,只有项目自带工具链认得。
- 装机是先卸载再装,传输历史与设置会被清空,验收前先告知使用者。
双机同仓的覆盖事故:一台机器的整站上传把另一台的改动静默盖掉
- 事故:另一台 Windows 整站上传覆盖 comfort.html,讲解入口消失,js/css/audio 都还在、只是页面不再引用。
- 处置:合并对方页脚入口后重部;deploy.sh 加部署前哨,比对上次部署的线上指纹,不一致列文件名并停 6 秒。
- 前哨两坑:基准须是上次部署指纹;指纹取归一化内容(剥 ?v=、去 CR)。
- 两条线合并进 Gitee 后以 git 为准,合并后实跑又抓出三处硬伤;哈希只证明两边一样,不证明产物对。
拆提交本轮的 6 个坑:旧 dump 静默退回已提交内容 / `-U0` 歧义匹配 / KSP 增量缓存炸了
- 拆 6 个 commit 踩 6 个坑,共同点是结果「看着对、其实错」。
- 最阴:dump 早于引擎修正,A 线把 D 刚加的 excluded 字段整段删掉;用不变量 grep 抓出,修法是重 dump 未提交线。
- -U0 歧义匹配把改一行吐成 64 行新增,下标 0 必须归给改之前那条线。
- KSP 增量缓存报 already registered,清缓存均无效,最终 -Pksp.incremental=false 绕过,后续 5 条线一次通过。
踩坑:配图容器用了 16:10,把图里的「AI 生成」角标裁掉了一半
- AI 生图右下角「AI 生成」角标是合规标识且烧在图内,配图容器用 16:10 裁切把角标裁掉一半,只剩「AI 生」。
- 改回与源图一致的 16:9 后立即完整。
- 约定:装这类图的容器一律 16:9,不为排版改比例。
- 同页多图需提前分配场景:总览页页头与深夜卡原本都是「居中走廊 + 人」,改成玄关近景与卧室床边才分开。
2026-10-13
本地版本清单落后于线上:按本地文件部署会把已发布版本整体回退
- 部署前发现本地版本清单比线上旧:线上桌面端版本更高,最近几次直接在服务器改、未回流仓库。
- 危害:按本地文件部署会把已发布版本整体回退,下载页版本号往回跳、安装包与实际不符。
- 处理:先从线上拉回对齐,并核对安装包真实存在(体积);把「部署前先拉线上比对」写进发布前自检。
- 教训:线上可改的配置一定会与仓库分叉,要么即时回流,要么流程强制比对。
iOS 首次真机构建:依赖索引被墙 + 一个失效的镜像劫持了依赖克隆
- iOS 首次真机构建卡两层,均非代码问题。
- 依赖索引 CDN 被墙:改配置文件地址无效(代码有短路逻辑),必须改代码常量。
- 更隐蔽:一条全局地址改写规则把某依赖劫持到 git 协议握手失败的镜像,首页 HTTP 仍返 200;判断方法是绕开规则直连一次。
- 修好后依赖安装 1 分 18 秒完成,35 个包全部就位。
- 环境结论:只能用项目自带工具链装机;安装会先卸载旧版、清空本地数据。
踩坑:凭肉眼判断了两个不存在的问题,探针一量全是误判
- 改版前用探针实测,推翻两个肉眼结论:图带 6 张卡高与图高一致,只是说明行数不同;入口按钮 1440/1280 落差 0px。
- 真正的问题:18 张同构卡连排 2538px 无分组、色标随机、首屏仅 694px 撑不满、悬浮胶囊压内容。
- 结论:长页面先量后改,肉眼易把「行数不同」看成「高度不同」。
视频异地备份脚本:状态码 200 不代表文件存在
- 视频已移出 git,素材只剩本机与线上托管两处,遂做异地备份 / 灾备恢复脚本。
- 踩坑:托管平台对不存在路径也回 200(回退首页),只看状态码会把丢文件判成下载成功。
- 判据改为同时校验 content-type 与字节数;另带只体检、按关键词单拉两种模式。
修复图表库因公共 CDN 不可达而加载失败的问题
- 管理后台趋势图不显示、new Chart() 报错:图表库走公共 CDN,该 CDN 国内完全不可达。
- 改为站点内自托管 + 本地路径引用,浏览器验证控件正常绘制、页面无报错。
- 教训:判断页面是否真用到某库不能只看返回 200,要查 window.X 是否存在。
视频与历史垃圾文件移出版本管理,并重写仓库历史
- 视频素材累积 243MB(10 个 mp4),移出版本管理但文件保留在磁盘,页面与构建仍照常引用。
- 从跟踪移除 + .gitignore 覆盖,再重写历史把 21 个大文件从全部提交抹除。
- 结果 .git 由 430MB → 112MB,78 条提交完整保留,push 不再触发大文件告警。
2026-10-12
踩坑:长辈模式把顶栏挤折行,rem 尺寸必须补 px 封顶
- 长辈模式(根字号 27px)上线后顶栏挤成两行,导航又被后加的固定高度规则撑到 84px。
- 小屏加放大字号下,带不换行属性的按钮顶破容器,320px 宽横向溢出 149px。
- 结论一:rem 尺寸在放大模式里都要补 min(…, Npx) 上限,否则整体按比例缩放先撑不住。
- 结论二:写完新规则要回查有没有旧规则被覆盖,固定高度那条就是后加覆盖了前面的。
2026-10-11
⚠️ 途中停顿摘除(transitstop)判据②过摘:线上试算会摘掉「在家」和一处「施工」——部署前必须先收紧
- transitstop 判据②「两头都在跑且地址无目的地词就摘」过摘真实停留,部署前必须收紧。
- 线上 14 条停留试算:会摘掉在家的 122 分(#2173)与施工的 28 分(#2206),另有一条疑似重复可能与对。
- 根因是 DEST_RE 漏词:真实地址常无「小区/别墅」,店名也没写「店」。
- 两方向待拍板:扩 DEST_RE 危险(号/楼几乎人人有),更宜收紧判据②并加时长或减速带证据;判据①本次零误伤可保留。
- 教训:一票否决的规则上线前必须拿线上全量数据逐条试算。
2026-10-10
构建排障两例:一行「25.0.2」和它掩盖的错误;以及构建成功≠产物正确
- flutter build apk 1 秒失败只输出「25.0.2」:Flutter 优先用 Studio 自带 JDK 25,Gradle 8.14 不认;改 --jdk-dir 到 17.0.7。
- permission_handler_android 自带 AGP 9.0.1、硬编码 compileSdk 37,与 Gradle 8.14/36 代差;已摘掉。
- 构建成功不等于产物正确:图标脚本按自身目录拼路径,5 张图标写错位置,只有 API 24/25 真机暴露;签名缺配置时静默回退 debug。
2026-10-09
判「人走了」的证据,得先确认「下一条」是同一地点
- 未闭合停留原按「下一条进入时刻」收口,线上遇到中心距离 0 米的重复开启,真实 3 小时被压成 31 分钟。
- 修法:先比坐标,中心距离小于 200 米视为同一地点,不作「人走了」证据,改由轨迹点判真实离开时刻。
- 坐标缺失或非法时直接报错停下,不静默退化。
一条超长字段,能把整个页面打挂
- 现象:供应商列表页整页挂,产品库按价格排序也整页挂,看着像前端写坏,实为数据问题。
- 根因:SQLite 文本字段无长度上限,接口出参契约限 64 字,写入无感、查询才炸;一家 21 个品牌拼进「主营品类」达 80 多字。
- 修法三层:导入按上限截断并统计截断条数;上限值直接取自出参契约;冒烟测试加超长值断言,确保列表仍返回 200。
- 教训:数据侧超长会表现成前端崩溃,排查先拿一条真实数据过接口;此后导入前先跑字段长度体检。
解析「跑通了」不等于「解析对了」:三个静默错误
- 脚本一路打印成功、条数也对,但有三处静默错误,结果都看起来合理。
- ① 三张表被判无表头,19 条真产品没进:闸门要求表头含价格类词,默认词表缺「产品价格」,补入后解决。
- ② 插座凭空多出同价「单火」版:合并单元格使零火/单火两列读出同值;加闸「拆出版本与主价相同即不是两件货」,两表从 51+32 收敛到 35+25。
- ③ 分类被关键词抢走:床归成窗帘电机、中控屏归成音箱、音响线当成音箱,重排分类优先级修正。
- 教训:每次解析后必须回原表逐格核对,并看类目分布是否符合常识。
部署脚本用 rsync --delete,把线上的启动脚本删了
- 现象:一次例行部署后站点直接 502。
- 根因:rsync --delete 全量同步把线上手工放置、未进仓库的启动脚本删掉,进程管理器重启找不到入口。
- 脚本最后一步打印「部署完成」,健康检查拿到 502 仍照常打印成功。
- 修法:启动脚本纳入版本库;健康检查改硬判据,返回内容必须含 ok,否则非零码退出并提示看日志。
- 结论:全量同步与服务器手工文件天生冲突;打印成功不等于真成功。
2026-10-08
把「家里网断了」误判成「设备故障」
- 上一轮把离线结论定为设备联网模块故障,实际是家里路由器被关掉,网络恢复后全部自动恢复。
- 证据链本不指向该结论:同账号净水器云端一直在线,不同品类心跳超时不同,「全部设备离线」根本不成立。
- 教训:只看单台设备在线状态,永远分不清设备坏了与家里断网,排除法要用对照物。
- 排查顺序:域名解析 → 外部绕一圈请求 → 服务器本机请求 → 进程与日志 → 最后才怀疑设备侧。
通知发出去了却不弹横幅:代码里改不动的那一层
- 现象:点通知自检提示已发送,但通知栏找不到,一度误判为假成功。
- 实际通知已发出、有声音和振动,只是被折进「更多通知」区且不弹横幅;系统把排序重要性降级,渠道设高重要性也无效,应用侧改不动。
- 真正开关在系统应用通知管理页,「横幅通知」「置顶通知」默认关闭,打开即正常;已在「我的」页加提示。
- 排查技巧:拉界面层级取精确坐标,目测 y 差 23px 就打空;判断截图是否变化要算哈希,状态栏时钟每分钟在变。
- 结论:第三方 App 无法用代码强制弹横幅。
自动断言也可能是假断言:用 0 验证 0
- 断言「在谈项目金额合计等于 0」恒成立,实为验证 0 == 0,实现写错也会通过。
- 改为比对接口真实返回的「在谈金额」字段才有意义。
- 截图脚本以 URL 是否以 /dashboard 结尾判登录成功,而登录失败跳 /login?redirect=/dashboard 也命中,密码错误被静默当成功。
- 改为严格比对完整地址,并额外等一个仅登录后存在的元素。
- 结论:断言先问「实现写错时它会不会失败」,会失败的才叫断言。
折线图看着挺正常,数据点却全飘在顶部
- 现象:月度趋势折线峰谷正确,但代表各月的圆点全落在图表顶部。
- 根因:折线用 SVG、数据点用 HTML 绝对定位,SVG 的 y 轴向下、CSS 的 bottom 向上,整条曲线被垂直翻转。
- 修法:bottom = 100 − (y / 高度) × 100。
- 另坑:SVG 呈现属性不解析 CSS 变量,stroke 写 var(--brand) 会静默失效,必须用 :style 绑定。
- 结论:跨两套渲染体系拼图形,坐标方向与颜色解析规则都要各验一遍。
还没签约的项目,被算成了「亏损 4.9 万」
- 现象:在谈项目的明细行显示合同额 ¥0、利润 ¥-49,173 且标红,看着像已经亏了。
- 根因:统一公式「合同额 − 总成本」只对已成交项目成立,代码漏了这个前提。
- 修法:仅已成交算利润,未签约的利润与利润率留空显示短横线,成本照常显示,表头注明未签约项目不计利润。
- 补一条断言专守此回归。
- 教训:同一公式在汇总与逐行两种用法下前提可能不同,汇总时全是成交项目所以看不出来。
踩坑:相册列表在新版系统上报错,而权限明明是已授予
- 现象:点扫相册报「打开相册时出错了」,但权限检查是已授予。
- 根因:新版系统不接受排序字符串里带条数限制,直接报非法标记;异常被宽泛兜底吞成统一错误提示。
- 修法:查询去掉条数限制,取回后在应用侧截取;扫相册改成有明确开始与结束的对话框,避免关不掉的加载。
- 结论:权限已授予不等于功能可用;兜底过宽会把参数非法翻译成未知错误,排查先拆兜底。
2026-10-07
macOS 打包踩坑:签名校验失败的真因是可执行文件名大小写不一致
- 签名校验报「信息清单或签名已被修改」,但应用双击能正常打开,容易误判成打包改坏了文件。
- 真因:包内信息清单声明的可执行文件名与磁盘实际文件名大小写不一致;文件系统不区分大小写所以运行无异常,签名按字节比对即判篡改。
- 修法已固化成打包脚本:对齐文件名、移除旧签名、逐个内部框架重签(不用已废弃的深层签名参数)、整体签名后强制校验,不过就不出包。
踩坑:报告「已上线」了,但线上跑的还是旧文件
- 某轮改动本地自测通过、也执行了上传,就汇报「已上线」;复查逐字比对线上与本地校验值,发现内容还是旧的。
- 根因:上传命令目标路径写成目录,文件落到上一层,而项目里恰有同名旧文件,于是传输 100%、文件存在、语法检查、版本号全部看起来正常。
- 处置:把「上传后逐字比对校验值」定为硬规矩,是否上线以线上接口真实返回为准,不看传输日志。
相册识图链路被证伪:端上 AI 根本不支持传图
- 反馈:宝宝照片与合影被识别成风景照、说没有人物。把已入库原图重跑识图,模型答「我无法看到照片」;换明确支持看图的多模态模型,回复一样,说明图在传输途中就丢了。
- 根因两层:一是选了纯文本模型 hy3-preview,传图被忽略;二是小程序原生 wx.cloud.extend.AI 不支持图片上传,content 里的 image_url 被网关直接丢弃。
- 结论:这条链路从上线起就没真正跑通过,此前自动化测试「通过」是拿风景图测的、模型蒙对。
- 修法:控制台开启多模态模型,识图改走服务端 node-sdk(超时调 60s)或 App 端 js-sdk。
2026-10-05
踩坑:Android 11+ 不声明包可见性,语音识别会被误判为「本机不支持」
- 现象:接入系统语音识别后,任何手机都被判成「本机没有识别服务」。
- 根因:Android 11+ 包可见性限制,不声明查询就看不到系统识别服务,接口恒返回不可用。
- 修法:清单里声明要查询的识别服务与合成引擎,不申请查询所有应用这种过宽权限;TTS 引擎同样要声明。
- 结论:接口存在、代码没错却不生效,先查平台级权限与可见性。
2026-10-04
macOS 重编踩坑:依赖锁文件被忽略导致版本漂移 + 国内网络下 66MB 二进制下载
- macOS 重编卡在二进制依赖两处。坑一:报错称最低系统版本不够,实为锁文件锁了旧版二进制;该锁文件被忽略规则排除、从未提交,版本漂移无人察觉。
- 清理锁文件重新解析,最低系统版本抬到 12.0,工程配置与构建脚本两处同步改,只改一处仍在安装阶段报错。
- 坑二:66MB 二进制国内直连不通,镜像单线程衰减到几 KB/s;切 8 段并行续传并加低速超时重连,约 330 KB/s、3 分半完成,缓存按原始校验和补齐。
- 重编后注册正常:服务端 120 秒窗口内仅 1 次注册,此前每 30 秒上万次的重注册风暴确认根治。
2026-09-27
车库(.21) 根因纠正:不是萤石,此前密码/取流路径全错
- 推翻早前结论:车库 .21 不是萤石,家里也没有萤石设备,是另一品牌。
- 错在沿用品牌假设用错账号,误判「设备不推流 / 需 App 唤醒」;mac 端一直能出画面本是强信号却被忽略。
- 实测:admin/admin + Digest、ONVIF 8888、RTSP 标识 happytime,主 ch0_0.264(H.265 2304×1296)、子 ch0_1.264(800×448)。
- 已修正 DB id=11 的 stream_url,重启 media 容器清掉 PlayerProxy 缓存。
同源判据抓不到同类 bug:走廊幅两个真 bug 的根因
- 探针抓出两个真 bug:走廊幅 u 分母误用普通样式(innerMedian 为 0),#947 人行道中心 3.386m 落进 3.40m 车道。
- 行道树 off0 符号假设错,127 段里 9 段偏移出渲染跨度(最大 2.74m),改按 sign(off1-off0) 现算。
- 教训:判据与实现同源会一起错,须从几何定义推导;探针 4a 漏除 miter 系数,急弯假偏差 2.6m。
- 抽出公共 edgePoints() 共用,4a/4b 各 5236 次比对全绿,绿化带审计 127 段全绿。
判据写太弱会给你假绿:最小车距从 25.65% 打到 0.021%
- 判据从「中心距为负」改为「中心距 < 车长」,才测出 25.65% 车体重叠。
- 六个缺陷:idm 把 s0 当车长(7.0→5.0m)、v0≤0 进不了紧急制动、桶按帧初建致跨边车不跟车、投车不查重叠、往短段塞车(8.15m 段 13 辆)、重投兜底硬塞。
- 分桶定位:<15m 段重叠 95.3%、≥15m 仅 4.09%,再用 hasRoomFor 判否与事件日志锁定 setRoute。
- 加 EntryClearance=7.0m 与投车不越停止线,重叠率降到 0.021%,最小中心距 6.08m。
2026-09-26
两个隐蔽判据坑:bash 3.2 中文变量边界 / RTSP 连接数漏 -i
- macOS 自带 bash 3.2 会把紧跟 $VAR 的中文字节吞进变量名(zsh 不会),set -u 下报 unbound variable 并中断。
- build-app.sh 因此长期在签名后中断,codesign -dvv 校验步骤从未执行;全仓库改 ${VAR},按正则扫出 4 处修复。
- 查 RTSP 连接数用 grep -c estab 漏了 -i,输出是大写 ESTABLISHED 恒定返回 0,把 5 条活连接误读成一条都没有。
踩坑:报错代码把「域名未配」伪装成了「网络不好」
- 现象:开发者工具朗读正常,真机一律弹「合成失败,请检查网络」,但网络与域名都没问题。
- 根因在报错代码:wx.request/downloadFile 的 fail 传的是普通对象 {errMsg} 不是 Error,String(err) 得到 [object Object],匹配不上 not in domain list 便掉进兜底分支。
- 修法:所有 wx 出错路径统一过 errText() 归一化,fail 补主机名,域名类错误直接抛出不再降级重试。
- 经验:错误提示必须能反推根因,catch 不该产出「请检查网络」这类无信息量文案。
坑:楼一旦允许旋转,所有拿包围盒当「重叠」的判定都失效了
- 改完朝向补楼从 656 掉到 582 栋,掉的一成在碰撞判定而不在朝向。
- 根因:AABB 会把旋转楼撑大,50×12 板楼转 30° 后包围盒变 49×35,相邻排净距 28m 直接咬住。
- 改 AABB 粗筛 + SAT 细判:凸四边形做精确 SAT,凹多边形退回 AABB,外扩 4m 用候选矩形沿自身两轴放大,只多否不漏放。
- 结果 582→673 栋,与旧行为只差 3 栋(-0.4%)。
- 回归脚本同步换严格多边形重叠,并报「盒子相交但实体分离」对数与最近距离;阈值先量真实 OSM 再定。
2026-09-24
运行时串口无输出
- 烧录成功但串口一片安静。
- 按先排除再怀疑的顺序查。
- 波特率、时钟配置、日志级别逐项收敛。
2026-09-23
踩坑:icon 裁剪为什么「按卡片裁」是错的
- 坑 1:不能按卡片裁,要按内圆圆心 ± 半径裁,否则微信圆形裁切后露出米白纸底与云纹残线。
- 坑 2:粗检圆心偏 14px(被云纹细线打断),改两遍裁切:180 条射线测边界 + 最小二乘拟合圆,四边留白 7/7/8/6。
- 坑 3:微信圆角矩形展示会露四角纸底,按径向取半径 −14px 处颜色补角,最外 5 圈 20480 像素里米白 0 个。
- 验证手法:取橙色朝日质心相对圆心的归一化坐标,两版 dx=−0.194 完全一致。
2026-09-20
全屏闪退根因:presentationOptions 互斥约束违反即 abort
- 现象:一全屏就退出,4 份 .ips 崩溃日志全落在 FullScreenController.applyImmersive,SIGABRT。
- 根因:NSApp.presentationOptions 有硬性互斥约束,违反即抛 NSInvalidArgumentException,Swift 无法 catch 直接 abort。
- 逐 mask 验证:唯一合法组合是 [.hideDock, .hideMenuBar];新增赋值前逐条校验,非法则记日志降级。
- captureAppearance 统一快照,自建按钮与系统绿钮两条路径都能还原。
- 验证:app 内自测钩子直接调崩溃函数体触发。
最大教训:客户端多实例堆积把自己的摄像头打满
- osascript quit 静默失败,open -n 每轮开新实例,4 轮后 4 个实例并行,每台摄像头挂 2~4 条 RTSP 会话,打满 TP-Link 并发上限。
- 假象连串:首帧等 42 秒、对端关闭连接、退避重试 4 次全失败、ffprobe/ffmpeg 也拉不到流。
- 正确流程:killall → 确认实例数 0、554 连接归零 → 等 15~25s 让设备回收会话 → 只启一个实例,已固化为 scripts/run-app.sh。
- 诊断命令 pgrep -x NVRStation | wc -l,必须为 1。
- 教训:调试客户端前先确认实例数,多实例会自己打爆自己并制造假故障。
2026-09-19
设备厂商判定修正:74:39:89 是 TP-Link 而非海康
- 74:39:89 曾按 OUI 判为海康(ONVIF 响应带 hikwsd 命名空间),实测推翻。
- GetDeviceInformation 显示 TP-Link TL-IPC44K-4,固件 1.0.13,74:39:89 是 TP-Link 的 OUI。
- hikwsd 只是兼容海康扩展协议的痕迹,不能当厂商判据。
- .21 的 9c:a3:a9 才是真海康 OUI(萤石为其消费品牌)。
- 结论:厂商以 GetDeviceInformation 为准。
2026-09-18
cameras 表为空:init-db.sql 的种子数据从未执行
- 现象:/api/cameras 返回空数组、stats 全 0,前端列表却显示 5/6 在线(那是硬编码 mock)。
- 根因:官方 PG 镜像的 initdb.d 只在数据目录为空时执行,种子 INSERT 是后期追加的,pg_data 早已初始化。
- 手动 psql 导入 6 路,验证 stats = total 6 / online 5 / recording 4 / offline 1。
- 教训:改 init-db.sql 不会自动生效,需 down -v 重建数据卷或手工补齐。
2026-08-07
社交裂变部署:CLI 凭证过期 + 命令格式变更踩坑
- tcb CLI 临时凭证约 26 天前过期,login 报密钥校验失败,需重新 device flow 授权。
- 部署后 NoSQL 短暂隔离报 env status is isolated,约 10 分钟自恢复。
- nosql execute 命令格式变更,旧 Values 格式报错,改用 Command 字段包 mongo 语法。
- 冒烟 6 项全通过;fn invoke 无真实 OPENID,依赖 openid 的 action 留待真机验证。
2026-07-06
踩坑:Web 端「上传按钮没反应」——Vue 静默吞掉 ReferenceError
- 招标详情弹窗点上传完全无反应,控制台也没报错,先怀疑文件选择和权限都排掉了。
- 根因:uploadFile()/save() 调的 token() 只在根 app setup 里定义,组件作用域没有,ReferenceError 被 Vue 3 静默吞掉。
- 修复:组件自己加 token() 读 localStorage 的 admin_token。
- 教训:Vue 里「点了没反应、无报错」先查模板/方法作用域。
踩坑:Web 端上传中文文件名乱码(Latin-1 误解码)
- Web 后台传文件后中文名变乱码,根因是 Content-Disposition 的 filename 按 Latin-1 解码 UTF-8 字节。
- 修复:服务端 Buffer.from(displayName,'latin1').toString('utf8') 重新解码。
- 供应商端早修过、管理端漏了,同一问题两个入口只补了一个,这次一并补齐。
踩坑:小程序文件选择与上传的一条完整坑链
- 选文件无反应,先疑隐私授权,加 requirePrivacyAuthorize 仍无效。
- 模拟器报栈溢出:chooseMessageFile 带 type 参数在基础库 3.16.1 触发微信 bug,去掉参数与授权壳仍无效。
- 正解改用 onNeedPrivacyAuthorization:未授权时弹自定义隐私弹窗,agree 按钮 resolve 放行原调用。
- 上传后文件名变 tmp_数字,改由客户端从 tempFilePath 拼 file_name,服务端多级探测扩展名;长名中间截断。
2026-06-24
踩坑:Failed to fetch 全面修复(网络 / CORS / 500 / 轮询泄漏四层)
- 一天内收掉 Failed to fetch 四层成因:请求层、服务端、CORS、前端定时器泄漏。
- 小程序 request() 加 try/catch,statusCode 补认 201,不再把创建成功当失败。
- Express 加全局错误中间件统一返 JSON 500;CORS 白名单补 http 生产域名;JWT_SECRET 后备值统一。
- 所有轮询定时器补 onUnmounted 清理,四处 footer 版本统一到 v2.0.2。
2026-06-22
日期输入改年月日独立文本框(绕开浏览器 locale)
- 竞价表单日期输入在英文浏览器显示 mm/dd/yyyy,根因是原生 date 控件跟随 locale。
- 改为年/月/日三个独立文本框,同步改重置、回填解析、保存拼串,招标表单的 datetime-local 一并换掉。
- 改完白屏:save() 被多复制一行 async function 造成语法错误,用 new Function() 先验语法再部署。
- 部署前做本地→宿主机→容器三层 md5 比对。
2026-06-21
错误提示体系:从 toast 到带 errCode 的 Modal
- 报错从一句「请求失败」改成带 errCode + HTTP 状态码的 showModal 弹窗,弹窗限频 3 秒。
- 建统一错误码表,管理端加 /error-codes 接口可查全表。
- 坑:容器缺文件报 404 找不到错因,顺手把接口路径打进弹窗。
- 教训:源码必须 bind mount 进容器,否则 compose 重建后改动全丢。
2026-06-02
踩坑:精准政策报 EXCEED_AUTHORITY —— CloudBase RDB 对匿名用户不开门
- 精准政策报 EXCEED_AUTHORITY,日志为 app.rdb is not a function。
- 两层根因:匿名身份无 RDB 读权限;本地改 mysql2 但云端仍跑旧版。
- 改 mysql2/promise 直连,连接信息走 process.env,依赖换 mysql2@^3.11.0,部署加 --force 并看日志。
- 验证 invoke 返回 code=200,16 条政策正常。
- 结论:tcb 显示 deployed 不等于真更新,公开接口直连更稳。
2026-05-27
踩坑:数据分析营收统计口径错误 + 缓存损坏
- 数据分析营收/消课/购课大量为 0,四个根因。
- 统计只查 orders,收入在 expense_records、coach_bookings、venue_bookings。
- 缓存 stats_json 写入 [object Object],解析必失败;existing 把 {data,error} 当数组。
- 修复:口径汇总四个收入源,缓存先删同日同类再插,动画值与 target 拆开。
- expense_records.amount 语义混乱(课时数 vs 金额)的历史数据一并修正。
2026-05-26
踩坑:场地价格管理页与预约页不一致(三个独立根因)
- 管理页与预约页价格不一致,挖出三个独立根因。
- UTC 日期:toISOString 取 UTC,东八区凌晨差一天,查不到当日价回退模板价。
- 时段名 23:00-00:00 对 23:00-24:00 匹配失败,DB 21 条统一 UPDATE。
- 会员 8 折双重误差:预约页 price*0.8、管理页原价;日期改本地格式化,onLoad 先定价再算会员价。
- 价格定稿:高级场工作日 100/150/100、周末 150/100;普通场 80/100/80、周末 120/80。
2026-05-25
踩坑:rdb 不匹配下划线字段,管理员被当成普通会员
- 现象:管理员账号登录后显示普通会员,管理功能全部不可见。
- 根因:rdb SDK 不返回下划线字段,_openid 查询静默为空,账号被当新用户重建为 role='user'。
- 修复:users 加 openid 列并双写,查询统一走 openid,覆盖 profile、db-service、payment 与三个 admin 鉴权。
- uk_openid / uk_phone 唯一索引因空串冲突删除,改由业务层保证唯一。
2026-05-21
Skyline 深坑复盘:从 flex 高度塌缩到弹窗四改
- 服务点单页一天五轮,Skyline 多层 flex 高度塌缩为 0,改导航栏与内容平级。
- 默认 content-box,带 padding 容器须 border-box;横向筛选改 overflow-x 避开嵌套滚动。
- 弹窗四改:transition 对 transform 无效改 wx:if,双 fixed 改单容器 + absolute,body 固定 55vh。
- navigation-bar 硬编码 #333,title 红底无白字须改 slot;导航栏不显示是 .json 没注册组件。
2026-05-19
电子名片小程序码:从 -501001 与 32 字符静默失败里绕出来
- 名片小程序码云调用报 -501001,改双策略,失败走 HTTP API 换 access_token。
- 坑:scene 用 card=openid 33 字符,超微信 32 上限且静默失败,改放纯 openid 28 字符。
- page 传名片页报 invalid page,改首页中转再重定向。
- 保存失败先查 business_cards 集合;更新不写 openid,避开 _openid 冲突。
- 画布用页面 Canvas + arcTo 圆角,主题色改 #D4272D。
2026-05-07
门禁真机问题攻坚:手机号与头像的「三修」
- 手机号授权修三轮:phone 写进 userInfo 被按 openid 判未登录覆盖 → 换独立 key lock_phone → 根因是云函数查到 phone 却不返回,_checkLogin 改三重读取。
- 头像压扁修三轮:加圆角、加 flex 均无效,最终视觉层与交互层分离,view 做圆形裁切、button 设 opacity:0 只接 open-type;根因是微信 button 内置 UA 样式。
- errcode -3 与 0 拆成两态:确认开门 vs 指令已发送;开锁成功页改 3 秒倒计时回首页。
- 设备名支持自定义,lock_devices 优先于默认 alias。
2026-04-30
踩坑:scroll-reveal 双层嵌套导致内容 opacity:0 不显示
- 现象:加滚动动画后首页课程体系整块 opacity:0 不显示。
- 根因:About/Coaches/Courses/Moments/Contact 五个组件模板自带 .scroll-reveal,Home.vue 又包一层,内层永远不被 IntersectionObserver 观察到。
- 修复:移除组件内 class、动画统一由 Home 控制;CSS 动画挂 html.sr-ready 前缀做渐进增强,useScrollReveal 加 nextTick。
- 同类坑:子页面根元素也不能加 .scroll-reveal,否则整页不显示。
2026-04-01
包体积治理:7.3MB → 2.2MB,把 2MB 上传上限这道墙撞开
- 主包上限 2MB,工程膨胀到 7.3MB 上传被拒:npm 依赖全量打包、node_modules/cloudfunctions/map 全被算进包体、miniprogram_npm 嵌套路径配置错。
- 移除未使用的 @cloudbase/js-sdk 改手动 npm 打包,用 packOptions.ignore 排除无关目录,修正构建路径。
- 结果 7.3MB → 2.2MB,上传通过。
- 顺带恢复 Skyline、版本号第三位自动自增、关于页补备案号 京ICP备2025149772号-2X。