用浏览器安装 PXA
打开网页烧录工具。在电脑上的 Chrome / Edge 等支持 Web Serial 的浏览器操作，通过 USB 数据线连接设备，不需要安装 ESP-IDF 或编译工具。串口访问由浏览器弹窗授权；手机或不支持串口的浏览器会显示使用提示。
目前支持 PAI Touch、SenseCAP Watcher、DOIT GameKit、DOIT GameKit 1、ESP32-S31 Korvo-1 、ESP Mosaico、DOIT ESP32-S31 DevKit 和 ESPP4-A。请按机身或购买资料选择型号，相同芯片的开发板不能互换固件。
三步完成安装
- 选择设备、准备固件。网站自动查询
SmartArduino/pxa-workspace最新稳定 Release，验证官方 P-256 签名；下载后核对 SHA-256 和镜像芯片。不使用测试版，不用手工找二进制文件。 - 连接设备并检查。关闭占用串口的 PXADB、监视器或 AI 调试任务，点击连接并选择串口。工具检查芯片、Flash 容量；保留数据升级还会读取并核对真实分区表。
- 确认写入。检查型号、版本和方式，点击开始。保持供电，不拔线、不关闭页面。Flash 内容校验完成后，按 RESET 启动。
连接设备不会立即写入。烧录完成表示写入和内容校验完成；启动、屏幕、输入是否正常，需要实际检查。
选哪种安装方式
| 方式 | 写入范围 | 适合场景 |
|---|---|---|
| 保留数据升级（默认） | 只写系统应用分区，保留已安装应用、设置和存档 | 已有 PXA，分区布局与新版一致 |
| 首次安装 / 完整重装 | 完整覆盖 Flash，包括应用、设置、存档；不写 SD 卡 | 新设备、恢复系统或分区布局变化 |
完整重装需要先备份并勾选清除确认。布局不一致会停止，不会自动改为清除模式。旧版 ESP Mosaico 等设备可能需要迁移。保留数据升级也建议预先备份重要资料，以防意外断电。
芯片识别只能确认 S3 / S31 / P4，不能证明具体板型。工具不烧写 eFuse；启用安全启动或 Flash 加密的定制设备应走厂商专用升级流程。
保留数据后，怎样更新商城
PXA 系统版本、整机固件版本和商城版本分别编号。 页面会显示签名发行清单中提供的这些版本；应用能否安装取决于 PXA 的实际能力，不要求整机固件与 PXA 版本一致。
官方固件 0.10.0 内嵌 PXA 0.10.0，完整安装预装商城 0.9.6。选择保留数据升级时，原来的商城也会保留。本版修复商城自更新占用和旧安装目录的原位更新；升级并重启后联网打开商城，在已安装应用中检查更新，应用私有数据和存档保留。
更早的固件没有向商城服务声明实际 PXA 能力的路径，旧商城可能仍按旧能力查询。此时先安装包含该修正的固件，或通过 PXADB 安装兼容的新版商城；设备兼容性应以实际能力声明为准，不能只看整机版本号。
无法连接怎么办
- 没有弹窗：在电脑上直接打开 HTTPS 官网，检查串口权限；第三方网页的内嵌页面可能不允许串口。
- 串口忙：退出其他串口工具，检查 USB 数据线、驱动、供电和系统权限。Linux 可能需要加入串口用户组并重新登录。
- 连接失败：按住 BOOT，按 RESET，再松 BOOT，重新选择串口。S31 原生 USB 端口可能在重启后变化。
- 芯片或分区不符：停止并核对型号，先备份，再决定是否完整重装。
- 下载失败：刷新重试。GitHub 不可用时只提供已验证的缓存，并标注暂时无法确认最新；没有可信缓存时停止。
- 写入中断：重新进入下载模式再试。完整安装中断时，旧数据可能已被覆盖。
可在页面展开或下载操作日志。反馈时提供设备、浏览器、固件版本与错误步骤，不要附带密码或其他应用的私人日志。
安装后，开始创作
前往 一句话 AI 创作，或者到 商城 发现作品。开发者可以使用 C / C++ SDK 和 PXADB 完成自动安装与真机调试。
浏览器驱动使用 Espressif esptool-js，随网站自托管，不依赖运行时 CDN。第三方许可证 随工具提供。