← 返回记录总览

全量栅格美术升级验收-2026-10-25

来源:游戏-鲸鱼魔盗团/docs/全量栅格美术升级验收-2026-10-25.md · 11.9 KB


全量栅格美术升级验收

核验日期:2026-10-25。核验对象为当前工作区文件;此前方案、旧截图与旧验收结论不作为本次完成依据。

本次已确认:游戏入口与剧情剧场不再加载 SVG 图形,场景主要视觉由 PNG 图集绘制;新增操作图标与四态按钮已接入真实组件。仍保留 HTML 动态文字、CSS 布局、焦点、遮罩与状态控制。这里的“资产化”指固定视觉图形由美术图片承担,不表示移除网页必需的 HTML/CSS 或 Canvas 图片合成。

资产数量与接入范围

口径当前数量证据与边界
runtime-catalog.json 登记 PNG51逐文件尺寸、字节、SHA256、透明元数据、生成来源核验通过
其中基础生产原图23角色动作4、头像4、敌人2、场景/道具图集4、FX图集4、背景3、UI原图2
其中剧情图片26五张早期关键帧,加七个剧情节点 × 三种演出风格的21张图
其中本轮新增 UI 图集2operation-icons-v1.png 与 button-states-v1.png
构建单独复制的补充 PNG10HUD徽章带、六张框体、标题纹章、鲸艇小队、码头前景;不重复计入51
Canvas 采样区9640角色姿态、4头像、2敌人、6道具、18场景部件、16FX帧、3背景、7UI图形
本轮操作图标16HTML/CSS按实测坐标取样,不新增Canvas采样区
本轮按钮状态4默认、聚焦、按压、禁用,均为图集内独立绘制区域

10张补充图片为:hud-icon-badges.png、panel-large.png、panel-card.png、hud-pill.png、hud-square.png、button-rail.png、ring.png、title-ornament-v1.png、whale-crew-hero-v2.png、dock-rail-overlay-v3.png。前八张位于 assets/ui/,后两张位于 assets/foreground/。

“登记/加载”与“每张在某张截图同时可见”是不同证据。51张图片均进入构建目录;角色、场景、FX通过 AssetLibrary 取样,剧情通过 storyArtFor() 和章节/档案封面读取,新UI由真实HTML组件读取。chrome-kit.png 的内容还通过独立框体图片复用;Canvas中的 ui-resource-shell 为无DOM标签时的回退路径,不能用预加载记录冒充正常场景中的可见绘制。视觉方向稿、旧版前景、来源原图、主角卡和历史截图不堆叠到游玩画面中。

新增 UI 图集核验

src/ui/raster-icons.mjs 定义1285×1224操作图集的16个实测区域:左、右、上、下、跳跃、冲刺、互动、暂停、航图、设置、档案、开始、重试、生命、计时、关闭。ui.mjs 与 ui-v3.mjs 使用同一图标工厂,触控与HUD使用真实PNG图标。主菜单、暂停和结果操作仍配短标签,避免只能猜图标。

src/ui/component-art.css 从1774×887按钮图集中取四个837×242区域。:hover、:focus-visible、:active、:disabled对应真实绘制状态;主行动使用金色状态。styles.css 最后导入该文件,因此实际覆盖此前按钮壳样式。

两项原图与原始生成输出逐字节一致,来源、提示词、尺寸和SHA256已登记。两份 register-operation-icons.mjs / register-button-states.mjs 的中文名称与说明码点正确,离线 assets/preview/catalog.js 与运行目录JSON一致。

程序化图形检查

检查范围为 index.html、story-theater.html、src/**/*.mjs、src/**/*.css,仅扫描文本文件。没有扫描PNG二进制;PNG的C2PA元数据中即使含SVG缩略信息,也不属于运行时SVG组件。

检查项当前结果具体边界
<svg>、.svg资源引用、createElementNS游戏与剧情剧场未检出HTML图标工厂返回PNG背景的span
CSS线性/径向渐变游戏与剧情剧场未检出面板、按钮、环、HUD等固定图形使用PNG
CSS旋转菱形、旧orbit、几何扫描装饰已移除或关闭剧情反馈改用现有四帧FX图集
Canvas美术绘制正常路径为图片绘制AssetLibrary.draw()使用drawImage()取原图区域
Canvas路径与矩形仍保留必要功能精确范围clip()、舞台裁切;未用路径涂绘替代美术
Canvas strokeRect()仅debug路径碰撞调试框由debug开关控制
Canvas fillText()无DOM时动态标签回退正常页面具备scene-labels,场景文字走HTML;回退框体仍取PNG

源CSS仍有文字颜色、普通分隔线、阴影、照片裁圆、控件边界与响应式尺寸,状态里仍有✓、◇、折叠+/−等文字记号。这些没有被宣称为新增美术资产,也不能把“主要美术资产化”写成“源码完全不含任何绘图相关API或CSS样式”。

