百 器 归 位
一个可完整通关的单局 Roguelite:三波敌人(45 / 60 / 75 秒)、一个首领、
波间商店与免费升级、结算与重开。玩家的操作只有移动和一个主动技能(Q),
攻击全自动——所有决策压力集中在「把哪件旧物放到哪个展台」。
三件旧物(旧台灯 / 纸折扇 / 旧闹钟)各有两种形态,互斥且全局只能归位一件:
| 旧物 | 随身(挂在修复车上) | 归位(固定展台) |
|---|---|---|
| 旧台灯 | 跟随玩家自动索敌,射程 7.5,单发高 | 展台持续扫描扇形,射程 10.5,覆盖广 |
| 纸折扇 | 朝最近敌人扫出短扇面,命中 7 个 | 半径 6.2 的持续风区,减速 25% |
| 旧闹钟 | 以玩家为中心的冲击波,带击退 | 范围更大,并使敌人短暂停顿 |
归位的代价是真实的:车上少一件武器,你必须把敌人引到展台附近才划算。 这让每一波的走位路线都因上一次摆台决定而不同。
| 系统 | 作用 |
|---|---|
| 修复片经济 | 修复片是唯一货币。波间商店用修复片买升级(每轮限购 1 件),捡得多才买得起,但深入怪群要冒险。 |
| 旧物共鸣 | 归位器物与随身器物组成配对照触发效果(暖风 / 报时 / 守夜)。中央展台 B 强度 ×1.35,让「摆哪个台」成为空间题。 |
| 器物专精 | 同一件器物选满 1/2/3 项改造,依次解锁三个质变效果(如台灯命中弹射、扇子把敌人拉向风区、闹钟双响),不是单纯加数值。 |
| 主动技能 | 技能种类随归位器物改变:台灯→扇形闪光、折扇→环形风爆、闹钟→全场定身。摆台决策多了一层考量。 |
| 敌人类别 | 11 种敌人各有反制要求:铁壳影必须绕后、愈合影必须优先击杀、唤影会持续召唤、自爆影要提前拉开。 |
| 模型驱动玩法 | 见第 3 节——攻击参数由 Lux3D 模型的几何形状推导,不是手写常量。 |
核心 Lux3D 不是素材供应商,而是玩法参数的来源。 项目共调用 Aholo Lux3D 文生 3D 接口生成 24 件资产,覆盖三件器物、修复车、9 种敌人、8 件环境道具。
| 项 | 值 |
|---|---|
| 网关 | 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 贴图) |
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()
① 尺寸不一致。Lux3D 的 aiPredictSize 会把模型缩放到 0.1–0.4 米量级,
与设计目标(修复车 1.2 米)相差数倍。解决:读取包围盒后按目标尺寸自动等比归一化,
并接地、水平居中,缩放系数记录在 LoadedAsset.meta 供报告核对。
② 朝向不统一。实测 7 件资产的包围盒最高轴并不一致(修复车最高轴是 X 而非 Y,扇子是平躺的)。
解决:建立 src/assets/orientation.ts,按资产语义声明确定性旋转,
改表即可,不影响任何玩法参数(更换模型不默默换玩法)。
这是本作品对「Lux3D 参与核心流程」最直接的证明:
删除 Lux3D 资产 → 无法生成 model-profiles.json → 攻击参数回退到静态表 → 整套模型驱动玩法不成立。
构建期读取 GLB 的包围盒与三角形数,计算四个形状特征,再映射到玩法:
| 特征 | 计算 | 影响的玩法 |
|---|---|---|
| elongation 拉伸度 | 最长轴 / 其余两轴几何均值 | 射程、单发伤害(越细长打得越远越重) |
| flatness 扁平度 | 最长轴 / 最短轴 | 扇形角、命中数(越扁平覆盖越广) |
| slenderness 高宽比 | 高度 / 水平最长边 | 冷却(越高耸节奏越慢) |
| solidity 实度 | 三角面密度 / 包围盒体积 | 爆发伤害 |
| 资产 | 判定形态 | 拉伸 | 扁平 | 推导出的战斗参数 |
|---|---|---|---|---|
| 旧台灯 | impact 圆形冲击 | 1.11 | 1.14 | 随身 10.3 伤害 / 1.03s / 3.5 射程 |
| 纸折扇 | area 扇形范围 | 3.66 | 10.29 | 归位 7.5 伤害 / 0.52s / 6.2 射程 / 命中 10 |
| 旧闹钟 | impact 圆形冲击 | 1.49 | 1.77 | 归位 16.3 伤害 / 1.38s / 5.3 射程 |
分类采用「几何主信号 + 器物语义约束」:纯几何阈值会因生成质量波动在边界抖动,
因此用几何特征决定形态类别,再用器物类别约束合法取值区间。该策略在
scripts/build-profiles.ts 中完整可读,不隐藏不确定性。
摆台界面每张器物卡都带「模型推导」徽标,悬停显示推导理由。 玩家看到的不只是数值,而是「这个形状为什么会有这种攻击方式」。
以下截图均来自线上运行版本(https://repair.aboly.de),非概念图。
规则引擎与游戏逻辑分离(29 个模块),核心规则全部有测试覆盖:
| 测试文件 | 数量 | 覆盖内容 |
|---|---|---|
| rules.test.ts | 23 | 规划取消/撤回互斥、同帧伤害取最大、首领免控、波末清场不掉落、首领提前死、加时判定、同归于尽判负、升级超时、暂停冻结、得分公式 |
| v2.test.ts | 24 | 商店经济、共鸣配对与歧义消解、专精等级解锁、模型推导与回退 |
| v3.test.ts | 13 | 自爆影引爆、远程弹丸、愈合影治疗、弹丸清理、主动技能四种形态 |
| 打法 | 胜率 | 平均剩余生命 | 说明 |
|---|---|---|---|
| 全随身 | 1/5 | 12 / 190 | 灵活但输出不足,难以打完首领 |
| 台灯归位 | 4/5 | 86 / 190 | 扇形覆盖压制 |
| 折扇归位 | 4/5 | 79 / 190 | 风区减速 + 共鸣灼烧 |
| 闹钟归位 | 3/5 | 73 / 190 | 控制足但输出慢 |
归位路线明显强于全随身,符合设计意图(牺牲机动性换取场地能力); 失败多为超时而非暴毙,说明压力落在「构筑够不够成型」。 注:这是机器人数据,不是真人试玩结果。
| 项 | 实测值 |
|---|---|
| 首包体积 | 构建产物 3.9 MB(含全部 24 件模型与 Draco 解码器) |
| 资产加载 | 24/24 件 GLB 全部 HTTP 200,无失败请求 |
| 控制台错误 | 0 |
| 部署 | Cloudflare Workers + R2,自定义域 repair.aboly.de |
本作品经历 7 轮迭代,每轮都由具体问题驱动:
| 轮次 | 问题 | 改动 |
|---|---|---|
| v1 | — | 核心闭环:三波、双态归位、6 项升级、状态机与规则引擎 |
| v2 | 决策频率太低,一局只有 2 次成长 | 修复片经济 + 波间商店、旧物共鸣、升级池 6→12、器物专精 |
| v3 | 敌人只有 3 种,走位压力不足 | 敌人类别扩到 11 种、主动技能(随归位器物改变) |
| v4 | 「看着像 2D」 | 正交相机→透视相机、俯角 42°→32°、地面分三层、展台改为多层塔、全场真实阴影 |
| v5 | 视角固定、画面静止 | 镜头系统:环绕漂移、事件推拉、手动旋转/缩放/复位 |
| v6 | 主角没有登场感 | 标题序章(打字机叙事 + 逐字浮现 + 卡片进入动画) |
| v7 | 敌人「都是方块的小动物」 | 批评完全正确:Lux3D 的噪影是一个皱布团。重建生物形体,并为每类敌人独立生成专属模型 |
在 v7 之前,我们试图用 Lux3D 生成的噪影贴图直接驱动敌人材质,尝试了三轮均失败:
作 map 时深灰贴图与基色相乘会把形体压成黑块;作 bumpMap 时因不是法线格式而过曝发白。
最终方案是:为每类敌人单独调用 Lux3D 生成专属模型(而非复用同一份噪影), 这样轮廓由生成结果直接决定,也不需要强行挪用贴图。 这个弯路与结论都保留在代码注释与本节中。
| 项 | 状态 |
|---|---|
| 真人试玩 | 未进行目前所有难度数据来自机器人 AI,真人手感未经测试 |
| 移动端 | 不支持触屏操作,仅保证页面可打开 |
| 音频 | WebAudio 程序合成 9 个音效,无背景音乐 |
| 模型面数 | 受 Lux3D 接口下限(10000 面)限制,单件 1.4 万–3.8 万三角面,高于建议预算,但压缩后不影响加载 |
| 无障碍 | 有静音、暂停、可跳过教学、减少动效;未做完整键盘导航与屏幕阅读器支持 |
| 范围 | 为提升可玩深度,在第 2–3 轮迭代中加入了 RFC 原始 P0 未包含的商店、共鸣与专精系统 |
| 项 | 地址 |
|---|---|
| 在线试玩(无需登录) | https://repair.aboly.de |
| 技术实现说明 | 见随附源码与 spec/implementation_v2.md |
| 资产来源记录 | 每件资产的 taskId、提示词、生成时间见 assets/source/<assetId>/ |
本报告所述内容均为已实现并通过自动化测试的功能。 未实现项已在第 7 节明确标注,不以设计目标代替完成事实。