A firmware image is the ESP32 flashable firmware file, also called 可刷写固件镜像 in Chinese product copy. A merged bin includes the expected flash layout, and a manifest describes chip, version, format, offset, size, and SHA-256.

firmware image 是 ESP32 可刷写固件镜像，也可称为固件文件。merged bin 包含预期 flash layout，manifest 描述芯片、版本、格式、偏移、大小和 SHA-256。

The ordinary website does not provide stable public firmware image or manifest buttons. Firmware metadata and download tokens are controlled by the logged-in, activated, device-bound official service path.

普通网页不提供稳定公开的 firmware image 或 manifest 下载按钮。固件 metadata 和 download token 由已登录、已激活、已绑定设备的官方服务路径控制。

Use the desktop app for official flashing. The app checks account status, device binding, release metadata, manifest fields, size, hash, chip, format, and flash offset before writing.

通过桌面 app 完成官方刷写。app 会在写入前检查账号状态、设备绑定、release metadata、manifest 字段、大小、hash、芯片、格式和刷写偏移。

The ordinary update path uses formal releases for ESP32-WROOM-32 hardware running agent-status-light-v1. RC and prerelease assets stay out of the stable user update path.

普通更新路径只走正式 release，面向运行 agent-status-light-v1 的 ESP32-WROOM-32 硬件。RC 和 prerelease 不进入普通用户稳定更新路径。

Official firmware service requests use a short-lived token, hash-only storage, and device-binding checks. Public pages must not expose token values or the complete device fingerprint.

官方固件服务使用短期 token、hash-only 存储和设备绑定校验。公开页面不能暴露 token 值或完整 device fingerprint。

Most failures are account, entitlement, download, or connection state, not a need for end-user toolchains.

• If the device is not bound, sign in, connect the ESP32-WROOM-32 light, run Devices Test, redeem an activation code, and bind the device.
• If the account is not activated, local basic status lighting still works but official firmware service remains unavailable.
• If the firmware service is unavailable, retry later; do not paste tokens or full device fingerprints into logs or support messages.
• If download fails, the short-lived token may have expired or the selected asset may not match the device-bound request.
• If flashing cannot reach the device, check USB data cable, selected serial path, power, and Devices Test before changing firmware.

多数失败来自账号、权益、下载或连接状态，不意味着最终用户需要安装工具链。

• 如果设备未绑定，请登录、连接 ESP32-WROOM-32 信号灯、运行 Devices Test、兑换激活码并绑定设备。
• 如果账号未激活，本地基础状态灯仍可使用，但官方固件服务不可用。
• 如果固件服务暂不可用，稍后重试；不要把 token 或完整设备指纹粘贴到日志或支持消息里。
• 如果下载失败，可能是短期 token 过期，或所选资产与设备绑定请求不匹配。
• 如果刷写连接不到设备，先检查 USB 数据线、选中的串口路径、供电和 Devices Test，再考虑改固件。