配置备份与文件接口
当前发行版没有独立“文件管理”菜单。进入 设备配置 > 高级配置 > 配置导入/导出 处理白名单JSON配置；该入口不提供任意LittleFS浏览或在线编辑。
可迁移配置
| 文件 | 内容 |
|---|---|
device.json | 可迁移的设备、时间和日志设置；身份字段由恢复策略保全 |
features.json | 功能选择 |
peripherals.json | 外设定义、引脚和参数 |
periph_exec.json | 外设执行规则 |
rule_scripts.json | 规则脚本 |
screen_panel.json | 屏幕布局 |
point_history.json | 点位历史设置 |
ir_keys.json | 红外按键配置 |
这是当前八文件白名单。network.json、protocol.json、用户和认证文件不在该通用迁移范围；现场网络、MQTT、身份及认证应另外安全备份并保留目标设备自身设置。配置包不是整片Flash备份。
导出
登录后选择需要的配置文件或配置包，下载并记录设备身份、板卡、固件版本及配置摘要。备份属于私有资料，不能上传公开示例。
不同芯片、模组与载板有不同引脚、功能裁剪和预算。另一设备的配置只能作为待核验输入，不能覆盖目标设备自身身份、网络与认证。
整组恢复
- 先导出目标设备原配置，核对芯片、Flash/PSRAM、接线和编译能力。
- 选择配置包及要恢复的项目，按页面流程上传至暂存区。
- 执行整组预检，检查引用关系、硬件资源、容量、功能依赖及诊断。暂存或预检成功都不代表配置已应用。
- 根据预检结果确认恢复。失败时保留错误及原配置，不拆成逐文件强行写入以绕过校验。
- 按提示单独执行重启，再检查目标身份、功能选择、外设、规则、屏幕及业务有效性。确认恢复和重启是两个步骤。
恢复只影响允许的项目；不能用通用包恢复网络或认证。接口细节及实际流程见设备配置、API参考。
503须按 Retry-After 或有限退避处理；401/403先处理登录及开发者模式。不要并发重试或在错误后静默重置。
定制文件 API
源码保留 /api/files、/api/files/content、/api/files/save、/api/filesystem，只有显式编入 FASTBEE_ENABLE_FILE_MANAGER=1 才注册。正式环境默认关闭，Web无对应管理页。
这些接口需要认证，面向定制诊断。常规配置迁移使用 /api/config/transfer/*；文件写成功不能替代整组预检、确认和业务验收。