开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 9 条记录。
2026-11-15
判据的两条几何限制:有些错只有交叉那条测得到;双胞胎抓不住口径错
meet只能验一个轴,这是几何的限制不是偷懒。取min(sx,sy)意味着比值大的那个轴刚好铺满(free = 0),只有另一个轴有空隙。所以九种x??Y??不可能在同一个 setup 里看出差别,最多验三种,要两个 setup:viewBox="0 0 50 100"(free_w=100)验横向、0 0 100 50(free_h=100)验纵向。- 两个 setup 加起来仍然抓不到串轴错。把
match a.align_x写成match a.align_y,横向那三条用的名字是xMinYMin/xMidYMid/xMaxYMax—— x 与 y 的对齐恰好一致,串了以后算出同一个数。抓它的是交叉那条:xMaxYMin必须 x 偏 100、y 不偏。所以「两个单轴判据拼起来」不等于「两轴判据」,必须显式测一次交叉。这一点是变异演练发现的,不是设计时想到的。 - 「期望红而没红」有两种完全相反的真相,只能手算分辨。前者是判据有洞(需要改判据),后者是期望算错(需要改期望)。我这一次遇到的是后者,而且一次就是两处。处置是改期望、并在脚本里写明「为什么这条抓不到」——不是把判据改软去凑它,后者会把「判据有洞」永久掩盖起来。分辨方法只有一个:把 setup 里的
sx/sy/free/tx一个个算出来,看那个数该不该变。 - 一个反例:
if rest.is_empty() { return Ok(ident) }删掉后 0 条红。它看起来在防「空transform属性」,实际上while !rest.is_empty()本来就处理了空串——那是「看起来在防什么」的空代码。同形状的还有Flatten::segments_for里那个n.max(1)。所以演练不只能验判据真假,它也在验代码里哪些分支是真的。 - 下一步(没做):现在 179 条断言里还有几条只证明「自洽」(比如拿 A 跟 A 的双胞胎比)。这类抓得住回归,但拓不住口径错——双胞胎两边一起错仍然绿。值钱的那几条已经把期望值换成独立公式(
πr²/ 交集w·h/ 包围盒整数格子),剩下的还没换完。
2026-11-14
Unity 7 调研:它花十年修的是「并存」,我们别重犯
- 数据源:
UnityCsReference@7000.0.0a16(Unity 7.0 alpha 16,2026-11-05)。树里 9,035 个.cs;blob 只落盘 2,639 个 / 783,136 行(Editor 层近全量:1,544 文件 / 456,886 行)。核心 C++ 一行看不到——那本身是第一条结论。 - 三条硬数据:① 398 个
*.bindings.cs= 12.1% 的行数没有任何实现(全文 6,556 处extern、964 处NativeHeader)② 编辑器 1,544 个.cs里 UI Toolkit 约 18%、IMGUI 约 19%,两套并存五年(OnGUI(已 0,但GUILayout/EditorGUILayout还在 300 个文件里)③ 最大单一模块是GraphToolkitEditor813 文件,第十名才是Entities163。 - 主论点:它十年修的是「并存」不是「功能」。三管线收敛 7 年(2026-06 的 6.5 才正式弃 BiRP),Mono→CoreCLR 9 年(2017 HackWeek 原型 → 2026-10 的 7.0 编辑器才不带 Mono),而且为此暂停了动画与世界构建的新功能。
- 该抄三条,全关于怎么退役:弃用写日期三件套(最后支持版本 + 支持结束 + 迁移文档)/opt-in → 默认 → 留逃生阀/给 agent 一条
me status --json(先做命令,MCP 只是壳)。 - 不该抄三条,全关于怎么并存:五对两个(渲染 3 套 + 物理/UI/输入/运行时各 2 套)/闭源核心/可回溯的商业条款。Unity 自己的判词是「Game Objects won, but Entities will Drive Game Objects」。
- Web 差距:Unity 空项目 7.7 MB(2D BiRP)/ 10.7 MB(3D URP),Godot ~5 MB,我们 795.1 KB 的完整游戏——9.7 倍 / 6.3 倍。Unity 那条「双后端同构建 + 按设备自动回退」值得抄,硬约束是「用户只下一份包」。
- 两篇调研撞出同一个洞:Godot 44% 的编辑器 include 自家控件 vs 我们
me-studio对me-ui是 0%。
- 数据源:
2026-11-10
S13 止损线的病因更正:不是净扭矩,是 8 轮迭代传不完 10 层
- 11-07 我给 A1 的结论是「2 点流形顺序求解带净扭矩 ⇒ 上块求解(3–5 人日)」。那个结论是猜的,今天推翻。
- 判别读数(同一场景只改
velocity_iterations):8 轮下底层竖直速度第 9→11 步 26→28.5→28.3 卡住不降;32 轮 9.4→7.2→5.6 收敛到 0。600 步后 8 轮下沉 200px 翻倒,32 轮下沉 28.5px 站住。 - 分界严格在层数 6→7,与宽度无关:80px 宽(宽高比 1:2.5,物理上绝不该倒)照样翻。8 轮 ≈ 8 跳传播距离,6 层够 7 层差一点。
- 块求解治不了这个病——它管「同一个流形内部两点冲量不等」,而这个病在「上下相邻两层之间」。两件事不在同一层。那 3–5 人日排期是白花的。
- 上一版错在把「锁住旋转就不倒」当判据:锁旋转同时把塔变成只能竖直传力的质点链,同一病因换了表现(塌不表现为翻倒、表现为下沉 9.4px)。一个现象能同时解释两条通路时,它不能当判据。
- 排除过程(六条,各有实测):地面摩擦(μ=0.6,排除)、恢复系数(e=0 仍翻)、暖启动(关掉仍翻)、分岛(逐位相同)、参考面抖动(真缺陷但只治 289→164)、接触分离容差(单列逐位无变化,10×10 爆到 41km,有反作用)。
- 判据 9→10 条,新增一条同时断言「8 轮塌 / 32 轮稳」,两组变异证过会红(2.13px / 15.27px)。整包 86 条全绿,
N-357已按这版更正。
2026-11-07
S16-5 后一半:me watch 落地,§3 表被迫长出一列「输出」
- S16-5 收口:
me watch落地(增量监听 + 变更集),契约 §3.8,事件 schemame.watch.v1 - 本仓唯一不经过
main::emit的命令:其余命令输出「一次结论」,而它输出「一个过程」。三条不变量:一行一个完整 JSON、首start末stop、seq不跳号——第二条最要紧,进程被杀时没有stop,那是编辑侧唯一能区分「跑完了」与「断了」的信号 - §3 表被迫长出第五列「输出」(信封/流):不加的话
--json扫描会跑me watch --json而它永不返回,CI 不红只会挂着。这列是给「判据自己别变成挂起」开的规矩 - 增量是两层指纹(文件字节只决定要不要重解析、节点指纹决定变更集);坏文件不中止也不参与节点差分(中间态必然语法错),保留最后一次好的快照,坏→好抖动不刷屏
- 判据:Rust 157 条;
test_cli.sh176→190(第十一节按列分流 17 条全覆盖 + 新的三步真改文件增量演练);drill-watch.py6 条变异逐条证过会红。演练逼出真问题:scan()那层原本没有判据——单测只覆盖了diff,把scan换掉则毫无反应,而真实后果是编辑侧每存一次盘场景节点全删再全加
- S16-5 收口:
S16-5 前一半:协议协商 + 冻结面,让「无破坏性变更」变成可判的
- S16-5(6 人日)这轮落版本协商这一半,watch 增量与变更集下一轮
- 要堵的那句话没法判定:DoD「编辑器协议连续两个迭代无破坏性变更(判据:me-studio 调用端不改一行)」——什么算协议、什么算破坏性都没清单,只能靠人回忆,而改的人从不觉得自己改了协议
- 把协议变成可枚举的面,每行取代码真实形状:外壳六键与顺序(从
json::envelope实际输出里读键名)、七档退出码、全部命令名、流式事件。渲染成protocol.v1.txt(27 行)+ FNV 指纹 → 「破坏性变更」有了机械定义:那份文件变了(加命令就重生成,改键序就 bump 版本另存 v2) --protocol <n>是门,在分发之前判、对每条命令生效。放各条命令自己管 = 留一个「忘了协商」的口子,而忘了的症状是安静地放行- 判据:Rust 6 条 + test_cli 第十二节 12 条(含python 现算一遍 FNV 与 me 报的指纹比对,两个语言独立算出同一个值)+ drill-protocol.py 8 条变异逐条证过会红
- 演练逼出一个真问题:第一版用
assert_ne!(newer, older)判「两个方向说的话不一样」,而它恒真——版本号不同就恒不相等,方向写反也照样不相等。第 3 条变异红在下一行才看见。判据自己也要被演练 - 顺带修掉上轮留下的
CONTRACT-STALE:cli.spec.md升 v12、同步 MANIFEST(A1 扇区,已登记代修) - 进度百分比没动:那是 main 的发布基线,A3 这半要等合并后才进分母
- 没做 watch 的理由:它输出是流式的,而 §3 表与
--json扫描都假设「一条命令 = 恰好一份信封」。加一列「输出:信封 / 流」改的是扫描的判据形状,而那个扫描这轮刚建成 S16-4 的证据——同一轮既建又改,两件事都没验干净
S16-4 收口:me --json 第一次真覆盖全部命令(三处「看着对」的坑)
- 飞哥说「S15、S16 可以提前」,先动 S16 里唯一无依赖的一条(S16-4,5 人日)
- 坑①:
me survey --json吐出的是「人读表格 + JSON 外壳」两段拼接,json.loads在第 1 个字节就失败(825 字节全不是 JSON)。全 crate 只有这一处绕过诊断通道的print!。改法不是加if json,而是把数字写进diagnostics(新码 ME-SURVEY-010..040),人读与机器读同一份。代价:那张对齐的表没了 - 坑②:「全部命令」以前没有可枚举的定义——契约表 §3 只有 13 条,代码能解析 15 条(
me sym/me bench一直没登记)。补两行 + 双向判据(name()的穷尽 match ↔ §3 表)。没另抄手写清单:抄的第三份就是会漂的第二真相源,而「两份对得上却同时少一条」正是这次的形态 - 坑③:
new/atlas/survey的外壳cmd是空串(位置参数必填时走的那条路),另 12 条是填对的。拆MissingArg { cmd, usage }修好 - 判据:
test_cli.sh160 → 176 条,按 §3 遍历、在空临时目录里跑(那批命令有会写盘的) - 六组变异逐组单独注入,都红了。最有价值的一条:
survey又自己 print! 这个变异,只有成功路径那条判据抓得到,扫描抓不到——不给参数时走不到report() - 流程教训:还原变异用反向替换,别用
git checkout。这轮它两次把我的改动一起冲掉(main.rs 一处、survey.rs 整块),重做了一遍。拿仓库当前状态当备份不成立 - S15 对 A3 是空转:三条 A3 名下的活全排在 A1 的 S15-4「通用序列化」后面(存档的槽位与迁移链必须建在那个版本头上)。已开 N-356 请 A1 先给最小可用接口
2026-10-31
改一个字的含义必须 bump ABI,加一个函数不必 —— 判据是「失败响不响亮」
rhi.ffi.h的版本表上这句话现在有了正反两面的例子:- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
INVALID_ARG/ 格式值不存在)。 - 改已有值的含义必须 bump(v26 是 v9 之后第一次):旧宿主传
format = 0想说的是「你挑」,新库读成「要 RGBA8」——两边都不报错,画面还在出,只是换了个通道序。这正是握手该拦的那一类,而拦得住的前提是两个数不相等。
哨兵取
0xFFFF_FFFF的第二个理由:格式值今天最大 22,它离得无限远,而且零初始化的结构体不会撞上它 ⇒ 零初始化 = 要 RGBA8(两条后端都真收),比「零初始化 = 你挑」安全(「你挑」在换后端时换答案)。配套给调用方加了一条义务(规则 30):
formats[]里现在真的有 0,只能按format_count读;按「遇到 0 结束」读的症状是「这台机器一个格式都不支持」而format_count说是 2。- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
2026-10-23
ADR-007 裁决 + ADR-008「更像人」:对齐玩家,不是变强
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
me-net只装与范式无关的六件事;同步范式项目级二选一、编译期裁剪;确定性是可选能力 + CI 守卫。未决两条(Det数值表示、快照压缩)保留开放——按 §3.1 实测,Det的触发点是“守卫变红”,不是开工前置。 - ADR-008 加 §8「更像人」。需求原话:「通过对弈玩家,假装水平和玩家相当。」
- 它与初版“智力远超常规 AI”不矛盾:前者是能力上限,后者是暴露水平。合起来是“我比你能,但我装成和你差不多”。
- 拆三步,每步归属不同:观测(引擎:SkillModel,规则层算、不调模型)→ 目标(项目:开关 + target_offset)→ 执行(provider:loss_budget / think_ms / style)。任何一步合并掉,就成了“引擎偷偷替人决定难度”。
- 三条先决判断:
① 对齐的是“这个人”不是档位 → 估计只能来自与他的实际对局;
② 局内不修胜率,跨局才更新目标 —— 拟人化的死敌不是失误,是橡皮筋;
③ 能力不足不许装,否则“像人”就成了静默降级的后门。
- 判据只承诺“量得出来”:盲测 AUC / 思考时长 KS / 失误率条件分布 / 重复率,四条都必要不充分;判据数据必须与调参数据不同源。
arena report不判通过失败——“多像才算像”是产品标准。 - 同步改了三处口径防打架:14 号文档 §6 把“自动调难度”拆成禁(隐藏)与行(显式 + 留痕);新增 §7.4 接入形态;05/09 的计划表同步。
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
2026-10-22
立项:MagicEngine 正式启动,代码落位 (本机路径)
定位:不做「另一个全能引擎」,做「预算感知 + AI 进编译链」的引擎;护城河在 MIR(带预算注解与溯源的内容图)+ 跨端编译,不在渲染器。
验收口径:P0 不是「做出引擎」是「验证假设」—— Gate 0 六指标 <4 项即止损;降级方案 C(AI 挂到 Cocos,8 周止损)预定触发。
代码落位:
(本机路径)→(本机路径)(240 文件 / 2 提交 / 工作区干净,原目录留备份)。基线已成:19 篇文档 + 6 ADR;
interface/契约冻结(rhi.ffi.h v1);越界守卫脚本;SfxForge 音效已跑通(32 资产 / 7 项硬校验 / 两次构建 MD5 一致)。三个决定:MIR 用块语法不用 S-expr(可 review 优先);FFI 冒烟提前到 W2(改语言成本 2 周 vs 4 个月);并发度按 FTE 表定(四并发窗口仅 8 周)。
现实约束:PS5 devkit 与主机 SDK 受 NDA、周期不可控 ⇒ 架构留口 P2 实现;新引擎本身不是卖点,唯一卖点是效率被实测数据证明。