夜班修复师

百 器 归 位

2026 群核空间智能黑客松 · 参赛作品报告书
桌面浏览器 · 单人 · 俯视 3D 生存构筑 · 单局 3–6 分钟
在线试玩:https://repair.aboly.de · 版本 v7 · 2026-11-18

一句话:旧物修复馆闭馆后,推着修复车对抗噪影。三件旧物带在身边是自动武器, 放回展台则成为更强的场地能力——但你不能同时拥有两者。 核心取舍不在数值面板里,而在你每一波的走位路线上。
24件 Lux3D 生成资产
11种敌人
16项升级 · 9 个专精
60项自动化测试

1. 我们做了什么

一个可完整通关的单局 Roguelite:三波敌人(45 / 60 / 75 秒)、一个首领、 波间商店与免费升级、结算与重开。玩家的操作只有移动和一个主动技能(Q), 攻击全自动——所有决策压力集中在「把哪件旧物放到哪个展台」。

1.1 核心机制:双态归位

三件旧物(旧台灯 / 纸折扇 / 旧闹钟)各有两种形态,互斥且全局只能归位一件:

旧物随身(挂在修复车上)归位(固定展台)
旧台灯跟随玩家自动索敌,射程 7.5,单发高展台持续扫描扇形,射程 10.5,覆盖广
纸折扇朝最近敌人扫出短扇面,命中 7 个半径 6.2 的持续风区,减速 25%
旧闹钟以玩家为中心的冲击波,带击退范围更大,并使敌人短暂停顿

归位的代价是真实的:车上少一件武器,你必须把敌人引到展台附近才划算。 这让每一波的走位路线都因上一次摆台决定而不同。

1.2 六个互相咬合的系统

系统作用
修复片经济修复片是唯一货币。波间商店用修复片买升级(每轮限购 1 件),捡得多才买得起,但深入怪群要冒险。
旧物共鸣归位器物与随身器物组成配对照触发效果(暖风 / 报时 / 守夜)。中央展台 B 强度 ×1.35,让「摆哪个台」成为空间题。
器物专精同一件器物选满 1/2/3 项改造,依次解锁三个质变效果(如台灯命中弹射、扇子把敌人拉向风区、闹钟双响),不是单纯加数值。
主动技能技能种类随归位器物改变:台灯→扇形闪光、折扇→环形风爆、闹钟→全场定身。摆台决策多了一层考量。
敌人类别11 种敌人各有反制要求:铁壳影必须绕后、愈合影必须优先击杀、唤影会持续召唤、自爆影要提前拉开。
模型驱动玩法见第 3 节——攻击参数由 Lux3D 模型的几何形状推导,不是手写常量。

2. Lux3D 用在哪

核心 Lux3D 不是素材供应商,而是玩法参数的来源。 项目共调用 Aholo Lux3D 文生 3D 接口生成 24 件资产,覆盖三件器物、修复车、9 种敌人、8 件环境道具。

2.1 调用记录(可核验)

项值
网关https://api.aholo.cn
创建任务POST /lux3d/v1/generate/text-to-3d/task/create
查询任务GET /lux3d/v1/generate/task/get?taskid=…
鉴权请求头 Authorization: <apiKey>(无 Bearer 前缀)
参数version=G1,style=cartoon,faceCount 8k–45k,outputFormat=["zip","glb"]
实际产出24 件 GLB,单件生成约 4–8 分钟
体积优化原始约 180 MB → 运行时 3.9 MB(Draco 网格压缩 + WebP 1K 贴图)

2.2 生成 → 入场的完整链路

Lux3D text-to-3d (G1)
   ↓ GLB(原始 5–9 MB/件)
assets/raw-models/          ← 原始归档(保留来源证据)
   ↓ gltf-transform: Draco + WebP 1024
