编辑与导入排错
从文件结构、资产引用、输入错误和发布步骤定位问题
优先使用底部的问题入口，找到具体文件或资源，再按以下对应场景处理。不要为了清空一条提示而删除尚未理解的配置。
ZIP 导入失败或没有布局
确认压缩的是一个 Xerr 插件项目，包含 config.yml 与 core，而不是整个服务端或客户端资源包。
- 目录有共同外层
Xerr：可以导入。 - 同时压入两个不同项目：分别压缩后再导入。
- 包内有越界路径、重复路径或超过安全限制：重新整理项目再压缩。
- 导入成功但项目尚无布局：先在布局分类新建，而不是期待编辑器自动生成默认主题。
默认主题应由插件首次启动生成；参见安装与默认效果。
图片或字体读取失败
先确认 ZIP 中包含资产文件，而不只是 YAML 引用。
| 检查点 | 示例 |
|---|---|
| 图片组位置 | core/assets/image/xerr_ui/icon/config.yml |
| 图片文件 | 同组 textures 中的 PNG / GIF，或配置指定的相对路径 |
| 引用图片 | namespace、basename 和图片 ID 与登记项一致 |
| 字体配置 | core/assets/font 中的字体定义 |
| TTF 文件 | 字体配置引用的实际文件，不能只保留字体 ID |
在资源库中打开对应资产，对照图片参考或字体参考。上传替换图像时，选有效 PNG / GIF；仅修改扩展名不会转换文件格式。
输入没有应用或导出被阻止
- 数值：离开字段或按
Enter应用，红色错误需要先修正。 - 多行文字：
Enter用于换行；点击其它控件结束编辑。 - YAML：修复语法和引用错误；最后一次有效画面仍可见时，当前源码也可能有错误。
- 想放弃未应用输入：按
Escape，再确认恢复的值。
不要反复点击导出来跳过校验。需要查找其它字段时，可从「文件」直接查看完整配置。
打开 YAML 源码，对照当前文件检查表达式、配置字段与引用。
拖不动、删不掉或找不到对象
先检查顶部是否处于预览模式，再检查选中对象是否锁定。输入框有焦点时，方向键和删除键优先作用于输入内容。
看不见元素时，使用聚焦、适合视图或屏外元素入口。没有显示不一定代表元素被删除，也可能是视角、条件、偏移或隐藏状态。
改一个元素影响了其它内容
通常是共享了同一个字体、模板或布局。打开「关系」查具体使用者；只希望影响当前对象时，按安全复用创建独立副本。
游戏里没有更新
按顺序检查：
- 是否导出了最新 ZIP，并更新到正确服务器的
plugins/Xerr？ - 是否处理了本次删除、移动或重命名留下的旧文件？
- 插件重载是否报错？目标 HUD 或信息栏是否启用，布局是否已绑定？
- 新字体、图片或资源设置是否完成打包，客户端是否已加载新包？
- 动态文字、权限条件、目标世界或脚本变量是否符合实际玩家环境？
罗盘目标需由运行时命令或程序提供；弹窗需触发显示。编辑器中安排了样式，不会替玩家永久建立这些运行时对象。
进一步的服务器排错见Xerr 排错。