Harness / v1.0.0

八种
说“不”的方式。

skill 是流程,harness 是那个能说不的部分。它用无头 Chrome 渲染页面、测量画面、审计场景图、驱动循环、检查外壳,最后只给一个结论。

0 个 npm 依赖Node 22+ · Python · Chrome8 道门 · 1 条命令

01循环

看见。测量。
一次只改一件事。

harness 存在,是因为看不见自己输出的 agent 无法做美术指导。渲染器给它眼睛,度量给它方向,验收门阻止它骗自己。

01 / 渲染

可复现的一帧。

无头 Chrome、固定机位、固定种子、固定视口。一个不依赖 npm 的小型 CDP 客户端。页面渲染几帧后设置 __READY。

render.mjs

02 / 测量

多尺度数字。

曝光、裁切、调色板、边缘密度、色彩度、fine/mid/coarse 频段能量,以及 8×5 网格的空间 p10。全局均值会藏住平坦区域。

image-stats.py · score.py

03 / 诊断

三条排序后的修复。

最低比值映射到具体改动。一行,一个变化。模型不需要自己判断“看起来更差”是什么意思。

diagnose.py

04 / 验收

门,不是意见。

shader、census、碰撞、灯光、playtest、product、mobile、look。look 放最后,因为漂亮画面救不了缺失的游戏。

verify.mjs

02工具

小工具。
一个结论。

每个工具只做一件事,打印模型能直接行动的东西。验收命令把它们组合起来;也可以单独跑。

工具做什么输出
render.mjs托管页面、启动无头 Chrome、等待 __READY、截图、收集 console 错误与页面统计PNG + JSON
image-stats.py曝光、裁切、中间调、调色板、边缘、频段能量、空间 tileJSON
score.py相对 profile 的比值 + 色调检查ENERGY + tone
calibrate.py从 2–3 张目标帧取中位数生成 profilerefs/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.mjs390×844 布局、溢出、标题可达、触屏PASS / 发现
verify.mjs跑完八道门,打印一个结论,失败时非零退出PASS/FAIL
qa.mjs从 __PRODUCT.cameras 生成固定机位表表格 + JSON
structcheck.mjs重复的顶层符号和代码块报告

03实测

Black Ice,
八门全绿。

原版 harness 在已发布构建上,没有项目 profile:8/8,约 66 秒。look 门使用回退模式,并明确打印。

shaders无编译/链接错误PASS
census167 mesh,0 失败PASS
collide102 碰撞体,0 穿透,0 穿模PASS
lights12 盏灯,全部有灯具PASS
playtest3/3 进度、死因、重开PASS
product外壳、内容、存档、触屏、预算PASS
mobile390×844、触屏、无溢出PASS
look色调 + 空置回退PASS
终端 / black ice
$ 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 门。

校准

05它不做什么

不是引擎。
没有品味。
不打包票。

harness 是测量仪器,不是创作者。它不会把坏题材变好、替你选美术方向,也不会替代最后的人眼。

不是引擎

它驱动你的页面。

没有场景格式、渲染器或素材管线。页面才是交付物;harness 只检查它。引擎构建可以通过同一份契约适配。

不是品味模型

eye veto 还在。

噪声层可以拉高指标,看起来却像电视雪花。如果数字变好、画面变差,错的是数字。人眼或视觉检查可以否决一帧。

不是保证

全绿只说明地板没塌。

门只检查它能看见的东西。它不证明游戏好玩、文本好、或美术方向值得。它证明地板没有塌。