Black Ice:暮色中的北极监听站,雪地、通信桅杆与履带车
开源 skill · v1.0.08 道验收门 · 0 个 npm 依赖

一个 1.4 MB 的游戏。
一个更便宜的模型。
一套 harness。

Saltline 是一个 1.4 MB 的单文件射击游戏,由 Claude Fable 5.2 做成:零外部图片、音频和模型,每个集装箱和每块表面背后都是模型写出的生成器。这套开源 harness 要问的是:一个低成本模型,能不能被同样的生产标准要求?目前的答案:318 KB,四种敌人,一个 Boss,8/8 全绿。

1,423,668字节 · Saltline 参考
318 KBskill 版射击游戏
8 / 8可执行的验收门,不是形容词
0npm 依赖 · 外部素材

01问题

文件大小
从来不是重点。

Saltline 被传播成“1.4 MB 的 3A 大作”。这个说法错得很有信息量:它不是 3A,1.4 MB 也不是压缩技术的胜利。内容从来没有被存储过——它是运行时由代码生成的。

Saltline:黄昏的雨夜集装箱码头,湿地面、灯杆与集装箱峡谷
Saltline / 集装箱码头 / 参考帧第三方截图,仅用于对照

模型写的是生成器,不是一个场景。

文件里大约一半是内联的 three.js,另一半是游戏本身:世界构建、材质、shader、玩家与敌人逻辑、UI 和合成音频。没有图片,没有模型,没有音频文件。代码比它生成的内容小,因为内容从来没有以数据形式被存下来。

真正重要的不是体积,而是那台生成器——几何套件、表面函数、光照装置、动画解算、音频图、自测开关——是模型写的。这会改变“谁能做出一款游戏”的成本结构。

看 harness 如何回答

1.42 MB单个 HTML 文件 · gzip 后约 443 KB
0外部图片、音频或模型
~8 小时创作者自述生成时间 · 约 $550 API

02答案

不是同一个游戏。
是同一种纪律。

第一版 skill 射击游戏通过了当时所有验收门,却仍然像一个 demo。第二版把“成品”变成了一道门。文件只有三分之一大,游戏却更完整。

Black Ice 标题页:实时 3D 场景、标题、前提、开始、设置与操作
BLACK ICE · 318 KB · DeepSeek V4.1 Flash · 8/8标题叠在实时场景上,HUD 隐藏

01 / 外壳

标题、设置、暂停、存档、触屏。

六个真实可检查的界面,不是浮在 HUD 上的一块模态框。设置会持久化,最佳成绩会持久化。玩家看到的第一分钟被当作产品。

product gate

02 / 内容

四种敌人,一个 Boss,两把武器。

游走者、胡蜂、重装守卫和典狱长;步枪与连锁电弧。四条目标节拍,而不是“换个颜色的波次”。

content budget

03 / 循环

能赢,能输,死因有名字。

致命伤害会结束本局,并写出“谁、用什么”击倒了你。playtest 在无头浏览器里真实驱动胜利、失败和重开。计数器不是反馈。

playtest gate

03两个案例,两个结论

到底要不要用 skill?

诚实的答案取决于你要交付什么。两个受控运行,同一个模型,同样的单文件约束,不同的 harness。

Sunset District:湿漉漉的市中心街道上的卡丁车比赛
3D 城市卡丁车受控 A/B

用——当你要交付的是一场完整的比赛。

不用 skill 的那版有扎实的街机核心,但外壳很薄。skill 版补上了设置、存档、触屏、目标链、湿地平面反射和四圈赛制。体积变大了,产品也变完整了。

890 KB无 skill
1.58 MB有 skill
4 圈5 名对手 · 636 calls

读卡丁车案例

Black Ice 实机:目标、罗盘、生命与弹药
3D 枪战三代版本

用——但预算必须先给产品。

第一版 skill 运行优化了画面,却丢掉了产品:一种敌人、一把枪、没有外壳。修复不是再加一个 shader,而是把“成品”变成门、明确美术方向、让 playtest 真实驱动循环。Black Ice 是结果。

318 KBskill v2
4 + 1敌人 + Boss
8 / 8验收门

读枪战案例

04它是什么

skill 是流程。
harness 会反对你。

SKILL.md 告诉模型先决定什么、按什么顺序做。harness 把每个真正重要的判断变成检查,这样弱模型不需要每次从记忆里重新推导品味。

画面

它像照片吗?

固定机位、项目自己的参考 profile、色调检查、空间平坦度、按优先级排序的缺陷清单。由最差机位决定,不是 hero shot。

render · score · calibrate · diagnose

实体

能穿墙吗?

从场景图检查碰撞体一致性、穿透、世界边界、裸边界和可穿模。碰撞体列表和几何脱节就是 bug。

census · collide

循环

能赢、能输、能重开吗?

页面自带的 selftest 或声明式 plan。提示不能承诺范围外的动作。伤害必须写出死因。reset 必须真的重置。

playtest

成品

它是游戏,还是一帧画面?

标题、设置、暂停、存档、触屏、内容宽度、HUD 层级、音频事件、双机位和实测性能预算。

product · mobile

“只活在 README 里的验收门,迟早没人跑。”

05验收命令

八道门。
一个结论。

这是 Black Ice 的真实输出。红色结论是构建失败,不是一份报告。没有项目 profile 时,look 门会退化为色调与空置检查,并明确打印出来。

