title: 网络验证方法论与结果汇总 created: 2026-05-06 status: COMPLETED
VRChat/Unity 知识网络验证报告
验证时间: 2026-05-05 ~ 2026-05-06
验证原则: 所有技术方案必须经过官方文档、开源仓库或社区教程的交叉验证，禁止闭门造车。
验证网络拓扑
┌─────────────────────┐
│ 服务器 (国内) │
└────────┬────────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ ✅ GitHub │ │ ⚠️ 部分SPA │ │ ❌ 被墙 │
│ API + Raw │ │ 文档站点 │ │ 官方文档 │
│ (可直接访问) │ │ (需浏览器) │ │ (DNS污染) │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
lilToon 源码 MA 官方文档 VRChat 官方文档
MA 官方文档 NDMF 官方文档 Unity 官方文档 (部分)
VRChat 社区 lilToon 文档 Unity Forum
验证结果汇总
MA 官方文档 NDMF 官方文档 Unity 官方文档 (部分) VRChat 社区 lilToon 文档 Unity Forum
## 验证结果汇总### ✅ 已验证 (源码/官方文档级别)
| 验证项 | 来源 | 关键结论 |
|:---|:---|:---|
| **lilToon `_DissolveParams` 分量映射** | GitHub: `ltspass_cutout.shader` + `lil_common_functions.hlsl` | `.r`=模式, `.g`=形状, `.b`=进度, `.a`=软度 |
| **lilToon 溶解核心公式** | GitHub: `lilCalcDissolveWithNoise()` (L668-715) | `dissolveAlpha = 1.0 - saturate(\|maskVal + noise - progress\| / softness)` |
| **Cutout Shader 默认启用溶解** | GitHub: `#define LIL_FEATURE_DISSOLVE` (L680) | 无需额外开启 |
| **Unity 材质属性动画格式** | Unity API: `AnimationClip.SetCurve()` | `material._PropertyName.subProperty` 格式官方支持 |
| **MA MergeAnimator 配置** | MA 官方 GitHub 文档 | Layer Type=FX, PathMode=Absolute, Priority≥1 |
| **MA MenuItem 参数绑定** | MA 官方 GitHub 文档 | 自动参数创建、Saved/Synced 控制 |
| **MA MenuInstaller 安装规则** | MA 官方 GitHub 文档 | 顶级安装、自动分页、子菜单需两个资产 |
| **MA Parameters 参数类型** | MA 官方 GitHub 文档 | Bool/Int/Float/Animator Only/Prefix |
### ⚠️ 部分验证 (信息不完整)
| 验证项 | 状态 | 原因 |
|:---|:---|:---|
| VRChat Expression Parameters 256 bits 限制 | 社区共识 | 官方文档被墙，但社区广泛确认 |
| lilToon 官方文档 (日文) 完整内容 | VitePress SPA | 需要浏览器渲染才能获取 |
| NDMF 完整构建阶段列表 | 落地页可访问 | 文档站点为 SPA，curl 无法获取 |
| MA 组件 SerializedObject 字段名 | 文档已获取 | 需要 Unity 环境验证实际序列化 |
### ❌ 未验证 (无法访问)
| 验证项 | 原因 |
|:---|:---|
| VRChat 官方 Expression Parameters 文档 | `docs.vrchat.com` DNS 污染/被墙 |
| VRChat Creator 官方文档 | `creators.vrchat.com` 连接超时 |
| Unity Forum 讨论帖 | 403 Forbidden |
| Unity 官方 Manual | 部分页面 404 |
## 网络访问方法总结
### 可访问的源
```bash
| Unity Forum 讨论帖 | 403 Forbidden |
| Unity 官方 Manual | 部分页面 404 |
## 网络访问方法总结
### 可访问的源
```bash# GitHub API (无需认证，限流较低)
curl -s 'https://api.github.com/repos/<owner>/<repo>/contents/<path>'
# GitHub Raw 文件
curl -s 'https://raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>'
# lilToon 官方文档 (VitePress SPA)
curl -s 'https://lilxyzw.github.io/lilToon/' # 首页可访问
# MA 官方文档 (nadena.dev)
curl -s 'https://nadena.dev/modular-avatars/' # 首页可访问
# NDMF 官方文档 (ndmf.nadena.dev)
curl -s 'https://ndmf.nadena.dev/' # 首页可访问
# Unity Scripting API
curl -s 'https://docs.unity3d.com/ScriptReference/<class>.<method>.html'
被墙的源
| 域名 | 错误类型 |
|---|---|
docs.vrchat.com |
[Errno 101] Network is unreachable |
creators.vrchat.com |
[Errno 101] Network is unreachable |
forum.unity.com |
HTTP Error 403: Forbidden |
vrchat.fandom.com |
HTTP Error 403: Forbidden |
duckduckgo.com |
超时 |
核心验证结论
1. lilToon 溶解参数 (100% 确认)
_DissolveParams 四个分量的作用已经通过源码 100% 确认：
.x = 0→ 溶解完全禁用.x = 1→ 启用 2D 纹理掩码溶解.z从 0 到 1 → 溶解进度从完全显示到完全消失
2. Unity 动画绑定格式 (100% 确认)
Unity 官方 API 文档确认了分量绑定格式：
clip.SetCurve("", typeof(Material), "material._Color.r", curve);
clip.SetCurve("", typeof(Material), "material._DissolveParams.z", curve);
这意味着在 AnimationClip 中绑定 _DissolveParams.z 是 Unity 官方支持的。
rial._DissolveParams.z", curve);
```
这意味着在 AnimationClip 中绑定 _DissolveParams.z 是 Unity 官方支持的。### 3. MA 组件配置 (100% 确认)
MA 官方文档确认了所有关键配置：
- MergeAnimator:
Layer Type = FX,Path Mode = Absolute,Layer Priority ≥ 1 - MenuItem: 支持自动参数创建，
Is Default设置默认值 - MenuInstaller: 顶级安装，支持自动分页
- Parameters: 支持重命名、Saved/Synced 控制
下一步行动
- 通过 MCP 连接 Unity，验证上述配置在 Unity 环境中的实际效果
- 创建动画片段，绑定
material._DissolveParams.z曲线 - 挂载 MA 组件，按照验证后的配置方案执行
- 构建并测试，确认游戏内效果