主题
备份、导入与版本恢复
适合：换电脑、误删组件、把项目拷给同事、大改前留档。
两种「导入」别搞混
| 在哪里 | 干什么 |
|---|---|
| 我的大屏 顶栏 导入 | 从 JSON 新建 一个大屏（列表里多一张卡片） |
| 编辑器 更多 → 导入/导出 | 同上，或 导出当前 大屏 JSON |
两者打开的是同一个 导入 / 导出 窗口，只是编辑器里还能 导出当前项目。
导出备份（手把手）
- 打开要备份的大屏 编辑器。
- 确认已 保存（有未保存修改先
Ctrl+S）。 - 顶栏 更多 ▼ → 导入/导出。
- 在 导出大屏 区域点 导出 JSON。
- 浏览器会下载一个
.json文件，文件名类似大屏名称_1730xxx.json。 - 把文件存到 U 盘、网盘或发给同事。
TIP
导出的是 项目内容（页面、组件、数据源配置等），不含 发布链接 token。导入后需 重新发布 才有新的公开链接。
没有「导出 JSON」？ 需要 screen:export 权限。
从列表导入（新建大屏）
- 进入 我的大屏。
- 顶栏右侧点 导入（带导入图标）。
- 弹出 导入 / 导出 窗口。
- 在 导入大屏 区域点 选择 JSON 文件。
- 在电脑里选中之前导出的
.json文件。 - 等待提示 导入成功。
- 系统会 自动新开标签页 进入编辑器；回到 我的大屏 刷新，列表里多一张新卡片。
常见错误
| 提示 | 原因 |
|---|---|
| JSON 格式错误 | 文件损坏或被改过，不是合法 JSON |
| 导入失败（400） | 文件结构不符合平台要求 |
| 没有导入按钮 | 无 screen:import 权限 |
在编辑器里导入（同样效果）
- 编辑器 → 更多 ▼ → 导入/导出。
- 选择 JSON 文件 → 选文件。
- 成功后 新开 一个新大屏的编辑器；不会 覆盖当前正在编辑的大屏。
版本历史（误删恢复）
每次 保存 大屏时，系统会自动存一个版本快照。
打开版本历史
- 在 编辑器 里。
- 顶栏 更多 ▼ → 版本历史。
- 弹出列表，每行类似：
V3 · 张三 · 2025-05-27 14:30:00。
列表是空的？ 还没保存过，或刚创建尚未第一次保存。
回滚到某一版
- 在版本历史里找到目标版本（数字 V 越大越新）。
- 点该行右侧 回滚。
- 等待 回滚成功 提示。
- 刷新浏览器页面（或关掉编辑器标签重新进），画布会回到那一版。
WARNING
回滚会 覆盖 当前服务器上的内容；编辑器里 未保存 的修改也会丢。大改前可先 导出 JSON 双保险。
没有版本历史菜单？ 需要 screen:version 权限。
和撤销（Ctrl+Z）的区别
| Ctrl+Z | 版本历史 | |
|---|---|---|
| 范围 | 当前这次打开编辑器后的操作 | 历次 保存 的快照 |
| 关页面后 | 一般没了 | 还在 |
| 适合 | 刚拖错、刚删错 | 昨天改坏了、同事覆盖错了 |
复制大屏（另一种备份）
不想下 JSON，只想留一份副本：
- 我的大屏 → 找到卡片。
- 点卡片下方 复制 图标（两张纸）。
- 列表出现 「xxx 副本」 新项目，互不影响。
需要 screen:duplicate 权限。
推荐习惯
- 大改前：导出 JSON 或复制大屏。
- 日常：改完就保存，版本历史会自动积累。
- 交付客户：导出 JSON 存档 + 发布链接分开管理。
- 协作冲突：优先 另存为副本，不要强行覆盖。见 协作与版本 · 保存冲突。