开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 150 条记录。
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。
- 三栏从「各算各的 + 减法」改成
判据的两条几何限制:有些错只有交叉那条测得到;双胞胎抓不住口径错
meet只能验一个轴,这是几何的限制不是偷懒。取min(sx,sy)意味着比值大的那个轴刚好铺满(free = 0),只有另一个轴有空隙。所以九种x??Y??不可能在同一个 setup 里看出差别,最多验三种,要两个 setup:viewBox="0 0 50 100"(free_w=100)验横向、0 0 100 50(free_h=100)验纵向。- 两个 setup 加起来仍然抓不到串轴错。把
match a.align_x写成match a.align_y,横向那三条用的名字是xMinYMin/xMidYMid/xMaxYMax—— x 与 y 的对齐恰好一致,串了以后算出同一个数。抓它的是交叉那条:xMaxYMin必须 x 偏 100、y 不偏。所以「两个单轴判据拼起来」不等于「两轴判据」,必须显式测一次交叉。这一点是变异演练发现的,不是设计时想到的。 - 「期望红而没红」有两种完全相反的真相,只能手算分辨。前者是判据有洞(需要改判据),后者是期望算错(需要改期望)。我这一次遇到的是后者,而且一次就是两处。处置是改期望、并在脚本里写明「为什么这条抓不到」——不是把判据改软去凑它,后者会把「判据有洞」永久掩盖起来。分辨方法只有一个:把 setup 里的
sx/sy/free/tx一个个算出来,看那个数该不该变。 - 一个反例:
if rest.is_empty() { return Ok(ident) }删掉后 0 条红。它看起来在防「空transform属性」,实际上while !rest.is_empty()本来就处理了空串——那是「看起来在防什么」的空代码。同形状的还有Flatten::segments_for里那个n.max(1)。所以演练不只能验判据真假,它也在验代码里哪些分支是真的。 - 下一步(没做):现在 179 条断言里还有几条只证明「自洽」(比如拿 A 跟 A 的双胞胎比)。这类抓得住回归,但拓不住口径错——双胞胎两边一起错仍然绿。值钱的那几条已经把期望值换成独立公式(
πr²/ 交集w·h/ 包围盒整数格子),剩下的还没换完。
素材不够狠,第八次:判据跑绿只说明两个实现碰巧给出同一个数
- 现象:一共十来条判据,写完跑绿,改一行代码去破它(变异演练),结果也绿。判据不红,等于没写。到这一轮已经是第八次。
- 八次的名字:① 漏了闭合标记
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 分得开,同一份变异立刻红。
- 可操作的做法:写判据时先问一句「错的那个实现算出来是多少」。答不出来就是不知道自己要区分什么,那就没写完。这一句后来直接进了几份场景文件的注释。
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
Unity 7 调研:它花十年修的是「并存」,我们别重犯
- 数据源:
UnityCsReference@7000.0.0a16(Unity 7.0 alpha 16,2026-11-05)。树里 9,035 个.cs;blob 只落盘 2,639 个 / 783,136 行(Editor 层近全量:1,544 文件 / 456,886 行)。核心 C++ 一行看不到——那本身是第一条结论。 - 三条硬数据:① 398 个
*.bindings.cs= 12.1% 的行数没有任何实现(全文 6,556 处extern、964 处NativeHeader)② 编辑器 1,544 个.cs里 UI Toolkit 约 18%、IMGUI 约 19%,两套并存五年(OnGUI(已 0,但GUILayout/EditorGUILayout还在 300 个文件里)③ 最大单一模块是GraphToolkitEditor813 文件,第十名才是Entities163。 - 主论点:它十年修的是「并存」不是「功能」。三管线收敛 7 年(2026-06 的 6.5 才正式弃 BiRP),Mono→CoreCLR 9 年(2017 HackWeek 原型 → 2026-10 的 7.0 编辑器才不带 Mono),而且为此暂停了动画与世界构建的新功能。
- 该抄三条,全关于怎么退役:弃用写日期三件套(最后支持版本 + 支持结束 + 迁移文档)/opt-in → 默认 → 留逃生阀/给 agent 一条
me status --json(先做命令,MCP 只是壳)。 - 不该抄三条,全关于怎么并存:五对两个(渲染 3 套 + 物理/UI/输入/运行时各 2 套)/闭源核心/可回溯的商业条款。Unity 自己的判词是「Game Objects won, but Entities will Drive Game Objects」。
- Web 差距:Unity 空项目 7.7 MB(2D BiRP)/ 10.7 MB(3D URP),Godot ~5 MB,我们 795.1 KB 的完整游戏——9.7 倍 / 6.3 倍。Unity 那条「双后端同构建 + 按设备自动回退」值得抄,硬约束是「用户只下一份包」。
- 两篇调研撞出同一个洞:Godot 44% 的编辑器 include 自家控件 vs 我们
me-studio对me-ui是 0%。
- 数据源:
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 出口只有精灵管线,
包体归因:先把「字节属于谁」这张表修成真的,再接进 CI
- 余量只剩 4.9 KB(795.1 / 800 KB),而
wasm_budget从 10 月写好起从没被跑过 —— CI 里没它的位置。 - 先查工具自己:它把产物报成「中文 11.4 KB / ASCII 0.2 KB」,严格 UTF-8 实测是 6.4 / 12.5 —— 几乎对调。两道判据几乎恒真(
0x80..=0xFF一律算文本;0xE4..=0xE9占 1‰ 算中文)。 - 改成按文本游程切(严格 UTF-8、≥8 字节才算),CJK 按码点比例;
--self-test喂 6 个已知答案样本 + 混合段 + 逐字节守恒。反向实验两轮都红。 - CI 新增一步(只增不改):先自检再出表;归因表凑不齐或段级重复 >1 KB 也红(后者以前只印不判)。
- 结论:文本只有 18.9 KB,不是大头;五张图集全是
zlib(9)且解压逐字节等于.rgba⇒ 没有安全字节可砍。800 KB 是 S0 手写圆整数,真约束是.70冷启动,要真机实测重定。 code522.2 KB(65.7%)还没归因:要留name段重编 + 按函数切。
- 余量只剩 4.9 KB(795.1 / 800 KB),而
分支落后 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 会按它排期。错结论进了文档就会自己长腿跑。 定了之后要么第一时间通知,要么改成“待验”状态再写。
S13 止损线的病因更正:不是净扭矩,是 8 轮迭代传不完 10 层
- 11-07 我给 A1 的结论是「2 点流形顺序求解带净扭矩 ⇒ 上块求解(3–5 人日)」。那个结论是猜的,今天推翻。
- 判别读数(同一场景只改
velocity_iterations):8 轮下底层竖直速度第 9→11 步 26→28.5→28.3 卡住不降;32 轮 9.4→7.2→5.6 收敛到 0。600 步后 8 轮下沉 200px 翻倒,32 轮下沉 28.5px 站住。 - 分界严格在层数 6→7,与宽度无关:80px 宽(宽高比 1:2.5,物理上绝不该倒)照样翻。8 轮 ≈ 8 跳传播距离,6 层够 7 层差一点。
- 块求解治不了这个病——它管「同一个流形内部两点冲量不等」,而这个病在「上下相邻两层之间」。两件事不在同一层。那 3–5 人日排期是白花的。
- 上一版错在把「锁住旋转就不倒」当判据:锁旋转同时把塔变成只能竖直传力的质点链,同一病因换了表现(塌不表现为翻倒、表现为下沉 9.4px)。一个现象能同时解释两条通路时,它不能当判据。
- 排除过程(六条,各有实测):地面摩擦(μ=0.6,排除)、恢复系数(e=0 仍翻)、暖启动(关掉仍翻)、分岛(逐位相同)、参考面抖动(真缺陷但只治 289→164)、接触分离容差(单列逐位无变化,10×10 爆到 41km,有反作用)。
- 判据 9→10 条,新增一条同时断言「8 轮塌 / 32 轮稳」,两组变异证过会红(2.13px / 15.27px)。整包 86 条全绿,
N-357已按这版更正。
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 的止损线第一次被真的跑起来,它没过
- §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 秒:不炸、不穿、不抖」此前没有任何判据,
S16-5 后一半:me watch 落地,§3 表被迫长出一列「输出」
- S16-5 收口:
me watch落地(增量监听 + 变更集),契约 §3.8,事件 schemame.watch.v1 - 本仓唯一不经过
main::emit的命令:其余命令输出「一次结论」,而它输出「一个过程」。三条不变量:一行一个完整 JSON、首start末stop、seq不跳号——第二条最要紧,进程被杀时没有stop,那是编辑侧唯一能区分「跑完了」与「断了」的信号 - §3 表被迫长出第五列「输出」(信封/流):不加的话
--json扫描会跑me watch --json而它永不返回,CI 不红只会挂着。这列是给「判据自己别变成挂起」开的规矩 - 增量是两层指纹(文件字节只决定要不要重解析、节点指纹决定变更集);坏文件不中止也不参与节点差分(中间态必然语法错),保留最后一次好的快照,坏→好抖动不刷屏
- 判据:Rust 157 条;
test_cli.sh176→190(第十一节按列分流 17 条全覆盖 + 新的三步真改文件增量演练);drill-watch.py6 条变异逐条证过会红。演练逼出真问题:scan()那层原本没有判据——单测只覆盖了diff,把scan换掉则毫无反应,而真实后果是编辑侧每存一次盘场景节点全删再全加
- S16-5 收口:
S16-5 前一半:协议协商 + 冻结面,让「无破坏性变更」变成可判的
- S16-5(6 人日)这轮落版本协商这一半,watch 增量与变更集下一轮
- 要堵的那句话没法判定:DoD「编辑器协议连续两个迭代无破坏性变更(判据:me-studio 调用端不改一行)」——什么算协议、什么算破坏性都没清单,只能靠人回忆,而改的人从不觉得自己改了协议
- 把协议变成可枚举的面,每行取代码真实形状:外壳六键与顺序(从
json::envelope实际输出里读键名)、七档退出码、全部命令名、流式事件。渲染成protocol.v1.txt(27 行)+ FNV 指纹 → 「破坏性变更」有了机械定义:那份文件变了(加命令就重生成,改键序就 bump 版本另存 v2) --protocol <n>是门,在分发之前判、对每条命令生效。放各条命令自己管 = 留一个「忘了协商」的口子,而忘了的症状是安静地放行- 判据:Rust 6 条 + test_cli 第十二节 12 条(含python 现算一遍 FNV 与 me 报的指纹比对,两个语言独立算出同一个值)+ drill-protocol.py 8 条变异逐条证过会红
- 演练逼出一个真问题:第一版用
assert_ne!(newer, older)判「两个方向说的话不一样」,而它恒真——版本号不同就恒不相等,方向写反也照样不相等。第 3 条变异红在下一行才看见。判据自己也要被演练 - 顺带修掉上轮留下的
CONTRACT-STALE:cli.spec.md升 v12、同步 MANIFEST(A1 扇区,已登记代修) - 进度百分比没动:那是 main 的发布基线,A3 这半要等合并后才进分母
- 没做 watch 的理由:它输出是流式的,而 §3 表与
--json扫描都假设「一条命令 = 恰好一份信封」。加一列「输出:信封 / 流」改的是扫描的判据形状,而那个扫描这轮刚建成 S16-4 的证据——同一轮既建又改,两件事都没验干净
S16-4 收口:me --json 第一次真覆盖全部命令(三处「看着对」的坑)
- 飞哥说「S15、S16 可以提前」,先动 S16 里唯一无依赖的一条(S16-4,5 人日)
- 坑①:
me survey --json吐出的是「人读表格 + JSON 外壳」两段拼接,json.loads在第 1 个字节就失败(825 字节全不是 JSON)。全 crate 只有这一处绕过诊断通道的print!。改法不是加if json,而是把数字写进diagnostics(新码 ME-SURVEY-010..040),人读与机器读同一份。代价:那张对齐的表没了 - 坑②:「全部命令」以前没有可枚举的定义——契约表 §3 只有 13 条,代码能解析 15 条(
me sym/me bench一直没登记)。补两行 + 双向判据(name()的穷尽 match ↔ §3 表)。没另抄手写清单:抄的第三份就是会漂的第二真相源,而「两份对得上却同时少一条」正是这次的形态 - 坑③:
new/atlas/survey的外壳cmd是空串(位置参数必填时走的那条路),另 12 条是填对的。拆MissingArg { cmd, usage }修好 - 判据:
test_cli.sh160 → 176 条,按 §3 遍历、在空临时目录里跑(那批命令有会写盘的) - 六组变异逐组单独注入,都红了。最有价值的一条:
survey又自己 print! 这个变异,只有成功路径那条判据抓得到,扫描抓不到——不给参数时走不到report() - 流程教训:还原变异用反向替换,别用
git checkout。这轮它两次把我的改动一起冲掉(main.rs 一处、survey.rs 整块),重做了一遍。拿仓库当前状态当备份不成立 - S15 对 A3 是空转:三条 A3 名下的活全排在 A1 的 S15-4「通用序列化」后面(存档的槽位与迁移链必须建在那个版本头上)。已开 N-356 请 A1 先给最小可用接口
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-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
第三条腿飘过一次 —— 抓不到结论就重抓,别指望「预算给足」
git push卡在「WebGL2 对账第三条腿」:```
✗ WebGL2 对账未通过(第三条腿)
✗ 标题里读不出 n/m(实际:GL COMPARE 运行中)
```
同一台机器、同一份代码,紧接着跑的 ANGLE 那一路 21/21 全过 —— 所以那不是判据红,是这一条判据当时飘了。根因在
apps/gpu-gl/run.sh:--dump-dom在页面加载完成时就把 DOM 抓走,而判据是 wasm 里算完才写进<title>的;--virtual-time-budget=120000是预算,不是「等到做完」——页面在 wasm 里做长段同步计算时预算可能已经走完,DOM 里还停在静态 HTML 的初始标题上。改成看着结果决定要不要再抓:标题仍是「运行中」/ 读不到就重抓,上限
GL_WAIT_SECS(默认 180s);热路径上永远第一次就出结论、一次都不多花。超时与判据红的分开写——「抓了 N 次、等了 Ns 仍是运行中 —— 这是没跑完,不是判据红」,退出码 1(跑不完不能算通过)。CI 层另加一个run_page_script兜底:只认日志里「没跑完」这一句才重跑,判据红一律立刻回去报红 —— 「失败就重试」是把红变成「有时红」的另一种写法。演练过(把
caps.html那行document.title用if (0)短路、GL_WAIT_SECS=3):重抓 1 次后打出上面那句、退出码 1;还原后三页全绿,attempt全是 1。一句话:飘的 CI 比红的 CI 贵 —— 红只让你多看一眼,而「有时红」会训练人重跑一次了事,从那一刻起这个门口就没人看结论了。
`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 拒绝换掉
改一个字的含义必须 bump ABI,加一个函数不必 —— 判据是「失败响不响亮」
rhi.ffi.h的版本表上这句话现在有了正反两面的例子:- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
INVALID_ARG/ 格式值不存在)。 - 改已有值的含义必须 bump(v26 是 v9 之后第一次):旧宿主传
format = 0想说的是「你挑」,新库读成「要 RGBA8」——两边都不报错,画面还在出,只是换了个通道序。这正是握手该拦的那一类,而拦得住的前提是两个数不相等。
哨兵取
0xFFFF_FFFF的第二个理由:格式值今天最大 22,它离得无限远,而且零初始化的结构体不会撞上它 ⇒ 零初始化 = 要 RGBA8(两条后端都真收),比「零初始化 = 你挑」安全(「你挑」在换后端时换答案)。配套给调用方加了一条义务(规则 30):
formats[]里现在真的有 0,只能按format_count读;按「遇到 0 结束」读的症状是「这台机器一个格式都不支持」而format_count说是 2。- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
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 演示页:清屏修掉 + 四张 AI 素材换掉色块
用户报:「切场景没清屏,越叠越乱」+「只有色块,观赏性太差」。
- 清屏根因:
frame()直接画默认帧缓冲、全程没begin_render_pass;而begin_frame一个字节都不清(清屏挂在 begin pass 的clear_color上)。抄LdrBlit时省掉的是填充 + 它顺带的清屏两件事。 - 12 项判据全绿:它们数的是「这一帧画了什么」,不是「屏上剩什么」。新判据钉
clear_color == Some(BG);?warm=24是唯一能拍下它的开关。 - 四张 AI 素材(genImage/混元):panel 512² · atlas 512×128 · tiles 256² · chest 256²。图标不抠图 —— 清屏色与页面底色统一成纯黑,近黑底直接融进背景。
- 平铺换过一次题:格子图不是周期结构(间距 30~69 浮动)、四重镜像又在中线出双线 ⇒ 改成「一格 = 一块带凹槽边框的板」,不用镜像。
chest的「主体占中间 50%」是case_trim的 uv 契约,不是审美。 - 连带:
TEXTURES与兜底像素尺寸必须同步(不做长度校验 ⇒ 不同步是越界读);T_CHECK采样器Nearest→Linear;修掉自己刚造的「等图再画 ⇒ 截图空画布」。 - 判据:268 测试全绿 · clippy 0 warning · 无头与
.6真机都 12/12、读数逐字未变 · wasm +735 B、无新 import、三份 md5 一致 · 素材脚本已入库可复现。
- 清屏根因:
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。
第十二轮:地面按震地什么也没发生,第三处「算出标志又丢掉」上了锁
- 审完
fixed_step与late_update两块:Hero::Brute站在地上按技能那条分支被let _ = shock;吃掉 —— 冷却照扣 150 步、音效照响、屏幕什么也没有。修法照抄同函数的slammed(块内算、出块兑现) - 冲击波那道环每帧写的是屏幕居中的算式(从选关页格子排版抄来的),相机贴世界边界时人在 x=31 震、环出现在 x=240。改成绕自身中心长,并修掉
spawn_effect「按左上角落位却按中心扩散」的半格偏移 - 第三次同款(
flash_due/shock/multi)⇒ 新增守卫tests/source_shape.rs:src/coin_run/*.rs禁止let _ = <裸标识符>;(那句正是让unused_assignments闭嘴的钥匙),守卫自带一条「匹配器不许空转」 Sim.unlocked的注释写着「Game::step每帧同步一次」——是假的,step 里没有这一处;把真实约定(改存档那步后面必须跟restart())写进注释,并把「两份镜像一致」推广成判据:unlocked/last_level/hero/save.hero/touch_ui五对数 × 四条入口- S6-3 第 ③ 段落地:
FrameRenderer::collect_cooked+Viewport::frame_cooked(产物字节 → 绘制列表 → 离屏 → 上屏,四步次序与 ECS 那条逐行相同),判据 4 条、两条变异各红。第 ④ 段(→ canvas)卡在 A3 一句答复:LoadedScene借用字节,wasm 里要自有版本还是Box::leak - 目录清理按档 1 执行:14G → 7.6G(incremental 4.0G / aarch64-apple-darwin 1.3G / macos-demo target 965M / Chrome 配置 350M / examples 226M / doc 90M),删前后
git ls-files都是 960 - 数字:
cargo test -p me-runtime36 target / 738 通过;game_slice117 通过;clippy --workspace --all-targets -D warnings干净;CI 3m01s 0 条 ✗(2 项已知降级);wasm 652.4 KB / 92 导出 - 三笔已推
agent/A2:2315a80震地与环 ·63d1985视口 cooked ·ef1c9c6死局部守卫 ·813511ewasm 快照 + §36
- 审完
压力关五个字一直是豆腐块 —— 守卫链在最后一环短路了
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
力 / 测 / 试 / 机 / 批五个字从来没进点阵表,屏幕上一直是豆腐块。而所有门都是绿的。 - 四层根因,每层单独看都合理:①
requirements.txt里从来没有 pillow,而install_hooks.sh只装它 ⇒ 托管的.venv一定跑不动gen_hanzi.py(SystemExit(2));②cjk.rs::the_generated_table_is_current按「第一个存在的解释器」选,取到.venv就只跑它;③ 退出码 2 走「跳过」分支,报 ok;④ CI 里那条cargo test也绿 —— 「跳过」和「通过」在输出里长得一样。而同一台机器的python3装了 Pillow,--check跑得动,并且会当场红。 - 修法:判据改成按结果退到下一个解释器(每个候选都试,全不行才跳过,并打印试过谁、各自怎么不行)、报错里带「用哪个解释器判的」;
STRESS_SAMPLE从stress.rs挪进copy.rs(上屏中文只有一个烘点阵的入口),stress.rs进NOT_ON_SCREEN并写明理由;重烘点阵。 - 验到底,不只看判据绿:无头 Chrome 跑压力页四档,批次
401 / 2 / 7 / 1全部等于期望、missing=0、白块0;再停到有标签那档截图放大逐字对过。图集占用率 51.6%(606 字),离装不下还很远(BakeError::AtlasFull会直接expect炸,不会静默画白块)。 - 顺手两处 review:①
copy.rs注释说「测试盯着名字分家」,实际只验数量与非空 —— 把两关中文名对调,四条判据全绿。改成LEVELS: [(&str,&str); 12](一行一关的中英名),逐关比.lvl的title;三个变异各自红(整行对调 / 只改英文 / 只改.lvl重打包)。②game.rs的let _ = (title, par, facing)吞掉三个死局部,含每帧一次String克隆与一个全仓没人读的Sim::par;sim.levels.clone()每帧一次 Vec 分配改成栈上定长数组。wasm 668,420 → 668,330 B。 - 两条口径:「跳过」与「通过」在输出里必须长得不一样 —— 判据越重要,越不能有「静默可行」的分支;「路径存在」≠「东西能用」,凡按存在选完就不再换的,都会在「存在但坏掉」的机器上退化成空转。
- 账面:CI 297s 全绿(0 ✗,2 项已知降级);
cargo test --workspace(debug)2275 通过 / 0 失败 / 3 忽略,5 分 33 秒 —— 在这之前-p me-runtime在 debug 下一直是红的。提交db670f9/66aa728/a61e0af/c6d278f/df8bcb0。 - 报给 A3:
requirements.txt缺pillow>=10(他的文件,一行闭合根因)、ci.sh第 742 行的包体余量数字过期(写 57.7 KB,实测 147 KB)。
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
第八轮 review:三个真 bug + 一次越界红灯(音频分块 / 音景锚点 / 渲染守卫)
- dsp:
TvBiquad::process的时间用本次调用的下标 ⇒ 分块喂时扫频每次调用从头开始,0.5s 扫频变 2.7ms。修成cursor + i(cursor原来只写不读)。判据三层:症状(尾段保留 84.65% 该砍光)+ 逐样本相等(128/100 两个块长)+ 空折线也算时间;5 个变异全红。 - 音景:首发点缀锚在 0 秒 ⇒ 宿主时钟不从 0 起时全层同时叫。改成锚到第一次
tick,随机流消耗次数不变所以撒点序列不变;3 个变异全红。 - 九宫格:判“最外沿”用列/行序号 ⇒ 没切的那一边永远拿不到内缩,
NineEdges::default()下默认Inset完全不起作用(只在贴一张图时最该起作用)。判据 + 真 GPU 跑 P4 自检 PASS。 - 裁剪:NaN 守卫只查尺寸,位置 NaN 同样能把 uv 算成 NaN(注释描述的灾难没变,只换入口);顺手给“尺寸那一半”补上从来没了的判据。
- 越界:
crates/me-atlas/**属 A3,我连着改了两笔 ⇒ CI 唯一红灯。不回退,按规矩登记cross-sector.txt代修(复核 A3 / 到期 2026-11-10),并把 20 处协商共享路径一次报备完。 - 推翻两条旧信念:①“me-audio 的改动都进 wasm”不成立(只有导出入口可达的才进);②判据绿 ≠ 那条路对(只有一种调用方式时)。
- CI 全绿:第八轮跑了四次 314/176/386/429s,差异全来自机器负载,不是优化。61 笔领先
origin/main。
- dsp:
第四轮收尾: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 笔。
- 归属表:
压力关第一次上真机:揪出「整页中文变白块」,并拿到真实的 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
坦克大战的图集与渲染层 —— 现在能把一帧画成 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 一类)。参考
定位音效的时长在混音器里被写死成 0 —— 每发都永久占着槽位
- 症状:玩一会儿之后定位音效全没了,日志里一个错都没有。
- 根因:
Mixer::play_spatial的签名里没有时长,函数体填duration_ms: 0;而0在这层的语义是「永不过期」(循环语音的语义)。实测(容量 2)播两发、tick(600_000)之后active()仍是 2,十分钟一条没释放;槽位满后新语音被PoolFull静默拒绝。 - 为什么要记:同一个坑在包装层
AudioSystem::play_at已经踩过并修过,机制层没跟着修 —— 两层各写一遍同样的逻辑,于是可以各错一次。 - 改法:
play_spatial收整条PlayRequest(而不是补第八个参数)。pan被覆盖(方位只有一套)、gain被乘上衰减(「半音量的远处声音」)。play_at退化成装请求 + 转发,spatialize全工程只剩一处调用。 - 判据(都反向验过):容量 2 播两发 100ms →
tick(1000)后active()==0,再播两发仍成功且rejected()==0(后半段抓「标成结束但没把槽位放回空闲链」);贴耳处(left,right)==(500‰,500‰)且请求里的Pan::RIGHT被位置覆盖,左侧 300px 处left>right且left<500‰。改回写死 0 ⇒ 红left: 2;不覆盖 pan ⇒ 红(0,500‰);把 gain 覆盖成衰减 ⇒ 红(1000‰,1000‰)。 - 一处 rustdoc 断链:
mixer.rs引用crate::AudioSystem::play_at,而me-audio里没有AudioSystem(在me-runtime,方向相反不能互依),-D warnings下会把 CI 文档检查打红 ⇒ 改成普通行内代码。 - 验收:wasm 732.2 KB(余量 67.8 KB),三份副本 md5 一致;工作区 1712 passed(+2);CI 通过 208s · 2 项降级。提交
cc0fa05,只在agent/A2。
汉字点阵的「扫哪些文件」自己也会过期 —— 新加模块就静默漏扫
- 症状:在
coin_run/下新加一个模块、里面写一句上屏中文 ⇒ 那几个字不进点阵(屏幕上豆腐块),而--check照样绿:它比的是「生成物 vs 那三次固定扫描的结果」,两边都不知道新文件的存在。 - 改法:扫范围从「三份写死的文件」改成「一个目录」:
SCOPE_GLOB = crates/me-runtime/src/coin_run/*.rs,目录里每个文件必须在SCAN(上屏)或NOT_ON_SCREEN(不上屏,必须写一句理由)之一,否则生成器直接失败。另一条报错管「名单里的文件已不存在」——否则--check会对着一个幽灵文件永久绿着。 - 为什么不全扫:量过,
crates/*/src/里含中文的字符串字面量横跨 100 个**文件(me-cli/me-mir/me-studio/me-rhi的报错与panic!全在里面),四千字上下。全扫会让点阵从 569 字涨到四千多,wasm 多背约 120 KB,而那些字一个都不会上屏。 - 反向验过两条:造一个
hud.rs⇒ 点名它、exit 1;把copy.rs改名 ⇒ 点名「已不存在」。 - 提交
b9ee5c8。
- 症状:在
跨两个命令的验收补上了: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。
- 背景:
金币声整关只有头 600 像素能听见 —— 听者从没被设置过
- 症状:第 1 关宽 7040 像素,金币声只有头六枚有声,其余七十几枚完全静音。玩家不会说「静音」,会说「这游戏声音怪怪的」。
- 根因:定位音效的衰减相对听者算,而
AudioSystem的听者从构造起就钉在世界原点(0,0)—— 全工程没有一处调set_listener。于是「金币在玩家身上」被算成「金币在世界原点上」,spatialize在距离超过max_distance(600) 时返回Gain::ZERO。 - 实测(修前):金币 x=40 → 551‰;x=670 / 1812 / 3992 / 6760 → 全是 0‰。
- 为什么测试一直绿:
every_coin_makes_exactly_one_sound数的是plays_of(SFX_COIN),那是「我们请求了一声」,不是「玩家听见了一声」。中间隔着增益,而增益可以是 0。 - 修法:
dispatch_audio每帧把听者设到玩家中心,金币声源用同一个点(两处各取一次会得到十几像素差,让每枚金币恒定压低几十‰ 并向左偏)。 - 顺手收掉一处分叉:八段音效合成一张表
sfx_for。原来只有金币挂在sfx总线上,另外七段直连MASTER—— 「音乐与音效分开压」的设计只对金币生效。七行照抄的分叉,单看每行都合理。 - 判据两条,都反向验过:①
a_coin_is_heard_all_the_way_to_the_end_of_the_level:去掉set_listener⇒ 四处实测 0‰、红。②every_sfx_goes_through_the_sfx_bus:跑完整关 + 撞障碍 + 按技能,八段都得响且都得等于 sfx 总线链;先校验两条总线增益不相等(否则没区分力)。让非定位音效直连 MASTER ⇒ 七段 1000‰、红。期望值从混音器读、不写死 800。 - 假红一条:把玩家瞬移到尖刺中心不触发受伤(危险判定看接触那一步的相对运动,瞬移没有速度)⇒ 走真路(一路向右不跳)。
- 数字:wasm 732.3 → 732.1 KB(预算 800);工作区 1709 passed(+2);CI 通过 188s · 2 项降级(都不是这一笔引入的);三份副本 md5 一致。
- 提交
49312fd,已 push 到origin/agent/A2。
高刷屏上按一下跳会被丢掉:按下边缘在帧层产生,却在步层消失
手机上一半的跳没反应,而电脑上永远复现不出来。根因两条拼起来:① 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 项降级。
看板重核: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 项降级。
包体腾挪:关卡文本压着进包,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)装不下,接素材之前要先谈包体。
- 改名:
巡逻怪锚点判据 + 复核对方的取景纠错 + 两轮假红的真因
- 巡逻怪也有锚点判据(反向:纸白 ≤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。
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 行)。
「没命中」被读成「不存在」: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。
- 技术债表里
符号表判据换成代码段指纹(旧判据会放行错版本),零手写 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」,重跑后每条红的原因都对。
- 符号表版本判据换了。
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 的旧产物,已重建。
dump 能指定关卡了:十二关各拍一帧,顺带发现坑是「空着的」
ME_DEMO_LEVEL=0..11走choose_level(先顶满 unlocked,不绕解锁);ME_DEMO_X走新的warp_to(贴地落位 + 12 帧无敌,否则落点旁的刺同帧弹回复活点)STATUS_U329 → 10,第 9 项是关卡号:12 关共用图集与天空,拍错关卡像素看着完全正常- 真 bug:坑在地形里是「地面段之间的空隙」⇒ 什么都不画 ⇒ 背景纸从坑里透出来(纸是亮的,读起来像地面被裁了一刀)。改成从
ground_segments()反推坑、画soil×0.3竖井压在地面下一层:贴地最暗 8×8 块 68.1 → 23.0 - 新判据 G:十二关各 1 帧,只读 dump 自己的数(STATUS_N 两侧常量 / LEVEL / COINS_LEFT == 该关
.lvl的 coin 行数);金币那条是唯一抓得到「关卡号换了、世界没换」的 - 新判据 H:量贴地最暗 8×8 块 ≤ 40。三条反向验证都做了:漏调 level ⇒ 两条红;伪造 LEVEL ⇒ 只有金币数红;停掉坑绘制 ⇒ 68.3 红
- 踩坑记一笔:
PICTURE是 NDC(-1..1)不是像素,按像素量会得到「画面 2×2,渲染没走完」 - 全套 23 项 ✅ / 0 ❌,CI 通过;wasm 三份副本同哈希
2026-10-25
HUD 换成墨色:那五行字的对比度本来是 1.00:1,而判据一直在数纸
- 放大 in-game 帧发现五行读数几乎看不见。量的结果是没画:关卡行对背景 1.00:1(亮度与纸完全相同),五行 1.00/1.02/1.54/1.13/1.09。
- 判据为什么绿:旧判据数「三通道 ≥150 的亮像素」,而敦煌纸三通道全 ≥150 ⇒ 数到 56 984 个,带子总共才 58 368 个像素。判据数的是纸。
- 改法:五槽位换墨/铜/朱砂/石青/石绿(4.5 到 12.55:1),结算面板那行不动(压在深色板上,方向相反)。不选「加暗影/垫底板」:会切开批次或压住技能条。
- 新判据两条:①数墨色像素 ≥300 ②五色对实测背景众数的 WCAG 对比度 ≥4.5。只判一,颜色淡了过;只判二,字没画也过。
- 顺手修同一类错的第二例:结算分支扫的是窗口顶部(1024×768 里正好是 letterbox)⇒「顶部没字」一直在数黑边。改成按画面矩形扫。
- 反向验证:配色改回旧的重建 ⇒ 红在「0 个墨色像素」;改回来绿在 595,最差对比度 6.01:1。
- 提交
345e611,三份 wasm 逐字节相同,十项判据 + 全套 CI 通过(2 项降级)。
地面换成 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。
- 桌面报
手机上的说明页,最后三行压在手柄底下(第十二批)
- 说明页在触屏上从
24排到211,而手柄从193.7起 ⇒ 最后三行被<>盖住(含12 LEVELS ABOUT 3 MINUTES EACH)。 - 它什么都不报:正文确实画了,
menu_line(Body)读出来也完整。只有把「画在哪」和「手柄在哪」一起量才红。 - 触屏头部改两列两行、行距收到 0 ⇒ 17 行排到 159(页脚 172、手柄 193.7)。
- 新增
help_line_rects(touch)逐行给矩形(行高/前进量从BuiltinFont取);不能给整页包围盒 —— 那是满宽的,而HOW TO PLAY靠左、顶部||居中,会红在假的地方。 - 判据 x1(84),负向验证:旧排版放回去就红。CI 135s。
- 说明页在触屏上从
Mac 桌面版放不出技能:宿主只认了三个键(第十一批)
coin::button_of只写了0/1/2,漏了Skill = 3—— 而 Swift 侧一直在发(J/K/Shift)。- 后果:
me_md_key返回 -3,宿主_ =丢掉 ⇒ 桌面版放不出技能;而窗口底部那行说明写着「J / K / Shift 技能」。不报错、不黑屏,DASH OK一直亮着。 - 改成「列出接受的四个动作键、编号问
raw()」;Pause=4仍拒(桌面有自己的菜单键,两条路做一件事)。 - 判据
every_action_button_the_keyboard_can_produce_is_accepted:逐个问raw(),外加 Pause 必须被拒。负向验证红在「按钮 3(Skill)被拒」。 - Mac 23 条判据全绿,clippy 干净。
手机上的菜单页脚:不删了,抬到虚拟手柄上面(第十批)
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
TOUCH_FOOT_TOP=172就行。 - 最贵的是选关页:页脚是那一页唯一说「哪个键开这一关、怎么退回去」的地方。
foot_text(touch, 键名版, &[(PadButton, 词语)])用pad_glyph拼字形;键盘版一个字没动。- 判据 ×2(83→84):逐页查非空+无键盘键名+逐键问字形;页脚与手柄每个键的矩形相交测试(不能比「最上面那个键」——暂停键在 y≈6)。
- 负向验证 ×3 全红在靶上。CI 99s。
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
说明页补上 `||`,并把「提到屏幕上的每个键」做成自维护判据
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
KEYS ARE THE FOUR BUTTONS BELOW(屏幕上是五个,且一个在顶部)。刚修过「说明教玩家按不存在的键」,不补就变成它的镜像:屏幕上有键,说明不提它。 - 顺手把判据改成逐个问
pad_glyph(不再写死字形清单)——写死的话加第六个键时这页会静默漏掉,而它是玩家唯一会读的地方。pad_glyph因此升成pub。 - 负向:删掉那一行 ⇒ 红在「触屏宿主的说明页该画出屏幕上的
||(Pause)」。 - 另一条硬朾教训:改完引擎必须
build.sh → cp 两份 → build_site.py,否则 CI 红在「生成物陈旧」(这一批被拦了两次)。 - 提交
a8937d9(agent/A2 已 push),全量 CI 73s 通过。
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
触屏暂停键:手机玩着也能回菜单(选关/换角色终于够得着)
- 洞:手机玩家玩着时没有办法回菜单(没 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)。
手机结算页:文案按宿主说话,且点一下真的能继续
- 小游戏开局现在停在标题页,于是它第一次有了玩家能看到的第一屏文字。顺着这条线补了两处「默认玩家有键盘」的地方。
- ① 说明页只有一版
JUMP SPACE UP W / MOVE A D,手机上这三个键一个都没有(只有底部四个字形<>^*)。拆成HELP_HEAD_KEYS/HELP_HEAD_TOUCH+ 共用HELP_TAIL,判据用已有的touch_ui(它已经在决定画不画手柄)。 - ② 三个终局面板硬写
PRESS SPACE,手机上通关/掉坑后就停在一个「让他按空格」的画面上,而那个画面上没别的东西可点。触屏版改TAP TO CONTINUE。 - ③ TAP 得真的有用:
me_coin_run_continue只有网页接过,game.js从来没调 ⇒ 手机玩家只能杀微信重进。bindTouch加onPress:DOWN 之前问一遍,返回 true 就整下吃掉(不 poke,否则手柄认领一个键而restart不重建手柄 ⇒ 进关先蹦一下);UP/MOVE 照样转发(否则按着右键掉坑的那根手指永远不抬起)。 - ⚠️
me_coin_run_continue错误约定与me_coin_run_audio相反:失败返回正数 4。写if (o < 0)永远进不去。 - 验收:Rust 101 lib + 79 game_slice(+2)、node 52 项(+1)、clippy/CI 全绿(148s);负向三条各自精确红(不吞 → py 170.97→152.86 起跳 18px)。
- 提交
b3f4782(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
- 新增
结算画面两处残留 UI:描边停在 (0,0)、技能条没让位
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
let _edge = …),位置永远停在 (0,0) —— 屏幕最上沿多出一条 6px 青线,看起来像装饰;② 技能条是另外两个色块实体,结局后文字让位了它俩没让,结算画面左上角飘着一条青色进度条。 - 修法:
Sim.panel_edge与panel走同一段定位算式;结局后技能条尺寸缩到零(零面积不落像素,比加可见性开关少一个会忘同步的状态)。 - 新判据
the_result_panel_is_the_only_thing_left_on_screen:过关帧描边的位置与宽度必须等于面板、技能条两个色块面积必须为 0。两条在修之前都会红。 - 实测:结算帧描边矩形 (83,218)-(940,223)(面板左上角 80,215),技能条填充 0 像素;全量 CI 166s · 1485 测试 全绿。
- 提交
35fea9b,已 push agent/A2。
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
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 项降级项目板全量重核: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)· commit65ffbe4NEON 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 要不要改口径。
scissor 接进渲染层:旋转的精灵终于能被容器裁了(N-201 关闭)
做了什么:v6 的
me_rhi_set_scissor只到「后端能收」——胶水有 thunk、契约写着每 pass 归零,而me-render里没有任何一处发出这条指令。本批补调用侧:clip.rs浮点→整数(min 向下 max 向上)、batch.rs批次键加一维clip、submit每批声明并收尾归 None、rhi_sink.rs缓存 +MeRect。- 数字:P7
apps/coin-run/clip.html57600 像素逐字节相等(A 场景伸出容器的 96 个像素灰→洋红);10 个既有判据页全绿;me-render353 测试;全量 CI 191s 通过(0 红,2 项已知降级);提交9514f1b/ 24 文件。 - 契约错了两处,都是真机抓的:①
clip_approx不会降到 0,正确形状是「只在后端真的没 scissor 时才非零」⇒ 改名clip_gpu(有它正常,零才可疑)②submit收尾必须关 scissor:第一版没关,同 pass 紧随的全屏 blit 被上一个容器切掉⇒ 整帧黑、57600 条判据红 56639。§2.5 的每 pass 归零只保证跨 pass,blit 与精灵提交共享同一个 pass。 - 坑:判据素材必须 24×8——正方形转 90° 是它自己,拿它验裁剪等于没验。九宫格页「同贴图 1 批」变 4 不是性能回归,是批次键多一维。
- 证据:
crates/me-render/src/wasm_clip.rs、run-clip.sh、evidence/p7-scissor-clip.png、契约 v14 第 4 条、Team/closed/2026-10-24-scissor-in-rhi.md。
- 数字:P7
引擎官网上线「Demo 体验」页:列表 + 实机录像 + 可试玩的 COIN RUN
- 线上:https://magic-engine.filebreeze.cn/demos.html ;可玩页
/play/coin-run/(部署版本7a3ac8d,18 个文件逐个哈希一致,14 条路径冒烟全 200) - 做了什么:列表页(实机录像 1920×1080/60fps/10.0s + 「立即试玩」)+ 真可玩页(浏览器里跑同一份引擎编的 wasm);首页顶栏与 hero 各加一个入口;第二条「MIR 可玩切片」标规划中、故意不给按钮(死链比没按钮更糟)
- 判据:不是「页面打开了」,是引擎自报数在涨 —— 线上实测帧号 0→41、批次 2、精灵 7、按住右键后生命 3→2(输入真进了 wasm);390×844 手机视口溢出量 0
- 抓到的坑:站点改动从引擎分支摘到 main 后,胶水按 main 版取(无
me_gl_set_scissor)、wasm 却是分支编的(带这条导入)⇒ LinkError 白屏。标题对、按钮能点、只是永远停在第一帧,截图看不出来。结论:产物必须由所在分支的源构建,判据是核对 wasm 导入表 ⊆ 胶水导出 - 取舍:js 不存副本(构建时从 apps/ 现取),wasm 只能存快照 +
check_play_sync硬门。能靠「只有一个副本」消除的故障不该用守卫管 - 证据:
apps/macos-demo/evidence/coin-run-promo.mp4;提交7a3ac8d(站点)、8562699(出片管线)
- 线上:https://magic-engine.filebreeze.cn/demos.html ;可玩页
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 条关卡测试(含“常量与文件一致”的镜像检查)。`
- 关卡从
没声音的真因:空图 prepare() 抛 NSException —— 一行修复,附判据 E
- 真机反馈「从 Finder 启动也没音效」⇒ 根因不是会话类型、不是音量、不是波形。
- 根因:
AVAudioEngine是惰性建图的,而prepare()假设图已建好。 建出来直接prepare()时 graph 里连outputNode都没实例化,AVAudioEngineGraph::Initialize断言inputNode != nullptr || outputNode != nullptr失败,抛NSException绕过do/catch。栈顶就在-[AVAudioEngine prepare]。 - 修复是一行:
prepare()之前先_ = e.mainMixerNode(getter 才会实例化 outputNode 并连上)。最小复现 20 行验证:不碰 → NSException;碰一次 →running = true。 - 上一版归因是错的,已在代码注释里订正:写成「非 GUI 会话(终端/沙箱/ssh)拿不到音频硬件」,并用「
system_profiler明明列着默认输出设备」当反证。错在证据只有「终端里跑没声音」——而双击启动根本没有终端可看。用open -n(LaunchServices,与控制台双击同会话)复现,一样失败。 - 判据 D(上屏)之外新增判据 E:
ME_AUDIO_PROBE=60报引擎在跑 / 节点已挂 / 淡入到满音量。实测AUDIO_TAKEN 60 CMDS FRAMES 60+节点 1 · 运行中 · mixer 1.00 · 当前语音音量 1.00。 - 探针自己踩了一个坑:
audioProbe分支没走固定步长,连跑 N 帧的dt差分为 0 ⇒ 30 帧只取到 3 条指令(全在第 0 帧),而同一份代码走 dump 是 30 条。判据红的与被测行为无关。 - 另加落盘诊断
(本机路径):双击启动没有终端,log show又要非沙箱权限 —— 起不来的结论必须落在磁盘上。
P13b 真机验收通过:macOS 窗口能玩了,关卡一次跑通
- 真机结论:COIN RUN 在 macOS 宿主窗口里可操作、可通关,关卡布局被认可。
- 窗口标题实测
80 顶点 · 2 批 · dt 16.82ms,证据apps/macos-demo/evidence/p13b-window.png。 - 上一轮修的三个宿主缺陷至此闭环:上屏路径漏
advance(全黑) /AVAudioEngine抛NSException闪退 /NSPersistentUIRestorer弹恢复框卡死回调。三个都是判据看不见的类型——前两个在 CI 全绿的情况下依然让窗口不可用。 - 判据 D(
ME_DEMO_LIVE_FRAMES)现在是真机可用的守门员:推进只留正式路径一处,删掉它就会红,不再自证。 - 关卡参数(可复用的手感基线):
VIEW 320×240/LEVEL_W 640/MOVE 120/JUMP 440/ 坑300–340/ 平台高度156/ 6 金币 / 终点600。 - 分支
agent/A2ca812a1,CI 62s · 1286 测试全绿。
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 面板(
合并 A2+A3 并重新发版:D0 收口 6/6、M0.2 收口 4/4、发布权收归 main
- 为什么合:发版前核对
/deploy.txt发现线上跑的是1b18bbe / agent/A3,而那个提交不在 main 的历史里。从 main 直接发版会把 S8-5 与 S0-10 从线上抹掉(35 退回 34 条任务),而页面看起来「更新了」。 - 两个合并:A3(24 提交,
me size包体归因 + AI 署名闸门)、A2(5 提交,FFI 开销实测 + 图集装箱 + 矩形帧表)。A3 合并两次——第一次合完他又推了 2 个提交(/team/协商板上站)并又发了一版,正是 N-022 描述的事在那条答复之后又发生一次。 - D0 收口 6/6:A2 测得
set_uniform_vec48.4 ns /set_texture9.5 ns /draw_bound11.4 ns,最贵只占 2μs 的 0.57%。更有用的两点:draw_bound多出来的是require_frame+ 两次查表(大头在我们自己代码里);错误路径比成功路径更快,所以「在什么都没画的调用上量出漂亮数字」真会发生。 - M0.2 收口 4/4:着色器生成器(
src/里除shader/外零手写 GLSL,判据可执行)+ 1000 节点mir→mirb→mir字节等义(160,928 字节)。 - 发布权收归 main:
tools/deploy/site.sh现在要求HEAD == origin/main,否则 exit 3,且卡在构建之前。不再只是 N-022 那条约定。 - 修好两处「闸门没通电」:
commit-msg钩子在版本库里是 100644(本地一次没关过);CI 署名步骤的 BRE 中文交替在本机 grep 上恒不命中,加上兜底写成ok,于是「一条没查」被画成 ✓。 - 契约:
cli.spec.md改了内容没 bump,绿勾底下挂了一条 STALE;补成 v3 + 新哈希。diag.codes.md抬头补「边界」一段(只覆盖 me-rhi 侧)。 - 发版:8 个文件逐哈希相等,
/deploy.txt→341e5d8 / main。 - 踩坑:
pre-push跑 CI 2–8 分钟而 SSH 连接空闲,Gitee 直接断连,git push以 141 退出且 CI 是绿的——白跑两轮。已设core.sshCommand带 ServerAliveInterval。
- 为什么合:发版前核对
第十八批 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。
- 契约零改动:
演示打不开的两个真原因:端口通 ≠ 是我们的服务;nohup 服务随父进程被回收
- 现象:Safari 打开演示页是一页 404 / 连不上,而服务看起来在跑。两个原因症状完全一样,白查两轮。
- 原因一:上一轮为跑
run-*.sh手工起过服务,--root是仓库根(页面在/apps/coin-run/demo.html)。serve.sh --open看到端口通就跳过启动,转头打印/demo.html⇒ 404。复用没错,错在没问一句「你是谁」。现在复用前先要一个 200,拿不到就在开浏览器之前 exit 1 —— 宁可什么都不弹,也不要弹一页 404。 - 原因二:从 CI / agent 工具调用上下文
nohup起的服务,父进程一退就被回收。地址打印完、浏览器打开时端口已经没了。现在起完立刻探活,探不到直说并指向双击入口。 - 新增:
apps/coin-run/打开演示.command(Finder 双击,父进程是登录会话 ⇒ 服务不被回收);apps/coin-run/test_serve_open.py9 项;serve.sh --no-open。 - 判据支点:把
open换成记账的假货放进 PATH 最前面 ⇒「弹窗了没有」成了可断言的事实,测试本身也不弹浏览器。只有证明「该弹的时候会弹」,「不弹」才是判据 —— 否则把 open 那行删掉,前三条照样全绿。 - 实测:Safari 回传
DEMO READY 8/8,why=title-change,UASafari/605.1.15;全屏截图确认八个面板全渲染。headless 截图evidence/demo-gallery.png。 - 顺带:
check_bash.py的discover()扩到.command(双击入口必须是这个后缀,天然逃过 CRLF / 缺 shebang /$VAR(中文)三类检查)—— 这一批正好写了/$FILE,,是它先红了我才发现的。A3 的 owns 路径,已代修登记cross-sector.txt(复核 A2+A3,到期 2026-11-07)并 fyi 报备。 - CI:42s 全绿,新增一步「演示可达」9 项;workspace 1186 测试。提交
add36b8已推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」的窗口里踩的。协商板撞号修复 + 守卫第 5 条 + poke 相位编号收敛成一个
两条跨扇区尾巴,各自堵掉一个「不会红」的失效。
1. 协商板撞号(错在我):提 N-008/N-009 时手上是
92ab276,A3 的同号两条随c26dccf才进 main ⇒ 四行里两行的编号指向的不是自己。它自己不会红(表由正文生成、reply_state_problems用 dict 按编号索引、watch.py照常报「在等」)。已改名为 N-015/N-016,并给守卫加第 5 条(同一编号出现两次即红 + 给出能直接抄的号max+1)。演练过:真板红两条,改完绿。2. N-013:poke 相位编号对齐契约(选 B)。A3 倾向两入口并存,理由是「poke 刻意没有 Move」——这句在代码里不成立:
VirtualPad::update有Move => {},移动不掉键(有测试);且touch_codec线上码也是 0/1/2/3,选 A 会留三套编号。3. 顺带:
render.pass.md升 v11(只为一条交叉链接改指向,sha 变了就升版本);pointercancel从 UP 改发 CANCEL;宿主加pointermove/onTouchMove;新增以前写不出来的测试「按住右滑到左键区域不掉键」。4. 证据:
me-runtime5 条单测 · 宿主 17 项 ·run-demo.sh七面板 7/7 · CI 全绿(契约 50 / workspace 1181 / 协商板 ✓)。提交a043c9a+0916547,已推agent/A2。5. 坑:换编号必须重编
apps/coin-run/wasm/me_runtime.wasm(gitignore)——产物没跟着改时,红的是产物不是代码;这台机器的 bashgrep是 BSD 版,\|不是「或」⇒ 静默返回空,用它找引用会漏,改-E或 ripgrep。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 对,
陷阱:基线不能取「上一次构建的产物」
- 问题:看板要标「哪些变了」,就要知道「上次发布的是哪一版」。第一版设计里我把基线取成「上一次构建的产物」——听起来合理,因为它代表「上次部署到线上的那一页」。
- 它错在哪里:产物会被本地预览反复重写。为了看一眼效果建两次,第二次算出来的变化集就是空的,然后发版把线上的绿点覆盖成一片平静。一次预览就吃掉了真正的更新,而没有任何东西会报这件事——页面里一个字都不会提示「基线丢了」。
- 修正:基线落在仓库文件
plan/board.revs.json(生成物),由 site.sh 在 rsync + 冒烟 + 逐文件哈希全部成功之后调--publish前移。 - 为什么必须在成功之后:失败也写,就会把没发出去的内容记成「已发布」,那批改动从此不再标绿。漏标比重复标危险得多——重复只是烦一下,漏了是永远的沉默。所以这一步自身失败也不阻断发版结果(页面确实发出去了),只打一行警告。
- 没有基线时退到 git:「不 dirty 用 H^、dirty 用 HEAD」。但它只覆盖「最后一次改 board.json 的提交」,不是「上次发布以来的全部变化」——所以它是过渡退路,不是常规路径。
- 一句话结论:「上次构建」和「上次发布」不是一回事,把两者当成一回事的代价,是静默地少报。
看板加了「哪里更新了」:绿→蓝,红点指路
- 起因:「看板已经更新但我没看过」+「每次看都不知道该关注哪里」。这不是排版问题,是缺一层状态——页面只有「现在是什么」,没有「和上次比变了什么」。
- 三层分工:绿(条目)= 变了且没看过;蓝(条目)= 变过、看过了;红点 = 那里面还有绿的但我没滚到(导航角标 / 收起的迭代卡 / 右下浮动「下一处」)。红点只出现在看不见绿的地方,因为它指位置不指状态。
- 变化怎么算:每个条目按内容算 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。色盲兜底是标题后的「新」字,不靠色相单独承载信息。
P2 缩小:mip 链 → 揪出「采样器覆盖纹理参数」,mips 参数从上线起一直空转
- 三个副本同帧(同像素 / 同 uv / 同缩放,只换 mip 链与采样器句柄),192 条判据(3×64 像素)真机全对。
- 读数:只第 0 层+采样器
min=0 max=255 对比度=255别名;mip 全+采样器0/255/255别名(mip 没生效);mip 全+不绑采样器128/128/0正确。 - bug:WebGL2 要求采样器对象覆盖纹理自己的 MIN/MAG_FILTER,而
RhiSink永远带非 0 采样器 ⇒ 胶水照mips生成的LINEAR_MIPMAP_LINEAR从第一天起就没生效过。形状是「参数被接收、被处理、被断言设过了,但被下一条指令覆盖」——编译和单测都拦不住。 - 判据设计:缩小取 7 倍不取 8 倍。
ratio=8⇒s = 8d+3.5,frac恒 0.5,每格 50/50 平均成一片 128,与 mip 链的值分不开;7 时frac恒 0,取到纯纹素,黑白交替,对比度 255 vs 0。 - mip 由引擎自己 2×2 box filter 逐层算(确定性;胶水那次
generateMipmap跑在还没有像素的时候)。 - 新增
wasm_mip.rs(8 单测)、mip.html(192 判据)、run-mip.sh、mip_js_table.rs(5 条表核对)、证据evidence/p2-mip-minification.png。 - 协商板补 §1.8:
me_filter只有 NEAREST/LINEAR,表达不了*_MIPMAP_*,请 A1 裁决;并提醒 A3 别删胶水那次generateMipmap(它的副作用是分配 mip 层,删了只在真机glError != 0)。 - CI:845 测试 / 13 步 / EXIT=0。提交
8948f4e(代码+证据) +83d52e7(文档),已推agent/A2。
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 全绿。
ADR-007 裁决 + ADR-008「更像人」:对齐玩家,不是变强
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
me-net只装与范式无关的六件事;同步范式项目级二选一、编译期裁剪;确定性是可选能力 + CI 守卫。未决两条(Det数值表示、快照压缩)保留开放——按 §3.1 实测,Det的触发点是“守卫变红”,不是开工前置。 - ADR-008 加 §8「更像人」。需求原话:「通过对弈玩家,假装水平和玩家相当。」
- 它与初版“智力远超常规 AI”不矛盾:前者是能力上限,后者是暴露水平。合起来是“我比你能,但我装成和你差不多”。
- 拆三步,每步归属不同:观测(引擎:SkillModel,规则层算、不调模型)→ 目标(项目:开关 + target_offset)→ 执行(provider:loss_budget / think_ms / style)。任何一步合并掉,就成了“引擎偷偷替人决定难度”。
- 三条先决判断:
① 对齐的是“这个人”不是档位 → 估计只能来自与他的实际对局;
② 局内不修胜率,跨局才更新目标 —— 拟人化的死敌不是失误,是橡皮筋;
③ 能力不足不许装,否则“像人”就成了静默降级的后门。
- 判据只承诺“量得出来”:盲测 AUC / 思考时长 KS / 失误率条件分布 / 重复率,四条都必要不充分;判据数据必须与调参数据不同源。
arena report不判通过失败——“多像才算像”是产品标准。 - 同步改了三处口径防打架:14 号文档 §6 把“自动调难度”拆成禁(隐藏)与行(显式 + 留痕);新增 §7.4 接入形态;05/09 的计划表同步。
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
陷阱: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,脚本打印「完成」。半小时后核对,线上
看板进了 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、要么内缩」是错的措辞:实测是三件事——留边、留边填边缘色(
四个坑:--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 里记过同一类错误,还是手滑了——这类规则不能靠记性,只能靠检查器。
看板公开上线 + 工程量层:把「做了多少」摆到「做到多少」旁边(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 个二进制资产。口径:
今天踩的五个坑:都是「没东西会因为你做错而变红」的那一类
今天这一轮全部是「工具没报错、但结果不对」的类型,共同特征是没有任何东西会因为你做错了而变红。
- 同一目录开两个会写代码的会话 = 编辑会静默丢失: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 次编辑都报成功,
编辑器界面设计稿:从「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却没部署,看板就是旧的。
- 数据分三层,避免看板变成许愿池:任务清单不另存,构建时解析
2026-10-22
官网上线:magic-engine.filebreeze.cn(架构文档同日可读)
- 站点结构重组:
site/成为唯一部署根(index.html+assets/+docs/),由build_site.py从手写的web/与docs/*.md组装,生成物不入库 - 官网内容全部来自 docs,未实现能力统一标注「设计示例 · 引擎尚未实现」;P0 排期数字直接取自
plan/p0-plan.json - 部署链路:
tools/deploy/site.sh(构建 → rsync → nginx vhost → certbot → 五路径冒烟),vhost 模板入库tools/deploy/nginx-magic-engine.conf - 线上实测:https 200、http 301 跳转、HTML no-cache、assets 7d、gzip 后首页 7.7KB、文档站 110KB
- 前端体检(1440/1280/1024/820/390 五档,Playwright):0 横向溢出、0 小于 11px 的字、时间轴 0 重叠、0 JS 报错,正文对比度最低 5.0:1
- 代码已推 Gitee 私有仓库 main(5a4b1a5)
- 站点结构重组:
立项:MagicEngine 正式启动,代码落位 (本机路径)
定位:不做「另一个全能引擎」,做「预算感知 + AI 进编译链」的引擎;护城河在 MIR(带预算注解与溯源的内容图)+ 跨端编译,不在渲染器。
验收口径:P0 不是「做出引擎」是「验证假设」—— Gate 0 六指标 <4 项即止损;降级方案 C(AI 挂到 Cocos,8 周止损)预定触发。
代码落位:
(本机路径)→(本机路径)(240 文件 / 2 提交 / 工作区干净,原目录留备份)。基线已成:19 篇文档 + 6 ADR;
interface/契约冻结(rhi.ffi.h v1);越界守卫脚本;SfxForge 音效已跑通(32 资产 / 7 项硬校验 / 两次构建 MD5 一致)。三个决定:MIR 用块语法不用 S-expr(可 review 优先);FFI 冒烟提前到 W2(改语言成本 2 周 vs 4 个月);并发度按 FTE 表定(四并发窗口仅 8 周)。
现实约束:PS5 devkit 与主机 SDK 受 NDA、周期不可控 ⇒ 架构留口 P2 实现;新引擎本身不是卖点,唯一卖点是效率被实测数据证明。