公开进度看板 · 数据截至 2026-11-07

引擎做到哪一步了

这不是路线图的复述,是逐条勾过的账。每一个标记完成的任务都挂着可核验的路径——源码、测试或截图;写错路径的「完成」会让页面构建直接失败,所以这里不会出现「感觉做完了」。

计划:P0 · 40 周 / 20 个双周迭代计划起点 2026-11-02口径:按人日加权,不是数任务条数
41%  计划内人日已完成
275 / 672 人日 · 74 / 170 个任务
已完成在写但未达 DoD未开始代码 201,455 行 · 4119 个测试里程碑 2 达成 / 1 部分 / 22 待开
00 / 工程量

这个工程有多大

文件数与行数每次构建实测(只算 git 跟踪的文件,生成物一律不计)。site/ 从 2026-10-24 起进了版本库,但它仍不算——它整站都是 web/ 与 docs/ 渲染出来的,算它等于把同一份文档数两遍。target/ 同理:一个会随构建次数长大的指标不是指标。(下面那张语言构成卡按 Gitee 的口径算、含 site/ —— 两个问题不同,差多少写在卡里。)

1,664 个文件 / 611,335 行:源码 341,715 行 · 文档 81,583 行 · 脚本与配置 188,037 行,另有 232 个二进制资产

  • 源码341,715 行674 文件
  • 文档81,583 行191 文件
  • 脚本97,027 行273 文件
  • 配置26,138 行129 文件
  • 前端49,140 行102 文件
  • 示例 MIR15,732 行56 文件
语言构成Gitee 语言统计 · 取数 2026-10-27
  • Rust49.8%
  • HTML23.5%
  • Python10.4%
  • JavaScript8.9%
  • Shell3.6%
  • Other3.8%

口径与上面那句不同:这一份含 site/ 这类已入库的生成物(Gitee 眼里没有「生成物」)。剔掉 site/ 与 library/ 之后 HTML 落到 17.1%、Rust 升到 63.0%,那才是手写代码这一侧的比例。右边那组数是 Gitee 的快照、不是本机现算 —— 它的排除规则(vendored / minified / 它自己的生成物清单)复现不出来;本机现算只做对账,差超过 5 个百分点会在构建时打一行警告。

口径:git ls-files 的每一个文件都读一遍,按扩展名归类、按 NUL 字节判二进制(不信扩展名)。二进制资产 232 个不计行数。这个数字由 build_board.py 的 --scale 一行打印,项目管理平台上的那句总结与这里是同一句。

01 / 路线图

四个阶段,四道门

每个阶段都以一款真实上线的产品为交付物,也都以一道出口门收尾——门不过就不进下一段,这条规则写死在计划里,不是倡议。5 条 Gate 里程碑里有 4 道是出口门,另有 1 道中途决策门(Gate 1a):它是段内的一次取舍,不是出口。

02 / 里程碑

25 条里程碑,逐条摊开

里程碑不是「做完某个模块」,是「某个能力被真实证明」。下面每条判据都能跑脚本或看截图验证;点开看它卡在哪。四个阶段各一组,用上面的开关切——同一阶段的判据才有可比性,跨四个阶段说一句「共 2 条已完成」没有意义。

P02D / 2.5D 垂直切片 + 原生后端第 1–40 周9 条 · 2 已达成 · 174 条任务

6/6。wasm 进微信并上屏、三目标 CI、确定性基座、构建可复现、评审归档都在跑;最后一条「FFI 单次调用开销 < 2μs」由 A2 在 N-204 里结掉:set_uniform_vec4 8.4 ns / set_texture 9.5 ns / draw_bound 11.4 ns,最贵的那个也只占预算的 0.57%。两个数字比结论更有用——①draw_bound 最贵,多出来的是 require_frame 加两次查表,大头在我们自己的代码里,不在跨语言那条 call 上,这改变了优化的方向;②错误路径比成功路径更快,所以「在一个什么都没画的调用上量出漂亮数字」是真的会发生的,A2 另立一条测试钉住成功路径的前提。原本卡住这条的不是技术,是判据没写清测哪个调用——模糊的判据永远不会被完成,因为谁都说不清自己测对了没有。附带一处我自己的错:N-020 里我写的 me_rhi_set_uniform_vec 真名是 _vec4(v1 起就是),照着我那个名字去找符号会找不到。

  • 微信开发者工具出画面(截图,不是「能编译」)
  • release + wasm-opt 后 .wasm ≤ 800KB
  • FFI 单次调用开销 < 2μs:测 me_rhi_set_uniform_vec / me_rhi_set_texture / me_rhi_draw_bound 三个每帧高频调用(null 后端,排除驱动),含 capi 侧的句柄查表与参数校验(即「参数编组」),预热 1 万次、计时 10 万次取平均,三者都要达标
  • CI 三目标全绿,全量构建 ≤10 分钟、增量 ≤60 秒
  • 同一 commit 两次构建产物 hash 一致
  • D0 评审记录归档(ADR-001 状态更新)

四条判据全齐。这条里程碑的真正意义不是"能出图",而是"出图这条路上没有一处是人手写死的美术":预算门禁把 tri=10 精确报回节点、确定性 hash 让两次构建可对比、1000 节点往返证明二进制层不会偷偷改变内容、而着色器从字面量换成了节点图生成。四条里有两条是今天收的:着色器生成器(S2-6)与 1000 节点往返。诚实说明两处边界:① 材质图今天由渲染侧代码构造,MIR 还没有材质节点的产生式——所以"内容能写材质"是 P1 的事,这一版做的是"屏幕上的着色器由节点图生成";② 判据 1 的真机截图(p5-mir-scene.png)是迁移前拍的,我没有重拍。理由是着色器字节与迁移前逐字节相同(shader_gen.rs 钉着),几何与批次路径一行未动;要更保守的话,下次跑 bash apps/coin-run/run-mir.sh 重拍一张即可,但那验的是同一件事。

  • .mir 文本 → 编译 → 屏幕出现带纹理的四边形,全程无手写 GLSL
  • 故意把 tri 预算改成 10,编译失败并精确报到节点 id
  • 1000 节点场景 mir → mirb → mir 字节级等义
  • 同输入两次构建,产物 hash 一致

改过一次,旧文字两半都错了:原本写「依赖 M0.2 的端到端链路与 S7 的玩法框架,两者均未开始」——M0.2 早就是 reached,而 crates/me-runtime/src/coin_run/ 有 7203 行(game 5236 / level 987 / wasm 923),是个能从头玩到尾的切片。现在按判据逐条说: ① 已达成。「开始 → 关卡 → 结算 → 重开」四段全在,且是从外面读数验的:Screen 四态 / Outcome 四态各自带 code()(不用 as u32,见 S7-1),all_twelve_levels_are_clearable_by_the_bot 用机器人跑完 12 关 × 2 角色共 131882 帧全通,每关 par(完美通关目标)175–190 秒,正好对上「3 分钟」。 ② ③ 不是不达标,是从没量过。中端安卓的帧时间 p95 与峰值内存都没有任何真机采样——perf.html 量的是 Mac Chrome 上「1000 批 vs 3 批」的对比(p95 31.7ms vs 0.2ms),而实盘是 2 批 / 424 顶点,两个数字回答的不是同一个问题;峰值内存连测量代码都还没有。S3-9 卡在同一个地方(微信开发者工具未登录)。 ④ 未开始:S7-4 的 trace 隧道与 S7-5 的归因都是空的。 所以 partial 在这里的意思不是「做到一半」,是「四条里只有一条有证据」。⚠️ 判据 1 的括号里写「关卡」,S7 的 DoD 写的是「3 关」,实际是 12 关——按 12 关算只会更严,不是放宽。

  • 3 分钟完整玩法循环(开始 → 关卡 → 结算 → 重开)
  • 中端安卓稳定 30fps,帧时间 p95 ≤ 33ms
  • 峰值内存 < 600MB
  • 真机 trace 回传编辑器,帧时间可归因到 MIR 节点

分包机制已在 PAL 层铺好,但纹理压缩管线、分包图划分、首帧优化都还没做。

  • 主包 ≤ 4MB(微信真机安装验证,不是构建产物估算)
  • 冷启动首帧 < 3s(中端安卓,4G 网络)
  • 总包 ≤ 30MB,分包加载成功率 ≥ 99.5%
  • 纹理全部走 ASTC / ETC2,无未压缩贴图进包

10 个关卡的产线(世界语法 + 构件库 + 关卡生成器)全部在 S9,尚未开工。

  • 10 个关卡,AI 生成占比 ≥50%(按 MIR 节点数计)
  • AI 生成内容人工 review 一次通过率 ≥80%
  • 连续 30 分钟游玩无崩溃、无内存单调增长
  • 5 台真机(3 安卓低中端 + 2 iOS)全绿

六项里只有「无手写 shader」有结构性把握(着色器生成器一旦落地即成立),其余五项都要等真实上线数据。

  • 游戏上线:微信小游戏真实上线,有真实用户
  • 主包体积 ≤ 4MB
  • 真机性能:低端安卓 30fps,帧时间 p95 ≤ 33ms
  • AI 生成占比:关卡内容 ≥50%,review 通过率 ≥80%
  • 效率对比:同等内容量,工时 ≤ Cocos 路线的 70%
  • 无手写 shader:全程零手写 GLSL

S13 的产物,也是 ADR-0017 止损表的现场判据:调不稳就退回分轴 AABB 并砍关节,而不是继续调。

  • 100 个刚体堆叠 10 秒:无 NaN、穿透 <0.5px、位置抖动 <0.1px
  • 1000 粒子在低端安卓 ≤1ms/帧,对象池零分配
  • 定步长确定性:同样输入跑 1000 步,两次结果逐位相同
  • 查询 API 三种(raycast / shape cast / overlap)各有反例

S13–S16 的收口。判据是「每块有 API 手册与反例」而不是「代码写完了」——没有反例的子系统等于没有验收,这正是本轮要修的旧问题(me-physics 的「最小集」三个字没有验收线)。

  • 九块各有 API 手册 + 至少 3 条反例,反例能跑出期望错误码
  • coin-run 与 city-twin 各完整接一次九个子系统
  • 50 骨骼 / 2000 顶点蒙皮在低端安卓 ≤2ms/帧
  • 存档 v1→v3 迁移有真实用例,旧档能读
  • CLI --json 覆盖全部命令且有 schema;编辑器协议连续两迭代无破坏性变更

S17–S19 的中途门(ADR-0018)。判据不是「Metal 写完了」,而是两个人在不知道对方实现的前提下、各自让同一份契约出画面——只有到这一步契约才算被证伪过一次。故意排在 S18 末而不是 S19 末:两个后端到 W38 还画不出东西,后面的像素级 diff 就没有意义,顺序要先改成「一个后端出画面」。

  • 三层对表:rhi.ffi.h / abi.rs / backend.rs trait 逐项一致,改一个枚举值必红
  • Metal 与 D3D12 各跑通全链路,两边都 grep 不到对方后端名
  • 同机(macOS)webgl2 vs metal ≤1/255;跨机(d3d12 vs 入库参考图)非背景 IoU ≥0.999 且色块归属一致

P13D 移动端第 7–24 个月9 条 · 0 已达成 · 19 条工作流

网络的第一道门不是「能连上」,是「连上之后两端看到同一个世界」——没有这一条,后面全是猜测。

  • 两客户端同房间互见(无预测)
  • RTT 100ms 下位置误差 < 1 格
  • 断线 5 秒内重连且状态一致
  • 1 核 50 并发房间,tick 漂移 < 5%

属于 P1 范围,P0 结束前不启动。

  • Metal / compute 路径跑通,能跑 GPU 粒子

属于 P1 范围。

  • Perf Agent 自动产出一次「被采纳」的优化 diff

引擎在这里能证明的只有一件事:项目只写三处代码就能把 agent 接进来,换 provider 不改游戏逻辑,且账单算得准。智力由项目接的模型决定,不在验收范围内。

  • 一局完整可下、可复盘
  • p99 决策 < 10 秒(60 步无超时)
  • trace 能回答「为什么走这步」
  • 同局重放逐字节相同(含 origin 标记)
  • 换 provider 游戏代码零改动
  • me budget 估算与真实账单误差 ≤20%(首批)

属于 P1 范围。

  • 抖音小游戏上线

属于 P1a 范围。

  • 3D 双端上线
  • Perf Agent 优化采纳率 ≥30%
  • MIR v1 冻结(含节点 net 段)
  • 第 2 个项目启动

冻结之后每次改动都要写迁移脚本,成本陡增——所以这条是 P1 里最不可推迟的一件事。

  • MIR schema v1 冻结,此后变更需迁移脚本

帧同步成立与否只有一条判据:三种目标算出同一个哈希。差一位就是差一位,没有「基本一致」。

  • 10 人 lockstep 跑通
  • WASM / ARM64 / x86 每 tick 状态哈希相同
  • 连续 30 分钟无 desync

P1b 的门。两条验收被换成「宿主可替换性」与「计量准确性」——胜率与留存取决于项目接的模型和产品设计,引擎兑现不了,写进验收就是把自己的 KPI 建在别人的变量上。

  • 换 provider(模型/厂商/端侧)游戏代码零改动
  • me budget 估算与真实账单误差 ≤5%(连续 30 天对账)
  • 三目标状态哈希逐帧相同,30 分钟无 desync
  • 1 核 50 并发房间,我方服务成本可算出数

P2PC 与高端渲染第 19–36 个月4 条 · 0 已达成 · 20 条工作流

先做软件光栅这一档,是因为 mesh shader 要等 D3D12/Vulkan 都稳了才能谈;而 Tier1 用一个 compute pass 就能验证「几何量不再受顶点缓冲限制」这件事本身。判据落在三角面数与帧率上,不落在「代码写完」。

  • 100 万三角面场景在 1080p 下 ≥30fps(Tier1 软件光栅路径)
  • 同一场景在关闭虚拟几何时退回普通绘制,画面差异只在远处细节
  • 显存峰值可报数(曲线由 CI 每轮记录)

⚠️ 这条在 2026-10-29 换了内容:D3D12 按 ADR-0018 提前到 P0 的 S18(第二个原生后端出画面),所以 P2 这一格不再是「双后端第一次跑通」。留下的是两件 P0 做不了的事:① Vulkan 是 Steam Deck 与国产显卡的必由之路,只做 D3D12 会在发行时被拦;② D3D12 的进阶能力(mesh shader、HW 光追)要等 P2 的几何与光照管线才有用武之地。判据仍是「同一份 cooked 包两端出同一张图」——只是 D3D12 那一端现在要在 P0 已有的基线上加特性,不是从零。

  • 同一份 cooked 包在 D3D12 与 Vulkan 上出图,语义级判据(非背景 IoU ≥0.999 + 色块归属一致)通过
  • 四个后端(GL / Metal / D3D12 / Vulkan)的能力矩阵无空洞
  • 后端切换只改配置,不改编译产物

P2 才是「写实」开始的阶段(05 号 §4)。硬件光追是这一段唯一无法用软件路径平替的能力,所以它单独成一条里程碑;降级链必须能自动生效,否则没 RT 的机器直接不可用。

  • DDGI 探针更新 ≤2ms(1080p,中端独显)
  • 关闭硬件光追时自动降级到 SDF-DDGI,画面不闪、帧率不塌
  • SSR 在掠射角不出现翻转,与反射探针的过渡无接缝

属于 P2 范围。

  • PC 端上线
  • 主机移植冒烟通过
  • 外部团队能独立使用(第 3 个项目)

P33A 与商业化第 37–48 个月3 条 · 0 已达成 · 13 条工作流

认证不是技术门槛而是流程门槛,失败通常是 checklist 里的死条款(内存上限、异常恢复、商店元数据)。先通过一个平台,把它变成一个可复用的 checklist,再开第二个——同时开三个是 P3 最容易高估的地方。

  • 至少一个平台的认证 checklist 全绿并留档
  • 该平台商店可下载,包体与内存上限都在官方限制内
  • 认证用的 checklist 已变成仓库里的可执行脚本(不是一份 PDF)

「外部团队能独立用」是 Gate 2 的判据,而授权是把它变成收入的动作。判据必须是第三方的使用记录,不是我们自己跑通的 demo。

  • 外部团队按文档 3 天内出第一个包(有试用记录与耗时)
  • 许可校验可离线:断网时仍能开,且过期有明确提示
  • SDK 与编辑器版本号一一对应,旧 SDK 能读旧工程

P3 的门第一次不是技术门:前三道门问「能力成立没有」,这道门问「这件事能自己养活自己没有」。技术指标在这里不再是主体。

  • 授权或云烘焙至少一条线产生真实收入(有合同与到账)
  • 主机版本至少一平台已上线并可下载
  • 大世界流式在真实项目里连续 30 分钟无卡顿
03 / 甘特

四个阶段,四张图

P0 的刻度是双周迭代、泳道是人;P1 起刻度是月、泳道是职能组。两种刻度不合并——P0 的一根条是两周,P1 的一根条是几个月,同轴要发明一个「每格等于多少天」的换算,而 P0 的条会细到看不见。

每张图是一个横向滚动窗口:列宽是固定像素,时间轴向左溢出、滚着看。不再切成几段竖着排——切段的代价是具体的:一根横跨段边界的条要切成两截,靠箭头与「续下一段」提示读者它们是一根;20 个迭代的轴头要标 10 遍;而「A1 在 S3/S4/S6 空转」这类跨段的事实,在任何一段里都看不出来。

代价写在明处:一屏只装得下 2.0 个迭代,读完 P0 要横滚 10.2 屏。这两个数印在每个窗口头上,而且「一屏」算的是时间轴露出的宽度:窗口 1,076px 要扣掉 96px 左槽与 11px 滚动条。不扣的话这句话会比实际坐得下的多,而它正是读者判断「要不要横滚」的依据。

左槽(编号)与上侧两行轴头都固定:竖滚到第 120 条也知道是哪一行,横滚到第 15 个迭代也知道是哪一列。而条不在横向视口里时,编号换浅蓝底并在后面挂一个指向它的箭头;点编号把窗口两个方向一起滚过去——只滚横向的话,条在下面第 40 行时点了等于没点。整屏都空时窗口中央会浮出一句话,说明这片白是「条在别处」而不是「这些活没排期」。

任务名写在条里(上行标题、下行「人日 · 等谁」),左边只留编号。左边那一列原来是 304px,与时间轴抢同一块宽度;搬进条里之后只剩 96px。而列宽不是挑的,是按标题宽度量的:P0 的标题中位 48 个字宽、p90 76、最长 163;一个迭代给 496px 时 170 根里 158 根完整(93%),压到 400px 掉到 82%、352px 只剩 68%——再窄就只剩省略号,而「哪几周」正是这张图的全部信息。

颜色只表示「归谁」(哪个泳道),实色 / 斜纹 / 淡色才是「做到哪」。这两件事用两套编码,是因为一条彩色条只能回答一个问题——而读者要问的往往是两个。

A1 240 · A2 244.5 · A3 187.5合计 672 人日上限 3 人 × 8.5 × 20 迭代 = 510S0-6、S10-8、S6-3 由两人以上共担,人日按人头均分(否则合计会比排班表大)差 162 人日,约 6 个迭代:这是把内容线并进 A1 的代价,不是排版问题——三条线装不下按四个人写出来的排班表。

分工三个人在这 20 个迭代里各担了多少(全阶段口径,不随窗口滚到哪而变)

智能体任务人日占上限没排活的迭代最忙的一个迭代
A159240141%S3、S4、S6、S13S1 · 26 人日
A265244.5144%S11S14 · 56 人日
A350187.5110%无S13 · 33 人日

节奏一格 = 这个人这个迭代多少活;空白就是他这两周没被派活。按绝对人日分档,不按占上限百分比——三个人都超 2–3 倍时,按百分比分档是 39 格全红,除了「全都不够」什么也读不出来。

迭代S0S1S2S3S4S5S6S7S8S9S10S11S12S13S14S15S16S17S18S19
全局周W1–2W3–4W5–6W7–8W9–10W11–12W13–14W15–16W17–18W19–20W21–22W23–24W25–26W27–28W29–30W31–32W33–34W35–36W37–38W39–40
A1162616261492582224131051187
A2931424302891851446561311666
A3865104518106312843341118878
<10 人日10–19≥20没排活上限 8.5 人日 / 迭代(1 人)
颜色 = 归谁:A1A2A3浓淡 = 做到哪:已完成(最深)在写未达 DoD(斜纹)未开始(淡)两人共担(虚线框)菱形 = 这一个迭代的末尾有门
20 个迭代(每个 496px)= 9,920 px时间轴 969 px(窗口 1,076 − 左槽 96 − 滚动条 11) ⇒ 一屏 2.0 个迭代 · 横向 10.2 屏
迭代
S0
S1
S2
S3
S4
S5
S6
S7
S8
S9
S10
S11
S12
S13
S14
S15
S16
S17
S18
S19
周
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
A1内核与编译链kernel59 项 · 240 人日 · 均 12/迭代(1.4 个产能)· 峰值 S1 26接手 14 · 交付 19

契约的产出方。写别人依赖的东西,因此写权最集中、审阅压力最大。

可写interfaceme-mirme-compilerme-agentme-coreme-cookedme-uime-rhi/src/ffi.hme-rhi/src/abi.rsme-rhi/src/backend.rsme-rhi/src/backends/metalapps/city-twinapps/studio-nativeapps/ui-galleryapps/ui-labdesigncontentlibrarytestsdocs/qa另 5 条构建/配置

S0-1
仓库骨架 + Rust workspace(9 个 crate)+ 目录约定2 人日
S0-2
CI 三目标构建:host / wasm32-unknown-unknown / aarch64-apple-ios3 人日 · 等 S0-1
S0-5
`me-rhi/ffi.h` 设计 + C++ dummy 后端(模拟 GNM 的对象式接口)5 人日
S0-6共
Rust → C ABI → C++ 冒烟:三角形 + 调用开销测量4 人日 · 等 S0-5
S0-9
MIR schema v0 草案(SceneGraph 子集,约 40 个节点类型)4 人日
S1-1
文本语法定稿(块语法 + 稳定属性顺序,**不用 S-expression**)3 人日 · 等 S0-9
S1-2
parser:手写递归下降,错误带行列号与修复建议5 人日 · 等 S1-1
S1-3
AST → 强类型 IR(schema 驱动代码生成)4 人日 · 等 S1-1
S1-4
规范化序列化器(排序规则、浮点格式、转义规则)4 人日 · 等 S1-3
S1-5
二进制 `mirb`(版本头 + 零拷贝 + 可 mmap)4 人日 · 等 S1-4
S1-8
校验规则首批:引用完整性、类型、循环依赖、预算字段合法性3 人日 · 等 S1-3
S1-9
示例场景 12 个(覆盖 2D 全要素:精灵/文本/九宫/层级/九层遮罩)3 人日 · 等 ←A3·S1-7
S2-1
pass 框架:注册、依赖、单独运行、逐 pass 日志4 人日 · 等 ⇠S1
S2-2
legalize:Tier0/Tier1 能力表 + 首批降级规则5 人日 · 等 S2-1
S2-3
budget:树形分配、父子借贷、超限定位到节点5 人日 · 等 S2-1
S2-9
基准场景 3 个(10 / 100 / 1000 sprite)2 人日 · 等 ←A3·S2-7
S5-1
Agent 运行时骨架:Intent → Task DAG → 执行器(可中断/重试)4 人日 · 等 ⇠S2
S5-2
Planner:意图 → 任务分解(prompt 模板带预算约束)4 人日 · 等 S5-1
S5-3
Builder:MIR patch 生成(schema 约束解码,不允许自由文本)5 人日 · 等 S1-3
S5-4
**Guardian:确定性校验器(不调模型),20 条规则**4 人日 · 等 S5-3
S5-5
Patch 应用器:三方合并 + 冲突检测 + 单步回滚3 人日 · 等 S5-3
S5-6
Provenance:`seed / model_version / recipe_hash` + 一条复现命令3 人日 · 等 S5-5
S5-8
评测集:20 个生成任务 + 人工评分标准(可接受/需修改/不可用)3 人日
S7-1
玩法框架:状态机、关卡流程、结算5 人日 · 等 ⇠S6
S7-2
关卡 1–3:手工 + AI 混合生产6 人日 · 等 S7-1
S7-7
首次真机全流程测试 + 问题清单3 人日 · 等 S7-2
S8-4
分包图划分:按场景可达性做图划分(最小割近似)5 人日 · 等 ←A2·S4-6
S8-7
真机安装验证 5 台(含最差机型)4 人日 · 等 ←A2·S8-1
S9-1
世界语法 v0:8 条布局规则(乡村 / 小镇 / 室内各一组)5 人日 · 等 ⇠S6
S9-2
构件库 v0:120 个构件 + 元数据(结构规格 + 语义标签)5 人日
S9-3
资产库双索引:语义向量 + 结构规格过滤5 人日 · 等 S9-2
S9-5
关卡生成器:语法 + 构件 + 预算约束 → MIR5 人日 · 等 S9-1、S9-3
S9-6
关卡 4–10 生产(AI 生成 + 人工 review)5 人日 · 等 S9-5
S10-1
5 台真机兼容矩阵(3 安卓低中端 + 2 iOS)6 人日 · 等 ⇠S8
S10-8共
Bug 修复缓冲6 人日 · 等 等 7 处前置
S11-1
隐私协议、用户协议、权限最小化3 人日
S11-2
审核自查(微信审核要点逐条)+ 整改5 人日
S11-5
灰度方案:5% → 20% → 100% + 回滚预案3 人日
S11-6
提审 + 应对驳回(预留 2 轮)6 人日 · 等 S11-2
S11-7
运营素材:icon / 截图 / 简介 / 分类3 人日
S11-8
客服与反馈通道2 人日
S12-1
全量发布 + 监控值守(前 72 小时)5 人日 · 等 ⇠S11
S12-2
留存与漏斗分析(7 日)4 人日 · 等 S12-1
S12-3
**工时台账汇总 + 与 Cocos 路线对比测算**5 人日
S12-4
六项指标核对表(每项给出数字与采集方式)4 人日 · 等 等 3 处前置
S12-5
Gate 0 评审报告 + P1 范围建议6 人日 · 等 S12-4
S14-8
`me import spine`:Spine JSON → MIR,含版本与字段校验、拒绝清单3 人日 · 等 ←A2·S14-1、←A2·S14-6
S14-20
`AttachmentKind::Clipping` + `Doc::clips` + 导入/导出 + 10 条判据3 人日 · 等 ←A2·S14-19
S14-21
`me_anim::mask`(作用域两段式 + 层状/深度检查 + `MaskStack`)+ 24 条判据3 人日 · 等 S14-20
S14-22
`linkedmesh`:两趟解析、几何复制、身份三元组、导出写回 + 13 条判据3 人日 · 等 ←A2·S14-15
S14-23
`deform` 继承:`Doc::deform_source` + `deform_into` 两趟 + 4 条判据1 人日 · 等 S14-22
S15-4
通用序列化:schema 驱动 / 版本头 / 零拷贝读 / 确定性写6 人日
S15-6
日志:分级 / 结构化 / 环形缓冲 / 崩溃前快照 / wasm 端导出4 人日
S16-7
九个子系统的 API 手册 + 每块 3 条反例(进 `docs/`,进 `doc-index`)3 人日
S16-8
端到端:coin-run 与 city-twin 各接一次九个子系统2 人日 · 等 等 7 处前置
S17-1
契约 v7:`surface` / `fence` / 资源 usage / pipeline / 平坦 binding slot / 格式裁剪 / 结构化 caps(ADR-0018 §D1–D9)8 人日
S17-2
三层对表:`check_contracts.py` 从「只比函数名」升到「参数个数 + 类型宽度 + 枚举值 + 结构体偏移」3 人日 · 等 S17-1
S18-1
Metal 后端:pipeline state / 绑定 / render pass / 绘制 / present8 人日 · 等 S17-1
S19-1
Metal 收尾:离屏渲染 + `copy_texture_to_buffer` + 回读(行 0 = 顶部)7 人日 · 等 S18-1
A2运行时与渲染runtime65 项 · 244.5 人日 · 均 12.2/迭代(1.4 个产能)· 峰值 S14 56接手 12 · 交付 17

契约的消费方 + 性能的兜底方。关键路径最长,最怕上游改接口。

可写interface/render.pass.mdme-rhi/backendsme-rhi/testsme-rhi/Cargo.tomlme-rhi/srcme-shaderme-rhi/toolsme-runtimeme-renderme-animme-audiome-record另 1 条构建/配置

S0-3
wasm 最小运行时:WebGL2 context + 三角形4 人日 · 等 ←A1·S0-2
S0-6共
Rust → C ABI → C++ 冒烟:三角形 + 调用开销测量4 人日 · 等 S0-5
S0-7
确定性构建基座:`SOURCE_DATE_EPOCH`、稳定排序、确定性 RNG3 人日 · 等 ←A1·S0-2
S1-6
往返校验 + 属性测试(proptest ≥1000 用例)3 人日 · 等 ←A1·S1-5
S2-4
lower:2D 场景 → 绘制列表 + 图集分配4 人日 · 等 ←A1·S2-1
S2-5
RHI WebGL2:buffer / texture / pipeline / draw / command buffer6 人日 · 等 S0-6
S2-6
着色器生成器 v0:材质节点 → GLSL(**全程无手写**)4 人日 · 等 S2-5
S3-1
archetype 存储 + 组件注册 + 句柄表5 人日 · 等 ⇠S0
S3-2
HierarchyIndex(父子稀疏数据)+ 变换传播4 人日 · 等 S3-1
S3-3
系统调度器:静态依赖图 + 单线程时间切片(2ms 预算)4 人日 · 等 S3-1
S3-4
内存模型:FrameArena / AssetHeap / Persistent3 人日 · 等 S3-1
S3-5
2D 批处理渲染器:排序、合批、状态缓存5 人日 · 等 S2-4
S3-9
性能基准 + 自动回归阈值(±5% 报警)3 人日 · 等 S3-5
S4-1
轻量混音器:16 通道、总线、距离衰减、单声道定位4 人日 · 等 ⇠S3
S4-2
wasm DSP 最小集:噪声/滤波/包络/混响(复用 SfxForge 配方)5 人日 · 等 S4-1
S4-3
音频管线:配方 → 烘焙 ogg 或运行时合成(按包体预算自动选)3 人日 · 等 S4-2
S4-4
场景音景:分层音床 + 随机变体调度3 人日 · 等 S4-2
S4-5
资源系统:AssetHandle、引用计数、按分包粒度整体卸载5 人日 · 等 S3-4
S4-6
流式加载:占位资产 → 渐进精化 + 相邻分包预下载5 人日 · 等 S4-5
S4-8
场景切换:无白屏(<300ms,含资源预热)3 人日 · 等 S4-6
S4-9
音频 CPU 预算测量(16 通道同时播放)2 人日 · 等 S4-1
S5-9
`--no-ai` 复现开关 + 回归测试2 人日 · 等 ←A1·S5-6
S6-3共
视口:`/api/build` 吐 cooked 字节 → wasm decode → **喂 `me-swrast` 的 `Framebuffer`**(原写「render 到 canvas」,自绘后 canvas 不存在)3 人日 · 等 S3-5、S6-1
S6-6
热重载 L1:材质/光照参数 <50ms3 人日 · 等 S6-3
S6-7
热重载 L2:结构变更 <300ms,实体按 id 映射4 人日 · 等 S6-6
S7-4
真机 profile 隧道:WebSocket trace → 编辑器5 人日
S7-5
归因:draw call → MIR 节点链4 人日 · 等 S7-4
S8-1
纹理压缩管线:ASTC / ETC2 + 质量档 + 按用途自动选5 人日 · 等 ⇠S7
S8-2
wasm 体积:`wasm-opt -Oz`、panic=abort、no_std 子集、去 fmt5 人日 · 等 S0-3
S8-3
音频:opus 低码率 + 大文件改运行时合成3 人日 · 等 ⇠S4
S8-6
首帧优化:首场景最小化 + 占位资产 + 并行下载5 人日 · 等 ←A1·S8-4
S9-4
规范化闸门:重拓扑/UV/单位朝向/LOD/材质烘焙 + 拒绝原因5 人日 · 等 ←A1·S9-2
S10-3
内存排查:30 分钟循环 + heap 快照 diff5 人日
S10-4
低端机降级:动态分辨率 + 画质档位下发4 人日 · 等 ←A1·S10-1
S10-7
压力测试:连续 100 次场景切换3 人日 · 等 S10-3
S10-8共
Bug 修复缓冲6 人日 · 等 等 7 处前置
S12-6
技术债清单 + 架构复盘(哪条 ADR 要改)4 人日
S13-7
渲染插值:把 `alpha` 交给渲染,**落点是 `me-runtime`**,不碰物理内部1 人日 · 等 ←A3·S13-3
S13-8
粒子系统:发射器 / 生命周期 / 曲线 / 混合模式 / 对象池5 人日 · 等 ←A3·S13-0
S14-1
骨骼层级 + 变换:局部/世界、继承标志(旋转/缩放/反射)、不动点4 人日
S14-2
关键帧时间轴:线性 / 阶跃 / 三次贝塞尔 + 轨道混合权重5 人日 · 等 S14-1
S14-3
2D 蒙皮:网格 + 权重 + 骨骼绑定 + 每帧 CPU 变形7 人日 · 等 S14-1
S14-4
形变动画:顶点偏移轨道 + 法线重算 + 与蒙皮共用网格4 人日 · 等 S14-3
S14-5
IK:两骨解析解 + 多骨 FABRIK(含极点与迭代上限)4 人日 · 等 S14-1
S14-6
附件与槽位:切换 / 绘制顺序 / 与 MIR 节点 id 对齐3 人日 · 等 S14-1
S14-9
`transform` 约束:四种更新模式(world/local × absolute/setup)+ 三条通道各自 mix + 从 JSON 读入并按 `order` 排3 人日 · 等 S14-1
S14-10
路径约束:位置 / 间距 / 朝向三个模式轴;配套 `me-math::arc` 弧长表与按距离反查3 人日 · 等 S14-1
S14-11
槽位混合方式(四种 + JSON 读入 + 两个别名)与两色着色(顶点 alpha 在两色之间插值)2 人日 · 等 S14-6
S14-12
`drawOrder` 与 `rgba`:从 Spine JSON 读入、写回、落到槽位,四格演示 + 反事实2 人日 · 等 S14-6、S14-11
S14-13
`deform`:列式导入 + 与网格对账 + 写回 + 播放到调用方缓冲2 人日 · 等 S14-4、S14-12
S14-14
`deform` 演示页:四格(无 / 线性 / 阶跃 / 世界空间反事实),15 项页面自检 + 两张证据图2 人日 · 等 S14-13
S14-15
网格几何进 `Doc`:`uvs` / `triangles` / `edges` / 顶点原样编码;加权网格带上、加权路径拒掉;两份真实文件夹具3 人日 · 等 S14-13
S14-16
网格附件 → `Mesh`:展开加权编码、塌成一个绑定点并报误差、非加权按槽位骨骼绑3 人日 · 等 S14-15
S14-17
`ik-lab` 演示页:四格(无 IK / Plus / Minus / 写回顺序错)+ 八导出 + 两张证据图3 人日 · 等 S14-10
S14-18
`fabrik-lab` 演示页:四格(直链初值 / 弯链初值 / 臂展边缘 / 臂展之外)+ 八导出 + 两张证据图3 人日 · 等 S14-17
S14-19
`me-anim::clip`(凸多边形裁剪 + UV 插值 + 批量接口)+ `clip-lab` 四格演示页3 人日 · 等 S14-12
S15-1
UI 布局补全:滚动容器 / 虚拟列表 / 九宫 / 多分辨率适配6 人日
S15-2
UI 焦点与导航:键盘 / 手柄焦点环 + 与输入法联动(`set_ime_area`)4 人日 · 等 S15-1
S15-8
UI 过渡动画:**复用 S14 的时间轴**,不另起一套3 人日 · 等 S14-2
S16-1
Profiler:scope 计时 + 采样 + 调用树聚合(按 scope 名,不按函数指针)6 人日
S16-2
Profiler:内存与包体归因,**并进 `trace.rs` 同一条通道**5 人日 · 等 S16-1
S17-3
`me-shader`:IR 定义 + 校验 + 常量折叠 + **MSL emitter**6 人日
S18-3
`me-shader`:**HLSL SM6 emitter**3 人日 · 等 S17-3
S18-4
null 后端按 v7 重写(契约自洽的第二份证据:不实现任何平台 API 也能编过全部语义)3 人日 · 等 ←A1·S17-1
S19-3
WebGL2 迁到 v7(compat 档:encoder 当录制日志、submit 时立即回放、fence 立即完成、barrier 空实现)6 人日 · 等 ←A1·S17-1
A3平台与工具链tools50 项 · 187.5 人日 · 均 9.4/迭代(1.1 个产能)· 峰值 S13 33接手 18 · 交付 8

共享设施的所有者:构建、CI、PAL、Studio。所有人卡住都找他,因此他最不能被自己卡住。

可写interface/pal.trait.rsinterface/cli.spec.mdme-palme-pal-wxme-clime-atlasme-atlas-iome-rhi/src/backends/d3d12me-physicsme-swrastme-compareme-studiome-studio-wasmme-rigid2dme-mathme-soft2dme-fluid2dme-fx2dapps/math-labapps/fx-labapps/studioapps/studio-shellapps/minigame-smokeapps/coin-runapps/macos-demoapps/tank-battleapps/physics-labapps/arcadeapps/gpu-demoapps/gpu-gl另 13 条构建/配置

S0-4
微信开发者工具最小工程:加载 wasm 并上屏3 人日 · 等 ←A2·S0-3
S0-8
`me` CLI 骨架(build / fmt / validate 占位)3 人日 · 等 ←A1·S0-1
S0-10
工程规范 + PR 模板 + AI commit 规则(§R-AI-1~3)2 人日
S1-7
`me fmt` / `me validate` 实装4 人日 · 等 ←A1·S1-4
S1-10
MIR 语法手册(20 个节点类型 + 10 个反例)2 人日 · 等 ←A1·S1-1
S2-7
link/pack:单包最小产物(本迭代不做分包)3 人日 · 等 ←A2·S2-4
S2-8
预算错误 UX:文案 + 建议("删 3 个装饰物可满足")2 人日 · 等 ←A1·S2-3
S3-6
图集打包工具 + 运行时图集切换4 人日 · 等 S2-7
S3-7
文本渲染:位图字体 + 动态字形缓存3 人日 · 等 ←A2·S3-5
S3-8
输入系统 + 微信触摸适配3 人日
S4-7
微信 PAL:FS、网络、分包加载 API4 人日
S5-7
AI Workbench 最小界面:意图输入、MIR diff、渲染前后对比5 人日
S6-1
**自绘壳**(`apps/studio-shell/`):窗口 + `me-swrast` 上屏 + 文字排版 + 输入法(含中文 IME),同进程起 `me-studio-serve`。**取代原「Tauri 2 壳」**,见 ADR-0015 §70 人日
S6-2
`me-studio` 服务:文档模型 + 命令栈(undo/redo)5 人日 · 等 S6-1
S6-3共
视口:`/api/build` 吐 cooked 字节 → wasm decode → **喂 `me-swrast` 的 `Framebuffer`**(原写「render 到 canvas」,自绘后 canvas 不存在)3 人日 · 等 S3-5、S6-1
S6-4
场景树 + 拖拽 + 多选4 人日 · 等 S6-2
S6-5
Inspector:MIR 节点属性编辑(**所见即 MIR**)4 人日 · 等 S6-2
S6-8
构建发布面板:一键构建 + 包体分析3 人日 · 等 S2-7
S7-3
UI 层:HUD、菜单、弹窗4 人日 · 等 ←A1·S7-1
S7-6
存档 / 设置(本地存储 + 跨端)3 人日 · 等 ←A1·S7-1
S7-8
性能预算热力图 v0(编辑器内高亮超预算节点)3 人日 · 等 ←A2·S7-4
S8-5
包体分析器:按模块/资产类型归因,输出可执行建议4 人日
S8-8
冷启动埋点(分段计时:wasm 加载/初始化/首场景)2 人日 · 等 ←A2·S8-6
S9-7
采纳率统计脚本(按 MIR 节点数,非人工估算)3 人日
S10-2
崩溃收集 + 符号化(wasm 栈还原)4 人日
S10-5
弱网 / 断网 / 后台切换 / 来电中断3 人日
S10-6
留存埋点 + 漏斗(进入/过关/失败/退出)3 人日
S10-8共
Bug 修复缓冲6 人日 · 等 等 7 处前置
S11-3
广告 SDK + 激励视频(如采用 IAA 模式)4 人日 · 等 ⇠S10
S11-4
埋点校验 + 后台看板4 人日 · 等 S10-6
S12-7
文档收尾:MIR 手册、构建手册、FAQ4 人日
S13-0
2D 数学库:`Vec2` / 仿射 `Mat2x3` / `Rot2`(`sin_cos` 只在这里调用)/ AABB / 贝塞尔与缓动 / 确定性定点5 人日
S13-1
碰撞形状:圆 / OBB / 凸多边形 + 层掩码 + 从形状推质量与惯量6 人日 · 等 S13-0
S13-2
窄相:SAT + 接触流形 + 接触点跨帧缓存(复用是稳定性的来源,不是优化)5 人日 · 等 S13-1
S13-3
顺序冲量求解器:摩擦锥 + 恢复系数 + 位置修正 + 热启动6 人日 · 等 S13-2
S13-4
关节三件套:距离 / 旋转 / 焊接(棱柱延到 P1,P0 没有用例)3 人日 · 等 S13-3
S13-5
查询 API:raycast / shape cast / overlap,带 filter 与排序3 人日 · 等 S13-1
S13-6
定步长:固定 1/60 累积器 + 休眠 + 宽相 SAP(**在 `me-physics` 内**)2 人日 · 等 S13-3
S13-9
特效时间轴:序列帧 / 拖尾 / 屏幕抖动 / 后效挂钩点3 人日 · 等 ←A2·S13-8
S14-7
状态机与混合:1D blend + 过渡时长 + 事件轨(脚步/受击)4 人日 · 等 ←A2·S14-2
S15-3
UI 样式表:设计令牌 → 主题(明/暗)+ 与图集共用一份色彩真相3 人日 · 等 ←A2·S15-1
S15-5
存档:槽位 / 版本迁移链 / 完整性校验(**升级 S7-6,不并存**)5 人日 · 等 ←A1·S15-4
S15-7
落盘适配:IndexedDB(web)/ `wx.setStorage`(小游戏)/ 文件(桌面)3 人日 · 等 S15-5、←A1·S15-6
S16-3
Profiler:marker 通道 + 火焰图数据导出(编辑器直接可读)4 人日 · 等 ←A2·S16-1
S16-4
CLI:全命令 `--json` 输出 + 退出码按「谁能改」分档5 人日
S16-5
CLI:编辑器协议(一次性命令 + watch 增量 + 变更集 + 版本协商)6 人日 · 等 S16-4
S16-6
CLI:`me import` / `me export` 命令组(Spine、图集、存档)3 人日 · 等 S16-5
S17-4
D3D12 骨架:设备 / 表面(`IDXGISwapChain3`)/ 资源 / fence / 描述符堆分配器(**不碰着色器与 pass**)8 人日 · 等 ←A1·S17-1
S18-2
D3D12 后端:root signature / PSO / barrier 跟踪 / command list / 提交7 人日 · 等 S17-4
S19-2
D3D12 收尾:同上 + **参考图入库** `tests/render/ref/<scene>/d3d12.png` + 跨机语义级判据([附录 B](#附录-b--跨机语义级判据s19-2-的-dod-怎么判))8 人日 · 等 S18-2
这一屏没有条 —— 本屏这些行的条在别处:编号后的 ‹ › 是方向,点编号直接滚到它跟前。

左槽(编号)与上侧两行轴头都是固定的:竖滚到第 120 条仍知道这是哪一行,横滚到第 15 个迭代仍知道这是哪一列。两根条不会再被切开——旧版按列切段,跨段的那根要画成箭头、还要写「续下一段」,而它本来就只是一根条。竖滚而整屏是空时不是没有活:那是这些行的条不在这一段里——编号换浅蓝底、后面挂一个指向条在哪边的箭头,点编号把窗口滚过去。

读法:一根条落在哪几周,就是这周它在做;条里两行——上行标题、下行「人日 · 等谁」(← 是同一个人给自己的前置,⇠ 是等整个迭代,←A2·S4-6 是等别人),左边只剩编号。列宽固定、横向滚动:最早把全部周数挤进一屏,一列只剩 12px,一根条只能说明「这周有个东西」;后来按列切段竖着排,列宽够了,但一根跨段边界的条要画成两截。现在一列 496px、20 个迭代连成一条轴,一根条从第一周画到最后一周——中途没有段边界,所以不存在「那是两根条」。前置不存在、指向更晚的迭代、成环,都会让这次构建直接失败:这三类错误在页面上看不出来,只能在这里拦。

渲染 950 · 动画 310 · 网络 910 · 模型 300 · 工具 610 · 平台 300合计 3,380 人日上限 11 人 × 17.85 人日/月 × 18 月 = 3,534.3余 154.3 人日(4%):合计看着装得下,但每组各自的余量见下方泳道——合计够不等于每组够。

分工6 个职能组在这 18 个月里各担了多少(全阶段口径,不随窗口滚到哪而变)

职能组工作流人日占上限峰值月平均每月
REN渲染595099%M6 · 占上限 204%52.8 人日(99% 人)
ANI动画331096%M8 · 占上限 224%17.2 人日(96% 人)
NET网络491094%M6 · 占上限 199%50.6 人日(94% 人)
MOD模型230093%M8 · 占上限 221%16.7 人日(93% 人)
TOOL工具361095%M6 · 占上限 151%33.9 人日(95% 人)
PLAT平台230093%M10 · 占上限 261%16.7 人日(93% 人)
颜色 = 归谁:渲染动画网络模型工具平台浓淡 = 做到哪:规划中(淡:还没有一行代码,所以没有完成状态)两人共担(虚线框)菱形 = 这一个季度的末尾有门
18 个月(每个 163px)= 2,934 px时间轴 969 px(窗口 1,076 − 左槽 96 − 滚动条 11) ⇒ 一屏 5.9 个月 · 横向 3.0 屏
季度
Q1
Q2
Q3
Q4
Q5
Q6
月
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
REN渲染3 人5 条 · 950 人日 · 上限 53.5 人日/月 · 峰值 109.1(2.04 个产能)接手 0 · 交付 4
P1-1
RHI:Metal 后端(Tier1 + compute 路径)240 人日
P1-2
Clustered Forward+ 与 PBR260 人日 · 等 P1-1
P1-3
级联阴影 + 后处理链(Bloom / ACES / SSAO)160 人日 · 等 P1-2
P1-4
TAA + 超分(先 FSR1 类空间法)120 人日 · 等 P1-3
P1-5
分层材质 + 节点种类扩容170 人日 · 等 P1-2
ANI动画1 人3 条 · 310 人日 · 上限 17.8 人日/月 · 峰值 40(2.24 个产能)接手 1 · 交付 1
P1-6
骨骼蒙皮(bone-only,走现有 sprite 批处理)90 人日 · 等 ←REN·P1-1
P1-7
3D mesh 蒙皮(骨骼矩阵数组,需要改 RHI 契约)100 人日 · 等 P1-6
P1-8
动画状态机 + 混合树 + 根运动120 人日 · 等 P1-7
NET网络3 人4 条 · 910 人日 · 上限 53.5 人日/月 · 峰值 106.4(1.99 个产能)接手 0 · 交付 1
P1-9
`me-net`:传输 / 协议 / 会话 / 时钟230 人日
P1-10
`me-sim`:权威 tick + 快照与增量220 人日 · 等 P1-9
P1-11
lockstep + 回滚 + desync 检测240 人日 · 等 P1-10
P1-12
`me-arena`:agent 宿主(Provider / 预算 / 回放)220 人日 · 等 P1-9
MOD模型1 人2 条 · 300 人日 · 上限 17.8 人日/月 · 峰值 39.5(2.21 个产能)接手 1 · 交付 0
P1-13
`me-model`:Provider 与 Pricing 接口 + 计量累加器 + 30 天对账190 人日 · 等 ←NET·P1-9
P1-14
"像不像人"的可区分性度量(AUC / 思考时长 / 失误率曲线)110 人日 · 等 P1-13
TOOL工具2 人3 条 · 610 人日 · 上限 35.7 人日/月 · 峰值 53.8(1.51 个产能)接手 3 · 交付 0
P1-15
资产管线:导入器 + 图集 + 子包规则190 人日 · 等 ←REN·P1-1
P1-16
编辑器:动画编辑 + Perf Workbench270 人日 · 等 ←ANI·P1-7
P1-17
MIR v1:预算注解 + provenance + 迁移脚本150 人日 · 等 ←REN·P1-2
PLAT平台1 人2 条 · 300 人日 · 上限 17.8 人日/月 · 峰值 46.7(2.61 个产能)接手 1 · 交付 0
P1-18
抖音小游戏端(宿主 + 分包 + 审核)160 人日 · 等 ←REN·P1-1
P1-19
Android / iOS 原生壳(PAL 扩展)140 人日 · 等 P1-18
这一屏没有条 —— 本屏这些行的条在别处:编号后的 ‹ › 是方向,点编号直接滚到它跟前。

左槽(编号)与上侧两行轴头都是固定的:竖滚到第 120 条仍知道这是哪一行,横滚到第 15 个迭代仍知道这是哪一列。两根条不会再被切开——旧版按列切段,跨段的那根要画成箭头、还要写「续下一段」,而它本来就只是一根条。竖滚而整屏是空时不是没有活:那是这些行的条不在这一段里——编号换浅蓝底、后面挂一个指向条在哪边的箭头,点编号把窗口滚过去。

读法:一根条覆盖哪几个月,就是这几个月在做;条里两行——上行标题、下行「人日 · 等谁」,左边只剩编号。泳道头上写着组人数与月产能。人日摊在这几个月里,所以分工表里的数比总人日更能说明这一组哪个月满。颜色只是身份——六个组六种颜色,淡色是因为这段还没有一行代码,不是「不重要」。起止月越出阶段区间、前置指向不存在的工作流、成环,都会让这次构建直接失败。

渲染 1,920 · 角色 1,250 · 主机 800 · 工具 1,120 · 美术 1,320 · QA 720合计 7,130 人日上限 25 人 × 17.85 人日/月 × 18 月 = 8,032.5余 902.5 人日(11%):合计看着装得下,但每组各自的余量见下方泳道——合计够不等于每组够。

分工6 个职能组在这 18 个月里各担了多少(全阶段口径,不随窗口滚到哪而变)

职能组工作流人日占上限峰值月平均每月
REN渲染61,920100%M5 · 占上限 185%106.7 人日(100% 人)
CHR角色41,25097%M12 · 占上限 175%69.4 人日(97% 人)
HOST主机380083%M12 · 占上限 159%44.4 人日(83% 人)
TOOL工具31,12087%M6 · 占上限 160%62.2 人日(87% 人)
ART美术21,32082%M5 · 占上限 106%73.3 人日(82% 人)
QAQA272075%M4 · 占上限 102%40 人日(75% 人)
颜色 = 归谁:渲染角色主机工具美术QA浓淡 = 做到哪:规划中(淡:还没有一行代码,所以没有完成状态)两人共担(虚线框)菱形 = 这一个季度的末尾有门
18 个月(每个 163px)= 2,934 px时间轴 969 px(窗口 1,076 − 左槽 96 − 滚动条 11) ⇒ 一屏 5.9 个月 · 横向 3.0 屏
季度
Q1
Q2
Q3
Q4
Q5
Q6
月
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
REN渲染6 人6 条 · 1,920 人日 · 上限 107.1 人日/月 · 峰值 198.3(1.85 个产能)接手 0 · 交付 8
P2-1
D3D12 后端360 人日
P2-2
Vulkan 后端320 人日 · 等 P2-1
P2-3
Virtual Geometry:Tier1 软件光栅400 人日 · 等 P2-1
P2-4
Virtual Geometry:Tier3 mesh shader300 人日 · 等 P2-3
P2-5
SDF-DDGI 全局光照280 人日
P2-6
HWRT-DDGI + 屏幕空间反射 + 体积雾260 人日 · 等 P2-5
CHR角色4 人4 条 · 1,250 人日 · 上限 71.4 人日/月 · 峰值 125(1.75 个产能)接手 3 · 交付 0
P2-7
皮肤 SSS330 人日
P2-8
毛发 Shell + Strand360 人日 · 等 ←REN·P2-1
P2-9
眼球 + 布料300 人日 · 等 ←REN·P2-1
P2-10
角色编辑器与预览260 人日 · 等 ←REN·P2-2
HOST主机3 人3 条 · 800 人日 · 上限 53.5 人日/月 · 峰值 85.0(1.59 个产能)接手 3 · 交付 0
P2-11
Xbox devkit + RHI 移植冒烟320 人日 · 等 ←REN·P2-1
P2-12
PS5 devkit 评估与移植预研240 人日 · 等 ←REN·P2-5
P2-13
主机提交流程与 checklist240 人日 · 等 ←REN·P2-5
TOOL工具4 人3 条 · 1,120 人日 · 上限 71.4 人日/月 · 峰值 114.4(1.60 个产能)接手 1 · 交付 0
P2-14
构建农场 + 增量编译420 人日
P2-15
多人协作(资产锁 / 冲突检测)340 人日 · 等 ←REN·P2-1
P2-16
资产导入器插件化 + 格式版本360 人日
ART美术5 人2 条 · 1,320 人日 · 上限 89.2 人日/月 · 峰值 94.4(1.06 个产能)无跨组交接
P2-17
演示项目(PC 版)资产量产900 人日
P2-18
材质库与参考场景420 人日
QAQA3 人2 条 · 720 人日 · 上限 53.5 人日/月 · 峰值 54.5(1.02 个产能)接手 1 · 交付 0
P2-19
兼容矩阵(GPU 厂商 × 驱动版本)380 人日 · 等 ←REN·P2-1
P2-20
性能基线回归(每轮 CI 自动出曲线)340 人日
这一屏没有条 —— 本屏这些行的条在别处:编号后的 ‹ › 是方向,点编号直接滚到它跟前。

左槽(编号)与上侧两行轴头都是固定的:竖滚到第 120 条仍知道这是哪一行,横滚到第 15 个迭代仍知道这是哪一列。两根条不会再被切开——旧版按列切段,跨段的那根要画成箭头、还要写「续下一段」,而它本来就只是一根条。竖滚而整屏是空时不是没有活:那是这些行的条不在这一段里——编号换浅蓝底、后面挂一个指向条在哪边的箭头,点编号把窗口滚过去。

读法:一根条覆盖哪几个月,就是这几个月在做;条里两行——上行标题、下行「人日 · 等谁」,左边只剩编号。泳道头上写着组人数与月产能。人日摊在这几个月里,所以分工表里的数比总人日更能说明这一组哪个月满。颜色只是身份——六个组六种颜色,淡色是因为这段还没有一行代码,不是「不重要」。起止月越出阶段区间、前置指向不存在的工作流、成环,都会让这次构建直接失败。

主机 1,900 · 世界 2,700 · 角色 2,200 · AI 2,100 · 商业 2,000 · 平台 1,900合计 12,800 人日上限 60 人 × 17.85 人日/月 × 12 月 = 12,852主机 差 400.6、世界 差 129.6、角色 差 58、AI 差 172.2——这几组各自超了,合计却还余 52。合计对账会把分组超支抹平,这一行就是为了不让它被抹平。

分工6 个职能组在这 12 个月里各担了多少(全阶段口径,不随窗口滚到哪而变)

职能组工作流人日占上限峰值月平均每月
HOST主机21,900127%M8 · 占上限 176%158.3 人日(127% 人)
WORLD世界22,700105%M4 · 占上限 115%225 人日(105% 人)
CHR角色22,200103%M8 · 占上限 143%183.3 人日(103% 人)
AIAI22,100109%M6 · 占上限 135%175 人日(109% 人)
BIZ商业32,00093%M8 · 占上限 162%166.7 人日(93% 人)
PLAT平台21,90074%M3 · 占上限 95%158.3 人日(74% 人)
颜色 = 归谁:主机世界角色AI商业平台浓淡 = 做到哪:规划中(淡:还没有一行代码,所以没有完成状态)两人共担(虚线框)菱形 = 这一个季度的末尾有门
12 个月(每个 163px)= 1,956 px时间轴 969 px(窗口 1,076 − 左槽 96 − 滚动条 11) ⇒ 一屏 5.9 个月 · 横向 2.0 屏
季度
Q1
Q2
Q3
Q4
月
37
38
39
40
41
42
43
44
45
46
47
48
HOST主机7 人2 条 · 1,900 人日 · 上限 124.9 人日/月 · 峰值 220(1.76 个产能)接手 0 · 交付 1
P3-1
PS5 / Xbox / Switch 正式支持与认证1,600 人日
P3-2
三平台提审与商店页300 人日 · 等 P3-1
WORLD世界12 人2 条 · 2,700 人日 · 上限 214.2 人日/月 · 峰值 247.2(1.15 个产能)无跨组交接
P3-3
大世界流式加载(分块 / 预取 / IO 预算)1,900 人日
P3-4
世界编辑与分区工具800 人日
CHR角色10 人2 条 · 2,200 人日 · 上限 178.5 人日/月 · 峰值 254.5(1.43 个产能)无跨组交接
P3-5
影视级角色管线(groom 导入 / SSS2 / strand)1,700 人日
P3-6
角色性能预算与 LOD 自动派生500 人日 · 等 P3-5
AIAI9 人2 条 · 2,100 人日 · 上限 160.6 人日/月 · 峰值 216.9(1.35 个产能)无跨组交接
P3-7
运行时 AI:NPC 行为与动态叙事1,600 人日
P3-8
本地推理预算与降级策略500 人日 · 等 P3-7
BIZ商业10 人3 条 · 2,000 人日 · 上限 178.5 人日/月 · 峰值 288.9(1.62 个产能)接手 1 · 交付 0
P3-9
引擎授权:SDK 分发 + 许可校验800 人日
P3-10
云烘焙服务(离线 GI 集群)700 人日
P3-11
垂直行业方案(文旅 / 适老化互动)500 人日 · 等 ←HOST·P3-1
PLAT平台12 人2 条 · 1,900 人日 · 上限 214.2 人日/月 · 峰值 202.5(0.95 个产能)无跨组交接
P3-12
平台抽象层 v2(跨主机 + 跨端)1,400 人日
P3-13
遥测与崩溃上报500 人日
这一屏没有条 —— 本屏这些行的条在别处:编号后的 ‹ › 是方向,点编号直接滚到它跟前。

左槽(编号)与上侧两行轴头都是固定的:竖滚到第 120 条仍知道这是哪一行,横滚到第 15 个迭代仍知道这是哪一列。两根条不会再被切开——旧版按列切段,跨段的那根要画成箭头、还要写「续下一段」,而它本来就只是一根条。竖滚而整屏是空时不是没有活:那是这些行的条不在这一段里——编号换浅蓝底、后面挂一个指向条在哪边的箭头,点编号把窗口滚过去。

读法:一根条覆盖哪几个月,就是这几个月在做;条里两行——上行标题、下行「人日 · 等谁」,左边只剩编号。泳道头上写着组人数与月产能。人日摊在这几个月里,所以分工表里的数比总人日更能说明这一组哪个月满。颜色只是身份——六个组六种颜色,淡色是因为这段还没有一行代码,不是「不重要」。起止月越出阶段区间、前置指向不存在的工作流、成环,都会让这次构建直接失败。

04 / 迭代与任务

170 个任务 + 52 条工作流

清单解析自 docs/10 与 docs/15,看板不另存一份。P0 勾到任务,P1 起只到工作流——计划只承诺到这个粒度。

看谁的A1 59 项 · A2 65 项 · A3 50 项 · 泳道 A/D → A1,B → A2,C → A3(原 A4 内容线 2026-10-25 并入 A1)

目标:在写下 5 万行代码之前,确认三件事——wasm 能进微信、Rust 能调 C++、构建是确定性的。

  • A1仓库骨架 + Rust workspace(9 个 crate)+ 目录约定2 人日workspace 用 glob 发现成员(crates/*),新增 crate 不必改共享文件;现有 12 个 crate。
  • A1CI 三目标构建:host / wasm32-unknown-unknown / aarch64-apple-ios3 人日每个 crate 在 Cargo.toml 的 package.metadata.me.targets 里声明自己该在哪些目标上构建,CI 逐个目标真构建,不做 --workspace 一把梭。
  • A2wasm 最小运行时:WebGL2 context + 三角形4 人日wasm + WebGL2 三角形已在微信开发者工具里出图,截图留档。
  • A3微信开发者工具最小工程:加载 wasm 并上屏3 人日最小小游戏工程能加载 wasm 并上屏;打包守卫把这个工程的上传白名单也纳入了检查。
  • A1me-rhi/ffi.h 设计 + C++ dummy 后端(模拟 GNM 的对象式接口)5 人日
    契约早在 S0 就定稿(v6 / ABI 5 / frozen),缺的一直是「第二种语言的实现」。展开 531 字
    契约早在 S0 就定稿(v6 / ABI 5 / frozen),缺的一直是「第二种语言的实现」。(2026-10-26) 此前仓库里一个 C++ 文件都没有:git ls-files '*.cpp' 为空,所有 FFI 检查都是 「Rust 里 extern "C" 声明、链接到自己的 Rust 实现」——那证明符号名写对了, 不证明这份头文件别人能用。 本轮补上 tools/ffi/dummy_backend.cpp:#include "../../interface/rhi.ffi.h", 内部是一个对象式的 DummyDevice(虚函数 + me_handle 就是指针,模拟 GNM 那类 对象式接口),外面是一层 extern "C" 薄壳。薄壳里只有一行转发,校验全在类里 ——薄壳里再写一遍业务规则就是两份规则,而两份规则必然有一天不一样。 编译器替我抓签名:头文件是唯一来源,抄错一个参数类型就编不过。 CI 里用 -Wall -Wextra -Werror 编 —— 后端代码带 warning 也算失败, 因为「参数没用上」正是「签名写错但恰好编得过」的前兆。
  • A1+A2Rust → C ABI → C++ 冒烟:三角形 + 调用开销测量4 人日
    真链路:Rust → C ABI → C++,19 条判据 + 一个开销数。展开 820 字
    真链路:Rust → C ABI → C++,19 条判据 + 一个开销数。(2026-10-26) tools/ffi/smoke.rs(rustc 直编,不进 cargo 构建图 —— 给 me-rhi 加 build.rs 会让 wasm32/ios 也跑一遍 clang++,把「主机验证件」变成「三个目标都可能构建失败」)。 判据:ABI 版本不匹配 ⇒ ME_ERR_INVALID_ARG(不是崩溃、不是默许);越界写入 ⇒ 拒绝 (头文件明写不截断不扩容);没 set_pipeline 就 draw_bound ⇒ 拒绝且不记账; 完整画三角形 ⇒ 账本里正好 3 顶点 / 1 draw / 1 帧;set_pipeline(NULL) 是合法解绑。 第 3 条最有价值:它是「静默跳过」与「报错」的分界,而静默跳过的症状是画面少一块 但没有任何错误,这类问题会一路活到 QA。 三角形这条 DoD 的实现形态要说清:它记的是「契约的形状被 C++ 满足、且前置 条件真的被拦」,不画像素。画像素由 apps/macos-demo 的真 Metal 判据负责 —— 混在一起的话,画不出来无法归因:是 ABI 错、后端没实现、还是驱动。 开销(DoD 第二半):跨语言调 me_rhi_capabilities 1.3 ns/次(20 万次 × 8 轮取最好)。 这个数比 ffi_cost.rs 那三个调用的 8.7~9.9 ns 更小,因为这里没有 uniform/纹理的 参数解码 —— 它量的是「薄壳 + 一次指针往返」本身。 退出码分三档:0 通过 / 1 判据失败 / 2 环境不满足(没有 clang++),CI 把 2 打成 ! 降级但把 SKIP 的原因打进那行字——一条永远静默跳过的检查等于不存在。
  • A2确定性构建基座:SOURCE_DATE_EPOCH、稳定排序、确定性 RNG3 人日确定性基座落在 me-runtime 的 det 模块:确定性 RNG + 稳定排序;配 SOURCE_DATE_EPOCH 与二次构建 hash 比对测试。
  • A3me CLI 骨架(build / fmt / validate 占位)3 人日me CLI 有 new / doctor / versions / json / diag 子命令;build 仍是明确占位的退出码 5(不返回假成功)。
  • A1MIR schema v0 草案(SceneGraph 子集,约 40 个节点类型)4 人日MIR schema v0 落地并登记进契约清单,含 8 条 JSON Schema 表达不了的语义不变量(x-invariants)。
  • A3工程规范 + PR 模板 + AI commit 规则(§R-AI-1~3)2 人日
    规则终于会红了。 docs/09 §9.2 的 R-AI-1 写下来之后,仓库里 390 个提交一个都没标(git log --all --format=%s | grep -c '^ai:'…展开 933 字
    规则终于会红了。 docs/09 §9.2 的 R-AI-1 写下来之后,仓库里 390 个提交一个都没标(git log --all --format=%s | grep -c '^ai:' = 0)——不是谁偷懒,是**没有任何东西会 让它变红**。只写在文档里的规则,只有「被人想起来」这一种生效方式,而它一次也没被想起来。 交付物三件:tools/ci/check_commit_msg.py(判据 + 12 条 self-test,钉判定逻辑而不是崩溃)、 tools/ci/hooks/commit-msg(提交那一刻就拦,不必等到 push——等到 push 才拦,人面对的是 五条历史,只能 rebase -i,而改历史最容易的结果是 --no-verify)、ci.sh 新增一步。 人读入口是 CONTRIBUTING.md(署名格式 / merge 三问 / 提交前跑什么 / 三条红线)与 .github/PULL_REQUEST_TEMPLATE.md(当下用途是贴进 merge 提交——那是本仓库唯一 「没人 review 也没人写正文」的提交)。 三条边界写在代码里:① 用尾部 trailer 不用 subject 前缀(git log --format=%(trailers) 一行统计 AI 占比,subject 每条重复模型名还会挤满 --oneline);② prompt-hash 不强制 (仓库没有 prompt 留档机制,编个假 hash 会让后来的人以为可复现,那是 S5-6 的活); ③ 不追溯 390 条历史——生效点由脚本自动推导(本文件首次加入的提交),rebase 后自动跟随, 写死 sha 会一次 rebase 就失效,而失效的表现是「检查静默变成检查 0 条」。 没做:R-AI-3(AI 代码覆盖率 ≥70%)需要按提交统计覆盖率,得等覆盖率采集接进 CI; R-AI-2(B 类代码禁止 AI 生成)的判据是「这段代码属于 B 类」,而仓库里还没有那份清单—— 两条都不是 2 人日的活,已记在下面的计划外条目里。

目标:让"场景"成为一种可读、可 diff、可往返验证的文本程序。

  • A1文本语法定稿(块语法 + 稳定属性顺序,不用 S-expression)3 人日块语法 + 稳定属性顺序定稿,写进 EBNF,不走 S-expression。
  • A1parser:手写递归下降,错误带行列号与修复建议5 人日手写递归下降 parser;报错带行列号与期望 token,位置统一由 Pos::from_offset 换算(存字节偏移,不存行列),有守卫测试。
  • A1AST → 强类型 IR(schema 驱动代码生成)4 人日AST 带字节偏移,节点类型由 schema 驱动;MirDoc 持有整份源码供诊断回查。
  • A1规范化序列化器(排序规则、浮点格式、转义规则)4 人日规范化序列化:排序规则、浮点格式、转义规则固定,判断标准是 encode(decode(b)) == b。
  • A1二进制 mirb(版本头 + 零拷贝 + 可 mmap)4 人日二进制 mirb:版本头 + 零拷贝 + 可 mmap;规范里把「读侧不许比写侧宽松」写成唯一判据。
  • A2往返校验 + 属性测试(proptest ≥1000 用例)3 人日往返校验 + 自研模糊测试(替代 proptest):截断、单字节破坏、变异输入三类,五轮里找出五种「读侧比写侧宽松」。
  • A3me fmt / me validate 实装4 人日
    me fmt 走 format_verified 并写盘(「fmt 两次结果相同」由 CLI 的幂等门禁钉住);展开 168 字
    me fmt 走 format_verified 并写盘(「fmt 两次结果相同」由 CLI 的幂等门禁钉住);me validate 走 me_mir::verify,跑语法 + 不变量 + 预算 +「未执行的规则」,通过 / 有诊断 / 用法错三态都有断言。长期记成「占位 exit 5」是旧口径——那时占位的是 me build。
  • A1校验规则首批:引用完整性、类型、循环依赖、预算字段合法性3 人日校验规则首批落地:引用完整性、类型、循环依赖、预算字段合法性;诊断码表 39 条(八域),码表是生成物、逐字节比对防止过期。
  • A1示例场景 12 个(覆盖 2D 全要素:精灵/文本/九宫/层级/九层遮罩)3 人日
    12 份齐了,而且每一份都说得出自己该画几条。 这一轮补的 10 份各自钉一个 2D 能力,不是凑数:text_scene(文本 = 精灵 + uv,8×4 字形表)、nine_slice_s…展开 1131 字
    12 份齐了,而且每一份都说得出自己该画几条。 这一轮补的 10 份各自钉一个 2D 能力,不是凑数:text_scene(文本 = 精灵 + uv,8×4 字形表)、nine_slice_scene(九宫 = 9 个 uv 矩形,uv 与 scale 必须配套)、atlas_frame_scene(序列帧 = 同一张图四格)、layer_stack_scene(layer 0..8 的先后)、depth_sort_scene(同层内 z 先、sort_y 后)、hierarchy_scene(父链累乘:2× 与 0.5× 抵消成 32×32,世界位置 (128,88) 是算出来的)、tint_scene(0.5 → 128 不是 127)、rotation_scene(弧度 / 绕中心 / 负角度归一化,两个 target 所以必须给 --profile)、budget_tight_scene(父子预算恰好相等,ME-BUDGET-003 报错主体是父)、uv_inset_scene(内缩半像素,0.5/96)。 三件事让它们不只是"文件变多了": ① 每份头部写 # expect-draws: <n>,test_cli.sh 新增一条门禁逐份 build 并核对条数。为什么是声明而不是"≥1":3D 的 coin_scene 在 lower 只处理 2D 的今天就是 0 条,它必须能合法存在;而 2D 内容 0 条是 bug。一个「≥1」表达不了两件事,最后一定会长出例外名单,而名单会让第二份 3D 内容静默逃过。演练过:把 tint 的声明改成 5、把标记删掉,两种都红且指名道姓。 ② .mir.json 孪生的比对范围扩到 attrs / inputs / targets / roots(见 24453e5)。扩之前 n_coin_b 有 rot 而孪生没有,漂了整整一轮检查是绿的 —— 也就是说这 10 份新孪生所依赖的那条判据,四小时前还只是"看起来在比"。10 份孪生的生成用的是与判据不同的实现(一次性脚手架,按行读、自己数花括号),所以判据能抓生成器的错。 ③ 这批文件是 uv 的第一个真实用户。sprite_scene 里 uv 全是默认值,等于 uv 这条路径在内容侧从没被走过;现在 9 份带非默认 uv。 边界:文本没有排版(字距/换行是手算的),九宫没有边框参数,图集不存在(uv 指向的是假想的格子,op.registry.rs 的 note 允许这么写)。真图集等 S3-6。
  • A3MIR 语法手册(20 个节点类型 + 10 个反例)2 人日
    手册不抄文法。 mir.grammar.ebnf 是给实现者的产生式,它读起来允许的东西实现可能拒收,反过来也发生过——所以 20 个节点全部用 me validate 真跑一遍。展开 2833 字
    手册不抄文法。 mir.grammar.ebnf 是给实现者的产生式,它读起来允许的东西实现可能拒收,反过来也发生过——所以 20 个节点全部用 me validate 真跑一遍。跑出来三条「按文法读会想错」的:① roots [] 明明是空的却被报成「缺 roots」且位置指向下一处;② 未登记预算键的 ErrCode 是 ContractViolation、退出码却是 3(预算不达标);③ a_ 资产引用的存在性从来不校验(ME-VAL-003 每次都明说「不变量 3 本次未执行」),写错字一路走到运行时。三条都进 §5,带实测报文。 20 份示例 + 10 个反例都是判据,不是篇幅。 示例在 interface/examples/spec/,与 §2 二十节一一对应,每份要过 parse + validate(且不带告警——样板自己带告警会教坏第一批读者),还必须是规范形式(format_text(parse(x)) == x 逐字节),否则读者抄完跑一次 me fmt 就得到覆盖全文件的 diff。反例直接引 interface/examples/bad/ 现有 12 份,不另造一份:那份东西有人写好了、也有 negatives.rs 守着。 格式不由我猜。 生成脚本写完跑一次 me fmt、再跑一次确认没有第二遍改动(第一遍它在每个 node 块之间插了空行——我以为的「紧挨着」不是规范形式,而「规范形式九条」里没有这一条,只有 text.rs 知道)。 6 条防漂移断言,8 个变异各自转红(删 budget 键 / 多一个空行 / 多一份未登记文件 / 手册点名不存在的文件 / 某一节不点名示例;第 6 条是 21:30 补的,三个方向:手册把「现有 12 份」改成 13 / §3 表格删一行 / bad/ 目录里多一份,三处各自红)。最后一条是本轮唯一改过的判据:最初写「小节数 == 表里节号数」,它红了——手册把 2.11/2.12、2.17/2.18 合并成一节,计数对不上;改成「每节都要说得出读者该去跑哪一份文件」,因为数节数只能证明写了 20 段,而一段没有示例的散文可以是任何东西。 第 6 条是复核时发现的缺口,不是新功能:正例份数有 table() 与 no_unlisted_spec_files 双向钉住(多一份、少一份都红),反例份数却只有 negatives.rs 在跑,而它不关心份数——往 bad/ 加第 13 份、顺手在它那张表里补一行,它就绿了,手册里的「12」会安静地留在原地。手册是给人数着读的(「下面 10 份最值得先读,另两份是同域补充」),数字错了,读者会以为自己漏看了两份,翻完目录发现手册说得不对——那一刻手册就不再是可信的入口。现在三个数互相锁:现有 N 份 = 表格 10 行 + 「另」行点名的 2 个 = 目录实际 12 份。 没做:mir.spec.md 未登 interface/MANIFEST.json(它是手册不是契约,每条契约都带版本号与 sha256,塞进去等于每次改字都 bump 一次),归 A1 决定要不要作为第 15 项。四条缺陷一条都没改(三条在 me-mir、一条在 me-cli,后者修法是 EXIT_BY_CODE 加一行,但会动退出码,先报备再动)。 2026-10-26 合并 origin/main:这条两边各做了一遍,两份证据都在树上,都留着。 谁主谁辅、要不要只留一份,等 A1 定(已报备)。 main 侧记的是: 手册是生成物,因为手写的清单已经错了三倍。(2026-10-26) DoD 写「20 个节点类型 + 10 个反例」。今天注册表里是 6 个 op、反例 14 个: 数字错了三倍,而没有任何东西会因此变红——这正是本仓库反复出现的形状 (诊断码漏七条、Studio note 说了不红、注入工具锚点静默失效)。 docs/11-mir-grammar.md 由 tools/doc/gen_mir_manual.py 生成:op 表来自 interface/op.registry.rs 的 OpDef{id,domain,requires,fallback,params},反例表来自 interface/examples/bad/*.mir 的文件头第一行(期望码也在那儿,不另抄一份表)。 check_generated.py mir 逐字节比对,第一处差异报行号而不是「内容不同」。 演练过会红:把 sprite.draw 改成 sprite.drawx ⇒ 第 61 行。 手册里一个手写数字都不留,全部算出来。内容覆盖:最小可编译文档(五行构造 + 各自 失效码)、节点类型表(能力位与默认降级)、引用与层级(悬空报 ME-REF-001,报错 subject 是写引用的地方)、预算四键(ME-BUDGET-001/002/003 三种混淆)、14 个反例表、以及 「刻意没写的三件事」(attrs 的逐字段 schema、id 语法展开、性能数字——都会与权威源漂移)。 2026-10-27:§5 缺陷 4(a_ 引用从不校验)已修,这一条的三条缺陷剩两条。 手册当初把这条写成「当前最大的静默失败面」,成因是「资产表在 P0 没落地」——表补上了,check_refs 里那个 unenforced(3) 放行开关就拆掉了,GAPS 从 2 条降到 1 条。这不是「又加了一条校验」,是这套记性机制第一次兑现:删掉清单条目那一刻,asset_ref_is_unguarded_by_design 如期变红,改写成 a_misspelled_asset_is_a_dangling_ref 之后转绿——一个能让删除变成红灯的缺口清单,比一句「TODO 补上」有用得多。 手册这边:§2.21 新增第 21 节(21-assets.mir,含「assets 块与它上面的注释之间要空一行」这个规范形式的坑——紧贴着写 me fmt 会推开一格,示例自己就不规范了);§4 边界表补 8 行(全部现场跑出来的,含一条已知的措辞偏差:两个 assets 块报 ME-SYN-006「键重复」,而实际重复的是块);反例 14 → 15 份。三处份数互相锁(spec_examples.rs),改一处不同步另外两处就红。

目标:打通 .mir → 屏幕,并让"预算"第一次真正拦住东西。

  • A1pass 框架:注册、依赖、单独运行、逐 pass 日志4 人日pass 框架落地:pass 注册与依赖、可单独运行、逐 pass 日志;编译帧结构单独成模块。
  • A1legalize:Tier0/Tier1 能力表 + 首批降级规则5 人日legalize 有 Tier0/Tier1 能力表与首批降级规则;能力位按声明式白名单判定,不在代码里散落条件编译。
  • A1budget:树形分配、父子借贷、超限定位到节点5 人日budget 做树形分配与父子借贷,超限定位到节点 id 并给出超出比例。
  • A2lower:2D 场景 → 绘制列表 + 图集分配4 人日
    已关闭(2026-10-25,用户决定)。 原文最后一句「还差图集分配:它要每张图的真实像素尺寸,而资产清单还没有(等 S3-6 真打包),现在是一张纹理走到底」现在三句全不成立:① 真实像素…展开 730 字
    已关闭(2026-10-25,用户决定)。 原文最后一句「还差图集分配:它要每张图的真实像素尺寸,而资产清单还没有(等 S3-6 真打包),现在是一张纹理走到底」现在三句全不成立:① 真实像素尺寸有了——props.atlas 每帧九个整数(图集矩形 x y w h + 裁剪偏移与原图尺寸 ax ay ow oh);② 「一张纹理走到底」早就过期了,sprite_scene 报 3 个纹理(多 tex 按字符串分槽);③ 编译器做不了自动装箱是设计不是欠账:装箱要写出一张新图,而 me build 按 ADR-0009 不落盘——在一条只读命令里加一个隐藏的写盘副作用,正是 ADR-0009 要拒绝的形状。落点因此拆成两段,都已经落地:离线装箱 tools/atlas/package.py(紧包围盒 + 高度降序 shelf + 按面积挑宽度,与 me-render/src/atlas.rs 必须是同一套 shelf)+ 内容里显式声明 attrs: { tex=…, atlas=…, frame=… },uv 由 lower 查表算,六种错法全报 ME-REF-003。判据也不是「也能画」而是「同一组数」:atlas_frame_scene 的四个手算 uv 换成 frame="f0".."f3" 之后,编出的四条与原值逐位相等(test_cli.sh 151 项)。低降链本身(parent 链累乘变换 → DrawItem、纯 3D 内容编出 0 条绘制时的 ME-BLD-006 告警)都已被 22 条测试钉住,不受这次关闭影响。
  • A2RHI WebGL2:buffer / texture / pipeline / draw / command buffer6 人日WebGL2 后端覆盖 buffer / texture / pipeline / draw / command buffer;null 后端用于无 GPU 环境的 CI。
  • A2着色器生成器 v0:材质节点 → GLSL(全程无手写)4 人日
    生成器落地:五种节点(常量/贴图/乘法/lerp/UV 变换)→ GLSL,两种形态都不再手写——精灵管线由节点图生成,上屏的 blit 归结到同一个模块。展开 395 字
    生成器落地:五种节点(常量/贴图/乘法/lerp/UV 变换)→ GLSL,两种形态都不再手写——精灵管线由节点图生成,上屏的 blit 归结到同一个模块。判据是两条,一条比一条硬:① 生成结果与迁移前的手写字节逐字节相同(所以「画面一个字没变」是可验证的,不是看起来一样);② src/ 里除 shader/ 之外不许出现 #version,注释行除外——一条没有例外的规则才守得住。顺带把 texture_slot_count 从手写常量改成从源码数出来,「声明一个槽」与「源码里有一个采样器」从此不可能漂。边界写清楚:材质图今天由渲染侧代码构造,MIR 还没有材质节点的产生式(语法里有 material 图但没有 lower),让内容侧能写材质是 P1 的事——所以这条的准确说法是「屏幕上的着色器由节点图生成」,不是「内容能写材质」
  • A3link/pack:单包最小产物(本迭代不做分包)3 人日
    me pack 从占位变成真实现(75592c7),产出的是这个迭代要的「单包最小产物」:dist/ 里是上传时真会走的那些文件(按 packOptions.ignore 剔除,剔掉的逐类汇总…展开 1417 字
    me pack 从占位变成真实现(75592c7),产出的是这个迭代要的「单包最小产物」:dist/ 里是上传时真会走的那些文件(按 packOptions.ignore 剔除,剔掉的逐类汇总),外加一份账本 me.pack.v1(files[] 的路径/字节/包归属 + content[] 每条内容的档位与 draw 数)。三条判据都跑得出来:产出后自校验(ME-PKG-016:文件数与字节逐一对齐,缺一个/多一个都红)、包体判据只有一份(主包 4MB / 总包 30MB,与 game.json 的分包配置交叉核对,所以「清单里有、配置里没有」这类不一致在打包时就被点名)、同一工程两次打包账本字节相同(实测 md5 一致——这条是 S0 DoD「同一 commit 两次构建产物 hash 一致」在打包侧的落点)。 没做、且本迭代明确不做:分包切分(那是 S8-4 的图划分,本迭代只读分包配置做一致性检查,不切产物)。没做、且不是本条的:包里的内容还没有文件形态——content[] 只记「编过了、多少 draw、几张图」,ME-PKG-023 明说「说得出这三个数,不等于包里有东西」,运行时到底读什么等 N-021(A2)与 S3-6。这条边界写在账本里而不是只写在计划里,所以下一个人读账本时不会以为包里已经有内容产物了。 2026-10-27 追加:assets 声明现在有三层判据,me pack 从「不碰资产表」变成它的唯一消费者。契约(mir.spec.md §2.21)一直写着「路径的形态与存在性都要等 me pack」,而那边没有这个检查——一句挂了空头承诺的边界。现在补上三条,各自对应一种改法:ME-PKG-030 写法不是工程内相对形式(绝对路径 / 盘符 / 含 .. 或 . 段)、ME-PKG-029 文件不存在、ME-PKG-031 在工程里但不会进包(被 packOptions.ignore 匹配等)。判据的实质不是「越不越界」而是「这串字面量等不等于包里那条路径」:绝对路径在本机真能读到东西,而收集出来的路径里不会有那些段,于是那条声明永远对不上 files[] 里任何一项——所以先判写法再判存在,顺序反了就是一个「检查过了、却永远不会进包」的资产。第三层直接用 files(真的会进包的那份清单),不重算 ignore/白名单/SKIP_DIRS:重算就是第二个实现,而漂移的表现是「检查说会进包、包里没有」,比不检查更坏,因为它是一句保证。三条都不产出 dist/。判据在 crates/me-cli/tests/pack_roundtrip.rs 四条走真进程的用例里,三次变异演练各红到点子上(整段跳过 3 红 / 只关 031 1 红 / 只废写法判据 1 红——最后那条证明「文件存在但永远进不了包」本来是完全静默的)。⚠️ coin_scene.mir 的两个 .glb 按设计不在仓库,所以「十三份示例一起打」那条用例的夹具补了一步 supply_declared_assets(从内容自己声明的路径造文件,不写死路径)——那批用例的主语是字节往返,不该被这件事绊住。
  • A3预算错误 UX:文案 + 建议("删 3 个装饰物可满足")2 人日预算越界不再只说「超了」,而是带上具体数字的建议(抬到多少、删哪个);建议本身也算数字。
  • A1基准场景 3 个(10 / 100 / 1000 sprite)2 人日
    (这个编号此前被借去记录另一件事:me build 的落盘实现整份撤回(ADR-0009 §2.2)。展开 1895 字
    (这个编号此前被借去记录另一件事:me build 的落盘实现整份撤回(ADR-0009 §2.2)。那段历史在 CHANGELOG 里;这里归还为板上真正的 S2-9 —— 基准场景。) 三份场景是生成的,不是手写的。tools/gen/bench_scenes.py → interface/examples/bench/sprites-{10,100,1000}.mir(1000 精灵 = 12031 行 / 352KB)。手写不可能,而「生成一次、生成器丢掉」更坏:半年后没人说得清那 12k 行还是不是对的,改布局要手工改 12k 行。所以生成器入库、产物也入库,--check 比对两者(由 crates/me-cli/tests/bench.rs 调用)——产物与生成器必须同时正确,这条纪律与 me fmt --check 是同一条。 场景的形状有具体目的,不是随便摆的。4 张图分成 4 组,组内 z 递增、组间也递增,于是画家顺序(layer → z)下同图的必然连续 → 预期 4 批。换成交替放置(0,1,2,3,0,1…)会让每张都断批,测出来的是「合批失效时多贵」,而 DoD 要的是「合批有没有生效」——两者不是同一个问题。 预算按子树总量给,第一次就是这么被拦下来的。ME-VAL-002 判的是「直接子节点之和」,所以一个 xform.node 即使自己不画东西,额度也必须 ≥1(它含着一个 sprite.draw)。这条一开始写成 draw=0,1000 个节点全部报错——而报错文案是对的,它直接说「要么把 n_a0_at 的 draw 抬到 ≥1」。 住子目录不是随意选择。pack_roundtrip.rs 有一条 copied == 12 的断言,数的是 interface/examples/*.mir。基准场景放顶层会让它红,而它会报「示例数量变了」——一个和性能毫无关系的失败信息。tests/bench.rs 里有一条测试把「住在子目录且不污染顶层」钉住。 这三个规模各有用途:10 = 小场景地板价(固定开销占比)、100 = 典型关卡(中段线性度)、1000 = DoD 的验收点(批次数 ≤8、线性度是否还成立)。实测 release 下 1000 精灵:parse 1.65ms · compile 38.9ms · batch 0.008ms。 2026-10-26 合并 origin/main:这条两边各做了一遍,两份证据都在树上,都留着。 谁主谁辅、要不要只留一份,等 A1 定(已报备)。 main 侧记的是: 按标题交付:三档基准真的有了,而且它是可判红的那一半。(2026-10-26) crates/me-runtime/examples/ecs_swarm.rs 的 SIZES = [10, 100, 1000, 10000],前十档正是这条 DoD 点名的 10 / 100 / 1000 sprite;一万档加进来是为了看趋势是否单调(三档看不出单调性,而「列存收益随规模变大」这句话只有单调才成立)。 为什么它不是又一个 bench:同一个文件里写了两套存储(archetype 列存 / Vec<Box<dyn Unit>>),跑的是同一个 initial(i) 与同一个 step_moving,每次跑完还按实体 id 比位置的位模式。比不出相等就 exit 1 —— 因为没有这一步的「A 比 B 快」不叫对比,叫两个程序。 数字(本机 M1 / release / 每档 5 轮最好值):update 在 N=1000 是 1.07µs vs 2.69µs(2.5x),N=10000 是 9.8µs vs 24.5µs;同目标总成本(两边都做到 3 批)N=1000 是 22.0µs vs 35.0µs(1.59x)。低档 N=10 反过来(0.9x)—— 小规模时 ECS 的固定开销收不回来,这一条照实写进报告。 判据进 CI:ecs_swarm --check 三档,三条断言(世界逐实体相同 / 批优先几何相同 / 画家顺序下 ECS 批数严格更少)。第三条是本仓库唯一声明「ECS 更好」的断言,演练过反向会红(3 vs 10 报错并指明它是什么证据)。

目标:运行时骨架成型,且性能数字是可测的。

  • A2archetype 存储 + 组件注册 + 句柄表5 人日archetype 存储 + 组件注册 + 句柄表齐备,签名用位图而非字符串集合。
  • A2HierarchyIndex(父子稀疏数据)+ 变换传播4 人日
    父子链接不是组件:archetype 按组件集合分桶,加一个 Parent 会把「精灵+变换」劈成有父/没父两桶,而绝大多数实体没有父。展开 701 字
    父子链接不是组件:archetype 按组件集合分桶,加一个 Parent 会把「精灵+变换」劈成有父/没父两桶,而绝大多数实体没有父。改成住在 World 里的左孩子/右兄弟索引(每实体 24 字节、零分配,懒扩容——没有层级的场景一次都不分配)。环在 attach 时拒绝,不靠深度上限兜底:前者的失败发生在建立关系那一步(工具能当场报,玩家看到拖拽弹回),后者要等到某一帧开始「每帧多转一点」才看得见。变换传播另开 LocalTransform(相对父)而不动 Transform2D 的世界坐标语义——改语义是契约级迁移(SpriteInstance 与 DrawItem 都按世界坐标消费它),而父子能力靠「加一个组件 + 每帧一次 propagate」就能拿到;没有 LocalTransform 的实体一个字节都不碰(零回归)。尺寸不随父缩放(那要加 scale 列,契约级,走协商板)。删父时子升根,世界位由 despawn_keeping_children_in_place 烘焙回局部——裸 despawn 会让挂件瞬移一次,而这个封装只能在 render2d(ECS 不认识 Transform)。11 + 11 条判据,五条负向验证全红在靶上(旋转符号、漏减父中心、角度覆盖、不烘焙、传播顺序)。 2026-10-26 合并说明: A3 侧有一份同名实现,但它从未提交(本地 mem.rs 比主干少 887 行,lib.rs 还把主干已修正的说法退回去了),已作废,本条的说明与证据取主干那份。
  • A2系统调度器:静态依赖图 + 单线程时间切片(2ms 预算)4 人日六段固定阶段调度器(Input / FixedUpdate / Update / LateUpdate / Render / Teardown),阶段顺序写死在类型里而不是靠约定。
  • A2内存模型:FrameArena / AssetHeap / Persistent3 人日
    三个池按「谁能决定它的死期」分:FrameArena(帧末 reset,游标归零、不还内存)/ AssetHeap(按分包整体还)/ Persistent(进程结束)。展开 584 字
    三个池按「谁能决定它的死期」分:FrameArena(帧末 reset,游标归零、不还内存)/ AssetHeap(按分包整体还)/ Persistent(进程结束)。三条硬规则:超预算返回 None(wasm 里 panic 就是小游戏闪退,而「这一帧塞不下」可以降级——少画几个粒子、略掉一层辉光);失败不改状态(手写 bump 分配器很容易先推游标再判越界,那么一次失败会让后面所有分配错位,症状是「偶尔有一帧画面全乱」);reset 不还内存(只归零游标,capacity 不变,第二帧起零分配)。零 unsafe:Vec<u8> 当底座、把「本次分配」表示成区间,代价是只拿得到 &mut [u8]——在列式存储面前可忽略,回报是这条路径上写不出未定义行为。底座建时多要 15 字节修一次绝对地址对齐(Vec<u8> 只保证 1 字节对齐),挡掉那种「离出错地方几百行」的 cast_slice_mut panic。28 条判据(22 单元 + 6 端到端)。 2026-10-26 合并说明: A3 侧有一份同名实现,但它从未提交(本地 mem.rs 比主干少 887 行,lib.rs 还把主干已修正的说法退回去了),已作废,本条的说明与证据取主干那份。
  • A22D 批处理渲染器:排序、合批、状态缓存5 人日2D 批处理:排序键、合批、状态缓存;一帧的提交顺序固定为 剔除 → 排序 → 绑管线 → 上传 → 绘制。
  • A3图集打包工具 + 运行时图集切换4 人日
    从「一段 Python」变成一条命令:me atlas <dir> 现在真跑得出来。展开 3005 字
    从「一段 Python」变成一条命令:me atlas <dir> 现在真跑得出来。新增 crates/me-atlas(L5 · host)——算法一行没重写(me_render::atlas 的 shelf 仍是唯一实现),它只做算法不管的四件事:排序 / 定高 / 分页 / uv。 排序不是优化,是判据,而且这条被实测打回来过一次。 第一版照 lower::sort_textures 按名字排(看着更一致),实测同一批 18 帧(武术序列)在 1024×1024 都装不下;改成高度降序 → 宽度降序 → 名字之后 1024×699 装下、占用 93.3%,与 apps/coin-run/wushu/sprite.json 逐字段对得上。差的是 33% 的显存。两处排序刻意不同,因为排的不是同一件事:lower 那个决定资产编号(要跨构建稳定),这个决定摆进图集的先后(要省显存)。 最容易静默错的是 index 那一列。 运行时不认名字,DrawItem::texture 是 lower 按名字排序后从 0 编号的资产表下标。计划里那一列必须等于「该素材名在名字字典序里的位次」,猜错的表现是每个精灵都采样到别人的格子——图集本身正确、构建也正确,没有任何一步会报错。判据跑真链路(me build --emit-cooked → me_cooked::decode → 读运行时真正会看到的 textures 表),语料 depth_sort_scene.mir 的声明顺序不是名字序,否则这条等于空转。 「运行时图集切换」没有新机制。 batcher 一直按 texture 分组、一换就断批,所以切换的全部代价已经由那句 if current != Some(...) 决定了;命令要做的只是让 texture 装页号。新增 me_atlas::remap(资产名表 → 页号 + uv,缺名字一次报全),tests/switch.rs 用真 Batcher 钉住:18 张同页 → 1 批(图集前是 18 批)、跨页必断、以及一条代价——BatchFirst 只能聚同层的同页。 变异测试抓出一条假绿。 六条判据第一轮 M3 仍绿:删掉 sort_unstable() 端到端测试照样通过——NTFS 的目录项按名字存,read_dir 给出来已经是名字序,那条判据在这台机器上等于没判。修法是把排序抽成 texture_order() 单测,用显式乱序(还带一个大写开头的 Roof.png,顺带钉住「按字节比而不是按本地化比」)。改完六条全红。 边界:不写 PNG(要 zlib,与零外部依赖冲突);me build 还不自动跑图集——要人显式 me atlas --out,接进构建链的前提是内容侧先声明「这批 tex 打成一个图集」。 补记(同日 22:10):这条规则被真实素材证伪了一次。 拉下 library/art 里的 packs/coin-run 之后跑 me atlas,它的图集是 1536×122 —— 而 --height 122 被「必须是 4 的倍数」拦下,auto 又把页高抬到 124。归因错了:GL_UNPACK_ALIGNMENT 约束每行起点(宽度方向),高度是行数、不参与对齐;原注释里「右边缘一列发淡」说的也是宽度。代价不报错:UV 的 v 分母从 122 变 124,ground(120px 高)底边少采 1.6%,近 2 个像素,画面上是底边被切一条。已删 HEIGHT_ALIGN;--height 原样接受任何≥8 的值;ME-ATL-005 拆成两种成因(页高选大了 / 行内右侧没排满,修法相反)。顺带订正旧判断:wushu 的 699 对 700 不是「刻意差 1 像素」,是同一条错误规则的产物,现在两边都是 699。新增第二处跨实现对账(coinrun 的 8 个矩形 + 页尺寸 + ground 的 v 上界 120.5/122),变异「把对齐加回去」三条测试同时红。契约 v6→v7。 2026-10-26 合并 origin/main:这条两边各做了一遍,两份证据都在树上,都留着。 谁主谁辅、要不要只留一份,等 A1 定(已报备)。 main 侧记的是: 两半都落地了,证据也在 CI 里。 生产侧(打包):tools/atlas/package.py 紧包围盒 + 高度降序 shelf + 按面积挑宽度,.atlas 帧表与图集图同出一份配方;tools/atlas/verify.py 纯 stdlib 进 CI。 消费侧(运行时切换):game.rs 把三张图集烘进二进制(hero_atlas.rgba.z / world_atlas.rgba.z / backdrop.rgba.z + include_bytes!),启动时自写 inflate 解开 —— 比带 PNG 进包小(962.9KB → 645.3KB),也不依赖宿主有没有解码器。PIXELS_PER_UNIT = VIEWPORT[0] / WORLD[0](=4)是算出来的而不是写死的,所以「帧尺寸 ÷ 4 = 世界尺寸」这条天然成立(写成 tex_px 会让一切大 4 倍,而那看起来像「分辨率调了」)。帧随物理状态切:HERO_FRAMES 7 帧、WORLD_FRAMES 5 帧。 证据(这条上一版缺的就是它):apps/macos-demo/check_dump.py 走真 Metal 离屏渲染 → 读回像素 → 与入库的 expect.json 比结构性指标(舞台覆盖率 / 重心 / 18 格缩略图覆盖率 / 当前帧亮度 / 顶点·索引·批次)。不逐像素比是有理由的:Linear 采样 + 预乘舍入 + unorm 量化 让边缘差一两级灰度,逐像素比只有「阈值宽到抓不住」或「天天红」两种结局。这条判据在 CI 里(bash apps/macos-demo/build.sh --check),不是手工截图。 上一版为什么记成 wip:那时只有我自己那条路(宿主解码 + 三段式上传 + art.html 取色),而 art.html 在 swiftshader 下跑不出绿(createImageBitmap 的 Promise 永不 settle),于是「真机采到了图集」没有证据。合并 A2 之后那套被烘进二进制这条取代,判据换成 check_dump.py,证据补上了 —— 所以现在记 done。撤回的文件(frames.rs / art_atlas.rs / gen_frames.py / art.html / run-art.sh)留在 git 历史里。
  • A3文本渲染:位图字体 + 动态字形缓存3 人日
    中文能上屏,而且是在一局真游戏里验的。 位图字体(5×7 ASCII)与中文点阵走同一条路径:FontAtlas 建一张 512×512,ASCII 与 569 个汉字一起烘进去,cjk::t…展开 1415 字
    中文能上屏,而且是在一局真游戏里验的。 位图字体(5×7 ASCII)与中文点阵走同一条路径:FontAtlas 建一张 512×512,ASCII 与 569 个汉字一起烘进去,cjk::text_width 按 16px 格宽算排版。落地对象是 coin-run 换皮成「铜钱江湖」之后的 HUD / 标题 / 说明 / 选关 / 结算 / 对白 —— 这条不是「能画几个汉字」的演示,而是一整套界面文案在跑。 四个取舍,每个都有反例撑着: ① 不引 TTF:仓库零第三方依赖,光栅化 TrueType 要几百行还得自己解 cmap。改成离线烘:tools/gen_hanzi.py 用 PIL + 系统 STHeiti Medium.ttc(index=1 才是简体)产出 16×16 1 位点阵。1 位与 8 位就是「放得进 800 KB」与「放不进」的差别(459 字 62.7 KB 对 ×8)。 ② 只能有一张字体图集:View.atlas 只有一个槽位。两张图集时第二张的字拿到第一张的 UV,画出来是一片透明 —— 症状是判据报「0 个 HUD 墨色像素」,看上去像「字没画」,实际是「画在别处」。所以 ASCII 与汉字必须烘进同一张。 ③ 度量必须与真正画的字体一致:help_line_rects() 原读 BuiltinFont::line_height()(8px),而中文实际 16px ⇒ 矩形只有字的一半 ⇒「说明页不压手柄」那条判据绿着放行。改走 cjk::text_width + hanzi::CELL 之后立刻红(中文版压到第 9 行才收住)。 ④ 生成物与 rustfmt 打架:hanzi.rs 一字一行,rustfmt 想拆成 16 行一组 ⇒ cargo fmt --check 与 gen_hanzi.py --check 互相把对方判红,谁先跑谁赢。表上加 #[rustfmt::skip],生成器模板 HEADER 同步加 —— 只改一边等于下次生成时再把坑挖回来。 对白是字幕条,不是墨字压背景。 原方案把台词直接画在关卡上,实测压深色土带只有 3.4:1(门槛 4.5),而噪声背景上不存在一种墨色能对所有底色都够亮。改成深底 [12,16,24,245] + 浅字 ⇒ 16.2:1,与关卡无关。 判据:every_character_of_the_copy_is_baked / every_talk_character_is_baked 逐字比对文案与点阵表(少一个字就红),加几何四条(底板有面积 / 文字在板内 / 不越界 / 左右留白相等)。反向验过:改左对齐 ⇒「左边留白 0,右边留白 192」;底板上移 ⇒「对白下沿 278 超过了世界高度 270」。 两处残留:① 收字靠 gen_hanzi.py 的 SCAN 白名单(game.rs / copy.rs / level.rs + .lvl 的 talk 行),新模块里写一句上屏中文,字进不了表而 --check 不红;② 对白只有几何判据,没有像素级判据(check_dump.py --hanzi 判的是标题那行)。
  • A3输入系统 + 微信触摸适配3 人日
    完成(2026-10-26)。 定义是「输入系统 + 微信触摸适配」(docs/10 §5 那张表的第 8 行),现在四件事都在,且判据能自己红: ① 契约那半。展开 1698 字
    完成(2026-10-26)。 定义是「输入系统 + 微信触摸适配」(docs/10 §5 那张表的第 8 行),现在四件事都在,且判据能自己红: ① 契约那半。 pal.trait.rs v1 有 Input / PointerPhase / PointerEvent / MAX_POINTER_EVENTS,6 字节由 const _: () = assert!(size_of::<PointerEvent>() == 6) 钉住;16 = 8 指 × 2 这条关系也钉成了编译期断言(这一轮补的,原先只活在注释里)。 ② 平台的微信实现那半。 wx.onTouch* → platform.js 队列 → 6 字节 → touch_codec.rs,99 项端到端(真 wasm + 真 platform.js + mock wx);宿主侧 81 项跑真 game.js,钉住 NDC 换算(漏乘 DPR / y 没翻转各有一个可断言的数)、两指一次 drawArrays、抬起/取消不画点。 ③ 这一轮补的是第三条腿:这条链在游戏里了。 之前 apps/coin-run/build.sh 只编 me-runtime,真游戏的触屏走 game.js 自己绑 wx.onTouch* → CoinBoot.toViewRect → me_coin_run_poke,完全绕过引擎的输入系统;而 toViewRect 与 VirtualPad 之间没有任何东西保证两边算的是同一件事。现在(N-312 的 A 案,A1 2026-10-26 定): - me-runtime 新增 me_coin_run_surface_px(w,h) 与 me_coin_run_touch_px(id,phase,x,y);后者收画布物理像素,在 px_to_world 里折成世界坐标(口径与 boot.js 的 toViewRect 逐个数字对齐:钳 → 乘 → 四舍五入 → 钳)。 - boot.js 只做「CSS → 物理像素」(toPx / toPxRect),世界坐标不再有第二份实现;bindInput 绑事件之前先报画布尺寸。game.js 同一套。 - me_coin_run_poke 保留(收世界坐标):它是确定性重放的入口,ScriptedInput 的时间线按帧号存世界坐标,重放不该依赖屏幕多大。 ④ 判据。 crates/me-runtime 的 wasm 测试 5 条(没报尺寸就拒、报 0 就拒、四角与 1280 级非整除的换算、物理像素按在跳键上必须落在跳键矩形里、以及一条负样本:不换算的坐标必须一个键都中不了);JS 侧 wx.test.js 18 项里 tap() 按的是世界键位、送的是屏幕坐标,进得了游戏就说明整条换算对了;boot.test.js 新增 3 条钉住 toPxRect、bindInput 先报尺寸、触点走物理像素入口。 ⑤ 仍然缺的两件,都不属本条的定义: - 真机没验(本机只有 Chrome + 开发者工具模拟器)。这是 S8-7/S10-1 的判据。上一版我把这条当成 S3-8 的堵点,据此记过完成又据此退回 wip —— 两次都错在拿别人的判据当自己的。 - WxInput 仍未收编:me-pal-wx 不在游戏包里,所以真游戏用的是引擎内置的等价换算,不是那个适配器。两份并行实现(99 项 vs 5 条,判据不重叠),收编(把 me-pal-wx 打进游戏包、让 touch_px 退化成 Pal::input 的转发)没有排期。这一条写在这里,是因为它是 A 案的直接代价,不是遗留 bug。
  • A2性能基准 + 自动回归阈值(±5% 报警)3 人日
    在写:六条判据落五条;「微信开发者工具内 ≥30fps」仍卡真运行时。展开 4236 字
    六条判据落五条;「微信开发者工具内 ≥30fps」仍卡真运行时。(2026-10-25 补登记:这条在 N-209 里已经落了。2026-10-26 再补:±5% 回归阈值落地,见下。) 能数的进 CI、判红:wasm_perf 7 条 + perf_js_table 4 条(1000 批 / 3 批 / 几何逐项相同 / 三张贴图颜色不同)。 这一轮新落:±5% 自动回归(tools/ci/perf_regress.py + perf-baseline.json,已进 CI)。但照字面实现会造出一条天天假红的判据,所以量分了两类: - 确定性的(批次数 / 顶点 / 索引)⇒ 精确相等,比 ±5% 严得多; - 计时的(各段 µs)⇒ ±5%,且只在噪声地板以上生效,地板 30µs。 地板不是猜的:同一份代码连跑三次,N=1000 的 update 在 1.0~1.8µs 之间(抖 80%)、build 在 16~34µs 之间。脚本现在自己量本机噪声(3 次采样按 (N,字段) 分组取最大偏差),再把阈值放宽到 max(5%, 噪声×1.5) 并打印理由 —— 本机实测噪声 9~20%,阈值因此落在 14~29%。第一版把不同 N 混成一个池子算噪声,得出 83550%(阈值放宽到 12 万 %,等于把判据关掉),这个错留在脚本注释里当反面教材。 进 CI 后第一次就假红,于是加了「多次采样取最小值」:✗ N=10000 ecs_submit_us:66.5 → 73.8 µs(+10.9%,阈 9%)。同一棵树紧接着连跑三次是 70.7 / 68.8 / 70.9 —— 那次 73.8 是别的东西正在编。均值会被这种污染拖上去,最小值不会(微基准要的是「最快能多快」,干扰只会让它变慢)。现在每个 (N,字段) 取 3 次采样的 min 再比,噪声仍按极差算;确定性量(批次数/顶点/索引)顺手核「两次跑出来对不对得上」,对不上按比性能回归更严重处理——那说明测量本身不可信。 ⚠ 说清楚这条判据的真实力气(改了两轮,两次都是被它自己拦下来的):第一版单次采样直接比,进 CI 就假红(ecs_submit 66.5 → 73.8,同树连跑三次是 70.7/68.8/70.9,那次是别的东西在编)⇒ 改成每个 (N,字段) 取 3 次采样的最小值;改完第二次又假红,这次红在对象侧(oop_submit 53.5 → 61.4,代码一行没动)。两次红幅度 10.9% / 14.8%、两侧轮流越线 ⇒ 这就是这台机器 µs 级跨会话漂移的地板。于是阈值分两档:提示档 ±5%(S3-9 的字面要求,只打 · 行让人看见漂移在累积)、判红档 max(20%, 噪声中位数×1.5) 封顶 100%(20% 是量出来的下限,不是拍的)。噪声本身也改过一次:第二版取最大值,一个离群采样就把判红档撑到 298%(和第一版那个 83550% 同一个病 —— 一个样本能取消整条判据)⇒ 改用中位数并封顶。现在 32 项时间量里只有 6 项在地板以上,真正和机器无关、每天都在替我们守着的是结构那半边(精确相等)。不要因为某次数值好看就把下限调回 5%:那会在下一次机器忙时假红,而假红训练人忽略红。 要量的只打印:主机侧 1000 精灵提交 8.8µs(画家顺序)对 16.3µs(批优先)。真机由 run-perf.sh 手工跑:1000 批 p95 31.7ms vs 3 批 p95 0.2ms —— 差的全在驱动里,主机侧(NullBackend)不存在这部分,所以这个数字只能在真机上看。 「时间切片」这条换了实现,不是没做:DoD 写「单个系统超 2ms 时跨帧续跑」,而我们用 Ctx::yield_rest 让系统自己举手 —— 按时钟切片会让「跑到哪」变成机器速度的函数,同一份重放录像在快慢机器上走不同分支。 还差的:「微信开发者工具内 ≥30fps」。它和 S3-8 同一个堵点(开发者工具未登录,CI 里那条一直是 ! 降级)。本机没有第二台设备可替代,所以这句话现在没有证据,不写成完成。 A3 侧这一轮做到哪(2026-10-26 由 tasks 退回 wip): 我把它记成过「完成」,复核时按 DoD 逐条对,最后一条我自己写的就是「只差一根真手指」——那就是没达 DoD,所以退回来。做过的部分如实留在下面。 它测什么,以及它测不到什么。三阶段全部 CPU 侧:parse(构建期一次)、compile(五个 pass)、batch(Batcher::build,运行时每帧);四个结构量:绘制条数、纹理数、批次数、顶点数。不测 GPU 帧时间——宿主机没有真 GL 上下文,板上 S3 的「1000 sprite @60fps、p95 ≤16ms」必须在 Mac Chrome 与真机上量。把两者混报,等于用「我没测 GPU」换一个更好看的结论。 进门的是结构量,不是时间。批次数是结构量:1000 精灵 / 4 张图 / 同层,合批对了必然是 4 批,排序坏了是 1000 批——在 Mac、CI 容器、Windows 上都一样,所以 --assert-batches 8 能当门(exit 3)。时间是机器量:CI 容器与开发机差一倍是常态,拿它当门会每次红一遍,而一条会被忽略的报警比没有报警更糟——它还在报告里占一个「已检查」的位置。所以时间超阈值默认只 Warn,--strict 才升级成失败。 时间阈值有三条限定,每一条都是被实测打出来的:① debug 构建下不比时间——同一个 debug 二进制连跑两次,10 精灵场景的 compile 从 148µs 跳到 264µs(+77%);② 基线跨构建档位不比时间——基线里记 profile,不一致就只比结构量(ME-BENCH-010),否则比出来的是「我换了个构建」;③ 相对 5% 且绝对 ≥20µs——batch 在 1000 精灵上才 100µs,5% 是 5µs,而空跑抖动就有 5–20µs,实测出现过 0.001ms → 0.001ms 报「慢 8.3%」。 基线只读、--emit 只写,故意分开。合成「有就比、没有就建」会让 CI 在第一次跑时安静地改掉一个进版本库的文件——基线被谁改的必须是一次显式动作。格式 me.bench.v1,一行一条:可 diff 是它存在的理由(与 me pack 的账本同源)。 顺带量出一个真缺陷(D-04,2026-10-26 晚已消)。5 份规模(10/100/200/500/1000)量出 compile 在 release 下 0.016 → 0.428 → 38.9ms:100→1000 是 10 倍数据 91 倍时间。逐 pass 计时(run_through 累计差,1000 节点):check 104ms · budget 再 +173ms,而 lower 只有约 6ms、parse 线性。一处已定位的嫌疑是 Ctx::op_of 用 self.ops.iter().find(...)——每个节点一次线性扫描,2000 节点就是 4M 次字符串比较。me-compiler 是 A1 扇区,按规矩只报备不改。 后记(2026-10-26 晚):这条按它报的嫌疑只改 op_of 只降 11%;自己采样后真凶在 me-mir::check_parent_budgets(占 55%)+ budget.rs 账本层 + check_cycles,四处同改才 102.7→10.6ms(1000 节点)。照别人给的定位改、改完确有改善,是「改对了」最像的假证据。 判据 10 条(crates/me-cli/tests/bench.rs,走真进程)。最强的一条是「批次数恰好等于纹理数」而不是「≤8」:4 张图同层时,画家顺序下同图必然连续,多一批就说明同图的精灵没排在一起——而那种错在画面上是「东西都画出来了,只是慢」,没有任何一步会报错。 这一轮把「真机那三条为什么没跑」查实了(2026-10-27)。 PERF / SHOT / SWITCH 三项 NO-CHROME 降级,原来的理由是「没装 Chrome」——不准确。本机确实没有 GUI Chrome,但 Playwright 缓存里有两份 Chromium(130 与 149),--version 都正常,而 --dump-dom about:blank 静默挂住:stdout / stderr 各 0 字节、20 秒不返回;换 --screenshot / --print-to-pdf / 老写法 --headless 一样;去掉 swiftshader 变 133(SIGTRAP);脱离沙箱再跑一遍一模一样。⇒ 只查 -x、或只查 --version 的闸会把它放过去,然后三项从「降级(会说这步没真验)」变成「判据红(说你代码错了)」,最坏是 CI 永远跑不完。所以闸改成「真的画一次」(tools/find-chrome.sh --require:--dump-dom 20 秒内返回且输出里有 <html)。这条 DoD 不因此变虚:「1000 sprite 批次数 ≤8」的真值判据在 host 侧(me_render::wasm_perf 的 7 条断言,CI 里会红),浏览器那一步只多回答「在真 GL 上也一样」。缺的一直是「真 GL」,不是「批次数」。

目标:让场景"有声音、能切换、不白屏",并把 SfxForge 接到运行时。

  • A2轻量混音器:16 通道、总线、距离衰减、单声道定位4 人日轻量混音器:多通道、总线、距离衰减、单声道定位;增益与空间化分模块。
  • A2wasm DSP 最小集:噪声/滤波/包络/混响(复用 SfxForge 配方)5 人日
    运行时 vs 烘焙期的边界必须写在代码里,否则「复用 SfxForge 配方」会变成「另写一套」。展开 1060 字
    运行时 vs 烘焙期的边界必须写在代码里,否则「复用 SfxForge 配方」会变成「另写一套」。tools/sfx/dsp.py 是烘焙期参考实现(numpy/scipy,32 资产就是它渲染的),这里是同一套基元的 Rust 版,好在 wasm 里现算(主包 4MB,20 秒 48kHz 立体声未压缩就 3.8MB ⇒ 配方进包、波形现算是唯一路子)。三个不得不分岔的地方,都是被运行时约束逼的:① 时变滤波 —— Python 用 STFT 幅度掩码(要整段信号 + 2048 点 FFT 的延迟),这里用 biquad 且只在块边界(64 样本)换系数;Python 那句「二阶 IIR 系数随时间变化会炸相位」的真正原因是逐样本重算系数,不是 IIR 本身;② 粉红噪声 —— Python 频域 1/sqrt(f),这里 Kellet 七极点(零延迟、7 个状态);③ 混响 —— Python 合成 IR + FFT 卷积(要一次性看到整段),这里 Schroeder 4 梳状 + 2 全通(逐样本递推,内存与延迟固定)。不承诺跨语言逐字节一致(numpy 随机流与 FFT 实现不同),承诺的是「同一目标、同一构建,两次运行逐字节一致」——那才是回归手段需要的性质。随机数自带 xoshiro256++,不用 rand crate(那个不承诺跨版本序列不变)。3 条单元 + 16 条行为判据:噪声测谱形关系(棕低频占比 > 粉 > 白,与算法无关)、滤波器测频响(截止处 -3dB / Nyquist 压下去)而不是复述系数、混响测 RT60 衰减、包络测 1/e 点与端点、整条配方端到端两次逐字节一致。6 条负向验证全红在靶上:biquad 反馈符号反 ⇒ 通带 0.0043(几乎全灭)、粉红退化成白噪 ⇒ 0.0969 vs 0.0968(两者几乎相同,说明判据精确抓到了)、混响反馈归零、包络去掉 attack、扫频只换一次系数。⚠️ 写判据时踩了三个自己的错误假设(都留在注释里):attack 末尾不是 1.0(指数在 192 个样本里已经掉了 8%)、去趋势 ≠ 零均值(布朗在 0.5 秒里只走一两个周期)、扫频折线 0.5 秒才降到底则后四分之一处截止还有 4.5kHz。env_ar 的端点改成与 np.linspace 同语义(端点落在 0/1 上),差一格会让衰减尾巴永远收不到 0。
  • A2音频管线:配方 → 烘焙 ogg 或运行时合成(按包体预算自动选)3 人日
  • A2场景音景:分层音床 + 随机变体调度3 人日
  • A2资源系统:AssetHandle、引用计数、按分包粒度整体卸载5 人日资源系统:AssetHandle + 引用计数 + 按分包粒度整体卸载,卸载语义有测试钉住。
  • A2流式加载:占位资产 → 渐进精化 + 相邻分包预下载5 人日流式加载:占位资产 → 渐进精化,相邻分包预下载;同步读语义与异步加载的矛盾在契约层写明,不靠上层猜。
  • A3微信 PAL:FS、网络、分包加载 API4 人日微信 PAL:FS、网络、存储、分包加载、账号、时钟分文件实现,导入面有 ABI 断言守着。
  • A2场景切换:无白屏(<300ms,含资源预热)3 人日
    S4-8 的 DoD 是「切换 <300ms,无白屏」,这两句必须分开证。展开 1125 字
    S4-8 的 DoD 是「切换 <300ms,无白屏」,这两句必须分开证。无白屏在渲染层修不掉:一帧画不出东西只有一个原因——屏上那个场景的资源不全,而「没资源就画个底色」正是白屏本身。所以修法是不让「资源不全的场景」成为屏上那个场景:冷启动画占位、切换期间 hold 住旧场景、换之前预热。判据逐帧问 on_screen_is_drawable,比截图可靠(16ms 的白屏人眼抓不到,而「某一帧空了」恰恰是最常见的错法)。300ms 只测一头毫无意义:配额调到 8 什么场景都瞬间齐,所以写成同参数下的冷热对比——冷切换 19 帧 = 316.7ms(必须超;它不超就说明平台参数把预热的用处抹掉了,判据自己会红并提示降配额),预热到位后 0 帧。预热不是免费的:24 个资源 / 每帧 2 个 = 12 帧发请求 + 8 帧延迟 ⇒ 要提前 20 帧(333ms)开始预热,这个数字是给内容侧(何时触发预下载)与 A3(分包调度)用的;预热过半(6 帧)就切仍只要 13 帧 = 216.7ms。预热必须 pin:预热的资源正好是「最久没用」的那批,不 pin 就在下一次内存压力下被 LRU 挑走,收益归零(有对照组:同参数下不 pin 的 AssetId(0) 当场被淘汰)。落地后旧场景必须变成可淘汰的,否则每切一次内存涨一份(判据:切换前腾出 0 字节、切换后腾出 12MB)。⚠️ 负向验证抓出我自己写的一条死规则:原本有「降级要等 30 帧」,把它改成 0 判据全绿——说明没有任何判据钉住它。原因是 drive 每 tick 立刻重发,Failed 在一个 tick 内就变回 Requested,「一失败就降级」在这套实现里根本发生不了。真正该兜的是另一件事:平台什么都不回(complete 没触发),状态永远是 Requested,「所有未就绪资源都失败」永远不成立 ⇒ 游戏永远停在旧场景上,玩家以为卡死,而日志里没有任何错误。改成 MAX_SWITCH_FRAMES=90(1.5 秒)超时兜底,黑洞用例 91 帧落地。5 条负向验证:删 holding ⇒ 第 0 帧就换屏;删 pin ⇒ AssetId(0) 被淘汰;删超时兜底 ⇒ 切换永远不落地;删空场景守卫 ⇒ 空场景被判成画得出来([].all() 返回 true 会骗过所有逐帧检查);配额 2→8 ⇒ 冷切换只 166.7ms,判据自己报「证明不了预热的意义」。已知缺口:COIN RUN 的关卡是 include_str! 数据、零 IO ⇒ 走不到这条路径,这条链路目前只有判据在跑。
  • A2音频 CPU 预算测量(16 通道同时播放)2 人日
    16 通道满载的结构量 + 本机耗时。这条 DoD 有一半不在本 crate 里:me-audio 每帧算的是每个语音的左右增益、声像、该不该被抢占,产出 MixCommand;展开 1418 字
    16 通道满载的结构量 + 本机耗时。这条 DoD 有一半不在本 crate 里:me-audio 每帧算的是每个语音的左右增益、声像、该不该被抢占,产出 MixCommand;PCM 采样叠加在平台侧混音器里(wx.createWebAudioContext)。所以判据分两截:① 结构门——满载 16 条指令且句柄两两不同、池满两分支(更不重要被拒 / 更重要抢走一个)、指令缓冲 100 帧同一地址(零分配)、600 帧零漂移;这四条在 debug 下也跑,是主门。② 时间测量只在 release 下编译(同一 debug 二进制两次跑差 77%,S2-9 实测),报的是「这一层还剩多少余量」,不是「整条音频链达标」。实测 16 通道 142 ns/帧 ≈ 1.5ms 预算的 0.009%,每通道 8.9ns;4→16 通道 36→133 ns,是线性的。所以参数计算不是瓶颈——1.5ms 这个阈值对任何合理实现都不构成约束,真正的成本在平台侧每帧每通道 800 采样的叠加与解码,那个数字只能真机取,宿主上无法替它测。 2026-10-26 合并 origin/main:这条两边各做了一遍,两份证据都在树上,都留着。 谁主谁辅、要不要只留一份,等 A1 定(已报备)。 main 侧记的是: DoD 写「16 通道同时播放,混音 CPU <1.5ms/帧」,但本工程的混音器不混 PCM(它算参数,采样叠加交给平台)⇒ 判据必须先说清测的是哪一层,否则那条 DoD 是一句没人能复核的口号。实测:tick 19ns / commands 105ns / 合计 122ns,16 个位置音源(含整数开方)432ns —— 只占 1.5ms 的 0.01%,其余 99.99% 在平台侧。这个结论比数字本身重要:它说明「混音会不会爆预算」的风险不在我们能改的那部分,也说明 1.5ms 这道门永远抓不到回归(涨 80 倍照样绿),所以另设一道 2μs 的紧门(16 倍余量,抓加锁/O(n²)/无谓计算;分配那一类由 commands_reuses_its_buffer 的指针判据单独钉住)。5 条判据:合计 + tick/commands 分开报(合计会被平均掉,commands 涨 3 倍而 tick 降下来照样绿)、16 个位置音源单列(isqrt 是牛顿迭代,全居中的那条绿了推不出它绿)、前提判据逐帧查池子满、缓冲指针稳定、位置音源只收单声道。⚠️ 负向验证当场抓出一个假判据:第一版语音只设 looping(),而 tick 的过期条件是 !looping && duration_ms > 0,duration_ms 默认 0 本来就不止期 ⇒ 把 looping() 删掉判据照样绿。改成 with_duration(3_000) + looping() 两个都设,删任何一个或删 looping 都会在第 188 帧红(控制实验:只删 duration 仍然绿,证明「必须两个都设」不是编的)。三条负向验证:删 looping ⇒ 第 188 帧剩 0 个语音;commands() 每次新建缓冲 ⇒ 第 0 帧地址就变了;帧路径塞 1 万次加法 ⇒ 125→2287ns 撞穿 2μs 门。

目标:AI 第一次能产出可编译、可 review、可回滚的 MIR。

  • A1Agent 运行时骨架:Intent → Task DAG → 执行器(可中断/重试)4 人日
    执行器落地了,而且它是个状态机不是线程池。(2026-10-26) crates/me-agent/src/exec.rs:Plan::new 构造即定序(算出 waves 并查环),Exec…展开 506 字
    执行器落地了,而且它是个状态机不是线程池。(2026-10-26) crates/me-agent/src/exec.rs:Plan::new 构造即定序(算出 waves 并查环),Executor 由调用方驱动(next → 干活 → succeed/fail)。三处取舍都写进了模块抬头: - 顺序按 id 升序,不按「谁先就绪」:no_std 下没有线程,但更主要的是可重放 —— 哈希表迭代顺序会随一次重构变,而没有任何测试会因此变红。 - 失败传播是递归的:上游失败 ⇒ 下游标 Skipped,不是留在 Pending(后者会让 is_finished() 永远假,界面上画一个转不完的圈)。 - 取消只动还没开始的:正在 Running 的那条结果照收 —— 取消不撤已经做完的事。 10 条判据(crates/me-agent/tests/agent_loop.rs)。其中两条演练过会红:把取任务改成 .rev() ⇒ 顺序那两条变红;把递归跳过改成只跳一层 ⇒ 「下游是跳过而不是一直等」变红。
  • A1Planner:意图 → 任务分解(prompt 模板带预算约束)4 人日
    确定性的一半落地,另一半卡在「意图 → 语义」。(2026-10-26) 已落地(crates/me-agent/src/plan.rs):意图 → 任务图的规则表(3 条规则 + 1 条兜底…展开 8856 字
    确定性的一半落地,另一半卡在「意图 → 语义」。(2026-10-26) 已落地(crates/me-agent/src/plan.rs):意图 → 任务图的规则表(3 条规则 + 1 条兜底),以及带预算数字的 prompt 模板。判据三条:同一意图两次分解逐字段相同(这是 S5-9 的地基)、不同意图走不同规则、prompt 里的数字是从 Budget 参数算出来的(控制实验:只改 tri,模板里只有那一处变)。 没落地的是「意图 → 语义」那一步,但它的两个前置在 2026-10-26 都不在原处了:① 模型通道有了(crates/me-studio/src/llm.rs,/api/ask 打一次 OpenAI 兼容请求、没配就说没配;它刻意不在 me-agent —— 那里 no_std,而执行器要可重放);② 录制回放载体有了(S5-5 的 .patch 文本文件:--no-ai 要的逐字节一致,录下来的就是 patch 本身,不需要另建格式)。S5-3 已于 2026-10-26 落地(decode.rs + POST /api/patch,见 S5-3 条目),所以这一条现在缺的不是解码,而是接起来:任务图那半仍是规则表,语义那半已经能产出 patch,但两者之间还差一次转换 —— 执行器吃的是 Command,decode 产出的是Patch(一串 Op),而 Op → Command 这一步现在藏在 patch.rs 私有的 run 里 —— 但后半句「没有对外的路」在 2026-10-27 复核时已经过期:同一轮 S5-7 落地的 Editor::apply_patch(&Patch) 就是那条路(/api/apply 走的正是它,tests/apply_undo.rs 有 5 条判据钉着),而且它收的是 Patch、不是 Command。当初写的「真要做的是让执行器直接吃 Patch」,随后的接线证明恰恰做不到(依赖方向决定,见下面那条追加)。 在那之前仍然明确兜底:没命中就把 fallback:true 写进 Note,界面上直接显示「按兜底走」—— 静默给一条貌似合理的链,是这一层最容易犯的错。 2026-10-27 追加:接线落地了 —— 而且上一版那句「让执行器直接吃 Patch」本身是错的。 crates/me-studio/src/agent_run.rs(新,416 行)+ tests/agent_run.rs(11 条判据):一条意图 → 任务图 → 每步一份录制 → 一份文档,全落地或一个字节不动。 先纠一条判断。「真要做的是让执行器直接吃 Patch」做不到,而原因不是懒:me-studio 依赖 me-agent(Cargo.toml 摆着),所以 me-agent 里的函数在类型上收不下 me_studio::patch::Patch。反过来把 Patch 挪进 me-agent 也不行 —— Op::prepare 要把路径解析成 NodeId、要向文档领 id、要造 Command,等于把 Doc/Command/Value(约 3700 行)搬进 L7,而 L7 的抬头写的是「Agent 不许直接改文件」。接线的位置由依赖方向决定,不由「谁更像主角」决定:驱动住在 L8,两边谁都不必知道对方存在。 四条判据是这一层的全部价值,三条演练过会红: - 原子范围是一条意图,不是一份 patch —— 第 2 步冲突时第 1 步要逆序退回,文档与进来时逐字节相同(去掉退回那段 ⇒ 红)。 - 缺录制是红,不是跳过也不是空成功(改成 succeed ⇒ 三条红)。 - 确定性失败只试一次 —— 缺的东西不会因为再跑一遍而长出来(改成 fail ⇒ 两条红)。 - 0 处 ≠ 没跑 —— Applied{ops, changed} 两个数分开记;重放已应用的录制时 ops 不动而 changed 归零。 顺带给执行器补了第三种结账口令 abandon(Retry::Hopeless):fail 说「也许再试」、abandon 说「再试也一样」。这一条反查出一个原有缺陷:工作台的试跑对同一份 text 反复调 Guardian,用 fail 让它显示「第 1 次,重试」—— 那份 text 一个字节没变,所以「下一次可能过」恒假。改成 abandon 后屏幕写「放弃(再试也一样)」,tests/workbench.rs 的断言从 "again":true 翻成 "retry":"hopeless",workbench.js 的日志行跟着改成三种放弃三句话。 2026-10-27 补:① 有入口了 —— 挂在 me-studio-replay 上,不是新开一个 bin。 同一句命令,第二个参数是文件就重放一份 .patch,是目录就跑一条意图(<任务名>.patch + --intent)。用路径区分粒度而不是加开关:录制的粒度就是一次重放的粒度,多一个开关只会多出「开关说目录、路径是文件」这种组合要报错。 me-studio-replay 场景.mir 录制目录 --intent "做一套金币拾取" > 出.mir 7 条新判据(tests/replay.rs 共 14 条):两跑逐字节相同 / 缺一步就红且 stdout 一个字节不打印 / 空目录是「没录」不是「空意图」(exit 2,不是 1)/ 目录模式不许带 --check-base(每份 patch 的 base 是在那一步之前的文档上写的,逐条比「现在的文档」必然对不上)/ 文件模式给了 --intent 是用法错 / --intent 在结尾说清楚(否则会走兜底链,症状像「录制坏了」)。演练过:把「失败也往下打印」放开 ⇒ 缺一步那条红。 仍然缺的是 ②「录制从哪来」:今天录制是人写的(或测试里构造的)。模型那半边(POST /api/patch → decode)产出的是一条意图一份 patch,而任务图要每步一份 —— 中间那一步(prompt 要带上步名、按步调模型、把 N 份攒成一份录制)没做。所以「AI 自己录一份」这条路今天不存在;能跑的是「人录一遍、机器重放 N 遍」。这一句写在这里,是为了不让下一个人把「--intent 能跑」读成「模型那半边通了」。 2026-10-27 再补:② 录制从哪来 —— 有了。而且是新开一个 bin,不是给 replay 加 --record。 agent_run::record() 按任务图逐步问模型、在副本上推进、把 N 份 patch 攒成一份 Recording;Recording::save() 落盘成 <任务名>.patch;入口 crates/me-studio/src/bin/me-studio-record.rs。 为什么不给 me-studio-replay 加一个 --record:那条命令抬头第一句是「不用模型」,而它的全部价值就在这里(CI、没网的机器、模型版本变了只剩复盘的那天)。加了之后那句话变成有条件真,同一个 --intent 还要担两种语义(目录模式下「用来分解任务图」/加了 --record 后「用来问模型」)。一面旗子两种意思,读命令的人分不出自己触发的是哪一种。所以拆两个 bin,共用 agent_run 这一层。 判据(tests/agent_run.rs 现 20 条,新增 9 条): - 按步问模型_攒出的录制能重放 —— 假模型(Script)按剧本答三份,攒成录制,立刻喂回同一条重放路径,文档要真的变。 - 每一步的问句里带着那一步的名字 —— 这条是「按步」与「把整条意图问三遍」的唯一区别。演练过:把 step_intent_of 改成原样返回意图,只有这一条红,而「录成了、能重放」那条照样绿 —— 说明只判「录成了」等于没判。 - 模型答不出来就停在那一步_而且整份录制不返回 / 某一步的_patch_落不了地就不进录制 —— 半份录制比没有更糟(它会重放出「前两步对、后面缺」的文档,而那份看起来是完整的)。 - 落盘 5 条:往返一致 / 默认不覆盖且旧文件逐字节不变 / 说了覆盖才覆盖 / 任务名带路径就不写且连目录都不建 / 有一份撞上就一份都不写。 两次演练都红在预期的地方:把 create_dir_all 提到名字检查之前 ⇒ 名字那条红(断言的是 !dir.exists());去掉冲突预检查 ⇒ 覆盖那两条红(fs::rename 会把旧文件盖掉)。顺带把 save 抬头里那句「否则前 2 个已经落盘」订正了 —— tmp+rename 本来就不留半份 .patch,这两道检查防的不是同一件事。 record 顺手把 Note 交了出来:走兜底链时任务图仍有三步、录制仍攒得出、重放仍「成功」,只是每份 patch 都是空的。不把 fallback 传出去,用户拿到的是一份「看着录成了」的空录制 —— 所以 me-studio-record 见到兜底会把这句话打出来。 未验的一条:真模型端到端。本机没配(~/.config/magic-engine/agent.env 不存在),只跑到了 exit 2「模型没配」那条分支。判据全部落在假模型上,不是因为它更省事 —— 真模型要网络、要额度、要版本没变,三件都不归我们管,拿它当判据会把「机器配好了没」混进「代码对不对」。 仍然缺的是 ③:录制没记「它是在哪份文档上录的」。文件模式有 base 指纹(--check-base),目录模式下每步的 base 各不相同,于是整条意图进来时那一版的指纹没人记 —— 换一份文档重放不会报错,只会「应用到了错的地方」。 2026-10-27 三补:③ 录制记下「它是在哪份文档上录的」—— 顺带订正上一笔的一个结论。 上一笔写着「目录模式不支持 --check-base:每份 patch 的 base 是在那一步之前的文档上写的,逐条比「现在的文档」必然对不上」。那个理由没错,结论错了:限制的正解不是「不许」,而是记一个整体的 —— 整条意图在开始之前只有一份文档,它的指纹是确定的。 所以录制目录里多了一份清单 me.recording.v1(一行格式,与 .patch 同一个风格): me.recording.v1 base 3f2a… - record() 记的是进来时那一份的指纹(不是逐步推进后的 scratch —— 重放要比的正是「开始之前」)。 - 清单不存在是正常的(人手写的录制、上一版工具留的目录),此时 base() 是 None;清单存在但读不动要报错。这是「空值与缺失必须分开」的那条:静默当成「没记出处」会让 --check-base 在无人察觉时失效。 - --check-base 在目录模式下现在真的会用,而且比逐条比更准:它回答的是「这条录制是在这份文档上录的吗」。 - 录制没记出处时给了 --check-base,会明说这一道闸没生效,不静默通过 —— 进不去的分支不是保险。 - 清单读坏了退出码是 1(内容错)不是 2(环境错):路径不在改命令行改不好,读不懂重录一次能修好,混成一个码上层就只能一律当「环境没配」。 判据:tests/replay.rs 14 → 18(原来那条「不支持 --check-base」翻成四条:闸没生效要说 / 对不上要拦且 stdout 为空 / 对得上要放(没有这条,「一律拒绝」也能让前两条绿)/ 不给 --check-base 只提醒),另加清单坏了的退出码一条;tests/agent_run.rs 20 → 25(记、写、读、缺失、坏);新增 tests/record_cli.rs 5 条(参数个数 / --intent 结尾 / 空意图 / 不认识的选项 / 没配模型是 exit 2 且一个文件都不建)。 演练三次,都只红预期的那条:删掉「拒绝」那支 ⇒ 「出处对不上就是拒绝」红;删掉「闸没生效」那句 ⇒ 「没记出处时明说闸没生效」红;在问模型之前先 create_dir_all ⇒ 「一个文件都不建」红。 「没配模型」那条能稳定造出来,靠的是把 HOME 指到空目录 + 摘掉三个环境变量 —— 判据不许依赖这台机器配没配过模型。 2026-10-27 四补:④ 线上入口有了 —— 一条意图一次落地、一次 Ctrl+Z。 Editor::apply_intent(intent, rec) + POST /api/act?act=intent。一条意图 → 一串录制 → 一次落地、一次 Ctrl+Z。 难点不在「多调几次」,在回滚有几个执行者。agent_run 那一层已经有一套逆命令栈(Receipt 的 inverse),History 有另一套(cancel_batch)。两边各退一次的症状不是报错,是「一次失败的运行之后文档往回退了两步」—— 而人只会觉得「它把别的东西也改了」。 解法不是加一个 bool,是加一个枚举 Rollback::{Own, Caller}(pub(crate))——与 Patch::apply_with / apply_via 同一个取舍:布尔在调用点读作 true/false,而这两个词不回答「谁负责收尾」。 两支不是同一种回滚换个说法: - Own 走 p.apply(单份内部 Unwind),因为这一步已落地的那几条不在 done 里(done 只在成功时 extend)—— 只靠最外层逆序跑,这几条会留下。 - Caller 走 p.apply_via(停在半路),因为那边每一条都进了撤销栈的批,cancel_batch 会把它们连同前面几步一起退回。 顺带把措辞收拢了:me-studio-replay 里那份「这一步为什么没落地」的 why() 挪进 agent_run::explain(),终端清单与界面回执共用一份 —— 两处各写一遍的话,「缺录制」在终端会说「把 .patch 放进目录」、在界面上说「录制缺失」,而人只会记住其中一个(一般是没用的那个)。 录制从哪来(交互场景):act=intent 的 rec 参数可选 —— 给了目录就读(不联网),没给就现问模型录一份(要网络、要额度)。两条路的分界不是「方便」而是「谁在花钱」,所以「没配模型」回 llm.unconfigured 而不是 request.bad:前端据此显示「去配一下」,而重试一百次也不会变。 失败时不动 revision:apply_intent 已经把文档整条退回去了,此时动版本号会让前端重画一屏没变的画面,并让用户下一次操作收到一条与他自己无关的「你过期了」。 判据:tests/intent_undo.rs 3 条(库层,字节级)+ tests/serve.rs 4 条(协议层,版本号与撤销栈)。演练两次:把 Caller 改成 Own ⇒ 命令根本不进历史,「一次撤销」与「dirty」两条红(这才是「一次撤销」这条判据的牙齿 —— 它钉的是「必须走 apply_via 注入 history」);失败时不 cancel_batch ⇒ 「整条退回去」红。 2026-10-27 五补:按钮落地了 —— 这条 WIP 的最后一块。 apps/studio/web/workbench.{html,css,js} 多了第四颗按钮「落地」+ 一格录制目录(留空=现问模型,填目录=读本地录制不联网)。前三颗问的是「分解得对不对」「它想改什么」,这一颗问「照这句话改下去,文档变成什么样」—— 三颗而不是一颗带开关,因为开关在调用点读作 true/false,而这两个词不回答「这一次会不会动文件」。 空目录不发 rec 而不是发空串:rec= 在服务端是「给了参数」,会被读成一个叫 "" 的路径,于是「明明留空却报读不到录制」。失败时按码指路(llm.unconfigured ⇒ 指到那格录制目录),不是只说一句「失败」。 行为判据 11 → 15(apps/studio/web/verify-apply.js,真浏览器):① 没配模型又没给目录 ⇒ 指路且一个字节都没改(这台机器配了模型时它明说跳过,不静默绿);② 给目录 ⇒ 真的改了 3 格(三份录制的 was 从当前文档里读,不写死 —— 写死的话判据会随用例顺序变红,而那种红看着像「落地坏了」);③ Ctrl+Z 一步退回整条(逐字节)。 演练过会红两条:把 Editor::apply_intent 的 begin_batch 去掉 ⇒「一次退回整条」红(14/15,差的正是撤销栈里那三步);把 err.code === 'llm.unconfigured' 改成别的码 ⇒「指路」红。 顺带把两处写死的条数去掉了(ci.sh 的步骤标题、run-workbench.sh 的总结句):加第 12 条的那天它会开始撒谎,而它撒的正是「有几条在守」。现在 sh 从脚本最后那行 N/M 通过 里读。 2026-11-04 收口:那半也落地了。 任务图现在由模型给,规则表降级成兜底。me-agent/src/graph.rs 定格式 me.plan.v1(十条校验 + 编码),plan::decompose_with 把「图 / 说明 / 拒绝理由」三件一起交出来,record() 先问一句「怎么分几步」再逐步问 patch。确定性不再靠「名字是常量」,改由录制记图兜:录制目录里多一份 me.plan.v1,重放读它、不重新分解。判据 me-agent/tests/graph.rs 29 条(其中 5 条钉「重试次数进格式」,见本节末)、me-studio/tests/agent_run.rs 28 条(新增 3 条钉「记图 / 用图 / 坏图退回」)。 2026-11-04 补:max_tries 一直没进格式 —— 而它被写成了「往返逐字段相同」。 graph::encode 只写 step <id> <名字> [after …],parse 一律填 2,于是「往返逐字段相同」只对 max_tries == 2 的图成立;而当时唯一的往返判据喂的正是规则表产出的图(全是 2),还顺手断言了「全是 2」—— 判据只喂自己爱吃的输入,绿的就不是那条性质,是那个巧合。max_tries 是任务图的属性(exec::Task 原话),而录制是「这份产物能原样再出现一次」的唯一凭据 ⇒ 一张 tries 1 的图录进去、重放出来变成 2,不报错,只多一次模型调用(那是钱)。 三处落法:① 格式尾部加 tries <次数>,encode 每次都写(漏写等于让「没记」与「记的是 2」共用一种形状,默认值一改老录制就换了个意思);② tries 0 单独一个 Reject::BadTries —— 那一行成形了,说它「不成形」会把人引去查词法,而真正要改的只是那个数字;③ 那个 2 原先有三个出口(Task::after / 规则表 / graph::parse),收成 exec::DEFAULT_TRIES。 五条演练各自只红预期那条:encode 不写 tries ⇒ 往返那条红;缺省读成 1 ⇒ 两条红;放过 tries 0 ⇒ BadTries 那条红;重复键后写覆盖 ⇒ 重复键那条红;要求 after 必须在前 ⇒ 顺序那条红(连带 4 条 encode 往返,因为 tries 会出现在行首)。 仍然没验的一条是真模型端到端:本机没配通道,只跑到 exit 2「模型没配」那支 —— 理由与当初相同(真模型要网络、要额度、要版本没变,三件都不归我们管)。
  • A1Builder:MIR patch 生成(schema 约束解码,不允许自由文本)5 人日
    约束是真的,只是落实处不是 JSON Schema。展开 1611 字
    约束是真的,只是落实处不是 JSON Schema。(2026-10-26) crates/me-studio/src/decode.rs:意图 + 文档 → 一份已补全、已逐条试跑的 patch。12 条单测在模块内,5 条集成判据在 tests/decode.rs,5 条协议判据在 tests/patch_api.rs,接口 POST /api/patch(只解不改、不落盘,与 ADR-0009 的「build 默认不落盘」同一条规矩)。 「schema 约束解码」在这里是「唯一解析器 + 逐条试跑 + 带错误重试」。 不用 provider 侧 JSON Schema 有两个理由:① 我们是用 curl 打通用 OpenAI 兼容端点(零外部依赖是硬约束),各家对 response_format 的支持并不一致;② provider 说它符合 schema,不等于它符合我们的语义 —— 一份 schema 合法的 patch 完全可以指向不存在的节点。所以模型只有一条路能过:输出一份真能在这份文档上跑通的 patch。判据不在 prompt 的措辞里,在 Patch::seal 的返回里。 旧值不问模型,由 Patch::seal 从文档读。 这是这一层最重要的决定。模型不知道旧值;若让它抄 was,抄错的后果不是报错,而是把「模型写错了」诊断成「人刚改过」 —— 同一个 Conflict::WantMismatch,两种处境的处置方式相反(前者重问模型,后者问人要不要覆盖)。补出来的值等于「生成这一刻的值」,所以人在生成期间改了同一格,应用照样报冲突 —— 三方合并的能力没因为省略而消失,只是改由机器填。 seal 必须逐条在副本上模拟。 一条 add 之后,后面的 set 指向还不存在的节点;一次性读原始 doc 会把「在新节点上设属性」判成 NotAbsent,于是「AI 想新建一个东西」在第一步就被自己否掉。 「做不到」是一等结局,不是失败。 模型只能输出一行 refuse: <原因>,不许硬编一份假 patch —— 硬编的后果是界面显示「AI 改了 3 处」,而其中没有一处是真意图。判据把 decoded / refused / gaveup / unconfigured / unavailable 分成五个状态:refused 是模型给了答案(答案是不做),另外几个是我们没拿到答案,下一步动作完全不同。 重试必须带上一轮的错误。 不带新信息的重试只会再错一次。判据断言的是第二次请求的正文里出现第一次的错误,不是「问了几次」。 判据有效性演练过两次(都只让该红的那条红):① 把 prev_of 改成恒不补 → 集成三条红(含「静默覆盖人的改动」那条);② 把 repair_prompt 换成 first_prompt → 只有「第二轮带错误」那条红。 端到端真链路验过:本地假端点 + Studio,/api/patch 回 decoded/ops:1,而 patch 里那行是 set … = "mat_stone" was "mat_gold" —— was 是服务端从文档读出来补的(模型只写了 base -、没写 was),base 也被换成了真指纹;假端点收到了完整场景与意图,而响应里没有密钥。界面四组视口实测 0 处违规。 还没做的是应用那一步:Patch::apply 没接进 /api/act,界面上也没有「应用」按钮。S5-7 的 DoD 第 3 条(渲染前后对比)要等它。
  • A1Guardian:确定性校验器(不调模型),20 条规则4 人日
    Guardian 落地了。 这是 P0 里唯一整段空白的迭代:S0/S1 各差 1、S2 差 0、S3 差 4、S4 差 5,而 S5 的 9 条一条都没动 —— 且 S5 九条的主责全是 A…展开 2301 字
    Guardian 落地了。 这是 P0 里唯一整段空白的迭代:S0/S1 各差 1、S2 差 0、S3 差 4、S4 差 5,而 S5 的 9 条一条都没动 —— 且 S5 九条的主责全是 A(我)。文档自己写了顺序(10-p0-sprint-plan.md §7):先做 Guardian(确定性、好做),再做 Builder(难),理由是"Builder 质量不达标时 Guardian 仍然有用"。这一步不需要模型,所以先落它。 Guardian 里没有一条判定逻辑。 parse 判语法、validate 判不变量、compile 判档位与降级,Guardian 只把三段收成一次"可否提交",并给每条结论一个规则编号。这不是偷懒,是 me-agent/src/lib.rs 那条规则的另一面:两份校验器必然分叉,分叉后的表现是「Validator 说没问题,编译却失败」。所以它自己建 Ctx 跑 standard()(compile() 失败时只返回一条 Diag,其余随 Ctx 销毁 —— 而 AI 提交 patch 后最需要的正是一次报完)。 19 条规则,不是 20。 按 interface/diag.codes.md 反推能落成"一种改法"的是 19 条:ME-BIN 不进(它只在读 .mirb 字节时报,guard() 收的是文本,给它一条永远不命中的规则只会让覆盖率看起来比实际高),同一 fix 的多个码合并(LEGAL-003/004/005 都是"去给 fallback")。排班表写 20 是估值,多写一条凑数等于给自己一个 20/20 的错觉。 三档归属(Owner)而不是两档:Content(改内容,Reject)/ Compiler(ME-PASS-9xx,报 A1,Broken)/ Artifact(ME-BIN-*,重新构建)。把编译器自己的 bug 报成"你的内容有错",对方会一直改一份本来就对的。这与 cli.spec.md 里退出码按"谁能改"分档是同一条纪律。 判据是数据不是注释:① every_registered_code_has_an_owner —— 码表里每个码都必须落进三档之一,新加码忘了想"谁改"就红;② every_negative_example_is_rejected_with_its_declared_code —— 期望码从文件头注释读,不另抄一张表(me-mir/tests/negatives.rs 那份表已有三方守卫,抄第二份就会分叉);③ interface/guardian.rules.md 是生成物,check_generated.py guardian 逐字节比对,演练过会红。 反例分两个目录,因为报出的阶段决定谁能修:bad/(解析与校验期,编辑器每次按键都能报)+ bad-compile/(只有跑完整条链才报)。混在一起的后果是 me-mir/tests/negatives.rs 会红 —— 它只跑前两段。本轮新增 5 份反例(空串参数、by 前缀、caps 越权、精灵无变换、帧表缺失),把"零反例的规则"从 7 条压到 4 条,其中 G-12 由参数型测试覆盖、G-19 按定义不会有反例(要造反例得往编译链注不确定性)。 还差:G-14(降级链走不通)/ G-15(渲染 pass 序列)仍无反例 —— 试过 "requires 无 fallback"(被 check 抢先报 ME-OP-005)与 "fallback 指向自己"(T0 不需要 compute,根本不走降级),两条路都不通,得先搞清 pass 序列在 MIR 里怎么写。S5-1/2/3(骨架 / Planner / Builder)与 S5-5/6/7/8/9 未动;读 .atlas 与调模型在 me-cli 侧,不在这个 crate。 2026-11-05 追加:DoD 那句「注入 20 个坏 patch,Guardian 拦 ≥19」有判据了。 crates/me-studio/tests/bad_patches.rs(3 条):从 sprite_scene.mir 出发走生产路径(parse → seal → apply → 写回 → guard),20 条全部先应用成功再被拦,命中 G-05 / G-10 / G-16;两次反向实验都红(改错一条期望码 ⇒ 19/20 并报「码不对」;把一条的路径写错 ⇒ 报「这条没到 Guardian 面前」)。 但拦截率满、覆盖不满:patch 的词汇只有 set / unset 属性、add 节点、rm 子树,改不了 inputs / budget / provenance / requires ⇒ 19 条规则里只能碰到 3 条。这不是测试写得不够,是能力边界:要让 G-03 / G-04 / G-06 / G-08 也测得到,得先让 patch 能表达它们。另有两类(未登记算子、重名)在 seal 就被应用器拒了,因此不算进这 20 条,由单独一条测试钉着「它们到不了 Guardian」。
  • A1Patch 应用器:三方合并 + 冲突检测 + 单步回滚3 人日
    应用器落地了,而且 patch 是命令序列,不是文本 diff。展开 4362 字
    应用器落地了,而且 patch 是命令序列,不是文本 diff。(2026-10-26) crates/me-studio/src/patch.rs:.patch 文本(patch me.patch.v1 抬头 + base / label / ---,正文四条动词 set / unset / add / rm),15 条集成判据在 crates/me-studio/tests/patch.rs、8 条单测在模块内。 为什么不用统一 diff:行不是单位。MIR 里两个不同节点各有一行 x=1,形状一模一样,行级合并会把「人改了 A」和「AI 改了 B」判成同一处冲突(假冲突),也可能把两处真改动当一处(漏冲突)。真正有意义的单位是 (节点, 属性) 这一格。另外 diff 表达不了「删除 vs 修改」,而回滚要重新 diff 就等于让「撤销之后文档和原来不一样」。 三方合并靠逐格前置值,不靠 base 快照:set /n_ground material = "mat_dirt" was "mat_ground" 里的 was 就是这一格在 base 的值。应用时退化成一次 CAS —— 等于 was 就写、等于目标值就跳过(幂等,不进撤销栈)、否则报冲突。收益是 O(改动量) 而不是 O(文档):不需要保留历史文档,也不需要写 diff 引擎。 base 指纹不参与放行:16 位 FNV-1a 只给人看。拿它放行就等于让「人在别处改过一个字」否决整份 patch。判据 base_指纹过期不阻止应用 专门为这条写 —— 其余用例的 base 都是 -,所以「改成按指纹拒绝」这个错误实现只会被它抓到,我注入演练过(只有它红)。 check 与 apply 走同一个 Op::run:预检在文档副本上真跑一遍。两份实现必然分叉,而分叉的症状是「预检说没问题、一应用就报错」。代价是每次应用克隆一份文档 —— 万级节点几十 MB,但 patch 应用不是每帧的事。 原子:有冲突就一条都不落(判据比 dump() 逐字节);中途 Doc 拒绝则逆序回滚已做的,回滚也失败才报 RollbackFailed(那时候要人来救,不能假装成功)。单步回滚拿的是 Receipt(当场记下的逆),不是文档快照 —— 这就是 S5-5 说的「每一步可单独撤销,不是重新生成」。 空值与缺失必须分开在这里是 Want::{Any, Absent, Value} 三态:was -(以为这个键不存在)撞上已存在的键要报冲突,而「没写 was」是不检查。合成一态就丢掉「AI 以为没有、人刚加上」这条。 还没接界面:diff 视图(S5-7 的 DoD 第 2 条)要等 S5-3 产出真 patch;现在这份只保证「给了 patch 就能安全落地」。 --- 接上编辑器了(2026-10-26 晚):从「有个应用器」到「界面上真能按」 上面那一半只是 Patch 这个值得对 —— 它没有出口。这一半补的是出口,而出口比 入口难:Patch::apply 直接改 Doc,绕过了 History,于是**AI 改完人按 Ctrl+Z 什么都不会发生**。那不算「少一个功能」:文档已经变了、撤销栈里没有对应记录, 撤销会退掉上一件不相干的事。 三处落法: - Op::prepare 把「要执行什么」与「要不要执行」拆开。原来 Op::run 是 「解析路径与字面量 → 构造 Command → apply」一条龙;现在前半截独立成 prepare,解析仍只有一份实现。幂等(文档本来就是这样 ⇒ 不进撤销栈) 留给执行器回答 —— 只有它跑完才知道。 - Patch::apply_via 不自己回滚,apply_with 才回滚。回滚**只能有一个 执行者**:走 History 的那条路由 cancel_batch 收尾,若这里也 Unwind 一次就会退两步,而人看到的只是「它把别的东西也改了」。两个责任写成两个入口, 没合并成一个布尔参数——true/false 不回答「谁负责收尾」。 - 整份是一个 batch:Editor::apply_patch 用 begin_batch 包住, 「AI 改了 7 处」在界面上是一次 Ctrl+Z。 顺手修的一个真 bug:check_want 的注释写着「已经是目标值 ⇒ 幂等」, 代码里根本没有这一支。后果不是报错,是重放同一份 patch 报冲突: 第一遍把 3 改成 5,第二遍的 was 3 对不上这个 5,而文档已经就是要的样子。 decode 的重试、用户点两次「应用」、录制的 .patch 重跑一遍,走的都是这条路。 判据(tests/apply_api.rs,6 条):改的是那两格 / 一次撤销退回逐字节相等 / 冲突时一个字节不改且 revision 不动 / 重放是 0 处且不多一步撤销 / 缺参数说清缺哪个 / 版本过期整份重发。三条演练过会红:去掉 batch ⇒ 前两条红; 去掉「已在目标状态」早判 ⇒ 重放那条红。 ⚠️ 一条演练不出来:「失败时 cancel 而不是 commit」改成 commit 后 6 条全绿。 因为 apply_via 第一步就 check(),冲突在那里返回,batch 是空的,空事务 commit 不留行。真正需要 cancel_batch 的是「check 过了、执行中途又失败」, 那要求文档在两步之间变过 —— 单线程同一把锁下不可达。判据留着,但它钉的是 语义承诺,不是一条今天会坏的路径。 界面:workbench.js 的 patch 结果区右侧加了「应用」按钮(只在 decoded 那一支里造,另外四个结局没有可应用的东西)。/api/agent 补上 revision —— 没有它,按钮一点就回 request.bad(缺 rev),用户只看到「有个按钮不能用」。 判据取「这次取到的 rev 能直接发起一次会改文档的请求」,不是「有没有 rev 字段」: 写死 0 也能过后半句,而写死 0 正好让每次应用都被版本闸拦下。 真机实测 0 处违规(1440×900 / 1280×800 × 浅深)。这一步暴露了两件事: ① 那个按钮原来根本不在被测画面上(要点了「生成改动」才存在),四组视口全绿 而它一次没被量过 —— verify-workbench.js 现在先把它造出来再量,造不出来直接中止; ② 纵向溢出判据把「页面变长」报成 20 处违规 —— 改成判「被 overflow:hidden 祖先 裁掉」,那才是真问题,落到 fold 以下滚一下就看得到。 --- 「Ctrl+Z」现在是真的了(2026-10-27 凌晨)。 上面那段把按钮接上了,但页面上有两处 (队列空态、workbench.html 的规则文案)写着「Ctrl+Z 一次全退」,而全页没有接这个键 —— 这一屏上按下去是浏览器默认行为,等于什么都不发生。写在屏幕上但没接,比不写更糟: 用户会以为自己按错了,然后去找别的办法,而那条路根本不存在。 三处落法: - 键接在 document 上,但焦点在输入框里让位。抢走「刚打完意图、想改一个字」的 Ctrl+Z 是敌意行为;判定落在事件目标上,不落在"页面上有没有输入框"上。 Ctrl/⌘+Z 撤销,Ctrl/⌘+Shift+Z 与 Ctrl+Y 重做(e.key 按 Shift 时是大写 Z,统一转小写再比)。 - 回执不许被覆盖。原来的顺序是「先报结果,再 load() 整屏重取」,而 load() 结尾 无条件写「已更新(target)」⇒「应用了 2 处(Ctrl+Z 一步退回)」只闪几毫秒就没了。 改成 load(after):取数完再显示这次动作的结果。这是最需要回执的那个动作—— 它改的是文件。 - 标题与按钮不许各说一句相反的话。应用成功后按钮变「已应用」,而标题还写着 「· 尚未应用」。读者会相信标题(它更长、更像结论)。改成成功后一起翻。 判据换了落点:apps/studio/web/verify-apply.js(11 条,全绿,三条演练过会红)。 视觉脚本量的是「按钮好不好看」,apply_api.rs 量的是「act=patch 的契约」,中间那层 ——按下去之后这一屏会不会跟着变——原来没人管。这一层最容易出假绿灯,因为按钮自己 会变成「已应用」,看起来就是"有反应"。真正该发生的三件事逐条量,落点是 /api/mir 的 逐字节内容(文案可以改,文档不会撒谎):① 服务端文档真的变了 ② 整屏重取(判据是 首屏那个 DOM 节点被换掉了——"泳道里有东西"恒真,分辨不出重画)③ Ctrl+Z 一次退回 整份、Ctrl+Shift+Z 重做、重放同一份不加版本号。 顺手把 verify-workbench.js 里那份手抄的 DOM 副本删了:它调的是真 showPatch (普通脚本的顶层函数就是 window.showPatch)。手抄那份有两个问题,第二个更糟—— 副本会悄悄与真代码分叉("改了 showPatch 就同步这里"就是那条债的字据),而且 手搓的按钮没挂监听器,只能量颜色、点下去什么都不会发生。 两个只有跑起来才知道的坑,都写进脚本抬头了:① window.state 是 undefined (顶层 const 不挂 window,用 window.state && … 写的等待条件永远为假,症状是 "等 15 秒超时",像服务端没回数);② 页面资源是 include_str! 进二进制的—— 改了 workbench.js 不重编,服务端发的是旧那份 JS,于是"改对了也红、改错了也绿"。
  • A1Provenance:seed / model_version / recipe_hash + 一条复现命令3 人日
    在写:一半落地,另一半的结论是「现在没有可复现的对象」。 已落地(2026-10-26):seed / model / recipe 与节点级 by: 计数进账本 —— content[] 追加 g…展开 2375 字
    一半落地,另一半的结论是「现在没有可复现的对象」。 已落地(2026-10-26):seed / model / recipe 与节点级 by: 计数进账本 —— content[] 追加 generated{agent,total} 与 provenance{by,seed,model,at,recipe},cli.spec.md v5→v6,3 条断言在 crates/me-cli/tests/provenance_ledger.rs。这让 mir.schema.json 里那句 P1 标准「AI 生成关卡占比 > 50%」变成可从文件算出来的:Σgenerated.agent / Σgenerated.total(按 path 去重)。判据用的是控制实验——同一份输入只加一行 by="agent:…",agent 从 0 变 1 而 total 一位不动。 没落地的是「一条复现命令」,而且不是没做,是不存在可复现的对象:2026-10-27 复核推翻了这句的前提 —— S5-3 已于 2026-10-26 落地(crates/me-studio/src/decode.rs + POST /api/patch:意图 + 文档 → 一份已补全、已逐条试跑的 patch),生成器有了。但 me gen --seed … --recipe … 仍然不写,理由比原来硬:那一步是一次模型调用,输出不可逐字节复现 —— seed 能进本地规则与模板,进不了远端采样。所以复现只能靠录下来重放,而录制与重放这一轮已经通了(见下)。⇒ 结论从「没有生成器所以无物可调」改成「有生成器,但它的产物只能录、不能算」。N-110 里那句「S5-9 的前置是 S5-3」已完成使命,可以让它退场;它今天等的是一次编排 + 一条线上入口。 剩下的真难点仍是 N-104 里那句「配方留档在哪」:prompt-hash 至今故意不强制,因为仓库没有 prompt 留档机制——编个假 hash 会让后来的人以为可复现。(2026-10-27 补:生成器已经有了,所以这条的说法要改 —— 从「等生成」变成「等一个留档落点」。) 2026-10-26 追加:一条复现命令到了,但它复现的是「录制」,不是「种子」。 me-studio-replay <文档.mir> <录制.patch> 落地(crates/me-studio/src/bin/me-studio-replay.rs + crates/me-studio/tests/replay.rs 7 条判据):给一份文档和一份 .patch 录制,重放一遍、结果打到 stdout;冲突时一个字节都不打印、退出码 1。这是「把一次改动原样再跑一遍」,不是「凭 seed 重新生成」—— 后者要一个吃 seed 的生成器 —— 今天有生成器(S5-3 的 decode),可它吃的是「意图 + 文档」,不是 seed,所以「凭 seed 重算」这条路仍然不存在。 所以 me gen --seed … --recipe … 这条命令仍然不写:写出来就是一句措辞正确的假承诺。S5-6 的缺口没变,只是从「什么都不能做」变成「录制能复现、种子不能」。 留档的形态其实已经有雏形:录下来的那次请求本身就是一份留档。但「把请求与回答配对写盘」与应用不写盘的原则冲突(写盘是「保存」的事),所以它属于录制那件事,不单独做。 判据的落点选可执行文件而不是函数(env!("CARGO_BIN_EXE_me-studio-replay") 真跑子进程),因为这条命令的用法是 > out.mir —— 失败时 stdout 必须为空:shell 先建文件,空文件是正常的,半份文档才会让下游 me build 当完整结果继续走。这一点在进程内测不出来。 另:base 指纹默认不拦(与 Patch::apply 同一条规矩),--check-base 才是显式要那道闸;退出码 0/1/2/70 按 cli.spec.md §2 的「该谁去改」分档。 2026-11-05 追加:同一个缺口从另一侧看到了 —— patch 也表达不了 provenance。 Op 只有 Set / Unset / Add / Rm,而 Set 只写节点 attrs;provenance 是节点块,assets / budget 是文档与节点块。所以「让 AI 自己写 seed 与 model」今天连语法都没有,账本里记的永远是人事后补的那份。这跟上面「配方留档在哪」是同一根结:留档的落点与写入的落点都没有。 2026-11-05 晚:这个缺口有了一个待定的落点(N-151)。 录制目录里补 <任务名>.prompt(第一步的 prompt 原文)+ manifest 里一行 prompt:<任务名> sha256:…;重放时重算 first_prompt 并与盘上逐字节比 —— 对不上说明「模型当时的输入变了」,而不是「patch 坏了」,而这两种故障今天长得一样。三问已发给 A3:多一个文件会不会破坏「一个目录就是一条意图」、重试轮的 prompt 留不留、.prompt 进不进 git。到期前不回我按「只留第一步 + 不进 git」推进。
  • A3AI Workbench 最小界面:意图输入、MIR diff、渲染前后对比5 人日
    第一版界面能开、能点、数字都是真的;但 DoD 三件里缺 diff。展开 2797 字
    第一版界面能开、能点、数字都是真的;但 DoD 三件里缺 diff。(2026-10-26) 已落地:apps/studio/web/workbench.{html,css,js} + GET /workbench + GET /api/agent。DoD 的三件——① 意图输入 ✅(改一句就重新分解)② MIR diff ✅(S5-3 落地了:/api/patch 回的是 .patch 命令序列,每行自带 was <旧值> —— patch 本身就是 diff,不用另造一个渲染器,所以这一栏是「生成改动」按钮的结果区)③ 渲染前后对比 ❌(卡的不再是应用了 —— 2026-10-26 晚那个按钮接上了,act=patch 走撤销栈、整份算一步 Ctrl+Z,见 S5-5 的后半段。现在缺的是「后」这个画面:应用之后这一屏重取整屏,预算与 Guardian 会跟着变,但没有任何一处把改动前的渲染结果留在旁边。要做的是「应用前先抓一张、应用后并排」,而抓图那条链路(离屏读回 → PNG)刚由 S6-3 打第一块砖,见 crates/me-render/src/offscreen.rs)。 判据落在协议上而不是 DOM 上(crates/me-studio/tests/workbench.rs,6 条):整屏数据来自一次请求(拆成五个接口就会来自不同修订)、文档过不了校验也不让整屏 500(预算那一块独立失败)、空意图自称兜底、页面里 __TOKEN__ 被替换、两份资源都非空、预算上限是文档算出来的。演练过会红:把试跑改成「一律算过」⇒「文档过不了校验也不让整屏失败」变红。 视觉是实测的,不是「调过颜色」:apps/studio/web/verify-workbench.js 用无头 Chromium 在 1440×900 / 1280×800 × 浅色/深色四组下量对比度(WCAG AA)、四边溢出、控件重叠、最小字号 —— 现在 0 处违规,实测值写进 workbench.css 末尾「实测」段。量出三处真问题:--ink-3 只有 4.20:1、深色端链接只有 3.06:1、预算条恒为 100%(用了 pct 而不是 headroom)。 还差:前后对比(应用按钮已接上,而且 2026-10-27 补上了行为判据:apps/studio/web/verify-apply.js 11 条,真点、真 POST、真撤销栈,见 S5-5 末段)。diff 有了之后这一屏能回答「AI 改了什么」(连「它以为的旧值是什么」都在每一行末尾),但还回答不了「改完长什么样」—— 那需要真落地一次再渲染。界面文案钉着这件事:那一栏的 .rule 写的是「按需生成」而不是「未落地」—— 过期的话比留空更糟,它会被当现状引用。 2026-11-05 追加:diff 的边界要跟着同一条事实写清。 既然 Set 只写 attrs,那一栏「MIR diff」能显示的也只有属性这一层 —— inputs / budget / provenance 的改动今天既改不了、也不会出现在 diff 里。看这一栏的人要按这个范围理解它,否则会把「diff 里没有」读成「没改」。 2026-11-05 更正:第三件也在 —— 上面那句写错了。 crates/me-studio/src/preview.rs(S5-7 的第三件)早在 3c3ad4bd(2026-10-26)就落地了,而且接在 POST /api/act?dry=… 的结果里(serve.rs 的 compare 字段;一次请求只装一次帧表,「前」与「后」必须基于同一份)。判据在 crates/me-studio/tests/serve.rs 的 前后对比的两张图共用一个坐标系 —— 不只比 viewBox 相同,还比两个矩形确实不同(只比 viewBox 会漏掉「两边都取了后的 quad」那类错)。 上面那段「缺的是『后』这个画面」写于同一天,可写的时候这件已经落了。这是「措辞正确」最像「已经做完」的反面:板子说没做,代码在跑 —— 于是下一个人(这次是我)会照着板子再实现一遍。 它比的不是像素:主机侧没有 GL 上下文,硬做只有两条路,两条都是假的(再写一个光栅器 = 第二份渲染实现;出一张示意图叫它渲染结果 = 措辞问题)。所以比的是渲染器真正消费的东西 —— draw 列表里每条矩形的几何与颜色,画成线框并排。像素级对比要等 S6-3 的离屏回读能在这台机器上跑,界面那一栏明写着这句话(workbench.js 的 线框是 draw 列表…它不等于画面)。 2026-11-16 追加:这一栏会自己说出「我看不见的那部分」。 实测把 frame="f0" 改成 "f1"(uv 从 [0, 0, 0.25, 1] 变成 [0.25, 0, 0.5, 1]),两张线框图逐字相同,对比栏的结论是「没有变化」—— 而画面上那块确实采到了另一格。根因在类型上:Quad 当初只抄了画矩形要用的六个字段(x/y/w/h/rot/color),其余(texture/layer/z/uv/sort_y/node)没抄,于是「没抄进来」被当成了「不存在」。现在 Quad 补齐九个字段,compare_json 每档多一对 same_box(矩形一样、底层不一样的条目数)与 same_box_fields(差在哪几个),界面上多一个虚线 chip「线框看不见 N 处:uv」。配对按多重集找:改 layer 会让 draw 列表重排,按下标配对会把整列都算成「动了」。 判据两句,缺一句就不成立:tests/serve.rs::换帧在对比栏里只看得见数字 —— 先断两张 <rect> 逐字相同(证明它真的踩在「看不出来」上,不是碰巧动了),再断服务端说「1 条,差在 uv」(证明它知道)。另加 preview.rs 4 条单测:换帧要报、矩形真动不报、重排仍能按几何配、原样不动不报。反向实验:把 uv 从 hidden_gap 里删掉 ⇒ 红在「服务端必须说 1 条」。 仍然看不见的:inputs / budget / provenance(patch 写不了,见上面 2026-11-05 那段),以及像素本身(S6-3)。
  • A1评测集:20 个生成任务 + 人工评分标准(可接受/需修改/不可用)3 人日
    在写:没有评测集,也没有能测「一次通过率」的执行器 —— 而且这两件事不是同一个原因。展开 1319 字
    没有评测集,也没有能测「一次通过率」的执行器 —— 而且这两件事不是同一个原因。(2026-11-05) 第一半是没开工:content/ 下只有 ui/,仓库里没有任何 20 条任务的清单,plan/p0-plan.json 与 docs/10 只写了那一句话。第二半更要紧:重放录像测不了一次通过率。 录像是「重试之后」的产物(decode::Options::max_rounds 默认 2,第二轮带着上一轮的错误重问),拿 Recording 重放永远 100% —— 那会是一条看起来能绿的假判据。一次通过率只能来自真跑模型并记录第几轮成功,decode 的 Round 里已经有这个数。 本机今天没有模型通道:~/.config/magic-engine/agent.env 不存在,ME_AGENT_BASE_URL / ME_AGENT_API_KEY / ME_AGENT_MODEL 三个环境变量都没设 ⇒ DoD 里「20 任务一次通过率 ≥70%」与「3 关跳跃 → 可编译 MIR」两条在本机产不出数字,不是没做,是缺一次带密钥的运行。 能离线做的那半已经定好形状:20 条意图 + 三档评分标准(可接受 / 需修改 / 不可用)+ 每条的起点文档,口径写成「第一轮就 seal 成功且 Guardian 放行」。下一轮先落这份清单(它不依赖模型),执行器等模型通道。 2026-11-05 晚:能离线做的那半落地了 —— 缺的只剩一次带密钥的运行。 content/eval/s5-tasks.tsv(20 条:16 条该出 patch、4 条该说做不到)+ content/eval/README.md(三档口径与「机器只判必要条件」的边界)。判据四组:crates/me-studio/tests/eval_set.rs 3 条(≥20 条且编号唯一 / 题干是话不是命令且起点自己过 Guardian / 拒绝题有但不是多数,三次反向实验都红)、tests/eval_cli.rs 5 条(--plan 打满 20 条、--limit、没配通道退 2 且不许出现任何百分比、清单读不到、用法错)。 口径钉在代码里而不是文档里:一次通过 = decode::Options{max_rounds:1} 跑成 —— 不给 Decoded 加「第几轮成的」字段,那等于让正式代码为评测变形。需修改 = 生产默认 2 轮成了;不可用 = 两轮都不成,或该拒绝却硬编了一份 patch(后一条是这份评测集最贵的考点)。 执行器 me-studio-eval <清单> [--plan] [--limit N]:退 0 达标 / 1 未达标(数字在 stdout)/ 2 用法或没配通道。真跑模型那条路本机没验过 —— 这台机器没有通道;第一次有人配了密钥跑它时,它就是验收的一部分。这条写在 bin 的抬头与 eval_cli.rs 的表格里,不藏。
  • A2--no-ai 复现开关 + 回归测试2 人日
    2026-11-06 结案:判据补上了,这条 DoD 成立;展开 1216 字
    2026-11-06 结案:判据补上了,这条 DoD 成立;但「球在 A2」那句是过期判断。 先更正:原文写「球在 A2:N-105 里那三问答完之前验收口径定不下来」。N-105 早已关闭,它的结案句恰恰回答了这件事:「cli.spec.md 里 --no-ai 的语义是关闭 ai-pass,而 ai-pass 的不确定性一旦录成 .patch,重放就是确定的 ⇒ 你那边要的离线可复现,用录制这一层就能接;不要等 seed 那一层。」所以这条从来没有卡在 A2 —— 卡的是没人把「重跑一遍」变成一条可执行的判据。 新判据 crates/me-cli/tests/determinism.rs(3 条,全走真进程 CARGO_BIN_EXE_me):① 跨进程两跑 --emit-cooked 字节相同;② 换一个目录编字节相同;③ 带 --no-ai 与不带字节相同,且开关必须出声(ME-ARG-005,文案要含「没有 ai-pass 可关」),不带时不许出现。为什么必须走真进程:进程内连跑两遍抓不到 HashMap/HashSet 的随机种子(RandomState 每个进程不同)与产物里的绝对路径,而这两样正是「逐字节一致」最容易破的地方。 为什么第一条要先证明产物非空:第一版实验拿 coin_scene.mir(2 个 mesh.draw,lower 只处理 sprite.draw)⇒ 编出空绘制列表、--emit-cooked 写出 14 字节,三趟字节相同,看着完美。空产物上的「一致」是恒真的(头里根本没地方放时间戳)。所以每条判据都先 decode 一遍、断言条目数等于示例自己声明的 # expect-draws: N(从文本读,不抄 4)。 三次反向实验(都还原了,工作树 src 零改动): ① 产物尾部追加进程号 ⇒ 三条全红,红在 decode 的 TrailingBytes { left: 4 } —— cooked 格式严格闭合,塞不进垃圾; ② 只翻最后一字节(落在 node: u32 里,解码接受)⇒ 三条全红在「逐字节相同」,249 字节 vs 249 字节; ③ 把 ME-ARG-005 改成 ME-ARG-999 ⇒ 只有第三条红,红在「必须出一条 ME-ARG-005」。 这件事的边界写在判据里:等 ai-pass 真的落地,ME-ARG-005 会消失 ⇒ 第三条变红。那不是回归,是提醒「DoD 这句话的语义变了,去补真正的关断测」。同理,谁为了「输出干净」把这句删掉,判据也会红 —— 今天用户拿 --no-ai 复现 bug 时,唯一能知道「它其实什么都没关」的信息就是这一行。

目标:编辑器能替代文本编辑,且"看到的 = 玩家看到的"。界面全自绘(ADR-0015 §3.1):

  • A3自绘壳(apps/studio-shell/):窗口 + me-swrast 上屏 + 文字排版 + 输入法(含中文 IME),同进程起 me-studio-serve。取代原「Tauri 2 壳」,见 ADR-0015 §70 人日
    在写:宿主那一半落地了,窗口还没套(2026-10-28 记,这条此前既不在 tasks 也不在 wip,看板上它显示成「未开始」——与事实差了整整一个 Tauri)。展开 10595 字
    宿主那一半落地了,窗口还没套(2026-10-28 记,这条此前既不在 tasks 也不在 wip,看板上它显示成「未开始」——与事实差了整整一个 Tauri)。apps/studio-shell/src-tauri/ 是一个独立 workspace 的小 crate me-studio-shell,它在同进程里起 me-studio-serve:一个线程 + 手写 TcpListener,不是 sidecar(sidecar 要管子进程生死,Windows 上父进程被杀时子进程常留着,还占着 exe 让下次构建失败);绑 127.0.0.1:0 让内核挑端口,写死的话多开时第二个进程绑不上会退出、而页面连的是先来的那个(症状是「改了文档,另一个窗口在变」);token 每次启动都换。实测(2026-10-27,Windows)/api/build.cooked?profile=wechat_android 回来的字节与 me build --emit-cooked 写出的那份相同。还差两件:① Tauri 2 窗口本身——把 main 里「起线程 + 等 stdin」换成 tauri::Builder::default().setup(|_| …) 里的同一段线程,再加一个事件循环;② tauri.conf.json、图标与双平台产物。界面这一半不需要新代码:三栏前端本来就在 apps/studio/web/ 跑着(vanilla + /api/* + /ws/trace),壳与它同源,换的只是 base URL。所以 3 人日里 2 已花掉,剩 1 是窗口与打包。没先加 Tauri 依赖的理由是它会带进一条「CI 联网解析几百个 crate」的依赖,而现有判据的力气全在「形状对不对」上;已进 CI 的判据是仓库根与 apps/studio-shell/src-tauri 各跑一次 cargo metadata 都 exit 0。 2026-10-29 目标校准(ADR-0015 §3.1:引擎全部自绘):上面那句「界面这一半不需要新代码——三栏前端本来就在 apps/studio/web/ 跑着」作废。那是 DOM 界面,而 §3.1 第 1 条写的是「不引入 DOM / AppKit / Win32 控件拼界面,界面像素只由 me-ui + me-render 产生」。所以分成两半看:宿主那半(同进程起 me-studio-serve、127.0.0.1:0、token 每次换、cargo metadata 判据)仍然有效,也已经做完;界面那半从「沿用 web 三栏前端」变成「在自绘管线上重做三栏」,人日不再是 0——原 3 人日里留给界面的 1 也不够。因此这条只能记 wip,不记完成;重估后的人日要进新一轮排期,不许拿旧的 3 糊过去。 2026-11-06 核过:重做已经是 v0.2,「人日不够」这句要换掉。 apps/studio-native/(A1 扇区,staticlib + rlib 双出口)现在是一个能用的自绘编辑器,不是原型:三栏(左 262 层级树 / 中视口 / 右 320 检查器)+ 菜单栏 + 状态栏全部由 me-ui 画;真窗口是 Sources/StudioHost.swift(AppKit NSView + CGImage 上屏,没有一行渲染代码,20 个 C 函数只做「报事件 / 要一帧 / 拿像素」);无头出口 --shot 把同一份 App::frame 写成 PPM。48 条判据(tests/replay.rs 6 / tests/ffi.rs 9 / tests/editor.rs 33),键位 20 条(树 ↑↓←→ Return Delete Cmd+D/A/↑↓/Z、格子 ←→ Home End Cmd+A/C/X/V Return Tab Esc Cmd+S)。实测 M1 / macOS 26:2× 74.9 ms(≈13 fps)、1× 24.2 ms(≈41 fps),静止时降到 ~3 Hz。所以「界面那半没人开始」是错的。 剩 7 条,各有前置,不再是一个笼统的人日(apps/studio-native/README.md 的「没做的」逐条核过):① ~~视口只画包围盒~~ —— 2026-11-07 已做(见文末第 ① 条的收尾,前置理由也是错的);② 菜单只有四项(文件/编辑/视图/帮助),项表是唯一一份、hint 里的快捷键在 handle_keys 里一定找得到分支;③ ~~输入法没接,只吃 ASCII~~ —— 2026-11-07 已接(见文末第 ③ 条的收尾);④ 没有真窗口的自动化交互判据(要辅助功能权限,现在只覆盖到 C ABI 那一层,Swift 那层只翻译事件、要人点一遍);⑤ ~~没有拖拽重排~~ —— 2026-11-07 已做(见文末第 ⑤ 条的收尾);⑥ ~~多选时同级移动按主选算~~ —— 2026-11-07 已做(见文末第 ⑥ 条的收尾);⑦ ~~窗口尺寸写死 1440×900~~ —— 2026-11-07 已做(见文末第 ⑦ 条的收尾)。 ③ 的准确缺口不是「Swift 没写」,是 me-ui 没有 preedit。 interface/pal.trait.rs v2 的 Preedit { status, text, cursor } 与 TextStatus::{Unsupported, Idle, Composing} 早在契约里(ADR-0016),me-ui 侧也已有 ime_area()(把焦点控件矩形 + 组字光标交给宿主,本轮补的);但 crates/me-ui/src/ 里 grep preedit 0 命中——组字串、下划线、串内光标三样在 UI 层一样都没有,宿主那边只走 sn_text(insertText 那条路)。所以 probe README 说的「打不出一个字」卡的上游在 UI,不在 AppKit。 ③ 已闭环(2026-11-07)。 这一段是上一轮补完 me-ui 那一侧之后留下的半截:Ui::preedit / Ui::ime_area 加好了,而 apps/studio-native 里 grep preedit 仍是 0 命中 —— 上游有能力、下游一个都没接,症状与修之前一模一样(还是打不出一个字)。这一轮把下游接完: - App.preedit: Option<(Target, Preedit)> + App::frame 里交给 Ui::preedit; - ffi.rs 两个新出口:sn_preedit(空串 = 结束组字)与 sn_ime_area(三档返回值:0 没有 / 1 有控件没光标 / 2 都有); - Info.ime:候选框位置必须在 end_frame 之前取,那之后 hits 就没了,而它一半的信息只在 Ui 里; - Sources/StudioHost.swift:NSTextInputClient + keyDown 先过 inputContext.handleEvent(组字是系统拿到事件之后才开始的,应用先处理掉就永远启动不了)+ doCommand 把方向键/Tab/Return/Esc 接回同一组键码。 归属带 Target 是被判据逼出来的。 第一版只判「有没有一格在编辑」,结果点开另一格时上一格的拼音会画到新格里 —— 而宿主只知道「系统要我画哪几个字」,格子是这边的事。判据 a_composing_string_does_not_follow_you_to_the_next_field 用两条会话对拍(一路设组字、一路不设,同样的点击序列,最后逐像素比)抓的就是这个。 tests/ffi.rs 3 条判据(候选框只在编辑时报 / 串画得出来且取消后光标回原处 / 串不跟换格),5 组反向实验逐条红过。没验的是最后一步:真窗口里用系统输入法打一次中文 —— 那要人点(辅助功能权限不在 CI 里)。 ⑤ 已闭环(2026-11-07):拖拽重排。 落点三段(上 1/4 = Before / 中 1/2 = Into / 下 1/4 = After),越过 4 像素才算在拖(DRAG_SLOP),拖动中画插入线(成立用 accent、拖进自己的子树用 theme.err),松手才在 App::apply 里改结构。tests/editor.rs 6 条判据(中区变孩子 / 下沿插在两兄弟之间 / 拖进自己现在的父落到末尾 / 拖进自己的子树被拒 / 跨行 2 像素不算拖 / 插入线出现又消失),5 组反向实验逐条红过。没验的是最后一步:真窗口里用鼠标拖一次 —— 与 ③ 同一个缺口(辅助功能权限不在 CI 里)。 这三条判据里有三条先后写成过恒等式,值得单独记。 ①「2 像素不算拖」第一版在同一行内部挪 2 像素:目标行就是被拖的那一行,*id != from 把它拦掉了,有没有阈值都一样 —— 必须跨行边界(211.5 → 213.5,行 4 底 = 213)。②「结构没变」第一版拿先序扁平表比:把节点搬出子树时它的先序位置可以完全不变(n_leaf 从 n_leaf_at 的独子变成 n_world 里n_plain_at 前面的一格,两处同一个下标),拆掉阈值之后状态栏已经写着「已移动 · n_leaf」而扁平表一个字节都没动 —— 要看父子归属。③「界面这一层拒绝了」第一版只看文档和状态栏:那两样都是 drop_onto 的产物,界面层那个 reject 的全部作用是那一笔颜色,拆掉它判据一片绿 —— 判据要落在它真产出的东西上。 有一处实现是判据逼出来的:Into 的下标是「摘掉之后」的(kids.len() - usize::from(kids.contains(&from)))。它只在「拖进自己现在的父」时才用得上 —— 不扣的话 n_group(n_world 的孩子数 2)算出 2,而 Doc::reparent 的上界是 2 - 1 = 1,直接 IndexOutOfRange,症状是「拖回自己家就不灵了」。原来的中区判据拖的是别的父的孩子,两个式子都等于 1,测不出来。 ⑤ 的第二半(2026-11-07):多选按整组。 第一版拖拽只搬按下的那一行,并在 drop_onto 里 select_only(from) —— 用户选了 5 行再拖其中一行,走的是 1 行,选区还被缩成 1 行。现在 Drag::group 在按下那一刻定死:按下的行在选区里就整组,不在就它一个。下标按整组算(Into 扣「组里已经在目标下的个数」,Before/After 扣「同父且排在目标之前的个数」—— 今天这份场景里那个数最多是 1,两个以上造不出来,照定义写的,没验过)。 「组」为什么必须在按下时定死:handle_keys 不看 self.drag,拖动期间按一下 ↑ 选区就变了。结算时再读选区的症状是「拖到一半碰了下方向键,松手什么都没发生」(move_selection 搬的是选区,此刻只剩一行 ⇒ Ok(0) ⇒ 状态栏「位置没变」)。判据 a_keyboard_nudge_mid_drag_does_not_change_what_you_are_dragging 钉这条。 两次假绿灯,都不是代码的错。 ① 多选那两条判据必须挑互不为祖先的两行:第一版挑的是 n_plain_at 和它的孩子 n_plain,而 move_selection 里的 topmost_selected() 本来就会剔掉「另一个选中节点的后代」(搬父节点时子节点跟着走),于是不管有没有那一步,动的都只有父节点一个 —— 判据测的是空气。② 「拖到一半按方向键」这条要先断言前提(↑ 真的把选区换成了别的),否则把「摆回组」那一段删掉也照样绿。 判据 9 条(原 6 + 多选 3),反向实验 9 组(原 5 + 4)逐条红过。 ② 的一半(2026-11-07):视图菜单加了「折叠全部 / 展开全部」。 原先只有「网格 / 名称标签」两个开关,树一大就只能一行一行按 ←。两条规则值得写下来:根不折(折到底整屏只剩一行,而那一行是「看不见的东西」的入口,用户下一步该点哪儿没有提示);只收有孩子的节点(叶子进 collapsed 不会出错,但「折叠了几个」这个数就没法解释 —— 7 个报 7 而屏幕上只少 6 行)。 判据落在可见性上,不数集合:折完之后同一个 y 上换了一行,才是真的少了一行。数 collapsed.len() 只是数机制 —— 集合对了而 visible_rows 不读它,屏幕上照样 7 行(反向实验 ⑦e 就是这么红的)。5 组反向实验逐条红过:把根也折进去 / 叶子也收进集合 / 展开时不清空 / 菜单分支是空的 / 可见行不读 collapsed。 顺手补的一笔(2026-11-07):拖动中给被拖的那几行各画一条记号。 插入线说的是「落到哪」,这条记号说的是「搬哪几行」—— 多选时后者不是显然的:用户按下的是一行,跟着走的可能是三行,而它们在松手之前和别的选中行长得一样。画在右边缘(tree_row 给选中态画的那条在左边缘),2×(行高 − 4)的竖条,不画整行底色(底色会和选中色抢,而「搬哪几行」不该盖住「选了哪几行」)。 判据把形状收紧到 2×18 且 200 < x < 269:检查器里的光标也是 2 像素宽(2×13),形状写松了就把它们数进来,而「多出来一条」会被算到拖拽头上 —— 第一版就是这么红的(基线 6 条、拖完 9 条)。3 组反向实验(不画 / 只给按下那行画 / 画到左边缘)逐条红过。 一句实测:松手那一帧记号还画着 —— self.drag = None 在 apply 之后(drop 要用它),而绘制在这之前。一帧 16 ms 用户看不见,但它决定了判据要跑几帧(判据里明写了,免得下一个人把它当抖动删掉)。 ⑥ 已闭环(2026-11-07):多选时同级移动按组算。 Cmd+↑/↓ 走的是 me-studio::Editor::move_selection(A3 扇区),它一次只认一个父 —— 一组里混着不同父节点时,第一版只有主选在自己那级里挪,其余的被搬进同一个父下面,而状态栏写着「已上移」。这个 bug 的重量不在「少挪了几行」:move_selection 真会重新挂载节点,n_leaf_at 从 n_mid 底下被拽进 n_world,屏幕上只是少了一层缩进,而撤销一步还回不去原样(跨父一次操作 = 好几条撤销记录)。现在 App::move_node 先按父分组、组内按文档序排(选区记的是点选先后,落点是文档里的位置)、每组在本级挪一格,顶头的那组跳过;单个节点时行为一个字没变。 三处看着等价其实不等价的地方(3 组反向实验逐条红过):① 逐组搬要反复改选区(每次只选中一组去调 move_selection),搬完必须摆回整组,否则第二次 Cmd+↑ 只搬最后一组 —— 判据把两件事一起钉:搬完 selected() 还是那两行,再按一次说「每组都到头了」;② 消息分支里 edge 只记一个名字,排在「多组都顶头」前面的话,另一组一动不动就没人解释;而按旧顺序那一支在这份场景里永远走不到(要所有顶头的组大小都 ≥ 2 才轮得上),等于死分支;③ 「顶头」的边界本该按整组算(target + 组大小 > count)—— 单个节点时它与 target >= count 等价,整组时不等,但两组大小都 ≥ 2 才分得开,而这份场景里 n_world 只有两个孩子,所以这一条今天造不出判据,是照定义写的,别当它验过。 判据落在没动的那一组上(n_mid 还有没有孩子),不是动的那一组 —— 与第 ② 条反转实验同一个教训:n_leaf_at 被搬进 n_world 的时候,「动的那一组」看起来完全正确,状态栏还写着「已上移 2 棵 · 1 组」。 ⑦ 已闭环(2026-11-07):窗口尺寸记得住。 一处一行 WxH 存到 ~/Library/Application Support/MagicStudio/window.txt(拖动结束与退出各写一次),开窗时三档优先级 --size > 上次的 > 1440×900。不用 UserDefaults / setFrameAutosaveName:build.sh 打的是裸可执行文件(没有 .app bundle、没有 Info.plist),Bundle.main.bundleIdentifier 是 nil,defaults 的域落哪儿不确定 —— 而「没记住」和「记住了」在界面上长得一模一样,这种依赖不能建在猜上面。 一处我写错、被实测纠正的事:第一版把上限按内容区去夹 NSScreen.visibleFrame。本机 visibleFrame 是 1440×869(frame 口径),标题栏 32,所以按内容区夹成 869 之后 AppKit 又把 frame 收到 869 ⇒ 内容区其实只有 837。数据探针第一次跑出来存档写的是 1440x837 才看见这件事。改成对着 window.frame 夹一次,并把打印的读数改成真正拿到的 view.bounds(原来打印的是请求值,等于自欺)。 判据是 tools/check_window_memory.sh:--size 1200x760 --shot a.png 一趟、不带 --size 再 --shot b.png 一趟,比两张 PNG 的尺寸(2× 下 2400×1520)。要真窗口,所以进不了 CI —— 套上去只会红在「打不开窗口」,而不是红在「没记住」。3 组代码级反向实验逐条红过:退出时不存(档都没写)/ 不按 frame 夹上限(开成 99999×99999)/ 解析不要求正数(0x0 被当成真值,开成最小窗 720×480)。另有 3 组数据级探针(存档 99999x99999 / garbage / 0x0)逐条落回 1440×837 而来源分别标对。 ① 已闭环(2026-11-07):视口画的是编译器给的四边形。 原文写的「前置是 me-runtime 的编译入口(A2)」不成立:Editor::render → me_mir::parse → me_compiler::compile 三步就能拿到 Report.scene.items,crates/me-studio/src/preview.rs:230 一直在用同一条链。web 侧拒绝写第二个光栅器是对的(它手上没有 GL、也没有 CPU 光栅器),而 native 侧本来就在用同一个光栅器画界面 —— 于是这件事在 native 里做,不新增任何实现分叉:编译入口一份(compile),光栅器一份(me_ui),视口只是换了数据源。 顺手挖出一个一直没人发现的错:旧视口把 pos 当中心画,而 pos 是左上角(DrawItem::pos 的文档、示例文件第 23 行都写着)。pos=(128, 88) 的框落在 (112, 72),差了半个尺寸,而视口那 7 个方框看着"就是那样"——一条判据都没有,所以一直是绿的。现在这个数从编译器来,两处语义不可能再分叉。 编不过时不画猜的东西:视口一条都不画,把码与原话居中写出来,标题从「编译结果」变「编译失败」。退回旧的包围盒是很诱人的(至少还能看见东西),但那样一来失败就只剩标题上一行字,而画面本身看起来完全正常。 一条顺手修的诊断文案:me-compiler 的 describe() 里 MissingRequiredParam 落进了默认分支,报出的是「n_leaf:ME-LOW-003」——作者知道有这个节点、知道码,就是不知道该补什么,而这条错的全部内容恰恰是"补哪一个参数"。现在读作「n_leaf 少了必填参数 tex」。5 处测试断言的是码不是原话,没有连锁。 字集这条路上被自己的判据拦了一次(这笔的第一版是错的,记在这里)。第一版把 me-mir / me-compiler / me-studio 三个 crate 加进 bake_ui_glyphs.py 的 SCOPE,好让「n_leaf 少了必填参数 tex」这句原话上屏。字集 488 → 952,四档图集 5.7 MB → 11.0 MB,撞上 crates/me-ui/tests/glyphs.rs::the_atlas_stays_within_budget 的 8 MB 预算 —— CI 红在这条上,不是红在别处。判据拦得对:图集是 me-ui 所有使用方(ui-lab / ui-gallery / studio-native)共担的成本,拿它补一个应用的便利,方向反了。所以视口只画 ASCII 的码与节点名(这两个字段本来就只可能是 ASCII),中文提示用 apps/studio-native/src 里自己写的固定文案(自动进字集)。真要看原话,正路是把图集换成单通道(现在 4 字节/像素,换 1 字节就有四倍余量),那是渲染格式变更 + 三个宿主一起改,不是抬预算。 判据 4 条(editor.rs 33 → 37,合计 52):视口的绝对位置(数量 2 + (cx+128, cy-120),按中心画差 16、按本地坐标画差 100 那一截)、改父节点 pos 后按父链缩放位移(挪 8 而屏幕挪 16)、缓存只在文本变了时重编、编不过时 0 块 + 码 + 错误色的字真的画出来了(数据与画面各判一次:why_face 算对了而根本没画,只判数据那半会绿)。4 组反向实验逐条红过:按中心画 / 码丢了(会误报成「渲染不出来」)/ 算对了但没画 / 每帧都编。 ⚠️ 一处造不出反向实验的地方,照定义写、别当它验过:「编不过 ⇒ 0 块」这半条只能靠"没有兜底路径"来保证(要让它红,得先写出那条我们禁止的兜底路径)。所以另配了一条对照判据(同一份视口读好文件是 2 块),排掉"视口本来就画不出来"这个解释。 视口能平移缩放了(2026-11-07)。 View { pan, zoom } 不在文档里 —— 与 collapsed 同一条理由:存进文档会进撤销栈,撤销一次改数值、视口顺手跳一下;也不存盘,两个人开同一份工程不会互相看见对方的视角。世界 → 屏幕的换算收在 View::rect 一处,四边形与网格都走它(散在绘制代码里就是半套跟缩放、半套不跟,症状是"放大后格子和内容对不齐",而两边单独看都像对的)。滚轮:Cmd 缩放(锚在指针,指针底下那点不动)、否则平移,且只在视口那一栏内生效;「视图」菜单加「适应窗口」与「原始大小」。 判据 6 条(editor.rs 37 → 43,合计 58),反向实验 4 组逐条红过(位置乘 zoom 而原点没乘 / 只重置 zoom / 视口无条件领走滚轮 / 网格步长写死)。两处踩到的坑:① 滚轮归属那条第一版恒绿 —— 只试了树上一点,而树那段先跑、scroll_rows 已经把滚轮吃了,视口拿到 0;真正的缺口是"树也不吃"的检查器与标题栏,现在扫三个位置。② 菜单项 y 把分隔线算在了项之后 —— menu_popup 是 y += 7 在项之前,于是 214 落进「适应窗口」,"点原始大小"实际执行了 fit 而判据报「没复位」,错不在缩放而在数错分隔线。另:菜单动作在 apply 里跑、apply 排在 App::frame 末尾 ⇒ 画面比 view 晚一帧(16 ms),判据要多走一帧才量得到新画面。
  • A3me-studio 服务:文档模型 + 命令栈(undo/redo)5 人日
    文档模型 + 命令栈 + 存盘/打开:稳定 NodeId、单根场景树、15 条可逆命令(含复制)、undo/redo/合并/事务、拖拽落点(批量换父),.mir ↔ Doc 的双向搬运,以及本…展开 364 字
    文档模型 + 命令栈 + 存盘/打开:稳定 NodeId、单根场景树、15 条可逆命令(含复制)、undo/redo/合并/事务、拖拽落点(批量换父),.mir ↔ Doc 的双向搬运,以及本机服务(serve.rs + 三栏前端,27 条协议测试)、新建节点(落点/命名/算子清单都走服务端与注册表)、改名(引用跟着改 + 行内编辑)、多选(mode=only/add/toggle,快照发整份 sels,按整份选区标高亮并说明「改一格会改到 N 个」)。DoD 那条「undo 20 步全部正确」是一条断言(撤销二十步回到原样、重做二十步回到终态),不是目测;「打开→保存」的判据是 coin_scene / sprite_scene 过一趟逐字节不变——原先只比「注释条数没少」,而那条在注释落点错位时一直是绿的。
  • A2+A3视口:/api/build 吐 cooked 字节 → wasm decode → 喂 me-swrast 的 Framebuffer(原写「render 到 canvas」,自绘后 canvas 不存在)3 人日
  • A3场景树 + 拖拽 + 多选4 人日场景树 + 拖拽换父/重排 + 多选(Shift 加选、Ctrl 反选、主选单独标)。多选那半是这一轮补的:后端本来就按整份选区干活,只是快照只发主选、树上只能标一行。补录。
  • A3Inspector:MIR 节点属性编辑(所见即 MIR)4 人日Inspector 逐格编辑,类型与「必填」都从算子注册表来(param_parity 逐项钉住,前端不写第二份类型真相);改一格 MIR 文本跟着变——「所见即 MIR」的判据在协议断言里。补录。
  • A2热重载 L1:材质/光照参数 <50ms3 人日
  • A2热重载 L2:结构变更 <300ms,实体按 id 映射4 人日
  • A3构建发布面板:一键构建 + 包体分析3 人日
    在写:「一键构建」那半边到了:Studio 顶栏的「构建」按钮打 GET /api/build,按文档自己声明的每一档回 pass 日志、draw 条数、纹理、计划序列、预算的上限/已分配、降级清单…展开 1131 字
    「一键构建」那半边到了:Studio 顶栏的「构建」按钮打 GET /api/build,按文档自己声明的每一档回 pass 日志、draw 条数、纹理、计划序列、预算的上限/已分配、降级清单,某档编不过时该档带码报错、其余各档照常给。 回执里的节点现在能点回树上(本轮):出错的 error.node 与每条降级 downgraded[].node 都带一个 node_id,点了就选中并滚到那一行。名字 → 编号这一跳放在服务端(NameIndex),不放前端:「重名怎么办」是判据,两份实现就会在猜错的那一次上分叉,而那次的表现是「选中了、名字也对,只是不是出错的那一个」。映射不上给 null,前端据此画成不可点并说明原因——不猜。 「包体分析」从这一条里退出了(2026-10-24 查实:不是没时间,是落错了地方)。 账本 me.pack.v1 的 content[] 是 me pack 遍历工程里的 .mir 逐个编出来的(pack.rs 里 Compiled 由 compile_one 产出),而 Studio 打开的是单个 .mir:没有工程、没有 dist/、没有主包/分包预算——serve.rs 里那句「档位取文档自己声明的,不取 me.toml」就是这个前提的注脚。在 Studio 里做包体分析,能画出来的只有它已经画过的那两个数(每档 draw 条数与纹理清单);再往前一步就得凭空造一个工程视角,那是给不存在的状态铺地砖。这一半退回它本来就有落点的地方:S8-5「包体分析器:按模块/资产类型归因,输出可执行建议」(docs/10-p0-sprint-plan.md,主责工具链、依赖空)。我在 N-023 的第一版里写的是「问 A1 落哪」——那是没先翻排班表就开口问人,已改。 打包侧的前提变过两次:me pack 会编译内容(dd8eab2,编不过不出包);随后 N-039 补上第二半——包里真有内容产物了(content/world.bin,cooked 字节,ME-PKG-023 现在说的是「产物叫什么」而不是「没有产物」)。运行时读什么也已裁决为 cooked 场景(ADR-0012,N-021 关闭)。所以「包体分析」能先做账本那半(content[{path,target,draws,textures}] 已经在);「出微信包」不再卡在格式上,卡在 A2 侧 me-runtime 接上 me_cooked::decode(N-040)。

目标:第一次完整的"能玩",并让真机性能可归因。

  • A1玩法框架:状态机、关卡流程、结算5 人日
    玩法框架三件(状态机 / 关卡流程 / 结算)都在 coin_run/game.rs 里,而且判据一律从外面读数。展开 491 字
    玩法框架三件(状态机 / 关卡流程 / 结算)都在 coin_run/game.rs 里,而且判据一律从外面读数。Screen 四态(玩着 / 标题 / 说明 / 选关)与 Outcome 四态(在打 / 过关 / 失败 / 全通关)各自带一个 code(),刻意不写 as u32:编号由声明顺序决定时,中间插一个状态会让宿主的判据集体错位,而错位没有编译错误,症状只是「结算画面显示成通关」。过关进下一关 / 失败重打 / 全通关回第一关这三件全在 Game::continue_run,宿主只接返回的 Outcome ——自己数关卡号就会与 LEVEL_COUNT 分叉(症状:最后一关过了之后进了第 13 关)。all_twelve_levels_are_clearable_by_the_bot 用机器人跑完 12 关 × 2 角色共 131882 帧,它证明的是「路走得通」(每个坑、每组怪、每个炮台都有活路),不是「设计好玩」——后者没有能给判据的写法。⚠️ 这条一登记,看板就从「少算 5 人日」变成如实。
  • A1关卡 1–3:手工 + AI 混合生产6 人日
    DoD 原文写的是「关卡 1–3」,实际有 12 关:crates/me-runtime/levels/coin-run-{1..12}.lvl 一关一条源文本,LEVEL_COUNT 是唯一…展开 422 字
    DoD 原文写的是「关卡 1–3」,实际有 12 关:crates/me-runtime/levels/coin-run-{1..12}.lvl 一关一条源文本,LEVEL_COUNT 是唯一来源(all() 逐份解析,HUD 的「N/12」也读它——把 12 写死在三个地方,加关时漏一处的症状是「第 13 关一进就 panic」或者「HUD 显示 12/12 但还有下一关」)。宽度 7040 → 14080 逐关递增,金币 84 → 177,par(完美通关目标)175 → 190 秒。但「手工 + AI 混合生产」这半句没有证据:.lvl 里没有任何 provenance(哪一关由谁/哪个模型生成、种子是什么),所以这条只算了产线,没算 AI 占比。这不是漏写,是不敢写——S9 要算「AI 生成占比 ≥50%」,那时的口径必须先定下来,否则现在补的 provenance 到 S9 一定对不上。
  • A3UI 层:HUD、菜单、弹窗4 人日
    UI 分两半,两半都有判据。引擎侧:HUD 是 HudSlot / HudBar 两套枚举,宿主只按槽位填数、不自己排版;展开 420 字
    UI 分两半,两半都有判据。引擎侧:HUD 是 HudSlot / HudBar 两套枚举,宿主只按槽位填数、不自己排版;标题 / 说明 / 选关三个页是 Screen 的三个态,同一套绘制路径。宿主侧:apps/coin-run/index.html 顶上那一行面板(帧 / 关卡 / 比分 / 生命 / 技能 / 批次 / 精灵 / 步数 / 最高金币),menu.html 是菜单与选关十二格的判据页。弹窗没有独立实现——结算画面就是「世界还在画、上面压一层暗色」,所以它跟游戏共用同一条绘制路径(Screen::Playing 时那块暗色的尺寸为 0,不是隐藏)。⚠️ 已知缺口:引擎只画那四个动作键,没有暂停。手机玩家想停下来只有按 R 重开(等于放弃这一局);暂停是宿主加的一个按钮去调 openMenu,在 index.html 里,不在引擎里——换宿主就会丢。
  • A2真机 profile 隧道:WebSocket trace → 编辑器5 人日
    在写:引擎、宿主、编辑器三端都通了(2026-10-26 补上编辑器端)。展开 1640 字
    引擎、宿主、编辑器三端都通了(2026-10-26 补上编辑器端)。 crates/me-runtime/src/trace.rs(环形缓冲 / 分位数 / JSONL)+ 5 个 C ABI 导出(start / host / json / stats / buf),宿主侧是 boot.js 的一个可选回调加 index.html 的一个 T 键。链路判据 apps/coin-run/trace.html 12 条全绿:120 帧同步驱动 → 环形缓冲留 64 帧 → 逐帧 JSONL 与统计行互相印证,每个数字都对得回喂进去的输入。 三件里 ① 已完成,还差 ② ③。①编辑器端 —— 已落地(2026-10-26):crates/me-studio/src/trace.rs(SHA-1 / base64 / RFC 6455 帧解析,零依赖手写)+ GET /ws/trace(升级后收文本帧,只转达不解析)+ GET /api/trace(快照:行数 / 字节 / 最后一帧多久以前 / 断线原因 / 环形缓冲里的原文)。判据 5 条,都演练过会红,其中握手期望值取的是 RFC 6455 的官方向量 s3pPLMBiTxaQ9kYGzzhZRbK+xOo=——不是自己算一遍再抄回去,那会把同一个错误在两边各写一遍。 同一轮修掉了它真正的拦路石:服务循环原来是 for stream in listener.incoming() { one(...) } 单线程串行,长连接挂上去会让整个 Studio 连 /api/doc 都回不了(one() 做的第一件事是 read_line)。改成每连接一线程;/api/ask 同时移出 Session 锁(DEFERRED 表)——它同步等模型最长 60 秒,以前点一次「问模型」编辑器就冻住一分钟。「没有并发」不是「不用管并发」的理由,是「一次等待等于全服务等待」的原因。 ②真机——这条判据跑在无头 Chrome 上,中端安卓没量过;③归因到 MIR 节点是 S7-5,渲染层至今没有任何 node id(SpriteInstance / Batch 都没有),那条要从 A1 的 DrawItem 往下一路加字段。 ⚠️ trace.html 上那个「自占 73.1%」是人造输入(喂的 busy = i×100µs),它证明链路通,不代表真实占比——真占比要在真机上跑出来。 2026-11-05 更正:③ 的那句已经过期。 原文写「渲染层至今没有任何 node id(SpriteInstance / Batch 都没有),那条要从 A1 的 DrawItem 往下一路加字段」——DrawItem.node 早就在(cooked v2 尾部那个 u32),Batch.node 在 me-render/src/batch.rs:291,LoadedScene::submit 走的是 push_attributed(me-runtime/src/cooked.rs:162 从新追加的那一段里数 tagged),Trace::account / attribution_json 与判据 tests/node_attribution.rs 都在。SpriteInstance 仍然没有 node,那是有意的:它进顶点流,每顶点 4 字节 GPU 一个字节都用不上,归因走 DrawList::nodes(进合批键)与 owners(不进)。所以这条 wip 现在只剩 ② 真机那一趟;归因的引擎侧已在 S7-5 记完,热力图消费方在 S7-8。
  • A2归因:draw call → MIR 节点链4 人日
    在写:引擎侧完成(有判据),缺的是消费方与真机那一趟。(2026-11-05 补登记:这条此前既不在 tasks 也不在 wip,看板上它显示成「未开始」——与事实差了一整条归因链。展开 948 字
    引擎侧完成(有判据),缺的是消费方与真机那一趟。(2026-11-05 补登记:这条此前既不在 tasks 也不在 wip,看板上它显示成「未开始」——与事实差了一整条归因链。)\n\n已落地(A2,af81ab6 起):DrawItem.node 进 cooked v2 尾部(0 = 未归因,不是节点 0);me-render 的 Batch.node、DrawList::push_attributed、DrawList::nodes(进合批键)与 owners(不进,否则同贴图的 400 个精灵会断成 400 批);me-runtime 的 SubmitStats.tagged(从绘制列表新追加的那一段里数,不是从条目上数)、Trace::account + attribution_json(一行、有序、两次导出逐字节相同),coin_run/wasm.rs:1275 已挂导出。以前 submit 调的是 push ⇒ 编号恒 0,画面一个像素都不变,只是残差等于全部——这正是「措辞正确」最像「已经做完」的那一类。\n\n判据:crates/me-runtime/tests/node_attribution.rs(含「submit 用的是 push_attributed,否则 tagged 是 0」)、crates/me-render/tests/draw_attribution.rs。两条口径不许顺手改:报计数不报时间(一次 draw 的耗时只有 GPU 计时器知道,拿 busy_us 摊派会让热力图冤枉节点);node == 0 单列残差,不摊给任何真实节点。\n\n没完成的是它后面那两步:① 编辑器热力图消费方(S7-8,A3——两行接法 trace.account(batches) 已在 N-225 里给出);② 真机那一趟(S7-4 的 ②,中端安卓没量过)。所以不记完成:判据不是「有归因表」,是「trace 从真机回传到编辑器并归因到 MIR 节点」(docs/10 S7 DoD 第 4 条)。
  • A3存档 / 设置(本地存储 + 跨端)3 人日
    平台侧早就在(save.rs 261 行 encode/decode + 7 组测试;展开 1104 字
    平台侧早就在(save.rs 261 行 encode/decode + 7 组测试;WxStorage 三项在 test_wx_platform.mjs 里逐字节验,含 0x00 与 0xFF 两端——base64 最容易在那两处出错)。这一轮做的是复核,抓到一个真缺口:没有一条测试证明「槽位隔离」。变异验证——把 load 改成忽略传入的 key(永远读 slot0),原有 8 条测试全绿,也就是说「存档坏了带坏设置」这个 bug 以前测不到。补了第 8 组 存档坏了不带坏设置:两个 key / 两个版本号,踩坏存档验设置完好、再踩坏设置验存档完好,中间插一条「拿 v3 去读 v7 的设置必须报 OldVersion」——版本号若只写进头部而不参与判定,这条会红。补完再跑同一个变异:8 passed / 1 failed,红的正是新加那条。 两条设计判据值得记住:① 版本不符 ≠ 数据损坏,两者必须分开报(前者迁移、后者丢弃,混在一起就是升一次版本丢一次档);② 跨端一致的判据是字节相等,不是「读出来一样」——后者可能只因为两边用了同一个错的解码器。 不在这个任务里的:上层槽位语义(自动存档 / 手动槽 / 设置分开存)在玩法框架 S7-1。这一层只提供「任意 key + 版本 + 校验」的机制,设置就是另一个 key 加另一个版本号——第 8 组测试做的正是这件事的最小验证。 2026-10-26 合并 origin/main:这条两边各做了一遍,两份证据都在树上,都留着。 谁主谁辅、要不要只留一份,等 A1 定(已报备)。 main 侧记的是: 存档是四个整数(unlocked / lastLevel / hero / bestCoins)。引擎不解析字节、宿主不解析语义:网页写 localStorage 一条 JSON,Mac 写 UserDefaults 四个键。这条分工不是洁癖——让引擎规定格式的话,三份宿主各要写一份解析器,而那份代码只在真机上跑、没有任何判据能验。五条判据全从外面看:新存档只解锁第一关 / 通关解锁下一关 / 点已解锁的格子进那一关 / 继续进存档那一关 / 存档往返并夹取(手改成第 999 关也不 panic,读不到的 JSON 当新玩家而不是整页白屏)。「跨端」只算两端:小游戏侧的 wx.setStorageSync 目前只在自检页验过「能写能读」,COIN RUN 本身还没接,所以这是两次跨端,不是三次。
  • A1首次真机全流程测试 + 问题清单3 人日
  • A3性能预算热力图 v0(编辑器内高亮超预算节点)3 人日
    编辑器内的预算热力图 v0:场景树每行右侧一个百分比徽章(最紧的字段),越界直接标「超」,悬停说清哪一档/用了多少/上限多少。展开 240 字
    编辑器内的预算热力图 v0:场景树每行右侧一个百分比徽章(最紧的字段),越界直接标「超」,悬停说清哪一档/用了多少/上限多少。关键取舍三条——① 单独跑 Budget 而不是整条链:check 越界时会停链,而那正是最需要看热力图的时候;② 编号取自编辑器那份 Doc,用另一套编号会把 A 的百分比画到 B 那行且看不出错;③ 前端取「最差的那一档」而不是加档位选择器。叶子不画(账本没有它们的行,画 100% 是编的),图头/重名进 unmapped 不悄悄跳过。

目标:把主包压进 4MB,把首帧压进 3 秒。这是全项目最不可压缩的一环。

  • A2纹理压缩管线:ASTC / ETC2 + 质量档 + 按用途自动选5 人日
    在写:编号是身份:这条原先错记在 S18-2 上,而 S18-2 是 D3D12 收尾(A3 的活);展开 3054 字
    编号是身份:这条原先错记在 S18-2 上,而 S18-2 是 D3D12 收尾(A3 的活);2026-10-29 挪回 S8-1,D3D12 的 wip 位因此空着,由 A3 自己写。 契约那半边做完了,上传路径没做(2026-10-29,A1)。RHI 从 v6 走到 v7(ME_RHI_ABI_VERSION 5→6,文档版本 7):TEX_ETC2_RGB=5 / TEX_ETC2_RGBA=6、texture_format_block、以及多做的一步 texture_format_upload_len——真实长度是 ceil(w/4)*ceil(h/4)*块字节,而这句话只写在提案里的后果是每个调用方自己写一遍取整,取整方向写反在 1060×96 上看不出差别(唯一那张图集恰好被 4 整除)。另一件是 Caps::WEBGL2 去掉了 TEXTURE_ASTC:ASTC 是可选扩展,GLES3.0 只保证 ETC2,而这一位本来就在契约里(不是新增位),缺的是用法——档位模板不该写探测位,胶水 getExtension 已经在探它,两份必然漂,漂了的症状是贴图全黑。顺带修掉胶水里那段 v2 遗留的「两个扩展都缺就假报档位」,它才是 ASTC 漂移的第二个上游:CONTEXT_READY v2 就有了,而那段注释写着「契约里没有这一位」。build_backend() 同步从判 caps != 0 改成判 CONTEXT_READY(契约原文:没有这一位其余位不可信),两处必须同批,只改一边的症状是白屏。 落地时炸出来的连锁,比契约本身更值得记:去掉模板里的 ASTC 之后 me-agent 的 good_examples_pass 立刻红了 11 份——interface/examples/*.mir 共 16 份写着 caps [texture_astc],而那些全是 2D 精灵场景、纹理都是 RGBA8,根本不需要压缩纹理。那句不是「我要求这个能力」,是抄了一遍「这一档有什么」,抄的源头就是那个假话。假话会被复制:判据 satisfies 一个字没变,变的只是一个常量,16 份文件同时从「合法」变成「越界」。另有三处生成器/模板跟着改(tools/gen/bench_scenes.py、crates/me-cli/src/newproj.rs、pack_roundtrip.rs 的夹具),否则 me new 出来的项目本身就非法;四份反例(bad/13、14、bad-compile/02、03)的 caps 也清了——它们本该只因自身原因红,却被 ME-LEGAL-002 抢先拦住,而一个反例只该因为一件事红。 下一半当天也落地了(2026-10-29):ME_CAP_TEXTURE_ETC2 = 1<<9 拿到自己的能力位(rhi.ffi.h v9 / ABI 7);create_texture 对块编码从「一律 Unsupported」改成三条拒绝(无能力位 / mips > 1 / 无钩子)——Unsupported 那一句同时意味着「设备没扩展」与「后端没实现」,对调用方是同一句降级、对我们是两件事;write_texture 走整级 compressedTexImage2D,长度只认 texture_format_upload_len。为什么这次 bump ABI 而 v8 没 bump:v8 那条是旧后端会响亮地 INVALID_ARG;而能力位是被胶水读的,旧胶水只返回它认识的位,1<<9 会被静默丢掉 ⇒ 内容侧永远判「没有 ETC2」、永远走 fallback、永远不报错,白付那份体积。胶水四份同步(探测 WEBGL_compressed_texture_etc、me_gl_write_texture 不再自己乘 w*h*4)+ tank-battle 的导入桩补第 25 个口。CI 门「ETC2 长度 == texture_format_upload_len」落在 etc2_upload_length_comes_from_the_contract_not_from_w_times_h(1062×96,并显式断言 w*h/2 < exact——1060×96 整除,两种算法同一个数,只测它等于没测)。裁决 ADR-0022。 ASTC 那一半也落地了(同日第二轮,RHI v10):ME_TEX_ASTC_4x4=7 … ME_TEX_ASTC_12x12=20 十四种块尺寸。真正的改动不是那十四个常量,是 BlockFormat { block_w, block_h, block_bytes, cap }——cap 不是 Option,于是「每个块格式都有能力位」从约定变成类型;后端那行写死的 caps.has(Caps::TEXTURE_ETC2) 变成 caps.has(block.cap),加第四个格式族时编译器逼人填、后端不用动。(这张对应表原先只以字面量形式活在实现里,契约检查器核不到——加 ASTC 时照抄就是第二个 if。) 为什么 v10 不 bump ABI 而 v9 bump 了:v9 加的是能力位,被胶水读,旧胶水只返回它认识的位 ⇒ 新位静默丢失 ⇒ 内容侧永远走 fallback 且永不报错;这次加的是格式值,旧胶水 TEX_FORMATS[format] 越界 fail() ⇒ 当场报「未知纹理格式 7」。响亮失败不需要握手,静默漂移才需要。 还差两件,所以这条仍在 wip:① 编码器——原文「仓库里没有任何 ETC2/ASTC 编码器」是错的(2026-11-06 更正):crates/me-rhi/tools/etc2enc.py(352 行纯 Python)就在库里,但它自己的文件头写着「默认参数没通过 GPU 验证,产物解不出来」——etc2_gpu_eval.py --enc ours 把位布局的 16 种组合全跑过,PSNR 落在 6.44~8.67 dB,同一趟里 etcpak 的块在这块 GPU 上解出 31.6 dB;etc2_probe.py 把单块解出的 16 个像素原值念出来,看到错的是整个位布局而不是「哪一档」。修它的前置是一次单比特探针(64 次上传、把每个 bit 的角色定出来),不是继续调 PSNR;候选替代是 etcpak 离线编码 + .etc2 进仓库(确定性来自 git 里的字节,不来自编码器)。⇒ 结论没变(管线今天只认「已经压好的块数据」,十四种块尺寸里有十三种没有东西能产出),但下一个人该先读那份证伪记录,而不是再写一个编码器;② 质量档 + 按用途自动选(任务文本的后半句,me pack 那一侧还没有入口)——它依赖①。
  • A2wasm 体积:wasm-opt -Oz、panic=abort、no_std 子集、去 fmt5 人日
    在写:体积那半边做完了,代码那半边没做。 做完的:tools/build-wx.sh 原来编的是主机档 --release,而 [profile.release] 带着 debug = "line-…展开 2303 字
    体积那半边做完了,代码那半边没做。 做完的:tools/build-wx.sh 原来编的是主机档 --release,而 [profile.release] 带着 debug = "line-tables-only",于是 125KB 调试段被装进小游戏包——166,038 B 里 code 只有 28,741 B。换成 --profile wasm-release 后是 29,019 B(−82.5%),同一份源码同一个 rustc,22 项 ABI 断言全过。逐开关归因(只改一个变量):strip=symbols 单独 −80.9%、lto=fat −5.5%、opt-level=z −2.5%、panic=abort ±0(me-pal-wx 一字不差,me-runtime 反而多 35 B;wasm32 本来不展开栈,那条注释是错的,已改)。工具:tools/ci/wasm_size.py 读段头,二十行的活,不为此引 binaryen;test_wasm.mjs 的体积门从 400KB(4MB 的 10%,且读的还是虚高 5 倍的档位)收到 64KB。—— 还差两件,都不该我一个人动:① no_std 子集——要动所有 crate 的#![no_std] 与 alloc 边界,横跨 A1/A2/A3 三个扇区,且会改变每个 crate 的错误处理写法;② 去 fmt——core::fmt 在 wasm 里通常是体积大户,但没有函数级分析工具(twiggy 那类)量不出它占多少,猜着改等于赌。这两件都该单独立项,不是塞在 5d 的 S8-2 里顺手做。 2026-10-26 补:wasm-opt -Oz 这一项从「本机没有 binaryen 所以跳过」变成真的跑了。 binaryen 133 装到了构建脚本硬编码的固定路径(直连 GitHub 拉不动,走 ghproxy.net + 断点续传)。数字:apps/coin-run/wasm/me_runtime.wasm 299 KB → 196.3 KB,apps/minigame-smoke/wasm/me_render.wasm 305,970 → 142,786 B,coin-run 主包 426,914 → 321,975 B(7.7%)。更要紧的是它揭开了一道从没在本机生效过的门:build_site.py --check-play-sync-only 比的是「刚构建的产物 vs 入库快照」,而本机此前永远没有优化产物、两边字节永远对不上,于是长期靠 WASM-UNOPT 降级跳过;装上后第一次真跑立刻报红(差 126 字节是真的——快照是 10-25 在 Mac 上产的,本分支 me-runtime/me-render 都有未提交改动)。还差的没变,且都不该一个人动:no_std 子集(横跨三个扇区、改变每个 crate 的错误处理写法)与「去 fmt」(没有函数级体积分析工具,猜着改等于赌)。 2026-10-27 补:去 fmt 这一项做完了 —— 但结论是「没有下手的地方」。 那把尺子补上了(tools/ci/wasm_funcs.py:读 code 段按函数切分 + name 段映射,自带 v0 符号的部分解析;一次性诊断工具,不进 CI,已在 cross-sector.txt 登记代修)。me-pal-wx / wasm-release 实测:core::fmt 2,635 B(10.3%),而进 wasm 的三个 crate 里格式化调用点 0 处(me-pal 唯一那处在 impls/host.rs:428,而那个模块整个是 cfg(not(wasm32)))⇒ 这 2.6KB 是 std 打印「文件名:行号」的地板价,没有一个调用点可以优化;要省它只能 -Z build-std + panic_immediate_abort(nightly 不稳定特性),那是另一个决定、不是 S8-2 顺手能做的事。同一把尺子顺手量出两件更要紧的:① compiler_builtins::math 5,391 B(21.1%)是 render_into() 的 sin(同心波纹画面本身要的,别改成手写查表——省 5.4KB 换一个没人验过的画面确定性);② 测试探针占了包的 26.2%:控制实验(mod pal_probe; 临时挂 --cfg me_noprobe,只改这一个条件)code 段 25,683 → 19,188 B(−25.3%)、data 2,397 → 1,285 B ⇒ 发布包 29,019 → 约 21,412 B(−26.2%)。探针这件已 fyi A3:不能删(它是 test_wx_platform.mjs 的唯一来源,走生产路径 WxStorage → abi → import → platform.js → wx.*),要用 feature 隔开、测试开发布关。 所以这一项剩下的是 no_std 子集一件——它仍然不该一个人动(横跨 A1/A2/A3 三个扇区、会改变每个 crate 的错误处理写法),仍然要单独立项。
  • A2音频:opus 低码率 + 大文件改运行时合成3 人日
  • A1分包图划分:按场景可达性做图划分(最小割近似)5 人日
    在写:分包图划分(5d)—— 未开始,日期已承诺 N-104:2026-11-03。展开 542 字
    分包图划分(5d)—— 未开始,日期已承诺 N-104:2026-11-03。 me pack 现在只读分包配置做一致性检查,不切产物(S2-7 里明写「本迭代明确不做」)。要做的就是把「哪些内容/资产进主包、哪些进分包」算出来并真的切。它卡着 A2 的 S8-6(首帧优化,5d)。 为什么排在 S5-6 之后:图划分要先有真实的多内容工程才谈得上——现在 content/ 是空的,包里只有 wasm 与胶水。先切一个不存在的集合,切出来的图没法验。 2026-10-27:图划分的输入表有了。 分包图要回答「哪些资产进主包、哪些进分包」,而在此之前资产在 MIR 里没有名字——inputs: { mesh=a_ground_mesh } 里的 a_ 是一个谁都不校验的字符串,更不知道它对应哪个文件。现在 assets { a_x: "path" } 是文档级声明表,path 就是「它从哪来」。这不解开 S8-4 的前置(「真实的多内容工程」仍为空,content/ 里没有东西可切),但它把「切什么」从图遍历问题变成了读一张表。没变的一条:me pack 仍只做一致性检查、不切产物。
  • A3包体分析器:按模块/资产类型归因,输出可执行建议4 人日
    包体归因落地为 me size:一份已打好的包拆成「谁在占」——按资产类型族 × 顶层目录 × 包三个维度,字节降序,每族带最大的那几个文件;展开 1225 字
    包体归因落地为 me size:一份已打好的包拆成「谁在占」——按资产类型族 × 顶层目录 × 包三个维度,字节降序,每族带最大的那几个文件;--baseline 给与上一版的净变化(用 git show HEAD~1:<...>/pack.json 取旧账本)。 为什么不并进 me pack --analyze:pack 会清空并重写 dist/("想看一眼账"要付一次全量写盘),且它的输入是一份工程;size 的输入是一份目录,已上传的包解出来的、CI 下载的产物都能分析。代价是两份遍历——所以加了一条会红的断言(归因总和必须等于账本总量,三个维度加总都回到同一个数),两份实现可以存在,但不能对同一个数有第二种回答。 它做的第二件事是核对账本与产物是不是同一时刻的:dist/ 被人手改过、删过文件、塞进旧资源时逐条报 Error(003/004/005)并让退出码非 0,结论行不再打 ✓。归因一律取盘上实测,盘上没有的文件不计入——第一版拿账本兜底,删掉 500KB 音频后报告仍写「音频 500KB(54.3%)」,与同一屏那句「盘上没有」直接矛盾。 不给「可省 xxx KB」,这是硬约束:给百分比要假设压缩率,而那取决于内容与参数,工具都不知道;编出来的数会决定优先级,排序反了的代价是一周。建议只给实测事实 + 指向具体任务的动作(S8-1 纹理压缩 / S8-2 wasm 体积 / S8-3 音频转码 / S8-4 分包图划分),以及「主包余量低于 400KB」这条还没超时就该说的提醒。 顺手修的三处会漂的重复:pack.rs 的 JSON 读侧搬进 json.rs(生产者与消费者共用一份解析器)、pack::kb/pack::worse 提为 crate 可见、契约 §1 新增「子命令专属 flags」表(--baseline 写到 pack 上是用法错而不是静默忽略)。 归因进账本(N-030,A1 选 A):账本的 files[] 每行追加 module 与 kind,打包那一刻判定、与 bytes 同一时刻产生;me size 改成读这两列、不再按后缀重判。三条约束各有会红的断言:只追加不改键序(中间插键会让账本 diff 退化成整行重写)、从 walk 推出不重扫、认不出的后缀写「未归类」并报 ME-PKG-025 点名而不是留空。顺带把 size.rs 的 Family::of 删了——它和 pack.rs 的 UPLOAD_EXTS 本是对同一件事的两份判定;聚合排序统一到 pack::tally,两侧不会对同一个数给出两种答案。老账本读不到 kind 时退回猜后缀,但报 ME-SIZE-015 说「这是猜的」。
  • A2首帧优化:首场景最小化 + 占位资产 + 并行下载5 人日
  • A1真机安装验证 5 台(含最差机型)4 人日
  • A3冷启动埋点(分段计时:wasm 加载/初始化/首场景)2 人日
    真机数字到了,而且推翻了上一轮的结论。 同一份 wasm:node/V8 + 假 gl 预热后 2.8ms,真浏览器 + 真 WebGL2 稳态 227–290ms、首趟 544ms。展开 1089 字
    真机数字到了,而且推翻了上一轮的结论。 同一份 wasm:node/V8 + 假 gl 预热后 2.8ms,真浏览器 + 真 WebGL2 稳态 227–290ms、首趟 544ms。差的两个数量级来自假 gl 根本没有的东西(真的 GL 上下文与着色器编译、真网络)——所以那 2.8ms 从此只能当相对比较用,不能当用户感受。 最有价值的一条是「编译成本会移位」。 六趟里三趟 wasm_compile 0.8ms / first_frame 208–266ms,另三趟 wasm_compile 141–168ms / first_frame 77–84ms,而合计始终 208–270ms。这是 V8 分层编译:WebAssembly.compile resolve 时只完成 Liftoff,TurboFan 还在后台线程跑、跟随后的 JS 抢 CPU。所以报告另列一行「编译+首帧」合计——单看 compile 那一格会读成「编译优化到位了」,而它只是把活儿推给了首帧。 工具 apps/coin-run/measure-coldstart.mjs(CDP,不进 CI):不加 --disable-gpu(加了会退到 SwiftShader 软渲染,测出来的不是玩家机器);每趟重新导航 + 每次全新 profile(reload 会复用已编译的 wasm 与已建 GL 上下文);退出码区分「测到了但慢」与「压根没测到」(负向验过:页面不存在 exit 1、服务没起 exit 2)。顺带修了一处垃圾泄漏:cleanup 在 Chrome 退出前删 profile,Windows 文件锁让 rmSync 静默失败,实测每趟 12MB、7 趟 84MB。 还差:首帧预算的阈值等 S8-6 定目标——现在写死一个数就是替 S8-6 做主。 稳态那半在 2026-10-25 补上了(D-11):tools/bench/frame_time.mjs 量帧内 CPU 而不是 FPS,本机 Intel Iris Xe 实测 0.325ms/帧、占 17.5ms 一格的 1.9%,1360 帧掉帧 0 长任务 0。配套两条硬结论写进 docs/17:不跨源隔离时计时刻度只有 100µs(对 0.3ms 的测量只剩 3 格),以及「一帧里 wasm 占多少」从宿主侧拆不出来(exports non-writable + Proxy 不变量),只能由 S7-4 自己埋点。

目标:把"AI 能生成一个关卡"变成"AI 能生成十个关卡且质量稳定"。

  • A1世界语法 v0:8 条布局规则(乡村 / 小镇 / 室内各一组)5 人日
  • A1构件库 v0:120 个构件 + 元数据(结构规格 + 语义标签)5 人日
  • A1资产库双索引:语义向量 + 结构规格过滤5 人日
  • A2规范化闸门:重拓扑/UV/单位朝向/LOD/材质烘焙 + 拒绝原因5 人日
  • A1关卡生成器:语法 + 构件 + 预算约束 → MIR5 人日
  • A1关卡 4–10 生产(AI 生成 + 人工 review)5 人日
  • A3采纳率统计脚本(按 MIR 节点数,非人工估算)3 人日
    新增 me survey adopt <生成版> <采纳版>——把 DoD 里那句「AI 生成占比 ≥50%(脚本统计)」变成一条能跑的命令。展开 1253 字
    新增 me survey adopt <生成版> <采纳版>——把 DoD 里那句「AI 生成占比 ≥50%(脚本统计)」变成一条能跑的命令。 输入是两份 .mir 的差,读者是排产的人:他不关心哪一行改了,只关心这一轮 AI 交的东西有多少真被人留下。 三个口径缺一不可,只报一个必然自我美化。 只报「AI 占比」时,分母是采纳版——删掉 1/3 的节点它还是 100%,报表上一片满分。所以同时给:keep(原样保留 / 生成版)、survive(保留+改动 / 生成版,就叫留存率)、ai(保留+改动 / 采纳版)。真跑演示过这个陷阱:生成 3 节点、删 1 个、改 1 个,AI 占比 2/2 = 100.0%,留存率 2/3 = 66.6%——实话在第二行。 「改过」必须与「删了重建」分开,靠的是内容指纹。 content_key 拼 op + 全部输入 + attrs + budget + reqs + fallback + provenance + tags;关键是语义无序的字段先排序再比——tags: ["ui","fg"] 变成 ["fg","ui"] 不是改动,inputs/attr/req 同理。指纹不含 at(源位置),否则挪动一行就算改过。这四条正是单测里变异能抓到的:删掉 tags.sort_unstable() 只有「重排tags不算改动」变红,其余 9 条全绿——说明这条断言不是装饰。 分母为零时不编百分比。 permille() 返回 Option,0/0 印 — 不印 0.0% 也不印 100%;「没有候选节点」和「一个都没采纳」在报表上必须长得不一样。整数千分比而非浮点,免了 66.66666% 这种噪音。 排序规则是报表规则,不是评分。 按算子汇总时 removed * 2 + modified 降序——删比改贵,权重 2 是让人一眼看到最该改的项,不是给 AI 打分(注释里写明了,防止后来人当 KPI 读)。 踩到 Rust 2024:gen 是保留关键字(generator 块),字段名都不行。SurveyArgs.gen → candidate,顺带把 Adopt.gen_nodes → cand_nodes、OpRow.gen → total。报错只有一句 expected identifier, found reserved keyword,改一处连带一片。 与 me diff 的分工:diff 回答「两份 MIR 差在哪」(逐个节点、给人看);survey 回答「这一轮 AI 的活被采纳了多少」(按算子汇总、给报表看)。合并没有好处——diff 的读者在调试,survey 的读者在排产。

目标:把"能玩"变成"能上线"。

  • A15 台真机兼容矩阵(3 安卓低中端 + 2 iOS)6 人日
  • A3崩溃收集 + 符号化(wasm 栈还原)4 人日
    在写:符号化那半边到了,收集那半边没到。 CLI 侧:me sym 把 wasm-function[4127]:0x2f6 换成函数名,索引按全索引空间算(import 偏移漏了会整体偏 N 且报告…展开 3217 字
    符号化那半边到了,收集那半边没到。 CLI 侧:me sym 把 wasm-function[4127]:0x2f6 换成函数名,索引按全索引空间算(import 偏移漏了会整体偏 N 且报告看起来正常,有断言钉着);--emit-map 在名字还在的那一刻产出一份 me.sym.v1,--map 在崩溃栈回来时还原。 本轮最有用的产出不是功能,是三个实测数字:①apps/coin-run/wasm/me_runtime.wasm(305KB)与 apps/minigame-smoke/wasm/me_render.wasm 里一个 custom 段都没有——wasm-opt/strip 把名字连 name 段一起清了,所以「从 wasm 里读名字」这条路在线上产物上不存在,符号表必须在构建时另存(与发 .pdb/.dSYM 同理);②name 段里的 1722 条名字有 1675 条是 v0 修饰(_R…),legacy _ZN 零条——我原来按 legacy 写的判断是错的;③v0 里解得出「纯路径」形态的只有 149/1700 = 8.8%,其余是泛型/impl/回溯(_RI…/_RX…/_RM…/…B7_)。 所以 me sym 现在只解纯路径,带泛型的原样返回并在汇总行报数。解一半会产出一个看起来合法的假名字,人拿假名字去改代码比看到修饰名贵得多。 还差两件,都不该我一个人拍板:①v0 泛型怎么解——完整 demangler 是几千行的独立工程(Rust 官方那份就是),两条路是「引入 rustc-demangle(破零依赖)」或「自己写完整 v0(S10 排不下)」,这个取舍要 A1 定;②崩溃收集那半边(wx.onError → 上报 → 落到日志),属于 me-pal-wx,依赖上报通道的隐私口径(S11-1 隐私协议),现在做等于替 S11 预支一个还没定的承诺。 2026-10-26 续:版本判据换了,符号表第一次真的产出来。 原来 --map 只比函数总数,这条判据有个「绿得让人放心」的洞:module 是文件名、函数总数改一个函数体一个字节都不变,所以贴错版本的符号表会被放行,然后给出一串看起来正常的错名字——人拿它去改代码,代价比没有符号表高一个数量级。现在记 code: {bytes, fnv1a64},强弱两道并行。实测这条路多容易踩:[profile.wasm-symbols] 只把 strip 换个写法重编,code 段 218,913 → 218,907 B(差 6 字节),函数个数一条不差、旧检查照样通过——换 profile 名就会让 codegen 变,所以走 RUSTFLAGS。tools/gen/sym-map.sh 三步产出(build → --emit-map → 用工具自己的指纹核线上产物),落 build/sym/(不进包:.json 在上传白名单里)。首份表 1123 条 / 指纹 0x2785a826397d7af3,拿线上 wasm 把 wasm-function[900] 还原成 NullBackend::draw。判据自身有牙齿:test_sym.sh 5 → 9 条,第 6~8 条现场合成两个最小模块(import 数 / 本地函数数 / name 段全同,代码段只差最后一个字节)——这个形状真产物给不出来,而要验的正是它。 还差的没变:① v0 泛型怎么解(完整 demangler 是几千行工程,破零依赖还是自己写,要 A1 定);② 崩溃收集那半边(wx.onError → 上报 → 落日志,属 me-pal-wx,依赖 S11-1 的隐私口径)。 2026-10-27:① 那个「要 A1 定」的取舍定了 —— docs/adr/ADR-0014-rust-symbol-demangle.md,走集成。 | # | 结论 | 一句话理由 | |---|---|---| | 1 | 引入 rustc-demangle(Rust 官方,MIT/Apache-2.0,正常使用零运行时依赖) | ADR-005 的判据直接适用:不是差异化 + 有成熟方案 ⇒ 集成 | | 2 | 只在 me-cli(L9,host-only);targets 含 wasm32 的 crate 一律不许 | 那些进包,多一条依赖就是多一份供应链与体积风险,而它们不需要解符号名 | | 3 | 不做门面(不 wrapper 成「我们自己的 demangler」) | 替换点本来就只有一处调用,多一层转发只多一处要维护、要测的东西 | | 4 | 解出来的名字原样输出::: 不换 .、<…> 不删、末尾 hash 保留 | 这个名字的用途是「拿它去 grep 代码」,加工一次就搜不到,而搜不到看起来像「代码里没有」 | B 为什么比它看起来贵:成本不是几千行,是没有语料。v0 的边角(泛型参数、impl 路径、回溯、const generics、闭包)靠推理写不完,写完也验不动 —— 全部样本就是那 1722 条,还来自一个产物的一份 name 段。而自己写的 demangler 会偶发解错,这类错没有症状:名字看起来对、长度合理、形态正常,然后人拿它去改代码。同一条理由(半解产假名字代价高)在「解一半是唯一可选」时指向「只解纯路径」,在「解全有成熟方案」时指向「引库」 —— 变的是可选集,不是判据。 这不违背「全仓零外部依赖」:那条到今天为止是真的(Cargo.lock 15 个包、非 me-* 的 0 个),但它一直是结果而不是规定 —— 没有任何 CI 步骤守着它,成立是因为此前每个决定碰巧都不需要外部 crate。ADR-005 早写了「什么时候可以引」。正因为没人守,它才容易在某次「顺手引一下」时悄悄破掉 —— 所以 ADR-0014 把边界写死成一张表,而不是留一句「尽量别引」。 三条判据(第三条是唯一能防「解得多但解得错」的): 1. Cargo.lock 的非 me-* 包从 0 变 1,且只在 me-cli 的依赖树里(cargo tree -p me-cli 看得到、cargo tree -p me-pal-wx 看不到)。建议做成 CI 守卫(tools/ci/** 是 A3 扇区,我没动)。 2. me sym 汇总行:「解不出」的条数从 1573 降到多少 —— 实测,不许预测。 3. 黄金样本逐字节对:至少 3 条已知的(wasm-function[900] → NullBackend::draw 已在用),包括 ::、<…>、末尾 hash。 ② 崩溃收集那半边不变:仍属 me-pal-wx,仍依赖 S11-1 的隐私口径,现在做等于替 S11 预支一个还没定的承诺。 待 A3 落地:crates/me-cli/Cargo.toml 加依赖 → me sym 改用它 → 把上面第 2 条的实测数字写回本条目。ADR 已转正(Accepted),build_site.py 的 DOCS 已同步(45 篇,check_coverage() 无漏登)。
  • A2内存排查:30 分钟循环 + heap 快照 diff5 人日
  • A2低端机降级:动态分辨率 + 画质档位下发4 人日
  • A3弱网 / 断网 / 后台切换 / 来电中断3 人日
    四个事件交错时的行为才是验收点。 三个维度(life / net / audio)各存各的,只在闸门合成——断网不停画面(单机游戏)、后台仍可联网(预取合法)、音频中断不影响渲染。展开 1046 字
    四个事件交错时的行为才是验收点。 三个维度(life / net / audio)各存各的,只在闸门合成——断网不停画面(单机游戏)、后台仍可联网(预取合法)、音频中断不影响渲染。非法取值当场抛错,不静默按后台处理(setLifecycle('Background') 直接红)。 最贵的一条是后台回来那一帧的 dt。 夹到 100ms 能让物理不炸,但那 100ms 是假的游戏时间——玩家没在玩。所以恢复后是「重置基准 + 推进 1ms」。last 放在消费者手里而不是 guard 里:一个页面可以有多个帧循环(demo 自检页就是),共享 guard 时基准会互相踩,现象只是「某个面板卡顿」。 弱网没有 API 可问,只能看自己的请求:窗口 10 条、超时率 > 30% 或 RTT 中位数 > 800ms → degraded。进入看窗口、退出看最近连续 3 次——两边都看窗口会让状态机能进不能出(慢样本把中位数钉死,加几个快样本也出不来),网络早好了游戏还当弱网。 做的时候抓到自己一个真 bug:samples.push 写在断网早返回之前,断网期失败样本照样入窗,后果是恢复后被历史样本立刻再降级(「网刚好了又不行」)。是新加的 D9 断言抓到的——而它第一次跑时原断言给的是假红,因为改成非对称判据后那个场景已经测不出差异。 31 条单元断言 + 5 个变异(夹取继续跑 / 后台不 skip / 退出也看窗口 / 断网样本入窗 / canRequest 只认 online,各自都能红)+ 真浏览器 20 项(CDP 真调 meSim、真读面板上的字)+ 宿主接线 81 项(真实 game.js + mock wx,含「老基础库缺 onAudioInterruption*」那一趟)。两份 guard.js 由 tools/ci/test_shared_copy.mjs 钉字节相同。 宿主侧修掉一个会伪装成「wasm 实例化失败」的坑:老基础库没有 onAudioInterruptionBegin 时直接调用会抛 TypeError,而那段代码在 .then 里 → 被 .catch 收走 → 屏幕上只显示「wasm 实例化失败」。改成能力检测并打出缺的 API 名字。 还差:小游戏真机验证——本机按约定不开开发者工具,事件已按 wx 官方接口接好。
  • A3留存埋点 + 漏斗(进入/过关/失败/退出)3 人日
    这一版交付的是口径与结构,不是数据流。 「可注入的上报接口」不等于「建好上报通道」:通道一旦存在就要回答发到哪、带什么头、重试几次、存多久——全是隐私口径(S11-1)的内容,在这里定等于替那…展开 930 字
    这一版交付的是口径与结构,不是数据流。 「可注入的上报接口」不等于「建好上报通道」:通道一旦存在就要回答发到哪、带什么头、重试几次、存多久——全是隐私口径(S11-1)的内容,在这里定等于替那一环预支承诺。所以 send 默认不传、不落盘、不上报聚合值,通道开了就能用,不开就一条数据都出不去。 漏斗不是一条链。 「进入 → 过关 → 失败 → 退出」听着顺,但过关与失败互斥:串成一条链之后「过关率」就没有分母了(分母该是「进过且没失败过的人」吗?那是把结果算进了分母)。所以主路径只有「进入 → 过关 → 退出」,失败单独一条,lostAt 只回答主路径上第一个没到达的步骤。 四件会悄悄错的事被逐条钉住:① 环形缓冲满了丢谁——dropped 必须能看见,否则「没有事件」和「事件被冲掉了」在日志里长得一样;② 上报失败必须回填且回到最前面——顺序错了服务端会把「过关后又进关」读成「进关后没过关」;③ 漏斗别自己骗自己:重复 enter 顶高分母、无配对 clear 顶高分子,两者都计数;④ 隐私白名单真的拦住 openid/位置这类键,且丢弃要计数(静默丢弃比不采更危险)。 测试抓到一个真 bug:微信 getStorageSync 取不到键时返回空串,而 Number("") 是 0 → 首启日被读成 1970-01-01 → 第一个新用户的留存就是 D20751,而报告上它长得像个合法值。 25 条单元断言 + 8 个变异(丢最新 / 回填顺序反 / 去白名单 / 失败串进主路径 / 允许负时长 / 空串当 0 / 宿主不接存储 / 切后台不记 session_end,各自都能红)+ 宿主接线 81 项。两份 telemetry.js 由 tools/ci/test_shared_copy.mjs 钉字节相同(该脚本原本只管 guard.js,加到第二个共用件时改成一张表——再复制一份脚本就会有两处相同逻辑)。 还差:关卡事件(进入/过关/失败)发生在 wasm 玩法层,宿主看不见,本次只接会话生命周期;真实上报通道等 S11-1。
  • A2压力测试:连续 100 次场景切换3 人日
  • A1+A2+A3Bug 修复缓冲6 人日

目标:过审、灰度、可回滚。这一迭代的外部依赖最多,必须留足时间。

  • A1隐私协议、用户协议、权限最小化3 人日
  • A1审核自查(微信审核要点逐条)+ 整改5 人日
  • A3广告 SDK + 激励视频(如采用 IAA 模式)4 人日
  • A3埋点校验 + 后台看板4 人日
  • A1灰度方案:5% → 20% → 100% + 回滚预案3 人日
  • A1提审 + 应对驳回(预留 2 轮)6 人日
  • A1运营素材:icon / 截图 / 简介 / 分类3 人日
  • A1客服与反馈通道2 人日
  • A1全量发布 + 监控值守(前 72 小时)5 人日
  • A1留存与漏斗分析(7 日)4 人日
  • A1工时台账汇总 + 与 Cocos 路线对比测算5 人日
  • A1六项指标核对表(每项给出数字与采集方式)4 人日
  • A1Gate 0 评审报告 + P1 范围建议6 人日
  • A2技术债清单 + 架构复盘(哪条 ADR 要改)4 人日
    11 条债分四组(等决定 / 有人认领就能修 / 口径债 / 要数据才能开工),每条给证据 + 不修的代价 + 修的前提;展开 1172 字
    11 条债分四组(等决定 / 有人认领就能修 / 口径债 / 要数据才能开工),每条给证据 + 不修的代价 + 修的前提;没有证据的不进表。§1 主动排除五项(没有并行调度、不做 PCM 自己混、28KB 还要不要压、debug 慢、"我不同意某设计")——这张表不排除它们就一定会退化成抱怨清单。提出的口径债里最值得看的是 D-09:时间类门槛永远不红(S4-9 的 1.5ms 对实测 142ns、S8-2 原来的 400KB 对 29KB 产物),共性是阈值贴"离硬限制多远"定而不是贴"体质"定。§3 的 ADR 复盘给三条落点:ADR-002 状态该从 Proposed 改 Accepted(状态债)、ADR-0006 加附注(绘制列表输入变成两个槽位)、新增 ADR-0013 父子变换合成。 2026-10-25 加固:这张表本身带着一个没写出来的前提——「我在哪个基线上看的」。 把 11 条逐个放到 origin/main 上核了一遍,结果是四类混在一起:4 条主干真实(D-07~D-10)、3 条只在本分支成立(D-01/D-02/D-06,依赖 A2 未提交的 mem.rs / hierarchy.rs——AssetHeap、Hierarchy、GlobalTransform 在主干上一个都搜不到)、2 条已消(D-03/D-05,都是落后 53 个提交的分支造出来的假债)、1 条原证据代码已不存在(D-04,Ctx::op_of 里的 self.ops.iter().find 在 main 上没有了)。按原样读这张表,Gate 0 会去修三条不该修的、重测一条已经有结论的,真正该修的只剩四条。 所以补了机械核验:plan/debt-baseline.json(每条债一组探针,一律跑在 origin/main 上,不是工作区)+ tools/ci/check_debt_baseline.py + CI 一步。退出码三档:0 一致 / 1 声明过期或探针写坏(红)/ 2 无法判定(降级不红——没有 origin/main 是环境问题)。claim 字段是人的判断,脚本不校验它:机器判不了「这条债该不该修」,假装能判会让判断也外包出去。 变异验证抓到一个真 bug:原先「一条债没有 probe」时脚本 exit 0,只说一句「没有 probe」就绿着过去——那正好是造假门最省事的办法(删掉探针而不是修好它)。现在「配置写坏」与「声明过期」一样红。四个变异各自转红,表在 docs/16 §6.4。
  • A3文档收尾:MIR 手册、构建手册、FAQ4 人日
    在写:三项里做完一项半。 做完的:docs/15-build-handbook.md(本轮的交付)——六条产物各一条命令、CI 的 38 步与降级口径、七条实测故障、两台机器差异表;展开 1763 字
    三项里做完一项半。 做完的:docs/15-build-handbook.md(本轮的交付)——六条产物各一条命令、CI 的 38 步与降级口径、七条实测故障、两台机器差异表;已加进 build_site.py 的 DOCS(新「运维」分组),站点文档 38 → 39 篇。MIR 手册那项在 S1-10 里已经交付(独立任务,20 个节点各配一份能跑的文件)。—— 还差 FAQ 的形态:故障表现在塞在构建手册 §4,是「按症状查」的表;而 FAQ 要的是「按问题查」的问答(比如「为什么我的存档在 iOS 上没了」→ 小游戏 localStorage 可能被系统清理,quota() 不是装饰)。两者读者不同:前者是正在构建的人,后者是正在用引擎的人。不是补几行字能了事,得先有真实的用户提问——现在一个都没有,硬编 FAQ 等于写小说。等 P0 可玩切片有人真跑起来再补。 2026-11-05 补:手册里有三处过期,订正时顺手把一条降级从「没跑」变成「真跑」。 ① 「只认完整浏览器,不认 chrome-headless-shell —— 它不认 --headless=new」——后半句 2026-11-04 已被实测推翻,tools/find-chrome.sh 改了,手册没改(同一个事实两个上游,改一处必漏另一处)。现在手册只写「去哪儿问」,不再重述它的三条约定。 ② 「那 6 项降级」的表:实测 20 项,且没有任何检查器看着它 ⇒ 它只会往后漂。改成只列任何机器上都消不掉的四类(macOS-only / Windows-only / 微信运行时 / 待复核),其余每一条的补法由脚本自己打在 ! 那行里 —— 「怎么补」放在报错里,不放在文档里。 ③ 「55 步,约 170 秒」:实测 105 个 step、317~689 秒。改成不写死数,要看准确值看末行 通过 (Ns)。 降级那条是实的:WB-NO-BROWSER / VP-NO-BROWSER 都写着「没有 playwright-core」,而本机一直装着 —— 真因是 npm root -g 指在 ~/.workbuddy/binaries/node/versions/22.22.2-6/lib/node_modules,路径里带版本号,装在那儿等于押 WorkBuddy 不升级;症状却是「没有包」,教人去重装。包改到 ~/.local(本机独立 node prefix),两份 run-*.sh 的 find_playwright 都加这一处探测。实测:工作台视觉 4 组视口 0 违规 + 行为 15/15,视口 14/14 —— 这 29 条判据今天第一次在本机真的绿过(此前是「没跑」,而没跑与跑过在报告里长得一样)。 ⚠️ 同轮的副作用要记:降级总数没变(20 → 20),因为新增了 PERF-LOADED(负载峰值 74.6 / 8 核,超阈值的数字仍打在上面)与 XSECTOR-PENDING(这两条代修正等 A3 复核)。 2026-11-05 再补三处(都在同一天发现,因为这一夜真的把降级从 20 降到 7):① 我自己两小时前写的「5~10 分钟」也是错的——实测 1976 秒(33 分钟)。改成不给区间、给关系:时长的主要变量不是「改了多少」,是「有多少条真机判据这一轮真跑起来了」(20 项降级那轮 317 秒、7 项那轮 1976 秒)。「CI 变快了」要先看降级数,快可能只是跑得少。② 故障表加「十几条 *-NO-CHROME 突然一起降级、下一轮同样的树全绿」—— 真因是候选里那个稳定挂住的浏览器被字符串升序排在前面,而好的那个偶发也挂一次。③ 故障表加「site.sh 报可试玩页资产不同步」—— 那是在发版工作树里跑,apps/coin-run/wasm/ 是 gitignore 的,那份永远旧;修法是在那边重建 17 秒,顺手 cmp 两个工作树的产物。

目标:先把九个块共用的那层数学立成一份,再把 me-physics 从「最小集」推到

  • A32D 数学库:Vec2 / 仿射 Mat2x3 / Rot2(sin_cos 只在这里调用)/ AABB / 贝塞尔与缓动 / 确定性定点5 人日
    在写:交了数值那一半,几何那一半没有(2026-10-28,A3 交、A1 合并)。展开 2794 字
    交了数值那一半,几何那一半没有(2026-10-28,A3 交、A1 合并)。crates/me-math 已经进 main:8 个模块、84 个 pub fn、3,004 行 / 82 个测试全绿、零依赖,而且全程不调任何一个第三方超越函数(sqrt 走位模式初值 + 牛顿,sin/cos 走 Cody-Waite 归约 + 泰勒)——理由是三份 libm(x86 / wasm32 / iOS)的 sin 最后一位不保证相同,差一位就足以让判据换个机器跑就红而改的人找不到原因。但它不等于 S13-0 那条 DoD。 计划里点名的 Mat2x3 仿射矩阵、Rot2 类型、Aabb、缓动曲线集、确定性定点,在 src/ 里 grep 0 命中(Vec2 也只是 [f32; 2] 上的自由函数,不是类型)。已交的八个模块是 scalar / trig / vec / curve / poly / series / integrate / stats,那是「游戏里会用到的数学」,不是「S13-2 的窄相明天就能拿它开工」。所以不记完成:判据不是「有没有数学库」,是「S13-2 拿它开不开得了工」。另一处缺口:演示 apps/math-lab 与互校方 crates/me-rigid2d(tests/cross_math.rs 拿两份实现对照)都还在 agent/A3 上没上 main,因此 tools/gen-math-functions.py --check 在 main 上读不到 scenes.rs 的 KINDS 会红——这步没进 CI,tools/ci/drill-math.sh 也没带,等 S13 物理那批合并时一起补。 2026-11-05 更正:Mat2x3 已经有了;另外三个是「决定不做」,不是「没做」。crates/me-math/src/geom.rs(A3,2026-10-31 由 A2 代修搬入)里有 Mat2x3:六个裸 f32、列主序、from_trs / then / det / to_array / from_array / transform_point,源身前是 me-anim 的 Affine2。搬家的理由写在 plan/proposals/A1-math-supplier-review.md:这个 crate 当时是函数供应商,而引擎要的是类型供应商——「用」的具体动作是在模块之间传同一个类型,Affine2 是全仓唯一已经存在的几何类型。所以 L0 第一次有了能往下传的东西,me-anim 是第一个消费者。上面那句 grep 0 命中 对 Mat2x3 已经不成立了。 Vec2 / Aabb / Rot2 仍然没有,但那是裁决过的:它们今天的消费者(me-ui 的 Rect、me-physics 的 Aabb、me-render 的 corners_of)分别躺在不同扇区,迁移是另一件事;「先进三个没人用的类型 = 凭空多三份真相 + 三条会腐烂的公开面」,而 docs/10 那条「struct Vec2 只命中一处」的判据对 0 处和 3 处同样绿。原文在 geom.rs 模块文档「只有 Mat2x3,没有 Vec2 / Aabb / Rot2」那一节,引它比复述它可靠。 2026-11-06 更正:上面那段(我 11-05 写的)里有两句是假的。 ① crates/me-physics 与 crates/me-rigid2d 2026-10-31 就进了 main(da4a1b88「A3 分支合入主干(39 处冲突 / 契约 v27 / 三份 ADR 重编号)」),git ls-tree origin/main crates/ 两个都在,apps/math-lab 也在。② 因此 tools/gen-math-functions.py --check 今天在 main 上是绿的:「清单一致:94 项 / 11 组 · FUNCTIONS.html 与 FUNCTIONS.ai.md 都是最新的」(刚跑)。原文那句「在 main 上读不到 scenes.rs 的 KINDS 会红」是 10 月底的事实。 我为什么会写错,比错本身重要:当时的判据是 ls crates/ | grep -i "phys|rigid" 返回空,于是写下「今天 crates/ 下两个都没有」。本机 grep 是 toybox,该有输出时会静默返回空(同一条教训上一轮刚写进 MEMORY §三)。危害不在「找不到」,在它给出的是一个看起来有据可依的否定结论,而否定句最省事、最难被下一个人反驳。⇒ 「待核」的动作必须是换一个工具复核(git ls-tree / Grep 工具 / 眼睛看 ls 全表),不是把原文再读一遍。 S13-2 今天卡在哪(重新定位,带数字):不是依赖,是 ADR-0017 第 80 行那条止损判据——「100 个刚体堆叠 10 秒:不炸、不穿、不抖」——实测不达标,而且不需要调参就能看见:10 摞 × 10(正好 100 个)22 个穿透地面、终速 12 170 px/s;临界点在 7 层(4/5/6 层零穿透,7 层掉 2 个),而 tests/scenarios.rs 里最大的堆叠是 a_stack_of_five_boxes_stays_a_stack(5 层,正好卡在崩溃点下面一层)——71 条判据全绿,一条都没进这个区间。控制实验排除了两个省事解释:不是「堆太高」(10 层的塔最高点才 y≈-45,照样掉),也不是「迭代不够」(100/50 时 10 摞 × 10 全好,但同档下 1 摞 × 20 仍掉 10 个;且 20/10、40/20 两个中间档比默认 8/3 更差)。实验代码与三张表在 plan/proposals/A1-rigid2d-stack-probe.md,已开 N-153(A1 → A3,到期 2026-11-20)。没有直接加测试:它会立刻红、堵住主线 CI。这不影响线上(coin_run 用的仍是冻结的 me-physics)。
  • A3碰撞形状:圆 / OBB / 凸多边形 + 层掩码 + 从形状推质量与惯量6 人日
  • A3窄相:SAT + 接触流形 + 接触点跨帧缓存(复用是稳定性的来源,不是优化)5 人日
  • A3顺序冲量求解器:摩擦锥 + 恢复系数 + 位置修正 + 热启动6 人日
  • A3关节三件套:距离 / 旋转 / 焊接(棱柱延到 P1,P0 没有用例)3 人日
  • A3查询 API:raycast / shape cast / overlap,带 filter 与排序3 人日
  • A3定步长:固定 1/60 累积器 + 休眠 + 宽相 SAP(在 me-physics 内)2 人日
  • A2渲染插值:把 alpha 交给渲染,落点是 me-runtime,不碰物理内部1 人日
    alpha 交给渲染:InterpTable(上一帧位姿)+ collect_culled_interp + set_alpha/set_interp,六条判据含恒等元逐字节;展开 420 字
    alpha 交给渲染:InterpTable(上一帧位姿)+ collect_culled_interp + set_alpha/set_interp,六条判据含恒等元逐字节;第二半接上真游戏(?interp=1 → me_coin_run_interp → Game::set_interp),第三半发布页/导出清单,第四半三份宿主接线判据 + 端到端截图。第五半收尾:内存代价量过了(InterpEntry 实测 32 B/条、4096 精灵 131072 B = 128.0 KB),并修掉表只增不删的无界增长(begin_frame 淘汰连续两帧没收到的条目 + allocated_bytes(),三条新判据 + 反向实验);真机运动中对比截图给出 0.01% 像素差且全在 HUD 数字区,结论是虚拟时间下 alpha 恒为 0,要拍到差异必须先造出 alpha ∈ (0,1000) 的帧——欠账如实保留,没拿假图销账
  • A2粒子系统:发射器 / 生命周期 / 曲线 / 混合模式 / 对象池5 人日
  • A3特效时间轴:序列帧 / 拖尾 / 屏幕抖动 / 后效挂钩点3 人日

目标:一套类 Spine 的 2D 骨骼动画,能读 Spine 导出的 JSON、能蒙皮、能形变。

  • A2骨骼层级 + 变换:局部/世界、继承标志(旋转/缩放/反射)、不动点4 人日
    局部姿势 → 世界矩阵这一步被单独钉死了(2026-10-29,A2)。展开 400 字
    局部姿势 → 世界矩阵这一步被单独钉死了(2026-10-29,A2)。crates/me-anim 是一个 L4 crate:Affine2 六元组、Bone、拓扑序 + 成环检测、五种 Inherit(Spine 语义照抄)。5 条内联 + 12 条集成判据,五种继承各断言世界矩阵的六个分量,不是「看起来像」。为什么先做它:S14-2/3/5/6 全在它的上面,世界矩阵先钉死,后面四条不用叠在「本来就算对了」的假设上——理由与 S13-0 同构。顺带把「确定性」从一句口号变成一条会红的判据:16 个角度的 sin/cos 与一个子骨骼世界矩阵的六个分量,在 x86 与 wasm 上逐位相同(wasm-host/ + tools/golden.mjs,CI 一步)。这是 me-math 存在理由的第一个硬证据,也是它的第一个真实消费者。
  • A2关键帧时间轴:线性 / 阶跃 / 三次贝塞尔 + 轨道混合权重5 人日
    第一种插值模式与第一个迭代算法(2026-10-29,A2)。展开 502 字
    第一种插值模式与第一个迭代算法(2026-10-29,A2)。Curve / Interp(线性 · 阶跃 · 三次贝塞尔)/ Key / Track,加 blend / blend_angle 的轨道混合权重;12 + 18 条判据。三个决定各有一条判据守着:插值模式挂在起点关键帧上(Spine 语义,挂在终点则第一帧没有终点可挂);c1x/c2x 限在 [0,1] 而 c1y/c2y 只要求有限(前者是时间、要有唯一反解,后者允许负数与 >1——那是预备动作与过冲);权重 0 与 1 逐位精确(lerp(a,b,1.0) 是 a+(b-a),a=1.0/b=1e-8 时它给 0.0 而不是 1e-8)。反解写成固定 20 轮二分而不是牛顿:牛顿的终止判定本身就是浮点比较,可能在不同目标上于最后一次迭代分叉;二分次数是常量,于是「同一份输入给同一个 t」可以被证明而不是被希望。这条「可以被优化掉的确定性」由第三张 golden 表(12 个采样点)盯着——它是全仓唯一一处把迭代过程本身钉住的判据。
  • A22D 蒙皮:网格 + 权重 + 骨骼绑定 + 每帧 CPU 变形7 人日
    蒙皮的两半都做了,而收益不在我以为的那一头(2026-10-29,A2)。展开 789 字
    蒙皮的两半都做了,而收益不在我以为的那一头(2026-10-29,A2)。计划写的是「每帧 CPU 变形」,我先量了 CPU 那条:50 骨骼 / 2000 顶点 = 0.011 ms/次(5.58 ns/顶点)——DoD 的 2ms 早就过了两个数量级,所以「换 GPU 是为了让 2ms 变 0」是错的(§89 结尾我这么建议过,已在提案 §90.1 撤回)。真正的差距在蒙皮之后:CPU 路径每帧要把 80,000 B 变形结果写回顶点缓冲,GPU 路径只上传 1,600 B 调色板,50 倍,且随顶点数继续拉开。判据因此不量时间(跨机器不可比,最后都会被 #[ignore]),而是数「这一帧往顶点缓冲写了几个字节」= 0。最值钱的一条是 the_two_paths_agree_on_the_ndc_position:同一个顶点,着色器算的和 Rust 算的必须落在同一个 NDC —— 把两条独立实现钉在一起,一边改了立刻红。四个真 bug 全是「静止时两种错法给同一个答案」:调色板该 W · B⁻¹ 还是 B⁻¹ · W(绑定姿势下逐位相同)、矩阵装行还是装列(旋转为 0 时 b=c=0,行列长得一样)、以及 U8x4 恒归一化导致骨骼索引少乘 255(症状是整张网格只认 0 号骨骼、角色堆在原点)。契约选择也记一笔:slot 3 起的一段 vec4 槽位,而不是新增 set_uniform_vec4_array —— 新增 ABI 函数要动 12 处,漏一处的后果是 wasm 里连 import 都不出现、整页 LinkError,而槽位区段的代价只是每帧约 100 次 uniform4f(~30µs)。真机:两页不加载 wasm,3 秒跑完(着色器编译 5 项 · 像素 6 项)。
  • A2形变动画:顶点偏移轨道 + 法线重算 + 与蒙皮共用网格4 人日
    形变是独立属性,而三处判断里有两处我第一遍写错了(2026-10-30,A2)。展开 1097 字
    形变是独立属性,而三处判断里有两处我第一遍写错了(2026-10-30,A2)。计划写的是「顶点偏移轨道 + 法线重算 + 与蒙皮共用网格」,落成 DeformTrack(全部顶点共享一次时间查找——2000 顶点 × 2 分量若各调一次 Track::sample 就是每秒 12 万次二分,而它们的结论是同一个下标)、QuantizedDeform(u16 档位,误差上界 步长/2,用例同时钉声明与实测)、Mesh::skin_deformed(与 skin 走同一条乘加循环 ⇒「偏移全 0 等于没形变」由结构保证)、normals::recompute、以及 GPU 侧的 a_deform(location 5 · slot 1 · 8 字节/顶点)。错的第一处:量化用 Vec<i16> —— LEVELS=65535 而 i16 只有 32767 档,as i16 是饱和转换,跨度最大那一端全被压到 32767,误差等于整个跨度(判据报「5.0000763 超出上界 0.00009155」,那个 5.0 正是顶点自己的偏移量);改 u16。错的第二处:法线用「三角形第一条边给三个角」⇒ 结果依赖索引顺序,正方形上两个角对、两个角错;改成「每条边贡献给它的两个端点」。另有两条期望写反了:2D 边法线的方向完全由几何决定,绕向翻转后边向量取反 × sign(cross) 翻转 = 同一侧 ⇒ 用例改名成 flipping_the_winding_does_not_move_the_normals,真正能抓「漏了 sign(cross)」的是镜像那条。一次真优化:法线里每条边那次 sqrt 是白算的(权重就是边长),删掉后法线重算 1.140 → 0.513 ms、整链路 1.371 → 0.732 ms/帧。最贵的一条判据只为一件事存在:skin_deform.vs.glsl 与 skin.vs.glsl 逐行 diff 只许差两行 —— 哪天有人为形变另抄一份 main(),diff 会变成十几行,而那时画面对得上,真问题要等到下次改权重才出现。量化的收益如实写:2 倍,不是数量级(提案 §91.6)——50 倍那个数字是 S14-3 蒙皮的功劳,两件事混一行写会让人以为量化值 50 倍。真机:两页对两条管线各跑一遍(着色器编译 11 项 · 像素 14 项),不加载 wasm,3 秒跑完。
  • A2IK:两骨解析解 + 多骨 FABRIK(含极点与迭代上限)4 人日
    两骨走解析解不是为了快,是为了「结果与初值无关」(2026-10-30,A2)。展开 1043 字
    两骨走解析解不是为了快,是为了「结果与初值无关」(2026-10-30,A2)。计划写的是「两骨解析解 + 多骨 FABRIK(含极点与迭代上限)」,两条都落了:solve_two_bone / apply_two_bone / FabrikChain(18 内联 + 14 端到端判据)。为什么两骨不也用 FABRIK:FABRIK 收敛到离初值最近的那个解,而初值是上一帧的姿势、上一帧的姿势依赖帧率——掉帧时迭代起点不同,多解时可能收敛到另一个解。两骨有闭式解,一步算出、与初值无关,所以「同样的动画在同样的时刻给出同样的姿势」可以被证明而不是被希望。极点:两骨在几何上有两个镜像解,余弦定理只给夹角大小、符号丢了,所以 Bend 是显式参数;FABRIK 反过来不该有这个参数(多骨链上「极点」本身很模糊),它的极点就是初始姿势,from_points 是控制它的唯一入口,判据 the_pole_of_a_fabrik_chain_is_its_initial_pose 钉住这一点。精度:DoD 是「两骨 IK 末端误差 ≤0.5px」,实测 0.000038 px(108 个目标,最坏在接近伸直的那一档),余量 13000 倍;FABRIK 到 0.01px 只要 1~2 轮。两处真错:① FABRIK 的 forward pass 方向符号写反(p[i] = p[i+1] + dirs[i]*len —— 把链往外拉),症状不是 NaN 也不是报错,而是永远不收敛(32 轮后误差还有 41.97px);② apply_two_bone 里世界角→局部旋转要减父的新世界朝向,图省事只 update_world 一次时读到的是解算前的父矩阵,症状是「静止时完全正确、动起来才歪」,所以函数里更新两次并写明原因。一次自我撤回:模块文档原写「acos 在伸直处精度崩掉所以用 atan2」,实测两者误差是同一个数(0.000034 vs 0.000038 px,因为本库的 acos 就是 π/2−asin,也要过 √(1−cos²))⇒ 文档改成「选 atan2 的理由是符号天生在里面 + 少一次往返,不是精度」,并把对照数字留在 examples/ik_report.rs 里,省掉下次有人想换回去的重复实验。
  • A2附件与槽位:切换 / 绘制顺序 / 与 MIR 节点 id 对齐3 人日
  • A3状态机与混合:1D blend + 过渡时长 + 事件轨(脚步/受击)4 人日
  • A1me import spine:Spine JSON → MIR,含版本与字段校验、拒绝清单3 人日
  • A2transform 约束:四种更新模式(world/local × absolute/setup)+ 三条通道各自 mix + 从 JSON 读入并按 order 排3 人日
    约束把资源规模从 N×M 拉回 M(2026-10-31,A2)。展开 490 字
    约束把资源规模从 N×M 拉回 M(2026-10-31,A2)。S14-1~8 解决「一条动画能播」,这一条解决「不必为每一种手的摆法各 K 一条轨道」。落成 constraint.rs(Frame × Anchor 两个轴 = 四种更新模式、三条通道各自 mix、ApplyReport 记跳过)与 spine 侧的 read_constraints / Doc::bind_constraints(按 order 排,不按书写顺序)。三条取舍写在代码里:混合必须在父坐标系里做(六种 Inherit 下对世界矩阵做逆运算会丢掉父的缩放);mix = 1 走 blend / blend_angle 而不是 scalar::lerp(后者在端点不保证逐位);shearMix 进 Skipped 而不是被静默忽略(Bone 没有剪切通道)。两个真 bug:链检测第一版对 bones = [父, 子] 这种最自然的写法漏判;退化检查打在被约束骨的 setup 世界上,把一份合法资源直接拒了。
  • A2路径约束:位置 / 间距 / 朝向三个模式轴;配套 me-math::arc 弧长表与按距离反查3 人日
    等参数不等于等距离,弧长表是唯一解(2026-10-31,A2)。展开 507 字
    等参数不等于等距离,弧长表是唯一解(2026-10-31,A2)。路径约束三个模式轴各自独立(位置 Fixed/Percent、间距 Length/Percent/Proportional、朝向 Tangent/Chain),一档对应一种资源真的会用的形状:履带用 Tangent、尾巴用 Chain、皮肤贴曲线用 Proportional。顺带还了 me-math 的一笔技术债:GAPS 第四条「贝塞尔按参数 t 均匀采样,不是按弧长」现在有 arc::ArcTable(建一次查多次、按距离二分反查);而仓里另一份借用式的 procedural::Path 一直没有对照,靠 the_two_arc_walkers_agree 逐点互校钉住「算的是同一条路」。一个真 bug:Chain 的基准是链首不是上一节——「相对上一节」的差会累积,三节的尾巴摆到曲线上时最后一节可能与第一节反向。没做的一件写在这一节里:从 Spine path 附件读顶点要先给 SlotSet 加路径表(AttachmentKind 是 Copy 的,装不下顶点数组)。
  • A2槽位混合方式(四种 + JSON 读入 + 两个别名)与两色着色(顶点 alpha 在两色之间插值)2 人日
    颜色与混合的两条通道都进了槽位,但只到数据与算术为止(2026-10-31,A2)。展开 496 字
    颜色与混合的两条通道都进了槽位,但只到数据与算术为止(2026-10-31,A2)。BlendMode 四种(normal / additive / multiply / screen,add 与 additive 两个写法都收)+ Tint(单色与两色)。三件事值得记:一,两色着色的两个端点必须逐位落在 dark / light,中间态用 16.16 定点整数算——me-anim 禁平台 libm,.floor() 会让 animation_code_never_reaches_for_the_platform_libm 直接红(第一版就是这么写的);二,is_two_color 只看三个颜色通道,不看 alpha,因为 dark.a 根本不参与计算,把它算进来就会让渲染侧为一个逐字节等价的结果换一条通路;三,不认识的 blend 报错而不是退化成 normal——退化的症状是「该发光的不发光」,而在渲染侧完全看不出是导入时就换掉的。渲染侧接线还没做:Slot::blend 没进批次键、Tint 没进顶点色。
  • A2drawOrder 与 rgba:从 Spine JSON 读入、写回、落到槽位,四格演示 + 反事实2 人日
  • A2deform:列式导入 + 与网格对账 + 写回 + 播放到调用方缓冲2 人日
  • A2deform 演示页:四格(无 / 线性 / 阶跃 / 世界空间反事实),15 项页面自检 + 两张证据图2 人日
  • A2网格几何进 Doc:uvs / triangles / edges / 顶点原样编码;加权网格带上、加权路径拒掉;两份真实文件夹具3 人日
  • A2网格附件 → Mesh:展开加权编码、塌成一个绑定点并报误差、非加权按槽位骨骼绑3 人日
  • A2ik-lab 演示页:四格(无 IK / Plus / Minus / 写回顺序错)+ 八导出 + 两张证据图3 人日
  • A2fabrik-lab 演示页:四格(直链初值 / 弯链初值 / 臂展边缘 / 臂展之外)+ 八导出 + 两张证据图3 人日
  • A2me-anim::clip(凸多边形裁剪 + UV 插值 + 批量接口)+ clip-lab 四格演示页3 人日
  • A1AttachmentKind::Clipping + Doc::clips + 导入/导出 + 10 条判据3 人日
  • A1me_anim::mask(作用域两段式 + 层状/深度检查 + MaskStack)+ 24 条判据3 人日
  • A1linkedmesh:两趟解析、几何复制、身份三元组、导出写回 + 13 条判据3 人日
  • A1deform 继承:Doc::deform_source + deform_into 两趟 + 4 条判据1 人日

目标:UI 从「控件」变成「系统」;序列化/存档/日志从「散在各处」变成「一层」。

  • A2UI 布局补全:滚动容器 / 虚拟列表 / 九宫 / 多分辨率适配6 人日
    在写:还差虚拟列表:N-232 核过 crates/me-ui/src/layout.rs 有 scrollbar() 与输入滚动量,但没有虚拟列表;展开 779 字
    还差虚拟列表:N-232 核过 crates/me-ui/src/layout.rs 有 scrollbar() 与输入滚动量,但没有虚拟列表;plan/agents.json 只对 A2 开了 layout.rs / input.rs 两个文件,ui.rs(2129 行,控件生命期/焦点/命中)与 design.rs 未开放。A1 2026-11-03 裁走 ②:A2 在这两个文件里改完在 notes/A2.md 报备。实现未开工。 2026-11-06 更正:这一条里的「没有虚拟列表」是错的,而且错了两处。 ① scroll_rows 就是虚拟列表 —— 它的模块文档写着「只对看得见的行调 body」,判据 a_ten_thousand_row_list_calls_body_ten_times 在 crates/me-ui/tests/scroll.rs(还有 the_sprite_count_does_not_grow_with_the_row_count 一起钉着)。② 九宫也早就有(paint.rs 的 nine / nine_quads)。所以「布局补全」四件里三件在跑:滚动容器、虚拟列表、九宫。 真正剩下的只有「多分辨率适配」,而它卡在一件具体的事上:layout.rs 没有 min/max-content(没法「先量内容再定尺寸」⇒ 文本宽了只能截断或撑破)。这件事在 .workbuddy/reports/20-ui-system-strategy.md 里就记着,layout.rs 也已对 A2 open —— 所以它不是「等 ui.rs」,是 A2 自己那半。N-154 里已把这条更正告诉 A2。
  • A2UI 焦点与导航:键盘 / 手柄焦点环 + 与输入法联动(set_ime_area)4 人日
    在写:还差 A1 的一次选择:三个真缺口(IME 落点 / 方向键 roving / 焦点跨帧落点)已逐行点名在 plan/proposals/A2-s15-2-focus-gaps.md。展开 1142 字
    还差 A1 的一次选择:三个真缺口(IME 落点 / 方向键 roving / 焦点跨帧落点)已逐行点名在 plan/proposals/A2-s15-2-focus-gaps.md。前两条要动 ui.rs 的焦点段(step_focus / reveal_focus / 画环约 40 行),而 ui.rs 未开放;N-240 给了两个方案(把焦点段开 open,或 A1 开钩子 A2 实现),A1 尚未选。合 main 那半已消解。 2026-11-06 结案那三条:A1 自己改完了(N-154),不记完成,但不再卡在「等 A1 选」。 选的是第四条路 —— 不 open、也不只开钩子,我照 A2 那份清单改(理由:ui.rs 是焦点/命中/生命期的唯一定义处,open 之后两个人会同时改 step_focus)。落地三件: ① Ui::ime_area() + ImeArea{rect, caret}(caret 是相对控件左上角的偏移;被容器裁掉时 None,与画环共用 clipped_away);② Ui::group(id, axis, |g| …) roving tabindex(停靠点是「焦点所在项」不是第一项,跨帧记在 State::group_current,方向键到头不回绕);③ 焦点跨帧落点(State::focus_lost,「只活一帧」靠 focus 变了自动过期,不加帧号)。 A2 给的那条判据写法是恒等式,已实测:「面板不画一帧 ⇒ 面板再画 ⇒ 焦点仍是第 3 个」今天就是绿的 —— 面板不画时没有任何东西会改 state.focus。真缺口在「面板关着的时候按了 Tab」,那时 cur 是 None 才把它丢掉。判据按后者写。 判据 8 条(tests/focus_group.rs 6 + tests/ime.rs 2)+ 反向实验 8 组,逐条能红:① 不判被裁 ⇒ 视口外那条红;② edit_value 无条件写光标 ⇒ 「按钮 caret 应为 None」红;③ 停靠点压成 v[0] ⇒ 「组内按 Tab 该出组」红;④⑤ 方向键的两道闸(入口判 group + 找不到就从头)/ clamp 换取模;⑥ 不恢复 ⇒ 「面板重开焦点回原位」红;⑦ 记了不清 ⇒ 「用户选别处不许抢回」红;⑧ 轴写反 ⇒ 横排那条红。 所以仍记 wip,但还差的是另外两件:手柄 D-pad 走同一套 Key(没实测过手柄)、真机 IME(候选框位置只有在真机上打字才看得见,本机没有那个环境)。
  • A3UI 样式表:设计令牌 → 主题(明/暗)+ 与图集共用一份色彩真相3 人日
  • A1通用序列化:schema 驱动 / 版本头 / 零拷贝读 / 确定性写6 人日
  • A3存档:槽位 / 版本迁移链 / 完整性校验(升级 S7-6,不并存)5 人日
  • A1日志:分级 / 结构化 / 环形缓冲 / 崩溃前快照 / wasm 端导出4 人日
  • A3落盘适配:IndexedDB(web)/ wx.setStorage(小游戏)/ 文件(桌面)3 人日
  • A2UI 过渡动画:复用 S14 的时间轴,不另起一套3 人日
    在写:还差 ui.rs 上的钩子:过渡动画复用 S14 时间轴的上游在 A2,但要往 ui.rs 插轨道;展开 768 字
    还差 ui.rs 上的钩子:过渡动画复用 S14 时间轴的上游在 A2,但要往 ui.rs 插轨道;A1 明确「ui.rs 与 design.rs 不开放,我在 ui.rs 上开钩子、你在时间轴侧实现」。2026-11-06:钩子开了,但只开输入侧 —— 那正好是 A2 拿不到的那一半。 Ui::track_transitions(true) 之后,entered() / exited() 给出 Transition { id, rect }:谁这一帧新出现、谁刚消失、消失的给最后一次出现的矩形(给 0 矩形的话退场过渡会从画布左上角滑出去)。列表按 id 升序 —— HashMap 的迭代序每帧不同,不排序会让「同一份输入跑两遍」的判据随机红绿。默认关:记它每帧要建一张 id → 矩形 的表并做两次差集,对不需要过渡的界面是纯开销。 判据 4 条(tests/transitions.rs)+ 反向实验 2 组(退场给 0 矩形 ⇒ 红;删排序 ⇒ 红两条)。 没开 alpha。Painter 只有裁剪栈,没有 alpha 栈;加它要改十条绘制路径(rect/round_rect/border/h_line/v_line/text*),还得先回答「border 内部调 rect,会不会乘两次」。那是表现侧,归 A2(me-render 是他的扇区,他若用 DrawItem 自带的颜色乘,根本不经过 me-ui)。所以这条仍记 wip:实现(插值曲线、轨道、alpha)仍在 A2,我只是把输入递到了他手上;在他定 alpha 之前,位移过渡已经能做(把矩形的 y 平移)。

目标:性能问题能定位到节点;编辑器能调 CLI 且协议稳定。

  • A2Profiler:scope 计时 + 采样 + 调用树聚合(按 scope 名,不按函数指针)6 人日
  • A2Profiler:内存与包体归因,并进 trace.rs 同一条通道5 人日
  • A3Profiler:marker 通道 + 火焰图数据导出(编辑器直接可读)4 人日
  • A3CLI:全命令 --json 输出 + 退出码按「谁能改」分档5 人日
  • A3CLI:编辑器协议(一次性命令 + watch 增量 + 变更集 + 版本协商)6 人日
  • A3CLI:me import / me export 命令组(Spine、图集、存档)3 人日
  • A1九个子系统的 API 手册 + 每块 3 条反例(进 docs/,进 doc-index)3 人日
  • A1端到端:coin-run 与 city-twin 各接一次九个子系统2 人日

目标:把 interface/rhi.ffi.h 从「一个 WebGL2 后端的抽象」改成「多个原生后端的抽象」,

  • A1契约 v7:surface / fence / 资源 usage / pipeline / 平坦 binding slot / 格式裁剪 / 结构化 caps(ADR-0018 §D1–D9)8 人日
  • A1三层对表:check_contracts.py 从「只比函数名」升到「参数个数 + 类型宽度 + 枚举值 + 结构体偏移」3 人日
  • A2me-shader:IR 定义 + 校验 + 常量折叠 + MSL emitter6 人日
  • A3D3D12 骨架:设备 / 表面(IDXGISwapChain3)/ 资源 / fence / 描述符堆分配器(不碰着色器与 pass)8 人日

目标:两个原生后端由两个人、在不知道对方实现的前提下同时写到能上屏。

  • A1Metal 后端:pipeline state / 绑定 / render pass / 绘制 / present8 人日
    在写:ADR-0018 的 RHI 主线,按 §D 的小节推进。展开 6032 字
    ADR-0018 的 RHI 主线,按 §D 的小节推进。逐版理由不写在这里——唯一上游是 interface/MANIFEST.json 里 rhi.ffi.h 的 why(那里每版一段,含为什么)与 interface/rhi.ffi.h 的正文。这里只留状态,否则这个字段会变成第二份变更日志。 已落地:v14 多帧在飞 + 队列有界(§D3);v15 像素回读(§D8);v16 me_rhi_backend_info(§D1「我是谁」);v17 me_rhi_device_limits(§D6 答得出的一半);v18 me_rhi_flush(§D3 第一块);v19 设备丢失(§D6 规则 3:31 个录制入口返 DEVICE_LOST、查询与 destroy 照旧、只清 CONTEXT_READY 一位,判据 crates/me-rhi/tests/device_lost.rs 9 条,含一条直接读 capi.rs 的结构判据);v20 格式交集裁剪(§D7 第一条:删 TEX_RGBA4444 留空号、TEX_DEPTH24 改名 TEX_DEPTH32_FLOAT、新增 me_core::is_known_format,判据 crates/me-rhi/tests/format_intersection.rs 5 条 + 6 次反向实验);v21 表面开关同源(BGRA8_UNORM + CAP_SURFACE_BGRA8 门控、present_modes 收窄到 FIFO/IMMEDIATE、me_frame.flags 真读 drawable 的 pixelFormat,判据 tests/surface_metal.rs 9 条);v22 BGRA8 上屏帧可回读(交换在回读路径做一次,交付永远是 RGBA 序;第一条真 drawable 上的像素级判据);v23 sRGB 当渲染目标(把「一条管线 = 一个 PSO」改成「按目标格式缓存的一组 PSO」:begin_render_pass 从附件对象读 pixelFormat、draw_bound 取对应变体。起因是一次推翻预料的实测——Metal 不校验 PSO 与附件的像素格式,拿 RGBA8 的 PSO 画进 sRGB 目标不报错、不 abort、也不编码,回读 128 而不是 188 ⇒ 判据只能是数值,判据 me-render/tests/metal_offscreen.rs::an_srgb_target_stores_the_hardware_encoded_value,两次反向实验都红在这一句上);v24 RGBA16_FLOAT(一位从 v1 就在、却一个宾语都没有的能力:FLOAT_RENDER_TARGET 一直在探、一直在档位模板里、satisfies 也拿它参与判定,而契约里没有任何浮点格式值需要它——与 §D6 规则 1「报了的必须能用」是同一类病的反面。顺手补上 v21 漏置的 CAP_SURFACE_BGRA8:加了格式值与 surface_caps 的报告,却忘了在 Metal 的 caps() 里置位 ⇒ 同一次回答里两个答案。判据 format_intersection.rs::the_caps_and_create_texture_answer_the_same_question 遍历格式值逐个真 create_texture 一次再与 caps 对——只读 caps 不断言的测试永远绿,因为「没请求」天生不会失败;三次反向实验各自红在对的断言上,其中一次踩到 Rust 的通配绑定陷阱:漏进 use 的常量名在 match 里是绑定不是错误,pixel_format(TEX_BGRA8_UNORM) 静默返回 115);v25 胶水侧上下文丢失(v19 那条规则的另一半在对面的语言里是错的:契约写「丢失后 capabilities 只清 CONTEXT_READY 一位、其余原样」,Metal 侧照做了、判据也有,而 me_gl.js 返回的是 0——整片清零。两条实现说同一件事、一条对一条错,而错的那条才是线上的那条(wasm 分支才是宿主真正跑的),且它在 Rust 测试里跑不到。同一批补了 webglcontextlost 监听与 onContextLost 钩子:此前只有 isContextLost() 轮询,它回答得准但不通知任何人,症状是「帧还在跑、画面不动」;胶水刻意不调 preventDefault(那是在说「我要恢复」,而恢复要重建整份实例,是宿主的策略)。判据五条 + 四次反向实验,并改掉一条绿着错的断言——glue.test.js 原写着「丢失必须报 0」,那个理由只对「建的时候就没有上下文」成立)。;v26 surface_desc.format 的 0 换意思(第一次 bump ABI:7→8:0 从「让后端挑」变成「明确要 RGBA8」,哨兵挪到 SURFACE_FORMAT_AUTO = 0xFFFFFFFF)。起因是 v21 记的那笔债——0 同时是 TEX_RGBA8 的编号,于是「我要 RGBA8」在表面上无法表达,而 v21 的对策是让 surface_caps.formats[] 只报一款:那不是后端的事实,是我们自己的编号问题。敢动的前提是先量掉 v21 那条没核实过的理由(「RGBA8 layer 不被支持」):同一个 CAMetalLayer、只换 pixelFormat,80/70/115 三个都拿到 drawable 且回读一致,反向对照 R8Unorm/B5G6R5/Depth32Float 被 setPixelFormat: 以 CAMetalLayerInvalid 抛异常拒掉 ⇒ 那个函数抛的是 ObjC 异常不是返回码,跨 FFI 进 Rust 是 UB(进程直接终止),所以 surface_format() 的穷举白名单是防进程被杀的那道墙,加格式值必须有实测记录。判据三条:surface_metal::every_reported_format_acquires_a_frame_and_the_flag_agrees(caps 报的每个格式都真 configure → acquire → 当颜色附件 → present,并核对 me_frame.flags 位 0 与请求的通道序一致——这一条以前写不出来:位 0 在 Metal 上恒为 1,而 acquire_frame 里那条「读到 70 就报 RGBA8 且位 0 归零」的分支永远走不到)、surface::the_previous_abi_version_is_refused_now_that_zero_changed_meaning(字面量 7 必须被拒,这是 bump 的全部理由)、me-core::the_surface_sentinel_is_not_a_texture_format(哨兵不许被当成第 23 个格式值)。三次反向实验各自红在对的断言上。⚠️ 顺手把「formats[] 里现在真的有 0」写成调用方义务(规则 30):只能按 format_count 读,按「遇到 0 结束」读的症状是「这台机器一个格式都不支持」而 format_count 说是 2。 仍然没有的:§D7 剩下的一个格式值(DEPTH24_STENCIL8,要标 FEATURE_GATED——Metal 上 depth24Unorm_stencil8 只有 Intel/AMD 的 Mac 支持,Apple 芯片不支持;见下条备忘);§D1 的 enumerate_adapters(问得出「我是谁」,问不出「能选谁」);§D3 的完整 timeline fence(要 queue/cmd_buffer/fence 三件套);§D6 的 features 结构化(caps 仍是 32 位掩码)与 shader_formats 那条「报了的必须能用」(今天没有 create_shader 入口,规则没有受体);后端自检(Metal commandBuffer.status——能判的只有真机一次 GPU hang,构造不出那个场景,所以不写没有判据的代码)。webglcontextlost 的胶水侧接线已在 v25 落地(监听 + 钩子 + stats.contextLost),剩下的只是页面级的 rebuild()——那本来就是 A3 发布页那条路,不是缺口。深度/模板的备忘:真要用 stencil,该加的是 DEPTH32_FLOAT_STENCIL8(Metal 260 / GL DEPTH32F_STENCIL8,Apple 芯片也支持),而不是 ADR 原表里的 D24S8——后者在 M 系列与 iPhone 上根本不存在,加它就等于加一个「只能在一个后端上用」的值。v26 判过:仍然不加——它今天零消费者,也没有任何能力位指着它(RGBA16F 之所以该加,是因为FLOAT_RENDER_TARGET 那一位从 v1 起就没有宾语),加了就是 v20 删 RGBA4444 时判过的同一条:能用了但只有一个后端能用,比不能用更坏。什么时候加:真有内容要模板测试时,那时它才有一个说得出的消费者。D3D12 归 A3 的 Windows 机器。 v27 只改注释(write_texture 的 level 语义;清屏不受绘制状态影响)——ABI 不动,三个后端一行未改。v28 = §D1 的另一半「能选谁」:me_rhi_enumerate_adapters + me_rhi_create_device_for(纯追加,ABI 仍 8),并把「这个目标上存在哪个后端」从 build_backend 的两个 cfg 分支提成 device::ADAPTERS 一份数据——枚举与默认选择读同一个地方(不是「两处说法一致」,是只有一处;build_backend() 就是 build_backend_for(ADAPTERS[0]))。判据 crates/me-rhi/tests/adapter_enum.rs 8 条:第一项==默认实际建出来的 / 遍历 count 逐个真建并核对 kind / 没报的必须 UNSUPPORTED / backends[] 按 count 读(主机上第一条就是 ME_BACKEND_NULL=0,按「遇到 0 结束」读会读空)。五次反向实验各自红在对的那条上(记录在 interface/MANIFEST.json 的 v28 why 里)。仍然没有的:§A.1 里那半个「名字 + 适配器类型」——Apple 芯片是集显、Intel Mac 上的 AMD 是独显,查不到就不许猜,报一个猜出来的「集显」比不报更坏;§D3 完整的 timeline fence(queue/cmd_buffer/fence 三件套);§D6 的结构化 features(caps 仍是 32 位掩码)与 shader_formats 的受体(今天没有 create_shader 入口)。 v29 只改注释:read_render_target 补一句「提交之前读 = ME_ERR_INVALID_ARG」(真后端有两个拦截点:pass 还开着 / 帧开着没提交;理由不同、码相同,因为调用方只有一段恢复逻辑),并写清它与 null 的 UNSUPPORTED 是两个问题(一个说「我没有这个能力」、一个说「你现在还不能用」)。⭐ 起因是一份新判据 crates/me-rhi/tests/metal_via_capi.rs(5 条):macOS 上原来碰 Metal 的三条判据都从 Rust 侧直接持有 MetalBackend,而 P0 的验收标准是「被三个后端分别证伪过的契约」——这一份第一次让 Metal 走完 枚举 → create_device_for → 句柄 → 建纹理/RT → 开 pass → 提交 → 回读 整条 C 边界(MetalBackend 一次都不出现),是 Windows 那边 d3d12_enum_path.rs 在 macOS 上的对应物。只覆盖离屏:上屏要 NSView + 事件循环,仍归 apps/macos-demo 那条截图路。 v30 = 关掉一个「契约自己写着、却没有任何判据守」的洞:me_device_desc.max_frames_in_flight 从 v1 到 v29 没有被任何代码路径读过(这句话就写在契约里)。查下去还更严重一层 —— metal 的默认队列深度是 2,而契约从 v1 就写着「后端可以下调,不能上调」⇒ = 1 的宿主要到 2,那是上调、违反契约自己那条禁令。改法(ABI 仍 8,结构体一字节未动):build_backend_for 加 max_frames,两个建库入口都从 desc 取;0 判 INVALID_ARG(参数问题),8 判成功并夹到 3(能力问题,device_limits 报夹过的值)。判据 tests/frames_desc.rs 5 条,两组反向实验分别红在三条能力判据 / 两条 0 判据上。仍然没有的:d3d12 那一格(new_offscreen 没有队列深度参数,留给 A3);null / webgl2 的 limits()(前者整体 Unsupported 有论证,后者没有 wasm 测试通道)。
  • A3D3D12 后端:root signature / PSO / barrier 跟踪 / command list / 提交7 人日
  • A2me-shader:HLSL SM6 emitter3 人日
  • A2null 后端按 v7 重写(契约自洽的第二份证据:不实现任何平台 API 也能编过全部语义)3 人日

目标:给出「契约真的被两个独立实现读懂」的唯一硬证据:同一场景、同一相机、逐像素一致。

  • A1Metal 收尾:离屏渲染 + copy_texture_to_buffer + 回读(行 0 = 顶部)7 人日
  • A3D3D12 收尾:同上 + 参考图入库 tests/render/ref/<scene>/d3d12.png + 跨机语义级判据([附录 B](#附录-b--跨机语义级判据s19-2-的-dod-怎么判))8 人日
  • A2WebGL2 迁到 v7(compat 档:encoder 当录制日志、submit 时立即回放、fence 立即完成、barrier 空实现)6 人日
P1 · 19 条工作流 · 3,380 人日 · 按职能组排,泳道见 03 区渲染 3 人 / 上限 963.9 / 已排 950 / 余 13.9动画 1 人 / 上限 321.3 / 已排 310 / 余 11.3网络 3 人 / 上限 963.9 / 已排 910 / 余 53.9模型 1 人 / 上限 321.3 / 已排 300 / 余 21.3工具 2 人 / 上限 642.6 / 已排 610 / 余 32.6平台 1 人 / 上限 321.3 / 已排 300 / 余 21.3
#工作流组起止人日前置状态
P1-1RHI:Metal 后端(Tier1 + compute 路径)渲染第 1–6 月240—规划中
P1-15资产管线:导入器 + 图集 + 子包规则工具第 1–8 月190P1-1规划中
P1-6骨骼蒙皮(bone-only,走现有 sprite 批处理)动画第 1–5 月90P1-1规划中
P1-9me-net:传输 / 协议 / 会话 / 时钟网络第 1–6 月230—规划中
P1-2Clustered Forward+ 与 PBR渲染第 2–8 月260P1-1规划中
P1-13me-model:Provider 与 Pricing 接口 + 计量累加器 + 30 天对账模型第 3–10 月190P1-9规划中
P1-10me-sim:权威 tick + 快照与增量网络第 4–9 月220P1-9规划中
P1-73D mesh 蒙皮(骨骼矩阵数组,需要改 RHI 契约)动画第 5–9 月100P1-6规划中
P1-12me-arena:agent 宿主(Provider / 预算 / 回放)网络第 6–12 月220P1-9规划中
P1-16编辑器:动画编辑 + Perf Workbench工具第 6–14 月270P1-7规划中
P1-3级联阴影 + 后处理链(Bloom / ACES / SSAO)渲染第 6–10 月160P1-2规划中
P1-11lockstep + 回滚 + desync 检测网络第 8–14 月240P1-10规划中
P1-14"像不像人"的可区分性度量(AUC / 思考时长 / 失误率曲线)模型第 8–14 月110P1-13规划中
P1-18抖音小游戏端(宿主 + 分包 + 审核)平台第 8–13 月160P1-1规划中
P1-5分层材质 + 节点种类扩容渲染第 8–14 月170P1-2规划中
P1-8动画状态机 + 混合树 + 根运动动画第 8–13 月120P1-7规划中
P1-4TAA + 超分(先 FSR1 类空间法)渲染第 9–13 月120P1-3规划中
P1-17MIR v1:预算注解 + provenance + 迁移脚本工具第 10–16 月150P1-2规划中
P1-19Android / iOS 原生壳(PAL 扩展)平台第 10–16 月140P1-18规划中

人日是分配值:先算组产能(人数 × 17.85 人日/月 × 月数),再分给该组的工作流。所以「余量」这一列不是估算出来的,是减出来的。

P2 · 20 条工作流 · 7,130 人日 · 按职能组排,泳道见 03 区渲染 6 人 / 上限 1,927.8 / 已排 1,920 / 余 7.8角色 4 人 / 上限 1,285.2 / 已排 1,250 / 余 35.2主机 3 人 / 上限 963.9 / 已排 800 / 余 163.9工具 4 人 / 上限 1,285.2 / 已排 1,120 / 余 165.2美术 5 人 / 上限 1,606.5 / 已排 1,320 / 余 286.5QA 3 人 / 上限 963.9 / 已排 720 / 余 243.9
#工作流组起止人日前置状态
P2-1D3D12 后端渲染第 1–6 月360—规划中
P2-11Xbox devkit + RHI 移植冒烟主机第 1–12 月320P2-1规划中
P2-16资产导入器插件化 + 格式版本工具第 1–12 月360—规划中
P2-14构建农场 + 增量编译工具第 2–10 月420—规划中
P2-20性能基线回归(每轮 CI 自动出曲线)QA第 2–18 月340—规划中
P2-7皮肤 SSS角色第 2–9 月330—规划中
P2-17演示项目(PC 版)资产量产美术第 3–18 月900—规划中
P2-3Virtual Geometry:Tier1 软件光栅渲染第 3–10 月400P2-1规划中
P2-19兼容矩阵(GPU 厂商 × 驱动版本)QA第 4–14 月380P2-1规划中
P2-2Vulkan 后端渲染第 4–9 月320P2-1规划中
P2-18材质库与参考场景美术第 5–15 月420—规划中
P2-5SDF-DDGI 全局光照渲染第 5–12 月280—规划中
P2-12PS5 devkit 评估与移植预研主机第 6–15 月240P2-5规划中
P2-15多人协作(资产锁 / 冲突检测)工具第 6–14 月340P2-1规划中
P2-8毛发 Shell + Strand角色第 6–13 月360P2-1规划中
P2-4Virtual Geometry:Tier3 mesh shader渲染第 9–15 月300P2-3规划中
P2-9眼球 + 布料角色第 10–16 月300P2-1规划中
P2-6HWRT-DDGI + 屏幕空间反射 + 体积雾渲染第 11–17 月260P2-5规划中
P2-10角色编辑器与预览角色第 12–18 月260P2-2规划中
P2-13主机提交流程与 checklist主机第 12–18 月240P2-5规划中

人日是分配值:先算组产能(人数 × 17.85 人日/月 × 月数),再分给该组的工作流。所以「余量」这一列不是估算出来的,是减出来的。

P3 · 13 条工作流 · 12,800 人日 · 按职能组排,泳道见 03 区主机 7 人 / 上限 1,499.4 / 已排 1,900 / 余 -400.6世界 12 人 / 上限 2,570.4 / 已排 2,700 / 余 -129.6角色 10 人 / 上限 2,142 / 已排 2,200 / 余 -58AI 9 人 / 上限 1,927.8 / 已排 2,100 / 余 -172.2商业 10 人 / 上限 2,142 / 已排 2,000 / 余 142平台 12 人 / 上限 2,570.4 / 已排 1,900 / 余 670.4
#工作流组起止人日前置状态
P3-1PS5 / Xbox / Switch 正式支持与认证主机第 1–10 月1,600—规划中
P3-12平台抽象层 v2(跨主机 + 跨端)平台第 1–10 月1,400—规划中
P3-3大世界流式加载(分块 / 预取 / IO 预算)世界第 1–12 月1,900—规划中
P3-5影视级角色管线(groom 导入 / SSS2 / strand)角色第 2–12 月1,700—规划中
P3-7运行时 AI:NPC 行为与动态叙事AI第 2–12 月1,600—规划中
P3-13遥测与崩溃上报平台第 3–10 月500—规划中
P3-4世界编辑与分区工具世界第 4–12 月800—规划中
P3-9引擎授权:SDK 分发 + 许可校验商业第 4–12 月800—规划中
P3-10云烘焙服务(离线 GI 集群)商业第 6–12 月700—规划中
P3-8本地推理预算与降级策略AI第 6–12 月500P3-7规划中
P3-11垂直行业方案(文旅 / 适老化互动)商业第 8–12 月500P3-1规划中
P3-2三平台提审与商店页主机第 8–12 月300P3-1规划中
P3-6角色性能预算与 LOD 自动派生角色第 8–12 月500P3-5规划中

人日是分配值:先算组产能(人数 × 17.85 人日/月 × 月数),再分给该组的工作流。所以「余量」这一列不是估算出来的,是减出来的。

05 / 模块

28 个 crate,201,455 行代码

行数与测试数每次构建实测,不填表。行数含 crate 用 #[path] 从 interface/ 引入的契约——那是它编译进去的一部分,只是放在别处(me-core 自己的文件 39 行,加上两份契约才是它的大小)。tests/、apps/ 与生成物不计入。状态只有两档:有实现、还是空壳——「空壳」的判定是不到 50 行且零测试,两个条件同时成立才算,只看行数会把只管类型定义的短 crate 误判成空壳。

crate层职责目标行数测试状态
me-agentL7AI 内核:Intent → Planner → Generator → Validator → Optimizer。不直接改文件。host
1,946
50有实现
me-animL42D 骨骼动画:骨骼层级、局部/世界变换、五种继承标志(Spine 语义)。不含蒙皮与 IKhost wasm32 ios
23,745
548有实现
me-atlasL5图集分配的计划层:排序 / 分页 / 定高 / uv,算法复用 me-render::atlas 的 shelf。host
1,103
27有实现
me-atlas-ioL7读 `.mir` 同一层目录里的 `.atlas`,给编译链和 Studio 同一份帧表集。host
225
5有实现
me-audioL4音频混音器:bus 图、定点增益、语音池与优先级抢占、单声道定位源。host wasm32 ios
2,586
87有实现
me-cliL9命令行外壳:me new / me doctor。Agent 闭环的唯一反馈通道。host
13,082
159有实现
me-compareL6对账图的三条腿共用:场景 / CPU 参考 / 逐像素比较 / 判据host wasm32
5,740
55有实现
me-compilerL6编译链:7 个 pass(legalize / budget / lower / link / pack)。离线运行,因此不进 iOS 包。host wasm32
4,160含契约 270
116有实现
me-cookedL0cooked 场景的落盘格式(magic MESC):编译期写、运行期读,一份实现两侧共用。host wasm32 ios
601
22有实现
me-coreL0基础设施:句柄、错误码、能力位、预算、溯源标记。全员依赖,不分配、不浮点。host wasm32 ios
1,305含契约 1,258
28有实现
me-fluid2dL42D 粒子流体:双密度松弛、空间哈希、自由表面(水/沙/粘液)host wasm32 ios
1,031
18有实现
me-fx2dL52D 特效系统:粒子池、发射器、特效时间轴、粒子与刚体的溅射/弹射host wasm32 ios
2,228
37有实现
me-mathL0确定性浮点数学:初等函数、2D 向量、贝塞尔、二次求根、级数、积分、最小二乘host wasm32 ios
3,705
97有实现
me-mirL6MIR:schema、解析、规范化序列化、mirb 二进制、校验。引擎唯一的真相源。host wasm32 ios
7,468含契约 404
175有实现
me-palL2PAL:平台抽象 trait 与各平台实现。L2 之上禁止 #if PLATFORM 的物理载体。host wasm32 ios
2,356含契约 1,004
45有实现
me-pal-wxL2微信小游戏 wasm 导出壳:把像素缓冲暴露给 JS/WebGL。契约定义在 interface/pal.trait.rs。wasm32
2,516
37有实现
me-physicsL42D 物理最小集:分轴 AABB 分离、单向平台、落地判定。不带旋转与 CCD。host wasm32 ios
357
19有实现
me-recordL5内录:帧序列 → mp4(ffmpeg 管道)或 PNG 序列。含帧尺寸/编码器早退/空输出三类判据。host
482
5有实现
me-renderL4渲染器:Render Graph、裁剪、材质、后处理。必须有 Compute-free 路径。host wasm32 ios
22,634
526有实现
me-rhiL3RHI:C ABI 边界(abi.rs 归 A1)与各后端实现(backends/ 归 A2)。host wasm32 ios
18,574
267有实现
me-rigid2dL42D 刚体:圆 + OBB + 凸多边形、顺序冲量、距离/铰链关节、子步 CCD、休眠host wasm32 ios
5,013
71有实现
me-runtimeL5运行时子系统:ECS、动画、物理、音频、脚本、网络、UI、流式加载。host wasm32 ios
48,738
971有实现
me-shaderL4着色器生成:材质图 → GLSL / MSL(+ 顶点属性声明)。不含编译与管线host wasm32 ios
2,541
37有实现
me-soft2dL42D 软体:质点-弹簧、Verlet 积分、形状匹配(旗帜/头发/果冻)host wasm32 ios
1,167
11有实现
me-studioL8Magic Studio 后端:场景/材质/动画编辑、AI 工作台的服务端。前端在 apps/studio。host
19,446
467有实现
me-studio-wasmL8Studio 视口的 wasm:把 cooked 字节验一遍,再把条目区零拷贝交给前端。host wasm32
456
10有实现
me-swrastL6CPU 软件光栅:把 me-render 的绘制列表画成 RGBA8 像素(Studio 自绘的底座)host
1,292
51有实现
me-uiL5自绘 UI 系统:设计令牌 / 约束布局 / 画笔 / 文字 / 输入 / 立即模式控件。host
6,958
178有实现
06 / 契约

17 份跨 Agent 契约

契约是三台机器同时写代码的唯一前提。状态只有两种:冻结(改就必须升版本、更新哈希、通知消费方)与草案(可以改,但仍登记哈希,为了知道是谁让它变了样)。

契约版本状态消费方
rhi.ffi.hv30冻结2
core.types.rsv12草案2
mir.schema.jsonv7草案3
mir.grammar.ebnfv3草案2
pal.trait.rsv2草案2
cli.spec.mdv11草案3
render.pass.mdv16草案2
content.needs.mdv1草案3
op.registry.rsv7草案2
pass.registry.rsv0草案2
diag.codes.mdv13草案2
mirb.spec.mdv3草案2
profiles.rsv0草案2
cooked.scene.mdv2草案2
atlas.file.mdv1草案2
guardian.rules.mdv2草案2
mir.spec.mdv5草案3
07 / 计划外

计划外的长期设施

常驻的挡板与守卫,不计入完成度;过程性交付的原始记录在 git log,不入此表。

诊断码与退出码

62 条错误码分十一域,按「谁能改」分而不是按代码模块分;退出码由域表派生、双向守卫(漏表态或多出表里没有的域都红)。码表是生成物,码永不复用、删码留空号。

interface/diag.codes.md · crates/me-mir/src/diag.rs · crates/me-cli/src/build.rs

契约归属与生成物守卫

一个文件一个 owner,越界与重复认领都红;契约哈希按 git 里的字节算,不是工作区字节——否则 Windows 检出一次就假红一轮。码表与契约文档是生成物,改代码不改文档就红。

tools/ci/check_ownership.py · tools/ci/check_contracts.py · tools/ci/check_generated.py

跨目标构建守卫

构建集合来自每个 crate 自己声明的 targets,逐目标真构建。空 crate 在哪个目标都能过,所以只用 --workspace 证明不了任何事。

tools/ci/check_workspace.py

零手写 GLSL 守卫

扫全仓九种后缀,三条硬规则:清单外红、豁免到期红、陈旧豁免(写了却已经扫不到)也红。假条子比没有条子更坏,它让人以为那处已经被管着。

tools/ci/check_no_shader.py

微信打包守卫

上传白名单按后缀、分包 ignore 按目录,两层都得管——只剔掉页面而页面的素材照旧进包,主包七成是演示资产。第一次跑就判红两个工程。

tools/ci/check_wx_pkg.py

音效资产流

32 个 ogg 由配方加种子确定性合成,两次构建 MD5 一致;七项硬校验:峰值、削波、LUFS、频谱质心、接缝、直流、静音。

tools/sfx/forge.py · library/sfx

CI 的日志隔离与「静默跳过」

每轮用独立临时日志目录:双跑串台时 A 的失败分支会读走 B 的日志,同一棵树一次红一次绿。判据跳过必须与通过长得不一样,否则红灯只是训练人重跑。

tools/ci/ci.sh

跨 Agent 协商板

三个 Agent 并行的真实成本是「互相等而 git 全程安静」。每条一个到期日、四态机、一个必须存在的落点,九条守卫挡「写了也不算数」;「代记人类裁决」是单独一档。

Team/negotiation.md · Team/check_negotiation.py

Gate 0 仪表盘

六项指标跑出四态:pass / fail / unknown / gap,后两态都不算通过;恒 exit 0——离门还有两个月就长期红着的门,等于没有门。

tools/report/gate0.py

动画系统六格演示

一格一块能力:继承(Inherit 四种)/ 插值(线性·阶跃·贝塞尔)/ 蒙皮(关节混合)/ 形变(骨骼不动、形状动)/ IK(拖鼠标)/ 综合。展开 264 字
一格一块能力:继承(Inherit 四种)/ 插值(线性·阶跃·贝塞尔)/ 蒙皮(关节混合)/ 形变(骨骼不动、形状动)/ IK(拖鼠标)/ 综合。它同时堵住一条没有主机判据能覆盖的缺口——coin_run 从不调 ik / deform / normals ⇒ 链接期整块删掉、产物里根本没有,而主机判据全绿(S14-4 与 S14-5 两批就是这么交付的)。CI 用 WebAssembly.Module.exports 只解析不实例化地数导出表:「查导出表」不该以「有个能跑 GL 的环境」为前提。

crates/me-runtime/src/anim_lab.rs · apps/coin-run/anim-lab.html · apps/coin-run/run-anim-lab.sh · apps/coin-run/evidence/anim-lab-grid.png · tools/ci/ci.sh

合拍 · 生图角色 + 蒙皮 + IK 的节拍小游戏

生图素材(genImage 出图 → 抠图 → 自动权重骨架)两个角色,玩法把动画时间轴当游戏时钟:一拍一次伸手,两只手在相位 0.5 相遇,玩家按得准不准=画面上它们有没有真的碰到。展开 288 字
生图素材(genImage 出图 → 抠图 → 自动权重骨架)两个角色,玩法把动画时间轴当游戏时钟:一拍一次伸手,两只手在相位 0.5 相遇,玩家按得准不准=画面上它们有没有真的碰到。判定窗口跟拍速走(1300ms→640ms),连击越多越快。它顺带钉住三条只在显示层才出现的错:骨尖重合了 30px 之外屏幕上还空着(手贴图在手腕、骨尖在外)、果冻 29px 的短手臂被 apply_chain 拉长 3.2 倍成尖刺而 tip_error 仍是 0、以及 ELEMENT_ARRAY_BUFFER 挂错 VAO 时一个三角形都不画而 HUD 照常跳分。

crates/me-runtime/src/char_beat.rs · crates/me-runtime/src/char_lab.rs · apps/coin-run/char-lab.html · apps/coin-run/char-lab/make_sprites.py · apps/coin-run/run-char-lab.sh · apps/coin-run/evidence/char-lab-hit.png · apps/coin-run/evidence/char-lab-idle.png · tools/ci/ci.sh

动画机制 · 九格演示(程序化那一半)

上一个六格演示只覆盖了骨架那一半(一个角色怎么动),做不出「血条告警在闪」。展开 825 字
上一个六格演示只覆盖了骨架那一半(一个角色怎么动),做不出「血条告警在闪」。这一版补非骨架那一半:序列帧 / 波形 / 缓动 / 呼吸 / 闪烁 / 脉冲 / 抖动 / 弹簧 / 路径,九格各一种,值由函数算出而不是由表读出。落成三个东西:me-anim::ease(16 条具名缓动)、me-anim::procedural(波形·闪烁·脉冲·噪声·弹簧·路径)、me-runtime::motion_lab(九格几何拼装)。四个决定各有一条判据守着:① 缓动端点必须逐位精确——OutElastic 的经典公式在 u=1 给 1.0005,过渡结束后角色常驻偏半像素,十五个分支各写特判必漏,所以在 Ease::ease 入口统一短路,公式只在开区间被调用;② 输入夹紧、输出不夹紧——InBack/OutBack 存在的全部意义就是过冲,夹到 [0,1] 等于把预备动作删掉,看着像美术没做;③ 程序化动画不能累加 dt——f32 每秒加 60 次、一局几万次,累计误差吃掉半帧,所以每个采样收 t_ms: u32,相位由取余一次得出;④ 弹簧不能按帧数积分——一步欧拉遇到 300ms 卡帧会把角色弹飞到 1e6,下一帧顶点 NaN、整格消失而日志正常,MAX_STEP_MS=33 夹住、固定 8ms 补步、t 回退就重置。另有三条只有显示层能看见的:闪烁若只改几何不改颜色则顶点判据全绿而屏幕上看不出闪(所以这一页比 anim-lab 多一个颜色缓冲,自检用 gl.readPixels 数像素而不是数顶点)、闪烁周期若整除帧间隔则每帧落在同一相位而几十秒后突然与别的动画拍频(演示刻意用 437/613)、脉冲 t=0 必须落在最低点否则「刚开始」那帧角色是鼓着的(用 sin² 而不是 cos 起步)。

crates/me-anim/src/ease.rs · crates/me-anim/src/procedural.rs · crates/me-runtime/src/motion_lab.rs · apps/coin-run/motion-lab.html · apps/coin-run/run-motion-lab.sh · apps/coin-run/evidence/motion-lab-nine.png · apps/coin-run/evidence/motion-lab-pulse.png · tools/ci/ci.sh

三分支协作规则 · 从「写在文档里」变成「有东西会红」

CONTRIBUTING.md §4 第一条从建仓起就写着「不直接推 main」,而 10-23 到 10-31 之间 1066 条提交全部直推 main,没有任何检查器红过一行——规矩不是被…展开 415 字
CONTRIBUTING.md §4 第一条从建仓起就写着「不直接推 main」,而 10-23 到 10-31 之间 1066 条提交全部直推 main,没有任何检查器红过一行——规矩不是被违反的,是没人记得它存在。这一批把 R1–R5 接到三处会红的地方(commit-msg 的 main 闸 / pre-push 的分支闸 / ci.sh 的新 step),并恢复 agent/A1~A3 三条分支(三条的独有提交都是 0 ⇒ 重置到 main 零丢失)。顺带修掉一个真缺口:check_bash.py 只扫 .sh 与 .command,不扫 tools/ci/hooks/**——而钩子是唯一「一跑就把 push 卡死」的脚本,写 pre-push 时两处共 25 个 $VAR」 被 bash 3.2 吃进变量名,set -u 下直接 unbound。

tools/ci/branch_flow.py · tools/ci/sync.sh · tools/ci/hooks/pre-push · tools/ci/hooks/commit-msg · tools/ci/check_bash.py · tools/ci/setup_agents.sh · tools/ci/ci.sh · docs/12-three-machine-sync.md · CONTRIBUTING.md · plan/branch-flow-baseline.json · tools/ci/cross-sector.txt

`xform.node` 的位置和尺寸第一次有类型(契约 v4)

场景面板上最常改的两格,lower 一直在读,而参数表是空的 ⇒ Inspector 只能把它们标成「未登记、只能保管不能校验」。展开 470 字
场景面板上最常改的两格,lower 一直在读,而参数表是空的 ⇒ Inspector 只能把它们标成「未登记、只能保管不能校验」。后果不是编译不过(attrs 是自由键值),而是用户往 pos 填 1 一路走到 ME-LOW-001「没有 xform 祖先」——一个跟手误毫无关系的错,比不报更贵。裁决是 A:登记成 Floats(3),第三分量是 z(2D 的 lower 只读前两位,写非 0 不报错也不生效,这句写进 note 才算说完)。三条边界:① 登记 3 不登记 2,因为示例一律写三个,改 2 要动两份 A4 的联调基线;② rot 故意不登记——它是四元数而没有任何编译器读它(2D 的旋转在 sprite.draw.rot),登记一个没人读的参数等于给用户一个填了不生效的格子;③ maps_to 保持 None,因为变换节点的参数落在子节点的绘制数据上,写成 Some("pos") 会让契约检查以为它是 DrawItem.pos 的第二个来源。

interface/op.registry.rs · interface/MANIFEST.json · crates/me-studio/src/inspector.rs · Team/closed/2026-10-24-xform-pos-scale-typing.md

协商板补两个档:`裁决`(代记人类)与「答复即改状态」

两件都是 A3 顶回来的机制缺口。① 三个会话共用一个 git 身份,唯一能区分「谁说的」的东西是条目边界——把人类的话写成我方通报,三个月后没人看得出它不是 A3 说的,而「以别人的名义说话…展开 390 字
两件都是 A3 顶回来的机制缺口。① 三个会话共用一个 git 身份,唯一能区分「谁说的」的东西是条目边界——把人类的话写成我方通报,三个月后没人看得出它不是 A3 说的,而「以别人的名义说话」是这套机制唯一防不住的错。加第四档 裁决,守卫强制四条:出现「代记」、写出是谁裁的、写出人类说话的时间、必须已关闭并带落点(只在板上说「定了」而没有任何文件被改 = 把决定交回给下一个不知道这事发生过的人)。② watch.py 把已经答完的条目继续列在「等 A3」里,因为它只读状态而状态没人改。加守卫:答复 标题点名了 N-xxx 而 N-xxx 还是待回复 ⇒ 红。新守卫第一次跑就抓出两条(N-001 / N-006 都已答完却还挂着),当轮关掉。顺带订正规则 4:待回复 → 待落地 由答复方自己改,→ 已关闭 仍由请求方确认。

Team/check_negotiation.py · Team/negotiation.md · Team/closed/2026-10-24-xform-pos-scale-typing.md

参数表比对进校验期:`ME-OP-006` / `ME-OP-007`(N-010 那句「要一处实现」)

attrs 一直和 OpDef::params 没比对过,两处缺口被 A3 写成探测器钉着(用例名与注释都明说「真去补时它会红,红得正是时候」)。展开 600 字
attrs 一直和 OpDef::params 没比对过,两处缺口被 A3 写成探测器钉着(用例名与注释都明说「真去补时它会红,红得正是时候」)。补在 me-mir 校验期而不是 lower,因为判据有两个入口:me validate 直连 me_mir::verify(不跑 pass 框架),me build 走 check pass——只写在 lower 里就是「同一份内容两个命令说两种话」,而两边各自都有测试、各自都对(me_compiler::suggest 那次)。006 = 形状不符(pos=1、uv=[0,0,1,1,1] 多给的分量原来被 attr_nums::<4> 静默丢掉);007 = 文本参数是空串(tex="" 能编过、画出来是白图,而「漏写 tex」是 ME-LOW-003 编译不过,两者在面板上长得一样)。同一次把 me-studio 的 check() 也改成拒空串——只改一边就是「编辑器比编译器松」,那是最坏的不对称。另外发现自己写的一条测试是做不到的形状:想只跑 Lower 验「读值那层也不静默补 0」,而链是 check→legalize→lower 硬依赖,少注册一个就是 ME-PASS-901。改成诚实的样子,并写清 lower 那条检查现在是兜底。

crates/me-mir/src/validate.rs · crates/me-mir/tests/params.rs · crates/me-mir/src/diag.rs · interface/diag.codes.md · crates/me-studio/tests/param_parity.rs

ADR-008 转 Accepted(§8 拟人化边界一并接受)

飞哥 2026-10-24 裁决。接受什么不等于都定了:Status 里补两张表,A 是不可再议的四组(责任边界 §1–§2 / 计量与预算 §3–§5 / 信息集与留痕 §6–§7 / 拟人…展开 359 字
飞哥 2026-10-24 裁决。接受什么不等于都定了:Status 里补两张表,A 是不可再议的四组(责任边界 §1–§2 / 计量与预算 §3–§5 / 信息集与留痕 §6–§7 / 拟人化 §8),B 是仍然开着的 8 条未决(全是实现问题,判据是「答案变了也不用改写 A 里任何一句」)。要推翻 A 里任一条,新开 ADR supersede,不改这一份——否则 Accepted 会退化成「这个词被换过」。同时订正两处:docs/09-development-plan.md 的 Q1 里程碑还写着「ADR-008 待裁决」;ADR 正文那句「现状:两个 crate 都是 27 行空壳」加了「Accepted 不改变这个事实」——读到「已接受」就以为有实现,是这份 ADR 最容易被误读的地方。

docs/adr/ADR-008-agent-arena.md · docs/09-development-plan.md · Team/negotiation.md

`me build` 的产物提示曾经指向一个给不出编译结果的命令

摘要原来写「包格式还没定(me pack 属 S8)」。展开 425 字
摘要原来写「包格式还没定(me pack 属 S8)」。S8 早已落地,而 me pack 打的是上传目录(dist/ + pack.json,喂微信开发者工具)——它不读 .mir、不跑编译链、不写 .meb。于是那句话成了指错方向的指针:用户照着它跑 me pack,拿到一份跟编译结果无关的目录,而两份输出里没有一个字解释这件事。裁决(飞哥 2026-10-24,N-016 代记):写产物归 me pack,me build 永远不落盘。文案只留「本次没有写任何产物文件」+ 它自己的事实(结果在报告里、--verbose 展开),并加一条反向断言:摘要里不许出现 me pack。判据写「不许出现什么」而不是「必须出现什么」——文案会改,而「别把下一步指向一个给不出这东西的命令」不会改。顺带把这条消息里的 markdown ** 去掉:那是全仓唯一一处漏进 tty 的星号。

crates/me-cli/src/build.rs · tools/ci/test_cli.sh · docs/adr/ADR-0009-me-build-wiring.md · Team/negotiation.md

ADR-001 转 Accepted:Status 只管「决定还算不算数」,里程碑只管「做完没有」

飞哥 2026-10-24 裁决「现在裁决」。原 Status 是「有条件接受,需 P0 第 8 周完成 FFI 冒烟测试后转 Accepted」——问题不在那个条件,在于它的验证物是代码,不…展开 459 字
飞哥 2026-10-24 裁决「现在裁决」。原 Status 是「有条件接受,需 P0 第 8 周完成 FFI 冒烟测试后转 Accepted」——问题不在那个条件,在于它的验证物是代码,不是评审。把代码判据写进 Status,Status 就成了 D0 的第二个副本,两处都要人手动同步,迟早不一致,而不一致时没人知道该信哪一份。所以:A 表钉三层(分层归属 / 边界形态 / 回退路径,要改必须新开 ADR supersede);B 表放开两条真未决(C ABI 能否承载 C++ 后端、主机 SDK 构建细节),并写清触发动作「第一个真 C++ 后端冒烟失败 ⇒ 按约束 4 回退方案 A 并 supersede」——不许靠改文字绕过。落定时核对的数字:13 crate / 74,821 行 Rust、29 个 me_rhi_* 导出、abi.rs 509 行、C++ 源文件 0 个。最后这个 0 是这份 ADR 现在唯一值得盯的数:边界两侧都还是 Rust,验的是形状不是跨语言成本。

docs/adr/ADR-001-kernel-language.md · crates/me-rhi/src/capi.rs · crates/me-rhi/src/abi.rs · Team/negotiation.md

`me pack` 开始编译内容;`.meb` 这个名字撤掉

按 ADR-0009 §6.1 第 2 条「.meb 若要做就在 me pack 里把 .mir 编成产物」往下做,撞到一件推翻前提的事实:运行时需要的不是 .mirb。展开 568 字
按 ADR-0009 §6.1 第 2 条「.meb 若要做就在 me pack 里把 .mir 编成产物」往下做,撞到一件推翻前提的事实:运行时需要的不是 .mirb。lower 的产出是 LoweredScene(绘制条目 + 资产表 + pass 序列),而 me-runtime/src/lib.rs 明写不许依赖 me-mir——把 MIR 文档的二进制放进 dist,运行时读了也画不出东西。所以这一轮只做能确定的那一半:pack 编译每一份 .mir(编不过就不出包,ME-PKG-024),账本记 content[{path,target,draws,textures}],结论行 ME-PKG-023 同时说「编过了多少」与「包里没有它的文件形态」。另外两处判断值得记住:①档位规则与 me build 故意不同——build 问「编哪一档」(不唯一就报错),pack 问「这份包要在哪些档上都能跑」(一份包同时上 iOS/Android,compute 只有 iOS 有),所以声明几档编几档;②.meb 撤名,因为它没有格式、没有写入者、没有消费者,且在 UPLOAD_EXTS 白名单外——上传即被丢,一个只活在文档里的名字比没有名字更坏。

crates/me-cli/src/pack.rs · crates/me-cli/src/build.rs · tools/ci/test_cli.sh · docs/adr/ADR-0009-me-build-wiring.md · Team/negotiation.md

微信触点接上了:两条路径都通,顺手拆掉两处「看起来对」

WxPal.input 从 AbsentInput 换成真 WxInput:wx.onTouchStart/Move/End/Cancel → platform.js 的队列 → 6 字节记录…展开 1415 字
WxPal.input 从 AbsentInput 换成真 WxInput:wx.onTouchStart/Move/End/Cancel → platform.js 的队列 → 6 字节记录 → touch_codec.rs 解码,端到端 99 项断言跑在真 wasm + 真 platform.js + mock wx 上。as_pal() 一行没动 —— 占位当初写成「同一 trait 的另一个 impl」而不是 Option 字段,回报就在这里:拆掉它只改了一个类型。 两个坑都长着「某一层看起来对」的样子: ① surface_size 原本写 let buf = [0u8; 4](不可变),理由是「写这块内存的是 JS」。不可变局部数组是编译器的常量:读回被折叠成 0 → 尺寸永远 (0,0) → poll 首行 if w == 0 || h == 0 { return 0 } → wx_touch_poll 不可达 → lld 把这条 import 整条删掉,而 platform.js 明明实现了它。Module.imports() 少一个符号看起来像「JS 没接上」,实际是「Rust 侧没人调用」。规则:凡是从 import 写回来的内存必须 mut。 ② 探针 op 26 原写「poll 取满 24 条,再往 dst 尽量写」:容量只够 1 条时队列被拿走 3 条、只写回 1 条,另外 2 条蒸发 —— 正是 input.rs 警告过的「多取再丢」,丢的永远是队尾(常常是 Up),症状是手指永远按着。探针是替真机跑这段逻辑的,它违反契约,用例就只能验出「探针错了」。 顺带撞出一处编号冲突:契约 PointerPhase 是 Down/Move/Up/Cancel = 0/1/2/3,而 me_coin_run_poke 是 0/1/2 无 Move —— 1 与 2 意思相反,boot.js 那句「与 PointerPhase 一致」是假话。已开 N-013 交 A2 定方向。 收口(2026-10-26):N-013 已关闭,A2 选 B —— poke 对齐契约 0/1/2/3。 我复核了三处:wasm.rs 的 phase_from_u32 收四态、越界 4 报 InvalidArg;boot.js 的 PHASE 表与 pointermove → MOVE、pointercancel 真的发 CANCEL;wx.test.js 那条「3 被拒」反过来了(现在 3 是 Cancel、4 才是越界),并补了一条旧编号下写不出来的「按住右滑到左键区不掉键」。 所以上面那句「已加两条断言(3 被拒)」在 B 落地后就不成立了——改成这段而不是删掉:它是那次裁决之前的事实。顺带一说,统一的是相位码,不是坐标:契约给画布物理像素,poke 收世界坐标 480×270。那次乘法(N-312)已经落进 me-runtime:me_coin_run_touch_px 收物理像素、内部 px_to_world 折成世界坐标,宿主不再自己折。所以「相位统一」不能读成「接上就行」——只是这回两边真的都统一了。

crates/me-pal-wx/src/platform/input.rs · crates/me-pal-wx/src/platform/touch_codec.rs · crates/me-pal-wx/host-wx/platform.js · tools/ci/test_wx_platform.mjs

手指按下去,屏幕上出现一个点 —— 触点整链打通(第三个「看起来对」:WebGL1 没有 VAO)

触点这条链以前只到 WxPal.input 为止 —— 平台层 99 项断言全绿,但屏幕上什么都没有,因为宿主从来没去问过。展开 594 字
触点这条链以前只到 WxPal.input 为止 —— 平台层 99 项断言全绿,但屏幕上什么都没有,因为宿主从来没去问过。这一版把最后一环接上:game.js 每帧调探针 op 26 取触点,render.js 在画面之上叠一层陶土色圆点(半径 = 画布短边 6%),test_wx_host.mjs 跑真实 game.js 钉住 16 项。 三个坑,前两个已经写过(不可变缓冲 → import 被 lld 删掉;探针多取再丢丢掉队尾的 Up),第三个是这轮的:WebGL1 没有 VAO。两个 program 里同名 aPos 的 location 不一定相同,而顶点状态是全局的 —— 切了 program 不重设 vertexAttribPointer,画的就是上一个缓冲。症状是画面变成一个点,或者点跑到屏幕外,两种都不报错。 断言刻意挑了一个不在中心的手指位置(左上方 (60,180) → NDC (-0.5,-0.5)):y 翻转写反时中心点照样对,只有偏心的点能露出来。这条判据比它看起来值钱 —— 「取一个好验的值」和「取一个能验出错的値」是两件事。 还差一根真手指。 本机只有开发者工具模拟器,所以「真机摸得到」这句话没有证据,host-wx/README.md 按层写清了哪一格验到了什么。

crates/me-pal-wx/host-wx/game.js · crates/me-pal-wx/host-wx/render.js · tools/ci/test_wx_host.mjs · crates/me-pal-wx/host-wx/README.md

构建面板后半:回执里的节点能点回树上,顺手抓到「同一个事实的第二个入口」

出错时人最想做的动作是「带我去出错的地方」,而在这之前面板只给一行死文字:用户读到 节点 n_coin_2,然后要自己在树上找一个同名的行——树一长,那一步就是「看着像就点」,点错的代价是改错…展开 916 字
出错时人最想做的动作是「带我去出错的地方」,而在这之前面板只给一行死文字:用户读到 节点 n_coin_2,然后要自己在树上找一个同名的行——树一长,那一步就是「看着像就点」,点错的代价是改错节点。现在 error.node 与每条 downgraded[].node 都带 node_id,点了选中 + scrollIntoView + 闪一下。 名字 → 编号这一跳放在服务端,不放前端。理由是「重名怎么办」本身是判据:放前端就是第二份实现,而两份分叉的那一次正好是猜错的时候——界面上选中了、名字也对,只是不是出错的那一个。抽成 NameIndex 之后 budget_json 与 build_json 共用它(热力早就需要同一个映射)。映射不上给 null,前端画成虚线不可点并说出原因,不许自己猜。降级条目也从一句逗号连起来的话改成一条一个 chip:降级不是错误(那档还是编过了),不该长得像错误;但它常常是「这档为什么慢/为什么难看」的唯一线索,而「只是提了一句」的事,人是不会去树上找的。 顺手抓到一个同类缺陷:抽屉的 note 写着「要产出文件用 me build」,而 me build 按 ADR-0009 永远不落盘——这正是 N-015 那件事的第二个入口。CLI 那侧已改完并加了反向断言(tools/ci/test_cli.sh:摘要里不出现 me pack),面板这侧没人守,于是它一直停在旧说法上,看起来完全正常。改文案只是顺手,真正补的是断言:include_str!(app.js) 进测试逐行扫,me build 不得与「产出/落盘/写盘/文件」同行,注释豁免(注释里写「me build 不落盘」是对的,该禁的是把话说反)。只守一个入口等于没守。 另外:把映射抽成 NameIndex 之后 inject_studio.py 里一条既有注入静默失效(报「注入没匹配上」)。重构会悄悄废掉判据这件事,只有注入这一层能看见——已改成对新代码形态的注入,三条新断言各配一条。

crates/me-studio/src/serve.rs · apps/studio/web/app.js · apps/studio/web/style.css · crates/me-studio/tests/serve.rs · tools/ci/inject_studio.py · plan/proposals/cli-spec-3-0-pack-pointer.md

「包体分析」在 Studio 侧无处落地:它要的是工程,Studio 手里只有一份 `.mir`

S6-8 的后半原本写着「包体分析」——把 me pack 的 me.pack.v1 账本搬到 Studio 的构建面板里。展开 769 字
S6-8 的后半原本写着「包体分析」——把 me pack 的 me.pack.v1 账本搬到 Studio 的构建面板里。动手前先去看账本是怎么来的,结论是这件事在 Studio 里做不成,而且做成也是假的。 账本里能回答的三个问题(这份内容编没编过、有多少东西要画、用到哪几张图)都是 me pack 遍历工程里每一个 .mir 逐个编出来的(pack.rs 的 Compiled { path, target, draws, textures },由 compile_one 产出,编不过就整包不出)。而 Studio 的入口是 serve::open(单个 .mir 路径):没有工程根、没有 dist/、没有主包/分包预算,连 me.toml 都不读(build_json 那段注释写得很清楚:「这里打开的是一个 .mir 文件,项目清单未必在磁盘上(也可能是别的项目)」)。 所以 Studio 能画的只有它已经在画的那两个数:每档的 draw 条数与纹理清单。再往前一步(每文件字节、主包占比、分包切分、超没超 2MB)就得先凭空造一个工程视角——那是给不存在的状态铺地砖,和上一轮差点给「不可达的 parse 失败分支」做逐行可点定位是同一个错。 处置:S6-8 里删掉这半。它本来就有落点——S8-5「包体分析器:按模块/资产类型归因,输出可执行建议」(主责工具链、依赖空),我第一版 N-023 却写成了「问 A1 落哪」:没翻排班表就开口问人,这条错也记在这儿。真正要问 A1 的是形态——归因写进账本(A,我倾向)还是另做 me pack --explain(B)。判据是「谁在什么时刻读」——它决定这东西是报告还是交互。

crates/me-cli/src/pack.rs · crates/me-studio/src/serve.rs · interface/cli.spec.md

`me` 的码表漏了七条:新码没人补,因为「补文档」这件事从来没红过

验反例的时候顺手发现的两件事,都不是我原本要做的任务。展开 991 字
验反例的时候顺手发现的两件事,都不是我原本要做的任务。 一、ME-VAL-002 查不到。 我造了一个父子预算超借的 .mir,me validate 报 ME-VAL-002;拿着这个码去 interface/diag.codes.md 查——查到的是空。那张表的抬头写「62 码 / 11 域」,而 me 会打印的码是 124 个(62 条 me-mir + 62 条 CLI):ME-ARG / ME-ENV / ME-PRJ / ME-BLD / ME-VAL / ME-ENC / ME-PKG / ME-IO / ME-VER 这些全部不在里面。不是表过期,是边界没写出来——查表的人只会以为「我记错了码」。已发 N-024 请 A1 在生成器抬头补一句(那是生成物,我改不了)。 二、crates/me-cli/src/diag.rs 那张表漏了七条。 ME-PKG-018..024 是 me pack 开始编译内容那批(dd8eab2)新增的,从写下来那天起一条都没进表。而它们恰恰是眼下最可能撞上的:018–022 是分包配置自相矛盾,023 是「内容编过了、包里却没有它的文件形态」(不读这句就会以为包里有东西),024 是「编不过所以什么都没产出」(不读这句就会去 dist/ 里找一个不存在的目录)。 根因不是疏忽。 这张表是手抄的,而「记得补文档」在「加功能」面前永远输;更糟的是漏了也不红——码表缺一行,编译通过、测试通过、CLI 照跑。所以补的不是七行,是四条对账(cargo test -p me-cli):① 源码里有、表里没有 → 红;② 表里有、源码里没有(死条目)→ 红;③ 表里抄了 me-mir 的码 → 红(一个码两个家,改语义时不会一起变);④ CLI 里写下的 me-mir 码在契约表里查不到 → 红(「去那边查」这句指路指向空)。四条都实测验过会红,其中 ① 正是今天这七条。 顺带删掉本表里 ME-LOW / ME-PASS / ME-LEGAL / ME-OP / ME-BUDGET 那十来条副本,改为一句指路——与这一整轮反复撞到的「同一事实两个入口」是同一件事:只守一个入口等于没守。

crates/me-cli/src/diag.rs · CHANGELOG.md · Team/negotiation.md

S0-10 只做完了三条准入规则里的一条——另两条今天接不上闸门,不是没时间

docs/09 §9.2 有 R-AI-1/2/3 三条。展开 722 字
docs/09 §9.2 有 R-AI-1/2/3 三条。这轮只把 R-AI-1 变成了会红的判据,另两条的缺口写清楚: R-AI-3(AI 功能代码覆盖率 ≥70% 行 / 60% 分支):要求按提交统计覆盖率,而 CI 现在跑的是 cargo test --workspace,没有任何覆盖率采集。要做这条,先得把 cargo-llvm-cov(或等价物) 接进 CI 并对变更行取数——那是半天到一天的活,且它会显著拖慢 CI(现在 40–90 秒)。 更关键:这个仓库几乎全部代码都是 AI 写的,「AI 代码 vs 人工代码覆盖率谁高」这个比较 在分母为 0 时没有意义。这条的真正落点是 S10 的度量,不是 S0 的规范。 R-AI-2(B 类代码禁止 AI 生成,只能 AI 建议):判据是「这段代码属于 B 类」,而 docs/09 §6.2 的 B 类清单是散文,没有落到可匹配的路径/符号上。要让闸门能判,先得有 B 类 = 哪些文件/哪些函数 的机器可读清单——那是一份需要人拍板的东西(性能关键路径 的定义会随实现变化),不是我能单方面定的。 另一件顺手发现的:docs/13 §8「现在的守卫清单」手抄了 7 条,其中「interface/diag.codes.md 的缺席」早已不成立(62 码 / 11 域,一直在由 dump_codes 生成并逐字节比对),而实际 CI 有 二十多步。我差点因此重造一个 commit 规范。未改(docs/ 是 A1 的章节,policy 禁止改写他人章节), 已发 N-026 建议改成指针。

docs/09-development-plan.md · docs/13-docs-and-comments.md · tools/ci/ci.sh

cooked 场景格式(S3-6 的前置 —— 计划外工作;S3-6 本身在板上,归 A3)

运行时第一次有东西可读:me pack 打得出包,而包里此前没有一个字节是引擎内容。展开 1968 字
运行时第一次有东西可读:me pack 打得出包,而包里此前没有一个字节是引擎内容。「读什么」在 N-021 / N-205 已裁决为 cooked 场景,这一轮落实字节层与落点:新 crate me-cooked(L0,magic MESC,.bin 后缀,14 字节头 + 定长 52 字节条目),写与读在同一份实现里——两份反序列化器各有测试、各自全绿,对「第 21 个字节是什么」可以有不同答案,而分叉的表现是某个精灵画到别处(浮点照收、不报错)。这个论断演练过:把版本号的写与读同时改成大端,roundtrip_* 全绿,只有逐字节钉偏移的golden_bytes_v1 红。顺带把资产编号从「首次出现顺序」改成按名字排序(改节点顺序不再改编号),并删掉 interface/README.md 那份全面过期的契约表版本列。已做的第三半(2026-10-25):me build --emit-cooked <path> —— 在此之前有一个格式,没有任何命令能产出它(编码器只被测试调用),于是 me pack(要往 dist/ 放产物)与 me-runtime(要读产物)各自等对方先动,两边都"有理"地不动。默认仍然不落盘:口子必须要了才落、只接受一个输入、没有默认路径、摘要按写没写分叉、先落盘后报告。已做的第四半(同日):crates/me-cooked/examples/decode 把一份产物打印成 key=value 行,test_cli.sh 用它断言「账本的 draws 与字节解出的条目数是同一个数」——此前没有任何东西解过一次 dist/ 里那份字节,一份写坏的条目(rot 落到 sort_y 的位置)能让存在性与 magic 两条断言全绿。它也是 N-040 的镜子:两边走同一个 me_cooked::decode,于是"我读到的"与"运行时读到的"是同一句话。同日补齐的最后两半:① me pack 把字节写进 dist/(A3,N-039);② me-runtime 读它(N-040,A1 代做 A2 的扇区,见协商板 N-102)。后者此前只是文档:模块抬头写着"运行时读的是 cooked 场景",而没有任何一行代码能读它——措辞正确比措辞错误更难发现,因为读的人会以为这件事做完了。新模块 me_runtime::cooked::LoadedScene 只做接缝(解码仍走 me_cooked::decode),并且签名里要一个 Camera2D:DrawItem::pos 是世界坐标而 SpriteInstance::pos 是屏幕坐标,省掉这一步不报错——相机停在原点时画面完全正常,一旦相机跟人走,整份内容画到别处,而所有人会先怀疑美术切图。判据是"两个入口说同一句话":同一批条目分别走 World → collect_culled 与 字节 → submit,逐字段比 DrawList,相机刻意非恒等(Camera2D::new 的 center 在视口正中,等于恒等变换,忘了换算与换算对了在它上面一模一样)。跨命令那一半:me pack 账本的 draws == 运行时 items.len(),外加提交数 == 条目数(前一个数对了后一个少了,正是"换算把条目丢了"的形状)。演练:把着地点换成"矩形底边",只有一条断言红,且红法是一个字段两边值不同(255.75 vs 243.75)——测试里那条全默认的条目对这个错毫无分辨力,它的底边恰好等于着地点。 ⚠️ 这一条在 extras 里而不是 tasks 里:S3-6 = 「图集打包工具 + 运行时图集切换」(docs/10 §5 第 6 行,4 人日,主责 C/A3,依赖 S2-7),它在板上是存在的,只是还没开始。cooked 不是 S3-6 的格式层,是它的前置:图集打包要先有稳定的纹理编号与资产清单,这两样正是本轮做的。所以本轮工作不挂在 S3-6 名下,S3-6 也没有被我改成「在做」。 (前一版这里写的是「S3-6 在板上不存在、所有『等 S3-6』都是悬空引用」——那是错的。错法:我用 grep "S3-6" 去查它是否在排期表里,而排期表用行号拼 id(TASK_RE 的 "%s-%s" % (sid, num)),字面串永远不出现。订正全文见 ADR-0012 §6。)

crates/me-cooked/src/lib.rs · crates/me-cooked/tests/format.rs · crates/me-cooked/examples/decode.rs · crates/me-compiler/src/cooked.rs · crates/me-cli/src/build.rs · crates/me-compiler/tests/cooked.rs · interface/cooked.scene.md · docs/adr/ADR-0012-cooked-scene-format.md · crates/me-compiler/src/passes/lower.rs · crates/me-runtime/src/cooked.rs · crates/me-runtime/tests/cooked_scene.rs · crates/me-runtime/examples/load_cooked.rs

Gate 0 六项第一次有数:2 项通过 / 1 项有数但答不了 / 3 项缺证据

tools/report/gate0.py 把这个门从「文档里的一段话」做成能跑的仪表盘。展开 562 字
tools/report/gate0.py 把这个门从「文档里的一段话」做成能跑的仪表盘。四态是刻意选的:pass / fail / unknown / gap,后两态都不算通过。恒 exit 0 —— 还没到 W26 就长期红着的门,等于没有门(D-09 同一条教训),所以它只回答「现在有什么数」,不负责拦人。 六项的实际状态:M2 包体 7.7% 与 M6 零手写 GLSL 通过;M3 真机性能 有数但答不了(本机 Iris Xe 核显 p95 0.41ms,达标但机型不是低端安卓,报 unknown 而不是 pass);M1 上线 / M4 AI 占比 / M5 工时台账 缺证据,报 gap。 写这一页时先自欺了一次,值得记:M2 第一版读 dist/pack.json,报 349,848 B(8.3%)——而那是 .gitignore 的本地生成物,比源码旧两天,真实 1.47MB(36.7%),差 4 倍。改成现算 me pack --check --json(零写盘、复用唯一实现),无 me 时才降级读账本并比对 mtime 明说可能过期。规则很朴素:能现算就现算,只能读账本时必须说清它是什么时候的。

tools/report/gate0.py · tools/report/gate0.html

零手写 GLSL 有守卫了:A2 那条只扫 `me-render/src/**/*.rs`,JS 侧没人守

Gate 0 第 6 条(全程零手写 GLSL)此前只有一个测试在守,而它只扫 crates/me-render/src/ 里的 .rs。展开 734 字
Gate 0 第 6 条(全程零手写 GLSL)此前只有一个测试在守,而它只扫 crates/me-render/src/ 里的 .rs。只在部分范围成立的守卫,和没有守卫的区别只在心理上——host-wx/render.js 里就有 5 段手写 GLSL,它的存在证明的是「宿主通路成立」,不证明「引擎生成的着色器在 wx 上能编译」**,而后者目前是「wx 上能画」的唯一证据。所以这条豁免必须写明证明边界。 tools/ci/check_no_shader.py 扫全仓 9 种后缀,三条硬规则:清单外 → 红 / 豁免到期 → 红 / 陈旧豁免(写了但已经扫不到)→ 红。第三条是最容易被忽略的:豁免表会随代码迁移变成一张假条子,而假条子比没有条子更坏——它让人以为那处已经被管着。另外断言「生成器目录里必须仍有 #version」:守卫被删空时其余检查全绿,那种绿是空的。 现状 10 处命中 / 9 条豁免(三类:A 后端自检 5 / B 墓碑 2 / C 宿主替身+夹具 2)+ 1 个生成器目录。--self-test 8 项,另做 6 个手工变异全部被抓;又用三处源码变异(取消 stale 判定 / 空守卫不报红 / 到期比较写坏)证明自检有牙齿——三个都被抓到且名字对得上。 一处自我纠正:变异测试第一轮五个全红,实际是 global BASELINE 位置非法导致的 SyntaxError(退出码也是 1),一次都没跑起来。红得对、但红错了原因,比不红更危险——它给的是「已验证」的错觉。现在变异输出多一列「崩=False」,六个变异重跑,这次每条红的原因都对。

tools/ci/check_no_shader.py · plan/shader-allowlist.txt · crates/me-render/tests/no_handwritten_glsl.rs · tools/ci/ci.sh

主包 1.47MB → 322KB:`.html` 被剔除,它的素材留在了包里

Gate 0 的包体那项一直报「通过,但 71% 是一个演示素材目录」。展开 720 字
Gate 0 的包体那项一直报「通过,但 71% 是一个演示素材目录」。查到底的结论有点荒唐:上传白名单按后缀拦(.html 进不去),所以 me pack 每次都把演示页剔掉并打一条警告;但它引用的 wushu/ 那 1.06MB 序列帧、nav.js 按后缀是白名单内的,于是照旧进包——而包里没有任何代码会去读它(读它的那个页面自己没进包)。半截的剔除。 project.config.json 的 packOptions.ignore 加两行:folder wushu + file nav.js。主包 1,539,020 B(36.7%)→ 426,914 B(10.2%),进包文件 18 → 9;装 binaryen 后再降到 321,975 B(7.7%)。对外一个页面都没少:可试玩页 web/play/coin-run/ 只有 index.html + wasm/,演示页从来不在它里面(本地 serve.sh 直接读源目录)。去掉的是只有上传包才背的那 1MB。 两条给人看的:① 按后缀的剔除表天生不知道「谁引用谁」——这类残留不会让任何检查变红,包能上传、游戏能跑,只是白背 1MB;② 排除之后大头变成 wasm/(71%),而 Gate 0 页里那句「拆分包第一候选」是写死的,对 wasm 是做不到的建议(分包只切内容)。已改成按归因分支:大头是 wasm//js/ 时说「再降只能靠压缩」,否则才说「拆分包」。一条写死的建议,会在它描述的事实变化后继续以同样自信的语气出现。

apps/coin-run/project.config.json · tools/report/gate0.py

`D-04` 量到了:以为是查表,实测是线性 find,105 倍

技术债表里 D-04 一直挂着「待重测」——因为我的探针写错了:git grep 单行找 ops.iter().find 没命中,据此判成「代码不存在、要重测」,还在表里写「Ctx 根本没有…展开 589 字
技术债表里 D-04 一直挂着「待重测」——因为我的探针写错了:git grep 单行找 ops.iter().find 没命中,据此判成「代码不存在、要重测」,还在表里写「Ctx 根本没有 ops 字段」。真实代码是三行写的,且挂在 LegalizeReport(frame.rs:255)不是 Ctx。「没命中」被读成「不存在」:git grep 逐行匹配而代码分行写;当工具表达不了一种形态,人只能用更弱的探针凑,再用弱探针的结果下强结论。 修法不是「下次仔细点」,是给 check_debt_baseline.py 加第三种探针 text(全文跨行正则 re.S,对排版不敏感、对结构敏感)。改完量到的三个数: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 已消、「待重测」那格是空的。代价最高的一条教训写在 plan/debt-baseline.json 头部的 $comment 里。

plan/debt-baseline.json · docs/16-tech-debt.md · tools/ci/check_debt_baseline.py

关卡文本压着进包:wasm 769.9 → 724.1 KB(计划外 —— 接素材之前先谈包体)

接完武侠图集后 wasm 只剩 30.1 KB 余量,而下一批素材估 46.5 KB —— 一接就撞 800 KB 线。展开 1165 字
接完武侠图集后 wasm 只剩 30.1 KB 余量,而下一批素材估 46.5 KB —— 一接就撞 800 KB 线。这一笔先把字节花在哪量清楚:data 占 62.1%、code 37.4%;data 里三张 .rgba.z 占 353 394,而那三张已经压过了。 三条「看起来免费」的路都是假的,这是我先花时间证明的事: ① 每行按 PNG 启发式挑过滤器(不再一律 Sub)⇒ 三张合计只省 1.9 KB,世界图集反而 +1 629 字节——启发式优化熵,deflate 抓重复,两者不是一回事; ② alpha=0 处把 RGB 抹零 ⇒ 透明像素占 39.7%,但 RGB 非零的只有 1.7%,只省 197 字节; ③ 背景 101 760 个像素里有 36 351 种颜色、世界图集 48 241 种 ⇒ 这就是 deflate 在噪声型艺术图上的极限(2~3 倍),不是参数没调好。 真正压得动的是文本:十二关 .lvl 原文 56 899 字节,是包里唯一没压过的东西。levels/pack.py 把它们首尾相接蒸一袋(MLV1 + 关数 + 每关原始长 + 一个 zlib 流)56 899 → 8 626。一个流而不是十二个:整袋 8 572 对逐关 23 907 —— 字段名 / 缩进 / 注释用词高度重复,分开压等于让每一关重新学一遍字典。 不剥注释是刻意的:删了只多省 3 KB,但那样「包是不是最新」就只能靠 Python 与 Rust 两套剥注释逻辑互相对齐来证明,而分叉的症状是「某关少读一行」。留着原文 ⇒ 判据能写成最硬那种:the_packed_levels_are_byte_identical_to_the_sources 拿包里解出来的字节与 include_str! 原文逐字节比。反向验过:给第 1 关加一行注释不重打包 ⇒ 当场红(56899 vs 56939),改回复绿。 代价一侧:data 489 242 → 441 177,code +632(解包 + 断言)。作者流程多一步:改完 .lvl 要跑 python3 crates/me-runtime/levels/pack.py,漏跑的症状写在断言消息里。十二关机器人全通,逐关 coin 数与改前一致(84/96/101/…/172)⇒ 压包没有动解析结果。 余量没花完就又要谈:这一笔把余量从 30.1 抬到 75.9 KB,随后点阵改走词法花掉 8.3 KB(见 S3-7),现在 67.8 KB。素材那批装得下,但只富余 21 KB —— 再接一关地面就还得回来谈。

crates/me-runtime/levels/pack.py · crates/me-runtime/levels/pack.bin · crates/me-runtime/src/coin_run/level.rs

Studio 不加载 `.atlas`:写了 `atlas=`+`frame=` 的 sprite 场景在 Studio 里一律编不过 —— **已修(2026-10-26 深夜)**

已修(2026-10-26 深夜)。 修法与下面列的 a 一样,但前提被改写了:.atlas 与 .mir 同层不是 Studio 的偏好,是格式契约(interface/atlas.file…展开 1329 字
已修(2026-10-26 深夜)。 修法与下面列的 a 一样,但前提被改写了:.atlas 与 .mir 同层不是 Studio 的偏好,是格式契约(interface/atlas.file.md),所以「要不要承认场景有邻居」这条主张根本不用动 —— 它读的就是那份文件。读侧从 me-cli 的 mod atlas_io 拆成 crates/me-atlas-io(L7,只依赖 me-compiler),CLI 与 Studio 共用一份策略,否则「Studio 说编得过 / CLI 说编不过」会成为一种可能,且两边都像是对的。帧表每次编译现读(与 Session::disk 每次快照读 .mir 同一取舍),面板上先给装载结果再给每档结论,坏帧表的「第一症状」因此不再是那句误导人的「引用的图集不存在」。判据 4 条在 crates/me-studio/tests/atlas.rs,两次演练过会红(换回 compile 红 3 条 / 摘掉回执字段红 4 条)。interface/examples/atlas_frame_scene.mir 现在 Studio 报「4 条 draw · 贴图 sheet.png」,me build 报「4 条绘制 · 1 个纹理」,一致。余下一条要 A1 点头:新 crate 的扇区登记已在 tools/ci/cross-sector.txt(代修,复核人 A1,到期 2026-11-09)。详见 CHANGELOG 2026-10-26「Studio 开始看得见帧表」。 实测(2026-10-26):打开 interface/examples/atlas_frame_scene.mir,/api/build 的每一档都报「n_f0 的 atlas="sheet.atlas" 没加载到。这次编译看见的帧表:(一份都没有)」。原因不是 bug 而是前提:Studio 只打开单个 .mir,没有工程上下文,build_json 传的是空 AtlasSet;而 .atlas 文件就在同一个目录里(props.atlas / sheet.atlas)。 后果有三层:① 这类场景在 Studio 里根本编不过,构建面板只剩一条错误;② 前后对比的线框对它们永远是空的(draw=0);③ draw 预算与纹理表在 Studio 里也一律是 0 —— 面板上那几个数字对 sprite 场景从来没有意义。 修法两种,都动了别人的边界:a) Studio 读 .mir 同目录的 *.atlas 并在 compile_with 时喂进去(要 me-atlas 的读侧,而 me-cli 现在已经有一份 atlas_io,不能抄第二份);b) me build 那条路上加一个「把工程上下文交给 Studio」的参数。选 a 更小,但必须先说服自己「Studio 该不该知道工程」——它现在的主张是「一个文件就是一个场景」。

crates/me-studio/src/serve.rs · crates/me-studio/src/preview.rs · interface/examples/atlas_frame_scene.mir

十三个示例里只有一个进过 Studio 的判据:补一条按目录遍历的,顺带把「0 条绘制」和「链路没接通」分开

这是上一节 .atlas 那个缺口的复盘点。 那个 bug 不是判据发现的,是有人打开例子看见面板报错;展开 948 字
这是上一节 .atlas 那个缺口的复盘点。 那个 bug 不是判据发现的,是有人打开例子看见面板报错;而我补的判据(tests/atlas.rs 第四条)用的还是同一个文件。出一次事、补一条判据、出事的那份内容从此被钉死,下一份内容照旧没人管——而 .atlas 从来没有只影响一个文件,它影响「凡是写了 atlas= 的内容」,只是当时仓库里恰好只有一份。 新增 crates/me-studio/tests/examples.rs,2 条判据:① 遍历 interface/examples/*.mir,每个示例的每一个档位都要编得过(逐档看,不看总数——档位之间 caps 不同,一档红一档绿是正常的);② 每个档位的 draw 数等于内容自己文件头那行 # expect-draws:。 三个取舍写在文件文档里:循环条件是目录不是清单(写死十三个文件名要有人记得加第十四行,而「记得」不是机制;另钉一条「少于 13 个就是走错目录」,防 read_dir 读空导致的假绿);期望值不搬进测试(# expect-draws 已经在内容里,抄一份就是第二个真相源);只核 draw 不核 textures/plan(那些量跨档位本来就该不同,把它们钉成相同是造假判据最快的方式)。 两次演练:把 build_json 换回 me_compiler::compile(不喂帧表)⇒ 两条全红,报的是「atlas_frame_scene.mir 在 wechat_android 这一档编不过:ME-REF-003 n_f0 的 atlas="sheet.atlas" 没加载到。这次编译看见的帧表:(一份都没有)」——正是那个历史 bug 的原话;把 tint_scene.mir 的 expect-draws 改错一格(4→5)⇒ 只有第二条红、第一条照旧绿,说明两条分量的是「编得过」与「编出来的东西对」两件事。 落笔前先把 13 个示例 × 2 个档位与 # expect-draws 核了一遍(全部一致)才写成断言——否则是拿一个没验过的期望去判别人的活。

crates/me-studio/tests/examples.rs · interface/examples/tint_scene.mir

写侧只被两份夹具验过:九宫格 / 图层栈 / uv 内缩 / 深度排序 / 层级从没走过存盘,而它们今天全部逐字节往返

write.rs 的单测用 coin_scene 与 sprite_scene 两份夹具,两份都只用到一小撮语法。展开 986 字
write.rs 的单测用 coin_scene 与 sprite_scene 两份夹具,两份都只用到一小撮语法。新加 crates/me-studio/tests/roundtrip.rs,循环条件同样是目录(interface/examples/*.mir),先拷到临时目录再存——判据绝不能指着仓库里的示例写盘,一次失败就会把仓库改脏。 结论:十三个示例打开再存盘,全部逐字节相同。 落笔前先单独跑了一遍 me fmt 确认示例本来就在规范形态,才把它写成断言。 两条判据一个走值一个走账:① 存盘后磁盘字节与打开前逐字节相同(失败时把差异逐行打出来,最多 5 行——「整篇不相同」这句话没法做事);② 存完快照里的 disk 必须还是 same,钉的是 saved_digest 的记账方式:它若取自别的来源,下一次存盘就会拿自己刚写的产物当成「别人改的」报 SAVE_STALE,而那种错最难归因(句子是真的,只是它指一次自己刚做的写)。判字段不判文案。 这一轮最值钱的不是判据,是我自己踩的那个坑:第一版把存盘写成 POST /save(真实路由是 POST /api/act + act=save),「字节不变」那条红了报 404,而「不许报盘上改过」那条绿了——因为它的断言是「不许出现 SAVE_STALE」,在一条恒回 404 的路上,否定式断言永远成立。改法不是补一句 status 断言,是把断言翻成正面的(ok:true + err:null + disk:"same")。与「判据抓症状不抓机制」是同一个病的两个面:那个是「测的是夹具的性质」,这个是「测的是一条没人走的路的性质」。 顺带:测试一开始想直接读 Session::revision,但它不公开——改成从 /api/doc 快照里读,也就是前端拿版本号的那条路。测试不该有后门让判据走的路比用户短,短出来的那一段正好是出事的那一段。 两次演练:save_to 写盘多加一个换行 ⇒ 两条全红(先红的是指纹那条,比字节 diff 早一步);saved_digest 写成 "deadbeef" ⇒ 两条全红,报的正是 "disk":"changed"。

crates/me-studio/tests/roundtrip.rs · crates/me-studio/src/editor.rs · crates/me-studio/src/serve.rs

预算面板说不出「帧表坏了」;补的时候浏览器抓到一个 `,,`,而那两条新判据是绿的

两个面板说法不一致的地方:构建面板从 2026-10-26 起就会先报「谁坏了」(atlases{loaded,problems}),预算面板不会。展开 956 字
两个面板说法不一致的地方:构建面板从 2026-10-26 起就会先报「谁坏了」(atlases{loaded,problems}),预算面板不会。于是屏幕上出现「热力图一片健康、构建红着」这种很像自相矛盾的组合。 先被实测否掉的,是我自己写在代码里的那句:「没有帧表这一档一开始就断,整张热力图是空的」。把 with_atlases 摘掉再取一次 /api/budget ⇒ levels 一个数字都不变:Budget 读的是节点上声明的额度,不跑 lower。所以热力图不会空,它甚至会看着很健康——那才是危险的地方。注释、界面文案、判据文档三处都按实测改写。 然后浏览器抓到我自己写的 bug:atlases_json 一直带尾随逗号(老约定:调用方紧跟 "profiles"),新的预算调用方又补了一个 ⇒ 回执里出现 ,, ⇒ fetch().json() 抛,横杠不出现。同期新写的两条 Rust 判据是绿的,因为它们只做字符串包含匹配——拼错一个逗号,字符串还在,只是整段不再是 JSON。 修法两层:① 片段不带分隔符(atlases_json 只吐一个值,逗号归调用方);② 判据比形状不比字串——crates/me-studio/tests/json_shape.rs 手写五十行严格解析器(零依赖),13 个示例 × doc/ops/build/budget 逐段解一遍,另有专钉「坏帧表时两个带 atlases 的回执仍合法」的用例(,, 正是两个调用方共用一个片段的交叉点)。演练:把尾随逗号放回去 ⇒ 两条全红,报「第 76 字节,附近:…"problems":[]},,"profiles":…」。 界面:打开热力时挂一条警示横杠 + 状态栏同一句话(#atlasbar,复用 .diskbar 骨架、左侧换警示色)。实测(无头 Chromium 1247,1440×900,浅色):横杠出现、.atl-bad 显示 sheet.atlas:缺 pad 行、构建面板报 ME-REF-003,两处一致;对比度正文 13.16:1、边框 4.88:1。

crates/me-studio/src/serve.rs · crates/me-studio/tests/atlas.rs · crates/me-studio/tests/json_shape.rs · apps/studio/web/app.js · apps/studio/web/index.html · apps/studio/web/style.css

前端打出「应用了 undefined 处」:回执里没有那个数;修的时候又发现那 11 条浏览器判据在本机一次都没跑过

症状:合并 A1 的 Ctrl+Z(2af47bb)后,工作台状态栏写的是「应用了 undefined 处」。展开 1057 字
症状:合并 A1 的 Ctrl+Z(2af47bb)后,工作台状态栏写的是「应用了 undefined 处」。回执里有 status/dry/compare/undo,唯独没有那个数——服务端算过(Applied::steps()),只用在了那句中文里。补 ,"landed":N,并写两条判据钉住它:① 两条命令故意让一条落空(layer 已是目标值)⇒ landed==1,且按一次 Ctrl+Z 一次就逐字节回原样(与「只落了一步」是同一件事);② 预演与幂等的 landed 都是 0。两次演练:改成 p.ops.len() ⇒ 两条全红(同一份回执自相打脸:note 说 1 条落地、landed 写 2);摘掉字段 ⇒ 两条全红(「回执里没有 landed」)。 更贵的那件事:verify-apply.js / verify-workbench.js 把浏览器路径写死成 macOS+arm64+chromium-1228,于是这台 Windows 机器上一次都没跑过——而「没跑过」与「跑过且通过」在报告里长得一模一样。新增 apps/studio/web/browser.js 按平台+按数字找最新 revision,CHROME 环境变量优先。第一次整份跑起来,11 条红了一条:第 11 条等的是状态栏文案「一个字节都没改」,而那句话冲突那张脸也说(分不出 noop 与 conflict),实测这一屏写的是「文档已经是目标态」⇒ 15 秒超时。中间我第一版改法也错了一次(改判 state.last.status——它是整屏快照,load() 一刷就被覆盖),跑一遍才发现;最终锚点改成结果区的 data-state(就是回执 status 的渲染),演练指到 conflict ⇒ 该条超时变红。 顺带两处「写死的路径在另一台机器上是另一个意思」:截图存 /tmp/wb-*.png 在 Windows 上落到 D:\tmp\ 而打印的仍是 /tmp/…(改 os.tmpdir());run-workbench.sh 的 lsof(改 netstat 的 LISTENING 行)与 NODE_PATH(三处依次找)。 现在一条命令:4 组视口 0 违规 + 11/11 行为判据,RC=0。这套脚本第一次在本机整份跑通。

crates/me-studio/src/serve.rs · crates/me-studio/tests/serve.rs · apps/studio/web/browser.js · apps/studio/web/verify-apply.js · apps/studio/web/verify-workbench.js · apps/studio/web/run-workbench.sh · apps/studio/web/workbench.js

两条真机判据一次都没跑过:一条的 `CHROME` 被启动器覆盖,一条住在别的平台的 `elif` 里

第一件:同一个 CI 里 CHROME 有两份,一份是找对的、一份是写死的。展开 1678 字
第一件:同一个 CI 里 CHROME 有两份,一份是找对的、一份是写死的。 ▸ 批处理吞吐 那步绿着(✓ 真机 PERF OK 1000 vs 3),紧跟着一步写的是! [SHOT-NO-CHROME] 离屏回读本轮没跑 —— 同一个变量、同一次运行、两个结论。病根不在探针:ci.sh 用 find_chrome() 找到本机的 Chrome 并 export CHROME=,而 apps/coin-run/run-audio.sh 第 21 行是无条件覆盖(不是 ${CHROME:-…})。于是它起了一个在这台机器上不存在的路径,--remote-debugging-port=9222 从来没监听,探针等 20 秒后报「没等到 Chrome 的 page target」—— 那句话把病根从启动器指到了探针上,而 CI 摘要里只留下一条「这台机器没装浏览器」的降级。 改法三行:先认 $CHROME、再退回 macOS 默认;起不来就当场说清楚是哪个路径没跑起来(✗ 找不到可执行的 Chrome/Chromium:<路径>,退出码 3),不留给探针去报一句它看不见的话。实测(Windows 11 + 系统 Chrome,--headless=new --use-angle=swiftshader):A 读回 8294400 字节(1920×1080×4)· B 非透明 100% · C 行序正(上 [29,34,36] 亮于下 [19,21,23])· D 帧 19 与 57 的指纹不同 · E 释放后可再分配 · F PNG 2.2 MB 落地且 256 点回读差 0。 第二件:72 条判据住在「非 macOS 就走掉」的分支里。 S4-8 那半条 DoD(「切过去不白屏」)的判据此前是 elif bash apps/macos-demo/build.sh --check 成功分支内部的一个嵌套 if。它在 Windows/Linux 上不可能跑到:那个 elif 的第一句就是 degrade METAL-MACOS-ONLY。而它跟 Metal 毫无关系 —— run-switch.sh 走的是真 Chrome 的软件光栅,任何平台都跑得起来。一个降级标签盖住两件不相干的事,它读起来就像那两件都验过了。 拆成独立 step (▸ S4-8 真宿主:切过去那一帧到底画出了什么)之后在本机第一次真跑:72/72,20 秒。 连带一件必须说的:跨后端对账要两侧同时在(Mac 的可执行文件 + 浏览器吐的 DOM)。它原来嵌在 Metal 分支里,「没有 Mac 那半」是隐含前提;拆出来后这个前提得自己讲,否则一到非 macOS,cross-render.py 会因找不到 demo 而抛错,被归成 ✗ 跨后端对账未通过 —— 一条假红,指向 me-render 的代码。新增 CROSS-MACOS-ONLY,把「浏览器那半已验 / 对账这半没验」写在标签里。 演练(判据红的那条路要真走过):把 switch.html 的 KINDS_MIN 改成 999999 ⇒ ✗ S4-8 真宿主判据未通过 + 12 行 ✗ L<n> 颜色种类 实测 8313 期望 ≥ 999999,退出码 1;还原后 72/72。演练跑的是从 ci.sh 按行切出来的原文外面套 step/ok/bad/degrade 桩,不是复述一遍逻辑 —— 复述的版本绿了,不能说明文件里的那份是绿的。 数字变了,方向也是对的:降级项 5 → 6。原来那 5 项里 METAL-MACOS-ONLY 顺手盖住了两件事,现在多出来的 CROSS-MACOS-ONLY 明说了「哪一半没验」;同时少掉两条「其实一直没跑」的假降级。

apps/coin-run/run-audio.sh · tools/ci/ci.sh

坦克战的宿主接过手就是坏的:一条新导入把整页打白,而此前没有任何东西在跑它

协商板 N-113(A1 → A3,11-02 前要一个能点的页面)。展开 1144 字
协商板 N-113(A1 → A3,11-02 前要一个能点的页面)。页面本来就有,但它坏了两天:引擎 2026-10-26 为离屏回读(S6-3)加了 me_gl_read_render_target,apps/tank-battle/gl-stub.js 的桩没跟上,于是 WebAssembly.instantiate() 整份失败 ——白屏、主循环不启动、屏幕上一个字都没有(原因只在 console 里)。 没人发现的两个原因叠在一起:① 这一页没有任何东西在跑;② 跑它的两个脚本都把路径写死成 macOS(CHROME 是无条件覆盖,NODE_BIN 默认 …/bin/node,而 Windows 上是 node.exe、没有那一层 —— 于是 build.sh 里那道「V8 校验」一次都没打过,构建照样报「好了」)。判据静默跳过与判据通过长得一模一样:都不打扰你,都留下一份成功的产物。 修:① 桩补上,返回 -1(Unsupported)而不是 0 —— 0 是「读到 0 个字节」,是成功,桩唯一会撒的谎就是说自己成功;② build.sh 的 V8 校验加一条「胶水的 env 键必须逐个覆盖 wasm 的导入表」,求值真实文件而不是从源码抽名字(抽名字会把注释里的名字算成已提供);③ 新增 tools/ci/check_glue.js + CI 一步:只读两个入库文件、0.2 秒、不要浏览器,于是这类断裂第一次有了拦网;④ CHROME / NODE_BIN 先认外面、再问 PATH、再退默认,都没有就当场报路径并 exit 3;⑤ cleanup 等 Chrome 真退再删 profile(Windows 上会刷几十行 Device or resource busy,把判据输出淹掉 —— 输出被噪音埋住和没跑是一回事)。 实测(Windows 11 + 系统 Chrome):60.0 fps · 真触摸事件 · mv [0,-1000] / aim [0,-1000] 模拟量 · 炮弹峰值 1 发 · 血 100%→75% · 推进 0→13.9% · 五张截图。演练:摘掉桩里那行 ⇒ 少了 1 个 env 导入:me_gl_read_render_target,build.sh 退出码 1;还原后 24/24。 边界写明:行为判据(真触摸 + 截图)没进 CI —— 它要 Chrome 和一份不入库的 wasm 产物,在干净机器上会永久降级,而永久降级就是「没跑过」换了个说法。进 CI 的是集合关系那一条。

apps/tank-battle/gl-stub.js · apps/tank-battle/build.sh · apps/tank-battle/run-shot.sh · tools/ci/check_glue.js · tools/ci/ci.sh

图集的「逐字节相同」只查了一半的帧:那 2 帧 opaque 正是当年出过半透明白线的那两帧

症状是一条判据的半边:package.py 里 rgba 与 opaque 是同一个约定的两个入口(源图整幅照用、不过 cut_frame),而 verify.py 的第 ⑪ 条(图集里那块必…展开 1354 字
症状是一条判据的半边:package.py 里 rgba 与 opaque 是同一个约定的两个入口(源图整幅照用、不过 cut_frame),而 verify.py 的第 ⑪ 条(图集里那块必须与源 PNG 逐字节相同)只查了 rgba。于是 2 帧 opaque——ground 1152×160、platform 320×32——在像素这一层没人看,而它们正是最早出过「地面顶上浮一条半透明白线」的那两帧。A1 在代修登记里请我复核的就是这个边界。 覆盖面补上之后判据当场红了,但红的原因不是图集坏了,是它自己读不懂:解不开源图 ground.png:只认 8 位 RGBA(实际 颜色类型 2 / 位深 8)。ground.png / platform.png 是 PIL 存的 RGB,没有 alpha 通道。「读不懂就抛错」这个态度是对的(返回空结果与通过长得一样),但认识的范围太小 —— 一条判据停在自己读不懂的地方,和图集对不对无关。 改:解码器认 8 位 RGB(类型 2)与 RGBA(类型 6),RGB 展开时 alpha 补 255(RGB 就是「处处不透明」的另一种写法,与 opaque 的语义是同一件事);反滤波仍在原始样点空间做(bpp=3/4),最后统一展开成 RGBA;其余格式照旧抛错。 不自证:拿 PIL 当独立参照物,6 帧逐字节比 convert("RGBA") —— ground(RGB 1152×160) / platform(RGB 320×32) / walker / flyer / item-shield / bullet(均 RGBA) 全等。 两条演练都演练过会红(退出码 1):把 ground 那块头三行的 alpha 压到 37(复刻当年的白线)⇒「3/160 行不同、不透明像素差 3456 个」(3456 = 3×1152,数目对得上);只把帧表的 ax 改 1 ⇒「标了 opaque,但图集里是 1152×160@(1,0),源图是 1152×160 —— 它被 cut_frame 裁过」。还原后 3 份图集全绿。 裁定:A1 提的那个替代方案(px 改「原图尺寸」语义、verify 比 ow/oh 并断言 ax+w ≤ ow)不采纳。opaque 那两帧是平铺素材,裁一下就没有「整条」可言;rgba 那批硬要求本来就是内容贴满画布。而原来那条理由(w×h 要与 px 相等)现在有第二条判据兜着,不必再动数据模型。 一个坑:library/art 是 submodule,图集产物住在里面 —— 演练改坏了在主仓库 git checkout <那个路径> 会报 is in submodule,得先 cd library/art。另外 package.py 要 PIL+numpy,这台机器的 python 没有 numpy,所以「改 spec 重打一遍」的演练路径走不通,演练一律改成直接扰动产物(改像素 / 改帧表)—— 这反而更贴近事故本身。

tools/atlas/verify.py · tools/ci/ci.sh · tools/ci/cross-sector.txt · CHANGELOG.md

`CONTRACT-STALE` 一直是假的:检查器拿工作区原始字节算契约哈希,冤枉了 A1 一轮

interface/mir.spec.md 登记的是 5494c95d10b4812f,而 check_ownership.py contracts 报 349cffde38cc1274 ST…展开 1288 字
interface/mir.spec.md 登记的是 5494c95d10b4812f,而 check_ownership.py contracts 报 349cffde38cc1274 STALE 待更新,于是我这边 CI 连着几轮挂一条降级。看上去像 A1 漏登了哈希——他上一手(bb640e1)写的正是「上一手只 bump 了版本没登哈希」。 他登对了,红的是检查器:git 里那份 26336 字节、0 个 CRLF,sha256 就是 5494c95d…;而工作区那份 26850 字节、514 行 CRLF + 9 行 LF(混的),算出 349cffde…。.gitattributes 第一行写的就是 * text=auto eol=lf,进仓库的那份永远是 LF。检查器数的是磁盘字节,于是它回答的不是「内容变没变」,是「这份是哪个操作系统检出的」。 这个错的代价不是一条降级,是它会把人往反方向推:看到「STALE 待更新」的人会去改 MANIFEST.json 里那 16 位,把一个纯换行差异写成一个真的假哈希,然后在 macOS 上再红一次。一条判据如果修它的动作会让事实更错,它比不判更糟。 修:contract_digest() 一律按 LF 规整后算,并把「工作区是 CRLF」单独报出来(planned 只是信息;frozen 那条连硬红都会消失——以前 Windows 上编辑器把一份 frozen 契约写成 CRLF 就是一条 DRIFT,要人「bump 版本并在 ADR 里记一笔」)。汇报层 ci.sh 同时把这句带出来:检查发现了、汇报层吞掉,等于没检查。 自检 10 → 13 条,钉的是判据在回答哪个问题:换行不同内容相同 ⇒ 同一个哈希;换行不同要被标出来;内容真变了 ⇒ 哈希必须不同。三条演练都演练过会红:① 退回 lf = raw ⇒ 自检 2 处 FAIL、退出码 1(还原 13/13);② frozen 契约转 CRLF ⇒ ok(改之前是 DRIFT 硬红);③ 真改一个字节 ⇒ DRIFT、退出码 1。汇报层另用「把 mir.spec.md 临时转回 CRLF 再跑一遍」验过:提示行真的冒泡到结论里。 顺带把 interface/mir.spec.md 的工作区副本转回 LF(git hash-object 与 git rev-parse HEAD: 都是 5b015d5)——不回这一步,这台机器就一直在验一个 git 里不存在的状态。 降级项 6 → 5。剩下 5 项里没有一项能在这台机器上消掉:CROSS-MACOS-ONLY / METAL-MACOS-ONLY 要 Mac,WX-RUNTIME 要开发者工具,IOS-CHECK-ONLY 要 macOS 链接,XSECTOR-PENDING 是等别人复核的代修条目。

tools/ci/check_ownership.py · tools/ci/ci.sh · interface/mir.spec.md · CHANGELOG.md

「浏览器路径收敛到一处」的第一版漏了 Windows —— 合并动作本身摘掉了一整个平台

A1 把散在十九处的浏览器路径收敛成 tools/find-chrome.sh。展开 1004 字
A1 把散在十九处的浏览器路径收敛成 tools/find-chrome.sh。方向对,那份 docstring 里甚至就写着我这轮踩的病根(run-audio.sh 连 $CHROME 都不看)。所以合并时我这边几份默认值全部让位。 但合完先跑了一遍它:bash tools/find-chrome.sh --require ⇒ ✗ 找不到可用的 Chrome(退出码 3)。而三分钟前 CI 里 真机 PERF OK 1000 vs 3 / A 读回 8294400 字节 / 真宿主 通过 72 / 72 三条都真的跑过 —— 用的是各脚本里那套 Windows 候选。照这份文件合进去,三条会一起变成降级,报告写「这台机器没有浏览器」。 缺两段,都补了:② Windows GUI 安装路径(Program Files / x86 / LOCALAPPDATA,/c/... 与 $PROGRAMFILES 两种写法都留);④ Windows 的 Playwright 缓存根(%LOCALAPPDATA%\ms-playwright\chromium-*\chrome-win\chrome.exe,Linux 的 ~/.cache/ms-playwright 一起补)。补完实测:找到 /c/Program Files/Google/Chrome/Application/chrome.exe,--require 的真渲染探针也过。 这件事的性质比那两个路径重要:收敛的收益是「只有一处要改」,代价是那一处必须覆盖所有平台。收敛的第一天往往就是某个平台静默失去能力的那天,而症状(几项判据一起降级)与「这台机器没装浏览器」长得一模一样。判断方法只有一条:改完在你没有的那台机器上真跑一次 --require —— 这次是因为「合并完先跑一遍它」这个习惯才撞上的。 ci.sh 侧同时按那版重写:CHROME_BIN 走 --require、原因收进 CHROME_WHY(降级信息里必须写「为什么没有」),本地那份 find_chrome() 删掉(留着就又是两份)。合并后全量 CI:EXIT=0,169s,5 项降级,与合并前同一组,无 NO-CHROME 回归。

tools/find-chrome.sh · tools/ci/ci.sh · apps/coin-run/run-audio.sh · apps/tank-battle/run-shot.sh · CHANGELOG.md

视口那一半:那 8.3 MB 出了浏览器没有下游 —— Studio 只能当管道,而当管道也得有判据

A2 把 Backend::read_render_target → me_coin_run_shot 做完了(真机 5 条判据),但那 8.3 MB 出了浏览器没有下游。展开 1707 字
A2 把 Backend::read_render_target → me_coin_run_shot 做完了(真机 5 条判据),但那 8.3 MB 出了浏览器没有下游。Studio 是主机侧 HTTP 服务,手上没有 GL 上下文,它不可能「自己渲染出画面」——主机侧再写一个光栅器就是第二份渲染实现,而两份实现的分叉不是两边都错,是只有一份还在改(preview.rs 当初就是因为这个改成比 draw 列表的)。 所以这一层只能是「把那一帧搬过来再搬回去」。搬运算不算工程?算 —— 只要它有三条会静默给错答案的路:① 信 w/h 不看字节数(1920×1080 少 4 字节 = 每行错一个像素,整幅图斜着错位,看起来像渲染器坏了);② 存引用不存副本(连接一关字节就没了,画面变成上一次的内容,随机且复现不了);③ 全黑帧当错误拒掉(黑屏是症状不是协议错误,拒掉等于把证据销毁)。三条都写进 frame.rs 抬头并各有对策。 几个具体的取舍:只留最新一帧(视口要「现在是什么样」,不是「刚才都画了什么」);serial(服务端数,防「拿 12 的宽高画 13 的字节」)与 src_seq(发送方报的,只进统计)分开;Response 加 bin 而不是把 body 改成 Vec<u8>(后者会让 300 多处断言失效);正文上限分两档(表单 64 KB 原样,帧 64 MB 取 frame::MAX_BYTES 不各写一遍),声明超限当场 413 且不读正文。 判据三段,各自守一层:tests/frame.rs 18 条(8.3 MB 过真 socket 一圈逐字节不变;w=0 的投诉必须是「宽高不能是 0」而不是「长度不对」—— 顺序陷阱;带 Expect 的客户端必须先收到 100)、verify-viewport.js 13 条(进 CI,落点是 getImageData 读回来的像素)、verify-viewport-engine.js 8 条(--engine 手动,真引擎 8.3 MB 端到端)。五条演练都演练过会红,红在哪一条记在抬头:第一版写的是「删掉尺寸更新 ⇒ ⑨ 红」,演练时实际先红在 ③(超时)—— 说明书跟着实测改。 一个我自己先踩的坑:第一版按路径分 POST/GET,GET /api/frame 也进了「只收 POST」那条分支,页面每次轮询都 405,报告上像「视口页坏了」。方法必须参与分流。 顺手认了 Expect: 100-continue,这一条省的是一秒:不回的话 curl 等满 1 秒才发正文,我量到的「推一帧 1.02 秒」里服务器真正花的是 30 ms —— 一个把人指向「服务端太慢」的假数字(我还为此去 release 版重编了一遍才怀疑到客户端)。认了之后 8.3 MB:POST 31 ms / GET 6 ms。 留给 A2 的那一件:POST /api/frame 过 guard_origin + token ⇒ 浏览器里的页面必须与 Studio同源。跨端口的引擎页推不了(这是设计,否则随手打开的任何网页都能往你视口里塞图)。真引擎演练里我用 page.route() 把 /play/ 从磁盘喂给浏览器,让那个页面真的运行在 Studio 的源上**—— 走的是与「将来 Studio 自己托管工程」一模一样的那条路,而不是把防线关掉。但「引擎页面以后由谁托管」这个问题必须有人回答:同源托管,或者继续两个端口 + CLI 中转。球在 A2。 真引擎端到端 8/8:1920×1080 · 8 294 400 字节 · 不透明 100% · 抽样 176 种颜色 · 引擎页与视口页的校验和都是 18da544b。CI 56 步 / 2127 个测试 / 255 秒 / 5 项降级(同一组)。

crates/me-studio/src/frame.rs · crates/me-studio/src/serve.rs · crates/me-studio/tests/frame.rs · apps/studio/web/viewport.html · apps/studio/web/viewport.js · apps/studio/web/verify-viewport.js · apps/studio/web/verify-viewport-engine.js · tools/ci/ci.sh · CHANGELOG.md

跟 A2 要的一句话:视口那条路 1080p 只有 44 fps,55fps 的门槛过不去

S6 的 DoD 里「视口 ≥55fps」与这条「读回 + HTTP」路的实测 44 fps 只差一点点,而差一点点最容易变成「上线再说」——那时候再发现就得返工,因为退路(降分辨率 / 共享…展开 704 字
S6 的 DoD 里「视口 ≥55fps」与这条「读回 + HTTP」路的实测 44 fps 只差一点点,而差一点点最容易变成「上线再说」——那时候再发现就得返工,因为退路(降分辨率 / 共享纹理)不是一晚上的活。所以先量再谈。 1080p:进程内 11.0 ms、真 socket 往返 22.9 ms ⇒ 44 fps;半分辨率:2.7 / 5.9 ms ⇒ 169 fps。降分辨率是一条真退路(余量 3.1 倍),不是安慰话。而这还没算 GPU→CPU 的读回、浏览器 putImageData、页面轮询——所以「能跑 55fps」与「跑得顺」之间还差一截,那一截只能由共享纹理解决(S6-3 原文的 macOS 优先,DoD 后面写着降级为独立渲染窗口)。 顺手量出一件反直觉的事:这一层八成成本不在搬运。put 的 1080p 三项是拷贝 1.2 ms / 数 alpha 0.73 ms / FNV 逐字节 7.7 ms。谁要提速该动摘要而不是拷贝——但我没动:digest 是写给 A2 独立核对的(N-313 说回执带 digest),换成快 3 倍的分块哈希会让那个数再也不能被第三方算出来。拿 3 倍换掉一条可核对的证据,不划算。 判据的力气写在测试抬头里:① 绝对上限 35 ms、② ≤11×memcpy(判机制不判机器)、③ 1080p 与 540p 的每 MB 成本 <2.5 倍(判固定开销)。演练了一条:插一遍逐字节扫描 ⇒ ② 红在 13.0 倍;①③ 演练不出红,原因也写在抬头里——留着它们是因为它们拦的是 ② 拦不住的方向(整机变慢 / 固定开销)。

crates/me-studio/tests/frame_cost.rs · crates/me-studio/src/frame.rs

热重载的前置:先给一个「第几版了」的通道,而不是先给一份增量协议

S6-6 要「编辑器改属性 <50ms 生效」。而在这之前,一个消费者想知道文档变没变,只有轮询 /api/doc 或 /api/mir 两条路,都是几十 KB —— 60Hz 轮询等于拿几…展开 629 字
S6-6 要「编辑器改属性 <50ms 生效」。而在这之前,一个消费者想知道文档变没变,只有轮询 /api/doc 或 /api/mir 两条路,都是几十 KB —— 60Hz 轮询等于拿几 MB/s 换一个布尔值。 新增 GET /api/hot?since=<rev>,回四十几字节。它只回「第几版」,不回「改了什么」:内容仍然只有 /api/mir 一处。之所以不做增量协议,是因为那会长出第二份真相,而两份真相漂移时没人知道哪份对;何况文档是 KB 级,拿到 changed 之后重取一次全文比维护一套 diff 协议便宜得多。 三个会静默失效的分支,各自有判据且都演练过会红:① 缺 since 时不写 changed(写个默认 true 会让每次首连白拉全文);② since > rev 必须说「变了」并带 rewound(服务重启后 rev 从 0 重来,回 false 的后果是消费者永远等一个不会到的号,症状是「热重载偶尔失灵」);③ 失败的编辑不动 revision(否则消费者会应用一条没生效的改动)。 演练顺带抓出一条因为错误的理由绿了的判据:③ 那条第一版没带 rev,于是在版本闸就被挡住,根本没走到编辑那一步 —— 它验的是闸。现在多一句断言排除这个解释。 今天仓库里还没有消费者(编辑器事件驱动、不轮询),第一个应该是 A2 的 S6-6 游戏侧。所以它的价值不在「有人在用」,在把「轮询整份文档」这个唯一选项换掉。

crates/me-studio/src/serve.rs · crates/me-studio/tests/hot.rs

视口整条链第一次算完:1080p ≈30 fps —— 浏览器那半比裸 socket 贵 2.4 倍

上一节留了一句「这还没算浏览器 putImageData 和页面轮询」。展开 958 字
上一节留了一句「这还没算浏览器 putImageData 和页面轮询」。现在算完了,落点是 verify-viewport.js 第 ⑬ 条(进 CI)。三段不重叠,可以相加: 1080p:put 10.3 + 浏览器取字节 21.8 + putImageData 1.6 = 33.7 ms ⇒ ~30 fps;540p:2.7 + 7.2 + 0.2 = 10.1 ms ⇒ ~99 fps。55fps 门槛 18.2 ms,1080p 差 1.9 倍,而且这还不含 A2 的 GPU→CPU 读回。上一节那个 44 fps 只算服务端与 socket,真实链再贵 50%。 订正我自己的算术:先前写的「22.9 + 21 + 1.5 ≈ 45 ms ⇒ 22 fps」是重复计 —— 22.9 里已经含一次 GET,浏览器那 21.8 就是同一次。方向没错,但一个多算一半的数会让人把「降一档分辨率」看成「降三档」,下一次就有人拿它砍掉本来够用的方案。 两件反直觉的事:① putImageData 一直被我当成要防的那头,实测 1.6 ms,比我们自己的 memcpy(1.36 ms)只贵一点,是整条链最便宜的一环;② 同一份字节,裸 socket 9.1 ms、页面里 21.8 ms(2.4 倍),多的 12.7 ms 在浏览器自己的栈里,不在网络也不在服务端。 对 A2 的结论:优化服务端白费(省 5 ms,浏览器一分不动);要降分辨率请降在源头(改 render target 尺寸),别让 Studio 在传输层缩 —— 传输层缩等于给一份马上要扔的 8.3 MB付 10.3 ms 全价,合计约 18.7 ms ⇒ 53 fps 还是不够,而源头就渲 540p 是 10.1 ms ⇒ 99 fps。同样是「半分辨率」,差一倍。 判据的力气:真的画满 20 帧 · paint < 8.0 ms · 半分辨率整段 < 60% · 样本非空;取最小不取中位数(连跑三次中位数 10.0 / 10.4 / 20.8,20.8 那次是 GC)。演练:插两趟逐字节加工 ⇒ 9.2 ms ⇒ 红;一趟 5.5 ms 演练不出红,所以阈值从 40 收到 8.0。

apps/studio/web/verify-viewport.js · apps/studio/web/viewport.js · CHANGELOG.md

视口的上游:GET /api/build.cooked —— 与 me build --emit-cooked 逐字节相同(ADR-0015 判据 2)

ADR-0015(今天 A1 裁决)把视口改成「cooked 字节 → 前端 wasm decode + render 到 canvas」,因为「共享纹理」真正的前置是先写一个 Metal 后…展开 1456 字
ADR-0015(今天 A1 裁决)把视口改成「cooked 字节 → 前端 wasm decode + render 到 canvas」,因为「共享纹理」真正的前置是先写一个 Metal 后端,而那不在 P0 里。决策 4 把吐字节这个端点划给 A3:要复用 /api/* 那一套同源校验与错误形状。判据 2 原文要求「同一份文档经 CLI 与经HTTP 端点取到的字节逐字节相同;写成端点通了不算」。 所以这件事分两半守:单元测试(me-studio/tests/build_cooked.rs,7 条)守「端点 == 同进程 to_cooked_bytes()」;shell 端到端(apps/studio/web/run-cooked.sh,进 CI)守「CLI == 端点」—— 真二进制、真 socket、最后一个 cmp。cargo test 里跑不了 CLI(me 是另一个包的 bin),而只有第二半能证明第一半不是自说自话。实测 sprite_scene.mir · 253 字节 · 两边 sha256 前 16 位都是 2e98ab7636f897a7。 三个刻意的选择,各有判据且都演练过会红:① profile 必填(缺了 400 并列出现成的 URL)—— 一条 URL 若随文档内容在档位间漂移就不可缓存不可重放,而猜错档位不会有任何东西报错;② 档位必须在这份文档里声明过,否则 409 —— 没声明 target 块时 legalize 跳过 caps 校验,CLI 照编并打 Warn(终端里有人读得到),而二进制正文里 Warn 没地方放,静默交出没有依据的产物正是这条链最容易造出的假绿灯;③ 一个字节都不加工 —— 判据 2 只有一种可靠实现:两边调同一个函数。 量出一件与设计假设相反的事:profile 不进入 cooked 字节。13 份 examples 逐个跑两档,全部逐字节相同 —— 档位影响的是 legalize 的 caps 与预算账本,不是产物。所以「参数有没有真的传下去」不能靠比字节证明,另写了一条用 Tier0 不保证的 compute 位当探针:?profile=wechat_android 必须带着 ME-LEGAL-002 红。这条若写成「两档应该不同」,会永远红,而红得毫无意义。 演练:字节 [0] ^= 1 ⇒ 单测红在「第 0 字节 0x4C ≠ 0x4D」、脚本红在 cmp 第 1 字节;还原 ⇒ 全绿。 顺带把三份脚本里重复的「挑端口 / 起服务 / 等就绪 / 收尾」抽成 apps/studio/web/serve-lib.sh:run-viewport.sh 那份收尾今天补了 taskkill,而 run-workbench.sh 那份没补 —— 漏掉的后果是残留进程占着 target/release/me-studio-serve.exe,下一次 cargo test 红在 os error 5,看起来像测试挂了。改造后两份重跑:视口 14/14 · 工作台 11/11。 留给 A1 的一件事(已提交议题):CLI 的 pick_target / undeclared_profile 这两条规则住在 me-cli,而 ADR-0015 让 Studio 也需要它;今天的选择是「端点更严」(不给没依据的字节),要不要把规则上移进 me-mir / me-compiler 请 A1 定。

crates/me-studio/src/serve.rs · crates/me-studio/src/api.rs · crates/me-studio/tests/build_cooked.rs · apps/studio/web/run-cooked.sh · apps/studio/web/serve-lib.sh · apps/studio/web/run-viewport.sh · apps/studio/web/run-workbench.sh · tools/ci/ci.sh · docs/adr/ADR-0015-studio-shell-and-viewport.md

A1 提的两件落点了:文档索引搬成数据(N-118);Studio 壳的「宿主那一半」+ 判据 1(N-117)

## ① DOCS 从 build_site.py 搬进 plan/doc-index.json(N-118 选方案 1) 加一篇文档要改那张表,而表在 build_site.py(A3 的扇…展开 1335 字
## ① DOCS 从 build_site.py 搬进 plan/doc-index.json(N-118 选方案 1) 加一篇文档要改那张表,而表在 build_site.py(A3 的扇区)⇒「写文档」这个纯 A1 的动作每次都要跨扇区代修 + 登记 + 到期日,同一机制被重复触发 8 次(其中一条代修自己写着「这个守卫已经拦下 4 次了」)。按 agents.json 的判据(同一路径因同一机制被跨扇区改 >=3 次 ⇒ 划分问题),这早就不是纪律问题。 现在构建脚本只剩 json.load + 一个循环。顺序有意义(决定侧栏顺序)所以是数组不是对象;对象在改字段时会被人手重排,而重排的后果是导航栏悄悄改版。搬完多了一个 check_index():重复 slug / 重复路径 / 空标题 / 空分组 / 空摘要 / 路径不在 docs、tools/adr 或根目录。路径规则取形状不取名(白名单每加一篇根目录文档就要改一次,改它的正是想加文档的人,同一个机制又回来了)。演练:塞重复 slug + 空摘要 ⇒ 红在 3 处;还原 ⇒ 绿。重建站点后 site/docs/index.html 逐字节没变(46 篇)。 ## ② apps/studio-shell/src-tauri:壳的宿主那一半(N-117 第 1 件) ADR-0015 决策 2 的落点。这一版没有窗口,做的是会被形状咬到的那部分:[workspace] 空表、放在 apps/ 而不是 crates/、同进程起 me-studio-serve(一个线程,不 sidecar —— sidecar 在 Windows 上父进程被杀时子进程常还活着,然后占着 exe 让下一次构建失败)。 没加 Tauri 依赖:加了就要有一条 CI 联网解析几百个 crate,而判据 1 一个字都没提窗口 —— 它要的是「从仓库根与从 apps/studio-shell/src-tauri 各跑一次 cargo metadata,两个都 exit 0」。CI 里两个目录都跑,理由是实测的:删掉 [workspace] 空表之后壳目录 exit 101(current package believes it's in a workspace when it's not),而仓库根照样 exit 0 —— 只验前者等于没验。这条演练做过。 真跑过一次:http://127.0.0.1:50216/ 起来,GET /api/build.cooked?profile=wechat_android 回 253 字节,sha256 前 16 位 2e98ab7636f897a7 —— 与 me build --emit-cooked 那份相同。端口传 0 让内核挑:写死时多开的第二个进程绑不上会退出,而页面连的是先来的那个,症状是「改了文档,另一个窗口在变」。 坑:echo "" | me-studio-shell 会立刻退出(它等的是「终端还开着」,管道一关就返回)——第一次冒烟撞上,现象是「服务起来了但 curl 连不上」。已写进 README。

build_site.py · plan/doc-index.json · apps/studio-shell/README.md · apps/studio-shell/probe/Cargo.toml · apps/studio-shell/probe/src/main.rs · tools/ci/ci.sh · Team/negotiation.md

手机那一侧有了:一句话 → 可重放的会话条目(ADR-0015 判据 3)

## 为什么不是加一个 Intent 类型 ADR-0015 §2.2 的结论是手机端不需要它 —— decompose 已经吃 &str,包一层只多一个说法。展开 1205 字
## 为什么不是加一个 Intent 类型 ADR-0015 §2.2 的结论是手机端不需要它 —— decompose 已经吃 &str,包一层只多一个说法。真正缺的是「一句话 → 一次可重放的会话条目」:S5-9 要求 --no-ai 重跑与原始产物逐字节一致,而原始产物的第一环就是人当时说的那句话。 ## 形状 remote.rs 里只有三样:一条记录 {seq,text,at}、一个日志(CAP=1024,满了丢最旧但把 dropped 数出来)、一个重放。/ws/remote 收一句话 → 先记 → 再分解 → 回一条回执;/api/remote 把记录重新算一遍交出来。判据 3 落在两者给的字节上:实时那条回执 == 重放那条,逐字节。 ## 三个刻意的选择 ① at 由调用方传,remote.rs 不读时钟:记录函数里读时钟的后果不是「多一个不确定源」,是判据写不出来(重放时的时间必然与录制时不同,只能靠人试)。 ② 先记后分解:分解失败也进日志 —— 失败是可复现的事件,不记它,「上次那句话它为什么做不到」永远查不出来,而症状是「偶尔不解」。 ③ 文本逐字节不改(不 trim):decompose 走 contains,空格不影响结论,所以 trim 看着毫无代价 —— 代价是重放出来的不再是原文。要 trim 是前端的事。 ## 上限 4 KB 而不是 1 MB 两份日志记账方式不同:trace 只留最后几十帧统计,这里按条数封顶 ⇒ 1024 × 1 MB = 1 GB,不设每句上限的话就是一个「上限存在但不起作用」的内存泄漏。超限关连接(1009)而不是截断记下来:截下来的那句不是人说的话,而重放会照着它算出一张图 —— 一份错的录像比没有录像更坏,因为它看起来是真的。 ## 判据 7 条,三条防「空转」 主判据把 4 句话(命中规则 / 带前后空格 / 空串 / 兜底)的回执与 replay 数组整段 ends_with 比;另有两行钉住内容(第一句必须真的排成 coin.spawn → pickup.rule → hud.counter),否则把 graph 整个删掉也能「两边相等」;还有一条守 replay() 无副作用(有的话日志会每拉一次快照长一节)。 演练过会红的三个改法:replay 另取一个 at / replay 用 text.trim() / to_json 不打 tasks —— 三条都实测跑过,红在预期的那一条。 坑:不能用 trace::read_frame 收服务端的帧(它按「客户端帧必须带掩码」校验,方向正好反着),测试里另写了 recv。

crates/me-studio/src/remote.rs · crates/me-studio/tests/remote.rs · crates/me-studio/src/serve.rs · crates/me-studio/src/api.rs · Team/negotiation.md

编号进了产物,名字也要出得去:`nodes` 有了两个出口(N-121)

## 什么缺了 cooked v2 之后产物里每条绘制带 node: u32,trace 能报「第 3 号花了几毫秒」,但 3 号是谁没有任何人知道 —— node_names 建好之后只命中…展开 1458 字
## 什么缺了 cooked v2 之后产物里每条绘制带 node: u32,trace 能报「第 3 号花了几毫秒」,但 3 号是谁没有任何人知道 —— node_names 建好之后只命中 lower.rs 与测试。S7-5 的归因因此只做了一半:算得出几毫秒,说不出谁。 ## 补了两个出口 me pack 的账本(content[].nodes)与 GET /api/build(紧跟 draws),形状都是裸数组、下标 i 的编号是 i + 1。不写 [{"id":1,"name":…}]:编号本来就是 1..=n 的连续整数(me-compiler 那条判据钉着),再写一遍 id 等于把同一个事实存两份,而两份里错一份时读的人不知道该信哪个。 ## 判据 3 处,各守一件事 build_nodes.rs(5 条,端点侧:顺序 / 与 cooked 字节交叉验证 / 两次相同 / 两档相同 / 空场景是 [] 不是缺字段);pack_roundtrip.rs(1 条,账本侧:与源文本里 sprite.draw 的声明顺序逐项相同);apps/studio/web/run-nodes.sh(进 CI,真 CLI + 真 socket,两个出口各自与第三方对账)。 最硬的是交叉验证:拿 /api/build.cooked 里每条绘制的 node 反查名字表,再加一条用 texture 下标独立确认「第 i 条绘制真的来自第 i 个节点」——少了后一条,前面那句在「名字表与 items 一起错位」时仍然绿。 ## 夹具必须自造 atlas_frame_scene.mir 的节点叫 n_f0..n_f3,声明顺序与字母序恰好相同 ⇒ 把账本改成 nodes.sort() 之后那条判据仍然绿(演练时撞出来的,不是推理)。自造夹具用 n_zeta / n_alpha / n_mid:声明序、字母序、资产表序三条线索两两不同。 ## 演练过会红四次 serve 侧 sort() ⇒ 第 1、2 条红;rotate_left(1) ⇒ 第 1、2 条红而第 3 条绿(它守稳定不守正确);空场景不写这个键 ⇒ 第 5 条红;pack 侧 sort() ⇒ pack_roundtrip.rs 红且只有自造那份红。 ## 脚本自己踩的两个假绿灯 + 一个 shell 坑 ① 账本里 { "path": 开头的行有两种(files[] / content[]),只有后者带 draws;② print 不算判据 —— python 只打印 BAD 没 sys.exit(1),外层 RC=$? 恒为 0,脚本在有 BAD 时报「都对上了 ✓」并 exit 0。判据的结论必须由退出码说出来。③ step "…" 标题里的反引号是命令替换:第一版标题真去执行了 nodes / me pack / /api/build 三条命令,日志里标题缺字 —— 不报红,只是没人看得出少了什么。 ## 顺手删掉一条死判据 脚本最后那段 diff(账本 == 端点)在两个出口各自等于 WANT 之后必然成立,永远不会红而报告上算一条判据。改成只与第三方对账。

crates/me-cli/src/pack.rs · crates/me-cli/tests/pack_roundtrip.rs · crates/me-studio/src/serve.rs · crates/me-studio/tests/build_nodes.rs · apps/studio/web/run-nodes.sh · tools/ci/ci.sh · Team/negotiation.md

视口缺的那条腿:一份 30 KB 的 editor-facing wasm(N-122)

## 什么缺了 ADR-0015 §2 第 3 条:「/api/build 吐 cooked 字节 → 前端 wasm decode + render 到 canvas」。展开 2034 字
## 什么缺了 ADR-0015 §2 第 3 条:「/api/build 吐 cooked 字节 → 前端 wasm decode + render 到 canvas」。前半句 2026-10-27 落地(判据 2 逐字节相同);后半句一直没有对应的产物。证据不是"找不到",是数出来的:MESC 在 apps/coin-run/wasm/me_runtime.wasm 里出现 0 次 —— me_cooked::MAGIC 是 const [u8; 4],只要 decode 可达就必然落在数据段。0 次的意思是那份 wasm 根本不认识 cooked。 ## 选了 §2.3 的 B 路 单独出一份 editor-facing wasm:crates/me-studio-wasm(L8,只依赖 me-cooked),12 个导出 + memory,零导入(前端不用写胶水)。体积 wasm-release 未优化 36,767 → wasm-opt -Oz 后 30,897 字节。 - A(给 coin-run 加导出):把只有编辑器用得到的解码器摊到玩家下载里,这个数直接加在 641,473 上; - C(服务端解码):前端不再跑真机那个解码器,判据 2 的「同机位 diff」要重写。 ## 这一层不渲染 渲染器在 me-pal 的 JS 侧(host-wx/render.js,5 段 GLSL 是 N-311 在盯的)。搬进来等于同一画面两套实现,分叉之后「看着不对」分不清是解码错还是画法错。这一层只回答「这份字节是真的」,加三样坐标:条目区在哪、资产名在哪、各有多少。 ## 零拷贝,不重新打包 条目定长 ITEM_BYTES、字段顺序就是 cooked.scene.md §5、decode 还逐字段验过。前端要的东西已经在输入缓冲区某个偏移上排好了。重新打包就是第二份条目布局,不一致时的症状是「某字段读成隔壁字段的值」—— 画面上是"精灵位置差了一点",没人会怀疑编解码。 ## 判据 13 条 tests/exports.rs 10 条(宿主侧:逐字节 == encode 的条目区 / 偏移 == HEADER_BYTES + Σ(2+len) / 资产名跳长度前缀 / 错误码分得开 / 失败清上一次 / 没打开过什么都不给 / alloc 能用且作废上一次);build.sh 的 V8 段 3 条(零导入 / 导出齐 / MESC 在数据段 / 体积 ≤ 48 KB);verify-node.js 一条链(真 V8 里 alloc → 写入 → open,条目区与文件尾部逐字节相同)。第 3 条是把当初那个观察反过来当门用 —— 它的失败没有别的症状:导出齐、能实例化、open 老实返回 ERR_BAD_MAGIC,看起来像"内容坏了"。 ## 12 次演练 items_at 忽略资产表长度 / 名字不跳前缀 / 两个错误码互换 / 不清上一次的成功 / 没打开过给 7 / 空长度当内容坏 / item_bytes 写死 52 / at 多算 1(自检开火返回 10)/ alloc 不作废 / alloc(0) 给地址 / 初始码写 OK —— 逐个红在对应那条上。 ## 三个坑 ① v.resize(len, 0) 那个位置没有判据能抓:改成 reserve 后 10 条全绿 —— 判据总是写满 len,漏写只在浏览器里发生。注释里写明了,不留假装在守它的判据。 ② alloc 这个缺口是写文档时发现的:原 JS 示例写 const ptr = alloc(...) 加一句「调用方自己的分配器」,而调用方是 JS,线性内存只有 wasm 自己能分配。补了 me_studio_alloc 并让它顺便作废上一次的打开(Loaded 存的是地址,alloc 会复用/搬动那块内存)。 ③ verify-node.js 第一次跑就红,红在它自己身上:拿文件内偏移索引线性内存(少加 ptr)。wasm 侧是对的 —— 这类红必须先想清楚是谁错,否则最容易做的是去改被验的东西。 ## 产物不落盘 玩家包落盘是因为两个消费方要文件(微信开发者工具、check_play_sync 拿线上副本比字节)。这份今天没有消费方:前端还在用 /api/build 直接取字节。没人加载的 .wasm 进仓库只会变成"陈旧但没人发现",而它和陈旧之间连一道门都没有。产物留 target/studio-wasm/,判据每轮 CI 重编;等前端接上再加落盘 + 逐字节比对。

crates/me-studio-wasm/src/lib.rs · crates/me-studio-wasm/tests/exports.rs · apps/studio/wasm/build.sh · apps/studio/wasm/verify-node.js · tools/ci/ci.sh · plan/agents.json

代修登记过期不再判红:374 条不会在 11-01 一起变红,但也不许静默(N-124)

## 什么缺了 check_ownership.py registry 里 until < today 和「扇区列写错」「复核人空着」并列进 problems。展开 803 字
## 什么缺了 check_ownership.py registry 里 until < today 和「扇区列写错」「复核人空着」并列进 problems。cross-sector.txt 里有 374 条的到期日是 2026-11-01 —— 那天它们会一起变红,registry exit 1,CI 跟着红,与谁改了什么无关。 ## 为什么归错类了 后两者是静态数据写错了,逐条改得对;过期是日历翻页。一条会在某一天无条件变红的判据,最后一定被人用「那天先别管它」对付过去 —— 从那一刻起这道门就没人看了。 ## 加了一条「A1 没提的」 XSECTOR-EXPIRED 降级行。不加的话 374 条会从「天天红」变成「彻底不提」,而后者才是这次改动真正的风险。降级清单里多一个稳定标签,数继续被人看见,只是不拦构建。 ## 边界:files 那条没动 有人真去改那个路径时,过期仍按越界处理(cross_sector_hit 原样)—— 只放开全局体检。不然「豁免有期限才会被消化掉」这条语义就真没了。所以「过期」= 不再有人替你数,不是可以随便改。 ## 表头也得跟着改 cross-sector.txt 原来写「到期后这一行自动按越界处理,不会静默放行」—— 改完之后这句半对,而半对的规则比没有更坏(下一个人会照它做判断)。已改成两条路分工。 ## 四面演练 扇区列 A2→A3 红 / 复核人留空红 / 到期日改到昨天不红且打出「已过期 1 条」/ 2026-13-01 红。 ## 一个实现坑 已过期 N 条 这一行无论 0 条都要打:ci.sh 用 grep -o 取数,读不到就是红(报「报文格式变了」)。因为「没打这一行」与「0 条」在日志里一模一样,而前者意味着过期永远失声。

tools/ci/check_ownership.py · tools/ci/ci.sh · tools/ci/cross-sector.txt · Team/negotiation.md

只有测试看得见的产物不算落地:30 KB 那份 wasm 落盘、发到 /me_studio.wasm,再当第三方读者去核报告

## 缺的不是判据,是地址 N-122 建完 crates/me-studio-wasm、13 条判据全绿 —— 而产物只在 target/ 里,产品里没人取得到它。展开 1343 字
## 缺的不是判据,是地址 N-122 建完 crates/me-studio-wasm、13 条判据全绿 —— 而产物只在 target/ 里,产品里没人取得到它。判据绿了却没人用,等于只证明了一件没人问的事。 ## 三件落点 1. 落盘 apps/studio/web/me_studio.wasm(30,897 字节),build.sh 用 cmp 守陈旧,更新走 ME_UPDATE_WASM=1。改了先前「不落盘」的主张:那时没有消费方;现在 serve.rs 要 include_bytes! 它 —— 条件变了,结论跟着变。 2. 服务端发 GET /me_studio.wasm,application/wasm,不查 token / Origin —— 它不是数据,是怎么做解码,与 /app.js、/style.css 同类。 3. 第三层判据:报告的 draw / textures / nodes vs 独立读者从字节里数出来的。前两层各差一口气 —— build_cooked.rs 是同一个函数调两遍(缺陷被忠实重复然后判相等),run-cooked.sh 是两个同源入口(读的都是内存里的 LoweredScene)。没有这一层,「to_cooked_bytes 少写一条」的症状是画面上少一个精灵,而报告、账本、端点全绿。 ## 一条新缝,四面演练 「磁盘换了、me-studio 没重编 ⇒ 发的是上一版解码器」——症状与一切正常完全同形。判据运行时读磁盘与编译期常量比(不能用 include_bytes!,那是同一次展开的两个常量自比)。演练 D1 长度(得直接跑已编好的测试二进制,走 cargo test 会重编、缝自愈、演不出东西)/ D2 同长度翻一字节(证明逐字节那条不是死代码)/ D3 Content-Type 写错 / D4 把 README.md 摆成那份 wasm(走通到魔数那条)。四条全红在对应那条上。 ## 被判据反咬一口 「未归因 0 条」撞上 ok() 的「0 + 量词一律判红」。守卫是对的,行是错的:一行里混了计数(条目 / 资产 / 节点表)与结论(残差为 0 正是想要的)。修法不是给整行传 --zero-ok(那会顺手放走「条目 0 条」),而是拆两行,残差那条不画勾——它是事实陈述,不是判据。 ## 边界 前端还没 fetch 它(viewport.js / app.js 里至今没有 cooked 字样)。画到 canvas 是下一步,那一步的判据得是「同机位 diff」,不是「字节解开了」。 ## 顺带 check_bash.py 抓到真 bug:echo "… $SHIPPED(记得提交)" —— macOS 的 bash 3.2 把「(」首字节当变量名的一部分,Windows 的 bash 4.x 一路绿。在 Windows 上绿过的 shell 不等于在 Mac 上绿过。

apps/studio/wasm/build.sh · apps/studio/web/me_studio.wasm · apps/studio/web/verify-cooked-wasm.js · apps/studio/web/run-cooked-wasm.sh · crates/me-studio/src/serve.rs · crates/me-studio/tests/serve.rs · tools/ci/ci.sh

Studio 的窗口:266 个 crate 换一个能看见编辑器的窗口,顺手把「壳不许有渲染逻辑」从注释变成门

## 缺的是窗口,不是壳 apps/studio-shell/ 里「宿主那一半」早就落地了(同进程起 me-studio-serve),缺的只是窗口。展开 2086 字
## 缺的是窗口,不是壳 apps/studio-shell/ 里「宿主那一半」早就落地了(同进程起 me-studio-serve),缺的只是窗口。 2026-10-27 套上 Tauri 2.12.5:WebviewUrl::External 指向 http://127.0.0.1:<内核挑的端口>/, 页面由同进程的服务提供,token 也在那里注入 —— 所以不打包前端,安装包里没有第二份会过期的副本。 实测把窗口开起来截了一张:场景树(n_world / n_ground_tile / n_coin_1…)、MIR 源码编辑器 (target wechat_android / budget)、右侧属性面板、底部状态栏。是真页面,不是占位页 —— 「窗口开了」与「页面加载对了」是两件事,这一条得看见才算。 三个数(实测):依赖图 266 个 crate / 首次 debug 构建 1 分 56 秒 / debug 产物 15.4 MB(原 2.8 MB)。 ## --headless 不是后门,是劈开问题的那把刀 窗口打不开时,是窗口的问题还是服务的问题?这两件事一半以上的症状长得一样(黑屏 / 白屏 / 一直是占位页)。--headless + verify-headless.py 验到的是:端口真在听、/api/build 回的是 这份文档、/api/build.cooked 与 me build --emit-cooked 逐字节相同。 ## 一条契约从「只有字」变成「有门」 ADR-0015 §3 第 1 条写着「壳不许有任何渲染逻辑」,在那天之前没有任何机器在看。它的失效方式 极安静:壳里为了「让视口先显示出来」加一段 OffscreenTarget::new(...),编译过、窗口开、画面动 —— 然后换视口形态时才发现要重写宿主。check_shell_purity.py 判的是能力不是行为: 依赖表里出现渲染 crate 就红、me-studio 的依赖表出现也红(壳唯一的入口)、源码去注释后出现 渲染符号也红。去注释是必须的 —— main.rs 的模块文档正写着「这三样留在 me-runtime 里」。 ## 三个坑 ① verify-headless.py 第一版给子进程 stdin=DEVNULL,而 --headless 用 read_line 等退出信号 —— EOF 一到进程就退了,症状是 WinError 10061 目标计算机积极拒绝(像"服务起不来",其实"起完就走了"); ② Windows 上 tauri-build 硬性要求 icons/icon.ico,缺了在 build script 阶段挂、报错像依赖问题; ③ 原生 python 里 /tmp/... 是当前盘根(D: mp),不是 Git Bash 那个 /tmp。 ## 边界 CI 不编壳(ME_BUILD_SHELL=1 才跑,因为要网络 + 两分钟);**窗口能不能开在没有显示器的机器上 没有判据(--headless 只验服务那一半);§3 第 3 条(后处理不许挂在上屏那一趟)仍然没有门**。 ## 2026-10-27 后记:这一版的 Tauri 宿主整体删除了,ev 因此改指现在的壳 同一天 ADR-0015 裁决放弃 WebView 路线,改全部自绘(me-swrast 出像素 + Win32 出窗), apps/studio-shell/src-tauri/ 整个目录被删。于是这个条目原来那 6 条 ev(main.rs / tauri.conf.json / build.rs / icon.ico / make-icons.py / verify-headless.py)**指向了 不存在的文件**,plan/board.json 的自洽检查因此一直红 —— 而它红了很久没人管,因为那条红 读起来像「历史条目过期」,像一件不急的事。 现在的证据换成自绘那一套:probe/Cargo.toml(壳的宿主)、probe/src/main.rs、 probe/src/live.rs(真窗口:滚轮/按键/关窗)、me-swrast/src/lib.rs(像素从哪来), 判据仍是 check_shell_purity.py(「壳不许有渲染逻辑」那四条)。 教训:把「一次交付的证据」写成具体文件路径,等于给这条记录装了一个会过期的指针; 删掉那些文件时,没有任何东西提醒你来改这里。ev 该优先指向长期存在的容器 (目录、工具、README),少指向会被重构掉的实现文件。

apps/studio-shell/README.md · apps/studio-shell/probe/Cargo.toml · apps/studio-shell/probe/src/main.rs · apps/studio-shell/probe/src/live.rs · crates/me-swrast/src/lib.rs · tools/ci/check_shell_purity.py · tools/ci/ci.sh

2D 物理三件套:刚体 / 软体 / 粒子流体,三个 crate 而不是一个

## 需求从哪来 飞哥问三件事:规划里有没有磁铁(互相吸引/排斥)、2D 能不能做布料(旗帜/头发/果冻)、 「小鳄鱼洗澡」那种水是不是流体力学。展开 1431 字
## 需求从哪来 飞哥问三件事:规划里有没有磁铁(互相吸引/排斥)、2D 能不能做布料(旗帜/头发/果冻)、 「小鳄鱼洗澡」那种水是不是流体力学。答案分别是:没有(05-roadmap.md 的 P0 砍掉清单 原文写着「物理(2D 用简单 AABB)」)、能、不是——行业里同类效果用粒子近似或格子 流体,没有人解 Navier-Stokes,要的是「看起来像水」而不是「算对连续方程」。 ## 为什么是三个 crate 而不是一个加开关 分界线不是新旧,是守什么不变量:刚体守动量与角动量(顺序冲量,速度层累积); 软体守边长与形状(Verlet,位置约束的迭代放松,速度藏在 pos − prev 里); 流体守不可压(密度是邻域的和,不是一对一的约束)。主状态不同的东西塞进一个 crate,那个 if kind 会长在所有东西上,而每种优化的前提对另外两种不成立。 ## 四个量出来的结论(都不是设计时想到的) - 磁铁的力必须随距离线性衰减 + 中心留 0.12 × radius 死区。用 1/r² 且不留死区, 球被吸到中心会以天文数字的加速度来回振荡——画面上是一团抖动的残影,而日志里全是合法数字。 - 果冻必须用「少约束」的 block 而不是 grid。带对角约束的网格近乎刚性,开不开形状 匹配残余偏差都是 0.0 像素;果冻的软来自约束解不唯一,只有横竖边时剪切是自由自由度。 - 形状匹配每步只能跑一次,不能放进迭代里。8 轮 × 0.1 刚度 = 每步拉回 57%,果冻被戳只动 0.0 像素。 - apply_force 不唤醒睡着的体。睡着的不积分,力白给;所以 World::add_field 必须 wake_all(), 否则现象是「磁铁开了球不动」,而所有数字都对。 ## 数学统一(同一天推翻了原来的设计) 原设计是「物理侧一个第三方超越函数都不调,自己写 sqrt / det_sin_cos,两份实现互校」。 2026-10-28 推翻:me-math 本身就是那个不调 libm 的 crate,它守得更硬。依赖它不等于引入 libm, 等于把纪律只守一遍。互校能发现「算错了」,发现不了「两边差着用」——两份精度不同的 sin 存在同一个引擎里,就是等着某天有人查一整天「为什么回放对不上」。 代价写清楚了:det_sin_cos 不再逐位相同,物理轨迹会变最小位(36 条场景判据全绿, 它们的容差按「看得见的差别」定,不按位定)。tests/cross_math.rs 随之删除。 ## 现状(2026-10-28,诚实版) - me-rigid2d:36 条场景判据 + 单元全绿;公开面 193 项 / 109 函数,109/109 在演示里被真调过 (构建时校验,改函数忘了更新演示就红);新增层掩码、射线、区域查询、持续力与扭矩、力场。 - me-soft2d:6 条判据全绿(链不拉长 / 迭代越多越硬 / 旗边不动 / 果冻记得形状 / 不穿地 / 挤出转过的盒子);函数清单已生成(27 项 / 24 函数)。 - me-fluid2d:刚落地,能编过,参数标定与判据都还没做,演示场景也还没加。这条不算完成。

crates/me-rigid2d · crates/me-soft2d · crates/me-fluid2d · crates/me-rigid2d/FUNCTIONS.ai.md · crates/me-soft2d/FUNCTIONS.ai.md · tools/gen-physics-functions.py · crates/me-rigid2d/src/field.rs · crates/me-rigid2d/src/ray.rs

特效系统(粒子 + 时间轴)落地,并做出物理粒子:弹射与溅射

## 需求与一个必须先说的事实 飞哥说「把任务看板里的粒子系统和特效时间轴统一都给 A3 来实现」。展开 2194 字
## 需求与一个必须先说的事实 飞哥说「把任务看板里的粒子系统和特效时间轴统一都给 A3 来实现」。先核了一遍: 看板里没有这两条——62 条 S 编号任务逐条过,跟粒子有关的只有 05-roadmap.md M6 那条「Tier1 路径跑通,能跑 GPU 粒子」,那是渲染线的一个里程碑,不是 2D 粒子系统; 特效时间轴则一处都没有。所以这次做的是「新建 + 登记所有权」,不是「改一条已有任务的 owner」。 写在这里,是因为"看板里有、只是我没找到"和"看板里没有、现在补上"是两件不同的事。 ## 为什么是 me-fx2d,而且为什么它在 L5 它不守任何守恒律:刚体守动量、软体守边长、流体守不可压,而"这团火星对不对"没有方程, 只有"像不像"。硬塞进 L4,物理层那条"只放守守恒律的东西"会先变成假话。 它是 L5:消费 me-math(数学唯一来源)与 me-rigid2d(穿透深度、法线、接触点速度), 被游戏层消费。 不放进 me-render 有两个理由:渲染不该拥有"什么时候爆炸"这种玩法级的时间; 而且 me-render 的 owner 不是 A3(plan/agents.json 的 never 列表),这道边界是登记过的。 ## 粒子系统与时间轴是两块,缺一块都做不出特效 - 粒子回答「长什么样」:池子(AoS + 容量上限)、发射器(速率累积器、卡顿保护、 出生形状、初速/寿命/自转的随机)、曲线(尺寸与透明度随归一化寿命变化)。 - 时间轴回答「什么时候」:cue + 游标,一帧把经过的 cue 全放完。 时间轴单独存在的理由很具体:真实特效的复杂度几乎全在"什么时候放什么"上。 只有粒子,写出来是一团永远在喷的火;只有时间轴,是一串没有内容的时间点。 ## 物理粒子:弹射与溅射(这是"能不能做"的回答) 能。两条反应都实现了,而且都是量出来验过的: - 弹射:粒子相对表面的速度按法向反射、切向乘摩擦。有两个必须一起做的细节: ① 先按穿透深度把粒子推出去再改速度——只反射不改位置,粒子留在体内,下一步再撞一次, 现象是"在箱子里面抖";② 用相对速度(含刚体角速度贡献 ω × r,直接调 Body::velocity_at),否则一块横扫过来的挡板只会把它自己的速度还给粒子。 - 溅射:法向速度超过门槛时,在接触点沿法线喷一簇,数量随撞速增加,方向由法线决定。 截图里最容易出的两个毛病都被判据钉住了:接触点算错(往中心走一个半径而不是走到表面)、 一帧几百颗粒子同时落地把池子抽干(splash_budget)。 ## 四个量出来的结论(都不是设计时想到的) - next_f32 的取值范围只有 [0, 0.5)。next_u32 取乘积高 31 位再 >> 8 就少一位, 上界只有 0.4999。而原来那条判据 0 ≤ v < 1 全绿——抓到它的是"圆盘取点是否面积均匀" (一半的点落在半径一半以内,实测 509/1000)。 - 曲线在"同一时刻有两个关键帧"时取了前一个:at(0.5) 给 2.0 而应该是 3.0。 - 时间轴"一帧只放一个 cue"的变异演练不红:外层 while remain > 0 会把下一发补上。 真正决定"一帧能追几个"的是"到达 cue 之后还剩多少余量",变异点得放在 remain -= to_next。 - 「落地不再溅」这条判据一开始是假绿:池子小了会被溅射粒子填满,splashes 因为 "发不出来"而停止增长——行为已经坏了,判据照样通过。修法是把池子给到 8000 并断言 dropped == 0。 ## 验证 - me-fx2d:12 条场景判据 + 25 条单元 + 2 条 doc test;公开面 186 项 / 102 函数, 102/102 在演示工程里被真调过一次(构建时校验,改函数忘更新演示就红)。 - tools/ci/drill-fx.py:7 条变异演练,全部按预期变红、报的是预期那句,还原后全绿。 - CI 补了两条:me-fx2d 的依赖面只许 me-math + me-rigid2d(第三方 RNG 会让 "同种子两次一样"照绿,只有依赖面能守住跨目标逐位相同);清单检查从 1 个 crate 扩到 3 个(原来 me-soft2d / me-fx2d 的清单可以是旧的而 CI 全绿)。 - 顺带补了 me-soft2d 的演示覆盖(24/24,导览里量点/边/三角形/总长/拉伸/质心/挤出距离)。 ## 还没做(不拿半成品充数) - me-fluid2d 仍是"能编过、参数没标定、判据没写"的状态。 - 演示工程还没有可视的粒子关:场景数仍是 12,粒子与溅射目前只在 --api-tour 里 以读数的形式出现。要做可视关,得让 Spec 带上粒子流、让查看器与关键帧光栅都会画粒子, 同时改 CI 里"场景数 = 12"那条判据——那是下一格的事。

crates/me-fx2d · crates/me-fx2d/tests/fx.rs · crates/me-fx2d/FUNCTIONS.ai.md · tools/ci/drill-fx.py · apps/physics-lab/src/tour.rs · docs/01-architecture.md