# 更新 XML 配置
> 当作品出现编辑器与显示内容不同步、黑屏异常、热点错位等问题时，强制刷新配置以恢复正常显示。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「发布作品」中打开更新 XML 配置。面板先说明适用的问题场景，并展示本次更新的配置详情；确认无误后点击「立即更新」，等待几秒即可。更新完成后作品会自动恢复正常显示。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 列出适用该功能的问题场景
- 展示本次更新的作品与更新方式
- 一键强制刷新配置
- 更新过程显示进度状态

## 3. 业务说明

### 配置区域

面板依次为「功能说明」（列出建议使用此功能的问题）、「配置详情」（作品 ID、更新模式、缓存处理、编辑状态）、「操作提示」以及更新中的状态区。底部为「返回」「立即更新」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 功能说明 | 说明何时使用：编辑器内容与显示内容不同步、作品自动黑屏或显示异常、热点配置丢失或错位、场景切换出现问题 | 说明文字 | — |
| 作品ID | 当前要更新的作品，未识别时显示「--」 | 只读展示 | — |
| 更新模式 | 本次更新采用的方式 | 只读：强制刷新配置 | — |
| 缓存处理 | 本次更新对缓存的处理方式 | 只读：清空重建 | — |
| 编辑状态 | 更新后是否保持编辑模式 | 只读：保持编辑模式 | — |
| 立即更新 / 更新中... | 执行配置更新 | 按钮 | 必点 |
| 返回 | 关闭页面，更新中不可返回 | 按钮 | — |

### 保存与生效

点击「立即更新」后开始处理，约几秒完成；更新期间会显示「正在更新配置... 请稍候，系统正在同步最新配置」，更新成功后延迟片刻自动关闭页面。更新会清空并重建缓存、强制刷新配置，用于让作品恢复正常显示。

## 4. 使用说明

1. 在编辑器左侧点击「发布作品」，打开更新 XML 配置
2. 阅读「功能说明」，确认当前问题在适用范围内
3. 核对「配置详情」中的作品信息
4. 点击「立即更新」，等待处理完成
5. 更新完成后确认作品显示是否恢复正常

## 5. 规则与限制

- 更新过程大约需要几秒钟
- 更新会清空重建缓存并强制刷新配置

## 6. 状态与异常

- 更新中显示「正在更新配置... 请稍候，系统正在同步最新配置」
- 更新中「返回」按钮不可用
- 缺少作品 ID：提示「缺少作品ID，无法更新配置」
- 网络异常：提示「网络错误，请检查网络连接后重试」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [发布作品（一级菜单）](https://9kvr.cn/site/tour/editor/config/publish.md)
- [发布作品](https://9kvr.cn/site/tour/editor/config/publish/send.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验