【首次连通性测试报告】


■ 测试目标

验证 Unity MCP 环境搭建完成后，Claude Code 能否通过 MCP 操控 Unity Editor 完成基本操作：创建 GameObject、设置 Material、添加脚本、运行场景。


■ 测试内容


· 测试项：创建红色旋转方块

操作序列：

1. 创建方块
- 通过 gameobject-create 工具创建 Cube（PrimitiveType.Cube）
- 位置：原点 (0, 0, 0)

2. 创建并应用红色材质
- 通过 assets-material-create 创建 Assets/Materials/Red.mat
- 使用 Standard Shader，颜色 RGB (1, 0, 0)
- 通过 object-modify 将材质引用赋值给 Cube 的 sharedMaterial 属性
- 注意：必须传递结构化引用 {"instanceID":-1852,"assetPath":"Assets/Materials/Red.mat"} 而非字符串路径

3. 添加旋转脚本
- 创建 Assets/Scripts/Rotator.cs
- 挂载到 Cube 上
- 实现 Y 轴旋转 + X 轴摇摆效果

4. 添加方向光
- 创建 Directional Light
- 光照强度 1.5，旋转 (50, -30, 0)
- 原因：Standard Shader 在无光源场景中显示为黑色/灰色


■ 遇到的问题与解决

问题 原因 解决方法
方块显示白/灰色而非红色 场景缺少 Directional Light 添加方向光
`m_Color` 属性写入失败 Reflector 使用属性名而非序列化名 改用 `color`
`material` 属性读取产生警告 编辑模式下访问 `material` 会实例化 改用 `sharedMaterial`
sharedMaterial 字符串赋值失败 属性期望 Material 引用对象 传递结构化引用 `{instanceID, assetPath}`
Cloud 模式连接失败 (SSL Error 35) 国内网络无法验证 ai-game.dev 证书 切换到 Custom 模式本地直连


■ 验证结果

- ✅ Unity MCP Server 正常运行（进程约 96MB 内存）
- ✅ Claude Code ↔ Server ↔ Unity Editor 三方连通
- ✅ GameObject 创建、材质应用、脚本挂载均正常
- ✅ 方块成功显示红色并旋转
- ✅ 77 个 SKILL.md 全部生成


■ 关键经验

1. 优先使用 Custom 模式：国内网络环境下 Cloud 模式不可靠
2. Reflector 路径语法：用属性名（color）而非字段名（m_Color），用 sharedMaterial 而非 material
3. Material 赋值需要结构化引用：不能传字符串路径
4. Standard Shader 需要光照：新建空场景要加 Directional Light


■ 测试日期

2026-05-29 ~ 2026-05-30