43 lines
4.7 KiB
Markdown
43 lines
4.7 KiB
Markdown
# Unity CLI Loop迁移核对与裁决
|
||
|
||
2026-09-21。用户要求参考D:/ft/ft/Client，确认当前项目是否可按相同方式替换UnitySkills。当前Unity处于用户提示的Reloading暂停阶段，本轮仅只读核对并落盘，不修改包清单、不触发导入、不控制Editor。
|
||
|
||
## 核对结论
|
||
|
||
可以迁移，建议复用参考项目已固定的本地包与批处理保护补丁。它只替换编辑器测试工具，不改变s101登录实现及验收范围；正式API仍为http://s101.local:18080/。
|
||
|
||
| 项目 | 参考项目 | 当前项目/本机 |
|
||
|---|---|---|
|
||
| Unity | 2022.3.62f2c1 | 相同 |
|
||
| Unity CLI Loop包 | io.github.hatayama.uloopmcp 2.2.0，本地包 | 当前manifest仍是com.besty.unity-skills，尚未安装ULoop包 |
|
||
| CLI | 文档固定2.2.0 | 实际uloop --version返回2.2.0 |
|
||
| 常驻对象 | HierarchyService明确获取DontDestroyOnLoad根对象 | 现有UnitySkills常规场景缓存未显式纳入该特殊场景 |
|
||
| 依赖 | ugui1.0.0、newtonsoft3.2.1 | 已具备；无需新增Input System |
|
||
|
||
参考来源：D:/ft/ft/docs/uloop-codex-setup.md、Client/Packages/manifest.json、本地ULoop package.json/FT_PATCHES.md及HierarchyService.cs。包固定上游v2.2.0 / 1dbd4435e872a7f33904bb024062f2abb987eb12，补丁防止BatchMode和Asset Import Worker启动服务/重载恢复钩子。
|
||
|
||
文档差异：参考setup文档提到根目录.agents/skills/ft-unity和shared-uloop适配器，但此次实际路径不存在，不照搬该脚本命令。参考Client/.codex和.cursor存在另一套uloop技能；不整批复制这些代理配置。以本机uloop CLI的--help及本地包契约为准。
|
||
|
||
## 完整方案与开发边界
|
||
|
||
1. 等待用户确认Reloading结束，先核对目标Editor状态；不强制杀进程、不清Library、不操作D盘参考实例。
|
||
2. 复制参考项目的Client/Packages/io.github.hatayama.uloopmcp包到当前同路径，保留.meta、许可证及FT_PATCHES.md；不复制Library、.uloop运行缓存、会话或权限文件。
|
||
3. 仅修改当前Client/Packages/manifest.json的工具依赖：移除com.besty.unity-skills，增加io.github.hatayama.uloopmcp本地路径，与参考项目一致。让UPM更新packages-lock.json，并检查锁文件差异只涉及工具依赖。
|
||
4. .gitignore加入/Client/.uloop/，补充当前项目CLI操作说明/迁移静态检查入口。若存在UnitySkills自启脚本先核对差异再移除；本轮Assets/Editor检索未发现相关引用。历史测试脚本及证据保留，标记停用，不删除历史日志。
|
||
5. 不复制D盘其他业务代码和完整manifest；不升级Unity、不新增Input System、不提高动态代码权限、不修改全局AI配置。编辑器相关改动不会扩大俱乐部、KV或PlayFab删除范围。
|
||
|
||
评审裁决：基于两个项目相同Unity版本、包依赖已满足、本机CLI版本匹配和本地补丁可复用，最小方案可行；开发边界限定工具包、manifest/UPM锁文件、忽略规则及操作文档。当前未实施。用户此前要求暂停Reloading期间的操作仍有效；恢复Editor操作前需解除该暂停。
|
||
|
||
## 迁移验收与后续测试
|
||
|
||
- 每条CLI命令显式--project-path C:/projects/ft/Client，避免误连D:/ft/ft/Client。实际Unity.exe位于本机C:/Program Files/Unity/Hub/Editor/2022.3.62f2c1/Editor，不照抄参考文档D盘编辑器路径。
|
||
- 先get-version、get-project-info确认当前项目、包版本及会话；再执行compile、get-logs检查导入结果，并核对批处理保护与移除旧包。
|
||
- 验证get-hierarchy能看到DontDestroyOnLoad中的UI及设置/账号入口，再做截图和控件定位。
|
||
- CLI提供simulate-mouse-ui，可用于EventSystem界面操作；真实可用性在当前项目接入后验收。simulate-keyboard/mouse-input依赖Input System，本次不为它们改变项目输入系统。
|
||
- 缺少专用操作时，动态代码先放CodexOutput、评审其读写边界，compile-only通过后再执行相同文件；不提升安全级别来绕过限制。
|
||
- 首先续测101退出再登录、101→102→101、失败重试及Cookie/SignalR隔离。当前仅确认工具能力与迁移可行性，不能保证自动解决Reloading或所有UI/真机测试。
|
||
- 工具接入后更新验证入口及交接文档；UnitySkills旧实例失联证据保留历史。每小步骤写开发日志。
|
||
|
||
## 2026-09-21 实施补充裁决
|
||
用户明确要求移植Unity CLI Loop 2.2.0，Reload卡死已定向重启并确认恢复。允许开始上述方案；为避免打开Editor时复制半成品触发多次导入，先确认非Play/非编译/场景未脏，正常关闭C盘实例，在其关闭后复制本地包、修改工具依赖和忽略规则，再打开同一项目验收。D盘项目只读作包来源。此补充不授权清理Library或回退业务改动。
|