public/assets/models/*.glb  ← 运行时 100–260 KB/件
   ↓ 构建期读取包围盒
scripts/build-profiles.ts
   ↓
public/assets/model-profiles.json   ← 7 件资产的形状特征
   ↓
src/config/deriveBehavior.ts        ← 几何 → 射程/伤害/冷却/张角
   ↓
运行时 behaviorSpec()

2.3 后处理:两个真实踩到的坑

① 尺寸不一致。Lux3D 的 aiPredictSize 会把模型缩放到 0.1–0.4 米量级, 与设计目标(修复车 1.2 米)相差数倍。解决:读取包围盒后按目标尺寸自动等比归一化, 并接地、水平居中,缩放系数记录在 LoadedAsset.meta 供报告核对。

② 朝向不统一。实测 7 件资产的包围盒最高轴并不一致(修复车最高轴是 X 而非 Y,扇子是平躺的)。 解决:建立 src/assets/orientation.ts,按资产语义声明确定性旋转, 改表即可,不影响任何玩法参数(更换模型不默默换玩法)。

3. 技术创新:让模型几何决定玩法

这是本作品对「Lux3D 参与核心流程」最直接的证明:
删除 Lux3D 资产 → 无法生成 model-profiles.json → 攻击参数回退到静态表 → 整套模型驱动玩法不成立。

3.1 从包围盒到战斗参数

构建期读取 GLB 的包围盒与三角形数,计算四个形状特征,再映射到玩法:

特征计算影响的玩法
elongation 拉伸度最长轴 / 其余两轴几何均值射程、单发伤害(越细长打得越远越重)
flatness 扁平度最长轴 / 最短轴扇形角、命中数(越扁平覆盖越广)
slenderness 高宽比高度 / 水平最长边冷却(越高耸节奏越慢)
solidity 实度三角面密度 / 包围盒体积爆发伤害

3.2 实际推导结果

资产判定形态拉伸扁平推导出的战斗参数
旧台灯impact 圆形冲击1.111.14随身 10.3 伤害 / 1.03s / 3.5 射程
纸折扇area 扇形范围3.6610.29归位 7.5 伤害 / 0.52s / 6.2 射程 / 命中 10
旧闹钟impact 圆形冲击1.491.77归位 16.3 伤害 / 1.38s / 5.3 射程

分类采用「几何主信号 + 器物语义约束」:纯几何阈值会因生成质量波动在边界抖动, 因此用几何特征决定形态类别,再用器物类别约束合法取值区间。该策略在 scripts/build-profiles.ts 中完整可读,不隐藏不确定性。

3.3 界面上可见

摆台界面每张器物卡都带「模型推导」徽标,悬停显示推导理由。 玩家看到的不只是数值,而是「这个形状为什么会有这种攻击方式」。

4. 过程截图

以下截图均来自线上运行版本(https://repair.aboly.de),非概念图。

图 1 标题序章:打字机叙事后标题浮现
图 2 摆台界面:每件器物带「模型推导」徽标与共鸣提示
图 3 战斗中:透视角、真实阴影、归位台灯的呼吸光圈与扇形扫描
图 4 属性面板(Tab 展开):显示模型推导后的实际生效值
图 5 波间商店:用修复片购买改造,每轮限购 1 件
图 6 免费三选一:卡片标注「解锁专精 Ⅰ」与未生效提示
图 7 场景全景与全部敌人种类。场地边缘的工具柜、木箱、工作凳、落地灯、货架, 与中央的 6 种 Lux3D 专属敌人模型,全部由 Aholo Lux3D 生成。 (本图为开发相机接口并排陈列,用于核对造型差异,非正常游戏流程。)

5. 效果如何

4.1 自动化测试(60 项,全部通过)

规则引擎与游戏逻辑分离(29 个模块),核心规则全部有测试覆盖:

测试文件数量覆盖内容
rules.test.ts23规划取消/撤回互斥、同帧伤害取最大、首领免控、波末清场不掉落、首领提前死、加时判定、同归于尽判负、升级超时、暂停冻结、得分公式
v2.test.ts24商店经济、共鸣配对与歧义消解、专精等级解锁、模型推导与回退
v3.test.ts13自爆影引爆、远程弹丸、愈合影治疗、弹丸清理、主动技能四种形态

4.2 平衡模拟(机器人 AI,4 种打法 × 5 种子 = 20 局)

打法胜率平均剩余生命说明
全随身1/512 / 190灵活但输出不足,难以打完首领
台灯归位4/586 / 190扇形覆盖压制
折扇归位4/579 / 190风区减速 + 共鸣灼烧
闹钟归位3/573 / 190控制足但输出慢

归位路线明显强于全随身,符合设计意图(牺牲机动性换取场地能力); 失败多为超时而非暴毙,说明压力落在「构筑够不够成型」。 注:这是机器人数据,不是真人试玩结果。

4.3 线上表现

项实测值
首包体积构建产物 3.9 MB(含全部 24 件模型与 Draco 解码器)
资产加载24/24 件 GLB 全部 HTTP 200,无失败请求
控制台错误0
部署Cloudflare Workers + R2,自定义域 repair.aboly.de

6. 过程与迭代

本作品经历 7 轮迭代,每轮都由具体问题驱动:

轮次问题改动
v1—核心闭环:三波、双态归位、6 项升级、状态机与规则引擎
v2决策频率太低,一局只有 2 次成长修复片经济 + 波间商店、旧物共鸣、升级池 6→12、器物专精
v3敌人只有 3 种,走位压力不足敌人类别扩到 11 种、主动技能(随归位器物改变)
v4「看着像 2D」正交相机→透视相机、俯角 42°→32°、地面分三层、展台改为多层塔、全场真实阴影
v5视角固定、画面静止镜头系统:环绕漂移、事件推拉、手动旋转/缩放/复位
v6主角没有登场感标题序章(打字机叙事 + 逐字浮现 + 卡片进入动画)
v7敌人「都是方块的小动物」批评完全正确:Lux3D 的噪影是一个皱布团。重建生物形体,并为每类敌人独立生成专属模型

6.1 一次如实记录的失败

在 v7 之前,我们试图用 Lux3D 生成的噪影贴图直接驱动敌人材质,尝试了三轮均失败: 作 map 时深灰贴图与基色相乘会把形体压成黑块;作 bumpMap 时因不是法线格式而过曝发白。

最终方案是:为每类敌人单独调用 Lux3D 生成专属模型(而非复用同一份噪影), 这样轮廓由生成结果直接决定,也不需要强行挪用贴图。 这个弯路与结论都保留在代码注释与本节中。

7. 已知限制(如实列出)

项状态
真人试玩未进行目前所有难度数据来自机器人 AI,真人手感未经测试
移动端不支持触屏操作,仅保证页面可打开
音频WebAudio 程序合成 9 个音效,无背景音乐
模型面数受 Lux3D 接口下限(10000 面)限制,单件 1.4 万–3.8 万三角面,高于建议预算,但压缩后不影响加载
无障碍有静音、暂停、可跳过教学、减少动效;未做完整键盘导航与屏幕阅读器支持
范围为提升可玩深度,在第 2–3 轮迭代中加入了 RFC 原始 P0 未包含的商店、共鸣与专精系统

8. 作品入口

项地址
在线试玩(无需登录)https://repair.aboly.de
技术实现说明见随附源码与 spec/implementation_v2.md
资产来源记录每件资产的 taskId、提示词、生成时间见 assets/source/<assetId>/

本报告所述内容均为已实现并通过自动化测试的功能。 未实现项已在第 7 节明确标注,不以设计目标代替完成事实。