Harness / v1.0.0
八种
说“不”的方式。
skill 是流程,harness 是那个能说不的部分。它用无头 Chrome 渲染页面、测量画面、审计场景图、驱动循环、检查外壳,最后只给一个结论。
01循环
看见。测量。
一次只改一件事。
harness 存在,是因为看不见自己输出的 agent 无法做美术指导。渲染器给它眼睛,度量给它方向,验收门阻止它骗自己。
01 / 渲染
可复现的一帧。
无头 Chrome、固定机位、固定种子、固定视口。一个不依赖 npm 的小型 CDP 客户端。页面渲染几帧后设置 __READY。
02 / 测量
多尺度数字。
曝光、裁切、调色板、边缘密度、色彩度、fine/mid/coarse 频段能量,以及 8×5 网格的空间 p10。全局均值会藏住平坦区域。
image-stats.py · score.py03 / 诊断
三条排序后的修复。
最低比值映射到具体改动。一行,一个变化。模型不需要自己判断“看起来更差”是什么意思。
diagnose.py04 / 验收
门,不是意见。
shader、census、碰撞、灯光、playtest、product、mobile、look。look 放最后,因为漂亮画面救不了缺失的游戏。
verify.mjs02工具
小工具。
一个结论。
每个工具只做一件事,打印模型能直接行动的东西。验收命令把它们组合起来;也可以单独跑。
| 工具 | 做什么 | 输出 |
|---|---|---|
render.mjs | 托管页面、启动无头 Chrome、等待 __READY、截图、收集 console 错误与页面统计 | PNG + JSON |
image-stats.py | 曝光、裁切、中间调、调色板、边缘、频段能量、空间 tile | JSON |
score.py | 相对 profile 的比值 + 色调检查 | ENERGY + tone |
calibrate.py | 从 2–3 张目标帧取中位数生成 profile | refs/profile.json |
diagnose.py | 排序最低的三个指标并映射到修复 | 排序清单 |
census.mjs | 枚举每个渲染实例,检查段数、贴图与身份 | PASS / 失败 |
collide.mjs | 碰撞一致性、穿透、边界、裸边、穿模 | PASS / 清单 |
lightaudit.mjs | 每盏灯 0.4 m 内有实体灯具 | PASS / 距离 |
playtest.mjs | 驱动 selftest 或声明式 plan:胜利、失败、死因、重开 | PASS / 报告 |
product.mjs | 外壳、设置、存档、触屏、内容宽度、HUD、音频、预算、机位 | PASS / 发现 |
mobile.mjs | 390×844 布局、溢出、标题可达、触屏 | PASS / 发现 |
verify.mjs | 跑完八道门,打印一个结论,失败时非零退出 | PASS/FAIL |
qa.mjs | 从 __PRODUCT.cameras 生成固定机位表 | 表格 + JSON |
structcheck.mjs | 重复的顶层符号和代码块 | 报告 |
03实测
Black Ice,
八门全绿。
原版 harness 在已发布构建上,没有项目 profile:8/8,约 66 秒。look 门使用回退模式,并明确打印。
shaders无编译/链接错误PASScensus167 mesh,0 失败PASScollide102 碰撞体,0 穿透,0 穿模PASSlights12 盏灯,全部有灯具PASSplaytest3/3 进度、死因、重开PASSproduct外壳、内容、存档、触屏、预算PASSmobile390×844、触屏、无溢出PASSlook色调 + 空置回退PASS$ node harness/verify.mjs \
--dir ../black-ice --page index.html
shaders PASS
census PASS
collide PASS
lights PASS
playtest PASS
product PASS
mobile PASS
look PASS
look mode: FALLBACK
VERDICT: PASS (8/8)
real 65.76s实测于 2026-11-14。项目自己的门在标题帧报告 163 draw calls、127k 三角形、12 盏灯;游玩过程中数字会变。
04设计规则
不会失败的检查,
不是门。
harness 故意很小,也故意很严。这些规则让它保持诚实。
01
门里没有项目事实。
没有坐标、mesh 名、计数器或 item id。这些属于页面的 __TEST plan 或 selftest。带硬编码坐标的门,只在产生它的那次运行里有效。
02
门赢过模型。
门和模型意见不一致时,门赢。门错了,就用反例修它,不要绕过。绕过就是未来的静默回归。
规则治理03
失败按类别排序。
行为、工艺、视觉、打磨。碰撞 bug 让漂亮画面失效;缺失的设置页让高 look 分失效。顺序就是优先级。
失败类别04
look 门是指南针。
它量的是与一套参考的相似度,不是完成度。风格化游戏可能天然低分。报告最差机位、色调和模式;永远不要让分数压过 product 门。
校准