assets/preview/ 是不参与游戏入口的离线资产审阅工具。其CSS仍含卡片渐变和Alpha棋盘格,其Canvas含诊断背景/文字;透明棋盘用于检查素材Alpha,不是游戏场景美术。该工具不属于上述“游戏与剧情剧场未检出渐变”的范围。

动画口径

40个角色姿态 = 四名角色 × 左右朝向 × 待机、行走、起跳、下落、技能五种状态。每个状态当前是一张关键姿态。character-motion.mjs 使用离散位移、旋转、缩放和现有姿态组成动作节奏;“待机4帧”“行走6帧”等程序采样阶段不能写成新增独立绘制帧。

实际逐帧美术为四组FX:水流冲刺、斧击、纸页诱饵、扫描。每组4张独立帧,2×2图集,运行目录为8FPS、500ms,合计16帧。UI或剧情可以重用这些帧并采用自己的触发时长,但不因此增加美术帧数。按钮四态是交互状态图,不计作FX动画。

完整角色逐帧步态目前仍未制作。不能宣称全角色已有手绘连续行走动画。

文字密度与图片构图

已由当前代码确认的调整:指令默认只呈现目标、两种方案、费用、队友短复述与确认;高级编排和影响按需展开。帮助以操作表与配图说明分区;存档导入、地图移动说明、证据正文采用details;分析列表不再逐行重复未收集长说明;契约保留简述并折叠完整规则。

主要画面采用一层外框承载内容,内部列表减少重复金属方框。面板以PNG九宫保持角部,按钮图集按坐标取样;主菜单标题区保留透明,使场景、鲸艇和小队成为主体。

剧情背景遮挡分别修复了两个入口:story-theater.css 的.screen-shade/剧本封面遮罩,以及游戏内 ui-v3.css 的基础、电影、实景三处.story-shade。它们此前误将panel-card.png铺满舞台,现改为低透明阅读遮罩,保留生成背景。两个入口是独立DOM/CSS路径;最终已重新检查游戏内电影、实景、分镜三种截图,确认背景可见。

档案封面现通过storyArtFor()按剧情映射专属电影插画。漫画按原图三分之一的557.333∶941比例显示单帧,当前镜头不再重复完整对白,正文保留在下方字幕框。全线结算的五章进度使用五张剧情关键帧;契约使用2×2 PNG九宫卡片与短述,完整规则可展开。

当前截图证据

目录:output/screenshots/raster-release-2026-10-25/。

最终共20张截图,含15张真实运行画面与5张明确标记的示例夹具。已目检的真实运行截图:

两张移动截图最终通过CDP以实际844×390 CSS视口、deviceScaleFactor=1.75重新捕获;输出像素为1477×683。它们是移动视口中的实时页面,不能把较高输出像素误读为桌面截图。该检查仍属于浏览器模拟,不等同实体手机GPU性能测试。

已目检的示例夹具截图:chapter-result-fixture.png、campaign-result-fixture.png、failure-fixture.png、analysis-fixture.png、contracts-fixture.png。它们使用真实UI渲染器与示例数据,并显示“验收示例/不代表实际通关”标识。它们证明这些面板的构图和资产接入,不证明本次浏览器已经真实完成五章、取得示例分数或触发对应失败/分析进度。

最终浏览器QA记录:finalTab与reviewTab两个活动页面的error日志均为空。截图覆盖所列主要画面,未穷举全部设置组合、每段剧情台词和所有游戏状态。

自动检查

本次独立重新运行并通过:

最终完整套件记录为summary.json,执行时间2026-10-25 12:57(UTC 04:57),24项全部通过、0失败,包括核心与世界fuzz、架构、美术、角色动作、扩展航程/世界、体验、输入、教学桥、主流程、地图、任务完整性、记录、分层渲染、存档、剧情美术/流程/UI、压力检查、构建与部署包校验。verify-story-flow的测试外壳已包含sceneImageKeys,最终完整套件中的17条剧情流程检查通过。

构建结果为51张登记原图;部署包核验101文件、缺失0。完整结果分别见构建日志与包校验日志。美术日志已改为动态“all catalog image URLs”文案;实际断言按当前目录动态检查51个图片URL。

对实际游戏地址执行node scripts/check-http.mjs http://127.0.0.1:8766/通过145个请求。渲染调用检查、浏览器截图、HTTP资源检查分别提供不同证据;模拟加载断言不代替真实浏览器解码。

已纠正文档与实际边界

本轮纠正 assets/README.md 中旧“28张”口径,明确51张目录原图、10张补充图、40姿态与16个真实FX帧。asset-manifest.json 的八条历史UI组合记录已更新为PNG组合接入事实,保留动态HTML文字与CSS布局,不再把旧SVG样式或“待接入”说明当作现状。

可继续提升的真实边界为:角色完整逐帧步态、所有状态组合的穷举覆盖、真实移动设备GPU表现与真人首分钟体验。现有证据不足以声称这些已经全部完成。原始资产留白、墙/水接缝和透视一致性仍应以实际镜头复查,不能单凭文件齐全或测试通过宣称全部画面达到最终美术质量。