版本:Art Build 01;日期:2026 年 10 月 24 日。以批准的横版侧视视觉稿为方向,采用深蓝海底机房、象牙白平台、黄铜金边、青色水光和暖色灯光。角色统一使用 DeepSeek、Grok、Claude、GLM。
当前 assets/runtime-catalog.json 登记 28 张原生 PNG,96 个运行采样区;另有 1 张独立 HUD 图标带供 HTML/CSS 状态徽章使用。assets/asset-manifest.json 记录制作状态、参考与来源。文件数与可调用区域数不同:角色和部件共用图集,头像源图也直接用于运行缩放,没有重复生成或另存裁切版。
| 可调用内容 | 数量 | 交付方式 |
|---|---|---|
| 四角色左右朝向 × 五种状态 | 40 | 四张动作图集;待机、行走关键姿态、跳跃、下落、技能 |
| 正面头像 | 4 | 四张独立生成的胸像 PNG |
| 敌方 | 2 | 普通守卫与调查员 |
| 道具 | 6 | 一张图集 |
| 场景部件 | 18 | 平台/障碍、机关、港湾三张图集 |
| 特效帧 | 16 | 四组 × 四帧,四张图集 |
| 背景 | 3 | 游戏舞台、标题与结算 |
| UI 图形 | 7 | 鲸鱼徽标+六类装饰框,两个 PNG 文件 |
| HUD 图标带 | 6 个图标 | 1 张无文字透明 PNG,CSS sprite,供实时状态徽章使用 |
| 总计 | 96 | 28 个生产 PNG 文件 |
另外新增 5 张剧情关键帧 PNG,位于 assets/story/,由剧情电影、实景和分镜模式共同读取;它们不占用 96 个运行时取样区。assets/prompts/ 与 assets/provenance/ 记录每张关键帧的生成提示词和来源。
配套程序界面由 assets/ui/game-ui.css 与 assets/ui/hud-icon-badges.png 提供,覆盖菜单、任务 HUD、指令预览、小队面板、触屏操作、对话、章节结算和主线结算;原矢量操作图标已由 operation-icons-v1.png 的 16 枚手绘图标替换,button-states-v1.png 提供默认、聚焦、按压和禁用四态。CSS 负责排版与状态,固定视觉取自 PNG。HUD 的固定语义优先使用生成图标,实时数字、计时、任务进度、按钮状态和无障碍文本仍由游戏代码更新,避免把动态信息做成无法更新的静态图片。
本轮使用内置 image_gen,全部交付 PNG 为原生生成输出的完整复制,保留原始尺寸与 Alpha,未后期裁切、缩放或拼接。实际尺寸以目录中的 images 为准,例如角色动作图集为 793×1983,头像与敌方为 1254×1254,场景图集为 1536×1024,三张背景为 1672×941;这些不是旧制作清单中的目标导出尺寸。
20 张透明 PNG 均检查到真实 Alpha 通道及完全透明像素;三张背景为 RGB 不透明图。部分资源 Alpha 最大值为 252 或 254,这是输出的实际数据,不应误记为 255。各图的尺寸、模式、字节数、透明像素数及 SHA256 保存在 runtime-catalog.json。
所有矩形采用原图绝对像素坐标 [x, y, width, height]:
| 字段 | 含义与用途 |
|---|---|
source_rect | 资源在原图里的完整分配区域,包含透明留白;用于图集取样与特效共同画布 |
content_rect | 在分配区域内以 Alpha > 8 检测得到的内容包围盒;普通精灵以此裁取显示,不会改写原图 |
solid_rect | Alpha > 160 的实色包围盒;供边缘检查和主体识别,不能直接充当玩法碰撞盒 |
logical_size、anchor | 运行时目标显示范围与归一化锚点;适配器默认保持长宽比 |
按每条记录取样,不统一等分。 角色原生图集宽度为奇数,左右列会有一像素差;平台图集六个部件采用不等宽区域,UI 装饰框也按实际区域登记。不要用固定格宽重新切图,否则会截断武器、平台或装饰框。
资源适配器 提供 AssetLibrary.load、draw、drawActor 和 drawEffect。下面示例适用于位于项目根目录的游戏入口模块:
import { AssetLibrary } from './src/render/assets.mjs';
const art = await AssetLibrary.load(
new URL('./assets/runtime-catalog.json', import.meta.url)
);
art.drawActor(ctx, 'deepseek', 'idle', 'right', 320, 520);
art.drawEffect(ctx, 'water-dash', elapsedSeconds, 360, 480);
适配器用 fetch 载入 JSON,游戏入口应通过开发服务器访问。角色默认以 content_rect 为显示区域、以底部中心锚点放置;传入的 feetY 是美术脚底位置,仍需由角色物理状态决定。
四组特效默认 8 FPS、500ms、播放一次;可以传入 loop 反复展示。特效取样要保留完整 source_rect 和共同中心,不能每帧按内容包围盒重新居中,否则水流和斧光会跳动。solid_rect 不参与特效取样。
平台的装饰支架、管线和下方石柱不能决定碰撞盒。关卡分别定义水平站立顶面、穿越规则和触发器,使角色脚底落在真正的平台边缘。水段、墙板未保证无缝平铺,正式摆关卡时检查接缝。背景可按比例 cover 适配 16:9;角色保持等比缩放。
双击或在浏览器打开 assets/preview/index.html,可直接从 file:// 运行,无外部脚本、字体、CDN 或网络依赖。图库展示全部采样区、角色筛选、四组特效与代码界面示例。场景拼装展示的是素材组合,不是可玩的关卡,也不是实机截图。
| 位置 | 用途 |
|---|---|
assets/atlases/、portraits/、enemies/ | 动作、头像、敌方、道具与场景图集 |
assets/fx/、backgrounds/、ui/ | 特效、背景、界面美术及代码 |
assets/runtime-catalog.json | 程序取样的当前事实来源 |
assets/asset-manifest.json | 制作状态与原计划的对应登记 |
assets/prompts/、provenance/ | 提示词、工具、日期、参考与原始输出位置 |
assets/references/、concepts/ | 用户参考、批准稿与已替代旧稿 |
assets/preview/ | 离线素材库 |
scripts/build_art_catalog.py | 只读分析 PNG 并生成目录元数据,不输出裁缩图片 |
保留每项提示词及来源 JSON,不用“最新生成图片”推测来源。来源记录中的原始工具路径和工作区路径共同用于追溯;替换图像后应同步更新坐标、尺寸、SHA256 与相关来源记录。用户参考和概念稿不计入本轮生产 PNG,也不能标记为真实游戏截图。当前记录不表示已经核验参考图的参赛或使用授权。
本包提供单张行走关键姿态,尚无完整逐帧步态;声音已在 src/game/audio.mjs 中以 Web Audio 合成。比赛主角卡状态为 waiting_for_gameplay_capture,必须在游戏接入后使用真实运行截图制作。五章关卡、约 20 分钟完整流程、存档、碰撞与操作体验仍需开发和实测,本轮美术交付不等于整款游戏完成。
原制作清单 保留了制作前的范围和目标尺寸。当前数量、文件路径与实际尺寸以本说明及两份机器清单为准。
五章侧视可玩流程、键鼠与触屏输入、章间存档、重试、结算和程序音效已实现。比赛主角卡已用真实运行画面制作于 assets/submission/deepseek-hero-card.png,1600×900 PNG。前文“待开发”“待截图”等为此前阶段记录;当前实施与验收见开发与验收记录。首次体验二十分钟待真人校准;在线发布等待源码上传和部署授权。