文件管理

fastbee大约 2 分钟

文件管理

功能说明

文件管理页面提供对设备 LittleFS 文件系统的可视化操作，包括查看、上传、下载、编辑和删除文件。所有配置文件（peripherals.json, periph_exec.json 等）都存储在 LittleFS 中。

导入配置前建议先下载当前文件备份；编辑 JSON 后若页面提示解析失败，应先恢复备份再逐段定位错误字段。

配置文件生命周期流程图

现场变更建议按“导出备份、离线编辑、语法校验、上传重载、异常回滚”的顺序执行，避免直接覆盖未知来源的完整配置包。

操作指南

浏览文件

进入 文件管理 页面
文件列表显示当前目录内容
点击文件夹进入子目录

上传文件

点击上传按钮
选择本地文件
确认上传路径

编辑文件

点击 JSON/文本文件
在编辑器中修改内容
保存更改

导入/导出配置

导出：下载 peripherals.json 或 periph_exec.json 到本地
导入：上传修改后的配置文件覆盖现有配置

参数说明

文件系统结构

/
├── config/
│   ├── peripherals.json    # 外设配置
│   ├── periph_exec.json    # 执行规则
│   ├── network.json        # 网络配置
│   ├── mqtt.json           # MQTT配置
│   └── device.json         # 设备配置
├── web/                    # Web 界面文件
│   ├── index.html
│   └── ...
└── log/                    # 日志文件

存储容量

芯片	Flash	LittleFS 可用
ESP32	4MB	~1.5MB
ESP32-S3	8MB/16MB	~4MB/12MB

故障排除

问题	可能原因	解决方案
上传失败	空间不足	删除不需要的文件
文件损坏	意外断电	重新上传或格式化文件系统
配置不生效	JSON 格式错误	验证 JSON 语法后重新上传
无法删除	系统文件保护	部分系统文件不允许删除