用途：面向用户自有本地文件的《最终幻想14》模组工作流，帮助安装、操作并排查 0ceal0t/Dalamud-VFXEditor，编辑特效、动画、时间线、音效、物理、UI、纹理、材质与网格等资源。仅限用户自有本地文件与获授权的模组流程，不得用于绕过服务限制、分发受版权保护的游戏资源或干扰其他玩家。
主要能力：识别资源归属文件类型，常见包括 .avfx（粒子与发光）、.pap（角色动画）、.tmb（特效、动画、音效的时间线触发器）、.scd（音乐与音效）、.atex/.tex（特效/UI/模型纹理）、.shpk/.shcd（着色器包与单个着色器）、.mtrl/.mdl（材质与网格）。若只需隐藏指定特效，建议改用上游作者的 EasyEyes，而非构造替换。
使用方式：主插件安装为 XIVLauncher → /xlplugins → VFXEditor → /vfxedit；测试版插件需在 /xlsettings > Experimental 添加上游 repo.json，主/测试版只能启用其一，然后使用 /vfxbeta。编辑前先快照：python3 .agent-skills/dalamud-vfx-editor/scripts/snapshot_asset.py /path/to/effect.avfx --output-dir ./vfx-backups，该脚本原样复制字节并写入 SHA-256 清单。在 VFXEditor 中选择 Loaded Vfx 作为新来源、Vfx Being Replaced 作为目标，只改预期参数，按 UPDATE，在受控本地场景测试，若时序、挂点、可见性、音效或性能异常立即回退。检查发布元数据：python3 .agent-skills/dalamud-vfx-editor/scripts/inspect_repo_manifest.py repo.json --json。源码构建需兼容环境，项目使用 Dalamud.NET.Sdk/15.0.0、锁定 NuGet 包及 Debug、Release、Beta 配置，推荐命令为 dotnet restore VFXEditor/VFXEditor.csproj --locked-mode 与 dotnet build VFXEditor/VFXEditor.csproj -c Debug --no-restore。
适用场景：插件安装与频道切换、资源编辑与最小改动替换、测试版发布元数据核对、C# 源码贡献与构建。
限制：主与测试版渠道互斥；无法在缺乏兼容 Dalamud 开发环境时保证构建成功；上游 API 与包版本会变化，应以当前上游文件为准。需报告源哈希、文件类型、目标路径、改动摘要、插件频道、游戏/Dalamud 版本、测试场景、观察结果与回退路径，不得将未修改的游戏资源打包进技能或仓库。部分细节（如具体授权范围、收费信息）暂未提供。