开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 20 条记录。
2026-11-10
包体归因:先把「字节属于谁」这张表修成真的,再接进 CI
- 余量只剩 4.9 KB(795.1 / 800 KB),而
wasm_budget从 10 月写好起从没被跑过 —— CI 里没它的位置。 - 先查工具自己:它把产物报成「中文 11.4 KB / ASCII 0.2 KB」,严格 UTF-8 实测是 6.4 / 12.5 —— 几乎对调。两道判据几乎恒真(
0x80..=0xFF一律算文本;0xE4..=0xE9占 1‰ 算中文)。 - 改成按文本游程切(严格 UTF-8、≥8 字节才算),CJK 按码点比例;
--self-test喂 6 个已知答案样本 + 混合段 + 逐字节守恒。反向实验两轮都红。 - CI 新增一步(只增不改):先自检再出表;归因表凑不齐或段级重复 >1 KB 也红(后者以前只印不判)。
- 结论:文本只有 18.9 KB,不是大头;五张图集全是
zlib(9)且解压逐字节等于.rgba⇒ 没有安全字节可砍。800 KB 是 S0 手写圆整数,真约束是.70冷启动,要真机实测重定。 code522.2 KB(65.7%)还没归因:要留name段重编 + 按函数切。
- 余量只剩 4.9 KB(795.1 / 800 KB),而
2026-10-31
第三条腿飘过一次 —— 抓不到结论就重抓,别指望「预算给足」
git push卡在「WebGL2 对账第三条腿」:```
✗ WebGL2 对账未通过(第三条腿)
✗ 标题里读不出 n/m(实际:GL COMPARE 运行中)
```
同一台机器、同一份代码,紧接着跑的 ANGLE 那一路 21/21 全过 —— 所以那不是判据红,是这一条判据当时飘了。根因在
apps/gpu-gl/run.sh:--dump-dom在页面加载完成时就把 DOM 抓走,而判据是 wasm 里算完才写进<title>的;--virtual-time-budget=120000是预算,不是「等到做完」——页面在 wasm 里做长段同步计算时预算可能已经走完,DOM 里还停在静态 HTML 的初始标题上。改成看着结果决定要不要再抓:标题仍是「运行中」/ 读不到就重抓,上限
GL_WAIT_SECS(默认 180s);热路径上永远第一次就出结论、一次都不多花。超时与判据红的分开写——「抓了 N 次、等了 Ns 仍是运行中 —— 这是没跑完,不是判据红」,退出码 1(跑不完不能算通过)。CI 层另加一个run_page_script兜底:只认日志里「没跑完」这一句才重跑,判据红一律立刻回去报红 —— 「失败就重试」是把红变成「有时红」的另一种写法。演练过(把
caps.html那行document.title用if (0)短路、GL_WAIT_SECS=3):重抓 1 次后打出上面那句、退出码 1;还原后三页全绿,attempt全是 1。一句话:飘的 CI 比红的 CI 贵 —— 红只让你多看一眼,而「有时红」会训练人重跑一次了事,从那一刻起这个门口就没人看结论了。
2026-10-28
SPRITE 演示页:清屏修掉 + 四张 AI 素材换掉色块
用户报:「切场景没清屏,越叠越乱」+「只有色块,观赏性太差」。
- 清屏根因:
frame()直接画默认帧缓冲、全程没begin_render_pass;而begin_frame一个字节都不清(清屏挂在 begin pass 的clear_color上)。抄LdrBlit时省掉的是填充 + 它顺带的清屏两件事。 - 12 项判据全绿:它们数的是「这一帧画了什么」,不是「屏上剩什么」。新判据钉
clear_color == Some(BG);?warm=24是唯一能拍下它的开关。 - 四张 AI 素材(genImage/混元):panel 512² · atlas 512×128 · tiles 256² · chest 256²。图标不抠图 —— 清屏色与页面底色统一成纯黑,近黑底直接融进背景。
- 平铺换过一次题:格子图不是周期结构(间距 30~69 浮动)、四重镜像又在中线出双线 ⇒ 改成「一格 = 一块带凹槽边框的板」,不用镜像。
chest的「主体占中间 50%」是case_trim的 uv 契约,不是审美。 - 连带:
TEXTURES与兜底像素尺寸必须同步(不做长度校验 ⇒ 不同步是越界读);T_CHECK采样器Nearest→Linear;修掉自己刚造的「等图再画 ⇒ 截图空画布」。 - 判据:268 测试全绿 · clippy 0 warning · 无头与
.6真机都 12/12、读数逐字未变 · wasm +735 B、无新 import、三份 md5 一致 · 素材脚本已入库可复现。
- 清屏根因:
2026-10-27
第十二轮:地面按震地什么也没发生,第三处「算出标志又丢掉」上了锁
- 审完
fixed_step与late_update两块:Hero::Brute站在地上按技能那条分支被let _ = shock;吃掉 —— 冷却照扣 150 步、音效照响、屏幕什么也没有。修法照抄同函数的slammed(块内算、出块兑现) - 冲击波那道环每帧写的是屏幕居中的算式(从选关页格子排版抄来的),相机贴世界边界时人在 x=31 震、环出现在 x=240。改成绕自身中心长,并修掉
spawn_effect「按左上角落位却按中心扩散」的半格偏移 - 第三次同款(
flash_due/shock/multi)⇒ 新增守卫tests/source_shape.rs:src/coin_run/*.rs禁止let _ = <裸标识符>;(那句正是让unused_assignments闭嘴的钥匙),守卫自带一条「匹配器不许空转」 Sim.unlocked的注释写着「Game::step每帧同步一次」——是假的,step 里没有这一处;把真实约定(改存档那步后面必须跟restart())写进注释,并把「两份镜像一致」推广成判据:unlocked/last_level/hero/save.hero/touch_ui五对数 × 四条入口- S6-3 第 ③ 段落地:
FrameRenderer::collect_cooked+Viewport::frame_cooked(产物字节 → 绘制列表 → 离屏 → 上屏,四步次序与 ECS 那条逐行相同),判据 4 条、两条变异各红。第 ④ 段(→ canvas)卡在 A3 一句答复:LoadedScene借用字节,wasm 里要自有版本还是Box::leak - 目录清理按档 1 执行:14G → 7.6G(incremental 4.0G / aarch64-apple-darwin 1.3G / macos-demo target 965M / Chrome 配置 350M / examples 226M / doc 90M),删前后
git ls-files都是 960 - 数字:
cargo test -p me-runtime36 target / 738 通过;game_slice117 通过;clippy --workspace --all-targets -D warnings干净;CI 3m01s 0 条 ✗(2 项已知降级);wasm 652.4 KB / 92 导出 - 三笔已推
agent/A2:2315a80震地与环 ·63d1985视口 cooked ·ef1c9c6死局部守卫 ·813511ewasm 快照 + §36
- 审完
压力关五个字一直是豆腐块 —— 守卫链在最后一环短路了
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
力 / 测 / 试 / 机 / 批五个字从来没进点阵表,屏幕上一直是豆腐块。而所有门都是绿的。 - 四层根因,每层单独看都合理:①
requirements.txt里从来没有 pillow,而install_hooks.sh只装它 ⇒ 托管的.venv一定跑不动gen_hanzi.py(SystemExit(2));②cjk.rs::the_generated_table_is_current按「第一个存在的解释器」选,取到.venv就只跑它;③ 退出码 2 走「跳过」分支,报 ok;④ CI 里那条cargo test也绿 —— 「跳过」和「通过」在输出里长得一样。而同一台机器的python3装了 Pillow,--check跑得动,并且会当场红。 - 修法:判据改成按结果退到下一个解释器(每个候选都试,全不行才跳过,并打印试过谁、各自怎么不行)、报错里带「用哪个解释器判的」;
STRESS_SAMPLE从stress.rs挪进copy.rs(上屏中文只有一个烘点阵的入口),stress.rs进NOT_ON_SCREEN并写明理由;重烘点阵。 - 验到底,不只看判据绿:无头 Chrome 跑压力页四档,批次
401 / 2 / 7 / 1全部等于期望、missing=0、白块0;再停到有标签那档截图放大逐字对过。图集占用率 51.6%(606 字),离装不下还很远(BakeError::AtlasFull会直接expect炸,不会静默画白块)。 - 顺手两处 review:①
copy.rs注释说「测试盯着名字分家」,实际只验数量与非空 —— 把两关中文名对调,四条判据全绿。改成LEVELS: [(&str,&str); 12](一行一关的中英名),逐关比.lvl的title;三个变异各自红(整行对调 / 只改英文 / 只改.lvl重打包)。②game.rs的let _ = (title, par, facing)吞掉三个死局部,含每帧一次String克隆与一个全仓没人读的Sim::par;sim.levels.clone()每帧一次 Vec 分配改成栈上定长数组。wasm 668,420 → 668,330 B。 - 两条口径:「跳过」与「通过」在输出里必须长得不一样 —— 判据越重要,越不能有「静默可行」的分支;「路径存在」≠「东西能用」,凡按存在选完就不再换的,都会在「存在但坏掉」的机器上退化成空转。
- 账面:CI 297s 全绿(0 ✗,2 项已知降级);
cargo test --workspace(debug)2275 通过 / 0 失败 / 3 忽略,5 分 33 秒 —— 在这之前-p me-runtime在 debug 下一直是红的。提交db670f9/66aa728/a61e0af/c6d278f/df8bcb0。 - 报给 A3:
requirements.txt缺pillow>=10(他的文件,一行闭合根因)、ci.sh第 742 行的包体余量数字过期(写 57.7 KB,实测 147 KB)。
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
第八轮 review:三个真 bug + 一次越界红灯(音频分块 / 音景锚点 / 渲染守卫)
- dsp:
TvBiquad::process的时间用本次调用的下标 ⇒ 分块喂时扫频每次调用从头开始,0.5s 扫频变 2.7ms。修成cursor + i(cursor原来只写不读)。判据三层:症状(尾段保留 84.65% 该砍光)+ 逐样本相等(128/100 两个块长)+ 空折线也算时间;5 个变异全红。 - 音景:首发点缀锚在 0 秒 ⇒ 宿主时钟不从 0 起时全层同时叫。改成锚到第一次
tick,随机流消耗次数不变所以撒点序列不变;3 个变异全红。 - 九宫格:判“最外沿”用列/行序号 ⇒ 没切的那一边永远拿不到内缩,
NineEdges::default()下默认Inset完全不起作用(只在贴一张图时最该起作用)。判据 + 真 GPU 跑 P4 自检 PASS。 - 裁剪:NaN 守卫只查尺寸,位置 NaN 同样能把 uv 算成 NaN(注释描述的灾难没变,只换入口);顺手给“尺寸那一半”补上从来没了的判据。
- 越界:
crates/me-atlas/**属 A3,我连着改了两笔 ⇒ CI 唯一红灯。不回退,按规矩登记cross-sector.txt代修(复核 A3 / 到期 2026-11-10),并把 20 处协商共享路径一次报备完。 - 推翻两条旧信念:①“me-audio 的改动都进 wasm”不成立(只有导出入口可达的才进);②判据绿 ≠ 那条路对(只有一种调用方式时)。
- CI 全绿:第八轮跑了四次 314/176/386/429s,差异全来自机器负载,不是优化。61 笔领先
origin/main。
- dsp:
2026-10-26
定位音效的时长在混音器里被写死成 0 —— 每发都永久占着槽位
- 症状:玩一会儿之后定位音效全没了,日志里一个错都没有。
- 根因:
Mixer::play_spatial的签名里没有时长,函数体填duration_ms: 0;而0在这层的语义是「永不过期」(循环语音的语义)。实测(容量 2)播两发、tick(600_000)之后active()仍是 2,十分钟一条没释放;槽位满后新语音被PoolFull静默拒绝。 - 为什么要记:同一个坑在包装层
AudioSystem::play_at已经踩过并修过,机制层没跟着修 —— 两层各写一遍同样的逻辑,于是可以各错一次。 - 改法:
play_spatial收整条PlayRequest(而不是补第八个参数)。pan被覆盖(方位只有一套)、gain被乘上衰减(「半音量的远处声音」)。play_at退化成装请求 + 转发,spatialize全工程只剩一处调用。 - 判据(都反向验过):容量 2 播两发 100ms →
tick(1000)后active()==0,再播两发仍成功且rejected()==0(后半段抓「标成结束但没把槽位放回空闲链」);贴耳处(left,right)==(500‰,500‰)且请求里的Pan::RIGHT被位置覆盖,左侧 300px 处left>right且left<500‰。改回写死 0 ⇒ 红left: 2;不覆盖 pan ⇒ 红(0,500‰);把 gain 覆盖成衰减 ⇒ 红(1000‰,1000‰)。 - 一处 rustdoc 断链:
mixer.rs引用crate::AudioSystem::play_at,而me-audio里没有AudioSystem(在me-runtime,方向相反不能互依),-D warnings下会把 CI 文档检查打红 ⇒ 改成普通行内代码。 - 验收:wasm 732.2 KB(余量 67.8 KB),三份副本 md5 一致;工作区 1712 passed(+2);CI 通过 208s · 2 项降级。提交
cc0fa05,只在agent/A2。
汉字点阵的「扫哪些文件」自己也会过期 —— 新加模块就静默漏扫
- 症状:在
coin_run/下新加一个模块、里面写一句上屏中文 ⇒ 那几个字不进点阵(屏幕上豆腐块),而--check照样绿:它比的是「生成物 vs 那三次固定扫描的结果」,两边都不知道新文件的存在。 - 改法:扫范围从「三份写死的文件」改成「一个目录」:
SCOPE_GLOB = crates/me-runtime/src/coin_run/*.rs,目录里每个文件必须在SCAN(上屏)或NOT_ON_SCREEN(不上屏,必须写一句理由)之一,否则生成器直接失败。另一条报错管「名单里的文件已不存在」——否则--check会对着一个幽灵文件永久绿着。 - 为什么不全扫:量过,
crates/*/src/里含中文的字符串字面量横跨 100 个**文件(me-cli/me-mir/me-studio/me-rhi的报错与panic!全在里面),四千字上下。全扫会让点阵从 569 字涨到四千多,wasm 多背约 120 KB,而那些字一个都不会上屏。 - 反向验过两条:造一个
hud.rs⇒ 点名它、exit 1;把copy.rs改名 ⇒ 点名「已不存在」。 - 提交
b9ee5c8。
- 症状:在
金币声整关只有头 600 像素能听见 —— 听者从没被设置过
- 症状:第 1 关宽 7040 像素,金币声只有头六枚有声,其余七十几枚完全静音。玩家不会说「静音」,会说「这游戏声音怪怪的」。
- 根因:定位音效的衰减相对听者算,而
AudioSystem的听者从构造起就钉在世界原点(0,0)—— 全工程没有一处调set_listener。于是「金币在玩家身上」被算成「金币在世界原点上」,spatialize在距离超过max_distance(600) 时返回Gain::ZERO。 - 实测(修前):金币 x=40 → 551‰;x=670 / 1812 / 3992 / 6760 → 全是 0‰。
- 为什么测试一直绿:
every_coin_makes_exactly_one_sound数的是plays_of(SFX_COIN),那是「我们请求了一声」,不是「玩家听见了一声」。中间隔着增益,而增益可以是 0。 - 修法:
dispatch_audio每帧把听者设到玩家中心,金币声源用同一个点(两处各取一次会得到十几像素差,让每枚金币恒定压低几十‰ 并向左偏)。 - 顺手收掉一处分叉:八段音效合成一张表
sfx_for。原来只有金币挂在sfx总线上,另外七段直连MASTER—— 「音乐与音效分开压」的设计只对金币生效。七行照抄的分叉,单看每行都合理。 - 判据两条,都反向验过:①
a_coin_is_heard_all_the_way_to_the_end_of_the_level:去掉set_listener⇒ 四处实测 0‰、红。②every_sfx_goes_through_the_sfx_bus:跑完整关 + 撞障碍 + 按技能,八段都得响且都得等于 sfx 总线链;先校验两条总线增益不相等(否则没区分力)。让非定位音效直连 MASTER ⇒ 七段 1000‰、红。期望值从混音器读、不写死 800。 - 假红一条:把玩家瞬移到尖刺中心不触发受伤(危险判定看接触那一步的相对运动,瞬移没有速度)⇒ 走真路(一路向右不跳)。
- 数字:wasm 732.3 → 732.1 KB(预算 800);工作区 1709 passed(+2);CI 通过 188s · 2 项降级(都不是这一笔引入的);三份副本 md5 一致。
- 提交
49312fd,已 push 到origin/agent/A2。
dump 能指定关卡了:十二关各拍一帧,顺带发现坑是「空着的」
ME_DEMO_LEVEL=0..11走choose_level(先顶满 unlocked,不绕解锁);ME_DEMO_X走新的warp_to(贴地落位 + 12 帧无敌,否则落点旁的刺同帧弹回复活点)STATUS_U329 → 10,第 9 项是关卡号:12 关共用图集与天空,拍错关卡像素看着完全正常- 真 bug:坑在地形里是「地面段之间的空隙」⇒ 什么都不画 ⇒ 背景纸从坑里透出来(纸是亮的,读起来像地面被裁了一刀)。改成从
ground_segments()反推坑、画soil×0.3竖井压在地面下一层:贴地最暗 8×8 块 68.1 → 23.0 - 新判据 G:十二关各 1 帧,只读 dump 自己的数(STATUS_N 两侧常量 / LEVEL / COINS_LEFT == 该关
.lvl的 coin 行数);金币那条是唯一抓得到「关卡号换了、世界没换」的 - 新判据 H:量贴地最暗 8×8 块 ≤ 40。三条反向验证都做了:漏调 level ⇒ 两条红;伪造 LEVEL ⇒ 只有金币数红;停掉坑绘制 ⇒ 68.3 红
- 踩坑记一笔:
PICTURE是 NDC(-1..1)不是像素,按像素量会得到「画面 2×2,渲染没走完」 - 全套 23 项 ✅ / 0 ❌,CI 通过;wasm 三份副本同哈希
2026-10-25
HUD 换成墨色:那五行字的对比度本来是 1.00:1,而判据一直在数纸
- 放大 in-game 帧发现五行读数几乎看不见。量的结果是没画:关卡行对背景 1.00:1(亮度与纸完全相同),五行 1.00/1.02/1.54/1.13/1.09。
- 判据为什么绿:旧判据数「三通道 ≥150 的亮像素」,而敦煌纸三通道全 ≥150 ⇒ 数到 56 984 个,带子总共才 58 368 个像素。判据数的是纸。
- 改法:五槽位换墨/铜/朱砂/石青/石绿(4.5 到 12.55:1),结算面板那行不动(压在深色板上,方向相反)。不选「加暗影/垫底板」:会切开批次或压住技能条。
- 新判据两条:①数墨色像素 ≥300 ②五色对实测背景众数的 WCAG 对比度 ≥4.5。只判一,颜色淡了过;只判二,字没画也过。
- 顺手修同一类错的第二例:结算分支扫的是窗口顶部(1024×768 里正好是 letterbox)⇒「顶部没字」一直在数黑边。改成按画面矩形扫。
- 反向验证:配色改回旧的重建 ⇒ 红在「0 个墨色像素」;改回来绿在 595,最差对比度 6.01:1。
- 提交
345e611,三份 wasm 逐字节相同,十项判据 + 全套 CI 通过(2 项降级)。
手机上的说明页,最后三行压在手柄底下(第十二批)
- 说明页在触屏上从
24排到211,而手柄从193.7起 ⇒ 最后三行被<>盖住(含12 LEVELS ABOUT 3 MINUTES EACH)。 - 它什么都不报:正文确实画了,
menu_line(Body)读出来也完整。只有把「画在哪」和「手柄在哪」一起量才红。 - 触屏头部改两列两行、行距收到 0 ⇒ 17 行排到 159(页脚 172、手柄 193.7)。
- 新增
help_line_rects(touch)逐行给矩形(行高/前进量从BuiltinFont取);不能给整页包围盒 —— 那是满宽的,而HOW TO PLAY靠左、顶部||居中,会红在假的地方。 - 判据 x1(84),负向验证:旧排版放回去就红。CI 135s。
- 说明页在触屏上从
Mac 桌面版放不出技能:宿主只认了三个键(第十一批)
coin::button_of只写了0/1/2,漏了Skill = 3—— 而 Swift 侧一直在发(J/K/Shift)。- 后果:
me_md_key返回 -3,宿主_ =丢掉 ⇒ 桌面版放不出技能;而窗口底部那行说明写着「J / K / Shift 技能」。不报错、不黑屏,DASH OK一直亮着。 - 改成「列出接受的四个动作键、编号问
raw()」;Pause=4仍拒(桌面有自己的菜单键,两条路做一件事)。 - 判据
every_action_button_the_keyboard_can_produce_is_accepted:逐个问raw(),外加 Pause 必须被拒。负向验证红在「按钮 3(Skill)被拒」。 - Mac 23 条判据全绿,clippy 干净。
说明页补上 `||`,并把「提到屏幕上的每个键」做成自维护判据
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
KEYS ARE THE FOUR BUTTONS BELOW(屏幕上是五个,且一个在顶部)。刚修过「说明教玩家按不存在的键」,不补就变成它的镜像:屏幕上有键,说明不提它。 - 顺手把判据改成逐个问
pad_glyph(不再写死字形清单)——写死的话加第六个键时这页会静默漏掉,而它是玩家唯一会读的地方。pad_glyph因此升成pub。 - 负向:删掉那一行 ⇒ 红在「触屏宿主的说明页该画出屏幕上的
||(Pause)」。 - 另一条硬朾教训:改完引擎必须
build.sh → cp 两份 → build_site.py,否则 CI 红在「生成物陈旧」(这一批被拦了两次)。 - 提交
a8937d9(agent/A2 已 push),全量 CI 73s 通过。
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
手机结算页:文案按宿主说话,且点一下真的能继续
- 小游戏开局现在停在标题页,于是它第一次有了玩家能看到的第一屏文字。顺着这条线补了两处「默认玩家有键盘」的地方。
- ① 说明页只有一版
JUMP SPACE UP W / MOVE A D,手机上这三个键一个都没有(只有底部四个字形<>^*)。拆成HELP_HEAD_KEYS/HELP_HEAD_TOUCH+ 共用HELP_TAIL,判据用已有的touch_ui(它已经在决定画不画手柄)。 - ② 三个终局面板硬写
PRESS SPACE,手机上通关/掉坑后就停在一个「让他按空格」的画面上,而那个画面上没别的东西可点。触屏版改TAP TO CONTINUE。 - ③ TAP 得真的有用:
me_coin_run_continue只有网页接过,game.js从来没调 ⇒ 手机玩家只能杀微信重进。bindTouch加onPress:DOWN 之前问一遍,返回 true 就整下吃掉(不 poke,否则手柄认领一个键而restart不重建手柄 ⇒ 进关先蹦一下);UP/MOVE 照样转发(否则按着右键掉坑的那根手指永远不抬起)。 - ⚠️
me_coin_run_continue错误约定与me_coin_run_audio相反:失败返回正数 4。写if (o < 0)永远进不去。 - 验收:Rust 101 lib + 79 game_slice(+2)、node 52 项(+1)、clippy/CI 全绿(148s);负向三条各自精确红(不吞 → py 170.97→152.86 起跳 18px)。
- 提交
b3f4782(agent/A2 已 push)。
结算画面两处残留 UI:描边停在 (0,0)、技能条没让位
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
let _edge = …),位置永远停在 (0,0) —— 屏幕最上沿多出一条 6px 青线,看起来像装饰;② 技能条是另外两个色块实体,结局后文字让位了它俩没让,结算画面左上角飘着一条青色进度条。 - 修法:
Sim.panel_edge与panel走同一段定位算式;结局后技能条尺寸缩到零(零面积不落像素,比加可见性开关少一个会忘同步的状态)。 - 新判据
the_result_panel_is_the_only_thing_left_on_screen:过关帧描边的位置与宽度必须等于面板、技能条两个色块面积必须为 0。两条在修之前都会红。 - 实测:结算帧描边矩形 (83,218)-(940,223)(面板左上角 80,215),技能条填充 0 像素;全量 CI 166s · 1485 测试 全绿。
- 提交
35fea9b,已 push agent/A2。
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
2026-10-24
没声音的真因:空图 prepare() 抛 NSException —— 一行修复,附判据 E
- 真机反馈「从 Finder 启动也没音效」⇒ 根因不是会话类型、不是音量、不是波形。
- 根因:
AVAudioEngine是惰性建图的,而prepare()假设图已建好。 建出来直接prepare()时 graph 里连outputNode都没实例化,AVAudioEngineGraph::Initialize断言inputNode != nullptr || outputNode != nullptr失败,抛NSException绕过do/catch。栈顶就在-[AVAudioEngine prepare]。 - 修复是一行:
prepare()之前先_ = e.mainMixerNode(getter 才会实例化 outputNode 并连上)。最小复现 20 行验证:不碰 → NSException;碰一次 →running = true。 - 上一版归因是错的,已在代码注释里订正:写成「非 GUI 会话(终端/沙箱/ssh)拿不到音频硬件」,并用「
system_profiler明明列着默认输出设备」当反证。错在证据只有「终端里跑没声音」——而双击启动根本没有终端可看。用open -n(LaunchServices,与控制台双击同会话)复现,一样失败。 - 判据 D(上屏)之外新增判据 E:
ME_AUDIO_PROBE=60报引擎在跑 / 节点已挂 / 淡入到满音量。实测AUDIO_TAKEN 60 CMDS FRAMES 60+节点 1 · 运行中 · mixer 1.00 · 当前语音音量 1.00。 - 探针自己踩了一个坑:
audioProbe分支没走固定步长,连跑 N 帧的dt差分为 0 ⇒ 30 帧只取到 3 条指令(全在第 0 帧),而同一份代码走 dump 是 30 条。判据红的与被测行为无关。 - 另加落盘诊断
(本机路径):双击启动没有终端,log show又要非沙箱权限 —— 起不来的结论必须落在磁盘上。
演示打不开的两个真原因:端口通 ≠ 是我们的服务;nohup 服务随父进程被回收
- 现象:Safari 打开演示页是一页 404 / 连不上,而服务看起来在跑。两个原因症状完全一样,白查两轮。
- 原因一:上一轮为跑
run-*.sh手工起过服务,--root是仓库根(页面在/apps/coin-run/demo.html)。serve.sh --open看到端口通就跳过启动,转头打印/demo.html⇒ 404。复用没错,错在没问一句「你是谁」。现在复用前先要一个 200,拿不到就在开浏览器之前 exit 1 —— 宁可什么都不弹,也不要弹一页 404。 - 原因二:从 CI / agent 工具调用上下文
nohup起的服务,父进程一退就被回收。地址打印完、浏览器打开时端口已经没了。现在起完立刻探活,探不到直说并指向双击入口。 - 新增:
apps/coin-run/打开演示.command(Finder 双击,父进程是登录会话 ⇒ 服务不被回收);apps/coin-run/test_serve_open.py9 项;serve.sh --no-open。 - 判据支点:把
open换成记账的假货放进 PATH 最前面 ⇒「弹窗了没有」成了可断言的事实,测试本身也不弹浏览器。只有证明「该弹的时候会弹」,「不弹」才是判据 —— 否则把 open 那行删掉,前三条照样全绿。 - 实测:Safari 回传
DEMO READY 8/8,why=title-change,UASafari/605.1.15;全屏截图确认八个面板全渲染。headless 截图evidence/demo-gallery.png。 - 顺带:
check_bash.py的discover()扩到.command(双击入口必须是这个后缀,天然逃过 CRLF / 缺 shebang /$VAR(中文)三类检查)—— 这一批正好写了/$FILE,,是它先红了我才发现的。A3 的 owns 路径,已代修登记cross-sector.txt(复核 A2+A3,到期 2026-11-07)并 fyi 报备。 - CI:42s 全绿,新增一步「演示可达」9 项;workspace 1186 测试。提交
add36b8已推agent/A2。
协商板撞号修复 + 守卫第 5 条 + poke 相位编号收敛成一个
两条跨扇区尾巴,各自堵掉一个「不会红」的失效。
1. 协商板撞号(错在我):提 N-008/N-009 时手上是
92ab276,A3 的同号两条随c26dccf才进 main ⇒ 四行里两行的编号指向的不是自己。它自己不会红(表由正文生成、reply_state_problems用 dict 按编号索引、watch.py照常报「在等」)。已改名为 N-015/N-016,并给守卫加第 5 条(同一编号出现两次即红 + 给出能直接抄的号max+1)。演练过:真板红两条,改完绿。2. N-013:poke 相位编号对齐契约(选 B)。A3 倾向两入口并存,理由是「poke 刻意没有 Move」——这句在代码里不成立:
VirtualPad::update有Move => {},移动不掉键(有测试);且touch_codec线上码也是 0/1/2/3,选 A 会留三套编号。3. 顺带:
render.pass.md升 v11(只为一条交叉链接改指向,sha 变了就升版本);pointercancel从 UP 改发 CANCEL;宿主加pointermove/onTouchMove;新增以前写不出来的测试「按住右滑到左键区域不掉键」。4. 证据:
me-runtime5 条单测 · 宿主 17 项 ·run-demo.sh七面板 7/7 · CI 全绿(契约 50 / workspace 1181 / 协商板 ✓)。提交a043c9a+0916547,已推agent/A2。5. 坑:换编号必须重编
apps/coin-run/wasm/me_runtime.wasm(gitignore)——产物没跟着改时,红的是产物不是代码;这台机器的 bashgrep是 BSD 版,\|不是「或」⇒ 静默返回空,用它找引用会漏,改-E或 ripgrep。
2026-10-23
P2 缩小:mip 链 → 揪出「采样器覆盖纹理参数」,mips 参数从上线起一直空转
- 三个副本同帧(同像素 / 同 uv / 同缩放,只换 mip 链与采样器句柄),192 条判据(3×64 像素)真机全对。
- 读数:只第 0 层+采样器
min=0 max=255 对比度=255别名;mip 全+采样器0/255/255别名(mip 没生效);mip 全+不绑采样器128/128/0正确。 - bug:WebGL2 要求采样器对象覆盖纹理自己的 MIN/MAG_FILTER,而
RhiSink永远带非 0 采样器 ⇒ 胶水照mips生成的LINEAR_MIPMAP_LINEAR从第一天起就没生效过。形状是「参数被接收、被处理、被断言设过了,但被下一条指令覆盖」——编译和单测都拦不住。 - 判据设计:缩小取 7 倍不取 8 倍。
ratio=8⇒s = 8d+3.5,frac恒 0.5,每格 50/50 平均成一片 128,与 mip 链的值分不开;7 时frac恒 0,取到纯纹素,黑白交替,对比度 255 vs 0。 - mip 由引擎自己 2×2 box filter 逐层算(确定性;胶水那次
generateMipmap跑在还没有像素的时候)。 - 新增
wasm_mip.rs(8 单测)、mip.html(192 判据)、run-mip.sh、mip_js_table.rs(5 条表核对)、证据evidence/p2-mip-minification.png。 - 协商板补 §1.8:
me_filter只有 NEAREST/LINEAR,表达不了*_MIPMAP_*,请 A1 裁决;并提醒 A3 别删胶水那次generateMipmap(它的副作用是分配 mip 层,删了只在真机glError != 0)。 - CI:845 测试 / 13 步 / EXIT=0。提交
8948f4e(代码+证据) +83d52e7(文档),已推agent/A2。