开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 20 条记录。
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 分得开,同一份变异立刻红。
- 可操作的做法:写判据时先问一句「错的那个实现算出来是多少」。答不出来就是不知道自己要区分什么,那就没写完。这一句后来直接进了几份场景文件的注释。
2026-11-10
分支落后 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-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):序列帧
2026-10-31
`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-27
压力关第一次上真机:揪出「整页中文变白块」,并拿到真实的 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 不在手上,手机侧数据待补;三档精灵数全扫被遮罩打断,数据分两次采集。
- 白块的根因在压力关自己:
2026-10-26
看板重核: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 次编辑都报成功,