开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 96 条记录。
2026-11-15
me-record 补到 20 条判据:PNG 用两套独立实现从外部解;提案 apps 契约守卫
- PNG 写入器的 7 条判据:手写 110 行,此前判据只看签名与 IHDR 宽高。里面最容易错的都是常数(crc32 多项式/初值、adler32、65535 分块边界、每行前置的 0、IEND 那 12 个字节),错了的症状完全一样:文件在那里、看图软件打不开或下半截是黑,而判据全绿。
- 做法:从外部解一遍。用两套独立实现(查表法 CRC32 + 只解 stored 块的最小 inflate)把产物从头解到尾,再与源像素逐字节比。测试侧先对规范标准向量,否则「两个实现互验」可能只是同一个错误写了两种排版。
- 三轮反向实验互不重叠:去掉 65535 分块 ⇒ 只红跨块那条;去掉 write_rgba 空检查 + Report::bytes 累加 ⇒ 正好两条;把多项式写成正向版 0x04C11DB7 ⇒ 4 条红而测试侧校验和仍绿 —— 这就是「独立」的证据。
- ⚠️ 还原要靠 git diff 不靠绿:反向实验后把
self.bytes += …还原到std::fs::write前面,20 条判据全绿,语义却变成「写盘失败也记账」。没判据抓得到的错。 - 顺带补了跨块用例:128×128 的原始行数据是 65,664 字节,正好跨两块 —— 此前所有判据都用小图,分块那段代码从来没被执行过。
- 提案 N-250:13 个带 Cargo.toml 的 app 里 8 个 CI 真编译,5 个从不编(city-twin / anim-metal / studio-native / ui-gallery / ui-lab),而 me-record 的唯一调用方就在 city-twin。提案给三个选项,建议加一条 cargo check;共享 target 的冷编/增量秒数还没实测。
- ⚠️ 两次假空:grep 被 OOM 杀(137、stdout 空)被读成「0 调用方」;用名字表当 CI 覆盖证据(gpu-metal 只在注释出现,实际第 4000 行就 cargo build)。改法不是更小心,是换一条能复现结论的命令。
- 入主:参数表那批 → main 8a94c8f2(CI 1181s / 10 项降级);提案 + PNG 两条一起推(CI 跑着,第二、三轮)。
me-record 参数表补 8 条判据;顺带挖出「apps 从没在 CI 里编过」
- 第二层重复:ffmpeg 参数表曾在本 crate 与 apps/city-twin 各一份(两份不报错、只让片子体积差 40%),那次已合并。本批补的是合并之后没人看的那层:那一处拼出来的东西,是不是文档承诺的那些。threads/bit_exact/crf/preset 四个开关删掉会怎样 —— 编译过、原有四条判据全绿(mp4_twice 反而更容易绿)、产出物完全正常,只是换机器就不是同一个文件。
- 做法:参数拼装抽成纯函数
me_record::encoder_args(mp4 里只剩一行 cmd.args),新文件tests/encoder_args.rs8 条判据。不需要 ffmpeg —— 验的是我们递出去的那串参数,不是编码器怎么理解它,所以不会在缺工具的机器上降级成 SKIP。 - 位置即语义:
-i -之前是输入选项、之后是输出选项。-pix_fmt rgba放到后面就变成「输出用 rgba」,原始字节被当成 yuv420p 解释 —— 颜色整体错、尺寸看着对、照常退出 0。判据不只数有没有,还数在哪一侧、-pix_fmt是否正好两次、-s与 frame_bytes() 是否同源。 - 反向实验:一次改三处(删 -threads、去掉输入侧 -pix_fmt rgba、把 -s 挪到 -i 后面)⇒ 正好那三条红,另五条仍绿,定位互不重叠。
- 一处自我纠正:我早先说 me-record 全仓 0 调用方,其实是那次 grep 被 OOM 杀掉(退出码 137、stdout 空),我把空输出读成了「没有」。apps/city-twin 在用两处。
- 挖出的真问题:apps/** 各自独立 workspace(自带 Cargo.lock,不在根 members),根 cargo test --all 覆盖不到。CI 真编译的 app 只有 coin-run / minigame-smoke / arcade / math-lab / studio;city-twin / anim-metal / studio-native / ui-gallery / ecs-swarm / arcade-replica 一次都没编过。也就是说我改 me-record 的契约,CI 不会告诉我 A1 那个 app 有没有破。
- 台账缺口:plan/board.json 里一次都没出现的 crate 有 3 个(me-arcade 5332 行、me-compare 5740 行、me-record)。看板只有 sprint 任务号这一种粒度,而「一个 crate 存在」不是 sprint 任务。
- 结果:13 条判据全绿(8 新 + 5 旧),clippy / doc 干净,生成物与归属守卫通过(CHANGELOG 走已登记代修)。不进 wasm,包体不动。
S15-8 收口:撤掉重复的 UI 过渡实现,转成一条实测;S16 两件补进看板
- 撞车了,我那份撤了:S15-8 的 UI 过渡,A1 的
me-ui/src/transition.rs(02:49)先落,我 12:08 又在me-anim侧写了ui_transition.rs(455 行 + 10 条判据)。同一件事两份,删后写的那份。DoD「没有第二份插值代码」两边都没破 —— 撞的是记账那一层,而 DoD 一个字没写到它。 - 从那边带回一条实测:被中断的过渡仍按整段时长走完剩余行程 ⇒ 从 50% 处打断「退干净」用 10 帧而不是 5 帧。画面上不是「被打断」是「变慢」,肉眼看不出、像素判据也抓不到。已开 N-247 给 A1。
- S16 缺的是台账不是功能:S16-1(
scope.rs938 行 + 23 条判据)与 S16-2(ledger.rs+ 13 条判据)都写完了,板上一条都没有。前者进 tasks 并勾 DoD;后者记 3/4 ——disk层 0 调用方(push_disk没喂),docs/10那条 DoD 不勾,开 N-248 给 A3。 - 一处我的错:
disk层「可选不急」以前只写在 notes 里,而协同唯一来源是协商表 —— 写在 notes 里等于没说。 - 补了一条判据:
me-rhi转发层原有判据比的是方法名集合,抓不到「转发到别的方法」。新判据要求正文调同名方法。反向实验:begin_frame改成调end_frame(能编过)⇒ 红在["begin_frame"],原有两条仍绿。 - 入主:两批都过了全量 CI(第一批 3056s / 10 项降级),main
0dece559;第二批 CI 跑着。 - 协商板 171 条 / 23 条在等,全绿;A2 名下剩 N-231 / N-150 / N-237 / N-239,四条都要对方扇区先动。
- 撞车了,我那份撤了:S15-8 的 UI 过渡,A1 的
S15-1 结项:三栏改成内容驱动,web 工作台正文收口 34em;进度重核 76/170 · 284/672
- 三栏从「各算各的 + 减法」改成
layout::distribute一次分完,2026-11-07 造好的Intrinsic第一次被宿主真用上(此前 Studio 写死 262 / 320)。用Item::ranged(Fixed)不是flex_within(Flex):Flex 分的是权重份额,右栏 cap 0.34 > 三栏份额 1/3 ⇒ share 落在夹紧区间中间,拿到份额而不是 cap,差几像素且不报错。 - 实测 1440×900:body 1424 = 左 200 + 视口 984 + 右 240;名字 34 字时 342 / 710 / 372。右栏长值 327(旧版只给 171.6,会截断)。
- 74 项判据改完一个没红(
distribute对 Fixed 做的就是clamp,同一算式),价值是「证明什么都没坏」;靠新加 3 条兜住:总量铺满 / 余量全给视口 / 诉求大于结算值。3 组反向实验真跑过(gap 给 8 ⇒「三栏 1408,那一行 1424」)。 - web 工作台:判据只有 1280 / 1440 两组视口,宽屏从没量过。加 1920 后是 0 违规 —— 布局不坏,只是没人问过「一行多长」。实测正文一行 41.2 / 53.5 / 90.5 个汉字,
.max-width: 34em后三组都是 34。 - 一条被实测纠正的论断:
ch量的是数字 0 的宽(本机字体 0.59em),34ch实测只有 20em —— 「一行 34 字」写成 ch 会变 20 字,而且判据不红(只抓太长)。量中文字数用 em:native 一栏装名字(不可断 ⇒ 像素),web 一栏装段落(可断 ⇒ em)。 - CI 连红三轮,没有一轮是这批代码算错:① ui-lab 控件覆盖表(每加一个
impl Ui的pub fn就红一条,报文不带名字);② 字表SCOPE含apps/ui-lab/src,「增益」不在 495 个码位里(修法是换词不重烘);③run-workbench.sh末句写死「视觉 4 组视口」,加第三组后照旧说 4。 - 落地:main 658d81ac,
S15-1从 wip 挪进 tasks(wip 16→15 / tasks 75→76),docs/10§17 加四小节,Team/notes/A1.md报备三条。 - 进度口径重核(取 main 658d81ac):计划内 76/170 条任务 · 284/672 人日 = 42.3%(在写 15 条 / 61 人日;extras 57 条)。原写的「40% = 255/636 · 67/155 · wip 14 · extras 12」全部过期,分母变了(155→170 任务、636→672 人日);三个数必须一起给,只报百分比会让分母一涨看起来像在退。
- 顺手核出一处账不平:
docs/10§1 抬头写「前 17 个迭代 569 人日 / 全表 636」,逐行合计实际是 630 / 672。差额集中在 S14:一个迭代排了 73 人日 / 23 条(两倍多容量),而文档只承认「S13 排 39」是唯一例外。待 A2 复核 S14。
- 三栏从「各算各的 + 减法」改成
SVG 光栅化层补完十一个缺口:从「只认 path」到能画一份真文件
- 起点是一个静默黑洞:
svgdoc.rs只认<path>与<g>,另外六种基础图形(rect/circle/ellipse/line/polyline/polygon)全落进_ => {}—— 画面上凭空少东西,而 CI 全绿、日志里一行都不留。现在这条缺口关掉了:不认识的标签计入Stats::ignored,tiger.svg上有一条判据要求这个数是 0。 - 十一个功能,每一个修的都是「画得出来但画错了」:虚线(
dasharray/dashoffset)· 端头与拐角(linecap/linejoin/miterlimit)· 填充规则(NonZero/EvenOdd)· 曲线自适应离散(按画布像素卡弦高,Flatten::Sagitta)· 组不透明度(composite_over+ 离屏图层栈)· 六种基础图形 ·viewBox四数 +preserveAspectRatio·apply_mask·<clipPath>+clip-path·transform列表 · 椭圆弧与二次贝塞尔。 - 四处「丢了一半」是可以眼见的骗人:①
viewBox只取后两个数,"50 30 100 100"被当0 0 100 100⇒ 整图偏移 (−50,−30),形状全对、位置整体偏;②viewBox原是在整份文档里find("viewBox=\""),根上没写就读到内层<svg>那个;③ 等比缩放是写死的假设,写none的文件被悄悄压扁;④transform="translate(10,10) scale(2)"被读成一个函数,报「参数读不出来」—— 一句看着像素材坏了的话,而它是导出工具的常见写法。 - 裁剪不能靠截断几何:一条路径被圆裁掉之后边界是圆弧,截断只会得到折线;更要紧的是抗锯齿 —— 圆边界上的像素该是半透明,而截断只能给「在里面/在外面」。所以走「裁剪区域光栅化成掩码 → 内容画到离屏层 →
layer.apply_mask(mask)」,掩码里的变换在光栅化之前进几何(Path::transform),不是事后挪掩码(那会模糊两遍)。 - 账:
apps/clanlib-port断言 179 项全过(15 个场景 / 15 张 BMP);引擎侧me-swrast新增tests/composite.rs9 条 +tests/mask.rs6 条;变异演练脚本从 11 条涨到 13 条(新增 aspect 12 / mask 5 / clip 6 / xform 5,跑起来全部全红)。ci.sh里那七条--check只核演练锚点 —— 全量的那部分要人手动跑,因为一次变异演练要重编十几次。 - 顺带修了一处只会在真文件上炸的 panic:
f32::clamp(0.0, w/2.0)在width="-40"时min > max触发assert!。是变异演练报「0 条红」才发现的 —— 真相是场景 panic 了,一行x都没输出,脚本把「没有输出」读成了「没有红」。现在两处都改:代码用(w/2.0).max(0.0),脚本把panicked at算演练失败。
- 起点是一个静默黑洞:
2026-11-14
Godot 4.7 调研落地:抄产品化那层,不抄引擎那层
- 拉了 Godot 4.7.2-stable 源码(445 MB,gitee 镜像)+ 官方 demo 目录树,出
docs/20-godot-study.md(591 行、35 个小节、113 行表格,数字都带可重跑脚本或文件行号)。 - 该抄三条:场景是文本 + 两级稳定 id(资源
uid://与节点unique_id,写盘处resource_format_text.cpp:274)、导入旁路文件、编辑器吃自己控件(我们 me-studio 压根不依赖 me-ui)。 - 不该抄三条:309 方法的 Vulkan 式 RD(我们 38 个方法撑三个后端)、双渲染器(它是 renderer_rd 65k + gles3 31k 两套完整渲染器,实测漂移 cluster 1109:0、sdfgi 974:35,不支持的只能写静默 no-op)、运行时反射(1783 个类 / 36 个 Variant 型)。
- 最该抄的是 §5.1:用编译期生成的静态组件表拿属性反射,而不是把 Variant 搬过来。
- demo:139 个里 27 个是 2D,逐条判完 ✅11 / 🟡12 / ❌4(脚本核过 27 对 27)。3D 32 个出局——我们没有 3D 渲染器(Camera3D 全仓 0 处)。
- 中间修了一次自己判错的:
polygons_lines原判能做,理由是「me-math/poly.rs有三角化」,实际那是多项式不是多边形,全仓三角化 0 处。已改判 🟡 并进附录 B。 - 落库 main
0a95a4a7 → 193d738e,两次 CI 699s / 526s 全绿,树断言 e40a8c96。
- 拉了 Godot 4.7.2-stable 源码(445 MB,gitee 镜像)+ 官方 demo 目录树,出
文档里点名的符号现在有判据了(附录 B.8 那条做成)
- 新增
tools/ci/check_doc_symbols.py+ CI 一步(117→118 步):状态文档里反引号点名的me_*必须真的存在;范围是docs/**减 adr/proposals(那两卷在说「打算建什么」)。 - 逃生阀不设白名单:讨论它的那一段得自己承认它不存在。粒度错了两次——按行(正文硬折行,一句话跨行)、按句(词表一下午加三次),最后收到段级。
- 「存在」的定义收紧三次,每次都是踩出来的假绿:注释里提过不算、README 里不算、
interface/MANIFEST.json里记着「v31 已删 me_rhi_draw」也不算(删除记录被当成存在证明)。 - 收紧后真实 5 个符号 / 12 处,全带备案。与手数报的 2 个对不上是因为旧口径——两件事分开记。
- 判据先挑出我自己新写的那段 B.8(列了 5 个不存在符号而整段没说「不存在」)。
- 顺带:S19 两条 DoD 据实测打勾(capi 43=43 双向差集空;IR 两条逐字节测试跑绿);M0.9 第 3 条两条腿今天重跑(跨机 20/1/0、同机 20/1/0)后打勾;S18 那条 draws 判据没勾并写清缺的是哪一段。
- 降级表按「拿真实输出对表」核了一次,补登
SHELL-PROBE-WINDOWS与XSECTOR-EXPIRED;这条方法本身记进了手册。
- 新增
2026-11-10
S17-3 落地:动画系统的 Metal 原生渲染(main 96d7a01d)
- 一条链上两处断裂,两处都不报错:① MSL 出口只有精灵管线,
create_pipeline用Unsupported拒绝非 GLSL 后端;② Metal 后端 3 个 uniform 槽 vs 契约 131 个 ⇒upload_palette写到第 4 个 vec4 就 InvalidArg。 - 补法:msl 四条蒙皮出口(调色板
constant float4* u_bones [[buffer(4)]]);后端骨骼段 128 个紧凑 vec4 合并成一次上传(64 字节存法会 8KB,超 setVertexBytes 4KB);program*按ShaderLang分派。 - demo
apps/anim-metal/:6 节骨骼链,12 帧 PNG + 拼图,bash apps/anim-metal/run.sh。 - 判据:只换调色板(0°/90°)看象限搬移 —— 绑定姿势下任何不生效的调色板都画出同一幅画;131 槽逐个写得进 / 132 必被拒。反向实验四个全红。
- 收尾三件:漏同步两份 wasm 快照(CI 拦下,体积不变 md5 变,368 字节);
emit_msl覆盖面缺蒙皮(8→12 份 + 脚本点名);图集真机探针一次抖动(单跑 18 条全过)。 - 全量 CI 964s 通过,6 条提交合入,main = 96d7a01d,四条 land 判据(树一致 / 每条都是祖先)逐条验过。
- 一条链上两处断裂,两处都不报错:① MSL 出口只有精灵管线,
2026-11-07
S13 的止损线第一次被真的跑起来,它没过
- §15 的 DoD 第一条「100 个刚体堆叠 10 秒:不炸、不穿、不抖」此前没有任何判据,
me-rigid2d76 条里规模最大的是 6 个体。今晚补tests/stack100.rs(9 条),第一次跑就红了。 - 读数:穿透 0.98px、堆顶下沉 200.5px、水平漂移 289.0px。锁住旋转则漂移变成 0.00 ⇒ 塌是转动问题(2 点流形被顺序求解,合起来带净扭矩),不是位置解算发散。
- 把
LINEAR_SLOP降一个量级(0.5→0.05)不解决翻倒(漂移 197px),只把穿透压到 0.72 ⇒ 两个病,一个参数治不了。 - 两处 DoD 与实现打架:① DoD 的 0.5px 与
LINEAR_SLOP = 0.5是同一个数,十层累计必然越线 ⇒ 这条 DoD 在现有参数下不可能成立;② DoD 第二条的「贝塞尔求根」没有实现(poly只有二次求根)。都记在N-357等 A1 拍。 - 没动求解器。判据分两档:默认档只断言今天成立的,
STACK100_STRICT=1才断言 DoD 四条 —— 免得它落地第一天就红然后被#[ignore]掉。 - 顺带:
me-math补了tests/against_f64.rs(12 条、120 万组采样、0.08s),这是 DoD 第二条此前完全没有的一层。
- §15 的 DoD 第一条「100 个刚体堆叠 10 秒:不炸、不穿、不抖」此前没有任何判据,
2026-11-01
动画系统:路径四格演示落地 + chainScale 补完
path_lab四格演示页落地(等间距 / 链式 / 按骨长 / 位置是状态),自检PATH LAB OK 16/16,两张证据图入库- 页面读 Rust 算的两个误差(间距 px / 朝向 rad)—— 这一页的观察点在顶点数组里看不出来
RotateMode::ChainScale补完:Bone一直有scale_x,当初"骨长刚性"的跳过理由是错的- 判据四条(含一条跨模式比对:位置与朝向与
chain逐位相同) - 全量 CI 绿(271s / 4 项既有降级),两批都已合入 main
2026-10-31
RHI 契约 v24–v26:一位没有宾语的能力、另一半在胶水里、第一次 bump ABI
- v24
RGBA16_FLOAT:FLOAT_RENDER_TARGET这一位从 v1 就在、档位模板里有、satisfies拿它判定,而契约里一个浮点格式值都没有——这是 §D6 规则 1「报了的必须能用」的反面:报了一件没有宾语的事。选 16F 不选 32F(GLES3.0 core-filterable;MetalRGBA16Float=115 从 A11 起可渲染可混合),顺手补上 v21 漏置的CAP_SURFACE_BGRA8(同一次回答里两个答案)。 - v25 上下文丢失那一半:契约说「丢失后
capabilities只清CONTEXT_READY一位、其余原样」,Metal 侧照做了、判据也有,而胶水me_gl.js返回 0(整片清零)——两条实现说同一件事、一条对一条错,而错的那条才是线上的那条(wasm 分支才是宿主跑的),且它在 Rust 测试里跑不到。补webglcontextlost监听 +onContextLost钩子(轮询能回答但不通知,症状是「帧还在跑、画面不动」);胶水刻意不调preventDefault——那是在说「我要恢复」,而恢复要重建整份实例,那是宿主的策略。 - v26 表面格式的哨兵:
surface_desc.format的0从「让后端挑」改成「明确要 RGBA8」,哨兵挪到SURFACE_FORMAT_AUTO = 0xFFFF_FFFF,第一次 bump ABI(7→8)。起因是 v21 记的那笔债:0同时是TEX_RGBA8的编号 ⇒「我要 RGBA8」在表面上无法表达,而 v21 的对策是让surface_caps.formats[]只报一款——那不是后端的事实,是我们自己的编号问题。 - 判据:三条新判据 + 各自反向实验(把 0 读回「你挑」/ caps 少报一款 /
flags位 0 写成常量,三次都红在对的断言上);胶水 52 条 / boot 19 条全绿;全量 CI 278s / 290s / 293s(8 项环境降级,无真红)。
- v24
2026-10-30
GPU 对账第十组 alphaacc:清屏 alpha 设成 0,顺手查出「量化规则是路径相关的」
- 为什么动清屏色:前九组期望里 alpha 全是 255,而那是恒等式
出a = a + 255×(1-a/255) = a + (255-a) = 255——背景不透明时 alpha 怎么画都等于 255。所以「两层半透明叠起来 alpha 该多少」九组一次都没验过(blend_ladder与stack_ramp两处注释都写着「这一格我只能承认它测不到东西」)。要让 alpha 离开这个不动点,只能让 dst alpha 从 0 起步。 - 结构改动:
Scene多clear: [u8;4],cpu::render/gpu::draw/compare::compare各多一个清屏参数。九个既有场景全填BG,实测前九组的差异像素数与上一轮逐个相同(这比「我觉得没影响」值钱)。新组用[26,28,32,0]:RGB 与 BG 相同,画面看起来一模一样。 - 数字:源色 (76,53,57)、a=51 → 一层 (36,33,37) a=51;两层 (44,37,41) a=91.8→92。源因子若写成
SRC_ALPHA,两层是 18(51×.2 + 51×.8)——差 74 位。演练(改me-swrast的blend()):alphaacc 差 80000 像素、最大差 74;blend也红(差 64);order差 41;additive/stack一个像素没动(alpha 恒饱和,与 README 早写的一致)。 - 它没红,而这件事本身是最大的产出:91.8 在两边都是 92,一个像素都没差;而第八组
tex同样是.x却全部差 1 位。两件事放一起才说得清:混合之后的量化两边都四舍五入,而「着色器直接把颜色写到渲染目标」那一步(Blend::Off)是截断的。 那条 1 位差不是「这台 GPU 的量化规则不同」,而是「不同路径的量化规则不同」——第八组那个「契约没写」的缺口被缩到了具体一步上。 - 静默的账:动机是「alpha 一次都没被测过」,演练完发现说过头了——
blend组靠「五档期望值全是 255」这条恒等式本来就能分辨源因子(写成SRC_ALPHA时 a=128 那档给 191,差 64)。准确说法是「它只在饱和那个不动点上被测过」;这一组真正多测的是非饱和区间的累积。已写进 README,免得后来人把「alphaacc 也绿」读成「alpha 全都验过了」。 - 还差:三层以上(第三层 RGB 就不再是整数,会把「量化差 1」与「算错了」混在一起,要另挑一组颜色);「混合 + 纹理」(
texture × 顶点色的 alpha 怎么参与混合);mip / sRGB / 各向异性;sort_y/layer/z的排序语义(三字段全填 0,排序没实现)。
- 为什么动清屏色:前九组期望里 alpha 全是 255,而那是恒等式
GPU 对账第九组 order:契约只写了「调用之间」的顺序,没写同一批里图元的先后
- 补的是上一轮列的空白 #2:前八组对「谁先谁后」一个字都没说过——
stack摎内坐标完全相同(正着倒着一样),其余七组连重叠都没有。查契约才发现答案半个在半个不在:rhi.ffi.h那句「后端必须按调用顺序生效」说的是 set → draw_bound 之间;同一批里图元的先后一个字没提。而真实管线会把半透明攒批最后合成(SpriteInstance带layer/z/sort_y,本工程全填 0),一旦攒了中间夹不透明的必须先切断——顺序与「必须切断」是同一件事。 - 道具:两块逐字段相同的几何按相反顺序提交(红 a=51 → 黄 a=255 → 蓝 a=51 得
(206,208,76);倒过来得(251,208,32),差 45)。场景自带差分:顺序被忽略时两簇同色,抽查点必红一个,不必另写自检。 - 能要求逐像素全等,因为中间那层
a=255把 dst 抹成纯色 → 两侧各只剩一次混合、每步都是整数(26×0.2+251×0.8 = 206.000003,浮点噪声在整数上方,round 与硬件截断同答)。代价:中间那层不能改半透明,改了就得放宽到「最大差 ≤ 1 位」。 - 两次演练红的形状不一样:① CPU 那半倒序提交 → 前八组一个像素都没动,order 差 259200、最大差 45,抽查仍 5/5(比的是 GPU)——这是「前八组对顺序无感」的实测证据;② 右簇改成和左簇同序 → 逐像素差 0、覆盖全对,只有两个抽查点红——顺序被无视时,逐像素那条判据是瞎的。
- 抓不到的四条:alpha 累积(
a + 255(1-a/255)恒等 255,九组帧缓冲都从 alpha 255 起步)、每层舍入(全整数)、真正的排序键(三字段全填 0,排序没实现)、「多算一遍但算对了」(a=255 时与直接覆盖同字节)。 - 顺手补的账:上一轮只重生成了
me-soft2d的 FUNCTIONS.html,而「apps/physics-lab 的 N 个场景」印在四份清单页首,场景数一变四份一起过期(CI 只红三份,第四份恰好是我改的那份)。教训:生成物挂在「别的东西的计数」上时,那份计数有几个落点就得重生成几处。 - 操作纪律一笔:
git push的 pre-push 钩子会整跑 ci.sh(7 分钟),我在它跑的同时又起了一份自己的——两份 CI 在同一工作树里并行,都写dist//host-wx//site/,第一次 push 就是这么红的。一个工作树同一时间只跑一份 CI。
- 补的是上一轮列的空白 #2:前八组对「谁先谁后」一个字都没说过——
physics-lab 第 20 格:布落在球上——一次位置推离,逼出两条被实测否掉的判据
- 补的是
push_out_of_circle从没进过演示的空白。做法只有一句:Verlet 里速度是pos − prev的差,所以每帧把跑到球内的点推回球面、不动prev,就等于给点一个朝外的速度突变——布自然滑下来,不需要摩擦、不需要冲量、不需要接触流形。整个实现是一行调用加一个spheres: Vec<Sphere>字段。 - 四条判据,缺一条就只剩一张好看的图,因为假绿各不相同:每帧每点不进球(实测最小距球心 90.00 = 半径,但球不在布的路上时会假绿)· 布真的贴过球面(100 点,门槛 40,但布从旁边滑过时会假绿)· 关掉推离就穿过去(最小距球心 0.32,差分守的正是上一条的假绿)· 末帧落到地面(540)。
- 两次演练分别红了 3 条与 2 条,且第二次演练中判据 1、4 仍然绿——这就是「球不在路上时它们会假绿」的直接证据,不是推理出来的。
- 写的时候两条判据被实测否掉:我原以为末帧布会卡在球内、两侧都有布;实跑是球内 0 点(布已落到球下方)、左 0 右 233(整块滑向一侧)。按实测改写,理由写进
tests/ball.rs文件头。 - 判据的常量不许手抄:演练时手抄了
const C = [480, 380],球被挪走后判据还在找旧球心——「测试常量过期」比没测更坏。改成引用scenes::BALL_CENTER / BALL_RADIUS;「从没发生」用Option<usize>而不是usize::MAX,否则报文印出「第 18446744073709551615 帧」。 - CI:场景数 19→20,加一份独立的
--test ball日志,结论行加「· 落球 N passed」;函数清单补上第 19 格落地时欠的19 + 41 → 20 + 41。 - 还差:布擦着球滑(摩擦/无摩擦两版对比)、布把球压弯(球目前是无限硬),两面都写进 README 的边界表了。
- 补的是
GPU 对账第八组 tex:纹理一上,撞出的不是 bug 而是契约没写清「怎么量化回 8 位」
- 前七组的纹理验算量是零:两边都用 1×1 白纹理,双线性采样只有一个点,mip / wrap / 线性与否一个字节都没碰过。第八组把纹理真的接上:
TexKind::White/Grad4,一块 4×4(R = 16(x+4y)、G = 240−R、B 在 (1,1) 挖一个 0、A=255),三块几何分别是 放大 80×(测插值)、1:1(测索引)、UV 子区域(测 UV 有没有真被用上)。 - 撞出来的不是 bug,是契约缺口:188030 / 204816 像素差 1 位,最大差 1。三个抽查点把数解释干净——
31.7→31、167.75→167、15.95→15,全部向下取整。根因:me-swrast在blend()末尾写out[0].round(),而 D3D12 的R8G8B8A8_UNORM是硬件截断。两边都对,只是契约里没写这一步该怎么量化。 - 判据因此改口:从「逐像素全等」改成「最大差 ≤ 1 位」,另加「
gross(差 > 8)必须为 0」把「量化」与「两个渲染器算出了不同的东西」分开。按像素比例判会红成笑话(91.8% 的像素都差 1 位);按位判一句话说清。跟 d3d12 那个 alpha 通道 bug、Metal 交接里「预乘 vs 非预乘」完全同构:契约里只要有一句话可以有第二种读法,就会有第二个后端读出第二种。 - 找到了「两边一起错」最干净的实例:把两侧同时退回白纹理 → 逐像素差 0、覆盖全对,前六条判据绿得毫无破绽,只有新加的「通道不变式」破 204816 像素。这条不变式好用在不依赖插值权重:四个权重非负且和为 1,所以对任何权重
R+G=240都成立 —— 不经过任何手算,也不依赖-0.5有没有写对。 - UV 盲区的实证:把
push_quad的 UV 改回常量 → 190947 像素差、最大差 96,但六个抽查点只红 1 个(子区域那块)。没做第三块的话整组对「UV 没接上」完全无感,而cpu.rs那一行在加这组之前正是写死的。补第三块是被「with_uvnever used」这条警告推进去的,不是设计时想到的。 - 半像素偏移仍然没被钉住:采样写的是
t = uv*size − 0.5,缺了-0.5整张图平移半个像素;Grad4是双线性可再生的(ramp 在插值下不变),所以这个错法测不出来。要么换一张高对比棋盘,要么承认这块还空着——已写进 README 的未验证清单。 - 两个小设计:① 「不查 max_delta」不能用
255当哨兵(matches!(Some(md) if md > 0)会把spin组吸进量化分支),改用Option<u8>:None/Some(0)/Some(1),「不查」是类型上不同的东西;② 抽查点吃同一容差、逐通道比,不让一个通道的误差抵掉另一个。 - 验收:完整 CI 451s 通过 · 6 项降级,GPU 那步报「八组对账全绿 · axis/half/blend/additive/stack 逐像素全等并抽查 6/6/5/5/5 · tex 最大差 1 位并抽查 6/6 · towers 差 9 个像素(边界)」,结论行加「· tex 最大差 1 位并抽查 6/6」,组数门 7→8。
- 事故一笔(已记在 commit message):python 批量替换
!= "7"→!= "8"误伤了 2721 行那条ARC_N判据(不是我写的),发现后断言 + 还原。批量替换必须带上下文断言,不能只匹配「看起来唯一」的短串。 - 还差:mip / sRGB / 各向异性没验;叠加的顺序语义仍未做(
stack摞内坐标完全相同,正着叠和倒着叠一模一样)。
- 前七组的纹理验算量是零:两边都用 1×1 白纹理,双线性采样只有一个点,mip / wrap / 线性与否一个字节都没碰过。第八组把纹理真的接上:
2026-10-29
GPU 对账第七组:四摞完全重合的色块,把「不累积」这种错法逼出来
- 前六组一个重叠都没有(
blend那句注释明写「互不重叠」,是为了让几何上没得错)。代价是累积从来没被验过:每块色块只混合一次,于是「每画一个矩形都从干净背景重新开始混」这种错法六组全绿——它只在东西压着东西时才显形。 - 新场景
stack:四摞完全重合的色块,摞深 1/2/4/8(共 15 个 quad),加性混合。演练(CPU 侧改成「每个矩形单独画到干净背景再取并集」=不累积):axis/half/spin/towers/blend/additive 一个像素都没动,stack差 124800 像素、最大差 140。124800 = 166400 − 41600,正好是「除第一层外所有层覆盖的像素」——数对得上,说明红的原因就是缺了累积。 - 为什么能要求逐像素全等:
a = 51(51/255 = 0.2),源色 (100,50,25) → 每层增量 (20,10,5) 全是整数,一次舍入都不发生。四摞期望值 (46,38,37)(66,48,42)(106,68,52)(186,108,72) 是手算的,跑出来逐格相同。代价如实写进注释:测不到每层的舍入规则(两边一个向上一个向下也永远落在整数上),测不到叠放顺序(摞内坐标完全相同)。要测舍入得用增量带小数点的场景,那会引入「不同 GPU 在 .5 上的 tie-breaking 不保证一致」——把一条硬判据换成一条偶发红的,不值。 - 破坏性改动:
geom::spec_of()从(usize, usize)变成Spec { quads, area, cover }。stack是第一个「面积和 ≠ 覆盖像素数」的场景(15 个 160×260 = 624000,画面里只有 166400 个像素被盖到),沿用「覆盖率 == 面积和」会红 457600 个像素而画面完全正确。调用点只有一处。 - 顺手补上第 2 条判据的第一次红:覆盖率那条此前是五条里唯一「没有一条演练证明它会红」的(README 里如实写着「没演练到」)。
stack给了干净坏输入——四摞间距 220→120 互相重叠,并集 166400→135200,而个数与面积和一个没变;第 3、4 条都绿,只有第 2 条说话。 - 这次演练抓出一个报文缺陷:抽查点一红就无条件顶掉
judge()的报文,把「覆盖 135200 ≠ 166400(偏 18.75%)」整句顶掉了,屏幕上只剩「抽查点错 4 个」——去查覆盖率的人会被带到完全无关的方向。改成两句并列:红几条就说几条。 - 前一轮欠的账:第 19 格(浮力)落地时忘了重新生成
crates/me-soft2d/FUNCTIONS.html,页首「18 + 41」不会自己变 19,CI 的清单那步(--check逐字节比)会红。已重生成。 - Metal 收编交接:
Team/notes/metal-handoff.md九节 + 跨扇区登记(复核 A2+A3,11-19 到期)。性质写清:本机没有 Mac,那 2509 行一行都没跑过,是「要人验的清单」而不是结论。核心判断——预乘 alpha 是收编唯一需要改契约或改数据的地方,与 d3d12 那个 alpha 通道 bug 完全同构:契约一句话有歧义,两个后端长出两个答案,而各自的单测都绿。 - 验收:完整 CI 整跑 381s 通过 · 6 项降级(Mac / 微信 / 代修待复核那些环境限制)。GPU 那步报「七组对账全绿 · 逐像素全等并抽查 6/6/5/5/5 · 7 组都在」。上一轮 507s 那次是红的——
tools/ci/ci.sh被批量替换写成了 CRLF(shebang 变bash\r),已转回 LF。 - 还差:混合 + 纹理(1×1 白纹理,采样只有一个点)、叠加的顺序语义(要先确定引擎承诺的是哪一种,当前没有答案)、以及「每步量化回 8 位」本身(整数增量把它绕过去了)。
- 前六组一个重叠都没有(
动画系统 S14-1 / S14-2:骨骼层级 + 关键帧时间轴,确定性变成会红的判据
新建
crates/me-anim(L4/A2),S14-1 与 S14-2 两批,判据 57 条全绿、CI 整跑通过 (270s)。- S14-1:
Affine2/Bone/Skeleton/ 五种 SpineInherit,五种继承各断言世界矩阵六个分量。 - S14-2:
Curve/Interp(线性·阶跃·贝塞尔)/Track+blend/blend_angle。 - 真正的交付是「确定性」:三张 golden 表(16 角度 sin/cos、骨骼世界矩阵 6 分量、贝塞尔反解 12 采样点),host 与 wasm 逐位相同,CI 里一步跑。这是
me-math存在理由的第一个硬证据。 - 贝塞尔反解用固定 20 轮二分而不是牛顿:牛顿的终止判定是浮点比较,可能在不同目标上于最后一次迭代分叉。
- 顺手查清两个别人的文件里的真 bug(已报备不代修):
build_crate_docs.py的 H1 标题死循环、check_commit_msg.py在本地已发散时的假绿窗口。 - 待办:
crates/me-anim还没进plan/agents.json(A1 的活);下一步是 S14-3 GPU 蒙皮 —— 那是「超越 Spine」的主攻方向。
- S14-1:
特效系统 me-fx2d:粒子 + 时间轴 + 真的会弹会溅(两个真 bug 是判据抓的)
- 两块不是一个东西:粒子回答「长什么样」,时间轴回答「什么时候」。只有粒子是一团永远在喷的火,只有时间轴是一串没有内容的时间点。为什么是 L5 不是 L4:刚体守动量、软体守边长、流体守不可压,都有方程;而「这团火星对不对」只有「像不像」。硬塞进 L4,第一个破的就是「物理层只放守守恒律的东西」。也不放进
me-render(渲染不该拥有「什么时候爆炸」这种玩法级时间,且 owner 不是 A3)。 - 弹射两个必须一起做:① 先按穿透深度把粒子推出去再改速度(只反射不改位置 → 粒子留在盒子里 → 下一帧又撞 → 看着像「在里面抖」);② 用相对速度(含
ω × r),否则横扫过来的挡板只是把它自己的速度还给粒子。 - 溅射三条:冷却 0.12s(地砖是拼的,一次撞击被两块体各判一次 → 同一点溅两簇;卡墙角则每帧一簇「持续喷水」)+ 每帧预算 24 个 + 数量
min(2 + ⌊speed/400⌋, 8)(150 像素/秒 → 2 个、900 → 4 个,是取整台阶不是线性,否则读数不可复现)。 - 粒子不推动刚体:反作用力是
World::explode那种一次性的活。每帧几千个粒子各给刚体一个力,会让刚体行为取决于粒子数量,而粒子数量取决于容量与帧率 —— 等于让物理结果依赖性能。 - 两个真 bug,都是判据抓的:①
next_f32只覆盖[0, 0.5)(xorshift64* 取了 31 位再右移 8),而当时那条0 ≤ v < 1的判据全绿;抓住它的是另一条「圆盘取点是否面积均匀」——1000 点里 509 个落在半径一半内(应该 250)。② 曲线在同一时刻取了前一个关键帧(按「哪一段包含 t」搜,落点上前一段先命中),at(0.5)给 2.0 而那个关键帧是 3.0。 - 一条绿着的假话:
a_settled_spark_stops_splashing第一版池子只有 512,溅射粒子填满后splashes因为「发不出来」停止增长,于是「停止溅射」在行为已经坏掉时通过。修法不是改判据,是池子给到 8000 并断言dropped == 0;顺带发现计数器在没设溅射发射器时也会 +1,计数器和现象不一致本身就是谎话。 - 演练:
drill-fx.py7 条全红、还原后全绿。脚本自己踩三个坑:--exact只认完整路径(单元测试名带rng::tests::前缀 → 一条都过滤不到、退出码 0,于是「七条全过」是空转);「一帧只放一个 cue」改内层while→if不红(外层while remain > 0会补上),变异点必须挑到remain -= to_next;「曲线取前一个关键帧」改上界搜索后那段成了死代码,变异它等于变异注释。 - 验收:25 单元 + 12 场景 + 2 doc test 全绿;清单 186 项 / 102 函数 / 102/102(每个公开函数在演示里真调一次,构建时校验);
--api-tour24 → 32 行,读数真跑(掠射 15° 只偏 30°、溅射 150→2 / 900→4)。 - CI 两处范围修正:清单检查从只查
me-rigid2d扩到三个 crate(原来另两个的清单可以一直是旧的、甚至没生成过,而 CI 全绿);新增「me-fx2d依赖面只许me-math+me-rigid2d」—— 随机全来自自己的Rng,哪天拉进rand,「同种子两次一样」照样绿。 - 还差:演示工程没有可视的粒子关(场景数仍是 12;要做得让
Spec带粒子流、viewer.rs与关键帧光栅都会画粒子,同时改 CI 里「场景数 = 12」那条);me-fluid2d仍是骨架;软体那 6 条判据还没演练红。
- 两块不是一个东西:粒子回答「长什么样」,时间轴回答「什么时候」。只有粒子是一团永远在喷的火,只有时间轴是一串没有内容的时间点。为什么是 L5 不是 L4:刚体守动量、软体守边长、流体守不可压,都有方程;而「这团火星对不对」只有「像不像」。硬塞进 L4,第一个破的就是「物理层只放守守恒律的东西」。也不放进
2026-10-28
物理三件套:刚体补磁铁/射线,新建软体与粒子流体,数学统一到 me-math
- 规划里原本没有物理(P0 砍掉清单原文「物理(2D 用简单 AABB)」),今天作为计划外补齐为三个 crate,按「守什么不变量」分家:刚体守动量、软体守边长与形状、流体守不可压。
me-rigid2d补玩法级五项(层掩码、射线、区域查询、持续力与扭矩、力场/磁铁),36 条场景判据全绿,公开面 193 项 / 109 函数,109/109 都在演示里真调过(构建时校验)。me-soft2d新建:6 条判据全绿。果冻的「软」是量出来的——带对角约束的grid残余偏差 0.0 像素,必须用只有横竖边的block;形状匹配每步只能跑一次,放进迭代里 8 轮×0.1 会让果冻被戳只动 0.0 像素。me-fluid2d新建:双密度松弛 + 计数排序空间哈希(不用HashMap,迭代顺序会漂)。能编过,但参数标定、判据、演示场景都还没做,这条不算完成。- 数学统一:推翻「物理自己写
sqrt/det_sin_cos、两份实现互校」——me-math守得更硬,互校能发现「算错」但发现不了「两边差着用」。math.rs改成门面,cross_math.rs删除。 - 文档同步:
docs/01§6.1 从 20 个 crate 改为 22,新增 §6.3「物理为什么是三个 crate」。改之前build_arch.py --check是红的(两个新 crate 在图上有、表里没有)。 - 站点
/arch//docs//board/三页已重建;/board/extras 追加这一条,--fmt后--check通过(110 任务 / 62 完成 / 22 crate)。 - 还差:流体标定与判据、软体判据演练红、三 crate 的 clippy/fmt、演示工程的磁铁/布料/流体三类场景。
帧率归因:引擎只花 1~5ms;十二个用例全加动画 + 第 13 项「角色与关卡」
先量再答:帧率不是引擎的事 原 HUD 只有一个帧率数,而「引擎慢」和「宿主不给帧」在数值上一模一样、修法却相反。加第三行「引擎 x.x ms · y%」(量一次 frame 调用的墙钟)后
.6实测:平铺 73fps / 引擎 1.5ms、规模 84fps / 4.5ms、角色 73fps / 1.3ms ⇒ 引擎只花 1~5ms,73/84 是抖动不是锁频。顺手拿掉preserveDrawingBuffer(每帧多一次全屏拷贝)与 HUD 每帧写 9 次 textContent。动画:t_ms 一直有,没人读 十二个用例无一读
Params.t_ms⇒「静止」是漏了不是设计。两条硬约束:① t=0 时逐顶点与旧版相同(判据/截图都跑 t_ms=0)⇒ 只用 sin / fract,一个 cos 都不要;② 只改位置/uv/颜色,不改精灵数与贴图交替顺序。翻转块从「1.8s 硬切」改「按 |cos| 压宽、过零换 uv」—— 硬开关时 t=0 与 t=1200 都落在不翻转那半、截图逐字节相同,看着像没生效。新增?t=毫秒,已验 6 项 t=0/t=1200 不同。第 13 项「角色与关卡」 夜空 + 地面带 + 主角(走/转身/跳)+ 两只史莱姆 + 三枚金币,9 批 16 精灵;四张素材走云函数 genImage。三个坑:抠图不能按 RGB 距离(背景 18~25 渐变暗灰,要按亮度分档:背景 18~25 / 描边 0~11 不重叠);
square()补边默认纯黑正落进「描边保留」档;content_box()阈值 26 是给纯黑背景写的,暗灰上判出整张图 ⇒ 只剩右下水印被裁进精灵。水印三分:图标裁、整屏背景镜像补、平铺砖回原坐标补(uv 内缩 5% 躲不开横跨 66%~100% 的它)。平铺重写:原按视口 88% 排,加平移立刻露黑边(深色画布上 = 渲染坏了)⇒ 铺满视口再多一圈作余量,
tile_layout()场景与判据共用。验收:cargo test -p me-render 全绿(lib 268)、clippy 0 warning、CI 全绿(30 项 · 2603 测试)、无头与 .6 真机均 13/13 PASS 且读数逐字一致;wasm 606,464 → 611,090 B,无新 import,三份副本 md5 一致。遗留:「着色」第 7 块挤在最右(六格后只剩 64 px),功能对但构图偏挤。
SPRITE 演示工程 —— 12 项功能巡览(参考 Cocos SpriteTest,图全是算出来的)
产物是画面,不是判据:与上一轮
sprite-lab(回答「特性生效没有」)分工不同,这一页回答「精灵能干什么」。判据只核三件(frame 返 0 / 批次 ≥ 1 / 未贴图批 = 0),故意不核精灵数。只借结构不借资源:Cocos 源码在
tao-lan:(本机路径)(不在本机)。看01.sprite九个场景 +staticScene的 sort/batching/opacity,但cocos-test-projects无 LICENSE ⇒ 7 张贴图全部代码算出。12 项:基础与过滤 / 九宫格 / 图集取帧 / 裁剪与留白 / 平铺 / 填充 / 旋转与缩放 / 翻转 / 着色 / 排序 / 合批 / 规模。
.6真机与无头 SwiftShader 都 12/12,读数逐字相同:1=2/4 2=1/37 3=1/20 4=5/16 5=1/64 6=3/57 | 7=1/24 8=1/8 9=2/13 10=3/24 11=66/129 12=1/1000(批次/精灵)。表比截图信息量大:第 1 项 2 批 =
T_QUAD与T_QUAD_SMOOTH像素相同、只有过滤不同,仍然断批;第 11 项 66 批/129 是故意的反例(交替贴图 + 递增 z)—— 不是合批退化,是合批的定义。三个取舍:
scene()返回多遍(排序是整份列表的属性,一帧里看三种排序只能提交多遍);绕开probe骨架(受控例外,守卫改三分类 + 名单过期断言);例外拿掉的是配平 ⇒ 补「连画两帧都成功」判据。五处观感缺陷全是截图看出来的、判据一个都不报:九宫格切边太细 / 裁剪右侧放大成两倍 / 填充扇形条有缝 / 旋转两件事没拆开 / 排序超出画布。
提交:
22a3a05(源码 2331 行)/78627dd(wasm 575.6→591.5 KB,+11 导出)/d71bc0c(§82)。SPRITE 实验室:8 项功能矩阵 + 36 格阶梯,一次 draw call ≈ 10µs
- 新落点
crates/me-render/src/wasm_lab.rs+crates/me-render/tools/sprite-lab/,一行没进apps/(apps 归 A3)。它不 import 游戏,也不需要游戏存在。 - 功能矩阵 8 项(实心 / 四象限 / 旋转 90° / UV 裁剪 / 翻转 / 半透明 / 合批 / Z 序):
.6真 GPU 8/8,无头 SwiftShader 也 8/8。 - 贴图用 8×8 四象限而不是单色 —— 裁剪/翻转/旋转/图集取帧都只改「哪块纹素落到屏幕」,单色下四种改动一个字节都不变。
- 阶梯 36 格(N=125→10000 × 6 组状态位):一次 draw call ≈ 9.9µs,跨三个数量级稳定;1000 批 ≈ 10.6ms = 16.7ms 预算的 63%。旋转/缩放/裁剪/染色/透明合计 <15%,换贴图 4.4 倍。
- 判据分工:不变量(覆盖率/批次数/顶点数)进
#[cfg(test)]13 条;颜色金标只能真 GPU 给,记在页面。 - 三次判红都红在判据上(染色是否断批 / 旋转方向 / a/b/c 全按颜色印),已写进状态文档 §80.3。
- 另外:产品页
?level=N直进关卡接上了,并撞出并修掉一处归因缺口(trace_start的归因在start重建 Game 时丢失,.6上组 0→9、残差 100%→0%)。
- 新落点
M0.3 ④ 真机 trace 接上(归因 9 组残差 0.0%),并查出 ② 在产品页上未达
- M0.3 ④(真机 trace 回传编辑器)第一次有真机证据:产品页默认就在采 trace(
CoinBoot.traceStart(ex, 600)),缺的是导出口 —— 只有按 T 下载 JSONL 和 console.log,真机上两样都没有。页面加了?trace=<毫秒>:跑满 N 毫秒把统计与归因压成一行回传/verdict。 .6上读数:TRACE-PAGE OK 600帧 归因帧 944 组 9 批 8496 残差+beyond 0.0% dt_p95 36.5ms busy_p95 2.2ms fps 47.4 canvas 1920x1080 css 816x460 dpr 1.5。归因落在 9 个 MIR 节点组上、残差 0.0%,一帧画的东西全部能指名道姓。- 顺带发现 M0.3 ② 在产品页上未达:同一台机器同一关,判据页
m03.html是dt_p95 17.0ms/60fps,产品页index.html是33.3ms/47–53fps。原因量到了 —— 产品页背板 1920×1080,而屏幕上那格是 816×460(dpr 1.5 ⇒ 1224×690),每帧多画 2.45 倍再缩下来,而busy_p95只统引擎侧 GL(2.2ms)。 - 背板 A/B(B→A→B):换成 1224×690 ⇒ fps 47.3 → 52.6、JS 堆 34.3 → 18.8MB,但
dt_p95仍停在 33.3。默认值没动:像素判据都按 1920×1080 建的口径,要 A1 定。 - DoD ② 的措辞有自相矛盾:「稳定 30fps,帧时间 p95 ≤ 33ms」—— 60Hz 上 dt 只有 16.7/33.3/50.0 三档,而 30fps 的帧时间正是 33.3ms,门槛比它小 0.33ms,照字面读任何真正跑 30fps 的机器都不达标。这条实际等价于「丢帧率 <5%」(fps ≥ 57)。
- 新增
apps/coin-run/run-trace-page.sh做驱动;顺带修了自己一处判据错:环缓冲回绕后frames恒等于容量而归因是累计的,accounted === frames会跑得越久越错判,改成>=。
- M0.3 ④(真机 trace 回传编辑器)第一次有真机证据:产品页默认就在采 trace(
M0.3 ②③ 第一次真机测量:`.6` 上 60fps、整进程 RSS 473MB,两条都过
- 判据 ②(中端安卓 30fps,p95 ≤ 33ms):第 1 关 180s
dt_p95 17.0ms(= 58.8fps)、busy_p95 2.6ms;第 12 关 180sdt_p95 17.0ms、busy_p95 2.8ms。余量 2 倍以上。 - 判据 ③(峰值内存 < 600MB):
com.tcl.browser整进程 PSS 峰值 308MB / RSS 峰值 473MB(基线 218MB),都在预算内。扣掉基线的页面自身部分 RSS ≤251MB、PSS ≤87MB。 - 三趟合计 285s 游玩,
wasm 15.1MB 增长 +0KB,与 30 分钟浸泡的 +0KB 一致。 dt_p95顶在上限时它测不出变慢:只要引擎成本在 16.7ms 内dt_p95恒为 17.0ms,要盯趋势得看busy_p95。- 「峰值」对跑之前进程多干净敏感:三连跑基线 157→182→218MB,引用这个数必须带条件。
- 边界:一台机器(
.6)、两关、一轮;.70是飞哥在用的电视盒子,没碰。
- 判据 ②(中端安卓 30fps,p95 ≤ 33ms):第 1 关 180s
M0.6 ③ 收尾 + wasm 降到 MVP(老 WebKit 也能跑)+ M0.3 / M0.6①④ 两台真机数
- wasm 降到 MVP:
build.sh加三个 lowering(sign-ext / trunc_sat / memory.copy-fill),价差 +1478 B / +0.22%。.70(Android 9 · TCL 自带浏览器 · WebKit)从「wasm 编不了、页面全黑无提示」变成能玩:GLLOST-PAGE NEAR 丢前 黑0.0%/步17 恢复 2579ms 黑0.0% 异常 0。加wasm-sec.py --min 0当门。 - D-02 的版本号读错了:之前写「WebView 66」,真正跑页面的是
com.tcl.browser(默认 VIEW 处理者,UA 冒充 iPad)。版本号要从跑页面的那个进程读。 - M0.3 第一次有三个数:
.6dt_p95 16.9ms / PSS 249MB;.70dt_p95 16.7ms / PSS 392MB —— 阈值 33ms、预算 600MB,余量很大,60fps 没掉帧。 - M0.6 ①(限时 1800s):
.61412 轮 / 84720 帧、.701192 轮 / 71520 帧,wasm 线性内存 +0KB,0 崩溃。 - M0.6 ④(100 轮):wasm +0KB;PSS 收尾相对峰值 −11.4% / −0.0%,相对基线 +24.4% / +0.7% —— 两个分母结论相反,采哪个挂 A1。
- 判据工具的三处修补:
soak.html轮数上限 500 原来是静默夹取(cycles=1400跑成500/500轮,看着像跑满了,其实只有 10 分 37 秒),现在会说出来,并新增?seconds=限时模式;dumpsys meminfo在 Android 9 上没有TOTAL PSS:标签,解析器收敛成apps/coin-run/meminfo.sh一份(原来两个脚本各存一份、同时坏);真机脚本加了「收尾」第三个内存读数。 - 六笔已推,CI 每笔全绿(262/249/241/236/238s)。
- wasm 降到 MVP:
2026-10-27
铜钱江湖:背景视差上线 + 工笔侠客 + 地面接缝彻底修掉
已发布(线上
92e1841,HEAD2d197d5)。- 背景有视差了:
Backdrop加step,三块[x, x+3w]才恒包含屏幕(两块会漏半屏,1920 宽从 1496 列起全黑);因子 0.22 是按画面调的。证据:X=700与X=1500两帧互相关最佳位移 −704 px,理论值0.22 × 800 × 4 = 704。 - 真分层拆不出来:需要一张无云远山图。横向插值留水平直条、IDW 留矩形块、按山脚行对齐混回云的青绿,三种都试过,放大 4 倍一眼看出「被抹过」。所以这一版是单层 + 视差 + 镜像平铺。
- 接缝根因不是块边界:
dilate写 RGB 却留alpha=0,混色权重 0 等于没外扩,每个精灵右边缘漏一列半透背景((150,76,50)→(175,122,88))。亮线跟着屏幕走(X=700在 435 列、X=750在 235 列)就是凭据。改成border_alpha:世界图集 255、侠客 0。 - 地面:镜像平铺 → 渐变 + 裁头,烘焙期断言首尾列差 < 12(实测 4.9)。坑从深绿方块换成中性压暗 + 6 单位坑口暗影。
- 判据跟着新美术改两处(撞色,不是引擎错):红袍把「主角专属色」堵死了,换石青云一族三色(41 / 上半段 0);地面换
(105,155,117)且模式改lower(19 299 / 335)。 - 验证:294 测试全绿,
ci.shexit 0 零 ✗,wasm 653.2 KB,发布 23 文件哈希一致。顺手把library/art子模块从42e8761快进到ffeb3af,重烘产物逐字节等价。
- 背景有视差了:
S6-7 引擎侧落地:结构热重载按「身份」接力(并撞出 cooked 的 node 是序号)
crates/me-runtime/src/reload.rs新增:SceneReload::reload(world, index, scene, uids) -> ReloadReport。换一份场景、世界不重启、帧号不归零,不在这份场景里的实体(玩家/粒子/UI)一个字节不动。- 落地前撞到的事:
DrawItem::node是lower.rs:409的node_names.len()+1,即条目序号。文档中间插一条绘制,它之后每条node全 +1 ⇒ 按它接力会把旧实体接到别的节点上,pos被覆盖而账上updated==N看起来完全正常。没有任何一层会报错。 - 解法:身份由宿主带外给(
uids与items()逐条对齐,从 MIR 节点 id 算),NodeIndex的键从此是身份 ⇒owner/拾取/框选/拖拽/补丁整条链自动对上。cooked 字节一个都没动。 - 判据 13 条(
tests/reload.rs)。核心那条的身份故意取成 1/2/3(与序号相同),让「按序号接力」找得到实体——找不到是响亮的,改错了人才需要钉住。演练:换成it.node⇒ 红在updated应为 0 实际 3,且三个实体位置被隔壁内容覆盖。 - 判据抓出真 bug:贴图「没变」不能按下标判(旧表 [a,b] 持 0=a、新表 [b] 要 0=b,下标相同图换了)⇒ 必须比名字、写入写新下标。
- 八个数分开报,
reindexed单列(资产表重排、画面不动):并进updated会让「插一张图」= 「改了 998 个节点」。 - 给 A1 提
N-228(契约 §5 补一句「编号只在这份产物内有意义」)、给 A3 提N-229(/api/build顺带吐uids,不许拿node顶替)。 - 判据:
cargo test -p me-runtime --release全绿(lib 294 + 集成,reload 13)、clippy/rustdoc-D warnings干净、本地 CI 206s · 0 ✗ · 5 项已知降级。 - 顺手订正板上账:
N-313标着「球在 A2」而N-223早答了 ⇒ 已关闭 /N-223待落地·球在 A3。
第四轮收尾:Studio 视口闭环打通(点中 → 拖 → 改)
- 归属表:
DrawList加第二条并行数组owners(UNOWNED = u32::MAX,不进批次键)。不能用push_attributed—— 那个节点号是批次键的一部分,按实体归因会让同贴图的 400 个精灵断成 400 批。 - 撤回一个假缺口:第三轮记的「震屏会连带改剔除」不存在。
Game::step先feel.present(cam)再把同一份交给View,剔除与投影本来就是同一个相机。两种「修法」都不必做,改成一条判据钉住。 - 拖动:新增
me_runtime::gizmo,屏幕位移 → 只改pos的补丁。锚点法(origin + (pointer - pointer0)/zoom),缩放锁定在起手那一刻。 - 闭环判据:点中 → 拿 node → 拖 → 下一帧在新位置点中的还是同一个节点。
- 判据账:三条新模块共 3+3 / 1 / 14+1 条,反向验证 4 + 1 + 5 条全红。
- 教训:判据没红的第四种形态 —— 我把「累加会累积误差」写成了事实,而纯算术的逐步累加是望远镜式抵消的,常规量级下与锚点法逐位相同。判据测不出的性质,不许在文档里说。
- CI 全绿(167~292s,2 项已知降级),
agent/A2领先 main 21 笔。
- 归属表:
2026-10-26
坦克大战的图集与渲染层 —— 现在能把一帧画成 PNG,不需要窗口
- 图集是纯代码画的:8×8 / 16×16 硬边色块,一张外部素材都没有。不是「美术排队先凑合」——这种图用代码画比画笔准,而且可判据(判据能问「炮管在上半部有几个像素」,PNG 不行)。附带好处:不受
library/art队列阻塞。 - 渲染层输出纯数据:
render::scene()把Sim翻成Vec<Cmd>(位置/尺寸/uv/乘色/图层),不依赖 ECS 也不依赖 GPU。于是整套画面能在没有窗口的条件下验证。 - 同一个文件里有个 CPU 软光栅化器(
rasterize),它在产品代码里而非测试里,因为三处都走它:判据、离线截图、以及与真机 GPU 的对照(两条路共用一份Cmd,不一致就说明问题在批渲染)。 - 三处只有看图才发现的错(改到第五版才对):① 老鹰是个蘑菇 —— 翅膀宽度逐行线性张开,画出来是等腰三角形、顶点被头盖住 ⇒ 改成「先张后收」;② 坦克是一根火柴 —— 描边取 42,乘上玩家黄 tint 后变成 15,比战场底色 24 还暗,描边等于不存在 ⇒ 改 86,落在「背景24/描边86/车体172/炮塔255」四层里;③ 水是蓝色砖堆 —— 波纹密度 30% 且每格两道横线、格与格正好对齐 ⇒ 改斜向稀疏(
(x+3y)%16<3,19%),格之间对不齐才像水。 - 15 条判据,6 条反验真红。最有价值的是「树压在坦克上面」那条:把
LAYER_FOREST调到 1,结果是图层判据 + 像素判据同时红 —— 说明像素那条不是靠图层判据吃饭,它自己走完了采样→排序→混合整条链。 - 顺手修的数据问题:三关玩家出生点都在第 0 列(贴左边界,16×16 的车有一半压在画面边缘),挪到第 2 列。
- 一处流程问题:上午请 A1 登记
apps/tank-battle/那次只写进了Team/notes/A2.md(流水),板子上没条目 = 等于没问**。补成 N-216 并--fmt重算汇总表。 - 规模:38 条判据(规则 23 + 渲染 15),workspace 1750 passed;wasm +0 字节(
tank没被 wasm 引用,dead code 全摇掉);CI 224s · 2 降级。提交d38de1a。 - 看画面:
cargo run -p me-runtime --example tank_png -- atlas(图集总览)/-- 1 300(战场)。两个视角都要用 —— 水在图集里看像波纹,铺到 26×26 才看出是砖。 - 仍缺宿主:
apps/tank-battle/未登记(球在 A1);apps/macos-demo/是 A3 共享路径,接窗口要报备。
- 图集是纯代码画的:8×8 / 16×16 硬边色块,一张外部素材都没有。不是「美术排队先凑合」——这种图用代码画比画笔准,而且可判据(判据能问「炮管在上半部有几个像素」,PNG 不行)。附带好处:不受
新游戏:坦克大战的规则层 —— 俯视、无重力、砖两发一块
- 选题:飞哥从 GitHub 候选里挑了坦克大战(Battle City 一类)。参考
feichao93/battle-city(MIT),只借规则与关卡布局思路,美术/数据/代码全自产。 - 为什么是它:coin-run 是横版重力;这一款换掉俯视无重力、地形可破坏、敌人换向打墙、弹道可对撞、字符网格关卡五样,共用 ECS/批渲染/混音器/输入。能跑通横版跳跃,只能说明能跑横版跳跃。
- 落点:
crates/me-runtime/src/tank/{mod,stage,logic}.rs+stages/tank-1..3.stage+ 23 条判据。提交dbc4f62/a2dbcdb。 - 三个设计决定:① 格盘 26×26 个 8 像素格(不是 13×13 个块)⇒ 砖才能两发一块、一发掉半块;② “挡坦克”与“挡炮弹”是两张表,合成一个
solid()水就变砖;③ 全整数,同一段输入跑两遍逐位相同。 - 四处踩到的:炮弹对撞不能用纯 AABB(4px 炮弹每步 4px,一步位移=自身宽度,迎面两发整步互穿);弹头出界撞上
get的越界默认值(钢板)⇒ 没钢板的图报 5 次打钢;关卡只护老鹰头顶、侧面空着 ⇒ 敌人贴侧面打穿,三关全这么输;两条判据是假绿,已改成峰值 + 总开炮数。 - 能看:
cargo run -p me-runtime --example tank_ascii -- 1 120。里面的守卫三关都会输,留着是为了反过来用——它突然赢了就说明敌人 AI 坏了。 - 下一步:渲染层 + 宿主
apps/tank-battle/(需 A1 登记扇区,已发 ask)。workspace 1735 passed,wasm +0 字节。
- 选题:飞哥从 GitHub 候选里挑了坦克大战(Battle City 一类)。参考
跨两个命令的验收补上了:me pack 的账 == 运行时解出的条目数
- 背景:
N-210里我说过「跳命令那条验收只做得到一半」,因为dist/里没有.bin(me pack的接线在 A3,N-039)。那个单落地后这条路通了,补上。 - 判据:
me pack打真工程 → 账本content[0].draws→ 同一个dist里的content/scenes/main.bin用LoadedScene::from_cooked解 → 条目数必须相等。两个数字来自两条独立的路(编译链 /me-cooked::decode)。 - 两份内容而不是一个数:
sprite_scene(4 条 / 3 资产)与layer_stack_scene(9 条 / 1 资产),最后用assert_ne!钉住「两份必须不同」——否则哪天失去区分力还会继续绿。 - 反向验过两条:两份都用
sprite_scene⇒ 红在[4, 4];产物削一个字节 ⇒Truncated { at: 249, need: 4, left: 3 }。 - 两个取舍:①
me路径按 cargo 规则从current_exe推(CARGO_BIN_EXE_me只给定义 bin 的包,即 A3 的me-cli);② 测试里不跑cargo build(执行期抢构建锁 = 自己锁自己,表现为卡住而报错为空)。找不到me时跳过并说明,CI 跑--workspace时 bins 一定会被构建。 - 踩到的红:
check_workspace不许测试里出现cfg!(windows)(平台差异只允许在 pal 层)⇒ 去掉。 - 数字:工作区 1710 passed(+1);CI 通过 125s · 2 项降级。提交
56707bc。
- 背景:
高刷屏上按一下跳会被丢掉:按下边缘在帧层产生,却在步层消失
手机上一半的跳没反应,而电脑上永远复现不出来。根因两条拼起来:① 144Hz 一帧 6.94ms、固定步 16.67ms ⇒ 三帧才跑一步(time.rs 的 advance 自己写着「返回 0 是正常的」);② PadState::jump_pressed 是单帧边缘,只在「这一帧按着、上一帧没按」那帧为真。于是按键落在没跑固定步的那一帧上就静默消失,而它落在哪种帧上取决于按下的时刻 —— 也就是随机。
判据按帧相位扫三遍(只测一遍会有一半概率绿着放行):改前相位 0、1 都丢,改后三遍全跳。
修法的关键是装填位置:窗口在 Input 阶段(帧层)写进 Sim.jump_buffer,在 fixed_step(步层)兑现与递减。在 fixed_step 里装填等于没修 —— 跑 0 步的那一帧没人看 intent.jump,下一帧它就被新的 PadState 覆盖成假了。
技能同一个病,但只给 2 步(33ms):跳跃那 8 步里有一半是手感,而技能在冷却里按的键刻意不兑现(否则「掐冷却」从玩家的操作变成引擎的承诺)。
顺带加了 6 步土狼时间(100ms)。上限由关卡自己给:从 44 的台阶掉下去要 13 步,宽限必须明显短于它,否则修掉一个不一致又造出「掉到半空还能原地起跳」。起跳时当场清掉计数器 —— 不清就是二段跳,判据实测会升 78.1 像素(单跳 56.7)。
六条判据全部反向验过,窗口长度连同常量一起钉住(只钉「实测 == 常量」的话,把两边同时改成 1 也能绿)。
顺手记两个假红:place_player 不动物理体的 on_ground(先判后走会让「落地前 N 步」变成「站着按跳」,rise 恒为 0);以及 wait=0 时量「落地后升了多少像素」恒为 0 —— 那时人已经站住了,第一次看到 grounded 发生在跳完之后。改成量「曾经站住、后来又离地」两种情况都对得上。
数字:wasm 732.2 → 732.3 KB(+134 字节,余量 67.7 KB);me-runtime 431 passed(+7);workspace 1707 passed;十二关机器人全通且逐关币数与改前逐项相同;离屏判据 72/72、SWITCH 12/12;CI 通过 119s · 2 项降级。
包体腾挪:关卡文本压着进包,wasm 769.9 → 724.1 KB,余量 30.1 → 75.9 KB
接完武侠图集后 wasm 只剩 30.1 KB,而下一批素材(怪/道具/存档点/弹丸)估 46.5 KB —— 一接就撞线。先量了字节花在哪:data 62.1%、code 37.4%;data 里三张 .rgba.z 占 353 394,那三张已经压过了,deflate 在 36 351 种颜色的背景上就是 2~3 倍,到顶了。
试过两条「免费的」路,都是白忙:
- 每行按 PNG 启发式挑过滤器(不再一律 Sub):三张合计只省 1.9 KB,世界图集反而 +1 629 字节 —— 启发式优化熵,deflate 抓重复;
- alpha=0 处藏着的 RGB 抹零:透明像素占 39.7%,但 RGB 非零的只有 1.7%,只省 197 字节。
真正压得动的是文本:十二关 .lvl 原文 56 899 字节,是包里唯一没压过的东西。
levels/pack.py把它们首尾相接 deflate 一袋(MLV1 + 关数 + 每关原始长 + 一个 zlib 流),56 899 → 8 626。一个流而不是十二个:整袋 8 572 vs 逐关 23 907,因为字段名/缩进/注释用词高度重复。保留注释(不剥):删了只多省 3 KB,但那样「包是不是最新」就只能靠两套剥注释逻辑互相对齐来证明。留着原文的收益是判据能写成最硬的那种 ——
the_packed_levels_are_byte_identical_to_the_sources拿包里解出来的字节与include_str!原文逐字节比。反向验过:给第 1 关加一行注释不重打包 ⇒ 当场红(56899 vs 56939),改回复绿。顺手踩到的坑:
gen_hanzi.py收字正则不认反斜杠续行(非 DOTALL 下\\.匹配不了「反斜杠+换行」),任何一处续行字面量都会让后面引号配对错位一格。我在断言里写了句续行消息,点阵从 459 字静默掉到 407 字(金币/存档/尖刺/巡逻那批被当成「文案里没有了」删掉)。改单行后恢复 465 字。正确修法(正则加 re.S)会连带把测试夹具的字收进表,另排一笔做。数字:wasm -46 944 字节(余量 30.1 → 75.9 KB,已用 90.5%);data 489 242 → 441 177;code +632(解包与断言)。CI 通过 265s · 2 项降级;me-runtime 424 passed;十二关机器人全通,逐关 coin 数与改前一致(84/96/101/…/172)⇒ 解析结果没变;build.sh --check --browser 72/72、SWITCH 12/12;三份 wasm 副本 md5 一致。
coin-run 换成武侠皮:改名「铜钱江湖」、界面说中文、跑动中有对白
- 改名:
copy.rs成了文案唯一来源 —— 游戏名「铜钱江湖」、十二个中文关名、角色 疾风/铁山、技能 疾行/撼地。画布、宿主面板、官网可试玩页三处一起改(外壳原来是 SWIFT/DASH,同一屏两个名字)。 - 汉字点阵:
tools/gen_hanzi.py用系统 STHeiti 把文案里出现过的字烘成 16×16 1 位点阵(459 字 / 62.7 KB 源码)。8 位要多 8 倍,这是「放得进 800 KB」与「放不进」的差别。生成器--check进 CI:改了文案忘了重新生成,屏幕上是豆腐块。 - 对白:
.lvl里一行talk x 说话人 台词就是一句剧情,十二关共 24 句,一条线「镖银被劫 → 顺着铜钱走 → 终库对上」。跑动中底部弹出,做成字幕条(深底浅字 16.2:1)—— 原来墨字压深色土带只有 3.4:1,而噪声背景上换颜色没有解。 - 三处「排版还按 5×7 算」的残留:技能条压在铜钱数字上;标题页高亮条只包住字的下半截;
check_dump.py的取样带够不着技能条(拉长带子会把场景里的朱砂红山算成 HUD 墨色,结算帧就永远红)。三处都补了判据并反向验证过。 - 真机两路都验了:Metal 离屏
build.sh --check全绿;无头 Chrome 的 wasm/WebGL2 页截图确认画布与外壳都是中文。me-runtime99 条测试通过,CI 绿。 - ⚠️ 包体只剩 30.1 KB(769.9 / 800 KB)。素材那批(怪/道具/存档点/弹丸,估 46.5 KB)装不下,接素材之前要先谈包体。
- 改名:
COIN RUN 夜间:5 条新判据 + 20.9KB 余量 + 十二关判据接进 CI
- 三条锚点像素判据(门/尖刺/平台):相机由引擎导出,屏幕=(世界−相机)×4;实测 0.424/0.421/0.173,左侧对照全 0.000。根因是图集为手绘噪声图,按色数像素不可分。
- S0 的 800KB 包体预算终于有判据(此前只是措辞):现 721.5KB,余量 78.5KB。反向验证:预算改 700KB ⇒ 红。
- 背景改 bpp=3 存(129600 个 alpha 全是 255):省 21618 字节,wasm 760153→738772。无损由逐字节对账测试证明。
- 补判据:踩存档点后 respawn_x 真的变(此前零覆盖);没有拾取物被埋在实心几何里(1695 件,0 处可疑)。
- 十二关全量通关此前带 #[ignore]、CI 从不跑:实测 release 仅 1.4s(标注的「半分钟」是 debug),已接进 CI 并打表。
- 订正:字节变而大小不变的真因不是 DWARF,是 panic 的 file:line 表跟着行号位移(16 字节全 +19,那次正好加 19 行)。
符号表判据换成代码段指纹(旧判据会放行错版本),零手写 GLSL 补上全仓守卫
- 符号表版本判据换了。
me sym --map原来只比函数总数。这个洞很危险,因为它绿得让人放心:module字段是文件名、函数总数改一个函数体一个字节都不变,所以贴错版本的表会被放行,然后给出一串看起来正常的错名字——人拿它去改代码,代价比没有符号表高一个数量级。 - 现在记
code: {bytes, fnv1a64},弱(总数)+ 强(代码段指纹)两道并行。用 FNV-1a 64 而不是 sha256:这里要答的是「两次编译字节一样吗」,不是「是否被刻意构造」。 - 实测这条路多容易踩:
[profile.wasm-symbols]只把strip换个写法重编,code 段 218,913 → 218,907 B(差 6 字节),函数个数一条不差、旧检查照样通过。这顺带推翻了一个我以为对的常识:换 profile 名就会让 codegen 变,所以只能走RUSTFLAGS = "-C strip=none"(实测 code 段与线上 sha256 完全相同)。 tools/gen/sym-map.sh第一次真的产出符号表:build/sym/me_runtime.sym.json,1123 条,指纹0x2785a826397d7af3。第三步用自己的指纹去核线上产物,不核过就 exit 1。落点选build/sym/而不是apps/coin-run/wasm/——后者会被me pack打进主包,而.json在上传白名单里,149KB 的表会直接进小游戏。- 实战验证:拿线上 wasm + 这张表,把
wasm-function[900]还原成NullBackend::draw。 - 判据自身也得上牙齿:
test_sym.sh5 → 9 条。第 6~8 条现场合成两个最小模块(import 数、本地函数数、name 段全同,代码段只差最后一个字节)——这个形状真产物给不出来,而要验的正是它。两个变异各验一次:指纹比较恒假 → 只有第 7 条红;拿到警告不发 → 只有第 8 条红。 - 零手写 GLSL 从口号变成了守卫。 A2 那条测试只扫
crates/me-render/src/**/*.rs,而host-wx/render.js里有 5 段手写 GLSL——只在部分范围成立的守卫,和没有守卫的区别只在心理上。新增tools/ci/check_no_shader.py扫全仓 9 种后缀,三条硬规则:清单外红 / 豁免到期红 / 陈旧豁免(写了但已扫不到)红。最后一条最容易被忽略:豁免表会随代码迁移变成一张假条子,而假条子比没有条子更坏。 - 现状 10 处命中 / 9 条豁免(后端自检 5 / 墓碑 2 / 宿主替身+夹具 2)/ 8 项
--self-test/ 6 个手工变异全被抓,又用三处源码变异证明自检有牙。 - 记一个自己踩的坑:第一轮变异五个全红,实际是
global BASELINE位置非法导致的SyntaxError(退出码也是 1),一次都没跑起来。红得对、但红错了原因,比不红更危险——它给的是「已验证」的错觉。 现在变异输出多一列「崩=False」,重跑后每条红的原因都对。
- 符号表版本判据换了。
2026-10-25
地面换成 A1 的贴图:镜像平铺消掉竖缝,半分辨率把 336KB 压到 94KB
ground帧只有 288 世界单位、一关地面 1760 ⇒ 直接贴横拉 24 倍,而这张图不可无缝平铺(首尾列差 33、内部只 4.5)。- 解法:镜像平铺 —— 偶数块正贴、奇数块 uv 的 u 两端对调。接缝两侧是同一个像素列,不需要图能接。周期变两块 576 单位,而一屏只 480 ⇒ 看不到完整周期。
- 分辨率取 1/2(576×80,tile 仍 288×40,每 texel 铺 2×2 屏幕像素):1:1 是 336 KB,加上 wasm 会到 981 KB 破线;1/2 是 94 KB,wasm 645.3 → 742.4 KB(余量只剩 58 KB)。
- 删掉地面顶边的 3 像素亮线(贴图自带高光):批次 6 → 5(地面从白图那一批进了世界素材,少一次切换),期望值跟着降。
- 判据重立:地面这条换过三次(主体色 → 亮线 → 草绿 96,162,124 + 像素数下限 3000)。新判据
ground_tiles_cover_every_segment_without_gaps判三件事:无缝隙、深度到底、相邻块 uv 方向相反(镜像的机器可读证据)。 OBJECTS从 4 元组扩到 5 元组(末格min_px),把「玩家像素下限」的 name 特判变成数据。- 判据:十项全绿;接缝放大 5× 肉眼看无硬缝。
贴图改压缩态进包:wasm 962.9 → 645.3 KB,自己写 inflate 不引入外部依赖
- 上一批接 A1 素材后 wasm 从 390.5 涨到 962.9 KB,破了 S0 DoD 的 800KB;CI 只卡主包 4MB 所以不会报红。
- 三张图裸 RGBA 合计 769 408 字节 → zlib + PNG Sub 行过滤后 275 557(省 64%)。背景只压到 57%,因为大面积平滑渐变 LZ77 抓不到「几乎一样」。
- 新增
inflate.rs(zlib 解压 + 五种行过滤)+image_blob.rs(.rgba.z容器:13 字节头 + PNG 风格扫描行)。零外部依赖,不引miniz_oxide。 - 判据两条二值:解压结果与仓库里的裸 RGBA 逐字节相等;再用 git stash 拿旧版跑同一帧,两份 PPM md5 相同。
- 顺手修三件旧账:
PANEL_COLORalpha 232→248 时漏改测试字面量(那条测试从上一批起就红);rebase 并集后协商板 §4 汇总表没重生成;library/art/index.json在 A1 的 42e8761 里就是陈旧的。 - 扇区:
library/art子模块指针跟随 3×→4× 被判越界,按正规出口登记cross-sector.txt代修(复核人 A1 / 到期 11-08),并建议把子模块指针进open段。
coin-run 接上武侠图集:18 帧烘成 7 帧 256×64,玩家拆成碰撞框 + 贴图两个实体
- A1 的 18 帧武侠图集 →
make_hero.py离线烘 256×64 的 7 帧(65 536 字节),include_bytes!进 wasm,引擎侧无解码器无异步。wasm 364.0 → 390.5 KB。 - 每帧按高归一到 44 像素:碰撞框 22 世界单位 × 4 屏幕像素 = 88,整数 2 倍最近邻。按宽归一会让出拳帧突然变小。
- 玩家拆两个实体:
player只留碰撞框(不带 Sprite,带了就是蓝方块盖住侠客),skin负责画、尺寸随帧变。合并会让碰撞框语义随帧变。 - 两个角色共用 7 帧,靠
Sprite.color乘白袍分色温:Swift[186,222,255]冷白 / Brute[255,226,210]暖白。用饱和色会变成蓝塑料。 - 坑一:宿主
coin.rs的texture()缺2 =>分支 ⇒ 拿不到第 2 张纹理像素,侠客画不出来,而 BATCHES 4 / 采样 4 全绿。删掉同色系的PlayerAccent才让判据抓住。 - 坑二:天空带 78 高是 320×240 时代定的 ⇒ 视野 270 后地平线之上一条黑带,改铺满
WORLD[1]。 - 坑三:判据色
(214,236,255)离 HUD 关卡行只 22(容差 24)⇒ 改(183,218,250),距离 52。 - 判据:
cargo test194 条、build.sh --checkMAC/COIN×4/LIVE/AUDIO/MENU×2/PAUSE 全绿、ci.shEXIT=0。提交3b1a7ea。
- A1 的 18 帧武侠图集 →
渲染目标提到 1920×1080:VIEW 拆成 WORLD / VIEWPORT
- 渲染面 320×240 → 1920×1080,世界不变,一屏看到 480×270 单位,整数 4 倍缩放。
- 视野为什么不是 320×180:12 关纵向占
y=54..240,要 186 高,320×180 差 6 个单位 ⇒ 第 3~11 关最高平台看不见、关卡打不通且不报错。 - 新增
STAGE_H=240:视野 270 比世界高 30,多出的必须是天空。相机纵向贴底,follow_clamped上沿抬 30。 - 抓到三处「zoom 只对一半生效」(zoom==1 时全都正确):
collect_text只乘scale不乘max_width⇒ 结算屏 4 行变 8 行;Camera2D::new的center=viewport*0.5⇒ 画面偏到世界右下角、第一帧零精灵;DrawList存屏幕像素而判据按世界/窗口量。 - 顺手补
TextStyle::scaled(k):加长度字段必须加进去。 - 判据:
cargo test全过 · boot.test 16/16 · wx.test 18/18 · mac demo MAC/COIN/MENU/AUDIO 全绿 ·ci.shEXIT=0。 - 已提交
c42bf86并推agent/A2。 - 缺口:画面没变清楚(仍全是纯色矩形 + 5×7 位图字);视野横向多 50% 是玩法变化;判据页只改了画布尺寸没重跑。
M0.3 判据②③:量尺架好了,顺带抓出「busy 恒为 0」的老 bug
- 新增
apps/coin-run/m03.html+run-m03.sh:跑真实一局(全程按右、结算自动继续)量dt/busy/ 内存,结论 POST 回serve.py的/verdict。 - 修了一处真 bug:
boot.js的busy原来是performance.now() - now(rAF 的时间戳 = 呈现时刻),Chrome 上常大于performance.now()⇒ 减出负数 ⇒ 夹 0 ⇒ 从上线第一天起busy一直是一片 0。同一台机器两次跑一次 700µs、一次 0µs,才把它抓出来。 - 分位数对「大部分是 0」不敏感:961 帧里 95% 是 0,p95 就落在 0 上。指得分位数替你看「量错了」是不可能的。
- 逐帧
busy就算改对了也分不出来:performance.now()被粗化到 ~100µs,而引擎一帧就是 25µs。于是另加「同步连跑 600 帧取平均」当可用替代。 - 这一页不能用无头:无头里 rAF 一帧都不发(
CVDisplayLinkCreateWithCGDisplay failed);加--virtual-time-budget则虚拟时间在同步代码里不前进 ⇒busy恒 0。所以用真窗口 +/verdict回传。 - 三档结论:
OK(安卓 + ≥180s + 两条线都过)/NEAR(数据有效但机器不对)/FAIL。前六条判据验「这次测量可信吗」,自检不过时后面的数字没意义。 - 实测(Mac · Chrome 156 · 120Hz · 10s):
M03 NEAR 1201帧 10.0s dt_p95 10.0ms busy_p95 0.0ms sync 25µs wasm 11.8MB js 4.6MB rAF 120Hz。两次跑sync都是 25µs。 - 判据③ 的引擎侧数已经能答:wasm 11.8MB + JS 堆 4.6MB ≈ 16.4MB,是 600MB 的 1/36。但判据② 的安卓数还没有 ⇒ M0.3 离达成差一台设备。
- 负向验证 2 条全红在靶上(
syncFrameUs置 0 ⇒ FAIL;无头 ⇒ 一帧不发)。 - ✅ CI 68s 绿 · 提交
dca0ef2
- 新增
S7-4:帧级 trace 打通「引擎 → C ABI → 宿主」,链路判据 12 条全绿
- 新增
crates/me-runtime/src/trace.rs(约 560 行):它不采集、只留存。LoopReport已把一帧算齐,trace 只做「留历史 / 压分位数 / 导出字节」。 FrameSample只收八个整数,push接它而不接LoopReport⇒ 模块不依赖game_loop,方向单向。- p95 用最近秩不插值:20 个样本的 p95 是第 19 个真实样本。「第 3402 帧 41ms」可追,「38.2ms」不可追。
dt_us与busy_us分开算:只报 dt 会把「等 GPU」和「逻辑慢」混成一个数,而两者修法相反。busy不夹到dt。- 宁可少一个字段,也不要一个永远是 0 的字段:原打算记
render_error,但 COIN RUN 路径上Game::step不返回渲染错误,填 0 等于「没测过也说没错」。换成untextured(退白纹理批次数)。 - 导出走「引擎缓冲 + 指针」而不是
out/cap:JS 宿主没能力自己申请 wasm 内存(malloc刻意不导出)。 - 判据:Rust 19 条 + C ABI 3 条 + 链路 12 条(
apps/coin-run/trace.html);负向验证 8 条全红在靶上。 - 实测输出:
M03-TRACE OK 64帧 回绕 120 dt_p95 16.0ms busy_p95 11700µs heap 1120KB - ⚠️ 仍缺:真机采样(数还没有)、MIR 节点归因(属 S7-5)、编辑器端 WS 端点(属 A3)。
- ✅ CI 81s 绿 ·
cargo test -p me-runtime382 测试全过 · wasm 三份哈希唯一fdf0ecf9…· 提交5fd8d60
- 新增
M0.3 核对:看板写「玩法框架未开始」,实际 12 关全通、循环齐全
- 看板 M0.3 = 待开始,why 仍写「S7 玩法框架未开始」——已失真:M0.2 早已 reached,
coin_run有 7203 行 - 实测
all_twelve_levels_are_clearable_by_the_bot(release,1.04s):12 关 × 2 角色全通,131882 帧 - 每关完美目标 par = 175–190s(≈3 分钟,正好对上 S7 DoD),速通 53–127s
- 判据 1「开始→关卡→结算→重开」代码齐全:Screen 4 态 + Outcome 4 态 + 存档解锁 + restart
- 判据 2(中端安卓 p95≤33ms)无真机证据,只有 Mac 上 1000 批 31.7ms / 3 批 0.2ms;实盘 2 批 424 顶点
- 判据 3(峰值内存 <600MB)没有任何测量代码
- 判据 4(trace 回传 + MIR 归因)未开始,S7-4 / S7-5 空
- 未登记但事实完成:S7-1 玩法框架 / S7-2(12 关,超出 1–3)/ S7-3 UI / S7-6 存档
- 看板 M0.3 = 待开始,why 仍写「S7 玩法框架未开始」——已失真:M0.2 早已 reached,
S4-8 场景切换无白屏:冷切换必须超预算,预热后 0 帧
crates/me-runtime/src/scene_switch.rs(约 470 行)+ 10 条判据,提交affc9bf,CI 174s 全绿- 三个时刻三种手段:冷启动画占位 / 切换中 hold 旧场景 / 换前预热
- 冷切换 19 帧 = 316.7ms(必须超),预热到位后 0 帧;预热要提前 20 帧(333ms)开始,预热过半就切仍只 13 帧 = 216.7ms
- 300ms 只测一头没意义:配额从 2 调到 8,冷切换只 166.7ms ⇒ 判据自己红并报「证明不了预热的意义」
- 预热必须 pin:有对照组,不 pin 的 AssetId(0) 当场被 LRU 掉
- ⚠️ 负向验证抓出自己写的死规则:原本「降级等 30 帧」改成 0 后 10 条判据全绿 ⇒ 根本没钉住(drive 每 tick 重发,Failed 一帧内就回 Requested)。真正该兜的是平台什么都不回,改 MAX_SWITCH_FRAMES=90 超时兜底
- 5 条负向验证全红在靶上(删 holding / 删 pin / 删超时 / 删空场景守卫 / 配额 2→8)
- 已知缺口:COIN RUN 关卡是 include_str! 零 IO,走不到这条路径
S4-2 wasm DSP 最小集落地:噪声/包络/滤波/混响能在运行时现算
crates/me-audio/src/dsp.rs(660 行)+tests/dsp.rs(16 条判据),提交3249cbc,CI 77s 全绿- 与 Python 烘焙版三处不得不分岔:时变滤波 STFT→biquad 按块更新系数;粉噪频域塑形→Kellet 七极点;混响 FFT 卷积→Schroeder 4 梳状+2 全通
- 炸相位的真因不是 IIR,是逐样本重算系数;块边界更新+块内 LTI 递推即连续
- 确定性口径:同目标同构建两次逐字节一致;不承诺与 Python 版逐字节一致(numpy 随机流/FFT 实现不同)
- 6 条负向验证全红在靶上(反馈符号反 → 通带 0.0043;粉噪退白 → 0.09689486 vs 0.096895166;混响反馈归零 → RT60 红)
- 三个我自己的错假设写进注释:perc attack 末尾不是 1(指数已掉 8%)、布朗去趋势≠零均值、扫频折线太缓后段还剩 30%
S4-9:16 通道混音每帧 118ns,只占 1.5ms 预算的 0.01%
- 实测(release / 600 帧 / 取 4 轮最小值):tick 18ns、commands 101ns、合计 118ns、16 个位置音源 417ns。
- 结论比数字重要:这个混音器不混 PCM(只算增益/声像,采样叠加在平台侧)⇒ 「混音会不会爆预算」的风险不在我们能改的那部分。
- ⇒ 1.5ms 那道门永远抓不到回归(涨 80 倍照样绿)。另设 2μs 回归门;分配那一类靠指针判据(
commands()逐帧指针不变),不靠阈值。 - ⚠️ 负向验证当场抓出一条假判据:第一版只设
looping(),删掉它判据照样绿 —— 因为tick的过期条件是!looping && duration_ms > 0,默认 0 本来就不止期。改成with_duration(3_000)+looping()才真(删 looping ⇒ 第 188 帧剩 0 个)。控制实验证明推理不假。 - 5 条判据;照
ffi_cost.rs模板(release 才断言 + 分项报 + 单独前提判据);CI 加--nocapture让数字进日志。 - ⚠️
me-audio::Mixer至今没有宿主在用(coin_run 走另一条 AudioEvent 流水)——这批量的是「将来要接」的路径。已向 A1 提 1.5ms 口径问题。CI 170s 绿。
S3-2:父子层级与变换传播(回到引擎主线)
- 前十三批全在
coin_run(验收载体),且task:trailer 借了S0-5(那是me-rhi/ffi.h的号)——署名守卫只验格式不验占号。这批回到 10 号排班表,task: S3-2。 - 父子不是组件:archetype 按组件集合分桶,加
Parent会把「精灵+变换」劈成两桶,而绝大多数实体没父。改成World里的左孩子/右兄弟(24B/实体、零分配、懒扩容)。 - 环在
attach时拒,不靠深度上限兜底——差别是发现问题的时刻(拖拽当场弹回 vs 某帧开始每帧多转一点)。 - 不动
Transform2D的世界坐标语义(SpriteInstance/DrawItem都按世界坐标消费它),另开LocalTransform+ 每帧propagate;没LocalTransform的实体一个字节不碰。 - 语义:局部原点 = 父左上角;旋转绕父中心;角度累加;尺寸不继承(缩放要加
scale列 = 契约级)。 - ⚠️ 删父必须
despawn_keeping_children_in_place烘焙,裸despawn会让挂件瞬移(ECS 不认识 Transform,封装只能在 render2d)。 - 22 条判据(11 单元 + 11 端到端);负向验证 5 条全红在靶上,报错带具体数字(「子该在 (132,200),实际 [100,200]」)。
- 顺手补账:
mem.rs887 行 / 28 判据早就是 S3-4,板上一直空着,已登记(38/110)。CI 70s 绿。
- 前十三批全在
触屏三页从「截图给人看」升级成「量像素」(第十四批)
- 上一批的截图判据只验「图落盘了」,排版对不对还是只有人眼 ⇒ 补像素读数。
- ⚠️ 关键:
readPixels必须在自己的requestAnimationFrame里读。从 eval 任务里读拿到的是已清掉的缓冲(整屏[0,0,0]),而恒 0 会让「这一带没有墨」全部假绿、让「有墨」永远红。所以先读一个已知一定亮的像素当控制组:选关页第一格青色光标(实测[86,210,200]),它不亮就整组作废。 - 基线:页脚带 88/808、格子与页脚间空带 0/808、说明页正文 920/5499、正文与手柄之间 0/1269。
- 负向验证:旧排版(8 行头 + 行距 1)放回去重编 ⇒ 那条空带变 345,红在「正文长到手柄底下了」;还原回 0。
- 顺手复跑九个老判据页(atlas/text/scale/mip/rotate/nine/demo/mir/buttons)全绿;12 关全通 131882 帧全绿。CI 131s。
触屏那三页终于能看了:加开关 + 截图判据(第十三批)
- 桌面报
pointer: fine⇒ 触屏独有的排版在桌面上永远看不到(页脚位置、说明页行数行距),而这几处正是唯一会错的地方。 index.html认?touch=1;新增shot-touchui.js+run-touchui.sh,手机视口拍三页落evidence/p-touchui-*.png(标题/选关/说明)。- 三张图已人眼验过:两列对齐在 9/32 列、页脚与手柄不重叠、说明页最后一行在 159。
- 顺手:发布页说明从「四个虚拟键」改成五个(加了顶部
||)。 - ⚠️ 顺手抓到一处漂移:
web/与site/的 wasm 还是上一批之前的字节,而上一批 CI 的check_play_sync是绿的 —— 提交前要核三份哈希。 - ⚠️
task:trailer 必须是S<n>-<n>;前四批写了自由文本没红,因为那道门只查未推送的提交。CI 68s。
- 桌面报
手机上的菜单页脚:不删了,抬到虚拟手柄上面(第十批)
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
TOUCH_FOOT_TOP=172就行。 - 最贵的是选关页:页脚是那一页唯一说「哪个键开这一关、怎么退回去」的地方。
foot_text(touch, 键名版, &[(PadButton, 词语)])用pad_glyph拼字形;键盘版一个字没动。- 判据 ×2(83→84):逐页查非空+无键盘键名+逐键问字形;页脚与手柄每个键的矩形相交测试(不能比「最上面那个键」——暂停键在 y≈6)。
- 负向验证 ×3 全红在靶上。CI 99s。
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
触屏暂停键:手机玩着也能回菜单(选关/换角色终于够得着)
- 洞:手机玩家玩着时没有办法回菜单(没 M 键、没 Esc,屏幕只有四个动作键)⇒ 上一批的选关/换角色只在开局看得到,唯一退路是切后台再回来。
- 做法:
PadButton::Pause(raw=4追加在最后)+PadState.pause_held/pause_pressed+platformer()顶部正中一个 0.75 键宽、字形||;输入系统把它换成回标题页(menu_item=0),不给玩法意图。 - 为什么由引擎消费:宿主要做这事得先知道「这一帧刚按了暂停」,而
state里没这列——加列就是又一处两个宿主都要改。为什么不另开一张键表:多指记账/命中/绘制三条路都只认PadKey。 - 位置是三个候选逐一排除的:右上角是 HUD
LIFE;底部中间压地面(再压一块玩家看不出哪里能落脚);右手键群旁会误触(后果是「玩着玩着回菜单」)。 - 顺带:字形居中开始乘字符数(
||是唯一双字符);暂停在说明/选关页是「返回」,在标题页什么都不做(否则光标每次被打回第一项)。 - 验收:102 lib + 81 game_slice(+3)、node 53 项(+1)、clippy/CI 全绿(148s);负向两条(去处理→红在「该把画面换到标题页」;矩形压到跳键→红「键 Jump 与 Pause 重叠了」)。
- 提必
496a0df(agent/A2 已 push)。
小游戏开局进标题页:玩家终于看得到选关/换角色/操作说明
game.js加CoinBoot.openMenu(ex):三个宿主里只有它开局什么都看不到(*技能键没有任何文字解释)。网页能写 DOM hint,小游戏只能靠Screen::Help,而那一屏只能从菜单进。- 先探过前提:手柄在菜单页也画得出来(
batches玩着 4 / 菜单页 4 / 关掉 2),所以那一屏既看得见也按得动。 - 顺带修好一条假绿的判据:「dt 单位」一直恒真。两个原因叠加:① 不喂输入 ⇒ 角色不横向移动,两条时间线都是出生点;② 直接读
fresh.state + 16,而stepFrame只填step块 ⇒ 读到上一帧循环的旧字节,等于byLoop === byLoop。把DT_MS_X100_PER_MS改成 12(差 8 倍)它照样过,相邻三条触控判据全红。 - 改后同一负向验证给出「循环 39.40 vs 手喂 156.03」。
- 五条既有判据因「开局不再在玩」要改:加公共
enterPlay(rt, game)替玩家按一下^。 - 验收:node 51 项 全绿;负向两条(注释
openMenu/ dt 改错)各自精确红在靶上;全量 CI 77s 通过。 - 提交
a2e90c4(agent/A2 已 push)。
小游戏补上存档、切后台暂停、四个虚拟键(S0-5 · 第九批)
game.js是三个宿主里唯一还缺这几样的,而它恰好是真正发给玩家那一个(网页与 Mac 是验收入口)。- ① 四个虚拟键从来没画出来过:命中区域一直在(所以能玩),但
game.js没调CoinBoot.touchUi—— 网页按pointer: coarse开了,小游戏百分之百是触屏反而漏了。 - ② 存档整条是断的:通到第 5 关、关掉微信、再进来又从第 1 关开始,最高金币永远 0。接上
wx.getStorageSync/setStorageSync,与网页localStorage/ MacUserDefaults走同一份四整数契约。writeSave只在内容变了才写 ——setStorageSync是同步的,每帧写会抖磁盘,而症状是「玩久了偶尔卡一下」。 - ③ 切后台不暂停 = 回来人就没了:rAF 停摆而
loop用真实时间算dt⇒ 回来第一帧dt是几秒,掉帧补步一次补很多步,角色已掉坑。onHide调openMenu+ 落一次存档,onShow什么都不做。 - ⚠️ 手柄那条判据写错了两版:第一版「开/关
sprites差 8」实测差 0 —— 零面积精灵照样计入sprites,只在图元装配阶段被丢,真正分界是batches(关 2 批 / 开 4 批);第二版测试自己先关再开,验的是「API 有效」而不是「game.js默认开了」,把game.js那行注释掉照样全绿。第三版从默认状态出发才真的红。 - 存档判据钉的是两边一致(存档里的值 == 引擎里的值),不是「大于 0」:
bestCoins只在通关后涨,拿「大于 0」当判据实际在验「机器人能不能在 4 秒内通关」。 - 验收:node 50 项(+5)/ 负向验过四条 / 全量 CI 73s。提交
5d8bbf5。
小游戏也有声音了:一份音色配方,两种落地(S0-5 · 第八批)
- 病灶:微信小游戏没有
AudioContext,只能wx.createInnerAudioContext()播文件 —— 网页那套「现场合成」在小游戏里根本不存在。所以game.js一局到底一声没有,而所有测试全绿。 - 根因在
game.js:CoinBoot.loop(ex, mem, onFrame)只传了三个参数,第四个onAudio一直是undefined⇒ 音频流水一条都没被取走。 - 一份配方两种落地:新增
js/sfx-recipes.js(波形/起止频率/时刻/时长/峰值/包络常数),sfx.js读它建振荡器,make-sfx.js读它算 PCM。数字埋在 switch 里就是两份真相互相漂移,而症状是「手机上的金币声和电脑上不是同一个调」。 - ⚠️ 噪声必须固定种子 LCG:
Math.random()每次烤出来字节不同 ⇒ 入库那份永远「和刚烤的不一致」⇒ 门要么永远红、要么被迫去掉。 - ⚠️ 扫频要积分相位,不能算
f(t)·t:后者在f0≠f1时相位跳,0.22s 的下坠音听起来像「断了一下」。 - BGM 取 1 秒:55/110/165 在 1 秒里都是整数周期。实测循环点首尾差 159 = 相邻样本差 159 —— 接上就是正常步进。非整数周期会每秒「咔哒」一声,听起来像心跳。
- 两个能力边界(写进注释,否则会有人去错的地方查):
InnerAudioContext没有 pan,两路增益只能取平均;烤出的波形与 WebAudio 的 band-limited 振荡器不逐样本一致(音高/节奏/包络/响度一致),所以判据验参数不验逐样本。 sfx-wx.js四个静默失效全用假InnerAudioContext验掉了:src 拼错 / 忘设 loop / 静音恢复成 1(BGM 一下响十倍)/ 每次 Play 新建实例(微信有实例数限制,超了不出声且不报错)。- 顺带:
check_play_sync从「只盯 wasm」扩到「PLAY_ASSETS 也逐字节比」—— 原注释那句「js 由 sync 现取、没有副本就没漂移」只对构建时成立,site/是入库的。 - 验收:node 45 项(+13)/ 负向验过四条 / 真机两页
AUDIO OK/ 全量 CI 72s。提交e1776c1。
- 病灶:微信小游戏没有
音频流水加上限 —— 把「宿主忘了取」从「会不会崩」降级成「丢了几条」(S0-5 · 第七批)
- 病灶:
AudioLog.events完全无界,而小游戏入口game.js从来没调过audioFrame⇒ 一局里每条增益淡变都留在Vec里单调增长,几万条。症状「玩久了变卡、偶尔闪退」会被算到内存、GPU、机型头上,唯独不会让人怀疑音频。 - 上限 96 条(约两秒的量),满了丢最老的(玩家在意刚发生的那一声);
VecDeque而不是Vec::remove(0)(每次溢出都要 memmove)。三条AudioSink方法走同一个push:写成三处各判一次,漏一处那个事件类型就成了无界口子,而「只有 Stop 会漏」的表现是「跑久了才卡」。 - 新状态列
STATE_AUDIO_DROPPED(第 27 列)。它的价值全在「宿主可以自己说清楚我没在取」—— 没有它,这件事在真机上没有任何可读证据。 - ⚠️
audio_events的差值会归零:原来算events.len()差值,队列满之后「弹一条、压一条」长度原地不动 ⇒ 报告说「本帧 0 条」。改用新的total(累计入队数,跨取走跨溢出单调增)。 - ⚠️
plays_of不能从流水里数:一有上限就只在「全程没溢出」时对,实测every_coin_makes_exactly_one_sound红成「81 枚金币 = 2 声」。改成按编号分桶的计数器。sounds()改名pending_sounds()(它只覆盖尾段,叫原名会让人以为拿到完整账)。 - 暂存区的账:
state多占一格 ⇒ 音频块起点 34→35 ⇒AUDIO_MAX5→4。每帧少取一条无影响,但它是提醒:加字段要从别处挪。 - 验收:
game_slice77(+3,每条先断言「这个场景必须真的溢出过」)/ lib 101 / node 32 / 真机AUDIO OK/ 全量 CI 143s 八条 Mac 判据全绿。提交8c4e056。
- 病灶:
把「最高金币」显示出来 —— 存着不给人看等于没有(S0-5 · 第六批)
- 引擎从 12 关那一批起就在算
bestCoins、也一直通过STATE_BEST_COINS导出,但界面从来没有那一格。存着不给人看 = 没有重打目标。HUD 补上「最高」并每帧对齐。 - 判据验的不是这个格子,是「引擎导出的字段 → 宿主显示」这条路:
touchbar-probe.js里先往 localStorage 写bestCoins:77再重载,读 HUD 得到 77;同一次重载顺带验了存档里的角色(hero:1→ 界面 BRUTE)。这类漏接不报错、不崩,只会一直空着。 - 结论行
✅ HOSTUI OK … 最高分 77;全量 CI 通过(workspace 1509 / node 32 项)。 - 提交
a27a6a2(push agent/A2)。
- 引擎从 12 关那一批起就在算
手机上补两个宿主键:暂停与静音(S0-5 · 第五批)
- 引擎只画四个动作键(←→ 跳 技能)⇒ 手机玩家想停一局只能按 R,而 R 是重开(等于放弃);想安静得先静音整台手机。补上页面里的「暂停 / 静音」两键(
.touchbar+@media (pointer: coarse))。 - 放在页面而不是引擎:
openMenu/setMuted是宿主能力;画进引擎桌面也会多出两个没人按的键,而四个虚拟键已经把地面盖掉一半。 - ⚠️ 顺手修了一个会被它踩到的隐患:
setMuted可能在AudioContext建起来之前调(那时还没用户手势),而_ensure建 master 时写死gain = 1⇒ 「按钮显示静音,一进游戏又响了」。补测试并负向验过(把1放回去立刻红)。 - ⚠️ 桌面那一半判据必须先跑:CDP 的
setTouchEmulationEnabled(false)撤不干净(撤完再导航pointer: coarse仍是 true)⇒ 第一版判据是假红的,测的是浏览器残留状态。 - 三个跑法脚本收成一套:
run-buttons.sh/run-shot.sh只设PROBE然后exec run-audio.sh(服务+Chrome 生命周期只能有一份)。 - 真机:
✅ TOUCHBAR OK 手机可见/桌面隐藏 · 无溢出 · 按钮 92×40 · 暂停把固定步冻在 24 · 静音可逆且落盘;证据evidence/p14-touchbar-phone.png。全量 CI 通过(70s,workspace 1509 / node 32 项)。 - 提交
0c0d6ac(push agent/A2)。
- 引擎只画四个动作键(←→ 跳 技能)⇒ 手机玩家想停一局只能按 R,而 R 是重开(等于放弃);想安静得先静音整台手机。补上页面里的「暂停 / 静音」两键(
网页版终于有声音了:引擎发货、宿主现场合成(S0-5 · 第四批)
- 症状:网页版一局打到底一声没有,而所有测试全绿。两头都断:引擎把每句该响的话都算对、记在
AudioLog里,但 wasm 只导出audio_events计数("本帧响了几声")—— "响的是哪一声"到不了宿主。 - 取走式不是游标式:
me_coin_run_audio(out, cap)取走即消费。游标的失效点只有restart清空日志那一处,而它零症状:之后每帧读到空 ⇒ "重开一局就哑了",账目全对。 - ⚠️ 错误码必须负数:这一层别的函数返回
ErrCode正数,但这里返回值首先是计数 ——InvalidArg是 4,而"恰好 4 条"也是 4。混在一个数里宿主只能照播四条没被写过的内存(上一帧残留,听起来像随机音效)。 - 合成而不加载 ogg:
library/sfx/没有 jump/hurt/win 那几段,另存一份就是又一处"发版忘了拷就没声音"。9 个音色现场合成:零资产、不会 404。 - 两路增益:
源 → Gain(L) → ChannelMerger[0]+源 → Gain(R) → merger[1]。引擎给的是定点增益(1.0 = 1000000),压成一个pan就把声像白算了。 - 判据:
game_slice+3(74 通过)/wasm.rs+3 /test/sfx.test.js7 条(假 AudioContext 记账 ——sfx.js在 CI 里唯一的覆盖)/ 真机run-audio.sh:AUDIO OK ctx=1 BGM 3 层 跳 +1 源 merger=2、固定步 0→63→91。全量 CI 通过(68s,workspace 1509)。 - 提交
bd7e0fd(push agent/A2)。
- 症状:网页版一局打到底一声没有,而所有测试全绿。两头都断:引擎把每句该响的话都算对、记在
手机竖屏能玩了 + 官网试玩页不再落后好几个批次(S0-5 · 第三批)
- 手机上那 1 像素:
width:100%+ 1px 边框在 content-box 下算出100%+2px⇒scrollW 391 / clientW 390整页能左右晃。改box-sizing:border-box;顺手补viewport width=device-width、aspect-ratio:4/3、justify-content:safe center(safe是关键,否则内容比视口窄时左边被裁)。 - 官网那份是手工维护的第二份:
site/play/coin-run/落后好几个批次(没有选角条、没有选关与存档、金币写 6 枚、触屏说明还让人「点一下画面」)。改由build_site.py的PLAY_ASSETS从web/复制,web/再从apps/取胶水。 PLAY_SYNC少一行,门等于没装:它只盯web/,而sync_web()只在构建跑过之后才铺site/⇒ 实测site/的 wasm 停在 248508 字节、web/已是 361990,差 113 KB,十二关之前那版引擎,线上照常能玩、零症状。补第二行;负向验过(追加 1 字节立刻中止并指名)。- 判
pointer: coarse不判ontouchstart:触屏 Windows 笔记本后者也 true,而那类机器有键盘、块会压住地面(玩家靠地面判断落脚)。matchMedia只在加载时求值 ⇒ CDP 里必须重载。 - 实测:390×844 无横向溢出、画布占 93.8%、四个键各 39.3 CSS 像素;
build.sh --check八条全绿;全量 CI 69s;cargo fmt无 .rs 变更(wasm 不陈旧)。 - 提交
98bc703(push agent/A2)。
- 手机上那 1 像素:
COIN RUN 触屏手柄:画的和点的必须是同一个数
- 四个虚拟键的命中区域一直在
VirtualPad::platformer,所以手机一直“能玩” —— 但那四个按钮从来没被画出来过。玩家面对一片“按哪里都有反应、看不出该按哪里”的画面,而桌面永远暴露不出来。 - 画的和点的必须是同一个数:
build_world里再建一个VirtualPad::platformer(VIEW)把keys()带命中区域一起抄进Sim::pad_ui。手写第二份矩形算式 = “看着在按钮上、点下去没反应”,不报错、不崩、数字全对。 touch_ui放Game上而非只放Sim:Sim每关重建,只写Sim的话“过了第 1 关手机上手柄就没了”。- 判
pointer: coarse不判ontouchstart:带触屏的 Windows 笔记本后者也 true,而那类机器有键盘、块会压住地面。 - 三处只有渲染出来才发现:① 底块
[8,14,22,120]在深色地面上等于隐形(只剩四个漂着的符号)⇒ 改[26,40,56,170];② 字形用Align::Center+max_width偏半格,无max_width还偏 ⇒ 自己算内边距 + 左对齐;③ 触屏时菜单页脚键位提示要藏掉(手柄压在那一带)。 - 判据:
game_slice新增 4 条(零面积默认 /pos == hit.min逐值 / 按住变青 / 重开还在)。mac 八条判据全部不受影响,顶点 408→424 正是 4 个底块 × 4 顶点。 - 真机:CDP
Emulation.setTouchEmulationEnabled后重载页面(matchMedia只在加载时求值),pointer: coarse为 true,按住左边那块变青且角色往左走。 - 全量 CI 123s 全绿,
9d8c22e在agent/A2。
- 四个虚拟键的命中区域一直在
COIN RUN 存档与选关:关掉游戏再回来接着打
- 引擎侧:Screen 第 4 档 Levels、标题页第三项「LEVELS n/12」、新 Save(unlocked/last_level/hero/coins)。通关当帧解锁,不等玩家按「继续」——在结算画面直接关游戏是正常动作。
- 选关页 6×2 格:
6*40+5*6=270,320 宽左右各留 25;锁定格画--不隐藏(否则玩家以为只有三格);技能键 = 返回(左右是环,否则死胡同)。 - 越界值一律
clamped():浏览器里 F12 就能改存档,unlocked=200会让格子画到屏幕外。 - 三处持久化:网页
localStorage(coin-run.save.v1)、macOSUserDefaults(coinRun.*)、小游戏预留。引擎只收发四个整数,格式由宿主定。 - 两处只有渲染出来才发现:① 选中格数字被同色高亮条吃掉(第 1 格成空青块)⇒ 选中一律反色;② 菜单里世界还在动(暗色只盖 93.3%,6.7% 透出金币悬浮)⇒
animate也看screen。 - 判据 F(标题页/选关页两屏,方向与前几批相反:判「该没有的确实没有」)+ PAUSE(
cmp比菜单里 90 帧与第 1 帧逐字节相同)。实测光标 538×45 与 128×96,正好是 168×14 / 40×30 的 3.2 倍。 - 踩坑:判据进程会读本机
UserDefaults⇒ 跑过标题页之后判据 E 报「61 条 ≠ 60 帧」,换干净机器又绿。结论取决于「以前有没有人玩过」。现在探针一律从新玩家起步、也不写回。 - 全量 CI 140s 全绿,
36aaea0在agent/A2;共享路径 9 处已用say.py报备 A3。
COIN RUN 启动先给标题页与操作说明(三平台)
- 新增
Screen {Playing, Title, Help},与Outcome分开;引擎建局照旧在玩,标题页由宿主open_menu()显式打开(判据/机器人/离屏 dump 不用先按键) - 菜单=暂停不是重开:
fixed_step非 Playing 直接 return;首项文案按has_run切 START GAME / RESUME - 不新增按键:左右翻项(环)+ 跳/技能都是确认;左右补了按下边沿(持续态会一口气翻三项)
- 说明页:按键表 / 道具 / 两种怪 / 两个角色技能 / 12 关约 3 分钟;位图字体等宽 ⇒ 左对齐手排空格
- 顺手修旧 bug:
Sim.hero搬进build_world,原来换角色后「身体是岩、技能是风」 - 证据:
game_slice+7 条全绿,12 关×2 角色 131882 帧仍全通;boot.test.js10/10;CDP 真按键在无头 Chrome 走通 →→空格进说明页 - macOS
build.sh --check七项全绿(ME_DEMO_MENU=1才拍菜单);标题栏菜单里改「标题页(已暂停)」 - 全量 CI 通过 76s;提交
dddc11b已 pushagent/A2 - 坑:
cargo fmt --all会让 wasm 产物变陈旧 ⇒check_generated报「生成器失败」;顺序必须是 fmt → build.sh → cp → check → ci
- 新增
COIN RUN 十二关 · 双角色 · 技能 / 道具 / 四种怪 · 结算与继续
- 玩法:12 关 7040…14080 宽(
levels/coin-run-1..12.lvl,include_str!进二进制,parse(&str)一行未改);每关设计目标 175~190s(完美通关 ≈3 分钟)。 - 双角色:Swift(132px/s、跳 56.7、DASH)/ Brute(112px/s、跳 49、SLAM);技能是
Intent.skill意图不是状态机,PadButton::Skill=3排最后。 - 道具:宝石 / 红心 / 护盾 / 星(无敌);怪:巡逻 / 飘浮 / 炮台 / 弹丸(都无物理体,轨迹与帧率无关)。
- 判据:
all_twelve_levels_are_clearable_by_the_bot实测 131882 帧 / 17.9s,12 关 × 2 角色全通,每关受伤 ≤2;内容层三条间距判据(怪不压坑 / 离坑 ≥一跳 / 怪间 ≥88)。 - 三个血坑:踩怪不能比「脚底 vs 头顶」(落地帧速度被清零 ⇒ 踩死变撞死);
fall_vy必须在物理步之前采样;出生点on_ground第一帧就得 true(否则开局按跳被静默吃掉)。 - 宿主:
me_coin_run_start/continue,state追加STATE_LEVEL_COUNT(21→22)让「关卡 1/12」的分母来自引擎;页面加选角条 + 空格继续。 - 顺带重标
apps/macos-demo四条像素判据(配色改由关卡数据决定);两条是改判据本身:顶点「都在框内」→「与画面相交」、实心度允许一组颜色(玩家 = 身体 + 高光)。 - 全量 CI 128s · 1484 测试 · 42 ✓(2 项降级:微信真运行时未登录 / 1 个 ogg 未入索引);wasm 344.7 KB。
- 玩法:12 关 7040…14080 宽(
三个内存池(S3-4):按「谁能决定它的死期」分,不按「数据多大」分
为什么:
lib.rs从 9 月就承诺了三个池,代码里一个没有。承诺了却不存在的接口比没有承诺更糟——下一个人按文档去用,或在第一帧发现它不在,或按文档自己实现一份。它也是S4-5资源系统的直接前置。分界线是「谁能决定它的死期」:
FrameArena(帧末 reset,只归零游标)/AssetHeap(按分包整体还)/Persistent(进程结束)。分不清的后果不是崩溃,而是每一处都退化成「看着差不多就 Vec::clear 一下」。三条判断:① 超预算返回
None,不 panic 也不扩容(wasm 里 panic 就是整局闪退);② 失败不改状态(手写 bump 很容易先推游标再判越界,一次失败毁掉后面全部);③reset不还内存(帧内数据生命周期全不一致,但一定死在同一时刻)。零 unsafe:
Vec<u8>当底座、把分配表示成区间。底座自己修一次对齐:Vec<u8>只保证 1 字节对齐,建池时多要 15 字节跳过开头几个字节使绝对地址 16 对齐;非 2 的幂的对齐值一律按 1 处理(位运算写法在 align=3 时给出假的对齐,调用方 cast 成[f32]会 fault)。接进 GameLoop:
tick末尾先取账再归零。两件错事的症状会撞在一起——先归零再取账 ⇒frame_used是 0(而「没人用过」也是 0);不归零 ⇒ 第二帧叠成 2048。所以判据写成「同一帧报 1024、帧末归 0」这一对。诚实一句:帧池暂时没有真实消费方(渲染用跨帧复用的 DrawList),
frame_used恒 0 是正常的。要盯的是frame_refusals——非零就是有人降级了,而画面不会报错。判据 28 条(
--lib mem22 +--test memory6):10000 帧后 capacity 与 peak 都不涨(S10「30 分钟不掉内存」的单测形状)· 拒绝后还能装下剩余的量 · 分包卸 9/10 占用落到 1/10 · 压缩后内容不串也不被清成零。坑:
compact先搬后清原位会毁数据(空洞在前 ⇒ 源在目标之后,重叠,清原位把刚搬的抹掉大半,症状是某些包变全零,看起来像「还没加载完」)。//!里连本模块自己的 item 都不在链接作用域,引用式定义也不行,必须写全crate::mem::FrameArena。顺带算清「我还能自己走多远」:A2 未完成 20 条 = 11 条能动/44 人日 + 9 条被卡/35 人日;被卡的 9 条里 4 条是我自己的前置(S6-3→S6-6→S6-7、S7-4→S7-5、S10-3→S10-7),都在能动清单里。真正卡在外面只有 5 条,已开
N-211要排期。结果:
49fce4c· CI 149s / 1451 测试 / 2 项降级运行时读 cooked 场景(N-040):那句「只读 mirb」终于指着一个存在的东西
为什么先做:
N-040是板上唯一一条 A1 在等我、且卡着「可玩切片」的条目(到期 11-07)。做了:
me-runtime加me-cooked(path,L5→L0 审计通过)· 新模块cooked.rs(LoadedScene::load)·lib.rs那句「只读mirb」改成指向具体入口。8 条判据全是真字节往返。我加的一条:只留
DrawList、不留Scene。两者是同一条记录的两种形态,都留就是每条 52 字节的双份常驻。判据里最值钱的两条:名字用指针落在
bytes区间里验「借的」而不是「拷的」(字符串相等对拷贝同样成立);真实示例那 4 条按me build --verbose报出的字段拄成常量——手工构造的都是整数位置全白着色,而真实内容里有layer=1000的 UI 条、rot≠0的旋转条。跨命令那半我只做得到一半:
me pack的draws: N↔items.len() == N要等dist/里有.bin(N-039在 A3)。我做的是「编出 4 条 →encode/decode→ 读回 4 条」——证明格式对真实内容保真,不证明 pack 写出的字节一致。两个坑:
//!模块文档里use引入的名字不进链接作用域([DrawList]照样报找不到);CI 跑的时候手动跑build.sh会抢同一份target/,第二次 CI 红在 site 报 markdown 缺失,第三次复跑EXIT=0而代码一个字未改。顺带:补登
S3-9——性能基准那批做完后看板一直空着,五条 DoD 落四条,差的只有微信 ≥30fps。结果:
aecda70+6b78a0c· 全量 CI 71s / 1423 测试 / 2 项降级NEON BREAK:一个能玩的打砖块,热闹时一帧也只有 2 个 draw call(P9)
这一批问的是「合起来能不能玩」:320×180、一个 wasm 模块、一个 canvas、固定步长循环,200+ 四边形、碎片带旋转飞出容器 —— draw call 正好 2。真机
b=2 q=152 brk=30 lv=1 clip=1 ev=57 f=3000(24 秒游戏时间)。2 是下界不是目标:批次键
(texture, clip),两条裁剪上下文 × 两张贴图 ⇒ 下界 2,判据写「任何一帧不超 2」。这条判据被自己的装饰毁过一次——命原本画成三个场景图集小方块,同一张贴图在「裁」与「不裁」各出现一次 ⇒ 必然断两次 ⇒ 批次 3。改成"I".repeat(lives)走字体那批后回到 2。判据:
--test breakout22 条(玩法内核零 GL)+--test breakout_render14 条(NullBackend);600 帧max_batches == 2、max_quads > 140;900 帧里至少一帧真的走了 GPU scissor。ev=57验的是跨 C ABI 的第 17 个字,单测证明不了它落在页面S.events = 16上。真 bug:打掉最后一块后球还在飞(
Phase::Cleared飞 0.7 秒),半秒后从底部出去 ⇒ 扣命 ⇒ 状态拨回Ready,关卡停在 1。庆祝阶段必须停掉失败判定,而这条只有「打完整一屏」的测试碰得到。坑:① 位图字体
0>7补零 +scale 2.0⇒ 七个「口」;② 碎片横向初速 ±60 飞不出容器,判据红得莫名其妙,给 ±130;③ 无头自检要取整段最大值不是最后一帧(clip=0假红)。音效:引擎不发声(wasm 无输出设备)。内核报
EV_*事件位(第 17 个字)读完清零,页面用 WebAudio 发声;微信侧要用InnerAudioContext。证据:
apps/coin-run/breakout.html(serve.sh --open breakout)·crates/me-render/src/breakout/{mod,render,wasm}.rs·evidence/p9-neon-break{,-play}.png·run-breakout.sh· 全量 CI 170s/876 测试 · commit93c146c
2026-10-24
批处理吞吐实测:1000 批 p95 31.7ms vs 3 批 0.2ms(P8)
做了什么:S3 的 DoD 有两条关于性能:「1000 sprite 批次数 ≤8」(可数)与「性能基准进 CI,超阈值报警」(要量)。把两件性质不同的事塞进同一个门里,两件都会不可信(一条「必须 <16ms」会 flaky → 被 ignore → 没人再跑)⇒ 拆开:计数进 CI 判红,墙钟只打印。新探针
wasm_perf(1000 个 8×8 铺满 320×200,三贴图轮转)+ 判据页perf.html+run-perf.sh+ CI 一步(11 项)。- 反直觉结论:批处理不省 CPU。主机侧 1000 精灵提交 9.6 µs(画家顺序)对 17.9 µs(批优先,含排序)——批优先更慢。省下的开销在驱动里,而主机侧 NullBackend 没有驱动,所以 bench_2d 永远看不见它。
- 真机数字(Chrome + SwiftShader,同一份精灵集合、光栅化工作量相同):提交 p95 21.9ms 对 0.3ms;帧 p95(每帧 gl.finish)31.7ms 对 0.2ms —— 前者吃掉 30fps 的整个帧预算。
- 踩的坑:画布高必须取 200(8 除不尽 180,半行会污染 A/B);标题里不能有
</>(--dump-dom转义后case匹配不上);--dump-dom连<script>源码一起 dump,正则会把字符串模板当数据行。 - 证据:
crates/me-render/src/wasm_perf.rs、tests/perf_js_table.rs、apps/coin-run/{perf.html,run-perf.sh,evidence/p8-perf-batches.png};提交7cbf638;全量 CI 208s 通过(0 红)。协商板N-209通报 A1:docs/10 那句 DoD 要不要改口径。
COIN RUN 通关宣传片:离线逐帧录制 + 自动通关脚本(10s / 1080p60 / 带音频)
- 成片
apps/macos-demo/evidence/coin-run-promo.mp4:10.03s / 1920×1080 / 60fps / 432KB。不录屏,走离线逐帧 —— 帧率不受负载影响,音频指令按同一帧号从引擎取走(同步是构造的,不是对的),可复现,不碰屏幕录制权限。 - 宿主新增
ME_DEMO_RECORD(每帧写 PPM)/ME_DEMO_TRACE(帧级轨迹)/ME_DEMO_SIZE。⚠️ 录制分支不调me_md_tick:renderOffscreen内部就带advance,两个都调会录成两倍速,而两倍速在任何静帧判据里都看不出来。 - ⚠️ TRACE 是必需品:只给
OUTCOME的话「撞刺」与「掉坑」都是 Lost,修法正好相反。靠它调了 5 轮,拿到通关脚本:280 帧 / 6-6 金币 / 零失误 / 4.7 秒。帧号与MOVE/JUMP/重力绑定,改了要重调。 - ⚠️ 这台机器的 ffmpeg 没编译 freetype/libass(
drawtext、subtitles都不存在)⇒ 文字改用 Pillow 渲 PNG 再 overlay。PingFang.ttcPIL 打不开,改用 Hiragino Sans GB W6 + SFNSMono;等宽空格是一个字宽,COIN RUN得拆两词画。 - 编排
make-promo.sh(一条命令 46s 重出)+promo_cards.py;判据 A-E 复跑全绿。关卡内容只占下半屏,4:3 摆进 16:9 时两侧放「本片成绩」栏而非黑边。
- 成片
RHI v6 scissor 后端落地:三态各有名字 + 义务 21 每次 begin 归零(N-201 后端侧)
- 前置:A1 的
ff018a8把me_rhi_set_scissor+ ADR-0011 放进 main,N-201那句「等 v6 契约窗口」失效。这一批补 A2 那半:后端 thunk + 胶水 + 判据。 - 驳掉一个顺手就会写出来的错:把
None(关裁剪)与0×0(裁到空)合并。它们在多数驱动上结果相同,于是「关裁剪」很自然被写成scissor(0,0,0,0)。但那是恰好对:某个后端优化掉空 scissor 并顺手关掉SCISSOR_TEST,整块就会被画出来,不报错。 - 所以胶水新导出是
me_gl_set_scissor(enabled, x, y, w, h):enabled独占一个判别位。关 =disable;裁到空 =enable+ 0×0;按矩形 =enable+ 矩形。判据是调用序列,不是「调过就算」(enabled恒为 1 的实现能通过「调过」那条断言,而那意味着裁剪永远关不掉)。 - 义务 21 是状态不是命令:空后端加
scissor()访问器回答它(日志里「没调用」与「上个 pass 设过」长得一样);webgl2 必须真的发一条disable——SCISSOR_TEST不会因为换了 pass 自己复位,残留不报错、只让画面少一块。 - y 要翻:契约原点在目标左上角,GL 在左下角,中间夹着「当前目标多高」。胶水在 begin 记
passTargetSize(RT 高 ≠ 画布高)、end 清回画布。拿画布高去翻的后果是离屏那遍裁剪框整体错位,错位量 = RT 高 − 画布高,画面只表现为「少画了一块」。三条测试分别钉默认帧缓冲 / 绑 RT / end 之后。 - 校验只有一处(
backends::validate_rect):只判负尺寸,越界不判。cap 层与两个后端都不重复判,否则会出现「记录器接受、真机拒绝」这种只在换后端那天才发现的差异。 - 胶水缺这条导出时返回
Unsupported,不假装成功:假装成功的症状是「裁剪不生效」,与「裁剪算乱了」长得一模一样。 - 这一批不做:
me-render的消费端(旋转精灵走 GPU 裁剪、clip_approx降到 0)。它要动批次键(切 scissor 必然断批),8 个真机判据页都得复跑 —— 记下一批。N-201因此仍是待落地。 - CI 248s 全绿;me-rhi lib 测试 67 → 70 + 3 条新集成(
tests/scissor.rs),胶水测试 30 → 33。分支agent/A2c650524。
- 前置:A1 的
关卡外置:`const` → `.lvl` 数据,改一行就改世界(已附端到端验收)
- 关卡从
const变成数据:新增crates/me-runtime/levels/coin-run-1.lvl(行式文本,#注释),src/coin_run/level.rs负责解析(带行号的错误)。 - 用
include_str!嵌进二进制:.app双击时工作目录是/,wasm/微信小游戏根本没有文件概念 —— 三个目标行为一致。改关卡仍需重编译,但改const本来也要。 - 解析器两条不静默的规矩:未知字段报错(
platfrom静默跳过 = “那层平台不见了”)、参数多了报错(“我改了宽度怎么没生效”);nan/inf也拒(所有比较恒为假)。 build_world改成接受&Level注入,并新增 4 条测试:世界跟随数据 / 出生点同时移动精灵与碰撞盒 / HUD 金币总数跟随 / 两段地面都铺到视口底。- HUD 里写死的
0/6改成coins.len()(3 处),LIVES常量取代两处各写一个3。 - 端到端验收:临时注释掉最后一枚金币 →
COINS_LEFT 6→5,且两帧像素差异只在x 320..351 / y 13..47(正是 HUD 最后一个字符6→5的位置),其余零像素变化。 - 新增 12 条关卡测试(含“常量与文件一致”的镜像检查)。`
- 关卡从
P13b:Mac 窗口全黑 + 闪退 —— 三个判据照不到的宿主缺陷
- 起因:只说「启动一下 mac 测试」,结果窗口开了两次都没画面,第二次弹了系统崩溃框。查出来是三条独立原因。
- ① 上屏路径从来不推进逻辑(P12 的回归):
SpriteRenderer.draw(in:)只encode,没有advance—— 那是 P12 抽出来时只给renderOffscreen加了调用。症状:窗口开着、标题里的分/命/剩都在动、画面全黑、标题写0 顶点 · 0 批,而 A/B/C 三组判据全绿(都走离屏)。活了两个批次、一次「能玩」验收。 - ②
AVAudioEngine抛 NSException,do/catch抓不住:从非 GUI 会话启动时拿不到音频硬件(system_profiler明明列着扬声器是默认输出)。试过三条都不够 ——do/catch(只抓Error)、查 HAL 默认输出设备(查得到照样崩)、AudioUnitInitialize探一遍(返回 noErr 成功照样崩),根因是outputNode的 getter 本身就会抛。最终新增 20 行 ObjC 桥Sources/ExcBridge.{h,m}用@try兜住,降级成「本次运行静音」。 - ③ 真正让人以为「一直在崩溃」的是启动时的恢复提示框:崩溃过几次后
NSPersistentUIRestorer会在applicationDidFinishLaunching之前弹模态的「要恢复窗口吗」,NSAlert.runModal把回调整个挂住 —— 进程活着、窗口不出现、脚本一行输出都没有。sample的栈里才看得见。修:UserDefaults.register(["ApplePersistenceIgnoreState": true])+window.isRestorable = false。 - 新增判据 D(上屏路径自报数):
ME_DEMO_LIVE_FRAMES=30→LIVE VERTICES 80 FRAMES 30 FRAME 30。不碰 drawable(currentDrawable在没有显示链路时会阻塞等 vsync,第一次接进 CI 挂了 5 分钟)。 - 判据自证的教训:第一版把
advance写在 live 分支里,删掉正式路径那一行仍然是绿的 —— 判据验的是它自己。改成推进只留一处(DemoController.draw开头),SpriteRenderer.draw改名render(in:)只管编码。现在删那一行 ⇒VERTICES 0 FRAMES 30 FRAME 0。 - 顺带:
codesign … 2>/dev/null的静默失败(.o误进Contents/MacOS)改成显式报错。 - 数字:CI 62s 全绿;1286 个测试;
--check摘要从 5 个 OK 变 6 个(MAC DUMP OK + 4×COIN DUMP OK + LIVE OK);真机窗口标题80 顶点 · 2 批 · dt 16.71ms。 - 提交:
fc1d7ae(主体)+21f63e0(文档数字)+ca812a1(真机窗口截图证据)。
N-207 + N-202:守卫认不出第二张表(main 本身就坏着);dump() 补上 uv/color
- main 的板子本身就是坏的:
Team/negotiation.md的 §4 汇总表一直是两块(98~141 行有表头、143~169 行无表头且逐行相同,rebase 的「两边都留」)。旧守卫只比对第一块 ⇒ 全绿,A1 和 A3 都在这个坏板子上改状态。 - 修法:
table_blocks()扫所有块,len(blocks) > 1直接红并给出行号范围;识别不靠表头(复制出来那半张没有表头,只按表头找等于漏掉它,判据是「连续|行里出现过表头或编号行」且只认围栏外);--fmt删多余块,判据是修复后与真板子逐字节相同。修完当场的下一次 rebase 又复制了一份,守卫红了、--fmt收敛、cmp相同 —— 同一个现场旧守卫是绿的。 - 守卫自己也有了测试(
Team/test_check_negotiation.py,8 条):它是唯一会发现板子坏掉的东西,于是它坏掉时没有任何东西会红(CI 跑的正是它)。自测用真板子的表体造副本(去掉表头),CI 里先跑自测再判板子。两处破坏演练都红:拿掉块数判据 ⇒ 端到端那条红;退回只按表头找块 ⇒ 3 条红。 - N-202 落地(A1 在 N-035 批准):
dump()补上uv与color,规则沿用rot那条(只在非默认时打);missing_fields从["uv","color"]变成空数组。 - 「漏字段」变编译错用穷尽解构,不用反射:
let DrawItem { texture, layer, z, pos, size, uv, color, sort_y, rotation } = *it;,加一个字段就E0027。演练:给结构体加pub drill: u8⇒ 构造点先E0063,补上后解构点E0027,两处都红。但穷尽解构只保证「测试提到了所有字段」,不保证「dump 打了所有字段」 —— 所以另加两条内容判据(HUD 那条 color 恰好出现一次;uv 默认时不许出现)。 - 末端判据:
mir-demo.html的hudTint()—— HUD 乘(255,128,128)后画面里 19.5% 的像素红分量高于绿分量(4096 个像素);改回共用sc.defaults.color⇒MIR DEMO FAIL/0.0%。旁边那条旋转判据在同样故障下全绿 —— 这个 bug 活了那么久,正是因为没有任何一条判据看得见它。 - 最大的教训:分支上的板子会落后 main 一个世界。
watch.py在我分支上说「没有一条是等 A2 的」,而 main 上有 42 条、其中 5 条是 A1 答复我的(N-032 cooked 场景名、N-033 D0 6/6、N-034 scissor 进 v6、N-035 uv/color 都加、N-029 看板选 A)。我提的 N-206/N-207 从来没上过 main,A1/A3 一次都没看见。以后动板子前先git fetch && git log origin/main -- Team/negotiation.md,rebase 时板子一律--ours,自己的条目在 rebase 之后重加。 - 数字:workspace 1286(分支)/ 1271(main);
me-compilerlower 25 → 29 条;MIR 判据 2644 点全过;CI 138s。 - 提交:
48b2d1d+f5b2970(agent/A2,rebase 后--force-with-lease);main 上a483dec+86e07b7(守卫与它抓到的第一份体检报告,纯共享基础设施按例外单独上 main)。
- main 的板子本身就是坏的:
P13:Mac COIN RUN 补音频 + 结算面板 + 按 R 重开(逐像素验过)
- 结算:结局那一帧一次性 spawn 260×76 面板(
Sim.panel记),HUD 搬进面板变三行居中 +max_width。实测面板 173899 px / 实心度 0.857,顶部白像素 0、全图白像素 8467。 - 重开:
restart清四样东西 —— 语音stop_all()、调度表clear()、定步长余量reset()、ctx.frame归零(新增GameLoop::ctx_mut())。最后一个洞是 Mac 离屏判据抓的:重开后第 1 帧与全新一局第 1 帧差 75 个像素(金币悬浮相位接着上一局,ctx.frame % 120)。补完逐字节相同。 - 音频:
AudioEvent::Play补voice(audio-ffi.md的me_au_play(voice, …)一直是带 voice 的,代码与自己的提案不一致而无人报错)。FFI 布局改成[kind, voice, sound, looping, left, right]。 - Mac 侧:
Sources/CoinAudio.swift一个算式合成器(正弦/方波 + 包络,无随机数,判据可复算)喂两个消费者:实时AVAudioEngine+ 离线OfflineMixer→ WAV。 - 判据:
build.sh --check三组 —— C 打到输(240 帧一直按右键)验面板 + 音频流水 + WAV(2ch/44100/16bit/4.000s,有声 0.945),D 第 240 帧按 R 验「与开局首帧逐像素相同」。 - 坑:离线混音第一版在
Stop时直接删语音 ⇒ 已响过的那段也消失,LOUD从 0.94 掉到 0.008。改成记end时刻。 - 数字:game_slice 31 条 + demo 22 条 + workspace 1282 条;CI 103s 全绿;提交
49a7cda。
- 结算:结局那一帧一次性 spawn 260×76 面板(
第十八批 P12:COIN RUN 在 Mac 上能玩(同一份 Game,两个宿主)
- 演示不抄玩法:
apps/macos-demo直接依赖me-runtime,键按下翻译成PointerEvent,与 wasm 宿主走同一个Game::press。Mac 侧另写一遍「右键=向右加速」的话,今天一样、三个月后必不一样,而没有任何判据会红。 Game不是Send(系统是Box<dyn FnMut>)⇒OnceLock<Mutex>编译不过,换thread_local!{RefCell};顺带删掉上批的static SERIAL: Mutex——串行化是把并发问题按下去,不是解决它。- 保比不铺满:逻辑画布 320×240 进任意窗口,
s = min(vw/320, vh/240),余量居中。判据期望值是320·vh/(240·vw);1024×768 上「铺满」也是 1.0000,这个尺寸抽不到它。 - 实测:判据 A(武术)覆盖率差 −0.000 / 重心 +0.001;判据 B 宽高比 1.0000 / 2 批 / HUD 白像素 3704 / 五种物件实心度 1.000;对照不按键
x=24.00→ 按右键 30 帧x=84.01。单测 24+17 条,workspace 1275 条,CI 57s 全绿。 - 证据:
apps/macos-demo/evidence/p12-coin-first.png与p12-coin-moved.png、check_dump.py --coin、提交dfb6512。 - 最值钱的坑:图集是白色+alpha,颜色判据对纹理完全不敏感。「所有批次都用第 0 张贴图」的破坏演练第一版全绿,因为乘上顶点色后颜色逐值不变,变的只有形状。换成数包围盒里非底色像素的实心度才红(1.000 → 0.133/0.185/0.203/0.238)。判据要抓的是「哪条路错了会给错答案」,不是「改动之后哪里变了」。
- 另一条:
rebase把协商板 §4 汇总表复制成两块而守卫只认第一块 ⇒ 全绿。已手删,缺口转成 N-207 给 A1(check_negotiation.py归 A1)。
- 演示不抄玩法:
紧排图集接进 Mac demo:anim.rs 支持矩形表,Metal 那一侧也画对了
- 图集紧排落地:18 帧武术图集 1024×1280(内容 49.9%)→ 1024×699(内容 93.3%,面积 −45%)。做法:裁到外接框 → 高度降序 → shelf 装箱(照抄
Atlas::insert)→ 贴图时四周外扩一像素。相邻帧最小差异仍是 79.3,与改造前逐值相同 ⇒ 画面内容没变,只是排布变了。 SpriteSheet从「cols × rows」扩成Layout::{Grid, Rects},新增from_rects(rects, atlas_w, atlas_h, frame_ms)。契约零改动(SpriteInstance.uv从 S3 起就是四元组)。cols()/rows()删掉(全仓无调用方),换grid() -> Option<(u32,u32)>。- 一个必须一起记住的副作用:紧裁把「头在哪一列」这个对齐信息裁没了。所以每帧随矩形存一个锚点
ax(头部中心到矩形左边的距离),消费方按它摆位 —— 只按矩形中心摆,踢腿帧会左右跳。 - Mac demo 改法:先按
ax把矩形放进虚拟的BOX=256格子(底边贴格底、头心对格子竖中线),再整格缩放到屏幕目标框。舞台与 18 格缩略图走同一份place(),两边各写一遍必然出现「舞台对、缩略图歪」。 - 真机判据:
build.sh --check离屏渲染 → PPM → 比基线,MAC DUMP OK:舞台覆盖率差 0.000、重心差 +0.001 / +0.002(阈值 0.03 / 0.02)。基线gen_expect.py是按同一套摆位算式独立写的第二份实现,不是拿实现验实现。 - 踩到的坑(值得记):①
SpriteSheet的文档链到私有Layout⇒ rustdoc-D warnings拦下,CI 红在这一步。②apps/macos-demo是独立 workspace,根cargo test/clippy --workspace永远看不到它 —— 补 CI 之前它带着 12 条-D warnings级错(11 条unsafe extern "C"缺# Safety)没人知道。③ 这个 crate 用static Mutex存全局状态,并行测试里frame()写、frame_no()读互相踩 ⇒ 加了static SERIAL: Mutex<()>串起来;重跑就绿的红最容易被当噪声放过。 - CI:新增一步「Mac 原生(Rust 侧)」跑该 crate 的
cargo test+clippy -D warnings(不需要 GPU/swiftc,任何机器都能跑);全量 CI 由 1233 个测试通过。 - 报备:改了两个
open路径(apps/macos-demo/**、tools/ci/ci.sh),已Team/say.py --kind fyi。
- 图集紧排落地:18 帧武术图集 1024×1280(内容 49.9%)→ 1024×699(内容 93.3%,面积 −45%)。做法:裁到外接框 → 高度降序 → shelf 装箱(照抄
Mac 原生 demo 跑通:Rust 出顶点,Swift+Metal 上屏(第一批 · 武术 18 帧)
- 新增
apps/macos-demo/:能双击的 .app。Rust 编 cdylib,只出顶点(20B,已转 NDC)/ 索引 / 批次表;Swift 写窗口 + Metal 管线。零 Cargo 依赖(swiftc 不进 Cargo,也不动根 Cargo.toml)。 - 切分的理由:
me-rhi在非 wasm 宿主只接NullBackend(native 发不出 draw call),但me-render::batch的产出本来就后端无关。这一批兑现了那句话——同一份批次表,WebGL2 和 Metal 各画了一遍。 - NDC 换算复用了
RhiSink::upload_geometry的算式(在 Rust 侧做,不在着色器里),所以两边顶点逐字节相同,画面才可比对。 - 真机判据:
build.sh --check→ 离屏渲染 → 读回 PPM → 和expect.json逐项比。实测舞台覆盖率 0.249/0.251、重心差 +0.001、18 格缩略图全在 ±0.04、高亮 1.69×。 - ⚠️ 踩到一个只有数值判据能抓的坑:纹理上下颠倒了。窗口截图里看着完全正常——武术素材本来就有一堆倒立/翻滚帧,全局颠倒被当成“这一招就这样”。只有重心项(0.464 vs 基线 0.535)红了才暴露。
- 破坏演练三处全红:缩略图 uv 错一帧 / 高亮失效 / NDC 的 y 不翻转。
apps/macos-demo/已登记到 A3 owns + 第 10 条 open;CI 加一步(无 swiftc 明确跳过)。全量 CI 52s exit 0**。- 第二批待做:COIN RUN 可玩版(键盘 + me_runtime::coin_run)。
- 新增
演示页加统一导航条与总览页 menu.html(13 页)
- 新增
apps/coin-run/nav.js:一行<script src>注入顶部导航,按「玩 / 看 / 判据」分三组,当前页高亮。用position: sticky而不是fixed—— fixed 会盖住 wushu 舞台顶部,判据读的是 canvas 像素,遮住就看不清在验什么。 - 新增
apps/coin-run/menu.html总览页:12 个页面分三组列卡片,每张一句说明 + 一行提示。打开演示.command与serve.sh --open menu默认进这一页。 - 13 个
*.html各加一行 script(12 个原有 + menu 自己)。 - CI 加两条清单检查(
tools/ci/ci.sh):① 每个 html 都引nav.js;②nav.js提到的.html必须真实存在(死链在浏览器里看起来就像页面坏了)。都做了破坏演练:改错一个文件名能判红。 - 判据页结论行一个都没变(这是验收条件):wushu 18/18、anim 12/12,其余 8 页 atlas/text/scale/mip/rotate/nine/mir/demo 全部 SELFCHECK PASS,mir 2644 像素 0 对不上,demo 八面板正常(合批 4096 精灵 1 批、99 µs/帧)。
- 全量 CI:exit 0,50s,新检查显示「13 页都有导航且无死链」。
check_bash.py21 个脚本通过,归属自检 6 处协商共享已向 A3 报备。
- 新增
P9 用生图素材跑 P8:18 帧武术动作,三个反直觉的坑
- 素材:CloudBase 云函数
genImage(混元HY-Image-3.0-Plus,走成长计划赠送额度,不额外扣费)生成 3 张图、每张 6 个人物 = 18 帧。三张原图与提示词都入库(apps/coin-run/wushu/gen/*.jpg、prompts-sheet*.json),可复现。 - 为什么一次生成六个动作:逐帧分别生成时人会长得一帧一个样 —— 而肉眼看单帧全都对,只有连起来播才发现是六个人。同一次生成的一致性由模型自己保证。
- ⚠️ 坑① 白衣服会被当成背景抠掉。背景近纯白 + 白练功服时,衣服与背景色差只有 10、描边是 135。按「与背景色差得远 = 前景」判,整件衣服落进背景只剩一圈描边;反混合 α 趋 0 除出来是黑的 —— 第一版十六帧里一半人穿黑衣服。正解是从画面边界漫水填充:与边界连通的那片才算背景,衣服被描边围住就自动算人物,什么颜色都无所谓。
- ⚠️ 坑② 「AI生成」水印不是淡的:实测 alpha 峰值 1.00,和人物一样实心,按「淡」筛一条也滤不掉。能分开的只有面积(人物 3~4 万像素,字块 200~1000)。更早一版按外接框面积筛还会长出一帧只画了一个「A」的假帧(框 40×50 过门槛,前景像素只几百)⇒ 筛前景像素数,不筛外接框面积。但真正解法是改构图:提示词要求画面底部留 12% 空白,水印落进空白带 —— 把噪声从数据里赶出去,比事后挑出来便宜。
- ⚠️ 坑③ 逐帧缩放让踢腿像呼吸:踢腿帧外接框突然变高,按框高逐帧归一会让整个人缩一下。改为按源图分组、组内统一缩放,基准取身高中位数;水平锚用头部中心而非框中心(腿横伸会把框中心拉偏,人突然向左跳)。
- 判据三条(全是「错了照样能播」):18 格非空 / 相邻帧必须不同(两个顺序都查)/ 脚底都在 249±3。门槛
MIN_DIFF取 20 而不是「不为 0 就算不同」—— 实测最小 79.3,设 0.5 只抓得住「两帧一模一样」。 - 破坏演练三轮:插重复帧 ⇒
生成顺序里重复帧 0→0;Loop 取余改四舍五入 ⇒loop@89 得到 1,应为 0;把once@1620期望 17 改 0 ⇒ 两条同时红,其中「同 elapsed 异 mode 必须不同帧」那条也红了(改完两者都返 0,对照没了)—— 这条红得最有价值:把对照改成一致会被抓住。 - 实测:真机
WUSHU OK 18/18(最低内容占比 13.9%、相邻最小差异 77.0、帧号表 11/11),CI 53s 全绿(新增一步 5 项,REPORT_PAGES 10→11)。截图evidence/p9-wushu.png。提交acd1d84已推agent/A2。
- 素材:CloudBase 云函数
P8 帧动画:整数毫秒 → 帧号 → uv,契约零改动(真机 12/12、19200 判据)
- 契约零改动:
SpriteInstance.uv从 S3 起就是[u0,v0,u1,v1],一帧动画要的东西它已经全有 ⇒DrawItem/render.pass.md/MANIFEST.json一行没改。缺的从来不是「能画出某一帧」,而是「哪个时刻该是哪一帧」。 - 三条判据都是「错了也能跑」:帧与帧之间没有几何变化,帧号错、uv 偏一格,画面上都还是一张会动的图。① 整数毫秒且只除一次(
f32逐帧累加一小时漂几十毫秒 = 正好吃掉一整帧);②Loop用(elapsed/frame_ms) % n,不先乘回毫秒(n*frame_ms在overflow-checks下当场 panic);③Once播完夹住不回绕。 - ⚠️ 除零
overflow-checks管不了 —— 它在 Rust 里无条件 panic。frame_ms == 0必须显式返回第 0 帧,而它来自策划配置。 - 素材三通道分工:
R= 每帧左上角一个像素写帧号色(64/128/192/255)⇒ 偏整帧;G= 1 纹素棋盘格,亮格CHECKER[帧](255/192/128/64)⇒ 偏一纹素;B恒 0 ⇒B == 255只可能是洋红清屏色。共用通道等于给错误留后门(「这个 255 是帧号还是棋盘格」)。 - 2×2 是刻意的:
1/3在f32里是0.33333334,边界落在纹素外侧 ⇒ 判据只能写「约等于」,而那种判据没人能复核。 - 12 个副本同一帧,只有
elapsed不同(分十二帧画会毁掉判据:任何一份错了都能被解释成「帧不同」)。第 2 行整行是第 1 行的对照:elapsed=120在Loop下第 0 帧、在Once下第 3 帧 —— 同一时刻必须给不同答案,否则「mode 没被用」会安静通过。 - 测试抓到一次真问题:
Once行四格全在最后一帧,「相邻必不同」不可能满足。那是数学事实,所以改测试不改数据(Once播完全同是正确行为,不是被稀释的判据)。 - 第一版十二格几乎一模一样(只有 1 个纹素不同),放大到屏幕是 2×2 像素 ⇒ 亮格绿随帧变暗。一个看不出在演示什么的演示等于没演示。
- 破坏演练两轮:
uv故意+1帧 ⇒ANIM FAIL tint=12(原因准确);Once改成回绕 ⇒ 三条单测同时红(语义 / 单调性 / 表一致性)。 - 实测:单测 26 条 + 表对照 6 条;真机
ANIM OK 12/12、19200 条判据、批次 1、退白 0;截图evidence/p8-animation.png;CI 140s 全绿(新增一步 32 项)。提交0e7da45已推agent/A2。
- 契约零改动:
判据从「某个人看见过」变成「有记录」——Safari 在屏幕休眠中也能验收了
起因:上一批做完「Safari 一条命令打开」后我想自己验收 ——
osascript读title被 TCC 拦(-10004),截图时屏幕睡着截到壁纸。页面很可能已通过,而我无法知道。做法:判据多了一个读者。页面
verdict-report.js盯<title>变了就POST /verdict,新增的serve.py(http.server超集)落到/tmp/coin-run-verdicts.jsonl,serve.sh --verdicts直接 cat。绑 127.0.0.1、4 KiB 上限、no-store(顺手治 Chrome 磁盘缓存老坑)。八个run-*.sh与九个自校验页跟着换,CI 加一步静态检查。实测:headless Chrome 两次各回传
DEMO READY 8/8;Safari 26.4、屏幕休眠中也回传DEMO READY 8/8。证据evidence/p7-safari-verdict.jsonl。坑:①
send_error(code, "中文")把 message 放状态行,而状态行只能 latin-1 ⇒ 客户端看到RemoteDisconnected而不是 400;②why=load不代表 observer 坏了(同步渲染十几秒,1.5 s 兜底定时器栈一空就先跑);③ 兜底通路会把静态标题当结论 ⇒ 加initialTitle守卫。CI 全绿 44s(新步骤 17 项,降级仍 2 项);25 处改动全在协商共享路径,已
say.py报备。演示在 Safari 里一条命令打开 + 第 8 个性能面板(顺手修掉 516 倍浪费)
1.
serve.sh --open:一条命令起服务并用 Safari 打开(--open mir/game/selfcheck,--stop收,BROWSER可换)。用 nohup 摘出去,等端口真通了再 open —— 抢在前面就是 ERR_CONNECTION_REFUSED,而「再刷一次就好」最容易被当成页面 bug。2. 结论横幅:
<title>与页面上那行由setVerdict()同一次赋值写。以前只在 title 里,无头 Chrome 抓到、人在 Safari 里看不到。两处各写一套就会出现「CI 判过了而人看到的是旧版」——两边都「有结果」,最难查。3. 第 8 个面板「合批吞吐」(4096 精灵 = 1 批)。第一次跑出 50150 µs/帧,根因是
draw_external每帧OffscreenTarget::new+dispose(尺寸根本没变)⇒ 改成按尺寸复用,97 µs/帧(516 倍),千精灵 12243 → 23.6 µs。⚠️ 七个探针页只画一帧,这个白花开销在它们身上永远看不见。4. 判据落在批次数不是耗时:耗时跨机器差两个量级(Apple GPU 0.07ms vs SwiftShader 50ms),红了的人没法复核。乘色另用两个角的像素判(乘色没生效时前三条全对,逐字节比对也抓不到)。
5. 号段化:一天撞了两遍号(N-008/9 撞 A3,改 N-015/16 又撞 A1 的 15/16/17)。根因不是忘查号,是分支上的条目在合进 main 前别人看不见 ⇒ 改成 A1=1xx / A2=2xx / A3=3xx,守卫加
segment_problems(≥ 10-25 的条目必须落在自己号段),演练过会红。render.pass.md因此一天内第二次升版本,只为一行引用。6. 数字:DEMO READY 8/8 · 69s→18.7s→15.1s · mir-demo 仍 4/4(像素数字一字未变)· CI 全绿 197s · 提交
50a046874982866184b44,已推 agent/A2。7. ⚠️
say.py正文用双引号传时,里面的反引号会被 shell 当命令替换吃掉,内容静默消失而返回 0。⚠️$VAR紧跟全角括号会被 bash 3.2 当成变量名的一部分 ——check_bash.py本来就抓这个,我在「改了还没跑 CI」的窗口里踩的。P5 · 内容驱动:引擎能画别人给的东西 + 两个演示页
做了什么
me_render_external_frame:按外部给的精灵表(56B/条)+ 纹理表(16B/条)渲染一帧,走与七批探针同一条路径。于是me build的绘制列表第一次有了消费者:.mir的rot=0.5236一路走到屏幕上一颗转了 30° 的金币。- 两个能直接看的页面:
demo.html(七个面板各自一个 wasm 实例 + 一个 WebGL2 上下文同时活着)、mir-demo.html(一份内容变成画面)。 - 新提协商 N-009(A2→A1):
DrawItem::dump()少打uv与color。
实测:mir-demo 判据 2644 像素、精确 99.7%、对不上 0;demo
DEMO READY 7/7且重画逐字节相同;CI 20 步全绿,测试 931 → 944。坑:⚠️ Chrome 复用
--user-data-dir磁盘缓存 ⇒ 改了 html 跑的还是旧页面(DOM 里是旧结论,会让你以为跑过了),八个run-*.sh全中已修;⚠️ 判据漏半像素的症状看起来像旋转方向反了;⚠️ Rust “自己写自己读”的布局测试是盲区,必须有 JS 侧独立对照。P4 · UI 从「能画」到「能编排」:九宫格 + 矩形裁剪
做了什么
me-render::nine:九宫格展开成最多 9 个精灵,不加图元;九块同贴图同图层 ⇒ 合批后仍是一次 draw call。rotation != 0返回错误而不是画歪。me-render::clip+DrawList裁剪栈:未旋转精灵精确重映射 pos/size/uv;旋转的只判整块内外并计入clip_approx。相机剔除与容器裁剪分两个计数。render.pass.mdv8→v9(ui:能画→能编排);协商板 N-008 提给 A1(me_rhi_set_scissor进不进 v6)。
实测与代价
- 真机
apps/coin-run/nine.html(P4):12096 条判据零容差全过,截图evidence/p4-nine-clip.png。零容差靠参数整数化:切边 4、目标 64 ⇒56/8 = 7,每源像素正好 7 屏幕像素。 - workspace 测试 931 个(本批 +56),CI 全绿 110s / 17 步。
坑:三段分割返回值顺序要见名知意(
(a,b,rest)被当(l,c,r)⇒ 三块全错);源图无中间段时目标不能还按三段分(会留洞);「空裁剪矩形」≠「没有裁剪」。扇区边界改三档(新增「协商共享」9 条)+ 协同区搬上 main
- 起因不是纪律,是划分错了。 查 168 条代修登记,前几名全是「同一条路径因同一个机制被跨扇区重复改」:
cross-sector.txt自己 38 次、ci.sh12、minigame-smoke~18、coin-run6+、MANIFEST.json5、me-cli/src6、compiler/passes4。第一条是自指的荒谬——登记越界这个动作本身要改那张表,于是每登记一次就制造一次新越界。 - 三档:① 排他(owns,跨扇区走复核人+到期日的代修);② 协商共享(open,新):责任在 owner 但谁都能改,不要复核人、不要到期日、改完 fyi 报备一句;③ 代修只在①上偶发用。进②的判据可查:同路径被跨扇区重复改 ≥3 次且理由同构。
- 不是全放开:②放的是「谁都要动的实现细节」,①守的是「一方动、全体受影响的面」——契约内容 / ABI / Cargo 骨架 /
agents.json。 - 守卫改动关键一处:
open必须在shared/owns之前短路。apps/coin-run/**在 owns 与 open 里字面相同、specificity 相等,谁赢会取决于max()对相等键的取舍——那是实现细节,不该决定「能不能跨扇区改」。 - 验证:24 条路径逐条断言档位 0 条不符;
--as A2改 open ⇒ EXIT=0,改me-compiler/src/lib.rs/Cargo.toml⇒ EXIT=1(放宽没把排他档一起放掉)。 - 三份 agent-briefs 同步(不然规则等于没发布)。A3 那份多写一段:它 7 条路径被放开最多,要说明「别人改你的目录是预期行为,判断改坏没改坏靠跑 CI,不靠读 diff」。
- 协同区上 main(
32dd1c1):只在 agent 分支上的话,A1/A3 拉 main 看到的是搬迁前的旧世界(plan/negotiation.md还在、Team/不存在)⇒ 「通过 Team 协商」物理上不成立。只摘共享基础设施,不带 16 个引擎提交;ci.sh不能整取(会带上未验收的探针步骤),只手改一行路径。 - 预演了 A3 的 rebase(worktree,不改他的分支):会撞 3 个文件 ——
cli.rs2 块(双方各加一个子命令:main 有Build、A3 有Pack⇒ 两个都留)、ci.sh2 块(同一段代码两代写法,得他自己判断)、cross-sector.txt1 块(两边都留)。这比事后让他自己发现省一轮。 - 顺手补
.gitignore漏的apps/coin-run/wasm/(181 KB 产物;至今没入库纯靠每次写显式路径,等于没防)。 - CI:876 测试 / 16 步 / EXIT=0(main 与 agent/A2 各跑一遍)。
origin/main=32dd1c1,origin/agent/A2=b67b254。
- 起因不是纪律,是划分错了。 查 168 条代修登记,前几名全是「同一条路径因同一个机制被跨扇区重复改」:
网站进 git:线上从此能反查是哪一版
- 起因:「网站可以在git仓库里,发布到线上」。这不是删一行 ignore。
- 事实:
plan/agents.json的generated一直登记着 site/(“由脚本产出但会提交”),而.gitignore里躺着site/—— 矛盾了近两个月没人发现。gantt.html 当年同款矛盾,那次也是改忽略规则。顺带补登记了 site/board/index.html。 - 先定语义,再写判据:site/ = 最近一次发布的快照,不是源码镜像。若按镜像判(逐字节等于构建结果),每次改代码都红——因为页面上有工程量。第一版函数就是那么写的,立刻因为「脚本 15,247→15,356 行」而红,差异全来自刚改的两个 .py 本身。所以 CI 只验「能构建 + 产物完整」。
- 基线改成仓库里那份页面:
git show HEAD:site/board/index.html里的指纹表。旧方案读旁路文件,发版后再构建一次就与线上分叉。HEAD 那份不会被本地预览动到。 - 线上可反查:
/deploy.txt写 commit,写完必须 curl 读回来比对——它存在的唯一目的就是“能查”。踩了两次 403(隐藏路径规则 +.json deny)才找到位置;根因是一条真教训:“写在磁盘上”和“能从 HTTP 读到”是两件事。 - 闭环实测三条:两次构建逐字节相同 / 线上页面==本地 site/ /
git show "${C}:site/board/index.html"逐字节等于线上。第三条让“网站进了 git”从声明变成可验证。 - 顺手修真 bug:
fmt_week_note用 date.today() 写「还有 N 天」→ 页面永远停在构建那天,且 site/ 入库后每天第一次 CI 必红。改为浏览器算。 - 新成本:改任何代码 → 重建站点 → 提交(工程量会变)。不做也不红,只让 deploy.txt 指纹与仓库对不上;发版必然重建,发布态下两者一致。
协同区建成 Team/:协商板与守卫搬入,状态只有一处
- 建之前先看了已有什么:发现
plan/negotiation.md+check_negotiation.py已经存在,而且比我准备建的成熟(四态机 / 到期日 / 已关闭必须有落点 / 正文≤24行 / 汇总表由正文推导)。⇒ 不重复造,只补它做不到的三个槽位,并把它搬进Team/。 - 三个槽位都不持状态:
notes/<AGENT>.md(各家流水,一人一个文件 ⇒ 文件级零冲突,正对cross-sector.txt的病)、open/<id>.md(议题正文,板子限 24 行放不下)、beat/<AGENT>(心跳,板子只记「谁欠着」不记「谁活着」)。 - 最重要的设计:状态只有一处。
Team/open/*.md不写 status/due,只写negotiation: N-xxx;watch.pyimport 守卫的parse(),格式只有一处实现 ⇒ 它报的「谁在等我」永远等于ci.sh那步报的东西。代价是开议题要动两处(故意的摩擦),而--open会把孤儿与悬空议题报出来。 - 搬家断了四条链:守卫
BOARD、ci.sh调用、agents.jsonshared、board.jsonev +p0-plan.json+ 三个 prompts。gantt.html 已重生成。 - CI 抓到 1 处 + 自查抓到 3 处:红在「看板证据路径不存在
plan/negotiation.md」——那条是 rebase 从 main 带进来的(板子搬迁前写的)⇒ 搬迁后任何从 main 进来的旧引用都不在你的 diff 里。另三处是「路标」(写给读者的指引,编译测试都不报):板子 §2 指着旧守卫、watch.py的 docstring 与提示文案。 shared的 owner 在check_ownership里也是排他的 ⇒ 光靠 git 零冲突不够,agents.json必须逐文件登记(新增 13 条),否则 A1 写自己的notes/A1.md会被判越界。顺带发现既有设计矛盾:docs/**的 policy 写「各 Agent 只追加自己的章节」但 owner 是 A1。- N-007 已提:MIR 怎么表达旋转角(度 vs 弧度 / 要不要 pivot / 归一化),正文在
Team/open/2026-10-24-mir-rotation-syntax.md。板子现状:7 条,在等:A1 ← N-007 / A3 ← N-001, N-006。 - CI:876 测试 / 16 步 / EXIT=0,「协商板」那步已用新路径跑通。提交
73b677d(搬迁) +4bae1c8(补漏),已推agent/A2。
- 建之前先看了已有什么:发现
2026-10-23
P3 收尾:接缝测试 + 四张老判据页复跑全绿(874 测试)
- 改了
push_quad(所有精灵都走它)⇒ 把机器上四张老判据页全部复跑:atlas 12 / text 9 / scale 24 / mip 192,一条没红。新判据证明"旋转能画",复跑证明"没把别的弄坏"——后者 CI 查不出来(主机侧只验算式不验像素)。 - 补三条接缝测试:①两条收集路径(带相机/不带相机)都要原样传角度;②剔除用旋转后的包围盒(同一精灵不转时被剔、转 45° 后必须画);③不转时包围盒与
pos/size逐字节相同(防那个0.0短路被当冗余优化掉)。 - 第②条错起来的样子是精灵转到某些帧消失、其余帧正常——很容易被归因成相机或批次,所以它必须有自己的断言。
- CI:874 测试 / 16 步 / EXIT=0。已 rebase 到最新 main 并推
agent/A2(f139254)。
- 改了
P3 旋转:五份同帧 2880 条判据,第一批「一个约等于都没有」的像素判据
- 五个副本同一帧(同贴图 / 同尺寸 / 同 uv,只换旋转角),2880 条判据(5 × 24×24 格)真机全过,五份两两不同 10/10 对,
glError = 0,一次过没调参。 - 第一次做到像素判据不需要任何容差:90/180/270 把整数坐标映到整数坐标 ⇒ 读回值必须逐字节等于源位图的一次转置/翻转。
- 非直角用 3-4-5(≈36.87°)而不是 45°:
sin/cos= 0.6/0.8 ⇒ 逆旋转后的源坐标恒为奇数/10,离最近纹素边界 ≥ 0.1;45° 的0.7071…可以任意接近整数。这就是"不要容差"的根据,而且有单测把它钉住。跟上一批把缩小倍数从 8 改成 7 同一个道理。 - 素材
v(x,y) = 16y + x:每个像素的值唯一(字形/图标有大量重复值,会把判据稀释成"看起来差不多")。副作用是灰阶铺满 0..255 ⇒ 清屏色必须跳出灰阶,用洋红(255,0,255);顺带白拿一条判据:像素要么灰阶、要么逐通道等于洋红,没有第三种。 - 功能:
SpriteInstance.rotation/Transform2D.rotation(弧度,正值 = 屏幕上顺时针,绕中心)。旋转几何只此一份(corners_of/aabb_of),顶点展开与剔除共用 —— 各算一份 ⇒ "画出来了但被剔掉了",只在转到某几帧出现。 - 契约检查把这一批拦下来过一次,拦得对:ADR-0006 §2.2 要求
DrawItem与SpriteInstance字段集一致;已给me-compiler的DrawItem加同名字段(恒 0.0,MIR 无旋转语法),登记cross-sector.txt(复核 A1+A2)。⇒ 渲染侧通了,内容(.mir)里的精灵还转不了,要 A1 定 MIR 属性形状(§1.9)。 - 顺手改正状态文档 §7 那句"旋转要换算法层":渲染侧只要加字段,物理侧才要换算法层。
- CI:867 测试 / 15 步 / EXIT=0。提交
b975241(代码+证据) +b9983f3(文档),已 rebase 到 main 并强推agent/A2。
- 五个副本同一帧(同贴图 / 同尺寸 / 同 uv,只换旋转角),2880 条判据(5 × 24×24 格)真机全过,五份两两不同 10/10 对,
看板加了「哪里更新了」:绿→蓝,红点指路
- 起因:「看板已经更新但我没看过」+「每次看都不知道该关注哪里」。这不是排版问题,是缺一层状态——页面只有「现在是什么」,没有「和上次比变了什么」。
- 三层分工:绿(条目)= 变了且没看过;蓝(条目)= 变过、看过了;红点 = 那里面还有绿的但我没滚到(导航角标 / 收起的迭代卡 / 右下浮动「下一处」)。红点只出现在看不见绿的地方,因为它指位置不指状态。
- 变化怎么算:每个条目按内容算 8 位指纹(task 含状态+标题+why+ev,里程碑含状态+why+全部判据),与 plan/board.revs.json 比对。工程量和完成度百分比刻意不进指纹:尺子量出来的数每轮都变,算进去等于天天说「有更新」,这个词随即失去意义。
- 看过 = 50% 可见 + 停留 900ms。滚轮一甩而过也「进入过视口」,那不算——替人决定「他看过了」比不做更糟。
- 首访只标构建期变化集,其余当基线写本地;否则第一次打开满屏绿,那是把「我还没有基线」说成「全都变了」。
- 「全部标为已读」带 8 秒撤销:它一键抹掉的正是这个页面唯一的值。
- 实测 24 项全过:首访只标 1 处 / 停留后转蓝 / 刷新记住 / 指纹对不上重新变绿 / 全部已读+撤销 / 1440 与 390 无横向溢出 / 无 JS 报错。
- 顺手修两个坑:
.sp角标用attr(data-new)但属性在祖先上,attr()只读同一元素 → 命中规则、内容为空,画面上只剩一个空胶囊(看起来像样式问题,不像数据没传过去);.revbar{display:flex}顶掉了[hidden],没更新时露出空壳。 - 颜色都手算过:未读绿白底 5.43:1、已读蓝 3.89:1(3px 竖条,非文本门槛 3:1)、红点白字 4.97:1。色盲兜底是标题后的「新」字,不靠色相单独承载信息。
A2:放大字形——采样器按素材分,把「糊」变成可算的 85 / 170(P1)
- 起点是上一批自己写下的「真问题」:缩放 ≥2 的像素字体走双线性会糊。写在文档里等于还没解决。
- 症结不在渲染:
SamplerDesc::pixel_art()(两档 NEAREST)早就写好了,但RhiSink只有一个sampler字段、懒建时固定用sprite()(线性)⇒ 这个 API 存在却从未被真机验证过一条指令。修法:samplers: [u64; 2]+TexEntry.filter,upload_font_atlas→ Nearest。 - 为什么 filter 挂图上而不是精灵上:挂精灵上要先让批次键
texture→(texture, filter),而Batch是me-render导出的公开类型 ⇒ 契约级改动 + 波及每一处SpriteInstance构造点。代价如实记下:一张图两种读法仍要上传两次(32KB,可量)。分界不是「灵活 vs 死板」,而是哪种错了会静默。 - 判据(可复用):一帧画两个副本,只换采样器句柄(左 x=16 线性 / 右 x=200 最近邻)。分两帧会被归因成「帧不同」。缩放必须取 3:
1/3×255=85、2/3×255=170都是整数;取 2 得 63.75/191.25 ⇒ 判据里出现「约等于」就没人能复核。 - 两个数字就是「糊」的定义:两笔之间的黑格 线性 85(墨漏出来)vs 最近邻 0;笔画边缘那一列 线性 170(边缘稀释)vs 最近邻 255。
- 真机一次过,没调参(SwiftShader / Chrome 640×360):
SELFCHECK PASS,24 条判据(12 点 × 2 副本),两副本差异 5 条 / 相同 7 条,批次 2 / 退白 0 / 四边形 2,glError = 0。实测与算式逐条相等,连 170、85 都没偏一。 - 比表更严的硬判据:要求「两副本读回值恰好差 5 条」。表只能证明表被写成 5 条;读回值才能证明换采样器在这台机器上真的可见。反过来「另外 7 条必须逐字节相同」同样重要:12 条全不同 ⇒ 两边不止差采样器一件事。
- 顺带修一处文档错误:
SamplerDesc::sprite()注释写「缩小取最近」,代码是min_filter: Linear。注释与代码不符的代价不是文档难看,而是下一个改这块的人会相信注释,于是不去查 mip 的缺口。 - 证据:
apps/coin-run/evidence/p1-sampler-scale.png(一帧两个副本 + 各自放大 8 倍 + 24 条判据)。左「4」笔画四周一圈灰边、中间黑格发白;右「4」是硬的像素边,肉眼可证。 - 主机侧 12 条进 CI(
wasm_scale9 +scale_js_table3)+rhi_sink3 条,整体 830 测试 / 20~40s 全绿。
看板进了 CI:从「靠记得」变成「忘了会红」
- 起因:要求「每次更新都把文件数和代码量放上去」。在此之前工程量只是「我记得跑一次」——
build_board.py --scale存在,但没人逼你看。 - 改动:
tools/ci/ci.sh新增「看板」一步,跑build_board.py --check(4 条守卫:证据路径不存在 / 任务 id 拼错 / 里程碑与判据不自洽 / 标记完成但无证据),并在同一步打印--scale那一句工程量。 - 定位:工程量只打印、不判定(改一行注释数字就变,CI 验不了“对不对”);但“这次没带”从此变成看得见的事。
- ok 行只写「数据自洽」,不写“已发布”:site/ 是产物不进仓库,CI 绿 ≠ 线上新。把两件事说成一件,是这类检查最常见的谎。
- 演练:把 S0-1 的证据路径改成不存在的 → 立刻红并点名该文件;顺带那条 round-trip 守卫又抓到一次排版漂移。
- 后果:CI 14 步 → 16 步(另一会话同时加了协商板)。
- 起因:要求「每次更新都把文件数和代码量放上去」。在此之前工程量只是「我记得跑一次」——
A2:字上真机——32 条像素判据,并抓回上一批 uv_inset 的回归(S0-10)
- 为什么上一批不够:S0-6 用纯色块验渗色,而纯色块被拉伸、被压缩、被错开一格读出来都是同一个颜色——结构上就验不到「位置」。字形自带内部结构(
4的横笔右侧必须有空),且只有缩放 1 时「屏幕像素 ↔ 图集纹素」一一对应,判据才能是干净的 0/255。 - 抓回一处上一批自己的回归:
uv_inset是缩放不是平移(u 范围w→w-1个纹素,四边形仍占w个 ⇒ 内容压缩w/(w-1))。16 纹素只缩 6.7%,纯色块量不出来;5 像素宽的字缩 20%,笔画变形。上一批把text::bake改成uv_inset正踩这条 ⇒ 改回rect.uv(),并加测试盯「uv 跨度必须正好w个纹素」。字形本就不需要内缩:blit已向四周外扩一像素。 - 对照组设计(可复用):模式 1 把每块 uv 整体右移一个纹素,位置一像素不动 ⇒ 每个探针读到「右邻那颗纹素」。16 点里刻意留 6 条翻面、10 条不翻;全都会翻的话「6 条」可以靠「随便什么都翻」凑出来。而且判据用「读回值真的变了 6 条」而不是「表里写了 6 条」——后者只能证明表被写成了那样。
- 真机(SwiftShader / Chrome 640×360):
SELFCHECK PASS,32 条判据(2 模式 × 16 点),对照组翻面 6 条,glError = 0,两模式都是 批次 1 / 顶点 8 / 退白 0 / 字形 2。一次过,没有调参——因为期望全是手算常量(ORIGIN=16/ADVANCE=6/5×7/gl_y = 359 - top_down),不是从代码反推的。 - 探针坐标必须硬编码:反过来用
GlyphMetrics::pos+ 排版公式推屏幕位置,排版错时探针跟着错,两边一起错 ⇒ 判据永远绿。 - 主机侧 9 条进 CI(
wasm_text6 +text_js_table3),整体 810 测试 / 20~40s 全绿。其中一条拿BuiltinFont::ink反推回字形内(c,r)逐点核对期望 —— 它抓的是「改了字形美术没改探针表」,这种漂移在截图上根本看不出来。 - 证据:
apps/coin-run/evidence/s0-10-text-on-device.png(两帧 + 「4」放大 16 倍 + 32 条判据) - 未覆盖:缩放 ≥2 的像素字体(双线性是加权平均,要清晰得换
NEAREST采样器——那是「采样器选择」问题,不是文本链路问题);中文(内置字体只有 ASCII 32..126,换来源只需换GlyphSource实现);微信真机WXWebAssembly。
- 为什么上一批不够:S0-6 用纯色块验渗色,而纯色块被拉伸、被压缩、被错开一格读出来都是同一个颜色——结构上就验不到「位置」。字形自带内部结构(
A2:图集渗色收口 + 18 条真机判据(S0-6)
- 契约 §5.2 那句「图集要么加 padding、要么内缩」是错的措辞:实测是三件事——留边、留边填边缘色(
Atlas::dilate)、uv 内缩半纹素(AtlasRect::uv_inset)。只做第一件,症状从「渗邻格」变成「边缘发暗」,一样不报错。 - 主机侧 9 条断言(
crates/me-render/tests/atlas_bleed.rs):把 GL 双线性规则抄一遍(s = u*N - 0.5+floor/frac+CLAMP_TO_EDGE),于是「边缘会混」变成可算的事。uv()+ 空留边 ⇒ 蓝色只剩0,0,128(alpha 也减半)。 - 真机侧 18 条(
apps/coin-run/atlas.html):同图集同精灵,只换 uv 取法画三帧。Raw是对照组——没有它,「修复模式读到纯色」可能只是这台机器恰好没出问题。实测Raw红块左边缘74,0,0→Inset/Dilate255,0,0;紫条65,0,65→Dilate255,0,255;外扩像素242 = 68×3+38。 - 一条主机上没预测到的:紫条中心在
Inset下读到252而非255。1 纹素宽的精灵 u 跨度就是 1 个纹素,屏幕像素中心几乎必然落在纹素边缘上,双线性躲不开边界。为此加Expect::Almost档(实测 252 vs 65,与Mixed的分界很清楚,判据没失去分辨力)。 - 两份判据表(JS 读像素 / Rust 出真值)逐行逐字段比对,比「抽数字按位比」严——三种期望形态长度不同,只抽数字会错位。
- 证据:
apps/coin-run/evidence/s0-6-atlas-bleed.png(三帧 + 8 倍放大镜 + 18 条判据)。全量 CI 12 项新增断言,整体 801 测试 / 21~39s 全绿。
- 契约 §5.2 那句「图集要么加 padding、要么内缩」是错的措辞:实测是三件事——留边、留边填边缘色(
看板公开上线 + 工程量层:把「做了多少」摆到「做到多少」旁边(378 文件 / 92,592 行)
- 工程量:378 个文件 / 92,592 行:源码 54,255 行 · 文档 13,106 行 · 脚本与配置 25,231 行,另有 44 个二进制资产。口径:
git ls-files实测、不含生成物,每次构建重算。 - 看板上线:https://magic-engine.filebreeze.cn/board/ 之前一直是 404,原因不是忘了部署,而是发版脚本的冒烟清单是手写 5 条路径——新页面不在清单里,就等于没有校验对象。手写清单的失效方式不报错,只沉默:脚本打「完成」,访问者看 404。现已改成从
site/产物推导(*/index.html → 目录 URL,assets/* → 文件 URL),本次上线校验 7 条路径全 200。 - 为什么加工程量层:看板一直只回答「做到多少」,不回答「做了多少」。百分比离开分母就没有意义——25% 可以被读成“刚开头的小项目”,也可以被读成“干了大半的大工程”。现在这一句压在页首:一句话 + 六条横条(源码 / 文档 / 脚本 / 配置 / 前端 / 示例 MIR)。用横条不用饼图:这里要比的是量级差距(5.4 万 vs 452 行),线性宽度才看得出来。
- 只有一处真相源:页面上的 HTML(数字加粗)与
--scale打印的纯文本共用同一份scale_parts(),并且构建时把 HTML 去标签后与纯文本逐字比对,不等就构建失败。两份文案一旦分叉,「看板写 92,592、项目板写 9 万」就会悄悄发生而没人核对。 - 「在写」第一次有数据:
wip以前是死代码(render 去读排班表里不存在的字段),于是那条图例永远空着——有图例没数据,比没有图例更容易让人以为“没人在做”。现在是 board.json 的一等字段:与 tasks 互斥、必须写「还差什么」。当前 S2-4(lower 差图集分配)、S1-9(示例 1/12)。视觉上用半填充方框表达第三档,不引入第三族颜色。 - 补记 S1-7:长期记着“me validate 还是占位”——那条口径过期了,占位的是 me build。fmt/validate 早就实装且各有三态断言。计划内完成度 27 → 28/110 任务,109/433 人日 = 25%。
- 工程量:378 个文件 / 92,592 行:源码 54,255 行 · 文档 13,106 行 · 脚本与配置 25,231 行,另有 44 个二进制资产。口径:
编辑器界面设计稿:从「Agent 只产 MIR diff」反推出的三视图,实测 24 次全绿
产出
design/studio/(index.html + studio.css + studio.js + verify.js,约 2400 行),单页三视图 + 深浅双主题 + 可交互。定位是设计稿,零实现。- 结构不是「传统编辑器加个 AI 侧边栏」,是从契约反推的:①
me-agent硬规则「不许直接改文件,只产 MIR diff」⇒ 右侧是 Patch 队列而不是 Inspector,patch 是一等公民;②docs/03 §3.1「Guardian 必须是确定性代码」⇒ 拒绝必须精确到ME-REF-004 · subject= · missing=并能点进视口高亮;③ 预算感知生成 ⇒ 预算条压在视口上方,用 MIR 真实五键tri/tex_kb/draw/ms_x100/mem_kb,不另造人类单位,不藏进面板。 - 三个视图:工作台(意图流 / 视口 / patch 队列 / Guardian 判据栏)· Diff 审查(MIR 文本 diff + 干瓦→湿瓦→参考图三联)· 性能(三层时间轴 + 预算热力图 + 归因链)。
- 三个取舍写在页内说明抽屉:没有传统 Hierarchy 树做主轴;patch 卡片默认信息密度偏高(可审计性的成本);退回是栈语义而不是重新生成(所以「退回」与「让 Builder 修这 3 条」是两个不同措辞的按钮)。
- 实测 24 次(3 视图 × 2 主题 × 4 视口,1280/1440/1920/390):对比度违规 0 · 溢出 0 · 重叠 0 · 最小字号 10px · 交互断言 7/7。脚本
design/studio/verify.js跟着设计稿进仓库——「我测过了」不是证据,跑得起来才是。 - 量出来的真问题都不是「看着不对」,而是量了才知道不对:分隔符用
--line画实测 1.27:1(等于没画);主按钮白字压电光蓝 3.24:1,深浅两端都不达标 → 新增--brand-solid(5.70,色相不变);diff 行号落在增删行浅底上 4.30;时间轴色块#3E86E8上白字 3.63。 - 两个只有截图才能看见的 bug:底部 Guardian 栏同时冒出 8 张卡(
[hidden]的display:none被.gd-body{display:grid}顶掉);1280px 下顶栏被 flex 压到中文逐字竖排(既不溢出也不重叠,三项判据全绿)→ 加nowrap+ 按序让位断点,检测视口从 3 个补到 4 个。 - 浅色主题不能复用深色的场景色阶:深色下建筑要比地面亮才立得住,浅色下必须反过来比地面深,直接复用糊成一片——两套独立值。
- 扇区登记:
design/**与build_board.py原为未注册扇区(warn)。按cross-sector.txt不能用代修表开后门,必须改plan/agents.json(已加到 A1 owns,理由写进notes.design_and_board)。
- 结构不是「传统编辑器加个 AI 侧边栏」,是从契约反推的:①
公开进度看板上线:110 个任务逐条可见,每条完成都带可核验的证据路径
页面
site/board/index.html,入口三处:官网顶栏、首页「逐条看进度 →」、文档站侧栏。六个区块:总进度 / P0–P3 路线图 / 12 个里程碑(逐条摊开判据)/ 13 迭代 × 110 任务(可展开可筛选)/ 12 个 crate 实测行数与测试数 / 12 份契约 / 6 项计划外交付。- 数据分三层,避免看板变成许愿池:任务清单不另存,构建时解析
docs/10-p0-sprint-plan.md(抄一遍就有两份,漂移方向永远是「文档改了、看板没改」);完成状态只存plan/board.json,每条必须有why+ev,构建时逐个 stat,路径写错即构建失败;行数与测试数扫源码实测。 - 五条守卫都演练过会红:证据路径不存在 / id 拼错 / 里程碑状态与判据不自洽 / 完成但无证据 / 文档少一条任务。没红过的守卫等于没有守卫。
- 实测(无头 Chromium 1440 + 390):溢出 0、对比度违规 0、首屏无遮挡;筛选 已完成 27 条 / 未完成 83 条 / 全部 110(27+83=110);
ci.sh12s 全绿;site.sh --dry-run走通。 - 先修了一个假功能:筛选原来作用于「整个迭代卡片」,13 个迭代一个也过滤不掉;改成作用于任务行。
- 顺手修三处「没人会因为这句话不对而报错」:首页「立项第 1 天」已过期;「19 篇文档 + 6 份决策记录」实际 25 份 → 改构建时注入
{{DOC_COUNT}},残留占位符即失败;ADR-0003-rhi-v3.md从未登记进文档清单,新加的check_coverage()真挡住了构建。 - 脱敏(页脚写明):只呈现模块 / 任务 / 判据 / 证据路径;不含姓名联系方式、机器网络信息、成本预算、客户商务条款、未公开决策与风险登记册。泳道 A/B/C/D 是角色代号。
- 待办:
ci.sh里还没有看板校验(tools/**归 A3),目前只靠发布脚本兜底 —— 改了board.json却没部署,看板就是旧的。
- 数据分三层,避免看板变成许愿池:任务清单不另存,构建时解析