35 lines
4.3 KiB
Markdown
35 lines
4.3 KiB
Markdown
# Logo 原生进度条接线验收
|
||
|
||
日期：2026-09-05。分支 codex/local-platform-login，基线41fcd65。用户批准修改现有Layer1_Logo.prefab与LocalPlatformLogin.scene；全部资源操作通过funplay MCP，未手改序列化文本。
|
||
|
||
## 最终行为
|
||
|
||
LocalPlatformLogin 的启动加载实例与loadingPrefab引用改为Layer1_Logo。group-1/Spirit254挂载原生cc.ProgressBar；原有00096_1底图保留，新建Fill子节点引用已有00096_2黄色前景。ProgressBar以FILLED模式控制前景水平填充，totalLength=1、reverse=false、初始progress=0。父节点保持1600×7、原位置和Widget；Fill居中、四边Widget偏移0，避免进度改变宽度与布局竞争。
|
||
|
||
原工程11_GameUI.js:2910的case254按LoadCount裁剪image96第二行。MCP读图确认00096_1是底图、00096_2是前景；因此没有把黑色底图误当填充图。独立资源审查发现过Fill偏移-800的问题，已通过编辑器修正并复审通过。
|
||
|
||
代码通过assetManager.loadAny读取序列化loginPrefab.uuid，使用真实completed/total回调更新进度。缓存命中可能很快从0到1，未伪造中间进度。loader失败、非法计数、停止取消均显式终止，迟到回调不再更新。资源就绪仅在实例化、绑定、Sprite依赖校验与下一帧之后记录；100%不会绕过原有配置、连接和最短展示门。
|
||
|
||
## 边界
|
||
|
||
本批是Logo替换与原生进度条优化，不是完整广告启动流程迁移。诊断实例隐藏Spirit3103/Spirit3104和group-32；保留已有500ms诊断展示门，它不产生资源进度。广告图片、远程launchWaitTime倒计时和跳过仍需后续接线。未改配置来源、协议、服务器、账号、房间或子游戏；未新增RPC验收。LocalPlatformLogin仍为本地诊断入口。
|
||
|
||
## 验证
|
||
|
||
- TDD：新增3个行为测试先RED（8通过/3失败，缺少createAssetLoadTask），实现后聚焦11/11通过；覆盖0/.5/1、非法总数/计数、失败、取消与迟到回调。tsx沙箱ENOMEM后使用相同精确命令在获准环境运行。
|
||
- 显式枚举framework-tests/**/*.test.ts：621/621通过；指定架构测试49/49通过；框架TypeScript与导入边界检查通过。没有运行聚合测试或资源生成器。
|
||
- MCP实际Creator3.8.8主checkout；开始时prefab编辑模式dirty=false。现有50个未跟踪文件SHA256不变，两项历史meta删除保留。
|
||
- Prefab/scene通过编辑器保存。MCP fp_3f9e3aa7b3ad6b20复读保存后的Fill位置0和Widget偏移0；资源引用检查无缺失。
|
||
- 无参数http://localhost:7456/实际网页：fp_d74b6f92c22912ae记录resources-ready先于login页面；最终资源修正后fp_ccac4dd12986039a再次验证ready=true、resourceProgress=1、pendingCount=0、无组件失败，Fill位置0、尺寸1600×7。未点击登录。
|
||
- 正常流程验证后停止host，另做视觉夹具，不将人工设置进度当真实加载证据。1600×765窗口半条与1920×945窗口整条截图均检查；0/.5/1填充比例正确。浏览器遮挡会暂停引擎，验收时恢复可见并等待真实AFTER_DRAW后截图，fp_82f3e3cae88af817确认paused=false、hidden=false、progress=fillRange=1。
|
||
- 临时截图在YouleNexus/temp/mcp-captures/logo-progress-half.png与logo-progress-full-wide.png；未提交生成图。
|
||
|
||
独立任务规格/质量审查及资源修正复审通过。最终整体独立审查通过，无可操作问题。
|
||
|
||
## 补充类型与收尾证据
|
||
|
||
Creator自带run_script_diagnostics（fp_6d1508df1f89941a）在既有webview-javascript-bridge.ts:80的const泛型上报13条语法错误；git show基线41fcd65确认该语法早已存在，本批未改。仓库现代TypeScript直接套Creator旧默认配置另有引擎声明/旧lib兼容诊断，不能将它们当作本批代码回归或宣称默认Creator诊断通过。
|
||
|
||
为覆盖实际Cocos脚本（不只framework），使用现有Creator项目及引擎类型，以命令行指定现代语言检查选项：`node node_modules/typescript/bin/tsc -p YouleNexus/tsconfig.json --noEmit --allowImportingTsExtensions --ignoreDeprecations 6.0 --target ES2020 --lib ES2020,DOM --strict --skipLibCheck --types node`，退出0。没有修改任何tsconfig或引擎文件。
|
||
|
||
最终独立验证窗口停止后stopped=true、ready=false、pendingCount=0并关闭，编辑器dirty=false（fp_eef13b93f09005af）。重新核对原有50个未跟踪文件SHA256不变，2项历史meta删除保留。 |