Egga 浏览器刷机

从任课宝获取固件，并使用浏览器 Web Serial 直接刷写 ESP32-S3 设备。

先识别并连接设备

刷机、管理设备内容或进行任何 USB 配置前，都必须先通过 USB 识别并连接设备。

1. 准备浏览器和数据线使用 Windows 或 macOS 桌面版 Chrome/Edge，并确认 USB 线支持数据传输。
2. 连接设备保持设备开机并接入电脑，关闭其他可能占用串口的软件或网页。
3. 识别设备点击“识别设备”，在弹窗中选择带有 ESP32-S3 或 USB JTAG/serial 字样的串口。
正在检测浏览器能力...
连接不上怎么办？
  • 先更换一根确认支持数据传输的 USB 线，并尝试电脑上的其他 USB 接口。
  • 更换最新版桌面 Chrome 或 Edge；Safari、Firefox 和微信内置浏览器不支持本页的串口连接。
  • 关闭串口调试工具及其他已连接设备的网页，然后拔下设备、重新插入并再次识别。
  • 没有看到设备时，点击“重新选择串口”；在授权弹窗中选择 ESP32-S3 或 USB JTAG/serial 设备。

Egga 固件刷写

用于升级或修复设备。日常升级请选择绿色主按钮；红色按钮只在设备无法正常启动或售后指导时使用。

1. 选择版本通常保留默认的最新版；需要回退时再选择旧版本。
2. 选择刷写方式日常升级使用“普通刷机”；只有售后指导或普通刷机无法修复时才使用“强制刷机”。
3. 开始刷写点击绿色按钮，等待进度完成并自动重启，中途不要拔线。
刷写失败怎么办？
  • 仍无法进入刷写模式时，按住设备 BOOT 键，再点击刷写按钮。
  • 只有普通刷机无法修复时，才使用红色的强制/完整刷机按钮。
待命
刷写进度 0%
正在加载固件列表...

管理 Egga 的 Wi-Fi

手动输入一个 Wi-Fi 并保存到设备，或查看、删除设备中已经保存的 Wi-Fi。网页不会扫描附近网络，也不会自动选择网络。

请手动输入 Wi-Fi 后新增，或查看设备中已经保存的网络。

隐私说明：Wi-Fi 密码只通过 USB 写入设备，网页不会保存。开放网络可以不填密码。

  • 点击“查看已保存网络”后显示列表

把自己的单词导入 Egga

第一次使用也很简单：下载模板、填写单词、连接设备写入。导入后就是普通的本地词库，可以离线学习并在设备上保存进度。

1. 准备词库没有现成文件就下载 CSV 模板；已有 Anki 可直接使用 .apkg。
2. 选择并检查选择文件后点击“检查词库”，确认名称、词数和字段。
3. 写入 Egga用 USB 连接设备，点击写入；完成后设备会自动重启。

只写入你的设备：词库不会上传到服务器，也不会发布到线上词书列表。浏览器只在本机处理文件，选择 USB 设备后才会开始写入。

模板怎么填写？
  • 单词、释义必须填写；音标、例句、例句翻译可以留空。
  • 保留第一行表头，每行填写一个单词。模板中的两行示例可以修改或删除。
  • 使用 Excel、WPS 等编辑后，请继续保存为 CSV 文件。
  • 也支持中文或英文表头，以及 TSV、TXT 和 Anki `.apkg` 文件。
还没有词库？先下载模板并填写；已有文件可直接选择。

在 Egga 上使用墨墨背单词

使用墨墨模式前必须开启：在墨墨 App → 我的 → 更多设置 → 实验功能 → 学习数据自动同步。

可只配置在线学习、只配置今日任务离线快照，也可以两项都配置。不了解 Token 时先填写账号密码即可。

1. 选择使用方式账号密码用于联网学习；开放 API Token 用于下载今日任务离线快照。
2. 写入认证至少填写其中一种，点击绿色按钮并在弹窗中选择 Egga 串口。
3. 检查状态点击“读取配置状态”，确认在线账号或离线快照显示为已配置。

隐私说明：账号、密码和 Token 只通过 USB 写入设备，本网页不会保存。设备联网使用墨墨服务时会直接与墨墨通信。

尚未读取设备墨墨状态。
开放 API Token 在哪里获取？
  • 打开墨墨背单词 App，进入“更多设置 → 实验功能 → 开放 API”。
  • 只想联网学习时可以不填 Token；只想下载今日离线任务时可以只填 Token。
  • 更新配置后输入框会自动清空，这是为了避免敏感信息留在页面中。