shaders无编译/链接错误;__READY 为真。PASS
census段数、表面贴图与身份预算。PASS
collide一致性、穿透、边界、裸边、穿模。PASS
lights每盏灯都有安装距离内的实体灯具。PASS
playtest胜利、失败、死因、可见后果、重开。PASS
product外壳、内容、存档、触屏、HUD、音频、预算。PASS
mobile390×844、无溢出、触屏可达。PASS
look最差声明机位 vs 项目 profile,或色调回退。PASS
终端 / 克隆与验收
# Node 22+、Python 3.10+、Pillow、Chrome
git clone https://github.com/NorwinYu/photoreal-game.git
cd photoreal-game
python3 -m pip install -r requirements.txt

./install.sh ~/.agents/skills

node harness/verify.mjs \
  --dir ../my-game --page index.html

没有 npm 包,没有构建步骤,没有 API key。渲染器是一个很小的 Chrome CDP 客户端;度量用 Python + Pillow。

读 harness 文档

06它抓到了什么

那些“看起来没问题”的失败。

skill 里的每条规则都来自一次真实的翻车。下面是四条最有用的——不全是画面问题。

缺陷 / 01

画面几乎全黑。

内联后,顶层的 clamp 和 three.js 的符号撞名。曝光、反照率、光照都没问题;shader 根本没编译。shader 门存在,是因为黑帧看起来像光照问题。

由 / shaders 抓到

缺陷 / 02

雪猫车炸开了。

每个 at() 压栈都没有配对的 done(),零件继承累积偏移,飞到天上。修复靠变换栈,不靠材质。

由 / 人眼 + 近景机位抓到

缺陷 / 03

提示在说谎。

标记在 3.0 m 出现,动作在 1.8 m 生效,提示在任何距离都写着按键。站在 2.5 m 的玩家按了 E,什么也没发生。截图看不出来。

由 / playtest 抓到

缺陷 / 04

Boss 打死了,局没结束。

Boss 死亡钩子先把 boss.dead 置真,胜利计时器还没排进去。playtest 真实驱动到胜利,才抓到这个问题。

由 / playtest 抓到

07证据

运行,不是形容词。

所有运行都是 DeepSeek V4.1 Flash,单文件、自包含。A/B 是 harness 对照,不是受控模型评测。

运行Harness体积它证明了什么结论
Sundown Circuit
城市卡丁车
无890 KB便宜模型不用 skill 也能交出完整街机赛车。核心强,外壳薄
Sunset District
城市卡丁车
skill + 验收门1.58 MBharness 补上产品层和招牌湿路面系统。用
Neon Breach
枪战
无304 KB内容宽度可以撑起风格化游戏,不靠照片感。内容强,风格不匹配
Ironsight
枪战,未公开
skill v11.50 MB第一版 skill 运行 6/6 全绿,仍然像 demo。不够
Black Ice
枪战
skill v2318 KB产品门 + 可移植 playtest 把流程变成游戏。用,但有预算
Saltline
参考
—1.42 MB目标:模型写出生成器,并自带截图与自测。参考

Black Ice:8/8,163 draw calls,127k 三角形,12 盏灯,0 网络请求。在已发布构建上实测

08用 / 不用

skill 不是免费的。

它买来的是产品层和一份可复查的记录,代价是轮次。如果你只需要一张画面,截完图就走。

什么时候用

交付物是一个游戏。

有胜负、有重开,且除了你之外还会有人玩。第一分钟很重要。你希望把构建交给评审时,不用口头解释“还缺什么”。

赛车 · 枪战 · 潜行 · 搬运 · 修理

什么时候不用

你要的是一帧,不是一个循环。

情绪板、风格测试、概念图、30 秒原型。product 门会按设计拒绝它,参考 profile 也会量错东西。

静帧 · 风格测试 · 一天原型

什么时候别用

风格是刻意扁平的。

赛璐璐、图解 UI、CAD 可读性。流程可以迁移,但照片感 profile 不适用。换一个风格一致的 look 门。

风格化 · 精确 · 无相机

诚实的版本

skill 不会把便宜模型变成美术总监。它只是让差距更早暴露。

读文档

09安装

三条命令,
拿到第一个红色结论。

skill 可以当普通指令文件用;harness 才让它可被检查。两者都在仓库里,都不需要账号。

01 / 克隆
git clone https://github.com/NorwinYu/photoreal-game.git
cd photoreal-game
python3 -m pip install -r requirements.txt
02 / 安装 skill
./install.sh ~/.agents/skills
# 或:cp SKILL.md ../my-game/AGENTS.md
03 / 验收
node harness/verify.mjs \
  --dir ../my-game --page index.html
能用在 Unity、Unreal 或 Godot 上吗?

流程可以迁移,仓库里的 harness 假设的是一个网页。五个杠杆——光照、材质、密度、成像、几何细节——与引擎无关。页面契约是接入点:如果引擎构建能暴露场景图、碰撞测试、固定机位和测试钩子,门就可以适配。

这是 Saltline 的模板吗?

不是。它是一套流程加验收门,不包含 Saltline 的世界、配色或素材,也不承诺同样的结果。案例里写清楚了哪些地方变好、哪些地方仍然不够。

为什么是八道门,而不是一个分数?

因为单一分数会隐藏失败类别。画面可以很漂亮但不能玩;循环可以正确但看起来像塑料。门的顺序按失败类别排:行为、工艺、视觉、打磨。look 门放最后是有原因的。

需要什么环境?

Node.js 22+、Python 3.10+(含 Pillow)、Chrome 或 Chromium。没有 npm 包,没有构建步骤,没有 API key。站点和游戏在运行时都不发网络请求。

开源 / MIT

把模型
按标准要求。

给仓库点 star,玩一下构建,或者提交一份把失败留在里面的案例。重点不是便宜模型会写游戏,而是它也能被同样的标准要求。