44 lines
4.3 KiB
Markdown
44 lines
4.3 KiB
Markdown
# 单文件启动配置验收
|
||
|
||
日期：2026-09-05。分支 codex/local-platform-login。设计/计划提交239af0a，实现提交facceea。独立任务审查与整体审查均通过。
|
||
|
||
## 范围
|
||
|
||
用户批准在 profiles.ts 单一 STARTUP_CONFIG 集中配置 mode、gameserver、useLocalServer、localServers。当前 debug/true；发布时在同一文件明确配置 release/false。URL mode/profile 不再选择模式或服务器，无参数网页可测试。本批不变更账号/身份协议、服务器或任何序列化资源，不扩展 RPC/UI 接线。
|
||
|
||
## 编辑器预检
|
||
|
||
- funplay MCP `fp_5838693755a937db`：主 checkout 的 `G:/Works/YouleGamesCocosCreator/cocoscreator_projects/YouleNexus`，场景 dirty=false。上批预览窗口已关闭。
|
||
- `fp_da61681a45eaf2e1`：当前 LocalPlatformLogin 场景 UUID67e69aac-9982-4e78-a44c-1d9c42f016ae，Canvas/Host 挂 LocalPlatformLogin。未写入场景或组件。
|
||
|
||
## 实际浏览器
|
||
|
||
通过 MCP 逐一刷新七个已有 TS 文件后，run_project_preview 返回无参数 `http://localhost:7456/`（`fp_b0584ce226aea86b`）。另由 MCP 创建独立 Chromium 验证窗口，Node integration 关闭，context isolation/sandbox 开启，加载同一原始 URL（`fp_a5517175ea6d4b16`）。
|
||
|
||
- `fp_328c5953fca91a56`：真实 location.search 为空；startup-config 的 mode=debug、source=remote，唯一服务器为 ws://127.0.0.1:3088。loading-first-draw=1574.9ms，配置完成1768.8ms，资源完成1773.3ms，最短展示门2075.5ms，login 页面2077.8ms激活；ready=true，无错误提示。未点击游客登录或测试其他 RPC。
|
||
- `fp_ec454dd740d8ce07`：通过 Creator import map 导入实际编译配置模块，保留真实 fetch，在冲突且重复的 mode/profile query 下读取。请求一次，HTTP200；结果仍为代码配置 debug/useLocalServer=true，配置快照内容等于 STARTUP_CONFIG，本地目标不变。rawConfig===remoteConfig.raw，前后 localStorage 内容不变。
|
||
- `fp_7d52b3adb2c0ea9a`：独立验证窗口停止后 stopped=true、ready=false、pendingCount=0，然后关闭该窗口。编辑器启动的普通网页预览供用户自行测试。
|
||
|
||
## 工作区与使用指南
|
||
|
||
原有50个未跟踪文件 SHA256 无变化，两项历史 meta 删除仍保留；本批未修改任何序列化资源。继续使用同一主 checkout 分支，不创建 worktree。
|
||
|
||
同步更新 docs/guides/配置与调试指南.md：当前启动设置、无参数测试、原生注入、内存解析、发布修改和安全测试命令。旧指南中 URL profile、绕过远程读取和历史接口示例不再作为操作步骤。
|
||
|
||
## 自动回归
|
||
|
||
- TDD 首轮聚焦 RED：28项，4通过/24失败，包括无参数被拒绝、模式错误、旧profile影响目标及缺少新配置入口。
|
||
- 最终聚焦62/62；全量显式枚举纯TS 618/618，无跳过或取消；指定架构测试49/49；框架类型与导入边界检查通过。全量包含既有负面路径的预期观察者异常日志。
|
||
- 测试覆盖四种 mode/useLocalServer 组合、冲突与重复URL参数、无参数宿主、非法配置、原生gameconfig、读取失败、停止期间不连接，以及内存原始数据引用。没有执行聚合资源生成测试。
|
||
- 七个生产TS文件在通知浏览器验证前已稳定；之后只补充测试，实际浏览器证据对应facceea的生产代码。
|
||
|
||
## 当前使用方式和限制
|
||
|
||
设置集中在 profiles.ts 的 STARTUP_CONFIG：mode=debug、useLocalServer=true；gameserver 与 localServers 同处定义。用户可直接打开 LocalPlatformLogin 并网页预览，不加mode/profile参数。
|
||
|
||
发布时在同一配置文件明确设置 release/false，同时选择Creator适当构建选项；LocalPlatformLogin仍是本地诊断场景，不是生产UI入口。当前真实远程配置对BUILD身份缺少game/player TCP，选择远程地址时仍会显式失败；不改身份、不用游客服务器或本地地址兜底。
|
||
|
||
独立Task1规格/质量审查覆盖239af0a..facceea，通过且无可操作问题；整体独立审查覆盖5d90891..af059b4，通过且无可操作P0/P1/P2/P3问题。
|
||
|
||
用户追加纠正：原工程启动资源加载界面应为 Layer1_Logo，当前诊断场景仍使用 Layer614_Loading。上述无参数启动证据只验收配置来源和就绪流程，不代表启动界面已忠实复刻。Logo 接线按下一批资源授权与原工程核对处理。
|