Web 在线刷机

Bondings Ink 提供基于浏览器的在线刷机能力，适合绝大多数用户。

在线刷机页面截图

上图就是当前刷机页的实际界面：左侧先看操作步骤，下面选择固件来源，最后点击“刷写固件”并观察日志。

1. 使用条件

  • 浏览器：Chrome / Edge（支持 WebSerial）
  • 访问环境：localhost 或 HTTPS 域名
  • 连接方式：USB 数据线（必须支持数据传输）

2. 基本流程

  1. 打开在线刷机页面
  2. 连接设备并授权串口
  3. 选择固件版本（可刷新版本列表）
  4. 点击刷写并等待完成
  5. 刷写后观察串口日志确认启动正常

3. 版本来源与代理

当前网页刷机页默认使用 webapp/app/flash/page.tsx 里的静态固件列表，并从 /firmware/ 下载网站托管的分区化固件文件。以下接口是保留给动态固件列表、手动 URL 校验和移动端/未来入口使用的兼容 API：

  • GET /api/firmware/releases
  • GET /api/firmware/releases/latest
  • GET /api/firmware/validate-url?url=...

/api/firmware/releases 优先读取 GitHub Releases；如果 GitHub 不可访问或私有 仓库未配置 GITHUB_TOKEN，会降级返回当前静态托管的分区化固件 manifest。

当未配置 NEXT_PUBLIC_FIRMWARE_API_BASE 时，前端默认走同域 API Route 代理到 INKSIGHT_BACKEND_API_BASE。

4. 故障排查

无法识别串口设备

  • 确认是数据线，不是仅充电线
  • 尝试更换 USB 口或重插设备
  • 在系统设备管理中确认串口是否存在

版本列表加载失败

  • 检查后端是否可访问
  • 检查后端是否触发 GitHub API 频率限制
  • 在页面内点击“刷新版本”重试

刷写中断/失败

  • 保持 USB 连接稳定
  • 切换到手动 URL 模式并先做链接校验
  • 重启设备后再次进入刷机流程